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 | delete-instance(1)

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

## NAME

> delete-instance - deletes the instance that is not running.

## SYNOPSIS

> `delete-instance` [--user admin_user] [--password admin_password] [--host localhost] [--port 4848] [--local=false] [--domain domain_name] [--passwordfile filename] [--secure|-s] `instance_name`

## DESCRIPTION

> Use the `delete-instance` command to delete the instance that you specify. The `delete-instance` command can be run both locally and remotely. To delete the instance locally, not requiring the administration server to be up and running, specify the --local option. To delete the instance remotely, the administration server must be running on the hostname and port number specified. The user authenticates using the password identified for the administration server. Additionally, the instance must already exist within the domain served by the administration server. Use this command with discretion since it is destructive and there is no undo.

> The `delete-instance` command does not remove the `/var/imq/instances/<instance_name>` directory.

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

> --domain

>   name of the domain.

> --local

>   determines if the command should delegate the request to administrative instance or run locally.

> --passwordfile

>   file containing passwords appropriate for the command (e.g., administrative instance).

> --secure

>   if true, SSL/TLS to communicate with the administrative instance.

## OPERANDS

> instance_name

>   name of the instance to be deleted.

## EXAMPLES

> Example 1. Using `delete-instance` in local mode

> > >     asadmin> delete-instance --domain domain1 server1
> > >     Deleted Instance server1 successfully

> > Where: the `server1` instance for the `domain1` domain is deleted on the local machine.

> Example 2. Using `delete-instance` in remote mode

> > >     asadmin> delete-instance --user admin --passwordfile passwords.txt --host localhost --port 4848 server1
> > >     Deleted Instance server1 successfully

> > Where: the `server1` instance for the domain associated with the specified user, passwords in the password file, host, and port number is deleted on the remote machine.

## EXIT STATUS

> 0

>   command executed successfully

> 1

>   error in executing the command

## INTERFACE EQUIVALENT

> Server Instance page

## SEE ALSO

> `create-instance`(1), `start-instance`(1), `stop-instance`(1), `restart-instance`(1)

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

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