Introduction
Thank you for choosing Page Updater Pro. Page Updater Pro V3.1 is far more powerful and flexible than the original version and has many upgrades and enhancements over V2.0. This program allows you to update content on web pages that reside on any server, not just the one you install the program on.

Page Updater Pro supports multiple users and has a separate Update interface that allows these users to edit page content without access to the main administration functions.

The 3.1 version allows to specify the name of the document and the name of the server that will display the managed content. If they don't match, an unauthorized access warning message is displayed. This is in place to add another level of protection for your managed information from "Content-Jackers".

Additionally, V3.1 creates it's own local SSI scripts already loaded, CHMODed and ready to run. It will also auto-make the SSI CGI application for the remote content files so that all you have to do is load it and CHMOD it, no more setting varaibles!

Finally, V3.1 also autmatically creates the SSI tags for you. No more guessing about paths, just use the built in utilities to generate the SSI tag and then you can just copy and paste it into your HTML document.

RequirementsPage Updater Pro V3.1 must be installed on a UNIX server with Perl 5 or higher. Remote servers that have content that is managed by this program must be UNIX servers with Perl 5 or higher and the LWP::Simple module installed.

Configuration
Before you can install this program, there is one configuration item you must first address.

Path To Perl
All CGI programs written in Perl must start with a line that tells the web server where to look for the Perl interpreter. This means the very first line of each of the .cgi files MUST be the Path to Perl. Here are some examples of common paths to Perl:

#!/usr/lib/perl
#!/usr/bin/perl
#!/usr/local/bin/perl

This program was shipped with a default path of: #!/usr/bin/perl

The first configuration item to address is to make sure that this is the correct Path to Perl for your web server. Your Virtual Hosts support/FAQ pages will tell you what the correct Path to Perl is for your web server. If this information can not be found on the support/FAQ pages then you should contact your System Administrator or Support Dept. to find out the correct value. In lieu of them being available, the samples above are fairly standard. Try them all out in the order above and see if any work for you.

Data Key
If you are using Page Updater Pro V3.1 or higher, then ignore these $DataKey instructions as you will be entering your DataKey from the program setup web interface.

If you are using Page Updater Pro V3.0 or lower then, use your test editor to open the file "pup_cfg.lib". Just below the header, there is one variable called $DataKey. You must set this variable to a completely random sequence of numbers and letters, upper case or lower case is fine but do NOT use any punctuation characters. Setting this $DataKey is a required step and it plugs a security hole that is present in all standardized, distributed CGI programs. There is an explanation of this accompanying the variable, please read the explanation and set the key now. Remember that it must be exactly ten characters long. If there is a problem with the Data Key that you set, the program will not set-up properly and you will be prompted to correct it.

On most servers, this should be the end of any configuration changes you have to set in the script. Please note that you do not have to set any more variables in the pup_cfg.lib, pup_admin.cgi, pup_admin.lib, pup_genssi.lib, pup_setup.cgi, page_update.cgi, pup_uninstall.cgi, support.lib or MongerFile.pm unless the program specifically tells you to.

This program uses our advanced set-up routine, which will create all it's own directories and set it's own permissions on data directories. If the program encounters a problem during the set-up process, you will be given specific directions on what to do. If the instructions given don't allow you to successfully install the program or you are not comfortable following the instructions, contact us through our
support page.

Please note that unless the program tells you otherwise, you do not have to create or set permissions on any directories.

Installation
To install this program, you must have an FTP client and be familiar with how to use its basic functions. If your not sure how to achieve any of the stated functions or commands with your FTP client, please refer to our FAQ on installation and on using FTP clients at:

Having set the path to Perl and the Data Key, it's time to install the program.

Here are the installation steps:

1. Open your FTP client and connect to your web space.

2. In your cgi-bin (some call it just "cgi" or "cgi-local") create a sub-directory with any legal name that you want (i.e. "update").

3. CHMOD this sub-directory to 755 (rwx-rx-rx).

4. Change into this sub-directory with your FTP client.

5. Making sure your FTP client is set to transfer in ASCII mode and not binary mode, transfer the files pup_setup.cgi, pup_admin.cgi, pup_admin.lib, pup_cfg.lib, pup_genssi.lib, page_update.cgi, support.lib and MongerFile.pm into the newly created sub-directory.

Do not transfer any other files at this time. They will be covered later in this Users Guide. Additionally, some FTP clients will convert file names to all lower case. After the transfer, check the case on the name of the file MongerFile.pm. If it has been converted to all lower case (mongerfile.pm) then you MUST rename it on the server to "MongerFile.pm".

6. CHMOD each files that end in ".cgi" to 755 (rwx-rx-rx). You only need to CHMOD the ".cgi" files, not the ".lib" or ".pm" files

7. Close your FTP client.

8. Launch your web browser and in the address line of the browser, type the full URL to the setup.pl script:

i.e. http://www.foo.com/cgi-bin/update/pup_setup.cgi

9. You should now see a set-up screen asking you to enter a User Name and Password (you have to enter the password twice). If you see this screen, it means the program has been configured correctly. Enter your new User Name and Password. Enter the Password a second time in the space provided. You also must enter your transaction number, this is from your purchase receipt for Page Updater Pro. Finally, you must also enter a Data Key. The Data Key is a random sequence of ten leters and numbers (no spaces or punctuation). Submit the form.

10. If you made any mistakes along the way, you will get a warning message with
instructions on what to do to correct the error. If you get an error that says the program
could not set-up the password file, this means that the program is unable to access the data
directory. If this was the first pass through the set-up screen, then there is a server
specific configuration issue. Contact us at our support centre for assistance. If this is not the first
pass through the set-up screen and you were asked to create some sub-directories, then the
program and sever are not able to resolve the Root directory. In this case, you must do the
following:

a. You must now create a directory on your server for the data files to be written to. Follow the instructions in the installation area above. This time however, the data directory must be outside of the cgi-bin and it must be CHMOD 777.

b. Once you have done that, use your text editor (Notepad , Editpad or similar) to open the pup_cfg.lib file. Just below the script header block you will see a variable like this:

$DefaultData = "";

Set the absolute path to that directory in the above variable. It will look like:

$DefaultData = "/usr/name/htdocs/some_data_directory";

c. Note that this variable does NOT end with a slash.

d. Save the changes to the file then re-upload it to the same directory it was originally installed in on the server.

e. Run the set-up routine again. If the problem persists, contact us at the Script Centre support forum for assistance.

Once you have received the screen that says "Set-up Successful" your program is installed, configured and ready to run.

Un-Install
This program ships with an easy un-install program. If you decide that you no longer wish to
use the program, instead of manually deleting all the files, use our un-install program.
This will ensure that all program generated files are removed from the server including
data AND executable files.

Simply upload the un-install file to the same directory as your other files , making sure
the correct path to perl is set. The un-install program required that the pup_cfg.lib file still be in place.
CHMOD pup_uninstall.cgi to 755. You then go to your browser and type in the full URL to the
pup_uninstall.cgi program and press enter. This will remove all the files. There is no
confirmation and no warning screen. Un-installing the program permanently removes the files
and there is no way to recover lost data unless you contact your System Administrator to
restore them from the last server tape backup (if they happen to backup your web space routinely).

WARNING: DO NOT PLACE THE pup_uninstall.cgi PROGRAM ON YOUR SERVER UNLESS YOU INTEND TO USE IT. IF YOU ACCIDENTALLY CALL THE PROGRAM AND IT IS ON YOUR SERVER YOU WILL LOSE ALL YOUR DATA.