Installation Procedure |
![]() |
The software installation procedure is the same whether you are:
The installation procedure automatically determines if this is a new installation of Caucus or an upgrade to an existing Caucus site. If you are upgrading Caucus, your existing conferences will not be affected by the upgrade. (This includes upgrading from a Caucus Trial Kit.)
Unless otherwise stated, all commands in this installation guide must be typed while logged in as "caucus".
If you are upgrading Caucus, all Caucus users should exit or quit the program while you are performing the upgrade, and the program should be shut down.
You can shut down Caucus from the Caucus Management page (from within Caucus), or by typing:
stopcaucus 0 0 /home/caucus
where /home/caucus is the home directory of the Caucus userid.
The Caucus software is delivered in a file called caucus40.t.Z. In the Caucus home directory, type the following command to unpackage this file.
zcat caucus40.t.Z | tar xvf -
The software includes an installation script that will automatically create the proper script files, set the proper file permissions, and so on.
The script will ask for the hostname (and port number, if needed) of your web server. Be prepared to provide these. To run the script, type:
./cinstall
The cinstall script will produce some warnings and informative messages on your screen. A copy of these warnings is also placed in the file caucus.warn. These warnings should be self-explanatory. They fall into three categories:
You should examine these warnings carefully and determine if any of them apply to your Caucus installation.
When you ran the cinstall script, it asked for a hostname and port number (such as "www.xyz.com" or "host.mycompany.com:8001"). If you need to change this information, now or at any future time, edit the files listed below, and change the hostname or port number appropriately.
Caucus requires that certain files be placed in the Caucus userid's public HTML directory. The standard name for this directory is public_html. The Caucus distribution includes a public_html directory with the necessary files already in it. If your httpd server uses a different name, rename public_html to that directory name now.
For example, if your httpd server uses "WWW" as a user's public HTML directory, from the Caucus home directory type:
mv public_html WWW
You may also need to change the definition of the Caucus parameter "Caucus_Lib". See your SWEB/swebd.conf configuration file for details.
In addition to the Web interface, there is a (largely historical) text interface to Caucus. If for some reason you wish to use this text interface, see the files cv2 and cv2check. Cv2 is the script used to run the text interface to Caucus. Cv2check provides a quick summary of how much new information there is in the conferences that you belong to.
If you have purchased the unlimited text-interface license option for Caucus, and are providing access to the text interface to your users, you probably want to copy these scripts to a public directory, such as /usr/local or /usr/local/bin. You may also wish to rename the scripts to something more mnemonic, perhaps caucus and caucuscheck.