• Unisphere CLI commands

    PDF

    Unisphere CLI commands

    Upgrade the system software

    Create an upgrade session to upgrade the system software or view existing upgrade sessions. The upgrade session installs an upgrade candidate file that was uploaded to the system. Download the latest upgrade candidate from the support website. Use the -upload switch to upload it to the system before creating the upgrade session.

    The latest software upgrade candidate contains all available hot fixes. If you have applied hot fixes to your system, the hot fixes will be included in the latest upgrade candidate.

    All system components must be healthy, prior to upgrading the system software. If any system components are degraded, the software update will fail. Perform a system health check explains how to run a health check on the system.

    The following table lists the attributes for upgrade sessions.

    Table 1. Upgrade session attributes
    Attribute
    Description
    Status
    Current status of the upgrade session. Value is one of the following:
    • running — Session is upgrading the system software.
    • completed — Session has completed upgrading the system software.
    • paused— Upgrade session has paused before rebooting the SPs.
    • failed— Upgrade session has failed.
    Progress
    Current progress of the upgrade session
    Creation time
    Date and time the upgrade session was created
    Elapsed time
    Amount of time that the upgrade session has been running
    Estimated time left
    Estimated time required to complete the upgrade session
    Percent complete
    Indicates the progress of the upgrade in percent.

    View system software versions

    Display details about the version of the installed system software and the software upgrade candidate that has been uploaded to the system. Upgrade the system software explains how to upgrade the system software. The following table lists the system software attributes.

    Table 2. System software attributes
    Attribute
    Description
    ID
    ID of the system software
    Type
    System software type. Value is one of the following:
    • installed — System software that is currently installed on the system
    • candidate — Upgrade candidate uploaded to the system for upgrading the system software
    Version
    Software version
    Release date
    Software release date
    Image filename
    Filename of the software image
    The show action command explains how to change the output format.
    Format
    /sys/soft/ver [{-id <value>|-type {installed|candidate}}] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the system software.
    -type
    Type the software type. Value is one of the following:
    • installed — View the version of the system software that is installed
    • candidate — View the version of the system software upgrade candidate that was uploaded to the system
    Example

    The following command displays details about the installed system software and an uploaded upgrade candidate:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/soft/ver show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID           = INST_1
           Type         = installed
           Version      = 0.1.0.1487
           Release date = 2016-04-30
    
    2:     ID           = CAND_1
           Type         = candidate
           Version      = 0.1.0.2187
           Release date = 2016-11-14
    
                            

    Perform a system health check

    Perform a health check of the entire system. A health check is a series of checks on the state of your system to ensure that no underlying problems exist.

    Before upgrading the system software, a system health check must be performed. All system components must be healthy prior to upgrading the system software. If any of the system components are degraded, the software update will fail.
    Format
    /sys/general healthcheck
    Example

    The following command performs a health check of the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/general healthcheck
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1: Error code = Error: The health check has failed. An internal error is preventing 
    the health check from completing successfully. Record the error code and search the 
    EMC Online Support website for available support options. 
    [Error Code: platform::check_boot_control_status_2]
    
    Operation completed successfully.
    
                            
    • The results of the health check may show errors and warnings, but a message of Operation completed successfully. displays in the output. This is only an indication that the health check action was performed, not that it was successfully completed without errors and warnings. Attempt to resolve all errors and rerun the health check.
    • If errors occur, a system software upgrade is not allowed. If warnings occur, they can be bypassed during the upgrade procedure.

    Upload and upgrade candidate

    To upgrade the system software, upload an upgrade candidate file that you download from the support website and use the -upload qualifier. Once you upload the candidate file to the system, use an upgrade session to start the upgrade process. Create upgrade sessions explains configuring upgrade sessions.

    Prerequisites

    Download the latest system software upgrade candidate from the support website.

    Format
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! -upload -f <file> upgrade
    Options
    Qualifier
    Description
    -f
    Type the path and file name of the upgrade candidate file to upload. Wrap the path and file name in quotes.
    Example

    The following example upload a upgrade candidate file to the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! -upload -f “\&#xpgrade_image&#xpgrade-2.0.0.12190-MAGNUM-RETAIL.tgz.bin” upgrade
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
    
                            

    Create upgrade sessions

    Create a session to upgrade the system software with an uploaded upgrade candidate.

    Do not use Unisphere or Unisphere CLI to manage or configure the system during a software upgrade.
    Format
    /sys/soft/upgrade create [–candId <value>] [-pauseBeforeReboot]
    Action qualifiers
    Qualifier
    Description
    -candId
    Type the ID of the uploaded upgrade candidate. View system software versions explains how to view the ID of the uploaded software candidate.
    -pauseBeforeReboot
    Specify whether to pause during the upgrade, executing all tasks before the SPs reboot.
    This option is ignored for language packs, hot fix, and ODFU upgrades.
    Example

    The following command creates a session to upgrade the system software to upgrade candidate CAND_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/soft/upgrade create –candId CAND_1
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = UPGSES_1
    Operation completed successfully.
    
                            
    All warning messages, if any, appear the first time you run the upgrade process. When a potential issue results in a warning message, the upgrade process stops. Once you review the warning message, run the upgrade command again to continue with the upgrade process. This time the upgrade process will run the checks again, but it will not stop for any warnings. The upgrade process will only stop when an error occurs.

    View upgrade sessions

    View details for an existing software upgrade session.

    The show action command explains how to change the output format.
    Format
    /sys/soft/upgrade show
    Example

    The following command displays details about the system software upgrade session:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /sys/soft/upgrade show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     Status              = Running
           Status message      = 
           Creation time       = 2009-11-09 19:43:08
           Elapsed time        = 01h 43m 08s
           Estimated time left = 01h 10m 00s
           Progress            = Task 5 of 25 (Stopping c4 stack on SPA)
           Percent complete    = 15%
    
    
                            

    The show action command

    The show action command displays a list of objects that exist on the system and the attributes of those objects. You can specify an object qualifier to view the attributes for a single object. The show action command provides qualifiers for changing the display of the output, including the format and the attributes to include. The available output formats are name-value pair (NVP), table, and comma-separated values (CSV).

    Format
    uemcli [<switches>] <object> [<object qualifier>] show [{-detail | -brief | -filter <value>] [-output {nvp | table [-wrap] | csv}]
    Action qualifier
    Qualifier
    Description
    -output|-o
    Specify the output format. Value is one of the following:
    • nvp — The name-value pair (NVP) format displays output as name=value. Name-value pair format provides an example of the NVP format.
    • table — The table format displays output as a table, with column headers and rows. By default, values that are too long to fit in a column are cut off. Add -wrap after the table qualifier, separated by a space, so that the values wrap. Table format provides an example of the table format.
    • csv — The comma-separated values (CSV) format is similar to the table format, but the names and values are separated by commas. Comma-separated values format provides an example of the CSV format.
    -detail
    Display all attributes.
    -brief
    Display only the basic attributes (default).
    -filter
    Comma-separated list of attributes which are included into the command output.
    Name-value pair format
                          1:     ID                 = la0_SPA
           SP                 = SPA
           Ports              = eth0_SPA,eth1_SPA
           Health state       = OK (5)
    
    2:     ID                 = la0_SPB
           SP                 = SPB
           Ports              = eth0_SPB,eth1_SPB
           Health state       = OK (5)
    
                        
    Table format
                          ID      | SP  | Ports             | Health state
    --------+-----+-------------------+--------------
    la0_SPA | SPA | eth0_SPA,eth1_SPA | OK (5)
    la0_SPB | SPB | eth0_SPB,eth1_SPB | OK (5)
                        
    Comma-separated values format
                          ID,SP,Ports,Health state
    la0_SPA,SPA,”eth0_SPA,eth1_SPA”,OK (5)
    la0_SPB,SPB,”eth0_SPB,eth1_SPB”,OK (5)
                        
    Example

    The following command modifies the set of attributes in the show action output. For example, if you add -filter "ID,ID,ID,ID" to the command, in the output you will see four lines with the "ID" attribute for each listed instance:

                          1:  ID = la_0
        ID = la_0
        ID = la_0
        ID = la_0
                        
    uemcli /net/nas/server show -filter “ID, SP, Health state, ID, Name”
    Filter format
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID           = nas_1
           SP           = SPA
           Health state = OK (5)
           ID           = nas_1
           Name         = Mynas1
    
    2:     ID           = nas_2
           SP           = SPA
           Health state = OK (5)
           ID           = nas_2
           Name         = Mynas2