ViPR 2.1 - Create a VM and provision an RDM with EMC ViPR and vCAC

Table of Contents

Integrating EMC ViPR with VMware vCloud Automation Center

EMC has made it easy to integrate EMC ViPR by providing an orchestration interface to the ViPR platform.

The EMC ViPR Plug-in for VMware vCenter Orchestrator is a collection of workflows that communicate with EMC ViPR to carry out common operations for software defined storage. The common operations include provisioning, expanding, or removing file and block storage.

vCloud Automation Center can consume workflows directly from vCenter Orchestrator. Therefore, the EMC ViPR Plug-in for vCenter Orchestrator is a required integration component. Using this component means that integration from vCAC to EMC ViPR can be done without any knowledge of the EMC ViPR API.

Back to Top

The Example Scenario

vCAC is a compute-centric product. EMC ViPR is a software defined storage product.

For our example, a use case was chosen that combines both products into one simple example. You can use this example to branch out to develop scenarios that are specific to your business.

Use case

A user would like to provision a virtual machine for a database and allocate dedicated storage for the database. A vCloud Automation Center blueprint is created that defines the virtual machine and storage from EMC ViPR to be used for the database. The storage provisioned from EMC ViPR will be mapped to the virtual machine using Raw Device Mapping in vCenter.

Back to Top

System overview

The following diagram shows the components used in the integration.

Back to Top

System Prerequisites

The components demonstrated in the System Overview must be installed and able to communicate on the network.

vCloud Automation Center System Prerequisites

This document assumes that the following baseline configuration, which is required for any integration with vCloud Automation Center (vCAC), was configured prior to installing and running the EMC ViPR example.

vCloud Automation Center server requirements

vCenter Orchestrator server requirements

vCenter server requirements

EMC ViPR System Prerequisites

EMC ViPR must be installed and configured for the storage array that will be used. EMC ViPR must be configured to the point where it is ready to provision storage.

Back to Top

Supported versions

This use case supports the following software versions.

Back to Top

Preparing the system to run the example

To ensure success, follow this high level process for preparing the vCAC environment to successfully run the EMC ViPR example.

Back to Top

Configure vCAC appliance to vCO server

From the vCAC console, configure vCAC to the vCO server.

Procedure

  1. Log into the vCAC appliance using SSO credentials.
  2. Navigate to Administration > Advanced Services.
  3. Select Server Configuration.
    The Server configuration wizard displays.
  4. Select Use an external Orchestrator server and then provide all vCO related details which has ViPR vCO Plugin.
  5. Click Test Connection to validate the connection to vCO.
  6. Click Update.
    vCAC is configured to the vCO server.
Back to Top

Assign the Service Architect role to AD user

From the vCAC console, assign the service architect role to the AD user.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Administration > Groups and then click Domain Admins.
  3. Select the Service Architect role and then click Update.
  4. Logout from the vCAC appliance to ensure that the changes are applied.
  5. Log into the vCAC appliance again using the AD user.
    The Advanced Services tab displays in the vCAC console.
Back to Top

Add the vCAC license

From the vCAC console, add the vCAC license.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Infrastructure > Administration and then click Licensing.
  3. Click Add License.
    The Add License wizard displays.
  4. Type the vCAC license key and then click OK.
    The license key is listed with the license information.
  5. Logout and login again to ensure the license changes are effective.
Back to Top

Create endpoints and its credentials

From the vCAC console, create endpoints and add the vCenter credentials.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Infrastructure > Endpoints and then click Credentials.
  3. Click New credentials. Type the vCenter server credentials and then save.
    The vCenter server credentials are listed under Credentials.
  4. Click Endpoints. Type the vCenter server details and then save.
    The vCenter server is listed under Endpoints and its compute resources are discovered.
  5. Click New credentials. Type the vCenter Orchestrator Client credentials and then save.
    The vCenter Orchestrator credentials are listed under Credentials.
  6. Click Endpoints. Type the vCenter Orchestrator details and then save.
    The vCenter Orchestrator is listed under Endpoints.
Back to Top

Create Fabric Group and Business Group

From the vCAC console, create Fabric Groups and Business Groups.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Infrastructure > Groups and then click Fabric Groups.
  3. Click New Fabric Group.
  4. Provide the required details and then click OK.
    The new fabric group displays in the Fabric Groups list.
  5. Logout and then login again to ensure the fabric group changes are effective.
  6. Navigate to Infrastructure > Groups and then click Business Groups.
  7. Click New Business Group.
  8. Provide the required details and then click OK.
    The new business group displays in the Business Groups list.
