Installation Guide

STORMONS v1.3 Installation Guide 12/01/2012 STORMONS SARL

Stormons Sarl | 4 Impasse du Planson | 38080 FOUR FRANCE Email : [email protected] | Internet : www.stormons.com

STORMONS CONSOLE v1.3

Stormons Sarl. Email : [email protected] | Internet : www.stormons.com Page 1 / 38

STORMONS Installation Guide, Jun 2011, Made in France.

Stormons company provides this publication as is without warranty of any kind, either express or implied. This publication may be updated from time to time without notice.

STORMONS is distributed under the Terms of the GNU General Public License Version 3.

(www.gnu.org/copyleft/gpl.html)

COPYRIGHT STATEMENT

Copyright 2009-2010 Stormons. Stormons, and the Stormons logo are trademarks, servicemarks, registered servicemarks or registered trademarks

of Stormons SARL.

TRADEMARK STATEMENT

Different trademarks may be mentioned herein which belong to other companies.

EMC,CLARiiON, FLARE,Celerra,Navisphere,Symmetrix are registered trademarks, SnapView,MirrorView are

trademarks of EMC Corporation.

Data ONTAP,FilerView,FlexClone,FlexVol and SnapVault are registered trademarks, Network Appliance, RAID-

DP, and Snapshot are trademarks of Network Appliance, Inc.



Contents

1 Introduction ................................................................................................................................4

2 Minimum System Requirements ..................................................................................................5

2.1 Supported Operating Systems .................................................................................................5

2.2 Hardware Requirements .........................................................................................................5

2.3 Web Server ............................................................................................................................5

2.4 Data Repository......................................................................................................................5

2.5 Perl ........................................................................................................................................5

3 Vendors and Storage Array Models supported .............................................................................6

3.1 Supported EMC Models .........................................................................................................6

3.2 Supported NetApp Models .....................................................................................................6

3.3 Supported Brocade Models .....................................................................................................7

4 Product Architecture ...................................................................................................................8

5 Installation instructions ............................................................................................................. 10

5.1 Download Product ................................................................................................................ 10

5.2 Licensing ............................................................................................................................. 10

5.3 Windows Installation from Stormons binaries (32bis or 64bits) ............................................ 11

5.4 Windows Installation from Stormons Perl Sources code (32bits or 64bits) ............................ 13

5.5 Linux Installation from Stormons Perl Sources code (32bits or 64bits) .................................. 17

6 Install Web Server ..................................................................................................................... 20

6.1 Apache Configuration .......................................................................................................... 20

6.1.1 The minimum set ......................................................................................................... 20

6.1.2 Example of a virtual host.............................................................................................. 21

7 Test Installation......................................................................................................................... 22

8 First Configuration .................................................................................................................... 23

8.1 First start .............................................................................................................................. 23

8.2 Create default configuration file ........................................................................................... 23

8.3 Site Configuration ................................................................................................................ 25

8.4 Adding a storage device ....................................................................................................... 26

8.4.1 NetApp Device Form ................................................................................................... 27

8.4.2 EMC Clarrion or VNX Form ...................................................................................... 28

8.4.3 EMC Celerra NAS Form ............................................................................................. 29

8.4.4 EMC Symmetrix or Vmax Form ................................................................................. 30



8.4.5 Brocade San Switch Form ............................................................................................ 31

8.4.6 Managing defined devices ............................................................................................ 32

8.5 Poller configuration .............................................................................................................. 33

8.5.1 Location....................................................................................................................... 33

8.6 Configuration for Stormons Windows binaries (32bis or 64bits) .......................................... 33

8.6.1 Set STORMONS_HOME environment variable ........................................................... 33

8.6.2 Register Stormons as Windows Services ...................................................................... 33

8.6.3 Change default Characteristic of services ..................................................................... 34

8.6.4 Start Stormons Services ............................................................................................... 34

8.7 Configuration for Stormons Windows Perl Sources code (32bits or 64bits) ........................... 35

8.7.1 Set STORMONS_HOME environment variable ........................................................... 35

8.7.2 Put NT resource kit in place ......................................................................................... 35

8.7.3 Add a new service using command line ........................................................................ 35

8.7.4 Change default Characteristic of services ..................................................................... 35

8.7.5 Modify registry to add perl script in service .................................................................. 36

