Chapter 12: Using Cisco Tools from a Command Line

How to Use the Services Utility from a Command Line

Using the Services Utility from a Command Line

When using the Services utility from a command line, note that:

Unlike in Dashboard use, you can stop services whose Type is Critical (service type is defined in the user-modifiable processinfo.xml file.)\

Prior to stopping a service, you should be aware of the significance of stopping it, including any dependant services that may be affected.

The Services utility will not allow you to stop services with peer or child dependencies while those dependencies are running. If you attempt to stop such a service, the utility returns a message stating that dependent services are running.

Table 5: Command Line Options

 

Command:

Description:

Example:

cmdhelp, chelp

Displays a list of commands specific to this utility.

>cmdhelp

 

Note: Using Help or ? also displays this list, but includes several

 

 

additional ICM commands (e.g., echo, error_stop) not used by this

 

 

utility.

 

/?

Displays syntax for a specified command.

><command> /?

appserver

Specifies the system on which the utility should run. If not

><app_servername> /

 

specified, the utility is run on the local system.

<options>

system

Specifies the target system the utility should run against. If not

> /system <host_name> /

 

specified, the utility is run against the local system.

<options>

localhost

Sets the network address of name of the target node to the local

>localhost

 

host.

 

 

Note: By default, unless a different system is specified (using the

 

 

system command) the local host is assumed to be the target system.

 

list

Displays information on all services on the target system.

>list

 

For each service, this command displays:

OR

 

Service Name: The service's name.

>list

<localfile_path\filename>

PID: The service's process ID.

Type: Critical, Known, or Unknown, as defined in the target system's processinfo.xml file.

Start (if the process is stopped) or Stop (if the process if started.

Cisco Support Tools User Guide for Cisco Unified Software Release 2.1(1)

129

Page 143
Image 143
Cisco Systems 2.1(1) Using the Services Utility from a Command Line, Utility Displays syntax for a specified command, Host