EMC Celerra Installation manual

EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1 -508-435-1000
www.EMC.com
Celerra®Network Server
Version 5.5
COMMAND REFERENCE MANUAL
P/N 300-002-697
REV A08

Celerra Network Server Command Reference Manual
2
Copyright © 1998 - 2008 EMC Corporation. All rights reserved.
Published July, 2008
EMC believes the information in this publication is accurate as of its publication date. The
information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION
MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE
INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an
applicable software license.
For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on
EMC.com.
All other trademarks used herein are the property of their respective owners.

Celerra Network Server Command Reference Manual 3
Chapter 1 Overview
The Celerra Network Server ........................................................... 12
Main components ...................................................................... 12
Control Station .................................................................................. 13
Accessing the Control Station.................................................. 13
Accessing the Command Line Interface................................. 13
Command set conventions .............................................................. 14
Synopsis ...................................................................................... 14
Command prefixes .................................................................... 15
Chapter 2 The cel and cs Commands
cel_fs ................................................................................................... 18
cs_standby.......................................................................................... 23
Chapter 3 The fs Commands
fs_ckpt................................................................................................. 26
fs_copy................................................................................................ 34
fs_dhsm .............................................................................................. 41
fs_group.............................................................................................. 61
fs_rdf................................................................................................... 64
fs_replicate......................................................................................... 71
fs_timefinder.................................................................................... 107
Chapter 4 The nas Commands
nas_acl .............................................................................................. 118
nas_automountmap........................................................................ 121
nas_cel .............................................................................................. 123
Contents

Celerra Network Server Command Reference Manual
4
Contents
nas_checkup .................................................................................... 128
nas_ckpt_schedule.......................................................................... 132
nas_config ........................................................................................ 138
nas_connecthome............................................................................ 141
nas_devicegroup............................................................................. 148
nas_disk............................................................................................ 152
nas_event ......................................................................................... 157
nas_fs ................................................................................................ 167
nas_fsck ............................................................................................ 190
nas_halt ............................................................................................ 194
nas_license ....................................................................................... 196
nas_mview....................................................................................... 198
nas_pool ........................................................................................... 207
nas_quotas ....................................................................................... 217
nas_rdf.............................................................................................. 229
nas_replicate.................................................................................... 233
nas_server ........................................................................................ 240
nas_slice ........................................................................................... 250
nas_storage ...................................................................................... 254
nas_version...................................................................................... 268
nas_volume...................................................................................... 269
Chapter 5 The server Commands
server_archive ................................................................................. 278
server_arp ........................................................................................ 292
server_cdms..................................................................................... 294
server_checkup ............................................................................... 300
server_cifs ........................................................................................ 311
server_cpu........................................................................................ 333
server_date....................................................................................... 335
server_devconfig............................................................................. 340
server_df .......................................................................................... 348
server_dns........................................................................................ 350
server_export................................................................................... 352
server_file......................................................................................... 362
server_http....................................................................................... 363
server_ifconfig................................................................................. 366
server_iscsi....................................................................................... 370
server_kerberos............................................................................... 384
server_ldap ...................................................................................... 390
server_log......................................................................................... 393
server_mount .................................................................................. 397

5
Celerra Network Server Command Reference Manual
Contents
server_mountpoint.......................................................................... 404
server_mpfs...................................................................................... 406
server_mpfsstat ............................................................................... 409
server_mt.......................................................................................... 413
server_name..................................................................................... 415
server_netstat................................................................................... 416
server_nfs ......................................................................................... 420
server_nis.......................................................................................... 429
server_param ................................................................................... 431
server_pax ........................................................................................ 438
server_ping....................................................................................... 442
server_rip.......................................................................................... 444
server_route ..................................................................................... 445
server_security................................................................................. 448
server_setup..................................................................................... 451
server_snmp..................................................................................... 454
server_standby................................................................................. 456
server_sysconfig.............................................................................. 459
server_sysstat................................................................................... 468
server_tftp ........................................................................................ 470
server_umount................................................................................. 473
server_uptime.................................................................................. 475
server_user....................................................................................... 476
server_usermapper ......................................................................... 479
server_version.................................................................................. 483
server_viruschk ............................................................................... 484
server_vtlu........................................................................................ 488
Appendix A Using Celerra Command Scripts
Celerra scripting guidelines ................................................... 498
Appendix B GNU General Public License
GNU General Public License......................................................... 506
Preamble.................................................................................... 506
Terms and Conditions for Copying, Distribution,
and Modification...................................................................... 507
NO WARRANTY..................................................................... 512
Index.............................................................................................................................. 513

Celerra Network Server Command Reference Manual
6
Contents

