Professional Documents
Culture Documents
: EMCGrab v4.4.4
********************************************************************************
*********
PERFORMANCE DEGRADATION NOTICE:
On some hosts, where high I/O is a normal course of events,
running the EMCGrab utility may cause some performance
degradation when running some commands.
Best practices should prevail, such as running at off peak hours
********************************************************************************
*********
IMPORTANT NOTICES FOR ALL OS:
If the EMCgrab is run with the -autoexec feature enabled and the host uses navis
eccli
(in case of navicli is not found) then in order to collect Clariion information,
the
security file should have been already created using -AddUserSecurity option of
naviseccli.
If that file is absent then EMCGrab will not collect any clariion information. A
lso,
modules like networker (-nw) is excluded from the Module execution list.
If a Symmetrix is attached to a host and if the symmetrix devices are not enable
d for
masking then, while running the symmaskdb and symaccess commands you can encount
er
a message as:
"No device masking database records could be found for the specified input param
eters"
IMPORTANT NOTICES FOR SOLARIS:
****** Before running EMCgrab please take note of these ETAs ******
ETA emc108113: PowerPath 4.4 / 4.3.1: SYMCLI commands hang or fail.
HBA goes Offline/Online. This issue is resolved in SAN release 4.4.9
for Solaris 8 & 9. For Solaris 10, fix included in 119130-17.
ETA emc121607: Solutions Enabler: Solaris Leadville MPxIO segments
Solution Enabler communication through multi-path gatekeepers or
other data devices.
"/etc/emcp_devicesDB.dat"
"/etc/emcp_devicesDB.idx"
4. Changes done in the module "se.sh"
a. Replaced symmaskdb commands with symaccess commands. (GERS 2750, 2682
) - (ALL)
Following new Commands are added
"symaccess -sid ${SYMCLI_SID} list view -detail"
"symaccess -sid ${SYMCLI_SID} list view -v"
"symaccess -sid ${SYMCLI_SID} backup -file -noprompt symaccess_backu
p"
"stordaemon action storapid -cmd list_gks ${SYMCLI_SID}"
"symaccess -sid ${SYMCLI_SID} -f ${SCRIPT_TMP}/${SYMACCESS_DB} backu
p -noprompt" "symaccess_backup"
"symaccess show view ${ARG} -sid ${SYMCLI_SID}"
b. Added the external commands for Base Daemon, Group Name Services, Gat
e Keepers except
for licensing in se.sh. (GERS 2708, 2450) - (ALL)
Below are the added commands:
"symlmf -sid ${SYMCLI_SID} list -type emclm"
"symlmf -sid ${SYMCLI_SID} query -type emclm"
"stordaemon action storapid -cmd show_gk_pdevs -all -sid ${SYMCLI_SI
D}"
"stordaemon action storapid -cmd show_gk_stats -sid ${SYMCLI_SID}"
"stordaemon action storapid -cmd list -ldb -sid ${SYMCLI_SID}"
"stordaemon action storapid -cmd list_gks -sid ${SYMCLI_SID}"
"stordaemon action storapid -cmd show_gk_stats -sid ${SYMCLI_SID}"
"symcg list -inactive"
"symdg list -inactive"
"stordaemon action storgnsd -cmd list_groups -sid ${SYMCLI_SID}"
"stordaemon action storapid -cmd list -ldb"
"stordaemon action storapid -cmd list_gks"
"stordaemon action storapid -cmd show_gk_stats"
"stordaemon action storgnsd -cmd list_groups"
c. Added sid to new commands upon user request (GERS 2857) - (ALL)
"symauth -sid ${SYMCLI_SID} list"
"symauth -sid ${SYMCLI_SID} list -users"
"vsymcg list -inactive"
"symdev list -identity_set"
"symdg list -inactive"
"vsymrcopy list -type migratev"
d. Added commands to se.sh to display FLM session Information (GERS 2438
) - (ALL)
"symdev list -identity_set"
"symdev list -passive"
"symrcopy list -type migrate"
e. Remove SYMM command execution in background (GERS 2432, 2395) - (ALL)
5. Changes
a.
b.
c.
) - (ALL)
6. Changes
a.
b.
S 2329)
c.
ands in
2. The script will prompt for EMC license agreement even in autoexec
mode unless the -legal option is set. Once EMC license agreement is accepted
then it will work as usual for autoexec mode.
Operation :
The script should be run as user root, to prevent any data not being
collected through lack of permissions.
The scripts defines a PATH environment based on the default installation paths
of it's software. If these are different, some modules may not work.
It is possible that some commands could run for a lengthy period. Each module
has a max runtime limit, ranging from 60 seconds through to 450, depending
on the module.
The script will generate a compressed tar file, residing in the outputs
directory. Its format will be
'<hostname>_YYYY-mm-dd-hh.mm.ss>_<OS>_emcgrab_<version>_[full | lite]_CC<Request
Number>.tar.<Z|gz>'
depending on whether compress or gzip has been used as their compression utility
.
If no Request number is defined, <CaseNo> will default to 0000000000
Syntax :
./emcgrab.sh [-h] [-v] [-o options,options] [-autoexec] [-backup] [-clariionIP <
IP Addresses>] [-exclude]
[-gpfs] [-inqLog] [-ip] [-ipmask] [-legal] [-lite] [-nomsg] [-nw] [
-OUTDir new_output_directory]
[-quiet] [-smas] [-symmid bypass|prompt] [-vxdmpdebug]
where
-h
: Displays help screen
-v
: Displays version information
-o
: User defined options, Comma Separated List (See below)
-autoexec : Bypasses user interactive prompts (but will prompt for EMC
's license if no -legal)
-backup
: Bypasses interactive menu, when scheduled via cron.
-clariionIP : Comma separated list of IP addresses for SPA / SPB
-exclude
: Allows adding a file name (file name only - no path) to th
e excluded_files file
-gpfs
: Collects General Parallel File System Information.
-inqLog
: Enables INQ Log Information Collection.
-ip
: Comma separated list of IP addresses for SPA / SPB
-ipmask
: Will mask the ip address of the host in all the files coll
ected in the EMCGrab
-legal
: User automatically accepts EMC License Agreement (used wit
h -autoexec or -quiet)
-lite
: A reduced subset of data collection that is required by HE
AT analysis server
-nomsg
: Will not collect the messages logs
-nw
: Collects Networker related information on AIX, HP-UX, LINU
X & SunOS
-OUTDir
: Option to store final EMCGrab file at specified location
-quiet
: Suppress all status messages
-smas
: Enables Symmetrix Management Console and Symmetrix Perform
ance Analyzer log collection.
-symmid
: bypass|prompt - Bypasses Symmetrix or prompts for each Sym
metrix detected
-vxdmpdebug : Runs vxdmpdebug script with 'Y' option enabled
Options :
This is a comma separated list of additional modules. By default these
options are not run, and need to be invoked by the -o syntax.
Supported Optional modules are as follows ::
:
:
:
:
:
:
:
:
:
:
:
:
:
:
(automatic detection)
AIX in Recover Point Environment
to Devices attached to Host (automat
output for HP-UX OS in FULL Mode
OS Support :
This version of EMCGrab is tested and supported on the following Operating Syste
ms
:
:
:
:
:
:
:
:
:
Solaris 7 or later
AIX 5.1 and later
HP-UX 11.xx or later
Tru64 4.x or later (OSF1)
RedHat Linux 7.x or later
RedHat Advanced Server 2.1 or later
SuSE Linux 7.x or later
Irix 6.5.x or later
Siemens Reliant Unix 5.4.x or later
4
5
6
7
Success
Failed to source emcgrab.main
Unable to create temporary working directory
EMCGrab Data Collection already running. Only a single instance
is supported at any time.
Script Aborted. Less than 25Mb of space detected on FileSystem.
Failed to create output tarfile
Override for non 'root' user operation failed.
File and directory dependencies not found.