Abstract
HP OneView 1.0 User Guide
Acknowledgments
Contents
Navigating the graphical user interface
Understanding the security features of the appliance
Accessing documentation and help
Using the Rest APIs and other programmatic interfaces
Planning for configuration changes
II Planning tasks Planning your data center resources
Managing networks and network resources 115
An HP 3PAR Storage System 105
107
Managing users and authentication 143
Managing power and temperature 139
Managing enclosures and enclosure groups 131
Managing firmware for managed devices 135
Managing the appliance 153
Backing up an appliance 149
About unsupported and unmanaged hardware 165
Monitoring power and temperature 179
VI Troubleshooting 197 199
Using the State-Change Message Bus Scmb 185
231
Restoring an appliance from a backup file 221
Support and other resources 227
Index 293
Using the virtual appliance console 269
Backup and restore script examples 271
Part I Learning about HP OneView
Page
HP OneView for converged infrastructure management
Learning about HP OneView
Architecture
HP OneView for converged infrastructure management
Learning about HP OneView
Hardware and software provisioning features
One tool and one data set-one view
Server profiles
Hardware and software provisioning features
Groups, templates, and sets
Expert design with consistent deployment
Types of groups and sets
Define configurations for specific environments
Flexibility in design and deployment
Streamlined process for bringing hardware under management
Operating system deployment
Monitoring and response features
Firmware and configuration change management features
Simplified configuration change management
Simplified firmware management
Monitoring the environment and responding to issues
Automatic configuration for monitoring
Monitoring and response features
Isolated management network
Alert and health management
Data center environmental management
Resource utilization monitoring
Specialized user role for creating backup files
Backup and restore features
Recovery from catastrophic failures
Backup and restore features
Availability features
Security features
Rest APIs-automation and integration
Graphical and programmatic interfaces
User interface-efficiency and simplicity by design
Convenient licensing model
Integration with other HP management software
Open integration
Networking features
Networking features
Supported networks
Logical interconnects
Network sets
Understanding the resource model
Resource model summary diagram
Connection templates
Server profiles
Relationship to other resources
UI screens and Rest API resources
Server hardware types
Connections
Connection-templates
Connections and server-profiles
Zero or more server profiles
Server hardware
UI screen Rest API resource Server Hardware Types
Server-hardware-types
Enclosure types
Enclosure groups
Server-hardware
Enclosure-groups
Enclosures
Zero or more power delivery devices
Interconnect types
Exactly one enclosure group
Interconnect-types
Interconnects
UI screen Rest API resources Interconnects
Logical interconnect groups
Interconnects , interconnect-types ,
Logical-interconnects
Logical-interconnect-groups
Logical interconnects
UI screen Rest API resource Logical Interconnect Groups
UI screen Rest API resource Logical Interconnects
Uplink sets
Logical-downlinks
To a downlink
Network sets
Networks
Zero or one uplink set per logical interconnect
Uplink-sets
Appliance
Domains
Network-sets
Domains
Data centers
Resources related data center facilities
Racks
Relationship to other resources
Power-devices
Power delivery devices
Unmanaged devices
Zero or more unmanaged devices
Unmanaged-devices
UI screen Rest API resource Unmanaged Devices
You can view, add, or edit the properties
Rest APIs
Page
Securing the appliance
Understanding the security features of the appliance
Securing the appliance
Best practices for maintaining a secure appliance
Understanding the security features of the appliance
Creating a login session
Creating a login session
Authentication for appliance access
Protecting credentials
Controlling access for authorized users
Understanding the audit log
Specifying user accounts and roles
Understanding the audit log
Resource category
Message
Example 1 Sample audit entries user login and logout
Appliance access over SSL
Managing certificates from a browser
Overview
Verifying a certificate
Using a certificate authority
Downloading and importing a self-signed certificate
Managing certificates from a browser
Browser best practices for a secure environment
Passwords
Nonbrowser clients
SSL connection
Switching from one console to another
Access to the appliance console
Ports needed for HP OneView
Required ports
Restricting console access
Enabling or disabling authorized services access
Algorithms for securing the appliance
SSL see
Downloads from the appliance
Downloads from the appliance
Page
Commonly used browser features and settings
Required plug-ins and settings
Navigating the graphical user interface
Browsers
Set US or metric units of measurement
About the graphical user interface
Set the browser for US or metric units of measurement
About the graphical user interface
Screen topography
Button functions
About the Activity sidebar
Banner and main menu
UI buttons
Filters sidebar
Help sidebar
Oneviewcommunity online
Icon descriptions
User control icons
Status and severity icons
Large icon Small icon Resource Activity Task Critical
Display details
Informational icons
Map view screen details
Notifications area
Notifications area
Search help topics
Log out of the appliance
About help system search results
Search resources
View resources according to their health status
Error Unknown Disabled
Advanced searching and filtering with properties
Nameenclosure10 name192.0.2.0, PDU
View resources according to their health status
Reset the health status view
Page
Resource operations
Using the Rest APIs and other programmatic interfaces
Operation Http Verb Create
Resource data
Return codes
Log in to the appliance using Rest APIs
URI format
Resource model format
Concurrency control using etags
Error handling
Asynchronous versus synchronous operations
Task resource
Developer tools in a web browser
Querying resources using common Rest API parameters
State Change Message Bus
Online help-conceptual and task information as you need it
Accessing documentation and help
This user guide supplements the online help
Rest API help design
Accessing documentation and help
Where to find HP OneView documentation
HP OneView documentation
Downloading Html help and Rest API files
Part II Planning tasks
Page
Security planning
Planning your data center resources
How many data centers?
Choosing a security certificate policy
Determining your backup policy
Determining roles and restrictions for authorized users
Choosing a policy for the audit log
Planning your resource names
Preparing your data center network switches
Reviewing your firewall access
Resource name
Planning the appliance configuration
Appliance VM and host requirements
Location of the appliance
Planning for high availability
Separate networks for data and management
Time clocks and NTP
Page
Appliance
Planning for configuration changes
Enclosures
Interconnects and logical interconnects
Adding a network
Planning for configuration changes
Server profiles and server hardware
Adding an enclosure
Page
Part III Configuration quick starts
Page
Configure the environment for the first time
Quick Start Initial Configuration
Process overview
Process overview
Directory-based authentication
Local authentication
Ethernet
Fibre Channel
Configuration step Required action or input
Configuration step Add power devices to the appliance
Page
Resource Task Description Networks Add the network
Process
Server Profiles Hardware
Resource Task
Page
Checklist connecting a server blade to a data center network
Page
Resource Task Enclosures
Process
Groups Enclosure
Resource Task Logical Create a logical Interconnect
Server Profiles Do one Following Hardware Create a server
It to the server
Enter a name for
104
105
Attach network
Resource Task Description Networks Add the Fibre
Sets for the Direct
107
Resource Task Server Hardware Add the server using
Rest APIs for
108
Part IV Configuration and management
110
Managing servers and server profiles
Server hardware features supported by the appliance
UI screens and Rest API resources
Server-profiles and connections
Tasks for server profiles
Prerequisites for bringing server hardware under management
Roles
Tasks for server hardware types
Tasks for server hardware
Effects of managing server hardware iLOs
Tasks for server hardware
Learning more
Managing networks and network resources
Data center switch port requirements
Managing Fibre Channel networks SANs
Interconnects
About network connectivity
Managing Ethernet networks
Roles
Tasks
About network connectivity
About Fibre Channel networks
Fibre Channel network types
Direct attach Fibre Channel networks
Fabric attach Fibre Channel networks
About network sets
About Ethernet networks
Fibre Channel networks and FCoE
Ethernet networks and network sets
Network set details
Managing enclosure interconnect hardware
Managing enclosure interconnect hardware
About interconnects
Learning more
Interconnects Networking features
Connectivity and synchronization with the appliance
About unsupported interconnects
About logical interconnects
Server Blade Logical Interconnect
Uplink sets
Adding a logical interconnect
Stacking modes
Stacking health
Deleting a logical interconnect
About logical interconnect groups
Logical Interconnect Group a
About Snmp settings
Configuration defined by the logical interconnect group?
Items Compliance checking Ethernet interconnect settings
Set?
Interconnect maps
Configure a port to monitor network traffic
130
Prerequisites for bringing an enclosure under management
Managing enclosures and enclosure groups
About enclosures
Tasks
Connectivity and synchronization with the appliance
Managing enclosures and enclosure groups
About enclosure groups
About enclosure groups
Effects of managing an enclosure
134
About the appliance firmware repository
Managing firmware for managed devices
About unsupported firmware
Unsupported firmware for firmware bundles
Roles and Tasks
Firmware update process
Unsupported firmware for enclosures
Unsupported firmware for server profiles
Best practice First step Upload the latest current SPP
Best practices for firmware
Option
Best practice
Troubleshooting firmware bundles
About power delivery devices
Managing power and temperature
Managing power
About racks
Managing power and temperature
Default data center Datacenter
Managing temperature
Default rack placement
Managing temperature
About utilization graphs
About user accounts
Managing users and authentication
Reset the administrator password
Action privileges for user roles
About user roles
Appliance role types
Action privileges for user roles
Global settings
Administrator Backups
Login sessions
Restores
About directory service authentication
About authentication settings
Managing user passwords
Managing user passwords
Resetting the administrator password
Reset the administrator password
Backup file name
Overview of the backup process
Backups
Backing up an appliance
Backing up an appliance
Guidelines for creating a backup file
Create and download a backup file
Post /rest/backups
Creating and downloading a backup file
Download the backup file
GET /rest/backups/archive/backup URI
152
Managing appliance availability
Managing the appliance
Best practices for managing a VM appliance
How the appliance handles an unexpected shutdown
What to do when an appliance restarts
Appliance recovery operations
Shut down the appliance
Restart the appliance
Restarting the appliance
Managing the appliance settings
About appliance Snmp settings
Enabling or disabling HP support access to the appliance
Managing the security features of the appliance
Managing addresses and ID pools
Id-pools
Managing the HP public key
Managing SSL certificates
Roles
Tasks
Downloading audit logs
Managing licenses
Audit-logs
Licenses
License types
About licensing
License delivery
License reporting
License graph colors
Server hardware licensing
View license status
Enclosure licensing policy behavior
Licensed features
Server blade licensing at the enclosure level
Licensing and utilization statistics
Rack mount server licensing
Licensing scenarios
Rack mount server licensing behavior
Licensing scenarios
Updating the appliance
Appliance/firmware
How the appliance handles unsupported hardware
About unsupported and unmanaged hardware
About unmanaged devices
How the appliance handles unsupported hardware
166
Part V Monitoring
168
Daily monitoring
Monitoring data center status, health, and performance
Initial check the Dashboard
Activities
Best practices for monitoring data centers
Monitor data center temperature
Best practices for monitoring health with the appliance UI
General health monitoring steps
Server hardware health monitoring
Best practices for monitoring health using Rest APIs
Network health monitoring
Overall health monitoring
GET /rest/alerts
Get a specific alert using the alert ID
GET /rest/alerts/id
Get the associated events
About activities
Managing activities
GET /rest/logical-interconnects/id
Managing activities
About alerts
Activity types alerts and tasks
About tasks
Task type Description User
Activity statuses
Activity states
How to interpret the Dashboard graphs
Using the Dashboard screen
About the Dashboard
Dashboard screen details
Status icons
Disabled or Unknown
Monitoring data center status, health, and performance
Power and temperature monitoring feature overview
Monitoring power and temperature
Power and temperature monitoring features by resource
UI power and temperature monitoring
Manipulating the view of the data center visualization
Monitoring power and temperature
About utilization graphs
Monitoring power and temperature utilization
About the Utilization panel
Utilization statistics gathered by resource
Enclosures Power Delivery Devices Server Hardware
Utilization graphs
Utilization metric Resource
Power utilization metrics
Update enclosure power capacity settings
Rest API power and temperature monitoring
Update server hardware power capacity settings
Prerequisites
GET /rest/certificates/client/rabbitmq/keypair/default
Using the State-Change Message Bus Scmb
Connect to the Scmb
Create and download the Amqp client certificate
Using the State-Change Message Bus Scmb
Set up a queue to connect to the HP OneView Scmb exchange
Sample queues
Json structure of message received from the Scmb
Example 2 Json example
NET C# code example
ChangeType values
NET C# code example
Additional example-specific prerequisites
Examples
Java code example
Java code example
Example 5 Java code example
Python code example
Python code example
Example 6 Python code example pika
Example 7 Python code example amqplib
Re-create the Amqp client certificate
Re-create the Amqp client certificate
Delete /rest/certificates/ca/rabbitmqreadonly
196
Part VI Troubleshooting
198
199
Troubleshooting
Category
About network setup errors
Basic troubleshooting techniques
About reported serious errors
Recommendation Details Look for a message
Create a support dump file
When VM host is down or nonresponsive
Creating a support dump file
Recommendation Details
Post /rest/appliance/support-dumps
Creating a support dump using Rest APIs Create support dump
Download the support dump file
GET /rest/appliance/support-dumps/file name
First time setup
Troubleshooting the appliance
Appliance cannot access the network
Unexpected appliance shutdown
Support dump file creation action fails
Appliance update is unsuccessful
Certificate action fails
Insufficient time
Backup file creation is still in progress
Backup file creation, download, or restore action fails
Backup file is incompatible
Appliance network is down
Restore operation fails or times out
Profile operation was running during the backup
Internal server error
Restart or shutdown failure
Reinstall the software
VM does not restart when VM host time is manually set
Reinstall the remote console
Add or remove enclosure is unsuccessful
Troubleshooting enclosures and enclosures groups
Clear vcmode
Restart interconnect
Restart interconnect N
Certificate Error
Troubleshooting firmware bundles
Add server blade is unsuccessful
Incorrect credentials
Troubleshooting licensing
Troubleshooting interconnects
27.9.1 I/O bay occupancy errors
Troubleshooting logical interconnects
Uplink set warnings or errors
License assigned does not match the type specified
Troubleshooting server hardware
Troubleshooting networks
Physical interconnect warnings and errors
Network create operation is unsuccessful
Is claimed by that software
Cannot control power on server blade
Troubleshooting server profiles
Troubleshooting server profiles
Server profile is not created or updated correctly
Prerequisites and conditions have not been met
Server hardware or its iLO are powered-off or reset
What to do when you cannot apply the server profile
Invalid configuration
Verify the operational status of the server hardware
Unauthenticated user or group
Troubleshooting user accounts
Profile operations fail
Incorrect privileges
Cannot add directory service
Directory service not available
User public key is not accepted
Inaccurate credentials
Lost connection with directory service host
Cannot add server for a directory service
User or group not configured in the directory service
Cannot add directory user or group
Restore operation overview
Restoring an appliance from a backup file
Restores
See also Post-restoration tasks
Restoring an appliance from a backup file
Preparing to restore an appliance
Restore an appliance from a backup file
Restore an appliance from a backup file
Creating a custom script to restore an appliance
Using Rest APIs to restore an appliance from a backup file
Restoring an appliance from a backup file
Post-restoration tasks
Post-restoration tasks
Preventing duplicate IDs on the network after a restore
226
Software technical support and software updates
How to contact HP
Support and other resources
Get connected to the HP OneView online user forum
Related information
Using your software technical support and update service
Documentation Product websites
Support and other resources
For UI and Rest API help
Submit documentation feedback
For user guides and other manuals
Docsfeedback@hp.com
230
Information about the sample data center
Tasks you can perform without data center hardware
Sample data center hardware
Tasks you can perform without data center hardware
OAAdmin
ILOAdmin
Rack mount server
Enclosure
Fibre Channel networks for the SAN fabrics
Data center networks
Fibre Channel networks
Storage system
SAN a and SAN B Fibre Channel network configurations
Switches in the data center
Production networks
Ethernet Networks
Networks for vMotion and virtual machine management
Planning for installation of the appliance
Planning the configuration
Ethernet network configuration values
Development networks
Planning for users and roles
Planning the configuration
Planning for network sets
Planning resource names
Installing the appliance
Assumptions
Workflow
Copying the template server profile to eight servers
Configuring the networks and network sets
Configuring the Fibre Channel SAN networks
Configuring the Ethernet networks
Prod 1101 1102 1103 1104
Use the following names and Vlan IDs for the test networks
Configuring the network sets
Page
Creating the logical interconnect group
Creating a logical interconnect group and its uplink sets
Creating the uplink sets for the Fibre Channel networks
Creating the uplink sets for the Ethernet networks
TestUS
ProdUS
DevUS
Click Create to create the logical interconnect group
Creating an enclosure group for vSphere ESXi hosts
Adding the enclosure
Enclosures Password
Viewing the server hardware types
172.18.1.12 Address
Viewing server hardware types
Creating a server profile to use as a template
Editing server hardware types
View information about the server hardware
Page
Esxi mgmt
Attribute Value Device type Ethernet Network
Secondary
Esxi vmotion
Requested bandwidth
Boot Not bootable
Attribute Value Device type Fibre Channel Network
Page
Esx02 Encl1, bay Esx03 Esx04 Esx05 Esx06 Esx07 Esx08
Copying the template server profile to eight servers
Name Server hardware
Creating the Flat SAN networks
172.18.1.14 Address
Page
Page
Enclosure name
Creating the server profile
Encl2
Enclosure group name
FlatSAN a
Requested bandwidth Default value FlexNIC
Device type Fibre Channel Network
FlatSAN B
Page
Assumptions
Viewing information about the server
Powering on the server
Adding the server hardware
Page
Adding a license for the server
Page
Using the virtual appliance console
Using the virtual appliance console
Using the virtual appliance console
Key combinations for the virtual appliance console
270
Sample backup script
Backup and restore script examples
Sample backup script
Sample script
Backup and restore script examples
Example 8 Sample backup.ps1 script
Sample backup script
None, does not accept piping
Sample backup script
Backup and restore script examples
Backup resource object
Absolute path of the download file
Sample backup script
Backup and restore script examples
Sample backup script
Sample restore script
Sample restore script
Example 9 Sample restore.ps1 script
Outputs the new active Api version
Response body to the upload post request
Sample restore script
Outputs the response body from the Post restore call
None, end of script upon completion or fail
Uri of the restore task in string form
Sample restore script
Backup and restore script examples
293
Host, security access, 80 initial configuration
Index
Index
Eula
295
Scmb see State-Change Message Bus
Status icon, 62 storage system website
Logical interconnect, 125 State-Change Message Bus
297
Vlan ID