Celerra Network Server Command Reference Manual 7
Preface
As part of an effort to improve and enhance the performance and capabilities
of its product line, EMC from time to time releases revisions of its hardware
and software. Therefore, some functions described in this document may not
be supported by all revisions of the software or hardware currently in use.
For the most up-to-date information on product features, refer to your
product release notes.
If a product does not function properly or does not function as described in
this document, please contact your EMC representative.
Audience This guide is part of the Celerra Network Server documentation set,
and is intended for use by administrators and users of the Celerra
Network Server.
Organization Here is a list of where information is located in this guide.
Chapter 1, “Overview,” provides an overview of Celerra Network
Server components; describes local and remote access of the Control
Station; and lists the command set issued at the command line
interface.
Chapter 2, “The cel and cs Commands,” provides man pages for
administering to the remote Celerra Network Server and to the local
Control Station.
Chapter 3, “The fs Commands,” provides man pages for
administering to the specified file system.
Chapter 4, “The nas Commands,” provides man pages for
administering to the NAS database on the Control Station.

8Celerra Network Server Command Reference Manual
Preface
Chapter 5, “The server Commands,” provides man pages for
administering to the Data Movers.
Appendix A, “Using Celerra Command Scripts,” provides an
overview of the Query Subsystem for the Celerra Network Server.
Appendix B, “GNU General Public License,” contains the GNU
General Public License (GPL).
Related
documentation Other Celerra Network Server system publications are available on
the Celerra Network Server User Documentation CD.
Conventions used in
this guide EMC uses the following conventions for notes, cautions, warnings,
and danger notices.
Note: A note presents information that is important, but not hazard-related.
CAUTION
!
A caution contains information essential to avoid data loss or
damage to the system or equipment. The caution may apply to
hardware or software.
WARNING
A warning contains information essential to avoid a hazard that can
cause severe personal injury, death, or substantial property damage
if you ignore the warning.
DANGER
A danger notice contains information essential to avoid a hazard
that will cause severe personal injury, death, or substantial property
damage if you ignore the message.
Typographical conventions
EMC uses the following type style conventions in this guide:
bold • User actions (what the user clicks, presses, or selects)
• Interface elements (button names, dialog box names)
• Names of keys, commands, programs, scripts, applications,
utilities, processes, notifications, system calls, services,
applications, and utilities in text

Celerra Network Server Command Reference Manual 9
Preface
Where to get help EMC support, product, and licensing information can be obtained as
follows.
Product information — For documentation, release notes, software
updates, or for information about EMC products, licensing, and
service, go to the EMC Powerlink website (registration required) at:
http://Powerlink.EMC.com
Technical support — For technical support, go to EMC Customer
Service on Powerlink. To open a service request through Powerlink,
you must have a valid support agreement. Please contact your EMC
sales representative for details about obtaining a valid support
agreement or to answer any questions about your account.
Your comments Your suggestions will help us continue to improve the accuracy,
organization, and overall quality of the user publications. Please send
your opinion of this guide to:
[email protected]
italic • Book titles
• New terms in text
• Emphasis in text
Courier •Prompts
• System output
• Filenames
• Pathnames
•URLs
• Syntax when shown in command line or other examples
Courier, bold •Userentry
• Options in command-line syntax
Courier italic • Arguments in examples of command-line syntax
• Variables in examples of screen or file output
• Variables in pathnames
<> Angle brackets for parameter values (variables) supplied by user.
[] Square brackets for optional values.
|Vertical bar symbol for alternate selections. The bar means or.
... Ellipsis for nonessential information omitted from the example.

10 Celerra Network Server Command Reference Manual
Preface

Overview 11
1
This chapter provides a brief description of the commands that can be
used to configure and manage the Celerra Network Server.
◆The Celerra Network Server.............................................................. 12
◆Control Station..................................................................................... 13
◆Command set conventions ................................................................ 14
Overview

12 Celerra Network Server Command Reference Manual
Overview
The Celerra Network Server
The Celerra®Network Server is a dedicated file server solution that is
easily integrated into existing networks by using standard network
interface protocols.
Main components The Celerra Network Server hardware platform is the Celerra cabinet
that works in conjunction with a storage system to produce sharable
network accessible storage. The Celerra cabinet:
◆contains up to 14 Data Movers available as dedicated file servers
that provide access to file systems resident on the storage system
to a requesting client on the network.
◆includes a Control Station that manages all Data Mover functions
both locally and remotely.

Control Station 13
Overview
Control Station
The Control Station provides utilities for managing, configuring, and
monitoring of the Data Movers in the Celerra Network Server.
As the system administrator, you may enter commands through the
control station to perform tasks that include the following:
◆Managing and Configuring of the database and Data Movers.
◆Monitoring statistics of the Celerra cabinet components.
Accessing the
Control Station You may use either local or remote access to the control station.
Local Local access of the command line interface is available directly at the
control station console.
Remote Remote access (through rlogin or telnet) using the command line
interface lets you use the Celerra Network Server command set.
Accessing the
Command Line
Interface
A description of how to gain local or remote access to the command
line interface for the Celerra Network Server follows.
Local For local access to the command line interface, at the prompt, log in
as nasadmin.
Remote For remote access to the command line interface:
1. Enter rlogin or telnet followed by the IP address of the control
station.
2. Log in as nasadmin.
You are now logged in at the command line interface.

14 Celerra Network Server Command Reference Manual
Overview
Command set conventions
This manual uses commonly known command set conventions for
the Celerra Network Server man pages. Each man page presents the
command name at the top of the man page followed by a brief
overview of what the command does. The Synposis contains the
actual command usage. The Description contains a more detailed
breakdown of the features of the command, and the Options describe
what each switch or option does specifically.
The See Also section refers to the technical modules that support the
feature, in addition to any other commands that interact with the
command. The Examples are at the end of the command.
The naming convention for the Data Mover variable in the command
line interface is <movername> (default = server_2 to server_15).
The commands are prefixed, then appear in alphabetical order.
Synopsis The synopsis is usage of each command. The synopsis appears in
courier typeface, with variables such as movername, file name, and
device name enclosed by angle brackets, with the command name
appearing in bold. The switches and other options also appearing in
bold and in most cases, prefixed by a minus sign:
server_umount { <movername> | ALL }[-perm |-temp]{-all | <fs_name> | <pathname>}
Required entries A switch or variable enclosed with curly brackets, or is not enclosed
at all indicates a required entry:
{<movername> | ALL }
Optional entries A switch or variable is enclosed with square brackets indicates an
optional entry:
[-perm |-temp]
Formatting The variable name (enclosed by angle brackets) indicates the name of
a specified object
{<movername> | ALL }
Options An option is prefixed with a minus (-) sign: -perm
If the option is spelled out, for example -perm, in the command
syntax, you may use just the first letter: -p

Command set conventions 15
Overview
Options and names are case sensitive. If an uppercase letter is
specified in the syntax, a lowercase letter is not accepted.
The vertical bar symbol ( |) represents or, meaning an alternate
selection:
{ -all | <fs_name> | <pathname> }
Command prefixes Commands are prefixed depending on to what they are
administering. For example, commands prefixed with:
◆cel_ execute to the remotely-linked Celerra system.
◆cs_ execute to the Control Station.
◆fs_ execute to the specified file system.
◆nas_ execute directly to the Control Station database.
◆server_ require a movername entry and execute directly to a Data
Mover.

16 Celerra Network Server Command Reference Manual
Overview

The cel and cs Commands 17
2
This chapter lists the Celerra Network Server Command Set provided
for managing, configuring, and monitoring of Data Movers. The
commands are prefixed with cel or cs, and appear alphabetically. The
prefix assigned to a command indicates what the command is
administering. The cel prefix administers to the remote Celerra
Network Server, and cs administers to the local Control Station. The
command line syntax (Synopsis), a description of the options, and an
example of usage are provided for each command.
The cel and cs
Commands

18 Celerra Network Server Command Reference Manual
The cel and cs Commands
cel_fs
Manages file systems residing on a remotely-linked Celerra Network
Server.
SYNOPSIS
cel_fs <cel_name>
-list
| -info [-size]{-all | {<fs_name> | id=<fs_id>},...}
| -Extract {-all | {<fs_name> | id=<fs_id> },...}
| -Import {{<fs_name>,...} | -file <filename>}
DESCRIPTION From the remotely-linked Celerra Network Server, cel_fs imports
and enables the definition of a remote file system known as the R2,
onto the local system known as the R1. The <cel_name> is the default
hostname of the remote Control Station active during installation, or
when performing a nas_rdf -init to set up the RDF environment. To
find the <cel_name>, go to nas_cel and execute the -list option. The
local Celerra Network Server, by default has an ID of 0 (zero).
cel_fs displays a listing of the file systems residing on the remote
Celerra Network Server including their attributes.
This command is used in FarCopy and NearCopy environments.
OPTIONS -list
Lists all of the file systems residing on the remote Celerra Network
Server as specified by its <cel_name>.
Note: The ID of the object is an integer and is assigned automatically. The
name of a file system may be truncated if it is too long for the display. To
display the full name, use the -info option with a file system ID.
-info [-size] { -all | {<fs_name> | id=<fs_id>},...}
Displays the attributes and size of the file system residing on the
<cel_name>. The <fs_name> can be a file system name or group
name and can be up to 16 characters.
-Extract { -all | {<fs_name> | id=<fs_id>},...}
Extracts all file system attributes that can be redirected for import
into the Celerra Network Server. The second <fs_name> specifies a
file system where the attributes can be imported.

