You are on page 1of 40

3PAR InForm Operating System

and Administration Tools


2.2.2 Release Notes

3PARdata, Inc.
4209 Technology Drive
Fremont, CA 94538 USA
320-1418-01
July 2006

Revision Notice
This is the first release of these release notes.

Changes
The material in this document is for information only and is subject to change without notice. While reasonable efforts have been
made in the preparation of this document to assure its accuracy, 3PARdata, Inc. assumes no liability resulting from errors or omissions
in this document or from the use of the information contained herein.
3PARdata reserves the right to make changes in the product design without reservation and without notification to its users.

Updates to the Documentation at 3PAR Central


Any updates to this document, or to other 3PAR technical documents, can be found by logging in to 3PAR Centrals Document
Control System from 3PARs Support page at http://www.3par.com/support/index.html

3PAR Technical Support and Services


Contact your local service provider for technical support and services.

Sales and Ordering Information


For sales and ordering information, contact:
3PARdata, Inc. 4209 Technology Drive
Fremont, CA 94538 USA
Telephone: 510-413-5999
Fax: 510-413-5699
Email: info@3pardata.com

Reader Comments and Suggestions


Please email your comments and suggestions about this document to ReaderComments@3pardata.com.

Copyrights
2002-2006 3PARdata, Inc. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or
transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior written
consent of 3PARdata, Inc., 4245 Technology Drive, Fremont, CA 94538. The users may print one copy for personal use. Production of
multiple copies or copies for sale is strictly prohibited.

Trademarks
3PAR, InServ, InForm, InSpire and Serving Information are registered trademarks of 3PARdata, Inc.
All other trademarks and registered trademarks are owned by their respective owners.

3PAR InForm Operating System and Administration Tools Release Notes

Table of Contents
1

Introduction
Audience

1.1

Organization

1.2

Related Documentation

1.2

3PAR InForm Operating System Release Notes


Online Upgrade Considerations

2.1

Supported Platforms

2.2

New Platform Support

2.2

End of Support Platforms

2.3

Components

2.4

Whats New in the InForm OS

2.5

Midrange Utility Platform Support

2.5

Native iSCSI Support

2.5

Consistent Multi-Volume Physical Copies

2.5

Support for up to 32, 000 Virtual LUNs

2.5

HP MC Service Guard Support

2.5

3PAR Multipath I/O for Microsoft Windows v1.0.16

2.5

3PAR InForm CIM API (enhanced)

2.6

Modifications to the InForm OS

2.7

Table of Contents

iii

3PAR InForm Operating System and Administration Tools Release Notes

Limitations of the InForm OS


Fibre Channel/SCSI Interface

2.8

Deleting Large Snapshot Volumes

2.8

Fibre Channel and N-to-1 Remote Copy

2.9

Known Issues with the InForm Operating System

2.9

Controlport rst Problem with Fibre Channel Adapter by LSI Logic

2.9

3.2

Virus Checking

3.2

Scripting Considerations

3.2

Solaris Installation

3.3

Whats New in the InForm GUI

3.4

Drive Cages

3.4

Hosts

3.4

Node Subsystem

3.4

Ports

3.5

Usability

3.5

Modifications to the InForm GUI

3.5

Limitations of the InForm GUI

3.6

Supported InServ Storage Servers

3.6

Limit on Number of Open Windows when Displaying Events

3.6

Known Issues with the InForm GUI

Table of Contents

2.10

3PAR InForm Administration Tools Release Notes


Installation Notes for the InForm Administration Tools

iv

2.9

Uncontrolled Shutdown (Bug 7833)

Dynamic Optimization

2.8

3.6

Statistics Plot wont Continue after Node Failure (Bug 502)

3.6

Statistics ALL Plots Fail when a Single Resource Fails (Bug 3086)

3.6

Fatal Error when Changing Versions of InServ Software w/GUI Running (Bug 5641)

3.7

JVM Not Found Error During Installation on Solaris (Bug 6113)

3.7

Out of Memory Error when Plotting Many Statistics for an Extended Period of Time (Bug 9878)

3.7

3PAR InForm Operating System and Administration Tools Release Notes

Drive Cage Detail Screen Cannot Detect Servicing of FC-ALs (Bug 9950)

3.8

GUI Fatal Error When Blocked from Listening for Network Connections (Bug 10812)

3.8

Updating Template doesnt Update Enabled State of VV Settings (Bug 11131)

3.8

Unable to Disable Allocation Warnings and Limits by Entering 0 (Bug 15343)

3.9

SCSI-3 Reservations Failed to load Message Box During Initial System Connection (Bug 18431)

3.9

Apply and Repeat does not Remember Disk Filter Settings during VV Creation (Bug 20539)

3.9

Whats New in the InForm CLI

3.10

Alerts/Events

3.10

Copy Services

3.10

Drive Cages

3.10

Hosts

3.10

Node Subsystems

3.11

Performance

3.11

Physical Disks

3.12

Ports

3.12

Remote Copy

3.12

Security

3.13

Service

3.13

SNMP

3.13

Volume Management

3.14

Remote Command and Options

3.14

Deprecated Commands and Options

3.14

Modifications to the InForm CLI

3.16

Known Issues with the InForm CLI

3.17

JVM not Found Error During Installation on Solaris (Bug 6113)

3.17

servicecage Command wont Force one Loop Off if the Other Loop has Failed (Bug 6561)

3.17

Cryptic Error from upgradepd -w wwn (Bug 7455)

