• Service the System

    PDF

    Service the System

    Change the service password

    The system ships with a default service password for performing service actions on the system. After you change the password, the old service password will not work.

    Prerequisites

    Both Storage Processors (SPs) must be present in the system and their boot mode must be Normal Mode. If you have removed an SP or an SP has failed, you must replace the SP before you can change the Service password.

    Format
    /service/user set { -passwd <value> | -passwdSecure } { { -oldpasswd <value> | -oldpasswdSecure } | -force }
    Action qualifiers
    Qualifier
    Description
    -passwd
    Type a new service password. The following are the password requirements:
    • Passwords must be 8 to 40 characters in length and cannot contain spaces.
    • Passwords must include mixed case, a number, and a special character from this list:

      ! , @ # $ % ^ * ? _ ~

    • When changing a password, do not reuse any of the last 3 passwords.
    -passwdSecure
    Specify the password in secure mode - the user will be prompted to input the password and the password confirmation.
    -oldpasswd
    Type the old password to set the new password.
    -oldpasswdSecure
    Specify the password in secure mode - the user will be prompted to input the password.
    -force
    Specify whether it is a password modification request or a password reset request. This is intended to be used by service user only.
    Example

    The following command changes the service password. Note that this can only be executed in normal mode:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/user set –passwd NewPassword456! –oldpasswd OldPassword456!
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                        

    Service the system

    Apply service action to the system. This command must be executed with service user credentials.

    Restart management software

    Restarts management software on the system. Can be executed in normal mode only.

    Format
    /service/system restart
    Example

    The following command restarts system management software:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/system restart
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            

    Shut down the system

    Shuts down the system.

    Note:  This command can be executed in normal mode only.
    Format
    /service/system shutdown
    Example

    The following command shuts down the system (in normal mode only):

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/system shutdown
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            

    Reinitialize the system

    Reinitialize the storage system. The system should be in the service mode to execute this action.

    Format
    /service/system reinit
    Example

    The following command reinitializes the storage system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/system reinit
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            

    Collect service information

    Collect information about the system and save it to a file. The file may then be downloaded using the uemcli -download command. (See View the switches).

    Format
    /service/system collect {-serviceInfo [-type {full | perfAssessment | perfTrace}] | -config [-showPrivateData]}
    Action qualifiers
    Qualifier
    Description
    -serviceInfo
    Collect information about the system and save it to a .tar file. Service providers can use the collected information to analyze the system.
    -type
    Specify the type of service information to collect. Valid values are:
    • full(default)–Collect the full set of service information.
    • perfAssessment–Collect service information for doing a performance assessment.
    • perfTrace–Collect service information for doing a trace.
    • minimum—Collect a minimum set of service information (log files only).
    -config
    Create a snapshot of the current system configuration and save it to a file. It captures all of the data necessary to recreate the current configuration on a new or reinitialized system. It does not capture log files or other types of diagnostic data.
    -showPrivateData
    Include sensitive information (such as IP addresses) into the collected data.
    Example 1

    The following command collects information about the system and saves it to a file:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/system collect -serviceInfo
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            
    Example 2

    The following command collects service information about system performance and saves it to a file.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/system collect -serviceInfo -type perfAssessment
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            

    Manage core dump files

    Manage the list of core dump files, which contain system information used by support for troubleshooting.

    Core dump files are generated by the system whenever there is an SP failure. Core dump files are used by support to help troubleshoot and resolve issues.

    Table 1. Core dump attributes
    Attribute
    Description
    ID
    Indicates the unique identifier of the core dump file.
    Name
    Name of the core dump file.
    Creation time
    Date and time when the core dump file was generated.
    File size
    Total size of all the core dump files in the dump folder.

    View core dumps

    View a list of core dump files generated by the system for both SPs. The files may be downloaded using the uemcli -download command. (See View the switches).

    Format
    /service/system/dump [-id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Indicates the unique identifier of the core dump file.
    Example

    The following command shows a list of the system core dumps.

    uemcli -d 10.0.0.1 -u local/serviceuser -p Password /service/system/dump –id "mspb:logDaemon_:2017-03-15_07_34_54_878_logDaemon.x" show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID            = mspb:logDaemon_:2017-03-15_07_34_54_878_logDaemon.x
           Name          = logDaemon_dump_spb_FCNCH097052190_2017-03-15_07_34_54_878_logDaemon.x_dir
           Creation time = 2017-03-15 07:34:54.000
           File size     = 126MB
                            

    Delete core dumps

    Delete a core dump file from the list of core dumps generated by the system.

    Format
    /service/system/dump {-id <value>} delete
    Object qualifier
    Qualifier
    Description
    -id
    Specify the unique identifier of the core dump file to be deleted.
    Example

    The following command deletes a core dump by specifying its name.

    uemcli -d 10.0.0.1 -u local/serviceuser -p Password /service/system/dump -id mspa:CP_:2016-06-22_15_13_20_19151_ECOM delete
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            

    Manage Service Information

    Manage and list the service information files that have been generated on your system.

    Table 2. Service information file attributes
    Attribute
    Description
    ID
    Indicates the unique identifier of the service information file.
    Name
    Name of the service information file.
    Creation time
    Date and time when the service information file was generated.
    File size
    Total size of all the service information files on the system.

    View service information file list

    View the list of service information files generate on your system.

    To download the service information files, use the uemcli -download command. See the View Switches section for detailed usage.

    Format
    /service/system/serviceInfo [-id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Optionally specify the ID of the service information file you want to view.
    Example

    The following example shows the list of service information files.

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/system/serviceInfo show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID            = m2018-12-31_20_19_02:spa__VNXe3200
           Name          = spa__VNXe3200_service_data_FCNCH097274951_2018-12-31_20_19_02.tar
           Creation time = 2018-12-31T20:23:35.000Z
           File size     = 100MB
    
                            

    Manage SSH access

    Manage SSH (Secure shell) access to the system. This command must be executed with service user credentials.

    Set SSH access

    Manage SSH access to the system.

    Format
    /service/ssh set -enabled {yes | no}
    Action qualifiers
    Qualifier
    Description
    -enabled
    Flag indicating whether the SSH access is enabled. The following are the password requirements. Value is one of the following:
    • yes
    • no
    Example

    The following command enables SSH access to the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/ssh set -enabled yes
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            

    View SSH settings

    Displays SSH settings.

    Format
    /service/ssh show
    Example

    The following command displays SSH settings:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/ssh show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     SSH enabled    = yes
    
                            

    Service the storage processor (SP)

    Allows user to apply service action to the storage processor. This command must be executed with service user credentials.

    Enter service mode

    Switch the storage processor to the service mode.This command can only be executed in normal mode.

    Format
    /service/sp -id <value> service
    Object qualifier
    Qualifier
    Description
    -id
    Identifies the storage processor.
    Example

    The following command enters the service mode:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/sp -id spa service
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            

    Reboot

    Reboot the storage processor.

    Format
    /service/sp -id <value> reboot
    Object qualifier
    Qualifier
    Description
    -id
    Identifies the storage processor.
    Example
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/sp -id spa reboot
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            

    Reimage

    Reimage the storage processor.

    Format
    /service/sp -id <value> reimage
    Object qualifier
    Qualifier
    Description
    -id
    Identifies the storage processor.
    Example
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /service/sp -id spa reimage
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.