HPE XP8 Storage

Application Version and Upgrade Details


Application Version	Bug fixes / Enhancements
1.0.0	Initial SDK2.0 application Discovery and Monitoring Implementations.

Introduction

The HP Storageworks XP (XP = eXtended Platform) is a computer data storage disk array sold by Hewlett Packard Enterprise using Hitachi Data Systems hardware and adding their own software to it. It’s based on the Hitachi Virtual Storage Platform and targeted towards enabling large scale consolidation, large database, Oracle, SAP, Exchange, and online transaction processing (OLTP) environments.

Key benefits

It discovers the HPE XP8 components.
Publishes relationships between resources to have a topological view and ease of maintenance.
Provides metrics related to job scheduling time and status etc..
Concern alerts will be generated for each metric to notify the administrator regarding the issue with the resource

Resource Hierarchy

XP Storage Array

-LDEVs

-Drives

-parity-groups

-Pools

-clprs

Supported Metrics

Click here to view the supported metrics

Native Type	Metric Name	Units	Application Version	Description
Storage Array	hpe_xp8_storage_array_internal_free_space	kB	1.0.0	The amount of free space in which users can create in internal volumes
	hpe_xp8_storage_array_internal_used_space_percentage	%	1.0.0	Amount of space used in internal volumes
	hpe_xp8_storage_array_external_used_space_percentage	%	1.0.0	Amount of space used in external volumes
	hpe_xp8_storage_array_external_free_space	kB	1.0.0	The amount of free space in which users can create in external volumes
	hpe_xp8_storage_array_total_used_space_percentage	%	1.0.0	Amount of space used in external volumes
	hpe_xp8_storage_array_total_free_space	kB	1.0.0	Total amount of free space in which users can create volumes in
	hpe_xp8_storage_array_total_efficiency_ratio		1.0.0	The total efficiency of the entire storage system
	hpe_xp8_storage_array_compression_ratio		1.0.0	The efficiency of capacity saving performed by using the capacity saving function (dedupe and compression) or capacity expansion
	hpe_storage_array_xp_provisioningRate	%	1.0.0	The percentage (%) of saving efficiency for consumption of capacity achieved by using Thin Provisioning to virtualize capacity
	hpe_xp8_storage_array_controller_status		1.0.0	Status of the controller ◦ Normal ◦ Warning ◦ Blocked ◦ Failed
	hpe_xp8_storage_array_controller_temperature	C	1.0.0	Temperature of the controller
	hpe_xp8_storage_array_system_powerConsumption	Watt	1.0.0	Power consumption of the storage system
	hpe_xp8_storage_array_cacheMemorySummary		1.0.0	The attribute related to summary information about the cache memory, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_sharedMemorySummary		1.0.0	The attribute related to summary information about the shared memory, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_bkmfSummary		1.0.0	The attribute related to summary information about the backup module, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_dkcpsSummary		1.0.0	The attribute related to summary information about the DKCPS, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_driveBox_PowerSupply_status		1.0.0	Attributes related to summary information about the drive box, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_driveBoxSummary_fanStatus		1.0.0	Attributes related to summary information about the drive box Fan status, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_driveBoxSummary_driveStatus		1.0.0	Attributes related to summary information about the drive box Drive status, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_driveBoxSummary_environmentStatus		1.0.0	Attributes related to summary information about the drive box Env status, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_xPathSummary		1.0.0	The attribute related to summary information about the X-path, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_processorSummary		1.0.0	The attribute related to summary information about the processor, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
	hpe_xp8_storage_array_batterySummary		1.0.0	The attribute related to summary information about the battery, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
ldevs	hpe_xp8_ldev_status		1.0.0	Status of the LDEV NML: The LDEV is in normal status. BLK: The LDEV is blocked. BSY: The LDEV status is being changed. Unknown: The LDEV status is unknown (not supported) .
	hpe_xp8_numOfUsedBlock	count	1.0.0	Number of blocks used in the pool.
	hpe_xp8_ldev_blockCapacity	GB	1.0.0	Block capacity of LDEV
