summaryrefslogtreecommitdiff
path: root/TAO/TAO-INSTALL.html
blob: 5e36446fe3ceefaf9575dbd2af474ac35445dc97 (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
<HTML>
<HEAD>
<TITLE>Building and Installing TAO</TITLE>
</HEAD>
<BODY text = "#000000" link="#000fff" vlink="#ff0f0f" bgcolor="#ffffff">

<HR>
<h3>Building and Installing TAO</h3>

TAO has been ported and tested Windows NT, Solaris, VxWorks, and
Linux.  I expect that major portions of the release will port easily
to other platforms that ACE has been ported to.  If you can help port
TAO to other platforms we'd appreciate it. <P>

TAO can be obtained <A
HREF="http://www.cs.wustl.edu/~schmidt/TAO-obtain.html">electronically</A>
via the WWW and ftp.  Bundled with the TAO release is
HREF="http://www.cs.wustl.edu/~schmidt/ACE.html">ACE</A>.  You will
need the most recent version of ACE because TAO tends to track changes
to ACE rather closely. <P>

A quick build note for users who have used ACE with other ORBs:
linking TAO with a version of ACE that is also linked against another
ORB vendor's library, <EM>e.g.</EM>, liborbix.so, will produce
undefined and most likely unpredictable and erroneous results. <P>

<HR><P>
<h3>On UNIX platforms</h3>

    <ol>
      <li>Set <code>ACE_ROOT</code> environment variable as outlined
      in the <a
href="http://www.cs.wustl.edu/~schmidt/ACE_wrappers/ACE-INSTALL.html">ACE
installation
      notes</a>.</li> <P>

      <li>Build and install ACE under <CODE>$ACE_ROOT</CODE>.</li> <P>

      <UL>
      <li>Change directory to <code>$ACE_ROOT/ace</code> and execute
      <code><a href="#makenotes">make</a></code>.</li> <P>
      </UL>

      <li>Set <code>TAO_ROOT</code> environment variable to
           <CODE>$ACE_ROOT/TAO</CODE>. <P>

      <li>Build and install the TAO release under <CODE>$TAO_ROOT</CODE>.</li> <P>

      <UL>
      <li>Change directory to <code>$TAO_ROOT/tao</code> and
      execute <code><a href="#makenotes">make</a></code>.</li> <P>
      </UL>

      <li>Change directory to <code>$TAO_ROOT/tests</code> and
      execute <code><a href="#makenotes">make</a></code>.</li> <P>

      <li>Follow instructions on executing the various examples under
      <code>$TAO_ROOT/tests</code>.<P>

    </ol>

    <h4><strong><a name="makenotes">A Note On Make</a></strong></h4>
    <p>
      Since TAO is built atop ACE, TAO re-uses ACE's Makefile
      structure as well.  Thus, just like ACE requires GNU Make, so
      too does TAO.  More exactly, versions of <code>make</code> which
      are known to <em>not</em> work include those from Solaris 4.x
      and 5.x, HP-UX, the latest BSD, etc.
    <p>
      GNU Make can be obtained from various places in source form.
	      

<HR><P>
<H3>On Windows NT</H3>

Before compiling <CODE>TAO_IDL</CODE> on NT, you may need to set the
environment variable <CODE>CPP_PATH</CODE> to where CL.exe is
installed on your machine.  By default, we set this variable to
"C:/Program Files/DevStudio/VC/bin".  Your location may vary, however.
Notice that if you forget to set this variable before compiling
<CODE>TAO_IDL</CODE>, you can use <CODE>CPP_LOCATION</CODE> to specify
the absolute pathname to CL.exe. We set if to "C:/Program
Files/DevStudio/VC/bin/CL.exe" when we do use it.<P>

<H4>Visual C++ 5.0</H4>

<P>It works best if TAO is placed in ACE_wrappers so TAO ends up in
<CODE>ACE_wrappers\TAO</CODE> because the Visual C++ 5.0 Project files
are set up to work in this configuration. If you move it, then make
sure you change the project file to look for the include and library
files in the correct place.</P>

<OL>
  <LI> Make sure ACE is built (For Visual C++ 5.0, use ace.dsw or ace-vc50.dsw,
       whichever is in your copy of ACE). <BR><BR>

  <LI> Load the workspace <CODE>tao\TAO.dsw</CODE> and build the TAO library. <BR><BR>

  <LI> To build the Cubit test, load the workspace <CODE>tests\Cubit\TAO\test.dsw</CODE>
       and build both client and server. <BR><BR>
</OL>

<H4>Visual C++ 4.x</H4>

<OL>
  <LI> In Tools|Options, go to the Directories page and make sure that include
       files paths includes ACE_wrappers\ and the root directory of TAO (which
       can be <CODE>ACE_wrappers\TAO</CODE> if installed there).  The
library files paths
       should include <CODE>ACE_wrappers\ace</CODE>. <P>

  <LI> Load the project file <CODE>tao\TAO.mdp</CODE> and build the
TAO library. <P>

  <LI> To build the Cubit test, load the project file <CODE>tests\Cubit\TAO\test.mdp</CODE>
       and build both client and server. <P>
</OL>

<P><HR><P>
Back to the <A HREF="http://www.cs.wustl.edu/~schmidt/TAO.html">TAO</A> home page.

<!--#include virtual="/~schmidt/cgi-sig.html" -->
</BODY>
</HTML>