summaryrefslogtreecommitdiff
path: root/TAO/CIAO/CIAO-INSTALL.html
blob: f88dc434cf98179f001865d54977bc413ba22cf4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
<!-- $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.

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

  <LI>CIAO core/tools/examples: This part of CIAO include following directories: <CODE>$CIAO_ROOT/ciao</CODE>, <CODE>$CIAO_ROOT/tools</CODE> ,<CODE>$CIAO_ROOT/examples</CODE> and all other directories in <CODE>$CIAO_ROOT</CODE> <STRONG>except</STRONG> those listed in the two bullets below.<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 Assembly Framework: This part of CIAO include <CODE>$CIAO_ROOT/DnC</CODE> and we are working on the implementation now. So you can just ignore this part for now.

</OL>


<HR>
<H3>Supported Platforms for CIAO</H3>

<p>The following table summarizes platforms on which CIAO runs:<P>

<table width="100%" border=1>

  <tr><b>For CIAO core/tools/examples</b></tr>
  <tr valign=top>
    <td><b>Fully supported, i.e., continually tested and used daily</b></td>
    <td>Solaris 2.5, 2.6, 7, and 8, Windows NT/2000/XP (6.x, and 7.1 and
        Borland C++ Builder 4, 5, and 6), Linux/Intel, Linux/Alpha, VxWorks, LynxOS,
        Digital UNIX 4.0 and 5.0, IRIX 6.x, and QNX Neutrino 2.0
    </td>
  </tr>
  <tr valign=top bgcolor="#AFAFAF">
   <td><b>Nearly fully supported, i.e., periodically tested</b></td>
   <td>Windows 9x/ME, HP/UX 10.x and 11.x, AIX 4.x
   </td>
  </tr>
  <tr valign=top>
    <td><b>Partially supported, i.e., infrequently tested</b></td>
    <td> FreeBSD, NetBSD, SunOS 4.x, Chorus
    </td>
  </tr>
  <tr valign=top bgcolor="#AFAFAF">
    <td><b>Planned support, i.e., pending</b></td>
    <td> pSoS, MVS, Windows CE, Tandem, SCO, UnixWare </td>
  </tr>
</table>

<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>Any UNIX/POSIX/Win32 variation is a potential target platform for
ACE.  If you have <A
HREF="../docs/ACE-porting.html">porting
questions</A> or have a problem compiling the ACE wrappers 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:ace-users@cs.wustl.edu">ACE 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://deuce.doc.wustl.edu/Download.html">electronically</A>
via the WWW and ftp.  <A
HREF="http://www.cs.wustl.edu/~schmidt/ACE.html">ACE</A> is bundled
with the TAO and CIAO release.  You'll always need the most recent version of
ACE because CIAAO tracks changes to ACE and TAO very closely. <P>

<HR><P>
<H3>Install CIDL Compiler</H3>

  <P>You can choose to either download the binary <CODE>cidlc(exe)</CODE> from <STRONG><A HREF="http://www.dre.vanderbilt.edu/cidlc/binary">here</A></STRONG> or to build it by yourself.<P>

  <P>There are 3 ways to build the CIDL compiler on <Strong>Linux</STRONG>:<P>
<OL>
  <LI>Use GNU Make utility. For details please see <a href="./CCF/Documentation/Build.html">Build.html</a><p>

  <LI>Use ACE Make uitility.<P>
      <UL>
         <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>Type <code>make</code> in <code>$CIAO_ROOT/CCF</code> and <code>$CIAO_ROOT/CIDLC</code>.<p>
      </UL>
  <LI>Use MPC:
     <P>
     <UL>
        <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>2. In <code>$CIAO_ROOT/CIDLC</code> run <code>$ACE_ROOT/bin/mwc.pl CIDLC.mwc</code>
        <LI>3. 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>
</OL>

  <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>CIAO requires the user to use MPC to generate the Makefiles/Project files/Solution files.</p>
  <STRONG>NOTE:</STRONG> If you use the provided Makefile/Project files to build ACE/TAO etc, all the generated libraries will be put in <CODE>$ACE_ROOT/ace</CODE>, however, since MPC  looks for those LIBS in <CODE>$ACE_ROOT/lib</CODE>, so you have to copy all the generated libraries from <CODE>$ACE_ROOT/lib</CODE> to <CODE>$ACE_ROOT/lib</CODE>.<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/ciao</code>
     <LI> <code>$CIAO_ROOT/tools</code>
     <LI> <code>$CIAO_ROOT/examples</code>
   </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/VC7</STRONG>: do <code>%ACE_ROOT%/bin/mwc.pl -type vc7</code> at the locations specified above then Open the solution 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>

<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>