Introduction

HP-UX is a closed source operating system provided by HP Enterprise. It is a Unix-like operating system based on the Unix System V design. It is primarily designed for HP computers, and its target system is a server. It is one of five commercial operating systems with versions certified to the open group’s UNIX 03 standard. It has a monolithic kernel with dynamically loadable modules and the preferred proprietary license.

Pre-requisites

  • Users must have either OpsRamp Classic Gateway 10.0 or OpsRamp Cluster Gateway installed.
  • Ensure that “adapter integrations” add-on is enabled in client configuration. Once enabled, go to Setup > Integrations > Adapter to see HP UX Server integration.
  • Users need to add path /usr/sbin against path variables in the .profile file to achieve NETWORK related metrics. Example:
(hpux_server_network_interface_OutTraffic, hpux_server_network_interface_InDiscards, hpux_server_network_interface_OutPackets, hpux_server_network_interface_OutErrors, hpux_server_network_interface_OutDiscards, hpux_server_network_interface_InPackets, hpux_server_network_interface_InErrors, hpux_server_network_interface_Collisions, hpux_server_network_interface_Status, hpux_server_network_interface_InTraffic).
cat .profile
# Set up the search paths:
        PATH=$PATH:/usr/bin:/usr/sbin:/etc:/usr/local/bin:.
  • Users should have a tmp folder, the app will use it to store top command output in order to retrieve CPU and memory utilization metrics.
Commands using tmp folder
top -f /tmp/topoutput.txt

cat /tmp/topoutput.txt

rm /tmp/topoutput.txt
  • Users who want to use log file monitoring must have a home directory on the system where the script will be run.
pwd

[content@centos-node1 ~]$ pwd
/home/content

Install the integration

  1. From All Clients, select a client.
  2. Go to Setup > Integrations > Integrations.
  1. From Available Integrations, select Adapter > HP UX Server. You may also search for the app in the Integration List section.
  2. Click on HP UX Server app to install it.
  3. The Install HP UX Server Integration popup appears.
  1. Enter the following information:
    a. Name: Name of the integration
    b. Upload Logo: Optional logo for the integration.
    c. GateWay Profiles: Select a gateway management profile to associate with the client.

  2. Click Install. The Integration page displays the installed integration.

Configure the integration

  1. In CONFIGURATION section, click +Add.
  1. On Create Adapter Configuration, enter:
    • Name: Configuration name.
    • IP Address/Host Name: IP address or host name of the target.
    • Additional Configurations: Add additional configuration details, such as file system, process, and so on. The Log File Configuration is part of the additional configuration, configure the values for below fields as per your log file monitoring use case:
      • Name
      • File Name
      • Rotated File Name
      • Expression
      • Check Type
      • Threshold
      • Severity
    • Notification Alerts: Select TRUE or FALSE.
  2. From the Credential section, select Custom and enter the Username and Password.
  3. From the Resource Types & Metrics section, select the metrics and configure for availability and alert conditions, for Cluster & Server.
  4. In the Discovery Schedule section, configure how frequently the discovery action should trigger. Select Recurrence Pattern to add one of the following patterns:
    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
  5. In the Monitoring Schedule section, configure how frequently the monitoring action should trigger.
  1. Click Save.
  2. After saving the integration, HP UX resources are discovered and monitoring is enabled as specified by the configuration profile.

The configuration is saved and displayed on the page. You can perform the actions manually, like Discovery, Monitoring or even Disable the configuration.

Resource information

  1. To view the resource information, go to Infrastructure > Resources > Server.
  2. Use the search function to find your resource and then click on it.

View resource attributes

The discovered resource(s) are displayed under Attributes. In this page you will get the basic information about the resources such as: Resource Type, Native Resource Type, Resource Name, IP Address etc.

View resource metrics

To confirm HP UX Server 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 metrics

Resource Type: Server

