NET C# code example, ChangeType values | HP OneView specs

ChangeType values

ChangeType value	Description
Created	The resource is created or is added to HP OneView.
Updated	The resource state, attributes, or both are updated.
Deleted	The resource is permanently removed from HP OneView.

Example 2 JSON example

{

"resourceUri" : "/rest/enclosures/123xyz",

"changeType" : "Created",

"newState" : "Managed",

"eTag" : "123456",

"timestamp" : "2013-07-10T18:30:44Z",

"newSubState" : "null",

"resource" : {

"category" : "enclosures",

"created" : "2013-07-10T18:30:00Z",

...

},

"associatedTask" : "/rest/tasks/4321",

"userInitiatedTask" : "true",

"changedAttributes" : [],

"data" : {},

}

26.4 .NET C# code example

The .NET C# code examples show how to connect and subscribe to the SCMB. In addition to completing the prerequisites, you must complete the example-specific prerequisites before using the .NET C# code examples.

Prerequisites

Before you can use the .Net C# code examples, you must add the CA root certificate, the client certificate, and the private key to the Windows certificate store.

1.Download the root CA certificate.

GET /rest/certificates/ca

2.Save the contents in the response body into a text file named rootCA.crt. You must copy and paste everything from -----BEGINCERTIFICATE-----to -----ENDCERTIFICATE-----, including the dashes, but not including the quotes.

3.Import the rootCA.crt file into the Windows certificate store under Trusted Root Certification Authorities.

4.Download the client certificate and private key.

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

5.Save the contents of the client certificate and private key in the response body into a text file named scmb.crt.

You must copy and paste everything from -----BEGINCERTIFICATE-----to -----ENDCERTIFICATE-----for the client certificate. Next, copy and paste everything from

-----BEGIN RSA PRIVATE KEY----- to -----END RSA PRIVATE KEY----- for the private key. You must include the dashes, but do not include the quotes.

188 Using the State-Change Message Bus (SCMB)

Image 188

HP OneView manual NET C# code example, ChangeType values, Example 2 Json example

