Installation and Configuration Guide for StoreAge SVM
Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no
responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use.
QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described
in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation
nor warranty that such applications are suitable for the specified use without further testing or modification. QLogic
Corporation assumes no responsibility for any errors that may appear in this document.
No part of this document may be copied nor reproduced by any means, nor translated nor transmitted to any magnetic
medium without the express written consent of QLogic Corporation.
QLogic, the QLogic logo, ReadyPath, SANbox, and SANblade are trademarks or registered trademarks of QLogic
Corporation.
HP-UX is a trademark or registered trademark of Hewlett-Packard Company.
Sun Microsystems and Java are trademarks or registered trademarks of Sun Microsystems, Inc.
Microsoft, Windows XP, Windows 2000, Windows 2003, and Internet Explorer are registered trademarks of Microsoft
Corporation.
Netscape Navigator and Mozilla are trademarks or registered trademarks of Netscape Communications Corporation.
StoreAge, the StoreAge logo, and SVM are trademarks or registered trademarks of StoreAge Network
Technologies, Ltd.
VMWare is a trademark or registered trademark of VMWare, Inc.
All other brand and product names are trademarks or registered trademarks of their respective owners.
Installation and Configuration Guide for StoreAge SVM
Tables
SN0054628-00 APage vii
SANbox 8200 Series Storage Services Platform
Installation and Configuration Guide for StoreAge SVM
Notes
Q
Page viiiSN0054628-00 A
Section 1
Introduction
This installation and configuration guide explains the initial hardware installation
and basic configuration procedures for the SANbox
Platform (SSP). It contains procedures for installing the system, configuring the
different components of the system, and completing basic storage operations. After
completing the installation and basic configuration procedures covered in this guide,
an administrator can use the SANbox SSP to provision and manage storage and
related services, such as virtualization, migration, mirroring, and replication.
The major sections of this guide are as follows:
Section 2 includes intended audience, related documentation, regulatory and
safety notices, and warranty and technical support.
Section 3 provides step-by-step instructions for getting started with the SANbox
SSP.
Section 3 references each screen and panel in the SANbox SSP Management
GUI. Use the SANbox SSP Management GUI to manage the SANbox SSP chassis.
The SANbox SSP Management GUI provides the same functions as the command
line interface.
Section 4 describes the procedures for using various aspects of the SANbox SSP
and the SVM appliance, including SAN zoning, configuring storage, creating virtual
volumes, interpreting LEDs, and shutting down.
Section 5 describes the procedures for maintaining the SANbox SSP. Maintenance
tasks include updating the SANbox SSP system software, applying software
patches, interpreting LED patterns, and replacing hardware.
®
8200 Series Storage Services
Section 6 provides troubleshooting
during system start-up or configuration of the SANbox SSP.
Appendix Alists the SANbox SSP specifications.
Appendix B describes the Telnet command line interface. The commands provide
the same functions as the SANbox SSP Management GUI.
SN0054628-00 A1-1
procedures for issues that you may experience
1 – Introduction
Audience
1.1
Audience
Q
This section is organized as follows:
■ Audience
■ Readme File
■ Related Documentation
■ New in this Release
■ Style Conventions
■ Regulatory and Safety Notices
■ Warranty and Technical Support
To use this guide, you should be familiar not only with basic networking installation
tasks but also with standard storage networking configuration, management, and
troubleshooting procedures. You should also have experience configuring,
installing, and maintaining different storage components and devices including host
bus adapters (HBAs), Fibre Channel switches, and storage arrays.
1.2
Readme File
See the readme.txt file included on the SANbox 8200 Series SSP for StoreAge SVM
CD-ROM for updates to this guide.
1.3
Related Documentation
The following websites, manuals, and materials are referenced in the text and/or
provide additional information.
■ SANbox 8200 Series Storage Services Platform Quick Start Guide for StoreAge
SVM
■ SANbox SSP solution guide for your configuration
The solution guides are documents that address the specific host operating
systems and storage devices present in your configuration.
■ SANbox SSP Release Notes
■ QLogic’s website: http://www.qlogic.com
1-2SN0054628-00 A
Q
■ StoreAge documents:
❑ MultiCopy User Manual
❑ MultiMirror User manual
❑ MultiView User Manual
❑ SVM Install Guide
❑ SVM User Manual
1.4
New in this Release
This is the initial release of this document.
1.5
Style Conventions
CAUTION!A Caution notice indicates the presence of a hazard that has the
1 – Introduction
Regulatory and Safety Notices
potential of causing damage to the equipment or loss of data.
WARNING!!
1.6
A Warning notice indicates the presence of a hazard that has the
potential of causing personal injury.
Regulatory and Safety Notices
1.6.1
FCC
This device complies with part 15 of the FCC Rules. Operation is subject to the
following two conditions:
■ This device may not cause harmful interference.
■ This device must accept any interference received, including interference that
may cause undesired operation.
The reader is cautioned that changes or modifications made to the equipment not
expressly approved by QLogic Corporation could void the user's authority to operate
this equipment.
To comply with radiated emissions, only use SFPs recommended by QLogic
Corporation.
The above statements apply to products marketed in the USA.
SN0054628-00 A1-3
1 – Introduction
Regulatory and Safety Notices
This Class A digital apparatus meets all requirements of the Canadian InterferenceCausing Equipment Regulations.
Cet Appareil numérique de la classe A respecte toutes les exigences du réglement
sur le matériel brouilleur du Canada.
The above statement applies to products marketed in Canada.
1.6.2
Q
Class I Laser Safety Information – Certification and Classification
Information
The SANbox SSP contains a laser product called an optical SFP transceiver. Models
of optical SFPs sold by QLogic Corporation are certified as Class I laser products
that conform to the requirement contained in the Department of Health and Human
Services (DHHS) regulation 21 CFR Subchapter J. The certification is indicated by
a UL registered mark and a statement of compliance to DHHS regulation 21 CFR
Subchapter J on the label located on the SFP. If another optical SFP is used, other
than one recommended and sold by QLogic Corporation, the user must ensure
compliance with UL recognized standards and DHHS regulations.
1.6.3
Declaration of Conformity
This Declaration identifies the product, manufacturer's name and address, and
applicable specifications recognized in the United States and Canada.
Manufacturer
QLogic Corporation
26650 Aliso Viejo Parkway
Aliso Viejo, California 92656
USA
The Manufacturer declares under sole responsibility that the products to which this
Declaration relates is in conformity with the following standards or other documents:
Safety: UL 60950 Listed
CSA C22.2 No.60950
IEC 60950
1-4SN0054628-00 A
Q
1 – Introduction
Regulatory and Safety Notices
EN 60825-1:1994+A11
EMC: FCC Rules Part 15, Subpart B,2001.Class A (US)
ICES-003:1997. Class A
ANSI C63.4:2000
EN55022 (1998), Performance Criteria A
EN50081-1 (1992)
EN50082-1 (1997)
EN55024 (1998)
EN61000-3-2 (1995) A14:2000, Performance Criteria A
EN61000-3-3 (1995), Performance Criteria B
IEC61000-4-2 (1995) A1:1998, Performance Criteria B
IEC61000-4-3 (1995) A1:1998, Performance Criteria B
IEC 61000-4-4 (1995), Performance Criteria B
IEC61000-4-5 (1995), Performance Criteria B
IEC61000-4-6 (1996), Performance Criteria A
IEC61000-4-11 (1994), Performance Criteria B and C following the provisions of
the Low Voltage Directive 72/23/EEC and EMC Directive 89/336/EEC and is Marked
in accordance with the CE Marking Directive 93/68/EEC.
Any device that uses electricity must be handled carefully; follow these guidelines
to ensure general safety:
■ Keep SANbox SSP area clear and dust-free during and after testing.
■ Place SANbox SSP in a secure and stable area.
Use the appropriate AC power for the system. The system components operate on
input voltages and frequencies within the ranges of 100 to 240 VRMS and 50/60 Hz
without the need for operator adjustments.
WARNING!!
SN0054628-00 A1-5
SANbox SSP may have more than one power supply connection for
standard operation. All power supply connections need to be
removed to fully de-energize the unit.
1 – Introduction
Warranty and Technical Support
WARNING!!To prevent personal injury or damage to the SANbox SSP, never
attempt to lift or tilt the system using component mounts or device
levers; these types of handles are not designed to support additional
weight beyond specification. Move the SANbox SSP by lifting the
entire unit with both hands.
1.7
Warranty and Technical Support
1.7.1
Warranty
Every QLogic solution is backed by a worldwide warranty for hardware and software
products and related services furnished by QLogic. For complete warranty details,
go to: http://support.qlogic.com/support/warranty.asp
1.7.2
Technical Support
Q
.
Customers should contact their authorized maintenance provider for technical
support of their QLogic switch products. QLogic-direct customers may contact
QLogic Technical Support; others will be redirected to their authorized maintenance
provider. Visit the QLogic support Web site listed in "Contact Information" on
page 1-7 for the latest firmware and software updates.
1.7.2.1
Before Contacting Technical Support
Before contacting technical support, run show debug dump in the command line
interface, and create a trace file in the SVM GUI. QLogic technical support
representatives may request this file to assist them in diagnosing issues with your
system. For more information about Show Debug Dump, see "Show Debug
Command" on page B-19.
To create a trace file in the SVM GUI:
1. Open the SVM GUI, and open Information in the tree view.
2. Click Trace Dump, then click Confirm to start creating the file.
NOTE:The system requires several minutes to generate the trace file.
3. View the file in the c:\Svm_Trace directory.
The name of each trace file takes this form:
SVM_TraceN.txt
where N is an incremental number. For example, if the last trace file that was
generated is SVM_Trace1.txt, then the next one is SVM_Trace2.txt.
1-6SN0054628-00 A
Q
1.7.2.2
Availability
QLogic Technical Support is available from 7:00 AM to 7:00 PM Central Standard
Time, Monday through Friday, excluding QLogic-observed holidays.
1.7.2.3
Training
QLogic offers certification training for the technical professional for SANblade®
HBAs, SANbox switches, and SANbox SSPs. From the training link at
www.qlogic.com
intensive "hands-on" Certification course. Technical Certification courses include
installation, maintenance and troubleshooting QLogic SAN products. Upon
demonstrating knowledge using live equipment, QLogic awards a certificate
identifying the student as a Certified Professional. The training professionals at
QLogic may be reached by email at tech.training@qlogic.com
1.7.2.4
Contact Information
1 – Introduction
Warranty and Technical Support
, you may choose Electronic-Based Training or schedule an
.
Telephone:+1 952.932.4040
Fax:+1 952.932.4018
Email:
Technical Service
Technical Training
Support Web Site: support.qlogic.com
support@qlogic.com
tech.training@qlogic.com
SN0054628-00 A1-7
1 – Introduction
Warranty and Technical Support
Notes
Q
1-8SN0054628-00 A
Section 2
General Description
This section provides physical and functional overviews of the SANbox Storage
Services Platform (SSP) Management GUI, the StoreAge Storage Virtualization
Manager (SVM) solution, and related hardware.
This section covers the following topics:
■ SANbox SSP and StoreAge Solution Overview
■ SANbox SSP Overview
■ Supported Network Configurations
■ Port Connections
2.1
SANbox SSP and StoreAge Solution Overview
StoreAge SVM is a SAN appliance that together with the SANbox SSP enables
highly available networks and provides centralized, network-based volume
management, snapshot, replication, and mirroring across all storage devices within
a SAN. For more information about high-availability, see "High-Availability
Configuration" on page 2-6 for more information and a diagram.
Unlike host-based or storage-based volume management and data replication
technologies, StoreAge SVM is a network-based solution that centrally manages
all storage regardless of the operating systems or storage devices in use. By
deploying SVM agents on SANbox SSP, StoreAge leverages QLogic’s intelligent
storage application technology to deliver centralized storage management,
business continuity, and disaster recovery capabilities across all attached servers
and storage subsystems within a SAN.
The SVM GUI is a web-based interface to the SVM appliance. You can access the
SVM GUI from a local or remote location using a standard browser. Use the SVM
GUI to configure storage pools, provision virtual volumes and manage access to
them, and manage point-in-time copies of virtual volumes.
Using a standard web browser, you can configure, maintain, and monitor the
SANbox SSP chassis through the SANbox SSP Management GUI. The GUI
provides access to all chassis management functions, including SANbox SSP
status, port management and configuration, diagnostics, and a telnet window.
Alternatively, use the command line interface (CLI), which provides the same
functions as the SANbox SSP Management GUI through serial, telnet, or ssh
connections. All configuration, maintenance, and monitoring tasks for the SANbox
SSP chassis are accessible through the CLI.
SN0054628-00 A2-1
2 – General Description
SANbox SSP and StoreAge Solution Overview
Figure 2-1 shows a StoreAge-enabled SAN with dual SANbox SSPs. The SANbox
SSP provides drop-in deployment of StoreAge capability into the SAN.
Q
Figure 2-1. SANbox SSP/StoreAge Solution
2-2SN0054628-00 A
Q
2.2
SANbox SSP Overview
The SANbox 8200/8202 SSP represents a new category of storage virtualization
devices that centralizes the management and delivery of storage and related
services, without creating performance bottlenecks in the storage network. Storage
services such as virtualization and volume management, snapshots, replication,
backup, and mirroring can be deployed and provisioned from the SANbox SSP.
While SANbox SSP can process and switch Fibre Channel packets at wire speed,
it is not itself a Fibre Channel fabric switch. Rather, SANbox SSP complements your
Fibre Channel fabrics, allowing you to provide storage services uniformly across
heterogeneous fabrics, and to configure and manage access between devices on
different fabrics. SANbox SSP provides these capabilities without the complication
and risk of merging Fibre Channel fabrics.
2.2.1
Features
Three models of SANbox SSPs are available:
2 – General Description
SANbox SSP Overview
SANbox 8200-08 SSP (single power supply integrated with 8 ports)
SANbox 8202-08 SSP (dual hot-swappable power supplies with 8 ports)
SANbox 8202-16 SSP (dual hot-swappable power supplies with 16 ports)
SANbox SSP:
■ Adds new storage services to any existing SAN environment
■ Reduces complexity of managing and protecting data resources by centralizing
storage services within the network
■ Integrates host-based agent functionality, avoiding the complexity of managing
distributed agents
■ Extends the reach of storage services across multiple SAN islands, eliminating
the need for multiple independent deployments
For SANbox SSP specifications, see Appendix A Specifications.
SN0054628-00 A2-3
2 – General Description
Supported Network Configurations
2.3
Supported Network Configurations
The SANbox SSP supports both single-fabric and multiple-fabric configurations.
This section shows three examples of supported configurations.
2.3.1
Small SAN Deployment Configuration with Zoning
In the following example of a typical small SAN deployment (Figure 2-2), a single
Fibre Channel switch is used to connect all storage and initiators. Zoning is used
to partition the front-side initiator ports, and back-side storage and StoreAge SVM
into two separate logical SANs. See "SAN Zoning" on page 5-3 for more detailed
information about proper zoning configuration.
Q
Figure 2-2. Single (Zoned) Fabric Configuration
2-4SN0054628-00 A
Q
2.3.2
Supported Network Configurations
Small SAN Configuration with Front/Back-Side SANs
In a small SAN deployment with multiple switches, the SANbox SSP is used to
physically partition the front-side and back-side SANs. The storage and the
StoreAge SVM must be placed on the back-side of the SAN, and the initiators are
physically placed on the front-side of the SAN. See Figure 2-2.
2 – General Description
Figure 2-3. Dual Fabric Configuration
SN0054628-00 A2-5
2 – General Description
Supported Network Configurations
2.3.3
High-Availability Configuration
High availability describes a system that is operational a high percentage of the
time. Through dual redundancy, a system can maintain high availability in the
presence of any single component failure.
Use of redundant components, multipathing, and failover help protect against
failures and ensure high availability. Implementing SVM agents on SANbox SSP
provides high availability by allowing the use of multiple paths between servers and
storage, and ensuring that no single point of failure can prevent access to data.
Failover is a backup operational mode in which the functions of a system component
(such as, a server, network, or storage controller, for example) are assumed by
secondary system components when the primary component becomes unavailable
through either failure or scheduled down time.
With the proper multipathing software running on the host, a high-availability
configuration can guarantee access to data even in the event of one or possibly
more hardware, software, or infrastructure failures. With the addition of multiple
hosts running supported clustering software, even host failures can be tolerated
without interrupting critical applications.
Q
In addition to continuous operation through unplanned failures, a correctly set up
high-availability configuration enables administrators to take components of the
system offline for maintenance or replacement, again without interrupting access
to data.
Figure 2-4 shows a recommended high-availability configuration with
cross-connected fabric. Within each fabric, zoning is used to partition the front-side
initiator ports, both StoreAge SVM ports, and back-side storage. Each server has
multiple HBAs installed, with at least one HBA connected to each of two redundant
front-side fabrics. Each HBA sees the same virtual disks on each of two redundant
SANbox SSPs. Each SANbox SSP has access to physical storage through at least
two paths, across two fabrics and at least two RAID controllers. Two SVMs can
each manage either or both SANbox SSP units. Two independent fabrics and host
failover software ensure availability.
2 – General Description
Supported Network Configurations
2.3.3.1
How the Solution Protects Against Failures
The following tables provides a list of common failure points in a network and the
corresponding protection that this high-availability solution provides.
Table 2-1. High-Availability Solution Protection Against Network Failures
Failed Component:Protection:
HBA or path to
SANbox SSP
All HBAs or paths to
one SANbox SSP
One SANbox SSPVirtual volume becomes active on alternate SANbox SSP, host
One path between
one SANbox SSP
and storage
All paths between
one SANbox SSP
and storage
Storage controller
SVM applianceAlternate SVM appliance takes over system management
One or more paths
between one SVM
and one SANbox
SSP
Host software uses a remaining HBA or path to the same SANbox
SSP
Virtual volume becomes active on alternate SANbox SSP, host
software uses alternate HBA
software uses alternate HBA
■ Back-side I/O uses alternate path
■ LUN uses alternate storage controller, if necessary
■ Virtual volume becomes active on alternate SANbox SSP
■ Host software uses alternate HBA
■ Back-side I/O uses path to alternate storage controller
Alternate SVM appliance takes over system management
Q
2.3.3.2
Setup Requirements
To configure a high-availability solution using SVM appliances and SANbox SSPs,
you must make sure that:
■ Each HBA sees only one SANbox SSP.
■ Each host sees both SANbox SSP in the high-availability solution, and no others.
■ Each StoreAge SVM appliance sees both SANbox SSPs.
■ Each StoreAge SVM appliance sees all storage ports.
■ If the storage includes dual-controller active/passive RAIDs, each SANbox SSP
is cross-connected with the controllers, which means that each SANbox SSP
must see both controllers in the RAID.
2-8SN0054628-00 A
Q
For more information about setting up your high-availability system, see "Setting
up a High-Availability Configuration" on page 5-1. In addition, see the SANbox SSP
solution guide for your application environment for detailed information about
configuring SANbox SSPs for specific high-availability configurations.
2.4
Port Connections
2.4.1
Fibre Channel Port Connections
SANbox SSP Fibre Channel ports support Small Form-Factor Pluggable (SFP)
industry standard transceivers. All ports can be configured as initiator mode, target
mode, or dual mode (initiator/target) to support different configuration topologies.
Ports can be configured for fixed 1 Gbps or 2 Gbps data rates, or they can be
configured to auto-negotiate between 1 Gbps and 2 Gbps.
By default, ports are configured for dual mode (initiator/target), and also to
auto-negotiate the data rate.
2 – General Description
Port Connections
2.4.2
Ethernet Connections
SANbox SSP supports one 10/100 Fast Ethernet connection for management and
two 10/100 Fast Ethernet connections for high availability cluster communication
(labeled HA1 and HA2). The management port is labeled on the port side of
SANbox SSP and named MGMT if you are accessing using the CLI.
Each Ethernet port is configured with a default IP address. It is recommended that
you change the IP address during initial startup. To change IP address settings, see
"Modify Eth Command" on page B-13.
NOTE:StoreAge SVM performs cluster communication using Fibre Channel, so
the Ethernet HA1 and HA2 ports are not used. These ports should not be
connected or configured when using StoreAge SVM.
2.4.3
Console Port Connection
SANbox SSP supports an EIA/TIA-232 asynchronous serial connection through a
standard DB-9 port connection. To connect an ASCII terminal to the SANbox SSP,
attach one end of the null modem DB-9 cable (included) to the serial port (labeled
) of SANbox SSP and the other end to an ASCII terminal port (such as
HyperTerminal).
SN0054628-00 A2-9
2 – General Description
Port Connections
Notes
Q
2-10SN0054628-00 A
This section describes the tasks you must perform before you begin to install,
configure, and operate the SANbox SSP. The tasks should be performed in the
order presented in this section.
This section covers the following tasks:
■ Task Roadmap
■ Checking Package Contents
■ Setting Up SANbox SSP
■ Managing your Configuration
3.1
Task Roadmap
Table 3-1 presents the roadmap for setup tasks.
1. For a high-availability system,
obtain information about
high-availability configurations
that use SANbox SSPs and SVM
appliances.
2. Unpack and set up the hardware:
mount the SANbox SSP in a rack,
install the power supplies, and
connect the console port.
3. Start up and configure the SANbox
SSPs: configure the terminal
settings on the host, use the serial
console port, and modify the
Ethernet settings for remote
access.
4. Connect SVM appliances,
SANbox SSPs, and hosts to the
SAN.
Section 3
Getting Started with SANbox SSP
Table 3-1. Roadmap of Setup Tasks
For This Setup Step:See:
■ "High-Availability Configuration" on page 2-6 for
overview information.
■ "Setting up a High-Availability Configuration" on
page 5-1 for specific information about setting up
each component of a high-availability system.
■ "Checking Package Contents" on page 3-2.
■ "Setting Up SANbox SSP Hardware" on
page 3-4.
■ "Accessing SANbox SSP for the First Time" on
page 3-7.
■ "Accessing SANbox SSP for the First Time" on
page 3-7.
■ "Connecting to the SAN" on page 3-9.
SN0054628-00 A3-1
3 – Getting Started with SANbox SSP
Checking Package Contents
Table 3-1. Roadmap of Setup Tasks (Continued)
For This Setup Step:See:
5. In Section 4 SANbox SSP
Management GUI Reference get
tips about zoning your SAN and
configuring storage, and use the
SVM GUI to manage your
configuration.
6. Review the troubleshooting
information as needed.
3.2
Checking Package Contents
CAUTION!Before shipping SANbox SSP to another site, remove the power
supplies. SANbox SSP must not be shipped with the power supplies
installed.
Ensure that all the components of the SANbox SSP arrived in the package. Save
the shipping container, foam inserts, and anti-static bags; returning SANbox SSP
without this packaging may void its warranty. Check the contents of the package to
make sure that you received the following items and components:
Q
■ "SAN Zoning" on page 5-3
■ "Configuring Storage" on page 5-6.
■ "To create storage pools:" on page 5-8.
■ "To create a user defined host (UDH) and set the
❑ SANbox 8200 Series Storage Services Platform Quick Start Guide for
StoreAge SVM
❑ SANbox SSP Release Notes
❑ Installation/Upgrade software including OS and application
❑ End User License Agreement
❑ Release Notes
■ 1 RS-232 serial null modem cable
■ 2 SANbox SSP power supplies (SANbox 8202-08 SSP and SANbox 8202-16
SSP) or
1 SANbox SSP power supply (SANbox 8200-08 SSP)
■ 2 U.S. power supply cords (SANbox 8202-08 SSP and SANbox 8202-16 SSP) or
1 U.S. power supply cord (SANbox 8200-08 SSP)
■ Rack mount kit, if ordered
3-2SN0054628-00 A
Q
6
■ Mounting instructions included with kit, if ordered
■ Warranty card
NOTE:All rack mount kits, including slide, direct, and shelf mount kits for the
SANbox SSP are ordered separately.
3.3
Setting Up SANbox SSP
The SANbox SSP has two serviceable panels: port side and fan side.
Port Side: includes the primary ports. See Figure 3-1.
3 – Getting Started with SANbox SSP
Setting Up SANbox SSP
17
8 9 1011
1 Power Connector 16 Ports 9-16 (SANbox 8202-16 SSP only)11 Console Port
2 Ports 1-87 Power Connector 212 Fan 1 LED
3 Power Supply 1 LED8 Management Port13 Fan 2 LED
4 Alert LED9 High-Availability Port 114 Fan 3 LED
5 Power Supply 2 LED10 High-Availability Port 215 Main Power Switch
NOTE:StoreAge SVM performs cluster communication using Fibre Channel, so
2
Figure 3-1. SANbox 8200/8202 SSP – Port Side
the Ethernet HA1 and HA2 ports are not used.
354
12 13 14
15
SN0054628-00 A3-3
3 – Getting Started with SANbox SSP
41
253
Setting Up SANbox SSP
Fan Side: includes the fans and power supplies. See Figure 3-2.
21
31
Q
2
6
1 Power Supply 24 Power Supply 16 Fan Assembly 3
2 Locking Knob5 Locking Knob7 Fan Assembly 1
3 Fan Assembly 2
NOTE: For SANbox 8200-08 SSP, Power Supply 1, Fan 1, Fan 2, and Fan 3 are covered.
Power Supply 2 is removed.
Figure 3-2. SANbox 8200/8202 SSP – Fan Side
3.3.1
Setting Up SANbox SSP Hardware
Setting up SANbox SSP hardware includes: mounting SANbox SSP in a rack,
installing the power supplies, and connecting the power cables.
WARNING!!
The SANbox 8200/8202 SSP can be mounted in the following configurations:
■ Slide mount with separate slide mount kit (preferred)
■ Shelf mount with separate rack mount kit
■ Standard rack mount with four mounting brackets
The SANbox SSP cannot be directly rack mounted with only two
supports. SANbox SSP MUST be mounted using a slide, shelf, or
four support brackets.
7
3-4SN0054628-00 A
Q
3 – Getting Started with SANbox SSP
Setting Up SANbox SSP
To mount SANbox SSP in a rack:
NOTE:
■ See manufacturer’s instructions included with the slide mount kit, the rack
mount kit, and the brackets.
■ Shelf mounting is independent of rack depth.
There are two types of rack mount kits available: the slide kit accommodates rack
depths from 20 inches to 30 inches. The direct rack mount kit requires a rack depth
of 21.5 inches.
NOTE:Air flows from the fan side to the port side in the SANbox SSP. When
installing SANbox SSP in a rack, orient the unit so that the port side faces
the rack's air exit.
You can see the Small Form-Factor Pluggable transceivers and power
and Ethernet cables from the port side.
To install the power supplies:
1. Remove the power supply from the packaging container.
2. Insert the power supply into the designated slot on the far left, which is located
above the fan assembly as shown in the following diagram, so that the power
supply is flush with the fan assembly and the label is facing up.
You may need to apply force when inserting the power supply to make sure it
is installed all the way into the slot.
Figure 3-3. Inserting the Left Power Supply
SN0054628-00 A3-5
3 – Getting Started with SANbox SSP
Setting Up SANbox SSP
3. Lock the supply in place by rotating the knob clockwise until it stops.
4. Once the power supply has been properly inserted, connect a power cable from
an electrical outlet to the power connector on the port side.
The corresponding power supply LED should be illuminated indicating that the
power supply and power cable have been properly installed.
5. Repeat step 1 through step 4 for the second power supply, inserting the power
supply into the power supply slot on the far right.
Q
Figure 3-4. Inserting the Right Power Supply
6. Plug in both power cables.
NOTE:Note: For maximum fault tolerance, plug the power cables into
separate circuits.
To connect the console port:
Attach the provided serial cable between the serial (console) port (labeled ) on
SANbox SSP and an RS-232 serial port on your laptop or host computer.
If the serial cable provided with SANbox SSP is not available, use a standard RS-232
null-modem cable to connect the console port to a host computer.
See Figure 3-1 to see exactly where the console port is located.
3-6SN0054628-00 A
Q
3.3.2
Accessing SANbox SSP for the First Time
The SANbox SSP supports accessing the command line interface (CLI) through
the serial console port. Once you have access to the CLI through the local console,
you can modify the Ethernet settings to enable remote access to SANbox SSP
through the SANbox SSP Management GUI or the CLI.
NOTE:Please allow sufficient time (approximately 2 minutes) for SANbox SSP
to load all the necessary drivers and system software and complete
necessary Power-On Self Test (POST) diagnostics.
To power up SANbox SSP:
Power on SANbox SSP by pressing the Main Power Switch on the port side.
The Main Power Switch should be illuminated, indicating the unit has begun the
power on cycle. See Figure 3-1 to view a picture of the port side of SANbox SSP.
While POST is in progress, the port status LEDs turn amber in color and flicker
intermittently. POST is complete when the port LEDs turn off; this takes
approximately 1-2 minutes. See "POST and the LEDs" on page 6-6 for more
information.
3 – Getting Started with SANbox SSP
Setting Up SANbox SSP
You can also use the Main Power Switch to shut down the SANbox SSP. For more
information, see "Shutting Down SANbox SSP" on page 5-11.
To configure the terminal settings on the host computer:
1. Run a terminal emulation program such as HyperTerminal on the host computer.
NOTE:For best results, configure the terminal program for ANSI terminal
emulation.
2. Configure the terminal on your host computer for 9600 baud, 8 data bits, no
parity, 1 stop bit, and no flow control.
To access the CLI through the serial console port:
1. Press the Enter key to get a prompt on your terminal emulation program.
2. If prompted, enter a login and password to gain administrative privileges.
The default login is kadmin, and the default password is kahuna.
3. QLogic recommends that you change the password; run the Modify User
command to change the password. See "Modify User Command" on page B-16
for more information.
Now that you are locally logged on to the command line interface (CLI),
configure the Ethernet settings for remote access to SANbox SSP. See the
next section, "To modify Ethernet settings for remote access:" on page 3-8.
SN0054628-00 A3-7
3 – Getting Started with SANbox SSP
Setting Up SANbox SSP
To modify Ethernet settings for remote access:
1. Type modify eth to configure the IP address for the management port (labeled
on the port side of SANbox SSP), and enter your IP address, subnet mask,
and gateway parameters.
NOTE:Use the management port, labeled ,to connect your SANbox SSP
to your LAN for management access. If you are connecting SANbox
SSP to a host computer instead of an Ethernet network, you must
use a crossover Ethernet cable.
NOTE:You can connect your host computer directly to the management port
using a crossover cable. If you want to do so without first configuring
the management Ethernet port via the serial console, the default
parameters for the port are:
IP address: 192.168.1.4
Gateway: 192.168.1.1
Netmask: 255.255.255.0
Q
For example, if the Ethernet name of the device is MGMT, the IP address is
192.168.1.4, the gateway is 10.4.2.1, and the subnet mask is
255.255.255.255, here is the command line to enter:
modify eth MGMT ip 192.168.1.4 gateway 10.4.2.1 netmask
255.255.255.255
See "Modify Eth Command" on page B-13 for more information about the
Modify Eth command and configuring the management port.
2. See "Managing SANbox SSP" on page 4-1 to begin managing SANbox SSP
remotely using the SANbox SSP Management GUI and the command line
interface.
Once the management port has been properly configured, IP based
management (telnet and web) can be accessed by using the newly defined IP
address, or the default address of 192.168.1.4 if using a crossover cable.
3-8SN0054628-00 A
3 – Getting Started with SANbox SSP
Q
3.4
Connecting to the SAN
This section provides instructions for connecting StoreAge SVM appliances,
SANbox SSPs, and hosts to the storage area network.
3.4.1
Connecting StoreAge SVM Appliances to the SAN
When setting up a high-availability configuration, you must make sure that each
SVM appliance:
■ Is connected through the back-side fabric to both SANbox SSPs.
■ Can access all storage ports.
To connect SVM appliances to the SAN in a high-availability configuration:
1. Power up one SVM appliance, and connect the first port to the switch labeled
FC Switch A in the configuration diagram, shown in Figure 2-4.
2. Connect the SVM appliance’s second port to the switch labeled FC Switch B.
Connecting to the SAN
3. Power up the other SVM appliance, connect its first port to the switch labeled
FC Switch A, and then connect its second port to the switch labeled FC Switch B.
4. Create two zones: one zone on FC Switch A named Zone back_A, and another
zone on FC switch B named Zone back_B.
5. Add the ports on the SVM appliance to the new zones.
SN0054628-00 A3-9
3 – Getting Started with SANbox SSP
Connecting to the SAN
3.4.2
Connecting SANbox SSPs to the SAN
For high-availability configurations, you must make sure that each SANbox SSP:
■ Can access all storage ports.
■ Is connected to both SVM appliances through the back-side fabric.
To connect SANbox SSPs to the SAN:
1. Using a standard multi-mode (62.5/125um) optical cable, connect ports 1 and
2 of both SANbox SSPs to the switch labeled FC Switch A in the configuration
diagram, shown in Figure 2-4.
The status LED for each SANbox SSP port transitions from off (no light) to
green when the port is connected to the SAN and the Fibre Channel link
becomes active; the port LEDs are shown in Figure 3-5:
Q
Port 1 LED. Link is up when LED
is green (cable not shown).
Port 2 LED. Link is down.
Figure 3-5. SANbox 8200/8202 SSP Port LED Transitions
2. Connect ports 3 and 4 of both SANbox SSP to the switch labeled FC Switch B
in the configuration diagram.
3. Create two zones: one on FC Switch A named Zone front_A, and another
zone on FC Switch B named Zone front_B.
4. Add the SANbox SSP ports connected to FC Switch A to both Zone front_A
and Zone back_A.
5. Add the SANbox SSP ports connected to FC Switch B to both Zone front_B
and Zone back_B.
3-10SN0054628-00 A
Q
3.4.3
Connecting Hosts to the SAN
When setting up a high-availability configuration, you must make sure that each
host:
■ Includes installed and supported high-availability or multi-pathing software.
■ Is connected to both SANbox SSPs in the high-availability solution, and not
connected to any other SANbox SSPs.
To connect hosts to the SAN:
1. Connect one HBA port on each host to the switch labeled FC Switch A in the
configuration diagram in Figure 2-4, and add each of these ports to Zone front_A.
2. Connect the other HBA port on each host to the switch labeled FC Switch B in
the configuration diagram, and add each of these ports to Zone front_B.
3. To access the SVM GUI, start a web browser and point to the IP address you
configured for the SVM appliance.
3 – Getting Started with SANbox SSP
Managing your Configuration
4. Use SVMAdministrator as the user name, and SVMAdministrator for the
password the first time you access the SVM GUI.
5. Configure a new password to use for the SVM GUI.
3.5
Managing your Configuration
See Section 5 Using the SANbox SSP for information about configuring storage,
zoning your SAN, and managing your SAN using the SVM GUI.
Use the SVM GUI to complete management tasks, such as creating storage pools,
virtual volumes, and user-defined hosts (UDH); and assigning a SCSI personality
to each UDH.
SN0054628-00 A3-11
3 – Getting Started with SANbox SSP
Managing your Configuration
Notes
Q
3-12SN0054628-00 A
SANbox SSP Management GUI Reference
This section provides a reference for each screen and panel in the SANbox SSP
Management GUI. Use the SANbox SSP Management GUI to manage the SANbox
SSP chassis. The SANbox SSP Management GUI provides the same functions as
the command line interface.
This section covers the following topics:
■ Managing SANbox SSP
■ Navigating the SANbox SSP Management GUI
3.1
Managing SANbox SSP
You can manage the SANbox SSP in three ways:
■ Remotely through the SANbox SSP Management GUI.
■ Remotely through the command line interface (CLI)
■ Locally through the CLI using the local administrative console
Section 3
The following sections provide more detailed information about each of the three
ways of accessing SANbox SSP.
NOTE:The examples shown in this section illustrate the interface for the
SANbox 8202-16 Storage Services Platform. Operation of the
SANbox 8200-08 SSP and SANbox 8202-08 SSP are identical with
SANbox 8202-16 SSP, with the exception that eight fewer ports are
shown in the SANbox SSP Management GUI and command line interface.
The SANbox SSP Management GUI is supported on Microsoft Windows platforms
running Internet Explorer version 5 or greater. To run the SANbox SSP Management
GUI, Java WebStart must be installed on your management station. Java WebStart
is an application that allows you to download and run a full-featured Java application,
such as the SANbox SSP Management GUI, directly from a web page.
SANbox SSP simplifies the task of configuring the management station by
automatically detecting whether Java WebStart needs to be installed when the
management station first accesses SANbox SSP. If Java WebStart is not present
on the management station, SANbox SSP can provide a copy of the application
that you can download and install. See "To install Java WebStart:" on page 4-2 and
"To download the SANbox SSP Management GUI from a web browser:" on page 4-3
for more information.
Once you've installed the WebStart application, the web console enables you to
access the SANbox SSP Management GUI remotely using your standard web
browser. For web browsers already running Sun's Java WebStart application, skip
the next two sections and see "To log into the SANbox SSP Management GUI:" on
page 4-4.
Q
NOTE:Sun Microsystems provides versions of Java WebStart for Windows and
other platforms through its Java website. You may be able to use the
SANbox SSP Management GUI from non-Windows management
stations using a version of Java WebStart provided by Sun; however,
QLogic only supports the use of the SANbox SSP Management GUI on
Windows platforms running Internet Explorer version 5 or greater in
conjunction with the version of the Java WebStart application provided
with your SANbox SSP.
To install Java WebStart:
For web browsers on Windows platforms that are already running Sun's Java
WebStart application, see the next section “Using the Web Console” instead. For
web browsers on Windows platforms that do not yet have Sun's Java WebStart
application installed, follow this procedure:
1. From a web browser, enter the management port (labeled ) IP address as
the URL and press the Enter key.
2. In the screen that displays, click Here is a local copy for Windows users to
install the Sun Java WebStart Application on your machine.
3. The License Agreement dialog box displays. In the License Agreement dialog
box, click Accept to begin software installation.
3-2SN0054628-00 A
Q
3 – SANbox SSP Management GUI Reference
Managing SANbox SSP
4. In the Installation Directory dialog box, enter the path for the directory to install
the Sun Java WebStart application.
5. The Installation Directory dialog box displays. Click Next and then Finish to
complete the installation.
To download the SANbox SSP Management GUI from a web browser:
NOTE:At least 100MB of free disk space must be available on your host system’s
hard drive for the SANbox SSP Management GUI and WebStart software.
WebStart must be installed from the browser from which you will access
the SANbox SSP Management GUI. For example, you cannot install
WebStart using Netscape and run the SANbox SSP Management GUI
from Internet Explorer.
1. In your web browser, type the IP address of the SANbox SSP management
port, labeled , (example: http://10.4.2.123). The following screen
2. After typing the username and password, click Logon.
3. QLogic recommends that you change the password if you did not already do
so during setup:
■ If you are using the SANbox SSP Management GUI, change the password
on the Telnet screen. See "Telnet" on page 4-12 for more information.
■ If you are using the CLI, run the Modify User command to change the
password. See "Modify User Command" on page B-16.
3.1.2
Using the Command Line Interface (Remotely)
You can remotely connect to the CLI through telnet or ssh. Before you can access
the CLI remotely, you must configure the management port (labeled on the port
side of SANbox SSP). If you did not yet configure the management port for remote
access, see "Accessing SANbox SSP for the First Time" on page 3-7.
After you access the CLI through telnet or ssh, see Appendix B Command
Reference for information about basic operation and configuration commands.
Managing SANbox SSP
To access the CLI using telnet:
For more information about remotely accessing the CLI through telnet, see "To telnet
to the CLI from a web browser:" on page B-4.
To access the CLI using ssh:
You can download a free ssh client from http://www.ssh.com. The ssh command
line to log in to the management IP address is:
ssh kadmin@10.4.2.123
3.1.3
Using the Command Line Interface (Locally)
Most users access the CLI locally only once for configuration when starting the
SANbox SSP for the first time. If you have not yet completed this step, see
"Accessing SANbox SSP for the First Time" on page 3-7.
The top-level navigation point for the SANbox SSP Management GUI is the Chassis
panel on the System tab. The Chassis panel provides property information for the
SANbox SSP.
Q
Figure 3-4. SANbox SSP Management GUIScreen
Using the SANbox SSP Management GUI, you can access these functions.
Table 3-1. SANbox SSP Management GUI Functions
GUI AreaFunctionFor more information, see:
SystemOverall system functionality, SANbox SSP
status, port management, system
configuration
TopologyThe Topology tab is not used for the SANbox
SSP implementation that runs the StoreAge
software
StorageThe Storage tab is not used for the SANbox
SSP implementation that runs the StoreAge
software
Diagnostics Diagnostics for ports and virtual disks "Diagnostics" on page 4-11
TelnetTelnet window"Telnet" on page 4-12
LogList of system events"Log" on page 4-13
"System" on page 4-7
not applicable
not applicable
3-6SN0054628-00 A
Q
3.2.1
System
3 – SANbox SSP Management GUI Reference
Navigating the SANbox SSP Management GUI
System allows you to manage and configure port settings on the SANbox SSP.
To manage external port behavior:
1. Click System on the left pane window.
2. Navigate within the lower window to the Ports folder.
3. Click the specific port to manage. The Port Information screen displays (see
In addition, the following settings can be changed on the System screen:
NOTE:For all the Force Fabric, Initiator, Target, and Speed settings, you must
click Apply before the settings are saved. The Initiator, Target, and Max
Frame Size settings take effect only after rebooting the SANbox SSP.
Force Fabric: selecting this box forces this port to operate in Fabric Mode Only (no
loop support).
Initiator: selecting this box enables initiator (storage back-end) operations through
this port.
Target: selecting this box enables target (front-end) operations through this port.
Speed: changing this box enables you to force the speed operation of the SANbox
SSP port.
Enabling and Disabling Ports
NOTE:Enabling and Disabling ports takes effect immediately after clicking the
Enable/Disable buttons.
Q
Disable: click Disable to disable a port.
Enable: click Enable to enable a port.
3-8SN0054628-00 A
Q
3 – SANbox SSP Management GUI Reference
Navigating the SANbox SSP Management GUI
Ethernet Panel (System)
The Ethernet panel in the System area shows Ethernet configuration information
for the SANbox SSP. To view the Ethernet panel, click the top-level icon in the tree
hierarchy on the left side. Figure 3-6 displays the System Ethernet panel.
Figure 3-6. System Ethernet Panel
An amber LED indicates that the corresponding component is missing, has failed,
or will likely fail soon. Even if your SANbox SSPs appear to be performing normally,
you should replace parts if their corresponding LED has turned amber. See
"Replacing Hardware Components" on page 6-6 for information about ordering and
The Sensors panel in the System area shows diagnostic information for
temperatures, fans, power supplies, and voltages for the power supplies on the
SANbox SSP. To the view the Sensors panel, click Sensors in the tree hierarchy
on the left. Figure 3-6 displays the System Sensors panel.
Q
Figure 3-7. System Sensors Panel
3-10SN0054628-00 A
Q
3.2.2
Diagnostics
3 – SANbox SSP Management GUI Reference
Navigating the SANbox SSP Management GUI
The Diagnostics screen provides statistics for various aspects of the system.
To use the Diagnostics panel:
1. Select an object type:
■ Port
■ Virtual Volume
2. Select a value for the object, such as port number if the object is port.
3. Select a variable to graph.
For example, utilization, errors, and transmit frames are among the variables
that you can graph for a port on the Diagnostics screen.
The following screen shows utilization for ports 4 and 8 (see Figure 3-8):
Figure 3-8. Diagnostic Screen Displaying Port Utilization
This section provides procedures for using the SANbox SSP, including SAN zoning,
configuring storage, creating virtual disks, interpreting LEDs, and shutting down.
This section describes the following procedures:
■ Setting up a High-Availability Configuration
■ SAN Zoning
■ Directly Connecting Devices to SANbox SSP
■ Configuring Storage
■ Using the SVM GUI to Manage Virtual Storage
■ Shutting Down SANbox SSP
4.1
Setting up a High-Availability Configuration
Table 4-1 provides the specific requirements for each component that is part of the
recommended high-availability configuration. The table presents the information for
a highly available configuration with a single host.
Table 4-1. Required Configuration for the Components
of a High-Availability System
Component
a
Type
Host1
Minimum
Required
Required Configuration per Component
■ Supported high-availability or multi-pathing software
installed.
■ Connected to both SANbox SSPs in the high-availability
solution, and not connected to any other SANbox SSPs.
HBA2 per host
■ Each connected to one SANbox SSP (directly or through
a fabric). Each must see only one SANbox SSP.
SANbox SSP2
■ Each can access all storage ports.
■ Each connected to both SVM appliances through the
back-side fabric.
StoreAge SVM
Appliance
2
■ Each one connected through the back-side fabric to both
SANbox SSPs.
■ Each one can access all storage ports.
SN0054628-00 A4-1
4 – Using the SANbox SSP
Setting up a High-Availability Configuration
Table 4-1. Required Configuration for the Components
of a High-Availability System (Continued)
Q
Component
a
Type
Storage arrayAt least
Fibre Channel
switches
or
Director-class
switch
a
See the SANbox SSP release notes for the list of supported hardware including host
operating systems, HBAs, storage, and FC switches.
Minimum
Required
1 device
2 or more
1
Required Configuration per Component
■ Supported RAID device with two or more independent
controllers.
■ All ports are accessible from both SVM appliances.
■ If a dual-controller active/passive RAID is used, the
SANbox SSPs must be cross-connected with the
controllers, which means that each SANbox SSP must
see both controllers in the RAID.
■ Supported Fibre Channel switch.
■ High availability
■ Multiple zones
4-2SN0054628-00 A
Q
4.2
SAN Zoning
NOTE:If you configure your SAN zoning using Fibre Channel World Wide Port
Zoning is a SAN management technique for making the most efficient use of storage
devices in the SAN. This section provides two examples of zoning.
In Figure 4-1, a single Fibre Channel switch is used to connect all storage and
initiators. Zoning is used to partition the front-side initiators (HBAs) and back-side
(target) storage and SVM appliances into two separate logical SANs.
4 – Using the SANbox SSP
SAN Zoning
Names (WWPNs), note that SANbox SSP WWPNs begin with the
hexadecimal digits 5009066. StoreAge SVM appliance WWPNs begin
with 2000111.
Figure 4-1. Single (Zoned) Fabric Configuration
SN0054628-00 A4-3
4 – Using the SANbox SSP
SAN Zoning
Note the following about Figure 4-1:
■ Zone A (pink-shaded area): initiators. All initiators and SANbox 8200-08 SSP
front-side ports (ports 1-4) are zoned together.
■ Zone B (orange-shaded area): storage. All storage ports, the StoreAge SVM
appliance, and SANbox 8200-08 SSP back-side ports (ports 5-8) are zoned
together.
■ The figure shows a configuration that does not use high-availability features.
In Figure 4-2, two independent fabrics and host failover software are used to ensure
availability. Within each switch, zoning is used to partition the front-side initiators,
and back-side (target) storage and both SVM ports. The figure uses
SANbox 8200-08 SSPs/SANbox 8202-08 SSPs.
Q
Figure 4-2. High-Availability Fabric Configuration with Zoning
4-4SN0054628-00 A
Q
Note the following about Figure 4-2:
Primary Fabric (FC Switch A)Secondary Fabric (FC Switch B)
Zone front_A: Primary Initiators
(yellow zone)
All primary HBA ports for each hostAll secondary HBA ports for each host
SANbox SSP 1, Ports 1-4SANbox SSP 2, Ports 1-4
Zone back_A: Primary Storage
(green zone)
All Primary storage ports All Secondary storage ports
SANbox SSP supports the direct connection of its ports to initiator devices. When
directly connecting a device to an SANbox SSP port, make sure that:
■ The device is explicitly configured for loop-only operation (point-to-point is not
supported for directly connecting at this time). See the documentation for your
device for more information.
■ if you are attaching a host, the SANbox SSP port mode is set to target or
initiator-target mode. Do not directly connect storage devices or the SVM
appliance to the SANbox SSP.
See "Modify Port Command" on page B-14 for details on configuring port modes.
SN0054628-00 A4-5
4 – Using the SANbox SSP
Configuring Storage
Figure 4-3 shows initiators connected directly to a SANbox 8202-16 SSP:
Q
Figure 4-3. Connecting Initiators Directly to SANbox SSP
4.4
Configuring Storage
This section provides guidelines for proper zoning, storage access, and maximum
frame size when configuring storage for use with SANbox SSP.
4.4.1
Zoning
See "SAN Zoning" on page 5-3 for zoning examples using the SANbox SSP. As
you configure your storage and plan the zoning, consider the specific requirements
of your particular installation.
4.4.2
Access
The SANbox SSP port connected to the storage must have permission to access
the storage. If you are using a RAID with LUN masking, you must make sure that
the SANbox SSP port has access to the LUN.
4-6SN0054628-00 A
Q
4.4.3
Maximum Frame Size
The default maximum frame size for the SANbox SSP is 1024 bytes. The maximum
frame size must be set to the smallest maximum frame size of any device on the
SAN.
If no device on the SAN is less than 2048 bytes, set the maximum frame size to
2048 bytes for a potential performance advantage. See "Modify Ports Command"
on page B-15 for more information about setting the maximum frame size.
NOTE:The maximum frame size for most SANs can be set to 2048.
4.4.4
Configuration Restriction on RAID Devices
CAUTION!Failure to comply with this restriction can cause the SVM to be unable
to see or access the available storage, or, in the most extreme cases,
data corruption.
4 – Using the SANbox SSP
Configuring Storage
This StoreAge-specific restriction affects RAID devices that are used as back-side
storage.
Some RAID devices allow the administrator to expose multiple logical units on
multiple ports of the RAID device using the same logical unit number (LUN). This
means that a logical unit can be exposed on controller A port 1 as LUN 3, for
example, while simultaneously a different logical unit can be exposed on controller B
port 2, also as LUN 3.
While this is a legal configuration for the RAID devices in question, the device
manager in the SVM GUI (Storage Virtualization Manager Graphical User Interface)
interprets those two distinct LUNs as a single piece of physical storage, with two
available paths.
When accessing storage through SVM GUI, it is important that the administrator
not assign the same LUN ID to different logical units on the same RAID device,
even if those logical units are visible on different ports. Each logical unit on a given
RAID device must have a unique LUN ID.
SN0054628-00 A4-7
4 – Using the SANbox SSP
Using the SVM GUI to Manage Virtual Storage
See Figure 4-4 for a visual representation of the StoreAge-specific restriction affects
RAID devices.
Q
Valid LUN
Configuration
Controller A, Port 1
LUN 1 - Logical Unit 1
LUN 2 - Logical Unit 2
LUN 3 - Logical Unit 3
Incompatible with
StoreAge SVM
Controller B, Port 2
LUN 1 - Logical Unit 1
LUN 2 - Logical Unit 2
LUN 3 - Logical Unit 4
Logical Unit 1
Logical Unit 2
Logical Unit 3
Logical Unit 4
Figure 4-4. StoreAge Configuration Restriction on Back-Side Storage RAID Devices
4.5
Using the SVM GUI to Manage Virtual Storage
This section provides general instructions for creating storage pools and virtual
volumes, creating groups of HBAs, called UDHs (user defined hosts), and assigning
a storage device profile to a UDH. For more information, see the StoreAge
documentation.
NOTE:This information is provided for your convenience. For additional details
about the SVM GUI, see the StoreAge documentation. If there are
differences between the StoreAge documentation and this installation and
configuration guide, follow the StoreAge documentation.
To create storage pools:
1. Open the SVM GUI, and open Volume Manager in tree view.
2. Click Pool, click Create, and then select the physical disks that you want to
include in the pool.
WARNING!!
This step removes the data on the physical disks that are added
to the pool. Once a physical disk is added to a pool, the SVM
GUI controls that disk. The data on disks that are not in a pool
are not subject to this issue.
NOTE:When you create the first storage pool, you are prompted to provide
a domain name that identifies the management domain for the SVM
appliance. Enter a domain name, and then click the Submit button
to commit the new name to the configuration.
3. Enter a name for the pool, and then click Continue.
4-8SN0054628-00 A
Q
4 – Using the SANbox SSP
Using the SVM GUI to Manage Virtual Storage
To create a user defined host (UDH) and set the SCSI personality:
1. Open the SVM GUI, and open Volume Manager in tree view.
2. Click Host, then select Create UDH.
3. Type the name of the host, select the operating system type, and then select
the HBAs to be included in this UDH.
NOTE:A UDH, which is a group of HBAs, enables you to easily control the
virtual volumes exposed to multiple HBAs installed in a single server.
4. Click Confirm to save the association between the host and the selected HBAs.
5. Click Manage under the Host tree, and then click the Manage button on the far
right side of the host to which you want to assign a storage device profile.
NOTE:The storage device profile is called a SCSI Personality in the SVM
GUI.
6. Click the Set SCSI Personality button, and select the personality that you want
to assign to the selected UDH.
See Table 4-2 for the guidelines for selecting the storage device profile. Make
sure you select the personality that is supported for your high-availability
configuration. For a given high-availability configuration, only one personality
type is supported. See the solution guide that corresponds to your
high-availability setup for more information.
:
VMWareLSI RDAC
Windows StoreAge Default
HP-UXHPUX Personality
a
If your platform is not listed, see the SANbox SSP solution guide for your configuration.
7. Click Confirm.
NOTE:You can expose the same virtual volume to different hosts with different
To create virtual volumes:
1. Open the SVM GUI, and open Volume Manager in the tree view.
2. Click Volume, select Create, and then type a name for the new volume.
Table 4-2. Guidelines for Selecting the Storage Device Profile
If you have:a Select this Personality:
personality settings.
3. Select the pool to use for the volume, and enter the capacity that you want to
use from the pool.
SN0054628-00 A4-9
4 – Using the SANbox SSP
Using the SVM GUI to Manage Virtual Storage
4. Assign permissions: R/W for read and write or Off (read only is not supported),
and then click Continue.
5. The new volume displays in the volume list.
6. Perform a hardware rescan on the system. Depending on the system, you may
also need to reboot the initiator to discover the new volume.
4.5.1
Failing Back
Failover to secondary paths on the back-side and front-side is automatic when you
are using an SVM appliance, while failback is manual. Failback causes I/O traffic
to resume using the primary paths. The system does not automatically fail back
once the primary back-side paths are restored. The administrator must perform an
operation on the primary paths to make them active. Until the primary paths are
also active, the system continues using the secondary paths.
On the back-side, if primary path failure has forced the activation of secondary
paths, the primary paths must be made available and active as soon as possible.
This requires both addressing the cause of the failure, and performing a manual
failback operation once the primary paths are made available. If you do not manually
fail back, and all secondary back-side paths fail, the system does not automatically
activate the primary paths on the back-side. Even if the primary paths are available,
the system does not automatically activate the primary paths.
Q
The failback behavior between front-side and back-side paths differs in the case
that all secondary paths fail. For both front-side and back-side paths, primary paths
are not automatically made active once they are available. On some systems,
however, host-based front-side multipathing software does activate the primary
paths if all secondary paths fail on the front-side. This reduces the urgency of
performing the failback operation on the front-side, since a path failure can still be
tolerated. The administrator must still address the failure on the front-side paths
and return the primary paths to an available state.
To fail back front-side traffic (to resume using primary paths ):
1. Open the SVM GUI, and open Volume Manager in the tree view.
2. Click Volume, select Manage under the host tree, and then click the Manage
button on the far right side of the host that you want to failback.
3. Click Fail Back.
The SVM GUI provides the name of the SANbox SSP that the selected host resumes
using.
4-10SN0054628-00 A
Q
To fail back back-side traffic (to resume using primary paths ):
1. Open the SVM GUI, and open Physical Devices in the tree view.
2. Click Manage, and then click the Manage button on the far right side of the
device that you want to failback.
3. Click Fail Back.
4.6
Shutting Down SANbox SSP
This section provides the steps for restarting or shutting down the SANbox SSP.
To restart SANbox SSP from the CLI:
1. Issue the Reboot command from the CLI.
2. Confirm that you are rebooting the system by typing Y at the Reboot system?
prompt.
The system shuts down and restarts, terminating active management sessions
in the process. SANbox SSP will accept new management sessions once the
system is restarted.
4 – Using the SANbox SSP
Shutting Down SANbox SSP
To shut down SANbox SSP from the CLI:
1. Issue the Shutdown command from the CLI.
2. Confirm that you are shutting down the system by typing Y at the Shut down system? prompt.
To shut down SANbox SSP using the Main Power Switch:
WARNING!!
■ AC power must be removed from both power supplies to cut power to the
SANbox SSP electronics.
■ If AC power is removed before the unit is placed into standby, SANbox
SSP automatically starts the boot sequence when power is restored.
To initiate shutdown, press the power button, and wait until the Alert, FAN 1, FAN 2,
and FAN 3 LEDs turn amber.
Once shutdown is complete, the system is in standby mode, and the Alert, FAN 1,
FAN 2, and FAN 3 LEDs turn off.
NOTE:The PS 1 and PS 2 LEDs remain illuminated with a green light as long
as the AC power is connected to the power supplies.
SN0054628-00 A4-11
4 – Using the SANbox SSP
Shutting Down SANbox SSP
Notes
Q
4-12SN0054628-00 A
Maintaining the SANbox SSP
This section provides information about maintaining the SANbox SSP. Maintenance
tasks include updating the SANbox SSP system software, applying software
patches, interpreting LED patterns, and replacing hardware.
The software may require periodic updates to reflect current software releases and
ensure optimum product performance and functionality.
This section covers the following topics:
■ SANbox SSP System Software
■ Boot Sets
■ Maintenance Mode
■ Updating SANbox SSP System Software
■ Interpreting the LED Patterns
■ Replacing Hardware Components
5.1
SANbox SSP System Software
Section 5
SANbox SSP has two system software components that can be updated:
■ System software image: The system software image contains the operating
environment for SANbox SSP, including the StoreAge SVM Agent for SANbox
SSP.
■ Maintenance Mode image: The Maintenance Mode image contains software
that implements basic system maintenance functions for the platform, including
system update capability.
Each release of the SANbox SSP system software includes the system software
image file used to update the SANbox SSP. Maintenance Mode functionality,
however, rarely changes. The release notes for each system software release
indicate whether a new Maintenance Mode image is included, and whether
installation of the new Maintenance Mode image is required to update the system.
The system update capability provided by SANbox SSP also supports the
incremental update of an existing system image by applying a patch file supplied
by QLogic. This system patching capability allows QLogic to distribute critical system
updates between full releases of the system software.
SN0054628-00 A5-1
5 – Maintaining the SANbox SSP
Boot Sets
5.2
Boot Sets
SANbox SSP allows you to install two system images on the platform at once, and
to choose which system image loads when the system boots. The two locations
where system images can be installed are called boot sets.
A valid boot set is one that has been successfully installed with a system image.
An invalid boot set is either empty or contains an image that cannot be used by
SANbox SSP.
The default boot set, selected during system startup, supplies the system software
that the SANbox SSP uses when booted. You can override this default selection
from the local administrative console when the system starts. See "To select the
active boot set from the local console:" below. The selected boot set is used to boot
the system and becomes the active boot set; the boot set that was not selected is
called the inactive boot set.
To s
elect the active boot set from the local console:
1. Connect to the local administrative console using a terminal emulator, such as
HyperTerm.
Q
2. Start or reboot the system.
After the first phase of system initialization completes, output that is similar to
the following displays:
GNU GRUB version 0.93 (630K lower / 2096128K upper memory)
Use the ^ and v keys to select which entry is highlighted.
Press enter to boot the selected OS, 'e' to edit the commands
before booting, or 'c' for a command-line.
The selected entry is 0
Entry 0 will be booted automatically in 10 seconds.
5-2SN0054628-00 A
Q
3. Use the arrow keys to select a boot set, and then press the Enter key to boot
using the selection.
The selected boot set becomes the default boot set when the system is next
restarted.
NOTE:Boot set items marked DIAG are for use by QLogic field service
5.3
Maintenance Mode
Maintenance Mode provides menu options for installing and upgrading your
SANbox SSP software. Maintenance Mode is accessible even when no valid boot
set is installed on the system.
To access Maintenance Mode from the local console:
1. Connect to the local administrative console using a terminal emulator, such as
HyperTerm.
5 – Maintaining the SANbox SSP
Maintenance Mode
personnel; they should not be selected under normal operating
conditions.
2. Start or reboot the system. At the boot menu, use the arrow keys to select an
entry labeled Maintenance Mode, and then press the Enter key to boot using
the selection.
If the entry tagged with ip=dhcp is selected, the system attempts to obtain an
IP address automatically from a DHCP server. Otherwise, you must manually
configure IP from Maintenance Mode to enable access to the SANbox SSP
management port (labeled on the port side of the SANbox SSP).
3. Log into the system as kadmin.
The Maintenance Mode menu displays. The options are:
e: Reconfigure Ethernet
g: Get image package from network
i: Install image package
d: Delete image file
l: List available images to install
s: Show installed versions
r: Reboot
m: Show Menu
SN0054628-00 A5-3
5 – Maintaining the SANbox SSP
Updating SANbox SSP System Software
5.4
Updating SANbox SSP System Software
This section provides procedures for the following:
■ Installing a new system software image
■ Applying a system software patch
■ Installing a new Maintenance Mode image
To install a new system software image on SANbox SSP:
1. Load the current system image file onto a server that is accessible via SCP
from the SANbox SSP to be updated.
A system image for this release has a name similar to:
t3-prod_name-image_1.1.0-15_i386.deb
where prod_name is a string specific to your product.
NOTE:The current system image file is available through ftp or on CD-ROM.
Q
2. Install the new release on one of the boot sets of the SANbox SSP.
a. Reboot the system.
b. Select Maintenance Mode in the boot menu.
c. Log in as kadmin to enter the Maintenance Mode menu.
d. Type e to configure the Ethernet port, if it is not already configured.
e. Choose option g to transfer the image file from the network:
t3-prod_name-image_1.1.0-15_i386.deb
f. Choose option i to install that image.
g. Choose the boot set to which the image will be installed (either 1 or 2), and
type YES to confirm erasure of the boot set.
h. After the image is installed, select option r to reboot the system.
To apply a system software patch:
1. Reboot into Maintenance Mode.
2. Login as kadmin user.
3. Choose option e to configure network (if not configured).
4. Choose option g to transfer the following file:
t3-patch_1.1.0-15c_i386.deb
5-4SN0054628-00 A
Q
5. Choose option i to install the following (or the desired boot set):
t3-patch_1.1.0-15c on bootset 1
6. Choose option r to reboot.
To install a new Maintenance Mode image on SANbox SSP:
The release notes for a given SANbox SSP software release indicate whether an
update to Maintenance Mode is necessary. See the release notes for instructions
on installing the Maintenance Mode image.
5.5
Interpreting the LED Patterns
Figure 5-1 shows the six LED indicator lights on SANbox SSP and the function to
which each light corresponds. A green light indicates normal operation.
An amber LED indicates that the corresponding component is missing, has failed,
or will likely fail soon. Even if your SANbox SSPs appear to be performing normally,
you should replace parts if their corresponding LED has turned amber. See
"Replacing Hardware Components" on page 6-6 for information about ordering and
installing replacement parts.
5 – Maintaining the SANbox SSP
Interpreting the LED Patterns
1
12
2
!
3
123
4
1 Power Supply 1 LED indicator light.
2 Alert LED indicator light: amber indicates a
temperature alert or an internal voltage fault.
3 Power Supply 2 LED indicator light.
4 Fan 1 LED indicator light.
5 Fan 2 LED indicator light.
6 Fan 3 LED indicator light.
Figure 5-1. SANbox SSP LED Panel Indicator Lights (Port Side)
5
6
SN0054628-00 A5-5
5 – Maintaining the SANbox SSP
Replacing Hardware Components
5.5.1
POST and the LEDs
Power-On Self Test (POST) is a diagnostic testing sequence that the SANbox SSP
runs while powering on. If all the hardware is detected and found to be operating
properly, SANbox SSP begins to boot.
While the software is loading, all the port LEDs turn amber and then turn off.
POST has successfully completed when all LED activity has stopped; this takes
approximately 1-2 minutes. SANbox SSP has powered on successfully when the
Alert LED is green, and all port lights are off. If POST never completes, all six LEDs
remain amber.
NOTE:The port LEDs blinks if there is traffic on the SAN.
5.6
Replacing Hardware Components
SANbox SSP comes with transceivers and fans already installed. This section
provides information if you need to replace a fan, transceiver, or power supply.
Q
To replace the fans:
To replace Fan 1 or Fan 3 (40 mm fan), order replacement fan 097-0005 from QLogic
Corporation. The kit includes instructions for replacing the fan.
To replace Fan 2 (80 mm fan), order replacement fan 097-0004 from QLogic
Corporation. The kit includes instructions for replacing the fan.
To replace the power supplies:
Order replacement power supply 097-0006 from QLogic Corporation. The kit
includes instructions for replacing the power supplies.
If you need to install the power supplies, see "To install the power supplies:" on
page 3-5.
5-6SN0054628-00 A
Q
5.6.1
About the Transceivers
NOTE:
■ If the port is not being used, leave the rubber dust cover plugged into the
transceiver.
■ Always use the bail latch to remove and insert the transceiver; do not pull
on the transceiver body.
■ Always put the bail latch into the up position before inserting the Fibre
Channel cable.
SANbox SSP comes with a full set of transceivers already installed, one in each
port. QLogic’s transceivers include a bail latch that must be in the down position
before removing the transceiver and put in the up position before inserting the Fibre
Channel cable.
NOTE:QLogic highly recommends that you use only transceivers certified and
sold by QLogic. The transceivers that QLogic sells are Small Form-Factor
Pluggable industry standard transceivers. If another optical SFP
transceiver is used, other than one recommended and sold by QLogic
Corporation, the user must ensure compliance with UL recognized
standards and DHHS regulations.
5 – Maintaining the SANbox SSP
Replacing Hardware Components
To replace a transceiver:
1. Order replacement transceivers, part number 097-0007.
The kit includes four transceivers.
2. Pull down on the bail latch, and then pull the old transceiver out of the port.
3. Insert the new transceiver into the port.
4. Remove the rubber dust cover from the transceiver before inserting the Fibre
Channel cable.
SN0054628-00 A5-7
5 – Maintaining the SANbox SSP
Replacing Hardware Components
Notes
Q
5-8SN0054628-00 A
Section 6
Troubleshooting
This section provides resolutions for issues that you may experience during system
start-up and configuration of the SANbox SSP.
NOTE:The recommended actions in this section assume that you are
troubleshooting components of the SANbox SSP, and that the platform
is in the original factory configuration. If you have removed or replaced
components or changed any default settings or driver firmware, the
recommendations in this section may not apply.
This section discusses:
■ Before Looking at the Problem Statements
■ Problem Statements and Troubleshooting Procedures
6.1
Before Looking at the Problem Statements
Before looking through the list of problem statements:
■ Confirm that the SANbox SSP is powered on and that the Alert LED is green.
■ Configure the IP address for the management port: from the command line
interface (CLI), run the Modify eth command. See "Modify Eth Command" on
page B-13 for more information about this command.
■ Confirm that all connected ports are fully seated and the link LED is illuminated.
■ Confirm that all the other components of the system (fabric switches, storage
arrays, and so on) are powered up and properly configured.
Before contacting technical support, see “Warranty and Technical Support” for more
information, including how to run Show Debug Dump and how to create a trace file.
SN0054628-00 A6-1
6 – Troubleshooting
Problem Statements and Troubleshooting Procedures
6.2
Problem Statements and Troubleshooting Procedures
This section discusses the troubleshooting procedures for each problem statement.
BACK-END STORAGE NOT FOUND (LOOP/FABRIC)
Check that:
■ SANbox SSP is correctly connected to the fabric.
■ Storage device is correctly connected to the fabric.
■ Zoning of storage-side fabric is correct.
See "SAN Zoning" on page 5-3 for zoning tips.
■ Storage device is configured to allow the SANbox SSP to access the appropriate
LUN.
If you are using a RAID with LUN masking, make sure that the SANbox SSP
port has access to the LUN. In addition, make sure that physical LUNs from the
storage array are configured for Open Systems host mode. The SANbox SSP
supports LUNs 0-255 only.
Q
■ Maximum frame size is correctly set.
Check that SANbox SSP ports are set to the lowest maximum frame size of any
device connected to the fabric. See "Configuring Storage" on page 5-6 for more
information.
BACK-END STORAGE NOT FOUND BY SVM
Check that:
■ SVM device is correctly connected to the fabric.
■ Storage device is correctly connected to the fabric.
The storage device must be configured to allow access to the SVM appliance
and the SANbox SSP. The LUN may be accessible by the SVM appliance but
not by the SANbox SSP. In this case, new virtual volumes created in SVM are
not actually created and are missing from the Show Debug Kdisks list.
See "Show Debug Command" on page B-19 for more information about this
command.
■ Zoning of storage-side fabric is correct. See "SAN Zoning" on page 5-3 for zoning
tips.
■ Storage device is configured to allow SVM to access the appropriate LUN.
Configure storage devices to allow access to the SVM appliance and the SANbox
SSP. If you are using a RAID with LUN masking, you must make sure that the
SANbox SSP port has access to the LUN.
6-2SN0054628-00 A
Q
6 – Troubleshooting
Problem Statements and Troubleshooting Procedures
■ Different logical units have different LUN identifiers.
When accessing storage through the SVM GUI, it is important that the
administrator not assign the same LUN ID to different logical units on the same
RAID device, even if those logical units are visible on different ports. Each logical
unit on a given RAID device must have a unique LUN ID.
See "Configuration Restriction on RAID Devices" on page 5-7 for more
information about this topic.
■ See also "Back-End Storage Not Found (Loop/Fabric)" on page 7-2.
CANNOT ACCESS SANbox SSP CONSOLE PORT
Make sure the terminal settings are properly configured. Set the terminal parameters
for 9600 baud, 8 data bits, no parity, 1 stop bit, and no flow control. In addition, make
sure you are connected to the correct COM port on your system.
CANNOT LOG INTO SANbox SSP (GUI or CLI)
Make sure that:
■ IP address is properly configured.
From the command line interface (CLI), run the Modify eth command. See
"Modify Eth Command" on page B-13 for more information about this command.
■ Make sure your Ethernet cable is connected to the management port (labeled
), which is the first Ethernet port from the left. The high-availability ports are
the two Ethernet ports on the right.
■ Username and password are correct.
■ SANbox SSP is powered on and that the Alert LED is green.
INITIATOR NOT FOUND (LOOP/FABRIC)
Check that:
■ SANbox SSP is correctly connected to fabric.
■ Initiator is correctly connected to the fabric.
■ Zoning of storage-side fabric is correct. See "SAN Zoning" on page 5-3 for zoning
tips.
■ Maximum frame size correctly set.
Check that SANbox SSP ports are set to the lowest maximum frame size of any
device connected to the fabric. See "Configuring Storage" on page 5-6 for more
information.
SN0054628-00 A6-3
6 – Troubleshooting
Problem Statements and Troubleshooting Procedures
INITIATOR NOT FOUND BY SVM
Check that:
■ SVM device is correctly connected to the fabric.
The switch must show that the SVM port is present. Unplug and then plug in the
SANbox SSP front-side connections to the fabric.
■ Initiator is visible to SANbox SSP. If not, try rebooting the SANbox SSP.
Run show debug wwpn in the command line interface. If the initiator is visible
to the SANbox SSP, it displays in the output of this command. See
Command" on page B-19 for more information about this command.
■ See also "Initiator Not Found (Loop/Fabric)" on page 7-3.
■ SANbox SSP is visible to the SVM.
Perform a reinit config on SVM, and then try rebooting the SVM appliance.
■ Reboot the fabric switch.
Q
"Show Debug
VIRTUAL VOLUME NOT DISCOVERED BY INITIATOR
Verify that:
■ Initiator is visible to SANbox SSP.
■ Storage is visible to SANbox SSP.
Perform or run these operations:
■ Run show debug wwpn in the CLI. See "Show Debug Command" on page B-19
for more information about this command.
■ Perform a rescan on the initiator.
■ Reset the initiator's Fibre Channel link. See your initiator documentation for more
information.
■ Reboot the initiator.
6-4SN0054628-00 A
Specifications
This appendix contains the specifications for the SANbox 5602 Fibre Channel
switch. Refer to Section 2 General Description for the location of all connections,
switches, controls, and components.
A.1
Performance Characteristics
Processors
■ SANbox 8202-16 .......................
■ SANbox 8202-08/8200-08 .........
Memory
■ SANbox 8202-16 .......................
■ SANbox 8202-08/8200-08 .........
Ports
■ SANbox 8202-16 .......................
■ SANbox 8202-08/8200-08 .........
Appendix A
Dual Intel Pentium Xeon
Single Intel Pentium Xeon
2 GB
1 GB
16 Fibre Channel ports, each N_port or
NL_port configurable
8 Fibre Channel ports, each N_port or
NL_port configurable
Port Speed...................................... Auto-negotiating 2 Gbps full duplex
Using the SANbox SSP command line interface (CLI), you can configure and
manage SANbox SSP with common command sets.
This appendix provides a reference for each command in the command line
interface for the SANbox SSP. The commands provide the same functions as the
SANbox SSP Management GUI.
You can access the CLI through either the Local Administrative Console or a telnet
session. This appendix provides the steps for accessing the CLI and describes each
of the commands.
This appendix covers the following topics:
■ Command Line Interface (CLI) Overview
■ Accessing the CLI
■ Commands
B.1
Command Line Interface (CLI) Overview
The SANbox SSP provides a command line user interface through serial, telnet,
and ssh connections. All configuration, maintenance, and monitoring of the SANbox
SSP are accessible through the command line interface.
B.1.1
Command Quick Reference by Object
Table B-1 shows which commands are available for the major object types.
Table B-1. Commands by Object Type
Object TypeCommandPage
ethsDisable Eth Command
Enable Eth Command
Modify Eth Command
Show Eth Command
Show Eths Command
portsDisable Port Command
Enable Port Command
Modify Port Command
Modify Ports Command
Reset Port Command
page B-9
page B-10
page B-13
page B-21
page B-22
page B-9
page B-11
page B-14
page B-15
page B-17
SN0054628-00 AB-1
B – Command Reference
Command Line Interface (CLI) Overview
Table B-1. Commands by Object Type (Continued)
Object TypeCommandPage
usersCreate User Command
communitySet Community Command
date/timezoneModify Date Command
fansShow Fan Command
groupsShow Group Command
thermsShow Therm Command
voltagesShow Voltage Command
Delete User Command
Disable User Command
Enable User Command
Show Community Command
Modify Timezone Command
Show Date Command
Show Fans Command
Show Groups Command
Show Therms Command
Show Voltages Command
Q
page B-8
page B-8
page B-10
page B-11
page B-18
page B-19
page B-13
page B-16
page B-19
page B-22
page B-23
page B-23
page B-23
page B-26
page B-27
page B-28
page B-28
B.1.2
Command Syntax and Command Completion
The CLI command syntax is as follows:
command
keyword [value]
keyword [value1] [value2]
The command is followed by one or more keywords. Consider the following rules
and conventions:
■ Commands and keywords are case sensitive.
■ Required keyword values appear in standard font: [value]. Optional keyword
values are shown in italics: [value].
This CLI provides command completion to minimize the typing needed to run
commands. This feature enables you to press the completion key (the Tab key) to
complete a partially typed command line. If the command line fragment is
unambiguous, it is completed with the remainder of the command line.
If there is more than one possible match for a command line fragment, continue
pressing the Tab key to see each of the possible matches. You then type enough
of the command line to distinguish it from the other possible matches.
B-2SN0054628-00 A
Q
B.1.3
Online Help
B – Command Reference
Command Line Interface (CLI) Overview
In addition, you can get a list of legal fields at any point in the command line. For
example if you type show user, and then press the Tab key, a list of existing users
is returned.
The completion feature in the CLI also validates previously typed input. If there is
an error in the command line prior to the point where you have requested completion,
an error is printed and the cursor is set to the point where the command line breaks
the defined syntax rules.
The CLI for the SANbox SSP includes online help. Type part of a command to view
the help information, such as a list of arguments or the proper syntax.
Help Commands
For information about getting a list of commands, see "Help Commands"
(page B-13). For information about getting help with a particular command, see
"Help Command" (page B-12).
Example 1:
Typing modify returns these results:
required arg not present
one of [therm, port, ports, timezone, date, user, eth, '?'] required
Example 2:
Typing show user returns these results:
kadmin@k-> show user
user - (syntax: show user <user name>)
users - (syntax: show users)
"user" is ambiguous, must differentiate between: [user, users]
Please refer to command syntax for detail.
SN0054628-00 AB-3
B – Command Reference
Accessing the CLI
B.2
Accessing the CLI
Once the management port (labeled on the port side of SANbox SSP) has been
properly configured with an IP address, a user can telnet to the SANbox SSP using
a web browser or standard telnet application. After successful bootup, the
management port is available for management purposes.
See "To modify Ethernet settings for remote access:" on page 3-8 or "Modify Eth
Command" (page B-13), if you did not already configure the management port for
remote access.
NOTE:To gain access to the CLI, type the default login and password.
To telnet to the CLI from a web browser:
1. In your web browser, type the IP address of SANbox SSP (example:
http://10.4.2.123).
Q
login: kadmin
password: kahuna
The following screen displays (see Figure B-1):
NOTE:The version number of the SANbox SSP is listed next to the Version
2. Click Telnet Console to run a HyperTerminal session. The following screen
displays (see Figure B-2):
Figure B-2. Telnet Console Login Screen
Log in with the default login and password.
NOTE:QLogic recommends that you change the default password. If you
have not already done so, run the "Modify User Command"
(page B-16) to change the password.
login: kadmin
password: kahuna
SN0054628-00 AB-5
B – Command Reference
Accessing the CLI
The following menu options display (see Figure B-3):
Q
Figure B-3. Telnet Console Menu Options
3. Enter commands into the telnet window to begin managing the SANbox SSP
with the CLI commands.
B.2.1
Users and Groups
The SANbox SSP provides two built-in users and two built-in groups: kadmin is a
member of the Administrator group, and kmonitor is a member of the
Monitor group.
The default password for both accounts is kahuna. See "Modify User Command"
(page B-16) for information about changing the password.
Users in the Monitor group are limited to commands that only view system
configuration and status; Monitor users cannot change the system configuration.
See the show commands, such as "Show User Command" (page B-27) and "Show
Port Command" (page B-23), and so on, for more information.
Users in the Administrator group can create and delete users, and can also
modify users, eths, and ports. See "Create User Command" (page B-8), "Delete
User Command" (page B-8), "Modify User Command" (page B-16), "Modify Eth
Command" (page B-13), "Modify Port Command" (page B-14), and "Modify Ports
Command" (page B-15) for more information.
B-6SN0054628-00 A
Q
B – Command Reference
Accessing the CLI
Table B-2 summarizes the features of the built-in users and built-in groups.
Table B-2. Built-In Users and Groups
View System
Built-in
Users
kadminAdministratorkahunayesyes
kmonitorMonitorkahunayesno
Built-in
Groups
Default
Password
Configuration
and Status
Create/Delete Users
and Modify
Eths/Ports/Users
SN0054628-00 AB-7
B – Command Reference
Commands
B.3
Commands
Clear Command
Clears the screen of text.
Syntaxclear
Create User Command
Creates a new user in the specified group, or views user settings. The groups
defined for SANbox SSP are Administrator and Monitor. When new users
are added, they get the same permissions as the existing kadmin and kmonitor
users. When you issue this command, you must enter an SNMP password greater
than eight characters in length, in addition to your normal account password.
Syntaxcreate user [user name] group [group name]
Q
Keywordscreate user [user name]
Name of the new user
group [group name]
Name of the group to which the user will belong: Administrator or kmonitor.
NotesOnly users belonging to the Administrator group can add, delete, and
disable/enable users, and the current user cannot be disabled or deleted.
See Also"Delete User Command" on page B-8
"Disable User Command" on page B-10
"Enable User Command" on page B-11
"Show User Command" on page B-27
"Show Users Command" on page B-27
Delete User Command
Removes the specified user from the list of administrators who can manage the
SANbox SSP.
Syntaxdelete user [user name]
Keywordsdelete user [user name]
Name of the user that you are removing from the system.
NotesOnly users belonging to the Administrator group can add, delete, and
disable/enable users, and the current user cannot be disabled or deleted.
B-8SN0054628-00 A
Q
See Also"Create User Command" on page B-8
"Disable User Command" on page B-10
"Enable User Command" on page B-11
"Show User Command" on page B-27
"Show Users Command" on page B-27
Disable Eth Command
SANbox SSP includes three Ethernet connections, MGMT, HA1, and HA2. This
command disables the specified Ethernet connection so that it cannot send or
receive network traffic.
This command is used for tightened security purposes. Once you disable the
Ethernet connections using this command, you can access the CLI and administer
SANbox SSP only from the serial console.
Syntaxdisable eth [ethernet name]
Keywordsdisable eth [ethernet name]
Name of the Ethernet that you are disabling: MGMT, HA1, or HA2.
B – Command Reference
Commands
NotesIf you are connected through the management port, disabling the MGMT Ethernet
terminates any active network GUI and CLI sessions, requiring relogin. If you are
using the CLI on the serial console, the connection is not be disrupted.
See Also"Enable Eth Command" on page B-10
"Modify Eth Command" on page B-13
"Show Eth Command" on page B-21
"Show Eths Command" on page B-22
Disable Port Command
Disables the specified Fibre Channel port number so that it cannot send and
receive Fibre Channel traffic.
Syntaxdisable port
[port number]
[*]
Keywordsdisable port [port number]
Port number is an integer 1-8 for SANbox 8200-08 SSP/SANbox 8202-08 SSP or
1-16 for SANbox 8202-16 SSP to indicate the Fibre Channel port.
disable port [*]
* indicates all Fibre Channel ports.
SN0054628-00 AB-9
B – Command Reference
Commands
See Also"Enable Port Command" on page B-11
"Modify Port Command" on page B-14
"Modify Ports Command" on page B-15
"Show Port Command" on page B-23
"Show Ports Command" on page B-24
Disable snmpv3 Command
This command does not turn off Simple Management Protocol. By default, the
system runs Simple Network Management Protocol, version 2. Disabling SNMPv3
means that SNMPv2 is running instead of SNMPv3.
Syntaxdisable snmpv3
See Also"Enable snmpv3 Command" on page B-11
"Show snmpv3 Command" on page B-26
Disable User Command
Q
Temporarily disables the user account without deleting it. The account can later be
enabled using the Enable User Command command.
NotesOnly users belonging to the Administrator group can add, delete, and
disable/enable users, and the current user cannot be disabled or deleted.
Syntaxdisable user [user name]
Keywordsdisable user [user name]
Name of the user account that you are disabling.
See Also"Enable User Command" on page B-11
"Modify User Command" on page B-16
"Show User Command" on page B-27
"Show Users Command" on page B-27
Enable Eth Command
SANbox SSP includes three Ethernet connections, MGMT, HA1, and HA2. This
command enables the specified Ethernet connection so that it can send or receive
network traffic.
Syntaxenable eth [ethernet name]
Keywordsenable eth [ethernet name]
Name of the Ethernet that you are enabling: MGMT, HA1, or HA2.
B-10SN0054628-00 A
Q
See Also"Disable Eth Command" on page B-9
"Modify Eth Command" on page B-13
"Show Eth Command" on page B-21
"Show Eths Command" on page B-22
Enable Port Command
Enables the specified Fibre Channel port number so that it can send and receive
Fibre Channel traffic.
Syntaxenable port
[port number]
[*]
Keywordsenable port [port number]
An integer 1-8 for SANbox 8200-08 SSP/SANbox 8202-08 SSP or 1-16 for
SANbox 8202-16 SSP to indicate the Fibre Channel port.
B – Command Reference
Commands
enable port [*]
* indicates all Fibre Channel ports.
See Also"Disable Port Command" on page B-9
"Modify Port Command" on page B-14
"Modify Ports Command" on page B-15
"Show Port Command" on page B-23
"Show Ports Command" on page B-24
Enable snmpv3 Command
By default, the system runs Simple Network Management Protocol, version 2.
Enabling SNMPv3 means that SNMPv3 is running instead of SNMPv2.
Syntaxenable snmpv3
See Also"Disable snmpv3 Command" on page B-10
"Show snmpv3 Command" on page B-26
Enable User Command
Enables the user account that was previously disabled using the Disable User
Command command.
Syntaxenable user [user name]
Keywordsenable user [user name]
Name of the user account that you are enabling.
SN0054628-00 AB-11
B – Command Reference
Commands
NotesOnly users belonging to the Administrator group can add, delete, and
disable/enable users, and the current user cannot be disabled or deleted.
See Also"Disable User Command" on page B-10
"Modify User Command" on page B-16
"Show User Command" on page B-27
"Show Users Command" on page B-27
Exit Command
Quits this command line interface session, terminates the telnet session, and logs
the user out.
Syntaxexit
See Also"Quit Command" on page B-17
Help Command
Q
Provides information about using the specified commands.
Syntaxhelp
[partial command name]
[command name]
Keywordshelp [partial command name]
Part of a help command (enough of the command to uniquely identify it).
help [command name]
Entire command name.
ExamplesExecuting the command help mod provides the same information as help
modify.
help re returns this help information:
reset - (Reset to known state.)
restart - (Restart a process.)
reboot - (Reboot the host.)
See Also"Help Commands" on page B-13
B-12SN0054628-00 A
Q
Help Commands
Provides a list of the first-level commands available in this command line
interface.
Syntaxhelp commands
See Also"Help Command" on page B-12
Modify Date Command
Sets the system date and time.
Syntaxmodify date [MM/DD/YYYY hh:mm:ss]
Keywordsmodify date [MM/DD/YYYY hh:mm:ss]
MM/DD/YYYY is the month, day, and year for the system time (year must be
4-digits long). hh:mm:ss is the hours, minutes, and seconds for the system time.
B – Command Reference
Commands
NotesOnce the time zone is set, the system automatically switches between Standard
Time and Daylight Saving Time.
See Also"Modify Timezone Command" on page B-16
Modify Eth Command
Configures the Ethernet properties — ip address, gateway, and subnet — for the
specified Ethernet connection.
Syntaxmodify eth [ethernet name]
ip [ip addr]
gateway [gateway router]
netmask [subnet mask]
KeywordsAt least one of the optional keywords is required:
modify eth [ethernet name]
Ethernet connection that you are modifying: MGMT, HA1, or HA2.
ip [ip addr]
IP address of the specified Ethernet.
gateway [gateway router]
Router for the specified Ethernet.
netmask [subnet mask]
Subnet mask for the specified Ethernet.
SN0054628-00 AB-13
B – Command Reference
Commands
Q
NotesIf you are connected through the management port, modifying the MGMT
Ethernet terminates any active network GUI and CLI sessions, requiring relogin. If
you are using the CLI on the serial console, the connection is not disrupted.
See Also"Disable Eth Command" on page B-9
"Enable Eth Command" on page B-10
"Show Eth Command" on page B-21
"Show Eths Command" on page B-22
Modify Port Command
Changes the specified keywords—type, capability, speed—for the specified Fibre
Channel port number.
Syntaxmodify port [port number]
type [port type]
capability [port capability]
speed [port speed]
KeywordsAt least one of the optional keywords is required:
modify port [port number]
An integer 1-8 for SANbox 8200-08 SSP/SANbox 8202-08 SSP or 1-16 for
SANbox 8202-16 SSP to indicate the Fibre Channel port.
capability [port capability]
FCP_TARGET: to enable the port to be used as a front-end (looks like a storage
array port).
FCP_INITIATOR: to initiate back-end traffic to disks (cannot receive storage).
both: traffic can go both ways.
speed [port speed]
1G, 2G, NEGOTIATE
type [port type]
N_PORT: the port functions only in conjunction with a single-attached device that is
capable of fabric mode operation.
AUTO: enables the port to initialize in the most appropriate mode, either loop
(NL_Port) or fabric (N_Port), according to what is on the other end of the link.
NOTE:Ports should generally run in fabric mode because fabric yields better
throughput and links recover more quickly.
NotesYou must restart the system for port capability or port speed changes to take
effect.
B-14SN0054628-00 A
Q
maxframesize is not a keyword for this command because all ports must share the
same frame size.
See Also"Disable Port Command" (page B-9)
"Enable Port Command" (page B-11)
"Modify Ports Command" (page B-15)
"Reset Port Command" (page B-17)
"Show Port Command" (page B-23)
"Show Ports Command" (page B-24)
Modify Ports Command
Changes the specified keywords — type, capability, speed — for all SANbox SSP
ports.
Syntaxmodify
ports type [port type]
capability [port capability]
speed [port speed]
maxframesize [size (in bytes)]
B – Command Reference
Commands
KeywordsAt least one of the following keywords is required:
capability [port capability]
FCP_TARGET: to enable the port to be used as a front-end (looks like a storage
array port)
FCP_INITIATOR: to initiate back-end traffic to disks (cannot receive storage)
both: traffic can go both ways
maxframesize [size (in bytes)]
Smallest maximum frame size of any device on the SAN, usually 2048. Some
systems require 1024, or even smaller.
This number specifies the maximum frame size that Kahuna can negotiate to
exchange with other Fibre Channel devices. This number must be the same throughout the SAN.
ports type [port type]
N_PORT: the port functions only in conjunction with a single attached device that is
capable of fabric mode operation.
AUTO: enables the port to initialize in the most appropriate mode, either loop
(NL_Port) or fabric (N_Port), according to what is on the other end of the link.
NOTE:Ports should generally run in fabric mode because fabric yields better
throughput and links recover more quickly.
SN0054628-00 AB-15
B – Command Reference
Commands
speed [port speed]
NEGOTIATE, 1G, 2G
Q
NotesYou must restart the system for port capability, port speed, or frame size changes
to take effect.
See Also"Disable Port Command" on page B-9
"Enable Port Command" on page B-11
"Modify Ports Command" on page B-15
"Reset Port Command" on page B-17
"Show Port Command" on page B-23
"Show Ports Command" on page B-24
Modify Timezone Command
Starts a Time Zone Configuration utility that enables you to select your
geographical area and time zone, and then modify your local time if needed.
Syntaxmodify timezone
NotesOnce the time zone is set, the system automatically switches between Standard
Time and Daylight Saving Time.
See Also"Show Timezone Command" on page B-27
Modify User Command
Adds the specified user to the specified group. This command also changes the
password defined for the specified user.
The groups defined for SANbox SSP are Administrator and Monitor. When
new users are added, they get the same permissions as the existing kadmin and
kmonitor users.
Syntaxmodify user [user name]
group [group name]
password
Keywordsmodify user [user name]
User name that you want to add to the specified group.
group [group name]
Name of the group to which you are adding the specified user: Administrator
or Monitor.
password
Include this keyword if you want to change the password.
B-16SN0054628-00 A
Q
See Also"Disable User Command" on page B-10
"Enable User Command" on page B-11
"Modify User Command" on page B-16
"Show User Command" on page B-27
"Show Users Command" on page B-27
Quit Command
Exits this command line interface session, terminates the telnet session, and logs
the user out.
Syntaxquit
See Also"Exit Command" on page B-12
Reboot Command
Restarts the SANbox SSP.
B – Command Reference
Commands
Syntaxreboot
Reset Port Command
Shuts down the port and then restarts it, leaving the properties of the port
unchanged. Use this command to clear a port that is in an unknown state and
trigger the discovery process.
WARNING!!
Syntaxreset port
[port number]
*
Keywordsreset port [port number]
An integer 1-8 for SANbox 8200-08 SSP/SANbox 8202-08 SSP or 1-16 for
SANbox 8202-16 SSP to indicate the Fibre Channel port.
reset port *
* indicates all Fibre Channel ports.
Running this command disrupts any traffic on this port, and should
never be performed on a port that is moving data. Doing so could
cause read/write failure and error conditions in software if traffic has
occurred.
See Also"Modify Ports Command" on page B-15
"Show Port Command" on page B-23
"Show Ports Command" on page B-24
SN0054628-00 AB-17
B – Command Reference
Commands
Q
Restart snmp Command
Stops and then restarts the Simple Network Management Protocol process.
Syntaxrestart snmp
Set Community Command
Changes the name of the community string. The community string for SANbox
SSP is public.
Syntaxset community [community name]
Keywordsset community [community name]
Name to which you want to change the community string.
NotesThe SNMP Community string is similar to a user id or password that allows
access to a router's or other device's statistics. It is standard practice for network
managers to change the community string so that outsiders cannot see
information about the internal network.
See Also"Show Community Command" on page B-19
Show Chassis Command
Returns the part number, MAC base address, serial number, or original
manufacture date for the SANbox SSP.