VMware

VMware vRealize Orchestrator Plug-In for vRealize Automation 7.0 Release Notes

VMware vRealize Orchestrator Plug-In for vRealize Automation 7.0 | 8 December 2015 | Build XXX

VMware vRealize Orchestrator 7.0 | 8 December 2015 | Build XXX

VMware vRealize Automation 7.0 | 8 December 2015 | Build XXX

Check frequently for additions and updates to these release notes.

What's in the Release Notes

The release notes cover the following topics:

Introduction to VMware vRealize Orchestrator Plug-In for vRealize Automation

The VMware vRealize Orchestrator vRealize Automation plug-in provides access and control over any vRealize Automation system.

The vRealize Orchestrator vRealize Automation plug-in provides the following capabilities:

  • Interact with and manage catalog services, catalog items, advanced services custom resources, service blueprints and resource actions, tenants, approvals and entitlements, work items, and blueprints.
  • Allow organizations to automate operations on the vRealize Automation IaaS model entities.
  • Integrate your existing business logic and models with an arbitrary vRealize Automation server.
  • Add a vRealize Automation as a policy-based, declarative multi-hypervisor, provisioning functionality to an existing top level service catalog portal.
  • Use the vRealize Automation plug-in policies to place a workload when a scale out update is needed based on performance triggered by vRealize Operations.
  • Enable workflow designers to include create, read, update, and delete operations for an arbitrary vRealize Automation model entity in any entity set.
  • Connect dynamically to a vRealize Automation system and provision a virtual machine from a vRealize Automation blueprint.

The VMware vRealize Orchestrator Plug-In for vRealize Automation 7.0 release runs on VMware vRealize Orchestrator 7.0. For instructions about installing and configuring the plug-in, see Using the vRealize Orchestrator Plug-In for vRealize Automation 7.0.

For information about vRealize Orchestrator, vRealize Orchestrator plug-ins, or vRealize Automation see the following documentation:

What's New in vRealize Orchestrator Plug-In for vRealize Automation 7.0

This release of the vRealize Orchestrator Plug-In for vRealize Automation introduces the following new functionality:

  • vRealize Orchestrator Plug-In for vRealize Automation 7.0 works with vRealize Automation 7.0 and vRealize Orchestrator 7.0.

Resolved Issues

The following issues are resolved in vRealize Orchestrator Plug-In for vRealize Automation release 7.0:

  • Error when running the Import vCenter Virtual Machine workflow in vRealize Orchestrator
    When you run the Import vCenter Virtual Machine workflow provided by the plug-in, the workflow fails and an error similar to the following appears:
    Link collections can only contain Entity instances, current is: null (Dynamic Script Module name : updateEntity#12)
    The error occurs when the virtual machine storage path is associated with a single storage unit from a storage cluster, but the reservation is associated with the cluster.

    Workaround: Before you run the Import vCenter Virtual Machine workflow, you must configure the reservation compute resources with all the individual child storage units for the cluster.
    1. In vRealize Automation, select Infrastructure > Reservations.
    2. Select the vSphere reservation.
    3. Click the Resources tab.
    4. Select the cluster associated with the virtual machine that you will import in the Compute resources drop-down menu.
    5. Select and configure the child nodes in the Storage list.
    6. Click Save for each storage unit.
    7. Click Save on the page when all the child storage units configured.



Known Issues

Some issues have been discovered and the following information is intended to help you understand behavior that you might encounter in this release:

  • Retrieving approval information by using a script results in missing property '@type' error
    The missing property type error is returned when you use the following script to retrieve approval information:
    var service = vcacHost.createApprovalClient().getApprovalApprovalInfoService();
    var approvalInfo = service.getApprovalInfo( approvalId );


    Workaround: Use the following script to retrieve approval information:
    var approvalClient = vcacHost.createApprovalClient();
    var vars = [ approvalId ]; var approvalInfo = approvalClient.getWithVariables("/info/approvals/{0}", vars);
    var approvalPolicy = new vCACCAFEApprovalDescriptiveReference() ;
    approvalPolicy.setId(approvalInfo.getProperty("policy").getProperty("id"));
    approvalPolicy.setName(approvalInfo.getProperty("policy").getProperty("name"));
    approvalPolicy.setDescription(approvalInfo.getProperty("policy").getProperty("description"));

  • On the Items tab of the vRealize Automation console, the name and description of some vCAC Infrastructure Administration resources do not display correctly
    If you publish a catalog item by using the Advanced Service Designer based on an infrastructure administration workflow that has an output parameter of vCAC:Entity type, when consumers request the catalog item successfully, the name and description of the provisioned items do not display correctly.

  • The requests workflows for waiting do not work correctly when a vCloud Automation Center host is added with Per User Session connection and the vRealize Orchestrator server is restarted during running of the workflows
    The Wait for work item, Wait for resource action request, and Wait for catalog item request workflows result in "Unable to retrieve authentication for this task" instead of "Approved" or "Rejected" if a vRealize Automation host is added with Per User Session connection and the vRealize Orchestrator server is restarted during running of these workflows.

  • vRealize Automation Plug-in API documentation is still in development
    vCAC and VCACCAFE modules of the vRealize Orchestrator API Explorer do not provide complete API documentation.

    Workaround: You can download the latest versions of the API documentation from vRealize Automation Documentation or access the vRealize Automation API documentation on https://vRealize_automation_appliance_host/component-registry/services/docs.

  • Searching for business groups returns results for all hosts
    When you run workflows for updating or deleting business groups, or adding, updating, or deleting custom properties for a business group from the Workflows view, there is no option to restrict the search function to a particular vRealize Automation host.

    Workaround: Run these workflows from the Inventory view.

    1. Click the Inventory view in the Orchestrator client.
    2. Right-click the business group you want to update.
    3. Select the workflow to run.

  • The workflows provided in the plug-in do not perform the same validation as vRealize Automation UI
    The vRealize Automation user interface performs validation checks, but not all of this logic is accounted for in the workflows provided with the plug-in. For example, vRealize Automation prevents you from creating a tenant with a non-unique URL, but the plug-in workflow does not validate this. Make sure that your custom workflows take care of any validation required by vRealize Automation.

  • The vCACCAFEAuthenticationGroupService.updateCustomGroup method removes all members of the updated group

    Workaround: Before using the vCACCAFEAuthenticationGroupService.updateCustomGroup method, retrieve the group members and reassign them to the group after the update, for example:

    // Create a vCACCAFEAuthenticationGroupService instance to perform operations, where host is the vcac host configured by the vcaccafe plug-in.

    var groupService = host.createAuthenticationClient().getAuthenticationGroupService();

    // Retrieve current members, where groupToBeUpdated is the target custom group

    var membersUsers = groupService.getUsersInGroup(tenant, groupToBeUpdated, criteria, pageable);

    var membersGroups = groupService.getGroupsByCriteriaAndDomainAndParentGroup(tenant, criteria, domain, groupToBeUpdated);

    // Update the group, retrieve the updated group, and reassign the members:

    groupService.updateCustomGroup(tenant, groupToBeUpdated);

    var updatedGroup= groupService.getGroup(tenant, groupToBeUpdated.getPrincipalId().asString());

    groupService.assignGroupsAndUsersToCustomGroup(tenant, updatedGroup, membersGroups, membersUsers);

Top of Page