Table of Contents

About this document

Before you begin

Virtual Connect Features and HP OneView

Backing up the Virtual Connect Domain

Virtual Connect domain status

Windows PowerShell

Support

VCtoOneView.ps1 PowerShell Script

Overview

Purpose

Accompanying Resources and Prerequisites

Required software components

Authorization requirements

Usage

Overview

Compatibility Check

Add Enclosure to a new Enclosure Group

Add Enclosure to existing Enclosure Group

Using in Virtual Connect Enterprise Manager environments

Output Files

VCtoOneView script operation flow

Limitations

What is not migrated

Firmware Baselines

Bandwidth Overprovisioning

Appendix A: VCtoOneView compatibility check status messages and description

Appendix B:  Sample Output Files

Sample generated migration script

Sample generated JSON resource definition file – Server Profiles

About this document

This document describes a scripted method which can be utilized to migrate an existing Virtual Connect (VC) domain to management under HP OneView.  This document describes the purpose, prerequisites, usage, and limitations of this scripted migration process.

Before you begin

Virtual Connect Features and HP OneView

There may be features enabled in a Virtual Connect configuration that have not been implemented in the current version of HP OneView.  Some of these features may prohibit migrating to OneView.  The whitepaper, “Transitioning a Virtual Connect Configuration to HP OneView” contains a full list of these features for the current version of HP OneView.

Backing up the Virtual Connect Domain

Before attempting to migrate a VC domain to HP OneView it is highly recommended to capture a backup of the domain configuration.  The Virtual Connect Manager (VCM) GUI can be used to save the configuration backup in binary format.  The VCM command line interface can used to capture the backup in a scripted format by executing the command “show config”.  On VCM version 4.20 or higher, ues “show config –includepoolinfo.”   For additional information or instructions on backing up your VC domain and command line options for the Virtual Connect command line interface please refer to Virtual Connect documentation at http://www.hp.com/go/virtualconnect/docs.

Virtual Connect domain status

Please insure that the candidate Virtual Connect domain is in a healthy status and has no pending updates prior to beginning the migration process.  Any updates that are pending when the migration process is started my not be reflected in the generated migration scripts.

Windows PowerShell

The scripting language utilized by the migration process is Windows PowerShell.  It is recommended that the reader have some knowledge of the PowerShell language in order to customize or enhance the generated migration scripts described in this paper.

Support

The process and scripts described in this paper are not officially supported by Hewlett-Packard.

Important

VCtoOneView only supports migrating to HP OneView version 1.10 from VCM versions 4.10 – 4.30.

VCtoOneView.ps1 PowerShell Script

Overview

VCtoOneView.ps1 is a migration script generation utility, it does not perform the actual migration.  The presence of an HP OneView appliance is not required in order to execute the script.  VCtoOneView analyzes a Virtual Connect configuration and translates the VC managed objects into equivalent OneView resources.  VCtoOneView then generates migration script(s) that should be analyzed and can be customized and enhanced if desired.

Purpose

Written by HP field personnel, VCtoOneView is an interim solution for automating the transition from VC Manager to OneView management.  Its primary goal is to perform that transition as seamlessly as possible in order to minimize application downtime during the process.  VCtoOneView reads the VC configuration information using calls to the VC Manager interface, analyzes it for compatibility with OneView management, and then translates it into objects that can be used by the OneView RESTful interface for migration purposes.  This functionality will be included in a future release of HP OneView.

Accompanying Resources and Prerequisites

Required software components

For accessing the VC and Onboard Administrator interfaces, VCtoOneView utilizes a custom set of PowerShell cmdlets provided in HPVCtoOV.dll.  This dynamic link library file is provided in the same archive as the VCtoOneView.ps1 PowerShell script.  The migration scripts generated by VCtoOneView utilize the HP OneView PowerShell Library that is hosted on CodePlex.  The following list of prerequisites are required for using the VCtoOneView script and the HP OneView PowerShell Library.

·       Windows Management Framework 3.0

·       Windows Management Framework 4.0

·       .Net Framework 4.0

Authorization requirements

Administrative access to both HP OneView, Virtual Connect Manager, and the Onboard Administrator is required.  Local administrative access is required on the Windows workstation where the scripts are executed.

Usage

Overview

VCtoOneView is an interactive script that prompts the user for information at various points of execution.  There are three basic usage scenarios for VCtoOneView

1.        Compatibility Check

                  Ex:  PS C:\> powershell c:\VCtoOneView.ps1

2.        Add Enclosure to a new Enclosure Group – Script Generation

                  Ex:  PS C:\> powershell c:\VCtoOneView.ps1