8.7.6 Start Stormons Services ............................................................................................... 36

8.8 Configuration on Debian or Ubuntu ...................................................................................... 37



1 Introduction

Thank you for your interest in Stormons . We appreciate your choice and truly believe our product

will bring more value to your business.

Stormons tools are dedicated to the Storage Administrator. Stormons is a Simple and Reliable

product for reporting Array Status and Configuration.



2 Minimum System Requirements

You must ensure that the computer on which you plan to install Stormons meets minimum system

requirements for the program to operate correctly.

2.1 Supported Operating Systems

Stormons V1.3.x Windows Server 2003

2.2 Hardware Requirements

Stormons V1.3.x X86 computer Memory : 2GB

2.3 Web Server

Apache Version 2.x

2.4 Data Repository

Storage disk Space The repository for Stormons is a directory tree and uses approximately 4MB / day / array.

2.5 Perl

Version Version 5.14 or later is required. On Windows system this is only required if you prefer to use Stormons Source code rather than binary



3 Vendors and Storage Array Models supported

3.1 Supported EMC Models

Highrange Storage

VMAX ( Symcli 7 )

Midrange Storage

VNX7500 Flare 31 ->

VNX5700 Flare 31 ->

VNX5500 Flare 31 ->

VNX5300 Flare 31 ->

VNX5100 Flare 31 ->

CX500, CX700 Flare 19 -> 28

CX3/xxx Flare 19 -> 28

CX4/xxx Flare 29 -> 30

Midrange NAS

VNX7500 DartOS 7.xx

VNX5700 DartOS 7.xx

VNX5500 DartOS 7.xx

VNX5300 DartOS 7.xx

VNX5100 DartOS 7.xx

Celerra NS DartOS 5-> 6.xx

3.2 Supported NetApp Models

Midrange Storage

FAS 250, FAS270 Data ONTAP 7G

FAS 20xx Data ONTAP 7G

FAS30xx, FAS 31xx Data ONTAP 7G et 8G (7-mode)

High-End Storage

FAS 60xx Data ONTAP 7G et 8G (7-mode)



3.3 Supported Brocade Models

Midrange Device

All switch From FOS 6.0

High-End Device

All switch From FOS 6.0



4 Product Architecture

Stormons provides a web based user interface and binary applications to poll the storage

environment.

Stormons uses the following:

ONTAP API

o to collect information from NetApp Devices

SSH

o to collect information from Brocade Switch

o to collect information from Celerra Control Station Device

NAVISECCLI

o to collect information from VNX

o to collect information from Clariion Device s



SYMCLI

o to collect information from VMAX

SNMP

o to collect performance information from NetApp Device

o to collect performance information from Brocade San Switch

Operates on Windows ( 32 or 64 bits )

Operates on Linux ( 32 or 64 bits )

Plugin NRPE to communicate with Nagios

XML Repository ( no database to maintain )

RRD files to store capacity information



5 Installation instructions

5.1 Download Product

STORMONS is available for download at: http://www.stormons.com/downloads

The installation download is in a zip file format.

5.2 Licensing STORMONS is distributed under the Terms of the GNU General Public License Version 3. (www.gnu.org/copyleft/gpl.html)



5.3 Windows Installation from Stormons binaries (32bis or 64bits) A. Download zip file marked as win_32bits.zip or win_64bits.zip

B. Extract zipfile to final destination

C. Rename directory

From stormons_1.3.x_xxxx_win_32bits to SM1.3

From stormons_1.3.x_xxxx_win_64bits to SM1.3

You will see something like this:

C:\tools\SM1.3>dir Rpertoire de C:\tools\SM1.3 02/09/2012 15:58 . 02/09/2012 15:58 .. 02/09/2012 15:58 bin 02/09/2012 15:58 config 02/09/2012 15:58 docs 02/09/2012 15:58 http 02/09/2012 15:58 logs 02/09/2012 16:05 repository



D. Set System Variables

STORMONS_HOME = c:\tools\SM1.3

VERSIONER_PERL_PREFER_32_BIT = yes (only for 64bits system )

Installation Completed



5.4 Windows Installation from Stormons Perl Sources code (32bits or

64bits) A. Download and install ActivePerl from activestate

http://www.activestate.com/activeperl

Select free downloads

Choose to download the version Perl 5.14

