Patching CIAO 4.1 or 4.1.1 to CIAO 4.1.2

CIAO 4.1 Science Threads

Overview

Last Update: 20 Apr 2009 - original version: new for CIAO 4.1.2

Synopsis:

How to patch CIAO 4.1 or CIAO 4.1.1 to CIAO 4.1.2.

This thread assumes that you already have CIAO 4.1 installed. If you don't, follow the Installing CIAO 4.1 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.1.1 patch before updating to CIAO 4.1.2. Version 4.1.1 may be skipped if you do not need the Cycle 11 proposal planning calibration files used by PIMMS.

[New] There is a new script, ciao-install, which automates the installation and upgrade of CIAO and CALDB. The README explains how it is used. CIAO 4.1.2 contains a beta release of ciao-install; user comments on the script are welcome via Helpdesk.

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

Downloading the Patch Files

The CIAO 4.1.2 patch files are available from the CIAO download pages. Download the appropriate patch file for the platform being used.

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

unix% gunzip /some/path/ciao-4.1.2-patch-fc8.tar.gz

Installing the Patch

The patch unpacks into the "ciao-4.1" 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 file (If you prefer more screen output, add the "v" option to the tar command):

unix% tar xf /some/path/ciao-4.1.2-patch-fc8.tar

Next, run the patch script.

unix% cd ciao-4.1/

unix% ./ciao_patch.sh

The script does not print any output. It installs the updated CIAO files in the correct directories. The files that are replaced are renamed ".<filename>_CIAO_4.1.1"; refer to the 4.1.2 README for more information.

Run the CIAO configuration script again:

unix% ./configure

Running CXC configure, v4.3.4
checking build system type... x86_64-unknown-linux-gnu
checking host system type... x86_64-unknown-linux-gnu
checking target system type... x86_64-unknown-linux-gnu
checking for more... /bin/more
checking for main in -lpthread... no
  --with-imagerdir not specified, defaulting to /export/junk_dir/ciao-4.1/ots/bin
configure: creating ./config.status
config.status: creating bin/ciao_setup.sh
config.status: creating ots/lib/python2.5/config/Makefile
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 bin/setup_chips.sh
config.status: creating bin/setup_chips.csh
config.status: creating bin/setup_sherpa.sh
config.status: creating bin/setup_sherpa.csh
config.status: creating bin/setup_tools.sh
config.status: creating bin/setup_tools.csh
config.status: creating bin/ciao-python-fix
config.status: creating test/smoke/bin/setup.sh
config.status: creating test/Makefile
config.status: creating ots/etc/pango/pangorc
config.status: creating ots/etc/pango/pango.modules
config.status: creating ots/etc/gtk-2.0/gtk.immodules
config.status: creating ots/etc/gtk-2.0/gdk-pixbuf.loaders

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

CIAO configuration is complete...
 CIAO version     :  CIAO 4.1.2 Saturday, March 21, 2009
 Proposal Toolkit version :  Cycle 11 Friday, December 5, 2008
 bin dir          :  /soft/ciao-4.1/bin
 Python path      :  CIAO

Reindexing the Help Files

The patch file contains new and updated help files. In order for CIAO to be able to access the new files, it is necessary to regenerate the ahelp indexes.

Start CIAO and run ahelp -r:

unix% ciao
CIAO configuration is complete...
 CIAO version     :  CIAO 4.1.2 Saturday, March 21, 2009
 Proposal Toolkit version :  Cycle 11 Friday, December 5, 2008
 bin dir          :  /soft/ciao-4.1/bin
 Python path      :  CIAO

unix% ahelp -r

Processing file '/data/ciao-4.1/doc/xml/ChipsId.xml'...OK

Processing file '/data/ciao-4.1/doc/xml/Attributes.xml'...OK

Processing file '/data/ciao-4.1/doc/xml/ChipsDictionary.xml'...OK

....

Processed Files  : 903
Succeeded Files  : 903
Failed Files     : 0
Purged Duplicates: 0

Creating Key Indexes...DONE
Subject DB Size: 1564

Creating Context Indexes...DONE
Context DB Size: 1564

Run the Smoke Tests

A set of smoke tests are packaged with CIAO 4.1. 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 tarfile from the original download directory:

unix% rm /some/path/ciao-4.1.2-patch-fc8.tar

History

20 Apr 2009

original version: new for CIAO 4.1.2