INSTALLATION This document describes how to install the TAO Display Software on a UNIX system (current supported platforms include SunOS, Solaris, SGI and DEC Ultrix, more will be added later). First you should check the ownership of the files under taohome/ directory to make sure that the name and group of all the files are valid on your system. If you see userID=402 and groupID=25, please re-untar the package with "-o" option or change the user and group ID using chown. The C-shell script, install.tao3, is provided for you to install TAO software (version 3.0 or above) on your system properly. YOU MUST START install.tao3 WHEN YOU ARE UNDER YOUR taohome/ DIRECTORY. If this is your first TAO installation, you should decide where you want to store the TAO data files. The most recent version of TAO display software (version 3.2) requires approximately 200 MB disk space to store entire TAO data files. This includes the working space and: Buoy daily data -- 15 MB Buoy 5-day data -- 8 MB Buoy monthly data -- 3 MB Buoy hourly data -- 64 MB Section 5-day data -- 37 MB Section monthly data -- 3 MB Depth section monthly -- 17 MB Lat-long maps data -- 7 MB Animation data files -- 17 MB Special -- 24 MB Others (winds, climatology) -- 8 MB If you don't have enough disk space to store the whole TAO data files, you can choose to install the data on another disk (the install script will make a symbolic link to it), or you can choose not to subscribe to all the data files. By default, the data/, ani/, and special/ data directories will be created under taohome/. To install the data at other locations, you must define these locations with following environment variables before the installation (i.e. before running install.tao3.) TAODATADIR for data/ directory - contains buoy, section, lat-long maps and winds data. TAOANIDIR for ani/ directory - contains animation data. TAOSPEDIR for special/ directory - contains special plots. For example, if you set environment variable: setenv TAODATADIR /home/taodata then the installation script will make the following symbolic link automatically while TAO data file will be physically installed on /home/taodata/data directory: taohome/data -> /home/taodata/data If you are using a DEC X-terminal doing the installation you should set environment variable TAO_FONT for proper font using by the TAO installation interfaces before starting this installation script. For example, setenv TAO_FONT "-fn helvetica-10" If you are using one server to install the TAO on another, you must set environment variable DISPLAY correctly before start the installation. For example, setenv DISPLAY pmel.noaa.gov:0.0 Sometimes you may have to specify the IP address instead of host name. ======================================================================== Here is the usage of install.tao3: Usage: install.tao3 all | taopath | printer | data_dir | data_file | subscription all Perform all the following installations. taopath Initialize environment variable TAOPATH and PPLUS font list files in corresponding C-shell scripts under bin/, subscription/ and lib/ directory. printer Select postscript printers for TAO display software. Run the install script with this option whenever you want to reselect the printers. data_dir Create data/, ani/ and special/ directories; and install default files and climatology data files. data_file Select the data sets and/or setup TAO data automated delivery schedule; and initiate a batch job, which starts immediately after you exit the program, to install the data file. (The automated delivery also include TAO software updates.) subscription Select the data sets and/or set up time for TAO data automated delivery. (This argument is similar to argument 'data_file' except it doesn't start the initial installation.) ======================================================================== You can run install.tao3 at any time with corresponding arguments: 1. all Use this argument if this is your first time installation of TAO Display Software V3.0 on your machine. It is the same as if you use all following arguments: taopath, printer, data_dir and data_file. 2. taopath Use this argument when you first time install TAO software or whenever you moved whole taohome/ directory to other location after last time installation. 3. printer User this argument when you first time install TAO software, or whenever you want to change printer access for TAO software. A point- and-click interface, TAO Printer Setup window, will popup to let user to select the printers for use by TAO software. It will list all the printers on your network, you should only select the POSTSCRIPT printers. Besides the printers you selected, it will also add a "Postscript File" entry, that is with this entry user will be able to generate postscript file from TAO display. On-line help is available on the interface. Unless you save the changes before quitting the interface, the previous setting will not be overwritten. 4. data_dir Use this argument when you first time install TAO software. You will find a compressed tar file tao_data.tar.Z, which contains some default files and climatology data files. When you use this argument, files will be extract from tao_data.tar.Z file. (We will notify you by email if climatology data files are updated.) 5. data_file Use this argument when you first time install TAO software, or whenever you like to have immediate tao data delivery to your system, and/or when you want to set/change data file subscription and TAO data automated delivery time. (If you just want set automated delivery time but not immediate data delivery, you can use the argument 'subscription'.) A point-and-click interface, TAO Data Subscription window, will pop up to let user to select (1) TAO data sets, and (2) the TAO data automated delivery time. Only three kinds of automated delivery frequencies are allowed: daily, weekly and monthly, or you can choose no delivery. (The actual delivery will be done by the cronjob.) When installation is done, you can check your scheduled cronjob by type: % crontab -l Note, only the person who set the delivery time can delete or reset it. You will receive email from root when some errors occur during the data delivery, but not for all errors. Output files will be generated after each delivery. It is usefully to check these files to be sure that the TAO data delivery is succeed. These files will be located at: taohome/subscription/, with names: daily.form.output weekly.form.output monthly.form.output for daily, weekly and monthly delivery, respectively. On-line helps are available on the interface. Unless you save the changes before quitting the interface, the previous setting will not be overwritten. When you choose to start immediate TAO data delivery, you actually launched program running at backgroud to ftp the data files. You must give it sometime allowing all the data files being transfered. To check the status of the data delivery procedure, you can look at above *.output files. The time are printed at beginning and end of the output files. So when you see the time stamp at the beginning of the file, it means the tranfering has already started; when you see the time stamp at the end of the output file, it means the transfering is finished. You should check all three output files. 6. subscription This argument does the same as argument 'data_file' except it doesn't start immediate TAO data delivery. ------------------------------------------------------------------------- When you are done with TAO software installation, you may want to include taohome/bin/ directory in your search path (edit your .cshrc file). To start TAO Display Software after the installation, you type: % taohome/bin/runtao or % runtao if you have include taohome/bin/ directory in your search path or alias runtao to be taohome/bin/runtao. The C-shell script "runtao" will initiate TAO software properly. To see other options of "runtao", type: % runtao -help