Installing

POSIX/Linux Installation of DDS Community Edition

Install

  1. Unzip and untar the distribution file. This will create a local directory HDE and beneath that a directory named to correspond to the target platform for the distribution. I.e. <target_platform>
  2. Replace the token @@INSTALLDIR@@ with the absolute path of the current working directory in the file ./HDE/<target_platform>/release.com

For example (Linux):

gtar -xzf <distrib_tar_file>
sed -i "s|@@INSTALLDIR@@|$PWD|g" HDE/<target_platform>/release.com

Example:

$ gtar -xzf OpenSpliceDDSV4.1.090513-x86.linux2.6-gcc412-gnuc25-HDE.tar.gz

$ sed -i "s|@@INSTALLDIR@@|$PWD|g" HDE/x86.linux2.6/release.com

$ echo $PWD 

/home/my_user

$ cat HDE/x86.linux2.6/release.com 

echo "<<< OpenSplice HDE Release V4.1.090513 For x86.linux2.6, Date 2009-05-13 >>>"

OSPL_HOME="/home/my_user/HDE/x86.linux2.6"

OSPL_TARGET=x86.linux2.6

PATH=$OSPL_HOME/bin:$PATH

LD_LIBRARY_PATH=$OSPL_HOME/lib:$LD_LIBRARY_PATH

CPATH=$OSPL_HOME/include:$OSPL_HOME/include/sys:$CPATH

OSPL_TMPL_PATH=$OSPL_HOME/etc/idlpp

OSPL_URI=file://$OSPL_HOME/etc/config/ospl.xml

CLASSPATH=$CLASSPATH:$OSPL_HOME/jar/dcpssaj.jar

export OSPL_HOME OSPL_TARGET PATH LD_LIBRARY_PATH CPATH OSPL_TMPL_PATH OSPL_URI CLASSPATH

$

Configure environment

  1. Configure the environment for TAO and / or JacORB, if, and only if, you intend to use the CORBA co-habitation features of OpenSplice (see below).
  2. Add the bin directory of a Java2 SDK (JDK 1.5 minimum required) if you intend to use the Java language binding of OpenSplice.
  3. Source the release.com script that was edited during installation.
... <assumes TAO / JacORB environment is already set / not required>...
export PATH=<Java SDK install dir>/bin:$PATH
source HDE/<target_platform>/release.com

Example:

 

Note: N.B. This example includes setting up the Java and also TAO code generation environments.

 

$ export TAO_ROOT=$PWD/tao161

$ export PATH=$TAO_ROOT/bin:$PATH

$ export LD_LIBRARY_PATH=$TAO_ROOT/lib:$LD_LIBRARY_PATH 

$ export SPLICE_ORB=DDS_OpenFusion_1_6_1

$ export PATH=/usr/local/jdk1.5.0_15/bin:$PATH

$ source $PWD/HDE/x86.linux2.6/release.com

<<< OpenSplice HDE Release V4.1 For x86.linux2.6, Date 2009-04-14 >>>


Windows Installation of DDS Community Edition

Install

  1. Extract the distribution zip file using Windows Explorer or a similar utility.
  2. Execute the Visual Studio Redistributable installer HDE\x86.win32\redist\vcredist_x86\vcredist_x86.exe

Configure environment

  1. Open a windows command prompt
  2. Configure the environment for TAO and / or JacORB, if you intend to use the CORBA co-habitation features of OpenSplice (see below).
  3. Add the bin directory of a Java2 SDK (JDK 1.5 minimum required) if you intend to use the Java language binding of OpenSplice.
  4. Run the release.bat script that is located in the installed distribution to set the other required environment variables.
... <assumes TAO / JacORB environment is already set / not required>...
set PATH=<Java SDK install dir>\bin;%PATH%
HDE\x86.win32\release.bat

Example:

NOTE: N.B. This example includes setting up the Java and also TAO code generation environments.

C:\ospl>set TAO_ROOT=C:\ospl\TAO161_0-Windows-vc8-inline-32bit-090505

C:\ospl>set PATH=%TAO_ROOT%\bin;%PATH%

C:\ospl>set JAVA_HOME="c:\Program Files\Java\jdk1.6.0_14"

C:\ospl>set PATH=%JAVA_HOME%\bin;%PATH%

C:\ospl>HDE\x86.win32\release.bat

"<<< OpenSplice HDE Release V4.1.1 For x86.win32, Date 2009-06-04 >>>"

 


 

Installation of Optional DDS Community Edition Third Party Tools

DDS Community Edition can optionally be used in conjunction with a variety of CORBA ORBs. This enables the sharing of IDL data types between CORBA and DDS applications in the same process space. If you wish to build or use DDS Community Edition with this capability then you should follow the instructions below to install and configure the required dependencies. If you do not wish to use DDS Community Edition in this manner these tools are not required.

Approved and tested distributions of these ORBs are freely available under their respective OSS licenses from the community downloads page.

TAO 1.6.1.0 C++ ORB

NOTE: Installation of TAO is only required if you intend to use, or wish to build, the CORBA collocation C++ binding.

TAO POSIX / Linux Installation

Untar the TAO distribution tar file and run the install script to install to an absolute directory path.

tar -xf <distrib_tar_file>
./install.sh <abs_inst_path>

Example:

$ tar -xf TAO161_0-Linux-gcc344-inline-32bit-090414.tar 

$ ./install.sh $PWD/tao161

Unzipping tar

Extracting tar

Done

$

TAO POSIX / Linux Environment Configuration

To configure the runtime environment for TAO you should:

  1. Define the environment variable $TAO_ROOT to be the installation directory of TAO.
  2. Add the installation bin directory to the $PATH
  3. Add the lib directory to the $LD_LIBRARY_PATH
  4. Define the SPLICE_ORB environment variable to specify that OpenSplice DDS should use this ORB.
