Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

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


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.


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)



J2EE 1.4 SDKGo To TopLast Changed March 2004