3.17

InServ Unable to Create VV when Space is Available (Bug 8521)

3.18

servicecage Command Fails and doesnt Clean Up (Bug 9153)

3.18

CLI Server Process Crashed and Consumed System Memory (Bug 18024)

3.18

Table of Contents

3PAR InForm Operating System and Administration Tools Release Notes

Error when Renaming Volumes when New Name is Greater than 19 Characters (Bug 18612)

vi

Table of Contents

3.19

3PAR InForm Operating System and Administration Tools Release Notes

1
Introduction
In this chapter
Audience

1.1

Related Documentation

1.2

Organization

1.2

This document provides the release notes for the 3PAR InForm OS
(Operating System) and associated InForm Administration tools.
This document should be read prior to installation of the 2.2.2 release.
NOTE: These release notes describe the features and bug fixes included
in InForm OS 2.2.2. For releases prior to 2.2.2, refer to the release notes
for that particular release.

Audience

The information in these release notes is intended for use by 3PAR


customers and partners, and 3PAR field representatives.

Introduction

1.1

3PAR InForm Operating System and Administration Tools Release Notes

Organization

This manual is organized as follows:

Chapter 1, Introduction, this chapter.

Chapter 2, 3PAR InForm Operating System Release Notes, provides


the InForm Operating System release notes.

Chapter 3, 3PAR InForm Administration Tools Release Notes,


provides the InForm Administration Tools release notes.

Appendix A, 3PAR InForm Operating System and Administration


Tools 2.2.1 MU1 Release Notes provides the InForm Operating
System and Administration Tools release notes for MU1.

Related
Documentation

The following documents also provide information related to InServ


Storage Servers and the InForm Operating System:
For information about

Read the

Pre-planning installation of

S400/S800 Storage Server Physical

the 3PAR InServ S400/S800

Planning Manual

Storage Server
Pre-planning installation of

E200 Storage Server Physical

the 3PAR InServ E200 Storage

Planning Manual

Server
Configuring and managing

InForm OS Administrators Guide

InServ Storage Servers


Using the InForm command

InForm OS Command Line Interface

line interface (CLI)

Reference

Identifying storage server

InForm OS Messages and Operators

components and fixing

Guide

problems

1.2

Introduction

3PAR InForm Operating System and Administration Tools Release Notes

For information about

Read the

Configuring and using 3PAR

3PAR Remote Copy Users Guide

Remote Copy
Installing, configuring and

3PAR Multipath I/O for Microsoft

using 3PAR Multipath I/O for

Windows

Microsoft Windows

Introduction

1.3

3PAR InForm Operating System and Administration Tools Release Notes

1.4

Introduction

3PAR InForm OS and Administration Tools Release Notes

2
3PAR InForm Operating
System Release Notes
In this chapter

Online
Upgrade
Considerations

Supported Platforms

2.2

Components

2.4

Whats New in the InForm OS

2.5

Modifications to the InForm OS

2.7

Limitations of the InForm OS

2.8

Known Issues with the InForm Operating System

2.9

This feature allows the upgrade of the InForm OS concurrently with I/O
activity on the attached hosts, provided certain conditions are met. For
further information and pre-planning of Rolling Upgrades, refer to the
InForm OS Upgrade Pre-Planning Guide, 320-1307.

3PAR InForm Operating System Release Notes

2.1

3PAR InForm OS and Administration Tools Release Notes

Supported
Platforms

The 3PAR Configuration Matrix for InForm OS 2.2.2 contains information


about supported hardware and software platforms. Contact your local sales
engineer or service representative to obtain a copy, or find it online at
http://www.3par.com. Use your 3PAR login userid to search the Document
Control System for the Configuration Matrix, Document Number 931.X.

New Platform
Support

The following platforms are now supported with the 3PAR InServ Storage
Server:

Solaris 8, 9, 10 with Emulex HBAs with native Sun HBA drivers ?????

Red Hat 4 with Symantec VxVM 4.1

Red Hat Global File System (GFS)

SuSE SLES 9 with Symantec VxVM 4.1

VmWare ESX 2.5.3

VmWare ESX 2.5.1, 2.5.2, and 2.5.3 with Emulex HBAs

Windows 2003 R2 ?????????

Egenera PAN Manager 4.1 and 5.0

McData i10K switch

Please review the 3PAR Configuration Matrix and Best Practice documents
for InForm OS 2.2.2 for details. These documents can be accessed online
through the Document Control System.

2.2

3PAR InForm Operating System Release Notes

3PAR InForm OS and Administration Tools Release Notes

End of Support
Platforms

Starting with the InForm OS 2.2.2 release, the following platforms will no
longer be supported.

???????? Anything ??????

?????Anything like below for 2.2.2 ?????????


Additionally, for customers migrating from InForm OS 2.1.4,
interoperability with the following platforms was discontinued beginning
with InForm OS 2.2.0. However, support for these platforms remain with
InForm OS 2.1.4.

Auspex

Egenera 3.1.1

3PAR MPIO for Microsoft Windows v1.0.5.2 and v1.0.9

NetWare 6.0

QLDirect (failover software) on Microsoft Windows 2000 and Windows


2003

Red Hat 7.3

Solaris 8 and 9 with Sun SOC X6730 HBA

SuSE 8.2 Professional with Emulex HBAs

SuSE SLES 8 with Emulex HBAs

Tru64 5.1a

Tru64 5.1b

3PAR InForm Operating System Release Notes