Contents

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 helpPlanning for configuration changes II Planning tasks Planning your data center resources Managing networks and network resources 115 An HP 3PAR Storage System 105107 Managing power and temperature 139 Managing users and authentication 143Managing 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 231 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 Learning about HP OneView HP OneView for converged infrastructure managementArchitecture HP OneView for converged infrastructure management Learning about HP OneView Hardware and software provisioning featuresOne tool and one data set-one view Hardware and software provisioning features Server profilesGroups, templates, and sets Expert design with consistent deployment Define configurations for specific environments Types of groups and sets Flexibility in design and deployment Streamlined process for bringing hardware under managementOperating system deployment Firmware and configuration change management features Monitoring and response featuresSimplified configuration change management Simplified firmware management Automatic configuration for monitoring Monitoring the environment and responding to issuesMonitoring and response features Isolated management network Alert and health management Data center environmental managementResource utilization monitoring Backup and restore features Specialized user role for creating backup filesRecovery from catastrophic failures Backup and restore features Security features Availability features Rest APIs-automation and integration Graphical and programmatic interfacesUser interface-efficiency and simplicity by design Convenient licensing model Integration with other HP management softwareOpen integration Networking features Networking featuresSupported networks Logical interconnects Network sets Resource model summary diagram Understanding the resource model Server profiles Connection templatesRelationship to other resources UI screens and Rest API resources Connections Server hardware typesConnection-templates Connections and server-profiles Server hardware Zero or more server profilesUI screen Rest API resource Server Hardware Types Server-hardware-types Enclosure groups Enclosure typesServer-hardware Enclosure-groups Zero or more power delivery devices EnclosuresInterconnect types Exactly one enclosure group Interconnects Interconnect-types Logical interconnect groups UI screen Rest API resources InterconnectsInterconnects , interconnect-types , Logical-interconnects Logical-interconnect-groups Logical interconnectsUI screen Rest API resource Logical Interconnect Groups Uplink sets UI screen Rest API resource Logical InterconnectsLogical-downlinks To a downlink Networks Network setsZero or one uplink set per logical interconnect Uplink-sets Domains ApplianceNetwork-sets Domains Resources related data center facilities Data centersRacks Relationship to other resources Power delivery devices Power-devicesUnmanaged devices Zero or more unmanaged devices UI screen Rest API resource Unmanaged Devices Unmanaged-devicesYou can view, add, or edit the properties Rest APIsPage Securing the appliance Understanding the security features of the applianceSecuring the appliance Understanding the security features of the appliance Best practices for maintaining a secure appliance Creating a login session Creating a login sessionAuthentication for appliance access Controlling access for authorized users Protecting credentialsUnderstanding the audit log Specifying user accounts and roles Understanding the audit log Resource categoryMessage Appliance access over SSL Example 1 Sample audit entries user login and logoutManaging certificates from a browser Overview Using a certificate authority Verifying a certificateDownloading and importing a self-signed certificate Managing certificates from a browser Passwords Browser best practices for a secure environmentNonbrowser clients SSL connection Access to the appliance console Switching from one console to anotherPorts needed for HP OneView Required ports Enabling or disabling authorized services access Restricting console accessAlgorithms for securing the appliance SSL see Downloads from the appliance Downloads from the appliancePage Required plug-ins and settings Commonly used browser features and settingsNavigating the graphical user interface Browsers Set US or metric units of measurement About the graphical user interfaceSet the browser for US or metric units of measurement Screen topography About the graphical user interface Button functions About the Activity sidebarBanner and main menu UI buttons Filters sidebarHelp sidebar Icon descriptions Oneviewcommunity online Status and severity icons User control iconsLarge 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 statusAdvanced searching and filtering with properties Nameenclosure10 name192.0.2.0, PDU Reset the health status view View resources according to their health statusPage Using the Rest APIs and other programmatic interfaces Resource operationsOperation Http Verb Create Resource data Log in to the appliance using Rest APIs Return codesURI format Resource model format Error handling Concurrency control using etagsAsynchronous versus synchronous operations Task resource Developer tools in a web browser Querying resources using common Rest API parametersState Change Message Bus Accessing documentation and help Online help-conceptual and task information as you need itThis user guide supplements the online help Rest API help design Where to find HP OneView documentation Accessing documentation and helpHP OneView documentation Downloading Html help and Rest API files Part II Planning tasks Page Security planning Planning your data center resourcesHow many data centers? Determining your backup policy Choosing a security certificate policyDetermining roles and restrictions for authorized users Choosing a policy for the audit log Planning your resource names Preparing your data center network switchesReviewing your firewall access Resource name Planning the appliance configurationAppliance VM and host requirements Planning for high availability Location of the applianceSeparate networks for data and management Time clocks and NTPPage Planning for configuration changes ApplianceEnclosures Interconnects and logical interconnects Adding a network Planning for configuration changesServer profiles and server hardware Adding an enclosure Page Part III Configuration quick starts Page Quick Start Initial Configuration Configure the environment for the first timeProcess overview Process overview Local authentication Directory-based authenticationEthernet 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 HardwarePage Checklist connecting a server blade to a data center network Page Process Resource Task Enclosures Resource Task Logical Create a logical Interconnect Groups EnclosureServer Profiles Do one Following Hardware Create a server It to the server Enter 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 hardware features supported by the appliance Managing servers and server profilesUI screens and Rest API resources Server-profiles and connections Tasks for server profiles Prerequisites for bringing server hardware under managementRoles Tasks for server hardware Tasks for server hardware typesEffects of managing server hardware iLOs Tasks for server hardware Learning more Data center switch port requirements Managing networks and network resourcesManaging Fibre Channel networks SANs Interconnects Managing Ethernet networks About network connectivityRoles Tasks About network connectivity About Fibre Channel networksFibre Channel network types Fabric attach Fibre Channel networks Direct attach Fibre Channel networks About Ethernet networks About network setsFibre Channel networks and FCoE Ethernet networks and network sets Network set details Managing enclosure interconnect hardware Managing enclosure interconnect hardwareAbout interconnects Interconnects Networking features Learning moreConnectivity and synchronization with the appliance About unsupported interconnects About logical interconnects Uplink sets Server Blade Logical Interconnect Adding a logical interconnect Stacking modesStacking health 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 enclosuresConnectivity and synchronization with the appliance Managing enclosures and enclosure groups About enclosure groups About enclosure groupsEffects of managing an enclosure 134 Managing firmware for managed devices About the appliance firmware repositoryAbout unsupported firmware Unsupported firmware for firmware bundles Firmware update process Roles and TasksUnsupported firmware for enclosures Unsupported firmware for server profiles Best practice First step Upload the latest current SPP Best practices for firmwareOption Troubleshooting firmware bundles Best practice About power delivery devices Managing power and temperatureManaging power Managing power and temperature About racks Managing temperature Default data center DatacenterDefault rack placement Managing temperature About utilization graphs About user accounts Managing users and authenticationReset the administrator password About user roles Action privileges for user rolesAppliance role types Action privileges for user roles Administrator Backups Global settingsLogin 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 nameBackups Backing up an appliance Backing up an appliance Guidelines for creating a backup fileCreate and download a backup file Creating and downloading a backup file Post /rest/backupsDownload the backup file GET /rest/backups/archive/backup URI 152 Managing the appliance Managing appliance availabilityBest practices for managing a VM appliance How the appliance handles an unexpected shutdown Appliance recovery operations What to do when an appliance restartsShut down the appliance Restart the appliance Restarting the appliance Managing the appliance settingsAbout appliance Snmp settings Managing the security features of the appliance Enabling or disabling HP support access to the applianceManaging addresses and ID pools Id-pools Managing SSL certificates Managing the HP public keyRoles Tasks Managing licenses Downloading audit logsAudit-logs Licenses About licensing License typesLicense delivery License reporting License graph colors Server hardware licensingView license status Enclosure licensing policy behavior Licensed featuresServer blade licensing at the enclosure level Rack mount server licensing Licensing and utilization statisticsLicensing scenarios Rack mount server licensing behavior Updating the appliance Licensing scenarios Appliance/firmware About unsupported and unmanaged hardware How the appliance handles unsupported hardwareAbout unmanaged devices How the appliance handles unsupported hardware 166 Part V Monitoring 168 Monitoring data center status, health, and performance Daily monitoringInitial check the Dashboard Activities Monitor data center temperature Best practices for monitoring data centersBest practices for monitoring health with the appliance UI General health monitoring steps Best practices for monitoring health using Rest APIs Server hardware health monitoringNetwork health monitoring Overall health monitoring Get a specific alert using the alert ID GET /rest/alertsGET /rest/alerts/id Get the associated events Managing activities About activitiesGET /rest/logical-interconnects/id Managing activities Activity types alerts and tasks About alertsAbout tasks Task type Description User Activity states Activity statuses Using the Dashboard screen How to interpret the Dashboard graphsAbout 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 overviewPower and temperature monitoring features by resource UI power and temperature monitoring Monitoring power and temperature Manipulating the view of the data center visualization About utilization graphs Monitoring power and temperature utilizationAbout the Utilization panel Enclosures Power Delivery Devices Server Hardware Utilization statistics gathered by resourceUtilization graphs Utilization metric Resource Power utilization metrics Rest API power and temperature monitoring Update enclosure power capacity settingsUpdate server hardware power capacity settings Prerequisites Using the State-Change Message Bus Scmb GET /rest/certificates/client/rabbitmq/keypair/defaultConnect 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 Example 2 Json example NET C# code exampleChangeType values 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 Re-create the Amqp client certificate Re-create the Amqp client certificateDelete /rest/certificates/ca/rabbitmqreadonly 196 Part VI Troubleshooting 198 199 TroubleshootingCategory Basic troubleshooting techniques About network setup errorsAbout reported serious errors Recommendation Details Look for a message When VM host is down or nonresponsive Create a support dump fileCreating a support dump file Recommendation Details Creating a support dump using Rest APIs Create support dump Post /rest/appliance/support-dumpsDownload the support dump file GET /rest/appliance/support-dumps/file name Troubleshooting the appliance First time setupAppliance cannot access the network Unexpected appliance shutdown Appliance update is unsuccessful Support dump file creation action failsCertificate action fails Insufficient time Backup file creation, download, or restore action fails Backup file creation is still in progressBackup file is incompatible Appliance network is down Profile operation was running during the backup Restore operation fails or times outInternal server error Restart or shutdown failure Reinstall the software VM does not restart when VM host time is manually setReinstall the remote console Troubleshooting enclosures and enclosures groups Add or remove enclosure is unsuccessfulClear vcmode Restart interconnect Restart interconnect N Troubleshooting firmware bundles Certificate ErrorAdd server blade is unsuccessful Incorrect credentials Troubleshooting interconnects Troubleshooting licensing Troubleshooting logical interconnects 27.9.1 I/O bay occupancy errorsUplink set warnings or errors License assigned does not match the type specified Troubleshooting networks Troubleshooting server hardwarePhysical interconnect warnings and errors Network create operation is unsuccessful Cannot control power on server blade Is claimed by that software Troubleshooting server profiles Troubleshooting server profilesServer profile is not created or updated correctly 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 resetInvalid configuration Verify the operational status of the server hardware Troubleshooting user accounts Unauthenticated user or groupProfile operations fail Incorrect privileges Directory service not available Cannot add directory serviceUser public key is not accepted Inaccurate credentials Cannot add server for a directory service Lost connection with directory service hostUser or group not configured in the directory service Cannot add directory user or group Restoring an appliance from a backup file Restore operation overviewRestores 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 applianceRestoring 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 updatesSupport and other resources Get connected to the HP OneView online user forum Using your software technical support and update service Related informationDocumentation Product websites Support and other resources Submit documentation feedback For UI and Rest API helpFor user guides and other manuals Docsfeedback@hp.com 230 Tasks you can perform without data center hardware Information about the sample data centerSample data center hardware Tasks you can perform without data center hardware ILOAdmin OAAdminRack mount server Enclosure Fibre 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 Planning the configuration Planning for installation of the applianceEthernet network configuration values Development networks Planning for users and roles Planning the configurationPlanning for network sets Installing the appliance Planning resource namesAssumptions Workflow Copying the template server profile to eight servers Configuring the networks and network setsConfiguring the Fibre Channel SAN networks 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 TestUS ProdUSDevUS Creating an enclosure group for vSphere ESXi hosts Click Create to create the logical interconnect group Enclosures Password Adding the enclosureViewing the server hardware types 172.18.1.12 Address Creating a server profile to use as a template Viewing server hardware typesEditing server hardware types View information about the server hardwarePage Attribute Value Device type Ethernet Network Esxi mgmtSecondary Esxi vmotion Requested 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 Creating the server profile Enclosure nameEncl2 Enclosure group name FlatSAN 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 Using the virtual appliance console Using the virtual appliance consoleUsing the virtual appliance console Key combinations for the virtual appliance console 270 Backup and restore script examples Sample backup scriptSample 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 293 Host, security access, 80 initial configurationIndex 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