asadmin-undeploy(1AS)						   User Commands					     asadmin-undeploy(1AS)

NAME

       asadmin-undeploy, undeploy - removes a component in the domain application server

SYNOPSIS

       undeploy   --user  admin_user  [--password  admin_password]  [--host  localhost]  [--port  4848]  [--secure|-s]	[--passwordfile  filename]
       [--terse=false] [--echo=false] [-interactiv=truee] [--droptables=true|false] [--cascade=false] component_name

       undeploy removes the specified component in the domain application server.

       The --droptables option is only used to undeploy CMP beans for which the tables had been created by the deployment. If not  specified,  the
       entries in the deployment descriptors are used.

       This command is supported in remote mode only.

OPTIONS

       --user		       authorized domain application server administrative username.

       --password	       password to administer the domain application server.

       --host		       machine name where the domain application server is running.

       --port		       port number of the domain application server listening for administration requests.

       --secure 	       if true, uses SSL/TLS to communicate with the domain application server.

       --passwordfile	       file containing the domain application server password.

       --terse		       indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-
			       formatted data for consumption by a script.

       --echo		       setting to true will echo the command line statement on the standard output.

       --interactive	       prompts you for the required options that are not already specified.

       --droptables	       if set to true, tables created by application using CMP beans during deployment are dropped. Default is the  corre-
			       sponding  entry	in the cmp-resource element of the sun-ejb-jar.xml file. If not specified, defaults to the entries
			       specified in the deployment descriptors.

       --cascade	       If set to true, it deletes all the connection pools and connector resources associated with  the  resource  adapter
			       being  undeployed.  If  set  to	false, the undeploy fails if any pools and resources are still associated with the
			       resource adapter.  Then, either those pools and resources have to be deleted explicitly, or the option  has  to	be
			       set  to	true.  If  the	option	is set to false, and if there are no pools and resources still associated with the
			       resource adapter, the resource adapter is undeployed. This option is applicable to connectors  (resource  adapters)
			       and applications.

OPERANDS

       component_name	       name of the deployable component.

       Example 1: Simple undeployment

       Undeploy (uninstall) an application named Cart

       asadmin> undeploy --user admin Cart

       Example 2: Undeploying an enterprise bean with container-managed persistence (CMP)

       Undeploy  a  CMP bean named myejb and drop the corresponding database tables. In a production environment, database tables contain valuable
       information, so use the --droptables option with care.

       asadmin> undeploy --user admin --droptables=true myejb

       Example 3: Undeploy a connector (resource adapter)

       Undeploy the connector module named jdbcra and perform a cascading delete to remove the associated resources and connection pools.

       asadmin> undeploy --user admin --cascade=true jdbcra

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

       asadmin-deploy(1AS), asadmin-deploydir(1AS), asadmin-list-components(1AS)

J2EE 1.4 SDK							    March 2004						     asadmin-undeploy(1AS)