export TAO_ROOT=<TAO_install_dir>
export PATH=$TAO_ROOT/bin:$PATH
export LD_LIBRARY_PATH=$TAO_ROOT/lib:$LD_LIBRARY_PATH
export SPLICE_ORB=DDS_OpenFusion_1_6_1

Example:

$  export TAO_ROOT=$PWD/tao161

$  export PATH=$TAO_ROOT/bin:$PATH

$  export LD_LIBRARY_PATH=$TAO_ROOT/lib:$LD_LIBRARY_PATH 

$  export SPLICE_ORB=DDS_OpenFusion_1_6_1

Verify TAO installation on POSIX / Linux

Verify the TAO installation by running the tao_idl IDL compiler.

tao_idl -V

Example:

$ tao_idl -V

tao_idl

TAO_IDL_FE, version 1.6.1 (Based on Sun IDL FE, version 1.3.0)

PrismTech Build No: OpenSpliceDDS v4.1 UNSUPPORTED 

PrismTech Version No: TAO 1.6.1.0

 PreProcessor is g++

 Compiler is g++ 3.4.4

 Platform is Linux 2.6.9-22.ELsmp i686

 Library  is inline

TAO_IDL_BE, version 1.6.1

$

TAO Windows Installation

Unzip the TAO distribution zip file.

TAO Windows Environment Configuration

To configure the runtime environment for TAO you should:

  1. Define the environment variable %TAO_ROOT% to be the installation directory of TAO.
  2. Add the installation bin directory to the %PATH%
set TAO_ROOT=<TAO_install_dir>
set PATH=%TAO_ROOT%\bin;%PATH%

Example:

C:\ospl>set TAO_ROOT=C:\ospl\TAO161_0-Windows-vc8-inline-32bit-090505

C:\ospl>set PATH=%TAO_ROOT%\bin;%PATH%

Verify TAO installation on Windows

Verify the TAO installation by running the tao_idl IDL compiler.

tao_idl -V

Example:

C:\ospl>tao_idl -V

tao_idl

TAO_IDL_FE, version 1.6.1 (Based on Sun IDL FE, version 1.3.0)

PrismTech Build No: OpenSpliceDDS_v4.1_UNSUPPORTED

PrismTech Version No: TAO 1.6.1.0

 PreProcessor is CL.EXE

 Compiler is Microsoft Visual C++ 8.0 (2005)

 Platform is Microsoft Win32

 Library  is inline

TAO_IDL_BE, version 1.6.1

C:\ospl>

JacORB 2.3.0 Java ORB

NOTE: Installation of JacORB is only required if you intend to use or build the CORBA collocation Java binding.

JacORB POSIX / Linux Installation

Unzip and untar the JacORB distribution gzipped tar file. Then run the Setup.jar with a Java 5, or later, VM to install JacORB to a local absolute directory path.

tar -xzf <distrib_tar_file>
java -jar Setup.jar <abs_inst_path>

Example:

$ tar -xzf JacORBv2.3.0.3_SDK1.5_OpenSplice.tar.gz 

$ java -jar Setup.jar $PWD/JacORBv2.3.0.3

Loading JarSetup...done

Installing Packages.................................................done

Merging jars................................................done

$

JacORB POSIX / Linux Environment Configuration

To configure the runtime environment for JacORB you should:

  1. Define the environment variable $JACORB_HOME to be the installation directory of JacORB.
  2. Add the installation bin directory to the $PATH
export JACORB_HOME=<JacORB_install_dir>
export PATH=$JACORB_HOME/bin:$PATH

Example:

$  export JACORB_HOME=$PWD/JacORBv2.3.0.3

$  export PATH=$JACORB_HOME/bin:$PATH

Verify JacORB installation on POSIX / Linux

Verify the JacORB installation by running the version tool.

version

Example:

$ version

OpenFusion OSPL UNSUPPORTED Version 4.2.5 (Build V081125)

JacORB-2.3.0.3 ; PrismTech OSPL UNSUPPORTED Build V081125-15 (JDK Build with Security) 

[Linux/2.6.18-53.el5PAE/i386]

[JDK1.5.0_15/Sun Microsystems Inc.]

JacORB Windows Installation

Unzip the JacORB distribution zip file extracting the Setup.jar file. Then run the Setup.jar with a Java 5, or later, VM to install JacORB to a local absolute directory path.

java -jar Setup.jar <abs_inst_path>
Example:

C:\>java -jar Setup.jar "%ProgramFiles%\JacORB_v2.3.0.3"

Loading JarSetup...done

Installing Packages.................................................done

Merging jars................................................done

C:\>

JacORB Windows Environment Configuration

To configure the runtime environment for JacORB you should:

  1. Define the environment variable %JACORB_HOME% to be the installation directory of JacORB.
  2. Add the installation bin directory to the %PATH%
set JACORB_HOME=<JacORB_install_dir>
set PATH=%JACORB_HOME%\bin;%PATH%

Example:

C:\>set JACORB_HOME=%ProgramFiles%\JacORB_v2.3.0.3

C:\>set PATH=%JACORB_HOME%\bin;%PATH%

Verify installation on Windows

Verify the JacORB installation by running the version tool.

version

Example:

C:\>version

OpenFusion OSPL UNSUPPORTED Version 4.2.5 (Build V081125)

JacORB-2.3.0.3 ; PrismTech OSPL UNSUPPORTED Build V081125-15 (JDK Build with Sec

urity)

[Windows XP/5.1/x86]

[JDK1.6.0_15/Sun Microsystems Inc.]

C:\>