Change page style: 

Installation

Installing the Phase I Tool

On February 28, 2014 a new version of the PIT was released to support the 2014B call for proposals.

UPDATE: PIT version 2014B-SV_2014.2.2 was released on July 24 to support several new instrument capabilities.

Please see the PIT Version Table for the appropriate PIT to use for different proposal types.

This page contains instructions for downloading and installing the Phase I Tool (PIT). You can install the software on individual machines or for an entire network of workstations. Versions are available for the following operating systems from the Phase I software directory:

  • Windows (XP / Vista / 7)
  • Solaris (10, 9, 8 or 7 recommended)
  • Linux (Fedora or Redhat Enterprise, most distributions)
  • Mac OS X (Intel Macs only with Leopard and newer with Java 1.6)

If you experience any problems installing or running the PIT, please see the Frequently Asked Questions (FAQ) page for the latest information.

Please read the description of new features on the Hot News page. (As in recent semesters all joint proposals must be submitted through PIT. Backend servers installed at all partner National Offices allow automatic electronic submission to multiple partners at the same time). The PIT will import proposal files from 2012B and later, but not from semesters before that.

An example proposal is available from here. You can load it using the "Open" button within the PIT. Template examples are included.

The PIT software, LaTeX/Word templates, and example files are available on the Gemini software site in the directory corresponding to the semester. You should use your web browser to download the files. Depending on your browser, right or shift+click to save the file.

The PIT will read proposals from previous semesters but it will convert them to the format for the new semester and some information may be converted or deleted.  Use the PIT that created the proposal XML file to view a proposal in its original form. A repository of old PITs is here.

Please read the installation instructions below for your preferred operating system:



Using the Gemini Phase I Tool on Windows

The Phase I Tool has been tested on Windows XP and Windows 7. 

Installing on Windows

  • Download the current Windows distribution of the Phase I Tool from the Gemini ftp site (follow the link to browse the ftp directory and right or shift+click the file named pit_2014B*_win*).
  • The Windows distribution is provided as a Windows executable installer.
  • Use Windows Explorer to display the directory in which you downloaded the installer. You must have at least 120 megabytes of disk space available to install the Phase I Tool on Windows.
  • Double-click the installer executable and follow the installer instructions. When the installation is completed, you will see a congratulatory message. Press the "Done" button to exit.
  • The installation places a Gemini/Phase I Tool 2014B 2014.2.1 folder in your start menu. Selecting "Phase I Tool 2014B" launches the Phase I Tool. 


Using the Gemini Phase I Tool on Solaris

Solaris 7, 8, 9, or 10 are the recommended Sun operating systems for running the Phase I Tool.

For correct operation in all situations, you must run PIT on a properly patched Solaris OS. Gemini has collected all patches Sun recommends for using Java on these Solaris releases. Solaris patches is . Solaris patches can be obtained from the Oracle SunSolve site.

Installing on Solaris

  • Download the current Solaris distribution of the Phase I Tool from the Gemini ftp site (follow the link to browse the ftp directory and right or shift+click the file named pit_2014B*_solaris*).
  • Use gunzip and tar to unpack the distribution in a directory where you have at least 150 megabytes of disk space.
    gunzip -c filename | tar -xvf -
  • The distribution unpacks into a single directory named " tt>pit_2014B_2014.2.1_solaris".
  • Run the PIT. You can use the complete path to the startup script, as shown below (where the $ represents your shell prompt), or you can include that directory in your PATH.
    ${where_you_untarred}pit_2014B_2014.2.1_solaris/pit_2014B_2014.2.1


Using the Gemini Phase I Tool on Linux

The Phase I Tool can be used on most recent Linux distributions, including RedHat Enterprise, Fedora Core, and Ubuntu. (Note that you cannot use the twm window manager).

Installing on Linux

  • Download the current RedHat Linux distribution of the Phase I Tool from the Gemini ftp site (follow the link to browse the ftp directory and right or shift+click the file named pit_2014B*_linux32.tar.gz (32-bit) or pit_2014B*_linux64.tar.gz (64-bit)).
  • Use gunzip and tar to unpack the distribution in a directory where you have at least 150 megabytes of disk space.
    gunzip -c filename | tar -xvf -
  • The distribution unpacks into a single directory named "pit_2014B_2014.2.1_linux" or "pit_2014B_2014.2.1_linux64".
  • Run the PIT. You can use the complete path to the startup script, as shown below (where the $ represents your shell prompt), or you can include that directory in your PATH.
    ${where_you_untarred}pit_2014B_2014.2.1_linux/pit_2014B_2014.2.1


Using the Gemini Phase I Tool on Mac OS X

Starting with the 2011A PIT, you must have a Java 1.6 (Java 6) virtual machine installed on you machine to use the Phase I Tool. It should already be installed if you are using 10.5 to 10.7 (Leopard, Snow Leopard, Lion) and regularly use Software Update. The virtual machine will be available through the Software Update system preference panel if it isn't already installed. Java is not included with OS X 10.8 (Mountain Lion) but it can be downloaded from Apple.

The PIT will not run on PowerPC Macintosh computers since Apple does not provide Java 6 for these machines.

Installing on Macintosh OS X

  • Download the current OS X distribution of the Phase I Tool from the Gemini ftp site (follow the link to browse the ftp directory and right or shift+click the file named pit_2014B*_macos*).
  • The Macintosh OS X distribution is provided as a disk image file.
  • Use the Finder to display the directory in which you downloaded the disk image. You must have at least 30 megabytes of disk space available to install the Phase I Tool on Mac OS X.
  • Double-click on the disk image (dmg) file to open and mount it. Then drag the "Gemini PIT 2014B" application icon to the location where you want to install it (normally the Applications folder). Then unmount the disk image from the Finder.
  • Double-click on the application icon to run the Phase I Tool.