[an error occurred while processing this directive]

SolutionPack for IBM LPAR

Table of Contents

Overview

This article explains how to install and configure the SolutionPack for IBM LPAR. The SolutionPack for IBM LPAR collects Inventory details about IBM's Power-Servers managed by Hardware Management Console (HMC) and displays the data in easy-to-use reports in ViPR SRM. With this SolutionPack, you can generate reports to highlight key relationships in the virtual environment such as:

Capacity reports, such as File System Usage, help you to improve the availability of business critical applications and services by ensuring that applications have the storage resources they need to operate effectively.

This article applies to EMC ViPR SRM version 3.5.1.

report screen

SolutionPack for IBM LPAR

Back to Top

Technical Specifications

SolutionPack version

Compatible ViPR SRM version

Polled metrics

Per Power Server:

Per LPAR:

Main reports

Note Image

ViPR SRM Release 3.5 and earlier: Topology maps for VIOC will be reported only if the respective VIOS is discovered.

ViPR SRM Releases after 3.5: Topology maps for VIOC will be reported regardless of VIOS discovery.


Additional information

Back to Top

Where to find the latest SolutionPack software

Install the latest core software update for your product suite. SolutionPacks distributed with core software have a 30-day free evaluation period. If you plan to use the software longer than 30 days, you must install a SolutionPack license before the trial period ends.

This 30-day free evaluation only applies to new installations and is not available for upgraded installations. If you upgrade the core software and want to try a new SolutionPack, you must request a license for that SolutionPack.

Back to Top

Configuring VIO for discovery

The user credentials of VIO Server & VIO clients should be configured in Discovery Center > Host Configuration.

ViPR SRM requires non-root user credentials or a SSH public/private key pair (keys can be created for root / non-root users) to discover VIO Servers.

ViPR SRM requires a non-root user or a SSH public/private key pair (Keys can be created via root / non-root users) to discover VIO Clients.

When the VIOS Server is installed the padmin user is automatically created and this user provides restricted shell access. The ViPR SRM host data collection mechanism does not work in the restricted shell environment, hence the need to create a non-root user and configure the non-root user via sudo to elevate the privileges to run certain commands as root. Provide the non-root user credentials to ViPR SRM while discovering VIO Server.
Note Image
ViPR SRM does not require padmin credentials to discover the VIO server.

Back to Top

Configuring sudo for VIO Server and Client host discovery

To discover VIO Server/Client hosts and collect data from these hosts you have to elevate privileges for the non-root user via sudo because some commands used in the data collection require root privileges.

Procedure

  1. Include the path of sudo command in the environment variable $PATH for the sudo user.
    The variable $PATH can be set either in /etc/environment or /etc/default/login or any other OS specific file.
  2. Include the paths of OS commands in the environment variable $PATH for sudo user.
    By default, most of the command files have the following location: /usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
  3. Verify that the $PATH is correct.
    1. Log in as sudo user
    2. Type which sudo.
  4. Ensure that the sudoers file is available.
    By default, the sudoers file is available in /etc or /opt/sfw/etc/ or /usr/local/etc/sudoers
  5. Ensure that the sudo user has root privilege to run the following commands on a given host.
    Ensure the absolute path to the packages are provided in sudoers file. It is recommended to use visudo to edit sudoers file. Some packages are not installed by default.
    • inq
    • powermt
    • vxdisk
    • dmidecode (Linux)
    • vgs (Linux)
    • pvs (Linux)
    • lvdisplay (Linux)
    • vgdisplay (Linux)
    • swap (AIX)
Back to Top

Generating a public and private key pair for SSH key based authentication

For the SSH key method of discovering UNIX hosts, you must generate a valid public and private key pair. You can choose any key generation tool to generate a valid public and private key pair.

Before you begin

Before you begin host discovery, you must have a public key present on all the UNIX hosts that are to be discovered using the private key.

These steps describe the procedure to generate a public and private key pair for UNIX hosts using the ssh-keygen tool.

