Upgrading to PowerPath | EMC 300-000-978 REV A03 guide

1

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 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.

Uninstalling the Earlier Version

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.

Licenses The upgrade preserves your existing PowerPath license. You need not reenter license information.

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 /etc/emc/emcpxarchive.

1-10	PowerPath for UNIX Installation and Administration Guide

Image 24

EMC 300-000-978 REV A03 manual Upgrading to PowerPath, Uninstalling the Earlier Version

Contents

PowerPath for Unix Version Copyright 1997-2003 EMC Corporation. All rights reserved Contents Chapter Configuring a PowerPath Boot Device on Solaris Chapter Removing PowerPathChapter PowerPath Administration on Solaris Integrating/ Upgrading PowerPath Into an Existing AAM Appendix a Files Changed By PowerPath Appendix B Customer Support Tables Tables Tables Viii Preface Audience and Prerequisites Preface Related Documentation Command line arguments when used in text Arguments used in examples of command lineOptions in command line syntax EMC uses the following type style conventions in this guide Sales and Customer Service Contacts Xiv Installing PowerPath Before You Install Obtain Up-To-Date InformationChoose a Convenient Time Locate Your License Key Prepare the Host and Storage System Configure HBA drivers Failure to do so could result in loss or corruption of data Prepare For a Clustered Environment For exampleFor sh, enter To find a unique major number Installing PowerPath Start the installation program. Enter You see the following prompt You are prompted to confirm the major number Press Enter to confirm the major numberEnter y and press Enter Manager VCS Agent Upgrading to PowerPath Uninstalling the Earlier Version Upgrading From PowerPath 3.0.x or Enter 1 and press Enter Enter package base directory default /opt,? You are prompted to confirm the major number EMC Troubleshooting the Upgrade If files are corrupted After You Install Register PowerPathOn the Host Reboot the Host Remove Verify the PowerPath Installation If you installed the PowerPath Volume Manager VCS AgentYou should see output like the following You should see output similar to this Modinfo grep -i emc Reconfigure Emcpower DevicesApplications to Use Installing the PowerPath Volume Manager VCS Agent Do you want to install these conflicting files y, n, ?, q Error Messages You should output similar to this PowerPath for Unix Installation and Administration Guide PowerPath in a Cluster Environment PowerPath in a Legato 5.1 or later AAM Cluster PowerPath in a Legato 5.1 or later AAM Cluster Installing PowerPath A New AAM Cluster PowerPath in a Legato 5.1 or later AAM Cluster PowerPath in a Sun Cluster Installing PowerPath in a New Sun Cluster PowerPath in a Sun Cluster PowerPath in a Sun Cluster Stop cluster services on the node. Enter boot PowerPath in a Veritas Cluster Server Cluster Installing PowerPath A New VCS Cluster Hatype -list grep EMC Integrating Upgrading PowerPath Into an Existing VCS Cluster Configuring VCS to PowerPath VolumeRecognize Manager Resources Editing main.cf to Include EMCTypes.cf Add the following line to the beginning Setting Major and Minor Numbers Minor Number PowerPath for Unix Installation and Administration Guide Configuring a PowerPath Boot Device On Solaris Introduction Configuring a PowerPath Native Device as the Boot Device Partitioning the Boot Device Creating Filesystems Usr/sbin/installboot /usr/platform/sun4u/lib/fs/ufs/bootblk\ At the % prompt, enter the following command and press Example After modification OpenBoot Setting Up the Boot AliasModifying Moving the Boot Device to an emcpower Device Output is similar to the following Recovery Procedure Reboot the host. Enter boot Removing PowerPath Control Over a Boot Device An example of a boot path is Reboot -- -r Removing PowerPath Before Removing PowerPath Removing PowerPath Screen displays information like this Enter the following command to remove these files Emcpvcleanup issues the following warningRemoval process saves the following files Reboot the host. Enter reboot -- -r Removing the PowerPath Volume Manager VCS Agent Removal of EMCvg was successful PowerPath for Unix Installation and Administration Guide PowerPath Administration on Solaris PowerPath and CLARiiON Storage Systems Booting a Host With Built-In Fibre Channel PortsEnsuring a Sufficient Stack Size Rebooting and Custom Settings Boot Device Support R1/R2 Boot Failover Support R1/R2 Supported Configurations R1/R2 Boot Procedure Device Naming Native DevicesForms Block device- /dev/dsk/c # t # d # s # Pseudo Devices Selecting a DeviceNaming Convention Device Naming Function Native Device Pseudo Device Volume Managers Reconfiguring PowerPath Devices Online Enter quit, to end the format process Screen displays the following information Dynamic Reconfiguration Adding an HBA to a PowerPath Configuration Removing an HBA From a PowerPath Configuration Command returns output like the following Powermt remove hba=# Upgrading to Solaris 9 with Solaris Live Upgrade Upgrading Solaris Troubleshooting Powercf Configuration Utility File Location Executing powercf Emcp.conf File PowerPath device entries in emcp.conf Arguments Files Changed By PowerPath Files Created or Modified by PowerPath Installation Etc Basedir/EMCpower/bin Basedir/EMCpower/driver PowerPath for Unix Installation and Administration Guide Kernel/drv Basedir/EMCpower/lib Files Created or Modified by PowerPath Installation Basedir/EMCpower/man/man1 Basedir/EMCpower/scripts This directory contains PowerPath scriptsThis directory contains the PowerPath man pages Usr/bin Solaris Files Modified by PowerPath Installation Installation programs add the following line to Files Created or Modified by VCS Agent Installation Etc/VRTSvcs/conf/configBasedir/VRTSvcs/EMC Basedir/VRTSvcs/bin/EMCvg PowerPath for Unix Installation and Administration Guide Customer Support Overview of Detecting and Resolving Problems Figure B-1Problem Detection and Resolution Process Troubleshooting the Problem Before Calling the Customer Support Center Documenting the Problem Reporting a New Problem Sending Problem Documentation FTP PowerPath for Unix Installation and Administration Guide Symbols Index VCS Veritas Volume Manager and emcpower devices PowerPath for Unix Installation and Administration Guide