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 Commandsundeploy(1)


 undeploy - removes a component in the domain application server


 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.


authorized domain application server administrative username.
password to administer the domain application server.
machine name where the domain application server is running.
port number of the domain application server listening for administration requests.
if true, uses SSL/TLS to communicate with the domain application server.
file containing the domain application server password.
indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script.
setting to true will echo the command line statement on the standard output.
prompts you for the required options that are not already specified.
if set to true, tables created by application using CMP beans during deployment are dropped. Default is the corresponding 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.
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.


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


command executed successfully
error in executing the command



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

J2EE 1.4 SDKGo To TopLast Changed March 2004