Dell EMC Unity
™
Family
Version 4.4
Unisphere
®
Command Line Interface User Guide
P/N 302-002-578 REV 05
Copyright
©
2016-2018 Dell Inc. or its subsidiaries. All rights reserved.
Published June 2018
Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND
WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED
IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.
Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.
Published in the USA.
Dell EMC
Hopkinton, Massachusetts 01748-9103
1-508-435-1000 In North America 1-866-464-7381
www.DellEMC.com
2 Unity Family 4.4 Unisphere Command Line Interface User Guide
15
Introduction 17
Overview.....................................................................................................18
Storage types.................................................................................18
Use Unisphere CLI in scripts...........................................................18
Set up the Unisphere CLI client...................................................................18
Install the Unisphere CLI client.......................................................18
Launch the Unisphere CLI client.....................................................19
Certificate verification................................................................... 19
Unisphere CLI syntax..................................................................................20
Executable.....................................................................................20
Switches........................................................................................20
Objects..........................................................................................20
Object qualifiers............................................................................. 21
Actions........................................................................................... 21
Action qualifiers..............................................................................21
Size qualifiers................................................................................ 22
Speed qualifiers............................................................................. 22
Action commands....................................................................................... 22
The create action command.......................................................... 22
The set action command................................................................23
The show action command............................................................ 23
The delete action command...........................................................25
Get help......................................................................................................25
Help on the Unisphere CLI client................................................... 25
Help on parent object types...........................................................26
Help on child object types..............................................................27
Help on actions.............................................................................. 27
Manage SSL certificates............................................................................ 28
Configure a certificate policy.........................................................28
View certificates............................................................................28
Delete certificates......................................................................... 29
Clear all certificates.......................................................................29
Import certificates.........................................................................29
View the switches...................................................................................... 29
Access the system..................................................................................... 35
Upload an upgrade candidate......................................................................37
Hide header information............................................................................. 38
Save Unisphere CLI settings.......................................................................38
Manage the System 39
Configure general system settings............................................................. 40
View system settings......................................................................41
Change general system settings.................................................... 42
Manually fail back NAS servers (physical deployments only).........43
Perform a system health check..................................................... 43
Preface
Chapter 1
Chapter 2
CONTENTS
Unity Family 4.4 Unisphere Command Line Interface User Guide 3
Configure system information.................................................................... 44
View system information............................................................... 44
Change system information........................................................... 45
Manage software versions..........................................................................46
View system software versions......................................................47
Prepare system software version.................................................. 48
Upgrade the system................................................................................... 49
Create upgrade sessions................................................................50
View upgrade sessions...................................................................52
Resume upgrade session............................................................... 53
Cancel upgrade session................................................................. 53
Manage security settings........................................................................... 54
View security settings................................................................... 54
Change security settings............................................................... 54
Manage system time.................................................................................. 55
View system time.......................................................................... 56
Change system time...................................................................... 56
Manage support configuration....................................................................57
View support configuration............................................................58
Change support configuration....................................................... 59
Manage support contracts......................................................................... 60
View support contracts................................................................. 60
Refresh support contracts............................................................. 61
Manage Centralized ESRS.......................................................................... 61
View Centralized ESRS configuration............................................62
Change Centralized ESRS configuration........................................62
Check Centralized ESRS network connection............................... 63
Manage Integrated ESRS (physical deployments only).............................. 64
View Integrated ESRS configuration............................................. 65
Change Integrated ESRS configuration......................................... 65
Check Integrated ESRS network connection.................................66
Request access code for Integrated ESRS.................................... 66
Validate access code for Integrated ESRS.....................................67
Manage Policy Manager................................................................ 67
Manage Connect Home.............................................................................. 70
View Connect Home.......................................................................71
Change the Connect Home configuration settings......................... 71
Test Connect Home.......................................................................72
Manage user roles...................................................................................... 72
View user roles...............................................................................73
Manage user accounts................................................................................74
Create user accounts.....................................................................75
View user accounts........................................................................76
Change user accounts....................................................................77
Delete user accounts..................................................................... 78
Manage user account settings....................................................................79
Configure user account settings.....................................................81
View user account settings............................................................84
Manage support credentials....................................................................... 84
View support credentials............................................................... 85
Change support credentials...........................................................85
Delete support credentials.............................................................86
Manage system limits................................................................................. 86
View system limits......................................................................... 86
View installed feature licenses.................................................................... 87
View licenses................................................................................. 88
CONTENTS
4 Unity Family 4.4 Unisphere Command Line Interface User Guide
View and accept the End User License Agreement.....................................89
View the EULA...............................................................................89
Accept the EULA........................................................................... 89
Manage Unisphere Central Management/Monitoring.................................90
Create the remote manager configuration.....................................90
View remote manager configuration...............................................91
Change remote manager configuration.......................................... 91
Manage remote logging.............................................................................. 92
View settings for remote logging................................................... 93
Configure settings for remote logging........................................... 93
Manage system certificates........................................................................94
View certificates information.........................................................96
Delete system certificate...............................................................97
Manage snapshot protection schedules......................................................97
View protection schedules.............................................................98
Delete protection schedules.......................................................... 99
Manage task rules...................................................................................... 99
Create task rules.......................................................................... 100
View task rules............................................................................. 104
Delete task rules.......................................................................... 105
Manage jobs..............................................................................................106
View list of jobs............................................................................ 107
Resume a job................................................................................108
Cancel a job..................................................................................108
Delete jobs................................................................................... 109
Manage job step........................................................................................109
View list of steps in a job...............................................................110
Configure Network Communication 113
Manage NAS servers................................................................................. 114
Create a NAS server..................................................................... 118
View NAS servers.........................................................................120
Change NAS server settings......................................................... 121
Delete NAS servers...................................................................... 125
Check and update user mappings for multiprotocol NAS servers....
127
Manage FTP settings................................................................... 129
Manage LDAP settings of a NAS server....................................... 137
Manage NAS interfaces................................................................143
Manage NAS routes..................................................................... 150
Manage Kerberos settings............................................................155
Manage VLANs..........................................................................................157
View VLANs..................................................................................157
Manage tenants........................................................................................ 158
Create a tenant............................................................................ 159
View tenants................................................................................ 160
Change tenant settings................................................................ 160
Delete a tenant............................................................................. 161
Manage CIFS Servers............................................................................... 162
Create a CIFS server.................................................................... 162
View CIFS server..........................................................................164
Change CIFS server settings........................................................164
Delete a CIFS server ................................................................... 166
Manage NFS servers................................................................................. 167
Create an NFS server...................................................................168
Chapter 3
CONTENTS
Unity Family 4.4 Unisphere Command Line Interface User Guide 5