2.3

3PAR InForm OS and Administration Tools Release Notes

Components
Component

Version

OS

2.2.2.98

CLI and GUI

2.2.2.98

BIOS

1.8.6

Drive Cage Firmware:

DC1 Drive Cage Firmware

4.43

DC2 Drive Cage Firmware

1.24

DC3 Drive Cage Firmware

01

Drive Firmware

SNMP Agent

2.4

3PAR InForm Operating System Release Notes

Hitachi DJ Drive Firmware: C1C1

Hitachi EJ Drive Firmware: C0C0

Seagate 10K7 Drive Firmware: 0005

Seagate NL35 Drive Firmware: 0002

1.3.0

3PAR InForm OS and Administration Tools Release Notes

Whats New in
the InForm OS
Midrange Utility
Platform Support

3PAR InForm OS Release 2.2.2 is a feature release. New features included in


InForm OS Release 2.2.2 are described below.
Support for 3PAR InServ E200 Storage Server is now available. InServ E200
brings the benefits of Utility Storage for departmental or remote office
consolidation. Please inquire with a 3PAR Sales Representative or a 3PAR
authorized reseller for more information on InServ E200.

Native iSCSI
Support

3PAR Utility Storage extends multi-protocol support in a single system with


added support for 2-port iSCSI HBAs on 3PAR X-Series 2400 MHz Controller
Nodes. Users can now consolidate both Fibre Channel and iSCSI hosts on a
single 3PAR InServ Sx00 or E200 Storage Server. Native iSCSI connectivity is
supported for Microsoft Windows, Red Hat Linux, or SuSE Linux hosts. 3PAR
iSCSI HBAs are equipped with full iSCSI and TCP/IP Offload Engine (TOE).

Consistent MultiVolume Physical


Copies

Consistent physical copy of a group of volumes can now be created with


3PAR Full Copy. This enables users to create a consistent, crash-level
recovery point of a database and/or file system that uses multiple 3PAR
Virtual Volumes.

Support for up to
32, 000 Virtual
LUNs
HP MC Service
Guard Support

Within a single InServ Storage Server, there is now support for up to 32,000
Virtual LUNs (VLUNs) providing users with greater flexibility.

Hewlett Packard ServiceGuard clustering software is now supported on


Hewlett Packard PA-RISC architecture servers. Users now have expanded
support for high-availability configurations on HP servers.

3PAR Multipath
I/O for Microsoft
Windows v1.0.16

3PAR MPIO for Microsoft Windows v1.0.16 is now available, enabling


support for "fan-in" of up to four InServ host ports. That is, a single
Microsoft Windows host initiator can now see up to four InServ host ports
when connecting over SAN. Users now have expanded support for highavailability blade server configurations.

3PAR InForm Operating System Release Notes

2.5

3PAR InForm OS and Administration Tools Release Notes

3PAR InForm CIM


API (enhanced)

In addition to previous capabilities, the CIM API now supports the following
SMI-S Array Subprofiles and Packages:

Supported Array
Packages
Package

Version

Purpose

Block Services

1.1.0

Provides management of Storage Volumes and


StoragePools.

Supported Array
Profiles
Subprofile

Version

Purpose

Multiple Computer System

1.1.0

Provides information about the multiple computer


systems (controller nodes) that cooperate to
present a virtual computer system (cluster).

iSCSI Target Ports

1.1.0

Provides management of front end (host facing)


iSCSI ports.

Additionally, 3PAR extensions have been added that allow for full Health
and Inventory Management of all physical components that comprise the
InServ Storage Server.
Lastly, a set of View classes have been added to the CIM API. These classes
allow for clients to retrieve information from the CIM Server in a faster,
more efficient manner than with the classes that are used with SMI-S by
aggregating multiple classes and associations into a single class.
For details, please refer to the 3PAR CIM API Programming Reference.

2.6

3PAR InForm Operating System Release Notes

3PAR InForm OS and Administration Tools Release Notes

Modifications
to the InForm
OS
Bug ID

Item

Description

12920

Running

The previous behavior when removing an SNMP community

removesnmppw kills

string using the removesnmppw CLI command was to re-

the SNMP agent and

initialize the SNMP agent by killing the process.

results in an SNMP
trap.

This has been changed; running the removesnmppw


command now does not kill the SNMP agent process or
generate any traps.

17031

CIM Server not able

In the case where the CIM Server is not running on the

to receive all SLP

Controller Node with the active IP address, the CIM Server

messages.

would not receive any DA advertisements or SA service


request multicasts, effectively disabling SLP discovery.
This has been fixed.

17343

Remote mirroring

Remote mirroring transmit buffer grew too large, causing

buffers caused node

the Controller Node to crash due to being out of memory.

problems.
The maximum size of the buffers has been reduced.
18054

Events not processed

Events were not being processed by the SP when the InServ

by the SP.

had certain ranges of IP addresses.


Firewall rules were corrected to properly handle this
situation.

3PAR InForm Operating System Release Notes

2.7

3PAR InForm OS and Administration Tools Release Notes

Bug ID

Item

Description

18894

The system manager overran a buffer of log sense write error


parameter pages read from a drive while searching for the
total number of unrecovered error sectors parameter.

20436

Total battery count

The kernel's total battery count for the node went out-of-

for the node out of

sync with the battery counts maintained for each power

sync.

supply. This data was reported to the cimserver, which


