Dell PowerVault NX3600 User manual

Dell FluidFS NAS Solutions
CLI Reference Guide

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.
©2012 Dell Inc.
Trademarks used in this text: Dell™, the Dell logo, Dell Boomi™, Dell Precision™, OptiPlex™, Latitude™, PowerEdge™, PowerVault™,
PowerConnect™, OpenManage™, EqualLogic™, Compellent™, KACE™, FlexAddress™, Force10™and Vostro™are trademarks of Dell
Inc. Intel®, Pentium®, Xeon®, Core®and Celeron®are registered trademarks of Intel Corporation in the U.S. and other countries. AMD®
is a registered trademark and AMD Opteron™, AMD Phenom™and AMD Sempron™are trademarks of Advanced Micro Devices, Inc.
Microsoft®, Windows®, Windows Server®, Internet Explorer®, MS-DOS®, Windows Vista®and Active Directory®are either trademarks
or registered trademarks of Microsoft Corporation in the United States and/or other countries. Red Hat®and Red Hat®
Enterprise Linux®are registered trademarks of Red Hat, Inc. in the United States and/or other countries. Novell®and SUSE®are
registered trademarks of Novell Inc. in the United States and other countries. Oracle®is a registered trademark of Oracle Corporation
and/or its affiliates. Citrix®, Xen®, XenServer®and XenMotion®are either registered trademarks or trademarks of Citrix Systems, Inc. in
the United States and/or other countries. VMware®, Virtual SMP®, vMotion®, vCenter®and vSphere®are registered trademarks or
trademarks of VMware, Inc. in the United States or other countries. IBM®is a registered trademark of International Business Machines
Corporation.
2012 - 06
Rev. A00

Contents
Notes, Cautions, and Warnings...................................................................................................2
1 Command Line Interface............................................................................................................7
Overview...................................................................................................................................................................7
Accessing The CLI....................................................................................................................................................7
Navigating The CLI....................................................................................................................................................8
One Menu At A Time..........................................................................................................................................8
Single Line Command.........................................................................................................................................8
Understanding The CLI Command Syntax................................................................................................................8
CLI Menu Options.....................................................................................................................................................9
2 Protecting Data..........................................................................................................................11
replication...............................................................................................................................................................11
nas-replication.................................................................................................................................................11
partner-systems...............................................................................................................................................17
snapshots................................................................................................................................................................19
revert................................................................................................................................................................19
actions..............................................................................................................................................................19
policies.............................................................................................................................................................21
antivirus..................................................................................................................................................................24
hosts.................................................................................................................................................................24
ndmp.......................................................................................................................................................................25
active-jobs........................................................................................................................................................25
configuration....................................................................................................................................................26
3 Managing The System..............................................................................................................27
general....................................................................................................................................................................27
info....................................................................................................................................................................27
cluster-id..........................................................................................................................................................28
background-operations....................................................................................................................................28
administrators..................................................................................................................................................29
cluster-name....................................................................................................................................................31
licensing...........................................................................................................................................................32
time-configuration..................................................................................................................................................33
view..................................................................................................................................................................33
list-timezones...................................................................................................................................................33
set.....................................................................................................................................................................33

monitoring-configuration........................................................................................................................................34
snmp.................................................................................................................................................................34
email.................................................................................................................................................................35
syslog...............................................................................................................................................................38
maintenance...........................................................................................................................................................40
controllers........................................................................................................................................................40
luns...................................................................................................................................................................42
actions..............................................................................................................................................................45
backup-configuration.......................................................................................................................................46
protocols.................................................................................................................................................................48
cifs....................................................................................................................................................................48
authentication.........................................................................................................................................................49
list-groups........................................................................................................................................................49
list-users...........................................................................................................................................................49
user-mapping...................................................................................................................................................49
active-directory................................................................................................................................................50
local-accounts.................................................................................................................................................51
full-access-account.........................................................................................................................................54
user-database..................................................................................................................................................55
networking..............................................................................................................................................................56
default-gateway...............................................................................................................................................56
dns....................................................................................................................................................................56
client connections ...........................................................................................................................................57
network-configuration......................................................................................................................................59
static-routes.....................................................................................................................................................60
subnets.............................................................................................................................................................61
4 User Access...............................................................................................................................63
quota.......................................................................................................................................................................63
usage................................................................................................................................................................63
recompute-quota..............................................................................................................................................64
rules..................................................................................................................................................................64
cifs-shares..............................................................................................................................................................66
add....................................................................................................................................................................66
view..................................................................................................................................................................67
delete................................................................................................................................................................67
clear-shares.....................................................................................................................................................68
edit....................................................................................................................................................................68
list.....................................................................................................................................................................69
cifs-home-share.....................................................................................................................................................69
add....................................................................................................................................................................69
view..................................................................................................................................................................70

delete................................................................................................................................................................70
edit....................................................................................................................................................................70
nfs-exports..............................................................................................................................................................71
refresh-netgroups-cache.................................................................................................................................71
add....................................................................................................................................................................71
view..................................................................................................................................................................72
delete................................................................................................................................................................72
edit....................................................................................................................................................................73
list.....................................................................................................................................................................73
nas-volumes............................................................................................................................................................73
total-volumes-status........................................................................................................................................74
add....................................................................................................................................................................74
view..................................................................................................................................................................74
delete................................................................................................................................................................75
edit....................................................................................................................................................................75
list.....................................................................................................................................................................76
5 Events..........................................................................................................................................77
export-events-list....................................................................................................................................................77
less..........................................................................................................................................................................77
tail...........................................................................................................................................................................78
6 Monitoring The System............................................................................................................79
system-stats............................................................................................................................................................79
quota.......................................................................................................................................................................79
view..................................................................................................................................................................79
list.....................................................................................................................................................................80
traffic-statistic........................................................................................................................................................80
view..................................................................................................................................................................80
list.....................................................................................................................................................................80
Replication..............................................................................................................................................................80
nas-replication.................................................................................................................................................80
connections............................................................................................................................................................81
cifs....................................................................................................................................................................81
export-data.............................................................................................................................................................82
nas-file-system-capacity.................................................................................................................................82
loadbalancing...................................................................................................................................................82
performance.....................................................................................................................................................83
system-validation....................................................................................................................................................83
view..................................................................................................................................................................83
start..................................................................................................................................................................83
hardware-components...........................................................................................................................................83

status................................................................................................................................................................84
sample..............................................................................................................................................................84
controllers........................................................................................................................................................84
appliances........................................................................................................................................................84
7 Running Diagnostics.................................................................................................................87
diagtool...................................................................................................................................................................87
check-ping-to-host.................................................................................................................................................87
list............................................................................................................................................................................87
start.........................................................................................................................................................................88
8 Upgrading Firmware.................................................................................................................91
instructions.............................................................................................................................................................91
status......................................................................................................................................................................91
start.........................................................................................................................................................................91
9 Getting Help................................................................................................................................93
Contacting Dell.......................................................................................................................................................93

1
Command Line Interface
Overview
The NAS cluster solution Command Line Interface (CLI) provides a convenient way to manage the NAS cluster solution.
It can be used to configure subsystems, manage administrative users, enable licensed features, and to monitor the
system. The CLI contains a set of commands to view, edit, add, delete, enable, disable, and set NAS cluster solution
entities, such as exports, shares, volumes, and accounts.
From the CLI, you can enter a specific menu and then execute its commands, as required. The following commands are
available throughout the system:
•help—lists the currently available menus or commands. At any moment while using the CLI, you can either type
help or type ?to see the available options/menus.
•back—moves back one level in the menus hierarchy.
•main—returns to the main menu.
•exit—exits the NAS cluster solution CLI.
Accessing The CLI
To access the CLI from an administrator workstation, use an SSH client, and connect to the NAS Management VIP
address you specified during cluster setup.
In a Linux prompt, run the command: ssh admin@<ipaddress>.
A Welcome window is displayed, listing the installed software version and the available commands in the top level
menu.
NOTE: Tab completion is available: type the first few characters of the command or menu name and press the
<Tab>. The name is completed to the longest unambiguous sub-string. Press the <Tab> again to see the available
commands beginning with the given string.
For example, to access a system that was defined with a NAS Management VIP of 10.10.1.200:
# ssh [email protected]
The authenticity of host '10.10.1.200 (10.10.1.200)’ can't be established.
RSA key fingerprint is:
1b:13:7c:9d:12:e2:74:69:4e:8c:93:75:1a:93:94:b5.
Are you sure you want to continue connecting
(yes/no)? yes
Failed to add the host to the list of known hosts
(/users/john/.ssh/known_hosts).
[email protected]'s password: Stor@ge!
Last login: Sun Dec 26 03:04:51 from 172.41.200.12
Welcome to "NX3600-sup3" (1.0.326)
Installed on Thu Dec 23 07:38:45 IST 2010
Hello admin, welcome to the NAS Manager command
line interface (version 1.0.366)!
7

Navigating The CLI
You can navigate in the CLI in two ways:
• one menu item at a time
• single line command
One Menu At A Time
To navigate through the CLI one menu at a time:
1. Type the <main menu name> and press the <Enter> key.
The available menu items and commands under the main menu is displayed.
2. Type the <sub menu name> and press the <Enter> key.
The available menu items and commands under the sub-menu is displayed.
3. Type the <command> and press the <Enter> key.
The command is executed.
Single Line Command
To navigate to a sub-menu or execute a command in available in the sub-menu using a single command:
Type the <main menu name> <sub menu name> <command> and press the <Enter> key.
The command is executed.
Understanding The CLI Command Syntax
NOTE: Unless mentioned otherwise, all the commands are relevant to both Dell PowerVault NX3500/NX3600/
NX3610 NAS Solutions and Dell Compellent FS8600 NAS Solution.
The structure of a single line CLI command as given in this document is:
<Cluster name> CLI > mainmenu submenu(s) command arguments [options]
Where:
•<Cluster name>—is the name of the cluster on which you are logged in.
•CLI >—is the command prompt where you type in the command syntax
•main menu—is the name of the top level menu.
•sub menu(s) —is the name of the sub-menu. Certain menus have multiple levels of sub-menus.
•command—is the name of the command that you want to execute.
•arguments—are the arguments that you must enter with the command to execute the command successfully.
The arguments for a command are always displayed on the CLI in bold font. You may have none or multiple
arguments depending on the command that you want to execute. You must enter the arguments for a command
in the correct order.
•[options]—are the options that you have available for a command. Depending on the command that you
want to execute, you may need to enter at least one of the available options for the command to execute
successfully. You may have none or multiple options depending on the command that you want to execute.
CAUTION: The menu names and commands are case sensitive. Enter the commands exactly as shown in the guide.
8

For example:
<CN-1> CLI > access quota rules edit volume type [options]
•access—is the name of the top level menu.
•quota—is the name of the sub-menu under access.
•rules—is the name of the sub-menu under quota.
•edit—is the name of the command under sub-menu rules.
•volume type—are the arguments that you must enter with the edit command to execute the command
successfully.
•[options]—are the options that you have available for a command. You need not enter the options for the
command to execute successfully. You may have none or multiple arguments depending on the command that
you want to execute. Each option for a command must be preceded by a hyphen (-).
To execute the above example successfully the syntax of the command must be:
access quota rules edit vol1 user -name testname -userSoftDef disabled -
userHardDef unlimited
CLI Menu Options
The following menus and menu options are available with the NAS cluster solution.
Menu Menu or Command Options
data-protection The data-protection menu lets you set the backup and
snapshot configuration to protect your data. It includes
the following menus:
• replication
• snapshots
• antivirus
• ndmp
system The system menu lets you configure various system-wide
properties. It includes the following menus:
• general
• time-configuration
• monitoring-configuration
• maintenance
• protocols
• authentication
• networking
access The access menu lets you define quotas, file system
options, and configure NAS volumes. It includes the
following menus:
• quota
• cifs-shares
• cifs-home-share
• nfs-exports
• nas-volumes
9

Menu Menu or Command Options
events The events menu lets you monitor your Dell Fluid File
System by detecting normal and abnormal events. It
includes the following commands:
• export-events-list
• less
• tail
monitor The monitor menu lets you monitor your Dell Fluid File
System. It includes the following menus:
• quota
• traffic-statistics
• replication
• connections
• export-data
• system-validation
• hardware-components
diag The diag menu lets you run the diagnostics on your NAS
solution. It includes the following commands:
• diagtool
• check-ping-to-host
• list
• start
service-pack The service-pack menu lets you update the NAS solution
firmware and check its installation status. It includes the
following commands:
• instructions
• status
• start
10

2
Protecting Data
Data protection is an important and integral part of any storage infrastructure. You can configure various methods for
protecting the data in your Dell Fluid File System using the data-protection menu in the CLI including:
• Replication—NAS replication is based on Dell Fluid File System snapshot technology. It uses snapshots to
identify the changes between two adjacent snapshots, and only copies the modified blocks.
• Snapshots—Snapshots are images of all the data frozen at a specific point-in-time as read-only. Snapshots
provide you with instant data backup, enabling easy access and restore capabilities by the end-user. They are
your first level of defense when protecting your organization's data.
• Antivirus—The NAS cluster solution contains integration with industry standard ICAP-enabled antivirus
software to ensure files written from CIFS clients are virus-free.
• NDMP—The NAS cluster solution supports backup and restore using Network Data Management Protocol
(NDMP). An NDMP agent installed on the NAS cluster solution ensures that stored data can be backed up and
restored using an industry-standard Data Management Application (DMA) that supports NDMP protocol,
without needing to install vendor-specific agents on the NAS appliance.
The data-protection menu lets you set the backup and snapshot configuration to protect your data. The menus under
data-protection are
• replication
• snapshots
• antivirus
• ndmp
replication
The menus available under replication are:
• nas-replication
• partner-systems
nas-replication
The menu under nas-replication is policy.
The commands available under nas-replication are:
• resume
• enable
• add
• view_history
• pause
• remove-from-replication
• view
• cancel
11

• replicate-now
• disable
• list
policy
The commands available under policy are:
• set-weekly-policy
• view
• set-daily-policy
• set-hourly-policy
• set-type
set-weekly-policy
Description
This command sets the policy for weekly snapshot creation for a specified NAS volume. You must define the number of
snapshots that must be maintained for the weekly scheduler.
Syntax
data-protection snapshots policies set-weekly-policy volume status [options]
Where the arguments are:
volume NAS volume to set
status Set status for weekly scheduler (on/
off)
The options are:
[-weeklyday weeklyday] Day of the week to snapshot at, days
are 0-6 (0 = Monday, 6 = Sunday)
[-weeklystarttimehour
weeklystarttimehour]
Offset hour of the day to snapshot at,
0-23
[-weeklystarttimemin
weeklystarttimemin]
Offset minute of the hour to snapshot
at, 0-59
[-weeklykeep weeklykeep] Number of snapshots to keep for the
weekly scheduler
view
Description
This command displays the type of NAS policy between the source and destination NAS volumes.
Syntax
data-protection replication nas-replication policy view source destination
where the arguments are:
12

source The source NAS volume in following
format: (volume name)@(system name)
destination The destination NAS volume in
following format: (volume
name)@(system name)
set-daily-policy
Description
This command sets the policy for daily snapshot creation for a specified NAS volume. You must define the number of
snapshots that must be maintained for the daily scheduler.
Syntax
data-protection snapshots policies set-daily-policy volume status [options]
Where the arguments are:
volume NAS volume to set
status Set status for daily scheduler (on/off)
the options are:
[-dailyall/-nodailyall] Enable/disable snapshot on every day
[-dailyat dailyat] Comma separated list of days to
snapshot at, days are 0-6 (0 = Monday,
6 = Sunday)
[-dailystarttimehour
dailystarttimehour]
Offset hour of the day to snapshot at,
0-23
[-dailystarttimemin dailystarttimemin] Offset minute of the hour to snapshot
at, 0-59
[-dailykeep dailykeep] Number of snapshots to keep for the
daily scheduler
set-hourly-policy
Description
This command sets the policy for hourly snapshot creation for a specified NAS volume. You must define the number of
snapshots that must be maintained for the hourly scheduler.
Syntax
data-protection snapshots policies set-hourly-policy volume status [options]
Where the arguments are:
volume NAS volume to set
status Set status for hourly scheduler (on/
off)
The options are:
13

[-hourlyall/-nohourlyall] Enable/disable snapshot on every hour
[-hourlyat hourlyat] Comma separated list of hours to
snapshot at, hours are 0-23
[-hourlystartmin hourlystartmin] Offset minute of hour to snapshot at,
0-59
[-hourlykeep hourlykeep] Number of snapshots to keep for hourly
scheduler
set-type
Description
This command sets the type of schedule for the replication policy between the source and destination NAS volumes.
Syntax
data-protection replication nas-replication policy set-type source destination
type
where the arguments are:
source The source NAS volume in following format: (volume
name)@(system name)
destination The destination NAS volume in following format:
(volume name)@(system name)
type The schedule of the required policy, optional values
are: NotScheduled, Hourly, Daily, Weekly
resume
Description
This command resumes a paused replication operation.
Syntax
data-protection replication nas-replication resume source destination
where the arguments are:
source The source NAS volume in the following format: (volume
name)@(system name)
destination The destination NAS volume in the following format: (volume
name)@(system name)
enable
Description
This command enables the replication partnership between the source and destination NAS volumes.
Syntax
data-protection replication nas-replication enable source destination
where the arguments are
14

source The source NAS volume in the following
format: (volume name)@(system name)
destination The destination NAS volume in the
following format: (volume
name)@(system name)
add
Description
This command creates a replication partnership between the source volume on the source cluster and the destination
volume on the destination cluster.
Syntax
data-protection replication nas-replication add source_volume
destination_system [options]
where the arguments are:
source_volume The source NAS volume on the current
system
destination_system The destination system from the
configured replication partnership or
"localhost" for current system
where the options are:
[-destination_volume
destinationVolume]
The destination NAS volume on the
destination cluster
view_history
Description
This command displays the replication history between a source and destination NAS volumes.
Syntax
data-protection replication nas-replication view_history source destination
Where the arguments are:
source The source NAS volume in the following
format: (volume name)@(system name)
destination The destination NAS volume in the
following format: (volume
name)@(system name)
pause
Description
This command pauses an active replication operation.
Syntax
data-protection replication nas-replication pause source destination
Where the arguments are:
15

source The source NAS volume in the following
format: (volume name)@(system name)
destination The destination NAS volume in the
following format: (volume
name)@(system name)
remove-from-replication
Description
This command removes the replication partnership between a source and destination NAS volumes and optionally
applies the source NAS volume configuration to the destination NAS volume.
Syntax
data-protection replication nas-replication remove-from-replication source
destination [options]
Where the arguments are:
source The source NAS volume in the following format: (volume
name)@(system name)
destination The destination NAS volume in the following format: (volume
name)@(system name)
the options are:
[-apply_configuration value] apply the source NAS volume
configuration in the destination NAS
volume, optional values are "Yes" or
"No" (the default value is "No")
view
Description
This command displays the replication partnership between the source and destination NAS volumes.
Syntax
data-protection replication nas-replication view source destination
Where the arguments are:
source The source NAS volume in the following
format: (volume name)@(system name)
destination The destination NAS volume in the
following format: (volume
name)@(system name)
cancel
Description
This command cancels an active replication operation between the source and destination NAS volumes.
Syntax
data-protection replication nas-replication cancel source destination
where the arguments are
16

source The source NAS volume in the following
format: (volume name)@(system name)
destination The destination NAS volume in the
following format: (volume
name)@(system name)
replicate-now
Description
This command starts the replication operation between the source and destination NAS volumes.
Syntax
data-protection replication nas-replication replicate-now source destination
Where the arguments are:
source The source NAS volume in the following
format: (volume name)@(system name)
destination The destination NAS volume in the
following format: (volume
name)@(system name)
disable
Description
This command disables file-system health scan throttling.
Syntax
system general background-operations health-scans disable
list
Description
This command lists the existing defined replications for the NAS appliance.
Syntax
data-protection replication nas-replication list
partner-systems
The commands available under partner-systems are:
• add
• view
• edit
• remove-partnership
• list
add
Description
This command adds a replication partnership between the source system and remote system.
17

Syntax
data-protection replication partner-systems add user_name
remote_mgmt_console_VIP
Where the arguments are:
user_name The administrator user name of the
remote
cluster
remote_mgmt_console_VIP The IP/Name of the remote cluster mgmt
console
view
Description
This command displays a list of the replication partners trusted by the selected system.
Syntax
data-protection replication partner-systems view system_name
Where the argument is:
system_name - The name of the remote replication
partner
to view
edit
Description
This command allows you to change certain parameters in the replication partnership. You can change the system
name, username, or the remote NAS management VIP.
Syntax
data-protection replication partner-systems edit system_name user_name [options]
here the arguments are:
system_name The name of the remote replication
partner to edit
user_name The administrator user name of the
remote cluster
the option is:
[-remote_mgmt_console_VIP
remoteMgmtVIP]
The IP/Name of the remote cluster mgmt
console
remove-partnership
Description
This command removes a system's replication partner from the replication partner list. You can enter multiple system
names, each separated by a comma.
Syntax
data-protection replication partner-systems remove-partnership system_name(s)
18

Where the argument is :
system_name(s) The name (or comma separated names list) of the remote
replication partner(s) to remove
list
Description
This command lists the currently defined replication partners.
Syntax
data-protection replication partner-systems list
snapshots
The menus under snapshots are:
• actions
• policies
The command available under snapshots is revert.
revert
Description
This command reverts the data in the selected NAS volume to the contents of the selected snapshot.
Syntax
data-protection snapshots revert volumes snap-name
Where the arguments are:
volume NAS volume name to be reverted
snap-name Snapshot name for reverting
actions
The commands available under actions are:
• rename
• create
• view
• delete
• view-delta
• list
• list-vol
rename
Description
This command renames an existing snapshot for a specified NAS volume.
19

Syntax
data-protection snapshots actions rename volume snap_name new_snap_name
Where the arguments are:
volume The NAS volumes name
snap_name The current snapshot name
new_snap_name The new snapshot name
create
Description
This command creates a snapshot of the specified NAS volume. You must have unique names for each snapshot.
Syntax
data-protection snapshots actions create volume snap_name
Where the arguments are:
volume The NAS volumes name
snap_name The current snapshot name
view
Description
This command displays the size of the specified snapshot and the date and time when the snapshot was created for the
specified NAS volume.
Syntax
data-protection snapshots actions view volume snap_name
Where the arguments are:
volume The NAS volumes name
snap_name The current snapshot name
delete
Description
This command deletes the specified snapshot for the specified NAS volume.
Syntax
data-protection snapshots actions delete volume snap_name
Where the arguments are:
volume The NAS volumes name
snap_name The current snapshot name
view-delta
Description
This command displays the difference in size (in MB) of the snapshot from when it was first created.
20