3.        Add Enclosure to existing Enclosure Group – Script Generation

           Ex:  PS C:\>  powershell c:\VCtoOneView.ps1 –addToEnclosureGroup myExistingEnclosureGroup

Each method of execution requires login parameters for both the Onboard Administrator and Virtual Connect Manager.  The user is prompted for these parameters during execution.

Note

Certain special characters such as exclamation points (!) and ampersands (&) as the first character in response to input are treated as a ‘prompt command’ by PowerShell causing the input string to not be processed as desired.  If an input string contains a special character as the first character, the input string will be processed literally if enclosed in single quotes (see below example).  As an alternative, a temporary Administrative user with a password not beginning with an exclamation point can be created for use with the migration process.

Ex.  To process the password, !myPassword, enter ‘!myPassword’ at the prompt.

Compatibility Check

Each time that VCtoOneView is executed against an existing Virtual Connect configuration, analysis is done to determine its compatibility to be managed by HP OneView.  This analysis looks for VC features and parameters that prohibit the domain from being managed by HP OneView as well as VC features and parameters that are not currently implemented in HP OneView but do not prohibit the domain from being managed by HP OneView.  If no critical errors are identified during the VC configuration analysis, a firmware check is initiated on the Onboard Administrators, Virtual Connect modules and iLOs in the enclosure.

Refer to Appendix A for a full list of configuration checks and their impact on migrating to HP OneView.

Add Enclosure to a new Enclosure Group

The compatibility check is executed at the beginning of this usage scenario.  If the compatibility and firmware checks complete without error, VCtoOneView prompts the user to save the configuration output files and generated migration script.  By default, VCtoOneView generates a migration script that imports the BladeSystem enclosure and VC settings as the first enclosure in a new enclosure group.  No additional command line parameters are required by VCtoOneView to initiate this script generation.

Output script operations:

1.        Creates Ethernet networks and SAN fabrics

2.        Creates Network Sets

3.        Creates the Logical Interconnect Group

4.        Creates Uplink Sets for Ethernet and Fibre Channel networks

5.        Creates the new Enclosure Group

6.        Creates Server Profiles

7.        Imports the Enclosure into the new Enclosure Group created in step 5

8.        Powers off the server hardware

9.        Assigns the Server Profiles to the appropriate Server Hardware

10.    Powers on the Server Hardware

To speed up the enclosure import operation and to minimize application downtime, the enclosure group and server profiles have the firmware baseline set to “manage manually” in the generated script.

Note

Although the migration script contains commands to power off the servers, a graceful shutdown of the operating systems cannot be guaranteed.  Therefore, it is recommended that the user gracefully shutdown the servers either prior to executing the generated migration script, or prior to confirming the enclosure import operation in the migration script.

Add Enclosure to existing Enclosure Group

Requirements for a successful migration into an existing HP OneView enclosure group:

1.        All networks (Ethernet and Fibre Channel) already exist in HP OneView

2.        Uplinks set definitions on the candidate enclosure match those of the target enclosure group’s logical interconnect group definition in HP OneView.

3.        The candidate enclosure’s interconnect modules are identical and populated in the same bays as that of the target enclosure group’s logical interconnect group definition.

The compatibility check is executed at the beginning of this usage scenario.  If the compatibility and firmware checks complete without error, VCtoOneView prompts the user to save the configuration output files and generated migration script.  In this scenario a script is generated that will import the enclosure into an existing enclosure group that is specified by the user during script execution.

The example below demonstrates how to initiate VCtoOneView for this usage scenario.

  powershell c:\pathto\VCtoOneView.ps1 –addToEnclosureGroup MyExistingGroupName

Output script operations:

1.        Creates Network Sets

2.        Creates Server Profiles

3.        Imports the Enclosure into the specified Enclosure Group

4.        Powers off the server hardware

5.        Assigns the Server Profiles to the appropriate Server Hardware

6.        Powers on the Server Hardware

Note

This usage scenario assumes that the enclosure to be migrated is configured identically as the target enclosure group to which it will be added.  No checks are executed that insure that this is the case, so it is important that the user verify the configuration of the candidate VC domain prior to executing the generated migration script.

Note

Although the migration script contains commands to power off the servers, a graceful shutdown of the operating systems cannot be guaranteed.  Therefore, it is recommended that the user gracefully shutdown the servers either prior to executing the generated migration script, or prior to confirming the enclosure import operation in the migration script.

Using in Virtual Connect Enterprise Manager environments

VCtoOneView does not directly interact with Virtual Connect Enterprise Manager (VCEM), but still can be used to migrate all members of a VCEM domain group into HP OneView.  VCEM already enforces uniformity of configurations across VC domains in the domain group, thus insuring the requirements for a successful migration into a single enclosure group within OneView are already met.  The steps to migrate a VCEM domain group into HP OneView are straightforward.

