EMC 300-000-978 User Manual

PowerPath for UNIX

Version 4.0

INSTALLATION AND

ADMINISTRATION GUIDE

P/N 300-000-978

REV A03

EMC Corporation

Corporate Headquarters

Hopkinton, MA 01748-9103 (800) 424-EMC2 http://www.EMC.com

Printed July, 2003

EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

Trademark Information

FairCom and c-tree Plus are trademarks of FairCom Corporation and are registered in the United States and other countries.

All other trademarks used herein are the property of their respective owners.

PowerPath for UNIX Installation and Administration Guide

Contents

Preface............................................................................................................................. ix

Chapter 1 Installing PowerPath

Before You Install............................................................................. 1-2

Obtain Up-To-Date Information............................................. 1-2

Choose a Convenient Time ..................................................... 1-2

Locate Your License Key ......................................................... 1-3

Prepare the Host and Storage System ................................... 1-3

Prepare For a Clustered Environment................................... 1-5

Installing PowerPath 4.0 ................................................................. 1-6

Upgrading to PowerPath 4.0........................................................ 1-10

About Upgrading ................................................................... 1-10

Upgrading From PowerPath 3.0.x or 2.1............................. 1-11

Troubleshooting the Upgrade............................................... 1-15

After You Install ............................................................................. 1-16

Remove the CD-ROM ............................................................ 1-17

Reboot the Host....................................................................... 1-17

Verify the PowerPath Installation........................................ 1-18

Verify the PowerPath Commands Are in Your Path ......... 1-19

Verify PowerPath Devices Are Configured on the Host... 1-19

Reconfigure Applications to Use emcpower Devices ....... 1-20

Installing the PowerPath Volume Manager VCS Agent .......... 1-21

Error Messages............................................................................... 1-23

Chapter 2 PowerPath in a Cluster Environment

PowerPath in a Legato 5.1 (or later) AAM Cluster..................... 2-2

Installing PowerPath in a New AAM Cluster ...................... 2-2

PowerPath for UNIX Installation and Administration Guide

iii

Contents

Integrating/ Upgrading PowerPath Into an Existing AAM

5.1 (or later) Cluster.................................................................. 2-3

PowerPath in a Sun Cluster 2.2 ..................................................... 2-4

Installing PowerPath in a New Sun Cluster 2.2................... 2-4

Integrating/ Upgrading PowerPath Into an Existing Sun

Cluster 2.2.................................................................................. 2-5

PowerPath in a Sun Cluster 3.0 ..................................................... 2-6

Installing PowerPath in a New Sun Cluster 3.0................... 2-6

Integrating/ Upgrading PowerPath Into an Existing Sun

Cluster 3.0.................................................................................. 2-7

PowerPath in a VERITAS Cluster Server Cluster ....................... 2-8

Installing PowerPath in a New VCS Cluster........................ 2-8

Integrating/ Upgrading PowerPath Into an Existing VCS

Cluster...................................................................................... 2-10

Configuring VCS to Recognize PowerPath Volume Manager

Resources................................................................................. 2-11

Setting Major and Minor Numbers............................................. 2-13

Chapter 3 Configuring a PowerPath Boot Device on Solaris

Introduction...................................................................................... 3-2

Configuring a PowerPath Native Device as the Boot Device ... 3-3

Partitioning the Boot Device................................................... 3-3

Creating Filesystems ................................................................ 3-4

Installing a Bootblk................................................................... 3-5

Copying Required Files........................................................... 3-5

Modifying OpenBoot ............................................................... 3-7

Setting Up the Boot Alias ........................................................ 3-7

Moving the Boot Device to an emcpower Device....................... 3-8

Recovery Procedure ................................................................. 3-9

Removing PowerPath Control Over a Boot Device.................. 3-11

Chapter 4 Removing PowerPath

Before Removing PowerPath......................................................... 4-2

Removing PowerPath ..................................................................... 4-3

Removing the PowerPath Volume Manager VCS Agent........... 4-6

Chapter 5 PowerPath Administration on Solaris

PowerPath and CLARiiON Storage Systems .............................. 5-2

Ensuring a Sufficient Stack Size..................................................... 5-2

