Installation of DLXS TextClass Middleware & Content

The install process will create the directory structure described in the "Directory Structure" section of the workshop.  Take your time.  We'll make sure everyone has a good installation before continuing.

We'll create this structure in the dlxs subdirectory of your home directory by extracting files from the tarfile /l1/dlxs2000-workshop/dlxs2000.tar

You may notice that the directory web/t/text/gifcvtdir already exists under $HOME/dlxs.  We put that directory in place so we could change the ownership to nobody which requires root priviledges.  This directory needs to be owned by nobody so the web server can write to it.

The "%" character indicates your Unix shell prompt.


Step 1

% cd $HOME/dlxs
% tar pxvf  /l1/dlxs2000-workshop/dlxs2000.tar

Tar will echo the files it is extracting.

The middleware is self-configuring.  The mddleware reads the DLXSROOT environment variable.  Our web server is configured to supply this variable with the correct value for each of your environments. Here is a sample o fthe configuration we are using:

Listen 8007
<VirtualHost 141.211.175.34:8007>
  SetEnv DLXSROOT /disks/l1/home/pfarber/dlxs

  DocumentRoot /disks/l1/home/pfarber/dlxs/web
  ScriptAlias  /cgi/     /disks/l1/home/pfarber/dlxs/cgi/
</VirtualHost>
Currently, the data preparation files such as .dd files and Makefiles are not self-configuring. In the future we hope to have an install process that will automate the next steps. Until then, we must edit the paths in a number of files to point to the root directory (DLXSROOT) of your particular installation.  It has a different value for each participant: either /disks/li/home/<<userid>>/dlxs or /prep3/usr/<<userid>>/dlxs.

You can determine the correct value by typing at the shell prompt : echo $HOME/dlxs .  In the following step we run a configuration script to do the work for us.   Note: for command-line (off-line) debugging you would set the DLXSROOT environment variable in your shell.


Step 2

% cd $HOME/dlxs
% /l1/dlxs2000-workshop/configure


Done :-)