Patching CIAO 4.0 or 4.0.1 to CIAO 4.0.2

CIAO 4.0 Science Threads

Overview

Last Update: 16 Apr 2008 - original version: new for CIAO 4.0.2

Synopsis:

How to patch CIAO 4.0 or CIAO 4.0.1 to CIAO 4.0.2. The CIAO 4.0.2 patch is for Mac OS X 10.4 (Tiger) and 10.5 (Leopard) Intel machines only.

This thread assumes that you already have CIAO 4.0 installed. If you don't, follow the Installing CIAO 4.0 thread. That thread includes the patch installation, so you do not need to return to this thread.

You are not required to install the CIAO 4.0.1 patch before updating to CIAO 4.0.2. Version 4.0.1 may be skipped if you do not use the ObsVis proposal planning tool.

Proceed to the HTML or hardcopy (PDF: A4 | letter) version of the thread.

Downloading the Patch Files
Installing the Patch
Run the Smoke Tests
Clean Up the Tarfiles
Notes
- Known Conflicts
- Usage and Licensing
History

Downloading the Patch Files

The CIAO 4.0.2 patch files are available from the Mac OS X 10.4 and 10.5 Intel download page.

Save the tarfiles to a location that is accessible from where you wish to install CIAO and unzip them:

unix% ls -1 /some/path/ciao-4.0.2*.gz
ciao-4.0.2-patch-bin-chips-osxi.tar.gz
ciao-4.0.2-patch-bin-core-osxi.tar.gz
ciao-4.0.2-patch-bin-obsvis-osxi.tar.gz
ciao-4.0.2-patch-bin-tools-osxi.tar.gz


unix% gunzip /some/path/ciao-4.0.2*.gz

Installing the Patch

The patch unpacks into the "ciao-4.0" directory where CIAO is installed. In our example, this directory is located within /soft/; if you do not recall where your CIAO installation directory is, start CIAO and type:

unix% cd $ASCDS_INSTALL

unix% cd ..

unix% pwd
/soft/

From this directory, untar the patch files:

unix% tar xf /some/path/ciao-4.0.2-patch-bin-chips-osxi.tar

unix% tar xf /some/path/ciao-4.0.2-patch-bin-core-osxi.tar

unix% tar xf /some/path/ciao-4.0.2-patch-bin-obsvis-osxi.tar

unix% tar xf /some/path/ciao-4.0.2-patch-bin-tools-osxi.tar

Next, run the patch script.

unix% cd ciao-4.0/

unix% ./ciao_patch.sh

This installs the updated CIAO files in the correct directories. The files that are replaced are renamed ".<filename>_CIAO_4.0"; refer to the 4.0.2 README for more information.

Run the CIAO configuration script again:

Running CXC configure, v4.2.6
checking build system type... i386-apple-darwin9.2.2
checking host system type... i386-apple-darwin9.2.2
checking target system type... i386-apple-darwin9.2.2
checking for more... /usr/bin/more
checking for main in -lpthread... no
  --with-imagerdir not specified, defaulting to /export/ciao-4.0/ots/bin
configure: creating ./config.status
config.status: creating config/system/CXCdefaults
config.status: creating bin/ciao_setup.sh
config.status: creating bin/ciao.sh
config.status: creating bin/ciao.csh
config.status: creating bin/ciao.ksh
config.status: creating bin/ciao.bash
config.status: creating bin/setup_obsvis.sh
config.status: creating bin/setup_obsvis.csh
config.status: creating test/smoke/bin/setup.sh
config.status: creating test/Makefile

The patch is now installed. When you start CIAO, the version number indicates this:

CIAO configuration is complete...
 CIAO version     :  CIAO 4.0.2 Friday, March 28, 2008
 Proposal Toolkit version :  Cycle 10 Thursday, December 6, 2007
 bin dir          :  /soft/ciao-4.0/bin

Run the Smoke Tests

A set of smoke tests are packaged with CIAO 4.0. Details and instructions on how to run them are included in the Run the Smoke Tests section of the Installing CIAO thread.

Clean Up the Tarfiles

Finally, you may delete the tarfiles from the original download directory:

unix% rm /some/path/ciao-4.0.2*.tar

Notes

Known Conflicts

There are some known conflicts between CIAO and other software or system libraries and tools. They are documented in the following webpages:

Usage and Licensing

All non-OTS source code will be freely available in support of any CIAO release. The software is subject to Smithsonian Institution Copyright, a statement of which can be found in the headers of the source files, as well as at $ASCDS_INSTALL/LICENSE.SAO.

CIAO 4.0 is further governed by the GNU General Public License ($ASCDS_INSTALL/COPYING) and/or the GNU Library General Public License ($ASCDS_INSTALL/COPYING.LIB), both of which are bundled with the software.

History

16 Apr 2008

original version: new for CIAO 4.0.2