Installation > Getting Started

1. Unzip files. Unzip the software files on your local computer, preserving the directory structure.

More information on Unzipping Files

2. Find Web Root. Using an FTP program, log into your server and locate your "Web Root". This is the top-level directory you can place web pages which will be displayed on your website. This is the same directory in which your website's homepage resides.

More information on FTP
More information on your Web Root

3. Find cgi-bin. Some web servers require you to put your CGI Scripts in a special directory called "cgi-bin", while others will let you run cgi scripts from any directory. If you are not sure how your web server is configured you should try to locate the cgi-bin using your FTP program. The cgi-bin directory will be named /cgi-bin/, /cgi-local/, /scripts/ or something similar.

If you can't find the cgi-bin as described then your server is probably the type that let's you run CGI Scripts from any directory and you should be able to install the program anywhere under your Web Root.

More information on cgi-bin directories

4. Create dir under web root. Create a new directory under your Web Root with your FTP program. We recommend you call the directory /pp/.

5. Create dir under cgi-bin. Create a directory within your CGI Directory. We recommend also calling this directory /pp/. If you don't have a CGI Directory, as discussed in Step 3, you won't need to create a second directory, simply use the same directory you created in Step 4.

6. Upload files. Upload the files and directories that you unzipped in step 1 into the web server directories that you created in steps 4 and 5. Make sure that the files are transferred in the correct mode (either "ascii" or "binary").

    
upload from (your PC) upload to (web server) upload mode
/pp/images/ [web root]/pp/images/ binary
/pp/uploads/ [web root]/pp/uploads/ binary
/pp/pp.cgi [cgi-bin]/pp/pp.cgi ascii
/pp/index.html [cgi-bin]/pp/index.html ascii
/pp/vconfig.dat [cgi-bin]/pp/vconfig.dat ascii
/pp/config.ini [cgi-bin]/pp/config.ini ascii
/pp/data/ [cgi-bin]/pp/data/ ascii
/pp/templates/ [cgi-bin]/pp/templates/ ascii

Mac Users: If your FTP program has a setting for "Translate ISO
characters" (e.g. Fetch), make sure it's disabled before you upload.

More information on FTP upload modes (ascii or binary)
More information on Mac "Translate ISO Characters" issue

7. Set File Permissions. If you are using a Unix-based Server, you will now need to set file permissions on some of the files and directories you uploaded. Most FTP clients have the ability to change file permissions. Unix-based servers also include Linux, Solaris, BSD, etc. For windows users, appropriate permissions may already be set.

Unix File Permissions *
Folder chmod Description
/pp/ 755 (executable) the directory itself (this applies to the /pp/ directory in the /cgi-bin/ and the web root)
/pp/pp.cgi 755 (executable) the file itself
/pp/vconfig.dat 644 (readable) the file itself
/data/   777 (writable) the directory itself
/data/*   777 (writable) all files in this directory
/uploads/   777 (writable) the directory itself
/uploads/*   777 (writable) the directory itself
/images/   755 (executable) the directory itself and all subdirectories
/images/*   644 (readable) all files in this directory and in subdirectories
/templates/   755 (executable) the directory itself and all subdirectories
/templates/*   644 (readable) all files in this directory and in subdirectories
More information on CHMOD and Unix File Permissions
*Refers to all Unix-based operating systems, such as Linux, Solaris, BSD, etc.


Windows Permissions *
Folder Permission Description
/pp/   Read and Write the directory itself
/data/   Modify the directory itself and all files in it
/uploads/   Read and Write the directory itself
/images/   Read the directory itself and all subdirectories
/templates/   Read the directory itself and all subdirectories
More information on Windows File Permissions
*Most commonly these permissions are set to IUSR_servername (where servername is the name of the server). To change these permissions, either contact your hosting provider or change them via your control panel (if available).

8. Open your web browser and type in the URL to the pp.cgi program on your website. (ie: http://www.mywebsite.com/cgi-bin/pp/pp.cgi) This will launch the Page Publisher installation program.