Author: Giovanni Rimassa (University of Parma), Tiziana Trucco (CSELT S.p.A.)
Date: December 18, 2000
Java platform: Sun JDK 1.2 Windows
JADE version 2.1
Since JADE 2.1, FIPA-compliant Message Transport Protocols can be plugged and activated at run-time on any JADE container. By default, the ORB implementation of Sun is launched on the Main Container of the platform. However, in alternative, the ORBacus implementation is also available. This tutorial describes how to install and use this ORBacus implementation in JADE. The ORBacus based IIOP MTP supports three kinds of addresses, corresponding to three different ways to describe a CORBA Object Reference in String form.
- IOR: addresses
These addresses have the form:
IOR:Hex digits
where the hexadecimal digits are simply a string representation of the memory dump of a CORBA data structure, containing all the information needed to find and contact a CORBA object. This address kind is the most widely supported, and it’s the most complete one (it can contain multiple transport profiles, character set informations, and so on). Its only disadvantage is not being human readable: in particular, in a TCP/IP environment, special utilities need to be used to extract the host name and port number from an IOR (which could be useful for network configuration purposes). - corbaloc: addresses
These addresses have the form:
corbaloc:proto:hostname:port/objectID
and try to represent a CORBA Object Reference just like an HTTP URL. They can be easily read, but they lose a lot of information with respect to IOR form, and they make only sense in a TCP/IP environment. The proto part denotes the transport protocol to be used, and it’s optional, defaulting to ‘iiop’; the hostname and port parts define the IP host and the TCP port where a suitable IIOP message must be sent in order to contact the CORBA object. The objectID part identifies a specific CORBA object (usually, selecting the host and the port will at most select an object adapter). Supporting this kind of addresses breaks the server-side source code portability that wasthe ultimate goal of the POA specification, because there is no concept of ‘port’ in the POA, to keep transport protocol independence: so, this ORBacus based MTP uses ORBacus-specific extensions to select the TCP port when requested, and creates a different POA for each TCP port. - corbaname: addresses
These addresses have the form:
corbaname::NShostname:NSport/NSName#objBinding
and use the CORBA COS Naming Service as an indirection level, to reach a CORBA object that was previously bound into a COSNaming Server. The NShostname and NSport parts define the IP host and TCP port where an implementation of theCOSNaming::NamingContext
IDL interface is listening. The NSName identifies the specific implementation (it defaults to “NameService“). The objBinding part, then, describes the binding in theNamingContext
object, from where the actual CORBA object implementing theFIPA::MTS
interface can be retrieved. Following the CORBA Interoperable Naming Service specification, theobjBinding
string can contain ‘.’ and ‘/’, to specify the ‘id’ and ‘kind’ fields of aCOSNaming::NameComponent
, and to describe paths ofCOSNaming::NameComponent
objects. When activating acorbaname:
address, this MTP implementation creates a newFIPA::MTS
object and binds it into the given Naming Server. Likewise, when deactivating thecorbaname:
address, the binding is removed from the Naming Server.
When a JADE container is started, it is possible to activate one ore more communication endpoints on it.
In order to use ORBACUS ORB the following steps must be performed:
- Download from the OOC web site www.ooc.com version 4 of Orbacus for JAVA. At the web site it ‘s possible to download the complete source code or the precompiled jar files for the ORBacus. So far, JADE has been tested with version 4.0.3.
- Download from the JADE site the add-on Orbacus in the download area of JADE.
- You can compile the JADE add-on by using its batch file or directly use the included jar file. Notice that if you downloaded the source code then you would also need the jidl (ORBacus IDL compiler).
- set the classpath to include the OB.jar (from ORBacus) and the iiopOB.jar (JADE add-on). NOTICE THAT conflict may arise between the Sun version and ORBacus version if you included also the iiop.jar. This implies that on each container only one of the two ORB must be used.If you want to use
corbaname:
addresses, you also have to include in your CLASSPATH the fileOBNaming.jar
(ORBacus COS Naming Service, available from www.ooc.com
At this point in time, an IIOP endpoint that uses an ORBacus-based IIOP MTP can be activated. There are two ways available to activate it:
- From the command line when you start a JADE container. In this case the following parameter must be specified on the command line. The following line activates a
corbaloc:
address:-mtp orbacus.MessageTransportProtocol(corbaloc:iiop:hostname:port/name)
The following line activates acorbaloc:
address:-mtp orbacus.MessageTransportProtocol(corbaname::NShostname:NSport/NSname#objBinding)
- From the GUI of the RMA as specified later in this tutorial
For corbaloc:
and corbaname:
addresses, the IIOP address where the platform must listen to incoming FIPA messages or the COSNaming Service can be found can be specified. This has the big advantage that the address of the platform can be selected by the user and, eventually, might be published on your business card. In other words, there is no more any need to publish the IOR of the agent platform. When activating a corbaname:
address, take care that a COSNaming Service implementation is actually running at the NSHostname:NSport address, with the NSnameObject ID, or the MTP activation will fail.
When a container starts, it prints on the standard output all the activated MTP addresses, separated by a carriage return. Moreover, it writes the same addresses in a file, named: MTPs-Container Name.txt.
Using the -mtp command line option, a transport endpoint lives as long as its container is up; when a container is shut down, all its MTPs are deactivated and the AMS information is updated accordingly. The JADE RMA console enables a more flexible management of the MTPs, allowing to activate and deactivate transport protocols during normal platform operations.
Configuring MTPs from the graphical management console.
Select a container from the GUI, click the right button of the mouse and a popup menu appears. Choose the Install a new MTP
option and a dialog will be shown. Here the following information can be set: the container to install the new MTP on (if different from the selected one), the fully qualified name of the class implementing the jade.mtp.MTP
interface, and (if it is supported by the chosen protocol) the transport address that will be used to contact the new MTP.
For example,
- in order to install a new IIOP endpoint by using the default JDK 1.2 ORB, one should write
jade.mtp.iiop.MessageTransportProtocol
as the class name and nothing as the address. - in order to install a new IIOP endpoint by using the ORBacus based implementation, one should write
orbacus.MessageTransportProtocol
as the class name and (if the endpoint had to be deployed at host jade.tilab.com on the TCP port 1234 with an object ID jade)corbaloc:iiop:jade.tilab.com:1234/jade
as the transport address.
Choosing Uninstall an MTP shows a dialog where the user can select from a list one of the currently installed MTPs and remove it from the platform.
JADE is a trademark of TILAB (formerly CSELT).
JADE has been developed jointly by TILAB (formerly CSELT) and the Computer Engineering Group of the University of Parma