Managing object revisions

This section contains information about object revision management. Open Single Management Platform allows you to track object modification. Every time you save changes made to an object, a revision is created. Each revision has a number.

Application objects that support revision management include:

• Administration Server properties
• Policies
• Tasks
• Administration groups
• User accounts
• Installation packages

You can perform the following actions on object revisions:

• View a selected revision (available only for policies)
• Roll back changes made to an object to a selected revision
• Save revisions as a JSON file (available only for policies)

In the properties window of any object that supports revision management, the Revision history section displays a list of object revisions with the following details:

• Revision—Object revision number.
• Time—Date and time the object was modified.
• User—Name of the user who modified the object.
• User device IP address—IP address of the device from which the object was modified.
• Web Console IP address—IP address of OSMP Console with which the object was modified.
• Action—Action performed on the object.
• Description—Description of the revision related to the change made to the object settings.

  By default, the object revision description is blank. To add a description to a revision, select the relevant revision and click the Edit description button. In the opened window, enter some text for the revision description.

Viewing and saving a policy revision

Open Single Management Platform allows you to view which modifications were made to a policy over a certain period, as well as save information about these modifications in a file.

Viewing and saving a policy revision are available if the corresponding management web plug-in supports this functionality.

To view a policy revision:

1. In the main menu, go to Assets (Devices) → Policies & profiles.
2. Click the policy for the revision that you want to view, and then go to the Revision history section.
3. In the list of policy revisions, click the number of the revision that you want to view.

   If the revision size is more than 10 MB, you will not be able to view it by using OSMP Console. You will be prompted to save the selected revision to a JSON file.

   If the revision size does not exceed 10 MB, a report in the HTML format with the settings of the selected policy revision is displayed. Since the report is displayed in a pop-up window, ensure that pop-ups are allowed in your browser.

To save a policy revision to a JSON file,

In the list of policy revisions, select the revision that you want to save, and then click Save to file.

The revision is saved to a JSON file.

Rolling back an object to a previous revision

You can roll back changes made to an object, if necessary. For example, you may have to revert the settings of a policy to their state on a specific date.

To roll back changes made to an object:

1. In the object's properties window, open the Revision history tab.
2. In the list of object revisions, select the revision that you want to roll back changes for.
3. Click the Roll back button.
4. Click OK to confirm the operation.

The object is now rolled back to the selected revision. The list of object revisions displays a record of the action that was taken. The revision description displays information about the number of the revision to which you reverted the object.

Rolling back operation is available only for policy and task objects.