Software Docs


Browse CVS, Git, or SVN
Software Repositories
OS Security Updates
LIGO software virtual machine
VMware SL6 Install


SCCB - Software Change Control Board
Edit these pages
Mailing List


LDAS Tools
LDG Client/Server
LVAlert Administration
NDS Client

Legacy Projects


Reference Server Machines

Table of contents

  1. Pre-Installation
  2. Installing Red Hat 9
  3. Getting Apache httpd and LSCDatagrid
  4. Setting up dsorun


The following instructions require some site-specific information which is indeicated by green keywords below:

  1. Host_Name (e.g
  2. Your_IP_Address (e.g
  3. Your_Network_Mask (e.g
  4. Your_Default_Gateway (e.g
  5. Your_Nameserver (e.g

Under Construction

Installing Red Hat 9

  1. Place the Red Hat installation CD (the first one) in the CD drive, and, if necessary, the Red Hat boot disk in the floppy drive. Power down and reboot.
  2. Type linux expert and press enter to begin the installation process. You can probably get by with these instructions with the graphical installation, but this document is tailored to the text mode.
  3. You will be asked if you want to verify the CD. You can likely skip this step. If you doubt the integrity of the CD(s) you are installing from, then it would be best to go ahead and verify. It will take a few minutes per CD.
  4. Choose OK when presented with the "Welcome to Red Hat Linux" window.
  5. Choose the English language and a US keyboard.
  6. You can choose CD install if you have all 3 CD's
  7. If You are doing a network install (You should be) Select HTTP for the installation media
  8. Uncheck "dynamic IP configuration"
    The ip: Your_IP_Address
    The network mask: Your_Network_Mask
    The default gateway: Your_Default_Gateway
    The nameserver: Your_Nameserver (You will add more later)
  9. Enter the web site name (e.g
    Enter path to the files (e.g /9)
  10. Choose the mouse from the list provided. In almost all cases it will be a generic 3-button PS/2 mouse, but another common mouse is a generic PS/2 wheel mouse, with a scroll wheel as its middle button. Choose Emulate 3 Buttons if necessary for your mouse.
  11. If you are prompted with a choice to upgrade because you had an earlier Red Hat installation on this machine, do not. Choose the "Reinstall System" option.
  12. Choose a custom system (or workstation is you know what you are doing).
  13. Select "Autopartition" to automatically partition your drive for you. Choose "Remove all partitions on this system" unless you desire to keep a current partition.
  14. You will now be in the Disk Druid utility. You should see a table with partition information and mount points. Generally, you shouldn't need to change anything here (assuming you chose to autopartition), but if you wish you may do things such as change the size of the swap partition, add partitions and so on. If you aren't sure what you're doing, don't change anything.
  15. Choose "OK" to continue on.
  16. Choose "OK" to use the GRUB boot loader.
  17. Choose "OK" to use the default options passed to the kernel.
  18. Do not use a GRUB password and choose "OK".
  19. Choose "OK" when asked about booting to other operating systems.
  20. Choose "OK" to install the boot loader in the master boot record (MBR).
  21. Set up the networking as the following:
    • Uncheck the "Use bootp/dhcp" box.
    • Keep the "Activate on boot" box checked.
    • The ip: Your_IP_Address
    • The netmask: Your_Network_Mask
    • The gateway: Your_Default_Gateway
    • The primary nameserver: Your_Nameserver
    • The secondary nameserver: Your_Nameserver
    • The tertiary nameserver: Your_Nameserver
  22. Set the hostname: Host_Name
  23. When prompted for firewall configuration, choose: No firewall.
  24. Make sure the English USA language package is checked. Select any other language packages you may find useful and choose "OK" when you are done.
  25. Choose the default language to be English (USA).
  26. Set hardware clock to GMT, and timezone (America/Chicago).
  27. For root password, choose something you'll remember. After installation, make absolutely sure to contact the admins to change it.
  28. Set up the authentication configuration according to your site.
    For example at UWM, we use:
    • Do use shadow passwords
    • Do enable MD5 passwords
    • Do enable NIS, and specify the NIS domain as uwmlsc-nis
    • Uncheck the "Request server via broadcast"box, and below it use
    • Do use enable LDAP or Kerberos
  29. Use the default package groups.
  30. Choose "OK" to begin the installation. This will take a while, likely around a half hour. You will need to change CDs twice during the install, so make sure you have CD 2 and CD 3 ready.
  31. Choose not to make a boot disk.
  32. Xprobe reports the video card installed. Choose "OK" if it is correct, or change it if you know what you are doing.
  33. Choose "OK" if your monitor is correctly detected, or choose one from the list presented. Don't probe again for monitor resolution. Select the amount of memory that your video card has, and choose No Clockchip.
  34. Choose a display resolution. 1024×768 is a good screen resolution for 15-inch monitors; larger screens can have up to 1280×1024. Choose the highest colour depth (16 or 24 bit) for your resolution. Choose to use graphical login.

For more information check out this Red Hat 9 instruction for machines at UWM.

Getting Apache httpd and LSCDatagrid

Installing httpd

  1. Login as root and open a terminal window.
  2. Run redhat-config-packages, select webserver, and update. (ensure httpd is selected)
  3. Start up httpd by service httpd start and enable httpd for runlevel 5 by typing chkconfig --level 5 httpd on (Make sure that you can view the Apache Welcome page by typing in your ip in a web browser)

Setting up LSCDatagrid (You need both the server and the client)

  1. Follow directions at LSC page

Setting up dsorun

Get dsorun through cvs

  1. Login as root, set the global variable and change group to apache.
    • export HTMLROOT=/var/www/html
    • chgrp apache /var/www/html
    • chmod g+w /var/www/html
    • cd $HTMLROOT
  2. Edit password file and su to apache
    • vi /etc/passwd and replace shell from /sbin/nologin to /bin/bash.
    • su apache
  3. Grab dsorun using cvs. (use lalwrapper for password)
    • cvs -d login
    • cvs -d co dsorun
    • cvs -d logout
    Notice that you should switch to user apache when doing this; the cgi-script must be owned by apache to execute correctly.
  4. Put identifier for ldas in file ldasname.
    • echo "ldas-uwm" > /etc/ldasname
  5. Edit cgi script
    • cd $HTML/dsorun/cgi-bin
    • vi index.cgi
    Search for "get_ldas_location" and make sure that your ldas is properly identified to your location. If you were configuring the on-line monitoring tool to run at UWM, edit the line
        /uwm/ && return qw( LHO Hanford);
    to contain the correct machine name, a three letter identifier, and a longer one-word description.
        /uwm/ && return qw( UWM Milwaukee);
    Save the file.
  6. Still as user apache, install ligotools. Follow the instructions on the ligotools web page and choose to install the packages LDASJob and dataflow.
  7. As root, change ownership and give Apache write permission
    • chown --recursive apache.apache $HTMLROOT/dsorun
    • chmod --recursive g+rw $HTMLROOT/dsorun
  8. Open Apache configuration file /etc/httpd/conf/httpd.conf and add the following lines:
        <Directory $HTMLROOT/dsorun/cgi-bin>
            Options +ExecCGI
    Uncomment the line:
        AddHandler cgi-script .cgi
  9. Obtain Perl module Tie::IxHash. As root type:
    • perl -MCPAN -e "shell"
    Answer "no" to the questions about configuring. CPAN tools will autoconfigure and will go into the CPAN shell. Next type:
    • install 'Tie::IxHash'
    Wait for the download and the installation to finish. Then log out by typing:
    • quit
  10. Finally, restart the web server by typing
    • service httpd restart
  11. Your should now be able to go to the web page using URL:
    • http://Host_Name/dsorun/cgi-bin/index.cgi
    Instructions(2002) about using the system can be found in:
    • http://Host_Name/dsorun/doc/index.html