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
Example:Description:Command:
>cmdhelpDisplays a list of commands specific to this utility.cmdhelp, chelp
Note: Using Help or ? also displays this list, but includes several
additional ICM commands (e.g., echo, error_stop) not used by this
utility.
><command> /?Displays syntax for a specified command./?
><app_servername> /
<options>
Specifies the system on which the utility should run. If not
specified, the utility is run on the local system.
appserver
> /system <host_name> /
<options>
Specifies the target system the utility should run against. If not
specified, the utility is run against the local system.
system
>localhostSets the network address of name of the target node to the local
host.
localhost
Note: By default, unless a different system is specified (using the
system command) the local host is assumed to be the target system.
>listDisplays information on all services on the target system.list
ORFor each service, this command displays:
•
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
Chapter 12: Using Cisco Tools from a Command Line
How to Use the Services Utility from a Command Line