HP 3PARInfo 1.2.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 2014 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.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 storage system.
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.2 HP 3PARInfo directory structure The HP 3PARInfo tar file HP3PARInfo.
When you run this command: • The binary is copied to /usr/bin directory. • The libraries are copied to: ◦ /usr/lib/ directory on Linux x86_32 ◦ /usr/lib64/ directory on Linux x64 ◦ /usr/lib/ directory on HP-UX ◦ /usr/lib/ directory on AIX ◦ /usr/lib/ directory on ESXi 5.1 ◦ /usr/lib/ directory on ESX 4.1 x32 ◦ /usr/lib64 directory on ESX 4.
• ◦ /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.
Get LUNs with VV ID and Domain ID Use the -ea option to view the list of LUNs that are exposed to hosts. This option is similar to -i option with the exception that there are two additional columns, VV ID and Domain ID in the end. The syntax is: # HP3PARInfo -ea Figure 5 (page 12) shows the sample output.
Table 2 LUN information (continued) Field Description 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. LUN WWN A unique 64-bit value used to identify fibre channel devices on an arbitrated loop. The WWN consists of a prefix issued by the IEEE to uniquely identify the company and a suffix that is issued by the company. VV Name Name of the virtual volume. Code Revision InForm OS version number.
For example, when we have log files HP3PARInfo.log to HP3PARInfo.log.4, and HP 3PARInfo is run again, HP3PARInfo.log.4 is overwritten and lost. NOTE: You cannot configure the number of log files that need to be retained. If you want to retain a particular log file, you must back up the file. NOTE: When multiple instances of HP 3PARInfo are run simultaneously, the log file is not rolled over; all the logs are logged into HP3PARInfo.log.
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.
