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