Last modified: December 2023

URL: https://cxc.cfa.harvard.edu/ciao/ahelp/check_ciao_version.html
AHELP for CIAO 4.16

check_ciao_version

Context: Tools::Utilities

Synopsis

Check that the CIAO and CALDB installations are up to date.

Syntax

check_ciao_version

Description

The check_ciao_version tool allows users to easily check that the CIAO and CIAO Calibration Database (CALDB) installations are up to date. It compares the dates of the installed components against the latest-released versions and prints out those elements that need upgrading. The script requires internet access since it has to download information from the CXC web site.

Tool behavior

The tool prints messages to the screen and exits with a status of 0 when everything is up to date or non-zero when something needs updating.

How do I upgrade my system: conda

The 'conda update' command can be used to update a conda-installed version of CIAO, and the script will detail the necessary arguments.

How do I upgrade my system: ciao-install

If the tool finds that your CIAO or CALDB installations are out of date then it will point you to the ciao-install download page, from which the ciao-install script can be downloaded. This script will perform the necessary updates.

Limitations

The tool does not

The CALDB check matches that done by the "--latest" flag of check_ciao_caldb, but it does not do the validation check that check_ciao_caldb does.


Examples

Example 1

unix% check_ciao_version

Up to date: conda

If the installations are up to date then you will see something like the following:

CIAO (installed via conda) is up to date.

Out of date

If there is an out of date component then you will see something like:

There is one package that need updating:
  ciao-contrib : 4.15.2 -> 4.15.3

The update can be checked with:

  conda update ciao-contrib --no-deps \
       -c https://cxc.cfa.harvard.edu/conda/ciao \
       -c conda_forge \
       --dry-run

and then repeated without the '--dry-run' option to make the change.

Example 2

unix% check_ciao_version

Up to date: ciao-install

If the installations are up to date then you will see something like the following:

The CIAO  installation at /soft/ciao is up to date.
The CALDB installation at /soft/ciao/CALDB (link to /data/CALDB/ciao) is up to date.

The actual output will vary depending on where (and how) CIAO and CALDB where installed.

Out of date

If there is an out of date component then you will see something like:

The CIAO  installation at /usr/local/ciao-4.16 is up to date.
The CALDB installation at /usr/local/ciao-4.16/CALDB
  has version: 4.10.5
  latest is:   4.10.7

Please use the ciao-install script from
    https://cxc.harvard.edu/ciao/download/ciao-install.html
to update your CIAO installation.

or

Using the CIAO installation at /opt/local/ciao-4.15

The following package:
    contrib   :  21 Jun 2023

needs updating to:
    contrib   :  21 Aug 2023

The CALDB installation at /opt/local/ciao-4.15/CALDB is up to date.

Please use the ciao-install script from
    https://cxc.harvard.edu/ciao/download/ciao_install.html
to update your CIAO installation.

Changes in the scripts 4.16.0 (December 2023) release

The script has been updated to support the new version of ciao-install and initial support for using mamba or micromamba to install CIAO.

Changes in the scripts 4.14.0 (December 2021) release

When there is an update for a conda installation the script will report the command needed to install it.

Changes in the scripts 4.13.1 (March 2021) release

Fix bug affecting ciao-install installations when checking CALDB version.

Changes in the scripts 4.13.0 (December 2020) release

The script has improved handling of the conda installation path.

Changes in the scripts 4.12.1 (December 2019) release

The script has been updated to work with CIAO installations made with the conda package manner as well as with ciao-install, although support should be considered experimental.

Changes in the scripts 4.8.1 (December 2015) release

The code has been updated to avoid warning messages from NumPy version 1.9. There is no difference to how the script behaves.

Changes in the scripts 4.6.2 (February 2014) release

The script no longer exits with an error when version files contain multiple lines, as with VERSION_graphics file in CIAO 4.6.

Changes in the April 2011 Release

The check_ciao_version script was added in this release.

About Contributed Software

This tool is not an official part of the CIAO release but is made available as "contributed" software via the CIAO scripts page. Please see this page for installation instructions.


Bugs

Error when CIAO is installed with ciao-install

[New] (12 12 2023) The script is currently broken when CIAO 4.16 was installed using the ciao-install script. Users will get an error like:

$ check_ciao_version 
# check_ciao_version (15 November 2023): ERROR [Errno 2] No such file or directory: '/soft/ciao-4.16/ciao-type'

There is no workaround at this time. Users can use the ciaover command to check the version of their installation. The script does not have the same problem when CIAO was installed using conda create.

See Also

tools::utilities
check_ciao_caldb