Skip to main content
Close
Hitachi Vantara Knowledge

Performance Data Collection - How to Run the Export Tool

  1. Last updated
  2. Save as PDF

** For the best user experience, log in to view this article. Users who do not log in will find some links do not work. **

Objective

  • How to collect "Performance Out" data from USP V, USP VM, VSP, VSP G1x00, Gx00, Gxx0,  HUS VM, VSP G5x00 and VSP E series
  • How to run the export tool
  • Enterprise performance data collection

Environment

  • Virtual Storage Platform (VSP G1x00), RAID800
  • Virtual Storage Platform (VSP G5x00), RAID900
  • Virtual Storage Platform (VSP Gx00), HM800
  • Virtual Storage Platform (VSP Gxx0), HM850
  • Virtual Storage Platform (VSP) E Series
  • RAID performance
  • Export tool
  • Microsoft® Windows®

Procedure

Note: Some links in this article will not be clickable unless logged in.

Note:  For SVP-Less Systems, Use: Performance Data Collection - Monitor 2 Performance Data from Systems Without an SVP 

  • Export tool is on the "...Customer Tools CD" that correlates to the microcode version of the Storage. Click Here for download instructions.
  • Note that typically short range performance data is only available for up to 24 hours.  Therefore it is very important that data is collected soon, during or after any performance impact.
  • It is also important to ensure that monitoring is enabled and active Control Units (CU) are selected for monitoring, data will only be stored from the point in time they are enabled.
  • There is no reason to provide any data which does not capture a problem or event as we will be unable to progress any investigation
  • On busy systems logs will wrap quickly so please collect data as soon as possible or within 24 hours after an incident
    • Validate that performance monitoring is enabled and CU are selected, for example: How to Enable Performance Monitoring for VSP G1x00
    • Validate that no changes have been made to Performance Monitor. Any changes will clear all historical data.
    • When running the export tool the output will show the available data.  You may need to adjust the "shortrange" or "range" stanza in the command.txt export script to collect the available range of data if this is less than 24 hours:

[ 14] show
Monitoring time range
From : 2020/10/01 11:23 - To : 2020/10/01 12:53 Interval : 1min.

  • For example, if performance monitoring is newly enabled, wait at least an hour after enabling monitoring and then modify the stanza to:

shortrange -0100:   OR    range -0100:

Steps

  1. Extract, burn, or mount the "...Customer Tools CD" for the array microcode version.
  2. Copy the "ExportTool" folder to an easy-to-remember drive path (example: desktop).
  3. Open ...\ExportTool\win_nt\ folder.
  4. Run "export.EXE" application.
  5. Press the OK button.
    • This will create a folder called "export" within the ...\ExportTool\win_nt\ folder.
  6. Open ...\ExportTool\win_nt\export directory.
  7. Right-click "command.txt" and click Edit.
    editcommand-dot-text.png
     
  8. For Line #1 for svpip, edit xxx.xxx.xxx.xx to equal your service processor (SVP) IP address. Be careful not to add or remove any extra spaces!
    editcommand-dot-textsvpip.png
     
  9. For VSP Gx00 models and (VSP) E Series, there is an extra field with the serial number of the sub system required; therefore Line #2 will be as follows: replace VSP Gx00 or (VSP) E Series Serial Number with xxxxxx on Line #2  and Line # 3 will contain user login and password similar to step 10. .  HM-800-command.png
  10. For other subsystems, there is NO system serial number needed; therefore for Line #2, for login, replace userid "password" with Storage Navigator credentials (do not modify the spacing, and keep the password within the quotations).
    • Best Practice: Use an exclusive user-created Storage Navigator account with 'Support Personnel' role.
    • In a pinch, you can use the default Storage Navigator logins. This is not best practice though.
      editcommand-dot-textsvpcred.png
       
  11. If the longrange stanza is commented out the export will attempt to collect 90 days of 15 minute-interval summary data:
    Default (not commented out):
    editcommand-dot-text-longrangenormal.png

    Commented out:
    editcommand-dot-text-longrangecommentout.png
  12. Optional: If the shortrange collection is too much, you may need to comment out the 24-hour collection and only perform an 8-hour collection.
    Default (24-hour collection):
    editcommand-dot-text-shortrange24.png

    8-hour shortrange:

     
  13. Save Command.txt.
  14. Double-click runWin.Bat within ...\ExportTool\win_nt\export directory.
    • Do not run as administrator; the export tool will output a java error if you do.
    • For Gxx0 series systems running Hitachi-supplied SVPs with OpenJDK installed, use runWinOnSvp.bat instead - as there is no default classpath variable to Java.exe
  15. Do not touch the command prompt window until you see "Export Tool End" and "Press any key to continue..." output.
    exporttoolend.png
     
  16. Archive the "out" folder in the *.zip format, and upload it to https://tuf.hitachivantara.com/upload.php using your service request (SR) number.
    • To assist our automated processing services; only store one performance data collection per zip file and try to include the words "out" or "export" in the filename for identification, e.g. "Out_Secondary_12345_Friday.zip".
    • It is also helpful to edit the Description field of the upload page, include the system serial number and date and time of the collection and other pertinent details. Contact Global Support after the upload is complete.
      archiveout.png

Additional Notes

  • For the best user experience, log in to view this article. Users who do not log in will find some links do not work.
  • If Hitachi modular storage is virtualized behind the array, and the external storage could be causing the problem, be sure to collect performance data from it BEFORE collecting the enterprise performance data. NOTE: Performance data on modular storage must be collected while the problem is happening.
  • Collection times vary based on system configuration and current IO workload. Expect a minimum of one hour of waiting for the collection to complete.
  • If changes are made to Performance Monitor, then short range data collection is limited to the time since the change. Modify the short range period to reflect the new time period. For example, if you added a control unit (CU) four hours ago, change  short range to four or less hours.
  • "Shortrange" & "range" data collection cannot exceed 24 hours.
  • The VSP Gx00 and VSP Fx00 series does not store longrange data.
  • If any errors happen during collection, archive "log" folder within ...\ExportTool\win_nt\export\ in the *.zip format and upload it to https://tuf.hitachivantara.com/upload.php using your SR number. Contact Global Support after the upload is complete.
    exporterror.png
  • For the VSP G130 G/F350 G/F370 G/F700 G/F900 series and the VSP E Series without an SVP, please see Enterprise - Collect Monitor 2 Performance Data from Systems Without an SVP
  • To run the Export Tool on the SVP, please see Performance Data Collection - Modify the Export Tool so That It Can Run in OpenJDK SVP and MPC Environments