Archiving and restoring configurations

You can archive streams and baselines that are no longer in use so that they are not shown in the list of configurations. Archiving a configuration does not delete it; configurations cannot be deleted. Restore configurations to make them available for use by you or other team members.

Before you begin

  • Ensure that you are familiar with project areas, components (if supported), baselines, streams, and change sets (if supported).
  • Ensure that you are logged in to a project.
  • Configuration management capabilities must be enabled for the project.
  • You must have permission to archive configurations.

About this task

  • Archiving a configuration removes it from the list of active configurations. It is common to archive a configuration when team members no longer work in it, or if the configuration is not a flow target for other configurations.

    For example, you might archive a baseline that was created for a review, when the baseline is no longer required.

    Note: You can archive all the configurations of a component at the same time by archiving the component. See the related topics.
  • If the configuration is part of a global configuration, the tree view in the Global Configuration Management (GCM) application shows a warning indicating that the local configuration is missing. You can either remove it from the tree view or replace it with another local configuration.
  • You cannot permanently delete components, streams, and baselines because artifacts reference these items. Removing the references would cause unexpected results.
  • You cannot archive a baseline if another configuration has a dependency on it. You cannot archive a stream that is the flow target of another configuration.
  • Archived items are not included in search and query results and Report Builder reports.

Quality management (QM) application

Archive items by using the Delete task. You can restore them from the Trash view later if you need them again.

Procedure

  1. On the banner, click Administration Administration menu > Manage Components and Configurations.
  2. Navigate to the component that contains the configuration to archive or restore.
  3. Complete the following steps as needed.
    • To archive configurations:
      1. In the left navigation pane, click the type of configuration to work with.
      2. From the Actions menu beside the configuration name, choose Delete configuration_type. The configuration is removed from the list. Team members can no longer work in this configuration or add it to global configurations.
    • To show archived configurations:
      1. Click Administration Administration menu > View Trash.
      2. From the View menu, choose the type of configuration to view (stream or baseline).
    • To restore configurations:
      1. Click Administration Administration menu > View Trash.
      2. From the View menu, choose the type of configuration to restore.
      3. From the Actions menu beside the configuration name, choose Restore configuration_type.
      4. To return to the list of components and configurations, click Administration Administration menu > Manage Components and Configurations.

Requirements management (QM) application

Archive and restore configurations from the configuration editor.

Procedure

  1. On the banner, click Administration Administration menu > Manage Components and Configurations.
  2. Optional: Click Browse Components to navigate to the component that contains the configuration to archive or restore.
  3. Complete the following steps as needed.
    • To archive configurations:
      1. If the configuration to archive is of another component than the one that's shown, click Browse Components and choose the correct component.
      2. To archive a stream: From the Actions menu beside the stream to archive, choose Archive. The stream is removed from the list.
      3. To archive a baseline:
        1. On the Streams tab, click the stream name that the baseline was created from.
        2. On the Baselines tab, from the Actions menu beside the baseline to archive, choose Archive. The baseline is removed from the list.
    • To show or hide archived configurations:
      1. To show archived streams: On the Streams tab of the component editor, click Show the archived configurations Archive. All streams are shown.

        Archived streams are disabled and have a gray icon Gray stream icon beside their name.

      2. To show archived baselines:
        1. On the Streams tab of the component editor, click a stream name.
        2. On the Baselines tab, click Show the archived configurations Archive.

          Archived baselines are disabled and have a gray icon Gray baseline icon beside their name.

      To hide archived configurations, click Hide the archived configurations Hide.

    • To restore configurations:
      1. Complete the preceding steps to show archived configurations.
      2. From the Actions menu beside the configuration name, choose Restore.

        You can now see the configuration in the list. Team members can set it as their configuration context, work in the stream, and configuration leads can add it to global configurations.


video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki