Reference Guide

ManualsBrandsDell ManualsStorageDell Compellent FS8600

Dell FluidFS 5.0 FS8600 Appliance

CLI Reference Guide

Summary of content (304 pages)

PAGE 1
Dell FluidFS 5.
PAGE 2
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Copyright © 2016 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
PAGE 3
Contents About This Guide....................................................................................................15 Revision History................................................................................................................................... 15 Audience.............................................................................................................................................. 15 Related Documentation..........................................................
PAGE 4
access-control local-groups restore................................................................................................. 36 access-control local-groups view..................................................................................................... 36 access-control local-users add.......................................................................................................... 37 access-control local-users change-password.........................................................
PAGE 5
hardware fabrics iSCSI-portals view...................................................................................................62 hardware fabrics iSCSI view................................................................................................................63 hardware fabrics status-list.................................................................................................................64 hardware NAS-appliances add-appliance....................................................
PAGE 6
NAS-volumes edit name..................................................................................................................... 87 NAS-volumes edit owner................................................................................................................... 88 NAS-volumes edit space.................................................................................................................... 88 NAS-volumes edit subnet-restrictions add-allowed-subnets...............................
PAGE 7
NAS-volumes NFS-exports delete-acl for-clients-in-subnet......................................................... 116 NAS-volumes NFS-exports delete-acl for-single-client..................................................................117 NAS-volumes NFS-exports edit........................................................................................................ 117 NAS-volumes NFS-exports list..........................................................................................................
PAGE 8
NAS-volumes replication create-volume-on-destination..............................................................146 NAS-volumes replication demote.................................................................................................... 146 NAS-volumes replication disable......................................................................................................147 NAS-volumes replication disconnect........................................................................................
PAGE 9
NAS-volumes snapshots schedules list............................................................................................ 175 NAS-volumes snapshots schedules view......................................................................................... 176 NAS-volumes snapshots set-expiry..................................................................................................176 NAS-volumes snapshots view.........................................................................................
PAGE 10
networking monitor performance-summary IOPS last-week........................................................ 201 networking monitor performance-summary IOPS last-year......................................................... 202 networking monitor performance-summary IOPS now................................................................ 203 networking monitor performance-summary read last-day...........................................................
PAGE 11
system data-protection antivirus-scanners view.............................................................................231 system data-protection cluster-partnerships add........................................................................... 231 system data-protection cluster-partnerships delete...................................................................... 232 system data-protection cluster-partnerships delete-local-partnership-by-ID.............................
PAGE 12
system internal cluster-name view...................................................................................................251 system internal diagnostics list......................................................................................................... 251 system internal diagnostics run-client-connectivity-diagnostic....................................................252 system internal diagnostics run-file-system-diagnostic..............................................................
PAGE 13
system internal security support-access secure-console-access disable.....................................276 system internal security support-access secure-console-access disable-proxyauthentication................................................................................................................................... 277 system internal security support-access secure-console-access enable......................................
PAGE 14
system time view-current-time....................................................................................................... 295 system vmware compute-resources list......................................................................................... 296 system vmware compute-resources view...................................................................................... 296 system vmware virtual-machines clone..................................................................................
PAGE 15
Preface About This Guide This guide provide information about using the FS8600 command-line interface (CLI) and how it can be used to manage FluidFS clusters. Revision History Document number: 680-114-001 Revision Date Description A January 2016 Initial release of FluidFS v5 B March 2016 Removed a command that is no longer valid C July 2016 Removed a command that is no longer valid Audience The intended audience for this document are storage or network administrators.
PAGE 16
• Dell FluidFS Version 5.0 FS8600 Appliance Deployment Guide – Provides information about the deploying an FS8600, including cabling the appliance to the Storage Center and network, and deploying the appliance using the Dell Storage Manager software. • Dell FS8600 Appliance Service Guide – Provides information about FS8600 appliance hardware, system component replacement, and system troubleshooting.
PAGE 17
1 About the CLI The command line interface (CLI) provides a comprehensive set of commands for managing the FluidFS cluster. The CLI allows you to perform the same management operations as the FluidFS NAS Manager WebUI, as well as operations that can be performed only from the CLI. CLI Menus CLI commands are organized using menus and submenus. Menus group related CLI commands. The following table lists the CLI menus that are available.
PAGE 18
Menu Submenus Description • • • • • • NDMP sessions; and monitor performance and external servers.
PAGE 19
Menu Submenus • • • • • • Description cluster-name language diagnostics system-configuration-state background-operations EM – recipients NAS-volumes • list • – capacity-over-time – edit – clone NAS-pool • – configuration – capacity-overtime NFS-exports • – add-acl – delete-acl – general-settings SMB-shares • – home-share – general-settings quota Use this menu to manage NAS volumes, clone volumes, NFS exports,SMB shares, quota rules, snapshots, replication, and configuration backups; and monit
PAGE 20
CLI Command Syntax CLI commands have the following structure: CLI> - where: • CLI> – Command prompt where you type the command • – Name of the main menu • – Names of one or more submenus (separated with spaces). Certain menus have multiple levels of submenus.
PAGE 21
The CLI also lets you abbreviate a command if the abbreviation uniquely identifies the command. For example, the following commands are identical: events list and events li. Enter a Command by Navigating One Menu at a Time Enter a command by navigating through the CLI one menu at a time. 1. Type the
and press the Enter key. The available submenus and commands under the menu are displayed. 2. If needed, type the and press the Enter key.
PAGE 22
• ESC — Pressing Esc returns you to a command prompt Getting Help on the CLI The CLI provides online help for menus, commands, arguments, and options. At any time while using the CLI, you can type help to see more information about the available menus, commands, arguments, and options.
PAGE 23
• Using a UNIX/Linux workstation, type the following command from a prompt: ssh cli@ 2. Type the FluidFS cluster administrator user name at the login as prompt. The default user name is Administrator. 3. Type the FluidFS cluster administrator password at the ’s password prompt. The default password is Stor@ge!. You are logged on to the CLI and a Welcome window is displayed, listing the installed FluidFS version and the available commands in the main menu.
PAGE 24
2 CLI Commands This section describes the available FluidFS cluster CLI commands. access-control active-directory join Join the FluidFS cluster to Active Directory. Format access-control active-directory join {options} Arguments Argument Description Format Active Directory domain Existing Active Directory domain name Option Description Format -Username Active Directory administrator name Existing Active Directory administrator user name.
PAGE 25
access-control active-directory leave Description Disconnect the FluidFS cluster from the Active Directory domain. Format access-control active-directory leave Example Disconnect the FluidFS cluster from the Active Directory domain: CLI> access-control active-directory leave access-control active-directory modify-settings The system selects which controllers to use automatically, based on the sites defined in Active Directory.
PAGE 26
| Domain | DC Name | DC IP | Trust | Online | |-----------------|-----------------------|------------|--------|--------| | Dell-IDC.com | DC3.Dell-IDC.com |172.22.144.2| Two-way| Yes | |-----------------|-----------------------|------------|--------|--------| | QA.Dell-IDC.com | CHID2.QA.DEll-IDC.com | 10.48.28.34| Primary| Yes | |-----------------|-----------------------|------------|--------|--------| | QA2.Dell-IDC.com| | | Two-way| Yes | '-----------------'-----------------------'------------'--------.
PAGE 27
Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header -Domain Account domain, the available domains are displayed by “domains-list” command AccountNamePrefix Prefix of computer name to be displayed by the command Example Display a list of machine accounts (computers) in Active Directory. CLI> access-control computers-list Output .-----------------.-----------------.
PAGE 28
Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header -Remarks Remarks> Group description Text description of the group Output .-----------------.-----------------.
PAGE 29
Example Display a list of groups in the NAS domain whose group name starts with d: CLI> access-control groups-list NAS d Output .--------.----------------------.----------------------.---------.----------.
PAGE 30
Argument Description Format used as the last character of the account name. Options Options Description Format -Remarks Group description Text description of the group Example Add a local group named groupA: CLI> access-control local-groups add groupA access-control local-groups add-external-computer Add an external computer to a local group. NOTE: To view a list of existing domains, use the command access-control domains-list.
PAGE 31
Format access-control local-groups add-external-group Arguments Argument Description Format External user domain Existing external user domain name External group name Existing external group name Local group name Existing local group name Example Add an external group named groupABC in the NAS domain to a local group named groupA: CLI> access-control local-groups add-external-group NAS groupABC groupA access-c
PAGE 32
access-control local-groups add-local-user Add a local user to a local group. Format access-control local-groups add-local-user Arguments Argument Description Format Local user name Existing local user name Local group name Existing local group name Example Add a local user named user1 to a local group named groupA: CLI> access-control local-groups add-local-user user1 groupA access-control local-groups delete Delete a local group.
PAGE 33
Format access-control local-groups delete-external-computer Arguments Argument Description Format External computer domain Existing external computer domain name External computer name Existing externalcomputer name Local group name Existing local group name Example Delete an external computer named MyComputer from the NAS domain to a local group named groupA: CLI> access-control local-groups delet
PAGE 34
access-control local-groups delete-external-user Delete an external user from a local group. NOTE: To view a list of existing domains, use the command access-control domains-list.
PAGE 35
access-control local-groups list Display a list of the local groups. Format access-control local-groups list Example Display the current list of local groups: CLI> access-control local-groups list Output .------------------.--------------------.--------------.--------------------. | Group Name | LocalUsers | DomainUsers | DomainGroups | |------------------|--------------------|-------------|--------------------| | Administrators | .---.--------. | .---.---. | .--------.---.
PAGE 36
| | | o | | | | o | a | | | | N | | | | | m | | | | m | m | | | | a | | | | | a | | | | a | e | | | | m | | | | | i | | | | i | | | | | e | | | | | n | | | | n | | | |--------|---| | | | |---|--------| | |---|---| | '--------'---' | | | '---'--------' | '---'---' | | |------------------|--------------------|-------------|--------------------| | groupB | .---.--------. | .---.---. | .--------.---.
PAGE 37
Arguments Argument Description Format Local group name Existing local group name Option Description Format -Remarks Group description Text description of the group Options Example Display the settings for a local group named groupA: CLI> access-control local-groups view groupA Output Group Name LocalUsers = groupA = .-------------.-----------.
PAGE 38
Argument Description Format used as the last character of the account name.
PAGE 39
Option Description Format characters (for example, +, ?, and *) Example Change the password for a local user named user1 to Password123: CLI> access-control local-users change-password user1 -Password Password123 access-control local-users delete Delete a local user.
PAGE 40
Options Option Description Format -PrimaryGroupName Primary group of the local user (must be a local group) Existing local group name -Enabled Indicate whether the local user is Possible values are Yes, No enabled -PasswordNeverExpires Indicate whether the local user password will never expire Possible values are Yes, No -RealName Full user name Full name of existing user -Remarks User description Text description of us
PAGE 41
| user1 | groupA | Yes | No | '---------------'---------------'---------'-----------------------------' access-control local-users restore Restore local users from another FluidFS cluster.
PAGE 42
Output User Name Primary Group Enabled Password Is About To Expire Password Never Expires = = = = = user1 groupA Yes No Yes access-control local-users view-groups Display the groups to which a local user belongs.
PAGE 43
Argument Description Format underscores, hyphens, spaces, and periods. A period can not be used as the last character of the account name.
PAGE 44
access-control mapping manual add Add a user mapping rule between a Windows and UNIX user. NOTE: To view a list of existing domains, use the command access-control domains-list.
PAGE 45
Arguments Argument Description Format Domain of the Windows user Existing Windows domain Name of the Windows user Existing Windows user Name of the UNIX user Existing UNIX user Example Delete the user mapping rule between a Windows user named jsmith in the NAS domain and a UNIX user named johnf: CLI> access-control mapping manual delete NAS jsmith johnf access-control mapping manual edit Modify a user mapping rule between a Windows and UNIX u
PAGE 46
Example Modify the user mapping rule between a Windows user named jsmith in the NAS domain and a UNIX user named johns to use UNIX to Windows mapping: CLI> access-control mapping manual edit NAS john jsmith EnableUNIXToWindowsMapping Yes access-control mapping manual list Display a list of the user mapping rules between Windows and UNIX users.
PAGE 47
Arguments Argument Description Format FluidFS cluster name from where the manual mappings should be restored Existing FluidFS cluster name Example Restore manual user mappings from a FluidFS cluster named idffs1: CLI> access-control mapping manual restore idffs1 access-control mapping manual view Display a user mapping rule between a Windows and UNIX user. NOTE: To view a list of existing domains, use the command access-control domains-list.
PAGE 48
access-control mapping policy edit Modify user mapping policy settings.
PAGE 49
Options Option Description Format -DatabaseType Indicate which repository the FluidFS cluster is using Possible values are LDAP, NIS, None -NISDomain NIS domain Existing NIS domain -NISServers List of NIS servers Comma-separated list of existing NIS servers -LDAPBaseDN LDAP Base DN Existing LDAP Base DN -LDAPServers List of LDAP servers Comma-separated list of existing LDAP servers -LDAPFilters List of LDAP filters Comma-
PAGE 50
Example Display the current NIS/LDAP settings: CLI> access-control users-database view Output Database Type NisServers LDAP Base DN LdapServers LDAP Extended Schema LDAP Use Filters LDAP Filters LDAP Use TLS LDAP Use Not Anonymous LDAP Bind DN LdapUseCertificate LdapCertificate = = = = = = = = = = = = LDAP dc=nas,dc=test 172.22.144.4 No No No No cn=proxyuser,dc=example,dc=com No access-control users-list Display a list of users.
PAGE 51
Output .--------.--------.---------------------.---------------.---------.----------.
PAGE 52
Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command --Severity Filter according to the severity of the events --Period Filter according to the period of the events --ConsolidatedEventID Enter this option to get occurrences of consolidated events --HeadlineSubText Filter according to headline sub text.
PAGE 53
events auditing summary-list Display a list of system-consolidated events.
PAGE 54
Option Description --ConsolidatedEventID Enter this option to get occurrences of consolidated events --HeadlineSubText Filter according to headline sub text. Format Example Display a current list of the events: CLI> events system list Output .-----------.-----------.------------.----------.-------------.-------------.
PAGE 55
Option Description -Period Filter according to period of the events -HeadlineSubText Filter according to headline sub text Format Example Display a current list of the system— consolidated events: CLI> events system summary-list Output .----------.----------.-----------.---------.-----------.-------------------.
PAGE 56
Output Event ID Event Time Severity Workspace Headline 'user1' to Text = 115000112 = 30-Jul-14 12:35:41 = Info = System = The user Administrator has successfully added new Local User cluster repository = Description: The user Administrator has successfully added new Local 'user1' to cluster repository User hardware destroy-cluster destroy-and-change-model Destroy the FluidFS cluster and change the model code. CAUTION: This command should be used only by Dell Technical Support.
PAGE 57
Options Option Description -SanVIP San VIP which will be used to communicate with the cluster Format Example Add a fabric named FAB1 on the eth30 interface where the netmask is 255.255.255.0: CLI> hardware fabrics add FAB1 eth30 255.255.0.0 hardware fabrics fc list Display a list of the Fibre Channel fabrics. NOTE: This command is available only on 10GbE iSCSI FS8600 appliances.
PAGE 58
Arguments Argument Description Format Name of the Fibre Channel fabric Existing Fibre Channel fabric name Example Display details of a Fibre Channel fabric named SANa: CLI> hardware fabrics fc view SANa Output Name = SANa Interface = hba0 hardware fabrics iSCSI add Add an iSCSI fabric. NOTE: This command is available only on 10GbE iSCSI FS8600 appliances.
PAGE 59
Example Add an iSCSI fabric on the eth30 interface where the netmask is 255.255.255.0 and the NAS controller IP addresses are 192.11.18.10 and 192.11.18.11: CLI> hardware fabrics iSCSI add eth30 255.255.0.0 192.11.18.10,192.11.18.11 hardware fabrics iSCSI delete Delete the iSCSI fabric. NOTE: This command is available only on 10GbE iSCSI FS8600 appliances.
PAGE 60
Options Option Description Format -VLANTag VLAN ID of the fabric Whole positive number (1 to 4094) -Netmask Netmask of the iSCSI fabric IP address in x.x.x.x format -ControllersIPs NAS controller IP addresses Comma-separated list of IP addresses in x.x.x.x format Example For an iSCSI fabric named SANb, change the NAS controller IP addresses to 192.11.18.14 and 192.11.18.15: CLI> hardware fabrics iscsi edit SANb -ControllersIPs 192.11.18.14,192.11.18.
PAGE 61
Format hardware fabrics iSCSI-portals add-IPv4 Arguments Argument Description Format IPv4 address of the iSCSI storage IP address in IPv4 format Description for the IPv4 address of the iSCSI storage Any string Example Add the IPv4 address 172.22.158.167 to storage iSCSI portals with PortIP_172.22.158.167 and a description: CLI> hardware fabrics iSCSI-portals add-IPv4 172.22.158.167 port_172.22.158.
PAGE 62
hardware fabrics iSCSI-portals enable-authentication Enable authentication to storage iSCSI portals. NOTE: This command is available only on 10GbE iSCSI FS8600 appliances.
PAGE 63
Format hardware fabrics iSCSI-portals view Example Display the current settings of iSCSI portals: CLI> hardware fabrics iSCSI-portals view Output Use Authentication = No Username = IscsiPortals = .----------------.---------------------. | IP | Description | |----------------|---------------------| | 172.22.158.167 | port_172.22.158.167 | |----------------|---------------------| | 172.22.158.166 | port_172.22.158.166 | |----------------|---------------------| | 172.22.158.178 | port_172.22.158.
PAGE 64
hardware fabrics status-list Display a list of fabrics and their connectivity status to the storage. NOTE: This command is available only on 10GbE iSCSI FS8600i appliances. Format hardware fabrics status-list Example Display a current list of fabrics and their connectivity status to the storage: CLI> hardware fabrics status-list Output +--[SAN] | |- Overall Connectivity Status = Accessible | '- DetailedConnectivityStatus = .-----------.----------.-----------.---------.
PAGE 65
hardware NAS-appliances add-appliance Add a NAS appliance. NOTE: The NAS controllers in the new NAS appliance must be in standby mode and powered on. A NAS controller is on and in standby mode if the power LED is flashing green at around 2 flashes per second.
PAGE 66
hardware NAS-appliances blink-appliance Update the blinking status of a NAS appliance.
PAGE 67
Example Create a FluidFS cluster: CLI> hardware NAS-appliances create-cluster SingleController hardware NAS-appliances delete Delete an unjoined NAS appliance. Format hardware NAS-appliances delete Arguments Argument Description Format NAS appliance ID Existing NAS appliance ID Example Delete an unjoined NAS appliance with the ID 2: CLI> hardware NAS-appliances delete 2 hardware NAS-appliances detach-controller Detach a NAS controller.
PAGE 68
hardware NAS-appliances discovery list Display a list of discovered NAS appliances. Format hardware NAS-appliances discovery list Example Display a current list of discovered, undeployed NAS appliances: CLI> hardware NAS-appliances discovery list Output .-----------------------.---------------------------------------------------. | Appliance Service Tag | Controllers | |-----------------------|---------------------------------------------------| | 7DSS3V1 | .--------.----------.
PAGE 69
Output Appliance S = 7DSS3V1 Controllers = +--+- Address | |- Slot | |- ServiceTag | |- Version | |- Model | |- Controller ID | |- Is Clean | '- AllIPv6Addresses | '--+- Address |- Slot |- ServiceTag |- Version |- Model |- Controller ID |- Is Clean '- AllIPv6Addresses = = = = = = = = = = = = = = = = fe80::a236:9fff:fe03:134e 1 8DSS3V1 4.0.002838 FS8610i 7DSS3V1-1 Yes fe80::a236:9fff:fe03:134e, fe80::a236:9fff:fe03:134c fe80::a236:9fff:fe03:1492 2 9DSS3V1 4.0.
PAGE 70
Output .--------------.-------------------.-------------------.--------------------. | Appliance ID | Appliance Service | Is File System | Controllers | | | Tag | Member | | |--------------|-------------------|-------------------|--------------------| | 1 | 17XZSW1 | Yes | .------.-------.
PAGE 71
Options Option Description Format ‐‐CSV Displays the command output in Append ‐‐CSV to the command a comma‐delimited format with a header Example Display a list of lost NAS volumes: CLI> hardware restore-configuration-from-storage list-lost-volumes Output .------.----------. | Name | Size | |------|----------| | vol1 | 80.00MB | '------'----------' hardware restore-configuration-from-storage restoreconfiguration Restore the configuration from the storage.
PAGE 72
Example Restore lost NAS volumes: CLI> hardware restore-configuration-from-storage restore-lost-volumes hardware restore-configuration-from-storage restoreNAS-volumes Restore NAS volumes from the storage. CAUTION: This command should be used only by Dell Technical Support. This command is used as part of a disaster recovery scenario. Format hardware restore-configuration-from-storage restore-NAS-volumes hardware restore-configuration-from-storage restoreNAS-volumes Restore NAS volumes from the storage.
PAGE 73
Example Display a list of the current storage identifiers: CLI> hardware storage-identifiers list Output .------------------.----------------------.
PAGE 74
hardware storage-subsystem expand-NAS-pool Expand the NAS pool. Format hardware storage-subsystem expand-NAS-pool hardware storage-subsystem file-system-configuration edit Modify the file system storage configuration. Format hardware storage-subsystem file-system-configuration edit Arguments Argument Description Format -UnmapEnabled When releasing space in NAS volumes and NAS pool, make that space available for block volumes, using the SCSI TRIM command.
PAGE 75
hardware storage-subsystem rescan Trigger LUN discovery. Format hardware storage-subsystem rescan hardware storage-subsystem view Display the storage subsystem status. Format hardware storage-subsystem view Example Display the current storage subsystem status: CLI> hardware storage-subsystem view Output '--+- Name = Storage |- Luns Accessibility = Optimal '- Luns = +--+- ID | |- LUN Number | |- Reserved Size | |- Real Size | |- Status | |- Accessibility | |- Array Type | '- Controllers | | | | | | ...
PAGE 76
Arguments Argument Description Format NAS volume name Must have a maximum length of 230 characters, and may contain letters, numbers, spaces, and underscores. Control characters and commas are not allowed.
PAGE 77
Option Description Format -DataReductionFilesFilterType Indicate whether the files should pass to deduplication immediately or according to defined filters Possible values are AllFiles, AgeBased -AccessTimeGranularity Granularity of access time updates Possible values are Always, Daily, Never, Every5Minutes, EveryHour ionTime Indicate whether the snapshot EnableSnapshotSpaceConsumpti space consumptio
PAGE 78
NAS-volumes view Display NAS volume settings.
PAGE 79
| Network ID | |------------| '------------' Inode Distribution = No Keep redundant copy of metadata for improved resiliency = Yes NAS-volumes auditing-policy add Add an auditing policy for a volume.
PAGE 80
Arguments Argument Description Format NAS volume name Existing NAS volume name Name of the auditing policy Existing policy name Cluster ID for the auditing server Existing cluster ID Example Delete an auditing policy from a NAS volume: CLI> NAS-volumes auditing-policy delete vol1 policy1 NASCluster1 NAS-volumes auditing-policy edit Modify an auditing policy for a volume. You can change subscriber ID and the file-access operations listed in the policy.
PAGE 81
Example Modify an auditing policy for a NAS volume: CLI> NAS-volumes auditing-policy edit vol1 policy1 NASCluster1 WRITE,READ,SET_ATTRIBUTES,RENAME -Enable Yes NAS-volumes auditing-policy list Display a list of existing auditing policies.
PAGE 82
Output .-------------------.------------------.------------------.-----------------.
PAGE 83
NAS-volumes configuration-backups restoreconfiguration Restore NAS volume settings from another FluidFS cluster. Format NAS-volumes configuration-backups restore-configuration Arguments Argument Description Format Volume name Existing NAS volume name Configuration types that should be restored Comma-separated list of configuration types. Possible values are SMBshare, NfsExport, QuotaRule, and SnapshotSchedule.
PAGE 84
Argument Description Format Destination file name Length must be less than 230 characters Example Clone a file on a NAS volume named vol1 from /folder/file.pdf to /folder/filecopy.pdf: CLI> NAS-volumes clone file vol1 /folder/file.pdf /folder filecopy.pdf NAS-volumes clone volume Description Clone a NAS volume.
PAGE 85
Arguments Argument Description Format NAS volume name Existing NAS volume name Example Delete a NAS volume named vol3: CLI> NAS-volumes delete vol3 Output Confirmation: You are about to delete . All data stored on the NAS volume will be lost. Are you sure that you want to complete the operation? ( Yes / No ): NAS-volumes edit advanced-settings Modify the advanced settings of a NAS volume.
PAGE 86
Example Update access timestamps every hour for a NAS volume named vol1: CLI> NAS-volumes edit advanced-settings vol1 -AccessTimeGranularity Everyhour NAS-volumes edit data-reduction Modify the data reduction settings of a NAS volume.
PAGE 87
Example Enable data reduction on a NAS volume named vol1: CLI> NAS-volumes edit data-reduction vol1 -EnableDataReduction Yes NAS-volumes edit interoperability-policy Modify the interoperability policy of a NAS volume. If the interoperability policy is changed, it affects any new files or directories in the volume.
PAGE 88
Format NAS-volumes edit name Arguments Argument Description Format NAS volume name Existing NAS volume name New NAS volume name Must have a maximum length of 230 characters, and may contain letters, numbers, spaces, and underscores. Control characters and commas are not allowed. Example Rename a NAS volume from vol1 to vol2: CLI> NAS-volumes edit name vol1 vol2 NAS-volumes edit owner Modify the NAS volume owner.
PAGE 89
Format NAS-volumes edit space {options} Arguments Argument Description Format NAS volume name Existing NAS volume name Option Description Format -Size NAS volume size Floating point number with suffix of units (MB, GB, or TB) (for example, 100MB) -SpaceProvisioning Space provisioning type of the NAS volume Possible values are Thick, Thin -ReservedSpace Reserved space from the NAS volume Floating point number -EnableUsedSpaceThreshol
PAGE 90
NAS-volumes edit subnet-restrictions add-allowedsubnets Add allowed subnet to the NAS volume. Format NAS-volumes edit subnet-restrictions add-allowed-subnets Arguments Argument Description Format NAS volume name Existing NAS volume name Subnet network ID Example Add allowed subnet to NAS volume Vol2: CLI> NAS-volumes edit subnet-restrictions add-allowed-subnets Vol2 192.168.0.
PAGE 91
NAS-volumes edit subnet-restrictions limit-to-subnets Enable or disable NAS volume access restriction for specified subnets. NOTE: If home shares reside on the volume to be restricted, all users might lose access to their home shares if they are not accessing it through this subnet.
PAGE 92
Example Display the last day’s NAS volumes statistics for a NAS volume named vol3: CLI> NAS-volumes list capacity-over-time last-day vol3 Output .-------.----------.---------.--------.---------------.-----------------.--------------. | Volume| Time | Size | Used | Unused | Unused Uneserved| Over Committed| | Name | | | Space | Reserved Space| Space | Space | |-------|----------|---------|--------|---------------|-----------------|--------------| | vol3 | 09-Aug-14| 20.00 MB| 0.00 MB| 0.00 MB | 19.
PAGE 93
Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display the last month's NAS volumes statistics for a NAS volume named vol3: CLI> NAS-volumes list capacity-over-time last-month vol3 Output .-------.-----------.---------.----------.----------.-----------.--------------.
PAGE 94
Arguments Argument Description Format NAS volume name Existing NAS volume name Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Options Example Display the last week's NAS volumes statistics for a NAS volume named vol3: CLI> NAS-volumes list capacity-over-time last-week vol3 Output .------------.----------.--------.----------.---------.-----------.----------.
PAGE 95
Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display the last year’s NAS volumes statistics for a NAS volume named vol3: CLI> NAS-volumes list capacity-over-time last-year vol3 Output .-----------.----------.---------.-----------.---------.----------.----------.
PAGE 96
Example Display the current NAS volumes statistics for a NAS volume named vol3: CLI> NAS-volumes list capacity-over-time now vol3 Output .------------.----------.---------.---------.----------.----------.-------------. | Volume Name| Time | Size |Used Space| Unused | Unused |Over Committed| | | | | | Reserved| Uneserved| Space | | | | | | Space | Space | | |------------|----------|---------|----------|---------|----------|-------------| | vol3 | 09-Aug-13| 20.00 MB| 0.00 MB | 0.00 MB | 19.00 MB | 0.
PAGE 97
Example Display a list of cloned NAS volumes: CLI> NAS-volumes list clones Output .--------------.-------------.--------------.-------------. | Cloned Volume| Base Volume | Base Snapshot| Base Volume | | Name | Name | Name | Space Status| |--------------|-------------|--------------|-------------| | clonevol3 | vol3 | vol3snap | Warning | '--------------'-------------'--------------'-------------' NAS-volumes list data-reduction List of NAS volumes with their data reduction information.
PAGE 98
--------------| | svol3 | Yes | De-duplication | No | 0.00 MB | 0% | |-------|---------------|-----------------|------------------|---------------|---------------| NAS-volumes list snapshots Description List NAS volumes with their snapshot space consumption.
PAGE 99
Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display a list of the NAS volumes with their current space information: CLI> NAS-volumes list space Output .-------.---------.----------.---------.--------------.-------------.---------------.------.
PAGE 100
Options Option Description -EnableSmb -RemoteSmbShare Format Yes or No Name of the share for the remote Must not be empty when SMB corresponding flag is enabled -EnableNFS Yes or No -RemoteNfsExport Must not be empty when corresponding flag is enabled Example Enable Namespace Aggregation on a a NAS volume named vol1: CLI> NAS-volumes Namespace-Aggregation add vol1 NAS-volumes Namespace-Aggregation create-folder Create a redirection folder on a volume.
PAGE 101
NAS-volumes Namespace-Aggregation delete Delete a redirection folder from a volume. Format NAS-volumes Namespace-Aggregation delete Arguments Argument Description Format NAS volume name Existing NAS volume name Path to an existing volume Example Delete /folder1 on a NAS volume named vol2: CLI> NAS-volumes Namespace-Aggregation delete vol2 /folder1 NAS-volumes Namespace-Aggregation edit Edit namespace aggregation settings on a NAS volume.
PAGE 102
Example Edit Namespace Aggregation settings on a a NAS volume named vol2: CLI> NAS-volumes Namespace-Aggregation edit vol2 NAS-volumes Namespace-Aggregation edit-by-dsid Edit namespace aggregation settings on a NAS volume by dataset identifier (DSID).
PAGE 103
Arguments Argument Description Format NAS volume name Existing NAS volume name Example List the redirection folders on a NAS volume named vol2: CLI> NAS-volumes Namespace-Aggregation list vol2 NAS-volumes Namespace-Aggregation view View the redirection folders that exist on a volume.
PAGE 104
Example View namespace aggregation settings on a NAS volume named vol1 by DSID: CLI> NAS-volumes Namespace-Aggregation view-by-dsid vol1 NAS-volumes NAS-pool capacity-overtime last-day Display the last day's NAS pool statistics.
PAGE 105
Arguments Argument Description Format NAS volume name Existing NAS volume name Dataset identification Allows working with entries that cannot be resolved to valid directories (for example, due to cache loss) Example View namespace aggregation settings on a NAS volume named vol1 by DSID: CLI> NAS-volumes Namespace-Aggregation view-by-dsid vol1 NAS-volumes NAS-pool capacity-overtime last-month Display the last month's NAS pool statistics.
PAGE 106
NAS-volumes NAS-pool capacity-overtime last-week Display the last week’s NAS pool statistics. Format NAS-volumes NAS-pool capacity-overtime last-week Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display the last week’s NAS pool statistics: CLI> NAS-volumes NAS-pool capacity-overtime last-week Output .-------------------.--------.---------.----------------.-----------------.
PAGE 107
Example Display the last year's NAS pool statistics: CLI> NAS-volumes NAS-pool capacity-overtime last-year Output .-------------------.---------.--------.----------------.------------------. | Time | Capacity| Used | Unused Reserved| Unused Unreserved| |-------------------|---------|--------|----------------|------------------| | 16-May-13 13:54:02| 1.70 TB | 1.00 MB| 41.00 MB | 1.70 TB | |-------------------|---------|--------|----------------|------------------| | 02-May-13 00:00:00| 0.00 MB | 0.
PAGE 108
Example Change the NAS pool used space alert threshold percent to 90%: CLI> NAS-volumes NAS-pool configuration edit -UsedSpaceAlertThresholdPercent 90 NAS-volumes NAS-pool configuration view Description Display NAS pool settings.
PAGE 109
Total Over Committed Total Optimization Saved Space Total Optimization Saved Space Percent Number Of NAS Volumes Number Of NAS Volumes With Snapshots Number Of NAS Volumes With Replication Number Of NAS Volumes With Data Reduction Number Of Cloned Volumes = = = = = = = = 0.00 MB 0.00 MB 0 5 2 0 0 1 NAS-volumes nfs-export select access create Create the user access to the NFS export.
PAGE 110
Arguments Argument Description Format NFS export name Maximum length of 255 characters, and can contain letters, numbers, and underscores. The name must start with a letter.
PAGE 111
Option Description Format -Report32bitInode Indicate whether the NFS export Possible values are Yes, No reports 32-bit inode to the clients Example Add an NFS export named export1 to a NAS volume named vol2 at the path /folder: CLI> NAS-volumes NFS-exports add export1 vol2 /folder NAS-Volumes nfs-export select access show Display a list of all the ACLs on a particular NFS export.
PAGE 112
Example Add an ACL for all clients accessing a read-write NFS export named export1 on a NAS volume named vol2 with a trust type of EveryoneExceptRoot: CLI> NAS-volumes NFS-exports add-acl for-all-clients vol2 export1 EveryoneExceptRoot Yes NAS-volumes NFS-exports add-acl for-clients-innetgroup Add an ACL (access control list) for all clients in a netgroup accessing an NFS export.
PAGE 113
Arguments Argument Description Format NAS volume name Existing NAS volume name NFS export name Existing NFS export name Network ID of the clients to which this NFS export should be available IP address in IPv6 or IPv4 format Network prefix length of the clients to which this NFS export should be available An integer (up to 30 for IPv4, up to 126 for IPv6).
PAGE 114
Example Add an ACL for a single client with the IP address 172.22.69.18 accessing a read-write NFS export named export1 on a NAS volume named vol2 with a trust type of Everyone: CLI> NAS-volumes NFS-exports add-acl for-single-client vol2 export1 172.22.69.18 Everyone Yes NAS-volumes NFS-exports create-folder Description Create a new folder for an NFS export.
PAGE 115
Arguments Argument Description Format NAS volume name Existing NAS volume name NFS export name Existing NFS export name Example Delete an NFS export named export1 from a NAS volume named vol2: CLI> NAS-volumes NFS-exports delete vol2 export1 NAS-volumes NFS-exports delete-acl for-all-clients Delete an ACL for all clients accessing an NFS export.
PAGE 116
Arguments Argument Description Format NAS volume name Existing NAS volume name NFS export name Existing NFS export name Clients netgroup to which this NFS export should be available Existing netgroup name Type of users to which this NFS export should be available Possible values are Nobody, Everyone, EveryoneExceptRoot Example Delete an ACL for all clients in a netgroup named group1 accessing an NFS export named export1 on a NAS volume named v
PAGE 117
Example Delete an ACL for all clients in the subnet 172.22.69.0 /24 accessing an NFS export named export1 on a NAS volume named vol2 with a trust type of Everyone: CLI> NAS-volumes NFS-exports delete-acl for-clients-in-subnet vol2 export1 172.22.69.0 24 Everyone NAS-volumes NFS-exports delete-acl for-single-client Delete an ACL for a single client accessing an NFS export.
PAGE 118
Options Option Description Format -EnableLimitReportedSize Indicate whether it is required to limit the reported size Possible values are Yes, No -LimitReportedSize Limited reported size Floating point number with suffix of units (for example, 100MB) -RequireSecurePort Indicate whether it is required to use a secure port Possible values are Yes, No -Comment Comment for the NFS export Any string -UnixStyle
PAGE 119
NAS-volumes NFS-exports list Display a list of NFS exports. Format NAS-volumes NFS-exports list {options} Options Option Description Format -VolumeName NAS volume name Existing NAS volume name --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display a current list of NFS exports: CLI> NAS-volumes NFS-exports list Output .---------------------------.-------------.-------------------.---------.
PAGE 120
Output Export Name = export1 Volume Name = vol2 Path = /folder Enable Limit Reported Size = No Limit Reported Size = 0.00 MB Require Secure Port = Yes Comment = Sys = Yes Krb5 = Yes Krb5i = Yes Krb5p = Yes Report32bitInode = Yes AccessDetails = .--------------------.------------------.------------------.----------.--------------------.
PAGE 121
Example Change a directory into a quota directory on a NAS volume named vol1 and limit the quota to 2 GB: CLI> NAS-volumes quota directory add vol1 /volume2 -isquotalimited yes hardlimit 2GB NAS-volumes quota directory create-folder Create a new folder on a NAS volume. NOTE: Run the NAS-volumes quota directory add command on this folder before adding any subdirectories or files in the newly created folder.
PAGE 122
NAS-volumes quota directory edit Modify a quota directory on a NAS volume.
PAGE 123
Example Display a current list of quota directories on a NAS volume named jvol1: CLI> NAS-volumes quota directory list jvol1 Output CLI/NAS-volumes/quota/directory> list jvol1 .--------.-------.------------.-----------.---------.-----------.---------. | Volume | Path | Is Required| Soft Limit| Is Quota| Hard Limit| Usage | | Name | | Alert | | Limited | | | |--------|-------|------------|-----------|---------|-----------|---------| | jvol1 | /Qdir2| No | 0.00 MB | Yes | 1.00 GB | 0.
PAGE 124
IsQuotaLimited Hard Limit Usage = Yes = 1.00 GB = 0.00 MB NAS-volumes quota rules groups add Add a group quota rule on a NAS volume. NOTE: To view a list of existing domains, use the command access-control domains-list.
PAGE 125
NAS-volumes quota rules groups default edit Modify the default rule for the group quota for a NAS volume.
PAGE 126
Arguments Argument Description Format NAS volume name Existing NAS volume name Example Display the current default group quota settings for a NAS volume named vol1: CLI> NAS-volumes quota rules groups default view vol1 Output Name Default Default Default Default Group Group Group Group Quota Quota Quota Quota Is Required Alert Soft Limit Is Quota Limited Hard Limit = = = = = vol1 No 0 Yes 50 NAS-volumes quota rules groups delete Description Delete a group quota rule from a NAS volume.
PAGE 127
NAS-volumes quota rules groups delete-by-group-ID Description Delete a group quota rule from a NAS volume using the group ID.
PAGE 128
Options Option Description -IsRequiredAlert Indicate whether the soft quota is Possible values are Yes, No enabled -SoftLimit Soft quota limit Floating point number with suffix of units (for example, 100MB) -IsQuotaLimited Indicate whether the hard quota is enabled Possible values are Yes, No -HardLimit Hard quota limit Floating point number with suffix of units (for example, 100MB) Example Change the hard quota to 60 MB for a group nam
PAGE 129
Output .----------.----------.----------.----------.----------.----------.----------. | Volume | Group | Group | Is | Soft | Is Quota | Hard | | Name | Domain | Name | Required | Limit | Limited | Limit | | | | | Alert | | | | |----------|----------|----------|----------|----------|----------|----------| | vol1 | idffs2 | groupA | No | 0.00 MB | Yes | 50.
PAGE 130
NAS-volumes quota usage groups list Description Display a list of groups usage on a NAS volume. Format NAS-volumes quota usage groups list {options} Options Option Description Format -VolumeName NAS volume name Existing NAS volume name --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display a current list of groups usage on a NAS volume named vol1: CLI> NAS-volumes quota usage groups list -VolumeName vol1 Output .
PAGE 131
Arguments Argument Description Format NAS volume name Existing NAS volume name Group domain Existing group domain Group name Existing group name Example Display the usage of a group named groupA in a domain named idffs2 on a NAS volume named vol1: CLI> NAS-volumes quota usage group view vol1 idffs2 groupA Output Volume Name Group Domain Group Name Usage = = = = vol1 idffs2 groupA 50.
PAGE 132
NAS-volumes quota usage group view-effective-rules Description Display the effective quota rules for a group on a NAS volume. NOTE: To view a list of existing domains, use the command access-control domains-list.
PAGE 133
Options Option Description Format -VolumeName NAS volume name Existing NAS volume name --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display a current list of users usage for a NAS volume named vol1: CLI> NAS-volumes quota usage users list -VolumeName vol1 Output .-------------.-------------.---------------.---------.
PAGE 134
Output Volume Name User Domain User Name Usage = = = = vol1 idffs2 user1 5.00 MB NAS-volumes quota usage users view-by-id Display the usage of a user on a NAS volume by user ID. NOTE: To view a list of existing domains, use the command access-control domains-list.
PAGE 135
Arguments Argument Description Format NAS volume name Existing NAS volume name User domain Existing user domain User name Existing user name Example Display the effective quota rules for a user named user1 in a domain named idffs2 on a NAS volume named vol1: CLI> NAS-volumes quota usage users view-effective-rules vol1 idffs2 user1 Output Volume Name User Domain User Name Is User Soft Quota Enabled User Soft Quota Is User Hard Quota Enabled User Hard Quota Gr
PAGE 136
Options Option Description Format -IsRequiredAlert Indicate whether the soft quota is Possible values are Yes, No enabled -SoftLimit Soft quota limit Floating point number with suffix of units (for example, 100MB) -IsQuotaLimited Indicate whether the hard quota is enabled Possible values are Yes, No -HardLimit Hard quota limit Floating point number with suffix of units (for example, 100MB) Example Add a 50 MB hard quota user quota rule
PAGE 137
Option Description -DefaultUserQuotaHardLimit Hard quota limit Floating point number with suffix of units (for example, 100MB) Example Add a hard quota of 10 MB for a NAS volume named vol1: CLI> NAS-volumes quota rules users default edit vol1 DefaultUserQuotaIsQuotaLimited Yes -DefaultUserQuotaHardLimit 10MB NAS-volumes quota rules users default view Description Display default user quota settings for a NAS volume.
PAGE 138
Format NAS-volumes quota rules users delete Arguments Argument Description Format NAS volume name Existing NAS volume name User domain Existing user domain User name Existing user name Example Delete a user quota rule for a user named user1 in the idffs2 domain on a NAS volume named vol1: CLI> NAS-volumes quota rules users delete vol1 idffs2 user1 NAS-volumes quota rules users delete-by-user-ID Description Delete a user
PAGE 139
NOTE: To view a list of existing domains, use the command access-control domains-list.
PAGE 140
Arguments Argument Description Format NAS volume name Existing NAS volume name Group domain Existing group domain Group name Existing group name Option Description Format -IsRequiredAlert Indicate whether the soft quota is Possible values are Yes, No enabled -SoftLimit Soft quota limit Floating point number with suffix of units (for example, 100MB) -IsQuotaLimited Indicate whether the hard quota is ena
PAGE 141
Example Delete a hard quota rule for any users in a group named groupA in a domain named idffs2 on a NAS volume named vol1: CLI> NAS-volumes quota rules users-in-groups delete vol1 idffs2 groupA NAS-volumes quota rules users-in-groups delete-bygroup-ID Description Delete a quota rule for users in a group from a NAS volume using the group ID.
PAGE 142
Arguments Argument Description Format NAS volume name Existing NAS volume name Group domain Existing group domain Group name Existing group name Option Description Format -IsRequiredAlert Indicate whether the soft quota is Possible values are Yes, No enabled -SoftLimit Soft quota limit Floating point number with suffix of units (for example, 100MB) -IsQuotaLimited Indicate whether the hard quota is ena
PAGE 143
Example Display a current list of quota rules for any users in groups for a NAS volume: CLI> NAS-volumes quota rules users-in-groups list Output .----------.----------.----------.----------.----------.----------.----------. | Volume | Group | Group | Is | Soft | Is Quota | Hard | | Name | Domain | Name | Required | Limit | Limited | Limit | | | | | Alert | | | | |----------|----------|----------|----------|----------|----------|----------| | vol1 | idffs2 | groupA | No | 0.00 MB | Yes | 65.
PAGE 144
NAS-volumes quota rules users list Description Display a list of user quota rules. Format NAS-volumes quota rules users list {options} Options Option Description Format -VolumeName NAS volume name Existing NAS volume name --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display a current list of the user quota rules: CLI> NAS-volumes quota rules users list Output .----------.----------.----------.----------.----------.
PAGE 145
Arguments Argument Description Format NAS volume name Existing NAS volume name User domain Existing user domain User name Existing user name Example Display the current settings for a user quota rule for a user named user1 in the idffs2 domain on a NAS volume named vol1: CLI> NAS-volumes quota rules users view vol1 idffs2 user1 Output Volume Name User Domain User Name Is Required Alert SoftLimit Is Quota Limited Hard Limit = = = = = = = vol1 idffs2 user1 N
PAGE 146
Option Description Format retention period in days (integer) is used.
PAGE 147
Arguments Argument Description Format Source NAS volume name Existing NAS volume name Destination FluidFS cluster name Existing FluidFS cluster name Destination NAS volume name Existing NAS volume name Example Demote a destination NAS volume named voldest where the source NAS volume is named volsource and the destination FluidFS cluster name is idffs2: CLI> NAS-volumes replication demote volsource idffs2 voldest Output Confirmation: Changes on
PAGE 148
NAS-volumes replication disconnect Description Disconnect the source NAS volume from the destination NAS volume. NOTE: Before you can disconnect a source NAS volume, the destination NAS volume must be promoted using the command NAS-volumes replication promote.
PAGE 149
Example Enable the replication between a source NAS volume named volsource and a destination NAS volume named voldest where the remote FluidFS cluster name is idffs2: CLI> NAS-volumes replication enable volsource idffs2 voldest NAS-volumes replication list-destination Display a list of replications for destination NAS volumes.
PAGE 150
NAS-volumes replication list-source Display a list of replications for source NAS volumes. Format NAS-volumes replication list-source Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display a current list of replications for source NAS volumes: CLI> NAS-volumes replication list-source Output .---------.-------------.------------.---------.------.------.---------.----------.---------.-------.---------.
PAGE 151
Arguments Arguments Description Format Source NAS volume name Existing NAS Destination FluidFS cluster name Existing FluidFS cluster name Destination NAS volume name Existing NAS volume name Snapshot retention policy Options Option Description Format (default 30 days) NAS-volumes replication promote Description Promote the destinati
PAGE 152
Format NAS-volumes replication schedules add {options} Arguments Argument Description Format Source NAS volume name Existing NAS volume name Destination FluidFS cluster name Existing FluidFS cluster name Destination NAS volume name Existing NAS volume name Replication schedule name Maximum of 230 characters, and may contain letters, numbers, and underscores
PAGE 153
NAS-volumes replication schedules delete Description Delete a replication schedule.
PAGE 154
Options Option Description Format -ScheduleType Replication schedule type Possible values are Periodic, SpecificTime -Period Interval between replications in periodic policy. This option is relevant only for ScheduleType Periodic. Whole positive number -Days List of days in which the Possible values are Sunday, replication will start. This option Monday, Tuesday, Wednesday, is relevant only for ScheduleType Thursday, Friday, or Saturday SpecificTime.
PAGE 155
Example Display a current list of replication schedules: CLI> NAS-volumes replication schedules list Output .--------------.-------------.---------------.---------------.---------------.
PAGE 156
Output Schedule Name Volume Name Remote Cluster Name Remote Volume Name Frequency = = = = = repsched1 volsource idffs2 voldest Sunday at 20:00 NAS-volumes replication set-QOS Set QoS (quality of service) replication for a volume.
PAGE 157
NAS-volumes replication start Start the replication from source to destination NAS volumes.
PAGE 158
Output Role = Source Volume Name = jvol1 Remote Cluster Name = cplsup3 Remote Volume Name = jvol1-replica Achieved Recovery Point = 10-Dec-14 14:52:06 Target Recovery Point = 10-Dec-14 14:52:06 Status = Idle Error = None Next Recovery Point = Seconds To Complete = Transferred MB = Snapshot Retention Policy= Archive Snapshot Retention period in Days = 10 The amount of resources on source and destination = Same CLI/NAS-volumes/replication> NAS-volumes SMB-shares add Add an SMB share to a NAS volume.
PAGE 159
Option Description Format -EnableAvExcludeDirsFilters Indicate whether to exclude specified directories from antivirus scanning Possible values are Yes, No -AvExcludeDirs Directories to exclude from antivirus scanning Any string -AvMaxFileSizeForScanning Maximum size of files that will be sent for antivirus scanning Floating point number with suffix of units (for example, 100MB) -AvDenyAccessLargeUnscannedFiles
PAGE 160
NAS-volumes SMB-shares add-exclude-group Add an exclude group for extensions filter of an SMB share. Members of this group are not restricted in the types of files they can save on the SMB share. Format NAS volumes SMB-shares add-exclude-group Arguments Argument Description SMB share name Group domain. The available domains are displayed by the domains-list command.
PAGE 161
NAS-volumes SMB-shares create-folder Create a folder in a volume. This folder can then be used for an SMB share. Format NAS-volumes SMB-shares create-folder Arguments Argument Description Format NAS volume name Existing NAS volume name Parent folder under the NAS volume Existing parent folder Name of the new folder Less than 255 characters and cannot contain the following characters: < > " \ | ? *.
PAGE 162
NAS-volumes SMB-shares delete-exclude-group Delete exclude group for extensions filter of SMB share. After executing this command, members of this group will have to conform to the restrictions on which types of files can be written to the volume. Only new writes or renames by group members are affected. Format NAS volumes SMB-shares delete-exclude-group Arguments Argument Description SMB share name Group domain.
PAGE 163
NAS-volumes SMB-shares delete-share-level-permissionby-sid Delete share-level permission from SMB share by SID. Format NAS volumes SMB-shares delete-share-level-permission-by-sid Arguments Argument Description SMB share name Share ID Format NAS-volumes SMB-shares edit Modify SMB share settings.
PAGE 164
Option Description Format -AvExcludeDirs Directories to exclude from antivirus scanning Any string -AvMaxFileSizeForScanning Maximum size of files that will be sent for antivirus scanning Floating point number with suffix of units (for example, 100MB) -AvDenyAccessLargeUnscannedFiles Indicate whether access to files Possible values are Yes, larger than the defined size will be No denied -AccessBasedEnumeration
PAGE 165
NAS-volumes SMB-shares general-settings view Display the general settings for the SMB protocol.
PAGE 166
Option Description Format -AvExtensions File extensions to exclude from antivirus scanning Any string -EnableAvExcludeDirsFilters Indicate whether to exclude Possible values are specified directories from antivirus Yes, No scanning -AvExcludeDirs Directories to exclude from antivirus scanning Any string -AvMaxFileSizeForScanning Maximum size of files that will be sent for antivirus scanning Floating point num
PAGE 167
NAS-volumes SMB-shares home-share enable Enable SMB home shares on a NAS volume.
PAGE 168
Is Required Message Encryption = No Enable file extension filter = No Deny creation of files with these extensions = Enable excluding groups from file extension filter = No Allow creation of any file to = .--------------.-------------. |Group Domain | Group Name | .--------------.-------------. | | | .--------------.-------------. Enable automatic home folder creation = Yes Contionuous availability for file handles = No NAS-volumes SMB-shares list Display a list of SMB shares.
PAGE 169
Arguments Argument Description Format SMB share name Existing SMB share name Example Display the current settings for an SMB share named share: CLI> NAS-volumes SMB-shares view share Output Volume Name = vol2 Share Name = jshare1 Path = /folder1 Comment = Antivirus = No Enable Antivirus Extensions Filters = No AvExtensions = Enable Antivirus Exclude Dirs Filters = No AvExcludeDirs = Antivirus Max File Size For Scanning = 1.
PAGE 170
Argument Description Format commas, and so on are not allowed. Example Add a snapshot named snap1 for a NAS volume named vol1: CLI> NAS-volumes snapshots add vol1 snap1 NAS-volumes snapshots delete Delete a snapshot from a NAS volume.
PAGE 171
NAS-volumes snapshots list Display a list of snapshots. Format NAS-volumes snapshots list Arguments Argument Description Format NAS volume name Existing NAS volume name --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display a list of the current snapshots on a NAS volume named vol1: CLI> NAS-volumes snapshots list vol1 Output .-------------.---------------.--------------------.
PAGE 172
Argument Description Format commas, and so on are not allowed. Example Rename a snapshot named snap1 to snapa on a NAS volume named vol1: CLI> NAS-volumes snapshots rename vol1 snap1 snapa NAS-volumes snapshots restore Restore a NAS volume to a snapshot. NOTE: All data written to the volume after the snapshot was taken will be deleted from the volume.
PAGE 173
Options Option Description Format -EnableRetention Indicate whether the retention policy is enabled Possible values are Yes, No -RetentionPeriod Retention period of snapshots created by this policy An integer number with suffix of units H/D/W (hours, days, or weeks) (for example, 10H) -Period Interval between snapshots in periodic policy. This option is relevant only for ScheduleType Periodic.
PAGE 174
Example Delete a snapshot schedule named snapsched1 from a NAS volume named vol1: CLI> NAS-volumes snapshots schedules delete vol1 snapsched1 NAS-volumes snapshots schedules edit Modify a snapshot schedule.
PAGE 175
Option Description Format -Minute Interval between snapshots in periodic policy. This option is relevant only for ScheduleType Periodic. Zero-based, whole positive number (0 to 59) Example Modify a snapshot schedule named snapsched1 on a NAS volume named vol1 to retain snapshots for 12 hours: CLI> NAS-volumes snapshots schedules edit vol1 snapsched1 -EnableRetention Yes RetentionPeriod 12H NAS-volumes snapshots schedules list Display a list of snapshot schedules.
PAGE 176
NAS-volumes snapshots schedules view Display snapshot schedule settings.
PAGE 177
Example Set a snapshot expiration date of 25-Aug-13 23:09:34 for a snapshot named snap1 on a NAS volume named vol1: CLI> NAS-volumes snapshots set-expiry vol1 snap1 "25-Aug-13 23:09:34" NAS-volumes snapshots view Display snapshot information.
PAGE 178
Arguments Argument Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Client or router IP address Existing client or router IP address in IPv6 or IPv4 format Client VIP to which the client or router was accessed Existing client VIP IP address in IPv6 or IPv4 format Example Display sessions of connection with the IP address 172.22.69.18 using client VIP 172.22.69.
PAGE 179
Output .-----------.---------.----------.--------------.----------.-------------------. | Controller| Session | Session | DMA IP | Session | Session Start Time| | Id | Id | Type | | Path | | |-----------|---------|----------|--------------|----------|-------------------| | 1 | 151691 | Restore | 172.41.200.70| /volume2 | 03-Jun-13 11:25:14| '-----------'---------'----------'--------------'----------'-------------------' networking active-ndmp-sessions logoff Abort an active NDMP session.
PAGE 180
Example Display information about an active NDMP session (job) on NAS controller 1 with the job ID 150471: CLI> networking active-ndmp-sessions view 1 150471 Output Controller ID Session ID Session Type DMA IP Session Path Session Start Time = = = = = = 1 150471 Backup 172.41.200.70 /volume2 03-Jun-13 11:17:25 networking active-view-NFS-sessions Display information about an active NFS session.
PAGE 181
networking active-sessions list-idle-sessions Display a list of active SMB and NFS sessions.
PAGE 182
Arguments Argument Description Format -FilterByOpenFIles Displays sessions with a number Integer (50 or larger) of open files larger than specified value Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display a list of sessions with many open files: CLI> networking active-sessions list-sessions-with-many-open-files Output .----------.--------.--------------.--------.--------.
PAGE 183
Example Disconnect an active NFS session for session 150471 on the computer win2k8d-m380.lab.town using NAS controller 1: CLI> networking active-sessions logoff-NFS-sessions logoff -ClientComputerName 1 win2k8d-m380.lab.town networking active-sessions logoff-NFS-session-by-ID Disconnect an active NFS session by session ID.
PAGE 184
Example Disconnect an active SMB session for the user idffs2\user1 on the computer win2k8d-m380.lab.town using NAS controller 1: CLI> networking active-sessions logoff-SMB-sessions -ClientComputerName 1 win2k8d-m380.lab.town -UserName idffs2\user1 networking active-sessions logoff-SMB-session-by-ID Disconnect an active SMB session by session ID.
PAGE 185
Example Display a list of the current active sessions: CLI> networking active-sessions list Output .--------.-------.-------------.----------.------.-----.-------.--------.-----. |Protoc | Contro| NFS Session |User | Comput| # |Connec| Idle |Guest| |ol | ller | Id | | er | Open |ted | Time | | | | Id | | | | Files|Time | | | |-------|-------|-------------|----------|-------|------|------|--- ----|-----| |SMB 3.0| 0 | N/A | IDC\jona | 10.48.| 1 |21:14:| 19:00: | No | | | | | thans | 29.
PAGE 186
Idle Time Guest = 00:00:00 = No networking client-load-balancing list Display a list of clients on the same subnet as the FluidFS cluster (in other words, clients in a flat network) and routers. Clients that access the FluidFS cluster through a router cannot be listed. From the perspective of the FluidFS cluster, it appears that the communication is directly with the router.
PAGE 187
networking client-load-balancing list-sessions-ofconnection Display sessions of connection.
PAGE 188
networking client-load-balancing mass-rebalance Rebalance all the clients between the NAS controllers. NOTE: Clients that are moved between controllers will experience a brief disconnection. Format networking client-load-balancing mass-rebalance networking client-load-balancing move Move a client or router to a required NAS controller.
PAGE 189
Arguments Argument Description Format Client or router IP address Existing client or router IP address in the format: x.x.x.x Client VIP to which the client or router was accessed Existing client VIP IP address in the format: x.x.x.
PAGE 190
networking client-load-balancing view Display information about a client on the same subnet as the FluidFS cluster (in other words, a client in a flat network) or a router. Clients that access the FluidFS cluster through a router cannot be viewed. From the perspective of the FluidFS cluster, it appears that the communication is directly with the router.
PAGE 191
Options Option Description Format -Mode Bonding module type of the client network interface Possible values are ALB, LACP -MTU MTU of the client network interface Whole positive number (1 to 9000) Example Change the mode of the client network interface to LACP: CLI> networking client-network-interface edit -Mode LACP networking client-network-interface view Display the settings of the client network interface.
PAGE 192
Example Add a default gateway with the IP address 172.22.69.1: CLI> networking default-gateway add 172.22.69.1 networking default-gateway delete Delete the default gateway. Format networking default-gateway delete Example Delete the current default gateway: CLI> networking default-gateway delete networking default-gateway edit Modify the default gateway.
PAGE 193
Example View the current default gateway: CLI> networking default-gateway view Output Gateway IP = 172.22.69.1 networking DNS edit Modify DNS settings. Format networking DNS edit {options} Options Option Description Format -DNSServers Comma-separated list of DNS servers IP addresses in IPv6 or IPv4 format -DNSSuffixes Comma-separated list of DNS suffixes A DNS suffix must be a fully qualified domain name (FQDN). Example Change the DNS server to 172.20.65.
PAGE 194
networking monitor external-servers-states list Display a list of external servers and their accessibility status. Format networking monitor external-servers-states list Options Option Description Format --CSV Display the command output in a Append --CSV to the command comma‑delimited format with a header Example Display a current list of external servers and their accessibility status: CLI> networking monitor external-servers-states list Output .--------------------.---------.-------------.
PAGE 195
Argument Description Format hyphens, but cannot start or end in a hyphen. Type of external server Possible values are GATEWAY, STATIC_ROUTE, DNS, ANTIVIRUS, MAIL_RELAY, NIS, LDAP, DMA_SERVER, TRAP_RECIPIENTS, NTP, ISCSI_PORTAL Example Display the accessibility status of an NTP server named time.lab.town: CLI> networking monitor external-servers-states view time.lab.town NTP Output Host = time.lab.
PAGE 196
| | | ) | ) | sec | sec | sec | sec | (pe| (pe | Rea | teM | r | | | | | | ) | ) | ) | ) | r | r | d | BsP | sec | | | | | | | | | | sec| sec | (pe | erS | ) | | | | | | | | | | ) | ) | r | ec | | | | | | | | | | | | | sec | | | | | | | | | | | | | | ) | | | |----|-----|-----|-----|-----|-----|-----|-----|----|-----|-----|-----|-----| | 0 | 05- | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0| 0.0 | 0.0 | 0.0 | 0.
PAGE 197
| | | | | | | | | | | sec | | | | | | | | | | | | | | ) | | | |----|-----|-----|-----|-----|-----|-----|-----|----|-----|-----|-----|-----| | 0 | 05- | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0| 0.0 | 0.0 | 0.0 | 0.
PAGE 198
| | Aug | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | | | -14 | MB | MB | MB | MB | MB | MB | MB | MB | MB | MB | MB | | | 11: | | | | | | | | | | | | | | 30: | | | | | | | | | | | | | | 23 | | | | | | | | | | | | |----|-----|-----|-----|-----|-----|-----|-----|----|-----|-----|-----|-----| | 1 | 05- | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0| 0.0 | 0.0 | 0.0 | 0.
PAGE 199
| | 50 | | | | | | | | | | | | |----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| | 1 | 10- | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0| 0.0 | 0.0 | 0.0 | 0.0 | | | Dec | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | | | -14 | MB | MB | MB | MB | MB | MB | MB | MB | MB | MB | MB | | | 11: | | | | | | | | | | | | | | 33: | | | | | | | | | | | | | | 50 | | | | | | | | | | | | |----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| ...[snip]...
PAGE 200
| | -14 | MB | MB | MB | MB | MB | MB | MB | MB | MB | MB | MB | | | 11: | | | | | | | | | | | | | | 28: | | | | | | | | | | | | | | 33 | | | | | | | | | | | | |----|-----|-----|-----|-----|-----|-----|-----|----|-----|-----|-----|-----| ...[snip]... networking monitor performance-summary IOPS lastday Display the last day's IOPS traffic statistics.
PAGE 201
Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display the last month’s IOPS traffic statistics: CLI> networking monitor performance-summary IOPS last-month Output .--------------.--------.--------.--------.--------.--------.-------------.
PAGE 202
Output .--------------.--------.--------.--------.--------.--------.--------------.
PAGE 203
networking monitor performance-summary IOPS now Display the current IOPS traffic statistics. Format networking monitor performance-summary IOPS now Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display the current IOPS traffic statistics: CLI> networking monitor performance-summary IOPS now Output .--------------.--------.--------.--------.--------.--------.--------------.
PAGE 204
Example Display the last day's read traffic statistics: CLI> networking monitor performance-summary read last-day Output .--------.--------.--------.--------------.-------------.--------------. | Time | NFS | NDMP | SMB Read | Replication | Network | | | Read | Read | (per sec) | Read (per | Overhead | | | (per | (per | | sec) | Read (per | | | sec) | sec) | | | sec) | |--------|--------|--------|--------------|-------------|--------------| | 10-May | 0.00 | 0.00 | 0.00 MB | 0.00 MB | 0.
PAGE 205
| | sec) | sec) | | | sec) | |--------|--------|--------|--------------|-------------|--------------| | 10-May | 0.00 | 0.00 | 0.00 MB | 0.00 MB | 0.00 MB | | -13 | MB | MB | | | | | 14:20: | | | | | | | 47 | | | | | | |--------|--------|--------|--------------|-------------|--------------| | 09-May | 0.00 | 0.00 | 0.00 MB | 0.00 MB | 0.00 MB | | -13 | MB | MB | | | | | 00:00: | | | | | | | 00 | | | | | | |--------|--------|--------|--------------|-------------|--------------| ...[snip]...
PAGE 206
|----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| | 1 | 05- | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0| 0.0 | 0.0 | 0.0 | 0.0 | | | Aug | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | | | -13 | MB | MB | MB | MB | MB | MB | MB | MB | MB | MB | MB | | | 11: | | | | | | | | | | | | | | 30: | | | | | | | | | | | | | | 23 | | | | | | | | | | | | |----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| ...[snip]...
PAGE 207
networking monitor performance-per-node last-day Display the last day’s traffic statistics per NAS controller. Format networking monitor performance-per-node last-day Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display the last day’s traffic statistics per NAS controller: CLI> networking monitor performance-per-node last-day Output .----.-----.-----.-----.-----.-----.-----.-----.-----.-----.-----.
PAGE 208
networking monitor performance-summary write lastday Display the last day’s write traffic statistics. Format networking monitor performance-summary write last-day Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display the last day’s write traffic statistics: CLI> networking monitor performance-summary write last-day Output .--------.--------.--------.--------------.--------------.--------------.
PAGE 209
Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display the last month’s write traffic statistics: CLI> networking monitor performance-summary write last-month Output .--------.--------.--------.--------------.--------------.--------------.
PAGE 210
Example Display the last week’s write traffic statistics: CLI> networking monitor performance-summary write last-week Output .--------.--------.--------.--------------.-------------.--------------. | Time | NFS | NDMP | SMB Write | Replication | Network | | | Write | Write | (per sec) | Write (per | Overhead | | | (per | (per | | sec) | Write (per | | | sec) | sec) | | | sec) | |--------|--------|--------|--------------|-------------|--------------| | 10-May | 0.00 | 0.00 | 0.00 MB | 0.00 MB | 0.
PAGE 211
| | sec) | sec) | | | sec) | |--------|--------|--------|--------------|-------------|--------------| | 10-May | 0.00 | 0.00 | 0.00 MB | 0.00 MB | 0.00 MB | | -13 | MB | MB | | | | | 14:23: | | | | | | | 07 | | | | | | |--------|--------|--------|--------------|-------------|--------------| | 26-Apr | 0.00 | 0.00 | 0.00 MB | 0.00 MB | 0.00 MB | | -13 | MB | MB | | | | | 00:00: | | | | | | | 00 | | | | | | |--------|--------|--------|--------------|-------------|--------------| ...[snip]...
PAGE 212
networking open-files close Close open files by file handle, protocol, or controllerID. Format networking open-files close Options Option Description FileHandle File handle Protocol Protocol through which the file was opened ControllerID ID of the controller through which the file was opened Format Possible values are ((enums.ClientProtocol)) Example Close an open file: CLI> networking open-files close 35625 SMB 0 Output .--------.--------.--------------.
PAGE 213
Example Close an open file by path: CLI> networking open-files close Output .----------.--------.--------------.--------.--------.-------.--------.-------. | Protoc | Contro | User | Comput | Number |Connec | Idle | Guest | | ol | ller | | er | Open |ted | Time | | | | Id | | | Files |Time | | | |----------|--------|--------------|--------|-------|--------|--------|-------| |SMB | 0 | idffs1\user1 | ::ffff | 1 |00:14: | 00:00: | No | | | | | :172.2 | |16 | 00 | | | | | | 2.69.
PAGE 214
Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header —FilterByName Displays only the files matching the specified name Example Display a list of open files: CLI> networking open-files list Output .-------.---------------.--------------.---------.-----.----------.-----------.
PAGE 215
Example Display information about open files: CLI> networking open-files list 35625 SMB0 Output Path Accessed By Protocol Number Of Locks Mode File handle = = = = = = jvol1 Dell\Jonathans SMB 0 Read ONly 35625 networking static-routes add Add a static route for a destination subnet.
PAGE 216
Arguments Argument Description Format Network ID of the destination subnet Existing network ID Prefix of the destination subnet Existing network prefix Example Delete the static route to a subnet with the address 10.1.100.0 and prefix 24: CLI> networking static-routes delete 10.1.100.0 24 networking static-routes edit Modify the gateway for a destination subnet.
PAGE 217
Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display the current static routes: CLI> networking static-routes list Output .------------------------.---------------------------.------------. | Destination Network ID | Destination Prefix Length | Gateway IP | |------------------------|---------------------------|------------| | 172.51.00 | 16 |172.41.2.65 | .------------------------.
PAGE 218
networking subnets add Add a subnet on the client network.
PAGE 219
Arguments Argument Description Format Network ID of the subnet Existing network ID < PrefixLength> Prefix length of the subnet Existing prefix length (integer) Example Delete a client subnet with the ID 192.168.0.0 and prefix 16: CLI> networking subnets delete 192.168.0.0 16 networking subnets edit Modify client network subnet settings.
PAGE 220
networking subnets list Display a list of the client network subnets. Format networking subnets list Options Option Description Format --CSV Displays the command output in Append --CSV to the command a comma‑delimited format with a header Example Display a list of the current client network subnets: CLI> networking subnets list Output .-------------.----------------.----------.----------------.-----------------.
PAGE 221
Example Display the settings for a client network with the ID 172.22.69.0 and the prefix length 24: CLI> networking subnets view 172.22.69.0 24 Output Network Id = 172.22.69.0 Prefix = 24 VLAN Tag = 0 PrivateIPs = 172.22.69.42,172.22.69.43 PublicIPs = 172.22.69.40,172.22.69.41 system administrators add Add administrator privileges to a user.
PAGE 222
Option Description Format -AccessControlSeverity Severity of the events from the access control workspace that will be sent by email to the administrator Possible values are All, Major -EnableNetworkingSeverity Indicate whether events from the Possible values are Yes, No performance and connectivity workspace should be sent by email to the administrator -NetworkingSeverity Severity of the events from the performance and connect
PAGE 223
Example Delete the administrator privileges from an administrator named Administrator2: CLI> system administrators delete Administrator2 system administrators edit Modify administrator settings. Format system administrators edit {options} Arguments Argument Description Format Name of the administrator Existing administrator user name Option Description Format -Email Email address of the administrator Email address in the following format: 'xxx@xxx.
PAGE 224
Option Description Format workspace should be sent by email to the administrator -NetworkingSeverity Severity of the events from the performance and connectivity workspace that will be sent by email to the administrator Possible values are All, Major -EnableHardwareSeverity Indicate whether events from the Possible values are Yes, No hardware workspace should be sent by email to the administrator -HardwareSeverity Severity of the even
PAGE 225
Output .----------------.---------------------.--------.---------------------------. | User Name | Email | SSHKey | Scope | |----------------|---------------------|--------|---------------------------| | Administrator | user@jonathan-linux2|ssh-rsa | NAS cluster administrator | |----------------|---------------------|--------|---------------------------| | Administrator2 | storage@domain.
PAGE 226
Format system administrators passwordless-access add-ssh-keys Arguments Argument Description Format Name of the user that will become administrator Length must be less than 97 characters Name of machine Public SSH key for a specified machine that will allow the administrator to enter the CLI without a user name and password Existing SSH key system administrators passwordless-access del-ssh-key Delete a secure shell handling (SSH
PAGE 227
Arguments Argument Description Format Name of the user that will become administrator Length must be less than 97 characters Name of machine Public SSH key for a specified machine that will allow the administrator to enter the CLI without a user name and password Existing SSH key system background-operations recent Display a list of recent background operations.
PAGE 228
| | 7E9465B0AC6FE3D | | | | Diagn | 13:33:59 | 14:14:20 | | | |------------|------------------|---------|----------|----------|-----------------------|------------|-----------|---------|---------| | 3 | 51DFC15C08EA1A7E9| 56275 | Default | Action | ServicePac | 12-Jul-14 | 12-Jul-13 | No | Finished| | | BAF0B871DB85E6A | | | | | 14:15:51 | 14:20:52 | | | '------------'------------------'---------'----------'----------'-----------------------'------------'-----------'---------'---------' system background-o
PAGE 229
system background-operations view-runningoperations-status Display the status of running background operations according to a specific ID.
PAGE 230
Arguments Argument Description Format Amount of time to block the Whole positive number (in command prompt waiting for the seconds) background operation to finish Example Block the command prompt for 20 seconds or until the current background process completes, whichever occurs first: CLI> system background-operations wait-to-finish 20 system data-protection antivirus-scanners add Add an antivirus server.
PAGE 231
system data-protection antivirus-scanners delete Delete an antivirus server. Format system data-protection antivirus-scanners delete Arguments Argument Description Format Antivirus server Existing antivirus server host name or IP address Antivirus server port Existing antivirus server port Example Delete an antivirus server with the host name av1.domain.com that the FluidFS cluster connects to on port 80: CLI> system data-protection antivirus-scanners delete av1.
PAGE 232
Format system data-protection cluster-partnerships add {options} Arguments Argument Description Format IP address of the remote system IP address in IPv6 or IPv4 format Option Description Format -UserName Administrator of the remote system Administrator user name of the remote system -Password Password of the remote system administrator Password of the remote system Options Example Create a partnership with a FluidFS cluster that has the IP addres
PAGE 233
system data-protection cluster-partnerships deletelocal-partnership-by-ID Delete a cluster partnership by ID. This command only deletes the partnerhip locally.
PAGE 234
system data-protection cluster-partnerships list Display a list of the FluidFS cluster’s partnerships. Format system data-protection cluster-partnerships list Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display a current list of the FluidFS cluster’s partnerships: CLI> system data-protection cluster-partnerships list Output .-------------------------.-------------------.-----------------.
PAGE 235
Options Option Description Format -UserName Administrator of the remote system Administrator user name of the remote system -Password Password of the remote system administrator Password of the remote system Example Update the communication type for a remote FluidFS cluster named idffs2 that has an administrator named Administrator with the password Stor@ge!: CLI> system data-protection cluster-partnerships update-protocol-version idffs2 -UserName Administrator -Password Stor@
PAGE 236
system data-protection NDMP-configuration edit Modify NDMP settings. NOTE: To delete DMA servers, you must provide an empty list in the form of ” ”. Format system data-protection NDMP-configuration edit {options} Options Option Description Format -DMAServers DMA servers Comma-separated list of IP addresses in IPv4 or IPv6 format -ClientPort Client port number Whole positive number Example Add an NDMP server with the IP address 74.125.225.
PAGE 237
Option Description Format character types: lowercase character, uppercase character, digit, special characters (for example, +, ?, and *) Example Change the NDMP username to backupuser and password to Password123: CLI> system data-protection NDMP-configuration update-user backupuser -Password Password123 system data-protection NDMP-configuration view Display NDMP settings.
PAGE 238
Example Create a new QoS entity with name Entity1 and bandwidth speed 100 KBps: CLI> system data-protection QOS add Entity1 -Name -100KBps speed system data-protection QOS delete Delete a QoS entity. Format system data-protection QOS delete {speed} Arguments Argument Description QOS entity name Format Example Delete a QoS entity with name Entity1: CLI> system data-protection QOS delete Entity1 -Name system data-protection QOS list List all the QoS entries.
PAGE 239
system data-protection QOS modify Modify a QoS entity.
PAGE 240
Options Option Description Format -Monday, -Tuesday, Bandwidth allocation percentage 10–100% Wednesday, -Thursday, -Friday, Saturday, -Sunday -new name New QoS name Example Change the limited hour on Mondays: CLI> system data-protection QOS modify-schedule Entity1 -name Monday -hour system data-protection QOS view View details of a QoS entity.
PAGE 241
Argument Description Format the device type, model, SCSI ID, and the destination port of the tape drive. Type of tape device Possible values are Tape (actual tape), Library (media library) Example Add a new tape device: CLI> system data-protection tape-devices add tape:IBM:ULT3580-HH4 tape system data-protection tape-devices delete Delete a Fibre Channel tape device.
PAGE 242
Option Option Description Format -DeviceType Type of tape device Possible values are Tape (actual tape), Library (media library) Example Modify a tape device: CLI> system data-protection tape-devices modify tape:IBM:ULT3580-HH4 DeviceType tape system data-protection tape-devices list List all Fibre Channel tape devices.
PAGE 243
Example View information about a new tape device: CLI> system data-protection tape-devices view tape:IBM:ULT3580-HH4 Output Name Device type Status summary Controller status = = = = Name of tape device Type of tape device Accessibility status (Optimal, Partial, Fail) Status of each controller (Connected, Not connected, N/A) system EM recipients add Add an EM recipient. CAUTION: This command should be used only by Dell Technical Support.
PAGE 244
Format system EM recipients delete Arguments Argument Description Format URL or IP address of the EM data collector Comma‐separated list of recipients. Must be less than 255 characters. Example Delete an EM recipient https://172.22.69.18:3033/dsfsevent: CLI> system EM recipients delete https://172.22.69.18:3033 system EM recipients edit Modify the EM recipients. CAUTION: This command should be used only by Dell Technical Support.
PAGE 245
Example Display the current EM recipients configuration: CLI> system EM recipients view Output .-------------------------.----------------------------.----------.-------------------. | URL | Data Collector ID | Is Active| Is Events Receiver| |-------------------------|----------------------------|----------|-------------------| | https://10.48.29.
PAGE 246
system event-filter view Display the event filter settings. Format system event-filter view Output .----------------------------.---------.----------.
PAGE 247
system file-access-notifications view View external auditing status. Format system file-access-notifications view Example View external auditing status: CLI> system file-access-notifications view Output Allow external servers auditing = Yes/No system file-access-notifications subscribers add Add an external auditing subscriber to file access notifications.
PAGE 248
system file-access-notifications subscribers delete Delete an external auditing subscriber from the file access notifications list. Format system file-access-notifications subscribers delete Example Delete an external auditing status: CLI> system file-access-notifications delete Arguments Argument Description Auditing servers cluster unique name Format system file-access-notifications subscribers edit Edit external auditing subscriber settings such as IP or port.
PAGE 249
system file-access-notifications subscribers list List all the auditing subscribers configured to receive file-access notifications. Format system file-access-notifications subscribers list Example View the external auditing status: CLI> system file-access-notifications subscribers list system-internal BMC-network disable Disable BMC network settings.
PAGE 250
Argument Description Format Gateway for the BMC network IP address in IPv4 format system-internal BMC-network enable Enable BMC network settings.
PAGE 251
Argument Description Format underscores and hyphens, but cannot end in a hyphen. It can be up to 15 characters long. Example Change the FluidFS cluster name to idffs1: CLI> system internal cluster-name set idffs1 system internal cluster-name view Display the FluidFS cluster name.
PAGE 252
Output -------------------.-------.----------.-----------------------------.--------------------------------. | Diagnostics Name | Status| Last | File name of main Diagnostics| File name of Logs Diagnostics| |------------------|-------|-----------|------------------------------|------------------------------| | General | Idle | 29-O | Summary.3859981732.29_10_20 | Logs.3859981732.29_10_2014- | | | | 12:46 | 14-12_46_39.tar.gz | 12_46_39.tar.
PAGE 253
Argument Description Format -RepositoryPath Path of the repository on which to run diagnostics If it is FTP, the diagnostics should be transferred from the cluster via ftp under ftp:// (UserName)@(ClusterVIP):44421/ diagnostics/archive/. Example Run the client connectivity diagnostic for an SMB client with the IP address 172.22.69.18: CLI> system internal diagnostics run-client-connectivity-diagnostic 172.22.69.
PAGE 254
Argument Description Format -RepositoryPath Path of the repository on which to run diagnostics If it is FTP, the diagnostics should be transferred from the cluster via ftp under ftp:// (UserName)@(ClusterVIP):44421/ diagnostics/archive/. Example Run the core file-system diagnostic: CLI> system internal diagnostics run-file-system-diagnostic -RepositoryType TypeA system internal diagnostics run-general-diagnostic Run the general diagnostic.
PAGE 255
Argument Description Format -RepositoryPath Path of the repository on which to run diagnostics If it is FTP, the diagnostics should be transferred from the cluster via ftp under ftp:// (UserName)@(ClusterVIP):44421/ diagnostics/archive/. Example Run the general diagnostic: system internal diagnostics run-general-diagnostic system internal diagnostics run-network-diagnostic Run the networking diagnostic.
PAGE 256
IP address of the client Existing client IP address in IPv6 or IPv4 foromat Argument Description Volume of repository on which to run network diagnostic If it is FTP, the should be transferred from the cluster via ftp under ftp:// (UserName)@(C lusterVIP): 44421/ diagnostics/ archive/. Path of repository on which to run network diagnostic Format me and RepositoryPath determine where the files will be stored.
PAGE 257
NOTE: FTP is enabled by default on the FluidFS cluster. However, if FTP has been disabled, see system internal security FTP configuration enable to reenable FTP before using this command. Format system internal diagnostics run-nfs-file-accessibility-diagnostic Arguments Argument Description Format IP address of the client Existing client IP address in the format: x.x.x.
PAGE 258
Format system internal diagnostics run-performance-diagnostic Arguments IP address of the client Existing client IP address in IPv6 or IPv4 foromat Argument Description Format Client protocol Possible values are SMB,, NFS NAS volume name Existing NAS volume name RepositoryType Type of repository on which to run diagnostics RepositoryType repository on NAS_VOLUME which to run or FTP.
PAGE 259
Example Run the performance diagnostic on a NAS volume named vol1: CLI> system internal diagnostics run-performance-diagnostic vol1 system internal diagnostics run-smb-and-nfsdiagnostic Run the general SMB and NFS diagnostic. If the problem happens only while certain activity is running against the cluster, repeat it after the activity has finished. For NAS Volume repository, use SMB-Share or NFS-Export.
PAGE 260
Argument Description Format Client protocol Possible values are SMB,, NFS -RepositoryType Type of repository on which to run diagnostics RepositoryType can be NAS_VOLUME or FTP. If it is NAS_VOLUME, then the values of RepositoryVolume and RepositoryPath determine where the files will be stored. The files can then be accessed by a share or export to the volume.
PAGE 261
Output Diagnostic Name Status Last Run File Name General Diagnostic = = = = Network DiagIdle 11-May-13 12:33:33 Summary.90fb2eb6-d44d-4440-abd8-adba59cb1101. 11_05_2013-12_33_06.tar.gz File Name Logs Diagnostic = Logs.90fb2eb6-d44d-4440-abd8-adba59cb1101.11_ 05_2013-12_26_57.tar.
PAGE 262
Example Display the current data reduction settings: CLI> system internal file-system background-processes configuration datareduction view Output Enable Data Reduction = Yes Starting Hour = 23 Duration in Hours = 6 system internal file-system background-processes configuration health-scan set Modify the health scan settings. CAUTION: Dell recommends keeping the health scan throttling mode set to Normal unless specifically directed otherwise by Dell Technical Support.
PAGE 263
system internal file-system background-processes configuration health-scan view Display the health scan settings. Format system internal file-system background-processes configuration health-scan view Example Display the current health scan settings: CLI> system internal file-system background-processes configuration health-scan view Output Throttling = Normal mode Crossref = Yes system internal file-system background-processes list Display a list of background processes with their status.
PAGE 264
system internal file-system background-processes view Display the status of a background process.
PAGE 265
| ID | Mode | Usage | | | |---------------|----------------|----------------|--------|----------------| | 1 | Mirroring | 0 |Running | .---.---.-... | | | | | | | D | R | ... | | | | | | | o | u | ... | | | | | | | m | n | ... | | | | | | | a | n | ... | | | | | | | i | i | ... | | | | | | | n | n | ... | | | | | | | I | g | ... | | | | | | | D | N | ... | | | | | | | | o | ... | | | | | | | | d | ... | | | | | | | | e | ... | | | | | | | | | ... | | | | | | | | | ... | | | | | | | | | ...
PAGE 266
DomainsInfo ...[snip]... = .--------.--------.--------.--------.---------.--------.
PAGE 267
Arguments Argument Description Format Indicate in which mode the FluidFS cluster should work Possible values are NoService, Normal, Write‑throughOn Example Change the system serviceability mode to Normal: CLI> system internal file-system service-mode set Normal system internal file-system service-mode view Display the system serviceability mode settings.
PAGE 268
system internal language set Modify the language of the FluidFS cluster. Format system internal language set Arguments Argument Description Format Language of the FluidFS cluster Possible value is English Example Modify the language of the FluidFS cluster to English: CLI> system internal language set English system internal language view Display the language of the FluidFS cluster.
PAGE 269
Options Option Description Format -MaxNFSVersionSupported Maximum version of NFS supported by system (configuration restrictions) Possible values are NFSv3, NFSv4, and NFSv4.1 Example Set the maximum NFS version supported on a cluster: CLI> system-internal protocols-settings NFS-settings edit MaxNfsVersionSupported system internal protocols-settings NFS-settings view Display the general settings of the NFS protocol.
PAGE 270
Option Description Format Local accounts maximum LocalAccountsMaxPasswordAg password age e Integer number with suffix of units H/D/W (hours, days, or weeks) (for example, 10H) -CheckPasswordComplexity Indicate whether the password‑complexity checks should be enforced Possible values are Yes, No -RequireMessageSigning Defines whether SMB3 traffic connected to any share is required to
PAGE 271
system-internal protocols-settings SMB-settings view Display the general settings for the SMB protocol. Format system internal protocols-settings SMB-settings view Example Display the current general settings for theSMB protocol: CLI> system internal protocols-settings SMB-settings view Output Local Accounts Password Never Expires = No Local Accounts Max Password Age = 6 Weeks Check Password Complexity = Yes system internal security FTP configuration disable Disable FTP on the FluidFS cluster.
PAGE 272
system internal security FTP configuration view Display the FTP settings on the FluidFS cluster. Format system internal security FTP configuration view Example Display the current FTP settings on the FluidFS cluster: CLI> system internal security FTP configuration view Output Enabled = Yes system internal security management-access management-subnet add Add a management subnet.
PAGE 273
Example Add a management subnet on the client interface with the client VIP 10.10.10.44 and NAS controller IP addresses 10.10.10.42 and 10.10.10.43: CLI> system internal security management-access management-subnet add 255.255.255.0 -Interface Client -PrivateIPs 10.10.10.42,10.10.10.43 -PublicIP 10.10.10.44 system internal security management-access management-subnet delete Delete a management subnet.
PAGE 274
Example Change the client VIP of a management subnet to 10.10.10.44: CLI> system internal security management-access management-subnet edit PublicIP 10.10.10.44 system internal security management-access management-subnet view Display management subnet settings.
PAGE 275
system internal security management-access restrictionstatus Display the status of management access restriction.
PAGE 276
Option Description Format character, uppercase character, digit, special characters (for example, +, ?, and *) Example Change the password of the support user to Password123: CLI> system internal security support-access change-password -Password Password123 system internal security support-access disable Disable support access to the system.
PAGE 277
system internal security support-access secure-consoleaccess disable-proxy-authentication Disable proxy-authentication. Format CLI> system internal security support-access secure-console-access disableproxy-authentication system internal security support-access secure-consoleaccess enable Enable remote access to support secure console.
PAGE 278
Options Option Description ProxyUsername Proxy user name Format ProxyPassword Proxy password system internal security support-access secure-consoleaccess view Supports secure shell status view. Format CLI> system internal security secure-console-access view system internal security support-access view Display settings for support access to the system.
PAGE 279
system internal security support-assist enable Enable SupportAssist. Format system internal security support-assist enable Example Enable SupportAssist: CLI> system internal security support-assist enable system internal security support-assist view Display settings for SupportAssist.
PAGE 280
Example Change the UI session expiation period to 1800 seconds: CLI> system internal security ui-configuration edit -SessionExpirationPeriod 1800 system internal security ui-configuration view Display the UI settings.
PAGE 281
system internal security ui-configuration wui-settings view Display the WUI (web user interface) settings. Format CLI> system internal security ui-configuration wui-settings view system internal system-configuration-state hardwarereplacement-finished Indicate that the hardware replacement is finished. CAUTION: This command should be used only by Dell Technical Support. This command is used during a FluidFS cluster deployment.
PAGE 282
system internal system-configuration-state installationfinished Indicate that the installation is finished. CAUTION: This command should be used only by Dell Technical Support. This command is used during a FluidFS cluster deployment.
PAGE 283
Argument Description Format Replication, Deduplication, Snapshots Example Delete the license for the Snapshots feature: CLI> system licenses delete Snapshots system licenses list Display a list of installed licenses. Format system licenses list Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display a list of the current installed licenses: CLI> system licenses list Output .---------------.
PAGE 284
Format system licenses load Arguments Argument Description Format File name of the new license file Existing file name of license file uploaded to ftp:// @: 44421/licensing/ Example Load a new license file named license: CLI> system licenses load license system licenses view Display details about an installed license.
PAGE 285
system mail-configuration disable-authentication Disable mail relays authentication. Format system mail-configuration disable-authentication Example Disable mail relays authentication: CLI> system mail-configuration disable-authentication system mail-configuration enable-authentication Enable mail relays authentication.
PAGE 286
Options Option Description Format -MailRelays Mail relays Comma-separated list of IP addresses in IPv6 or IPv4 format -ClusterMailAddress Mail address from which the FluidFS cluster will send the emails Email address in the following format: xxx@xxx.
PAGE 287
system SNMP set Modify SNMP settings.
PAGE 288
Arguments Argument Description Format Workspace to which the events belong Possible values are AccessControl, Hardware, NasVolumes, Performance&Connectivity, System Option Description Format -Enabled Indicate whether SNMP traps should be sent for the events from this workspace Possible values are Yes, No -Severity Severity of the events that will be sent as SNMP traps from this workspace Possible values are All, Major Options Example Enable SNMP traps for all
PAGE 289
|----------------------------|--------|----------| | Performance & Connectivity| Yes | Major | |----------------------------|--------|----------| | Hardware |Yes | Major | |----------------------------|--------|----------| | System |Yes | Major | '----------------------------'---------'----------' system software-updates list Display a list of the software updates.
PAGE 290
Example Display the software update details for release 3.0.8142: CLI> system software-updates view 3.0.8142 Output Release = 3.0.8142 Status = Installed Installation Date = 12-Jul-13 13:19:36 File Name = system software-updates approve-eula Approve that the administrator read the end-user license agreement.
PAGE 291
Example Display the current version of the software: CLI> system software-updates current-version Output Release 3.0.8331 system software-updates flash-standby-controller Write the service pack image to the internal USB drive of the node. Format flash-standby-controller Arguments Argument Description File name of the software update Format system software-updates upgrade Install a service pack. NOTE: FTP is enabled by default on the FluidFS cluster.
PAGE 292
Output Confirmation: System upgrade is a lengthy operation. It is recommended to upgrade during a maintenance window as users will experience disconnections. Are you sure you want to perform the upgrade now? Are you sure that you want to complete the operation? ( Yes / No ): system software-updates validate Validate a service pack. NOTE: FTP is enabled by default on the FluidFS cluster.
PAGE 293
Arguments Argument Description Format Software update version Existing release name Example Display the software update details for release 3.0.8142: CLI> system software-updates view 3.0.8142 Output Release = 3.0.8142 Status = Installed Installation Date = 12-Jul-13 13:19:36 File Name = system time available-timezones Display a list of available time zones. Format system time available-timezones Example View available time zones: CLI> system time available-timezones Output .
PAGE 294
| Africa/Bissau | |----------------------------------| | Africa/Blantyre | |----------------------------------| | Africa/Brazzaville | |----------------------------------| ...[snip]... system time edit Modify the time zone and NTP settings. Format system time edit {options} Options Option Description Format - TimeZone Time zone of the FluidFS cluster For a list of valid time zones, see system time available-timezones.
PAGE 295
Example Display the current time zone and NTP settings: CLI> system time view Output Time Zone = US/Central Use NTP = Yes NTPServers = time.lab.town system time set-current-time Modify the current FluidFS cluster time.
PAGE 296
system vmware compute-resources list Display a list of all ESXi hosts and clusters mounting this FluidFS system. Format system vmware compute-resourcees list Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command Example Display a list of current VMware servers: CLI> system vmware vmware-servers list system vmware compute-resources view Display details of compute resources.
PAGE 297
system vmware virtual-machines clone Clone a virtual machine using FluidFS file cloning. Format system vmware virtual-machines clone [options] Arguments Argument Description Unique name of the VMware server Host name to register cloned virtual machines Prefix for names of cloned virtual machines. The machines will be named {CloneNamePrefix}1, {CloneNamePrefix}2, and so on.
PAGE 298
Option Description Password VMware server password; this field is required if VMware server credentials were not saved Format Example Clone a virtual machine with a server named MyMachine: CLI>system vmware virtual-machines -clone MyMachine 192.168.0.14 [options] system vmware virtual-machines clone-single Create a single cloned virtual machine using FluidFS file cloning.
PAGE 299
Option Description CustomizationSpecName Name of the customized specification to apply on resulting cloned virtual machines UserName VMware server user name; this field is required if VMware server credentials were not saved Password VMware server password; this field is requuired if VMware server credentials were not saved Format Example Create a single cloned virtual machine with a server named MyMachine: CLI>system vmware virtual-machines -clone-single MyMachin
PAGE 300
Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command -VMwareServerName VMware server containing the virtual machine -Path Virtual machine full path in VMWare server inventory -VirtualMachineName Virtual machine name Example Display details about a virtual machine: CLI> system vmware virtual-machines view MyVM system vmware vmware-servers delete Delete one or more V
PAGE 301
Arguments Argument Description Unique name of the VMware server
Address of the VMware server Format Can be a host name or IP address Example Modify a VMware server: CLI>system vmware vmware-servers edit MYVMware 192.168.0.14 system vmware vmware-servers list Display a list of the VMware servers.
PAGE 302
Options Option Description Format --CSV Displays the command output in a comma-delimited format with a header Append --CSV to the command --VMwareServerName Name of the server as it was defined during the add command.
PAGE 303
CLI Procedures 3 Adding a NAS Appliance to a FluidFS Cluster Using the CLI Use this procedure to add a NAS appliance to a FluidFS cluster using the CLI. The recommended way to add a NAS appliance is to use the FluidFS NAS Manager WebUI. This procedure should be performed only by Dell Technical Support Services. 1. Log on to the CLI of the existing FluidFS cluster (do not log on to the new NAS appliance) as described on Accessing the CLI. 2.
PAGE 304
9. Perform an incremental format and join the new NAS appliance to the FluidFS cluster. hardware nas-appliances join-appliance For example: hardware nas-appliances join-appliance 2 10. After the previous command completes, confirm that the NAS appliance Status is Optimal in the output of the following command.