1.        Generate a migration script for the first domain by executing VCtoOneView without the –addToEnclosureGroup switch.

2.        Generate subsequent migration scripts for the remaining members of the VCEM domain by executing VCtoOneView with the   -addToEnclosureGroup switch against each additional member of the VCEM domain group.

3.        Remove the domain members from the VCEM domain group.

4.        Execute the script generated in step one to create the Enclosure Group, Logical Interconnect Group and populate all networks in HP OneView.

5.        Execute the scripts generated in step two, in any order, to add the remaining enclosures to the Enclosure Group in HP OneView.

Note

Unassigned profiles in VCEM are captured in the last domain removed from the domain group and are not migrated to OneView. To capture the unassigned profiles for future reference, please insure you backup each VC domain, or capture the profile information from VCEM using the vcemcli –export command.   Ex:  vcemcli –export profiles –exportfile c:\myVCEMprofiles.csv

For a full listing of VCEM cli commands and their usage please reference the HP Virtual Connect Enterprise Manager Command Line Interface User Guide.

Output Files

VCtoOneView generates PowerShell scripts that are used for the actual migration to OneView as well as JSON resource definition files for use by the generated migration scripts.  Care should be taken when editing the migration scripts or the JSON resource files.

For uniqueness, names for the resources that will be created in OneView will have the enclosure serial number prepended to the names as they exist in Virtual Connect Manager.  These names are coded into the generated script and should not be altered.  Once the migration process is complete, the names can be changed without impact to server operation.

The output scripts for actual migration use the naming converntion VCDomainName-migrate.ps1

Please refer to Appendix B for a sample migration script and JSON resource definition file.

 

VCtoOneView script operation flow

Figure 1. VCtoOneView flow diagram

 

Limitations

As stated previously, the goal of the migration process described in this whitepaper is to minimize downtime and provide a seamless migration from Virtual Connect management to HP OneView management.  To that end, those features and functions of Virtual Connect that are non-essential to the application or server operation are not migrated from Virtual Connect to OneView.

Those features and settings that are not migrated, but are supported by OneView, can be manually enabled or edited in OneView at any point before or after the migration without impacting server operations.;

Important

Currently VCtoOneView only supports migrating to HP OneView version 1.10 from VCM versions 4.10 – 4.30

What is not migrated

The list below outlines those settings that are available in OneView but are not migrated as part of this process.  These are settings that can be manually added or altered in OneView after the migration with no impact on server operations.  For a full list of Virtual Connect features not currently implemented in OneView see the whitepaper, “Transitioning a Virtual Connect Configuration to HP OneView”

·       User/group settings and configuration

o    LDAP users

o    Local users

·       SNMP settings

·       Firmware baselines (Enclosure Firmware Management settings from the Onboard Administrator)

·       Unassigned Virtual Connect Profiles

Firmware Baselines

HP OneView enables the use of firmware baselines when adding enclosures and defining server profiles.  Applying baselines to these resources triggers an update attempt during enclosure import or application of a server profile.  This update process may delay the amount of time it takes to restore application functionality during the migration process.  For that reason, the firmware baseline setting for both enclosures and server profile is set to “manage manually” during resource import and creation on the OneView appliance.

Note that regardless of the firmware baseline setting, if the Onboard Administrator or iLOs are not at the minimum level required for OneView management, they will be automatically updated during the enclosure import process.  Virtual Connect modules that are not at the minimum firmware level for OneView management must be manually updated after enclosure import.  For this reason, it is recommended that the Onboard Administrators, iLOs, and Virtual Connect modules be updated to at least the minimum level for OneView management prior to attempting the migration process.  For a full list of the minimum firmware requirements for OneView management please see the HP OneView Compatibility Guide at http://www.hp.com/go/oneview/docs.

Bandwidth Overprovisioning

Virtual Connect Manager allows for the overprovisioning of physical links on Flex capable adapters and CNAs through the use of custom and preferred network speed settings.  HP OneView does not currently support overprovisioning of the physical adapter port.  In translating the profile connections from Virtual Connect to OneView, FlexNICs that have a requested bandwidth exceeding 2500 Mbps will have their bandwidth set to 2500 Mbps when migrated to OneView.

HP OneView allows requested bandwidth settings to be altered in the profile without the need to power down the server to which the profile is applied.  Once the migration process is complete, users can adjust the profile connections’ requested bandwidth settings to suit their needs.

Appendix A: VCtoOneView compatibility check status messages and description

Table 1. VCtoOneView compatibility check errors and description

