Revision as of 14:39, 27 April 2016

IBM Power ZenPack

Warning

The ZenPack Catalog has moved to its new home at https://www.zenoss.com/product/zenpacks as of January 17, 2017. The following information may be out of date, and this page will eventually be removed.

Support

This ZenPack is included with commercial versions of Zenoss and enterprise support for this ZenPack is provided to Zenoss customers with an active subscription.

Releases

Version 1.1.1- Download

Released on 2016/04/27

Requires PythonCollector ZenPack,CalculatedPerformance ZenPack,AIX Monitor ZenPack

Compatible with Zenoss Resource Manager 4.2.x, Zenoss Resource Manager 5.0.x, Zenoss Resource Manager 5.1.x

Version 1.1.0- Download

Summary of changes: * Audited, revised, and standardized component classes and relations model throughout

• Added Dynamic View functionality
• Updated Analytics Bundle
• Complete conversion to ZPL
• Many bug fixes

Released on 2016/02/10

Requires PythonCollector ZenPack,CalculatedPerformance ZenPack,AIX Monitor ZenPack

Compatible with Zenoss Resource Manager 4.2.x, Zenoss Resource Manager 5.0.x

Version 1.0.2- Download

Requires PythonCollector ZenPack,Calculated Performance ZenPack

Compatible with Zenoss Resource Manager 4.2.x, Zenoss Resource Manager 5.0.x

Background

This ZenPack provides support for monitoring IBM Power Server (P5/P6/P7), with the IBM HMC interface. Monitoring is performed using the HMC interface. This ZenPack is currently supported for IBM Power servers running on the AIXLinux Operating System.

Supported versions of HMC

V 7

Supported versions of Power Servers

POWER7, POWER6 and POWER5

Supported Operating systems of Logical partition

AIX, Linux

Prerequisites

Zenoss Version

>=4.2.4

PythonCollector

>=1.3

CalculatedPerformance

>=2.0

AixMonitor >=1.0

External Dependencies

SSH should be configured and running on IBM HMC Server.

This should be verified using SSH command from HMC server:

lssyscfg -r sys

• This will list all the Managed Systems under HMC

Features

The features added by this ZenPack be summarized as follows. They are each detailed further below.

• Initial discovery and continual synchronization of relevant components.

• Performance monitoring.

• Service impact and root cause analysis. (Requires Zenoss Service Dynamics)

Discovery

IBM HMC Server

The following components will be automatically discovered through the HMC Server IP address and the host name you provide. The properties and relationships will be continually maintained

HMC Server

Attributes: Serial Number, BIOS, Model Number, Version, Build Level, Service Pack, Release

Relationships: Managed Systems, Logical Partitions, HMC Service Processor

Managed Systems

Attributes: Server Name, Serial Number, Model, Service Partition, State

Relationships: HMC Server, I/O Devices, Processor Pools, HEA, HEAPorts, LHEA, LHEA Ports, Profiles, Port Groups, IO Pools

Profiles

Relationships: LogicalPartitions

I/O Devices

Attributes: Slot, Server Name, Owner, Description, Bus ID, I/O Pool ID

Relationships: Managed Systems

I/O Pools

Attributes: Pool ID, Server Name, LPAR Name, LPAR ID, I/O Pools Allowed

Relationships: Managed Systems

Logical Partitions

Attributes: LPAR Name, LPAR ID, Server Name, Serial Number, Work Group ID, OS Version, Processing Units, Assigned Memory, State

Relationships: HMC Server

HMC Service Processor

Attributes: Serial Number, IP Address, Location Code, Service Processor Role, Connection State

Relationships: HMC Server

Processor Pools

Attributes: Pool Name, Shared Processor Pool ID, LPAR IDs

Relationships: ManagedSystem

Hea

Attributes: phys_loc, state

Relationships: ManagedSystem

Hea Port

Attributes: speed, duplex, state

Relationships: ManagedSystem, Hea, PortGroup, LogicalPartition

LHea

Attributes: capability, drc_name

Relationships: ManagedSystem, LogicalPartition