allocated memory based upon the total battery count, and a
segfault occurred when accessing data beyond the allocated
limit.
This has been fixed.

Limitations of
the InForm OS
Fibre Channel/
SCSI Interface

The InForm OS does not provide user-level control on write caching via the
SCSI mode select command. Write-caching is on by default. Deferred errors
will never be reported after status is sent for a write command. The InServ
storage system software may go into write-through mode while handling
certain events such as loss of battery charge or a faulty node.
The following SCSI commands are supported but are effectively null
operations: rezero_unit, format_unit, seek, verify, sync_cache,
send_diag. The SCSI command write verify performs a write operation but
not a verify operation.
Head-of-queue and ordered-queue are not supported. Simple-queue
currently defaults to unrestricted reordering.

Deleting Large
Snapshot
Volumes

For volumes that are extremely large and/or have a large amount of
ongoing writes, deleting snapshots of the volume may take a long time.
This is particularly the case for volumes larger than 100G. Times in excess of
20 minutes have been observed in the worst cases. As of release 2.1.2, this
no longer blocks growth of TPVVs, CPVVs and CPGs, which previously could

2.8

3PAR InForm Operating System Release Notes

3PAR InForm OS and Administration Tools Release Notes

cause host writes to fail. However, this will still make both the GUI and CLI
unresponsive for the duration of the snapshot deletion.
In addition to manual deletion via the removevv command, snapshot
deletions may be performed automatically by the use of Physical Copy or
Remote Copy. Remote Copy makes particularly heavy use of snapshot
deletion when it is configured to use asynchronous periodic mode.

Fibre Channel
and N-to-1
Remote Copy

While both Remote Copy over Fibre Channel (RCFC) and N-to-1 remote copy
are supported in this release, N-to-1 is only available when using IP
connections.

Known Issues
with the
InForm
Operating
System
Uncontrolled
Shutdown
(Bug 7833)

If the InServ Storage Server encounters a double node failure where two
nodes undergo an uncontrolled shutdown (i.e. no panic saves), when the
nodes rejoin the cluster, any LDs whose two owners are the two nodes will
go through a check. Currently there is a bug that can cause checks on
RAID 5 LDs between such nodes to remain in the checkld state forever.

Workaround - Perform a shutdownsys reboot. This will allow the LDs


to be checked and restarted.

Controlport rst
Problem with
Fibre Channel
Adapter by LSI
Logic

When the controlport rst command is issued, for an InServ port


manufactured by LSI Logic, the device driver reclaims all the command
resources from the port hardware before disabling the transmitter. During
the reclamation process, if the host sends a command to the port, it will be
replied with a QUEUE FULL status. The behavior cause a problem to the
Egenera BladeFame System Software prior to version 4.0, which on
receiving a QUEUE FULL status, does not perform the failover to the other
path. As a result, pserver blades on the BladeFrame may lose their boot
device and fail.

Workaround - Disconnect the cable on the InServ Storage Server side,


then issue controlport rst.

3PAR InForm Operating System Release Notes

2.9

3PAR InForm OS and Administration Tools Release Notes

Dynamic
Optimization

When the tunealdvv command is used to change the characteristics of


volumes, the system will place all logical disks into writethru mode for a
short period of time (in the order of tens of seconds). The system also will
block off I/O from all hosts for a short period of time (in the order of
seconds). The time at which these operations will occur is close to the end of
the tune process, after data has been copied over to the target regions. On
smaller systems or on larger volumes, this may happen more than once for a
single tunealdvv command. External to the system, this is visible as a
slowdown in host I/O, but will not lead to any disruption of service.

2.10

3PAR InForm Operating System Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

3
3PAR InForm Administration
Tools Release Notes
In this chapter
Installation Notes for the InForm Administration Tools

3.2

Whats New in the InForm GUI

3.4

Modifications to the InForm GUI

3.5

Limitations of the InForm GUI

3.6

Known Issues with the InForm GUI

3.6

Whats New in the InForm CLI

3.10

Modifications to the InForm CLI

3.16

Known Issues with the InForm CLI

3.17

The InForm Administration Tools are used to monitor and administer 3PAR
InServ Storage Servers. The suite of tools consists of the:

InForm Command Line Interface (CLI)

InForm Graphical User Interface (GUI)

3PAR InForm Administration Tools Release Notes

3.1

3PAR InForm Operating System and Administration Tools Release Notes

Installation
Notes for the
InForm
Administration
Tools
Virus Checking

Virus checking is known to slow down and potentially cause problems with
installation of the InForm Administration Tools. Before attempting
installation or uninstallation of the InForm Administration Tools, please
shut down all running applications and disable virus-checking software.

Scripting
Considerations

By default, the InForm Administration Tools are installed in the following


location:

Windows: C:\Program Files\3par\inform\<release>\

Solaris: /opt/3par/inform/<release>/

where:

<release> is the current release version, e.g. 2.2.2.

This is done so that multiple versions of the administration tools can reside
on the same client system simultaneously.
If you have scripts that depend on the location of the binaries for any of the
administration tools, be aware that you will need to update your scripts or
environment variables to point to the latest version of the tools. As an
alternative, if you do not need to keep multiple versions of the tools
installed, you can change the default install location of the tools to a path
of your choosing so that the path stays consistent from release to release.
If you do this, you must fully uninstall the previous version using the
provided uninstaller before installing a new version.

3.2

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

Solaris
Installation

Because of a known problem with InstallShield on Solaris, installation