cel_fs 19
The cel and cs Commands
-Import {{ <fs_name>,...} | -file <filename>}
Imports file system attributes obtained from the extraction of a file
system definition either from the specified <fs_name> or <filename>.
SEE ALSO Using SRDF/S with Celerra for Disaster Recovery, nas_cel, nas_fs,
nas_rdf, fs_group.
EXAMPLE #1 To display a listing of the file systems residing on the remote Celerra
Network Server, cs30, type:
$cel_fs cs30 -list
id inuse type acl volume name server
1 n 1 0 66 root_fs_1
2 y 1 0 68 root_fs_2 1
3 y 1 0 70 root_fs_3 2
4 y 1 0 72 root_fs_4 3
5 y 1 0 74 root_fs_5 4
6 n 1 0 76 root_fs_6
7 n 1 0 78 root_fs_7
8 n 1 0 80 root_fs_8
9 n 1 0 82 root_fs_9
10 n 1 0 84 root_fs_10
11 n 1 0 86 root_fs_11
12 n 1 0 88 root_fs_12
13 n 1 0 90 root_fs_13
14 n 1 0 92 root_fs_14
15 n 1 0 94 root_fs_15
16 y 1 0 96 root_fs_common 4,3,2,1
17 n 5 0 145 root_fs_ufslog
18 y 1 0 156 ufs1 1
Where:
EXAMPLE #2 To display the attributes and the size for ufs1 on cs30, type:
$ cel_fs cs30 -info -size ufs1
id = 18
name = ufs1
acl = 0
in_use = True
type = uxfs
volume = mtv1
pool =
Value Definition
id ID of a file system (assigned automatically).
inuse whether a file system has been registered into the mount table.
type what type of file system. See nas_fs.
acl access control value for a file system. See nas_fs.
volume name of the volume on which a file system resides.
name name assigned to a file system.
server server associated with a file system.

20 Celerra Network Server Command Reference Manual
The cel and cs Commands
rw_servers= server_2
ro_servers=
rw_vdms =
ro_vdms =
size = total = 22660 avail = 22659 used = 0 ( 0% ) (sizes in MB)
volume: total = 23012 (sizes in MB)
stor_devs =
002804000190-0034,002804000190-0035,002804000190-0036,002804000190-0037
disks = d3,d4,d5,d6
disk=d3 stor_dev=002804000190-0034 addr=c0t3l8-15-0 server=server_2
disk=d4 stor_dev=002804000190-0035 addr=c0t3l9-15-0 server=server_2
disk=d5 stor_dev=002804000190-0036 addr=c0t3l10-15-0 server=server_2
disk=d6 stor_dev=002804000190-0037 addr=c0t3l11-15-0 server=server_2
Where:
EXAMPLE #3 To extract a file system definition for ufs1 from cs30, type:
$ cel_fs cs30 -Extract ufs1
0:bofs:18
18:ufs1:0:y:1:164:1::::0:::
164:mtv1:0:y:3:2:18:156:
156:stv1:0:y:2:1:164:64:3,4,5,6:
6:d6:0:y:4:1:156:6:
6:d6:0:y:5753:002804000190:1,2,3,4:6:0037:5:
5:d5:0:y:4:1:156:5:
5:d5:0:y:5753:002804000190:1,2,3,4:5:0036:5:
4:d4:0:y:4:1:156:4:
4:d4:0:y:5753:002804000190:1,2,3,4:4:0035:5:
3:d3:0:y:4:1:156:3:
3:d3:0:y:5753:002804000190:1,2,3,4:3:0034:5:
0:eof:18
Where: The output is the extracted file system definition.
Value Definition
id ID of a file system (assigned automatically).
name name of the imported file system.
acl access control value for a file system. See nas_fs.
inuse whether a file system has been registered into the mount table.
type what type of file system. See nas_fs.
volume name of the volume on which a file system resides.
pool storage pool for the file system.
rw_servers servers with read-write access.
ro_servers servers with read-only access.
rw_vdms VDM servers with read-write access to a file system
ro_vdms VDM servers with read-only access to a file system.
size total size, available size, and amount used in MB.
volume volume size that is used.
stor_devs ID of the storage system device and the serial number.
disks the disks on which a file system resides - dd indicates a remote disk.