Chandra X-Ray Observatory
Skip to the navigation links
Last modified: 19 October 2016


Downloading CIAO 4.8.1/4.8.2

32bit Linux and OSX 10.6.8/10.7: End of Life

CIAO is no longer available for 32bit Linux nor for OSX 10.6.8 & 10.7. CIAO 4.7 is still available for users who are unable to upgrade their system. The platform support page describes the operating systems that can be used with CIAO 4.8.1.

macOS Sierra

[New] (19 Oct 2016) The CXC has done limited testing of CIAO 4.8 with the latest version of macOS 10.12, Sierra, using the pre-compiled OSX 10.11, El Captian, binaries. No problems have been found at this time; however, ierra is still not considered an officially supported platform.

The ElCapitan version of CIAO 4.8 is the only version of CIAO that works with Sierra. If users upgraded to Sierra from an older version of OSX, then CIAO will need to be reinstalled. NOTE: be sure to delete any previous ciao-install file in the Download directory before proceeding with the new installation.

Mac OS X

OSX users, particularly those that have upgraded to 10.11 from an earlier OSX version, should ensure that compatible versions of XQuartz and XCode are installed on the system before proceeding with the CIAO installation.

CIAO 4.8.2

CIAO 4.8.2 is only distributed for Mac OS X 64-bit 10.11 (El Capitan).

The CIAO 4.8.2 patch is identical to the CIAO 4.8.1 patch, with a fix on a bug introduced by the previous patch that only affects the OS X 10.11 (El Capitan) pre-compiled binaries.

Functionally, CIAO 4.8.1 and 4.8.2 are the same across platforms.

OSX 10.8 (Mountain Lion): Final Release

CIAO 4.8 will be the last version of CIAO that supports OSX 10.8, aka Mountain Lion.

Steps to install CIAO (if the following does not work then try the Manually Installing CIAO 4.8.1/4.8.2 thread):

  1. [WARNING]
    What is the download called?

    The following document assumes that the script has been downloaded with the name ciao-install. This is the default name, but the web browser may well add on a suffix (such as "(1)") to avoid overwriting an existing file. Please rename the downloaded file - or use the new name - in the following steps!

  2. Run the script that has been downloaded; this will download the requested parts of CIAO and install them on your system, and is described in more detail in the Installing CIAO 4.8.1/4.8.2 using the ciao-install script thread:

    unix% bash /<path>/ciao-install

    We strongly suggest that the smoke tests are run, the results reviewed, and that the bug page for CIAO installation is reviewed before contacting the CXC Helpdesk if there are any problems.

  3. Set up an alias to start CIAO: for example, if CIAO has been installed into the directory /soft/ciao-4.8/, then

    alias ciao "source /soft/ciao-4.8/bin/ciao.csh"

    for csh and tcsh users and

    alias ciao="source /soft/ciao-4.8/bin/ciao.bash"

    for bash users.

  4. This alias should then be called in the terminal in which you plan to use CIAO (multiple terminals can be set up to use CIAO at the same time). When called, a version message will be displayed and then the parts of CIAO that were downloaded - such as tools or Sherpa - will be available:

    unix% ciao
    CIAO configuration is complete... 
    CIAO 4.8 Thursday, January 28, 2016
      bindir      : /soft/ciao-4.8/bin
      CALDB       : 4.7.2

    Please review the notes on starting and installing CIAO for potential conflicts between CIAO and other systems, such as XMM SAS and HEASoft.

  5. Once CIAO has been started, the MARX suite of tools for simulating the on-orbit performance of Chandra can be downloaded and installed with the install_marx script (it can be installed at any time). The script takes a single argument, the location to install MARX. Change /soft/marx to a suitable location:

    unix% install_marx /soft/marx
    Some users have reported problems with MARX built with the default llvm/clang compilers on OSX. More information about the problem can be found on the Downloading and Installing Marx page.

    An alias can be created to set the MARX environment. For instance

    alias setup_marx "source /soft/marx/marx_setup.csh"

    for csh and tcsh users and

    alias setup_marx="source /soft/marx/"

    for bash users.

Would you like to receive Chandra and CIAO announcements?
Send an email message to:

Last modified: 19 October 2016
Smithsonian Institute Smithsonian Institute

The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory. 60 Garden Street, Cambridge, MA 02138 USA.   Email: Smithsonian Institution, Copyright © 1998-2016. All rights reserved.