Uppsala Software Factory - Installation

1. Determine which program(s) you want to install. The programs have been organised into several packages, namely:
   • RAVE
   • X-UTIL
   • VOIDOO
   • DEJAVU
   • SPASM
   • SBIN

2. If you are a commercial user, contact Gerard for licensing information

3. Download the package(s) of your choice by FTP. Each package comes precompiled for a number of different platforms (SGI, Mac OS X, etc.). You can download individual programs, or the entire package for each platform. For example, if you were interested in MAPMAN (part of the RAVE package) for Mac OS X, you could download either the program itself (from ftp://xray.bmc.uu.se/pub/gerard/rave/rave_osx/osx_mapman) or the entire RAVE package for OS X (from ftp://xray.bmc.uu.se/pub/gerard/rave/rave_osx.tar.gz).

4. Some programs require a library or dictionary file. If that is the case, you can download them separately, or you can download the package's "_etc.tar.gz" file (e.g., for X-UTIL this would be ftp://xray.bmc.uu.se/pub/gerard/xutil/xutil_etc.tar.gz). The databases of a few programs (SPASM, DEJAVU) are very big and are therefore not distributed via the "_etc.tar.gz" file but as separate files from the corresponding package's ftp directory. The easiest way to download these is through the libraries page.

5. You may also want to download your own copy of the OMAC directory with public domain programs, macros, scripts, etc. etc.

6. Move the ".tar.gz" files to where you want the USF software to reside. Unpack the files (e.g.: tar xfz rave_osx.tar.gz). Each tar file will yield a separate directory.

7. To make running the programs easy and transparent for the user (especially in a multi-platform environment), it is recommended that you get a copy of the run script. Note that you need to edit this (once) so that it points to your local directories. For this to work, you need to put all your executables for any platform in one directory. In general, you would have the following subdirectories if the top directory is called $GKHOME:
   • $GKHOME/lib - library and dictionary files
   • $GKHOME/symm - O-style symmetry operator files
   • $GKHOME/ALPHA - executables for Alpha OSF1
   • $GKHOME/SGI - executables for SGI Irix 6.2
   • $GKHOME/LINUX - executables for i386 Linux
   • $GKHOME/OSX - executables for Mac OS X
   Note that the "run" script is also intended to set sensible default values for a number of environment variables.

8. Put an alias to the "run" script in your .cshrc file (or put it in a directory that is in your standard path, e.g. /usr/bin). From now on, you can run any of the programs by typing things like: "run moleman2" or "run voidoo -batch < infile | tee outfile".

9. If you don't want to use the "run" script, then do make sure that:
   • the programs are executable (use the Unix "chmod" command if necessary)
   • the directory where the programs reside is in your path (probably defined in your .cshrc file; if you change your path you may need to issue the Unix "rehash" command to update it)