*----------------------------------------------------------*
          *         HPE Integrity Superdome X WBEM Providers         *
          *              Installation Guide for SLES                 *
          *----------------------------------------------------------*

Copyright (C) 2014-2021 Hewlett-Packard Enterprise Development LP          

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

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

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

    SUSE Linux Enterprise Server 11 SP3
    SUSE Linux Enterprise Server 11 SP4
    SUSE Linux Enterprise Server 12 
    SUSE Linux Enterprise Server 12 SP1
    SUSE Linux Enterprise Server 12 SP2
    SUSE Linux Enterprise Server 12 SP3
    SUSE Linux Enterprise Server 12 SP4
    SUSE Linux Enterprise Server 12 SP5
    SUSE Linux Enterprise Server 15 SP1
    SUSE Linux Enterprise Server 15 SP2
    SUSE Linux Enterprise Server 15 SP3
 

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 SLES version:
        http://downloads.linux.hpe.com/repo/bl920-wbem/suse/<SUSE-version>/x86_64/current/
    For example:
        http://downloads.linux.hpe.com/repo/bl920-wbem/suse/11SP3/x86_64/current/
        Or
        http://downloads.linux.hpe.com/repo/bl920-wbem/suse/12SP1/x86_64/current/
        Or
        http://downloads.linux.hpe.com/repo/bl920-wbem/suse/15SP1/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 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

(d) If you are using an HP InfiniBand FDR 2-port 545M Adapter, download the -
    1) Drivers - Mellanox OpenFabrics Enterprise Distribution for Linux or
       the MLNX_OFED drivers from the Linux SW/Drivers at www.mellanox.com :
       http://www.mellanox.com/page/products_dyn?product_family=26&mtag=linux_sw_drivers
       The download and installation procedure is available in the Mellanox OFED User Manual
    2) Provider - Mellanox CIM Provider version 1.2.4 or higher, from
       the Common Information Model at www.mellanox.com :
       http://www.mellanox.com/page/products_dyn?product_family=131&mtag=common_information_model
       or from the Software Delivery Repository of Linux WBEM Providers for
       HPE Integrity Superdome X at :
       http://downloads.linux.hpe.com/SDR/repo/bl920-wbem/suse/

===================
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 system with "root" privileges and follow the instructions
below for a new (first-time) installation of WBEM Providers.


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

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

    (a) The following packages must be installed prior to WBEM Providers
        installation:
        - OpenIPMI 
        - sblim-sfcb
        - policycoreutils
        - libxml2-python
        - SQLite
        - libevent API Package
        - openwman-server (If you plan to use HPE Insight Remote Support)

        Additional dependencies for SLES15 SP1 or higher:
        - pmisc
        - python-xml
        - libcimcClientXML0
        - libcimcclient0
        - libcmpisfcc1
 

    Note: For SLES 12 and later, the OpenWSMAN must be atleast
          at version 2.4.11-2. Refer to Linux WBEM providers of HPE Integrity
          Superdome X Release Notes for additional information.

    Note: In order to use openwsman-server on SLES12 SP4 and SLES12 SP5
          with WBEM Providers, download the following rpm from SDR site:
          http://downloads.linux.hpe.com/repo/bl920-wbem/suse/
          libwsman1-2.4.11-21.8.1.20041.3.PTF.1157655.x86_64.rpm
          openwsman-server-2.4.11-21.8.1.20041.3.PTF.1157655.x86_64.rpm
          Use the following commands to install the same:
          # rpm -e libwsman1 openwsman-server
          # rpm -ivh libwsman1 openwsman-server

        To check if the above packages are installed, use the following command:
        # rpm -qa | grep -i -e openipmi -e sblim-sfcb -e openwsman-server \
        > -e sqlite3 -e policycoreutils -e libevent

        If the one or more packages are not installed use the following 
        command to install the packages:
        # yast -i OpenIPMI sblim-sfcb openwsman-server sqlite3 \
        > policycoreutils libevent
 
    Note: In order to use Infiniband on SLES11 with WBEM Providers
          version >= 60 , download the following sblim-sfcb version
          sblim-sfcb-1.4.9-0.28.1.14342.0.PTF.1045366, from SDR site:
          http://downloads.linux.hpe.com/repo/bl920-wbem/suse/
          Use the following commands to install the same:
          # rpm -e sblim-sfcb
          # rpm -ivh sblim-sfcb-1.4.9-0.28.1.14342.0.PTF.1045366.x86_64.rpm

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

    (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, 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

    (d) If you are using an HP InfiniBand FDR 2-port 545M Adapter, you must
        install -
        i.  The MLNX_OFED drivers from the Linux SW/Drivers at www.mellanox.com
            Follow the instalation procedure from the Mellanox OFED User Manual
        ii. The Mellanox CIM Provider version 1.2.4 or higher:
            # rpm -ivh MLNX_CIMProvider-1.2.4-009.x86_64.rpm


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) Install the hpshd package:
      # rpm -ivh hpshd-<version>.<distro>.<arch>.rpm

  (c) 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

  (d) For HPE Insight Remote Support (IRS), 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:
    # ps -ef|grep sfcb

If you see an output like "/usr/sbin/sfcbd -d" 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 support the upgrade functionality for all constituent packages on the 
- SUSE Linux Enterprise Server 11 SP3
- SUSE Linux Enterprise Server 11 SP4
There is a known issue of sblim-sfcb on SUSE Linux Enterprise Server 12 and above, that prevents
the upgrade functionality for WBEM Providers packages. Refer to the known issue "[SLES 12] HP-SMX
may not upgrade correctlyfrom version 56 and above, if HPSHD is also installed on the system." in
the Release Notes for further details.

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 hp

    (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 SLES 11 and above:
           # /etc/init.d/hpshd stop
           # /etc/init.d/sfcb stop
           # /etc/init.d/hpmgmtbase stop

           For SLES 12 and above:
           # systemctl stop hpshd
           # systemctl stop sblim-sfcb.service
           # systemctl stop hpmgmtbase

        2) Erase the following RPMs from the system 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 version of hpmgmtbase, hp-smx and hpshd rpms:
           # 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) For SLES 11 SP3 and SP4:
        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) For SLES 11 SP3 and SP4:
        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


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

If you need to uninstall the WBEM Providers from your 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 hpshd hp-smx hpmgmtbase
        # 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-