Archiving Tags

This section describes how to add, edit, copy, delete, and associate tags with archived device configuration revisions of one or more devices. A tag serves as a unique identifier that you can use to label a particular revision of a device configuration file in the CVS repository. You can tag any CVS entry with a free text string (for example, golden, master, or template). The same tag can be associated with multiple device configurations, but not with multiple configuration revisions of the same device. If a tag already associated with a configuration revision of a device is added to another configuration revision of the same device, the tag will automatically be removed from the previous configuration revision.

The Junos Scope administrator can select a device, view all configuration revisions for the selected device in the repository, then assign a tag to one of the configuration revisions of the selected device. The administrator can also select multiple devices and assign a tag to a configuration revision of each selected devices iteratively. Alternatively, the administrator can assign a tag to the Head Revision (latest revision) in the repository for all the selected devices. The administrator can compare any two configuration revisions of a device to determine which configuration revision to tag.

Adding an Archived Configuration Tag

The Junos Scope administrator can add unique text tags to label specific device configurations that have been archived in the Junos Scope CVS repository.

To add an archived configuration tag, follow these steps:

  1. In the Junos Scope main window, click Configuration > Repository > Archive Tags. The Archive Tags dialog box appears.
    Image tag-table-view.gif

    Tags are listed in the Archive Configuration dialog box in alphabetical order by Name, Comment, and Actions. See Table 14 for a description of the information. If you have not created any configuration archive tags, the dialog box will be empty.

  2. Click Add. The Add Archive Tag dialog box appears.
  3. In the Name text box, type a unique archive tag name.

    Follow these rules when adding an archive tag name or you will not be able to associate the tag with a device configuration:

    • Tag name length must be no more than 40 characters.
    • The first character of a tag name must be a letter.
    • The rest of the tag name characters can be alphanumeric characters.
    • The tag name can include a hyphen (-) or an underscore (_). Do not include a period (.).

      The archive tag names Head Revision and Running are reserved tag names that can be used for both source or target configuration files for comparison and auditing.

  4. In the Comment text box, type an optional comment for the tag name.
  5. Click OK. The new tag appears in the Archive Configuration dialog box.

Viewing Archived Configuration Tags

Use the Archive Configuration dialog box to set up and maintain configuration tag names. You can add, edit, copy, and delete tags. You can associate a tag with archived device configuration revisions of one or more devices and also untag archived device configuration revisions.

To view all archived configurations, follow this step:

  1. In the Junos Scope main window, click Configuration > Repository > Archive Tags. The Archive Tags dialog box appears.
    Image tag-table-view.gif

    Tags are listed in the Archive Configuration dialog box in alphabetical order by Name, Comment, and Actions. See Table 14 for a description of the information. If you have not created any configuration archive tags, the dialog box will be empty.

    Table 14: Archive Configuration Dialog Box Labels

    Column Name

    Description

    Name

    Name of the archived configuration tag.

    Comment

    Comment entered while creating the archived configuration tag.

    Actions

    Actions that can be performed on an archived configuration tag. The possible actions are:

    • EditEdit or rename the selected tag.
    • CopyCreate a copy of the selected tag, including all associated device configurations.
    • DeleteDelete the selected tag.
    • Set Archive TagAssociate the selected tag to a device or devices.

Editing Archived Configuration Tags

The Junos Scope administrator can edit an archived configuration tag name and comment.

To edit a tag name and comment, follow these steps:

  1. In the Junos Scope main window, click Configuration > Repository > Archive Tags. The Archive Tags dialog box appears.
  2. Click the Edit action link for the tag that you want to edit. The Edit Archive Tags dialog box appears.
    Image tag-edit.gif
  3. Modify the tag name and comment.
  4. Click OK. The modified tag information appears in the Archive Tags dialog box.

Copying Archived Configuration Tags

You can copy the archive configuration tag name and comment.

To copy a tag name and comment, follow these steps:

  1. In the Junos Scope main window, click Configuration > Repository > Archive Tags. The Archive Tags dialog box appears.
  2. Click the Copy action link for the tag that you want to copy. The Copy Archive Tags dialog box appears.
    Image tag-copy.gif
  3. Modify the tag name or comment.
  4. Click OK. The copied tag appears in the Archived Tags dialog box.

Associating Tags to Devices and Tagging Device Configuration Files

After a tag is created, the Junos Scope administrator must associate it with devices with archived configurations in the Junos Scope CVS repository. The administrator can select devices that have archived configurations to tag, view all the configurations of each selected device, then assign a tag or untag iteratively. The administrator can also assign a tag to the Head Revision (latest) in the repository for all devices selected.

Note: You cannot associate an archive tag to a device configuration unless the tag name meets the rules described in Adding an Archived Configuration Tag.

To associate and tag device configurations, follow these steps:

  1. In the Junos Scope main window, click Configuration > Repository > Archive Tags. The Archive Tags dialog box appears.
  2. Click the Set Archive Tag action link for the tag that you want to associate with devices. The Associate Archive Tags with Devices dialog box appears.
    Image archivetags_associate.gif
  3. Select a device or devices and move them into the Selected Devices to Tag/Untag list box using the buttons in the Add/Remove column.
  4. Click one of the command buttons at the bottom of the dialog box to do the following:
    • View/Tag/Untag Selected Devices—View all configuration revisions for each selected device in the Selected Devices to Tag/Untag list box, select a configuration revision and tag or untag configuration revisions for each device iteratively. Skip to step 5.
    • Tag All Head Revisions—Assign a tag to the head revision (latest) in the repository for all selected devices in the Selected Devices to Tag/Untag list box. If an existing tag is added to the head revision (latest) of a device, the tag is automatically removed from the old revision. If you click Tag All Head Revisions, the message Successfully tagged head revision of selected devices appears in the Associate Archive Tags with Devices dialog box after all the head revisions are tagged.
    • Untag All—Untag all the configuration revisions for all selected devices in the Selected Devices to Tag/Untag list box. If you click Untag All the message Successfully untagged selected devices appears after all the configuration revisions for the selected devices are untagged.
    • Finish—Save any changes made and return to the Archive Tags dialog box.
  5. If you click View/Tag/Untag Selected Devices, the Tag or Untag configuration revisions dialog box appears.
    Image archivetags_taguntag.gif
  6. Select an archived configuration revision and click one of the command buttons at the bottom of the dialog box to do the following:
    • Tag—Apply the tag to the configuration revision selected.
    • UnTag Master—Remove the tag from the configuration revision selected if the tag has already been associated with the configuration revision.
    • Next Device—Display the Tag or Untag Configuration Revisions dialog box for the next device when you are tagging configuration revisions of multiple devices iteratively. You can tag configuration revisions of multiple devices iteratively using this command button.
    • Previous Device—Display the Tag or Untag Configuration Revisions dialog box for the previous device when you are tagging configuration revisions of multiple devices iteratively.
    • Compare—Compare two selected configuration revisions.
    • Finish—Save any changes made and return to the Associate Archive Tags with Devices dialog box.
  7. Click Finish after you tag or untag configuration revisions to return to the Associate Archive Tags with Devices dialog box.

Deleting Archived Configuration Tags

The administrator can delete archived configuration tags that are no longer in use.

To delete an archived configuration tag, follow these steps:

  1. In the Junos Scope main window, click Configuration > Repository > Archive Tags. The Archive Tags dialog box appears.
  2. Click the Delete action link for the tag that you want to associate. A confirmation dialog box appears.
    Image tag-delete-confirmaiton.gif
  3. Click OK. The tag is removed from the Archive Tags dialog box.