B. Check your Perl Version ( Perl V5.14 or later is required )

C: >perl -v This is perl 5, version 14, subversion 2 (v5.14.2) built for MSWin32-x86-multi-thread (with 1 registered patch, see perl -V for more detail) Copyright 1987-2011, Larry Wall Binary build 1402 [295342] provided by ActiveState http://www.ActiveState.com Built Oct 7 2011 15:49:44 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.

C. Install Perl Libraries via PPM (Perl Package Manager from ActivePerl )

ppm install Archive::Zip ppm install CGI ppm install Crypt::CBC ppm install Cwd ppm install Digest::MD5 ppm install File::Copy::Recursive ppm install File::Copy ppm install File::Basename ppm install File::Next ppm install File::Path ppm install Getopt::Long ppm install LWP::UserAgent ppm install MIME::Base64 ppm install MIME::Tools ppm install Net::SMTP ppm install Sys::Hostname ppm install Socket ppm install Time::Local ppm install threads ppm install threads::shared ppm install Time::HiRes



ppm install URI::Escape::XS ppm install XML::Parser ppm install XML::LibXML ppm install XML::LibXML::Simple ppm install Crypt::Blowfish ppm install Crypt::Blowfish ppm install Imager

D. Download zip file marked as src.zip

E. Extract zipfile to final destination

F. Rename directory

From stormons_1.3.x_xxxx_src to SM1.3




C:\tools\SM1.3>dir Le volume dans le lecteur C s'appelle System Le numro de srie du volume est 500A-ED9A Rpertoire de C:\tools\SM1.3 02/09/2012 15:58 . 02/09/2012 15:58 .. 02/09/2012 15:58 bin 02/09/2012 15:58 config 02/09/2012 15:58 docs 02/09/2012 15:58 http 02/09/2012 15:58 logs 02/09/2012 16:05 repository 0 fichier(s) 0 octets 8 Rp(s) 81 115 746 304 octets libres

G. Go to bin directory and make test, you will see this

C:\tools\SM1.3>perl SMEngine.pl -help you must set the STORMONS_HOME environment variable before you run the application.

H. Set System Variables

STORMONS_HOME = c:\tools\SM1.3



I. Make new test, you will see this

C:\tools\SM1.3\bin>perl SMEngine.pl help ERROR: Config file not found ! [C:\tools\SM1.3\config\stormons.xml] Check file ...




5.5 Linux Installation from Stormons Perl Sources code (32bits or 64bits) A. Download zip file marked src.zip

B. Extract zipfile to final destination

C. Rename directory

From stormons_1.3.x_xxxx_src to SM1.3


root@nikita:/tools/SM1.3# ls -la total 32 drwxr-xr-x 8 root root 4096 sept. 2 17:21 . drwxr-xr-x 4 root root 4096 sept. 2 19:41 .. drwxr-xr-x 2 root root 4096 sept. 2 17:20 bin drwxr-xr-x 2 root root 4096 sept. 2 17:20 config drwxr-xr-x 2 root root 4096 sept. 2 17:20 docs drwxr-xr-x 2 root root 4096 sept. 2 17:20 goodies drwxr-xr-x 6 root root 4096 sept. 2 17:21 http drwxr-xr-x 2 root root 4096 sept. 2 19:42 logs drwxr-xr-x 2 root root 4096 sept. 2 17:21 repository

D. Change permissions on /tools/SM1.3

root@nikita:/tools/SM1.3# chown R apache:apache /tools/SM1.3

E. Change execute permissions

root@nikita:/tools/SM1.3# chmod +x /tools/SM1.3/bin/*.exe root@nikita:/tools/SM1.3# chmod +x /tools/SM1.3/http/*.cgi

F. Check your Perl Version ( Perl V5.14 or later is required )

root@nikita:~# perl -v This is perl 5, version 14, subversion 2 (v5.14.2) built for x86_64-linux-gnu-thread-multi (with 53 registered patches, see perl -V for more detail) Copyright 1987-2011, 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.

G. Install Perl and Perl modules below via apt-get



apt-get install zlib1g-dev apt-get install libxml2-dev apt-get install libxml-libxml-perl apt-get install libpng12-dev

H. Install Perl libraries via CPAN