Note Image
The public key is to be added to the authorized_keys file on the target hosts intended for discovery and the private key is to be imported to the collector VMs where discovery is triggered.

Procedure

  1. Public-Private key pair can be generated on any UNIX host using the command:
    ssh-keygen -t rsa -f <location_of_the_private_key/name_of_ private_key_file> -N ""

    For example: ssh-keygen -t rsa -f /root/.ssh/id_rsa -N ””

  2. Ensure that the public and private key pair that is generated has the following permissions:
    • chmod 600 /root/.ssh/id_rsa
    • chmod 644 /root/.ssh/id_rsa.pub
    The private key file is id_rsa.
    The public key file is id_rsa.pub.
  3. To make the key pair functional, append the public key to <users home directory>/.ssh/authorized_keys in the target UNIX host using the command cat<location_of_the_public_key/name_of_public_key_file> >> <users home directory>/.ssh/authorized_keys
    For example: cat /root/.ssh/id_rsa.pub >> /<user's home dir>/.ssh/authorized_keys
    Next, import the private key to the Collector used for discovery.
Back to Top

Importing a private key into the Collector

Procedure

  1. Place the generated private key in the RSC conf folder /opt/APG/Collecting/Remote-Shell-Collector/<instance_of_collector>/conf
  2. Type chown apg:apg <private_key_file>
    This command changes the owner.
    The host is now ready for successful data collection.
Back to Top

Verify adapter IDs in NPIV configuration

In the NPIV configuration if a VFC Server Adapter is created on the VIOS and a VFC Client Adapter on the VIOC, ensure correlation between the Physical HBA ports and the Virtual FC Client Adapter ports.

Procedure

  1. On an HMC, go to the Virtual Adapters tab in the partition Properties of the VIOS/VIOC on which the VFC Server/Client Adapter are created.
  2. Verify that a match exists between the Adapter ID of VFC Server Adapter and the Adapter ID of VFC Client Adapter.
Back to Top

Installing the SolutionPack

Before you begin

Procedure

  1. Log in.
  2. Click Administration.
  3. Click Centralized Management.
  4. Click SolutionPacks.
  5. Select SolutionPack Center.
  6. Select SolutionPack for IBM LPAR. in the Browse and Install SolutionPacks screen.
  7. Enter an instance name.
  8. Click Install.
  9. In the Data Collection field, select the Collector host.
  10. In the Reports field, select the Frontend host.
  11. Click Next.
  12. In the Data collection window, select a value for Data Collection.
    If you select Add a new data collection, type information about the data collection.
    • Optionally, enable Failover-Filter.
    • In HostName or the IP address to send data to, type the Primary Backend Hostname / IP or localhost, based on the following condition:
      • For ViPR SRM release before 3.5, type the Primary Backend Hostname / IP

      • For release 3.5 and later ViPR SRM releases, type localhost
  13. Click Click to show device questions to display HMC configuration window and click the plus sign (+).
    IBM LPAR configuration window appears.
  14. Type the HMC IP address, username and password.
    The SolutionPack for IBM LPAR installation begins.
  15. Optionally, you can change the default HMC polling interval by clicking Do you want to configure advanced settings.
  16. Click Next.
  17. Click Install.
  18. Click Ok once installation is complete.
    Note Image

    SolutionPack for Physical Hosts will collect data from Physical Host/LPAR/VIO Servers. You can configure script block from SolutionPack for Physical Hosts on multiple collectors VMs where you intend to discover hosts/LPAR/VIO server. Based on your deployment plan, you can distribute host discovery on multiple collector VMs.


Back to Top

Using Discovery Center to discover the VIO Servers and Clients

Procedure

  1. From the User Interface, click Administration.
  2. Click Discovery Center.
  3. Under Device Type, click Host configuration.
  4. Click Add new device.
  5. In Server, select the collector VM where script block from SolutionPack for Physical Hosts is installed.
  6. Enter the VIO Server/Client configuration details and click Ok.
  7. Add a new device for each VIO Server and Client that will be discovered.
  8. Select the Authentication Type as:
    Option Description
    Password based Authenticates with password.
    Public key base Authenticates with SSH public private key.
  9. Provide username (root or sudo user):
    1. Provide the password of the host for password based authentication
    2. Provide the location of the private key for public key based authentication ( /opt/APG/Collecting/Remote-Shell-Collector/ <instance-of-collector> /conf/ <name-of-private-key>)
  10. Click Ok.
  11. Select the device added and click Save.
  12. Add a new device for each VIO Server and client that will be discovered.
