EMC 300-000-978 REV A03 manual Arguments, PowerPath device entries in emcp.conf

Page 90

5

PowerPath Administration on Solaris

Arguments	powercf scans HBAs for single-ported and multiported storage
	system logical devices and compares those logical devices with
	PowerPath device entries in emcp.conf.
	-q

Runs powercf in quiet mode.

powercf -qupdates the emcp.conf file by removing PowerPath devices not found in the HBA scan and adding new PowerPath devices that were found. It saves a primary and an alternate path to each PowerPath device.

powercf -qruns automatically during system boot.

-Z

Configures an SRDF-enabled server to be bootable from an R2 mirror of a Symmetrix-based emcpower boot disk by a remote host.

powercf -Zshould be run manually whenever such a server's Symmetrix volume configuration changes due to the addition or deletion of volumes.

Error Messages

PowerPath reports any errors, diagnostic messages, and failover recovery messages to the system console and to the file /var/adm/messages. Refer to the PowerPath Product Guide for a complete list of PowerPath error messages.

5-18	PowerPath for UNIX Installation and Administration Guide

Image 90

Contents PowerPath for Unix VersionCopyright 1997-2003 EMC Corporation. All rights reserved Contents Chapter PowerPath Administration on Solaris Chapter Configuring a PowerPath Boot Device on SolarisChapter Removing PowerPath Integrating/ Upgrading PowerPath Into an Existing AAMAppendix a Files Changed By PowerPath Appendix B Customer Support Tables TablesTables Viii Preface Audience and PrerequisitesPreface Related Documentation Options in command line syntax Command line arguments when used in textArguments used in examples of command line EMC uses the following type style conventions in this guideSales 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 SystemConfigure HBA drivers Failure to do so could result in loss or corruption of dataFor sh, enter Prepare For a Clustered EnvironmentFor example To find a unique major numberInstalling PowerPath Start the installation program. EnterYou 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 VersionUpgrading From PowerPath 3.0.x or Enter 1 and press EnterEnter package base directory default /opt,? You are prompted to confirm the major number EMC Troubleshooting the Upgrade If files are corruptedAfter You Install Register PowerPathOn the Host Reboot the Host RemoveYou should see output like the following Verify the PowerPath InstallationIf you installed the PowerPath Volume Manager VCS Agent You should see output similar to thisModinfo 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 thisPowerPath for Unix Installation and Administration Guide PowerPath in a Cluster Environment PowerPath in a Legato 5.1 or later AAM ClusterPowerPath in a Legato 5.1 or later AAM Cluster Installing PowerPath A New AAM ClusterPowerPath in a Legato 5.1 or later AAM Cluster PowerPath in a Sun Cluster Installing PowerPath in a New Sun ClusterPowerPath 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 ClusterHatype -list grep EMC Integrating Upgrading PowerPath Into an Existing VCS Cluster Recognize Configuring VCS toPowerPath Volume Manager ResourcesEditing main.cf to Include EMCTypes.cf Add the following line to the beginningSetting Major and Minor Numbers Minor NumberPowerPath 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 DeviceCreating FilesystemsUsr/sbin/installboot /usr/platform/sun4u/lib/fs/ufs/bootblk\ At the % prompt, enter the following command and press Example After modificationOpenBoot Setting Up the Boot AliasModifying Moving the Boot Device to an emcpower Device Output is similar to the followingRecovery ProcedureReboot the host. Enter boot Removing PowerPath Control Over a Boot Device An example of a boot path isReboot -- -r Removing PowerPath Before Removing PowerPath Removing PowerPath Screen displays information like thisEnter 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 SupportR1/R2 Boot Failover Support R1/R2 Supported Configurations R1/R2 Boot ProcedureForms Device NamingNative Devices 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 informationDynamic Reconfiguration Adding an HBA to a PowerPath ConfigurationRemoving an HBA From a PowerPath Configuration Command returns output like the followingPowermt remove hba=# Upgrading to Solaris 9 with Solaris Live Upgrade Upgrading SolarisTroubleshooting Powercf Configuration Utility File Location Executing powercf Emcp.conf FilePowerPath device entries in emcp.conf ArgumentsFiles Changed By PowerPath Files Created or Modified by PowerPath Installation EtcBasedir/EMCpower/bin Basedir/EMCpower/driverPowerPath for Unix Installation and Administration Guide Kernel/drv Basedir/EMCpower/lib Files Created or Modified by PowerPath Installation Basedir/EMCpower/man/man1 This directory contains the PowerPath man pages Basedir/EMCpower/scriptsThis directory contains PowerPath scripts Usr/binSolaris Files Modified by PowerPath Installation Installation programs add the following line toBasedir/VRTSvcs/EMC Files Created or Modified by VCS Agent InstallationEtc/VRTSvcs/conf/config Basedir/VRTSvcs/bin/EMCvgPowerPath for Unix Installation and Administration Guide Customer Support Overview of Detecting and Resolving Problems Figure B-1Problem Detection and Resolution ProcessTroubleshooting the Problem Before Calling the Customer Support Center Documenting the Problem Reporting a New Problem Sending Problem Documentation FTPPowerPath for Unix Installation and Administration Guide Symbols IndexVCS Veritas Volume Manager and emcpower devices PowerPath for Unix Installation and Administration Guide