Show TOC

Procedure documentationUndeploying Archives Locate this document in the navigation structure

 

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

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

End of the note.

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.

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 Caution

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

        End of the caution.

    • 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 Note

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

    End of the note.

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

    Note Note

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

    End of the note.

Result

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

More Information

Filtering and Sorting Archives