LHea Port

Attributes: drc_name, drc_index, state

Relationships: ManagedSystem, PortGroup, LogicalPartition

Port Group

Attributes: phys_port_ids, curr_port_group_mcs_value

Relationships: ManagedSystem, LogicalPartition, HeaPort, LHeaPort

Performance Monitoring

The following metrics will be collected every 5 minutes by default. Any other IBM HMC Server metrics can also be collected by adding them to the appropriate monitoring template.

HeaPort

• Packets

LogicalPartitions

• Processor Utilization
• Processor Units Used
• Memory Used

ManagedSystems

• Processor Utilization
• Memory Utilization

ProcessorPools

• Utilization

Event Monitoring

This zenpack will monitor the power states of the logical partitions and managed systems. Currently this is the only out of box event creation.

IBM Power Server

Installed Items

Installing this ZenPack will add the following items to your Zenoss system.

Configuration Properties

• zCollectorPlugins
• zSnmpMonitorIgnore
• zDeviceTemplates
• zCommandUsername
• zCommandPassword
• zCommandCommandTimeout
• zCommandPort
• zKeyPath

Device Classes

• /Devices/Server/IBM/Power/HMC

IBM HMC Server will be added in this device class using HMC IP.

Modeler Plugins

The following plugins will be used for modeling HMC Server and IBM Power Server using the HMC Server IP Addresses via SSH interface.

• HMCModelerPlugin

This plugin is for modeling IBM HMC Server and IBM Power Server.

Datasource Types

• COMMAND

Monitoring Templates

• PortGroup (in /Server/IBM/Power/HMC)

• Hea (in /Server/IBM/Power/HMC)

• HeaPort (in /Server/IBM/Power/HMC)

• LHea (in /Server/IBM/Power/HMC)

• LHeaPort (in /Server/IBM/Power/HMC)

• Device (in /Server/IBM/Power/HMC)

• IODevices (in /Server/IBM/Power/HMC)

• IOPools (in /Server/IBM/Power/HMC)

• Profile (in /Server/IBM/Power/HMC)

• ProcessorPools (in /Server/IBM/Power/HMC)

• ServiceProcessor (in /Server/IBM/Power/HMC)

• ManagedSystems (in /Server/IBM/Power/HMC)

• LogicalPartitions (in /Server/IBM/Power/HMC)

Service Impact and Root Cause Analysis

When combined with the Zenoss Service Dynamics product, this ZenPack adds built-in service impact and root cause analysis capabilities for services running on IBM Power. The service impact relationships shown in the diagram and described below are automatically added. These will be included in any services that contain one or more of the explicitly mentioned components.

IBM and Power Server Impact Relationship Diagram

Internal Impact Relationships

• Managed Systems, Logical Partitions, HMC Service Processor and Processor Pools impacts the related HMC Server

• Memory, Processors, I/O Devices, Host Ethernet Adapters and I/O Pools failure impacts the related Managed Systems which impacts the HMC Server.

• Managed Systems failure impacts the related Logical Partitions which impacts the HMC Server.

Most of the impacts described above follow the default policy of a node being in the worst state of the nodes that impact it. For example, an HMC Server failure will imply that all related hosts are also failed.

Zenoss Analytics

This ZenPack provides additional support for Zenoss Analytics. Perform the following steps to install extra reporting resources into Zenoss Analytics after installing the ZenPack.

1. Copy analytics-bundle.zip from $ZENHOME/ZenPacks/ZenPacks.zenoss.IBM.Power/analytics/ on your Zenoss server.
2. Navigate to Zenoss Analytics in your browser.
3. Login as superuser.
4. Remove any existing IBM Power ZenPack folder.
   1. Choose Repository from the View menu at the top of the page.
   2. Expand Public in the list of folders.
   3. Right-click on IBM Power ZenPack folder and choose Delete.
   4. Confirm deletion by clicking OK.