Status

Message

Description / Actions

Critical

Multi-Enclosure stack identified

Multi-Enclosure VC domains will not be migrated.

Critical

Multi-hop FCoE is enabled on network X

Multi-hop FCoE support is not currently implemented in OneView.  The VC domain cannot be migrated to OneView

Critical

Server productname in device bay X is not supported

An unsupported server was identified in the enclosure.  The VC domain cannot be migrated to OneView

Critical

Server in device bay X has an adapter in location Y that is unsupported

An adapter was identified that is unsupported or will be unmanaged by OneView.

Critical

Interconnects in adjacent bays X  and Y are not identical

Virtual Connect modules in adjacent horizontal bays must match.  The VC domain cannot be migrated to OneView

Critical

IO Module productname in IO bay X is not currently supported

A Virtual Connect module was identified in the enclosure that is not supported by OneView.  The VC domain cannot be migrated to OneView

Critical

Profile X contains iSCSI connections

iSCSI connections on the server profile are not yet supported by OneView.  The VC domain cannot be migrated.

Critical

Profile X contains multi-hop FCoE connections

Multi-hop FCoE support is not yet implemented in OneView.  The VC domain cannot be migrated

Critical

ComponentX firmware is below the minimum requirement for import into OneView.

Firmware for iLO, Onboard Administrator, and Virtual Connect modules must be at a minimum revision to attempt to import the enclosure into OneView.  Refer to the OneView compatibility guide at http://www.hp.com/go/oneview/docs.

Critical

The iLO model type in bay X is not supported

An unsupported iLO model was identified.  This is a redundant check to the supported servers check.

Critical

The iLO model type in bay X is reporting as [Unknown]

An error is causing the OA to be unable to acquire information regarding the iLO.  The VC domain will not be migrated to OneView.

Critical

Profile X has unassigned connections

Unassigned profile connections are not currently supported in OneView.  The VC domain cannot be migrated to OneView.  Remove the connections from the VC profile, or assign temporary networks to the connections.

Critical

Profile X is using mapped VLAN ids on a connection assigned to multiple networks.

HP OneView does not currently support the ability to set custom VLAN ids on a server connection.  Downlink server VLAN ids must match the uplink VLAN ids.   

Critical

Profile X has connections not mapped to physical hardware

A Virtual Connect profile has server connections that exceed the number of physical ports.  This is not supported by the migration script.  Remove the connections and retry the migration.    

Critical

Profile X contains an untagged network on a connections assigned to multiple networks

HP OneView does not currently support adding a tunneled/untagged network to a network set (aka VC profile multiple networks).  Multiple network assignments must only contain tagged networks in order to be migrated.

Warning

Profile X has custom min/max speed settings on Ethernet port Y

OneView profiles currently only allow a requested bandwidth setting.  The migration will utilize the minimum port speed setting of the Virtual Connect profile for the requested bandwidth setting.  The speed settings can be altered in OneView after the migration process is complete.

Warning

ComponentX firmware is below the minimum requirement for OneView Management.

Firmware for iLO, Onboard Administrator, and Virtual Connect modules must be at a minimum revision in order to be managed by OneView.  Components above the minimum level for import, but below the minimum level for management must be updated. Updating the components after being imported may prolong the migration process.  Onboard Administrators and iLOs that are below the minimum level for OneView management will automatically be updated to the minimum level upon enclosure import.  Refer to the OneView compatibility guide at http://www.hp.com/go/oneview/docs.

Warning

Radius/TACACS authentication is enabled

Radius and TACACS authentication is not currently implemented in HP OneView and those settings will not be migrated.

Warning

Network access groups other than the default exist in the domain

Networks access groups (NAGs) are not yet implemented in HP OneView and will not be migrated.

Warning

Profile X is unassigned and will not be migrated to OneView

HP OneView profiles are associated with a server hardware type in order to determine BIOS setting and connection capabilities.  The migration process cannot determine this association on unassigned Virtual Connect profiles or profiles assigned to empty server bays.  Preserve the profile information using the “show config” command of the VCM CLI so that the profile can be manually re-created in OneView if needed.

Warning

Profile X  has boot settings on FC connections set to “USE-BIOS”, manual steps may be required.

HP OneView does not currently have an equivalent “USE-BIOS” setting for FC boot parameters.  The migration process will set those connections to non-bootable.  If the connection is used for fibre channel boot, it must be set to “primary”, or “secondary” in the OneView profile after migration.

Warning

Profile X is assigned to an empty server bay and will not be migrated to OneView

