|
|
|
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 |
|
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.
|
|
- --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.
|
|
-
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
|
|
|
|
- 0
- command executed successfully
- 1
- error in executing the command
|
Company Info
|
Contact
|
Copyright 2003 Sun Microsystems, Inc. All rights reserved.
Use is subject to license terms.
|