Features System Requirements Installation Users Guide FAQ

Please note, your version of Perl DBM may limit the length of posted messages. This is *not* a function of HyperThread and we recommend using an ODBC compatible database system if it is available to you.

Directions:

In order to install Hyperthread you must have one of the following:

1. Administrator access to the IIS server manager

2. Arranged with an administrator the creation of the necessary directories. If you are to run the installation program, you will need the necessary permissions for copying files.

The following directories must be created before running the installation program:

1. A CGI directory - for storing the perl scripts and databases
   Ex. C:\InetPub\Scripts\Hyperthread\

2. A webdocs directory - for storing images, template files and possibly html archives of the discussions.
   Ex. C:\InetPub\wwwroot\Hyperthread\

3. If you are using an ODBC compatible database system, please read the ODBC installation instructions.

We recommend taking a moment at this point to make sure the required directories and files were included in your HyperThread .zip file.

You are now ready to run the installation program.

Step 1: Ensure that PERL scripts will run on your webserver.

For IIS 2.0, You will need to use the Registry editor to add a mapping so that perl scripts are executed properly (it is assumed that Active State's perl is used). Add a new value for the following key:

HKEY_LOCAL_MACHINE
SYSTEM
CurrentControlSet
Services
W3SVC
Parameters
Script Map

of the form:

.pl => C:\Perl\Bin\Perl.Exe %s %s

If you installed Perl in a different location, substitute the correct directory as necessary. You will then need to grant execute permissions for the specified CGI directory using the IIS2.0 server manager.

For IIS 4.0, the IIS 4.0 server manager provides a mechanism for allowing Perl CGI scripts to execute. Simply select the hyperthread directory you created from the menu of WWW directories and create an application for it -- call it Hyperthread or anything else you like.

Now, using the "configuration" utility, make sure you see a mapping for .pl files which map to your Perl interpreter. If such a mapping does not exist, create one with the format:

.pl => C:\Perl\Bin\Perl.Exe %s %s

(substitute your Perl directory if different from the above).

For IIS 3.0, you will need to determine if your web server is compatible with IIS 2.0 or IIS 4.0 -- the simplest way to do this is to check your IIS server manager and see if options are available for configuring directories to run as applications. If so then your server is compatible with IIS 4.0, and you can use the above instructions to take care of the pre-installation setup. If not, use the above instructions for IIS 2.0.

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 path for the specified CGI directory where Hyperthread's script files will be stored. The database directory will be created as a subdirectory. Example:
  C:\InetPub\scripts\hyperthread\

• the absolute url associated with this directory. For example:
  http://www.mydomain.com/scripts/hyperthread/

• the location of a directory for images to be installed to. This must be a non-cgi directory, so an example might be:
  C:\InetPub\wwwroot\hyperthread\images

• a URL that corresponds with the images directory. example:
  http://www.mydomain.com/hyperthread/images

• the location of a directory for html template files to be installed to. This must also be a non-cgi directory. An example might be:
  C:\InetPub\wwwroot\hyperthread\html

• 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:
  C:\InetPub\wwwroot\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: The remainder of the installation is performed by the install-NT.pl script provided with your Hyperthread package.

If your system is setup to automatically run Perl scripts, then just do the following to start the installation script:

install-NT.pl

If not, you will need to type:

C:\Perl\Bin\Perl.Exe install-NT.pl

(substitute your Perl directory if necessary).

* The user running the installation program must have the necessary permissions to be able to create directories and copy files to them.

You can troubleshoot the HyperThread installation with the Installation FAQ. If you run into trouble, we first recommend contacting your system administrator with system specific questions (e.g. the location of perl on your machine).