HP OneView profiles are associated with a server hardware type in order to determine BIOS setting and connection capabilities.  The migration process cannot determine this association on unassigned Virtual Connect profiles or profiles assigned to empty server bays.  Preserve the profile information using the “show config” command of the VCM CLI so that the profile can be manually re-created in OneView if needed.

 

Appendix B:  Sample Output Files

Caution

These scripts and object files are for example purposes only, and should not be used to attempt an actual migration.

Sample generated migration script

# 06/06/2014 12:44:05

# Auto-generated OneView configuration script

 

# Connect to OneView - example parameters provided. Alter for the specific environment

Connect-HPOVMgmt 192.168.0.0 UserName Password

 

# Create Ethernet and Fibre Channel networks using JSON input file.

# Since this a bulk import operation, the script will exit with error if one of the network

# creation attempts fail.

$netResp = New-HPOVNetwork -importFile "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Networks.JSON"

 

$ErrorActionPreference = "Inquire"

if($netResp.status -contains "Failed"){

          $netResp = $netResp | ? {$_.status -eq "Failed"} | ? {$_.details.errorCode -notmatch "CRM_DUPLICATE_NETWORK_NAME"}

          # If the resonse still contains errors it due to other problems than duplicate names. Throw error.

          if($netResp){

                     throw "Error creating one or more networks."

                     }

          }

 

# Create Network Sets derived from VC Profiles

# Create USE939SBA4-r1e1_vc_domain-NS1

$untaggedNetUri = (Get-HPOVNetwork -name "VLAN-100").uri

$netUris = @()

$netUris += (Get-HPOVNetwork -name "VLAN-100" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-101" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-102" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-103" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-104" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-105" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-106" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-107" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-108" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-109" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-110" -type Ethernet).uri

# Look for existing Network Sets that are identical to this one.

$networkSets = Get-HPOVNetworkSet

# Check if any net sets exists yet and create this one if not

if(!$networkSets){New-HPOVNetworkSet -name USE939SBA4-r1e1_vc_domain-NS1 -untaggedNetworkUri $untaggedNetUri -networkUris $netUris

          }

else{

          # Network sets already exist on the appliance

          # Compare this net set to existing ones

          $netSetExists = $false

          ForEach($ns in $networkSets){

                     if(!(Compare-Object $ns.networkUris $neturis)){

                               # Found a match - set the variable to true, update profiles file, and break out of the loop

                               $netSetExists = $true

                               (Get-Content F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON) | Foreach-Object {$_ -replace "USE939SBA4-r1e1_vc_domain-NS1",$ns.name } | Set-Content "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON"

                               break

                               }

                     }

          if(!$netSetExists){

                     New-HPOVNetworkSet -name USE939SBA4-r1e1_vc_domain-NS1 -untaggedNetworkUri $untaggedNetUri -networkUris $netUris

                     }

          }

# Create USE939SBA4-r1e1_vc_domain-NS2

$untaggedNetUri = $null

$netUris = @()

$netUris += (Get-HPOVNetwork -name "Prod-Primary" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "Mgmt-Primary" -type Ethernet).uri

# Look for existing Network Sets that are identical to this one.

$networkSets = Get-HPOVNetworkSet

# Check if any net sets exists yet and create this one if not

if(!$networkSets){New-HPOVNetworkSet -name USE939SBA4-r1e1_vc_domain-NS2 -untaggedNetworkUri $untaggedNetUri -networkUris $netUris

          }

else{

          # Network sets already exist on the appliance

          # Compare this net set to existing ones

          $netSetExists = $false

          ForEach($ns in $networkSets){

                     if(!(Compare-Object $ns.networkUris $neturis)){

                               # Found a match - set the variable to true, update profiles file, and break out of the loop

                               $netSetExists = $true

                               (Get-Content F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON) | Foreach-Object {$_ -replace "USE939SBA4-r1e1_vc_domain-NS2",$ns.name } | Set-Content "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON"

                               break

                               }

                     }

          if(!$netSetExists){

                     New-HPOVNetworkSet -name USE939SBA4-r1e1_vc_domain-NS2 -untaggedNetworkUri $untaggedNetUri -networkUris $netUris

                     }

          }

# Create USE939SBA4-r1e1_vc_domain-NS3

$untaggedNetUri = $null

$netUris = @()

$netUris += (Get-HPOVNetwork -name "Mgmt-Redundant" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "Prod-Redundant" -type Ethernet).uri

# Look for existing Network Sets that are identical to this one.

$networkSets = Get-HPOVNetworkSet

# Check if any net sets exists yet and create this one if not

if(!$networkSets){New-HPOVNetworkSet -name USE939SBA4-r1e1_vc_domain-NS3 -untaggedNetworkUri $untaggedNetUri -networkUris $netUris

          }

