How To Create Linux Grabs
Summary: This article describes step by step, how-to-create a Grab for a Linux host.
This article applies to
This article does not apply to
This article is not tied to any specific product.
Not all product versions are identified in this article.
Symptoms
Simple steps to create Grabs for Linux Hosts.
Grabs on average take about 15 to 20 minutes to run. If there are many Symmetrix arrays attached to the host, it would be longer. As long as the screen is printing, the script is running good. It can be stopped by ctrl+c anytime, like other linux commands.
Grabs on average take about 15 to 20 minutes to run. If there are many Symmetrix arrays attached to the host, it would be longer. As long as the screen is printing, the script is running good. It can be stopped by ctrl+c anytime, like other linux commands.
Cause
Must create Grab.
Resolution
Instructions for running the Grab on a Linux host.
The script should be run as user root or sudo with root privileges, to prevent any data not being collected through lack of permissions.
Download the latest grab utility grab_Linux_vX.X.X_signed.tar from https://central.dell.com/solutions/GrabUnixLinux (requires a Dell account).
1. Place the Grab tar file into a suitable directory (e.g., /usr/dell) and extract using the following command:
tar -xvf grab_<os>_<version>_signed.tar
The extracted grab_<os>_<version>_signed.tar file contains the following files:
grab_<os>_<version>_key.pem
grab_<os>_<version>_signed.tar
grab_<os>_<version>.tar
grab_<os>_<version>.tar.signed.bin
grab_<os>_<version>_verify_signature.sh
grab_signature.sh
To verify the grab_<os>_<version>.tar file run the following command:
[root@localhost /usr/dell]# ./grab_<os>_<version>_verify_signature.sh
grab_<os>_<version>.tar: Verified OK
Note: Openssl must be installed to verify the file signature
2. Once the Grab grab_<os>_<version>.tar file is verified extract it using the following command:
tar -xvf grab_<os>_<version>.tar
3. A directory named 'emcgrab' is created which contains all the necessary support scripts and functions to successfully run the data collection scripts.
4. Please ensure that your filesystem has at least 500M of free disk space for temporary files that may be generated during its processing. If there are many Symmetrix arrays attached to the host, the resulting tar file could be very large.
5. Change the directory to emcgrab, and run the command
The script should be run as user root or sudo with root privileges, to prevent any data not being collected through lack of permissions.
Download the latest grab utility grab_Linux_vX.X.X_signed.tar from https://central.dell.com/solutions/GrabUnixLinux (requires a Dell account).
1. Place the Grab tar file into a suitable directory (e.g., /usr/dell) and extract using the following command:
tar -xvf grab_<os>_<version>_signed.tar
The extracted grab_<os>_<version>_signed.tar file contains the following files:
grab_<os>_<version>_key.pem
grab_<os>_<version>_signed.tar
grab_<os>_<version>.tar
grab_<os>_<version>.tar.signed.bin
grab_<os>_<version>_verify_signature.sh
grab_signature.sh
To verify the grab_<os>_<version>.tar file run the following command:
[root@localhost /usr/dell]# ./grab_<os>_<version>_verify_signature.sh
grab_<os>_<version>.tar: Verified OK
Note: Openssl must be installed to verify the file signature
2. Once the Grab grab_<os>_<version>.tar file is verified extract it using the following command:
tar -xvf grab_<os>_<version>.tar
3. A directory named 'emcgrab' is created which contains all the necessary support scripts and functions to successfully run the data collection scripts.
4. Please ensure that your filesystem has at least 500M of free disk space for temporary files that may be generated during its processing. If there are many Symmetrix arrays attached to the host, the resulting tar file could be very large.
5. Change the directory to emcgrab, and run the command
./emcgrab.sh
6. The script generates a compressed tar file, residing in the ./emcgrab/outputs directory unless the -OUTDir option is used to change it. Its format is
6. The script generates a compressed tar file, residing in the ./emcgrab/outputs directory unless the -OUTDir option is used to change it. Its format is
'<hostname>_YYYY-mm-dd-hh.mm.ss>_<OS>_emcgrab_<version>_[full | lite]_CC<ServiceRequestNumber>.tar.<Z|gz>'.
If no Service Request number is defined, <ServiceRequestNumber> defaults to 0000000000
7. Download the .tar.gz file and upload to the FTP or case
Note:
1. The script prompts the user with a warning message should it detect less than 50MB remaining on the file system every time the script runs the file system check routine unless run in -autoexec mode.
2. The script prompts for a Dell Technologies license agreement unless in -autoexec mode with the -legal option. Once EMC license agreement is accepted, the script continues.
Invoking the Grab script with the -legal option confirms that the user accepts the Dell Technologies license agreement.
3. If don't want to see prompts listed in 4, run with the with the following switches ./emcgrab.sh -autoexec -legal
4. When run ./emcgrab.sh only
Then input Y to accept:
Input the information as asked or just press enter to pass:
Input Y:
If this question is prompted, please input n, unless SMI-S information is required by support:
5. At the end, it shows like below
7. Download the .tar.gz file and upload to the FTP or case
Note:
1. The script prompts the user with a warning message should it detect less than 50MB remaining on the file system every time the script runs the file system check routine unless run in -autoexec mode.
2. The script prompts for a Dell Technologies license agreement unless in -autoexec mode with the -legal option. Once EMC license agreement is accepted, the script continues.
Invoking the Grab script with the -legal option confirms that the user accepts the Dell Technologies license agreement.
3. If don't want to see prompts listed in 4, run with the with the following switches ./emcgrab.sh -autoexec -legal
4. When run ./emcgrab.sh only
Press enter or space bar to review the agreement:
Then input Y to accept:
DO YOU AGREE TO ACCEPT THE TERMS & CONDITIONS OF THIS LEGAL AGREEMENT (Y/N): Y
Input the information as asked or just press enter to pass:
Please Enter Service Request Number : Please Enter Customer Party Number (Site ID) : Please Enter Customer Company Name : Please Enter Customer Contact Name : Please Enter Customer Contact Phone Number : Please Enter your Email Address :
Input Y:
Is the Grab Identification Information Correct (Y/N) : Y
If this question is prompted, please input n, unless SMI-S information is required by support:
Do you want to collect SMI-S information (y/n) ? n
5. At the end, it shows like below
Finishing Data Collection, please wait... Creating and compressing Tar File <hostname>_YYYY-mm-dd-hh.mm.ss>_<OS>_emcgrab_<version>_[full | lite]_CC<ServiceRequestNumber>.tar.<Z|gz>........... All outputs are located in the outputs directory Output Filename is : <hostname>_YYYY-mm-dd-hh.mm.ss>_<OS>_emcgrab_<version>_[full | lite]_CC<ServiceRequestNumber>.tar.<Z|gz> Please submit this file to Dell EMC for Analysis. Thank you Removing Temporary Files.... [root@localhost emcgrab]#
Additional Information
FTP access requires either Microsoft Internet Explorer or Google Chrome with IETab or Microsoft EDGE with IETab or a third-party ftp client.
Affected Products
GRABProducts
GRABArticle Properties
Article Number: 000170532
Article Type: Solution
Last Modified: 16 Apr 2024
Version: 7
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.