sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

User Commands | stop-instance(1)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- OPERANDS
- EXAMPLES
- EXIT STATUS
- SEE ALSO

## NAME

| stop-instance - stops the specified server instance and all the services associated with it

## SYNOPSIS

| `stop-instance` [--user admin_user] [--password admin_password] [--host local_host] [--port 4848] [--local=false] [--domain domain_name] [--secure|-s] `instance_name`

## DESCRIPTION

| Use the `stop-instance` to stop the instance with the instance name specified. The `stop-instance` can be run both locally and remotely. The named instance must already exist within the given domain; and the instance must be running.

## OPTIONS

| --user administrative user associated for the instance. --password administrative password corresponding to the administrative user. --host host name of the machine hosting the administrative instance. --port administrative port number associated with the administrative host. --local determines if the command should delegate the request to administrative instance or run locally. --domain name of the domain. --passwordfile file containing passwords appropriate for the command (e.g., administrative instance). --secure if true, uses SSL/TLS to communicate with the administrative instance.

## OPERANDS

| instance_name name of the instance to be stopped.

## EXAMPLES

| Example 1. Using `stop-instance` in local mode
    asadmin> stop-instance --local --domain domain1 server1
    Instance server1 stopped
Where: the `server1` instance associated with the domain1 domain is stopped locally.
Example 2. Using `stop-instance` in remote mode
    asadmin> stop-instance --user admin --password bluestar --host localhost
    --port 4848 server1
    Instance server1 stopped
Where: the `server1` instance associated with the named user, password, host and port is deleted from the remote machine.

## EXIT STATUS

| 0 command executed successfully 1 error in executing the command

## SEE ALSO

| `delete-instance`(1), `start-instance`(1), `create-instance`(1), `restart-instance`(1), `start-appserv`(1), `stop-appserv`(1), `start-domain`(1), `stop-domain`(1)

| Go To Top | Last Changed April 2004

Company Info | Contact | Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.