GoGui: Workspace Scenarios

Overview. GoGui is a GUI-based build tool for use with SConscript builds. Effective use of GoGui depends on:

• Access to the cvs repository.
• Access to the external libraries.
• A working installation of SCons.

For development purposes, you will also need access to:

• A base release, i.e., a source distribution of a supported container package such as ScienceTools or GlastRelease.

Note: At the time of this writing (09-08-2010), the SCons version of GlastRelease was not yet available.

There are five basic scenarios for setting up to work with GoGui: three for SLAC Central Linux and two for Desktop Installations.

• Scenario 1: SLAC Central Linux
  - Link to a base release; link to external libraries.

Primary Advantages:

• Minimum memory and download/install time required; you simply link to a base release and to the external libraries for that release, check out the subpackage(s) you plan to work with, then build and test against the base release(s) and external libraries to which you've linked.

• GoGui and SCons installations are maintained and readily available on SLAC Central Linux by issuing the commands GoGui or Scons.

See Implementing Scenario 1.

• Scenario 2: SLAC Central Linux
  - Install a base release in your work area; link to external libraries.

Primary Disadvantage: Requires a lot of memory and significant download/install time.

Both the GUI and Command Line Installers are readily available on SLAC Central Linux:

• Glast Software Installer (i.e., the GUI installer). To launch the GUI installer, issue the command:
• Command Line Installer. The command line installer for the SCons Release Manager is located in the SCons-installer package in the CVS repository.

Be aware that the Glast Software Installer will create a top-level folder (e.g. ScienceTools-09-17-00) and install the designated build in that folder; the Command Line Installer will install the build in whatever directory you specify.

See Implementing Scenarios 2 or 3.

• Scenario 3: SLAC Central Linux
  - Install everything (base release and external libraries) in your work area.

Primary Disadvantages: Requires even more memory; download/install time.

See Implementing Scenarios 2 or 3.

• Scenario 4: Desktop Installation
  - Install base release and external libraries on your desktop computer.

You can download and install copies of the packages and external libraries that work area using either the Glast Software Installer or the Command Line Installer.

Note: The Command Line Installer is available only for linux machines.

Primary Advantage:

• Desktop installations are particularly advantageous if connectivity to SLAC Central Linux is a problem.

Primary Disadvantages:

• Memory requirements and download/install time.

• You must have a working installation of SCons on your machine.

Note: You will also need to download and install GoGui.

See Implementing Scenarios 4 or 5.

• Scenario 5: Desktop Installation
  - Install base release on your desktop machine; link to the external libraries.

Limitation: You can do this only if you are working on a Linux desktop machine at SLAC.

See Implementing Scenarios 4 or 5.