Starting and stopping services

Following installation or times when maintaining the system, you might need to start or stop and restart the services.You can use the user interface to start and stop services, or you can issue commands from a command line. This topic describes both options and and the order in which you must stop and start services.

Working with the subscriber services

Start and stop order

In addition to the required start and stop order for services, the following table includes the program name for the services.

Start order	Services	Program	Stop order
1	TMTM Application Service	qpas	6
2	TMTM Topic Service	qpts	5
3	TMTM Event Service	qpes	4
4	TMTM History Service	qphs	3
5	TMTM Client Gateway Service	qpcgateway	2
6	(Optional) TMTM ProactiveNet Service	qpps	1

Before you begin

On UNIX systems, ensure that the UNIX userid that starts the services has read access to /dev/random and /dev/urandom.

To start the services on Windows

Open the Windows Service Control Manager.
Scroll through the services, and locate TMTM Application Service. The status of the service is displayed as Started if it is running or blank if it is stopped.
Select TMTM Application Service and click Start. A dialog box appears indicating the service is being started.
If the service does not start, verify that the service is proxy configured with a valid user account and password.
Repeat for the remaining services in the start order listed in the Start and stop order table.

To stop the services on Windows

Open the Windows Service Control Manager.
Scroll through the services, and locate TMTM Client Gateway Service. The status of the service is displayed as Started if it is running or blank if it is stopped.
Select TMTM Client Gateway Service and click Stop. A dialog box appears indicating the attempt to stop the service.
Repeat for the remaining services in the stop order listed in the Start and stop order table.

To start and stop the services on Windows or UNIX using the command prompt

Open a command prompt.

Perform the required operation listed in the following table using the corresponding long or short command option.

To do this…	Use long option	Use short option*
Start the service.	`--start`	`-s`
Stop (kill) the service.	`--stop`	`-k`
Run the program as a console application.	`--console`	`-c`
Debug the service configuration startup.	`--debug`	`-d`
Specify the service's configuration file.	`--conf filename`	`-f filename`
Print the product version and exit.	`--version`	`-v`
Install the program as a Windows service, with an automatic startup (Windows only).	`--install`	`-i`
Remove the program from the Windows Service Manager (Windows only).	`--remove`	`-r`
Print this option list.	`--help`	`-h`
Display transient checkpoint data and exit.	`--transient`	`-t`
Specify the service to be debug build only, used with third party tools that change process name (for internal use only).	`--progname serviceName`	`-p`
*The short options are not valid with the TMTM Client Gateway Service.

Examples

Start the TMTM Event Service with the long option:
qpes --start

Start the TMTM Application Service with the short option:
qpas -s

Note

The --debug and --conf options only apply when running the service with the console option. If the service is not run as a console application, specifying the --debug and --conf options has no effect.