Back to Top

Create machine prefixes

From the vCAC console, create machine prefixes.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Infrastructure > Blueprints and then click Machine Prefixes.
  3. Click New Machine Prefix.
  4. Provide the required details and then click OK.
    The new machine prefix displays in the Machine Prefixes list.
Back to Top

Create Reservation and Blueprint

From the vCAC console, create a reservation and blueprint.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Infrastructure > Reservations and then click New Reservation.
  3. Select Virtual > vSphere (vCenter).
  4. Provide the required details and then click OK.
    The new reservation displays in Reservations list.
  5. Navigate to Infrastructure > Blueprints and then click New Blueprint.
  6. Select Virtual > vSphere (vCenter).
  7. In Blueprint information, provide the name as Create Virtual Machine, click Master (copyable), and then select the data for other mandatory fields.
  8. In Build Information, select Action as Create and then Provisioning workflow as BasicVMWorkflow. Provide the Machine Resource details.
  9. In Properties, click New Property and then provide the name VMware.VirtualCenter.OperatingSystem and value sles10_64Guest. Save these details.
  10. Click OK.
    The blueprint displays under Blueprints.
  11. Publish the Blueprint by choosing publish option.
Back to Top

Create virtual machine

From the vCAC console, create a virtual machine.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Administration > Catalog Management and then click Services.
  3. Click the add (+) icon to add Service.
  4. Type the name Create Virtual Machine (can be user defined) and then select the status as Active.
  5. Click Add.
    The new service displays in the Services list.
  6. Select the service and then click Manage Catalog Items.
  7. Click the add (+) icon. The catalog items should be automatically populated and then select Create Virtual Machine.
  8. Click OK.
    The service displays under Catalog Items.
  9. Click Close.
  10. Navigate to Administration > Catalog Management and then click Entitlements.
  11. Click the add (+) icon to add Entitlement.
  12. Provide the Name EMC vSphere Admins, User as Registered AD users, status as Active and then click Next.
  13. In Item & Approvals, click the add (+) icon to add Entitled Services and then click Create Virtual Machine. Click OK.
    The service displays in the Entitled Services list.
  14. Click the add (+) icon to add Entitled Catalog Items and then click Create Virtual Machine. Click OK.
    The item displays in the Entitled Catalog Items list.
  15. Click the add (+) icon to add Entitled Actions and then add the appropriate actions.
  16. Click OK.
    The action displays in the Entitled Actions list.
  17. Navigate to Catalog and then select the Create Virtual Machine service.
  18. Click Request.
  19. Provide all the required details in the wizard and then submit the request.
    The Successful submission message displays.
  20. Navigate to Requests to check the status of your request.
    The request status is Successful.
  21. Log into vCenter server through vSphere client and validate that the Virtual Machine is created.
Back to Top

Create property dictionary

From the vCAC console, configure vCAC to the vCO server.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Infrastructure > Blueprints and then click Property Dictionary.
  3. Click New Property Definition and then type the following details for the ViPR Virtual Array.
    Column Value
    Name EMC.ViPR.VirtualArray
    Display Name EMC ViPR VirtualArray
    Control Type DropDownList
    Required Yes
    Property Attributes <Comma separated ViPR Virtual Array list>
  4. Click New Property Definition and then type the following details for the ViPR Virtual Pool.
    Column Value
    Name EMC.ViPR.VirtualPool
    Display Name EMC ViPR Virtual Pool
    Control Type DropDownList
    Required Yes
    Property Attributes <Comma separated ViPR Virtual Pool list>
Back to Top

Create an EMC ViPR build profile

From the vCAC console, create a build profile.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Infrastructure > Blueprints and then select Build Profiles.
  3. Click New Build Profile.
  4. Type the name EMC ViPR Provisioning.
  5. Under Custom properties, click New Property and then type the following details.
Back to Top

Create blueprint for EMC ViPR provisioning

From the vCAC console, create a blueprint for EMC ViPR provisioning.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Infrastructure > Reservations and then click Reservations.
  3. Click New Reservation and then select Virtual > vSphere (vCenter).
  4. Provide the required details and then click OK.
    The reservation displays in the Reservations list.
  5. Navigate to Infrastructure > Blueprints and then click New Blueprint.
  6. Select Virtual > vSphere (vCenter).
  7. Select Create Virtual Machine from Copy from existing blueprint dropdown list.
  8. Provide the name EMC ViPR Example and then click Properties.
  9. Navigate to Build profiles and then click EMC ViPR Provisioning.
  10. Under Custom properties, click New Property and then type the vCO endpoint name and virtual center operating system.
  11. Click OK.
    The blueprint information displays under Blueprints.
  12. Publish the Blueprint by choosing publish option.
