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

Table of Contents

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

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 VMware vCenter Orchestrator is a required integration component. Using this component means that integration from vCloud Automation Center to EMC ViPR can be done without any knowledge of the EMC ViPR API.

Back to Top

The Example Scenario

vCloud Automation Center 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 Server.

Back to Top

System Prerequisites

The following components must be installed and able to communicate on the network.

For supported versions, see the EMC ViPR Support Matrix available on the EMC Community Network (community.emc.com).

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

Preparing the system to run the example

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

Procedure

  1. Setup vCloud Automation Center.
  2. Create the Baseline Blueprint.
    Checkpoint 1 - Create a virtual machine.
  3. Configure vCenter Orchestrator.
    Checkpoint 2 - Test the EMC ViPR plugin.
  4. Install EMC ViPR.
  5. Configure vCloud Automation Center to run the 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 EMC ViPR plug-in for VMware vCenter Orchestrator.
  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 and then login again using the AD user to ensure that the changes are applied.
    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 then 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 following details.
    1. Type the name Create Virtual Machine
    2. Click Master (copyable).
    3. Select the data for other mandatory fields.
  8. In Build Information, provide the following details.
    1. Select the Action as Create.
    2. Select the Provisioning workflow as BasicVMWorkflow.
    3. Provide the Machine Resource details.
  9. In Properties, provide the following details.
    1. Click New Property.
    2. Type the name VMware.VirtualCenter.OperatingSystem
    3. Type the value sles10_64Guest
    4. 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 following details.
    1. Type the Name EMC vSphere Admins
    2. Select the User as Registered AD users.
    3. Select the status Active.
    4. Click Next.
  13. In Item & Approvals, provide the following details.
    1. Click the add (+) icon to add Entitled Services.
    2. Click Create Virtual Machine.
    3. 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. Type 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 vCAC 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 EMC 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 vCAC 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

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

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

Procedure

  1. Log into the vCloud Automation Center 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. Perform the following steps.
    1. Type the name EMC vSphere Admins
    2. Type the users Registered AD users
    3. Type the status Active
    4. 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