cpan install Archive::Zip; cpan install CGI; cpan install Crypt::CBC; cpan install Cwd; cpan install Digest::MD5; cpan install File::Copy::Recursive; cpan install File::Copy; cpan install File::Basename; cpan install File::Next; cpan install File::Path; cpan install File::Pid; cpan install Getopt::Long; cpan install LWP::UserAgent; cpan install MIME::Base64; cpan install MIME::Tools; cpan install Net::SMTP; cpan install Sys::Hostname; cpan install Socket; cpan install Time::Local; cpan install threads; cpan install threads::shared; cpan install Time::HiRes; cpan install URI::Escape::XS; cpan install XML::Parser; cpan install XML::LibXML; cpan install XML::LibXML::Simple; cpan install Crypt::Blowfish; cpan install Imager;

I. Go to bin directory and make test, you will see this

root@nikita:/tools/SM1.3/bin# ./SMEngine.pl -help you must set the STORMONS_HOME environment variable before you run the application.

J. set STORMONS_HOME environment variable and call program

root@nikita:/tools/SM1.3/bin#export STORMONS_HOME=/tools/SM1.3 root@nikita:/tools/SM1.3/bin# ./SMEngine.pl help ERROR: Config file not found ! [/tools/SM1.3/config/stormons.xml] Check file ...



6 Install Web Server STORMONS works on Apache 2 hosted on Windows server or Linux server.

You must install apache on your server before continuing.

6.1 Apache Configuration You will need to configure Apache by making changes to the distributed configuration file or you may

add a virtual host to your existing configuration.

6.1.1 The minimum set

6.1.1.1 Add Directory Set

Example with Stormons installed in c:\tools\SM1.3

SetEnv STORMONS_HOME "c:/tools/SM1.3" AllowOverride None Order allow,deny Options ExecCGI

6.1.1.2 Add Alias

Find the part and add line like this

Example with Stormons installed in c:\tools\SM1.3

Alias /stormons c:/tools/SM1.3/http Alias /capa_spk c:/tools/SM1.3/repository/capacity/spk Alias /perf_spk c:/tools/SM1.3/repository/performance/spk

6.1.1.3 Setting .cgi as cgi extension

Find the par and add line like this

AddHandler cgi-script .cgi



6.1.2 Example of a virtual host

If you are not installing STORMONS on a dedicated server, you may add a new virtual host to the

existing configuration by adding lines like this example:

with Stormons installed in c:\tools\SM1.3

ServerAdmin root@localhost ServerName www.domain.tld DocumentRoot c:/tools/SM1.3 SetEnv STORMONS_HOME "c:/tools/SM1.3" Alias /stormons c:/tools/SM1.3/http Alias /capa_spk c:/tools/SM1.3/repository/capacity/spk Alias /perf_spk c:/tools/SM1.3/repository/performance/spk AllowOverride None Order allow, deny AddHandler cgi-script .cgi

Options ExecCGI ErrorLog c:/tools/SM1.3/logs/apache.error.log LogLevel warn CustomLog c:/tools/SM1.3/logs/apache.access.log combined



7 Test Installation From a web browser like Firefox open the url http://yourwebservername/stormons/SMCheck.cgi

You will see this page :

( if you see any errors, correct them before proceeding further )



8 First Configuration

8.1 First start

From a web browser like Firefox open the url http://yourwebservername/stormons

You will see this page :

8.2 Create default configuration file To create the default configuration file:

A. Go to Config Menu

B. Select Settings then General in menu panel

C. Push the save button



8.3 Site Configuration A. Go to Config Menu

B. Select Settings then Paths in menu panel

You have to set the paths used by application

Repository Path ( default is < STORMONS Install Directory >/repository)

Naviseccli Binary Path ( following installation of Naviseccli )

SSH Binary Path (use ssh on linux and plink.exe on windows )

Dedicated Temporary Directory Path ( default is c:/temp/stormons on windows and

/var/tmp/stormons on linux )

be careful here, because Stormons periodically removes files and directories in the temporary directory. You must specify a dedicated temporary directory to prevent data loss.

Stormons does not create the directory automatically. you must create it from the system.

