Obtaining and Using Codes

Welcome to the download page for DDS test codes. This document describes how to obtain the latest test codes for DDS benchmarking. Note that this is a ongoing benchmark projects, so the codes and the documentations are subject to constant changes. Please contact ming xiong should you run into any problems.

Getting Started

1.Download freely available test codes

The latest test codes package can be downloaded from here. Please note that the package includes the current snapshot of the test codes, which are not well documented, so it may only serve as a reference for now. We are in the process of cleaning up our codes and adding necessary comments. It should be updated in the near future.

2.Prerequisite

Current test codes are targeted on linux platform. so make sure that you download the test codes to a linux environment. For environment information for our test, please checkout ISISLab.
To succesfully run test codes for a specific DDS implementation, you have to have the product available for each specific implementaions, some of which are not free!
Please have the latest version of ACE available, which can be obtained here, in order to build the test codes which are using timing methods provided by ACE.

Instructions for Compiling Codes

NDDS
To build and install the latest test code for NDDS, here is what you need to do:

Install the latest version of NDDS as mentioned earlier and set up the environment variables properly
Install latest version of ACE as mentioned earlier and set up the environment varaibles.
Navigate to the performance/NDDS
do 'make -f makefile_TP_Packet_i86Linux2.6gcc3.4.3'

Splice
To build and install the latest test code for Splice, here is what you need to do:

Install the latest version of Splice as mentioned earlier and set up the environment variables properly
Install latest version of ACE as mentioned earlier and set up the environment varaibles.
Navigate to the performance/Splice
do './BUILD'

TAO_DDS
To build and install the latest test code for TAO_DDS, here is what you need to do:

Download the latest version of free TAO_DDS from here as mentioned earlier and set up the environment variables properly
Install latest version of ACE as mentioned earlier and set up the environment varaibles.
Navigate to performance/TAO_DDS/TypeNoKeyBounded
make
Navigate to performance/TAO_DDS/TCP
do 'make'

Instructions for running the tests manually

NDDS
1-to-many throughput test

Set up the NDDS_DISCOVERY_PEERS on the various nodes where you deploy your applications/participants.
Start the subscribers at the subscriber nodes by doing
./objs/i86Linux2.6gcc3.4.3/subscriber -pn 100 - sn 10000 -Size [datasize: 4 - 16384] -role [unique index number starting from 1] -r [result file]
After all the subscribers are up and running, do this at the publisher side
./objs/i86Linux2.6gcc3.4.3/publisher -pn 100 - sn 10000 -Size [datasize: 4 - 16384] -r [result file]
Check the result file at each node

Splice
1-to-many throughput test

Start the subscribers at the subscriber side by doing
./start_pub.pl
Start the publisher at the publisher by doing
./start_pub.pl
Check result files

TAO_DDS
1-to-many throughput test

Choose a seperate node and run the InfoRepo service
./start_repo.pl
Start the subscribers at the subscriber side by doing
./start_pub.pl
Start the publisher at the publisher by doing
./start_pub.pl
Check result files

Instructions for running the tests using benchmark scripts

We have developed a DDS Benchmark Environment (DBE) to let you use specifially designed benchmark scripts to run the test without having to start them manually at different nodes. To run the tests using DBE, please refer to Test Suite.

DOC group welcomes you to help us improve our test codes. If you have questions and comments, please send them to ming.xiong@vanderbilt.edu

Back to DDS Web Page .