Application Version and Upgrade Details

Application VersionBug fixes / Enhancements
1.0.0Initial 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 TypeMetric NameUnitsApplication VersionDescription
Storage Arrayhpe_xp8_storage_array_internal_free_spacekB1.0.0The amount of free space in which users can create in internal volumes
hpe_xp8_storage_array_internal_used_space_percentage%1.0.0Amount of space used in internal volumes
hpe_xp8_storage_array_external_used_space_percentage%1.0.0Amount of space used in external volumes
hpe_xp8_storage_array_external_free_spacekB1.0.0The amount of free space in which users can create in external volumes
hpe_xp8_storage_array_total_used_space_percentage%1.0.0Amount of space used in external volumes
hpe_xp8_storage_array_total_free_spacekB1.0.0Total amount of free space in which users can create volumes in
hpe_xp8_storage_array_total_efficiency_ratio1.0.0The total efficiency of the entire storage system
hpe_xp8_storage_array_compression_ratio1.0.0The efficiency of capacity saving performed by using the capacity saving function (dedupe and compression) or capacity expansion
hpe_storage_array_xp_provisioningRate%1.0.0The percentage (%) of saving efficiency for consumption of capacity achieved by using Thin Provisioning to virtualize capacity
hpe_xp8_storage_array_controller_status1.0.0Status of the controller ◦ Normal ◦ Warning ◦ Blocked ◦ Failed
hpe_xp8_storage_array_controller_temperatureC1.0.0Temperature of the controller
hpe_xp8_storage_array_system_powerConsumptionWatt1.0.0Power consumption of the storage system
hpe_xp8_storage_array_cacheMemorySummary1.0.0The attribute related to summary information about the cache memory, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_sharedMemorySummary1.0.0The attribute related to summary information about the shared memory, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_bkmfSummary1.0.0The attribute related to summary information about the backup module, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_dkcpsSummary1.0.0The attribute related to summary information about the DKCPS, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_driveBox_PowerSupply_status1.0.0Attributes related to summary information about the drive box, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_driveBoxSummary_fanStatus1.0.0Attributes related to summary information about the drive box Fan status, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_driveBoxSummary_driveStatus1.0.0Attributes related to summary information about the drive box Drive status, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_driveBoxSummary_environmentStatus1.0.0Attributes related to summary information about the drive box Env status, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_xPathSummary1.0.0The attribute related to summary information about the X-path, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_processorSummary1.0.0The attribute related to summary information about the processor, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
hpe_xp8_storage_array_batterySummary1.0.0The attribute related to summary information about the battery, Normal ,Service ◦ Moderate ◦ Serious ◦ Acute ◦ Unknown
ldevshpe_xp8_ldev_status1.0.0Status 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_numOfUsedBlockcount1.0.0Number of blocks used in the pool.
hpe_xp8_ldev_blockCapacityGB1.0.0Block capacity of LDEV
poolshpe_xp8_pool_status1.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.0Usage rate of logical capacity (%)
hpe_xp8_pool_usedPhysicalCapacityRate%1.0.0Usage rate of physical capacity
hpe_xp8_pool_availableVolumeCapacityMB1.0.0Free logical capacity
hpe_xp8_pool_availablePhysicalVolumeCapacityMB1.0.0Free physical capacity
hpe_xp8_pool_totalPoolCapacityMB1.0.0total logical capacity
hpe_xp8_pool_totalPhysicalCapacityMB1.0.0Total physical capacity
hpe_xp8_pool_virtualVolumeCapacityRate1.0.0The maximum subscription limit of a virtual volume relative to pool capacity
hpe_xp8_pool_totalLocatedCapacityMB1.0.0Total capacity of the THP/Smart volumes mapped to the pool
hpe_xp8_pool_totalReservedCapacityMB1.0.0Total capacity of the reserved page (MB) of the THP/Smart volume that is related to the THP/Smart pool
clprshpe_xp8_clpr_cacheMemoryCapacityMB1.0.0Cache size
hpe_xp8_clpr_cacheMemoryUsedCapacityMB1.0.0Used cache size
hpe_xp8_clpr_writePendingDataCapacityMB1.0.0Amount of data waiting to be written
hpe_xp8_clpr_cacheUsageRate%1.0.0Cache usage rate
hpe_xp8_clpr_writePendingDataRate%1.0.0Rate of data waiting to be written
hpe_xp8_clpr_cacheUsageRate%1.0.0Cache usage rate
driveshpe_xp8_drives_status1.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-grouphpe_xp8_pg_usedCapacityRate%1.0.0Usage rate of the parity group
hpe_xp8_pg_availableVolumeCapacityGB1.0.0Available 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.

  1. 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)

  2. 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)

  3. 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

  1. From All Clients, select a client.
  2. Navigate to Setup > Account.
  3. Select the Integrations tab.
  4. The Installed Integrations page, where all the installed integrations are displayed. Click + ADD on the Installed Integrations page.
  5. 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.
  6. Click ADD in the HPE XP8 application.
    Note: Select the version from the drop down menu.
  7. In the Configurations page, click + ADD. The Add Configuration page appears.
  8. Enter the following BASIC INFORMATION:
Field NameDescription
NameEnter the name for the configuration.
IP Address/Host Name of HPE XP Storage ArrayIP Address/Host Name for the HPE XP Storage.
API PortAPI Port

Note: By default port is 443.
HPE XP Storage Array CredentialSelect 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.
  1. Select the following Custom Attribute:
Field NameDescription
Custom AttributeSelect the custom attribute from the drop down list box.
ValueSelect 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).

  1. 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.
  2. In the DISCOVERY SCHEDULE section, select recurrence pattern to add one of the following patterns:
    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
  3. 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.

  1. 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.

  2. Click NEXT.

  3. (Optional) Click +ADD to create a new collector. You can either use the pre-populated name or give the name to your collector.

  4. Select an existing registered profile.

  1. 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

View the HPE XP8 Details

To discover resources for HPE XP8 Storage:

  1. Navigate to Infrastructure > Search > DATABASES > HPE XP8. The HPE XP page is displayed.
  2. Select the application on the HPE XP8 page
  3. The RESOURCE page appears from the right.
  4. Click the ellipsis () on the top right and select View Details.
  1. Navigate to the Attributes tab to view the discovery details.
  1. 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 TypeKeys
All TypesresourceName
hostName
aliasName
dnsName
ipAddress
macAddress
os
make
model
HPE XP StoragedkcMicroVersion
HPE XP LDEVclprId
ssid
emulationType
HPE XP POOLblockingMode
poolType
HPE XP Parity GroupraidType
type
raidLevel
HPE XP DrivedriveType
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.