stop-instance

Syntax

tadm stop-instance common_options --config=config_name (node_host)*

Description

Use this command to stop one or more instances of a configuration. When you execute stop-instance, if the administration node process is running as non-root on the node where the instances are located, and if the failover for that instance is running, then the instance will not be stopped. In order to stop the failover and the instance, you must execute the stop-failover command on the node as a root user.

Options

For information about common_options, run the help command.

--config|-c: Specify the name of the configuration for which you want to stop instances.

Operands

node-host

Specify the name of the node running on the configuration . If you do not specify any nodes, all instances running on the specified configuration are stopped. If an instance on any node is not running, this command will result in an error.

Example

tadm stop-instance --user=admin --password-file=./admin.passwd --host=admin.example.com --port=8989 --no-prompt 
--config=soa serverhost

tadm stop-failover --user=admin 
--password-file=./admin.passwd --host=admin.example.com --port=8989 
--no-prompt --config=soa --instance-home=/home/otd

Exit Codes

The following exit values are returned:

0: command executed successfully

>0: error in executing the command

For more information about exit codes and syntax notations, run the help command.