Show TOC

Undeploying ArchivesLocate this document in the navigation structure

Prerequisites

The respective Deployment Job view is open.

Choose with the quick info text Refresh to display an up-to-date list of the deployed archives.

Context

When you no longer need a component, you can undeploy it.

Note

If you do not want to use it now, but plan to use it later, you can simply stop it as described in Managing Deployed Archives .

Procedure


  1. Expand the Setting .

  2. Set:

    • An undeployment strategy

      • If depending stop

        If there are components that depend on the software component that has to be undeployed and these are not part of the list of components that have to be undeployed, the undeployment process will stop. The dependent components have to be undeployed for the undeployment to be successful.

      • Undeploy depending

        All deployed components that depend on the component that has to be undeployed will be undeployed too.

        Caution

        Please use this strategy with caution. If there is a large dependency chain, you may undeploy applications you did not intend to undeploy

    • An error strategy

      • Stop when the first error occurs

        The whole undeployment process will fail if one of the undeployments fails. This is the default error behavior.

      • Skip undeployment of archives depending on the erroneous undeployment

        This option is most suitable when undeploying Java EE archives since all your archives will be undeployed. If the undeployment of some of the components fails, all depending components are skipped and not undeployed. The process continues with the next component in the undeployment queue that does not depend on the failed component.

  3. Select the archives you want to undeploy from the tree. You can make multiple selections.

  4. From the context menu choose Add to undeploy list . This will copy the names to the Undeployment List .

    Note

    If you want to remove an archive from the list, select its name and choose Remove .

  5. Choose Undeploy . A message is displayed at the end of the process.

    Note

    You can check the undpeloyment status of the component in the Deployment View Console view.

Results

You have undeployed the component. For more information, see the log messages in the Deploy View Console.

Next Steps

Filtering and Sorting Archives