5. Add the new IBM Power ZenPack folder.
   1. Choose Server Settings from the Manage' menu at the top of the page.
   2. Choose Import in the left page.
   3. Remove checks from all check boxes.
   4. Click Choose File to import a data file.
   5. Choose the analytics-bundle.zip file copied from your Zenoss server.
   6. Click Import.You can now navigate back to the IBM Power ZenPack folder in the repository to see the following resources added by the bundle.

Usage

Adding HMC Server

Use the following steps to start monitoring HMC Server using the Zenoss web interface.

1. Navigate to the Infrastructure page.
   

   Add Device
2. Navigate to organizer Devices/Server/IBM/Power/HMC.
3. Choose Add a Single Device from the add button.
   
4. Fill out the form.
   

   Add Dialog
   • Name can be anything you want.
   • Hostname or IP must be resolvable and accessible from the collector server chosen in the Collector field.
5. Click ADD.
6. IBM HMC Server will be added in the /Devices/Server/IBM/Power/HMC device class.

Use the following steps for successful modeling.

1. Select the device added.
2. Navigate to Configuration Properties.
   

   Model device
3. Provide the values for zCommandUsername and zCommandPassword.
4. Model the device.

zenbatchload

• Alternatively you can use zenbatchload to add devices from the command line.
• To do this, you must create a file with contents similar to the following.
• Replace all values in angle brackets with your values minus the brackets.
• Multiple devices can be added under the same sections.

'/Devices/Server/IBM/Power/HMC' <device name>  setManageIp="<IP Address>", zCommandUsername='<username>', zCommandPassword='<password>'

Example : /Devices/Server/IBM/Power/HMC HMC_1 setManageIp='10.100.75.35', zCommandUsername='hcladmin', zCommandPassword='root123'

You can then load the Devices using zenbatchload with the following command.

zenbatchload <filename>

Limitation

• Storage Mapping has not been implemented in this release.

Changes

1.1.1

• Updated zenpacklib.py to address modeler timeouts from attribute-indexed components

1.1.0

• Audited, revised, and standardized component classes and relations model throughout
• Added Dynamic View functionality
• Updated Analytics Bundle
• Complete conversion to ZPL
• ZEN-21613: Update all documentation
• ZEN-21555: No metric values collected for various components
• ZEN-21537: Changes in configuration applied" occurs after remodeling
• ZEN-21536: Connection Information shows wrong information
• ZEN-21541: Update Impact documentation
• ZEN-18852: Incorrect value format for the 'Installed Count' field
• ZEN-18853: Duplicated fields for components
• ZEN-18851: Incorrect value in the 'Manufacture Config' field
• ZEN-18850: No friendly names for fields
• ZEN-18819: Analytics details for HMC Server component should be changed
• ZEN-15818: Small code coverage by unit tests for ZenPack
• ZEN-15746: Default icons for all components
• ZEN-16216: Provide friendlier event message if there is connection failure due to user timeout
• ZEN-18848: Incorrect impact relations
• ZEN-18847: No node exist error when add component to Service
• ZEN-18787: Dynamic View error for Service Processors component
• ZEN-18863: Traceback during running 'zenpython run' command
• ZEN-15808: Include status icon to all components affected by managed system
• ZEN-16222: The 'Y' scale for the Processor Units Used of LPARs is not adjusting correctly
• ZEN-15299: Long component load times
• ZEN-16544: percent_pool_cycles missing from managed systems component
• ZEN-15715: Traceback when attempting to open IBM Power device

1.0.2

• ZEN-16881: Fix Links in the right hand Services pane
• ZEN-16544: Fix missing percent_pool_cycles

1.0.1

• Add pool cycles to managed systems that support them
• ZEN-16510 Traceback on some datasources.

1.0.0

• Initial release.

Installation

Normal Installation (packaged egg)

1. Download the appropriate egg file for the version of Zenoss you are running.
2. Ensure you are logged in as the zenoss user:

   $ sudo su - zenoss

3. Install the ZenPack:

   $ zenpack --install ZenPacks.zenoss.IBM.Power-*.egg

4. Restart these services:

   $ zenoss restart

Discuss

New: Don't forget to add yourself to the Zenoss User Map!