Welcome to the Antelope 4.10 Distribution Included in this Antelope 4.10 distribution are: * the Antelope Real Time System, ARTS, a complete package of software for acquiring, transporting, distributing and processing seismological data in real time. * the Antelope Seismic Information System, ASIS a relational database underpinning for ARTS as well as a complete data processing and archiving system for seismological data. Most Antelope software modules require license keys to run. These license keys are obtained by running the program register_antelope to request a license key. If your computer is not connected to the internet, or your mail is not working, you must run register_antelope, and then send the file BRTT-license-request which it leaves in your home directory to register@brtt.com. register_antelope collects information which we require to issue a license; the file BRTT-license-request is in a format which we can deal with easily. ** You must run register_antelope and fill out its form to obtain license keys. ** Please do not send us other ad hoc requests for licenses. Antelope software uses the perl and tcl/tk. As a convenience to users, we have included compiled versions of the distributions of perl and tcl/tk which are compatible with the Antelope software. All of Antelope installs in a single directory -- /opt/antelope -- including the perl and tcl/tk distributions. Please install these distributions of perl and tcl/tk even if you already have your own versions of these utilities. Contributed Software We have bundled a set of contributed software with this distribution. The contributed programs and software libraries were written by people in the Antelope user community who have generously made these available to all Antelope users. Any license agreements, claims of ownership, or copyright statements contained in this distribution do not apply to any of the contributed software. BRTT makes no claims of ownership for any of the contributed software. The contributed software on the Antelope CD is provided on an "as is" object code only basis and BRTT disclaims any responsibility relating to the contributed software. The authors have given BRTT permission to include this contributed software in the Antelope distribution, permission for you to copy this contributed software onto your hard drive and permission for you to run this contributed software on your computers. Any other use, including redistribution, should first be cleared with the original authors. Requests for support should be made to the original authors. None of the contributed software libraries and programs are node locked. Source code for the contributed software modules may be obtained from the Antelope User Group web site (a link to this site is on the BRTT web page at http://www.brtt.com). Contributed software may be recognized by the notation at the bottom of the man page for the program: Antelope Contrib SW The man page should also identify the author. Pricing and Support For those who purchase Right-To-Use licenses for the Antelope software, we offer a support and maintenance package. Please refer questions regarding pricing, support and maintenance to: Mr. Ogie Kuraica Kinemetrics, Inc. 222 Vista Ave. Pasadena, CA 91107 626-795-2220 ogie.kuraica@mail.kmi.com For those who are running the Antelope software on free evaluation licenses, we offer limited e-mail only support (no more than several e-mails per institution). Please send e-mail questions to: support@brtt.com System Requirements 1. SPARC, Intel, Apple/Macintosh or ARM hardware architecture. 2. SUN-Solaris, Linux, or MacOS X/Darwin operating system 3. X-windows 4. 300 to 400 Mbytes to install Antelope. 100 Mbytes additional to install the demo data sets. 50 Mbytes additional to run demos, 5. A working sendmail configuration is required for certain Antelope programs, including rtexec and autodrm. Contents of the CD * Antelope 4.10 programs, scripts, libraries, include files and man pages. * A complete demo data set of the Southern California Network provided by the the University of California San Diego, the California Institute of Technology and the United States Geological Survey." * An ASIS Database demo data set. * Tcl/Tk tcltk8.4.4 programs, scripts, libraries, include files and man pages. * perl 5.8.8 programs, scripts, libraries, include files and man pages. * Antelope tutorial documentation (in the doc directory) * Installation and run demo scripts. Installation Instructions 1. Mount the CD. On a Sun, if you have the volume manager running, then this should happen automatically when you insert the CD into the drive. If you do not have the volume manager running, then you will have to manually mount the CD as super-user with the mount(8) command. 2. Change directory with the cd(1) command to the CD mount point root directory. On a sun, the mount point may be something like /cdrom/antelope_4.10 Under Linux, the mount point might be: /cd or /mnt/cdrom You may have to look at /etc/fstab to find the mount point. Under MacOS X, the mount point will be: /Volumes/Antelope_4.10 3. Execute the "Install_antelope" script in the toplevel directory of the cd, eg: /cdrom/antelope_4.10/Install_antelope [options] [destination-directory] (Your path to the script may vary) The mounted cd must allow execution privileges. If you find this is not true, try something like the following command (as root): mount -oremount,exec /cd The options are: -t use terminal mode -- no gui -u ask no questions; install full distribution -v more verbose, progress bars in terminal mode Typically, the software must ultimately be installed into /opt/antelope; however, you can install it somewhere else (eg, /export/opt/antelope) temporarily. 4. An installation window will appear if you have X-windows running. Follow the instructions. The Antelope software MUST be installed in /opt/antelope on your system. /opt/antelope can either be a directory or a symbolic link to another directory. The installation script checks to see if /opt/antelope exists and if you have permission to write into this directory. If /opt/antelope does not exist, the installation script will attempt to create it. On most SUN systems, creation of /opt/antelope requires super-user permission. If this is the case on your system, you will have to either run the installation script as super-user, or get your system administrator to create /opt/antelope and make you the owner before you can install the software. XHOST Authorization The original X-windows method of authorizing client connections was done through the command xhost(1) (usually in /usr/openwin/bin). This X-windows security mechanism was found to be not particularly secure. Consequently, a new and more secure authorization mechanism was developed and is supposed to be the current standard for X-windows. This new authorization is done through the command xauth(1) (also in /usr/openwin/bin). Antelope makes extensive use of the public domain tcl/tk software for making Graphical User Interfaces (GUIs). The tcl/tk software will not work properly when xhost based authorization is enabled. Because of this, most of the Antelope tcl/tk scripts check for xhost based authorization and will error exit if xhost authorization is enabled. If your system has a /etc/X*.hosts file, you will have to get your system administrator to remove the file and convert over to the more secure xauth(1) mechanism for X-windows client authorization. This file is an old "back-door" relic for automatically enabling xhost authorization whenever X-windows is started. xhost authorized clients in the /etc/X*.hosts file cannot normally be removed by users. X-Window Display Modes and Free color cells Because most new machines have 24-bit color, the following is usually no longer an issue. However, if your workstation has an 8 bit frame buffer, you should be aware that the Antelope software usually needs about 100 free color cells to operate properly. You may need to free up color cells if you are running applications the take all of your color cells. The most common application that hogs color cells is netscape. Usually you will have to kill netscape if it is running in order to run Antelope. You can check your X-windows display mode and the number of free color cells with the Antelope command check_visual. Locally Mounted Disks vs Remotely Mounted Disks If you are using the Antelope real time software modules, then certain data files must reside on a locally mounted disk. In particular, ORB files must reside on a locally mounted filesystem relative to the machine which is running the orbserver(1) program. In order to run the Southern California demo, you will have to put your ORB files and database files on a locally mounted filesystem. Set Your Environment to use Antelope Once you have successfully installed the Antelope software and have obtained a valid license key and copied it into /opt/antelope/4.10/data/pf, you are ready to use the software. The easiest way to set up your environment variables and execution path is to source the file /opt/antelope/4.10/setup.csh. This assumes that you are running a csh compatible shell (tcsh is OK). This is easiest to accomplish by adding source /opt/antelope/4.10/setup.csh to your .cshrc file (or .tcshrc file). If you use Bourne or related shells, add . /opt/antelope/4.10/setup.sh to your .profile file (or other rc file). Manually installing license keys Licenses provided by BRTT must be put into a file named "/opt/antelope/4.10/data/pf/license.pf". After you have obtained your licenses and installed them into "/opt/antelope/4.10/data/pf/license.pf", you should check the licenses by running the program "check_license" which should give you something like the following: % check_license check_license: license OK If you do not get this response, please contact BRTT at support@brtt.com; please the include the output from "check_license -v" in your email. Running the ARTS demo Running the ARTS demo (the Southern California Network demo) is a very good way to become acquainted with Antelope and we strongly encourage all new users to run the real-time demo. In order to run the real-time demo do the following: 1. Set the Antelope environment according to the instructions above. 2. Make sure the license file is installed according to the instructions above. 2. cd to a working directory on a locally mounted file system. 3. Execute the program "rtdemo" This will bring up a window with further instructions. Antelope documentation You can conveniently find Antelope documentation from the master web page: file:///opt/antelope/4.10/antelope.html Point your web browser at this URL to see all of the online Antelope documentation. Boulder Real Time Technologies, Inc 2045 Broadway, Suite 400 Boulder, CO 80302 http://www.brtt.com support@brtt.com Copyright 2008 by Boulder Real Time Technologies, Inc. All rights reserved