If you're building OpenDDS for use by Java applications, please see the file $DDS_ROOT/java/INSTALL instead of this one. BUILDING OpenDDS ======================== * Supported platforms: We have built OpenDDS on number of different platforms and compilers. See $DDS_ROOT/README.md for a complete description of supported platforms. * Compiling: OpenDDS has a "configure" script to automate all steps required before actually compiling source code. This script requires Perl 5.10 or newer to be installed and available on the system PATH. Perl 5.8 may be sufficient on Unix systems but ActiveState Perl 5.10 or newer should be used on Windows. To start the script simply change to the directory containing this INSTALL file, and run ./configure (Linux, MacOSX, Solaris) configure (Windows: use a Visual Studio Command Prompt) Optionally add "--help" to the command line to see the advanced options available for this script. The configure script will download ACE+TAO and configure it for your platform. To use an existing ACE+TAO installation, either set the ACE_ROOT and TAO_ROOT environment variables or pass the --ace and --tao (if TAO is not at $ACE_ROOT/TAO) options to configure. If configure runs successfully it will end with a message about the next steps for compiling OpenDDS. The configure script creates an environment setup file called setenv (actually named setenv.sh or setenv.cmd depending on platform) that restores all the environment variables the build and test steps rely on. The main makefile for non-Windows builds temporarily sets the environment as well, so setenv.sh is not needed when running "make" from the top level. On Windows, the configure script modifies the environment of the command prompt that ran it. * Test: Optionally, you can run the entire OpenDDS regression test suite with one Perl command. NOTE: Make sure your environment is set by checking the variable DDS_ROOT. Run setenv if it is not set. bin/auto_run_tests.pl (On Windows: bin\auto_run_test.pl) If you built static libraries, add "-Config STATIC" to this command. To test RTPS features (uses multicast) add "-Config RTPS" to this command. On Windows if you build Release mode add "-ExeSubDir Release". On Windows if you build static libraries add "-ExeSubDir Static_Debug" or "-ExeSubDir Static_Release". * Installation: When OpenDDS is built using make, if the configure script was run with an argument of "--prefix=