else{

          # Network sets already exist on the appliance

          # Compare this net set to existing ones

          $netSetExists = $false

          ForEach($ns in $networkSets){

                     if(!(Compare-Object $ns.networkUris $neturis)){

                               # Found a match - set the variable to true, update profiles file, and break out of the loop

                               $netSetExists = $true

                               (Get-Content F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON) | Foreach-Object {$_ -replace "USE939SBA4-r1e1_vc_domain-NS3",$ns.name } | Set-Content "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON"

                               break

                               }

                     }

          if(!$netSetExists){

                     New-HPOVNetworkSet -name USE939SBA4-r1e1_vc_domain-NS3 -untaggedNetworkUri $untaggedNetUri -networkUris $netUris

                     }

          }

# Create USE939SBA4-r1e1_vc_domain-NS4

$untaggedNetUri = $null

$netUris = @()

$netUris += (Get-HPOVNetwork -name "VLAN-2" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-3" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-120" -type Ethernet).uri

$netUris += (Get-HPOVNetwork -name "VLAN-200" -type Ethernet).uri

# Look for existing Network Sets that are identical to this one.

$networkSets = Get-HPOVNetworkSet

# Check if any net sets exists yet and create this one if not

if(!$networkSets){New-HPOVNetworkSet -name USE939SBA4-r1e1_vc_domain-NS4 -untaggedNetworkUri $untaggedNetUri -networkUris $netUris

          }

else{

          # Network sets already exist on the appliance

          # Compare this net set to existing ones

          $netSetExists = $false

          ForEach($ns in $networkSets){

                     if(!(Compare-Object $ns.networkUris $neturis)){

                               # Found a match - set the variable to true, update profiles file, and break out of the loop

                               $netSetExists = $true

                               (Get-Content F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON) | Foreach-Object {$_ -replace "USE939SBA4-r1e1_vc_domain-NS4",$ns.name } | Set-Content "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON"

                               break

                               }

                     }

          if(!$netSetExists){

                     New-HPOVNetworkSet -name USE939SBA4-r1e1_vc_domain-NS4 -untaggedNetworkUri $untaggedNetUri -networkUris $netUris

                     }

          }

 

# Create Logical Interconnect Group (LIG)

# NOTE: SNMP settings are not migrated, and must be applied manually.

# Now create the LIG

New-HPOVLogicalInterconnectGroup -LigName LIG-r1e1_vc_domain-USE939SBA4 -bays @{3 = "VCFC24";2 = "FlexFabric";1 = "FlexFabric";4 = "VCFC24"} -enableIgmpSnooping $false -igmpIdleTimeoutInterval 260 -LoopProtect $true -FastMac $true -FastMACRefresh 5

 

# Create Ethernet UplinkSets

# First read JSON input for Ethernet UplinkSet definition

$ethUs = [string]::Join("", (gc "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-EthUSs.JSON")) | ConvertFrom-Json

ForEach($e in $ethUs){

          New-HPOVUplinkSet -ligName LIG-r1e1_vc_domain-USE939SBA4 -usType $e.usType -usName $e.usName -usNetworks $e.usNetworks -usNativeEthNetwork $e.usNativeEthNetwork -usUplinkPorts $e.usUplinkPorts -usEthMode $e.usEthMode

}

 

# Create FibreChannel UplinkSets

# First read JSON input for Fibre Channel UplinkSet definition

$fcUs = [string]::Join("", (gc "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-fcUSs.JSON")) | ConvertFrom-Json

ForEach($f in $fcUs){

           New-HPOVUplinkSet -ligname LIG-r1e1_vc_domain-USE939SBA4 -usName $f.usName -usType $f.usType -usNetworks $f.usNetworks -usUplinkPorts $f.usUplinkPorts

}

$lUri = (Get-HPOVLogicalInterconnectGroup LIG-r1e1_vc_domain-USE939SBA4).uri

 

#Create the new enclosure group using the logical interconnect group from above.

$encGroup = New-HPOVEnclosureGroup -name EG-r1e1_vc_domain-USE939SBA4 -logicalInterConnectGroup $lUri

 

# Create Server-hardware-types

# First read JSON input for SHT definitions

$shts = [string]::Join("", (gc "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-SHTs.JSON")) | ConvertFrom-Json

