Manuals / HP / Computer Equipment / Software

HP OneView manual Sample restore script

Models: OneView

1 297

Page 283

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 GuideAcknowledgments Contents Navigating the graphical user interface Understanding the security features of the applianceII Planning tasks Planning your data center resources Using the Rest APIs and other programmatic interfacesAccessing documentation and help Planning for configuration changes107 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 131Managing the appliance 153 Backing up an appliance 149About unsupported and unmanaged hardware 165 Monitoring power and temperature 179VI Troubleshooting 197 199 Using the State-Change Message Bus Scmb 185Support 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 ArchitectureOne 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 setsTypes of groups and sets Define configurations for specific environmentsOperating 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 managementIsolated management network Automatic configuration for monitoringMonitoring the environment and responding to issues Monitoring and response featuresResource 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 failuresAvailability features Security featuresUser 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 networksNetwork sets Understanding the resource model Resource model summary diagramUI screens and Rest API resources Server profilesConnection templates Relationship to other resourcesConnections and server-profiles ConnectionsServer hardware types Connection-templatesServer-hardware-types Server hardwareZero or more server profiles UI screen Rest API resource Server Hardware TypesEnclosure-groups Enclosure groupsEnclosure types Server-hardwareExactly one enclosure group Zero or more power delivery devicesEnclosures Interconnect typesInterconnect-types InterconnectsLogical-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-downlinksUplink-sets NetworksNetwork sets Zero or one uplink set per logical interconnectDomains DomainsAppliance Network-setsRelationship to other resources Resources related data center facilitiesData centers RacksZero or more unmanaged devices Power delivery devicesPower-devices Unmanaged devicesRest 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 applianceAuthentication for appliance access Creating a login sessionCreating a login session Specifying user accounts and roles Controlling access for authorized usersProtecting credentials Understanding the audit logMessage Resource categoryUnderstanding the audit log Overview Appliance access over SSLExample 1 Sample audit entries user login and logout Managing certificates from a browserManaging certificates from a browser Using a certificate authorityVerifying a certificate Downloading and importing a self-signed certificateSSL connection PasswordsBrowser best practices for a secure environment Nonbrowser clientsRequired ports Access to the appliance consoleSwitching from one console to another Ports needed for HP OneViewSSL see Enabling or disabling authorized services accessRestricting console access Algorithms for securing the applianceDownloads from the appliance Downloads from the appliancePage Browsers Required plug-ins and settingsCommonly used browser features and settings Navigating the graphical user interfaceSet 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 topographyBanner and main menu About the Activity sidebarButton functions Help sidebar Filters sidebarUI buttons Oneviewcommunity online Icon descriptionsDisplay details Status and severity iconsUser control icons Large icon Small icon Resource Activity Task CriticalInformational icons Map view screen detailsNotifications area Notifications areaSearch help topics Log out of the applianceAbout help system search results Search resourcesNameenclosure10 name192.0.2.0, PDU Error Unknown DisabledView resources according to their health status Advanced searching and filtering with propertiesView 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 CreateResource model format Log in to the appliance using Rest APIsReturn codes URI formatTask resource Error handlingConcurrency control using etags Asynchronous versus synchronous operationsState 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 helpDownloading Html help and Rest API files Where to find HP OneView documentationAccessing documentation and help HP OneView documentationPart 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 usersReviewing 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 EnclosuresServer 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 overviewFibre Channel Local authenticationDirectory-based authentication EthernetConfiguration step Required action or input Configuration step Add power devices to the appliance Page Resource Task Description Networks Add the network ProcessServer Profiles Hardware Resource TaskPage Checklist connecting a server blade to a data center network Page Resource Task Enclosures ProcessIt to the server Resource Task Logical Create a logical InterconnectGroups Enclosure Server Profiles Do one Following Hardware Create a serverEnter 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 resourcesRoles 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 iLOsLearning more Interconnects Data center switch port requirementsManaging networks and network resources Managing Fibre Channel networks SANsTasks Managing Ethernet networksAbout network connectivity RolesFibre Channel network types About Fibre Channel networksAbout network connectivity Direct attach Fibre Channel networks Fabric attach Fibre Channel networksEthernet networks and network sets About Ethernet networksAbout network sets Fibre Channel networks and FCoENetwork set details About interconnects Managing enclosure interconnect hardwareManaging enclosure interconnect hardware About unsupported interconnects Interconnects Networking featuresLearning more Connectivity and synchronization with the applianceAbout logical interconnects Server Blade Logical Interconnect Uplink setsStacking health Stacking modesAdding a logical interconnect Deleting a logical interconnect About logical interconnect groupsLogical Interconnect Group a About Snmp settingsInterconnect 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 groupsManaging enclosures and enclosure groups TasksAbout enclosures Connectivity and synchronization with the applianceEffects 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 firmwareUnsupported firmware for server profiles Firmware update processRoles and Tasks Unsupported firmware for enclosuresOption Best practices for firmwareBest practice First step Upload the latest current SPP Best practice Troubleshooting firmware bundlesManaging power Managing power and temperatureAbout power delivery devices About racks Managing power and temperatureManaging temperature Managing temperatureDefault data center Datacenter Default rack placementAbout 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 typesRestores Administrator BackupsGlobal settings Login sessionsAbout directory service authentication About authentication settingsManaging user passwords Managing user passwordsResetting the administrator password Reset the administrator passwordBacking up an appliance Overview of the backup processBackup file name BackupsCreate 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 file152 How the appliance handles an unexpected shutdown Managing the applianceManaging appliance availability Best practices for managing a VM applianceRestart the appliance Appliance recovery operationsWhat to do when an appliance restarts Shut down the applianceAbout 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 poolsTasks Managing SSL certificatesManaging the HP public key RolesLicenses Managing licensesDownloading audit logs Audit-logsLicense reporting About licensingLicense types License deliveryView 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 scenariosLicensing scenarios Updating the applianceAppliance/firmware How the appliance handles unsupported hardware About unsupported and unmanaged hardwareHow the appliance handles unsupported hardware About unmanaged devices166 Part V Monitoring 168 Activities Monitoring data center status, health, and performanceDaily monitoring Initial check the DashboardGeneral health monitoring steps Monitor data center temperatureBest practices for monitoring data centers Best practices for monitoring health with the appliance UIOverall health monitoring Best practices for monitoring health using Rest APIsServer hardware health monitoring Network health monitoringGet the associated events Get a specific alert using the alert IDGET /rest/alerts GET /rest/alerts/idManaging activities Managing activitiesAbout activities GET /rest/logical-interconnects/idTask type Description User Activity types alerts and tasksAbout alerts About tasksActivity statuses Activity statesDashboard screen details Using the Dashboard screenHow to interpret the Dashboard graphs About the DashboardStatus icons Disabled or UnknownMonitoring 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 resourceManipulating the view of the data center visualization Monitoring power and temperatureAbout the Utilization panel Monitoring power and temperature utilizationAbout utilization graphs Utilization metric Resource Enclosures Power Delivery Devices Server HardwareUtilization statistics gathered by resource Utilization graphsPower utilization metrics Prerequisites Rest API power and temperature monitoringUpdate enclosure power capacity settings Update server hardware power capacity settingsCreate and download the Amqp client certificate Using the State-Change Message Bus ScmbGET /rest/certificates/client/rabbitmq/keypair/default Connect to the ScmbUsing the State-Change Message Bus Scmb Set up a queue to connect to the HP OneView Scmb exchangeSample queues Json structure of message received from the ScmbChangeType values NET C# code exampleExample 2 Json example NET C# code example Additional example-specific prerequisitesExamples Java code example Java code exampleExample 5 Java code example Python code examplePython code example Example 6 Python code example pikaExample 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 errorsRecommendation Details When VM host is down or nonresponsiveCreate a support dump file Creating a support dump fileGET /rest/appliance/support-dumps/file name Creating a support dump using Rest APIs Create support dumpPost /rest/appliance/support-dumps Download the support dump fileUnexpected appliance shutdown Troubleshooting the applianceFirst time setup Appliance cannot access the networkInsufficient time Appliance update is unsuccessfulSupport dump file creation action fails Certificate action failsAppliance network is down Backup file creation, download, or restore action failsBackup file creation is still in progress Backup file is incompatibleRestart or shutdown failure Profile operation was running during the backupRestore operation fails or times out Internal server errorReinstall 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 vcmodeRestart interconnect N Incorrect credentials Troubleshooting firmware bundlesCertificate Error Add server blade is unsuccessfulTroubleshooting licensing Troubleshooting interconnectsLicense assigned does not match the type specified Troubleshooting logical interconnects27.9.1 I/O bay occupancy errors Uplink set warnings or errorsNetwork create operation is unsuccessful Troubleshooting networksTroubleshooting server hardware Physical interconnect warnings and errorsIs claimed by that software Cannot control power on server bladeServer 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 configurationIncorrect privileges Troubleshooting user accountsUnauthenticated user or group Profile operations failInaccurate credentials Directory service not availableCannot add directory service User public key is not acceptedCannot 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 serviceSee also Post-restoration tasks Restoring an appliance from a backup fileRestore operation overview RestoresRestoring an appliance from a backup file Preparing to restore an applianceRestore an appliance from a backup file Restore an appliance from a backup filePost-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 filePost-restoration tasks Preventing duplicate IDs on the network after a restore226 Get connected to the HP OneView online user forum How to contact HPSoftware technical support and software updates Support and other resourcesSupport and other resources Using your software technical support and update serviceRelated information Documentation Product websitesDocsfeedback@hp.com Submit documentation feedbackFor UI and Rest API help For user guides and other manuals230 Tasks you can perform without data center hardware Tasks you can perform without data center hardwareInformation about the sample data center Sample data center hardwareEnclosure ILOAdminOAAdmin Rack mount serverFibre 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 valuesPlanning for network sets Planning the configurationPlanning for users and roles Workflow Installing the appliancePlanning resource names AssumptionsConfiguring 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 networksConfiguring the network sets Page Creating the logical interconnect group Creating a logical interconnect group and its uplink setsCreating 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 hosts172.18.1.12 Address Enclosures PasswordAdding the enclosure Viewing the server hardware typesView 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 SecondaryAttribute 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 Encl2Device 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 console270 Sample script Backup and restore script examplesSample backup script Sample backup scriptBackup and restore script examples Example 8 Sample backup.ps1 scriptSample 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 Eula295 Scmb see State-Change Message BusStatus icon, 62 storage system website Logical interconnect, 125 State-Change Message Bus297 Vlan ID