asadmin-delete-instance(1AS)					   User Commands				      asadmin-delete-instance(1AS)

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

       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 adminis-
       tration 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.

       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

       asadmin-create-instance(1AS), asadmin-start-instance(1AS), asadmin-stop-instance(1AS), asadmin-restart-instance(1AS)

J2EE 1.4 SDK							    March 2004					      asadmin-delete-instance(1AS)