Abstract and Table of ContentsPrevious SectionNext Section

3. Installing RPS2

3.1 Installation Requirements

Installing the RPS2 software should be relatively easy, but it does require a basic understanding of Unix. If you are familiar with Unix, you should be able to install it without any special privileges and with minimal help from the system managers. If you or your system manager has problems installing or running RPS2, please contact your Program Coordinator.

Check with your system manager to determine the best place to install RPS2. This is particularly important at institutions where there are multiple HST observers; in this case the software can be installed once in a place where everyone can use it.

Note: Users at STScI do not have to install this software. It has already been installed on the unix science cluster and is accessible from /usr/local/bin/.

3.2 Retrieving the RPS2 Software

The code can be retrieved from STScI using the World Wide Web or anonymous FTP (for a list of what is available, see Possible Configurations).

Via the WWW:

1) Open URL: http://www.stsci.edu/ftp/software/rps2/

2) Click on the desired file (such as solaris-RPS2bin.tar.Z )

3) Type the full path (of the directory in which you want to install RPS2) and the chosen RPS2 file name in the dialog box

Via anonymous FTP:

1) Type cd <directory in which you want to install RPS2>

2) Type ftp ftp.stsci.edu

3) Type in the name " anonymous " as your user name

4) Give your e-mail address as your password

5) Type cd software/rps2

6) Type bin

7) Type get solaris-RPS2bin.tar.Z (or other desired file)

8) Type quit

You need to retrieve only one file; all the software elements needed to install and use RPS2 are archived together in this file.

3.3 Unpacking the Software

Once you have downloaded the file into your installation directory, examine the file name. If the file still has the .Z extension, use the following command. (Remember that unix commands are case sensitive.) For the solaris configuration:

zcat solaris-RPS2bin.tar.Z | tar -xf -

If the file no longer has the .Z extension, your FTP or WWW client uncompressed the file for you. Use the command:

tar -xf solaris-RPS2bin.tar

When this is finished, the installation directory will contain some files (like INSTALL and README ) and subdirectories (like docs/ and testprops /). Read the INSTALL and README files. The docs/ directory contains a version of the RPS2 User's Manual as well as a copy of a blank Phase II proposal template.

3.4 Installing the Software

While in the installation directory, execute the following command:

make install

This command modifies the source code to conform to its current location and sets the necessary file permissions. The " make install " command only needs to be run once, unless the files are moved to another location.

3.5 Testing Your Installation

A sample RPS2 proposal is available in a subdirectory of the installation directory called testprops/ . The file name is: 2.prop (a WFPC2 example). Copy this proposal into a new directory and follow the instructions starting with Bringing up the RPS2 Graphical Interface.

Note that this sample proposal contains minor errors designed to illustrate how RPS2 diagnostics work. The README file in the testprops/ directory outlines what is illustrated in the sample proposal. This proposal is merely for demonstrating how RPS2 works. Sample proposals are available on the WWW from the Phase II proposal development page, http://presto.stsci.edu/public/rps2home.html and from the Instruments Page , http://www.stsci.edu/instruments /

 

Abstract and Table of ContentsPrevious SectionNext Section