Server Activation

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.