Diagnostic Tests

Available Languages

Download Options

  • PDF     (473.4 KB)
    View with Adobe Reader on a variety of devices
Updated:August 3, 2012

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Diagnostic Tests

Diagnostic Tests

This chapter includes the following sections:

Diagnostic Tests Overview

Diagnostics is a standalone utility that runs on the E-Series Server independent of the operating system or applications running on the server. If you experience problems with the E-Series Server, you can use diagnostics tests to run a preliminary check and isolate the problem. Diagnostic tests can be executed on the server CPU, memory, and block devices. Block devices include hard drive, USB drive, and SD cards.

If the diagnostic tests pass successfully, it indicates that there is no problem with the server CPU, memory, or block devices. The problem could be with some other hardware component or with the software configuration. Open a service request with Cisco Technical Assistance Center (TAC) at: http://www.cisco.com/cisco/web/support/index.html to isolate the problem.

If the diagnostic tests fail, open a service request with Cisco TAC for further assistance.


Caution

Diagnostic tests are non-destructive, but if there is power or equipment failure when the tests are running, there is a possibility that the disk data might get corrupted. Therefore, we highly recommend that you backup the data before running these tests.

Basic Workflow for Executing Diagnostic Tests

  1. Backup data.
  2. Download the diagnostics image from the specified FTP, SFTP, HTTP, or HTTPS server onto the SD card.
  3. Mount the diagnostics image onto the HDD virtual drive of a USB controller.
  4. Set the boot order to make EFI Shell as the first boot device.
  5. Reboot the server.
  6. Run diagnostic tests from the EFI Shell.
  7. Reset the virtual media boot order to its original setting.

Mapping the Diagnostics Image to the Host

Before You Begin
  • Log into CIMC as a user with admin privileges.
  • Obtain the diagnostics image file from Cisco Systems.

Note

If you start an image update while an update is already in process, both updates will fail.
Procedure
      Command or Action Purpose
    Step 1 Server# scope host-image-mapping  

    Enters the host image mapping command mode.

     
    Step 2 Server /host-image-mapping # download-image {ftp | sftp | http | https} server-ip-address path / filename [username username password password]  

    Downloads the image from the specified remote server onto the SD card. The diagnostics image must have .diag as the file extension. The remote server can be a FTP, SFTP, HTTP, or HTTPS server. If the remote server requires user authentication, you must add the username and password of the remote server.

    Note   

    If the image file exceeds the flash SD card size limit, an error message is displayed.
     
    Step 3 (Optional) Server /host-image-mapping # show detail  

    Displays the status of the diagnostics image download.

     
    Step 4 Server /host-image-mapping # map-diagnostics  

    Mounts the image on the HDD virtual drive of the USB controller.

     
    Step 5 (Optional) Server /host-image-mapping # show detail  

    Displays the status of the diagnostics image mapping.

     

    This example maps a diagnostics image:

    Server# scope host-image-mapping 
Server /host-image-mapping # download-image ftp 10.20.34.56 pub/diagnostics-image.diag
---
Server /host-image-mapping # show detail
Host Image Info:
  Name: DiagnosticsImage.diag
  Size: 6626848
  Last Modified Time: Fri, 12 Aug 2011 21:13:27 GMT
  Host Image Status: Download Successful!!
