diag

Gathers diagnostic information from an array and packages it into an e-mail message intended for your support provider.

Run the diag command only if instructed by your support provider.

The diag output does not contain any data from user volumes in any form.

There are three ways data collected from the diag command can be retrieved from the array:

To access the CLI to run the diag command, see Running Array Management Commands.

Once connected to the array (either through a serial connection or a network connection to an IP address assigned to a network interface), press the <Enter> key and log in to a group administration account that has read-write permission (for example, the grpadmin account). At the CLI prompt, enter the diag command.

Format

diag ["options"]

Options

Options can be used in any combination, separated by spaces. All options used must be enclosed in one set of quotes.

-b

Operates in non-interactive batch mode. With this option, you cannot dump the output to the console.

-e name@address

Sends e-mail to up to three e-mail addresses, instead of those specified by the grpparam email-list setting. Addresses must be separated by commas only (no spaces).

-n

Sends no e-mail with the output. You must retrieve the output with FTP or use the option to dump output to the console.

-u

Uses existing output files. Skips the data-collection step and attempts to resend files from the previous diag command.

Examples

The following example shows how to use telnet to connect to an IP address assigned to a network interface on an array and run the diag command. This example assumes you have previously configured e-mail notification to send the output to user@email.com.

telnet 123.14.1.132

Connected to 123.14.1.132.

 

             EqualLogic, Inc. - Storage Arrays

 

login: grpadmin

Password: 

 

                 Welcome to Group Manager

            Copyright 2001 – 2006 EqualLogic, Inc.

diag

 

The diag command will gather configuration data from this array for

support and troubleshooting purposes. No user information will be included in this data.

 

E-mail notification is not available, so you must retrieve the results from the array using FTP, or by using the "text capture" feature of your terminal emulator or Telnet program.

 

You will be given information to help you do this at the end of this procedure.

 

Do you wish to proceed (y/n) [y]: y

 

Starting data collection.

Section 1 of 14: ...

Section 2 of 14: ......................

Section 3 of 14: ...

Section 4 of 14: ....

Section 5 of 14: ...

Section 6 of 14: ...........

Section 7 of 14: .

Section 8 of 14: ....

Section 9 of 14: ............

Section 10 of 14: ...

Section 11 of 14: ............

Section 12 of 14: .

Section 13 of 14: .

Section 14 of 14: ............................................

Finished in 54 seconds

You have the option of retrieving the diagnostic data using FTP.

To do this, use the FTP 'mget' command to retrieve all files matching the specification "Seg_*.dgo". You must use the "grpadmin" account and password and connect to one of the following IP addresses:

172.17.192.231

alias 172.17.192.230

 

You also have the option to capture the output by using the "text capture" feature of your Telnet or terminal emulator program.

 

Do you wish to do this (y/n) [n]: n

The following example shows how to use the FTP utility to copy the diag output file from the array to a host. Invoke FTP on the host and enter the FTP open command, specifying an IP address assigned to one of the array’s network interfaces.

When prompted, enter the grpadmin account and password. Be sure to specify the diag output file with the mget command.

ftp

ftp> open 123.14.1.132

Connected to 123.14.1.132.

220 123.14.1.132 FTP server ready.

User: grpadmin

331 Password required for grpadmin.

Password: 

230 User grpadmin logged in.

Using binary mode to transfer files.

ftp> mget Seg_*.dgo

mget Seg_1.dgo? y

227 Entering Passive Mode (123,14,1,132,255,102)

150 Opening BINARY mode data connection for 'Seg_1.dgo' (614247 bytes).

226 Transfer complete.

614247 bytes received in 1.33 secs (4.5e+02 Kbytes/sec)

mget Seg_2.dgo? y

227 Entering Passive Mode (123,14,1,132,255,101)

150 Opening BINARY mode data connection for 'Seg_2.dgo' (880243 bytes).

226 Transfer complete.

880243 bytes received in 1.17 secs (7.3e+02 Kbytes/sec)

mget Seg_3.dgo? y

227 Entering Passive Mode (123,14,1,132,255,100)

150 Opening BINARY mode data connection for 'Seg_3.dgo' (317761 bytes).

226 Transfer complete.

317761 bytes received in 1.02 secs (3e+02 Kbytes/sec)

ftp> bye

221-

   Data traffic for this session was 1812251 bytes in 3 files.

   Total traffic for this session was 1813753 bytes in 6 transfers.

221 Thank you for using the FTP service on 123.14.1.132.