The RCS provides information on all configuration changes to your system and you can retrieve and revert to older configuration versions when needed. RCS can generate reports to help monitor configuration changes.
In this article:
Activating the RCS on a Standalone Barracuda NG Firewall
When activated on a standalone Barracuda NG Firewall, RCS provides information on all configuration changes that are made to the Barracuda NG Firewall.
- Open the Administrative Settings page (Config > Full Config > Box).
- From the left Configuration Mode menu, select RCS Setup.
- Click Lock.
- Enable the Version Control System.
- Specify the settings as described in the above section.
- Click Send Changes and Activate.
Activate the RCS by disconnecting and then reconnecting to the Barracuda NG Firewall. Click Disconnect and then click Connect.
After configuring and activating RCS, you can view change reports for each Config Tree node.
Report Processing Script Examples
The following table displays examples of scripts that you can enter in the Report Processing Script table for transmitting your change reports via scp or mailclt. In your script, use the $REPORT variable. The name of the report file is stored in $REPORT.
Viewing RCS Versions
You can view the RCS versions for a configuration page from the Config Tree or on the page itself. To compare versions, you can generate RCS reports. These RCS reports can also be filtered for specific time periods and administrator IP addresses.
- To view the RCS versions from a configuration page, open it, click RCS in the upper right of the page and select Show versions.
- To view the RCS versions of a configuration page from the Config Tree, right-click the configuration node and select Show RCS Versions.
The RCS Versions window displays a list of all versions of a configuration page. It displays the following information:
|Version||The version numbers of activated (by clicking Activate) changes.If a configuration has only been sent (by clicking Send Changes), this column displays, "session."|
If a linked file is edited, the file version and complete path to the link target are also displayed.
|Date||The date when the configuration version was activated. Dates are formatted follows: yyyy/mm/dd|
|Time||The time when the configuration version was activated. Unless you have changed the time settings for the system, the UTC time format is used.|
|Admin||The login name of the administrator who made changes for the configuration version.|
|Peer||The IP address of the administrator who made changes for the configuration version.|
Displays the type of change made by the administrator:
|Link Version||If the configuration page is linked to a repository, the version of the link target is displayed.|
|Link Path||If the configuration page is linked to a repository, the complete path of the link target is displayed.|
|Release||The product release number.|
|Message||Displays a message if configured.|
Generate an RCS Report
In the RCS Versions window, you can generate an RCS report to compare and view information for specific configuration versions. For configuration objects that contain at least one sub-node you can also filter RCS reports for specific time periods and administrator IP addresses. To generate a report,
- Open the RCS versions page.
- Select the versions that you want to include in the report. To select a range of versions, click the first version and last version in the range of interest. Then select the Full History check box. To select all versions, click Select All.
- Click Show Differences.
To generate a filtered report,
- Click RCS on the configuration page and select Show RCS Report.
- You can specify the following settings for the report:
- Start Date / End Date – The period of time that is to be displayed.
- Admin – (Optional) The login name of a specific administrator.
- Peer – (Optional) The IP address of an administrator
- Include Node Creation – Collects all available version information. This option may generate a high load of information.
- No Difference Details – Only specify if a change was made. The changed value is not displayed.
- Show Detail for Linked Nodes – Collects all available change information. Also displays changes made to a linked target. This option may generate a high load of information.
The RCS Report window displays the following information:
|Node||Displays changes in a tree structure. The first level specifies the name of the configuration entity, the second level specifies the name of the data set, the third level specifies the position in the configuration dialog, and the fourth level specifies the object of editing.|
The type of change made:
Move - The position of the configuration entry was moved in the hierarchy (for example moving a rule up or down in a rule set).
|New||The new value of the configuration entity.|
|Old||The old value of the configuration entity. The New and Old columns may contain multiple lines. To view all the lines, expand the nodes in the Node column or right-click the Details… from the context menu.|
|Version||Displays the version number when editing is displayed. If there are multiple version number within this node, the column displays: *|
|Stamp||The date and time when the configuration was modified. Unless you have changed the time settings for the system, the UTC time format is used. The date and time are formatted as follows: yyyy/mm/dd hh:mm:ss|
|Admin||The name of the administrator who made changes for the configuration version.|
|Peer||The IP address of the administrator who made changes for the configuration version. If the same IP address is entered multiple times within a firewall rule, the RCS Report window may display incorrect change history even if the change was correctly deployed.|
RCS Report Tools
You can right-click the RCS Report columns and select any of the following options to modify the column view or print the report:
- Details – Opens the RCS Report Detail window, which displays the column information in a more readable format (recommended for multi-line entries).
- Expand and Expand All – Expands a selected node or all nodes.
- Collapse and Collapse (All) – Collapses a selected node or all nodes.
- Print (Visible Only, Landscape/Portrait) – Prints the display as it is displayed. You can print the report in landscape or portrait orientation. Landscape is recommended.
- Print (All, Landscape/Portrait) – Prints all the information in the report. You can print the report in landscape or portrait orientation. Landscape is recommended.
The toolbar on the bottom of the RCS Report window offers the following functionalities:
- Search String – In this empty field, you can enter the string you want to search for. Wildcards are not supported.
- << Find / Find >> – Navigate up and down the report to find the specified search string.
- Import … / Export … – Export the report into a *.prp file for archiving purposes or import an archived prp file.
- << Prev / Next >> – Navigate between the selected configuration versions.
Revert an RCS Version
With RCS, you can revert a configuration page to a previous version. You cannot retrieve RCS versions for VPN settings.
- On the configuration page, click RCS and select Retrieve versions.
- In the RCS Versions window, select the required configuration version and click Choose. The configuration page header displays the selected version.
- Click RCS and select Accept Version.
- In the window that opens with a message asking if you want to accept and activate the selected version, click Yes.
- Click Send Changes and Activate.