VMware vCenter Orchestrator Plug-In for Site Recovery Manager 5.8 Release Notes

|

VMware vCenter Orchestrator Plug-In for Site Recovery Manager 5.8.0.1 | 09 APR 2015 | Build 2557742 | Download

VMware vCenter Orchestrator Plug-In for Site Recovery Manager 5.8 | 09 SEP 2014 | Build 2098727

VMware vCenter Orchestrator 5.5.2 | 09 SEP 2014 | Build 1951762 | Release Notes

VMware vCenter Orchestrator 5.5.2 Appliance | 09 SEP 2014 | Build 1992027 | Release Notes

VMware vCenter Site Recovery Manager 5.8 | 09 SEP 2014 | Build 2056894 | Release Notes

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 the VMware vCenter Orchestrator Plug-In for Site Recovery Manager 5.8

The VMware vCenter Orchestrator plug-in for Site Recovery Manager allows Site Recovery Manager administrators to simplify the management of their Site Recovery Manager infrastructure by extending the robust workflow automation platform of Orchestrator. You build these workflows by using the drag-and-drop capability of the workflow editor in the Orchestrator client. Orchestrator uses the plug-in to access the functionality of Site Recovery Manager and the Site Recovery Manager API. The included, pre-built workflows simplify the process to get you started with custom workflow creation.

The Orchestrator plug-in for Site Recovery Manager 5.8 release runs with VMware vCenter Orchestrator 5.5.2.

You can download the Orchestrator plug-in for Site Recovery Manager 5.8 from the download page.

Installation

The Orchestrator Plug-In for Site Recovery Manager software is distributed as Orchestrator application file. Install and configure the plug-in by using the Orchestrator configuration interface.

After you install the Orchestrator Plug-In for Site Recovery Manager, the plug-in automatically discovers the Site Recovery Manager Server instances on both sites.

NOTE: Orchestrator uses vCenter Single-Sign On. To use the Orchestrator Plug-In for Site Recovery Manager, use the vCenter Single Sign-On credentials to log into vSphere Web Client or the Orchestrator client.

After you install the Orchestrator Plug-In for Site Recovery Manager, you find the Site Recovery Manager workflows in the vSphere Web Client:

  1. Go to vCenter Orchestrator > Workflows view in the vSphere Web Client.
  2. Expand the hierarchy to navigate to the vCO Servers > vco_server > Library > SRM folder.

Before you can run the Site Recovery Manager workflows, you must first run the Library > SRM > Configuration > Login workflow to log into Site Recovery Manager on the remote site. You must run this workflow once per Orchestrator Client session. The Login workflow logs out of Site Recovery Manager when you log out of the Orchestrator client.

Reconfiguring Non-Default Site Recovery Manager Ports

When you access the Orchestrator plug-in for Site Recovery Manager for the first time it creates the SRM.xml configuration file on the Orchestrator server. If you configured Site Recovery Manager to use API listener ports that are not the default ports, you must update the port settings in the SRM.xml configuration file before you can use the Orchestrator plug-in for Site Recovery Manager. If you installed Site Recovery Manager with the default ports, you do not need to update SRM.xml.

  1. Log in to the Orchestrator server host machine.
  2. Browse the inventory of workflows under vCenter Orchestrator > Inventory > SRM. This creates the SRM.xml file.
  3. Open the SRM.xml configuration file in an editor.
    You find the SRM.xml configuration file in the following locations:
    • Windows host: C:\Program Files\VMware\Orchestrator\app-server\conf\plugins\SRM.xml
    • vCenter Orchestrator appliance: /etc/vco/app-server/plugin/SRM.xml
  4. Set the listener ports for the local and remote Site Recovery Manager Server instances that you set when you installed Site Recovery Manager Server.
    In the following example, Site Recovery Manager uses ports 9007 and 9017.
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <SrmExtensions>
        <SrmExtension id="srm_id">
            <localPort>9007</localPort>			      
            <remotePort>9017</remotePort>		      	   
        </SrmExtension>
        <SrmExtension id="srm_id">
            <localPort>9007</localPort>			    
            <remotePort>9017</remotePort>		    
        </SrmExtension>
    </SrmExtensions>
    
  5. Restart the Orchestrator service.

Example Workflows