Back to Top

Install and configure vCAC in vCO

Install the vCAC plugin and then configure vCAC in vCO.

Procedure

  1. Download the vCAC o11nplugin-vcac.dar plugin from the vCAC appliance in /usr/lib/vco/app-server/plugins.
  2. Install the vCAC Plugin in vCO through vCO Configuration page.
  3. Restart all of the vCO related services once the vCAC plugin is successfully installed.
  4. Log into the vCO Client and then verify the vCloud Automation Center folder is available under Workflows section.
  5. Navigate to the vCloud Automation Center > Configuration folder and then run the Add a vCAC host workflow.
  6. Type all of the vCAC related details and then submit the workflow.
  7. Once the workflow is successfully executed, verify the vCAC details are displayed properly under Inventory.
Back to Top

Configure vCAC custom workflow for EMC ViPR

From the vCO user interface, configure the vCAC custom workflow for EMC ViPR.

Procedure

  1. Log into the vCO Client using admin privileges.
  2. Select EMC ViPR folder under workflow tab and then click Import Workflow.
  3. Select vCAC Custom Workflow for ViPR from the ViPR Enablement Kit folder.
    The workflow is imported into vCO.
  4. Navigate to the vCloud Automation Center > Extensibility > Installation folder and then start the Install vCO customization workflow.
  5. Type the vCloud Automation Center Host (vCAC IAAS Server Hostname) and then click Next.
  6. Keep the default values in State Change Workflow and then click Next.
  7. Specify the value as 5.0 for Number of menu operations and their workflows field and then click Submit. It may take some time to execute this workflow. Ensure that this workflow executes successfully.
  8. Navigate to vCloud Automation Center > Extensibility and then start the Assign a state change workflow to a blueprint and its virtual machines workflow.
  9. Select MachineProvisioned and then type the vCAC host name.
  10. Select the Blueprints name as EMC ViPR Example from the list. Leave the remaining fields to the default values.
  11. Select vCAC Custom Workflow for ViPR for the End user workflow to run field. Leave the remaining fields to default values.
  12. Click Submit and then verify that the workflow successfully executed.
  13. Log into the vCAC appliance using the AD user.
  14. Navigate to Infrastructure > Blueprints and then select Blueprints.
  15. Select EMC ViPR Example and then verify that the ExternalWFStubs.MachineProvisioned property exists under Properties.
  16. Click OK.
Back to Top

ViPR example: Create a VM and provision an RDM with EMC ViPR storage

From the vCAC user interface, create a VM and provision an RDM with EMC ViPR storage.

Procedure

  1. Log into the vCAC appliance using the AD user.
  2. Navigate to Administration > Catalog Management and then click Services.
  3. Click the add (+) icon to add Service.
  4. Type the name EMC ViPR Example (can be user defined) and then select the status as Active.
  5. Click Add.
    The service displays in the Services list.
  6. Select the service and then click Manage Catalog Items.
  7. Click the add (+) icon. The Catalog Items should be automatically populated and then select EMC ViPR Example.
  8. Click OK to add the populated service.
    The item displays under Catalog Items.
  9. Click Close.
  10. Navigate to Administration > Catalog Management and then click Entitlements.
  11. Click the add (+) icon to add an entitlement.
  12. Type the name EMC vSphere Admins, Users as Registered AD users, and status as Active. Click Next.
  13. Under Item & Approvals, click the add (+) icon to add Entitled Services. Click EMC ViPR Example and then click OK.
    The services displays in the Entitled Services list.
  14. Click the add (+) icon to add Entitled Catalog Items. Click EMC ViPR Example and click OK.
    The item displays in the Entitled Catalog Items list.
  15. Click the add (+) icon to add Entitled Actions and then add the appropriate actions.
  16. Click OK.
    The action displays in the Entitled Actions list.
  17. Navigate to Catalog and then select EMC ViPR Example > Request.
  18. Type all of the required details in the wizard and then submit the request.
    The Successful submission message displays.
  19. Navigate to Requests to check the status of your request.
    The request status is Successful.
  20. Log into the vCenter server through the vSphere client and then validate if the Virtual Machine is created and provisioned with raw device mapping (RDM) of EMC ViPR Storage.
  21. Validate the EMC ViPR volume information in the ViPR GUI or CLI.
Back to Top