V7000: SVCMON

SVCMON is a perl based SAN monitoring solution for IBM.

General Installation notes(Note that there will be newer version available):
2-1. Install Linux
svcmon is tested with the following Redhat Enterprise Linux 5 installation.
[root@sspc bin]# cat /proc/version
Linux version 2.6.18-92.el5 ([email protected]) (gcc version 4.1.2 20071124 (Red Hat 4.1.2-41)) #1 SMP Tue Apr 29 13:16:12 EDT 2008
[root@sspc bin]#

2-2. Installion Perl
svcmon is tested with the following perl and its modules installation.
[root@sspc bin]# rpm -qa | grep perl
perl-Compress-Zlib-1.42-1.fc6
perl-BSD-Resource-1.28-1.fc6.1
mod_perl-2.0.2-6.3.el5
perl-Digest-SHA1-2.11-1.2.1
perl-Digest-HMAC-1.01-15
perl-Socket6-0.19-3.fc6
perl-IO-Zlib-1.04-4.2.1
perl-GD-2.41-2.el5.rf
perl-5.8.8-10.el5_0.2
perl-String-CRC32-1.4-2.fc6
perl-HTML-Parser-3.55-1.fc6
perl-Net-DNS-0.59-3.el5
perl-Net-SSLeay-1.30-4.fc6
perl-XML-Simple-2.14-4.fc6
perl-HTML-Tagset-3.10-2.1.1
perl-Net-IP-1.25-2.fc6
perl-SGMLSpm-1.03ii-16.2.1
perl-DBI-1.52-1.fc6
perl-DBD-MySQL-3.0007-1.fc6
perl-XML-Parser-2.34-6.1.2.2.1
perl-GD-Graph-1.43-1.2.el5.rf
perl-IO-Socket-INET6-2.51-2.fc6
newt-perl-1.08-9.2.2
perl-Archive-Tar-1.30-1.fc6
perl-DBD-Pg-1.49-1.fc6
perl-GDTextUtil-0.86-1.el5.rf
perl-URI-1.35-3
perl-libwww-perl-5.805-1.1.1
perl-IO-Socket-SSL-1.01-1.fc6
perl-Time-Piece-1.13-1.el5.rf
[root@sspc bin]#

2-3. Install PostgreSQL
svcmon is tested with the following PostgreSQL installation.
[root@sspc bin]# rpm -qa | grep postgresql
postgresql-libs-8.1.11-1.el5_1.1
postgresql-8.1.11-1.el5_1.1
postgresql-python-8.1.11-1.el5_1.1
postgresql-server-8.1.11-1.el5_1.1
[root@sspc bin]#

2-4. Install ssh
svcmon is tested with the following ssh installation. After installation, you need to register your ssh key to your SVC / Storwize V7000 cluster.
[root@sspc bin]# rpm -qa | grep ssh
openssh-askpass-4.3p2-26.el5
openssh-4.3p2-26.el5
openssh-clients-4.3p2-26.el5
openssh-server-4.3p2-26.el5
[root@sspc bin]#

2-5. Install xsltproc
svcmon is tested with the following xsltproc installation.
[root@sspc bin]# rpm -qa | grep xslt
libxslt-1.1.17-2
libxslt-python-1.1.17-2
libxslt-devel-1.1.17-2
[root@sspc bin]#

2-6. Install svcmon
Create directories and place svcmon files as follows. /svcmon/report directory needs to be mode drwxrwxrwx, since user postgres is going to create files in this directory:
[root@sspc bin]# ls -alR /svcmon
/svcmon:
total 32
drwxr-xr-x 7 root root 4096 Nov 13 10:52 .
drwxr-xr-x 26 root root 4096 Nov 13 10:52 ..
drwxr-xr-x 2 root root 4096 Nov 13 10:52 backup
drwxr-xr-x 2 root root 4096 Nov 13 10:54 bin
drwxr-xr-x 2 root root 4096 Nov 13 10:54 config
drwxr-xr-x 2 root root 4096 Nov 16 05:59 iostats
drwxr-xr-x 2 root root 4096 Nov 13 10:52 report
/svcmon/backup:
total 8
drwxr-xr-x 2 root root 4096 Nov 13 10:52 .
drwxr-xr-x 7 root root 4096 Nov 13 10:52 ..
/svcmon/bin:
total 120
drwxr-xr-x 2 root root 4096 Nov 13 10:54 .
drwxr-xr-x 7 root root 4096 Nov 13 10:52 ..
-rw-r–r– 1 root root 7098 Nov 12 15:59 svcconfig.pl
-rw-r–r– 1 root root 1301 Feb 23 2008 svcconfig.xsl
-rw-r–r– 1 root root 19102 Nov 12 15:16 svcdb.pl
-rw-r–r– 1 root root 22025 Nov 12 16:23 svcperf.pl
-rw-r–r– 1 root root 50622 Nov 12 15:59 svcreport.pl
/svcmon/config:
total 12
drwxr-xr-x 2 root root 4096 Nov 13 10:54 .
drwxr-xr-x 7 root root 4096 Nov 13 10:52 ..
-rw-r–r– 1 root root 316 Feb 20 2008 svcconfig.css
/svcmon/iostats:
total 8
drwxr-xr-x 2 root root 4096 Nov 16 05:59 .
drwxr-xr-x 7 root root 4096 Nov 13 10:52 ..
/svcmon/report:
total 8
drwxrwxrwx 2 root root 4096 Nov 16 07:42 .
drwxr-xr-x 7 root root 4096 Nov 13 10:52 ..
[root@sspc bin]#