ForEach($sht in $shts){

          $shtTemp = $sht | select * -ExcludeProperty uri, bay

          $shtResp = Send-HPOVRequest -method POST -body $shtTemp -uri /rest/server-hardware-types

 

#If POST was successfull, we get a uri. Add that to the base object for profile assignment

          if($shtResp.uri){$sht.uri = $shtResp.uri}

#If not, we get an error. Look for duplicate sht creation error and get uri from message.

           else{

                     if($shtResp.errorCode -eq "SERVER_HARDWARE_TYPE_ALREADY_EXISTS"){

                               $sht.uri = ($shtResp.message.substring($shtResp.message.indexof("/rest/"))).replace(".", "")

                               }

                     #If not a duplcate sht error, something went wrong throw error to terminate script

                     else{

                               throw "Fatal error creating server-hardware-type"

                               }

                     }

          }

 

# Create Profiles

# First read JSON input for profile definitions

$profiles = [string]::Join("", (gc "F:\VCtoOneView-Dev\out-files\r1e1_vc_domain-Profiles.JSON")) | ConvertFrom-Json

ForEach($p in $profiles){

          $pTemp = $p | select * -ExcludeProperty factorySn, enclosureBay

          $pTemp.serverHardwareTypeUri = ($shts | ? {$_.bay -eq $p.enclosureBay}).uri

          ForEach($c in $pTemp.connections){

                     $cnet = ($c.networkUri.split("/"))[3]

                     $cType = ($c.networkUri.split("/"))[2]

                     if($cType -eq "network-sets") {$c.networkUri=(Get-HPOVNetworkSet $cnet).uri}

                     else {$c.networkUri=(Get-HPOVNetwork $cnet).uri}

                     }

          $pTemp.enclosureGroupUri = $encGroup.uri

          $profileResp = New-HPOVProfile -import -ProfileObj $pTemp

          $profileResp | Wait-HPOVTaskComplete    

}

 

#Import the enclosure

#WARNING! Importing the enclosure is destructive to the Virtual Connect domain.

#You will be prompted during execution of this script to confirm the import action.

#You can suppress this prompt by adding "-confirm:$false" to the end of the command.

$encTask = New-HPOVEnclosure -oa 192.168.19.40 -enclGroupName EG-r1e1_vc_domain-USE939SBA4 -user Administrator -pass hpinvent -license OneView

# Wait for the enclosure import to complete prior to attempting profile assignment.

$encTask = $encTask | Wait-HPOVTaskComplete

 

 # Assign profiles to appropriate server hardware

ForEach($p in $profiles){

          $sn = $p.FactorySn

# Get the target server hardware object from the appliance.

          $sHdwr = Get-HPOVServer | ?{$_.serialNumber -eq $sn}

          $shUri = $sHdwr.uri

# Get the power state and power off the server if currently on.

          if($sHdwr.powerState -ne "Off"){

                     $pwrTask = Set-HPOVServerPower $sHdwr Off

                     $pwrTask = $pwrTask | Wait-HPOVTaskComplete

                     # If soft power task fails, attemp force power off

                     if(($pwrTask.taskState -eq "Error") -and ($pwrTask.taskStatus -match "Unable to power off")){

                               $pwrTask = Set-HPOVServerPower $sHdwr -powerState Off -powerControl PressAndHold

                               $pwrTask = $pwrTask | Wait-HPOVTaskComplete

                               }

                     }

# Retrieve the profile object from the appliance.

          $serverProfile = Get-HPOVProfile -name $p.name

          #Update the profile object to assign it to actual hardware

          $serverProfile.serverHardwareUri = $shUri

          $spTask = Send-HPOVRequest -uri $serverProfile.uri -method PUT -body $serverProfile

          $spTask | Wait-HPOVTaskComplete

          Set-HPOVServerPower $sHdwr

}

 

Sample generated JSON resource definition file – Server Profiles

