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
 An HP 3PAR Storage System 105
107
Managing networks and network resources 115
 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
 Restoring an appliance from a backup file 221
Support and other resources 227
231
 Using the virtual appliance console 269
Backup and restore script examples 271
Index 293
 Part I Learning about HP OneView
Page
 HP OneView for converged infrastructure management
Learning about HP OneView
Architecture
HP OneView for converged infrastructure management
 Hardware and software provisioning features
One tool and one data set-one view
Learning about HP OneView
 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
 Streamlined process for bringing hardware under management
Operating system deployment
Flexibility in design and 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
 Data center environmental management
Resource utilization monitoring
Alert and health management
 Specialized user role for creating backup files
Backup and restore features
Recovery from catastrophic failures
Backup and restore features
 Availability features
Security features
 Graphical and programmatic interfaces
User interface-efficiency and simplicity by design
Rest APIs-automation and integration
 Integration with other HP management software
Open integration
Convenient licensing model
 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 interconnects
UI screen Rest API resource Logical Interconnect Groups
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
 Understanding the security features of the appliance
Securing the appliance
Securing the appliance
 Best practices for maintaining a secure appliance
Understanding the security features of the appliance
 Creating a login session
Authentication for appliance access
Creating a login session
 Protecting credentials
Controlling access for authorized users
Understanding the audit log
Specifying user accounts and roles
 Resource category
Message
Understanding the audit log
 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
 About the graphical user interface
Set the browser for US or metric units of measurement
Set US or metric units of measurement
 About the graphical user interface
Screen topography
 About the Activity sidebar
Banner and main menu
Button functions
 Filters sidebar
Help sidebar
UI buttons
 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
 Querying resources using common Rest API parameters
State Change Message Bus
Developer tools in a web browser
 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
 Planning your data center resources
How many data centers?
Security planning
 Choosing a security certificate policy
Determining your backup policy
Determining roles and restrictions for authorized users
Choosing a policy for the audit log
 Preparing your data center network switches
Reviewing your firewall access
Planning your resource names
 Planning the appliance configuration
Appliance VM and host requirements
Resource name
 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
 Planning for configuration changes
Server profiles and server hardware
Adding a network
 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
 Resource Task Description Networks Add the Fibre
Sets for the Direct
Attach network
 Resource Task Server Hardware Add the server using
Rest APIs for
107
 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
 Prerequisites for bringing server hardware under management
Roles
Tasks for server profiles
 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 Fibre Channel networks
Fibre Channel network types
About network connectivity
 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
About interconnects
Managing enclosure interconnect hardware
 Learning more
Interconnects Networking features
Connectivity and synchronization with the appliance
About unsupported interconnects
 About logical interconnects
 Server Blade Logical Interconnect
Uplink sets
 Stacking modes
Stacking health
Adding a logical interconnect
 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
Effects of managing an enclosure
About enclosure groups
 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 practices for firmware
Option
Best practice First step Upload the latest current SPP
 Best practice
Troubleshooting firmware bundles
 Managing power and temperature
Managing power
About power delivery devices
 About racks
Managing power and temperature
 Default data center Datacenter
Managing temperature
Default rack placement
Managing temperature
 About utilization graphs
 Managing users and authentication
Reset the administrator password
About user accounts
 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
 Guidelines for creating a backup file
Create and download a backup file
Backing up an appliance
 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
 Managing the appliance settings
About appliance Snmp settings
Restarting the appliance
 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
 Server hardware licensing
View license status
License graph colors
 Licensed features
Server blade licensing at the enclosure level
Enclosure licensing policy behavior
 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
 Monitoring power and temperature utilization
About the Utilization panel
About utilization graphs
 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
 NET C# code example
ChangeType values
Example 2 Json example
 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
Delete /rest/certificates/ca/rabbitmqreadonly
Re-create the Amqp client certificate
 196
 Part VI Troubleshooting
 198
 Troubleshooting
Category
199
 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
 VM does not restart when VM host time is manually set
Reinstall the remote console
Reinstall the software
 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
Server profile is not created or updated correctly
Troubleshooting server profiles
 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
 Data center networks
Fibre Channel networks
Fibre Channel networks for the SAN fabrics
 SAN a and SAN B Fibre Channel network configurations
Switches in the data center
Storage system
 Ethernet Networks
Networks for vMotion and virtual machine management
Production networks
 Planning for installation of the appliance
Planning the configuration
Ethernet network configuration values
Development networks
 Planning the configuration
Planning for network sets
Planning for users and roles
 Planning resource names
Installing the appliance
Assumptions
Workflow
 Configuring the networks and network sets
Configuring the Fibre Channel SAN networks
Copying the template server profile to eight servers
 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
 ProdUS
DevUS
TestUS
 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
 Boot Not bootable
Attribute Value Device type Fibre Channel Network
Requested bandwidth
Page
 Copying the template server profile to eight servers
Name Server hardware
Esx02 Encl1, bay Esx03 Esx04 Esx05 Esx06 Esx07 Esx08
 Creating the Flat SAN networks
 172.18.1.14 Address
Page
Page
 Enclosure name
Creating the server profile
Encl2
Enclosure group name
 Requested bandwidth Default value FlexNIC
Device type Fibre Channel Network
FlatSAN a
 FlatSAN B
Page
 Assumptions
 Powering on the server
Adding the server hardware
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
 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
 Host, security access, 80 initial configuration
Index
293
 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