StorageIM

1.0
Installation and Administration

7/19/2010

7/19/2010

Table of Contents
Manual Installation .......................................................................................................................................2
MANUAL INSTALLATION STEPS ................................................................................................................. 6
MySQL Installation and Configuration .............................................................................................. 6
Apache Tomcat 6.x Installation and Configuration ...........................................................................7
Installer Installation ......................................................................................................................................2
Upgrading ......................................................................................................................................................7
Administration ............................................................................................................................................. 8
Configuring an SMI-S Agent ....................................................................................................................... 8
Monitoring Data ........................................................................................................................................... 9
Testing an SMI-S Agent ............................................................................................................................... 9
StorageIM Administration .......................................................................................................................... 10
Views Tab ...................................................................................................................................................... 11
Dashboard ............................................................................................................................................... 11
General Capacity Chart ........................................................................................................................ 11
Allocated Capacity Chart ..................................................................................................................... 11
Physical ................................................................................................................................................... 12
Topology ................................................................................................................................................. 12
Data .......................................................................................................................................................... 12
Array Controllers and Controller Ports|Status ................................................................................ 12
Audit .................................................................................................... Error! Bookmark not defined.
Database ....................................................................................................................................................... 15
storageim database diagrams ............................................................. Error! Bookmark not defined.
Sample Queries ........................................................................................ Error! Bookmark not defined.
SLP ................................................................................................................................................................ 15

7/19/2010

StorageIM
Installation and Administration
WINDOWS INSTALLER INSTALLATION
storgeim has available a Windows based installer

Step 1

Step 2 Source Distribution Selection

7/19/2010

Step 3 Installation Directory

Step 4 Group

7/19/2010

Step 5 Tomcat Ports

Step 6 MySQL Ports

7/19/2010

Step 7

Step 8

7/19/2010

MANUAL INSTALLATION
Manual installation is based on the sourceforge storageim_betax_x.zip download. This download
does not come with MySQL or a java basded web server such as Apache Tomcat. This distribution
is used for Unix and Windows installations where Tomcat and or MySQL may already be installed
or a manual configuration is necessary.
In order to install storageim, you will need to download and use the following
1.
Apache Web Server or JBOSS
2.
MySQL 5.0 or greater (Community or Enterprise)
3.
StorageIM release
4.
Java 1.5 or greater http://java.sun.com/javase/downloads/index_jdk5.jsp

MANUAL INSTALLATION STEPS

MySQL Installation and Configuration
1.

Download and install MySQL 5.0 or greater from http://www.mysql.org/downloads/

a. Using the MySQL command line, create a new MySQL username=storageim and
password=storageim
i.
Grant all on storageim.* to storageim@localhost identified by storageim;

7/19/2010

b.

Using the mysql command line client utility, perform the following
i.
Mysql> source "DOWNLOAD_PATH\storageim.sql"

Apache Tomcat 6.x Installation and Configuration

1.

Download and install Apache Tomcat from http://tomcat.apache.org/

a.
Copy the storageim.war in the TOMCAT_HOME/webapps directory
b.
Start Apache Tomcat

UPGRADING
Currently, there is no upgrade installer for StorageIM. If you need information on upgrading from a
previous version, send us an email, info@storageim.com.

7/19/2010

ADMINISTRATION
In order for storageim to discover any hardware devices, SMI-S based providers must be installed
prior to storageim discovery. Check your vendor website for information regarding their SMI-S
provider implementation or visit SNIAs provider pages,
http://www.snia.org/forums/smi/tech_programs/ctp/conformingproviders/

CONFIGURING AN SMI-S AGENT

Based on your hardware vendors provider documentation, you must provide authentication values
in order to establish a connection. Open a browser and go to storageim,
http://ipaddress:8080/storageim.
Click the Administration tab: Currently you should see no CIMOMs in the list. Click System
Config.

Add SMI-S Agent

Name: Arbitrary Name used to define the CIMOM/provider

Protocol: protocol configured on the CIMOM
IPAddress: CIMOM/Provider IP Address

7/19/2010

Namespace: Location Where provider stores collected Hardware data

Username/Password: Credentials Used to authenticate against provider
Discovery Interval: The interval to discover a CIMOM/Provider
Data Retention: How long will storageim save the data collected

Once a CIMOM credentials are created, storageim will add the CIMOM to discovery.

Created CIMOM

MONITORING DATA
Based on the discovery interval that was set during the addition of a SMI-S Agent, StorageIM will
attempt a discovery. Currently, StorageIM supports SMI-S 1.1 for array, switch, HBA, VMWare ESX,
and partial iSCSI based devices.

TESTING AN SMI-S AGENT

StorageIM allows you to test SMI-S agents prior to adding them to the StorageIM configuration

7/19/2010

STORAGEIM ADMINISTRATION
StorageIM uses user authentication to login to the user interface. Currently there are two
authentication roles, basic and administrator. A basic user is allowed view privileges only. They
have no Administrator or Active Management Privileges. If a user is a non-administrator, the
administration and Active Management tabs will not be visible.

10

7/19/2010

VIEWS TAB
The views tab represents..

Dashboard
General Capacity Chart
Denotes aggregates of primordial, total concrete and allocated concrete.

Current: Current unassigned, assigned and total managed space

o

"Assigned Space" = TMS-RMS sum of all primordial|parent pools

"Unassigned/Remaining Managed Space" = RMS sum of all primordials

"Total Managed Space" = TMS sum of all primordials

Historical: Time based unassigned, assigned, and allocated storage

Allocated Capacity Chart

11

7/19/2010

Physical
The physical view tab denotes hardware location based on user configuration.

Topology

Data
Array Controllers and Controller Ports|Status

12

7/19/2010

Array Pools and LUNs

13

7/19/2010

Array Disks

14

7/19/2010

DATABASE
storageim uses MySQL as its relational database for storage of current and historic data.

SLP
Service Location Protocol provides the ability to advertise a vendors service if their provider is
configured to do so. StorageIM incorporated SLP discovery in order to discover a providers
existence before configuring. This allows a user to make sure that a provider is installed and
configured correctly. SLP discovery in StorageIM allows for both unicast and multicast discovery.
Unicast discovery is a manual process in which you must provide an IP Address or host name that
has a SLP server agent or directory agent installed. The multicast SLP discovery automatically
discovers SLP agents. You can also use the multicast Rediscover button to push a new multicast
rediscovery.

15

7/19/2010

The SLP Add button is used to copy over the SLP discovered attributes in a specific row for
configuring an SMI-S Agent. The SLP Add button will only carry over the protocol, IPAddress,
port, and chosen namespace. You will still have to provide a unique name, username, password,
discovery interval and data retention variables during configuration.

16

7/19/2010

17