Service Bridge Management API

The following methods are defined to facilitate management of service bridges. Implementation of these methods is optional. The servercontrol command line tool, which can be used to install and de-install services, will call these methods as needed, as will the Concordia Administrator available with the non-Freeware versions of Concordia.

startService Service bridges can override this method to perform any necessary startup tasks.
stopService Service bridges can override this method to perform a clean shutdown of the service. In general, any sub-threads of the bridge should be notified of the shutdown and important pending tasks should be allowed to complete. An optional timeout value is passed in which specified how long the bridge should wait for pending tasks to complete.
killService This method will be called by the Concordia server to immediately stop a service. Any pending tasks should be aborted, and all threads should be killed. Service bridges can override killService to perform shutdown tasks related to the killing of the server.

In the non-Freeware versions of Concordia, suspendService and resumeService management methods are also supported.

In the non-Freeware versions of Concordia, service bridges can be remotely administered using the Concordia Administrator tool. However, to properly support remote administration, service bridges must override some of the methods defined in the ServiceBridge base class. Concordia remote administration supports the following areas of control:

    <Note: The functionality to utilize the following methods is not available in the Freeware version of Concordia.>

  1. Property Management - the ability to remotely view and change the operating properties of the service. Methods which can be overridden include getProperties, getProperty, setProperty, setProperties and syncServiceProperties.
  2. Server Runtime Management - the ability to remotely start, stop, suspend, resume, and kill a service. In addition to the startService, stopService and killService methods described above, methods which can be overridden include suspendService and  resumeService.
  3. Server Performance Monitoring - the ability to remotely retrieve information about a server's performance and resource usage. Methods which can be overridden include getServiceStatistics and getServiceStatisticsInfo.