LINKWINDS VERSION 2.1 INSTALLATION INSTRUCTIONS REQUIRED OPERATING ENVIRONMENT LinkWinds (lwx21) runs on all SGI platforms running under IRIX 5 or later. An alpha-test version of LinkWinds (lwxsun) runs on the Sun workstation, under Solaris 2.4 or later. The LinkWinds software and documentation, exclusive of sample or user's data files, is not very large, and requires about 6.5 MB of disk space. The sample datasets provided take another 15.5 MB, for a total disk space requirement of about 22 MB. The LinkWinds executable file is 3 MB in size so that the RAM requirements for the workstation are primarily dictated by the size of the user's datasets. We suggest that the platform have a minimum of 32 MB, and as much additional RAM and swap space as is necessary to prevent excessive or infinite paging when loading user datasets. For optimal data display and manipulation, your workstation should have at least 8-bit color and z-buffering. INSTALLING LINKWINDS ON YOUR SYSTEM You will receive the software in several compressed tar files. If more than one user is to have access to it, we recommend that it be installed in a directory owned by root. In this case, each user can establish a uniquely tailored LinkWinds execution directory following the instructions below. For a single user, it can be installed in a subdirectory in the user's home directory. In the single user case, create a directory named lwx21 in your home directory, and place the lwx21.tar.Z, or lwx21sun.tar.Z file in it. then type zcat lwx21.tar.Z | tar xvof - or zcat lwx21sun.tar.Z | tar xvof - and the system will be installed. If you have had a previous installation of LinkWinds, make sure it is in another directory and preserved until you can take relevant information from your previous control files and use them to update the new control files. Some of the control file formats have changed, so don't simply replace the new files with old ones. You will need to edit the new ones, adding the information specific to your use. To install the documentation, put lwx21docs.tar.Z into the lwx21 directory and type zcat lwx21docs.tar.Z | tar xvof - The sample datasets should be placed in the db directory you will find in the lwx21 directory. From inside that directory, type zcat sampleDBs.tar.Z | tar xvof - to install them. You are then ready to execute LinkWinds from the lwx21 directory. For multiple users, LinkWinds should be installed by the system administrator in a directory accessible to all users. It can be in /usr/share/LinkWinds, or /usr/people/LinkWinds, for instance. In the following instructions, we will assume it is in the latter. Create the designated directory, and install the tar files as described above in the single user case. This will install LinkWinds and all of its files and directories on your system. SETTING UP AN INDIVIDUAL USER'S LINKWINDS DIRECTORY For the case of multiple user access to LinkWinds, a script file named setup_lw is provided to help each user configure a uniquely personal LinkWinds directory. This allows all users to execute LinkWinds simultaneously, with their own data and ancillary files, without disturbing the system installation. To do this, create a sub-directory in your home directory, for instance ~/mylw, from which to execute LinkWinds. Then copy setup_lw from the system installation of LinkWinds into that directory and execute it with the path to the system installation as the argument. That is, type setup_lw /usr/people/linkwind (or whatever is the LinkWinds system directory path) After executing this script, several files and directories will be copied to your designated directory. Most of the files can be edited by you to tailor the installation to your own needs or preferences. A description of each file, and how it can be edited is given in Section 15 of the User's Guide. If you had a previous LinkWinds installation, and you're using the same directory, the previous files are saved with the extension .O. You can subsequently copy information from them to the new files, as needed, and discard them if you wish. If you have difficulties in installing the system, we are able perform the installation ourselves, and give new users a realtime tutorial using the network capabilities of LinkWinds. If you are having a problem understanding any aspect of its operation, or ingestion of data, please contact us and we will schedule a session with you. Once you have installed the software, PLEASE NOTIFY US BY EMAIL SO THAT WE CAN ADD YOU TO OUR MAILING LIST FOR SUBSEQUENT UPDATES. THE ADDRESS IS linkwind@apex.jpl.nasa.gov Good Luck.