Diagnostic Tests

This chapter includes the following sections:

Diagnostic Tests Overview

Diagnostics is a standalone utility that runs on the E-Series Server or NCE independent of the operating system or applications running on the server. If you experience problems with the E-Series Server or NCE, 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 a power or equipment failure when the tests are running, there is a possibility that the disk data might get corrupted. We highly recommend that you backup the data before running these tests.

Basic Workflow for Executing Diagnostic Tests

  1. Backup data.

  2. The diagnostics image is pre-installed on the E-Series Server or NCE at the time of purchase. You can also choose to download the most current diagnostics image from a specified FTP or HTTP server onto the CIMC internal repository.

  3. Mount the diagnostics image onto the HDD virtual drive of a USB controller.

  4. Set the boot order to make the Internal EFI Shell as the first boot device.

  5. Reboot the server.

    Note

    • For E-Series Servers and SM E-Series NCE—On server reboot, the EFI Shell displays.

    • For EHWIC E-Series NCE and NIM E-Series NCE—On server reboot, the AMIDiag EFI Shell displays.

  6. Run diagnostic tests from the EFI Shell or the AMIDiag EFI Shell as appropriate.

  7. Reset the virtual media boot order to its original setting.

Mapping the Diagnostics Image to the Host

Before You Begin

  • Backup data.

  • Log in to CIMC as a user with admin privileges.

  • The diagnostics image is pre-installed on the E-Series Server at the time of purchase. You can also choose to download the most current diagnostics image from a specified FTP or HTTP server onto the CIMC internal repository. See Obtaining Software from Cisco Systems.


Note

If you start an image update while an update is already in process, both updates will fail.

Procedure
    Step 1   In the Navigation pane, click the Server tab.
    Step 2   On the Server tab, click Host Image Mapping.
    Figure 1. Host Image Mapping



    Step 3   From the Host Image Mapping page, click Add Image.
    The Download Image dialog box opens. Complete the following fields:
    Name Description

    Download Image From drop-down list

    The type of remote server on which the image is located. This can be one of the following:

    • FTP

    • HTTP

    Note   

    Depending on the remote server that you select, the fields that display change.

    FTP or HTTP Server IP Address field

    The IP address of the remote FTP or HTTP server.

    FTP or HTTP File Path field

    The path and filename of the remote FTP or HTTP server.

    The path and filename can contain up to 80 characters.

    • If you are installing a host image, that image must have .iso or .img as the file extension.

    • If you are installing a diagnostics image, that image must have .diag as the file extension.

    Username field

    The username of the remote server.

    The username can contain 1 to 20 characters.

    Note   

    If the username is not configured, enter anonymous for the username and any character(s) for the password.

    Password field

    The password for the username.

    The password can contain 1 to 20 characters.

    Note   

    If the username is not configured, enter anonymous for the username and any character(s) for the password.

    Step 4   Click Download.

    The Host Image Mapping page opens. You can view the status of the image download in the Host Image Mapping Status area. After the image is downloaded and processed successfully, refresh the page. After the page refreshes, the new image displays in the Image Information area.

    Step 5   From the Image Information area, select the image to map, and then click Map Selected Image. The image is mapped and mounted on the virtual drive of a USB controller.
    Step 6   Set the boot order to make EFI Shell as the first boot device.

    To set the boot order, see Configuring the Server Boot Order Using the CIMC GUI.

    Step 7   Reboot the server.

    The EFI Shell appears.

    What to Do Next

    Run diagnostic tests.

    Running Diagnostic Tests—E-Series Servers and SM E-Series NCE

    From the EFI shell, use the following procedure to run diagnostic tests on the E-Series Servers and the SM E-Series NCE.

    Before You Begin

    • Back up 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. We highly recommend that you back up 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 ActionPurpose
      Step 1Shell > 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 2Shell > virtual-media-drive-name:  

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

       
      Step 3Virtual 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 4Virtual Media Drive :\> dsh  

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

       
      Step 5Server: 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 8Server: SRV > exit  

      Exits from Diagnostic Shell.

       
      Step 9Open 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.

      Running Diagnostic Tests—EHWIC E-Series NCE and NIM E-Series NCE

      Diagnostic tests are run on the server CPU, memory, and block devices. Block devices include SSD drive and USB drive.

      Before You Begin

      • Back up 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. We highly recommend that you back up data before executing these tests.

      • Delete previous versions of AMIDIAG_OBD.log files if any.

      • Use the CIMC CLI or the CIMC GUI to download and map the diagnostics image onto the HDD virtual drive of the USB controller.

      • Launch the KVM console.

      • Reboot the server. The AMIDiag EFI Shell displays in the KVM console: 
        Found AMI DIAG on fs0: 
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

Enter 'q' to quit, any other key to continue:

fs0:\>
      Procedure
         Command or ActionPurpose
        Step 1From the AMIDiag EFI Shell, press any key (except q) to run the diagnostic tests.  

        Executes all available diagnostic tests and displays the progress. After the tests are completed, the Pass or Fail test status displays.

        Note   

        Diagnostic tests can run for approximately 10 minutes.

         
        Step 2 (Optional) fs0:\> type AMIDIAG_OBD.log  

        Displays the Onboard Diag log files with details.

         
        Step 3Server: fs0:\> exit  

        Exits from AMIDiag EFI Shell.

         
        Step 4Open 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.

         
        What to Do Next

        Reset the virtual media boot order to its original setting.