For Unix platforms, download the webinator-4.3.tar.gz
file, from
the URL given to you during the registration procedure, to a temporary
directory on your machine. (The number 4.3
in the filename may
differ, if you are downloading a different version.) Then uncompress it,
extract it, and run the install script using the following two commands:
gunzip <webinator-4.3.tar.gz | tar xvf -
sh ./install
Note: The Webinator install should preferably be run as the user
that will actually run the software, not as root
. The user
should be the same user that your web server runs CGI programs as
(typically a non-login user); consult your web server config files for
details. This user must have permission to place and move files in
the install directory and the web server tree. If you must run the
install as root
it will ask you for the name of a non-root
user that Webinator will run as. Note: Once installed,
Webinator should never be run as root
.
You will be asked several questions during the installation. For some of these questions, a default answer may appear in square brackets. Eg.:
Install dir [ENTER for /usr/local/morph3]:
In this case, if you just hit Enter
without typing a path, the
install will use the answer /usr/local/morph3
as if you'd typed
that. Note: Just because a default answer is given, does
not necessarily mean that is the correct or best answer for your
particular environment. It is up to you to choose the default or
enter your own value based on knowledge of your machine's setup.
The questions you will be asked include:
/usr/local/morph3
; you
should use this if at all possible to avoid potential path issues
later. Only enter a different directory if you are specifically
unable to install to the standard directory. Whatever directory
you choose should be inaccessible to your web server
(ie. outside its server and document directories): the install
will place just the public files of Webinator in your web server
tree later.texis
executable here. Note: Since Webinator runs as a CGI
program your web server must be configured to run CGI
programs. Consult your web server documentation and config files
to find out how and where your server places CGI programs. For
Apache servers it is typically done with a ScriptAlias
directive. Note that this is the file path to your CGI
directory, not the URL entered in a browser.
For example, let's say you already have a CGI program
findit
installed on this machine, and you access it via the
URL http://www.mysite.com/cgi-bin/findit
. You would then
enter /cgi-bin
as your URL prefix. If your site uses
virtual hosts, or runs on a non-standard port, you can enter a
full URL instead (eg. http://www.myothersite.com:2001/cgi-bin
).
If you want to start over with a new CGI directory (previous question),
then enter /newdir
to back up a step.
.cgi
at the end signifies a CGI program. If this is true for the CGI
URL prefix you've selected, enter it here. For example, if your
CGI programs are named findit.cgi
or shop.cgi
then
you might enter .cgi
as the extension. (This may be the
case for Apache servers if CGI is set up with an
AddHandler cgi-script
directive instead of
ScriptAlias
.) If your programs do not have an extension in
the URL, type none
.Once the installation has completed successfully, you can remove the tar and install files, as they are no longer needed:
rm -f install webinator-4.3.tar.gz webinator.tar
install.sum webinator.sum
Note: If you move your web server directories around or change your CGI configuration after installing Webinator, you will have to re-install it.