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)


NAME

 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

DESCRIPTION

 

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

EXAMPLES

 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

SEE ALSO

 

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



J2EE 1.4 SDKGo To TopLast Changed March 2004