Booting a Host With Built-In Fibre Channel Ports...................... 5-2

Rebooting and Custom Settings .................................................... 5-3

PowerPath for UNIX Installation and Administration Guide

Contents

Boot Device Support....................................................................... 5-3

R1/R2 Boot Failover Support........................................................ 5-4

R1/R2 Supported Configurations ......................................... 5-4

R1/R2 Boot Procedure ............................................................ 5-4

Device Naming................................................................................ 5-5

Native Devices.......................................................................... 5-5

Pseudo Devices......................................................................... 5-6

Selecting a Device Naming Convention............................... 5-6

Reconfiguring PowerPath Devices Online................................ 5-10

Dynamic Reconfiguration............................................................ 5-12

Adding an HBA to a PowerPath Configuration................ 5-12

Removing an HBA From a PowerPath Configuration..... 5-13

Upgrading Solaris ......................................................................... 5-15

Upgrading to Solaris 9 with Solaris Live Upgrade........... 5-15

powercf Configuration Utility..................................................... 5-17

File Location............................................................................ 5-17

Executing powercf ................................................................. 5-17

emcp.conf File......................................................................... 5-17

Syntax ...................................................................................... 5-17

Arguments .............................................................................. 5-18

Error Messages .............................................................................. 5-18

Appendix A Files Changed By PowerPath

Files Created or Modified by PowerPath Installation ............. A-2

/etc............................................................................................ A-2

/basedir/EMCpower/bin....................................................... A-3

/basedir/EMCpower/driver ................................................. A-3

/kernel/drv ............................................................................. A-5

/basedir/EMCpower/lib........................................................ A-6

/basedir/EMCpower/man/man1........................................ A-8

/basedir/EMCpower/scripts................................................. A-9

/usr/bin ................................................................................... A-9

/usr/man/man1..................................................................... A-9

Solaris Files Modified by PowerPath Installation............ A-10

Files Created or Modified by VCS Agent Installation ........... A-11

/basedir/VRTSvcs/EMC...................................................... A-11

/basedir/VRTSvcs/bin/EMCvg......................................... A-11

/etc/VRTSvcs/conf/config ................................................ A-11

/usr/lib .................................................................................. A-11

PowerPath for UNIX Installation and Administration Guide

Contents

Appendix B Customer Support

Overview of Detecting and Resolving Problems ...................... B-2

Troubleshooting the Problem ....................................................... B-3

Before Calling the Customer Support Center ............................ B-4

Documenting the Problem ........................................................... B-5

Reporting a New Problem ............................................................ B-6

Sending Problem Documentation ............................................... B-7

Index................................................................................................................................ i-1

PowerPath for UNIX Installation and Administration Guide

Tables

5-1 Native Devices versus emcpower Devices ............................................... 5-8

5-2 Support for Native and Pseudo Devices ................................................... 5-9

PowerPath for UNIX Installation and Administration Guide

vii

Tab les

viii

PowerPath for UNIX Installation and Administration Guide

Preface

As part of its effort to continuously improve and enhance the performance and capabilities of the EMC product line, EMC periodically releases new versions of the PowerPath software. Therefore, some functions described in this manual may not be supported by all versions of the PowerPath products or the storage-system hardware they support. For the most up-to-date information on product features, see the PowerPath release notes.

If a feature does not function properly or as described in this manual, please contact the EMC Customer Support Center for assistance. Refer to Where to Get Help on page xiii for contact information.

Audience and

Prerequisites

This guide describes the features and functionality of EMC PowerPath

Version 4.0 .

This manual is part of the PowerPath documentation set. It is intended for use by storage administrators and other information system professionals responsible for using, installing, and maintaining PowerPath.

Readers of this manual are expected to be familiar with the Solaris operating system, storage-system management, and the applications used with PowerPath.

PowerPath for UNIX Installation and Administration Guide

Preface

Organization Here is an overview of the information contained in this guide:

◆ Chapter 1, Installing PowerPath, describes how to install

PowerPath on a Solaris host, how to upgrade from an earlier version of PowerPath, and how to install the PowerPath Volume Manager VCS Agent.

◆ Chapter 2, PowerPath in a Cluster Environment, describes how to