pools	hpe_xp8_pool_status		1.0.0	POLN: Normal (Pool Normal) POLF: The pool is in the overflow status exceeding the threshold. (Pool Full) POLS: The pool is in the overflow status exceeding the threshold and is suspended. (Pool Suspend) POLE: The pool is suspended in the failure status. (Pool failure)
	hpe_xp8_usedCapacityRate	%	1.0.0	Usage rate of logical capacity (%)
	hpe_xp8_pool_usedPhysicalCapacityRate	%	1.0.0	Usage rate of physical capacity
	hpe_xp8_pool_availableVolumeCapacity	MB	1.0.0	Free logical capacity
	hpe_xp8_pool_availablePhysicalVolumeCapacity	MB	1.0.0	Free physical capacity
	hpe_xp8_pool_totalPoolCapacity	MB	1.0.0	total logical capacity
	hpe_xp8_pool_totalPhysicalCapacity	MB	1.0.0	Total physical capacity
	hpe_xp8_pool_virtualVolumeCapacityRate		1.0.0	The maximum subscription limit of a virtual volume relative to pool capacity
	hpe_xp8_pool_totalLocatedCapacity	MB	1.0.0	Total capacity of the THP/Smart volumes mapped to the pool
	hpe_xp8_pool_totalReservedCapacity	MB	1.0.0	Total capacity of the reserved page (MB) of the THP/Smart volume that is related to the THP/Smart pool
clprs	hpe_xp8_clpr_cacheMemoryCapacity	MB	1.0.0	Cache size
	hpe_xp8_clpr_cacheMemoryUsedCapacity	MB	1.0.0	Used cache size
	hpe_xp8_clpr_writePendingDataCapacity	MB	1.0.0	Amount of data waiting to be written
	hpe_xp8_clpr_cacheUsageRate	%	1.0.0	Cache usage rate
	hpe_xp8_clpr_writePendingDataRate	%	1.0.0	Rate of data waiting to be written
	hpe_xp8_clpr_cacheUsageRate	%	1.0.0	Cache usage rate
drives	hpe_xp8_drives_status		1.0.0	NML: Normal WAR: Part of the drive is blocked CPY: Copying is in progress CPI: Copying is incomplete RSV: The spare drive cannot be used FAI: The drive is blocked because of a failure BLK: The drive is blocked because maintenance is being performed Unknown or UNK: The status is unknown
parity-group	hpe_xp8_pg_usedCapacityRate	%	1.0.0	Usage rate of the parity group
parity-group	hpe_xp8_pg_availableVolumeCapacity	GB	1.0.0	Available capacity

Default Monitoring Configurations

HPE XP8 has default Global Device Management Policies, Global Templates, Global Monitors and Global Metrics in OpsRamp. You can customize these default monitoring configurations as per your business requirement by cloning respective Global Templates and Global Device Management Policies. It is recommended to clone them before installing the application to avoid noise alerts and data.

Default Global Device Management Policies
You can find the Device Management Policy for each Native Type at Setup > Resources > Device Management Policies. Search with suggested names in global scope:
{appName nativeType - version}
Ex: hpe-xp8 HPE Storage Array - 1 (i.e, appName = hpe-xp8 , nativeType = HPE Storage Array, version = 1)
Default Global Templates
You can find the Global Templates for each Native Type at Setup > Monitoring > Templates. Search with suggested names in global scope. Each template adheres to the following naming convention:
{appName nativeType 'Template' - version}
Ex: hpe-xp8 HPE Storage Array Template - 1 (i.e, appName = hpe-xp8 , nativeType = HPE Storage Array, version = 1)
Default Global Monitors
You can find the Global Monitors for each Native Type at Setup > Monitoring > Monitors. Search with suggested names in global scope. Each Monitors adheres to the following naming convention:
{monitorKey appName nativeType - version}
Ex: HPE XP8 Array Monitor hpe-xp-storage HPE XP8 Storage Array 1 (i.e, monitorKey = HPE Storage Array Monitor , appName = hpe-xp8, nativeType = HPE Storage Array, version = 1)

Configure and Install the HPE XP Storage Integration

From All Clients, select a client.
Navigate to Setup > Account.
Select the Integrations tab.
The Installed Integrations page, where all the installed integrations are displayed. Click + ADD on the Installed Integrations page.
If you do not have any installed applications, you will be navigated to the Available Integrations page. The Available Integrations page displays all the available applications along with the newly created application with the version.
Note: Search for the application using the search option available. Alternatively, use the All Categories option to search.
Click ADD in the HPE XP8 application.
Note: Select the version from the drop down menu.
In the Configurations page, click + ADD. The Add Configuration page appears.
Enter the following BASIC INFORMATION:

