Directions:
In order to install HyperThread 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 hyperthread sub-directory in a non-cgi directory in your web document area (for the image and html files used in HyperThread).
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.
Step 1: Telnet into the appropriate directory.
note: The scripts in HyperThread are set up 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 HyperThread' 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:
- the location of your perl, for example:
/usr/local/bin/perl
- the location for a cgi directory to be set up (the installer will do the work for you once you tell it where to put the directory) example:
/home/myaccount/public_html/cgi-bin/hyperthread/
- a url that corresponds with the cgi directory. example:
http://www.mydomain.com/cgi-bin/hyperthread
- the location of a directory for images to be installed to. This must be a non-cgi directory, so an example might be:
/home/myaccount/public_html/hyperthread/images
- a URL that corresponds with the images directory. example:
http://www.mydomain.com/hyperthread/images
- the location of a directory for html files to be installed to. This must also be a non-cgi directory. An example might be:
/home/myaccount/public_html/hyperthread/temp
- the location of a directory for an archive sub-directory to be created in. This too must be a non-cgi directory. An example might be:
/home/myaccount/public_html/hyperthread/archive
- a URL that corresponds with the archive directory. Example:
http://www.mydomain.com/hyperthread/archive
- your company name, your name, contact email address and 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. HyperThread requires Perl 5 or later (compiled with DBM support) or a 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 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 HyperThread installation with the Installation FAQ. If you run into further trouble, we first recommend contacting your system administrator system with specific questions (e.g. the location of perl on your machine).
