Wednesday, February 25, 2015

How to gather SPcollect files or Logs for EMC VNX or Clarrion Series Array

Summary: This article describes how to gather SPcollects from a VNX Series array (including arrays with MCx), using either Unisphere, USM or Navisphere Secure CLI. Retrieving diagnostic data from a Unified array using Unisphere.

Environment: EMC Hardware: VNX Series
                       EMC Hardware: VNX Series with MCx
                       Product: VNX5100
                       Product: VNX5200
                       Product: VNX5300
                       Product: VNX5400
                       Product: VNX5500
                       Product: VNX5600
                       Product: VNX5800
                       Product: VNX5700
                       Product: VNX7500
                       Product: VNX7600
                       Product: VNX8000
                       EMC Hardware: VNX Unified/File 
                       EMC Hardware: VNX Block
                       EMC Software: VNX Operating Environment (OE) for Block 05.32
                       EMC Software: VNX Operating Environment (OE) for Block 05.33 and later
                       EMC Software: Unisphere
                       EMC Software: Unisphere Service Manager
                       EMC Software: Navisphere Secure CLI

Resolution: There are a number of methods to gather SPcollects:
  1. Start and retrieve SPcollects from each SP using Unisphere.
  2. Launch Unisphere Service Manager either directly or from within Unisphere. This approach has the advantage of automating the whole SPcollect gathering process and gathering File diagnostic data too.
  3. Start and retrieve SPcollects from each SP using Navisphere Secure CLI.
Unisphere:
  1. Launch Unisphere and login.
  2. Select the VNX series array from either the dashboard or from the Systems drop-down menu. Click System on the toolbar.
  3. On the right pane, under Diagnostic Files, select 'Generate Diagnostic Files - SPA'. Confirm that it is OK to continue.  "Success" will be displayed when the SPcollect starts, but this only means the script has been started and will still take several minutes to complete.
  4. Repeat step 3 for SP B.
  5. It will take around 15 minutes to generate a complete SPcollect file.
  6. Still on the right pane, select 'Get Diagnostic files - SP A'.
  7. When the SPcollect file has completed, a file with the following name will be listed: <ArraySerialnumber>_SPA_<date_time(GMT)_code>_data.zip
  8. Sorting by descending order of date is a good way to find the latest SPcollect and the zip file will generally be over 10MB.  If the file has not appeared, press refresh every minute or so until the correct _data.zip file appears.
  9. On the right-hand side of the box, select the location on the local computer, where the SPcollects should be transferred to.
  10. On the left hand side of the box select the file to be transferred.  Note, if a file is listed that ends in runlog.txt, this indicates that the SPcollects are still running. Wait until the data.zip is created.
  11. Repeat Steps 6-10 on SP B to retrieve its diagnostic files.
Unisphere Service Manager:
  1. Log in to Unisphere client.
  2. Select the VNX, either from the dashboard or from the Systems drop-down. Click System on the toolbar.
  3. On the right pane, under Service Tasks, select 'Capture Diagnostic Data'.  This will launch USM.  Alternatively USM can be launched directly from the Windows Start menu.
  4. Select the Diagnostics tab and select ‘Capture Diagnostics Data’.  This will launch the Diagnostic Data Capture Wizard.
  5. The Wizard will capture and retrieve SPcollect files from both SP and Support Materials from the File storage, which will then be combined into a single zip file.
Navisphere Secure CLI:
Perform the following steps:
  1. Open a command prompt on the Management Station.
  2. Type cd "C:\Program Files\EMC\Navisphere CLI" - This is the default installation folder for Windows, but the path the file was installed to may have been overridden.  Other platforms, such as Linux, would have a different folder structure, but the commands are the same. The CLI folder may already be in the path statement, in which case, the commands can be run from any directory.
  3. Type naviseccli -h <SP_A_IP_address> spcollect
  4. Type naviseccli -h <SP_B_IP_address>spcollect
  5. These commands start the SPcollect script on each SP.  Additional security information may also need to be specified
  6. Wait at least 10 minutes for the SPcollects to run, before attempting to retrieve them.
  7. Type naviseccli -h <SP_IP_address>managefiles -list
  8. This will list the files created by SPcollect.  Check that a file with the current date and time in GMT has been created, ending with _data.zip.  If there is a file ending with .runlog instead, then the SPcollect is still running, so wait for a while longer before retrying this.
  9. Type naviseccli -h <SP_IP_address>managefiles -retrieve
          This will display the files that can be moved from the SP to the Management Station.
          Example:
          Index Size in KB     Last Modified            Filename
          0     339       06/25/2013 00:45:42  admin_tlddump.txt
           ...
          10    24965     06/24/2013 23:39:53  FNM00125001234_SPB_2013-06-24_22-38- 15_32a007_data.zip
          11    41577     06/25/2013 00:17:17  FNM00125001234_SPB_2013-06-24_23-10-55_32a007_data.zip
           ...
    10.  Enter files to be retrieved with index separated by comma (1,2,3,4,5) OR by a range (1-3) OR enter 'all' to retrieve all file OR 'quit' to quit> 11
This will pull the index number 10 (the most recent ~_data.zip file) from the corresponding SP and copy it to the c:\program files\emc\navisphere cli directory, with a filename of FNM00125001234_SPB_2013-06-24_23-10-55_32a007_data.zip


Notes: While an SPcollect is running, a file ending runlog.txt will be visible.  This just tracks the progress of the SPcollect and will disappear once the SPcollect completes (it gets moved into the SPcollect data.zip file). There is no need to upload the runlog.txt by itself and it will be necessary to wait until the SPcollect completes on each SP, before uploading the data.zip files.


No comments:

Post a Comment