orbd [ options ]
To access the ORBD Server Manager, the server must be started using servertool, which is a command-line interface for application programmers to register, unregister, start up, and shut down a persistent server. For more information on the Server Manager, see Server Manager.
Before running a client or a server, you will start ORBD. ORBD includes a persistent naming service and a transient naming service, both of which are an implementation of the COS Naming Service.
The Persistent Naming Service provides persistence for naming contexts. This means that this information is persistent across service shutdowns and startups, and is recoverable in the event of a service failure. If ORBD is restarted, then the Persistent Naming Service restores the naming context graph, so that the binding of all clients' and servers' names remains intact (persistent).
For backward compatibility, tnameserv, a Transient Naming Service that shipped with earlier releases of the JDK, is also included in this release of Java SE. A transient naming service retains naming contexts as long as it is running. If there is a service interruption, then the naming context graph is lost.
The -ORBInitialPort argument is a required command-line argument for orbd, and is used to set the port number on which the naming service runs. The following instructions assume you can use port 1050 for the Java IDL Object Request Broker Daemon. When using Oracle Solaris software, you must become a root user to start a process on a port lower than 1024. For this reason, it is recommended that you use a port number above or equal to 1024. You can substitute a different port when necessary.
To start orbd from a UNIX command shell, enter:
orbd -ORBInitialPort 1050&
From an MS-DOS system prompt (Windows), enter:
start orbd -ORBInitialPort 1050
Now that ORBD is running, you can run your server and client applications. When running the client and server applications, they must be made aware of the port number (and machine name, when applicable) where the Naming Service is running. One way to do this is to add the following code to your application:
Properties props = new Properties();
ORB orb = ORB.init(args, props);
In this example, the naming service is running on port 1050 on host MyHost. Another way is to specify the port number and/or machine name when running the server or client application from the command line. For example, you would start your HelloApplication with the following command line:
java HelloApplication -ORBInitialPort 1050 -ORBInitialHost MyHost
To stop the naming service, use the relevant operating system command, such as pkillorbd on Oracle Solaris, or Ctrl+C in the DOS window in which orbd is running. Note that names registered with the naming service can disappear when the service is terminated because of a transient naming service. The Java IDL naming service will run until it is explicitly stopped.
For more information about the naming service included with ORBD, see Naming Service at http://docs.oracle.com/javase/8/docs/technotes/guides/idl/jidlNaming.html
See Java IDL: The "Hello World" Example at http://docs.oracle.com/javase/8/docs/technotes/guides/idl/jidlExample.html
In this example, you run the idlj compiler and javac compiler as shown in the tutorial. To run the ORBD Server Manager, follow these steps for running the application:
UNIX command shell, enter: orbd -ORBInitialPort 1050.
MS-DOS system prompt (Windows), enter: start orbd -ORBInitialPort 1050.
Port 1050 is the port on which you want the name server to run. The -ORBInitialPort option is a required command-line argument. When using Oracle Solaris software, you must become a root user to start a process on a port below 1024. For this reason, it is recommended that you use a port number above or equal to 1024.
Start the servertool: servertool -ORBInitialPort 1050.
Make sure the name server (orbd) port is the same as in the previous step, for example, -ORBInitialPort 1050. The servertool must be started on the same port as the name server.
In the servertool command line interface, start the Hello server from the servertool prompt:
servertool > register -server HelloServer -classpath . -applicationName
The servertool registers the server, assigns it the name HelloServerApName, and displays its server ID with a listing of all registered servers.Run the client application from another terminal window or prompt:
java HelloClient -ORBInitialPort 1050 -ORBInitialHost localhost
For this example, you can omit -ORBInitialHost localhost because the name server is running on the same host as the Hello client. If the name server is running on a different host, then use the -ORBInitialHost nameserverhost option to specify the host on which the IDL name server is running.Specify the name server (orbd) port as done in the previous step, for example, -ORBInitialPort 1050. When you finish experimenting with the ORBD Server Manager, be sure to shut down or terminate the name server (orbd) and servertool. To shut down orbd from am MS-DOS prompt, select the window that is running the server and enter Ctrl+C to shut it down.
To shut down orbd from an Oracle Solaris shell, find the process, and terminate with the kill command. The server continues to wait for invocations until it is explicitly stopped. To shut down the servertool, type quit and press the Enter key.