RRDtool Binary Path (if you're not familiar with this product you will find all the

information here (oss.oetiker.ch/rrdtool/)

o RRDtool Minimum version: 1.2.30

Push the save button



8.4 Adding a storage device

A. Go to Config Menu

B. Select Settings then Devices in menu panel

C. Click on Add button

The screen displayed may be different depending on the vendor and model.

Fill in the settings fields in order to allow STORMONS to request information for your device.



8.4.1 NetApp Device Form



8.4.2 EMC Clarrion or VNX Form



8.4.3 EMC Celerra NAS Form



8.4.4 EMC Symmetrix or Vmax Form



8.4.5 Brocade San Switch Form



8.4.6 Managing defined devices

Once recorded the devices will show up as follows:

Three buttons allow you to add modify or delete the defined device:

Modify Button Delete Button Add Button



8.5 Poller configuration

8.5.1 Location

The poller binary is located in the bin directory of STORMONS.

8.6 Configuration for Stormons Windows binaries (32bis or 64bits)

8.6.1 Set STORMONS_HOME environment variable

8.6.2 Register Stormons as Windows Services

Run MS-DOS command prompt as an administrator

C:\>cd C:\tools\SM1.3\bin C:\tools\SM1.3\bin>SMEngineSvc.exe --help STORMONS 1.3.2 ( Build : 3307 ) Copyright 2010-2012 Stormons, Sarl. SMEngineSVC.exe [--help] [--install] [--remove] --help : usage --install : install stormons windows service --remove : uninstall stormons windows service SMEngineSvc.exe -install [auto] to install the service, (optional: auto start) SMEngineSvc.exe -remove to remove the service C:\tools\SM1.3\bin>SMEngineSvc.exe --install Stormons Engine installed as Stormons Engine.



C:\tools\SM1.3\bin>

8.6.3 Change default Characteristic of services

go to Control Panel\All Control Panel Items\Administrative Tools\Services

A. Change Startup Type from Manual to Automatic

B. Change Recovery as follow

Fisrt failure : Restart the Service

Second failure : Restart the Service

Subsequent failures : Restart the Service

8.6.4 Start Stormons Services


Net start Stormons Engine



8.7 Configuration for Stormons Windows Perl Sources code (32bits or

64bits)

8.7.1 Set STORMONS_HOME environment variable

8.7.2 Put NT resource kit in place

Copy the window NT resource kit to C:\WINNT\. You can name it as you like but putting it as WINNT

will help you to recall in future. The Windows NT Resource Kit provides two utilities "INSTSRV.EXE"

and "SRVANY.EXE" that allow you to create a Windows NT user-defined service for Windows NT

applications.

INSTSRV: - Allows you to installs and removes system services from Windows NT.

SRVANY: - Allows any Windows NT application to run as a service.

8.7.3 Add a new service using command line

Run MS-DOS command prompt as an administrator as shown below, and run the following command

INSTSRV Stormons C:\WINNT\SRVANY.EXE

8.7.4 Change default Characteristic of services

go to Control Panel\All Control Panel Items\Administrative Tools\Services

A. Change Startup Type from Manual to Automatic

B. Change Recovery as follow



Fisrt failure : Restart the Service

Second failure : Restart the Service

Subsequent failures : Restart the Service

8.7.5 Modify registry to add perl script in service

Run MS DOS command prompt and type command REGEDIT. It will pop up a window. Follow the

path below and look for your service name Stormons:

HKEY_LOCAL_MACHINE -> SYSTEM -> CurrentControlSet -> Services -> Stormons

Add the new Key: Parameters

Select Parameters

Add the String Value: Application

String: C:\PERL\bin\perl.exe c:\tools\SM1.3\bin\SMEngine.pl

8.7.6 Start Stormons Services


Net start Stormons



8.8 Configuration on Debian or Ubuntu

Adding a startup script to be run at bootup

A. Copy goodies/debian/init.d/stormon script to /etc/init.d

B. Edit /etc/init.d/stormons and change STORMONS_HOME if need

C. updates the System V style init script links /etc/rcrunlevel.d/NNname

update-rc.d stormons defaults

D. Test startup script

root@sms0001:/etc/init.d# ./stormons Usage: {start|stop|status|restart} root@sms0001:/etc/init.d# ./stormons status Stormons is NOT running.

E. Start Stormons

root@sms0001:/etc/init.d# ./stormons start Starting Stormons Engine SMEngine.pl Stormons started

Installation Guide

Documents

Transcript of Installation Guide