Metric NameMetric DescriptionUnits
hpux_server_openFileDescriptors_UtilizationHP UX open file descriptors used percentagePercent
hpux_server_openFileDescriptors_UsedCountCurrent number of open file descriptorsCount
hpux_server_loggedInUsers_PctCurrent number of logged in users percentagePercent
hpux_server_loggedInUsers_CountCurrent number of logged in users
Count
hpux_server_runningProcesses_PctCurrent running processes percentage
Percent
hpux_server_runningProcesses_CountCurrent number of running processesCount
hpux_server_semaphores_UtilizationSemaphore ID's used percentagePercent
hpux_server_semaphores_UsedCountCurrent number of semaphore ID’s in useCount
hpux_server_sharedMemoryIDs_UtilizationUsed percentage of shared memory ID'sPercent
hpux_server_sharedMemoryIDs_UsedCountCurrent number of shared memory ID’s in useCount
hpux_server_cpu_total_UtilizationSystem CPU utilizationPercent
hpux_server_cpu_logicalProcessor_UtilizationSystem CPU logical processor utilizationPercent
hpux_server_cpu_LoadAverage CPU load for 1 min, 5 min, and 15 min
hpux_server_realMemory_ScanRateMemory scan rate in pages per secondpsec
hpux_server_realMemory_pageOuts_PagesPerSecMemory page out rate in pages per secondpsec
hpux_server_realMemory_pageOuts_KiloBytesPerSecMemory pages page out rate in Kilo Bytes per secondKBps
hpux_server_memory_UsedSystem memory used spaceMB
hpux_server_memory_UtilizationSystem memory utilizationPercent
hpux_server_swapMemory_UsedSwap memory usedKB
hpux_server_swapMemory_UtilizationSwap memory utilization in percentPercent
hpux_server_individual_swapArea_UtilizationIndividual swap area utilization in percentPercent
hpux_server_fileSystem_space_UtilizationFile system space utilization in percentPercent
hpux_server_fileSystem_space_UsedInMBFile system space usage in MBMB
hpux_server_fileSystem_space_DeltaInKBFile system space usage(KB) deltaKB
hpux_server_fileSystem_Inodes_UtilizationFile system Inodes utilization percentPercent
hpux_server_fileSystem_Inodes_Usage_NumberFile system Inodes usage numberCount
hpux_server_fileSystem_Inodes_DeltaFile system Inodes usage deltaCount
hpux_server_fileSystem_mount_ChangeDetectionFile system mount point change detection. It detects if any file system mount point removed and if any new mount point added into the system. Below are the possible values: 0 - Available , 1 - Newly Added , 2 - Removed
hpux_server_mountpoint_space_UtilizationMount point space utilization in percentPercent
hpux_server_mountpoint_space_UsedInMBMount point usage in MBMB
hpux_server_mountpoint_space_DeltaInKBMount point space usage(KB) deltaKB
hpux_server_mountpoint_Inodes_UtilizationMount point Inodes utilization percentPercent
hpux_server_mountpoint_Inodes_Usage_NumberMount point Inodes usage numberCount
hpux_server_mountpoint_Inodes_DeltaMount point Inodes usage deltaCount
hpux_server_mountpoint_availability_StatusAvailability status of mount point. These are possible values : 0 - Not Available 1 - Available
hpux_server_network_interface_OutTrafficMonitors Out traffic of each interface for hpux devicesKbps
hpux_server_network_interface_InDiscardsMonitors Network in discards of each interface for hpux devicespsec
hpux_server_network_interface_OutPacketsMonitors Out packets of each interface for hpux devicespackets/sec
hpux_server_network_interface_OutErrorsMonitors network out errors of each interface for hpux devicesCount
hpux_server_network_interface_OutDiscardsMonitors network Out Discards of each interface for hpux devicespsec
hpux_server_network_interface_InPacketsMonitors in Packets of each interface for hpux devicespackets/sec
hpux_server_network_interface_InErrorsMonitors network in errors of each interface for hpux devicesCount
hpux_server_network_interface_CollisionsMonitors network collisions of each interface for hpux devicesCount
hpux_server_network_interface_StatusMonitors status of each interface for hpux devices. Possible values 0-down, 1-up
hpux_server_network_interface_InTrafficMonitors In traffic of each interface for hpux devicesKbps
hpux_server_process_RunningStatusMonitors status of each user mentioned process. possible values 0-Not Running, 1- Running

Risks, Limitations & Assumptions

  • We are not supporting below monitorings as of now:
    • Hardware metrics
    • Programmable Resource Monitoring
    • Processes (we provided one metric for each process RunningStatus. i.e, hpux_server_process_RunningStatus).
  • Need below json payload as input for log monitoring:
    • Name: This can be any string used to identify individual log configuration.
    • File Name: It is a combination of folder path and file name. Folder path should contain the exact path for the file as prefix. File name can be any valid string or regular expression. In case of file not found with specified file name, alert will be generated with the severity specified by the user.
    • Rotated File Name: It is similar to file name field but specifying the rotated file. This is a optional field.
    • Expression: This can be any valid string or regular expression used to specify the search string. It’s a mandatory field.
    • Check Type: This can be either “exists” or “not exists”(case insensitive).
    • Threshold: This can be any valid integer. Alert will be generated in case of specified threshold breach happens.
    • Severity: It is used to specify the alert type to be created in case of expression found. Possible values are CRITICAL, WARNING, INFO, and OK (case insensitive).

Log file configuration:

 [
  {
  "Name":"",
  "File Name":"",
  "Rotated File Name":"",
  "Expression":"",
  "Check Type":"",
  "Threshold":"",
  "Severity":""
  }
]

  • We do not process logs for the first request because it creates performance issues due to a large amount of data. We will process the second request based on the most recent logs (logs generated between the first and second polls).
  • No recovery alerts are generated for expression related alerts. We will get recovery only for file not found alerts.
  • App can handle Critical/Recovery failure alert notifications for below 2 cases when user enables Notification Alerts in configuration:
    • Connectivity Exception
    • Authentication Exception
  • App will not send any duplicate/repeat failure alert notification until the already existing critical alert is recovered.
  • App can’t control monitoring Pause/Resume actions based on above alerts.