Global Array Manager
Transition Tool Client
Software
May 2003
First Edition
®
DB15-000278-00
This document contains proprietary information of LSI Logic Cor poration. The
information contained herein is not to be used by or disclosed to third parties
without the express written permission of an officer of LSI Logic Corporation.
Document DB15-000278-00, First Edition (May 2003)
This document describes version 5.20 of LSI Logic Corporation’s Global Array
Management Client software. This document will remain the official reference
source for all revisions/releases of this product until rescinded by an update.
LSI Logic Corporation reser ves the right to make changes to any products herein
at any time without notice. LSI Logic does not assume any responsibility or
liability arising out of the application or use of any product described herein,
except as expressly agreed to in writing by LSI Logic; nor does the purchase or
use of a product from LSI Logic convey a license under any patent rights,
copyrights, trademark rights, or any other of the intellectual property rights of LSI
Logic or third parties.
LSI Logic, the LSI Logic logo design, MORE, Mylex, eXtremeRAID, and
SANmapping are trademarks or registered trademarks of LSI Logic Corporation.
All other brand and product names may be trademarks of their respective
companies.
SOFTWARE LICENSE AND WARRANTY POLICY
Limited Warranty
LSI warrants to the original purchaser of the product enclosed herein
(“Customer”) that (a) for a period of three (3) years from the date of Customer’s
purchase of the Product (excluding batteries and memory) (the “Product
Warranty Period”), and (b) for a period of one (1) year from the date of purchase
of the Product by Customer (the “Battery/Memory Warranty Period”), the batteries
and memory included in the Product will (i) be free from defects in workmanship
and materials, and (ii) substantially conform to the documentation or other
specifications for the Product. The limited warranties herein shall not apply to and
shall be void for any Product that has been misused (including static discharge,
improper installation, or accident), abused, modified, damaged as a result of
actions on the part of Customer or its agents or its processes, unauthorized
service or par ts, used in a manner inconsistent with nor mal computer operations
(including but not limited to electrical irregularities, lightning or power line related
damage, or other abnormal occurrences), or to normal wear and tear of the
Product. The warranty herein is made to and for the benefit of the original
purchaser of this Product and is non-transferable.
This warranty will not apply to, and LSI provides no warranty for any BIOS,
software, ROM-based firmware or other product developed or manufactured by
any third party whether including with this Product or not. Such warranty or
warranties are provided by third parties and, to the extent permitted thereby, shall
be made available and are hereby assigned by LSI to Customer.
Customer may obtain warranty service during the Product Warranty Period or
Battery/Memor y Warranty Period, as the case may be, if (a) Customer has
contacted LSI at the telephone number listed LSI’s web site at www.lsilogic.com
to obtain a Returned Material Authorization (“RMA”) number and appropriate
instructions from LSI, (b) after obtaining LSI’s authorization, Customer has
returned the Product if so instructed to an authorized LSI service facility or to LSI
in accordance with LSI’s instructions and the terms of this Agreement, shipping
costs to be borne by LSI, and (c) Customer has provided proof of purchase price
and date for unregistered Product. LSI shall bear one-way shipping, packing and
insurance costs and all other costs, excluding labor and parts, necessary to
effectuate repair or replacement under this warranty. All Product repaired or
replaced under this warranty shall be returned to Customer at Customer’s
expense. Repair or replacement Product provided under this limited Product
warranty will be furnished on an exchange basis and may be new or
reconditioned. All Product returned under this warranty shall become the property
of LSI. LSI shall notify Customer in the event that the Product returned under the
warranty does not, in LSI’s sole determination, comply with the conditions and
requirements set forth herein and, unless disposition instructions are given by
Customer for the Product within thirty (30) days of such notification, the Product
shall be returned to Customer freight collect.
Warranty Disclaimer
EXCEPT AS SET FORTH IN THIS DOCUMENT, LSI MAKES NO
WARRANTIES, WHETHER EXPRESS, IMPLIED, OR STATUTORY
REGARDING OR RELATING TO THE PRODUCT, OR ANY MATERIALS OR
SERVICES FURNISHED OR PROVIDED TO OEM UNDER THIS AGREEMENT,
INCLUDING MAINTENANCE AND SUPPORT. LSI SPECIFICALLY DISCLAIMS
ALL IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE
PRODUCT AND ANY OTHER MATERIALS AND SERVICES, AND WITH
RESPECT TO THE USE OF ANY OF THE FOREGOING.
THE REMEDIES STATED IN THIS DOCUMENT CONSTITUTE CUSTOMER’S
EXCLUSIVE REMEDIES AND LSI’S SOLE LIABILITY FOR BREACH OF THE
LIMITED WARRANTIES SET FORTH HEREIN.
Software License
Subject to the terms and conditions of this Agreement, LSI grants Customer a
non-exclusive, worldwide, non-transferable, revocable, royalty-free license to use,
perform and display the LSI software that is a part of the Product (“LSI Software”)
solely as part of the Product incorporated into the OEM Products that and not on
a standalone basis. Customer may not (a) sell, lease, license, or sublicense the
LSI Software, (b) de-compile, disassemble, reverse engineer, or otherwise
attempt to derive source code from the LSI Software, in whole or in part, except
to the extent such restriction is prohibited by applicable law, (c) modify o r create
derivative works from the LSI Software, or (d) use the LSI Software to provide
processing services to third par ties or otherwise use the LSI Software on a
service bureau basis, electronically distribute or timeshare the LSI Software or
market the LSI Software by interactive cable or remote processing services.
Limitation of Liability
IN NO EVENT SHALL LSI’S TOTAL, CUMULATIVE LIABILITY ARISING FROM
THE SALE, USE AND DISPOSITION OF THE PRODUCT AND/OR THE
LICENSING OF THE LSI SOFTWARE EXCEED THE AMOUNT PAID BY
CUSTOMER FOR THIS PRODUCT. IN NO EVENT SHALL LSI BE LIABLE TO
CUSTOMER OR ANY THE OTHER FOR ANY PUNITIVE, INCIDENTAL,
INDIRECT, CONSEQUENTIAL OR SPECIAL DAMAGES, INCLUDING LOSS OF
PROFITS, INCURRED BY THAT PARTY, HOWEVER CAUSED AND UNDER
ANY THEORY OF LIABILITY, WHETHER BASED IN CONTRACT, TORT
(INCLUDING, WITHOUT LIMITATION, NEGLIGENCE OR PR ODUCT LIABILITY)
OR WARRANTY, IN CONNECTION WITH THE SALE, USE AND DISPOSITION
OF THE PRODUCT AND/OR THE LICENSING OF THE LSI SOFTWARE, EVEN
IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
iv
JB
To receive product literature, address your request to:
To receive product literature, visit us at http://www.lsilogic.com.
For a current list of our distributors, sales offices, and design resource
centers, view our web page located at
http://www.lsilogic.com/contacts/index.html
This User’s Guide covers the steps involved to install and use the client
®
component of Mylex’s Global Array Manager
MegaRAID Ultra 320 and Mylex PCI Disk Array Controllers.
For information on installing and r unning the server component of Global
Array Manager Transition Tool, consult the Global Array Manager Transition Tool Ser ver Software Installation Guide and User Manual
DB15-000279-00.
Transition Tool with
Audience
Organization
This document assumes that you have familiarity with RAID controllers
and related support devices.
The people who benefit from this book are:
•Network administrators who need to install and use Global Array
Manager Transition Tool with MegaRAID or Mylex controllers
•Engineers and managers who are evaluating MegaRAID or Mylex
controllers for possible use in a system
This document has the following chapters and appendixes:
•Chapter 1, Introduction, introduces the Global Array Manager
Transition Tool (GAM TT) Client software, which manages
MegaRAID Ultra320 and Mylex AcceleRAID 160/170/170LP/352 and
eXtremeRAID 2000/3000 PCI RAID controller families.
®
•Chapter 2, Installation, explains how to install and un-install the
GAM TT Client software.
Global Array Manager Client Software User’s Guidev
Global Array Manager® Transition Tool (GAM TT) Client software
manages selected MegaRAID Ultra320 and the AcceleRAID and
eXtremeRAID families of PCI RAID controllers. This manual provides
information on GAM TT Client that supports new server features for the
following controllers:
•MegaRAID Ultra320 -1, -2, 2x, 4x
•eXtremeRAID 2000/3000
•AcceleRAID 160/170/170LP/352
GAM TT Client software is used to:
•Monitor and manage server and disk array groups.
•Monitor, manage, maintain, and configure Mylex Disk Array
Controllers and the physical and logical drives that are connected to
these controllers, even across remote servers.
Configuration functions are easily performed using RAID AssistTM, an
intuitive, wizard-lik e utility in the GAM TT Client component that simplifies
the process of setting up or reconfiguring a disk array. Just answer a few
brief questions, and RAID Assist automatically does the rest. Use Manual
Configuration for more control over drive group setup or individual
configuration parameters.
1.1.3Monitoring Functions
The Global Array Manager Transition Tool Server component collects and
disseminates information on disk array status. The GAM TT Client
component organizes this information through an intuitive graphical
display. Errors and events are recorded in a log file and in the Log
Information Viewer windo w, and if a problem is serious enough to warrant
immediate attention, operators can be alerted via popup windows,
pagers, fax, or E-mail if so desired.
1.1.4Maintenance Functions
The GAM TT Client manages or performs maintenance on individual disk
arrays and drives (with the appropriate authentication), again by means
of the graphical user interface. This includes removing physical devices
from operation in a functioning disk array (also known as “killing” or offlining a drive), rebuilding drives, selecting hot spares, and initiating a
consistency (or parity) check on arrays that are configured to suppor t
redundancy. The Global Array Manager Transition Tool Server executes
the management instructions specified by the GAM TT Client.
1.2Requirements
Since GAM TT is a client/server application, the GAM TT Server software
component must be installed in one or more file servers in order for the
GAM TT Client software component to operate. Hardware and software
requirements for installation and operation of the GAM TT Server
component are described for each supported network operating system
in the Global Array Manager Transition Tool Server Software Installation
Installation of the Global Array Manager Transition Tool Client component
requires one of the following operating systems:
•Windows 2000/2003/XP 32-bit/98/95/Me
•Linux (using Wine)
This chapter assumes that the network administrator for this site will be
performing these installation procedures.
If you are installing GAM TT Client, you may also choose to install GAM
TT Server and its subcomponents at the same time on the same system.
When installing GAM TT Server, dialog boxes for the ser ver component
open and require a computer restart before launching the GAM TT Client
software. Refer to the Global Array Manager Transition Tool Server Software Installation Guide and User Manual for G AM T T Se r ver
installation instructions.
2.2Installation of the Global Array Manager Transition Tool
Client
Global Array Manager Transition Tool software can be downloaded from
http://www.lsilogic.com/GAMTT. Once you download and unzip the GAM
TT Client, use the following procedure for installation.
2.2.1Installing GAM TT Client Software
If you intend to install GAM TT Server with GAM TT Client, make sure
TCP/IP is installed and functioning properly.
Global Array Manager Transition Tool Client Software User’s Guide2-1
2.After a few moments, the Welcome dialog box will display
(Figure 2.1). Click Next to proceed with the installation, or click
Cancel to end the installation procedure and return to the menu.
Figure 2.1Welcome Dialog Box
3.When the LSI Logic Software License Agreement screen displays,
click Yes to accept the terms of the agreement and continue.
If you click No, you will not be allowed to continue GAM TT Client
installation.
The Select Components dialog box is displayed as shown in Figure 2.2.
At this point you will select the component(s) you wish to install.
4.To select Global Array Manager Transition Tool Client for installation,
click the box (if necessary) to check the Global Array Manager
Transition Tool Client option.
Note:
5.Click Next and follow the on-screen prompts.
If installing the Global Array Manager Transition Tool Client,
you may also choose to install Global Array Manager
Transition Tool Server at this time. Instructions for GAM TT
Server installation are described in the Global Array
Manager Transition Tool Server Software Installation Guide
and User Manual.
2.3Installing Global Array Manager Transition Tool Client
with Linux
Installing the Global Array Manager Transition Tool Client on a Linux
operating system requires the use of Wine™. Wine is a program that
ports the GAM TT Client onto Linux. It is highly recommended that you
use the Wine version from the specified web site. This version of Wine
has been tested with GAM TT Client and we do not guarantee that our
product supports other versions.
Installing Global Array Manager Transition Too l Client with Linux2-3
It is highly recommended that you use the following Windows
16/32-bit emulator rpm file:
wine-20010131-3.i386.rpm
Refer to the following web sites for further information on Wine.
http://www.winehq.com
http://www.codeweavers.com
2.3.2Install GAM TT Client
Global Array Manager Transition Tool software Global Array Manager
Transition Tool software can be downloaded from
http://www.lsilogic.com/GAMTT. Once you download GAM TT Client, use
the following procedure for installation (where x: represents the current
version number.):
\GAM\Linux\gam-client-x.xx-xx.i386.rpm
Install GAM TT Client on Linux:
rpm -ivh gam-5.00-xxxxxxxx.i386.rpm
GAM TT will be installed under /opt/gam
To run GAM TT Client see Section 3.1, “Star ting Global Array Manager
Transition Tool,” page 3-1. Fur ther information is available in the
Starting the Global Array Manager Transition Tool Client requires both
the Server and Client components. It is required that you install and start
GAM TT Server before you attempt to run the Global Array Manager
Client.
3.1.1Server Component
Installation and startup of the Global Array Manager Server component
is covered in the Global Array Manager Server Software Installation Guide and User Manual. The software for GAM TT Server is provided on
http://www.lsilogic.com/GAMTT.
Refer to the appropriate sections in the above-mentioned manual for
instructions on star ting the Global Array Manager Transition Tool Server
component under any of the supported network operating systems.
3.1.2Client Component
Under Windows 2000/2003/XP 32-bit/95/98/Me or Linux, you are ready
to start the Global Array Manager Transition Tool Client once you have
installed the client on your workstation (see Section 2.2, “Installation of
the Global Array Manager Transition Tool Client,” page 2-1).
To star t GAM TT Client:
•Under 2000/2003/XP 32-bit/95/98/Me, start the GAM TT Client
software by selecting
Start->Programs->Mylex Global Array Manager Client.
•Under Linux, type gam.
Global Array Manager Transition Tool Client Software User’s Guide3-1
At startup, the GAM TT Client will display the following message dialog
box (Figure 3.1).
Figure 3.1GAM TT Client Opening Message
This dialog box is to notify you that the event definition has been changed
from default after clicking OK from the Settings option. If you do not want
this dialog box to open each time you star t the GAM TT Client, select the
“Don’t display this dialog again” check box. Click OK to close the dialog
box.
If at least one server group and file server are defined, the GAM TT
Client opening screen displays. If not, the Define Server Groups dialog
box opens (see Section 3.5, “Setting Up Server Groups and Servers,”
page 3-17).
Note:
In order for event notification to occur, the Global Array
Manager Transition Tool Ser ver and Global Array Manager
Transition Tool Client must be r unning at all times.
3.2Navigating Global Array Manager Transition Tool Client
This section describes the navigating features and options that GAM TT
provides.
3.2.1Button Controls
Dialog boxes throughout the Global Array Manager Transition Tool Client
have a series of control buttons. Some examples of these include:
Click this button to apply the settings made in the dialog box.
Click this button to cancel the settings made in the dialog box.
Click this button to confirm the action identified in the dialog box.
Click this button to cancel the action identified in the dialog box.
Click this button to close the active dialog box.
Click this button to apply your configuration changes.
3.2.2Components of the GAM TT Client Opening Screen
Upon startup (with defined ser vers), Global Array Manager Transition
Tool Client displays the opening screen, consisting of the Global Array
Manager window, the Global Status View window, and the Log
Information Viewer (Figure 3.2).
Figure 3.2Opening GAM TT Screen
#1
#5
#2
#3#4
#6
#7
Navigating Global Array Manager Transition Tool Client3-3
The major components of the GAM TT Client windows (Figure 3.2) are
described below.
1.Item #1 is the menu bar. There are five menus with several
selections each. The contents of the menus and the functionality of
several of the most important selections will be described throughout
this guide.
2.Item #2 is the toolbar. There are seven toolbar icons representing
eight of the most useful functions available in GAM TT Client. The
identity of each toolbar icon and an explanation of the purpose of
each will be described in later sections of this chapter.
3.Item #3 is the server group selection box. When selected, the box
displays the names of each server group that is in contact with the
current client workstation. Each group may consist of multiple
servers. You may select a specific server group to view, or select “All
Servers” if you want to view all the servers that are connected to this
workstation.
4.Item #4 is the controller selection box. When selected, the box
displays the controller ID (C-0, C-1, etc.) and controller type
(eXtremeRAID 2000, etc.) of each PCI/SCSI connected to the
currently-selected server.
3.2.2.2Components of the Global Status View Window
The major components of the Global Status View window (Figure 3.2)
are described below:
5.Item #5 is an icon that represents the currently-selected file server
running the GAM TT Server component. The icon identifies:
–the IP address (e.g. 10.17.3.172) or name (e.g. ide40) of the
server
–the network operating system running on the ser ver (e.g. 2000 =
Windows 2000; NW = Novell NetWare, etc.)
–the operational status of the server (green = functioning, yellow
= attempting connection, red ‘X’ = unable to connect)
–the number of DAC (PCI/SCSI) controllers connected on the
server, with a controller operational status light (green =
functioning, yellow = critical, red ‘X’ = down or nonfunctional)
6.Item #6 is an icon that represents a currently unselected file server
running the GAM TT Server component. The icon identifies the same
information described above.
3.2.2.3Components of the Log Information Viewer
7.Item #7 in Figure 3.2 is the GAM TT Client Log Information Viewer.
Each line in the Log Information Viewer identifies a single event
(error, status, warning, etc.) which was noted during monitor ing by a
file server running GAM TT Ser ver, and was transmitted by that
server to this client workstation. Relevant details accompany the
event:
–Event ID. Displays an icon showing whether the event is
informational, cautionary, a warning, etc., plus the identification
number assigned to this event.
–Severity. The severity level of this event.
–Source. The IP address or name of the file server that is the
sender (source) of this event.
–Source Time. Day of the week, month, day of the month, time
of day, and year at the source file server’s location when this
event occurred.
–Device Address. Relevant channel/target or other data
pertaining to the source of this event.
–Description. Text of the message describing what occurred.
–Sequence (Seq). Number representing where this event fell in a
stream of events from the same source.
–Local Time. Day of the week, month, day of the month, time of
day, and year at the local client workstation’s location when this
event arrived.
Navigating Global Array Manager Transition Tool Client3-5
Open the Controller View window by double-clicking any server icon in
the Global Status View, or as shown in Figure 3.3:
Figure 3.3Select “Controller View”
The Controller View window (Figure 3.4), displays the following
information about the controller currently selected in the controller selection box:
Note:
In order for the Controller View window to refresh with real
time information, if you don’t have a real IP address on the
GAM TT Server, it is important to make sure that the GAM
TT Server event notification destination address is set with
the loop back IP address (127.0.0.1). See the Global Array
Manager Transition Tool Server Software Installation Guide
and User Manual for instructions on how to update the
server event file (gamscm.ini).
•Item #1: The number of channels on this controller, each channel
depicted as a tower.
•Item #2: The physical devices present on each channel, specifying
the target ID, capacity of the device, device type, and device status.
See Section 5.4, “Physical Device and Logical Drive Monitoring,”
page 5-5, for more information.
•Item #3: The logical drives configured on the controller, specifying
the logical drive number, capacity of the logical drive, configured
RAID level, and logical drive status.
The Controller View window for the eXtremeRAID 3000 (Figure 3.5),
displays the same information as descr ibed in the previous section.
However, it is organized graphically to allow many more targets to be
shown in each of the fibre channels, and the Controller Vie w is scrollab le .
The number of targets per column can be set in the GAM2CL.INI file.
Channel 0 represents the internal SCSI channel.
Navigating Global Array Manager Transition Tool Client3-7
GAM TT Client contains a menu bar (Figure 3.6) in the Global Array
Manager Transition Tool window.
Figure 3.6Menu Bar
3.3.1.1File Menu
The File menu (Figure 3.7) contains the following options:
•Open Configuration (Ctrl+O): Loads a configuration from disk and
saves it to the controller. (See Section 3.5, “Setting Up Ser ver
Groups and Servers,” page 3-17.)
•Save Configuration (Ctrl+S): Saves a configuration file to a new
filename, disk, and/or directory.
•Clear Configuration: Removes configuration information from the
selected array on the selected controller.
Caution:
Although there are confirmation checkpoints and warnings
following selection of this option, remember that all existing
configuration and file data (on all drives connected to the
array) will be deleted.
The View menu (Figure 3.8) contains the following options:
•Global Status View: Toggles the Global Status View window. The
•Controller View: Toggles the Controller View window showing
•Log Information Viewer: Toggles the Log Information Viewer, a
Global Status View window opens by default when Global Array
Manager Transition Tool Client star ts.
channel/ID/target information and physical device/logical drive
configurations for the controller selected in the controller selection
box.
window showing a log of recent system error and status event
messages. The Log Information Viewer opens by default when
Global Array Manager Transition Tool Client starts.
•Foreground Initialization Status: Displays the progress (percent
complete) of an ongoing full foreground initialization of one or more
drives.
Figure 3.8View Menu
•Background Initialization Status: Displays the progress (percent
complete) of an ongoing full background initialization of one or more
drives.
•Rebuild Status: Displays the progress (percent complete) of an
•Consistency Check Status: Displays the progress (percent
complete) of an ongoing logical drive consistency check.
•Expand Capacity Status: Displays the progress (percent complete)
of an ongoing data restriping process across the target RAID group.
•Patrol Read Status: Enables GAM TT Client to poll every 1 minute
to get new status data from the controller.
•Error Table: Displays a table of bad block and “request sense” data
generated as a result of finding areas of damage or data
unavailability on a storage device. Data for all storage devices on the
selected controller are presented in the same tables.
•Cluster Map (Mylex Controllers Only): Displays a graphical back
end cable connection for the controller selected from the cluster
controller list.
3.3.1.3Administration Menu
The Administration menu (Figure 3.9) contains the following options:
•Sign On: Enables use of GAM’s configuration and administration
functions to “Administrators” (“gamroot” + password). Enables only
monitoring functions to “Users.”
•Define Server Groups: Sets up server groups and individual server
names or IP addresses within each group.
•Select Current Server Group (Ctrl+G): Displays the current
contents of the server selection box located in the Global Array
Manager Transition Tool window. Functions in the same way as
directly selecting the server selection box.
•Select Current Controller (Ctrl+C): Displays the current contents of
the controller selection box located in the Global Array Manager
Transition Tool window. Functions in the same way as directly
selecting the controller selection box.
Facilitates configuration tasks using either one-step “automatic”
configuration, a configuration “wizard” assistant, or a manual
(advanced level) configuration option allowing more control over
configuration parameters.
•Initialize Logical Drives: Offers the ability to run a full initialization
of logical drives at a time of your choice, not just immediately
following a new configuration. If it’s inconvenient to follow a
configuration immediately with a logical drive initialization, you can
decline the initialization and use this menu item to start the process
at a later time.
Caution:
If you perform an initializ ation on a logical drive(s) that you
are currently using for data storage, you will lose the data
stored on the drive(s).
•Controller Information: Displays key information about the
currently-selected controller.
•Enclosure Information: Displays information and status about
components in the external disk enclosure.
•Controller Options: Sets various parameters for the selected Disk
Array Controller. Unlike Controller Inform ation, user definable
controller parameters are modified in Controller Options.
•Physical Device Options: Displays a list of all physical devices
connected on the currently selected controller and allows the user to
change transfer speed, transfer width, and/or tag value for individual
devices.
•Intelligent BBU: (Only enabled if the selected controller has an
Intelligent Battery Backup Unit installed.) Displays a dialog box from