With the server activation feature of the ORB, you can register
your server with the ORB and the ORB will automatically start the server
(if it is not already running) when a client invokes on a persistent object
implemented within that server.
Server
Deployment Descriptor
The server deployment descriptor describes the various parameters
needed by the ORB to start your server within a Java VM. When using the
command line utilities, it is expressed as a Properties file. When working
with the Activation System APIs, the ServerDesc is a regular serializable
Java object.
The
Activation System
The server activation function is performed by the ActivationSystem
object running inside jorbd, the ORB Daemon. It provides
APIs for registering, unregistering, activating, deactivating, and enumerating
active/registered servers. You can write programs directly to this API,
or you can use the provided command line utilities.
Activation
Command Line Utilities
This section describes the activation command line utilities
- regserv, unregserv, startserv, stopserv,
listserv and chngserv.
Manually
starting a Registered Server
It is required that a server implementing persistent objects
register itself with the ORB. Support is provided so that the server can
be started manually, perhaps, to debug the server within an IDE environment.
In this section we will go through the steps needed to manually start the
above persistent Hello World server.
Support for
Logging
Once the server Java VM is started by the ORB, its System.out
and System.err streams are automatically redirected to files in a directory
of your choice. This is a useful diagnostic tool. See the Server
Deployment Descriptor for details.
Securing
the Activation System
The ActivationSystem can be secured with a realm so
that only the clients that authenticate against that realm can invoke methods
on it. To do so, set the activation.realm property in the
orbd.properties file under the lib directory to the name
of the realm.
See Basic Realm and the Realm Tool, and
Writing a Custom Security Realm for more
information.
Copyright © 1998-2003,
Novell, Inc.
All rights reserved.