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


Chapter 5 Running the EMS Server : Running the EMS Server as a Windows Service

Running the EMS Server as a Windows Service
Some situations require the EMS server and multicast daemon processes to start automatically. You can satisfy this requirement by registering these with the Windows service manager. The emsntsrg utility facilitates registry.
emsntsrg
The emsntsrg utility registers or unregisters the EMS server daemon or the EMS multicast daemon as a Windows service.
Syntax
emsntsrg /i [/a] service_name emsntsct_directory service_directory [arguments] [suffix]
emsntsrg /r [service_name] [suffix]
Remarks
Some situations require the EMS server processes to start automatically. You can satisfy this requirement by registering these with the Windows service manager. This utility facilitates registry.
Restrictions
You must have administrator privileges to change the Windows registry.
Location
Locate this utility program as an executable file in the EMS bin directory.
 
Use this directory pathname to specify the location of the emsntsct.exe executable. The emsntsrg utility registers the emsntsct.exe program as a windows service. The emsntsct.exe program then invokes the associated tibemsd or tibemsmcd.
By default, emsntsct.exe is located in EMS_HOME\bin.
Register
To register tibemsd as a Windows service, run the utility with this command line:
emsntsrg /i [/a] tibemsd emsntsct_directory tibemsd_directory [arguments] [suffix]
To register tibemsmcd as a Windows service, run the utility with this command line:
emsntsrg /i [/a] tibemsmcd emsntsct_directory tibemsmcd_directory [arguments] [suffix]
Example 1
This simple example registers one tibemsd service:
emsntsrg /i tibemsd C:\tibco\ems\8.1\bin C:\tibco\ems\8.1\bin
Example 2
This example registers a service with command line arguments:
emsntsrg /i tibemsd C:\tibco\ems\8.1\bin C:\tibco\ems\8.1\bin "-trace DEFAULT"
Example 3
This pair of example commands registers two tibemsd services with different configuration files. In this example, the numerical suffix and the configuration directory both reflect the port number that the service uses.
emsntsrg /i tibemsd C:\tibco\ems\8.1\bin C:\tibco\ems\8.1\bin "-config C:\tibco\ems\8.1\7222\tibemsd.conf" 7222
 
emsntsrg /i tibemsd C:\tibco\ems\8.1\bin C:\tibco\ems\8.1\bin "-config C:\tibco\ems\8.1\7223\tibemsd.conf" 7223
Notice these aspects of this example:
When installing tibemsd, if you supply a -config argument, the service process finds the directory containing the main configuration file (tibemsd.conf), and creates all secondary configuration files in that directory. In this example, each service uses a different configuration directory.
Example 4
This example registers one multicast daemon service:
emsntsrg /i tibemsmcd C:\tibco\ems\8.1\bin C:\tibco\ems\8.1\bin
Example 5
This example registers a multicast daemon service with command line arguments:
emsntsrg /i tibemsmcd C:\tibco\ems\8.1\bin C:\tibco\ems\8.1\bin "-logfile c:\tibemsmcd.log"
Note that specifying a log file can help identify conflicts that might prevent the multicast daemon service from starting.
Example 6
This pair of example commands registers two multicast daemon services with different ports. In this example, the numerical suffix reflects the port number that the service uses.
emsntsrg /i tibemsmcd C:\tibco\ems\8.1\bin C:\tibco\ems\8.1\bin "-listen 7345" 7345
 
emsntsrg /i tibemsmcd C:\tibco\ems\8.1\bin C:\tibco\ems\8.1\bin "-listen 7346" 7346
Remove
To unregister a service, run the utility with this command line:
 emsntsrg /r [service_name] [suffix]
Both parameters are optional. If the service_name is present, it must be tibemsd or tibemsmcd. To supply the suffix parameter, you must also supply the service_name. When both parameters are absent, the utility removes the services named tibemsd and tibemsmcd.
Command Summary
To view a command line summary, run the utility with this command line:
 emsntsrg
Windows Services Applet
The Windows services applet displays the name of each registered service. For EMS services, it also displays this additional information:
The process ID (PID)—when the service is running

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