### Building and Installing CIAO

The first thing you should do to install CIAO is to set the environment variable `CIAO_ROOT` to be `$TAO_ROOT/CIAO`, or whereever you have installed the CIAO sources. The `DANCE_ROOT` environment variable should also be set to `$CIAO_ROOT/DAnCE`, or wherever you have installed the DAnCE sources. Please refer to the ACE installation notes and TAO installation notes for instructions on setting `$ACE_ROOT` and `$TAO_ROOT`, respectively. They are needed since CIAO sits on top of ACE+TAO. Compiling ACE+TAO successfully is the first requirement for compiling CIAO.

CIAO is divided into several parts, so different installation/building rules apply to different parts of CIAO.

1. CIAO core/examples: This part of CIAO include following directories: `$CIAO_ROOT/ccm`, `$CIAO_ROOT/ciao`, `$CIAO_ROOT/examples`.
2. CIAO Deployment and Configuration Framework: This part of CIAO includes all the directories in `$CIAO_ROOT/DAnCE`. DAnCE is an implementation of the new Deployment and Configuration specification. We refer, henceforth, to all pieces as CIAO in general. This piece will be referred specifically by their name as DAnCE though they are part of CIAO.

### Supported Platforms for CIAO

CIAO should be usable on all platforms that TAO runs on. Please see TAO's installation pages for details

If you have porting questions or have a problem compiling CIAO with TAO and ACE on the platforms shown above please send email to either ACE Newsgroup or the CIAO mailing list and we'll try to help you fix the problems. You can also submit bug reports and enhancement requests in our bug tracking system.

CIAO can be obtained electronically via the WWW and ftp. CIAO is bundled with the ACE and TAO release. You'll always need the most recent version of ACE and TAO because CIAO tracks changes to ACE and TAO very closely.

### Obtaining and Installing Xerces-C

The Xerces-C XML parsing library is a necessary component to build parts of DAnCE that need to process XML based descriptor files, which include the Plan Launcher and the Repository Manager. Currently, the only Xerces-C versions supported by the DOC group is version 2.6 or later or 3.0 or later. Earlier versions of the Xerces-C library may work.

#### Building Xerces-C

You will have to obtain the source from the Xerces-C webpage and build it. Building Xerces-C is fairly straightfoward. Please see the documentation available here for instructions particular to your platform.

- NOTE: Some of the provided projects with Xerces-C attach inconsistant library decorators onto the end of the Xerces-C libraries. The MPC build tool will expect these libraries to be named xerces-c for non debug versions, and xerces-cd for debug versions.

#### Xerces-C Environment Settings

If the Xerces includes and libraries are in your system include and library paths, respectively, then you need not set up any environment and may proceed to the next step. If not, you will need to set an environment variable named XERCESCROOT to a path such that $XERCESCROOT/include points to the includes and $XERCESCROOT/lib points to the libraries. Also make sure that $XERCESCROOT/lib is in the appropriate environment variable that your platform uses to search for dynamically linked libraries.

### Install CIAO core/tools/examples

Most of the GNUmakefiles/project files/solution files required to build CIAO are available in the release. If you don't like the configurations used, please feel free to regenerate them using MPC. Please see this file for more details.

To build CIAO core/tools/examples:

1. Make sure ACE and TAO are built.
2. Make sure you have the Xerces-C libraries installed/built
3. Enable Xerces-C in default.features by setting `xerces3=1` or `xerces2=1`, depending on your version Xerces-C libraries.
4. Make sure all ACE/TAO/etc. generated libs are in `$ACE_ROOT/lib`. To build CIAO you will need:
   - `ACE`
   - `TAO`
   - `TAO_IDL`
   - `IFR_Client`
   - `IORTable`
   - `Valuetype`
   - `Security`
   - `ACEXML`
5. Generate the Makefile/Solution/Project files and build

   For the supported build tools please see MPC manual.

   You have to execute the MPC command in the following directories if you only want to build the examples and have a peek at CIAO:

   - `$CIAO_ROOT/DAnCE/`

   On Linux: do `$ACE_ROOT/bin/mwc.pl -type gnuace` at the locations specified above then `make`.

   On Windows/VC8: do `%ACE_ROOT%/bin/mwc.pl -type vc8` at the locations specified above then Open the solution file and build.

   Note: You can run `mwc.pl` at `$CIAO_ROOT.` After running the command with proper augment once then you can do `make` at `$CIAO_ROOT` (Linux) or open the workspace/solution file at `$CIAO_ROOT` (Windows) to build.

Building CIAO quickly : You can build CIAO quickly by doing the following:

- Remove all the GNUmakefiles or project files that are shipped with the release or download a source only distribution.
- Open up `$CIAO_ROOT/CIAO_TAO.mwc` .
- Run `$ACE_ROOT/bin/mwc.pl CIAO_TAO.mwc -type gnuace` from `$CIAO_ROOT` .
- Type 'make'
- This will build all the required ACE+TAO libraries including CIAO libraries and tools.

### Connectors

See this tutorial for more information on connectors.

See DDS4CCM-INSTALL for more information on how to build and install the DDS4CCM connector.

Back to the CIAO home page.