undeploy

Description

Removes an entity and deletes files associated with it.

Syntax

undeploy [-keepConfigFiles true|false] [-undeployListOnly] [-server host:port] entities 

Option

Description

-keepConfigFiles true-false

Preserves the configuration files for removed entities, which are located in the config directory of the install.

-undeployListOnly

Lists files that would be removed and other actions that would be performed by running the command, but does not remove the specified entities.

-server host:port

Remotely deploys the archive to the server running on the specified host and listening on the specified HTTP port. If you do not specify a server, the archive deploys locally to the same installation where you run the deploy command.

You must have an active wlogin session with the server, using an account that has administrator role privileges on that server.

NoteInstead of using the host:port syntax, you can pass the server name, if it is defined in the local Repository.

entities

The names of the entities to be removed, in the format described under “Entity references”.

You can specify multiple entities, separated by commas. You can use wildcards to represent multiple entities. For example, use ejbjar-foo* to specify all EJB modules that begin with foo, or appclient-* to specify all application clients.

Usage

If an entity’s Ant configuration file specifies additional files to include when exporting the entity, using the includeOtherFiles property, these files are not deleted when you undeploy the entity.

See also

deploy, export