install and configure PowerPath in Sun Cluster, Legato AAM, and VERITAS Cluster Server environments.

◆ Chapter 3, Configuring a PowerPath Boot Device on Solaris,

describes how to configure a PowerPath device as the boot device.

◆ Chapter 4, Removing PowerPath, describes how to remove

PowerPath from a Solaris host.

◆ Chapter 5, PowerPath Administration on Solaris, discusses Solaris

issues and administrative tasks.

◆ Appendix A, Files Changed By PowerPath, lists files that are created

or modified by PowerPath installation and upgrade.

◆ Appendix B, Customer Support, reviews the EMC process for

detecting and resolving software problems, and provides essential questions you should answer before contacting the EMC Customer Support Center.

PowerPath for UNIX Installation and Administration Guide

Preface

Documentation

Here is the complete set of PowerPath documentation; all manuals are available from EMC Corporation:

◆ PowerPath Product Guide, EMC P/N 300-000-979

◆ PowerPath for UNIX Volume Manager User’s Guide, EMC P/N

300-000-992

◆ PowerPath for UNIX Installation and Administration Guide, EMC

P/N 300-000-978

◆ PowerPath for UNIX Quick Reference, EMC P/N 300-000-981

◆ PowerPath for UNIX Volume Manager Quick Reference, EMC P/N

300-000-982

◆ Installing and Configuring Emcpower Devices With Solaris

Applications, P/N 300-000-786 (electronic version only)

◆ EMC PowerPath Release Notes, EMC P/N 300-000-980

These documents are updated periodically. Electronic versions of the updated manuals are available on the Powerlink website:

http://powerlink.emc.com.

Symmetrix users should also refer to the EMC Host Connectivity Guides, which are available on the Powerlink website.

CLARiiON users should also refer to the following manuals:

◆ EMC Host Connectivity Guides

◆ EMC Installation Roadmap for CX-Series and FC-Series Storage

Systems, EMC P/N 069001166

◆ EMC ControlCenter Navisphere Manager Version 6.X Administrator’s

Guide, EMC P/N 069001125

Another related EMC enterprise storage publication is the EMC Support Matrix, available on the Web. Go to this page:

http://www.emc.com/horizontal/interoperability

Choose the link to EMC Interoperability Support Matrices, and then the link to EMC Support Matrix.

PowerPath for UNIX Installation and Administration Guide

Preface

Conventions Used in

This Guide

EMC uses the following conventions for notes, cautions, warnings, and danger notices.

A note presents information that is important, but not hazard-related.

CAUTION

A caution contains information essential to avoid damage to the system or equipment. The caution may apply to hardware or software.

Typographical Conventions

EMC uses the following type style conventions in this guide:

AVANT GARDE Keystrokes

Palatino, bold

◆ Dialog box, button, icon, and menu items in text

◆ Selections you can make from the user interface,

including buttons, icons, options, and field names

Palatino, italic

◆ New terms or unique word usage in text

◆ Command line arguments when used in text

◆ Book titles

xii

Courier, italic

Courier

Arguments used in examples of command line syntax.

System prompts and displays and specific filenames or complete paths. For example:

working root directory [/user/emc]:

c:\Program Files\EMC\Symapi\db

Courier, bold

PowerPath for UNIX Installation and Administration Guide

◆ User entry. For example:

symmpoll -p

◆ Options in command line syntax

Where to Get Help For questions about technical support, call your local sales office or

service provider. If you have a valid EMC service contract, contact EMC Customer

Service at:

United States: (800) 782-4362 (SVC-4EMC) Canada: (800) 543-4782 (543-4SVC) Worldwide: (508) 497-7901

Follow the voice menu prompts to open a service call and select the applicable product support.

Sales and Customer Service Contacts

For the list of EMC sales locations, please access the EMC home page at:

http://www.emc.com/contact/

For additional information on the EMC products and services available to customers and partners, refer to the EMC Powerlink website at:

http://powerlink.emc.com

Preface

EMC Support Matrix

For information about products and technologies qualified for use with the EMC software described in this manual, go to this EMC Web page:

http://www.emc.com/horizontal/interoperability

