ESO/ECF generic catalogue server: Installation Guide

Installation Requirements

The Tycho-2 catalogue server is a pure perl program and thus requires an existing Perl installation. The server has been tested with Perl version 5.005 on Sun Solaris 2.6 and Linux Suse 6.1/6.3 and RedHat 6.1. In addition to a standard Perl installation the following packages are used in the server:

• HTTP::Daemon

• HTTP::Response

• HTTP::Status

• CGI

• Getopt::Std

• Config

Some distributions already contain these packages by default, others don't. If you don't understand what to do to get the packages on your local machine please ask your local Perl guru. The HTTP packages are only needed for the stand-alone http server. If you are priviledged to install CGI scripts in a cgi-bin directory of an existing http-server you will not need the stand-alone server. The following is valid for the installation of the stand-alone version only.

Installation

Requirements If you have all the required packages you may download the file server.tar.gz and install it as follows:

1. move the tar file to a place of your choice. There are no directories in the tar, thus please create one yourself if need be. Let's assume the installation directory is INSTALL_DIR = tycho-2

2. Untar the file with a command like: 'tar -xvzf server.tar.gz' (gnu tar)

3. On Linux and Sun you may now start a netscape browser. If the server detects a running netscape during startup it will send it's own URL to this browser. Sorry only netscape supported at this time.

4. Locate the Tycho-2 catalogue: Assume you have it on CD and the CD is mounted under /cdrom. Under Linux you only have to start the server by entering ./server.pl in the INSTALL_DIR directory. Under SunSolaris the mounter mounts the CD under /cdrom/tycho-2 (the volume name). In this case you have to start the server by entering

   ./server.pl -H /cdrom/tycho-2

   If you have a copy of the Tycho-2 CD on magnetic disk, you may startup the server by entering

   ./server.pl -H <your-own-path>

   Upon startup the server will print out it's URL and send the URL to a running netscape if it was able to detect it. If you have a different browser running, or if the automatic procedure failed, just use the URL given on the terminal screen where you started the server to connect.

5. The server HTML form should now be visible on the browser. Just enter some coordinates to try it.