Field Name	Description
Name	Enter the name for the configuration.
IP Address/Host Name of HPE XP Storage Array	IP Address/Host Name for the HPE XP Storage.
API Port	API Port Note: By default port is 443.
HPE XP Storage Array Credential	Select the Credential from the drop-down list. (Optional): Click + Add to create a credential. The ADD CREDENTIAL window is displayed. Enter the following information. Name: Credential name. Description: Brief description of the credential. User Name: User name. Password: Password. Confirm Password: Confirm password

Notes:

By default the Is Secure checkbox is selected.
Ip Address/Host Name and Port should be accessible from Gateway.
Notification: Notes:
- By default False is selected.
- If you select TRUE, application will handle Critical/Recovery failure alert notifications for Connectivity, Authentication Exceptions.

Select the following Custom Attribute:


Field Name	Description
Custom Attribute	Select the custom attribute from the drop down list box.
Value	Select the value from the drop down list box.

Note: The custom attribute that you add here will be assigned to all the resources that are created by the integration. You can add a maximum of five custom attributes (key and value pair).

In the RESOURCE TYPE section, select:
- ALL: All the existing and future resources will be discovered.
- SELECT: You can select one or multiple resources to be discovered.
In the DISCOVERY SCHEDULE section, select recurrence pattern to add one of the following patterns:
- Minutes
- Hourly
- Daily
- Weekly
- Monthly
Click ADD.

Now the configuration is saved and displayed on the configurations page after you save it.
Note: From the same page, you may Edit and Remove the created configuration.

Under the ADVANCED SETTINGS, Select the Bypass Resource Reconciliation option, if you wish to bypass resource reconciliation when encountering the same resources discovered by multiple applications.
Note: If two different applications provide identical discovery attributes, two separate resources will be generated with those respective attributes from the individual discoveries.
Click NEXT.
(Optional) Click +ADD to create a new collector. You can either use the pre-populated name or give the name to your collector.
Select an existing registered profile.

Click FINISH.

The integration is installed and displayed on the INSTALLED INTEGRATION page. Use the search field to find the installed integration.

Modify the Configuration

See Modify an Installed Integration or Application article.
Note: Select HPE XP8.

View the HPE XP8 Details

To discover resources for HPE XP8 Storage:

Navigate to Infrastructure > Search > DATABASES > HPE XP8. The HPE XP page is displayed.
Select the application on the HPE XP8 page
The RESOURCE page appears from the right.
Click the ellipsis (…) on the top right and select View Details.

Navigate to the Attributes tab to view the discovery details.

Click the Metrics tab to view the metric details for HPE XP8.

View resource metrics

To confirm HPE XP8 monitoring, review the following:

Metric graphs: A graph is plotted for each metric that is enabled in the configuration.
Alerts: Alerts are generated for metrics that are configured as defined for integration.

Supported Alert Custom Macros

Customize the alert subject and description with the following macros so that it can generate alerts accordingly.
Supported macros keys:

Click here to view the alert subject and description with macros

${resource.name}

${resource.ip}

${resource.mac}

${resource.aliasname}

${resource.os}

${resource.type}

${resource.dnsname}

${resource.alternateip}

${resource.make}

${resource.model}

${resource.serialnumber}

${resource.systemId}

${parent.resource.name}

${Custom attributes on the resource}

Resource Filter Input keys

HPE XP8 application Resources are filtered and discovered based on below keys.

Note: You can filter the resources with the discoverable keys only.

Click here to view the Supported Input Keys

Resource Type	Keys
All Types	resourceName
	hostName
	aliasName
	dnsName
	ipAddress
	macAddress
	os
	make
	model
HPE XP Storage	dkcMicroVersion
HPE XP LDEV	clprId
	ssid
	emulationType
HPE XP POOL	blockingMode
HPE XP POOL	poolType
HPE XP Parity Group	raidType
	type
	raidLevel
HPE XP Drive	driveType
HPE XP Drive	driveTypeName

Risks, Limitations And Assumptions

The integration can manage critical/recovery failure alerts for the following two scenarios when the user activates App Failure Notifications in the settings:
- Connectivity Exception
- Authentication Exception
HPE XP8 will send any duplicate/repeat failure alert notification for every 6 hours.
Using metrics for monitoring the resources and generating alerts when the threshold values are breached.
HPE XP8 control monitoring pause/resume actions based on above alerts.
HPE XP8 supports only Classic GW and NextGen Gateway. Not supported with Cluster GW.
Component level thresholds can be configured on each resource level.
No support of showing activity log and applied time.