Hitachi storage installation
Back to storage installation home.
In case of usage of
Virtual Appliance
- Use local account lpar2rrd for hosting of STOR2RRD on the virtual appliance
- Use /home/stor2rrd/stor2rrd as the product home
- Use lpar2rrd account on storage as it is configured in /home/stor2rrd/stor2rrd/etc/stor2rrd.cfg (STORAGE_USER)
- Replace lpar2rrd by stor2rrd user in all examples below.
The program uses
Hitachi Storage Navigator Modular 2 CLI interface (HSNM2 CLI).
The CLI is included in the same CD from where you got the SNM GUI. If you dont have the CD you should ask HDS for the SNM CD (usually distributed as an ISO image). It has the CLI in it.
Allow TCP/IP communication from STOR2RRD host to all Hitachi storage on port
2000 (28355 when using secure communication)
Install HSNM2 CLI
- HSNM2 CLI apparently needs libstdc++ package. Assure that it is installed.
You have to install it even in case of usage Virtual Appliance 1.10 as it does not contain it (1.20 is ok).
$ rpm -qa|grep libstdc++
libstdc++-4.8.3-9.el7.x86_64
Install it if it is not listed:
# yum install libstdc++ # (RedHat, prp. Debian/Ubuntu )
# apt-get install libstdc++ # (Debian/Ubuntu )
- Get HSNM2 CLI package for your operating system and install it under root:
# mkdir /usr/stonavm/
# cd /usr/stonavm/
# tar xf /tmp/HSNM2-2810-A-CLI-P01.tar
# chown stor2rrd /usr/stonavm # This must be owned by stor2rrd !!!!
- Set environment in your actual shell (just copy&paste to the cmd line)
LIBPATH=/usr/stonavm/lib:$LIBPATH
SHLIB_PATH=/usr/stonavm/lib:$SHLIB_PATH
LD_LIBRARY_PATH=/usr/stonavm/lib:$LD_LIBRARY_PATH
STONAVM_HOME=/usr/stonavm
STONAVM_ACT=on
STONAVM_RSP_PASS=on
PATH=$PATH:/usr/stonavm
export LIBPATH SHLIB_PATH LD_LIBRARY_PATH STONAVM_HOME STONAVM_ACT STONAVM_RSP_PASS PATH
- Register the storage systems to be monitored (adjust IPs in below examples)
-
Create user stor2rrd (lpar2rrd when you use Appliance) on the storage (storage admin with read role)
-
Register user access for the storage
# auaccountenv -set -uid stor2rrd -authentication
-
Test connectivity
# auunitref
# auunitinfo -unit HUS110
STOR2RRD storage configuration
-
Let run the storage agent for 15 - 20 minutes to get data, then:
$ cd /home/stor2rrd/stor2rrd
$ ./load.sh
- Go to the web GUI: http://<your web server>/stor2rrd/
Use Ctrl-F5 to refresh the web browser cache.
Allow TCP/IP communication from STOR2RRD host to all Hitachi storage on port
1099,
31001 and
51100
The program uses two Hitachi APIs. You have to install both of them.
- Command Control Interface (CCI)
- Hitachi Export tool
Installation of Hitachi CCI
Obtain CCI installation package from your Hitachi representatives.
- Insert the installation media into the proper I/O device. Move to the desired directory for CCI (under root)
# mkdir /opt
# cpio -idmu < /dev/XXXX # where XXXX = I/O device with install media
# ln -s /opt/HORCM /HORCM
- Execute the CCI installation command:
-
Verify installation of the proper version using the raidqry command:
# raidqry -h
Model: RAID-Manager/HP-UX
Ver&Rev: 01-29-03/05
Usage: raidqry [options]
-
Assure that everything is executable and writeable by stor2rrd user (it will be started under stor2rrd).
This is a must! Under root identification execute this:
# touch /HORCM/etc/USE_OLD_IOCT
# chown -R stor2rrd /HORCM/log* /HORCM/.uds /HORCM/usr
# chmod 755 /HORCM/usr/bin /HORCM/usr/bin/* /HORCM/log /HORCM/etc/horcmgr /HORCM/etc/*conf /HORCM/.uds/ /HORCM/.uds/*
Configuration of CCI
- CCI communication with storage can be done either via LAN (it is something described below) or via command device (SAN attached volume from the storage).
When you have many storage in place 40+ then use rather command device as LAN communication might not be reliable enough
- Each storage must have its own config file /etc/horcmXX.conf
- Check if local ports 10001 and 10002 are not used (nothing is listening there)
# netstat -an|grep -i listen| egrep "11001|11002"
- storage with IP 192.168.1.1, conf file /etc/horcm1.conf will use local port 11001 (UDP)
Use storage node IP. SVP IP must be used in etc/storage-list.cfg further.
# vi /etc/horcm1.conf
HORCM_MON
# ip_address service poll(10ms) timeout(10ms)
localhost 11001 1000 3000
HORCM_CMD
# dev_name dev_name dev_name
\\.\IPCMD-192.168.1.1-31001
- storage with IP 192.168.1.10, conf file /etc/horcm2.conf
change localhost port to 11002 (from 11001 which is used above)
# vi /etc/horcm2.conf
HORCM_MON
# ip_address service poll(10ms) timeout(10ms)
localhost 11002 1000 3000
HORCM_CMD
# dev_name dev_name dev_name
\\.\IPCMD-192.168.1.10-31001
- Start it under stor2rrd account (definitelly not under root!). Use lpar2rrd account on the Virtual Appliance
This starts HORM instance 1 (/etc/horcm1.conf)
# su - stor2rrd # (lpar2rrd user on the Virtual Appliance)
$ /HORCM/usr/bin/horcmstart.sh 1
- Start HORM instance 1 & 2 (/etc/horcm1.conf & /etc/horcm2.conf)
# su - stor2rrd # (lpar2rrd user on the Virtual Appliance)
$ /HORCM/usr/bin/horcmstart.sh 1 2
- Check if they are running
$ ps -ef | grep horcm
stor2rrd 19660912 1 0 Feb 26 - 0:03 horcmd_02
stor2rrd 27590770 1 0 Feb 26 - 0:09 horcmd_01
- Place it into operating system start/stop scripts
# su - stor2rrd -c "/HORCM/usr/bin/horcmstart.sh 1 2"
# su - stor2rrd -c "/HORCM/usr/bin/horcmshutdown.sh 1 2"
Installation of Hitachi Export Tool
It is typically located on a CD that comes packaged with the Service Processor on the HDS USP Array. The Export Tool can also be obtained by contacting HDS support.
(CD location: /ToolsPack/ExportTool)
Hitachi produces a new Export Tool for each release of the firmware. So unless you make sure all of the storage are running on the same firmware version then you will need to obtain the appropriate version of the Export Tool to meet the firmware version you are running at the site.
Find our firmware release of your storage (83-01-28/00) identified by /etc/horcm1.conf (-I1):
Under stor2rrd account!
# su - stor2rrd # (lpar2rrd user on the Virtual Appliance)
$ raidcom -login $login $paswd -I1
$ raidqry -l -I1
No Group Hostname HORCM_ver Uid Serial# Micro_ver Cache(MB)
1 --- localhost 01-35-03-08 0 471234 83-01-28/00 320000
$ raidcom -logout -I1
Install each version of the Export Tool into separate directory named as firmware of your storage (just 6 numbers like in this example firmware 83-01-28) under root user:
# mkdir /opt/hds
# mkdir /opt/hds/83-01-28
# cd /opt/hds/83-01-28
# tar xvf export-tool.tar
# chown -R stor2rrd /opt/hds
Directory /opt/hds is optional, it is configurable in /home/stor2rrd/stor2rrd/etc/sto2rrd.cfg : VSP_CLIDIR=/opt/hds
The HDS Performance Monitor License must exist for each array and monitoring must be enabled.
Storage configuration example
STOR2RRD storage configuration
-
Let run the storage agent for 15 - 20 minutes to get data, then:
$ cd /home/stor2rrd/stor2rrd
$ ./load.sh
- Go to the web GUI: http://<your web server>/stor2rrd/
Use Ctrl-F5 to refresh the web browser cache.