Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Operating the Data Object Broker : Running a Data Object Broker as a Windows Service

Running a Data Object Broker as a Windows Service
With these post-installation instructions, a site can run one or more instances of the Data Object Broker under the control of the Windows services manager. A Data Object Broker that is registered as a service can be set to start automatically at system startup.
Installing the Data Object Broker as a Service
To run the Data Object Broker as a Windows service, it must be defined to the Windows services manager through the Registry. To do this, complete the following:
1.
hrncrSvc -i service_name
where service_name is a unique name that you assign to the service.
A message is then displayed, stating that the service is installed.
2.
3.
4.
5.
Make sure that this user ID is also defined as the SYSADMIN in the Data Object Broker parameter file crparm. For more information on the SYSADMIN Data Object Broker parameter and the crparm file, refer to TIBCO Object Service Broker Parameters.
You must update this whenever your Windows user ID or password changes.
See Also
TIBCO Object Service Broker for Open Systems Utilities for information about the hrncrSvc (Install Data Object Broker as a Windows Service) utility and the arguments that it takes.
Starting the Service
Start the service in either of these ways:
From the Control Panel
1.
2.
3.
From the Command Line
Run the command net start service_name.
Setting the Service to Start Automatically
1.
2.
3.
4.
This causes the Data Object Broker to start when the machine is rebooted. You can shut down and restart your machine if you want to ensure automatic startup is functioning correctly.
Shutting Down Your Windows System
Windows imposes a 20-second time limit for a service to shut down when a general Windows system shutdown is requested. The Data Object Broker cannot shut down in this time and is terminated by Windows.
When the Data Object Broker restarts, it recovers properly. To avoid having Windows terminate the Data Object Broker, stop the service.
Shutting Down a Data Object Broker Started as a Windows Service
There are two ways to shut down a Data Object Broker that started as a Windows service:
Run the command net stop service_name.
Each method closes the service properly and advises the Windows service manager of the shutdown.
Uninstalling the Data Object Broker Windows Service
To uninstall the Data Object Broker service, run the following command:
hrncrSvc -u service_name

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved