Create a Revision¶

Click to open the New Revision dialog. The process to create a new revision is explained in the section Creating Revisions.

Global administrators and promotion administrators also have the possibility to create a new revision uploading directly a VQL file clicking the . The process is explained in the section Create Revisions from VQL.

Edit a Revision¶

To edit a revision, click . A similar dialog to the one of creating a revision will appear. You can change any value from the General pill or update the selected elements in the Revision Elements one. Remember to click the on the top of the dialog to save your changes.

Edit a Revision from the Compare Environments Wizard¶

To edit a revision using the compare environments wizard, click and then, Edit revision with the compare environments wizard.

The compare environments wizard will appear with the revision elements selected. If there is a revision associated with the one being edited (i.e.: when the revision was created, an associate revision of the opposite type was also created), its elements will also be selected.

You can update the selected elements in the Target elements tree. Then, click . If when the revision was created, an associate revision of the opposite type was not created, only the current revision will be updated. In this case the selected elements which are of the same type as the revision will be saved:

1. In the case of a CREATE revision these elements are: the elements present in both environments (transparent background) as well as the candidate elements to be modified (violet background) or added (green background).

2. In the case of a DROP revision these elements are the candidate elements to be removed (orange background).

If when the revision was created, an associate revision of the opposite type was also created, both revisions will be updated. Each revision will store the applicable elements according to their type, as described above.

See the Information of a Revision¶

Global administrators can edit the revisions of other users. No user can edit a revision that has already been deployed. Nevertheless, you can check its content in read-only mode. Click the button and a dialog will appear with all the information about the revision.

Revision definition in read-only mode¶

VQL revision in read-only mode¶

Remove Revisions¶

You can remove revisions in two different ways:

1. Select several revisions on the table and click the button.

2. To remove only one revision, click the button on its row.

Filter Revisions in the Table¶

To apply a filter to the results in the table, click the button and fulfill the form in the dialog below.

Filter revisions dialog¶

A new tag like will appear above the table to represent what it is filtering. You can edit the filter clicking its name or remove it clicking its button.

You can create more than one filter. The table will show only those revisions that verify all the filters defined.

Download the Metadata of a Revision¶

You can download the generated VQL or the Scheduler jobs zip that will be deployed for a revision. Click the button and select the corresponding option in the emerging menu.

Download the contents of a revision¶

Validate a Revision¶

The elements of a revision may depend on a set of properties, like data source URIs, user names, passwords… For a deployment to succeed, the target environment should provide a value for each one of these properties. More specifically:

• The target environment should define a value for every Virtual DataPort property that parameterizes the VQL of the revision.

• Every enabled cluster of the target environment with Scheduler servers should define a value for every Scheduler property that parameterizes the jobs of the revision.

Before deploying a revision, you can validate that the target environment defines all the required properties. Click the button for the corresponding revision and select the target environment that you want to validate. You can also add a comment to the validation.

Select the target environment for a revision validation¶

When the validation process ends a new dialog will appear with the result. If there is any property missing, the validation will fail.

Dialog with the result of a validation¶

If the validation fails and you have permission to create properties, the button will show up. Click it and a new dialog will show up in which you can create the missing VQL properties.

Dialog with the missing VQL properties¶

By default, all properties have an undefined value. You have 3 different options for each property:

1. Keep the undefined value. The validation process will fail if any property is undefined and you will not be able to deploy a revision.

2. Fill the value manually.

3. The column Source Environment Value contains the values of the properties in the environment where the revision was created. You can assign values to the properties copying the values from this column to the New Value column by clicking or . After saving the missing properties, the validation process will be automatically relaunched.

Check the Validation Summary of a Revision¶

You can check the list of environments where a revision was validated on, clicking its button.

List of environments where a revision was validated on¶

If you click one of the environments in the list, you will access the validation summary for that environment.

Validation summary with errors for a revision¶

For those unsuccessful validations, you can check the list of missing properties clicking the button.

Missing Scheduler properties for a validation¶

Copy Revision¶

Click to copy a revision. This will open the wizard create revisions with all the information copied from that revision. Then, you can edit anything on this revision and save the new revision.

Deploy Revisions¶

You can deploy revisions in two different ways:

1. Select several revisions on the table and click the button.

2. To deploy only one revision, click the button on its row.

A dialog will appear where you have to select in which environment you want to deploy the selected revisions. You can also enter a description about the deployment.

Select the target environment for a revision deployment¶

If a property is missing in the target environment, you will be able to see the validation details at this moment. If you have permission to create properties, you will also be able to create the missing VQL properties. See section Validate a Revision for more details. After saving the missing VQL properties, the deployment process will be automatically relaunched.

Confirmation dialog to create VQL missing properties¶

If the option Rollback when the deployment fails in the first server is enabled for the target environment, but there is no backup data available, you will have to confirm that the deployment should continue anyway.

Confirmation dialog to continue the deployment without a backup¶

To get more information about the status of the deployment, you can click on the notification that appears after deploying the revision.

Notification of successful deployment¶

Check the Environments Where a Revision Was Deployed¶

You can check the list of environments where a revision was deployed on, clicking its button.

List of environments where a revision was deployed on¶