Basic Concepts

There are a number of concepts found in Configuration Manager, that you should be aware of before you start using it. These are as follows:

UUID

The UUID (Universally Unique Identifier) is a system defined read-only field. The UUID is generated upon an object’s creation, and so, every object has a UUID. It is a BINARY (16) field type, and it is available in the Object Details section for a specific object in the Ooyala Flex Console, as shown below:

An example of a UUID could be : 4c1bded2-e54d-11e4-8a00-1681e6b88ec1

  • UUIDs are returned in the REST API as a JSON property and for existing objects.
  • A UUID will be generated when an object is created and it is immutable.
  • A UUID can be seen in the Ooyala Flex Console, in the Object Details section for that object.
  • A UUID will be returned in the configuration object REST API responses.
  • A UUID will be used to uniquely identify an object in the REST API URL parameters.

Revision Numbering

A revision number will be generated when an object is created, and it will be updated when the configuration changes are saved.

Example: Any change to the name or description of an object is a new revision version.

The revision number can be viewed in the Ooyala Flex UI, in the Object Details section for a specific object. The revision number will be in the following format:

  • HashCode: is a unique 32 bit java hash for the object.

  • Number: is local to the environment and is a sequentially generated number (0, 1 …N). This number represents the number of updates that have been committed for that specific object in this environment only. Configuration Manager manages revision changes across multiple environments and warns, as well as prevents committing configuration changes to target environments when the revisions don’t match the Configuration Manager central revision store. Ooyala Flex updates the new revision codes for each configuration object. Then, it will maintain the revision code, recalculating it with every change that is made using the UI or Configuration Manager commit deployment.