servertool (original) (raw)

You can start the servertool command with or without a command-line command.

register -server server-class-name -classpath classpath-to-server [ -applicationName application-name -args args-to-server -vmargs flags-for-JVM ]

Registers a new persistent server with the Object Request Broker Daemon (ORBD). If the server is not already registered, then it is registered and activated. This command causes an installation method to be called in the main class of the server identified by the -server option. The installation method must be public static void install(org.omg.CORBA.ORB). The install method is optional and lets developers provide their own server installation behavior, such as creating a database schema.

unregister -serverid server-id | -applicationName application-name

Unregisters a server from the ORBD with either its server ID or its application name. This command causes an uninstallation method to be called in the main class of the server identified by the -server option. The uninstall method must be public static void uninstall(org.omg.CORBA.ORB). The uninstall method is optional and lets developers provide their own server uninstallation behavior, such as undoing the behavior of the install method.

getserverid -applicationName application-name

Returns the server ID that corresponds to the application-name value.

list

Lists information about all persistent servers registered with the ORBD.

listappnames

Lists the application names for all servers currently registered with the ORBD.

listactive

Lists information about all persistent servers that were started by the ORBD and are currently running.

locate -serverid server-id | -applicationName application-name [ -endpointType endpointType ]

Locates the endpoints (ports) of a specific type for all ORBs created by a registered server. If a server is not already running, then it is activated. If an endpointType value is not specified, then the plain/non-protected endpoint associated with each ORB in a server is returned.

locateperorb -serverid server-id | -applicationName application-name [ -orbid ORB-name ]

Locates all the endpoints (ports) registered by a specific Object Request Broker (ORB) of registered server. If a server is not already running, then it is activated. If an orbid is not specified, then the default value of "" is assigned to the orbid. If any ORBs are created with an orbid of empty string, then all ports registered by it are returned.

orblist -serverid server-id | -applicationName application-name

Lists the ORBId of the ORBs defined on a server. An ORBId is the string name for the ORB created by the server. If the server is not already running, then it is activated.

shutdown -serverid server-id | -applicationName application-name

Shut down an active server that is registered with ORBD. During execution of this command, the shutdown method defined in the class specified by either the -serverid or -applicationName parameter is also called to shut down the server process.

startup -serverid server-id | -applicationName application-name

Starts up or activate a server that is registered with ORBD. If the server is not running, then this command starts the server. If the server is already running, then an error message is displayed.

help

Lists all the commands available to the server through the servertool command.

quit

Exits the servertool command.