The first thing you should do to install CIAO is to set the environment
variable CIAO_ROOT
to be $TAO_ROOT/CIAO
. 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.
IMPORTANT: There are currently
TWO CIAO implementations with this distribution of the software. The
"old" CIAO is designed and implemented based on the orginal
OMG CCM 3.0 specification, the "new" CIAO is designed and implemented
based on the new OMG's
Deployment and Configuration specification. For a temporary solution, we
put the "new" CIAO implementation in the $CIAO_ROOT/DAnCE
directory,
which contains the CIAO core, CIAO examples and Deployment and Configuration
Framework. However, both the "old" one and the "new" one have the same modules
and structures, which are described as below.
(We suggest you use this "new" CIAO instead of the "old" one, since the "old"
CIAO will not be officially supported soon.)
$CIAO_ROOT/DAnCE/ciao
,
$CIAO_ROOT/DAnCE/examples
.
$CIAO_ROOT/CCF
and $CIAO_ROOT/CIDLC
.
$CIAO_ROOT/DAnCE
except the ones mentioned above.
DAnCE is an implementation of the new
Deployment and Configuration specification. We refer, henceforth, to all
pieces as CIAO in general. The above two pieces will be referred specifically
by their names as CIDLC and DAnCE though they are part of CIAO.
CIAO should be usable on all platforms that TAO runs on. Please see TAO's installation pages for details
CIDLC is supported only on a small subset of platforms. Please refer to this for details on how to build CIDLC.
For Building CIAO CIDLC CompilerFully supported, i.e., continually tested and used daily | Windows 2000/XP (VC 7.1), Linux(GCC 3.2 or higher) |
Binaries available intermittently, no automatic builds or tests | MacOS, Solaris |
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.
We suggest you download the prebuilt binary cidlc(exe)
from
here or, if you are using Windows or Linux, you can build it by
yourself.
MPC is used to build the CIDL compiler on Linux. The procedure is outlined below.
$ACE_ROOT/bin/MakeProjectCreator/config/global.features
and
set cidl=1.
$ACE_ROOT/include/makeinclude/platfrom_macros.GNU
.
boost_filesystem
, boost_regex
and Utility
Library
. For how to do that please see
Build.html.
$CIAO_ROOT/CIDLC
run $ACE_ROOT/bin/mwc.pl CIDLC.mwc
$CIAO_ROOT/CIDLC
run make
.There are 2 ways to build the CIDL compiler on Windows:
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 version supported by the DOC group is version 2.6 compiled with RTTI support. Earlier versions of the Xerces-C library may work, but only if they were built with RTTI support.
You may check here to see if there is a prebuilt binary available for your platform. Otherwise, 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.
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.
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 for more details.
To build CIAO core/tools/examples:
$ACE_ROOT/lib
. To
build CIAO you will need:
ACE
TAO
TAO_IDL
IFR_Client
IORTable
Valuetype
Security
ACEXML
$CIAO_ROOT\bin
with the
right permission setting (executable).
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
at the
locations specified above then make
.
On Windows/VC6: do %ACE_ROOT%/bin/mwc.pl -type vc6
at the locations specified above then Open the workspace file and build.
On Windows/VC71: do %ACE_ROOT%/bin/mwc.pl -type vc71
at the locations specified above then Open the solution file and build.
Note: You can run mwc.pl
at $CIAO_ROOT
as long as you don't intend to build CIDL compiler with MPC. If this is the
case(default), you can run the mwc.pl 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.
$CIAO_ROOT/CIAOTAO.mwc
.
$ACE_ROOT/bin/mwc.pl CIAOTAO.mwc
from $CIAO_ROOT
.
Back to the CIAO home page.