Required role

Finding your Aria Automation version

Log in to your Aria Automation instance.
Click your username and select
About
to display a pop-up with the version details.

Log in to your Aria Automation instance.
Click the
Help
icon on the right side to show your version details at the bottom of the window.

Versioning support

curl -X PUT \
{{apigateway}}/catalog/v3/providers/{{providercode}} \
-H 'apikey: {{apikey}}' \
-H 'content-type: application/json' \
-H 'username: {{userid}}' \
-d '
{
   "adapter":"http://cb-catalog-int-api:3959/catalog/content/vra/v2",
   "provider":"{{providername}}",
   "enableVersion":false
}

Updating to Aria Automation 8.x

Upload the new API definitions related to the Aria Automation 8.x APIs using the following

cb-consume-bootstrap

script:

./vRA/insert_api_definitions.sh apigateway userid userapikey

Delete and re-upload the new updated standard operations from the Aria Automation standard operations folder using the

cb-provisioning-template

script.

./readTemplates.sh . apigateway userid userapikey

If your provider code is not the default existing code Aria Automation, then ensure that the following changes are made to each of the operation files (power-on, power-off, reboot) before executing the script:

Rename the operation definition and template files for each operation using this format:
<operationcode>-<providercode>_definition.json (for example, powerOff-vrademo_definition.json)
<operationcode>-<providercode>_template_.json (for example, powerOff-vrademo_template.json)
Make the following operation definition changes:
Change the ID to the following format:
<existingid>-providercode (for example, reboot-vrademo)
Update the provider code and routing key.
Update the
provider.name
field.
Change the
serviced
to match the ID you changed in the previous operation definition changes section step.

Re-run the proxy adapter installer by changing the proxy adapter image to the latest release image.

#Advanced configuration
Vra_proxy_image_name=<< Docker imageName of proxy adapter >>

Configuring custom forms

Derived default value

   "derivedData": {
      "type": "bindField/conditionalField/computedField/externalValue",
      "data": {}
   }

   {
      "id": "textField_bed9f6b1",
      "name": "Text Field - Conditional",
      "required": false,
      "default": null,
      "editable": true,
      "hidden": false,
      "group": "page_c3e527c3",
      "configGroupCode": "page_c3e527c3",
      "configGroupName": "Text Fields",
      "binding": "$.inputs.textField_bed9f6b1",
      "description": "",
      "serviceDetails": "",
      "configEditable": true,
      "isSelected": false,
      "inputType": "freetext",
      "derivedFrom": ["textField_34590542"],
      "derivedData": {
         "type": "conditionalField",
         "data": [{
               "within": {
                  "textField_34590542": "abc def"
               },
               "value": "1000"
         }]
      }
   }

   {
      "id": "textField_ba7fc2ac",
      "name": "Text Field - External",
      "required": false,
      "default": null,
      "editable": true,
      "hidden": false,
      "group": "page_c3e527c3",
      "configGroupCode": "page_c3e527c3",
      "configGroupName": "Text Fields",
      "binding": "$.inputs.textField_ba7fc2ac",
      "description": "",
      "serviceDetails": "",
      "configEditable": true,
      "isSelected": false,
      "inputType": "freetext",
      "derivedFrom": ["$projectId"],
      "derivedData": {
         "type": "externalValue",
         "data": {
               "type": "external",
               "apiId": "vra8FormsExternalValue",
               "params": {
                  "projectId": "${$projectId}",
                  "body": {
                     "uri": "com.ibm.mcmp.actions/getMCMPProject",
                     "dataSource": "scriptAction",
                     "parameters": []
                  }
               },
               "return": {
                  "id": "$.data",
                  "label": "$.data"
               },
               "handleByAdapter": true
         }
      }
   }

Multi Value Picker attribute

   {
      "id": "datagrid_08e0992a",
      "name": "Constant - Multi Constant Constant",
      "required": false,
      "default": null,
      "editable": true,
      "hidden": false,
      "group": "page_2fc75061",
      "configGroupCode": "page_2fc75061",
      "configGroupName": "Data Grid",
      "binding": "$.inputs.datagrid_08e0992a::multiValuePicker",
      "description": "",
      "serviceDetails": "",
      "configEditable": true,
      "isSelected": false,
      "inputType": "multiselect",
      "derivedValues": [{
         "valueId": "{\"string_field\":\"String 1\",\"string_field1\":\"String 11\"}",
         "label": "String 1"
      }, {
         "valueId": "{\"string_field\":\"String 2\",\"string_field1\":\"String 22\"}",
         "label": "String 2"
      }]
   }

Known issues

The Virtual Machine property
'provisionGb'
remains unchanged after updating disk size due to a VMware issue.
Standard operations associated to a XaaS (Anything as a Service) blueprint do not update the status of Virtual Machine in Aria Automation even after the status has been updated in vSphere. This is a VMware issue.
The
File Upload Custom Form
attribute is not supported.
In
derivedData
of type
conditionalField
for the 'within' operator, the child value is not set as expected if the parent value is empty.
Setting of a default value for multi-select configurations is not supported.
When migrating versioning information for Aria Automation 8.x services, the labels are set to the default labels for the first version of the service, which is v1.0.0.0 instead of the version set in Aria Automation. However, this has no impact on the provisioning for that version of the service.