Sample restore script | HP OneView specs

4.Calls start-restore()to start the restore.

5.Calls restore-status()to periodically check the restore status until the restore completes.

If you pass the -statusoption to the script, the script verifies and reports the status of the last or an ongoing restore until the restore process is complete:

1.Calls recover-restoreID()to get the URI to verify the status of the last or an ongoing restore.

2.Calls restore-status()to periodically verify the restore status until the restore completes.

C.2 Sample restore script 283

Page 283

Image 283

Contents

Abstract HP OneView 1.0 User Guide Acknowledgments Contents Navigating the graphical user interface Understanding the security features of the appliance II Planning tasks Planning your data center resources Using the Rest APIs and other programmatic interfacesAccessing documentation and help Planning for configuration changes 107 An HP 3PAR Storage System 105Managing networks and network resources 115 Managing firmware for managed devices 135 Managing power and temperature 139Managing users and authentication 143 Managing enclosures and enclosure groups 131 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 Support and other resources 227 Restoring an appliance from a backup file 221231 Backup and restore script examples 271 Using the virtual appliance console 269Index 293 Part I Learning about HP OneView Page HP OneView for converged infrastructure management Learning about HP OneViewHP OneView for converged infrastructure management Architecture One tool and one data set-one view Hardware and software provisioning featuresLearning about HP OneView Expert design with consistent deployment Hardware and software provisioning featuresServer profiles Groups, templates, and sets Types of groups and sets Define configurations for specific environments Operating system deployment Streamlined process for bringing hardware under managementFlexibility in design and deployment Simplified firmware management Firmware and configuration change management featuresMonitoring and response features Simplified configuration change management Isolated management network Automatic configuration for monitoringMonitoring the environment and responding to issues Monitoring and response features Resource utilization monitoring Data center environmental managementAlert and health management Backup and restore features Backup and restore featuresSpecialized user role for creating backup files Recovery from catastrophic failures Availability features Security features User interface-efficiency and simplicity by design Graphical and programmatic interfacesRest APIs-automation and integration Open integration Integration with other HP management softwareConvenient licensing model Logical interconnects Networking featuresNetworking features Supported networks Network sets Understanding the resource model Resource model summary diagram UI screens and Rest API resources Server profilesConnection templates Relationship to other resources Connections and server-profiles ConnectionsServer hardware types Connection-templates Server-hardware-types Server hardwareZero or more server profiles UI screen Rest API resource Server Hardware Types Enclosure-groups Enclosure groupsEnclosure types Server-hardware Exactly one enclosure group Zero or more power delivery devicesEnclosures Interconnect types Interconnect-types Interconnects Logical-interconnects Logical interconnect groupsUI screen Rest API resources Interconnects Interconnects , interconnect-types , UI screen Rest API resource Logical Interconnect Groups Logical interconnectsLogical-interconnect-groups To a downlink Uplink setsUI screen Rest API resource Logical Interconnects Logical-downlinks Uplink-sets NetworksNetwork sets Zero or one uplink set per logical interconnect Domains DomainsAppliance Network-sets Relationship to other resources Resources related data center facilitiesData centers Racks Zero or more unmanaged devices Power delivery devicesPower-devices Unmanaged devices Rest APIs UI screen Rest API resource Unmanaged DevicesUnmanaged-devices You can view, add, or edit the propertiesPage Securing the appliance Understanding the security features of the applianceSecuring the appliance Best practices for maintaining a secure appliance Understanding the security features of the appliance Authentication for appliance access Creating a login sessionCreating a login session Specifying user accounts and roles Controlling access for authorized usersProtecting credentials Understanding the audit log Message Resource categoryUnderstanding the audit log Overview Appliance access over SSLExample 1 Sample audit entries user login and logout Managing certificates from a browser Managing certificates from a browser Using a certificate authorityVerifying a certificate Downloading and importing a self-signed certificate SSL connection PasswordsBrowser best practices for a secure environment Nonbrowser clients Required ports Access to the appliance consoleSwitching from one console to another Ports needed for HP OneView SSL see Enabling or disabling authorized services accessRestricting console access Algorithms for securing the appliance Downloads from the appliance Downloads from the appliancePage Browsers Required plug-ins and settingsCommonly used browser features and settings Navigating the graphical user interface Set the browser for US or metric units of measurement About the graphical user interfaceSet US or metric units of measurement About the graphical user interface Screen topography Banner and main menu About the Activity sidebarButton functions Help sidebar Filters sidebarUI buttons Oneviewcommunity online Icon descriptions Display details Status and severity iconsUser control icons Large icon Small icon Resource Activity Task Critical 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 Nameenclosure10 name192.0.2.0, PDU Error Unknown DisabledView resources according to their health status Advanced searching and filtering with properties View resources according to their health status Reset the health status viewPage Resource data Using the Rest APIs and other programmatic interfacesResource operations Operation Http Verb Create Resource model format Log in to the appliance using Rest APIsReturn codes URI format Task resource Error handlingConcurrency control using etags Asynchronous versus synchronous operations State Change Message Bus Querying resources using common Rest API parametersDeveloper tools in a web browser Rest API help design Accessing documentation and helpOnline help-conceptual and task information as you need it This user guide supplements the online help Downloading Html help and Rest API files Where to find HP OneView documentationAccessing documentation and help HP OneView documentation Part II Planning tasks Page How many data centers? Planning your data center resourcesSecurity planning Choosing a policy for the audit log Determining your backup policyChoosing a security certificate policy Determining roles and restrictions for authorized users Reviewing your firewall access Preparing your data center network switchesPlanning your resource names Appliance VM and host requirements Planning the appliance configurationResource name Time clocks and NTP Planning for high availabilityLocation of the appliance Separate networks for data and managementPage Interconnects and logical interconnects Planning for configuration changesAppliance Enclosures Server profiles and server hardware Planning for configuration changesAdding a network Adding an enclosure Page Part III Configuration quick starts Page Process overview Quick Start Initial ConfigurationConfigure the environment for the first time Process overview Fibre Channel Local authenticationDirectory-based authentication Ethernet 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 TaskPage Checklist connecting a server blade to a data center network Page Resource Task Enclosures Process It to the server Resource Task Logical Create a logical InterconnectGroups Enclosure Server Profiles Do one Following Hardware Create a server Enter a name for 104 105 Sets for the Direct Resource Task Description Networks Add the FibreAttach network Rest APIs for Resource Task Server Hardware Add the server using107 108 Part IV Configuration and management 110 Server-profiles and connections Server hardware features supported by the applianceManaging servers and server profiles UI screens and Rest API resources Roles Prerequisites for bringing server hardware under managementTasks for server profiles Tasks for server hardware Tasks for server hardwareTasks for server hardware types Effects of managing server hardware iLOs Learning more Interconnects Data center switch port requirementsManaging networks and network resources Managing Fibre Channel networks SANs Tasks Managing Ethernet networksAbout network connectivity Roles Fibre Channel network types About Fibre Channel networksAbout network connectivity Direct attach Fibre Channel networks Fabric attach Fibre Channel networks Ethernet networks and network sets About Ethernet networksAbout network sets Fibre Channel networks and FCoE Network set details About interconnects Managing enclosure interconnect hardwareManaging enclosure interconnect hardware About unsupported interconnects Interconnects Networking featuresLearning more Connectivity and synchronization with the appliance About logical interconnects Server Blade Logical Interconnect Uplink sets Stacking health Stacking modesAdding a logical interconnect Deleting a logical interconnect About logical interconnect groups Logical Interconnect Group a About Snmp settings Interconnect maps Items Compliance checking Ethernet interconnect settingsConfiguration defined by the logical interconnect group? Set? Configure a port to monitor network traffic 130 Prerequisites for bringing an enclosure under management Managing enclosures and enclosure groups Managing enclosures and enclosure groups TasksAbout enclosures Connectivity and synchronization with the appliance Effects of managing an enclosure About enclosure groupsAbout enclosure groups 134 Unsupported firmware for firmware bundles Managing firmware for managed devicesAbout the appliance firmware repository About unsupported firmware Unsupported firmware for server profiles Firmware update processRoles and Tasks Unsupported firmware for enclosures Option Best practices for firmwareBest practice First step Upload the latest current SPP Best practice Troubleshooting firmware bundles Managing power Managing power and temperatureAbout power delivery devices About racks Managing power and temperature Managing temperature Managing temperatureDefault data center Datacenter Default rack placement About utilization graphs Reset the administrator password Managing users and authenticationAbout user accounts Action privileges for user roles About user rolesAction privileges for user roles Appliance role types Restores Administrator BackupsGlobal settings Login sessions About directory service authentication About authentication settings Managing user passwords Managing user passwords Resetting the administrator password Reset the administrator password Backing up an appliance Overview of the backup processBackup file name Backups Create and download a backup file Guidelines for creating a backup fileBacking up an appliance GET /rest/backups/archive/backup URI Creating and downloading a backup filePost /rest/backups Download the backup file 152 How the appliance handles an unexpected shutdown Managing the applianceManaging appliance availability Best practices for managing a VM appliance Restart the appliance Appliance recovery operationsWhat to do when an appliance restarts Shut down the appliance About appliance Snmp settings Managing the appliance settingsRestarting the appliance Id-pools Managing the security features of the applianceEnabling or disabling HP support access to the appliance Managing addresses and ID pools Tasks Managing SSL certificatesManaging the HP public key Roles Licenses Managing licensesDownloading audit logs Audit-logs License reporting About licensingLicense types License delivery View license status Server hardware licensingLicense graph colors Server blade licensing at the enclosure level Licensed featuresEnclosure licensing policy behavior Rack mount server licensing behavior Rack mount server licensingLicensing and utilization statistics Licensing scenarios Licensing scenarios Updating the appliance Appliance/firmware How the appliance handles unsupported hardware About unsupported and unmanaged hardwareHow the appliance handles unsupported hardware About unmanaged devices 166 Part V Monitoring 168 Activities Monitoring data center status, health, and performanceDaily monitoring Initial check the Dashboard General health monitoring steps Monitor data center temperatureBest practices for monitoring data centers Best practices for monitoring health with the appliance UI Overall health monitoring Best practices for monitoring health using Rest APIsServer hardware health monitoring Network health monitoring Get the associated events Get a specific alert using the alert IDGET /rest/alerts GET /rest/alerts/id Managing activities Managing activitiesAbout activities GET /rest/logical-interconnects/id Task type Description User Activity types alerts and tasksAbout alerts About tasks Activity statuses Activity states Dashboard screen details Using the Dashboard screenHow to interpret the Dashboard graphs About the Dashboard Status icons Disabled or Unknown Monitoring data center status, health, and performance UI power and temperature monitoring Monitoring power and temperaturePower and temperature monitoring feature overview Power and temperature monitoring features by resource Manipulating the view of the data center visualization Monitoring power and temperature About the Utilization panel Monitoring power and temperature utilizationAbout utilization graphs Utilization metric Resource Enclosures Power Delivery Devices Server HardwareUtilization statistics gathered by resource Utilization graphs Power utilization metrics Prerequisites Rest API power and temperature monitoringUpdate enclosure power capacity settings Update server hardware power capacity settings Create and download the Amqp client certificate Using the State-Change Message Bus ScmbGET /rest/certificates/client/rabbitmq/keypair/default Connect to the Scmb 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 ChangeType values NET C# code exampleExample 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 Delete /rest/certificates/ca/rabbitmqreadonly Re-create the Amqp client certificateRe-create the Amqp client certificate 196 Part VI Troubleshooting 198 Category Troubleshooting199 Recommendation Details Look for a message Basic troubleshooting techniquesAbout network setup errors About reported serious errors Recommendation Details When VM host is down or nonresponsiveCreate a support dump file Creating a support dump file GET /rest/appliance/support-dumps/file name Creating a support dump using Rest APIs Create support dumpPost /rest/appliance/support-dumps Download the support dump file Unexpected appliance shutdown Troubleshooting the applianceFirst time setup Appliance cannot access the network Insufficient time Appliance update is unsuccessfulSupport dump file creation action fails Certificate action fails Appliance network is down Backup file creation, download, or restore action failsBackup file creation is still in progress Backup file is incompatible Restart or shutdown failure Profile operation was running during the backupRestore operation fails or times out Internal server error Reinstall the remote console VM does not restart when VM host time is manually setReinstall the software Restart interconnect Troubleshooting enclosures and enclosures groupsAdd or remove enclosure is unsuccessful Clear vcmode Restart interconnect N Incorrect credentials Troubleshooting firmware bundlesCertificate Error Add server blade is unsuccessful Troubleshooting licensing Troubleshooting interconnects License assigned does not match the type specified Troubleshooting logical interconnects27.9.1 I/O bay occupancy errors Uplink set warnings or errors Network create operation is unsuccessful Troubleshooting networksTroubleshooting server hardware Physical interconnect warnings and errors Is claimed by that software Cannot control power on server blade Server profile is not created or updated correctly Troubleshooting server profilesTroubleshooting server profiles Prerequisites and conditions have not been met Verify the operational status of the server hardware What to do when you cannot apply the server profileServer hardware or its iLO are powered-off or reset Invalid configuration Incorrect privileges Troubleshooting user accountsUnauthenticated user or group Profile operations fail Inaccurate credentials Directory service not availableCannot add directory service User public key is not accepted Cannot add directory user or group Cannot add server for a directory serviceLost connection with directory service host User or group not configured in the directory service See also Post-restoration tasks Restoring an appliance from a backup fileRestore operation overview Restores 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 Post-restoration tasks Using Rest APIs to restore an appliance from a backup fileCreating 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 226 Get connected to the HP OneView online user forum How to contact HPSoftware technical support and software updates Support and other resources Support and other resources Using your software technical support and update serviceRelated information Documentation Product websites Docsfeedback@hp.com Submit documentation feedbackFor UI and Rest API help For user guides and other manuals 230 Tasks you can perform without data center hardware Tasks you can perform without data center hardwareInformation about the sample data center Sample data center hardware Enclosure ILOAdminOAAdmin Rack mount server Fibre Channel networks Data center networksFibre Channel networks for the SAN fabrics Switches in the data center SAN a and SAN B Fibre Channel network configurationsStorage system Networks for vMotion and virtual machine management Ethernet NetworksProduction networks Development networks Planning the configurationPlanning for installation of the appliance Ethernet network configuration values Planning for network sets Planning the configurationPlanning for users and roles Workflow Installing the appliancePlanning resource names Assumptions Configuring the Fibre Channel SAN networks Configuring the networks and network setsCopying 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 DevUS ProdUSTestUS Click Create to create the logical interconnect group Creating an enclosure group for vSphere ESXi hosts 172.18.1.12 Address Enclosures PasswordAdding the enclosure Viewing the server hardware types View information about the server hardware Creating a server profile to use as a templateViewing server hardware types Editing server hardware typesPage Esxi vmotion Attribute Value Device type Ethernet NetworkEsxi mgmt Secondary Attribute Value Device type Fibre Channel Network Boot Not bootableRequested bandwidth Page Name Server hardware Copying the template server profile to eight serversEsx02 Encl1, bay Esx03 Esx04 Esx05 Esx06 Esx07 Esx08 Creating the Flat SAN networks 172.18.1.14 Address Page Page Enclosure group name Creating the server profileEnclosure name Encl2 Device type Fibre Channel Network Requested bandwidth Default value FlexNICFlatSAN a FlatSAN B Page Assumptions Adding the server hardware Powering on the serverViewing information about the server Page Adding a license for the server Page Key combinations for the virtual appliance console Using the virtual appliance consoleUsing the virtual appliance console Using the virtual appliance console 270 Sample script Backup and restore script examplesSample backup script Sample backup 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 Index Host, security access, 80 initial configuration293 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

HP OneView manual Sample restore script

Models: OneView

C.2 Sample restore script 283