########################################################
#                                                      #
#      +-+   http://www.go2cgi.com/   +-+              #
#      |  ) +-- ++  + ++  +--  +- -+- |  ) ++   +      #
#      +-+  |   | | | | ) |   |    |  +-+  | ) | |     #
#      |  | +-  | | | ++  +-  |    |  |    ++  | |     #
#      |  | +-- ++  + + + +--  +-  +  |    + +  +      #
#                                                      #
########################################################

Congratulations for choosing RedirectPro to run your new
redirection service, we here at go2cgi are sure you’ll
be completely satisfied with it. In this packet we’ll
describe to you how to configure, install, and operate
RedirectPro in an easy to follow step by step process.
If you have any problems or questions please direct them
to the Support Forum at http://www.go2cgi.com/.

                  ·   script.pl   ·

· Locate the disk that was packaged with this paper.
  On this disk is a ZIP file of the actual script bundle
  as well as the uncompressed files themselves if you do
  not have a ZIP utility. The disk is formatted for DOS,
  which means it can be access from any DOS or Windows
  based computer. If you are using a Macintosh or *NIX
  computer you may download a ZIP file of RedirectPro
  from http://www.go2cgi.com/download.pl using the
  script name "redirectpro" and your personal password
  which can be found on the disk label.

· Insert the disk into your computer and unzip the ZIP
  file into a empty folder or copy the folder on the
  disk onto your hard drive.

· Locate the script named "script.pl" in the folder you
  just created. Open it with a plain text editor such as
  Notepad. Do not use a word processor that alters the
  file’s format.

· To continue you will need to know the following things
  about the server this script will reside on to
  continue: 1) Where the latest copy of Perl is 2) What
  your fully qualified UNIX path is 3) Whether or not
  you have access to non-web accessible directories and
  4) Where your sendmail (or equivalent) program is. If
  you do not know the answers to any of these you will
  need to ask the server administrator (or your host as
  the case may be) for them.

· Change, if needed, the shebang line
  (#!/usr/local/bin/perl) to point to where Perl is on
  your server. Do not delete the "#!". 

· Change $header to the path to where you intend to
  upload your header file (a sample header file has
  been included). In this plain text file you may put
  any HTML code you wish to appear at the top of all of
  the RedirectPro pages.

· Change $footer to the path to where you intend to
  upload your footer file (a sample footer file has
  been included). In this plain text file you may put
  any HTML code you wish to appear at the bottom of all
  of the RedirectPro pages.

· Set $mail_prog to the path of your sendmail (or
  equivalent) program. 

· In $emailadd put the email address you want used on
  all the outgoing mail RedirectPro sends.

· Type the text you want displayed at the top of all
  email RedirectPro sends here in $mailhead.

· Type the text you want displayed at the bottom of all
  email RedirectPro sends here in $mailfoot.

· Change $datafile to the path to where you intend to
  upload your datafile. Ideally, this should be a
  non-web accessible directory but a web accessible
  directory will do but will be much less secure.

· Change the path in $redirect to where you want the
  user’s accounts to be stored. If your domain is
  go.to and you want your user’s URLs to be go.to/user
  then this should be your base directory.

· Put the URL that the $redirect path reflects here in
  $reurl.

· Set $domain to your domain name, do not include the
  "http://" or "www".

· If you wish to allow your members to place your
  ad directly on their page set $placeban to "yes", 
  otherwise set it to "no".

· On the sign-up page the width of the username text
  field can be changed using $width. For example,
  setting $width to 15 will make the username field
  15 characters wide.

· Change $rescript to the path to redirect.pl relative
  to the member's subdirectory (for example
  "../redirect.pl").

· RedirectPro requires SSI for some parts of the
  redirection. Set $ext to the extension you need to use
  to tell the server to parse for SSI (usually
  ".shtml").

· Set $title to the title of your redirection service.

· Change $script to the URL to the script.pl file. This
  may be relative (eg /script.pl) or absolute
  (eg http://www.domain.com/script.pl).

· Set $leave to the URL members should be taken to after
  they modify their account or have clicked the "Exit"
  button on the menu page.

· Change $whatis to what the page the URL above is (eg
  "home page")

· Change $countries to the path of the countries.txt
  file (the countries file allows you to better target
  your advertising by letting you run different ads on
  different sites depending on the nationality of the
  member).

· Put in $html the HTML you want the new member to put
  on his or her page if there is a problem with the
  countries file and you have enabled $placeban.

· Save the file (remember to save it as plain ASCII
  text, the same way it was when you opened it).

                   ·   redirect.pl   ·

· Open the file "redirect.pl" and change the shebang
  line as you did in "script.pl".

· Set $popup to the URL to the HTML file that you want
  to be in the popup if there is a problem with the
  countries file.

· Change $datafile to the path to the datafile. This
  should be the same path as you entered in "script.pl".

· Set $delayfile to the path to the file containing the
  HTML you displayed on the delay page if there is a
  problem with the countries file.

· Change the URL in $frameurl to the file you want to be
  in the ad-frame (currently this is not available in the
  countries file).

· Change $countries to point to your countries file.

· Save the file (remember to save it as plain ASCII
  text, the same way it was when you opened it).

                    ·   admin.pl   ·

· Open the file "admin.pl", change the shebang line
  as you did in the other two scripts. 

· Change $datafile to the path to the datafile, this
  should be the same path used in the other scripts.

· Change $script to the URL to this script (leaving
  this as it is should work in most situations).

· In $rescript put the path to the redirect.pl script
  relative to the member's directories

· Set $redirect to the path that users accounts are
  stored in.

· Change $ext to the extension needed to signal your
  server to parse for SSI.

· Set $password to what you want your admin password to
  be.

· Change the path in $countries to point to your
  countries file.

· Save the file (remember to save it as plain ASCII
  text, the same way it was when you opened it).

                     ·   Finish   ·

· Upload all of the scripts in ASCII to your CGI-BIN or
  any other subdirectory that you can use CGI from.

· CHMOD all of the scripts 755 (rwxr-xr-x).

· Upload the datafile to where you said it would be in
  the three scripts. Ideally this should be non-web
  accessible. CHMOD it 777 (rwxrwxrwx).

· Upload the countries datafile to where you said it
  would be in the three scripts. CHMOD it 777
  (rwxrwxrwx).

· Edit the header and delay files to your liking and
  upload them to where you said they would be in the
  scripts. CHMOD them 777 (rwxrwxrwx).

· CHMOD the directory (usually your base directory)
  your user’s accounts will put put in 777 (rwxrwxrwx).

· If you are upgrading from a previous version of 
  RedirectPro, open convert.pl and follow the
  instructions in the header of the script.

Done. You should now be able to access your Site as
normal, there should be no difference in it’s loading.
Provide a link to the script called "script.pl" so that
your visitors can sign-up for accounts and modify them
later. You can link to the sign-up page directly using
"script.pl?do=step1", the modify page using
"script.pl?do=modify", and the member's index using
"script.pl?do=links". Use the admin script, "admin.pl",
to administer your redirection service. The countries
data file allows you to better target your advertising,
before you open your service to the public you’ll need
to log-in to the admin file and setup your country
options.

              ·   Problems or questions?   ·

If you have any problems installing or using
RedirectPro, you can take them to the Support Forum at
http://www.go2cgi.com/, email webmaster@go2.com.py, or
ICQ 53662716.

Thank you for purchasing RedirectPro.

########################################################
#                                                      #
#         Copyright © 1999 W. Dustin Alligood          #
#                                                      #
########################################################