Back to Top

Using Discovery Center to discover an HMC

Procedure

  1. From the User Interface, click Administration.
  2. Click Discovery Center.
  3. Under Device Type, click IBM LPAR configuration.
  4. Click Add new device.
  5. Enter the HMC hostname, username and password.
  6. Click Ok.
  7. Select the device added and click Save.
  8. Add a new device for each HMC that will be discovered.
Back to Top

SolutionPack Reconfiguration

If you wish to change the answers that were provided during SolutionPack installation the first time through, you could change them by reconfiguring the SolutionPack.

Procedure

  1. Click Administration.
  2. Under Centralized Management.
    1. Click SolutionPacks > Independent SolutionPackBlocks and select generic-rsc.
      The SolutionPackReconfiguration dialog box appears.
    2. Click SolutionPacks > Infrastructure > IBM LPAR and select the instance for LPAR.
  3. Change the configuration as desired.
  4. Click Reconfigure.
Back to Top

Confirming report creation

After you install a SolutionPack, you can view its reports.

To view the reports:

Procedure

  1. Go to User Interface > Report Library.
  2. Click the SolutionPack to view its reports.

Results

It may take up to an hour to display all relevant information in these reports.

Back to Top

Troubleshooting

Report display problems

Back to Top

What to do if data does not appear in any reports

Procedure

  1. After the completion of at least three collection cycles, verify if data is populating into the reports. If there is still no data in the reports, continue to the next step.
  2. Run the scheduled task to import data into reports. If there is still no data in the reports, continue to the next step.
  3. To view the log files for errors, go to Centralized Management and click Collecting > Collector-Manager::<instance name> > Log Files.
Back to Top

Running a scheduled task to import data into reports

After you push a new configuration into a collector, a scheduled task runs and populates the reports with new data. You can manually run the scheduled task to import the data more quickly.

Before you begin

Allow at least three polling cycles to pass before manually running the scheduled task.

Procedure

  1. Click Administration.
  2. Click Centralized Management.
  3. Expand Scheduled Tasks.
  4. Click Database.
  5. Select the import-properties-Default task.
  6. Click Run Now.
  7. Confirm success in running the task in the Last Result and Last Result Time columns.
Back to Top

What to do if data does not appear in some reports

Procedure

  1. Run the scheduled task to import data into reports. If there is still no data in the reports, continue to step 2.
  2. Search for the metric in the database.
  3. To view the log files for errors, go to Centralized Management and click Collecting > Collector-Manager::<instance name> > Log Files.
Back to Top

Searching for metrics in the database

You can verify that a metric is being collected and used for reporting when you search and find the metric in the database.

Procedure

  1. Go to the Administration page.
  2. Under Modules, click Management of Database Modules.
  3. On the Metric Selection page, create the filter, type the number of results, and select the properties to display for the metric.
    For example, to list up to 100 results of the SignalWait Time metric with the properties of device and IP, type name=='SignalWaitTime' in the Filter field, 100 in the Maximum results field, and select device and IP for the Properties to show.
  4. Click Query.
    A list of the metric results appears. If nothing displays, the metric is not being collected.
Back to Top

Viewing collector errors in the Collector-Manager log files

Review the Collector-Manager log files to troubleshoot problems with data collection.

Procedure

  1. Click Administration.
  2. Click Centralized Management.
  3. Expand Collecting.
  4. Click the Collector-Manager for your collector instance.
    Collector-Manager::<Collector-Manager instance> - <physical_host_ID>
  5. Expand Log Files and click the View File icon to review the configuration error messages.
Back to Top
[an error occurred while processing this directive]