Intel(R) RSTe with Linux OS CIM provider Files

Copyright 2011 Intel Corporation All Rights Reserved.

Installing Intel(R) RSTe with Linux OS* CIM provider


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
Table of Contents
1. Dependences
2. Registration of schema DMTF 2.25 experimental
3. Installing CIMPLE
4. Installing Intel RSTe with Linux OS* SSI Library API
5. Installing Intel RSTe with Linux OS* CIM provider
6. Provider registration
7. Test using comand line client
8. Configurations
9. Scientific Linux Security Edition
10. Installing from binary packages
11. Comments

**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****

Overview

The Common Information Model (CIM) is an open standard that defines
how managed elements in an IT environment are represented
as a common set of objects (schema) and relationships between them.
This is intended to allow consistent management of these managed elements,
independent of their manufacturer or provider.

The CIM standard is defined and published by the Distributed
Management Task Force (DMTF)

Intel(R) RSTe with Linux OS* CIM provider allows third party
systems/storage management applications to manage IMSM software RAID.


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
1. Dependences

a. Dependences for RHEL

To build CIM provider from source code the one are required
- packages:
    sg3_utils-devel,
    tog-pegasus,
    tog-pegasus-devel,
    sblim-cmpi-devel
- header file StringConversion.h from tog-pegasus-devel package
- Intel Rapid Storage Technology enterprise
  with Linux OS* Storage Interface Standard Library API
  (http://sourceforge.net/projects/irstessi/)
- SimpleWBEM sources (http://simplewbem.org/cimple-2.0.16.tar.gz)

b. Dependences for SLES

To build CIM provider from source code the one are required
- packages:
    sg3_utils-devel,
    cmpi-bindings-pywbem,
    cmpi-provider-register,
    cmpi-pywbem-base,
    cmpi-pywbem-power-management,
    icmpinfo,
    libcmpiCppImpl0,
    libsblim-cmpiutil1,
    python-pywbem,
    sblim-sfcb,
    sblim-sfcc,
    sblim-wbemcli,
    sblim-cmpi-base,
    sblim-cmpi-c++-devel,
    sblim-cmpi-devel,

- Intel Rapid Storage Technology enterprise
  with Linux OS* Storage Interface Standard Library API
  (http://sourceforge.net/projects/irstessi/)

- SimpleWBEM sources (http://simplewbem.org/cimple-2.0.16.tar.gz)


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
2. Registration of schema DMTF 2.25 experimental

The official schema version can be downloaded from
http://www.dmtf.org/sites/default/files/cim/cim_schema_v2250
     /cim_schema_2.25.0Experimental-MOFs.zip

a. RHEL

Unzip archive cim_schema_2.25.0Experimental-MOFs.zip

Register this schema in root/Intel_RST namespace by executing commands:

cimmof -aE -n "root/Intel_RST" qualifiers.mof
cimmof -aE -n "root/Intel_RST" cim_schema_2.25.0.mof

b. SLES

Unzip schema archive to system specific directory:

mkdir -p /opt/schema/cimv2.25.0exp
cd  /opt/schema/cimv2.25.0exp
unzip cim_schema_2.25.0Experimental-MOFs.zip
ln -s cim_schema_2.25.0.mof CIM_Schema.mof


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
3. Installing CIMPLE

Download SimpleWBEM sources from http://simplewbem.org/cimple-2.0.16.tar.gz

Untar SimpleWBEM and go to the created directory cimple-2.0.16

Run configure command with parameters shown below

a. RHEL

./configure --host=x86_64-unknown-linux-gnu \
  --prefix=/usr/lib64 \
  --with-pegasus-libdir=/usr/lib64 \
  --with-pegasus-includes=/usr/include/Pegasus \
  --with-cmpi=/usr/include/cmpi \
  --enable-embedded-instances

Run "make" and then "make install"

b. SLES

./configure --host=x86_64-unknown-linux-gnu \
  --prefix=/opt/cimple \
  --with-cmpi=/usr/include/cmpi \
  --with-schema=/opt/schema/cimv2.25.0exp \
  --enable-static \
  --enable-embedded-instances

Run "make" and then "make install"


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
4. Installing Intel RSTe with Linux OS* SSI Library API

Unpack SSI sources, go to the created directory ssi and run commands:

./autogen.sh

./configure --libdir='${prefix}/lib64'

Run "make" and then "make install"

Export PKG_CONFIG_PATH environment variable,
set it to $PREFIX/lib64:$PKG_CONFIG_PATH
where $PREFIX is set to the value indicating
head path to installed libraries


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
5. Installing Intel RSTe with Linux OS* CIM provider

Go to cim's source code directory,
build and install CIM by executing commands:

./autogen.sh

a. RHEL

./configure \
  --enable-static \
  --with-simplewbem-lib-dir=/usr/lib64 \
  --with-simplewbem-include-dir=/usr/include \
  --with-cmpi-include-dir=/usr/include/cmpi \
  --with-cmpi-lib-dir=/usr/lib64

Run "make" and then "make install"

Prepare the provider before registering it with OpenPegasus
mv /usr/lib64/libirstcmpirovider.* /usr/lib64/Pegasus/providers

b. SLES

./configure \
  --libdir='${prefix}/lib64' \
  --with-simplewbem-include-dir=/opt/cimple/include \
  --with-simplewbem-lib-dir=/opt/cimple/lib64

Run "make" and then "make install"


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
6. Provider registration

a. RHEL

Once provider library was installed
one should register it using Cimple /usr/bin/regmod tool.
Run the command below to register the provider

regmod -c -n root/Intel_RST /usr/lib64/Pegasus/providers/libirstcmpiprovider.so

b. SLES

sfcbstage -n root/intel_rst -r MOFs/RST/intel_rst.reg MOFs/RST/intel_rst.mof
sfcbstage -n root/interop -r MOFs/RST/intel_interop.reg MOFs/RST/intel_interop.mof
sfcbrepos -c /opt/schema/cimv2.25.0exp/ -f


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
7. Test using command line client

a. RHEL

Verify the provider is installed correctly by executing a command:

cimprovider -l -s

The IntelRST_Module should be on the list and returned status should be OK.

cimcli -n root/intel_rst ei RST_ProductHBA

or

wbemcli ei 'http://user:password@localhost:5988/root/Intel_RST:RST_ProductHBA'

to list information about Intel controllers,
("user" and "password" comes from OS account)

b. SLES

wbemcli ei 'http://user:password@localhost:5988/root/Intel_RST:RST_ProductHBA'

to list information about Intel controllers,
("user" and "password" comes from OS account)

Note.
If the method chosen to connect with cim server is configured to use a secured
connention one should use the following command line:

wbemcli ei 'https://user:password@localhost:5989/root/Intel_RST:RST_ProductHBA'


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
8. Configurations

a. RHEL

To choose which unix account can access Pegasus
edit the file /etc/Pegasus/access.conf
By default the http and https connection
is enabled only for Pegasus users
To add root to allow http connection change the line:
"-: ALL EXCEPT pegasus"
 to
"-: ALL EXCEPT pegasus root:wbemNetwork"

To enable http connection run following command:

cimconfig -p -s enableHttpConnection=true

Restart the tog-pegasus service for the changes to take effect:

service tog-pegasus restart

b. SLES

In section ProvidersDir: add directory holding provider binaries
i.e. /usr/local/lib64

Restart the sfcb server service fot the changed to take effect:

service sfcb restart


**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
9. Scientific Linux Security Edition

Because SELinux could give you a lost connection invoking
the provider recomended is to disable the SELinux service
by setting SELINUX=disabled in /etc/sysconfig/selinux
and then run command:

setenforce 0

Instead of disabling enforcement you can configure SELinux configuration to
suit your needs.

**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
10. Installing from binary packages

a. RHEL
Another way of installation of Intel(R) RSTe with Linux OS* CIM provider
on RHEL is by using binary packages. To do that
* downolad
- irstessi-1.0-1.el6.x86_64.rpm from http://sourceforge.net/projects/irstessi/files/RPM/
- irstecim-1.0-1.el6.x86_64.rpm from http://sourceforge.net/projects/intelrstecim/files/RPM/
* Issue instalation commands in shell
rpm -i irstessi-1.0-1.el6.x86_64.rpm
rpm -i irstecim-1.0-1.el6.x86_64.rpm

b. SLES
* downolad
- irstessi-1.0-1.x86_64.rpm from http://sourceforge.net/projects/irstessi/files/RPM/
- irstecim-1.0-1.x86_64.rpm from http://sourceforge.net/projects/intelrstecim/files/RPM/
rpm -i irstessi-1.0-1.x86_64.rpm
rpm -i irstecim-1.0-1.x86_64.rpm

**** **** **** **** **** **** **** **** **** **** **** **** **** **** ****
11. Comments
More information about this release can be found in RELEASE file.