How do I uninstall an artifact bundle?

Purpose

Use this procedure to make the artifacts in a bundle unavailable to their target applications. You may choose to do this to perform a rollback of the artifacts in the bundle to the previous version, or as a first step towards completely deleting a bundle and its contents. Uninstallation of an artifact bundle changes the bundle status from Installed to Imported; if previous versions of any of the artifacts in the bundle exist in the system, they will be reinstalled according to the version management policy of the target, and their status updated to Installed. See What is artifact version management? for more information about version management.

It is not necessary to uninstall artifact bundles before installing new versions. In most cases, when a new version of an existing artifact is installed (for example, a new version of an existing artifact is delivered in a different bundle), the older artifact version remains in Artifacts and its status is updated to Obsolete.

If an artifact appears in more than one bundle, uninstalling one of the bundles will not affect the other bundles. The artifact remains in the list and the Artifact Details panel shows the remaining bundles the artifact is in.

Steps
 
1 

Open Artifacts, Artifact Bundles.

2 

To uninstall the contents of a bundle in Installed status:

  1. To uninstall all artifacts in the bundle, choose Uninstall from the png1.png (Table row actions) menu.

  2. If selective uninstallation is available for the bundle, choose artifacts to uninstall:

    1. Select a bundle and choose View artifacts from the png1.png (Table row actions) menu.

    2. In the Artifact List, select an artifact or Ctrl+click to select multiple artifacts.

    3. Choose Uninstall from the png1.png (Table row actions) menu.

      Note: if the files list icon (png2.png) appears instead of png1.png (Table row actions), selective uninstallation of artifacts is not available for the bundle.

3 

In the confirmation form, click Uninstall.

The statuses of the bundle and its artifacts are updated to Uninstalled when the process succeeds, then revert to Imported.

When the automatic reconcile operation occurs next, NSP checks and updates the status of all artifacts and artifact bundles and retries any failed uninstallations.

4 

Optionally, proceed to delete the artifact bundle from the NSP. Select the bundle in the Artifacts, Artifact Bundles view and choose Delete from the png1.png (Table row actions) menu.

Note: deleting the zip file removes the bundle and artifacts from NSP entirely, making them unavailable for rollback.

End of steps