TAO/docs/Security/SSLIOP-INSTALL.html

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
   2 <html>
   3
   4   <head>
   5     <title>TAO's SSLIOP Protocol - Installation</title>
   6     <!--  -->
   7   </head>
   8
   9   <BODY text = "#000000"
  10     link="#000fff"
  11     vlink="#ff0f0f"
  12     bgcolor="#ffffff">
  13
  14     <H1>TAO's SSLIOP Pluggable Protocol - Installation</H1>
  15
  16
  17 <p>The first step for all platforms is to build and install the <A HREF="http://www.openssl.org/">OpenSSL</A>
  18   distribution. Then the TAO SSLIOP pluggable protocol library must be built according
  19   to the instructions below. Refer to the <a href="SSLIOP.html">TAO SSLIOP usage
  20   instructions</a> for details about how to use the SSLIOP pluggable protocol.
  21   See the <a href="../../../ACE-INSTALL.html#sslinstall">ACE
  22   installation notes</A> for how to build ACE_SSL after you have build OpenSSL.
  23 </p>
  24 <h3>UNIX</h3>
  25 <OL>
  26   <LI>Make sure the OpenSSL header file directory is in your compiler's include
  27     path, and that OpenSSL libraries are in your library link/load path (e.g.
  28     <font face="Courier New, Courier, mono">LD_LIBRARY_PATH</font>). If you installed
  29     OpenSSL into a set of directories unknown by the compiler, then set the following
  30     variables in your <font face="Courier New, Courier, mono">platform_macros.GNU</font>
  31     file:</LI>
  32
  33     <table width="75%" border="0" align="center">
  34       <tr>
  35         <td><font face="Courier New, Courier, mono">PLATFORM_SSL_CPPFLAGS</font></td>
  36         <td>Platform preprocessor options for OpenSSL (e.g. -I...)</td>
  37       </tr>
  38       <tr>
  39         <td><font face="Courier New, Courier, mono">PLATFORM_SSL_LDFLAGS</font></td>
  40         <td>Platform linker options for OpenSSL (e.g. -L...)</td>
  41       </tr>
  42       <tr>
  43         <td><font face="Courier New, Courier, mono">PLATFORM_SSL_LIBS</font></td>
  44         <td>Platform libraries required with OpenSSL</td>
  45       </tr>
  46     </table>
  47     <br>
  48
  49   <LI>Build ACE and TAO as described in the <A HREF="../../../ACE-INSTALL.html">ACE
  50     installation</A> instructions and the <A HREF="../../../TAO/TAO-INSTALL.html">TAO
  51     installation</A> instructions, respectively. When building ACE and TAO, add
  52     &quot;<font face="Courier New, Courier, mono">ssl=1</font>&quot; to your <font face="Courier New, Courier, mono">make</font>
  53     command line invocation, or add it to your <font face="Courier New, Courier, mono">platform_macros.GNU</font>
  54     file.</LI>
  55   <li>Build the SSLIOP pluggable protocol library in the <TT>$TAO_ROOT/orbsvcs/orbsvcs/SSLIOP</TT>
  56     directory. (<TT>ACE_ROOT</TT> environment variable should be set prior
  57     to this point), by invoking <font face="Courier New, Courier, mono">make</font>
  58     with <font face="Courier New, Courier, mono">TAO_ORBSVCS=SSLIOP</font>.</li>
  59 </OL>
  60 <h3>Microsoft Visual Studio</h3>
  61 <ol>
  62   <li>Set the OpenSSL include/header directory path under the <b><i>Directories</i></b>
  63     tab - <i><b>Include Files</b></i> setting in the <i><b>Tools-&gt;Options</b></i>
  64     dialog. A typical value would be something like: <code>openssl-0.9.6\inc32</code></li>
  65   <li>Set the OpenSSL library directory path under the <b><i>Directories</i></b>
  66     tab - <i><b>Library Files</b></i> setting in the <i><b>Tools-&gt;Options</b></i>
  67     dialog. A typical value would be something like: <code>openssl-0.9.6\out32dll</code></li>
  68   <li>Open the <code>TAOACE.dsw</code> workspace, and refer to the <a href="../../../ACE-INSTALL.html">ACE
  69     installation</a> and the <a href="../../../TAO/TAO-INSTALL.html">TAO
  70     installation</a> instructions for details on creating a <code>config.h</code>
  71     configuration header for this platform. Once the config.h file has been created,
  72     build <code>SSLIOP</code> project. All project dependencies are already set,
  73     so those projects that SSLIOP depends on will be automatically built. </li>
  74 </ol>
  75 <h3>Borland C++</h3>
  76     <p>Note: You will need perl installed on your system and available on
  77       the path to be able to build OpenSSL.
  78       <ol>
  79       <li>Obtain and unpack OpenSSL.
  80       <li><p>Apply this <A HREF="http://www.tenermerx.com/programming/corba/tao_bcb/openssl-0.9.6h-bcbpatch.tgz">patch</A>.
  81         <p>This will enable OpenSSL to build DLLs that can be used by
  82           ACE+TAO.  If you will only be doing a static build of
  83           ACE+TAO you do not need to apply this patch.
  84       <li>Open a command prompt and change to the OpenSSL directory.</li>
  85       <li>Configure OpenSSL to build by executing the command:
  86         <p><code>ms\bcb4.bat</code></li>
  87       <li>If you want to use SSL in a dynamic library build of
  88         ACE+TAO, run the command:
  89         <p><code>make -f bcbdll.mak</code></li>
  90       <li>If you want to use SSL in a static build of ACE+TAO, run the
  91         command:
  92         <p><code>make -f bcb.mak</code>
  93       <li><p>To enable SSL support in ACE+TAO you simply need to set the
  94           <code>SSL_ROOT</code> environment variable to point to the
  95           location of OpenSSL. For example:
  96         <p><code>set SSL_ROOT=c:\openssl-0.9.6h</code>
  97     </ol>
  98
  99 <p>&nbsp;</p>
 100 <p>&nbsp;</p>
 101 </body>
 102 </html>