HP 3PARInfo 1.2 User Guide Abstract This guide provides information about installing and using HP 3PARInfo. It is intended for system and storage administrators who monitor and direct system configurations and resource allocation for HP 3PAR Storage Systems. For the latest information about this product, see the HP 3PARInfo Release Notes.
© Copyright 2012, 2013 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Introduction...............................................................................................4 Overview................................................................................................................................4 HP 3PARInfo environment...........................................................................................................4 2 Installing HP 3PARInfo.................................................................................
1 Introduction This chapter describes HP 3PARInfo 1.2, its features, and the working environment. Overview HP 3PARInfo is provided with HP 3PAR System Reporter apart from being available as a web download. You can use this utility to obtain configuration information about HP 3PAR LUNs that are exposed to the host from HP 3PAR array.
2 Installing HP 3PARInfo This section describes how to install and uninstall HP 3PARInfo. It also lists the various components of HP 3PARInfo. For UNIX platform Prerequisites The following are the prerequisites for installing, removing and executing HP 3PARInfo on a UNIX platform: • Ensure root user access to the system is available. • The unix_local_install.sh script must have executable permissions. If it does not have the same, run the following command: #chmod +x ./unix_local_install.
NOTE: • Default destination folder on windows is: C:\Program Files (x86)\3PAR\HP 3PARInfo • Shortcut is created under the following location: Start > All Programs > HP 3PAR > HP 3PARInfo 1.2 HP 3PARInfo directory structure The HP 3PARInfo tar file HP3PARInfo.tar contains the following folders: • HP3PARInfo-aix • HP3PARInfo-ESXi • HP3PARInfo-hpux-1123 • HP3PARInfo-hpux-1131 • HP3PARInfo-linux-32 • HP3PARInfo-linux-x86_64 • HP3PARInfo-windows • README • unix_local_install.
◦ /usr/lib/ directory on HP-UX ◦ /usr/lib/ directory on AIX ◦ /usr/lib/ directory on ESXi 5.1 ◦ /usr/lib/ directory on HP-UX-1123 ◦ /usr/lib/ directory on HP-UX-1131 ◦ /usr/lib/ directory on ESX 4.1 x32 ◦ /usr/lib64 directory on ESX 4.1 x64 nl After running the installation script, view the directories and ensure that the following files are available: • HP3PARInfo in the /usr/bin/ directory • libHP3PARInfoLogger.
• ◦ /usr/lib/ directory on ESX 4.1 x32 ◦ /usr/lib64 directory on ESX 4.1 x64 The log files are removed from: ◦ /var/log/HP3PARInfo/ directory on Linux, AIX, ESX and ESXi. ◦ /var/adm/HP3PARInfo/ directory on HP-UX nl After running the script for removing HP 3PARInfo, view the directories and ensure that the following files are removed: • HP3PARInfo in the /usr/bin/ directory • libHP3PARInfoLogger.
3 Working with HP 3PARInfo This section describes how to use the command options of HP 3PARInfo. Command options HP 3PARInfo supports five command options: -v, -h, -i, -d and -f. Each of these options display a specific set of information. Table 1 (page 9) lists the command options. Table 1 Command options Command option Information you get -v Version information of HP 3PARInfo. -h Help for HP 3PARInfo. -i The list of LUNs that are exposed to hosts. -f More information about the specified LUN.
Figure 2 Get help information Get LUNs Use the -i option to view the list of LUNs that are exposed to hosts. The syntax is: # HP3PARInfo -i nl Figure 3 (page 10) shows the sample output. Figure 3 Get LUN list The -i option displays the following information: nl • Device File Name • LUN Size • Target ID • LUN ID • LUN WWN • VV Name • Code Revision • Array Serial Number For more information about these fields, see Table 2 (page 12).
nl This option can be used to obtain data in csv format. Get LUN information Use the -f option to view more information about a LUN. The syntax is: # HP3PARInfo -f [devicefile] Figure 4 (page 11) shows the sample output.
Table 2 (page 12) lists the information about the fields displayed when -i,-f and –d options are used with the HP3PARInfo command. Table 2 LUN information Field Description Device File Name Name of the device as seen by the host. LUN Size Size of LUN in megabytes. Host Target or Target ID SCSI ID of the target device (LUN) in Hexadecimal. Array LUN or LUN ID Logical Unit Number (LUN) in Hexadecimal, a unique identifier used on a SCSI bus to distinguish between devices that share the same bus.
HP 3PARInfo implements a rollover logger; each time HP 3PARInfo is run, the existing log files are rolled over. At any time, a maximum of five latest log files are present in the log directory. When you run HP 3PARInfo for the first time, HP3PARInfo.log is created. When you run it for the second time, the existing log file HP3PARInfo.log is renamed as HP3PARInfo.log.0, and the new log file HP3PARInfo.log is created. Similarly, whenever a new log file is created, the older log files are renamed.
4 Troubleshooting HP 3PARInfo This chapter describes how to troubleshoot and solve common problems that might occur while using HP 3PARInfo. Unable to view a specific device file If you are unable to view a specific device file after running the HP3PARInfo -i command, perform the following to search for the device: • On Linux — run fdisk –l • On HP-UX 11.31 — run ioscan –m dsf • On AIX — run “cfgmgr” • On Windows — Re-scan disks under Disk Management.
[root@paxppr2 HP3PARInfo-linux-32]# HP3PARInfo -i Device File Name Size [MB] Tgt Lun LUN WWN VV Name Code Rev Serial# ======================================================================================================================================================= /dev/sdbk 512 04 01 50002ac0000736f8 HP3PARINFO_Demo_LUN_SET0.1 3.1.1 MU2 01214072 /dev/sdbl 512 04 02 50002ac0000836f8 HP3PARINFO_Demo_LUN_SET0.2 3.1.1 MU2 01214072 nl nl nl In this sample output, the deleted device sdbj is not shown.
5 Support and other resources Contacting HP HP technical support For world wide technical support information, see the HP support website: http://www.hp.
• HP download drivers and software http://www.hp.com/support/downloads • HP Software Depot http://www.software.hp.
Glossary A ATS Atomic, Test, and Set. This command allows the hypervisor to lock only the required blocks rather than the entire LUN. Without VAAI, the entire LUN temporarily could be locked by the numerous VMFS operations of one single hypervisor and this prevents other hypervisors from accessing the shared LUNs. The ATS API off-loads lock management from the host to the storage array and keeps the LUN available by locking only required blocks, not the entire VMFS file system.