directly from the CD can occasionally fail. In such a case, the user is
presented with a dialog that reads JVM not found. Given this, 3PAR
recommends that you install via the instructions below.
NOTE: Shut down all running applications and disable virus-checking
software before proceeding with the following instructions.

Insert the InForm OS Administration Tools and Documentation CD into


your CD drive.

Copy /cdrom/cdrom0/solaris/setup.bin to a suitable temporary


location on your hard drive, such as /tmp. You will need approximately
45 MB of temporary free space to copy the file. Note: This temporary
space can be reclaimed at the end of the installation process.

Run the installation using the setup.bin file in temporary location you
just created. For example, if you copied the file to /tmp, the command
to start the installation is:

# ./tmp/setup.bin
4

Follow all instructions during the installation. For detailed information,


please refer to the 3PAR InForm Administrators Guide.

Remove the setup.bin file that you copied.

3PAR InForm Administration Tools Release Notes

3.3

3PAR InForm Operating System and Administration Tools Release Notes

Whats New in
the InForm GUI
Drive Cages

Support for new DC3 drive cage.

Ability to locate cages by turning on LEDs on the entire cage,


magazines, or interface cards (depending on the cage type).

Overall cage state has changed so that the state will either be OK,
Degraded, or Failed. This aligns cage states more closely align with
corresponding alerts.

Hosts

Support for iSCSI

Users now have the ability to annotate hosts with extra information
such as physical location, OS, Model, Contact, etc.

New wizard-based configuration for hosts. Users can enter information


about FC Paths, iSCSI Paths, iSCSI CHAP Authentication, Host Descriptors,
and see a summary of all changes in a step-by-step configuration flow.

New Paths tab on the Host Summary screen shows detailed


information for each SCSI initiator (host path).

New Descriptors tab on the Host Summary screen shows details


about user entered Host annotations.

Node Subsystem

Support for E200 Storage Systems.

System Detail screen now displays system model information.

Complete redesign of the Controller Nodes screens to provide more


detailed information, including information on the Nodes, Power
Supplies, Batteries, and System Fans. Within each node, information
is provided on CPUs, Physical Memory, IDE drives, and installed PCI
Cards.

Addition of overall node state which will either be OK, Degraded, or


Failed. This state is an aggregation of the state of the node and all of its
components. This aligns cage states more closely align with
corresponding alerts.

3.4

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

Ability to enter serial number information on Controller Node power


supplies.

Ability to enter serial and expiration date information, view and reset
test logs for batteries.

Ability to locate a storage system by blinking its LEDs (and optionally the
LEDs on its cages).

Ports

Support for iSCSI adapters.

Display of information for small form factor pluggable (SFP) optical


transceiver modules (E200 systems).

New Sessions tab on the Ports Detail screen for iSCSI ports provides
information on active iSCSI sessions.

Usability

The GUI now remembers which systems youve logged into in the past.

Modifications
to the InForm
GUI
Bug ID

Item

Description

18386

Creation of RAID 5

When creating or modifying CPGs, the Admin space LDs are

CPGs with Set Size

always RAID1, even if the CPG itself is RAID5. The GUI was

greater than 3+1

erroneously passing the set size value the user entered for

fails.

the CPG as the value of the set size for the RAID1 LDs. Any
value above 4 is not valid for RAID 1, resulting in a cryptic
message about the valid set sizes for RAID1.
This has been fixed.

3PAR InForm Administration Tools Release Notes

3.5

3PAR InForm Operating System and Administration Tools Release Notes

Limitations of
the InForm GUI
Supported InServ
Storage Servers

Due to changes in the InForm OS itself, this version of the 3PAR InForm
Graphical User Interface (GUI) can be used only to monitor InServ Storage
Servers running InForm OS version 2.2.1, build 114. It cannot be used to
monitor servers running prior versions of the software, including InForm OS
version 2.2.1, build 88.

Limit on Number
of Open
Windows when
Displaying
Events

Because of the amount of data displayed in the Event Summary screen, if


the user attempts to open multiple windows while displaying this screen,
they may encounter an Out of Memory error, which will cause the InForm
GUI to exit. The number of windows that can be open while displaying
event information is dependent on how many systems InForm GUI is
connected to and the number of events in the eventlog on those systems.

Known Issues
with the
InForm GUI
Statistics Plot
wont Continue
after Node
Failure (Bug 502)

Statistics ALL
Plots Fail when a
Single Resource
Fails (Bug 3086)

If you are plotting statistics and the node that the GUI is connected to
fails, a dialog will be displayed indicating the plots will stop. The error
says, Plot cannot continue.
Workaround - Restart the plot manually.
If you are plotting all resources on a node (such as ALL PDs) and one of
them fails or is removed, rather than continuing with the surviving
resources, the system reports a failure to the GUI. This causes the plot to
stop with an error, Plot cannot continue.
Workaround -The workaround is to restart the plot manually. The plot
will then be initialized with only the surviving resources.

3.6

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

Fatal Error when


Changing
Versions of
InServ Software
w/GUI Running
(Bug 5641)

If you change the version of the software on the InServ while the GUI is
running, it may cause the GUI to crash. This is because of
incompatibilities between the GUI and the data sent from the InServ.
Workaround - When the version of the InServ is changed, the GUI must
match that version. Before upgrading/downgrading the InServ, stop all
GUI sessions. After installing the InServ, make sure to install the
compatible client software.

JVM Not Found


Error During
Installation on
Solaris (Bug
6113)