Server /host-image-mapping # map-diagnostics
---
status: ok
---
Server /host-image-mapping # show detail
Host Image Info:
  Name: DiagnosticsImage.diag
  Size: 6626848
  Last Modified Time: Fri, 12 Aug 2011 21:13:27 GMT
  Host Image Status: Image mapped successfully!!
    What to Do Next

    1. Set the boot order to make EFI Shell as the first boot device.
    2. Reboot the server. The EFI Shell appears.
    3. Run diagnostic tests.

    Running Diagnostic Tests

    From the EFI Shell, use the following procedure to run diagnostic tests.

    Before You Begin
    • Backup data. All tests are non-destructive, but if there is power or equipment failure when the tests are running, there is a possibility that the disk data might get corrupted. Therefore, we highly recommend that you backup data before executing these tests.
    • Use the CIMC CLI or the CIMC GUI to download and map the diagnostics image onto the HDD virtual drive of the USB controller.
    • Reboot the server. The EFI Shell displays.
    Procedure
        Command or Action Purpose
      Step 1 Shell > dir virtual-media-drive-name:  

      Displays all the file packages that exist in the specified virtual media drive. The drive name starts with fs0 and can be fs0, fs1, fs2, and so on.

      Note   

      Make sure that you add a colon after the virtual media drive name. For example, dir fs1:
       
      Step 2 Shell > virtual-media-drive-name:  

      Enters the virtual media drive in which the diagnostic file is located.

       
      Step 3 Virtual Media Drive :\> cp package-file-name dsh.pkg  

      Copies the package file for which you are running diagnostics into the diagnostics shell package file.

       
      Step 4 Virtual Media Drive :\> dsh  

      Enters the Diagnostics Shell. At the confirmation prompt, answer Y.

       
      Step 5 Server: SRV > run all  

      Executes all available diagnostic tests and displays the progress and status of the tests. Diagnostic tests are run on the server CPU, memory, and block devices. Block devices include hard drive, USB drive, and SD cards.

      To execute a specific diagnostic test on the server, use the run test-name command where test-name can be one of the following:
      • cpux64—CPU diagnostic test.
      • diskx64—Block devices diagnostic test. Block devices include hard drive, USB drive, and SD cards.
      • memoryx64—Memory diagnostic test.
      Note   

      Diagnostic tests can run for approximately 10 minutes.
       
      Step 6 (Optional) Server: SRV > results  
      Displays a summary of the diagnostic test with Passed or Failed test status.
      Note   

      The summary report indicates the number of tests that failed and passed. It does not provide information about which tests failed or passed. To determine which tests failed and passed, see the output of the run all command.
       
      Step 7 (Optional) Server: SRV > show  

      Displays a list of global parameters and diagnostic test modules that were administered on the server.

       
      Step 8 Server: SRV > exit  

      Exits from Diagnostic Shell.

       
      Step 9 Open a service request with Cisco TAC. 

      If the diagnostic tests pass successfully, it indicates that there is no problem with the server CPU, memory, or block devices. The problem could be with some other hardware component or with the software configuration. Open a service request with Cisco TAC to isolate the problem.

      If the diagnostic tests fail, open a service request with Cisco TAC for further assistance.

       

      This example runs all diagnostic tests:

      Shell > dir fs1:  
		06/27/12  07:48p            1,435,424  Dsh.efi
  06/27/12  08:03p               10,036  dsh-e140d.pkg
  06/25/12  06:00p               10,140  dsh-e140s.pkg
  06/27/12  08:04p               10,042  dsh-e160d.pkg
          4 File(s)   1,465,642 bytes
Shell > fs1:
fs1:\> cp dsh-e140d.pkg dsh.pkg
copying fs0:\OBD\dsh-e140d.pkg -> fs0:\OBD\dsh.pkg
- [ok]
fs1:\> dsh
Diagnostics is a standalone utility that runs on the server module independent
of the operating system or applications running on the module.All tests are
non-destructive, but there is a possibility of disk datacorruption during
power or equipment failure when the tests are in progress. Therefore, before
executing these tests, we highly recommend that you backup the data.


For questions or concerns with this utility, please open a Service Request
with Cisco TAC at http://www.cisco.com/cisco/web/support/index.html

(Y)es to continue test. (N)o to exit(y/n): Y
Cisco Diagnostics  Shell 1.03(0.3) Thu 06/28/-16:35:08.95-canis-diag@cisco.com
UCS-E140D-M1/K9:SRV>

Server: SRV > run all
Server: SRV > results
Test Name          : all
Test Status        : Passed
Failed/Run History : 0/17
Start Time         : 06/27/12 14:38:19
End Time           : 06/27/12 14:43:36
Diag Version       : 1.03(0.3) Mon 04/02/-17:07:57.19-canis-diag@cisco.com
Board S/N          : FOC160724BY

Server: SRV > show
Server: SRV > exit
      What to Do Next

      Reset the virtual media boot order to its original setting.

      Was this Document Helpful?

      FeedbackFeedback

      Contact Cisco

      This Document Applies to These Products