This document describes how to obtain and install the HyperWave server software (binaries) by use of the HyperWave distribution tar-files.
Note: To get the full functionality of the HyperWave Server you have to register your server.
We provide this special installation variant for people that cannot use our installation script; for instance, the server machine may be behind a firewall and only FTP to the outside world is allowed. Although HyperWave can be installed from tar-files we strongly recommend the use of the HyperWave install script (hginstserver) if possible, especially for updating the server. Further information concerning HyperWave server software update and a short introduction to HyperWave server administration is contained in Download HyperWave Software.
Should you experience problems connecting to ftp.iicm.edu, the /pub/Hyper-G directory is mirrored nightly to the following hosts.
If you have questions or comments about this document, please feel free to mail hgsupport@iicm.edu. We welcome any suggestions, criticism, or postcards. If you find a mistake within this document, please let us know so we can correct it in the next version.
Thanks.
To operate a HyperWave server you must have one of the following machines and operating systems:
Now, for each supported architecture the software distribution consists of several compressed tar-archives; for instance, the tar-files for Silicon Graphics machines are:
The tar-files contain:
The "date" in the tar-file names correspond to the creation date of the tar-files.
IMPORTANT:For a complete HyperWave server installation you will need both a "HyperWave_Server_..." and a "HyperWave_Tools_..." tar-file!!!
The HyperWave server software itself consumes about 50 MB (depending on your platform). In addition, you will need enough space for the documents you are planning to serve. Double the space for text documents (required for the full text index), and add an extra 500 bytes overhead per document. For example, if you are going to serve 50,000 text documents of 1K each, plus 1000 images of 100K each, this sums up to 50,000 * 1K * 2 + 1,000 * 100K + 51,000 * 0.5K = 225.5 MB. Allow more if you have lots of links between documents. In addition, you will need some free space for logfiles, temporary files, etc. Your mileage may vary!
The HyperWave Server is distributed in binary form, and is available for the platforms mentioned above. In order to install the software, you need to have root (super-user) privileges. However, once it is installed, the server could and should run as an ordinary UNIX user. First you may perform the following steps (you need root privileges to do this):
setenv HYPERWAVE_HOME <directory>/usr/local/HyperWave will then replaced by directory as the location where these links will be generated. If neither /usr/local/HyperWave exists nor HYPERWAVE_HOME is defined no links will be created at all.
gzip -dc <archive file name> | tar xvpf -The tar-files will be expanded in the subdirectory "tartmp" of hgsystem's home directory.
tartmp/hginsttar
The first time the script is run it will ask you a series of questions and create a file .hgrc in ~hgsystem (user hgsystem's home directory) and modify .cshrc so that .hgrc is included at the end of .cshrc. In .hgrc a number of environment variables are defined (you may edit this file after the installation has completed), including:
~hgsystem/bin/scripts ~hgsystem/bin/$CPUis prepended to the existing path
The script will also create the directories HTML, bin, bin/scripts, bin/$CPU, contrib, hgserver, dbserver, ftserver, dcserver, sgml, samples, doc, and man under ~hgsystem, with appropriate access permissions. It will also create symbolic links to these directories from /usr/local/HyperWave (if /usr/local/HyperWave exists and write access is granted; if the environment variable HYPERWAVE_HOME is defined the directory as specified by HYPERWAVE_HOME is used instead of /usr/local/HyperWave; see step 2 above).
After the previous steps (that are only necessary when installing for the first time) the binaries, scripts and configuration files for your platform are installed in the correct directories. The directory ~hgsystem/tartmp is not used anymore and can be removed to save diskspace.
Once you have done this, you are all set to start your HyperWave server. You may do so at any time by issueing the command dbstart (located in ~hgsystem/bin/scripts) as user hgsystem. If you want to stop the HyperWave server you may perform this by issueing the command dbstop. However, in order to keep the HyperWave server running all the time, you should add the following lines to your boot script (e.g., /etc/rc.local):
# Start HyperWave Server if [ -f <home_of_hgsystem>/bin/scripts/dbstart]; then echo 'Starting HyperWave Server' >/dev/console su - hgsystem <home_of_hgsystem>/bin/scripts/dbstart fi
This starts the HyperWave server control script (that fires off the individual server components) as user hgsystem. You may want to change the default port numbers of the Gopher gateway (port 70) or the WWW gateway (port 80) to other port numbers (e.g. if you would like to run both the WWW server and the HyperWave server on the same system). In such cases you should edit the file ~hgsystem/.db.contr.rc (see dbserver.control) and then stop and restart the HyperWave server. You may verify that the server is running by connecting to it using any command line tool, e.g., hginfo -oid 2. You also may wish to install Harmony, the UNIX/X11 client for HyperWave, if you have not done this already. Look under the Hyper-G/Harmony ftp directory to find out how to install Harmony on your machine.
You may wish to install the HyperWave Server Tools on other machines than your server machine, too (all the tools are client-server applications and can work with your HyperWave server). The installation procedure is very similiar to the steps described in section 4, except that steps 1) and 2) and 7) are not necessary.
You have a choice between two different methods to update HyperWave server software on your system:
Although HyperWave can be updated from a tar file we strongly recommend the use of the HyperWave install script if possible. We provide the "tar-file" installation variant for people that cannot use our installation script (server machine may be behind a firewall, slow network connection to iicm.edu).
For a description of hginstserver look at hginstserver.1
This document describes the update procedure by use of the HyperWave distribution tar-files.
For example: If you want to update the beta version of the HyperWave tools for a SUN Sparc with the Solaris operating system installed you have to download the following tar-files: HyperWave_Tools_....tar.gz
gzip -dc <archive filename> | tar xvpf -The tar-files will be expanded in the subdirectory "tartmp" of hgsystem's home directory.
A number of research papers are available that go into details of HyperWave's design philosophy. In directory papers you will find electronic versions of some of them. If you have never heard of HyperWave before, we suggest you first look at files report388.ps* in that directory. We also suggest you to read the documentation on the HyperWave Server Manager to install, uptdate and manage the HyperWaver Server using a graphical user interface.
This document does not describe HyperWave clients. Information on Harmony, the UNIX/X11 client for HyperWave, can be found in Download HyperWave Software. Documentation on Amadeus, the PC/MS-Windows client, is also available there. The protocol definition is contained in Hyper-G Client/Server Protocol (HG-CSP), which is only of interest if you plan to write your own HyperWave clients or tools that interface with the server directly.