The Orchestrator Plug-In for Site Recovery Manager includes example workflows in Library > SRM > SRM Samples that demonstrate how you can automate Site Recovery Manager operations by using Orchestrator.

  • Create VM and Protect It:
    1. Creates a virtual machine
    2. Adds the virtual machine to an existing protection group
  • Create ABR Group, Protect Existing VMs, Add to Recovery Plan:
    1. Creates an array-based protection group
    2. Protects the virtual machines in a given datastore by adding that datastore to the protection group
    3. Adds the new protection group to an existing recovery plan
  • Post Provisioning SRM Configuration for VCAC Workflow
    1. Determines whether a datastore is included in a Site Recovery Manager protection group when vCloud Automation Center provisions a virtual machine on that datastore.
    2. If so, configures protection on the virtual machine.
    3. Determines whether the protection group is included in a recovery plan.
    4. If so, parses any custom properties associated with the recovery plan to determine whether to customize the recovery settings of the virtual machine.
  • Set Recovery Settings from VCAC VM Properties
    • Customizes the recovery settings with which to start the recovered virtual machine on the recovery site, based on the vCloud Automation Centre properties for that virtual machine.

Resolved Issues in Plug-In Version 5.8.0.1

The following issue has been fixed in the VMware vCenter Orchestrator Plug-In for Site Recovery Manager 5.8.0.1 release:

  • vCenter Orchestrator Plug-In for Site Recovery Manager times out with the error SAML token is required for signing

    After a period of inactivity of longer than 20 minutes, the vCenter Orchestrator Plug-In for Site Recovery Manager 5.8 times out. The error message is SAML token is required for signing. This has been fixed in the vCenter Orchestrator Plug-In for Site Recovery Manager 5.8.0.1 release.

  • The Orchestrator plug-in for vCloud Automation Center 6.1 in the embedded Orchestrator server in vCloud Automation Center 6.1 is incompatible with the Orchestrator plug-in for Site Recovery Manager 5.8.

    The Orchestrator plug-in for vCloud Automation Center 6.1 that is preinstalled in the Orchestrator server that is embedded in vCloud Automation Center 6.1 contains an issue that makes it incompatible with the Orchestrator plug-in for Site Recovery Manager 5.8. If you are using the preinstalled vCloud Automation Center plug-in and you try to run either of the Post Provisioning SRM Configuration for VCAC or the Set Recovery Settings from VCAC VM Properties workflows, the workflow fails with the error "TypeError: Cannot read property "datastore" from null".

    This has been fixed in the vCenter Orchestrator Plug-In for Site Recovery Manager 5.8.0.1 release.

Known Issues in Plug-In Version 5.8

The following issues are known to occur in the VMware vCenter Orchestrator Plug-In for Site Recovery Manager 5.8 release:

  • The Orchestrator plug-in for vCloud Automation Center 6.1 in the embedded Orchestrator server in vCloud Automation Center 6.1 is incompatible with the Orchestrator plug-in for Site Recovery Manager 5.8.

    The Orchestrator plug-in for vCloud Automation Center 6.1 that is preinstalled in the Orchestrator server that is embedded in vCloud Automation Center 6.1 contains an issue that makes it incompatible with the Orchestrator plug-in for Site Recovery Manager 5.8. If you are using the preinstalled vCloud Automation Center plug-in and you try to run either of the Post Provisioning SRM Configuration for VCAC or the Set Recovery Settings from VCAC VM Properties workflows, the workflow fails with the error "TypeError: Cannot read property "datastore" from null".

    Workaround: Upgrade the vCenter Orchestrator Plug-In for Site Recovery Manager 5.8 to version 5.8.0.1. You do not need to upgrade Site Recovery Manager or vCenter Orchestrator.

    If cannot upgrade the Orchestrator plug-in for Site Recovery Manager 5.8 to version 5.8.0.1, do not use the Orchestrator plug-in for vCloud Automation Center 6.1 that is preinstalled in the Orchestrator server that is embedded in vCloud Automation Center 6.1. Download and install the Orchestrator plug-in for vCloud Automation Center 6.1 that is available as a separate download from the vCloud Automation Center downloads page. The vCloud Automation Center plug-in that is available from the downloads page contains the fix that resolves this issue.