Choose the link to EMC Interoperability Support Matrices, and then the link to EMC Support Matrix.

Your Comments Your suggestions will help us continue to improve the accuracy,

organization, and overall quality of the user publications. Please send a message to techpub_comments@EMC.com with your opinions of this guide.

PowerPath for UNIX Installation and Administration Guide

xiii

Preface

xiv

PowerPath for UNIX Installation and Administration Guide

Invisible Body Tag

Installing PowerPath

This chapter describes how to install PowerPath 4.0 on a Solaris host and how to upgrade from an earlier version of PowerPath. The chapter also describes how to install the PowerPath Volume Manager VCS Agent for a VERITAS Cluster Server (VCS) environment.

The PowerPath Volume Manager Legato Agent is not part of the PowerPath

4.0 package. See the appropriate Legato documentation for information on installing and configuring that agent.

◆ Before You Install ...............................................................................1-2

◆ Installing PowerPath 4.0 ...................................................................1-6

◆ Upgrading to PowerPath 4.0..........................................................1-10

◆ After You Install ...............................................................................1-16

◆ Installing the PowerPath Volume Manager VCS Agent.............1-21

◆ Error Messages.................................................................................1-23

Installing PowerPath

1-1

Installing PowerPath

Before You Install

The sequence in which you configure the storage and install PowerPath® depends on the storage system you use:

Symmetrix

Symmetrix system. Verify that the Symmetrix system is working properly, then install PowerPath using the instructions in this guide.

CLARiiON

part of a CLARiiON setup and configuration procedure. To properly install PowerPath on a host with a CLARiiON array, refer to the EMC Installation Roadmap for CX-Series and FC-Series Storage Systems. There you will find step-by-step instructions for installing PowerPath and other CLARiiON software.

The rest of this section describes what to do before you install PowerPath on the host.

Obtain Up-To-Date Information

Check the Powerlink website (http://powerlink.emc.com) for the most current information:

storage systems. Install PowerPath after you set up the

storage systems. PowerPath installation is an integral

Choose a Convenient Time

1-2

PowerPath for UNIX Installation and Administration Guide

❑ Release notes — We update the PowerPath release notes

periodically and post them on the Web.

❑ Patches and notices — Review the patch ReadMe files to

determine which patches (if any) you want to install after PowerPath, and whether those patches have any added prerequisites that must be met before you install PowerPath.

Installing PowerPath requires you to reboot the host. Plan to install or upgrade PowerPath when a reboot will cause minimal disruption to your site.

Locate Your License Key

The PowerPath license registration key is on the License Key Card delivered with the PowerPath media kit.

If you are upgrading from an earlier version of PowerPath, you need not reregister; PowerPath will use your old key.

Prepare the Host and Storage System

To prepare the host and storage system:

❑ Verify that your environment meets the requirements in:

❑ Environment and System Requirements section of the EMC

PowerPath Release Notes. That section describes minimum hardware and software requirements for the host and supported storage systems.

❑ Chapter 3, PowerPath Configuration Requirements, in the

PowerPath Product Guide. That chapter describes the

host-storage system interconnection topologies that PowerPath supports.

Installing PowerPath

❑ Set up the SCSI target and LUN or Fibre Channel port and LUN

addresses. Refer to the EMC Host Connectivity Guides or Installation Roadmap for FC-Series Storage Systems.

In the

/etc/system file, make sure the timeout value is set to 60

seconds. This minimizes path failover time without compromising online storage-system microcode or base code upgrades. The entry must be a hexadecimal number:

set sd: sd_io_time = 0x3C

❑ Use the Solaris format utility to format, partition, and label the

unused storage system devices such that each unused device has a partition 2 that occupies the entire device. Do not, however, use or mount these devices before installing PowerPath.

Before You Install

1-3

Installing PowerPath

❑ Uninstall any earlier version of PowerPath.

The PowerPath installation program exits if it detects an existing version of PowerPath.

Important: Before you uninstall the earlier version, save your

configuration using the documentation for the earlier version for further uninstallation instructions.

You need not reboot the host after you uninstall the earlier version of PowerPath. You must, however, reboot the host after you install PowerPath 4.0.

❑ Configure HBA drivers.

CAUTION

Be sure to follow HBA driver configuration guidelines outlined by EMC in the EMC Support Matrix and product documentation. Using improper settings can cause erratic failover behavior, such as greatly increased I/O delays.

powermt save command. Refer to the

1-4

❑ For hosts connected to storage arrays via a Fibre Channel switch

(that is, a fabric), configure the HBAs using persistent binding for SCSI target IDs.

CAUTION

Failure to do so could result in loss or corruption of data.

For information about persistent binding, refer to the Host Connectivity Guide for Sun Solaris, the HBA driver documentation,

and the

.conf file for your HBA type.

❑ Optionally, configure the host to send warnings to the console.

By default, warning messages are sent only to the log file. To see warnings on the console:

1. Add the following line to the

localX.Warn /dev/sysmsg

where X is a value that is not used by any other local setting in

/etc/syslog.conf.

PowerPath for UNIX Installation and Administration Guide

/etc/syslog.conf file:

Installing PowerPath

For example:

local0.Warn /dev/sysmsg

The separator between localX.Warn and /dev/sysmsg must be a tab character.

2. Set the RAD_LOG_FACILITY environment variable to

LOG_LOCALX, where X is the number you used in the local

setting of the

/etc/syslog.conf file.

For example, for

setenv RAD_LOG_FACILITY LOG_LOCAL0

For sh, enter:

RAD_LOG_FACILITY=LOG_LOCAL0; export RAD_LOG_FACILITY

Prepare For a Clustered Environment

If you are installing PowerPath in a clustered environment: ❑ Prepare the cluster environment.

Refer to Chapter 2, PowerPath in a Cluster Environment, for information on installing PowerPath in a new or existing cluster.

❑ Find a major number that can be assigned to the PowerPath

driver, number that is unused by any host in the cluster. The installation will prompt you for this number.

Setting the major number is necessary only if you intend to use NFS mounted file systems on PowerPath Volume Manager volumes in your cluster. For more information, refer to Setting Major and Minor Numbers on page 2-13.

To find a unique major number:

emcp, on every host in the cluster. This must be a unique

csh, enter:

1. Enter the following command on every host in the cluster:

sort -n +1 /etc/name_to_major

2. Note the highest major number on every node. Then, when the installation prompts for a major number, use a

number that is higher than all of these.

Before You Install

1-5

Installing PowerPath

Installing PowerPath 4.0

This section describes how to install, or reinstall, PowerPath 4.0 when no earlier version of PowerPath has been installed on the host.

If you are upgrading to PowerPath 4.0 from PowerPath 3.0.x or 2.1, refer instead to Upgrading to PowerPath 4.0 on page 1-10.

Mount the CD-ROM 1. Log in as root.

2. Insert the CD-ROM into the CD-ROM drive. If the CD mounts automatically, continue with Install the Software,

which follows. If the CD does not mount automatically, you must mount it

manually. Continue with step 3.

3. Mount the CD on your file system. For example, to mount the CD on

/cdrom/cdrom0, enter:

mount -F hsfs -r /dev/dsk/cxtydzs0 /cdrom/cdrom0

where x, y, and z are values specific to the host’s CD-ROM drive. For example:

1-6

mount -F hsfs -r /dev/dsk/c0t2d0s0 /cdrom/cdrom0

Install the Software 1. If you do not have a graphics terminal, run the script filename

command to record

pkgadd completes, use CTRL-D to stop recording the output.)

2. Change to the

pkgadd output in the specified file. (After

mount_point

/UNIX/SOLARIS directory. For

example, enter:

cd /cdrom/cdrom0/UNIX/SOLARIS

3. Start the installation program. Enter:

/usr/sbin/pkgadd -d .

PowerPath for UNIX Installation and Administration Guide

Installing PowerPath

4. You see the following prompt:

The following packages are available: 1 EMCpower EMC PowerPath

2 EMCvg EMC Enterprise Cluster PowerPath Volume

Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:

(all) 4.0.0_bxxx

Manager VCS Agent (sparc) 1.0

Enter 1 and press ENTER.

5. You are prompted for the directory where the PowerPath program files will be installed:

Enter package base directory (default: /opt,?):

Press ENTER to accept the default base directory (/opt), or type the path to an alternate base directory and press

ENTER.

PowerPath installs its files in / process creates the EMCpower subdirectory. Make a note of the name and location of the PowerPath base directory for future reference.

6. You are prompted for the directory where the log files will reside:

Enter directory for logging (default: /

Press ENTER to accept the default (/ type the path to an alternate log files directory and press You must specify a local file system.

7. You see the following prompt:

Install for cluster environment [y,n,q,?] (default: n):

• If you are installing PowerPath on a standalone system, press

ENTER. Go to step 10.

• If you are installing PowerPath in a clustered environment,

y and press ENTER. Continue with step 8.

enter

basedir

/EMCpower; the installation

/EMCpower/log):

/EMCpower/log), or

ENTER.

Installing PowerPath 4.0

1-7

Installing PowerPath

8. You are prompted for a major number that can be assigned to the PowerPath device driver (

Assign major number for the device driver [?]:

Enter a major number and press ENTER. You must specify a major number that is not used by any host in the cluster.

The installation will assign this major number to the PowerPath driver. Specify this major number during PowerPath installation on every other host in the cluster.

9. You are prompted to confirm the major number:

Major major will be assigned to the device driver [y,n,q,?] (default: y):

Press ENTER to confirm the major number.

If you have already installed PowerPath 4.0 on the host and are now reinstalling the PowerPath 4.0 software, you see the following prompt:

Configuration for PowerPath 4.0 exists - want to upgrade [y,n,q,?] (default: y):

emcp) on every host in the cluster:

1-8

NTER to preserve your PowerPath configuration.

Press E

Enter n and press ENTER to overwrite your PowerPath configuration.

10. You see the following prompt:

This package contains scripts which will be executed with super-user permission during the process of installing this package.

Do you want to continue with the installation of <EMCpower> [y,n,?]

Enter y and press ENTER.

PowerPath for UNIX Installation and Administration Guide

Installing PowerPath

11. The screen displays information about the installation, ending with:

----------------------------------------------------

* EMCpower installation: * * Installation is successful. * * If you have a license key card, register now. Then * REBOOT the host to complete the remaining steps of the * installation. Refer to the PowerPath for UNIX * Installation and Administration Guide for more * information.

------------------------------------------------------

Installation of <EMCpower> was successful.

The following packages are available: 1 EMCpower EMC PowerPath

(all) 4.0.0_bxxx

2 EMCvg EMC Enterprise Cluster PowerPath Volume

Manager VCS Agent

(sparc) 1.0 Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:

• If you are installing PowerPath for a VCS cluster and you want to install the PowerPath Volume Manager VCS Agent now, enter

2 and press ENTER. Continue with Install the VCS

Agent Software, step 5, on page 1-22.

• Otherwise, enter

q and press ENTER.

PowerPath is now installed on the host. You must register PowerPath, reboot the host, and perform other administrative tasks before PowerPath can run on the host. Refer to After You Install on page 1-16 for postinstallation information and procedures.

Installing PowerPath 4.0

1-9

Installing PowerPath

Upgrading to PowerPath 4.0

This section describes how to upgrade to PowerPath 4.0 from an earlier version of PowerPath.

About Upgrading

Uninstalling the Earlier

Ver sion

Licenses The upgrade preserves your existing PowerPath license. You need

You can upgrade to PowerPath 4.0 from the following releases:

◆ PowerPath 3.0.x

◆ PowerPath 2.1

To upgrade from PowerPath 1.5 or 2.0, you must first upgrade to PowerPath

2.1 or 3.0.x and then upgrade to PowerPath 4.0.

After upgrading from PowerPath 2.0 to PowerPath 2.1 or 3.0.x, you must restore your configuration by running the following command: powermt load file=/etc/powermt.custom.pre-pp2.1.0. Then upgrade to PowerPath 4.0.

Before upgrading to PowerPath 4.0, you must uninstall the earlier version of PowerPath. Follow the instructions in the documentation for that version. Note, however, that you need not reboot the host after you uninstall the earlier version.

Upgrading from PowerPath 2.1: Before you uninstall PowerPath 2.1, search the file /etc/profile for the following string: end of additions. If you find that string, replace it with the following string: done additions.

not reenter license information.

1-10

Configuration Files With the release of PowerPath 4.0, PowerPath configuration files

have changed in both content and number. The upgrade converts your PowerPath 3.0.x or 2.1 configuration files to the newer formats.

The old configuration files are saved in

PowerPath for UNIX Installation and Administration Guide

/etc/emc/emcpxarchive.

Installing PowerPath

Upgrading From PowerPath 3.0.x or 2.1

Mount the CD-ROM 1. Log in as root.

2. Insert the CD-ROM into the CD-ROM drive. If the CD mounts automatically, continue with Install the Software,

which follows. If the CD does not mount automatically, you must mount it

manually. Continue with step 3.

3. Mount the CD on your file system. For example, to mount the CD on

/cdrom/cdrom0, enter:

mount -F hsfs -r /dev/dsk/cxtydzs0 /cdrom/cdrom0

where x, y, and z are values specific to the host’s CD-ROM drive. For example:

mount -F hsfs -r /dev/dsk/c0t2d0s0 /cdrom/cdrom0

Install the Software 1. If you do not have a graphics terminal, run the script filename

command to record

pkgadd completes, use CTRL-D to stop recording the output.)

