orbd: Naming Service Daemon


orbd: Naming Service DaemonSince JDK 1.4

Synopsis

     orbd -ORBInitialPort <ns-port> [ options ]

Description

The orbd tool is a server daemon that runs a CORBA Naming Service. It's a replacement for the tnameserv tool, which is still provided as part of Sun's JDK (described later). orbd supports both transient and persistent CORBA servants running within its Naming Service. For transient naming services, orbd can be used in a similar fashion to tnameserv. The Naming Service is started and told to listen on a particular port using the -ORBInitialPort option, and CORBA servants are registered directly to this Naming Service on the given port. These servants are transient, in the sense that their references in the Naming Service last only for the lifetime of the orbd process.

To access the persistent services of orbd, you must use servertool (described later in the appendix). The orbd daemon has a persistent reference manager internally and a database of persistent references. The daemon can use these to reinitialize a servant if it dies or to reinitialize a servant reference if the orbd daemon dies and is restarted. On their own, CORBA servants can access the default transient services of orbd, but servertool can invoke orbd's persistent reference services using an internal protocol between itself and orbd. To make a CORBA servant persistent, register it with orbd using the servertool command interface.

To start the orbd daemon, run it from the command line with (at a minimum) an initial port specified:

     > orbd -ORBInitialPort 1050

If you want to register persistent CORBA server objects with orbd, start servertool using the same port so that it connects to the running orbd process:

     > servertool -ORBInitialPort 1050

This presents the servertool command-line interface, which allows you to register CORBA servers with orbd, as described later.

Options


-defaultdb < path>

Specifies the directory where orbd should maintain its persistent information in a file called orbd.db. By default, the current directory is used for this file.


-J< javaoption>

Passes the given option directly to the underlying Java virtual machine. There is no space between the -J and the option. For example, to run the JVM in verbose mode, use:

     > orbd -J-verbose ...


-ORBInitialPort < portnum>

Required. The standard CORBA property controls the initial port used for services, such as the Naming Service. Normally it's optional for CORBA servants and tools, but the orbd daemon requires that this option be specified on the command line. The default port for the Naming Service is port 900, but on some Unix variants, ports less than 1024 are restricted to root access, so you need to specify a higher port number, such as 1050.


-port < port>

Customizes the port number used by orbd for requests to reactivate persistent servers. This option is useful when the default port of 1049 isn't available.


-serverPollingTime <time>

Sets the frequency (in milliseconds) with which the daemon checks on its persistent servers. If not specified, the default time is 1000 ms.


-serverStartupDelay < time>

Sets the delay orbd inserts between the time it restarts a persistent server and the time it forwards the next request targeted for that server. This gives the server a chance to initialize itself. If not specified, the default time is 1000 ms.



Java Enterprise in a Nutshell
Java Enterprise in a Nutshell (In a Nutshell (OReilly))
ISBN: 0596101422
EAN: 2147483647
Year: 2004
Pages: 269

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net