Supported Target Versions |
---|
CLI commands used in the application are valid for all Eternus storage models. |
Tested on an Eternus model with product code "ET203 BU" with product name "Eternus DX200 S3" which belongs to the "Eternus DX" product family. |
Application Version and Upgrade Details
Application Version | Bug fixes / Enhancements |
---|---|
1.0.7 | Metric data point conversion changes |
1.0.6 |
|
1.0.5 | Added support for NativeType Display order changes and resource grouping by type in UI. |
Click here to view the earlier version updates
Application Version | Bug fixes / Enhancements |
---|---|
1.0.4 |
|
1.0.3 | Full discovery Support. |
1.0.2 | Bug fixes - changed the few commands to get the response. |
1.0.1 | Activity logger related changes. |
1.0.0 | Initial resource discovery and monitoring implementations. |
Introduction
Eternus storage systems is a family of compatible all flash and hybrid storage systems. Eternus AF all flash arrays offer practically unlimited storage performance. Eternus DX hybrid storage systems are designed to store large amounts of unstructured data using cost efficient hard disk capacities while allowing fast access via SSDs. Eternus AF and Eternus DX offer an outstanding family of systems that allow the digital world to achieve the ideal balance between cost , capacity and speed.
Key Use cases
Discovery Use cases
The device discovery enables customers with an unified way of showing all of the elements making up a Eternus storage device along with the relationships.
Monitoring Use cases
The device monitoring helps to collect the metric values with respect to time and sends alerts to the intended customer team to act up immediately in case of any threshold breach or unexpected metric behavior observed based on configurations. In a way it helps the customer with smooth functioning of business with minimal or zero downtime in case of any infrastructure related issues occurring.
Prerequisites
- OpsRamp Classic Gateway 14.0.0 and above.
- OpsRamp NextGen Gateway 14.0.0 and above.
Note: OpsRamp recommends using the latest Gateway version for full coverage of recent bug fixes, enhancements, etc.
Hierarchy of Eternus Storage
Eternus Storage
- Controller enclosure
- Front-end enclosure
- Drive enclosure
- Disk drive
- RAID Groups
- Volume
- Pool
Supported Metrics
Click here to view the supported metrics
Native Type | Metric Names | Display Name | Metric Label | Unit | Application Version | Description |
---|---|---|---|---|---|---|
Eternus Storage | eternus_storage_system_Status | Eternus Storage System Status | Availability | 1.0.0 | Eternus Storage System Status. Possible Values are Normal:0,Empty:1,Pinned Data:2,Unused:3,Warning:4,Maintenance:5,Error:6,Loop Down:7,Not Ready:8,Subsystem Down:9,Change Assigned CM:10 | |
eternus_storage_enclosure_Status | Eternus Storage Enclosure Status | Availability | 1.0.0 | Eternus Storage System Enclosure Status.Possible Values are Normal:0,Other:1 | ||
eternus_storage_port_link_Status | Eternus Storage Port Link Status | Availability | 1.0.0 | This metric represents Link status of SAS expander ports (the interfaces linking controllers and drive enclosures).Possible Values are Link Up:0,N/A:1,Link Down:2 | ||
Eternus Controller Enclosure | eternus_controller_enclosure_Status | Eternus Controller Enclosure Status | Availability | 1.0.0 | This metric displays the status of Eternus controller enclosure.Possible Values are Normal:0,Other:1. | |
eternus_controller_enclosure_intakeTemp_Status | Eternus Controller Enclosure Intake Temperature Status | Thermal | 1.0.0 | This metric displays CE intake temperature status.Possible Values are Normal:0,Other:1. | ||
eternus_controller_enclosure_exhaustTemp_Status | Eternus Controller Enclosure Exhaust Temperature Status | Thermal | 1.0.0 | This metric displays CE exhaust temperature status.Possible Values are Normal:0,Other:1 | ||
eternus_controller_enclosure_CM_Status | Eternus Controller Module Status | Availability | 1.0.0 | This metric displays the status of controller module of a controller enclosure.Possible values are Normal:0,Other:1. | ||
eternus_controller_enclosure_PSU_Status | Eternus Controller Enclosure PSU Status | Availability | 1.0.0 | This metric displays the status of power supply unit of a controller enclosure.Possible values are Normal:0,Other:1. | ||
eternus_controller_enclosure_Disk_Status | Eternus Controller Enclosure Disk Status | Availability | 1.0.0 | This metric displays the disk status of a controller enclosure.Possible Values are Available:0,Spare:1,Available(Predictive Failure):2,Present:3,Rebuild/Copyback:4,Broken:5,Not Available:6 | ||
eternus_controller_module_BusyRate | Eternus Controller Module Busy Rate | Performance | % | 1.0.0 | This metric displays the controller modules busy rate in percentage | |
eternus_controller_module_CopyResidualQuantity | Eternus Controller Module Copy Residual Quantity | Usage | MB | 1.0.0 | This metric displays the controller module copy residual quantity in MB | |
eternus_port_ReadIO | Eternus Port ReadIO | Performance | IOPS | 1.0.0 | This metric displays the read IO of eternus host interface port(FC or iSCSI) | |
eternus_port_WriteIO | Eternus Port WriteIO | Performance | IOPS | 1.0.0 | This metric displays the write IO of eternus host interface port(FC or iSCSI) | |
eternus_port_throughput_Read | Eternus Port Throughput Read | Performance | MBps | 1.0.0 | This metric displays the read throughput of eternus host interface port(FC or iSCSI) | |
eternus_port_throughput_Write | Eternus Port Throughput Write | Performance | MBps | 1.0.0 | This metric displays the write throughput of eternus host interface port(FC or iSCSI) | |
Eternus Frontend Enclosure | eternus_frontend_enclosure_Status | Eternus Frontend Enclosure Status | Availability | 1.0.0 | This metric displays the status of Frontend enclosure of eternus .Possible Values are Normal:0,Other:1. | |
eternus_frontend_enclosure_intakeTemp_Status | Eternus Frontend Enclosure Intake Temperature | Thermal | 1.0.0 | This metric displays the intake temperature status of frontend enclosure of eternus device.Possible values are Normal:0,Other:1. | ||
eternus_frontend_enclosure_exhaustTemp_Status | Eternus Frontend Enclosure Exhaust Temperature | Thermal | 1.0.0 | This metric displays the exhaust temperature status of Frontend enclosure of eternus device.Possible values are Normal:0,Other:1 | ||
eternus_frontend_enclosure_FRT_Status | Eternus Frontend Enclosure FRT Status | Availability | 1.0.0 | This metric displays the Front end Router status of Frontend enclosure of an eternus device.Possible values are Normal:0,Other:1. | ||
eternus_frontend_enclosure_SVC_Status | Eternus Frontend Enclosure SVC Status | Availability | 1.0.0 | This metric displays the service controller status of Frontend enclosure of an eternus device.Possible values are NOrmal:0,Other:1. | ||
eternus_frontend_enclosure_FanUnit_Status | Eternus Frontend Enclosure Fan Unit Status | Availability | 1.0.0 | This metric displays the FU status of Frontend enclosure of an eternus device.Possible values are Normal:0,Other:1. | ||
eternus_frontend_enclosure_Operationpanel_Status | Eternus Frontend Enclosure Operation Panel Status | Availability | 1.0.0 | This metric displays the operation panel status of Frontend enclosure of an eternus device.Possible values are Normal:0,Other:1. | ||
eternus_frontend_enclosure_PSU_Status | Eternus Frontend Enclosure PSU Status | Availability | 1.0.0 | This metric displays the power supply unit status of Frontend enclosure of an eternus device.Possible values are Normal:0,Other:1. | ||
Eternus Drive Enclosure | eternus_drive_enclosure_Status | Eternus Drive Enclosure Status | Availability | 1.0.0 | This metric displays the status of drive enclosure of a eternus device.Possible values are Normal:0,Other:1. | |
eternus_drive_enclosure_intakeTemp_Status | Eternus Drive Enclosure Intake Temperature | Thermal | 1.0.0 | This metric displays the intake temperature status of DE of an eternus device.Possible Values are Normal:0,Other:1. | ||
eternus_drive_enclosure_exhaustTemp_Status | Eternus Drive Enclosure Exhaust Temperature | Thermal | 1.0.0 | This metric displays the exhaust temperature status of a drive enclosure of eternus device.Possible values are Normal:0,Other:1. | ||
eternus_drive_enclosure_IOM_Status | Eternus Drive Enclosure IOM Status | Availability | 1.0.0 | This metric displays the status of I/O Module of a drive enclosure of eternus device.Possible values are Normal:0,Other:1 | ||
eternus_drive_enclosure_FEM_Status | Eternus Drive Enclosure FEM Status | Availability | 1.0.0 | This metric displays the status of Fan expander module of a DE of eternus device.Possible values are Normal:0,Other:1. | ||
eternus_drive_enclosure_PSU_Status | Eternus Drive Enclosure PSU Status | Availability | 1.0.0 | This metric displays the PSU status of a drive enclosure of eternus device.Possible values are Normal:0,Other:1. | ||
Eternus Disk Drive | eternus_drive_Status | Eternus Drive Status | Availability | 1.0.0 | This metric displays the status of disk drive of an eternus device.Possible Values are Available:0,Spare:1,Available(Predictive Failure):2,Present:3,Rebuild/Copyback:4,Broken:5,Not Available:6 | |
eternus_drive_HealthPct | Eternus Drive Health Percentage | Performance | % | 1.0.0 | This metric displays the health status of eternus disk drive in percentage | |
eternus_drive_BusyRate | Eternus Drive Busy Rate | Performance | % | 1.0.0 | This metric displays the busy rate of eternus disk drive in percentage | |
eternus_drive_mediaerror_Count | Eternus Drive Media Error Count | Availability | count | 1.0.0 | This metric displays the media error count of eternus disk drive | |
eternus_drive_driveerror_Count | Eternus Drive Error Count | Availability | count | 1.0.0 | This metric displays the drive error count of eternus disk drive | |
eternus_drive_driveRecoverederror_Count | Eternus Drive Recovered Error Count | Availability | count | 1.0.0 | This metric displays the drive recovered error count of eternus disk drive | |
eternus_drive_smartevent_Count | Eternus Drive Smart Event Count | Availability | count | 1.0.0 | This metric displays the smart event count of eternus disk drive | |
eternus_drive_IOTimeout_Count | Eternus Drive IO Timeout Count | Availability | count | 1.0.0 | This metric displays the IO Timeout count of eternus disk drive | |
eternus_drive_linkerror_Count | Eternus Drive Link Error Count | Availability | count | 1.0.0 | This metric displays the link error count of eternus disk drive | |
eternus_drive_checkcodeerror_Count | Eternus Drive Check Code Error Count | Availability | count | 1.0.0 | This metric displays the checkcode error count of eternus disk drive | |
Eternus RAID Group | eternus_raidgroup_status | Eternus Raid Group Status | Availability | 1.0.0 | This metric displays the status of RAID Group of an eternus device.Possible values are Available:0,Spare in Use:1,SED Locked:2 | |
eternus_raidgroup_UsedCapacity | Eternus RAID Group Used Capacity | Usage | MB | 1.0.0 | This metric displays the used capacity of eternus RAID Group in MB | |
eternus_raidgroup_Capacity_Utilization | Eternus RAID Group Capacity Utilization | Usage | % | 1.0.0 | This metric displays the capacity utilization of eternus RAID Group in percentage | |
Eternus Volume | eternus_volume_Status | Eternus Volume Status | Availability | 1.0.0 | This metric displays the status of volume of an eternus device.Possible Values are Available:0,Other:1 | |
Eternus Pool | eternus_thinprovisioning_Status | Eternus Thin Provisioning Status | Availability | 1.0.0 | This metric displays the thin provisioning enable status of an eternus device.Possible values are Enable:0,Disable:1 | |
eternus_thin_pro_pool_Status | Eternus Thin Provisioning Pool Status | Availability | 1.0.0 | This metric displays the status of thin provisioning pool in an eternus device.Possible values are Available:0,Other:1. | ||
eternus_thin_pro_pool_UsedCapacity | Eternus Thin Provisioning Pool Used Capacity | Usage | TB | 1.0.0 | This metric displays the used capacity of a TPP in eternus device | |
eternus_thin_pro_pool_Utilization | Eternus Thin Provisioning Pool Utilization | Usage | % | 1.0.0 | This metric displays the utilization of TPP in an eternus device |
Default Monitoring Configurations
Eternus has a default Global Device Management Policies, Global Templates, Global Monitors and Global Metrics in OpsRamp. Users can customize these default monitoring configurations as per your business use cases by cloning respective Global Templates and Global Device Management Policies. OpsRamp recommends doing this activity before installing the app to avoid noise alerts and data.
Default Global Device Management Policies
OpsRamp has a Global Device Management Policy for each Native Type of Eternus. You can find those Device Management Policies at Setup > Resources > Device Management Policies, search with suggested names in global scope. Each Device Management Policy follows below naming convention:
{appName nativeType - version}
Ex: eternus Eternus Storage - 1 (i.e, appName = eternus, nativeType = Eternus Storage, version = 1)
Default Global Templates
OpsRamp has a Global Template for each Native Type of Eternus. You can find those templates at Setup > Monitoring > Templates, search with suggested names in Global Scope. Each template follows below naming convention:
{appName nativeType 'Template' - version}
Ex: eternus Eternus Storage Template - 1 (i.e, appName = eternus, nativeType = Eternus Storage, version = 1)
Default Global Monitors
OpsRamp will have a Global Monitors for each Native Type which has monitoring support. You can find those monitors at Setup > Monitoring > Monitors, search with suggested names in global scope. Each Monitors follows below naming convention:
{monitorKey appName nativeType - version}
Ex: Eternus Storage Monitor eternus Eternus Storage 1(i.e, monitorKey = Eternus Storage Monitor, appName = eternus, nativeType = Eternus Storage, version = 1)
Configure and Install the Fujitsu ETERNUS Integration
- From All Clients, select a client.
- Go to Setup > Account.
- Select the Integrations and Apps tab.
- The Installed Integrations page, where all the installed applications are displayed.
Note: If there are no installed applications, it will navigate to the Available Integrations and Apps page. - Click + ADD on the Installed Integrations page. The Available Integrations and Apps page displays all the available applications along with the newly created application with the version.
Note: You can even search for the application using the search option available. Also you can use the All Categories option to search.
- Click ADD in the Fujitsu ETERNUS tile.
- In the Configurations page, click + ADD. The Add Configuration page appears.
- Enter the below mentioned BASIC INFORMATION:
Functionality | Description |
---|---|
Name | Enter the name for the configuration. |
Eternus IP Address/Host Name | Host name or the IP address provided from the installation. |
Eternus SSH Port | SSH Port information. Note: By default 22 is selected. |
Eternus Credentials | Select the credentials from the drop-down list. Note: Click + Add to create a credential. |
Notes:
- Eternus IP Address/Host Name and Eternus SSH Port should be accessible from Gateway.
- App Failure Notifications: if turned on, you will be notified in case of an application failure that is, Connectivity Exception, Authentication Exception.
- Select the below mentioned Custom Attribute:
Functionality | 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 by providing a name or use the pre-populated name.
- Select an existing registered profile.
- Click FINISH.
The application 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 the Fujitsu ETERNUS application.
View the Fujitsu Eternus details
The Fujitsu Eternus integration is displayed in the Infrastructure > Resources > Storage. You can navigate to the Attributes tab to view the discovery details, and the Metrics tab to view the metric details for Fujitsu Eternus.
Resource Filter Input keys
Click here to view the Supported Input Keys
Resource Type | Supported Input Keys |
---|---|
All Types | resourceName |
hostName | |
aliasName | |
dnsName | |
ipAddress | |
macAddress | |
os | |
make | |
model | |
serialNumber | |
Location | |
Eternus Storage | Cache Mode |
Device Identification Number | |
Operation Mode | |
Remote Support | |
Eternus Controller Enclosure | Type |
Eternus Drive Enclosure | Type |
Eternus Disk Drive | Size |
Speed (rpm) | |
Type | |
Usage | |
Eternus RAID Group | Assigned CM |
RAID Level | |
Eternus Volume | RG or TPP or FTRP Name |
RG or TPP or FTRP No. | |
Size(MB) | |
Type | |
Eternus Pool | Disk Attribute |
RAID Level |
Supported Alert Custom Macros
Customize the alert subject and description with below macros then it will generate alert based on customisation. 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}
${Custome Attributes in the resource}
${parent.resource.name}
Risks, Limitations & Assumptions
- Application can handle Critical/Recovery failure notifications for below two cases when user enables App Failure Notifications in configuration
- Connectivity Exception
- Authentication Exception
- Application will not send any duplicate/repeat failure alert notification until the already existed critical alert is recovered.
- OpsRamp has validated this application with an Eternus model which has product code as “ET203 BU” and product name as “Eternus DX200 S3” which belongs to the product family of “Eternus DX.
- Support for Macro replacement for threshold breach alerts (i.e, customisation for threshold breach alert’s subject, description).
- No support of showing activity logs.
- The Template Applied Time will only be displayed if the collector profile (Classic and NextGen Gateway) is version 18.1.0 or higher.
- Application is not compatible with Cluster Gateway.
- This application supports both Classic Gateway and NextGen Gateway.
Troubleshooting
Before troubleshooting, ensure all prerequisites prerequisites are met.
If Fujitsu Eternus integrations fail to discover or monitor, troubleshoot using the following steps:
- If there is an error or alert related to the end device connectivity or authentication, try checking the reachability of the end device from the gateway with the following commands:
- to ping the IP address provided in the configuration:
{ping <IP Address>}
- to try telnet:
{telnet <IP Adress> <Port>}
- to try SSH to an end device from a gateway:
{ssh <username>@<IP Address>}
- To run a SSH command:
Prepare the request payload by using below sample request:
{ “apiVersion”: “debug/v1”, “module”: “Debug”, “app”: “eternus”, “action”: “Reachability”, “payload”: { “ipAddressOrHostName”: “
”, “protocol”: “https”, “port”: 443, “requestPath”: “ ”, “version”:“v1”,
“requestMethod”:"<get/post>”, “userName”: “
”, “password”: “ ” } } Encode the request payload to base64
Log in to the gateway concole and connect to the GCLI terminal using the below command:
{## gcli}
Run the command using the previously generated base64 encoded string
{## sdkappdebug <base64 encoded string>}
- to ping the IP address provided in the configuration: