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:
|
-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 restartExample
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 shutdownExample
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 reinitExample
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:
|
-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.
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>] showObject 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>} deleteObject 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.
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>] showObject 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:
|
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 showExample
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> serviceObject 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> rebootObject 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> reimageObject 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.