*----------------------------------------------------------*
          *         HPE Integrity Superdome X WBEM Providers         *
          *       Installation Guide for RHEL 6.X, RHEL 7.X          * 
          *       and RHEL8.X                                        * 
          *----------------------------------------------------------*

Copyright (C) 2014-2016,2020 Hewlett-Packard Enterprise Development LP

This document provides detailed instructions to install/upgrade
WBEM Providers on supported RHEL releases for HPE Integrity
Superdome X Servers.

================================
1. OPERATING ENVIRONMENT SUPPORT
================================

WBEM Providers requires one of the following releases of Red Hat Enterprise
Linux (x86-64) on your HPE Integrity Superdome X Server:

    Red Hat Enterprise Linux Server 8.4
    Red Hat Enterprise Linux Server 8.3
    Red Hat Enterprise Linux Server 8.2
    Red Hat Enterprise Linux Server 8.1 
    Red Hat Enterprise Linux Server 7.9
    Red Hat Enterprise Linux Server 7.8
    Red Hat Enterprise Linux Server 7.7
    Red Hat Enterprise Linux Server 7.6
    Red Hat Enterprise Linux Server 7.5
    Red Hat Enterprise Linux Server 7.4
    Red Hat Enterprise Linux Server 7.3
    Red Hat Enterprise Linux Server 7.2
    Red Hat Enterprise Linux Server 7.1
    Red Hat Enterprise Linux Server 7
    Red Hat Enterprise Linux Server 6.10
    Red Hat Enterprise Linux Server 6.9
    Red Hat Enterprise Linux Server 6.8
    Red Hat Enterprise Linux Server 6.7
    Red Hat Enterprise Linux Server 6.6
    Red Hat Enterprise Linux Server 6.5

