Building OCI's Distribution of ACE and TAO Revision 1.4a This file provides basic instructions for installing/building OCI's Distribution of TAO, version 1.4a, for Windows and Linux. ACE+TAO can also be used on other major modern operating systems, such as Solaris, HP-UX, AIX, and Tru64, and some real-time and embedded operating systems, such as VxWorks, LynxOS, Timesys Linux, and Windows CE. ----------------------------------------------------------------------- WINDOWS ----------------------------------------------------------------------- Hardware Requirements - CPU Speed: Intel x86 P3 500 MHz or faster - Memory: 512 MB (more memory improves compile speed) - Hard Drive Space: 256MB swap + 250 free MB Operating System Requirements - Windows 2000, 2003, or XP C++ Compiler Requirements - Microsoft Visual C++ 6.0 SP5 or 7.1 (NOT 7.0) Other Software Requirements - OCI TAO 1.4a_p5 or later (see instructions below for obtaining and installing OCI TAO) - WinZIP or similar for extracting software archives - ActiveState Perl v5.6.1 or newer (recommended, but not required) Obtaining and Installing OCI TAO 1. Download the latest patch release of OCI TAO 1.4a from: http://download.ociweb.com/TAO-1.4a/ACE+TAO-1.4a_with_latest_patches.zip 2. Extract the above archive into a path with no spaces in the path name (e.g., C:\ACE_wrappers). 3. Set ACE_ROOT, TAO_ROOT, and PATH environment variables. For example, if ACE+TAO are installed in C:\ACE_wrappers, the variables will look like this: * ACE_ROOT=C:\ACE_wrappers * TAO_ROOT=C:\ACE_wrappers\TAO * The PATH variable should contain these directories: C:\ACE_wrappers\bin;C:\ACE_wrappers\lib 4. Create a file named config.h in %ACE_ROOT%\ace with the following contents: #define ACE_DISABLE_WIN32_ERROR_WINDOWS #define ACE_HAS_STANDARD_CPP_LIBRARY 1 #define ACE_DISABLE_WIN32_INCREASE_PRIORITY #include "ace/config-win32.h" 5. If you are using Visual C++ 6.0, build the Win32 Debug configuration of ACE+TAO using the following workspace file: %TAO_ROOT%\TAOACE.dsw The projects in the TAOACE workspace build the ACE and TAO libraries, TAO IDL compiler, gperf, ORB services libraries and executables, and some common utilities. Libraries will be installed in %ACE_ROOT%\lib. Some executables will be installed in %ACE_ROOT%\bin, others (the ORB services executables) will be installed in their source directory. Note: Some projects may not build due to dependencies on 3rd-party tools/libraries (e.g., OpenSSL). If that is the case, you can either skip those projects or obtain the 3rd-party tools/libraries in question. Contact OCI support for more information. If the above file does not exist, you will need to generate it using MakeProjectCreator (MPC) (requires Perl as listed above) with the following commands: cd %TAO_ROOT% %ACE_ROOT%\bin\mwc.pl -type vc6 TAOACE.mwc 6. If you are using Visual C++ 7.1, build the Debug configuration of ACE+TAO using the following solution file: %TAO_ROOT%\TAOACE.sln The projects in the TAOACE solution build the ACE and TAO libraries, TAO IDL compiler, gperf, ORB services libraries and executables, and some common utilities. Libraries will be installed in %ACE_ROOT%\lib. Some executables will be installed in %ACE_ROOT%\bin, others (the ORB services executables) will be installed in their source directory. Note: Some projects may not build due to dependencies on 3rd-party tools/libraries (e.g., OpenSSL). If that is the case, you can either skip those projects or obtain the 3rd-party tools/libraries in question. Contact OCI support for more information. If the above solution file does not exist, you will need to generate it using MakeProjectCreator (MPC) (requires Perl as listed above) with the following commands: cd %TAO_ROOT% %ACE_ROOT%\bin\mwc.pl -type vc71 TAOACE.mwc ----------------------------------------------------------------------- LINUX ----------------------------------------------------------------------- Hardware Requirements - CPU Speed: Intel x86 P3 500 MHz or faster - Memory: 512 MB (more memory improves compile speed) - Hard Drive Space: 256MB swap + 250 free MB Operating System Requirements - Linux 2.2 (or later) kernel C++ Compiler Requirements - gcc 3.2.x (or later) Other Software Requirements - OCI TAO 1.4a_p1 or later (see instructions below for obtaining and installing OCI TAO) - GNU gunzip and GNU tar for extracting software archives - GNU make - Perl v5.6.1 or newer (recommended, but not required) Obtaining and Installing OCI TAO 1. Download the latest patch release of OCI TAO 1.4a from: http://download.ociweb.com/TAO-1.4a/ACE+TAO-1.4a_with_latest_patches.tar.gz 2. Extract the above archive into a path with no spaces in the path name (e.g., /usr/local/ACE_wrappers) 3. Set ACE_ROOT, TAO_ROOT, PATH, and LD_LIBRARY_PATH environment variables. For example, if ACE+TAO are installed in /usr/local/ACE_wrappers, the variables will look like this: * ACE_ROOT=/usr/local/ACE_wrappers * TAO_ROOT=/usr/local/ACE_wrappers/TAO * PATH will include the directory /usr/local/ACE_wrappers/bin * LD_LIBRARY_PATH will include the directory /usr/local/ACE_wrappers/lib 4. Create a file named config.h in $ACE_ROOT/ace with the following contents: #include "ace/config-linux.h" 5. Create a file named platform_macros.GNU in $ACE_ROOT/include/makeinclude with the following contents: exceptions=1 inline=1 ami=1 rt_corba=1 interceptors=1 interface_repo=1 corba_messaging=1 probe=0 profile=0 fakesvcconf=0 shared_libs_only=1 debug=1 optimize=0 include $(ACE_ROOT)/include/makeinclude/platform_linux.GNU 6. Build ACE+TAO using the following commands: cd $TAO_ROOT make The above commands will build the ACE and TAO libraries, TAO IDL compiler, gperf, ORB services libraries and executables, and some common utilities. Libraries will be installed in $ACE_ROOT/lib. Some executables will be installed in $ACE_ROOT/bin, others (the ORB services executables) will be installed in their source directory. 7. If there are no GNUmakefiles, you will need to generate them using MakeProjectCreator (MPC) (requires Perl as listed above) with the following commands: cd $TAO_ROOT $ACE_ROOT/bin/mwc.pl -type gnuace TAOACE.mwc