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.