Manuals / HP / Computer Equipment / Software

HP OneView manual Java code example

Models: OneView

1 297

Download 297 pages 36.02 Kb

Page 191

NOTE: .Net C# code example 2 (Microsoft Windows certificate store) is referencing the Trusted Root Certificate Authorities store, located under Local Computer.

•StoreName.Root = Trusted Root Certificate Authorities

•StortLocation.LocalMachine = Local Computer

26.5Java code example

The Java code example shows how to connect and subscribe to the SCMB.

Prerequisites

1.Download the client certificate and private key.

GET /rest/certificates/client/rabbitmq/keypair/default

2.Save the contents of the client certificate in the response body into a text file named default-client.crt.

You must copy and paste everything from -----BEGINCERTIFICATE-----to -----ENDCERTIFICATE-----, including the dashes, but not including the quotes.

3.Save the contents of the private key in the response body into a text file named default-client.key.

You must copy and paste everything from -----BEGIN RSA PRIVATE KEY-----to

-----END RSA PRIVATE KEY-----, including the dashes, but not including the quotes.

4.Create a PKCS12 keystore from the private key and the public certificate.

openssl pkcs12 -export -name myclientcert -in default-client.crt -inkey default-client.key -out myclient.p12

5.Convert the PKCS12 keystore into a JKS keystore.

keytool -importkeystore -destkeystore c:\\MyKeyStore -srckeystore myclient.p12 -srcstoretype pkcs12 -alias myclient

26.5 Java code example 191

Image 191

HP OneView manual Java code example

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 changesManaging networks and network resources 115 An HP 3PAR Storage System 105107 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 185231 Restoring an appliance from a backup file 221Support and other resources 227 Index 293 Using the virtual appliance console 269Backup and restore script examples 271 Part I Learning about HP OneView Page HP OneView for converged infrastructure management Learning about HP OneViewHP OneView for converged infrastructure management ArchitectureLearning about HP OneView Hardware and software provisioning featuresOne tool and one data set-one view Expert design with consistent deployment Hardware and software provisioning featuresServer profiles Groups, templates, and setsTypes of groups and sets Define configurations for specific environmentsFlexibility in design and deployment Streamlined process for bringing hardware under managementOperating system 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 featuresAlert and health management Data center environmental managementResource utilization monitoring Backup and restore features Backup and restore featuresSpecialized user role for creating backup files Recovery from catastrophic failuresAvailability features Security featuresRest APIs-automation and integration Graphical and programmatic interfacesUser interface-efficiency and simplicity by design Convenient licensing model Integration with other HP management softwareOpen integration 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 ,Logical-interconnect-groups Logical interconnectsUI screen Rest API resource Logical 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 applianceCreating a login session Creating a login sessionAuthentication for appliance access Specifying user accounts and roles Controlling access for authorized usersProtecting credentials Understanding the audit logUnderstanding the audit log Resource categoryMessage 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 US or metric units of measurement About the graphical user interfaceSet the browser for US or metric units of measurement About the graphical user interface Screen topographyButton functions About the Activity sidebarBanner and main menu UI buttons Filters sidebarHelp sidebar 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 operationsDeveloper tools in a web browser Querying resources using common Rest API parametersState Change Message Bus 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 Security planning Planning your data center resourcesHow many data centers? Choosing a policy for the audit log Determining your backup policyChoosing a security certificate policy Determining roles and restrictions for authorized usersPlanning your resource names Preparing your data center network switchesReviewing your firewall access Resource name Planning the appliance configurationAppliance VM and host requirements 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 EnclosuresAdding a network Planning for configuration changesServer profiles and server hardware 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 Attach network Resource Task Description Networks Add the FibreSets for the Direct 107 Resource Task Server Hardware Add the server usingRest APIs for 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 resourcesTasks for server profiles Prerequisites for bringing server hardware under managementRoles 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 RolesAbout network connectivity About Fibre Channel networksFibre Channel network types 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 Managing enclosure interconnect hardware Managing enclosure interconnect hardwareAbout interconnects About unsupported interconnects Interconnects Networking featuresLearning more Connectivity and synchronization with the applianceAbout logical interconnects Server Blade Logical Interconnect Uplink setsAdding a logical interconnect Stacking modesStacking health 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 applianceAbout enclosure groups About enclosure groupsEffects of managing an enclosure 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 enclosuresBest practice First step Upload the latest current SPP Best practices for firmwareOption Best practice Troubleshooting firmware bundlesAbout power delivery devices Managing power and temperatureManaging power About racks Managing power and temperatureManaging temperature Managing temperatureDefault data center Datacenter Default rack placementAbout utilization graphs About user accounts Managing users and authenticationReset the administrator password 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 BackupsBacking up an appliance Guidelines for creating a backup fileCreate and download a backup file 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 applianceRestarting the appliance Managing the appliance settingsAbout appliance Snmp settings 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 deliveryLicense graph colors Server hardware licensingView license status Enclosure licensing policy behavior Licensed featuresServer blade licensing at the enclosure level 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 utilization graphs Monitoring power and temperature utilizationAbout the Utilization panel 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 ScmbExample 2 Json example NET C# code exampleChangeType values 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 Re-create the Amqp client certificate Re-create the Amqp client certificateDelete /rest/certificates/ca/rabbitmqreadonly 196 Part VI Troubleshooting 198 199 TroubleshootingCategory 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 software VM does not restart when VM host time is manually setReinstall the remote console 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 bladeTroubleshooting server profiles Troubleshooting server profilesServer profile is not created or updated correctly 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 for the SAN fabrics Data center networksFibre Channel networks Storage system SAN a and SAN B Fibre Channel network configurationsSwitches in the data center Production networks Ethernet NetworksNetworks for vMotion and virtual machine management Development networks Planning the configurationPlanning for installation of the appliance Ethernet network configuration valuesPlanning for users and roles Planning the configurationPlanning for network sets Workflow Installing the appliancePlanning resource names AssumptionsCopying the template server profile to eight servers Configuring the networks and network setsConfiguring the Fibre Channel SAN networks 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 TestUS ProdUSDevUS 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 SecondaryRequested bandwidth Boot Not bootableAttribute Value Device type Fibre Channel Network Page Esx02 Encl1, bay Esx03 Esx04 Esx05 Esx06 Esx07 Esx08 Copying the template server profile to eight serversName Server hardware Creating the Flat SAN networks 172.18.1.14 Address Page Page Enclosure group name Creating the server profileEnclosure name Encl2FlatSAN a Requested bandwidth Default value FlexNICDevice type Fibre Channel Network FlatSAN B Page Assumptions Viewing information about the server Powering on the serverAdding the server hardware 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 293 Host, security access, 80 initial configurationIndex Index Eula295 Scmb see State-Change Message BusStatus icon, 62 storage system website Logical interconnect, 125 State-Change Message Bus297 Vlan ID