Hp OneView User Manual

HP OneView 1.05 User GuideAbstractThis guide describes HP OneView features, interfaces, resource model design, and secure working environment. It desc

26.3.3 Activity states...19226.3.4 Activity statuses..

10.1 ProcessWhen you add a network to the appliance, you might need to make configuration changes to thefollowing resources:DescriptionTaskResource• A

DescriptionTaskResourceServerProfiles andServerHardware• When you add a network to an appliance, it is immediately available.However, for a server bla

102

11 Quick Start: Adding an enclosure and connecting itsserver blades to networksThis quick start describes the process to add an enclosure to an existi

Why you need itConfiguration requirementYou do not have to know the hardware configuration, but you do have tochoose an available network or network s

ProcessDescriptionTaskResource• When you add the enclosure, specify an existing enclosure group.• When you add an enclosure, you also must select a fi

ProcessDescriptionTaskResource• You must create a logical interconnect group before you can create anenclosure group.• You add uplink sets as part of

• The networks and network sets, if any, have been added to the appliance. To add networksor network sets, see “Quick Start: Adding a network to an ex

108

12 Quick Start: Configuring an enclosure and server bladefor Direct attach to an HP 3PAR Storage SystemThis quick start describes the process for addi

29.6.3 HP SUM errors...23029.7 Troubleshooting interconn

12.1 ProcessDescriptionTaskResource• If you add the networks from the Networks screen:◦ For Type, select Fibre Channel◦ For Fabric type, select Direct

13 Quick Start: Adding an HP ProLiant DL rack mount serverThis quick start describes the process for adding a rack mount server.The features supported

112

14 Quick Start: Adding an active/active networkconfigurationThis quick start describes the process to add an active/active configuration for an enclos

14.1 ProcessFor each VC interconnect module you want to set up as an active/active configuration in theappliance, make configuration changes to the fo

DescriptionTaskResource4. Edit the server profile to add twoconnections: assign one port for thenetworks or network sets on one moduleand a different

116

15 Quick Start: Migrating from an active/standby to anactive/active network configurationThis quick start describes the process of migrating from an e

DescriptionTaskResource• Adding a network to a network set does not require that youtake resources offline. Server profiles that have connectionsto th

Part IV Configuration and managementThe chapters in this part describe the configuration and management tasks for the appliance and the resourcesit ma

A Step by step: Configuring an example data center using HP OneView...251A.1 Tasks you can perform without data center hardware...

120

16 Managing server hardware and server profilesManaging servers with the appliance involves interacting with several different resources on theapplian

16.1.1 Roles• Minimum required privileges: Infrastructure administrator or Server administrator16.1.2 Tasks for server hardwareThe appliance online he

16.1.4 Prerequisites for bringing server hardware under managementServer hardware must meet the following prerequisites for the appliance to manage it

16.1.5.1 How the appliance handles unsupported hardwareUnsupported hardware is any device that the appliance cannot manage. Unsupported devices aresim

16.1.6 Tasks for server hardware typesThe appliance online help provides information about using the UI or the REST APIs to:• Edit the name or descrip

16.2.1 Roles• Minimum required privileges: Infrastructure administrator or Server administrator16.2.2 Tasks for server profilesThe appliance online he

unapplied sections are reapplied. For example, if a firmware update succeeds but the subsequentBIOS portion of the apply operation fails, the firmware

128

17 Managing licensesYou manage licenses from the Settings screen or by using the REST APIs.17.1 UI screens and REST API resourcesREST API resourceUI s

Part I Learning about HP OneViewThis part describes HP OneView and its model for data center resources and introduces you to the termsand concepts use

When you add an enclosure or rack mount server to the appliance, you must specify one of theselicenses. After a 60-day trial period, the appliance dis

Figure 11 Sample license graphs100%100 Licenses available1000 Servers licensedHP OneViewCompliance21314 Licenses required0 Licenses available0 Servers

When you add an enclosure to the appliance, you must choose a server hardware license policy.This sets the licensing policy for all server hardware in

• If the server hardware has an existing permanent iLO Advanced license, the appliance assignsan HP OneView w/o iLO license, regardless of the license

Table 8 Licensing scenarios (continued)NotesResultLicense policy or typeUser actionAfter the 60-day trial period,a message notifies you whenthere are

18 Managing networks and network resourcesThis chapter describes configuring and managing networks and network resources for the enclosuresand server

Instead of assigning a single network to a connection in a server profile, you can assign a networkset to that connection.•• You can create a network

18.3.1 Fibre Channel network typesThe Virtual Connect interconnect modules in enclosures support two types of Fibre Channelconnections to storage devi

Servers connecting to a Direct attach Fibre Channel network have access to all devices connectedon the uplink ports defined for that network. If there