NOTE: Refer the "Running Linux on HPE Integrity Superdome X" Whitepaper
(http://h20195.www2.hpe.com/V2/getpdf.aspx/4AA5-4775ENW.pdf) for the
OS support matrix.


===================
2. PRODUCT DOWNLOAD
===================

To install or upgrade WBEM Providers, use the following links to obtain
the latest version of the software:

(a) Download the WBEM Providers packages from this SDR site,
    corresponding to your RHEL version:
        http://downloads.linux.hpe.com/repo/bl920-wbem/rhel/<RHEL-version>/x86_64/current
    For example:
        http://downloads.linux.hpe.com/repo/bl920-wbem/rhel/6.6/x86_64/current
        Or
        http://downloads.linux.hpe.com/repo/bl920-wbem/rhel/7/x86_64/current

(b) If you are using an HPE QMH2672 Fibre Channel adapter, download the
    HP-CNA-FC-hpqlgc-Enablement-Kit (HPE Fibre Channel Enablement Kit
    for Linux - QLogic) from Hewlett-Packard Enterprise Support Center:
        http://h20564.www2.hpe.com/hpsc/swd/public/detail?swItemId=MTX_1c3d23bab38f4328a7e50cdd75#tab1

(c) If you are using InfiniBand, download the latest version of InfiniBand
    WBEM Provider package (MLNX_CIMProvider-<version>.<arch>.rpm) for RHEL
    from this SDR site:
        http://downloads.linux.hpe.com/SDR/repo/bl920-wbem/rhel/
    For example:
        http://downloads.linux.hpe.com/SDR/repo/bl920-wbem/rhel/MLNX_CIMProvider-1.2.2-058.x86_64.rpm

    Note:- InfiniBand WBEM Provider is not supported on RHEL8 and above.
 
(d) If you want to use HPE System Management Homepage (SMH) with WBEM Providers,
    download the SMH package from the following site:
         https://support.hpe.com/hpsc/swd/public/detail?swItemId=MTX_2a6a42eea39a4ac3ab2ff8326d 


===================
3. NEW INSTALLATION
===================

Download the required software (as described in section 2
"PRODUCT DOWNLOAD") to a temporary directory on the target system.

Login into the target system with administrative privileges and
follow the instructions below for a new (first-time) installation
of WBEM Providers.

3.1 Pre-requisites
------------------

Before installing WBEM Providers on the target system, ensure that
the following pre-requisites are met:

  (a) The following packages must be installed prior to WBEM Providers
      installation:
        - tog-pegasus
        - openwsman-server
        - OpenIPMI
        - libxml2-python
        - libevent
        - policycoreutils
        - policycoreutils-python
        - pciutils
        - sqlite

      Additional dependencies for RHEL 8.1:
       - python2
       - libnsl

      To check if the above packages are installed, use the following
      command:
      # rpm -qa | grep -i -e tog-pegasus -e openwsman-server \
      > -e OpenIPMI -e libxml2-python -e libevent -e policycoreutils \
      > -e policycoreutils-python -e pciutils -e sqlite

      If one or more packages above are not installed, use the following
      command to install the packages:
      # yum install -y tog-pegasus openwsman-server OpenIPMI \
      > libxml2-python libevent policycoreutils policycoreutils-python \
      > pciutils sqlite

  (b) If you are using an HPE QMH2672 Fibre Channel adapter, you must
      install HP-CNA-FC-hpqlgc-Enablement-Kit as below:
      # rpm -ivh HP-CNA-FC-hpqlgc-Enablement-Kit-<version>.noarch.rpm 

      This kit is required for WBEM Providers to retrieve I/O information.

  (c) SMX WBEM Providers conflicts with "libvirt-cim" package due to
      "libvirt-cim" holding different WBEM schemas with HPE standard WBEM
      extensions. Before proceeding further, please make sure that
      libvirt-cim*.rpm is NOT installed on your server:
      # rpm -qa | grep -i -e libvirt-cim

      If the output is not empty, uninstall the package manually:
      # rpm -e libvirt-cim

3.2 Installation
----------------

The WBEM Providers RPM packages have the following name format:
      <component>-<version>.<distro>.<arch>.rpm

Follow these steps to install WBEM Providers on the target system:

  (a) Install the hpmgmtbase and hp-smx packages:
      # rpm -ivh hpmgmtbase-<version>.<distro>.<arch>.rpm
      # rpm -ivh hp-smx-<version>.<distro>.<arch>.rpm

  (b) If you are using InfiniBand, you must install the InfiniBand
      WBEM Provider package:
      # rpm -ivh MLNX_CIMProvider-<version>.<arch>.rpm

  (c) Install the hpshd package:
      # rpm -ivh hpshd-<version>.<distro>.<arch>.rpm

  (d) If you want to enable SMH and the corresponding WBEM Providers
      webapp pages, you must install the SMH package, followed by
      the hpsmx-webapp package:
      # rpm -ivh hpsmh-<version>.<arch>.rpm
      # rpm -ivh hpsmx-webapp-<version>.<distro>.<arch>.rpm

  (e) If you want to use HPE Insight Remote Support (IRS) to view
      information from WBEM Providers, you must install
      the hp-smx-EnableWsman package:
      # rpm -ivh hp-smx-EnableWsman-<version>.<distro>.<arch>.rpm

3.3 Verification
----------------

To verify if WBEM providers was successfully installed and running,
use the following command:

    For RHEL6.X:
    # service tog-pegasus status

    For RHEL7.X/RHEL8.X:
    # systemctl status tog-pegasus

If you see an output like "CIM server (nnnnn) is running" or
"Active: active (running) since <date-and-time>" above,
your installation should have completed successfully.


=====================================
4. UPGRADING AN EXISTING INSTALLATION
=====================================

Download the required software (as described in section 2
"PRODUCT DOWNLOAD") to a temporary directory on the target system.

Follow the instructions below to upgrade an existing installation of
WBEM Providers.

NOTE: WBEM Providers do not support the upgrade functionality for
all the constituent packages until version 56 (i.e. x.y.z-56).
Hence, if you are currently using a version of WBEM Providers < 56,
you first need to uninstall the existing WBEM Providers packages
from the target system, before installing the latest version.
The following instructions will guide you through this process.

  (a) Login into the target system with administrative privileges.

  (b) Lookup the existing WBEM Providers related packages installed
      on the system:
      # rpm -qa | grep -i -e hp -e mlnx

  (c) If you are using an HPE QMH2672 Fibre Channel adapter and
      a newer version of the HP-CNA-FC-hpqlgc-Enablement-Kit is
      available, upgrade to the latest version:
      # rpm -Uvh HP-CNA-FC-hpqlgc-Enablement-Kit-<version>.noarch.rpm

  (d) If version number of your existing WBEM Providers installation
      is <= 51 (for example, x.y.z-50), follow these steps:

      1) Stop the following daemons:

         For RHEL 6.X:
         # service hpshd stop
         # service tog-pegasus stop
         # service hpmgmtbase stop

         For RHEL 7.X/RHEL8.X:
         # systemctl stop hpshd 
         # systemctl stop tog-pegasus
         # systemctl stop hpmgmtbase

      2) Erase the following packages in the given order:
         # rpm -e hpsmx-webapp            (In case of SMH integration)
         # rpm -e hp-smx-EnableWsman      (In case of IRS integration)
         # rpm -e hpshd
         # rpm -e hp-smx
         # rpm -e hpmgmtbase

      3) Install the latest versions of hpmgmtbase, hp-smx and hpshd:
         # rpm -ivh hpmgmtbase-<version>.<distro>.<arch>.rpm
         # rpm -ivh hp-smx-<version>.<distro>.<arch>.rpm
         # rpm -ivh hpshd-<version>.<distro>.<arch>.rpm

      4) For SMH integration, install the latest hpsmx-webapp package:
         # rpm -ivh hpsmx-webapp-<version>.<distro>.<arch>.rpm

      5) For IRS integration, install the latest hp-smx-EnableWsman package:
         # rpm -ivh hp-smx-EnableWsman-<version>.<distro>.<arch>.rpm

  (e) If version number of your existing WBEM Providers installation
      is >= 52 and <= 55 (for example, x.y.z-54), follow these steps:

      1) Erase the following packages from the system:
         # rpm -e hpsmx-webapp            (In case of SMH integration)

      2) Upgrade hpmgmtbase, hp-smx and hpshd to their latest version:
         # rpm -Uvh hpmgmtbase-<version>.<distro>.<arch>.rpm
         # rpm -Uvh hp-smx-<version>.<distro>.<arch>.rpm
         # rpm -Uvh hpshd-<version>.<distro>.<arch>.rpm

      3) For IRS integration, upgrade hp-smx-EnableWsman to its
         latest version:
         # rpm -Uvh hp-smx-EnableWsman-<version>.<distro>.<arch>.rpm

      4) For SMH Integration, install the latest hpsmx-webapp package:
         # rpm -ivh hpsmx-webapp-<version>.<distro>.<arch>.rpm

  (f) If version number of your existing WBEM Providers installation
      is >= 56 (for example, x.y.z-56), follow these steps:
       
      1) Upgrade hpmgmtbase, hp-smx and hpshd to their latest version:
         # rpm -Uvh hpmgmtbase-<version>.<distro>.<arch>.rpm
         # rpm -Uvh hp-smx-<version>.<distro>.<arch>.rpm
         # rpm -Uvh hpshd-<version>.<distro>.<arch>.rpm

      2) For SMH integration, upgrade to the latest version of
         hpsmx-webapp:
         # rpm -Uvh hpsmx-webapp-<version>.<distro>.<arch>.rpm

      3) For IRS integration, upgrade to the latest version of
         hp-smx-EnableWsman:
         # rpm -Uvh hp-smx-EnableWsman-<version>.<distro>.<arch>.rpm

  (g) If you are using InfiniBand, follow these steps to upgrade
      the InfiniBand WBEM Provider:

      1) Erase the existing MLNX_CIMProvider package:
         # rpm -e MLNX_CIMProvider

      2) Install the latest InfiniBand WBEM Provider package:
         # rpm -ivh MLNX_CIMProvider-<version>.<arch>.rpm


=================
5. UNINSTALLATION
=================

If you need to uninstall the WBEM Providers and the related packages
from the target system, use the following commands:
        # rpm -e hpsmx-webapp            (In case of SMH integration)
        # rpm -e hp-smx-EnableWsman      (In case of IRS integration)
        # rpm -e MLNX_CIMProvider        (For InfiniBand WBEM Provider)
        # rpm -e hpshd
        # rpm -e hp-smx
        # rpm -e hpmgmtbase

You can erase the hpsmh and HP-CNA-FC-hpqlgc-Enablement-Kit packages if they
are not being used by other applications/plugins:
        # rpm -e hpsmh
        # rpm -e HP-CNA-FC-hpqlgc-Enablement-Kit

-End-