Archiving and restoring components in the RM application

Archive components that you no longer use or that are obsolete to simplify the list of components that you see and prevent team members from adding configurations of those components to global configurations. Archiving a component does not delete it. You can restore it when you need it again.

Before you begin

  • Configuration management must be enabled for the project.
  • You must be a configuration lead or have permission to archive and restore components.

About this task

You might archive components that are no longer in use, that were created for temporary use only or by mistake, or whose artifacts were cloned to newer components.

When you archive a component, the system first archives all of the configurations (streams and baselines) of that component. Archived components and configurations are hidden from view in the application, though you see archived configurations when they are referenced by an active configuration. Archived configurations have a gray icon beside their name, as in this example of an archived stream: Gray icon that represents an archived stream.

You can show or hide archived components only from the Manage Components and Configurations > Browse Components page.

You cannot edit archived components or configurations, and you cannot add archived configurations to global configurations. Archived items are not displayed in search and query results and Report Builder reports.

Procedure

  1. Open a project from the Home menu Home menu or the All Projects view: https://example.com:9443/rm/web
  2. On the toolbar, click Administration Administration menu > Manage Components and Configurations. Details of the component you are working in are shown.
  3. Optional: To work with a different component in the project, click the Browse Components breadcrumb link and click the component name.
  4. Complete the steps for the action you want to take.
    • To archive components:
      1. Beside the component name, click Archive this component so it is hidden from use Archive component icon.

      The component and its configurations are archived.

    • To restore components:
      1. Click the Browse Components breadcrumb link.
      2. Click Show archived components Show archived components icon above the table.
      3. Click the component name.
      4. Beside the component name, click Restore this component Restore component icon.

      The component and its configurations are now visible in the application.

What to do next

To return to the list of components, click the Browse Components breadcrumb link. To show or hide archived components, click Show archived components Show archived components icon or Hide archived components Hide archived components icon above the table.

To resume work in the current project, click Artifacts on the toolbar. Check that the Current Project Component and Current Configuration menus on the toolbar are set to the component and configuration that you want to work in.

To resume work in another project, select it from the Home menu Home menu or the All Projects view.


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