[

    {

        "enclosureGroupUri":  null,

        "boot":  {

                     "order":  [

                                   "CD",

                                   "Floppy",

                                   "USB",

                                   "HardDisk",

                                   "PXE"

                               ],

                     "manageBoot":  true

                 },

        "bios":  {

                     "manageBios":  false

                 },

        "FactorySn":  "3UI12507AS",

        "serverHardwareTypeUri":  null,

        "macType":  "Virtual",

        "name":  "USE943TK2K-Enc2-ESX-Host-Bay1",

        "type":  "ServerProfileV3",

        "serialNumber":  "VCX0000101",

        "connections":  [

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:00",

                                "maximumMbps":  100,

                                "wwpnType":  "Physical",

                                "portId":  "AUTO",

                                "wwpn":  null,

                                "networkUri":  "/rest/ethernet-networks/LAB_NetworkA",

                                "functionType":  "Ethernet",

                                "wwnn":  null,

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  100

                            },

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:02",

                                "maximumMbps":  100,

                                "wwpnType":  "Physical",

                                "portId":  "AUTO",

                                "wwpn":  null,

                                "networkUri":  "/rest/ethernet-networks/LAB_NetworkB",

                                "functionType":  "Ethernet",

                                "wwnn":  null,

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  100

                            },

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:04",

                                "maximumMbps":  100,

                                "wwpnType":  "Physical",

                                "portId":  "AUTO",

                                "wwpn":  null,

                                "networkUri":  "/rest/ethernet-networks/NR_VM_A",

                                "functionType":  "Ethernet",

                                "wwnn":  null,

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  100

                            },

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:06",

                                "maximumMbps":  100,

                                "wwpnType":  "Physical",

                                "portId":  "AUTO",

                                "wwpn":  null,

                                "networkUri":  "/rest/ethernet-networks/NR_VM_B",

                                "functionType":  "Ethernet",

                                "wwnn":  null,

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  100

                            }

                        ],

        "uuid":  "1be4e7ae-78ab-4112-a3fd-cc624a49dca6",

        "enclosureBay":  1,

        "serialNumberType":  "UserDefined",

        "wwnType":  "Physical",

        "firmware":  {

                         "manageFirmware":  false

                     }

    },

    {

        "enclosureGroupUri":  null,

        "boot":  {

                     "order":  [

                                   "CD",

                                   "Floppy",

                                   "USB",

                                   "HardDisk",

                                   "PXE"

                               ],

                     "manageBoot":  true

                 },

        "bios":  {

                     "manageBios":  false

                 },

        "FactorySn":  "2M4124469H",

        "serverHardwareTypeUri":  null,

        "macType":  "Virtual",

        "name":  "USE943TK2K-Enc2-ESX-Host-Bay3",

        "type":  "ServerProfileV3",

        "serialNumber":  "VCX0000102",

        "connections":  [

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:08",

                                "maximumMbps":  100,

                                "wwpnType":  "Physical",

                                "portId":  "AUTO",

                                "wwpn":  null,

                                "networkUri":  "/rest/network-sets/USE939SBA4-r1e1_vc_domain-NS2",

                                "functionType":  "Ethernet",

                                "wwnn":  null,

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  100

                            },

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:0A",

                                "maximumMbps":  100,

                                "wwpnType":  "Physical",

                                "portId":  "AUTO",

                                "wwpn":  null,

                                "networkUri":  "/rest/network-sets/USE939SBA4-r1e1_vc_domain-NS3",

                                "functionType":  "Ethernet",

                                "wwnn":  null,

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  100

                            },

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:0C",

                                "maximumMbps":  100,

                                "wwpnType":  "Physical",

                                "portId":  "AUTO",

                                "wwpn":  null,

                                "networkUri":  "/rest/network-sets/USE939SBA4-r1e1_vc_domain-NS4",

                                "functionType":  "Ethernet",

                                "wwnn":  null,

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  100

                            },

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:0E",

                                "maximumMbps":  100,

                                "wwpnType":  "Physical",

                                "portId":  "AUTO",

                                "wwpn":  null,

                                "networkUri":  "/rest/network-sets/USE939SBA4-r1e1_vc_domain-NS4",

                                "functionType":  "Ethernet",

                                "wwnn":  null,

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  100

                            },

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:10",

                                "maximumMbps":  4000,

                                "wwpnType":  "UserDefined",

                                "portId":  "AUTO",

                                "wwpn":  "50:06:0B:00:00:C2:66:00",

                                "networkUri":  "/rest/fc-networks/EN1-SANA",

                                "functionType":  "FibreChannel",

                                "wwnn":  "50:06:0B:00:00:C2:66:01",

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  4000

                            },

                            {

                                "macType":  "UserDefined",

                                "mac":  "00:17:A4:77:04:11",

                                "maximumMbps":  4000,

                                "wwpnType":  "UserDefined",

                                "portId":  "AUTO",

                                "wwpn":  "50:06:0B:00:00:C2:66:02",

                                "networkUri":  "/rest/fc-networks/EN1-SANB",

                                "functionType":  "FibreChannel",

                                "wwnn":  "50:06:0B:00:00:C2:66:03",

                                "boot":  {

                                             "targets":  [

 

                                                         ],

                                             "priority":  "NotBootable"

                                         },

                                "requestedMbps":  4000

                            }

                        ],

        "uuid":  "b9fd66f3-327a-46e0-a400-dec91be6eb2c",

        "enclosureBay":  3,

        "serialNumberType":  "UserDefined",

        "wwnType":  "Physical",

        "firmware":  {

                         "manageFirmware":  false

                     }

    }

]

 

 

Last edited Sep 11, 2014 at 9:51 PM by ChrisLynchHP, version 10