diff options
Diffstat (limited to 'TAO/CIAO/CIAO-INSTALL.html')
-rw-r--r-- | TAO/CIAO/CIAO-INSTALL.html | 199 |
1 files changed, 199 insertions, 0 deletions
diff --git a/TAO/CIAO/CIAO-INSTALL.html b/TAO/CIAO/CIAO-INSTALL.html new file mode 100644 index 00000000000..3e3944ab08f --- /dev/null +++ b/TAO/CIAO/CIAO-INSTALL.html @@ -0,0 +1,199 @@ +<!-- $Id$ --> +<HTML> +<HEAD> + <TITLE>Building and Installing CIAO</TITLE> + <link rev=made href="mailto:schmidt@cs.wustl.edu"> +</HEAD> + +<BODY text = "#000000" + link = "#000fff" + vlink = "#ff0f0f" + bgcolor = "#ffffff"> + +<HR><P> +<H3>Building and Installing CIAO</H3> + +The first thing you should do to install CIAO is to set the +environment variable <CODE>CIAO_ROOT</CODE> to be +<CODE>$TAO_ROOT/CIAO</CODE>. Please refer to the <a +href="../../ACE-INSTALL.html">ACE installation notes</a> and <a +href="../TAO-INSTALL.html">TAO installation notes</a> for instructions +on setting <CODE>$ACE_ROOT</CODE> and <CODE>$TAO_ROOT</CODE>, +respectively. They are needed since CIAO sits on top of +ACE+TAO. Compiling ACE+TAO successfully is the <STRONG> first +</STRONG> requirement for compiling CIAO. + +<P>CIAO is divided into several parts, so different +installation/building rules apply to different parts of CIAO. +<br> +<br> +<font color=#ff0000>IMPORTANT</font>: There are currently +<font color=#ff0000>TWO</font> CIAO implementations with this +distribution of the software. The "old" CIAO is designed and implemented +based on the orginal <a +href="http://www.omg.org/cgi-bin/doc?formal/02-06-65"> +OMG CCM 3.0 specification</a>, the "new" CIAO is designed and implemented +based on the new <a +href="http://www.omg.org/cgi-bin/doc?ptc/2003-07-02"> OMG's Deployment and +Configuration specification</a>. For a temporary solution, we put the "new" +CIAO implementation in the <code>$CIAO_ROOT/DAnCE</code> 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. +<br><br> +(We suggest you use this "new" CIAO instead of the "old" one, since the +"old" CIAO will not be officially supported soon.) + +<OL> + + <LI>CIAO core/examples: This part of CIAO include following directories: + <CODE>$CIAO_ROOT/DAnCE/ciao</CODE>, <CODE>$CIAO_ROOT/DAnCE/examples</CODE>.<P> + + <LI>CIDL Compiler: This part of CIAO include + <CODE>$CIAO_ROOT/CCF</CODE> and <CODE>$CIAO_ROOT/CIDLC</CODE>.<P> + + <LI>CIAO Deployment and Configuration Framework: This part of CIAO + includes all the directories in <CODE>$CIAO_ROOT/DAnCE</CODE> except + the ones mentioned above. DAnCE is an + implementation of the new <a + href="http://www.omg.org/cgi-bin/doc?ptc/2003-07-02"> Deployment and + Configuration</a> 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. + +</OL> + + +<HR> +<H3>Supported Platforms for CIAO</H3> + +<p>CIAO should be usable on all platforms that TAO runs on. Please see +<a href="../TAO-INSTALL.html"> TAO's installation</a> pages for details<P> + +<H3>Supported Platforms for CIDLC</H3> +<p> CIDLC is supported only on a small subset of platforms. Please +refer to <a href="CCF/Documentation/Build.html"> this</a> for details +on how to build CIDLC. +<p> +<table width="100%" border=1> + <tr><b>For Building CIAO CIDLC Compiler</b></tr> + <tr> + <td><b>Fully supported, i.e., continually tested and used daily</b></td> + <td>Windows 2000/XP (VC 7.1), Linux(GCC 3.2 or higher) + </td> + </tr> + +</table> + +<P>If you have <A HREF="../../docs/ACE-porting.html">porting +questions</A> or have a problem compiling CIAO with TAO and ACE on the +platforms shown above please send email to either <A +HREF="news:comp.soft-sys.ace">ACE Newsgroup</A> or the <A +HREF="mailto:ciao-users@cs.wustl.edu">CIAO mailing list</A> and we'll +try to help you fix the problems. You can also submit bug reports and +enhancement requests in our +<a href="../../docs/usage-bugzilla.html">bug tracking system</a>.<P> + +CIAO can be obtained <A +HREF="http://www.dre.vanderbilt.edu/Download.html">electronically</A> +via the WWW and ftp. <A +HREF="http://www.dre.vanderbilt.edu/CIAO">CIAO</A> 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. <P> + +<HR><P> +<H3>Install CIDL Compiler</H3> + + <P>We suggest you download the binary <CODE>cidlc(exe)</CODE> from + <STRONG><A HREF="http://www.dre.vanderbilt.edu/cidlc/binary">here</A></STRONG> + if you are using Windows or Linux, or you can build it by yourself.<P> + + <P><a href="../../MPC/README"> MPC</a> is used to build the CIDL + compiler on <Strong>Linux</STRONG>. The procedure is outlined + below. + <P> + <UL> + <LI> Open up + <CODE>$ACE_ROOT/bin/MakeProjectCreator/config/global.features + </CODE> and set cidl=1. + <LI> Make sure you set cidl=1 in + <CODE>$ACE_ROOT/include/makeinclude/platfrom_macros.GNU</CODE>. + <LI>Install <code>boost_filesystem</code>, <code>boost_regex</code> and <code>Utility Library</code>. For how to do that please see <a href="./CCF/Documentation/Build.html">Build.html</a>. + <LI>In <code>$CIAO_ROOT/CIDLC</code> run <code>$ACE_ROOT/bin/mwc.pl CIDLC.mwc</code> + <LI>In <code>$CIAO_ROOT/CIDLC</code> run <code>make</code>. + <br>Note: The linking time is a bit long (more than 5 Minutes with an Intel XEON 1.90GHZ CPU, please be patient). + </UL> + + <P>There are 2 ways to build the CIDL compiler on <Strong>Windows</STRONG>:<P> +<OL> + <LI>Use the provided Visual Studio solution/project file. For detail please see <a href="./CCF/Documentation/Build.html">Build.html</a><p> + + <LI>Use MPC: (Not supported yet) +</OL> + +<HR><P> +<H3>Install CIAO core/tools/examples </H3> + + <P>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 <a href="../../MPC/README"> this </a> for more + details. </p> +<p> + +To build CIAO core/tools/examples: + +<OL> + <LI>Make sure ACE and TAO are built. <P> + + <LI>Make sure all ACE/TAO/etc. generated libs are in <code>$ACE_ROOT/lib</code>. To build CIAO you will need: + +<ul > + <li><code>ACE</code></li> + <li><code>TAO</code></li> + <li><code>TAO_IDL</code></li> + <li><code>IFR_Client</code></li> + <li><code>IORTable</code></li> + <li><code>Valuetype</code></li> + <li><code>Security</code></li> + <li><code>ACEXML</code></li> +</ul><p> + + <LI>Make sure you have cidlc or cidlc.exe in <CODE>$CIAO_ROOT\bin</CODE> with the right permission setting (executable).<p> + + <LI>Generate the Makefile/Solution/Project files and build<P> + For the supported build tools please see <a href="http://downloads.ociweb.com/MPC/MakeProjectCreator.pdf">MPC manual</a>.<P> + 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: + <UL> + <LI> <code>$CIAO_ROOT/DAnCE/ + </UL><P> + + + On <STRONG>Linux</STRONG>: do <code>$ACE_ROOT/bin/mwc.pl</code> at the locations specified above then <code>make</code>.<P> + + On <STRONG>Windows/VC6</STRONG>: do <code>%ACE_ROOT%/bin/mwc.pl -type vc6</code> at the locations specified above then Open the workspace file and build.<P> + + On <STRONG>Windows/VC71</STRONG>: do <code>%ACE_ROOT%/bin/mwc.pl -type vc71</code> at the locations specified above then Open the solution file and build.<P> + + <Strong>Note:</Strong> You can run <code>mwc.pl</code> at <code>$CIAO_ROOT</code> 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 <code>make</code> at <code>$CIAO_ROOT</code> (Linux) or open the workspace/solution file at <code>$CIAO_ROOT</code> (Windows) to build. +</OL> + + <STRONG> Building CIAO quickly </STRONG>: You can build CIAO + quickly by doing the following: + <LI> Remove all the GNUmakefiles or project files that are shipped + with the release. </LI> + <LI> Open up <CODE> $CIAO_ROOT/CIAOTAO.mwc </CODE>. + <LI> Run <CODE>$ACE_ROOT/bin/mwc.pl CIAOTAO.mwc</CODE> from <CODE> + $CIAO_ROOT </CODE>. </LI> + <LI> Type 'make' </LI> +This will build all the required ACE+TAO libraries including CIAO +libraries and tools. +<P><HR><P> +Back to the <A HREF="http://www.cs.wustl.edu/~schmidt/CIAO.html">CIAO</A> home page. + +<!--#include virtual="/~schmidt/cgi-sig.html" --> +</BODY> +</HTML> |