Fortinet black logo

Administration Guide

Managing configuration revision history

Managing configuration revision history

The revision history repository stores all configuration revisions for a device. You can view the version history, view configuration settings and changes, import files from a local computer, compare different revisions, revert to a previous revision, and download configuration files to a local computer.

To view the revision history of a FortiGate unit:
  1. Go to Device Manager > Device & Groups and select a device group.
  2. In the lower tree menu, select a device. The content pane displays the device dashboard.
  3. In the dashboard, locate the Configuration and Installation Status widget.
  4. In the Total Revisions row, click Revision History.

In the Configuration Revision History dialog box, the following buttons are in the toolbar:

View Config

View the configuration for the selected revision.

View Install Log

View the installation log for the selected revision.

Revision Diff

Show only the changes or differences between two versions of a configuration file. For details, see Comparing different configuration files.

Retrieve Config

View the current configuration running on the device. If there are differences between the configuration file on the device and the configuration file in the repository, a new revision is created and assigned a new ID number.

More

From the More menu, you can select one of the following:

  • Download Factory Default
  • Revert
  • Delete
  • Rename
  • Import Revision

You can also right-click a revision to access the same options.

The following columns of information are displayed:

ID

The revision number. Double-click an ID to view the configuration file. You can also click Download to save the configuration file.

Date & Time

The time and date when the configuration file was created.

Name

A name assigned by the user to make it easier to identify specific configuration versions. You can rename configuration versions.

Created by

The name of the administrator account used to create the configuration file.

Installation

Display the status of the installation.

N/A indicates that the revision was not sent to the device. The typical situation is that the changes were part of a later revision that was sent out to the device. For example, you make some changes and commit the changes. Now you have a revision called ID1. Then you make more changes and commit the changes again. Then you have a revision called ID2, which also includes the changes you made in revision ID1. If you install revision ID2, then the status of revision ID1 becomes N/A.

Comments

Display the comment added to this configuration file when you rename the revision.

To view the configuration settings on a FortiGate unit:
  1. Go to Device Manager > Device & Groups and select a device group.
  2. In the lower tree menu, select a device. The content pane displays the device dashboard.
  3. In the dashboard, locate the Configuration and Installation Status widget.
  4. In the Total Revisions row, click Revision History.
  5. Select the revision, and click View Config. The View Configuration pane is displayed.
  6. To download the configuration settings, click Download.
  7. Click Return when you finish viewing.
To add a tag (name) to a configuration version on a FortiGate unit:
  1. Go to Device Manager > Device & Groups and select a device group.
  2. In the lower tree menu, select a device. The content pane displays the device dashboard.
  3. In the dashboard, locate the Configuration and Installation Status widget.
  4. In the Total Revisions row, click Revision History.
  5. Right-click the revision, and select Rename.
  6. Type a name in the Tag (Name) field.
  7. Optionally, type information in the Comments field.
  8. Click OK.

Managing configuration revision history

The revision history repository stores all configuration revisions for a device. You can view the version history, view configuration settings and changes, import files from a local computer, compare different revisions, revert to a previous revision, and download configuration files to a local computer.

To view the revision history of a FortiGate unit:
  1. Go to Device Manager > Device & Groups and select a device group.
  2. In the lower tree menu, select a device. The content pane displays the device dashboard.
  3. In the dashboard, locate the Configuration and Installation Status widget.
  4. In the Total Revisions row, click Revision History.

In the Configuration Revision History dialog box, the following buttons are in the toolbar:

View Config

View the configuration for the selected revision.

View Install Log

View the installation log for the selected revision.

Revision Diff

Show only the changes or differences between two versions of a configuration file. For details, see Comparing different configuration files.

Retrieve Config

View the current configuration running on the device. If there are differences between the configuration file on the device and the configuration file in the repository, a new revision is created and assigned a new ID number.

More

From the More menu, you can select one of the following:

  • Download Factory Default
  • Revert
  • Delete
  • Rename
  • Import Revision

You can also right-click a revision to access the same options.

The following columns of information are displayed:

ID

The revision number. Double-click an ID to view the configuration file. You can also click Download to save the configuration file.

Date & Time

The time and date when the configuration file was created.

Name

A name assigned by the user to make it easier to identify specific configuration versions. You can rename configuration versions.

Created by

The name of the administrator account used to create the configuration file.

Installation

Display the status of the installation.

N/A indicates that the revision was not sent to the device. The typical situation is that the changes were part of a later revision that was sent out to the device. For example, you make some changes and commit the changes. Now you have a revision called ID1. Then you make more changes and commit the changes again. Then you have a revision called ID2, which also includes the changes you made in revision ID1. If you install revision ID2, then the status of revision ID1 becomes N/A.

Comments

Display the comment added to this configuration file when you rename the revision.

To view the configuration settings on a FortiGate unit:
  1. Go to Device Manager > Device & Groups and select a device group.
  2. In the lower tree menu, select a device. The content pane displays the device dashboard.
  3. In the dashboard, locate the Configuration and Installation Status widget.
  4. In the Total Revisions row, click Revision History.
  5. Select the revision, and click View Config. The View Configuration pane is displayed.
  6. To download the configuration settings, click Download.
  7. Click Return when you finish viewing.
To add a tag (name) to a configuration version on a FortiGate unit:
  1. Go to Device Manager > Device & Groups and select a device group.
  2. In the lower tree menu, select a device. The content pane displays the device dashboard.
  3. In the dashboard, locate the Configuration and Installation Status widget.
  4. In the Total Revisions row, click Revision History.
  5. Right-click the revision, and select Rename.
  6. Type a name in the Tag (Name) field.
  7. Optionally, type information in the Comments field.
  8. Click OK.