Occasionally on Solaris, installation will fail with an error JVM not


found. This is caused by Solaris mounting the cdrom with a # character
in the mount point (typically, /cdrom/inform_adm_tools#1).
InstallShield will fail when the mount point contains special characters
such as #.
Workaround - See Installation Notes above for specific workaround
instructions.

Out of Memory
Error when
Plotting Many
Statistics for an
Extended Period
of Time
(Bug 9878)

The amount of time that it takes to consume all memory is dependent


on how many total statistics plots are simultaneously attempted.
Workaround - Possible workarounds:

Limit the amount of memory used by plotting fewer statistics or plot


statistics in separate GUI sessions.

Increase the initial amount of memory the GUI is allowed to use. This
will ensure that the GUI has memory pre-allocated and thus will not fail
due to memory being consumed by other applications. This can be done
by passing an argument in the form of Xms<size>m when starting the
GUI. This option should be used carefully. If the GUI cannot allocate the
initial memory, it will fail to execute. Also, if the GUI is not being heavily
used, or the InServs it is communicating with do not have a large
amount of events, having the GUI allocate large amounts of memory is
wasteful and prevents other applications from utilizing it.

Increase the maximum amount of memory the GUI is allowed to use.


This can be done by passing an argument in the form of Xmx<size>m
when starting the GUI. The default is 64MB and the maximum will
depend on how much memory you have on your system.

3PAR InForm Administration Tools Release Notes

3.7

3PAR InForm Operating System and Administration Tools Release Notes

Options 2 and 3 can be performed on Windows by editing the desktop


icon properties, and on Solaris by passing a parameter to the
inform.bin launcher.

Drive Cage Detail


Screen Cannot
Detect Servicing
of FC-ALs
(Bug 9950)
NOTE: The servicecage command is for service personnel only.

If the servicecage command is issued to prepare a cage FCAL card for


servicing, the GUI cannot detect this and indicate to the user that the
data on the Drive Cage Detail screen may be out of date.
Workaround - As a workaround, always refresh the data after doing
administration on the InServ Storage Server.

GUI Fatal Error


When Blocked
from Listening
for Network
Connections
(Bug 10812)

If InForm GUI is run on a system running a firewall, the firewall may


need to be configured to allow the JVM to listen for and accept inbound
connections. If listening is prevented the GUI will exit indicating an
internal error. If listening is allowed but inbound connections blocked,
the GUI will function normally with the exception that the GUI will not
receive new events or indicate when displayed data is stale.
Workaround - Consult the documentation provided with your firewall,
if any, for how to allow applications to listen for and accept inbound
connections.

Updating
Template doesnt
Update Enabled
State of VV
Settings
(Bug 11131)

3.8

If the user has selected a template during VV creation, then realizes


some of the template settings are incorrect and changes the template,
the VV screen will not be automatically updated with those changes.
Workaround - Re-select the template in the Template pulldown
control on the VV Creation screen. This will refresh the template
properties.

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

Unable to
Disable
Allocation
Warnings and
Limits by
Entering 0
(Bug 15343)

SCSI-3
Reservations
Failed to load
Message Box
During Initial
System
Connection
(Bug 18431)

The user attempted to disable an allocation warning or limit for a CPG


or TPVV by entering the value 0. This is not allowed, since zero is a valid
time.
Workaround - To disable warnings and limits, remove all text from the
text field.

Some users have reported an intermittent problem during initial


connection to an InServ where the GUI will display a message box
indicating that "SCSI-3 Reservations failed to load".
Workaround - Click OK on the message box to dismiss it. The SCSI3
reservation data will be available when navigating to the VV screens.

NOTE: Enhancements to the logging on both the GUI and InServ GUI
server have been added to gather more information about this
problem. Also, related fixes to the GUI server process on the InServ may
have fixed this problem. However, if you see this issue, please contact
your support representative.

Apply and
Repeat does not
Remember Disk
Filter Settings
during VV
Creation
(Bug 20539)

When creating multiple VVs using the Apply and Repeat button in the
VV Creation screens, the settings that were used for disk filtering are
not remembered for subsequent VVs.
Workaround - Re-enter the disk filtering information for each VV
created.

3PAR InForm Administration Tools Release Notes

3.9

3PAR InForm Operating System and Administration Tools Release Notes

Whats New in
the InForm CLI
Alerts/Events

The showalert command has been changed to show only New alerts
by default. A new -all option has been added to show all alerts on
the system.

The default output of the showeventlog and showalert commands


has been made more concise and readable. A new -d option to these
commands provides detailed information. A -old option is also
available on a temporary basis to provide the previous output.

New -comp and -ncomp options to the showeventlog command


allow filtering for entries that either match or do not match the
specified component.

New RemoteSyslog and RemoteSyslogHost subcommands to the

setsys command allows for events to be sent as syslog messages to a


remote system.

Copy Services

A new creategroupvvcopy command allows users to create a


consistency group physical copy of a list of virtual volumes. This capability is
available via the CLI only.

Drive Cages

Support for new DC3 drive cage.

The output of the showfirmwaredb command has been changed to


include a new Cage_type column which indicates which firmware is to
be used for each of the supported cage types.

Hosts

The createhost command has new options to support for iSCSI.

Users now have the ability to annotate hosts with extra information
such as physical location, OS, Model, Contact, etc. This can be done at
host creation time via the createhost command or later via a new

sethost command.

The showhost command has several new options to allow display of


detailed path information, unassigned paths, descriptor information,
and all information at once.

3.10

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

New -iscsi option to the removehost command provides the ability


to remove iSCSI paths from a host.

Node
Subsystems

Support for E200 Storage Systems.

The output of the showsys command has changed for this release. The
output is more concise and the output for the -d option has been
cleaned up and better formatted. For anyone scripting, a -old option
is available to receive output in the previous format.

A new shownode command is available which provides summary and


detail information about Controller Nodes and all their components.

The output of the showbattery command has been changed for this
release and more options are available. For anyone scripting, a -old
option is available to receive output in the previous format.

New options to the setsys command provide the ability to set alert
thresholds on the amount of Fibre Channel or Nearline raw capacity
remaining in the system.

New locatesys command provides the ability to locate a storage


system by blinking its LEDs (and optionally the LEDs on its cages).

Performance

New statiscsi command provides statistics for iSCSI.

New statiscsisession command provides statistics for iSCSI


sessions.

A new utilization column has been added to stat command output.

New -metric option to the hist commands allow users to specify which
metrics to display. (size, time, or both).

New -timecols option to the hist commands allows users to specify


which columns to display when showing an I/O time histogram.

New -sizecols option to the hist commands allows users to specify


which columns to display when showing an I/O size histogram.

New -idlep option to the statch, statld, statpd, statport,

statvlun, and statvv commands provides information on the


percent idle the object is over time.

3PAR InForm Administration Tools Release Notes

3.11

3PAR InForm Operating System and Administration Tools Release Notes

New -lw to the statvlun command provides the WWN or iSCSI Name
in the output. This is especially useful when multiple WWNs/iSCSI Names
belonging to the same host are visible on the same port.

Physical Disks

The admitpd command has been changed so that no arguments are


required when using the -nold option. This allows admitting of multiple
disks while simultaneously marking them not to be used for logical disk
creation.

Ports

New -iscsi and -iscsiname options to the showport command


provides information on iSCSI ports.

New -sfp and -d options to the showport command provide summary


and detail information for small form factor pluggable (SFP) optical
transceiver modules (E200 systems).

New controliscsiport command provides ability to configure


iSCSI ports.

New showiscsisession command shows information about active


iSCSI sessions for each iSCSI port.

New showportarp command shows ARP table information for iSCSI


ports.

New showportisns command shows Internet Storage Name Service


(iSNS) information for iSCSI ports.

The controlport command will now print a warning when executing


either the ct or the persona subcommands when the result of the
command changes the connection type of the port and the operation is
being done on an LSI port. This is because a hard reset will be issued to
the port which will also affect the other port in this port pair.

Remote Copy

New over_per_alert/no_over_per_alert policies to the setrcopygroup


command allow users to specify whether or not an alert should be
generated if a synchronization of a periodic remote copy group takes
longer to complete than its synchronization period. The default
behavior is to generate an alert.

New tunelinks subcommand to the setrcopytarget command


allows users to adjust the performance values for the target's links.

3.12

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

New -d option to the showrcopy command provides more detailed


configuration information.

New -f option to the stoprcopy command allows users to override the


confirmation when using the -clear option.

Security

The createuser and setpassword commands now enforces a


minimum length of 6 characters for passwords.

The removeuser command will return an error if an attempt is made


to remove a user that is currently logged into the system.

Service

New -ovrd option to movech allows chunklets to be moved even if it


results in a loss of quality. This is only used in conjunction with a
permanent move via the -perm option. Also, the -perm option now
allows users to specify just a source address. This effectively permanently
sets the chunklets into their current location and discards their original
location.

New -nodisks option to the servicemag command is available for


use in conjunction with the -log option. This allows the user to specify
clearly that if a magazine with all valid drives is being serviced, then
either the -pdid option has to be used to specify the PD to be replaced,
or the -nodisks option has to be used to specify that no PDs need to
be replaced and only the magazine needs to be reseated or replaced.

The servicehost command has been modified to accept iSCSI Names


as input.

New locatesys command helps users locate systems by blinking the


node status LEDs on each node of the storage system. Users can also
choose whether or not to blink the cage LEDs.

SNMP

The setsnmppw command has been changed to accept community strings


up to 50 characters in length to match the capabilities of the 3PAR MIB.

3PAR InForm Administration Tools Release Notes

3.13

3PAR InForm Operating System and Administration Tools Release Notes

Volume
Management

New -degraded option to the showldch command shows only


chunklets in sets that cause the LD availability to be degraded.

New options to the showldch command provide better visualization of


LD layout.

Support for -degraded on showldch command to show only those


sets that are degraded with respect to LD availability setting.

Remote
Command and
Options

New showvvpd command shows VV distribution across physical disks.

The -f option to the controlpd, startld, and startvv commands


was previously marked deprecated in favor of -ovrd. The -f option
has been removed from all these commands.

The -ba, -bs, and -bu options to the growavv command were
previously marked deprecated. They have been removed from the
command.

The -n option to the statld, statvv, histld, and histvv


commands was previously marked deprecated. It has been removed
from all these commands.

The -n, -s, and -p options to the statpd, statport, statvlun,

histpd, histport, histvlun, showpd, tunepd, and showvlun


commands were previously marked deprecated in favor of -nodes, slots, -ports. They have been removed from all these commands.

The -p option to the showversion command was previously marked


deprecated. It has been removed from the command.

The -h <hostname> option to the showvlun command was


deprecated in favor of -host <hostname>. The -h option is used to
retrieve online help for the command.

Deprecated
Commands and
Options

The -dryrun option to the movech, movechtospare,

movepdtospare, and moverelocpd commands has been deprecated


and will be removed in a future release. Please use the -dr option.

The setbdiskscrub, showbdiskscrub, and setmemscrub


commands have been deprecated and will be removed in a future
release.

3.14

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

The -rc option to the statport command has been deprecated and
will be removed in a future release. Please use the -rcfc and -rcip
options.

3PAR InForm Administration Tools Release Notes

3.15

3PAR InForm Operating System and Administration Tools Release Notes

Modifications
to the InForm
CLI
Bug ID

Item

Description

9960

Cryptic error when

Previously, if the locatecage command was passed a

locatecage is used on

port specifier that is not physically connected, the

an unconnected port

command would return a cryptic error.

specifier.
This has been fixed.
15763

Cannot remove a pattern

If the user created a disk filter pattern for a CPG using

created with setcpg.

the setcpg command, the pattern could not be


subsequently removed.
The command syntax has been enhanced to take "" as
a valid pattern, which then removes previous patterns.

17819

In the createvvcopy

If the parent volume is smaller than the child volume,

command, the number of

the number of blocks to be copied, as reported by the

blocks to be copied may

output of the createvvcopy command, will be

be incorrect.

incorrect. The command was referencing the size of


the child volume, in blocks rather than the parent.
This has been fixed.

18495

Error removing user.

The customer encountered an error removing a user.


The error was returned because the files that contain
user information on the controller nodes had gotten
out of sync, i.e. the user being removed did not exist on
some of the nodes. This was caused by an earlier
attempt to remove the user while the user was logged
in.
The removeuser command has been modified to not
allow for user removal when that user is currently
logged into the system.

3.16

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

Known Issues
with the
InForm CLI
JVM not Found
Error During
Installation on
Solaris
(Bug 6113)

Occasionally on Solaris, installation will fail with an error JVM not


found. This is caused by Solaris mounting the cdrom with a # character
in the mount point (typically, /cdrom/inform_adm_tools#1).
InstallShield will fail when the mount point contains special characters
such as #.
Workaround - See Installation Notes above for specific workaround
instructions.

servicecage
Command wont
Force one Loop
Off if the Other
Loop has Failed
(Bug 6561)

Cryptic Error
from upgradepd
-w wwn
(Bug 7455)

Currently the servicecage command expects both loops to be active


before the command will complete.
Workaround - Use the controlmag command to move the magazines
within the cage offloop.

The upgradepd w wwn command can be used to upgrade firmware on


disks that have not been admitted or cannot be admitted because the
existing firmware is not recognized as valid by the system. When doing
so, however, the following error message may be returned:
Failed --Error in scsi_db file for pd with devid []
rev_level [].
Even though this error is returned, the upgrade has succeeded.
Workaround - After running the upgradepd command, retry the
admitpd command. Then run the showpd command to verify that the
PD has been upgraded and has a valid firmware version.

3PAR InForm Administration Tools Release Notes

3.17

3PAR InForm Operating System and Administration Tools Release Notes

InServ Unable to
Create VV when
Space is
Available
(Bug 8521)

If the user chooses storage settings for set size and availability such that
the desired set size exceeds the availability level, the volume creation
will fail with an error that states that not enough space could be found.
As an example, if the availability is set to Cage and the set size is 4, the
system will look to lay out the volume across four cages. If the system
does not have this many cages, the command will fail.
The error text makes it seem like the amount of storage is the issue,
rather than the number of available resources (cages, magazines, etc.).
The error message text has been modified to clarify the nature of the
problem.
Workaround - Make sure arguments for availability and set size match
the InServ configuration.

servicecage
Command Fails
and doesnt
Clean Up
(Bug 9153)

During servicecage execution, the command attempts to take all


physical disks off the loop being serviced. If, however, one or more disks
have previously failed on the other loop, the command will fail since it
cannot remove the last path to a disk. Upon such a failure, however, the
command does not clean up and put the disks that it had processed back
on the loop.
Workaround - First, to avoid the failure, make sure all disks that are in
the cage being serviced show a State of OK on the loop opposite of the
one being serviced.
Second, to bring physical disks back on the loop manually, use the
controlmag command.

CLI Server
Process Crashed
and Consumed
System Memory
(Bug 18024)

The tls libraries used by the CLI server were leaking memory. This can be
caused by cli clients using a secure connection rather than the default
unsecure connection.
This has been partially fixed in 2.2.2 by upgrading the tls libraries used
by the CLI server. However, a smaller memory leak still remains.
Workaround - Use the default CLI connection type (unsecure).

3.18

3PAR InForm Administration Tools Release Notes

3PAR InForm Operating System and Administration Tools Release Notes

Error when
Renaming
Volumes when
New Name is
Greater than 19
Characters
(Bug 18612)

The createsv and creategroupsv commands allow for volume


names up to 31 characters in length. However, most of the volume
commands such as createaldvv, growaldvv, and setvv where
implemented with a limit of 19 characters. When a user tries to rename
a virtual copy volume using the setvv command, an error will be
returned if the new name is greater than 19 characters even if the
original name is longer.
Workaround - Use names of 19 or less characters for all VV names.

3PAR InForm Administration Tools Release Notes

3.19

3PAR InForm Operating System and Administration Tools Release Notes

3.20

3PAR InForm Administration Tools Release Notes

You might also like