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
- INTERFACE EQUIVALENT
- 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

## INTERFACE EQUIVALENT

> Server Instance page

## 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)

Sun Java System Application Server | Go To Top | Last Changed 29 Dec 2003

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