pkgadd output in the specified file. (After

2. Change to the

mount_point

/UNIX/SOLARIS directory. For

example, enter:

cd /cdrom/cdrom0/UNIX/SOLARIS

3. Start the installation program. Enter:

/usr/sbin/pkgadd -d .

4. You see the following prompt:

The following packages are available: 1 EMCpower EMC PowerPath

2 EMCvg EMC Enterprise Cluster PowerPath Volume

Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:

(all) 4.0.0_bxxx

Manager VCS Agent (sparc) 1.0

Enter 1 and press ENTER.

Upgrading to PowerPath 4.0

1-11

Installing PowerPath

5. You are prompted for the directory where the PowerPath program files will be installed:

Enter package base directory (default: /opt,?):

Press ENTER to accept the default base directory (/opt), or type the path to an alternate base directory and press

ENTER.

PowerPath installs its files in / process creates the EMCpower subdirectory. Make a note of the name and location of the PowerPath base directory for future reference.

6. You are prompted for the directory where the log files will reside:

Enter directory for logging (default: /

Press ENTER to accept the default (/ type the path to an alternate log files directory and press You must specify a local file system.

7. You see the following prompt:

Install for cluster environment [y,n,q,?] (default: n):

• If you are installing PowerPath on a standalone system, press

ENTER. Go to step 10.

• If you are installing PowerPath in a clustered environment,

y and press ENTER. Continue with step 8.

enter

8. You are prompted for a major number that can be assigned to the PowerPath device driver (

Assign major number for the device driver [?]:

emcp) on every host in the cluster:

Enter a major number and press ENTER. You must specify a major number that is not used by any host in the cluster.

basedir

/EMCpower; the installation

/EMCpower/log):

/EMCpower/log), or

ENTER.

1-12

The installation will assign this major number to the PowerPath driver. Specify this major number during PowerPath installation on every other host in the cluster.

PowerPath for UNIX Installation and Administration Guide

Installing PowerPath

9. You are prompted to confirm the major number:

Major major will be assigned to the device driver [y,n,q,?] (default: y):

Press ENTER to confirm the major number.

10. You see the following prompt:

Configuration for PowerPath version exists - want to

upgrade [y,n,q,?] (default: y):

where version is either 3.0.x or 2.x. Press

ENTER to upgrade.

11. You see the following prompt:

This package contains scripts which will be executed with super-user permission during the process of installing this package.

Do you want to continue with the installation of <EMCpower> [y,n,?]

Enter y and press ENTER.

Upgrading to PowerPath 4.0

1-13

Installing PowerPath

12. The screen displays information about the installation. Provided the upgrade is successful (that is, conversion of the configuration files succeeds) the display ends with:

----------------------------------------------------------------------* EMCpower installation: * * Installation is successful. * * Please REBOOT the host to complete the remaining steps of the installation. * Refer to the PowerPath for UNIX Installation and Administration Guide for more * information.

-----------------------------------------------------------------------

The following packages are available: 1 EMCpower EMC PowerPath

2 EMCvg EMC Enterprise Cluster PowerPath Volume

Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:

(all) 4.0.0_bxxx

Manager VCS Agent (sparc) 1.0

Important: If the display indicates that conversion of the configuration files failed, refer to Troubleshooting the Upgrade on page 1-15.

1-14

• If you are installing PowerPath for a VCS cluster and you want to install the PowerPath Volume Manager VCS Agent now, enter

2 and press ENTER. Continue with Install the VCS

Agent Software, step 5, on page 1-22.

• Otherwise, enter

q and press ENTER.

PowerPath 4.0 is now installed on the host. You must reboot the host and perform other administrative tasks before PowerPath can run on the host. Refer to After You Install on page 1-16 for postinstallation information and procedures.

PowerPath for UNIX Installation and Administration Guide

Installing PowerPath

Troubleshooting the Upgrade

Upgrading to PowerPath 4.0 could fail for the following reasons:

◆ The PowerPath 3.0.x or 2.1 configuration files are corrupted.

◆ You inadvertently chose not to upgrade; that is, you answered n

instead of

Configuration for PowerPath version exists - want to

upgrade [y,n,q,?] (default: y):

y to the following prompt:

The following sections describe what to do under these circumstances.

If files are corrupted

If the PowerPath 3.0.x or 2.1 configuration files are corrupted, your custom configuration is no longer available after you install PowerPath 4.0. If any of your applications are configured with PowerPath pseudo devices, you must reconfigure those applications. Refer to Installing and Configuring Emcpower Devices With Solaris Applications, which is available on the Powerlink website (

http://powerlink.emc.com).

If you chose not to upgrade

If you inadvertently answer no to the upgrade prompt, before you reboot the host:

1. Run the

emcpupgrade check command to check whether upgrade

is possible. Enter:

emcpupgrade check -f /etc/emc/emcpxarchive/powermt.custom.saved

If the check fails, the upgrade cannot take place. Contact EMC Customer Support.

If the check succeeds, continue with step 2.

2. Run the

emcpupgrade convert command to convert the

PowerPath 3.0.x or 2.1 configuration files to the PowerPath 4.0 format. Enter:

emcpupgrade convert -f /etc/emc/emcpxarchive/powermt.custom.saved

3. Run the emcpupgrade validate command to verify that the conversion succeeded. Enter:

emcpupgrade validate

For information about the emcpupgrade utility, refer to Chapter 5 of the PowerPath Product Guide.

Upgrading to PowerPath 4.0

1-15

Installing PowerPath

After You Install

After installing the PowerPath software:

❑ Register PowerPath on the host (first-time installation only). ❑ Remove the CD-ROM. ❑ Reboot the host. ❑ Verify the PowerPath installation. ❑ Verify the PowerPath commands are in your path. ❑ Verify that PowerPath devices are configured on the host. ❑ Optionally, reconfigure applications to use emcpower devices.

The following sections describe these procedures.

Register PowerPath on the Host

If you have previously registered an earlier version of PowerPath on the host, PowerPath will use your old key; you need not reregister. (Note, however, that if your previous registration was for evaluation purposes, and the registration has expired, you must reregister before you reboot the host).

To register the PowerPath software:

1. Enter:

/etc/emcpreg -install

You see the following output:

============ EMC PowerPath Registration ============= Do you have a new registration key or keys to enter? [n]

2. Type y and press ENTER. You see the following output:

Enter the registration key(s) for your product(s), one per line, pressing Enter after each key. After typing all keys, press Enter again.

Key (Enter if done):

1-16

PowerPath for UNIX Installation and Administration Guide

+ 84 hidden pages

EMC 300-000-978 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Preface

Installing PowerPath

Before You Install

Obtain Up-To-Date Information

Choose a Convenient Time

Locate Your License Key

Prepare the Host and Storage System

Prepare For a Clustered Environment

Installing PowerPath 4.0

Upgrading to PowerPath 4.0

About Upgrading

Upgrading From PowerPath 3.0.x or 2.1

Troubleshooting the Upgrade

After You Install

Register PowerPath on the Host