Command | Description |
---|---|
help | This shows you all the commands available in the system |
add | This pushes the target changes to the environment |
bootstrap | Bootstraps objects that do not have an UUID |
clear | Clears the console |
cls | Clears the console |
commit | Commits the changes to git repository |
dependencies | Pulls dependencies of object of passed UUID from the remote environment |
environment | Creates a new environment configuration |
exit | Exits the shell |
info | Shows all the supported objects and their extended data |
gitdiff | Displays information about tracked and untracked changes based on the changeset and the git repository. This only displays changes that have taken place in the folder that represents your target environment. |
mapper | Set mapper configuration. Mapper will be applied to current change request. e.g. file: { “sourceUuid”: , “targetUuid”: },… |
prepare-bootstrap | Populates the objects with a new UUID |
list | Lists available objects from the source environment by default, but you can list objects in the target as well |
open | Creates a new change request or opens an existing one |
pull | Pulls source or target configuration objects from the remote environment |
quit | Exits the shell |
remove | Removes all objects from the target environment |
repository | Creates a new repository and config files |
script | Parses the specified resource file and executes its commands |
session | Shows information about the current session. |
showchangeset | Shows changeset |
showrepos | Lists available repositories |
status | Lists all change requests in the current repository |
system properties | Shows the shell’s properties |
tag | Adds the tag to commit |
update | Updates all objects from source environment to target environment |
version | Displays the shell version |
Below is a detailed list of the most important commands that Configuration Manager supports along with use case examples. With most of the following commands, you will be able to select all the available objects, by simply executing a command by itself. For example, if you were to execute the pull command by itself, without specifying a particular object type, you would pull all of the available object types.
The showrepos command displays the repositories you’ve created.
Example: Available repositories: - Repository name: my_repo
The status command displays the status of the Change Request created by the system. If you use the status command, you will see a response which is similar to the following:
Name | Created On | Source | Target | Committed on |
---|---|---|---|---|
CR_1202151204 | 02/12/2015 | 12:04:56 | MioStage | MioStageTarget |
open --source <name_of_source_env> --target <name_of_target_env>
This command creates a new change request. With this command, you can change which environment is your source and which is the target for a particular change session.
Example: open --source my_source_env --target my_target_env
If the change session has been setup successfully, you will see the following response:
Note: The name of source and target environment should match the folder name in your repository.
open --cr change_request_name
This command is used to switch the environments or load an existing change request.
Example: “ChangeRequest loaded: [name=CR_0612151434, uuid=66d36f8f-7f9a-4dd0-b5f6-d3f9887657ba, source=DEV, target=QA, created on=12/06/2015 14:34:09, committed on= not yet]”
open –source <name_of_env> –target <name_of_env> –keep_organisational
By running this command, you can indicate whether or not to keep account / user settings that are found in the source environment, and apply them to the target environment. So when you pull items, and then push them to the target, they will automatically conform to the organisational details you have specified.
The following options can be used with this command:
Example: The following command would keep all the settings associated with users.
open --<source_env_name> --<target_env_name> --keep_organisational user
The session command provides you with the details of the current session.
Example: Working path: C:\miocm_reposRepository: MioCMEnvironments: There are 2 environments  - Environment name: MioStage  - Environment name: MioStageTargetCurrent CR: There is no change request open
list [[--type <object_type>]|[--uuid <uuid>]][--environment source|target]]|
The list command currently supports the following object types:
Example: Using List –type action lets you see a list of all the actions you have in a particular environment. The information for each action in the list will be displayed in the following order <type_object>. This is shown in the screenshot below:
The pull command lets you pull objects from an environment.
pull [[--type <object_type>]|[--uuid <uuid>]] [--environment source|target]] |
Examples:
By default, executing the pull command will pull objects from the source environment. If you execute the pull command by itself without specifying an object type, Configuration Manager will pull all the available object types by default.
If you use the pull --environment
command, you can select --environment 'source|target'
label.
The pull --type action
command will take all the actions from the source environment, and send them to the source folder inside the repository.
The pull command currently supports the following object types:
add [[--type <object_type>]|[--uuid <uuid>]]|
The add command is used to push changes to the target folder. If the object type and UUID are not specified, all of the environment configuration will be copied across to the target by default. So it is important to specify the object type and UUID if you are only changing one object for example. If you execute the add command by itself without specifying an object type, Configuration Manager will add all the available object types by default.
Examples:
The add command currently supports the following object types:
update [[--type <object_type>]|[--uuid <uuid>]]|
The Update command is used to update the target folder with the delta records. If you execute the update command by itself without specifying an object type, Configuration Manager will update all the available object types by default.
Examples:
The update command currently supports the following object types:
The commit command is used to commit changes you have made, to the git repository.
commit [[--type <object_type>]|[--uuid <uuid>]][--message <message_text>][--force true|false][--skip_git_status true|false]
Examples:
With this command, you can add messages to your commit so that you can differentiate between different commits in the git repository. If you have spaces in your message you must wrap the message in quotes.
Additionally, the commit command accepts the –force option. This option will change all of the conflict questions to “Include all” without confirmation from the User. If you choose to use the –force option, all questions will be changed to “Include all” by default. The –force param will be passed from Ooyala FlexCM CLI to Ooyala Flex Core. In Case 4, Ooyala Flex Core will try to perform the change and return a warning message (meaning it will inform you of the conflicts but will attempt to commit the changes anyway).
[[--type <object_type>]|[--uuid <uuid>]]|
Examples:
The remove –type command currently supports the following object types:
The dependencies command lists the dependencies of a specific object. This is done by passing the UUID for the object located in the remote environment. For example: you could have a workflow, and that workflow might reference several other objects in order to work, such as actions, event handlers, and so forth. The objects that are referenced by the workflow, may in turn, reference objects as well.
Note: You must open a change session first, in order to use this command.
Below is an example of a list of dependencies for a specific object:
dependencies --environment target --uuid 2bd43348-d6e0-475d-bbd0-be0699a91fef { "dependencies" : [ { "referenceLink" : { "id" : 19362, "uuid" : "2bd43348-d6e0-475d-bbd0-be0699a91fef", "name" : "!Achal Add to Group Action", "displayName" : "!Achal Add to Group Action", "externalIds" : [ ], "objectType" : { "id" : 18, "name" : "action", "href" : "https://my.environment.net/api/objectTypes/18", "displayName" : "Action", "pluralName" : "Actions", "userDefined" : false, "attachmentsSupported" : true, "commentsSupported" : true, "objectDataSupported" : false, "contentMetadataSupported" : false, "metadataSupported" : true }, "accountId" : 18487, "enabled" : true }, "upstream" : [ ], "downstream" : [ ] } ] }
The mapper command allows you to map a user, account, or visibility from one environment and apply it to an object located in another environment using UUIDs.
Note: The mapper command doesn’t map internal configuration references. For example, an action using a metadata definition in the configuration will not have the UUID mapped. Only access details are mapped: such as user, account, and visibility.
You need to specify the UUID of the object type you wish to map, and then the UUID of the object you want to map it to.
In order to use this command, you must first specify the object UUIDs in a JSON file. For example you could have the following:
"mapping": [ { "sourceUuid": "4508649d-d697-4c75-8fa0-27ac4ca674c4", "targetUuid": "786a8a14-6533-41c9-ad22-8a54fe9bcbd9" },... ]
Once you specified the UUIDs in the JSON file, you need to run the following command, containing the exact path to where your JSON file is located.
Example
mapper –file D:/mappers/owner_account_mapping.json