Product: OpenFusion TAO

Version: ALL

Description:

How to register OpenFusion clients in the TAO Name Service?

Solution: 

To get an OpenFusion client to register itself in the TAO Name Service you will need to follow the following steps:

1. Start the TAO Name service using the command Naming_Service which you will find in the bin directory of the TAO distribution. To write the ior out to a file use the -o <filename> option. To run the TAO Name Service on a fixed port you need to use the -ORBEndPoint option. This is documented in the ORB Configuration options html supplied with the OpenFusion TAO distribution.

2. In the classes directory of the OpenFusion JacORB distribution you will need to comment out the following property:

jacorb.orb.objectKeyMap.NameService=file://C:/PrismTech/OpenFusion/domains/OpenFusion/localhost/NameService/NameSingleton/NameSingleton.ior

3. To get the correct syntax for using the corbaloc format you can run the iorDecoder tool which is in the bin directory of the OpenFusion JacORB distribution. Use the following format:

iorDecoder -corbaloc -file <Tao Name Service ior file>

The output will be something like this:

corbaloc:iiop:hostname:port/NUPNameServiceNameService

4. To run a Name Service client on the command line you need to use the following command line:

jaco Client -ORBInitRef NameService="corbaloc:iiop:host:port/NameService"

You need to use the quotes when you are on windows. The jaco command is in the bin directory of the OpenFusion JacORB distribution. You will need to have the jacorb.jar and the log4j.jar on your CLASSPATH. These are in the lib directory of the OpenFusion JacORB distribution.

5. To run an OpenFusion service, e.g the Notification Service and get it to register itself into the TAO Name Service you need to do the following:

a) Bring up the OpenFusion Administration Manager. Choose the Notification Service and go to the JVM Flags option on the Java Tag. Enter the following:

-DORBInitRef.NameService=corbaloc:iiop:host:port/NameService

b) Go to the Notification Singleton tag. Under the Corba Tag you need to fill in the IOR Name Service Entry. This is the name you want the Notification Service to register itself into the Name Service with when it starts.

Save the settings and start the Notification Service and it should register itself into the Name Service.