Directions:
In order to install LinkTrakker you must have: telnet and FTP access to your webserver.
First you'll need to telnet into your server and go to the appropriate (CGI) directory where you FTP-ed the distribution archive.
To un-gzip the file, type the following command:
gzip -d [archive filename]
The file will now be un-gzipped and is ready to be untarred. The .gz is now dropped from the filename. To untar the file type the following command:
tar xvf [new filename]
The file will now untar and create the appropriate directories while setting file permissions. You will also want to create a LinkTrakker sub-directory in a non-cgi in you web document area (for the image files used by the report generator).
We recommend taking a moment at this point to make sure the required directories and files were created.
You are now ready to run the install program.
UNIX instructions
3 easy steps:
Step 1: Telnet into the appropriate directory.
note: The scripts in LinkTrakker are setup with the default perl location of /usr/local/bin/perl. If your perl resides elsewhere, you will have to edit the scripts. Please read the 'Editing LinkTrakker' guide.
Step 2: The installation program will prompt you for all of the needed information to complete the installation. Please be sure you know the following:
- Whether you want the UNIX DBM (standard) installation or the mSQL (requires mSQL be installed on your server) version.
- the location of your perl for example: /usr/local/bin/perl
- the location for a cgi directory to be setup (the installer will do the work for you once you tell it where to put the directory) example: /home/myaccount/public_html/cgi-bin/trakker/
- a url that corresponds with the cgi directory. Example: http://www.mydomain.com/cgi-bin/trakker
- a directory for images to be installed to. This must be a non-cgi directory. So an example might be: /home/myaccount/public_html/trakker_images
- a URL that corresponds with the images directory. Example: http://www.mydomain.com/trakker_images
- Company name, your name, contact email address and your Webserver software
Step 3: run the install-UNIX program by entering the location of your perl, then install-UNIX.pl:
/usr/local/bin/perl install-UNIX.pl
The most common mistakes made during a UNIX installation are not knowing the proper location of perl, not having a writable db directory, and not properly giving the location of directories. LinkTrakker requires a Perl5.002 or newer interpreter to function. To first find your Perl interpreter use the command:
which perl
This will give you the location of the default perl interpreter. To
determine if this perl version is compatible, you can then type:
perl -v
This will display the version of perl you are using, make sure it is version 5.002 or newer. If your default perl is not compatible you will need to contact your system administrator to find a suitable perl version, if one exists on your system.
While the install program will handle setting the proper permissions, those performing the installation manually will have to make sure your db directory is writable. The catch all is to set world writability by having the directory set to 777
Remember that the location of directories is relative to your server root and will always start with a slash ("/").
You can troubleshoot the LinkTrakker installation with the Installation FAQ. If you run into further trouble, we first recommend contacting your system administrator with specific questions (e.g. the location of perl on your machine).
