Aperi SAN Simulator Installation Instructions
Use the following instructions to download and install SAN Simulator.
Introducing SAN Simulator
Welcome to SAN Simulator. SAN Simulator is a software tool that enables you
to simulate a SAN environment without requiring you to have the hardware in
that SAN. Large storage installations are extremely complex today and as storage
capacities grow, their complexity increases. One of the primary constraints
that developers face is the inability to test any SAN software against large,
complex SAN environments due to the lack hardware resources. For example, it
might not always be feasible to own expensive IBM and non-IBM SAN boxes just
to test out developing software. This might create a situation where development
and test staff have to timeshare SAN boxes across geographically-distributed
teams.
You can use the SAN Simulator to create a SAN configuration, add devices to
the SAN, create arbitrary connections between devices, and remove connections
between devices. Because most storage devices today expose their services through
a CIMOM, you can also use the SAN Simulator to create CIM instances based on
your specifications. It can generate various profiles like fabric, array, and
disk profiles in temporal fashion, and take snapshots of existing real live
CIMOMs and replay back as required.
You can simulate CIMOMs in the following ways:
- Snapshot Approach: SAN Simulator can take snapshot of any real live CIMOM
and then replay it back from your local workstation/network.
- Configuration Approach: SAN Simulator can simulate CIM information for a
device based on the specification supplied in a XML file. For example, you
can specify the number of pools/volumes in a storage subsystem, the number
of FCPorts in a switch, and so on.
See the SAN
Simulator User's Guide for more information on how to use the SAN Simulator.
2. Check install requirements
- You must be running Windows 2000, XP, or 2003.
- You must have Sun JDK 1.5 and Sun JRE 1.5 or higher installed on your machine.
To check for Java on a machine, start a command prompt window and type java
-version from a command line. If you do not have a JDK 1.5 and JRE 1.5
or higher installed, you can download it from the following Web site: http://java.sun.com/j2se/1.5.0/download.jsp
- Make sure the JAVA_HOME environment variable is set to the appropriate directory
where you installed the JDK. For example, JAVA_HOME=c:\java5\jdk.
Plan for the database repository
A single database instance serves as the repository for data used by the
SAN Simulator. SAN Simulator was tested using DB2 v9.5 for Windows XP, DB2
v9.5 for Windows 2003 Server, DB2 v8.2 for Windows XP, DB2 v8.2 for Windows
2003 Server.
Perform the following steps to download and set up DB2 for use with the SAN
Simulator:
- Download DB2. You can learn more about DB2 and download a trial version
here.
- Install DB2 using the default settings.
Download and install SAN Simulator
- Download the SAN Simulator package (zip file) from the downloads
page. The zip file is located in the Binary downloads - Storage Network
Simulator section.
- Place the .zip file in the directory where you want to install the directories
and files for SAN Simulator.
- Use an unzipping tool to unzip the file. If successful, SAN Simulator's
runtime directories and files appear in the directory where you unzipped
them. The install instructions refer to this directory as [SIMULATOR_HOME].
For example, if you unzipped the file into the c:\SAN_Simulator, whenever
[SIMULATOR_HOME] appears in these install instructions it is referring to
c:\SAN_Simulator.
- Download and unzip the wbemservices-1.0.2.bin.zip file. This zip file
contains additional files that are required by SAN Simualtor but not included
in the .zip file you downloaded in step 1. To download and unzip this file,
complete the following steps:
- Go to http://wbemservices.sourceforge.net/.
- Click Downloads.
- Click WBEM Services v1.0.2.
- Go to the File Releases section at the bottom of the page,
right-click wbemservices-1.0.2.bin.zip, and select Save Target
As...
- Save wbemservices-1.0.2.bin.zip to a local directory.
- Use an unzipping tool to unzip the contents of wbemservices-1.0.2.bin.zip
to [SIMULATOR_HOME]. If successful, the contents of the wbemservices-1.0.2.bin.zip
appear in the in the [SIMULATOR_HOME]\wbemservices folder. For example,
c:\SAN_Simulator\wbemservices.
- Copy the [SIMULATOR_HOME]\wbemservices\lib\wbem.jar file to [SIMULATOR_HOME]\lib\.
- Copy the DB2 JDBC driver into the [SIMULATOR_HOME] directory. To do this,
locate the DB2 JDBC driver that was installed during the DB2 installation
in the Plan for the database repository section. On Windows,
check C:\Program Files\IBM\SQLLIB\Java.
- For DB2 v8.2: Copy db2java.zip, db2jcc.jar, db2jcc_license_cisuz.jar,
and db2jcc_license_cu.jar into [SIMULATOR_HOME]\lib.
- For DB2 v9.5: Copy db2java.zip and db2jcc.jar
into [SIMULATOR_HOME]\lib.
Notices
Aperi SAN Simulator (C) Copyright IBM Corp. 2007. All Rights Reserved
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which accompanies
this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html.