2-7. Verify installation

Verify Perl installation
Change current directory to /svcmon/bin and use the perl command as follows:
[root@sspc bin]# perl -v
This is perl, v5.8.8 built for i386-linux-thread-multi
Copyright 1987-2006, Larry Wall
Perl may be copied only under the terms of either the Artistic License or the
GNU General Public License, which may be found in the Perl 5 source kit.
Complete documentation for Perl, including FAQ lists, should be found on
this system using “man perl” or “perldoc perl”. If you have access to the
Internet, point your browser at http://www.perl.org/, the Perl Home Page.
[root@sspc bin]#
If you see a similar screen, Perl installation is OK.

Verify PostgreSQL installation
Change current directory to /svcmon/bin and use the psql command as follows:
[root@sspc bin]# psql -U postgres
Welcome to psql 8.1.11, the PostgreSQL interactive terminal.
Type: copyright for distribution terms
h for help with SQL commands
? for help with psql commands
g or terminate with semicolon to execute query
q to quit
postgres=# q
[root@sspc bin]#
If you see a similar screen, PostgreSQL installation is OK.

Verify svcmon installation
Change current directory to /svcmon/bin and use the svcdb.pl command as follows:
[root@sspc bin]# perl svcdb.pl –help
Syntax
>>- perl svcdb.pl —+- –create—————+———————–>
‘- –backup ————–‘
‘- –restore – file_name -‘
‘- –list —————-‘
>–+————————–+—————————————->
‘- –dir – directory_name -‘
>–+————————+—+—————————-+———>
‘- –dbhost – host_name -‘ ‘- –dbname – database_name -‘
>–+————————+—+———————-+—————>
‘- –dbuser – user_name -‘ ‘- –dbpwd – password -‘
>–+———-+—+———+—————————————–><
‘- –help -‘ ‘- –man -‘
Invocation examples
perl svcdb.pl –create –dbhost localhost –dbname svcdb –dbuser postgres –dbpwd password
perl svcdb.pl –create
perl svcdb.pl –backup –dir /svcmon/backup/ (or C:svcmonbackup) –dbhost localhost –dbname svcdb –dbuser postgres –dbpwd password
perl svcdb.pl –backup
perl svcdb.pl –restore svcdb_20080101_000000 –dir /svcmon/backup/ (or C:svcmonbackup) –dbhost localhost –dbname svcdb –dbuser postgres –dbpwd password
perl svcdb.pl –restore svcdb_20080101_000000
perl svcdb.pl –list –dbhost localhost –dbname svcdb –dbuser postgres –dbpwd password
perl svcdb.pl –list
* Use “perl svcdb.pl –man” for more details.
[root@sspc bin]#
If you see a similar screen, svcmon installation is OK

The following applications and modules caused me issues and took some troubleshooting to get everything running properly:

xsltproc
libxslt
There will be several perl package that will need to be located and installed separately:
DBI
DBD
XML-Pg
XML-Parser
perl-XML-Simple
perl-Catalyst
per-GDGraph

Usage commands:
From svcmon/bin/
perl svcperf.pl –svc V7000DNSNAME
* Note what time you start the data collection

Use: Ctrl + c to stop the data collection

Create the report
perl svcreport.pl –cluster V7000DNSNAME –from “2013-03-07 8:40:00”

Report information can be found in svcmon/reports

Before creating a new report, to keep things clean I run:
“rm -f ../report/*” from svcmon/bin/