# Copyright (C) 2001-2004 Association of Universities for Research in Astronomy, Inc. ##*********************************************************************** ## ## FILENAME ## INSTALL.TXT ## ## PURPOSE: ## Instructions on how to install. ## INSTALLATION INSTRUCTIONS FOR GEMINI GMMPS PACKAGE Binary version (SUN/Solaris and Linux): ######################################### 0) Install Skycat, see here: ftp://ftp.eso.org/pub/archive/skycat/README.html 1) De-tar the distribution tarfile tar xvf gmmps-.tar The tarfile unpacks to a directory named gmmps- where is something like "0.302-REL". The distribution contains binaries and libraries for various operating systems in the same tarfile. A softlink defines which binaries and libraries are used. Version 0.302 contains binaries for Linux and Mac OS X. To change the softlink there is a script in the gmmps directory named "setplatform". If your linux distribution is one of the following: RedHat 9 Fedora Core 3 Fedora Core 4 Fedora Core 6 Then you can set your platform by cd-ing into the gmmps directory and typing "./setplatform". The script recognizes your OS directly. If you use another linux distribution then you need to figure out which build your version/distribution of linux will be compatible with. E.g. the following distributions are compatible with the given binary set. Debian 2.6.8 ---> Fedora3 openSUSE 10.2 ---> Fedora3 RedHat Enterprise 2.6 ---> RedHat9 RedHat Enterprise 5 ---> Fedora6 And so to set the platform for Debian 2.6.8 you would run setplatform this way: ./setplatform Fedora3 Note: ./setplatform establishes the symbolic links from bin and lib to bin.Platform and lib.Platorm. It is meant to be run from the directory in which it is located. NOTE for Mac Users: These are PowerPC binaries tested to run smoothly on Intel Mac under Rosetta. This is because Skycat 3.0 for Mac is itself a PowerPC application. You should issue the command as follows to get the "Darwin" platform: ./setplatform Darwin NOTE for Solaris Users: Version 0.22 should still be used on Solaris. That distribution has the link pointing to the Sun/Solaris binaries by default. 2) Paths Newer versions of skycat rely on "dynamic libraries". Since these libraries are separate files the programs needs and are loaded at runtime, their directory location needs to appear in a special "load library path" environment variable. (These are ".so" files in linux, ".dylib" files in Mac OS/X ) If the libraries have not been moved to a system library directory then you will need to add the relevant path yourself. The path will be to libraries in the skycat directories, and also the lib directory within the gmmps directories. Typically these are In Linux: The library load path is LD_LIBRARY_PATH. In Mac OS/X The library load path is DYLD_LIBRARY_PATH Some example startup scripts are given below. These should be placed in the user's path. For Linux: #!/bin/bash export GMMPS=/gmmps-0.302-REL export LD_LIBRARY_PATH=$GMMPS/lib:/home/user/skycat-3.0/lib:$LD_LIBRARY_PATH export PATH=$GMMPS/bin:$PATH $GMMPS/bin/gmmps $* and for Mac: #!/bin/bash export GMMPS=/gmmps-0.302-REL export DYLD_LIBRARY_PATH=$GMMPS/lib:/Applications/Skycat.app/Contents/Resources/lib:$DYLD_LIBRARY_PATH export PATH=$GMMPS/bin:/Applications/Skycat.app/Contents/MacOS/:$PATH $GMMPS/bin/gmmps $* Source code version: #################### If you are planning to run under a supported Linux platform, you should not compile the software, binaries are distributed for these architectures. Warning: while you the package contains most of what you need to compile (you will also need skycat), there are manual steps below which must be followed in order to build. 1) De-tar the distribution tarfile tar xvf gmmps-.tar The tarfile unpacks to a directory named gmmps- 2) Build cfitsio starting in the gmmps package directory... cd cfitsio ./configure make 3) Compile the package: First check that the make you are using is GNU make. You can check by typing: make -v You should see something like: GNU Make version 3.79.1, by Richard Stallman and Roland McGrath. Built for sparc-sun-solaris2.5.1 Copyright (C) 1988, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 2000 ... Make sure that you have skycat in your PATH environment variable: set path=($path path/to/skycat ) Go in the directory gmmps-/src and type: ./createplatform this will detect your platforms, create bin. and lib.. (You can see what platform gmmps thinks you are on by running ./discoverOS.sh. This script then will copy some files to the lib created... e.g. cfitsio's lib, but does not copy the skycat lib. Instead it uses "locate" to try to find the library and print a line you can use to copy the file after making sure libcat is the correct and current version. If this library is not available, there will be a link problem. tcsh # configure is a tcsh script, must be in tcsh to configure/make source configure (If you get an error: Word too long. This means that your PATH environment variable is too long, shorten it) Stay in the directory gmmps/src and type: make clean make all ######### RUN GMMPS ######### To run GMMPS you have to edit your personal shell configuration file by setting the environment variable GMMPS to point the directory where the package has been installed and adding its bin directory to your PATH environment variable. For the C-Shell it is: setenv GMMPS /xxxxx/xxxxxx/gmmps- setenv PATH ${PATH}:$GMMPS/bin Also need to make sure skycat is in your PATH environment variable: For the C-Shell it is: setenv PATH ${PATH}:/path/to/skycat Start the GMMPS mask making software with the command: gmmps & This will bring up the skycat tool. The users manual is now on the web, see http://www.gemini.edu/sciops/instruments/gmos/gmosMOSobserver.html