When defined on this appliance, Ethernet networks connected to enclosure interconnects requirea VLAN ID.• You can add multiple Ethernet networks that

14

2 of Enclosure 1, then the data center switch ports that connect to those X2 ports must beconfigured to support VLAN IDs 1101, 1102, 1103, and 1104.•

19 Managing interconnects, logical interconnects, andlogical interconnect groupsA logical interconnect group acts as a recipe for creating a logical i

Connectivity and synchronization with the applianceThe appliance monitors the health status of interconnects and issues alerts when there is a changei

• Configure a port to monitor network traffic.• Change Ethernet settings such as:Fast MAC cache failover◦◦ MAC refresh interval◦ IGMP (Internet Group

For Ethernet networks, an uplink set enables you to identify interconnect uplinks that carry multiplenetworks over the same cable. For Fibre Channel c

Redundantly Connected There are at least two independent paths between any pair ofinterconnects in the logical interconnect, and there are at leasttwo

logical interconnect group. If you change the uplink sets for an existing logical interconnect group,only enclosures that you add after the configurat

19.2.5 About active/active and active/standby configurationsWhen choosing which HP Virtual Connect network configuration to use (active/active oractiv

19.2.5.2.1 Requirements and best practices for an active/active configurationTo have a functioning active/active configuration in HP OneView, you must

19.2.5.2.2 Sample active/active configurationToR SwitchPhysical server 1NIC TEAMPort 1 Port 2IO Bay 1Network vNet 101A-Internal VLAN 3-External VLAN 1

1 Learning about HP OneView1.1 HP OneView for converged infrastructure managementOptimized for collaboration, productivity, and reliability, the HP On

interconnect and logical interconnect group, comparing the two, and checking the following forconsistency:Compliance checkingItemsAre there difference

19.2.9 Learning more• “Logical interconnect groups” (page 36)• “Logical interconnects” (page 37)• “Uplink sets” (page 38)19.2 Managing logical interco

152

20 Managing enclosures and enclosure groupsAn enclosure is a physical structure that can contain server blades, infrastructure hardware, andinterconne

20.2 Roles• Minimum required privileges: Infrastructure administrator or Server administrator20.3 Tasks for enclosuresThe appliance online help provid

NOTE: HP does not recommend using iLO or the OA to make changes to a device. Makingchanges to a device from its iLO or OA could cause it to become out

• The OA firmware is updated to minimum firmware levels, listed in the HP OneView SupportMatrix.• The server hardware iLO time zone is set to Atlantic

21 Managing firmware for managed devicesNOTE: This chapter describes how to manage the firmware for devices managed by the appliance.For information a

Unsupported firmware for enclosuresWhen adding an enclosure, the appliance:• Generates an alert if the logical interconnect firmware for the interconn

resources in the enclosure (OA, all member interconnects, and server hardware firmwareincluding iLO).In the UI, select Enclosures→Actions→Update firmw

and server profiles established by your experts, you can enable system administrators to provisionand manage thousands of servers without requiring th

DescriptionBest practiceDo not update the firmware on a managed device unless the firmware baseline isset to manage manually.Verify the managed device

22 Managing power and temperatureYou can use the appliance to manage the power and temperature of your IT hardware.22.1 Managing powerTo manage power,

The Power Delivery Devices screen describes the following classes of devices:• HP Intelligent Power Distribution Units (HP iPDUs), which the appliance

data center as a whole. The appliance enables you to bring power and cooling management ofyour servers, enclosures, and power delivery devices togethe

rack PDUs that provide power to the rack, and their physical position in the rack or on either side.You can also describe how the devices in the rack

23 Managing users and authenticationThe appliance requires users to log in with a valid user name and password, and security ismaintained through user

23.4 About user rolesUser roles enable you to assign permissions and privileges to users based on their jobresponsibilities. You can assign full privi

Table 11 Action privileges for user roles (continued)Action privileges for user roles(C=Create, R=Read, U=Update, D=Delete, Use)CategoryRead onlyBacku

Table 11 Action privileges for user roles (continued)Action privileges for user roles(C=Create, R=Read, U=Update, D=Delete, Use)CategoryRead onlyBacku

When you add an authentication directory service to the appliance, you provide search criteriaso that the appliance can find the group by its DN (Dist

• Streamlined process for bringing hardware under management (page 19)• Operating system deployment (page 19)1.2.1 Server profilesA server profile cap

The authorized support representative uses the challenge code to generate a short-lived,one-time password based on the challenge key. It will be an ea

24 Backing up an applianceThis chapter describes how to use the UI, REST APIs, or a custom-written PowerShell script to saveyour appliance resource co

REST APIs let you to:• Schedule a backup process from outside the appliance.• Collect backup files according to your site policies.• Integrate with en

the backup script to run automatically in interactive or batch mode on a regular basis. Only a userwith Backup administrator or Infrastructure adminis

24.7 Creating a custom script to create and download an appliancebackup fileIf you prefer to write a customized script to create and download your app

25 Managing the appliance25.1 Updating the applianceThe appliance runs a combination of software and firmware. Keeping the appliance up to datefixes p

25.1.2 Roles• Minimum required privileges: Infrastructure administrator25.1.3 TasksUpdating the appliance requires a single user accessing the applian

25.2.2 Shut down the applianceUse this procedure to perform a graceful shutdown of the appliance.Prerequisites• Minimum required privileges: Infrastru

What to do when an appliance restartsThe online help provides information about using the user interface or the REST APIs to:• Check for critical aler

Install SNMP OS host agents for HP ProLiant G7 blade serversFor the appliance to monitor the health of HP ProLiant G7 blade servers, you need to confi

Types of groups and setsDescriptionGroup or setA group of enclosures that use the same configuration, such network connectivity and firmwareversions f

25.6 Enabling or disabling HP support access to the applianceThis product contains a technical feature that will allow an on-site authorized support r

25.8 Managing the HP public keyThe HP public key verifies that:• HP created its software packages (RPMs) and updates.• The code was not modified after

182

Part V MonitoringThe chapters in this part describe using the appliance to monitor your data center. You use the informationin this part after the app

184

26 Monitoring data center status, health, and performanceThis chapter describes the recommended best practices for monitoring data center status, heal

26.1.4 Monitor data center temperatureThe appliance provides detailed monitoring data that you can use to determine the power andcooling capabilities

Server hardware health monitoringFor server hardware with a Critical or Warning status, the associated server profile might bein failed state, so you

Monitoring stepView the originating event(s) that caused a specific alert.1. Select an alert.GET /rest/alerts/2. Get a specific alert using the alert

perform a GET operation on alerts and filter for alerts related to interconnects. To list states, youcan perform a GET operation on interconnects and

Flexibility in design and deploymentHP OneView provides flexibility in the creation of groups, templates, and sets. For example, youcan create a logic

Activity screen componentsThe image shown here illustrates the important areas on the screen that you can use to monitor,resolve, and manage activity.

While alerts have an active or locked state, they contribute to a resource’s overall displayed status.After you change their state to Cleared, they no

26.3.3 Activity statesDescriptionStateActivityThe alert has not been cleared or resolved.A resource’s active alerts are considered in the resource’s o

26.4 Using the Dashboard screen26.4.1 About the DashboardThe Dashboard provides a graphical representation of the general health and status of several

Table 12 Dashboard graph colors (continued)IndicationColorThe remainder of resource instances that do not match the data being measured (used incombin

The sample graph for the Server Hardware resource shows a total of ten instances of managedserver hardware, of which half are either disabled or are u

196

27 Monitoring power and temperatureHP OneView enables you to monitor the power and temperature of your hardware environment.Power and temperature moni

Prerequisites• Minimum required privileges: Server administrator.• You have created a data center and positioned your racks in it.• The placement of r

• Move the horizontal slider left to zoom in and right to zoom out.• Move the vertical slider up and down to change the vertical viewing angle.• Click

© Copyright 2013-2014 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP required for possession, use or c

1.3 Firmware and configuration change management features1.3.1 Simplified firmware managementThe appliance provides fast, reliable, and simple firmwar

Table 13 Utilization statistics gathered by resourceUtilization metricCustomTemperaturePowerCPUResource✓✓✓Enclosures✓Power DeliveryDevices✓✓✓✓ServerHa

with the most recent intervaldata on the right. Thedifferent units ofmeasurement have a secondminimum time interval is two interval down the right sid

27.2 REST API power and temperature monitoring27.2.1 Update enclosure power capacity settingsTo update the enclosure capacity settings, perform a PUT

28 Using the State-Change Message Bus (SCMB)The State-Change Message Bus (SCMB) is an interface that uses asynchronous messaging to notifysubscribers

Figure 16 Connecting the client to the SCMB5The appliance can revoke theSCMB client certificate to3The appliance issues a clientcertificate to the SCM

NOTE: The task resources routing key syntax is scmb.resource-category and does not usechange-type and resource-uri. To receive messages about all task

ChangeType valuesDescriptionChangeType valueThe resource is created or is added to HP OneView.CreatedThe resource state, attributes, or both are updat

Additional example-specific prerequisitesExample 1Convert the client certificate and private key to PKCS format for .Net.openssl.exe pkcs12 -passout p

ExamplesExample 3 .Net C# code example 1 (directly referencing client certificate) public void Connect() { string exchangeName = &q

NOTE: .Net C# code example 2 (Microsoft Windows certificate store) is referencing the TrustedRoot Certificate Authorities store, located under Local C

Isolated management networkThe appliance architecture is designed to separate the management traffic from the productionnetwork, which increases relia

Example 5 Java code example//c://MyKeyStore contains client certificate and private key. Load it into Java Keystorefinal char[] keyPassphrase = "

Example 6 Python code example (pika)import pika, sslfrom pika.credentials import ExternalCredentialsimport jsonimport logginglogging.basicConfig()####

Example 7 Python code example (amqplib)#!/usr/bin/env pythonfrom optparse import OptionParserfrom functools import partialimport amqpdef callback(chan

ch.close() conn.close()if __name__ == '__main__': main()28.7 Re-create the AMQP client certificateIf you change the appliance name

214

Part VI TroubleshootingThe chapters in this part include information you can use when troubleshooting issues in your data center,and information about

216

29 TroubleshootingHP OneView has a variety of troubleshooting tools you can use to resolve issues. By following acombined approach of examining screen

29.1 Basic troubleshooting techniquesHP OneView has a variety of troubleshooting tools you can use to resolve issues. By following acombined approach

29.2 Create a support dump fileSome error messages recommend that you create a support dump of the appliance and send it toan authorized support repre

1.4.1 Data center environmental managementHP OneView integrates these critical areas for environmental management of the data center:• Thermal data vi

29.3 Create a support dump for authorized technical support using RESTAPI scriptingSome error messages recommend that you create a support dump of the

29.4 Troubleshooting the appliance29.4.1 First-time setupPossible causes and recommendationsSymptomsAppliance network settings are not properly config

29.4.4 Appliance update is unsuccessfulAny blocking or warning conditions affecting the appliance update are displayed prior to theupdate operation.Po

29.4.7 Backup file creation or download action failsPossible cause and recommendationSymptomOther related operations are in progressOnly one backup fi

Possible cause and recommendationSymptomA profile operation was running during the backupMinimum required privileges: Infrastructure administrator1. I

29.4.9 Restart or shutdown failurePossible cause and recommendationSymptomInternal server errorMinimum required privileges: Infrastructure administrat

29.4.10 VM does not restart when VM host time is manually setPossible cause and recommendationSymptomYou are not using NTP and the VM host’s time was

29.5 Troubleshooting enclosures and enclosures groups29.5.1 Add or remove enclosure is unsuccessfulPossible cause and recommendationSymptomIf the encl

Possible cause and recommendationSymptomYou might be unable to remove an enclosure for the following reasons:• Lack of communication with the hardware

29.5.2 Add server blade is unsuccessfulPossible cause and recommendationSymptomIf a server blade previously associated with this profile is re-inserte

• View alerts for a specific resource from the UI screen for that resource or using the REST APIfor that resource.• Automatically forward SNMP traps f

29.6.2 Lost iLO connectivityPossible cause and recommendationSymptomReset the server to restore network connectivity to the server's management p

NOTE: You need your entitlement certificate (physical or electronic document) to restore thelicense key.Possible cause and recommendationSymptomThe li

29.9.3 Physical interconnect warnings and errorsPossible cause and recommendationSymptomInterconnect warnings or errors due to:• Downlink with a deplo

embedded in the message; the add action rediscovers all components and updates its knowledgeof the server.Possible cause and recommendationSymptomServ

resource state accordingly, and updating the health status. The appliance creates a task queue foreach task during a resynchronization operation.Possi

( ). The profile remains on the appliance, but you must to correct it. When you correct the serverprofile, the profile status changes to OK ( ).Possib

Possible cause and recommendationSymptomThe server hardware or its iLO are powered-off or reset• In most cases, retrying the operation resolves the pr

29.12.3 Profile operations failPossible cause and recommendationSymptomThe enclosure is no longer managed by the applianceTo prevent losing all alloca

29.13.3 User public key is not acceptedPossible cause and recommendationSymptomHidden characters introduced during a copy/paste operation change the k

29.13.6 Cannot add server for a directory servicePossible cause and recommendationSymptomLost connection with directory service host1. Verify that the

1.6 Security featuresCATA (Comprehensive Applications Threat Analysis) is a powerful HP security quality assessmenttool designed to substantially redu

240

30 Restoring an appliance from a backup fileThis chapter describes how to use the UI, REST APIs, or a custom-written PowerShell script to restorea cor

case, the backup file must have been created from an appliance running the same version of HPOneView.DescriptionActions during the restoreoperationDur

30.3 Best practices for restoring an applianceDescriptionBest Practice1. Note the passwords you use.Maintain a list of the current user accounts on th

IMPORTANT: If you are using a backup file created on another appliance to restore a new orreplacement appliance:1. Install HP OneView on the new or re

30.5 Using REST APIs to restore an appliance from a backup filePrerequisites• Minimum required session ID privileges: Infrastructure administrator• Yo

246

31 Support and other resourcesThe information provided here describes how to contact HP, obtain software updates, submitfeedback on documentation, and

See http://www.hp.com/go/insightlicense for more information.31.4.2 Using your software technical support and update serviceOnce registered, you recei

31.6 Submit documentation feedbackHP is committed to providing documentation that meets your needs. To help us improve ourdocumentation, send errors,

1.8 Graphical and programmatic interfacesThe HP OneView appliance was developed to use a single, consistent resource model embodiedin a fast, modern,

250

A Step by step: Configuring an example data center usingHP OneViewThis appendix contains an illustrated example of using the HP OneView appliance UI t

• Two HP BladeSystem c7000 Enclosures, each of which contain HP Virtual Connect FlexFabricmodules and several different models of HP BladeServer serve

Enclosure 2DescriptionAttributeEnclosure-1904Name172.18.1.13Primary Onboard Administrator IPaddress172.18.1.14Secondary Onboard Administrator IPaddres

Table 14 SAN A and SAN B Fibre Channel network configurationsNotesValueConfiguration attributeFibre ChannelTypeChoose Fabric attach for Fibre Channel

Figure 17 Sample data center: Fibre Channel network connectionsEnclosureUIDEnclosureInterlinkPS3PS2PS1PS6PS5PS4OA1 OA2Removemanagement modules beforee

Table 18 Development networksVLAN IDName1105dev 11051106dev 11061107dev 11071108dev 1108Table 19 Test networksVLAN IDName1111test 11111112test 1112111

ValueConfiguration attribute172.18.0.0Gateway address172.18.0.0Preferred DNS server172.18.0.1Alternate DNS serverUnassigned (do not use IPv6 addresses

A.3.4 Planning resource namesSearching and filtering in the appliance is based on a smart search model. By embeddinginformation about the resource in

6. “Create an unassigned server profile for use as a template for ESXi servers” (page 270).This server profile includes a firmware baseline, the BIOS

1.9 Integration with other HP management softwareOnboard AdministratorHP OneView interacts seamlessly with the Onboard Administrator to provide comple

After the networks are added, when you select a network in the master pane, you can see detailsabout that network in the details pane. For each of the

k. Click Create + to create another network.The appliance creates the network and opens the Create network dialog box. This dialogbox uses the configu

The following illustration shows the Networks screen after you add the Ethernet networks.A.5.3.3 Configuring the network setsYou use network sets to c

The Create network set dialog box shows the networks that you added to the networkset.d. Select a network in the network set to receive untagged traff

b. In the search box, enter dev to filter the list of networks.c. Select all of the dev networks listed and click Add.d. Select Untagged for the first

3. In the top left box, click Add interconnect and select HP Virtual Connect FlexFabric 10Gb/24-PortModule.4. In the top right box, click Add intercon

5. Add the uplink set for the SAN B:a. For Name, enter SAN B.b. For Type, select Fibre Channel.c. For Network, select SAN B.d. Configure the uplink po

e. Add the ESXi networks:i. In the search box, enter esx to display only the ESXi networks.ii. Select all of the EXSi networks listed.TIP: Select all

4. Click Create to create the logical interconnect group.5. In the details pane of the Logical Interconnect Groups screen, you can use your pointing d

3. For Logical interconnect group, select EsxFlexFabricLIG.4. Click Create.A.5.6 Adding the enclosureAdding an enclosure brings the rack, the enclosur

When you add hardware with an embedded license to the appliance, the applianceautomatically applies the license. Your software license is also automat

Viewing server hardware typesFrom the main menu, select Server Hardware Types.The Server Hardware Types screen lists server hardware types for each un

1. From the main menu, select Server Profiles and then click + Create profile.The Create Server Profile dialog box opens.2. Under General, enter the f

a. Add two connections to the esxi mgmt 1131 network. When you finish entering theinformation for a connection, click Add + to add this connection and

e. Add one connection to the SAN A network. Enter the information shown in the followingtable, and then click Add + to add the connection and reopen t

4. Scroll down to see other items in the dialog box.5. Configure the boot order for this server profile. Manage boot order is selected by default.Drag

d. Click OK to save the edits and close the dialog box.The Create Server Profile dialog box displays the BIOS settings whose values differ fromthe def

4. (Optional) View the progress of the create profile action from the Server Profiles screen.Optionally, launch the iLO remote console to view the pro

8. In Name, enter FlatSAN B and click Create.The Networks screen opens.After the networks are added, when you select a network in the master pane, you

3. Click Add to add the enclosure.The appliance discovers the interconnects in the enclosure, creates a logical interconnectgroup, and opens the Edit

c. For Network, select FlatSAN B.d. Configure the uplink ports. For Interconnect under Uplink Ports, select Interconnect: 2and then select ports X3 an

Network setsYou can define a collection of Ethernet data center networks to be identified by a single name,called a network set. You can specify a net

7. Click OK and add enclosure.The appliance adds the enclosure, the enclosure group, the logical interconnect group, andthe uplink sets:Encl2Enclosure

• For Server hardware type, select BL460c Gen8 Standard.• For Enclosure Group, select DirectAttachGroup.• For Firmware Baseline, select Manage manuall

6. Add one connection to the FlatSAN B network. Enter the information shown in the followingtable, and then click Add to add the connection and close

b. Click Edit BIOS Settings.The Edit BIOS Settings dialog box opens. The server hardware type that you selected forthis profile determines the default

1. In the master pane of the Server Profiles screen, select win2k12 boot from 3PAR.The appliance displays the details about the server profile in the

A.7.2 Adding the server hardware1. From the main menu, select Server Hardware, and then click + Add server hardware.2. Enter the following information

NOTE: To view utilization data or connect to the remote console, the server must have theappropriate licenses. See “Adding a license for the server” (

In this example, the server is related to Rack-173 and the DL360p Gen 8 1 server hardwaretype.5. Click Rack-173 to display the Map view for the rack.6

To add an HP OneView license for the server you added in “Adding the server hardware”(page 285):1. Do one of the following:• From the warning message

B Using the virtual appliance consoleB.1 Using the virtual appliance consoleThe virtual appliance console has a restricted browser interface that supp

2 Understanding the resource modelThe HP OneView appliance uses a resource model that reduces complexity and simplifies themanagement of your data cen

290

C Backup and restore script examplesC.1 Sample backup scriptAs an alternative to using Settings→Actions→Create backup from the appliance UI, you can w

Example 8 Sample backup.ps1 script# (C) Copyright 2013 Hewlett-Packard Development Company, L.P.######################################################

} catch [System.Exception] { Write-Host $_.Exception.message if ($_.Exception.getType() -eq [System.IO.IOException]) # f

##### getApiVersion: Get X_API_Version #####function getApiVersion ([int32] $currentApiVersion,[string]$hostname){ <# .DESCRIPTION

# create the request body as a hash table, then convert it to json format $body = @{ userName = $username; password = $password } | convertTo-json

function waitFor-completion ([object]$taskResource,[string]$authValue,[string]$hostname){ <# .DESCRIPTION Checks the status of t

if ($global:interactiveMode -eq 1) { Write-Host "`n" Write-Host "Backup stopped abnormally" Write-Host $erro

Write-EventLog -EventId 100 -LogName Application -Source backup.ps1 -Message $error[0].Exception.Message } }}##### Function to download the

Write-Host "Backup download complete!" } } catch [System.Management.Automation.CommandNotFoundException] { return download-Ba

ContentsI Learning about HP OneView...131 Learning about HP OneView...

The UI and REST APIs are organized by resource. The documentation for the UI and REST APIs arealso organized by resource.To view the complete list of

if (($errorObject.message.length -gt 0) -and ($errorObject.recommendedActions.length -gt 0)) { $errorMessage = $errorObject

#Use exception message } if ($isSilent) { throw $errorMessage } elseif ($global:interactiveMode -eq 1) { Write-Host $

Write-Host "Could not initialize backup" } Write-EventLog -EventId 100 -LogName Application -Source backup.ps1 -Message "Could no

4. Calls start-restore() to start the restore.5. Calls restore-status() to periodically check the restore status until the restore completes.If you pa

Example 9 Sample restore.ps1 script#(C) Copyright 2013 Hewlett-Packard Development Company, L.P.######################################################

Write-Host "Enter user name" $secUsername = Read-Host -AsSecureString $username =[Runtime.InteropServices.Marshal]::PtrToStringAuto([Run

The correct password associated with username .PARAMETER hostname The appliance address to send the request to (in https

{ return } $uploadResponse = $rawUploadResponse | convertFrom-Json if ($uploadResponse.status -eq "SUCCEEDED"

$rs.write($contentDisp,0,$contentDisp.Length); [byte[]]$contentType = [System.Text.Encoding]::UTF8.GetBytes($conType + "`r`n`r`n");

$rawRestoreResponse = setup-request -uri $fullRestoreUri -method "POST" -accept "application/json" -contentType "applicat

Relationship to other resourcesA connection template resource is associated with zero or more connection resources. A connectionresource is associated

} if ($statusResponse.status -eq "FAILED") { Write-Host "`r`nRestore failed! System should now undergo a reset to factor

if ($authValue -ne "0") { $request.Headers.Item("auth") = $authValue } $request.Headers.Add("X-API-Version:

$loginVals = query-user if ($loginVals -eq $null) { Write-Host "Error passing user login vals from function query-host, closing program.&q

IndexAAccessing help sidebar, 63Actions menu, 59activeuplink, 147active active see active/activeactive-active see active/activeactive-standby see acti

details pane, 59directory servertroubleshooting, 239directory serviceconfiguring, 165troubleshooting, 238discovery, hardware, 19documentationdownload

SCMB, 26server profile, overview, 17sets, overview, 17SNMP trap configuration, 21user interface, 25Iicon description, 62iconsinformational, 63severity

Pin icon, 63planning considerationsdata center, 85data center resources, 85security, 85PowerShell library, 76ProLiant server hardware, 248public keytr

tagging, network see VLAN IDtask, 22, 190, 191see also activityappliance, 191background, 191completed, 192interrupted, 192number initiated during curr

Relationship to other resourcesA server hardware type resource is associated with the following resources in the resource summarydiagram (page 29):• Z

UI screens and REST API resourcesNotesREST API resourceUI screenYou use the server hardware resource,not the server profile resource, toperform action

UI screens and REST API resourcesNotesREST API resourceUI screenThe UI does not refer to enclosure type,but the enclosure type is used by theappliance

Relationship to other resourcesAn interconnect type resource is associated with the following resources in the resource summarydiagram (page 29):• Zer

Relationship to other resourcesAn interconnect resource is associated with the following resources in the resource summarydiagram (page 29):• Exactly

Relationship to other resourcesA logical interconnect group resource is associated with the following resources in the resourcesummary diagram (page 2

The Server administrator is not required to know the details about interconnectconfigurationsBecause a logical interconnect is managed as a single ent

The uplink sets defined by a logical interconnect group specify the configuration for uplink setsused by logical interconnects that are members of the

2.19.4 Unmanaged devices...423 Understanding the security fea

Relationship to other resourcesA network set resource is associated with the following resources in the resource summarydiagram (page 29):• Zero or mo

UI screens and REST API resourcesREST API resourceUI screenSeveral REST API resources are related to the appliance and appliance settings. See thereso

Relationship to other resourcesA rack resource is associated with the following resources in the resource summarydiagram (page 29):• Zero or one data

All devices connected to an HP Intelligent Power Distribution Unit (iPDU) using an HP IntelligentPower Discovery (IPD) connection are added to the app

44

3 Understanding the security features of the applianceMost security policies and practices used in a traditional environment are applicable in a virtu

• Operating-system-level users are not allowed to access the appliance, with the followingexceptions:◦ A special pwreset command used only if the Infr

◦ Maintain a zone of trust, for example, a DMZ (demilitarized zone) that is separate fromproduction machines.◦ Ensure proper access controls on Fibre

3.5 Controlling access for authorized usersAccess to the appliance is controlled by roles, which describe what an authenticated user ispermitted to do

You must have Infrastructure administrator privileges to download the audit log.Monitor the audit logs because they are rolled over periodically to pr

5 Using the REST APIs and other programmatic interfaces...715.1 Resource operations...

Example 1 Sample audit entries: user login and logout2013-09-16 14:55:20.706 CST,Authentication,,,administrator,jrWI9ych,,,SUCCESS,LOGIN,INFO,CREDENTI

3.10.2 Self-signed certificateThe default certificate generated by the appliance is self-signed; it is not issued by a trusted certificateauthority.By

3.10.3 Using a certificate authorityUse a trusted CA (certificate authority) to simplify certificate trust management; the CA issuescertificates that

3.12.2 SSL connectionThe client should specify HTTPS as the protocol to ensure SSL is used on the network to protectsensitive data. If the client spec

3. Press and release the space bar.4. Press and release F1 to select the non-graphical console or F2 to select the graphical console.3.14.1 Enabling o

Table 2 Supported SSL cipher suites (continued)MacEncAuKxSSL versionSSL cipher suiteSHA13DES (168)RSARSASSL v3DES-CBC3-SHASHA1AES (128)RSADHSSL v3DHE-

56

4 Navigating the graphical user interface4.1 BrowsersFor general information about browser use, see the following topics:• “Supported browsers” (page

4.1.3 Set the browser for US or metric units of measurementTo configure how units of measurement are displayed—either in United States (US) or metricu

Figure 2 Screen topographyHP OneViewOverviewCreateCreateGeneralActivityTypeVLAN IDPurposeEthernetc1 net2015GeneralPreferred bandwidth 2.5Gb/sMaximum b

10 Quick Start: Adding a network to an existing appliance environment...9910.1 Process...

4.3 About the Activity sidebarThe Activity sidebar shows tasks initiated during the current session. The most recent task is displayedfirst.Task notif

Table 4 UI buttonsDescriptionButtonAdds items from your current data center environment (such as enclosures, server hardware,and other physical items)

Figure 6 Help sidebarHelpDocumentationHelp on this pageBrowse REST API helpFirst time setupBrowse helpLicenseEnd-User License agreementCommunityHP One

TaskActivityResourceSmall iconLarge iconSuccessInformationalOKCanceledDisabledUnknownAn In progress rotating icon indicates that a change is being app

DescriptionNameIconDisplays your login name and the duration of your current session. Also provides a linkyou can use to log out of the appliance.To c

Figure 7 Sample Map viewAdd enclosure: 192.0.2.0Apr 30 10:17AMMap1Z34AB7890ActionsvHPTC-RACK - 011Z34AB7890, interconnect 11Z34AB7890BladeSystem c7000

Figure 8 Notifications areaModelManagLocationPowerMaximumSerialGeneralOverviewA, Slot 1!The system A, Slot 1 is not configured for redundant power beca

• Wildcard characters, such as the asterisk (*), are not supported.• These search operators are not supported:◦ Plus sign (+)◦ Minus sign or hyphen (–

When you start typing, search suggestions are provided based on pattern matching andpreviously-entered search criteria.• Select a suggestion to change

Advanced searching and filtering with propertiesTIP: Enclosure a search value in double quotes if the value contains spaces.Enter complete values for

17.3 Tasks for licenses...12917.4 About licensing..

Figure 10 Filter resource instances by their health statusServer Hardware15Add server hardware+Unmanaged Server Dl 360P Gen8Unmanaged Server Dl 360P G

5 Using the REST APIs and other programmatic interfacesREST (Representational State Transfer) is a web service that uses basic CRUD (Create, Read, Upd

5.2 Return codesDescriptionReturn codeSuccessful operation2xxClient-side error with error message returned4xxAppliance error with error message return

5.6 REST API version and backward compatibilityWhen you perform a REST API operation, an X-API-Version header is required. This versionheader correspo

resource model. You can use the TaskResource resource model URI to list the current status ofthe operation.5.8 Task resourceWhen you make an asynchron

a query would return a large number of resources. The collection attributes (described below)provide information needed to determine whether the full

The simplest way to make sure that you have retrieved all resources in a specific collection is toalways perform iterative GET requests using the retu

To receive development discussions, sign up on the public mailing list at https://groups.google.com/forum/#!forum/hp-oneview-python.5.14 PowerShell an

78

6 Accessing documentation and helpThis chapter describes how to access help from the appliance, how to access the publicly availableonline information

20 Managing enclosures and enclosure groups...15320.1 Prerequisites for bringing an enclosure under management..

• Planning information, including configuration decisions to make and tasks that you might needto perform before you install an appliance, add managed

4. Navigate to the hp-oneview-help/content or hp-oneview-restapi/contentdirectory.5. Double-click the index.html file to open the HP OneView help syst

82

Part II Planning tasksThe chapters in this part describe data center configuration planning tasks that you might want to completebefore you install th

84

7 Planning your data center resourcesIn addition to ensuring that your environment meets the prerequisites for installation of the appliance,there are

1 and 2◦ Examples of network names that follow the recommended naming conventions includethe following:dev_1105_Aprod_1102_1test_1111_left◦ If you pla

For more information about the search capabilities of the appliance, see “Search resources”(page 67).7.5 Planning the appliance configurationThese top

7.5.6 IP addressesYou must specify what type of IP addresses are in use and how they are assigned to the appliance,either manually by you or assigned

8 Planning for configuration changesThis chapter identifies configuration changes that might result in a resource being taken offlinetemporarily or th

24.7 Creating a custom script to create and download an appliance backup file...17425 Managing the appliance...

each server profile connection to reconfigure it to specify the network you added. Becauseyou must edit the server profile to edit the connection, you

• Logical Interconnects and Logical Interconnect Groups. For a server connected to a logicalinterconnect to access a network, the logical interconnect

92

Part III Configuration quick startsThe quick starts provided in this part describe the basic resource configuration tasks required to quicklybring the

94

9 Quick Start: Initial ConfigurationThis quick start describes the process to bring your data center resources under management ofthe appliance after

To use REST APIs to configure the appliance and bring your environment under management forthe first time, see the REST API help, which is available f

connections, thus enabling the appliance to provide powerful monitoring and managementfunctionality:• The Data Centers screen generates a 3D model of

98

10 Quick Start: Adding a network to an existing applianceenvironmentThis quick start describes the process to add a network to an existing appliance e