June 1, 2001

        ---------------------------------------------------------------
        Installation Instructions for the High Voltage Control Software
        ---------------------------------------------------------------

1. Make somewhere a directory called "slow_control".

2. Copy the files high_voltage-1.0.3.tar.gz and utils.tar.gz to the 
   slow_control directory and unpack them with tar -xvzf.

3. Define an environment variable called "DAQHOME" which points to the 
   directory containing slow_control. (DAQHOME is only used by the Makefiles, 
   so alternatively you can define it in the four Makefiles.)

4. Make a link in the slow_control directory:
   ln -s high_voltage-1.0.3 high_voltage

5. The Makefiles put the executables in $HOME/bin, so create this directory and 
   environment variable if you don't have them.

6. In our system, the HV programs write and read from files in four 
   subdirectories of a "data directory" called /home/fast/data. An example of 
   this directory structure and the files therein is provided in 
   hv_data-1.0.3.tar.gz. Copy this file to the location you choose for your 
   data directory, and unpack it with tar -xvzf. You may want to make a link to 
   the resulting top directory ("ln -s hv_data-1.0.3 data"), or just move it 
   ("mv hv_data-1.0.3 data").

7. The paths and filenames needed by the programs are defined in the file 
   config.inc in slow_control/high_voltage/common/include. If your data 
   directory is not called /home/fast/data, edit config.inc to change 
   "/home/fast/data" wherever it appears to the correct pathname. The pathname 
   must be no more than 40 characters long.

8. Compile the programs by running "make" in these two slow_control 
   subdirectories: high_voltage/server_client and high_voltage/history.

9. Copy the startup script "hv_control" from 
   slow_control/high_voltage/server_client to $HOME/bin.

10. Install the driver for the A303A. Copy the file a303.tar.gz to a convenient 
   directory, unpack it and install it, following the instructions in 
   a303/drv/readme.txt. 

11. To automatically load the driver at bootup time, add a line with the
   pathname of your driver to the end of your /etc/rc.d/rc.local file:

   Example: /sbin/insmod /home/fast/fast_daq/drivers/a303/drv/a303drv.o

12. To automatically update the history files from the record files once a day, 
   use "crontab -e" to add a line like the following to your crontab file (all 
   on one line):

   10 1 * * * $HOME/bin/hv_history_update >> $HOME/data/hv_history/update_log 
     2>&1  

13. See the "User's Guide for the High Voltage Control Program" for 
   information on how to configure the system and run the hv_control programs.