Contents 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...
Page 5
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...
Page 6
Contents Celerra Network Server Command Reference Manual...
Page 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.
Page 8
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).
Page 9
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.
Page 10
Preface Celerra Network Server Command Reference Manual...
Page 11
Overview 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...
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:...
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.
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.
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.
Page 16
Overview Celerra Network Server Command Reference Manual...
The cel and cs Commands 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.
<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.
Page 19
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 inuse type acl volume...
Page 20
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. Celerra Network Server Command Reference Manual...
Page 21
-Import option. Value Definition system ID of the remote file system. backup_of number of MB copied from the file system on the remote Celerra Network remainder Server. EXAMPLE #6 To import a remote file system definition from the file, extract-file,...
Page 22
The cel and cs Commands stor_devs = 002804000218-0034,002804000218-0035,002804000218-0036, 002804000218-0037 disks = dd3,dd4,dd5,dd6 See Example #2 and Example #6 for a description of command output. Celerra Network Server Command Reference Manual...
The cel and cs Commands cs_standby Initiates a takeover and failover of a Control Station on a Celerra Network Server with dual Control Stations. SYNOPSIS cs_standby { -takeover | -failover } DESCRIPTION cs_standby initiates a Control Station takeover and failover. When a Control Station is activated, the name of the primary Control Station is displayed.
Page 24
Control Station, cd to the directory of the primary /nas/sbin Control Station, then type: #./cs_standby -failover The system will reboot, do you wish to continue [yes or no]: y Failing over from Primary Control Station Celerra Network Server Command Reference Manual...
The fs Commands This chapter lists the Celerra Network Server Command Set provided for managing, configuring, and monitoring of the specified file system. The commands are prefixed with fs and appear alphabetically. The command line syntax (Synopsis), a description of the options, and an example of usage are provided for each command.
PFS as specified by the <name>. The checkpoint must be unmounted prior to unmounting the PFS. Names assigned to a checkpoint cannot be all numeric. If a name is not chosen, one is assigned by default. Celerra Network Server Command Reference Manual...
Page 27
The fs Commands [<volume_name>] Specifies an unused metavolume for the checkpoint. A volume can be specified for only the first checkpoint of a PFS since all of the subsequent checkpoints share the same SavVol. Note: The minimum size required for a SavVol is 64 MB. The volume size is 10 gigabytes unless the PFS is less than 10 gigabytes, then the volume is the same size as the file system.
Page 28
PFS. This for protection in the event that the restored image is discarded. [-Force] The -Force option must be used when restoring a production file system with File-Level retention enabled. Celerra Network Server Command Reference Manual...
Page 29
75 (default). automount=no Stops the checkpoint from being automatically mounted. SEE ALSO Using SnapSure on Celerra, nas_fs, nas_pool. BACKEND OUTPUT The number associated with the storage device is dependent on the attached backend of the system. CLARiiON backends display a prefix of APM before a set of integers, for example, APM00033900124-0019.
Page 30
SavVol usage point which, when reached, sends a warning message to the system log, and auto-extends the SavVol as system space permits. storage system devices associated with a file system. stor_devs disks on which the metavolume resides. disks Celerra Network Server Command Reference Manual...
Page 31
The fs Commands EXAMPLE #2 To create a checkpoint of ufs1 named ufs1_ckpt2 with a size of 2 gigabytes using the clar_r5_performance pool, with the specified storage system, with the %full set to 95, type: $ fs_ckpt ufs1 -name ufs1_ckpt2 -Create size=2G pool=clar_r5_performance storage=APM00043807043 -option %full=95 operation in progress (not interruptible)...id = 27...
Page 32
Using root command, to restore ufs1_ckpt2 and capture the latest point-in-time image of the PFS on ufs1_ckpt3, type: $ /nas/sbin/rootfs_ckpt ufs1_ckpt2 -name ufs1_ckpt3 -Restore operation in progress (not interruptible)...id = 30 name = ufs1_ckpt2 Celerra Network Server Command Reference Manual...
Page 33
The fs Commands in_use = True type = ckpt worm = off volume = vp145 pool member_of = rw_servers= ro_servers= server_2 rw_vdms ro_vdms checkpt_of= ufs1 Wed Nov 10 14:02:59 EST 2004 used = 0% full(mark)= 90% stor_devs = APM00043807043-0011,APM00043807043-0017 disks = d12,d15 disk=d12 stor_dev=APM00043807043-0011 addr=c16t1l1...
The interface or IP address for the source and destination file system can be specified. The <cel_name> specified after the <dstfs> specifies the remote Celerra Network Server where the copy is to take place. If a <cel_name> is not specified, the copy is local.
Page 35
The -Force flag should only be used when explicitly directed in the Using Celerra Replicator, or on the instruction of EMC Customer Support. The -Force flag is mainly used within the procedure to transport an initial copy of a file system via tape or disk for Celerra Replicator.
Page 36
EXAMPLE #1 To create a complete copy of the file system, srcufs1_ckpt1 using the interface cge0, to the dstufs1 file system on the remote Celerra Network Server, cs100, using the interface cge0, and leaving the destination file system as rawfs, and set the maximum transfer...
Page 38
IP address of the Celerra Network Server serving as the source. source_ip_address IP address of the Celerra Network Server serving as the destination.
Page 39
See Example #1 for additional description of command outputs. EXAMPLE #5 To initiate the differential copy of srcufs1_ckpt2 on the interface, cge0 to the dstufs1 file system on the remote Celerra Network Server, cs100, using the cge0 interface, using srcufs1_ckpt1 as the starting point, type:...
Page 40
IP Copy remaining (%) 100..Done. done See Example #1 for a description of command outputs. Celerra Network Server Command Reference Manual...
[-localPort <port>] [-user <username>] [-password <password>] [-timeout <seconds>]} DESCRIPTION fs_dhsm modifies the properties on file systems enabled for Celerra FileMover. fs_dhsm creates, deletes, and modifies NFS, CIFS, and HTTP connections to remote hosts, lists Celerra FileMover file systems, and provides information on the connections.
Page 42
The fs Commands -info [<fs_name>|id=<fs_id>] Displays information for the specified Celerra FileMover file systems. -modify {<fs_name>|id=<fs_id>} Sets Celerra FileMover parameters for the specified file system. Note: When specifying the -modify option on a disabled file system, the state is automatically changed to enabled. To maintain the disabled state, specify -state disabled.
Page 43
-connection [<fs_name> | id=<fs_id>] -info [<cid>] Displays details on all Celerra FileMover connections or details on all connections for the specified file system. If the <cid> is specified, only information for that connection is displayed.
Page 44
The fs Commands Note: Although an IP address can be specified for an <nfs_server>, EMC strongly suggests using the hostname of the server, which allows you to take advantage of DNS failover capability. [-read_policy_override {full|passthrough|partial|none}] Specifies the migration method for data recall in response to client read requests.
Page 45
The fs Commands [-mntVer {1|2|3}] Specifies the mount version for the NFS connection. If the -type is nfsv3, then the -mntVer must be 3. If the -type is nfsv2, then 1 or 2 can be specified. The default for nfsv2 is 2. [-localPort <port>] Overrides the default port that the Data Mover uses during connection to be compatible with firewalls.
Page 46
Note: Although an IP address can be specified for a <host>, EMC strongly suggests using the hostname of the server, which allows the DNS failover capability.
Page 47
Use the -password option when digest authentication is required by the secondary storage HTTP server. [-timeout <seconds> Specifies the timeout value in seconds. By default, the Celerra HTTP client waits 30 seconds for a reply from the HTTP server and then retries the operation once.
Page 48
Celerra Network Server before the connection is removed. If no is specified and stub files exist, an I/O error appears when the file is read because the connection no longer exists.
Page 49
CONNECTIONS Specifies the name or IP address of the secondary NFS server. Note: Although an IP address can be specified for the <nfs_server>, EMC strongly suggests using the hostname of the server, which allows use of the DNS failover capability.
Page 50
[-password <password>] Allows the user to specify the admin password. The password is not recorded in the command log. If the -password option is given but no password is specified, the user is prompted interactively. Celerra Network Server Command Reference Manual...
Page 51
Done Where: Value Definition whether Celerra FileMover is enabled or disabled on the file system. state whether CIFS clients should be notified that a file is migrated. offline attr timeout value in seconds, before Windows popup notification is sent to the CIFS client.
Page 52
IP address of the remote file system. secondary specifies whether Celerra FileMover is enabled or disabled on the file system. state migration method option used to override the read method specified in the stub file. read policy override write policy option used to recall data from secondary storage.
Page 53
The fs Commands write policy full local_server = DM102-CGE0.NASDOCS.EMC.COM admin = nasdocs.emc.com\Administrator wins = 172.24.102.25 Done See Example #2 for a description of command output. EXAMPLE #4 To display connection information for ufs1, type: $ fs_dhsm -connection ufs1 -info 1...
Page 54
The fs Commands EXAMPLE #6 To modify the Celerra FileMover connection for ufs1, type: $ fs_dhsm -connection ufs1 -modify 0 -nfs_server 172.24.102.115 -proto TCP ufs1: state = enabled offline attr = on popup timeout = 10 backup = offline read policy override = full...
Page 55
= useRootCred=true proto=UDP Done See Example #2 for a description of command output. EXAMPLE #8 To modify the Celerra FileMover connection for ufs1, type: $ fs_dhsm -connection ufs1 -modify 1 -proto TCP ufs1: state = enabled offline attr...
Page 56
The fs Commands See Example #2 for a description of command output. EXAMPLE #9 To display Celerra FileMover connection information for ufs1, type: $ fs_dhsm -info ufs1 ufs1: state = enabled offline attr = on popup timeout backup = passthrough...
Page 57
= useRootCred=true proto=TCP Done See Example #2 for a description of command output. EXAMPLE #12 To modify the state of the Celerra FileMover connection 0 for ufs1, type: $ fs_dhsm -connection ufs1 -modify 0 -state disabled ufs1: state = enabled...
Page 58
See Example #2 for a description of command output. EXAMPLE #14 To delete the Celerra FileMover connections 1 and 2 for ufs1, and specify the recall policy for any migrated files during the delete, type: $ fs_dhsm -connection ufs1 -delete 0,1 -recall_policy...
Page 59
The fs Commands Done See Example #1 for a description of command output. EXAMPLE #16 To delete the Celerra FileMover connection 0 for ufs1, type: $ fs_dhsm -connection ufs1 -delete 0 ufs1: state = enabled offline attr = on popup timeout...
Page 60
= passthrough read policy override = none log file = on max log size = 10MB type = HTTP secondary http://www.nasdocs.emc.com/cgi-bin/access.sh state = enabled read policy override = none write policy full user options Done Celerra Network Server Command Reference Manual...
Removes the specified file system(s) or group from a file system group. Individual file systems are not deleted. SEE ALSO Managing Celerra Volumes and File Systems Manually and Using TimeFinder/FS, Near Copy, and Far Copy with Celerra, fs_timefinder, nas_fs. fs_group...
Page 62
EXAMPLE #3 To display information for the file system group, ufsg1, type: $ fs_group -info ufsg1 = 22 name = ufsg1 in_use = False type = group fs_set = ufs1 pool Celerra Network Server Command Reference Manual...
Page 63
The fs Commands stor_devs = 000187940268-0006,000187940268-0007,000187940268-0008,000187940268-0009 disks = d3,d4,d5,d6 See Example #1 for a description of command output. EXAMPLE #4 To add file system, ufs2, to the file system group, ufsg1, type: $ fs_group -xtend ufsg1 ufs2 = 22 name = ufsg1 in_use = False...
{<fs_name> | id=<fs_id>} -Mirror {on | off | refresh} | -Restore [-Force] | -info Note: RDF is supported only on a Celerra Network Server attached to a Symmetrix. DESCRIPTION fs_rdf turns mirroring on and off for an RDF file system and displays information about RDF relationships.
Page 66
OFFLINE_PEND, ONLINE_MIXED specifies the state of the RA director coming online after power on. Possible states are: prevent_ra_online_upon_p wron ENABLED, DISABLED the serial number of the storage system containing the target volume. remote_symid Celerra Network Server Command Reference Manual...
Page 67
The fs Commands the storage system device name of the remote device in an RDF pair. remote_sym_devname the RA group number (1-n). ra_group_number the type of RDF device. Possible values are: R1 and R2 dev_rdf_type EXAMPLE #2 To display RDF related information for ufs1_snap1 from the R2 Control Station, type: $ fs_rdf ufs1_snap1 -info = 20...
Page 68
= READY remote_dev_rdf_state = WRITE_DISABLED rdf_status link_domino = DISABLED prevent_auto_link_recovery = DISABLED link_config suspend_state = OFFLINE consistency_state = DISABLED adaptive_copy_wp_state = NA prevent_ra_online_upon_pwron = ENABLED See Example #1 for a description of command output. Celerra Network Server Command Reference Manual...
Page 69
The fs Commands EXAMPLE #4 To perform a mirror refresh for ufs1_snap1 on the R1 Control Station, type: $ fs_rdf ufs1_snap1 -Mirror refresh remainder(MB) = 1 0 = 20 name = ufs1_snap1 in_use = False type = uxfs volume = v168 pool rw_servers= ro_servers=...
Page 70
= READY remote_dev_rdf_state = WRITE_DISABLED rdf_status link_domino = DISABLED prevent_auto_link_recovery = DISABLED link_config suspend_state = NA consistency_state = DISABLED adaptive_copy_wp_state = NA prevent_ra_online_upon_pwron = ENABLED See Example #1 for a description of command output. Celerra Network Server Command Reference Manual...
Replication takes place locally unless a remote Celerra Network Server name is specified. OPTIONS -list Lists all the replication instances.
Page 72
The <dstfs> must be a rawfs (see nas_fs) type, be the same size in blocks as the <srcfs>, and mounted read-only. For the <dstfs>, the [:cel=<cel_name>[:if=<interface>|:ip=<ip_addr>]] option specifies the Celerra Network Server where replication is to take place. Replication takes place locally unless a remote Celerra Network Server is specified.
Page 73
Stops replication on the remote, destination side Celerra Network Server. -refresh <fs_name1>[,<fs_name2>[:cel=<cel_name>]] Updates and refreshes the <srcfs> and the <dstfs> with the specified options. The refresh is local unless a remote Celerra Network Server is specified. [:cel=<cel_name>] Indicates the remote Celerra Network Server containing the file system, that is to be refreshed.
Page 74
Generates or plays back a delta set based on the time interval specified in seconds (default=600). If a value is specified using to= and both file systems are specified in the command line, that value is applied to both the source and destination file systems. Celerra Network Server Command Reference Manual...
Page 75
-failover <srcfs>[:cel=<cel_name>] <dstfs> Executed from the Celerra Network Server hosting the <dstfs>, fails over the <srcfs> on the specified Celerra Network Server onto a <dstfs>. After the failover, the <dstfs> is mounted read/write. If the <srcfs> is still available at the time of failover, it will be mounted read-only.
Page 76
If a value is specified using hwm= and both file systems are specified in the command line, that value is applied to both the source and destination file systems. Celerra Network Server Command Reference Manual...
Page 77
The fs Commands dhwm=<destination high_water_mark> Specifies a threshold in megabytes (default=600) for playing back a delta set based on a storage space threshold. The threshold is the amount of change allowed before triggering delta set activity. qos=<qos> Specifies the maximum network bandwidth in kilobits per second that can be used for the replication session.
Page 78
[-Cfg <srccfgvol_name>[,<dstcfgvol_name>]] [-option <options>] See -start for a description of all the options. -suspend <srcfs> <dstfs>[:cel=<cel_name>] Leaves replication in a condition where it can be restarted, but stops the playback and replication services from running. Celerra Network Server Command Reference Manual...
Page 79
The fs Commands -info { <fs_name>[id=<session_id>] Displays the status of the replication instance for the file system on the specified Celerra Network Server or the file system group. [ -verbose <number_of_lines> ] Displays historical information about the file system replication in the number of lines specified.
Page 80
VDM servers with read/write access to a file system. rw_vdms VDM servers with read-only access to a file system. ro_vdms checkpoint names associated with the file system. ckpts ip_copies name of the destination file system where the source file system is replicated. Celerra Network Server Command Reference Manual...
Page 81
The fs Commands stor_devs storage system devices associated with a file system. disks on which the metavolume resides. disks backup_of name on the source file system. fs_replicate...
Page 83
The fs Commands Note: All times are in GMT. Block size is 8 KBytes. Where: The output for this command is divided into sections: Source file system Destination file system Communication state between the Celerras If you specify the verbose option when you run the command Value For the Source File System Definition ID of the source file system.
Page 84
Where: Value For the Communication between Celerras Definition whether the Data Movers on each Celerra system can communicate with each other. communication_state current_transfer_rate rate at which the last 128 MB of data was sent across the IP network. average rate at which the last 128 sets of data were sent across the IP network.
Page 87
The fs Commands source_ip = 172.24.102.238 source_port = 56686 destination_ip = 172.24.102.242 destination_port = 8888 QOS_bandwidth = 0 kbits/sec Note: All times are in GMT. Block size is 8 KBytes. done See Example #2 for a description of the output. EXAMPLE #6 To stop the playback and replication services from running and leave replication in a condition where it can be restarted, on the source...
Page 88
= 93 name = root_suspend_ckpt_30_1 in_use = True type = ckpt worm = off volume = vp159 pool = clar_r5_performance Celerra Network Server Command Reference Manual...
Page 91
The fs Commands avg_transfer_rate = ~ 13312 Kbits/second source_ip = 172.24.102.238 source_port = 56675 destination_ip = 172.24.102.243 destination_port = 8888 QOS_bandwidth = 0 kbits/sec Note: All times are in GMT. Block size is 8 KBytes. done operation in progress (not interruptible)...id = 58 name = src_ufs1...
Page 92
Operation complete done See Example #1 and #2 for a description of the output. EXAMPLE #7 To restart a suspended replication relationship, on the source Control Station type: $ fs_replicate -restart src_ufs1 dst_ufs1:cel=cs110 Celerra Network Server Command Reference Manual...
Page 93
The fs Commands operation in progress (not interruptible)...Starting replication... operation in progress (not interruptible)...id = 58 name = src_ufs1 in_use = True type = uxfs worm = off volume = v156 pool = clar_r5_performance member_of = root_avm_fs_group_3 rw_servers= server_2 ro_servers= rw_vdms ro_vdms ckpts...
Page 94
= 82 name = root_new_ckpt_src_ufs1 in_use = True type = ckpt Celerra Network Server Command Reference Manual...
Page 95
The fs Commands worm = off volume = vp159 pool = clar_r5_performance member_of = rw_servers= ro_servers= server_2 rw_vdms ro_vdms checkpt_of= src_ufs1 Thu Jan 13 14:51:56 EST 2005 used = 38% full(mark)= 90% stor_devs = APM00042000818-0014,APM00042000818-001B,APM00042000818-0018,APM00042 000818-0017 disks = d21,d12,d19,d10 disk=d21 stor_dev=APM00042000818-0014 addr=c16t0l15 server=server_2 disk=d21...
Page 96
IP Copy remaining (%) 100..Done. done Deleting root_suspend_ckpt_30_1... = 77 name = root_suspend_ckpt_30_1 in_use = False type = ckpt worm = off volume Celerra Network Server Command Reference Manual...
Page 97
The fs Commands rw_servers= ro_servers= rw_vdms ro_vdms Deleting root_new_ckpt_src_ufs1... = 82 name = root_new_ckpt_src_ufs1 in_use = False type = ckpt worm = off volume rw_servers= ro_servers= rw_vdms ro_vdms Operation complete done See Example #1 and #2 for a description of the output. EXAMPLE #8 To fail over a replication relationship, from the destination Control Station, type:...
Page 98
(not interruptible)...Converting filesystem type = 58 name = src_ufs1 in_use = True type = rawfs worm = off volume = v156 pool = clar_r5_performance member_of = root_avm_fs_group_3 rw_servers= ro_servers= server_2 rw_vdms Celerra Network Server Command Reference Manual...
The Symmetrix must already have BCVs configured to the same size as the volumes on the Celerra Network Server. Once the copy has been made of the file system, the copy can be mounted on any Data Mover.
Page 109
In a TimeFinder/FS FarCopy configuration, use disktype=R1BCV for creating a snapshot of the PFS on the local Celerra. For creating a snapshot of an imported FarCopy snapshot on the remote Celerra, use disktype=STD.
Page 110
Specifies the following comma-separated option(s): mirror=on Places the file system copy in mirrored mode. SEE ALSO Using TimeFinder/FS, Near Copy, and Far Copy with Celerra, fs_ckpt, fs_group, nas_fs. EXAMPLE #1 To create a TimeFinder/FS copy of the PFS, type: $ fs_timefinder ufs1 -Snapshot operation in progress (not interruptible)...
Page 111
The fs Commands = 19 name = ufs1_snap1 in_use = False type = uxfs worm = off volume = v456 pool rw_servers= ro_servers= rw_vdms ro_vdms backup_of = ufs1 Thu Oct 28 14:13:30 EDT 2004 stor_devs = 000187940268-0180,000187940268-0181,000187940268-0182,000187940268-0183 disks = rootd378,rootd379,rootd380,rootd381 Where: Value Definition...
Page 112
(not interruptible)...id = 18 name = ufs1 in_use = True type = uxfs worm = off volume = mtv1 pool rw_servers= server_2 ro_servers= rw_vdms ro_vdms backups = ufs1_snap1 stor_devs = 000187940268-0006,000187940268-0007,000187940268-0008,000187940268-0009 Celerra Network Server Command Reference Manual...
The nas Commands This chapter lists the Celerra Network Server Command Set provided for managing, configuring, and monitoring of NAS database. The commands are prefixed with nas and appear alphabetically. The command line syntax (Synopsis), a description of the options, and an example of usage are provided for each command.
The <numerical_id> can be a user ID (UID) or group ID (GID). Note: Before executing this command, the user or group must exist in the Control Station in the /etc/passwd file or the /etc/group file. Celerra Network Server Command Reference Manual...
Page 119
{[num_id=<numerical_id> ] [,level=<acl_level> ] } Modifies the <numerical_id> and level for an access control level entry. SEE ALSO Controlling Access to Celerra System Objects, nas_fs, nas_volume, nas_server, and nas_storage. EXAMPLE #1 Before creating access control level entries, su to root. To create...
Page 120
EXAMPLE #4 To modify an access control level entry, type: nas_acl -modify -user 211 level=7 done EXAMPLE #5 To delete an access control level entry, type: # nas_acl -delete -user 211 done Celerra Network Server Command Reference Manual...
The nas Commands nas_automountmap Manages the automount map file. SYNOPSIS nas_automountmap -list_conflict <infile> [ -out <outfile> ] | -create [ -in <infile> ] [ -out <outfile> ] DESCRIPTION nas_automountmap creates and displays an automount map containing all permanently exported file systems used by the automount daemon.
Page 122
The nas Commands EXAMPLE #4 To merge an automountmap file with an existing map file, type: $ nas_automountmap -create -in automountmap -out automountmap1 Celerra Network Server Command Reference Manual...
Note: The ID of the object is an integer and is assigned automatically. The name of the Celerra Network Server may be truncated if it is too long for the display. To view the full name, use the -info option with the Celerra Network Server ID.
Page 124
The -create must first be executed on the source Celerra (to identify the destination Celerra) and then on the destination Celerra (to identify the source Celerra). If a name is not specified, one is assigned automatically. The IP address specified represents the appropriate remote Celerra’s primary Control Station (in slot 0);...
Page 125
Where: Value Definition ID of the remote Celerra Network Server. name assigned in the local view to the remote Celerra Network Server. name ACL ID assigned automatically. owner R2 device mounted by the local control station to read the data base of the remote control station in the SRDF device environment.
Page 126
ACL ID assigned automatically. owner mount_dev mounted database from the remote Celerra Network Server in the SRDF environment. This value is unique to the Symmetrix backend. RDF channel from where information is read and written. This value is unique to the Symmetrix backend.
Page 127
= APM000438070430000 passphrase = nasdocs_replication See Example #1 for a description of command output. EXAMPLE #6 To delete the Control Station entry of the remote Celerra Network Server, cs110, type: # nas_cel -delete cs110_target operation in progress (not interruptible)...
OPTIONS No arguments Runs a series of system health checks on the Celerra and reports the problems that are found and the actions needed to fix the problem. Note: No e-mail, callhome, or Celerra Manager alert is posted when the health check is run unscheduled.
Page 129
/nas/log/syslog contains the overall results of nas_checkup. /nas/site/checkup_eventlog.cfg provides a sample nas_checkup event configuration file. This is the file to be modified to add email addresses and load the file. SEE ALSO Configuring Celerra Events and Notifications. nas_checkup...
Page 130
The nas Commands EXAMPLE #1 To run a health check on the Celerra Network Server, type: $ nas_checkup Check Version: 5.5.75.0 Check Command: /nas/bin/nas_checkup Check Log /nas/log/nas_checkup-run.Sep-28-13:00:36.log -------------------------------------Checks------------------------------------- Control Station: Checking if minimum free space exists ns....Pass Control Station: Checking if enough free space exists ns....Pass Control Station: Checking if NAS Storage API is installed correctly..
Page 131
The nas Commands EXAMPLE #2 To display help for nas_checkup, type: $ nas_checkup -help Check Version: 5.5.75.0 Check Command: /nas/bin/nas_checkup usage: nas_checkup [ -help | -version ] EXAMPLE #3 To display the version of nas_checkup utility, type: $ nas_checkup -version Check Version: 5.5.75.0 Check Command:...
The nas Commands nas_ckpt_schedule Manages SnapSure checkpoint scheduling for the Celerra Network Server. SYNOPSIS nas_ckpt_schedule -list | -info {-all | <name> | id=<id>} | -create <name> -filesystem {<name> | id=<id>} [-description <description>] -recurrence { once [-start_on <YYYY-MM-DD>] -runtime <HH:MM> [-ckpt_name <ckpt_name>] | daily [ -every <number_of_days>...
Page 133
The nas Commands -info { -all | <name>| id=<id>} Lists detailed information for all schedules or for the specified schedule. -create <name> -filesystem {<name> | id=<id>} [-description <description>] -recurrence { Creates a snapshot schedule for the specified file system. The -description option provides a label for the schedule and the -recurrence option determines whether the schedule defines a checkpoint event or a schedule for taking checkpoints just once, or...
Page 135
-resume { <name> | id=<id>} Resumes a paused checkpoint schedule. SEE ALSO Using SnapSure on Celerra EXAMPLE #1 To create a checkpoint schedule that creates a checkpoint of the file system daily at 8:00 A.M. and 8:00 P.M. starting on 11/13/06...
Page 136
-days_of_month 10 This command returns no output. EXAMPLE #7 To get detailed information about checkpoint schedule, type: $ nas_ckpt_schedule -info ufs1_ckpt_sched3 id = 7 name = ufs1_ckpt_sched3 description = Monthly Checkpoint schedule for ufs1 Celerra Network Server Command Reference Manual...
Page 137
The nas Commands tasks = Checkpoint ckpt_ufs1_ckpt_sched3_001 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_002 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_003 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_004 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_005 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_006 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_007 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_008 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_009 on filesystem id=25, Checkpoint ckpt_ufs1_ckpt_sched3_010 on filesystem id=25, Checkpoint...
Control Station. The SSL certificate should be set up before using Celerra Manager, but after setting up or modifying the Control Station’s network configuration. Specifically, the hostname, DNS domain name, or IP address.
Page 139
Refer to the bash or csh shell man page for a description of how the mechanism works. SEE ALSO Celerra Network Server System Operations EXAMPLE #1 To create an IP alias for the Control Station with alias id 0, type: # /nas/sbin/nas_config -IPalias -create -name eth3 0 Do you want slot_0 IP address <172.24.95.244>...
Page 140
Session timeout is disabled done EXAMPLE #6 To set the session timeout value to 23 minutes, type: # /nas/sbin/nas_config -sessiontimeout 23 done EXAMPLE #7 To disable session timeout, type: # /nas/sbin/nas_config -sessiontimeout off done Celerra Network Server Command Reference Manual...
The nas Commands nas_connecthome Configures email, FTP, and modem transport mechanisms for transporting Callhome event files to user-configured destinations. SYNOPSIS nas_connecthome -info | -test {-email_1|-email_2|-ftp_1|-ftp_2|-modem_1|-modem_2} | -modify [–modem_priority {Disabled|1|2|3}] [-modem_number <phone_number>] [-modem_bt_tymnet {yes|no}] [-modem_number_2 <phone_number>] [-modem_bt_tymnet_2 {yes|no}] [-ftp_priority {Disabled|1|2|3}] [-ftp_ipport <ip_addr>[:<port>]] [-ftp_user <username>] [-ftp_passwd [<passwd>]] [-ftp_folder <path>]...
Page 142
[-modem_bt_tymnet_2 { yes |no }] Enables or disables the secondary BT Tymnet parameter of the modem. Note: Specifying "" (empty double quotes) reverts to the default value of Celerra Network Server Command Reference Manual...
Page 143
The nas Commands [-ftp_priority { Disabled|1 |2 |3 }] Enables FTP as a Primary, Secondary, or Tertiary transport mechanism. Specifying Disabled removes FTP as a transport mechanism. [-ftp_ipport <ip_addr>[:<port>]] Sets or modifies the IP address of the primary FTP server and corresponding port.
Page 144
[ -email_from <email_addr> ] Sets or modifies the sender's email address. The maximum number of characters that can be specified is 63. Note: Specifying "" (empty double qoutes) reverts to the default value of connectemc@emc.com Celerra Network Server Command Reference Manual...
Page 145
Note: Specifying "" (empty double quotes) does not disable the number or restore its default value. The empty string is stored as is. [-serial_number <serial_number>] Sets or modifies the Celerra serial number, if it was not automatically detected. Note: Specifying "" (empty double quotes) does not disable the number or restore its default value.
Page 146
Encryption Enabled = yes Dial In : Enabled = yes Modem phone number = 9123123123 Site ID = MY SITE Serial number = APM00054703223 Email : Priority Sender Address = admin@yourcompany.com Recipient Address(es) = emailalert@emc.com Celerra Network Server Command Reference Manual...
Page 147
To test the primary email server, type: # /nas/sbin/nas_connecthome -test -email_1 --------------------------------------------------------- ConnectEMC 2.0.27-bl18 Wed Aug 22 10:24:32 EDT 2007 RSC API Version: 2.0.27-bl18 Copyright (C) EMC Corporation 2003-2007, all rights reserved. --------------------------------------------------------- Reading configuration file: ConnectEMC.ini. Run Service begin... Test succeeded for Primary Email.
LUNs are part of a MirrorView/S consistency group On the source Celerra, root permission is needed to issue the -acl, -suspend, and -resume options. nas_devicegroup must be run from a Control Station in slot 0; it will report an error if run from a Control Station in slot 1.
Page 149
-resume {<name>|id=<id>} Resumes device group operations and restarts mirroring, synchronizing the destination LUNs with the source LUNs. SEE ALSO Using MirrorView/Synchronous with Celerra for Disaster Recovery, nas_acl, nas_mview. BACKEND OUTPUT The number associated with the storage device is dependent on the attached backend of the system;...
Page 150
= Consistent role = Primary condition = Active recovery policy = Automatic number of mirrors = 16 mode = SYNC owner = 500 mirrored disks local clarid = APM00053001549 remote clarid = APM00053001552 Celerra Network Server Command Reference Manual...
Page 151
The nas Commands mirror direction = local -> remote EXAMPLE #4 To halt operation of the specified device group, as root user, type: # nas_devicegroup -suspend mviewgroup Sync with CLARiiON backend ..done STARTING an MV 'SUSPEND' operation. Device group: mviewgroup .... done The MV 'SUSPEND' operation SUCCEEDED.
-delete <disk_name> [ -perm] Deletes an entry from the disk table. Unless the -perm is specified, the disk is still identified as a Celerra disk and can be discovered and marked again using server_devconfig. The -perm option removes the entry from the disk table and deletes the diskmark.
Page 153
The nas Commands EXAMPLE #1 For the Celerra Network Server with a CLARiiON backend, to list the disk table, type: $ nas_disk -list inuse sizeMB storageID-devID type name servers 11263 APM00042000818-0000 CLSTD root_disk 1,2,3,4 11263 APM00042000818-0001 CLSTD root_ldisk 1,2,3,4 2047...
Page 154
EXAMPLE #2 For the Celerra Network Server with a CLARiiON backend, to view information for a specific disk such as size, type and ACL, type: $ nas_disk -info d7 name = d7...
Page 155
(SCSI address). addr EXAMPLE #3 For the Celerra Network Server with a CLARiiON backend, to rename a disk, type: $ nas_disk -rename d7 disk7 name = disk7 in_use...
Page 156
= server_5 addr=c48t1l2 See Example #2 for a description of command output. EXAMPLE #4 For the Celerra Network Server with a CLARiiON backend, to delete a disk entry from the disk table, type: $ nas_disk -delete d24 = 24...
DESCRIPTION nas_event provides a user interface to system-wide events within the Celerra Network Server. The Celerra Network Server includes a default event configuration file that contains a mapping of facilities that generate events, and the associated actions triggered by those events.
Page 158
To list all of the facilities able to generate events, type: $ nas_event -list -f -info facility UPSMonitor LocalHardwareMonitor NaviEventMonitor NASDB JServer BoxMonitor MasterControl ACLUPD DHSM USRMAP SNAPSURE_SCHED CHAMIIENCMON VMCAST VRPL MGFS SVFS STORAGE SECURITY NDMP Celerra Network Server Command Reference Manual...
Page 159
The nas Commands FSTOOLS DRIVERS ADMIN EXAMPLE #4 To list the events for the LocalHardwareMonitor facility, type: $ nas_event -list -f LocalHardwareMonitor description 1.5V too high 1.5V too low Vccp1 too high Vccp1 too low 3.3V too high 3.3V too low 5V too high 5V too low 12V too high...
Page 160
MasterControl File system error MasterControl NBS Device Error MasterControl IPMI connection failure BoxMonitor EPP did not initialize BoxMonitor Mandatory thread create failed BoxMonitor SIB read failure BoxMonitor SIB write failure BoxMonitor AC power failure Celerra Network Server Command Reference Manual...
Page 161
The nas Commands BoxMonitor Fan 0 has failed BoxMonitor Fan 1 has failed BoxMonitor Both fans have failed BoxMonitor High temperature warning BoxMonitor High temperature failure BoxMonitor 12V DC supply high BoxMonitor 12V DC supply low BoxMonitor 5V DC supply high BoxMonitor 5V DC supply low BoxMonitor...
Page 162
Power Supply is OK BoxMonitor Fan fault BoxMonitor Fan is OK BoxMonitor Multiple Fan error BoxMonitor Slot boot error BoxMonitor Slot Managment Switch Reason Code Error BoxMonitor Management Switch Ping Failure BoxMonitor Both Management Switches Ping Failure Celerra Network Server Command Reference Manual...
Page 163
The nas Commands BoxMonitor Management Switch Network Port is Up BoxMonitor Management Switch Network Port is Down BoxMonitor State change request is ignored JServer Call Home - JServer failed to come up after 3 retries JServer Call Home - Generated debug file xxx from the core dump JServer Call Home - JServer reports nas_cmd errors JServer...
Page 164
A Environment contact closure has returned to it's default state UPSMonitor The UPS is on bypass due to an internal fault UPSMonitor UPS put on bypass by user via software or front UPS panel UPSMonitor UPS put on bypass by user Celerra Network Server Command Reference Manual...
Page 165
The nas Commands UPSMonitor The UPS has returned from bypass mode UPSMonitor The base module bypass power supply needs repair UPSMonitor The base module fan needs repair UPSMonitor Communication lost with external battery packs, check battery signal cable UPSMonitor Communication established with external battery packs UPSMonitor A battery run time calibration test has been initiated UPSMonitor...
Page 166
ID of the event is listed in the ID column. EXAMPLE #8 To unload the event configuration file, type: $ nas_event -Unload /nas/site/new_eventlog.cfg EventLog : will unload /nas/site/new_eventlog.cfg... done Celerra Network Server Command Reference Manual...
The nas Commands nas_fs Manages local file systems for the Celerra Network Server. SYNOPSIS nas_fs -list | -delete <fs_name> [-option <options>][-Force] | -info [-size] {-all | <fs_name>} [-option <options>] | -rename <old_name> <new_name> [-Force] | -size <fs_name> | -acl <acl_value> <fs_name>...
Page 168
NAS database and the Data Mover. If a file system is unmounted, data is reported from the NAS database only. The -size option also displays the total size of the file system and the block count in megabytes. Celerra Network Server Command Reference Manual...
Page 169
The <fs_name> must be a uxfs file system type mounted as read-write. The policy specified in the -from option instructs the Celerra Network Server which operating system (UNIX or Windows) to derive permissions from when migrating to the MIXED or MIXED_COMPAT access-checking policy (set with server_mount).
Page 170
The slice=n option gives the new file system exclusive access to the disk volumes it uses, and is relevant when using TimeFinder/FS. Celerra Network Server Command Reference Manual...
Page 171
The nas Commands When the symm_std, symm_std_rdf_src, symm_ata, and symm_ata_rdf_src pools are specified, the default is not to slice the volumes, which is overridden with slice=y. When the clar_r1, clar_r5_performance, clar_r5_economy, clarata_r3, clarata_archive, cm_r1, cm_r5_performance, cm_r5_economy, cmata_r3, and cmata_archive pools are specified, the default is to slice the volumes, which is overridden with slice=n.
Page 172
The file-level retention option can only be specified when creating a new file system; existing file systems cannot be converted. After a file system is enabled for file-level retention, it is persistently marked as such until the time when it is deleted. Celerra Network Server Command Reference Manual...
Page 173
The nas Commands CAUTION The enterprise version of file-level retention is intended for self-regulated archiving. The administrator is considered a trusted user and the file-level retention capability does not protect the archived data from the administrator’s actions. If the administrator attempts to delete the file system, the file system issues a warning message and prompts the administrator to confirm the operation.
Page 174
[-auto_extend {no|yes [-vp {no|yes}] For an AVM file system, turns Automatic File System Extension and virtual provisioning on or off, and sets a high water mark and maximum size for the file system. When Automatic File Celerra Network Server Command Reference Manual...
Page 175
The nas Commands System Extension is turned on, the file system is automatically extended up to the maximum size specified when the high water mark is reached. The default for -auto_extend is no. Virtual provisioning reports the maximum file system size to the CIFS, NFS, and FTP users, even if the actual size of the file system is smaller.
Page 176
Management, Managing Celerra Volumes and File Systems Manually, Controlling Access to Celerra System Objects, Using File-Level Retention on Celerra, Using TimeFinder/FS, Near Copy, and Far Copy with Celerra, and Using Celerra Replicator, fs_ckpt, fs_timefinder, nas_acl, nas_rdf, nas_volume, server_export, server_mount, server_mountpoint.
Page 177
The nas Commands BCV, R1BCV, R2BCV, ATA, R1ATA, R2ATA, BCVA, R1BCA, R2BCA. EXAMPLE #1 To create a file system named ufs1 on metavolume mtv1, type: $ nas_fs -name ufs1 -create mtv1 = 37 name = ufs1 in_use = False type = uxfs worm = off...
Page 179
The nas Commands name = ufs3 in_use = False type = rawfs worm = off volume = v173 pool = clar_r5_performance member_of = root_avm_fs_group_3 rw_servers= ro_servers= rw_vdms ro_vdms auto_ext = no,virtual_provision=no stor_devs = APM00042000818-001F,APM00042000818-001D,APM00042000818-0019,APM00042 000818-0016 disks = d20,d18,d14,d11 See Example #1 and Example #3 for a description of command output.
Page 180
The clar_r5_performance storage pool is available with the CLARiiON backend. EXAMPLE #8 To list all of the file systems in the NAS database, type: $ nas_fs -list inuse type acl volume name server root_fs_1 root_fs_2 Celerra Network Server Command Reference Manual...
Page 181
The nas Commands root_fs_3 root_fs_4 root_fs_5 root_fs_6 root_fs_7 root_fs_8 root_fs_9 root_fs_10 root_fs_11 root_fs_12 root_fs_13 root_fs_14 root_fs_15 root_fs_common 2,4,3,1 root_fs_ufslog root_fs_d3 root_fs_d4 root_fs_d5 root_fs_d6 ufs2 ufs4 See Example #1 for a description of command output. EXAMPLE #9 To extend the file system, ufs1, with the volume, emtv2b, type: $ nas_fs -xtend ufs1 emtv2b = 38 name...
Page 182
The nas Commands disk=d17 stor_dev=APM00042000818-001C addr=c0t1l12 server=server_2 disk=d17 stor_dev=APM00042000818-001C addr=c32t1l12 server=server_2 See Example #1 for a description of command output. Celerra Network Server Command Reference Manual...
Page 183
The nas Commands EXAMPLE #10 To extend the file system, ufs2, by the specified size of 100 GB using clar_r5_performance pool, type: $ nas_fs -xtend ufs2 size=100G pool=clar_r5_performance = 38 name = ufs2 in_use = True type = uxfs worm = off volume = v171...
Page 184
See Example #1 for a description of command output. Celerra Network Server Command Reference Manual...
Page 185
The nas Commands EXAMPLE #13 To start the conversion of the file system, ufs2, and to conform to the MIXED access policy mode, type: $ nas_fs -translate ufs2 -access_policy start -to MIXED -from NT = 38 name = ufs2 = 1432, owner=nasadmin, ID=201 in_use = True type...
Page 186
# nas_fs -delete ufs1_ckpt1 -option umount=yes = 1458 name = ufs1_ckpt1 in_use = False type = ckpt worm = off volume rw_servers= ro_servers= rw_vdms ro_vdms See Example #1 for a description of command output. Celerra Network Server Command Reference Manual...
Page 187
The nas Commands EXAMPLE #18 To create a file system named ufs3, with a size of 20 GB, using the clar_r5_performance pool, a maximum size of 100 G and with auto-extend and virtual provisioning enabled, type: $ nas_fs -name ufs3 -create size=20G pool=clar_r5_performance -auto_extend yes -max_size 100G -vp yes = 42 name...
Page 188
= Completed Has_translation_error = False Where: See Example #1 for a description of file system command output. Value Definition Default_directory_type the default directory type for the file system. Available types are: DIR3 and COMPAT. Celerra Network Server Command Reference Manual...
Page 189
DIR3 False is MPD. No action required. DIR3 True requires translation or file system maintenance. Contact EMC Customer Service. COMPAT False is COMPAT and requires translation. Contact EMC Customer Service. COMPAT True requires translation. Contact EMC Customer Service.
If FSCK is started on a mounted file system, the file system will be unavailable for the duration of the FSCK. NFS clients will see an message and CIFS clients will lose NFS server not responding connectivity with the server and will have to remap shares. Celerra Network Server Command Reference Manual...
Page 191
Forces a fsck or aclchk to be run on a file-level retention enabled file system. SEE ALSO Managing Celerra Volumes and File Systems Manually, nas_fs. EXAMPLE #1 To start file system check on ufs1 and monitor the progress, type: $ nas_fsck -start ufs1 -monitor...
Page 193
The nas Commands See Example #1 for a description of command outputs. EXAMPLE #6 To display information about all file system checks, that are currently running, type: $ nas_fsck -info -all name = ufs2 = 23 volume = v134 fsck_server = server_5 inode_check_percent = 30...
[root@cs100 nasadmin]# /nas/sbin/nas_halt now ******************************** WARNING! ******************************* You are about to HALT this Celerra including all of its Control Stations and Data Movers. DATA will be UNAVAILABLE when the system is halted. Note that this command does *not* halt the storage array.
Page 195
The nas Commands 3 11:13:41 cs100 dhcpd: Wrote 0 deleted host decls to leases file. 3 11:13:41 cs100 dhcpd: Wrote 0 new dynamic host decls to leases file. 3 11:13:41 cs100 dhcpd: Wrote 0 leases to leases file. 3 11:13:41 cs100 dhcpd: Listening on LPF/eth2/00:00:f0:9d:04:13/128.221.253.0/24 3 11:13:41 cs100 dhcpd: Sending on LPF/eth2/00:00:f0:9d:04:13/128.221.253.0/24...
The failover license is legacy and should only be used when instructed to do so by EMC personnel. Note: Licenses installed on the Control Station are read by the system. The site_key is a unique identifier which gets generated the first time nas_license is run.
Page 197
The nas Commands -init Initialize the database and recreates the license file using the that is already installed. The license file is located at site_key . It contains license keys in an encrypted /nas/site nas_license format. The -init should be run only if the license file containing all the license information has been lost and the following error message is received: license table is not initialized...
/nas/sbin For-init and -info, you can log in as nasadmin and su to root; for -activate and -restore, you must log in to the destination Celerra Network Server using the remote administration account (for example, dradmin) and su to root.
Page 199
MirrorView/S active/active’ configuration , use the -init option to specify the name of the remote Celerra Network Server. The active/active configuration is a bidirectional configuration in which a Celerra can serve as both a source and destination for another Celerra. -activate...
Page 200
The CLARiiON backend supports the following system-defined AVM storage pools for MirrorView/S only: cm_r1, cm_r5_performance, cm_r5_economy, cmata_archive, and cmata_r3. EXAMPLE #1 To initialize a destination Celerra in an active/passive configuration to communicate with source site source_cs, from the destination Control Station, type: # /nas/sbin/nas_mview -init source_cs...
Page 201
The nas Commands Contacting source_cs for server capabilities... Analyzing server information... Source servers available to be configured for remote DR ------------------------------------------------------- server_2:source_cs server_3:source_cs [ local standby ] Verify standby server configuration Quit initialization process Continue initialization Select a source_cs server: 1 Destination servers available to act as remote standby ------------------------------------------------------ server_2:target_cs [ unconfigured standby ]...
Page 202
= local -> remote ***** Servers configured with RDFstandby ***** name = server_2 = 1000, owner=nasadmin, ID=201 type = nas slot member_of = standby = server_3, policy=auto RDFstandby= slot=2 status defined = enabled actual = online, active Celerra Network Server Command Reference Manual...
Page 203
The nas Commands name = server_3 = 1000, owner=nasadmin, ID=201 type = standby slot member_of = standbyfor= server_2 RDFstandby= slot=3 status defined = enabled actual = online, ready ***** Servers configured as standby ***** No servers configured as standby Where: Value Definition Device Group...
Page 204
(not interruptible)...done commit in progress (not interruptible)...done commit in progress (not interruptible)...done done EXAMPLE #4 To restore, login to the destination Control Station using dradmin account, as root user, and type: Celerra Network Server Command Reference Manual...
Page 205
The nas Commands # /nas/sbin/nas_mview -restore Sync with CLARiiON backend ..done Validating mirror group configuration ..done Contacting source site source_cs, please wait... done Running restore requires shutting down source site source_cs. Do you wish to continue? [yes or no] yes Shutting down remote site source_cs ..
Page 206
Sync with CLARiiON backend ..done STARTING an MV 'RESUME' operation. Device group: mviewgroup .... done The MV 'RESUME' operation SUCCEEDED. Restarting NAS services ..done commit in progress (not interruptible)...done commit in progress (not interruptible)...done done Celerra Network Server Command Reference Manual...
OPTIONS -list Lists all storage pools on the Celerra Network Server. -info {<name>|id=<id>|-all} Displays detailed information for the specified storage pool, or all storage pools. -size {<name>|id=<id>|-all} Displays the size for the specified storage pool, or all storage pools.
Page 208
-modify {<name>|id=<id>} Modifies the attributes of the specified user-defined or system-defined storage pool. Refer to Managing Celerra Volumes and File Systems with Automatic Volume Management for a listing of available system-defined storage pools. [-name <name>] Changes the name of the storage pool to the new name.
Page 209
The nas Commands [-default_slice_flag {y|n}] If set to y (default), then members of the storage pool may be sliced when space is dispensed from the storage pool. If set to n, members of the storage pool will not be sliced when space is dispensed from the storage pool and the volumes specified cannot be built on a slice.
Page 210
SEE ALSO Managing Celerra Volumes and File Systems with Automatic Volume Management, Managing Celerra Volumes and File Systems Manually, Controlling Access to Celerra System Objects, Using TimeFinder/FS, Near Copy, and Far Copy with Celerra, fs_timefinder, nas_fs, nas_volume, and nas_slice.
Page 211
The nas Commands EXAMPLE #1 To create a storage pool with the name, marketing, with a description, with the following disk members, d12, d13, and with the default slice flag set to y, type: $ nas_pool -create -name marketing -description 'Storage Pool' -volumes d12,d13 -default_slice_flag y = 20 name...
Page 212
Data Mover has visibility. EXAMPLE #4 For Celerra Network Servers with a CLARiiON storage backend, to change the -is_greedy and -is_dynamic attributes for the system defined, clar_r5_performance storage pool, type:...
Page 213
The nas Commands description = Symmetrix STD = 1421 in_use = True clients = ufs3 members = v169,v171 default_slice_flag = False is_user_defined = False disk_type = STD server_visibility = server_2,server_3,server_4,server_5 volume_profile = symm_std_vp is_dynamic = True is_greedy = True Where: Value Definition ID of the storage pool.
Page 214
The nas Commands EXAMPLE #6 For Celerra Network Servers with a CLARiiON storage backend, to extend the system-defined storage pool by a specified size with a specified storage backend, type: $ nas_pool -xtend clar_r5_performance -size 128M -storage APM00042000818 name = clar_r5_performance...
Page 215
The nas Commands Where: Value Definition ID of the storage pool. whether the storage pool is being used by a file system. inuse access control level value assigned to the storage pool. name of the storage pool. name EXAMPLE #9 To display information about the user-defined storage pool called marketing, type: $ nas_pool -info marketing...
Page 216
$ nas_pool -delete marketing -deep = 20 name = marketing description = Marketing Storage Pool in_use = False clients members default_slice_flag = True is_user_defined = True See Example #1 for a description of command output. Celerra Network Server Command Reference Manual...
Page 218
Sets the block grace period in seconds. IGP=<integer> Sets the inode grace period in seconds. DUBSL=<integer> Sets the default user block soft limit in KB. DUBHL=<integer> Sets the default user block hard limit in KB. Celerra Network Server Command Reference Manual...
Page 219
The nas Commands DUISL=<integer> Sets the default user inode soft limit. DUIHL=<integer> Sets the default user inode hard limit. DGBSL=<integer> Sets the default group block soft limit in KB. DGBHL=<integer> Sets the default group block hard limit in KB. DGISL=<integer> Sets the default group inode soft limit.
Page 220
<pathname>, for all users and/or groups on all file systems on all Data Movers in the cabinet. The -clear option permanently removes all quota records, deletes the quota configuration file, and turns quotas off. Celerra Network Server Command Reference Manual...
Page 221
The nas Commands CAUTION While quotas are being turned on, off, or cleared, other operations to a file system may be disrupted. CIFS clients are disconnected during this execution. -on -tree -fs <fs_name> -path <pathname> Turns on (enables) tree quotas so that quota tracking and hard-limit enforcement (if enabled) can occur.
Page 222
516| +------------+--------+-------+-------+--------+--------+------+------+--------+ done EXAMPLE #5 To select user 300 as prototype user for ufs1, and assign other users the same limits, type: $ nas_quotas -group -edit -fs ufs1 -proto 300 301 302 303 done Celerra Network Server Command Reference Manual...
Page 223
The nas Commands EXAMPLE #6 To display the group quotas information for ufs1, type: $ nas_quotas -report -group -fs ufs1 Report for group quotas on filesystem ufs1 mounted on /ufs1 +------------+---------------------------------+-------------------------------+ | Group Bytes Used (1K) Files +------------+--------+-------+-------+--------+--------+------+------+--------+ Used | Soft | Hard |Timeleft| Used | Soft | Hard |Timeleft|...
Page 224
Block soft limit (warning level) crossed: Quota check starts: Quota Check ends: +------------------------------------------------------------------------------+ done EXAMPLE #10 To turn tree quotas on for ufs1, type: $ nas_quotas -on -tree -fs ufs1 -path /tree1 -comment 'Tree #1' done Celerra Network Server Command Reference Manual...
Page 225
The nas Commands EXAMPLE #11 To list the tree quotas for ufs1, type: $ nas_quotas -list -tree -fs ufs1 +------------------------------------------------------------------------------+ | Quota trees for filesystem ufs1 mounted on /ufs1: +------+-----------------------------------------------------------------------+ |TreeId| Quota tree path (Comment) +------+-----------------------------------------------------------------------+ 1 | /tree1 (Tree #1) 2 | /tree2 (Tree #2) +------+-----------------------------------------------------------------------+ done...
Page 226
Report for user quotas on quota tree /tree3 on filesystem ufs1 mounted on /ufs1 +------------+---------------------------------+-------------------------------+ |User Bytes Used (1K) Files +------------+--------+-------+-------+--------+--------+------+------+--------+ Used | Soft | Hard |Timeleft| Used | Soft | Hard |Timeleft| +------------+--------+-------+-------+--------+--------+------+------+--------+ |#1000 2992| 4000| 6000| 200| 300| |#32768 9824| +------------+--------+-------+-------+--------+--------+------+------+--------+ done Celerra Network Server Command Reference Manual...
Page 227
The nas Commands EXAMPLE #22 To open a vi session and edit the quota configuration for tree quota, /tree3, on a file system, ufs1, type: $ nas_quotas -edit -config -fs ufs1 -path /tree3 Tree Quota Parameters: fs "ufs1" tree "/tree3" Block Grace: (1.0 weeks) Inode Grace: (1.0 weeks) * Default Quota Limits:...
Page 228
To clear all tree quotas for ufs1, type: $ nas_quotas -clear -tree -fs ufs1 done EXAMPLE #27 To clear quotas for users and groups of a Data Mover, type: $ nas_quotas -clear -both -mover server_2 done Celerra Network Server Command Reference Manual...
Note: The apostrophe in active/active’ indicates that both sites have a source volume mirrored at the other site. SRDF is supported only on a Celerra Network Server attached to a Symmetrix system. Also, this command must be run from a primary Control Station in slot 0;...
Page 230
The nas Commands The <cel_name> is the name for the remote Celerra Network Server, and the <ip> is the IP address of the remote Celerra Network Server Control Station. The <cel_name> and <ip> must be specified for the following: For active/passive SRDF, the initialization procedure requires the...
Page 231
The nas Commands Movers see a “server unavailable” message; CIFS client connections time out.) Each volume on the source Celerra Network Server is set as read-write, and each mirrored volume on the destination Celerra Network Server is set as read-only.
Page 232
Where: Value Definition ID of the remote Celerra Network Server. name assigned in the local view to the remote Celerra Network Server. name ACL ID assigned automatically. owner R2 device mounted by the local control station to read the data base of the remote control station.
OPTIONS -list Displays all configured replication sessions on each Data Mover in the Celerra cabinet. Each session is represented by a session ID that is generated automatically whenever a session is configured and is globally unique. Because the session identifer is lengthy, use this option to obtain the <session_id>...
Page 234
To list all the replication sessions, type: $ nas_replicate -list server_2: server_3: Local Source session_id = fs25_T6_LUN1_000190100577_0047_fs23_T2_LUN1_000190100559_0047 application_label = RM/SE_WINSERVER1_L:\ session_id = fs25_T6_LUN2_000190100577_0047_fs23_T2_LUN2_000190100559_0047 application_label = RM/SE_WINSERVER1_G:\_ContainsRmDatabase session_id = fs25_T6_LUN0_000190100577_0047_fs23_T2_LUN0_000190100559_0047 application_label = RM/SE_WINSERVER1_K:\ Local Destination Celerra Network Server Command Reference Manual...
Page 235
The nas Commands server_4: This command was run on the source Celerra Network Server. Where: Value Definition globally unique character string used as the identifier of the iSCSi replication session. session_id alias name for the iSCSI replication session identifier. alias name of the application using the iSCSI replication session.
Page 239
The nas Commands source_data_port = 0 destination_data_ip = 172.24.102.202 destination_data_port = 8888 QOS_bandwidth = 2147483647 kbits/second Note: See Example #2 for a description of command output. EXAMPLE #4 To abort a replication session, type: $ nas_replicate -abort id=fs25_T6_LUN2_000190100577_0047_fs23_T2_LUN2_000190100559_0047 Operation in progress, please check sys_log for status EXAMPLE #5 To fail over a replication relationship, type: $ nas_replicate -failover...
Data Mover may be truncated if it is too long for the display. To display the full name, use the -info option with the Data Mover ID. Valid Data Mover types are: 1=nas 2=not used 3=not used 4=standby 5=not used 6=rdf Celerra Network Server Command Reference Manual...
Page 241
The nas Commands Note: The nas type is set automatically, vdm is set using nas_server, rdf and standby are set up using server_standby. [-all | -vdm] The -all option displays the physical Data Mover and VDMs. The -vdm option lists the VDMs only. -delete <movername>...
Page 242
The loaded option installs the image of the VDM onto the physical Data Mover, but does not mount the non-root file systems. The mounted option mounts the root_fs read-only, but the VDM image is not installed. Celerra Network Server Command Reference Manual...
Page 243
This mode is used when the mode of the VDM root file system is different from that of the physical Data Mover. SEE ALSO Configuring Virtual Data Movers for Celerra and Using International Character Sets with Celerra, nas_fs, nas_volume, server_checkup...
Page 244
Disk types when using CLARiiON are: CLSTD and CLATA, and for CLARiiON backends involving mirrored disks: CMSTD, and CMATA. Celerra Network Servers with a Symmetrix backend support the following system-defined storage pools: symm_std, symm_std_rdf_src, symm_ata, symm_ata_rdf_src. For user-defined storage pools, the difference in output is in the disk type.
Page 245
The nas Commands Where: Value Definition ID of the Data Mover. access control value for the Data Mover or VDM. server the VDM is loaded on. server mountedfs file systems that are mounted on this VDM. ID number of the root file system. rootfs name given to the Data Mover or VDM.
Page 246
EXAMPLE #6 To display information for all VDMs, type: $ nas_server -info -vdm -all name = vdm_1 type = vdm server = server_2 rootfs = root_fs_vdm_1 I18N mode = UNICODE mountedfs = member_of = status Celerra Network Server Command Reference Manual...
Page 247
The nas Commands defined = enabled actual = mounted Interfaces to services mapping: Where: Value Definition ID of the Data Mover. name of the Data Mover. name access control value for the VDM. for VDM server, the type is always VDM. type server the VDM is loaded on.
Page 248
See Example #4 for a description of command output. EXAMPLE #11 To set up an access control level value of 1432 for server_2, type: $ nas_server -acl 1432 server_2 name = server_2 = 1432 type = nas slot Celerra Network Server Command Reference Manual...
Page 249
The nas Commands member_of = standby = server_5, policy=auto status defined = enabled actual = online, ready See Example #4 for a description of command output. EXAMPLE #12 To delete vdm_1, type: $ nas_server -delete vdm_1 name = vdm_1 type = vdm server rootfs...
If an offset is not specified, the system defaults to the next best-fit size. SEE ALSO Managing Celerra Volumes and File Systems with Automatic Volume Management and Managing Celerra Volumes and File Systems Manually,...
Page 251
The nas Commands EXAMPLE #1 To display the slice table, type: $ nas_slice -list inuse slice_of offsetMB sizeMB name root_dos root_layout root_slice_1 root_slice_2 root_slice_3 root_slice_4 root_slice_5 root_slice_6 root_slice_7 root_slice_8 root_slice_9 root_slice_10 root_slice_11 root_slice_12 root_slice_13 root_slice_14 root_slice_15 root_slice_16 root_log_1 root_log_2 root_log_3 root_log_4 root_log_5 root_log_6...
Page 252
To display attributes of slv1, type: $ nas_slice -info slv1 = 76 name = slv1 in_use = False slice_of = d8 offset(MB)= 0 size (MB)= 1024 volume_name = slv1 See Example #2 for a description of command output. Celerra Network Server Command Reference Manual...
Page 253
The nas Commands EXAMPLE #5 To rename a slice from slv to slv1, type: $ nas_slice -rename slv slv1 = 76 name = slv1 in_use = False slice_of = d8 offset(MB)= 0 size (MB)= 1024 volume_name = slv1 See Example #2 for a description of command output. EXAMPLE #6 To delete slv1, type: $ nas_slice -delete slv1...
Control Station, and performs a failback for CLARiiON systems. OPTIONS -list Displays a list of all attached storage systems available for the Celerra Network Server. Note: The ID of the object is an integer and is assigned automatically. The storage system name of the may be truncated if it is too long for the display.
Page 255
The nas Commands -rename <old_name> <new_name> Renames the current storage system name to a new name. By default, the storage system name is its’ serial number. -acl <acl_value> <name> Sets an access control level value that defines the owner of the storage system, or the level of access allowed for users and groups defined in the access control level table (see nas_acl).
Page 256
APM before a set of integers, for example, APM00033900124-0019. For example, Symmetrix backends display as 002804000190-003C. EXAMPLE #1 For the Celerra Network Server with a CLARiiON backend, to list all attached storage systems, type: $ nas_storage -list name...
Page 257
The nas Commands EXAMPLE #2 For the Celerra Network Server with a CLARiiON backend, to display information for the attached storage system, type: $ nas_storage -info APM00042000818 arrayname = APM00042000818 name = APM00042000818 type = Clariion model_type = RACKMOUNT model_num...
Page 258
= 122 write_cache = 3072 free_memory raid3_mem_size failed_over = False hidden = False network_name = spb ip_address = 172.24.102.6 subnet_mask = 255.255.255.0 gateway_address = 172.24.102.254 num_disk_volumes Port Information Port 1 = 50:6:1:60:B0:60:1:CC:50:6:1:69:30:60:1:CC link_status = UP Celerra Network Server Command Reference Manual...
Page 259
The nas Commands port_status = ONLINE switch_present = True switch_uid = 10:0:8:0:88:A0:36:F3:20:3E:8:0:88:A0:36:F3 sp_source_id = 6372883 <...removed...> = 50:6:1:60:80:60:4:F0:50:6:1:68:0:60:4:F0 storage_processor = B port server = server_3 = 20:0:0:0:C9:2B:98:77:10:0:0:0:C9:2B:98:77 storage_processor = B port = 20:0:0:0:C9:2B:98:77:10:0:0:0:C9:2B:98:77 storage_processor = A port ------------ 0000 -> 0000 0001 ->...
Page 260
= 14 vendor = SEAGATE remapped_blocks = -1 state = ENABLED For the Celerra Network Server with a Symmetrix backend, to display information for the attached storage system, type: $ nas_storage -info 000187940260 serial_number = 000187940260 name = 000187940260 type...
Page 264
Port 1 = 50:6:1:60:B0:60:1:CC:50:6:1:69:30:60:1:CC link_status = UP port_status = ONLINE switch_present = True switch_uid = 10:0:8:0:88:A0:36:F3:20:3E:8:0:88:A0:36:F3 sp_source_id = 6372883 <...removed...> = 50:6:1:60:80:60:4:F0:50:6:1:68:0:60:4:F0 storage_processor = B port server = server_3 = 20:0:0:0:C9:2B:98:77:10:0:0:0:C9:2B:98:77 storage_processor = B Celerra Network Server Command Reference Manual...
Page 265
The nas Commands port = 20:0:0:0:C9:2B:98:77:10:0:0:0:C9:2B:98:77 storage_processor = A port ------------ 0000 -> 0000 0001 -> 0001 0002 -> 0002 0003 -> 0003 0004 -> 0004 0005 -> 0005 0018 -> 0018 0019 -> 0019 0020 -> 0020 0021 -> 0021 0022 ->...
Page 266
Note: This is a partial display due to the length of the output. EXAMPLE #9 To delete a storage system with no attached disks, type: $ nas_storage -delete APM00035101740 id = 0 serial_number = APM00035101740 name = APM00035101740 acl = 0 Celerra Network Server Command Reference Manual...
Page 267
= APM00042000818 = 1432, owner=nasadmin, ID=201 EXAMPLE #11 To modify the IP address of the CLARiiON backend on the Celerra Network Server, type: $ nas_storage -modify APM00072303347 -network -spa 10.6.4.225 Changing IP address for APM00072303347 Discovering storage (may take several minutes)
Page 270
-Clone <volume_name> Creates an exact clone of the specified <volume_name>. Volumes can be cloned from slice, stripe, or metavolumes. The name automatically assigned to the clone is derived from the ID of the volume. Celerra Network Server Command Reference Manual...
Page 271
Disk types when using a Symmetrix are: STD, R1STD, R2STD, BCV, R1BCV, R2BCV, ATA, R1ATA, R2ATA, BCVA, R1BCA, R2BCA. SEE ALSO Managing Celerra Volumes and File Systems with Automatic Volume Management, Managing Celerra Volumes and File Systems Manually, Using TimeFinder/FS, Near Copy, and Far Copy with...
Page 272
= d7 disks = d7 See Example #2 for a description of command output. EXAMPLE #4 To rename a mtv1 to mtv2, type: $ nas_volume -rename mtv1 mtv2 = 146 name = mtv2 Celerra Network Server Command Reference Manual...
Page 273
The nas Commands in_use = False type = meta volume_set = d7 disks = d7 See Example #2 for a description of command output. EXAMPLE #5 To create a stripe volume named, stv1, with a size of 32768 bytes on disk volumes d10, d12, d13, and d15, type: $ nas_volume -name stv1 -create -Stripe 32768 d10,d12,d13,d15 = 147...
Page 274
To set an access control level value for mtv1, type: $ nas_volume -acl 1432 mtv1 = 125 name = mtv1 = 1432 in_use = False type = meta volume_set = d7,mtv2 disks = d7,d8 See Example #2 for a description of command output. Celerra Network Server Command Reference Manual...
Page 275
The nas Commands EXAMPLE #11 To delete mtv2, type: $ nas_volume -delete mtv1 = 146 name = mtv1 = 1432 in_use = False type = meta volume_set = d7,mtv2 disks = d7,d8 See Example #2 for a description of command output. nas_volume...
Page 276
The nas Commands Celerra Network Server Command Reference Manual...
The server Commands This chapter lists the Celerra Network Server Command Set provided for managing, configuring, and monitoring of Data Movers. The commands are prefixed with server and appear alphabetically. The command line syntax (Synopsis), a description of the options, and an example of usage are provided for each command.
Note: If no options are specified, server_archive lists the contents of the archive. Celerra Network Server Command Reference Manual...
Page 279
The server Commands Read (-r) server_archive extracts the members of the archive file read from the archive, with pathnames matching the specified patterns. The archive format and blocking are automatically determined on input. When an extracted file is a directory, the entire file hierarchy rooted at that directory is extracted.
Page 280
This reference file is an ascii file and is located in The backup is /.etc/BackupDates. referenced by the pathnameof the files to back up and the time and Celerra Network Server Command Reference Manual...
Page 281
The server Commands date of when the backup was created. This file is updated only if the backup is successful. Backup files can be copied using the server_file command. -<x > Level x (x=1-9) indicates a backup of all files in a file system that have been modified since the last backup of a level smaller than the previous backup.
Page 282
Specifies one or more file characteristic options (privileges). The <string> option-argument is a string specifying file characteristics to be retained or discarded on extraction. The string consists of the specification characters a, e, m, o, and p. Multiple characteristics can Celerra Network Server Command Reference Manual...
Page 283
The server Commands be concatenated within the same string and multiple -p options can be specified. The meaning of the specification characters are as follows: Do not preserve file access times. By default, file access times are preserved whenever possible. Preserve everything (default mode), the user ID, group ID, file mode bits, file access time, and file modification time.
Page 284
During a list operation, produces a verbose table of contents using the format of the ls 1 utility with the -l option. For pathnames representing a hard link to a previous member of the archive, the output has the format: Celerra Network Server Command Reference Manual...
Page 285
The server Commands link name <ls -l listing> == < > For pathnames representing a symbolic link, the output has the format: listing <ls -l > => <link name> Where <ls -l listing> is the output format specified by the ls 1 utility when used with the -l option.
Page 286
1048576 (1M), 1024 (1K) or 512, respectively. A pair of bytes limits can be separated by x to indicate a product. Note: The limit size will be rounded up to the nearest block size. Celerra Network Server Command Reference Manual...
Page 287
The server Commands -C [d | i | m ] When performing a restore, this allows you to choose PAX behaviors on CIFS collision names. d: delete i: ignore m: mangle Ignores files that have a less recent file inode change time than a pre-existing file, or archive member with the same name (see -u option above).
Page 288
(as what happens when a file is extracted from an archive and the modification time is preserved). Time comparisons using both file times are useful when server_archive is used to create a Celerra Network Server Command Reference Manual...
Page 289
The server Commands time-based incremental archive (only files that were changed during a specified time range will be archived). A time range is made up of six different fields and each field must contain two digits. The format is: [yy[mm[dd[hh]]]]mm[ss] where yy is the last two digits of the year, the first mm is the month (from 01 to 12), dd is the day of the month (from 01 to 31), hh is the hour of the day (from 00 to 23), the second mm is the minute (from 00...
Page 290
$ server_archive <movername> -r -w -v -Y -Z home /backup STANDARDS The server_archive utility is a superset of the -p1003.2 standard. Celerra Network Server Command Reference Manual...
Page 291
The server Commands Note: The archive formats bcpio, sv4cpio, sv4crc, and tar, and the flawed archive handling during list and read operations, are extensions to the POSIX standard. ERRORS The server_archive command exits with one of the following system messages: All files were processed successfully.
: 172.24.102.254 at 0:d0:3:f9:37:fc 172.24.102.20 at 0:d0:b7:82:98:e0 172.24.102.24 at 0:50:56:8e:1d:5 128.221.253.100 at 0:4:23:a7:b1:35 EXAMPLE #3 To display an ARP entry specified by IP address, type: $ server_arp server_2 172.24.102.20 server_2 : 172.24.102.20 at 0:d0:b7:82:98:e0 Celerra Network Server Command Reference Manual...
Page 293
The server Commands EXAMPLE #4 To delete an ARP entry, type: $ server_arp server_2 -delete 172.24.102.24 server_2 : deleted: 172.24.102.24 at 0:50:56:8e:1d:5 server_arp...
-connect <mgfs> -type {nfsv2|nfsv3} -path <localpath> -source <srcName>:/<srcPath> Provides a connection for the Celerra Network Server with the remote NFS server. The -type option specifies the protocol type to be used for communication with the remote NFS server. The directory <localpath>...
Page 295
-source \\<srcServer>[.<domain>]\<srcShare>[\<srcPath>] -admin [<domain>\]<admin_name> [-wins <wins>] Provides a connection for the Celerra Network Server with the remote CIFS server as specified by its NetBIOS name. The directory <localpath> in the file system must be unique for that file system. The -source specifies the source file server name of the remote server as the <srcName>...
Page 296
-start <mgfs> -path <localpath> [-Force] -log <logpath> Directs the Data Mover to migrate all files from the source file server to the Celerra Network Server. The -log option provides detailed information on the state of the migration, and any failures that might occur.
Page 297
[-state {START|STOP|ON_GOING|ERROR|SUCCEED|FAIL}] Displays only the threads that are in the state that is specified. SEE ALSO Celerra CDMS Version 2.0 for NFS and CIFS, server_export, server_mount, server_setup. EXAMPLE #1 To provide a connection for the migration file system to communicate...
Page 298
Celerra Network Server, type: $ server_cdms server_2 -start ufs1 -path /dstdir -log / server_2 : done EXAMPLE #5 To display information about migration with the specified status, type: $ server_cdms server_2 -info ufs1 -state ON_GOING server_2 : Celerra Network Server Command Reference Manual...
Page 299
= /nfsdir type = NFSV3 source = 172.24.102.144:/srcdir options= proto=TCP path = /dstdir type = CIFS source = \\winserver1.nasdocs.emc.com\srcdir\ netbios= DM112-CGE0.NASDOCS.EMC.COM admin = nasdocs.emc.com\administrator threads: path = /dstdir state = ON_GOING = NONE See Example #3 for a description of command outputs.
If the dependency is not defined, executes the command for all the dependencies of the component. -quiet Displays only the number of errors and warnings for the sanity check. -full Provides a full sanity check of the specified Data Mover(s). Celerra Network Server Command Reference Manual...
Page 301
The server Commands -list Lists all available components that can be checked on a Data Mover. -info <component> Lists all dependencies of the specified component, with details of checks that can be performed on each dependency. EXAMPLE #1 To list the available component in the Data Mover, type: $ server_checkup server_2 -list server_2 : done CIFS...
Page 302
To execute only the check of the DNS dependency of the CIFS component, type: $ server_checkup server_2 -test CIFS -subtest DNS server_2 : ------------------------------------Checks-------------------------------------- Component CIFS : : Checking the DNS configuration and connectivity to DNS servers. Pass -------------------------------------------------------------------------------- Celerra Network Server Command Reference Manual...
Page 303
The server Commands EXAMPLE #4 To list the available dependencies of the CIFS component, type: $ server_checkup server_2 -info CIFS server_2 : done COMPONENT : CIFS DEPENDENCY : ACL DESCRIPTION : Number of ACL per file system. TESTS In full mode, check if the number of ACL per file system doesn't exceed 90% of the maximum limit.
Page 304
Check the .etc_common file system is correctly mounted, Check the syntax of the definition file of the Unicode characters, Check the uppercase/lowercase conversion table of Unicode character is valid. COMPONENT : CIFS DEPENDENCY : Kerberos Celerra Network Server Command Reference Manual...
Page 305
The server Commands DESCRIPTION : Kerberos configuration TESTS Check the machine password update is enabled and up-to-date. COMPONENT : CIFS DEPENDENCY : LocalGrp DESCRIPTION : Local groups and local users TESTS Check the local group database doesn't contain more than 80% of the maximum number of servers, Check if the servers in the local group database are all valid servers, Check the state of the local group database (initialized and writable),...
Page 306
Check if configuration file is in use, 2 ranges do not overlap, Check if secmap is enabled, In full mode, check the SID/UID and SID/GID mappings and reverses are correct and coherent. COMPONENT : CIFS DEPENDENCY : UnsupOS Celerra Network Server Command Reference Manual...
Page 307
The server Commands DESCRIPTION : Client OS not supported TESTS Check for unsupported client network OS. COMPONENT : CIFS DEPENDENCY : UnsupProto DESCRIPTION : Unsupported protocol commands detected TESTS Check for unsupported client network protocol commands. COMPONENT : CIFS DEPENDENCY : VC DESCRIPTION : Virus checker configuration...
Page 308
Error 13160939577: server_2 : pingdc failed due to NT error ACCESS_DENIED at step SAMR lookups --> check server configuration and/or DC policies according to reported error. Error 13160939577: server_2 : pingdc failed due to NT error ACCESS_DENIED at step SAMR lookups Celerra Network Server Command Reference Manual...
Page 309
The server Commands --> check server configuration and/or DC policies according to reported error. Error 13160939577: server_2 : pingdc failed due to NT error ACCESS_DENIED at step SAMR lookups --> check server configuration and/or DC policies according to reported error. Error 13160939577: server_2 : pingdc failed due to NT error ACCESS_DENIED at step SAMR lookups -->...
Page 310
The server Commands WINS : Checking for the connectivity to WINS servers, if defined..Pass NB: a result with a '*' means that some tests were not executed. use -full to run them -------------------------------------------------------------------------------- Celerra Network Server Command Reference Manual...
The server Commands server_cifs Manages the CIFS configuration for the specified Data Mover(s) or VDMs (virtual Data Movers). SYNOPSIS server_cifs { <movername> | ALL } [<options>] 'options' can be one of the following: | -option {audit [[client=<machine_name>]|[user=<user_name> ]] | homedir[=NO]} | -add netbios=<netbios_name>,domain=<domain_name>[,alias=<alias_name>...] [,hidden={y|n}[[,interface=<if_name>[,wins=<ip>[:<ip>]]]...] [,local_users][-comment <comment>]...
Page 312
Each NetBIOS name must be unique to the domain and the Data Mover. [,alias=<alias_name>...] Assigns a NetBIOS alias to the <netbios_name> associated with the NetBIOS name. The <alias_name> must: • be unique on a Data Mover • be limited to 15 characters Celerra Network Server Command Reference Manual...
Page 313
Mover, it becomes the default CIFS server and is available on all interfaces not used by other CIFS servers. The default CIFS server can be deleted at any time. EMC recommends that IP interfaces should always be specified. VDMs do not have default CIFS servers.
Page 314
/ \ : ; , = * + | [ ] ? < > " CAUTION Each computer name must be unique to the domain and the Data Mover. Using International Character Sets with Celerra Note: See the for details. Only Windows NT security mode can be configured when UTF-8 is enabled.
Page 315
Mover, it becomes the default CIFS server and is available on all interfaces not used by other CIFS servers. The default CIFS server can b e deleted at any time. EMC recommends that IP interfaces should always be specified. VDMs do not have default CIFS servers.
Page 316
Mover, it becomes the default CIFS server and is available on all interfaces not used by other CIFS servers. The default CIFS server can be deleted at any time. EMC recommends that IP interfaces should always be specified. VDMs do not have default CIFS servers.
Page 317
Renames a NetBIOS name. For Windows 2000 or Windows Server 2003, renames a Compname after the CIFS server is unjoined from the domain. Refer Managing Celerra for the Windows Environment for the procedure to rename a Compname. For Windows 2000 or Windows Server 2003, a NetBIOS name cannot be renamed if the CIFS server is joined to a Windows domain.
Page 318
An Active Directory and a DNS can have the same domain name, or a different domain name (disjoint namespace). For each type of Active Directory and DNS domain relationship, specific Celerra parameters and command values must be used. For example, for a disjoint...
Page 319
Data Mover to run Windows 2000 or later native environments. UTF-8 should be enabled for NT security mode. CAUTION EMC does not recommend the use of UNIX or SHARE security modes. For UNIX security mode, the client supplies a username and a plain-text password to the server.
Page 320
-delete compname=<comp_name>[,alias=<alias_name>...] Deletes the CIFS configuration as identified by its <comp_name>. This does not remove the account from the Active Directory. It is recommended that an -Unjoin be executed prior to deleting the computer name. Celerra Network Server Command Reference Manual...
Page 321
The server Commands If an alias is specified, deletes the alias name for the computer name. CAUTION If an <alias_name> is not entered, the entire CIFS configuration, as identified by its NetBIOS name or computer name, is deleted. -delete wins=<ip_addr>[,wins=<ip_addr>...] Deletes the WINS server(s) from the CIFS configuration.
Page 322
[-summary] Displays a summary of SMB statistics. SEE ALSO Configuring CIFS on Celerra, Managing Celerra for the Windows Environment, Using EMC Utilities for the CIFS Environment, Configuring CIFS on Celerra, Managing Celerra for a Multiprotocol Environment, Replicating Celerra CIFS Environments, and Using International Character Sets with Celerra, server_date, server_export, server_mount, server_setup.
Page 323
NT4 domain NASDOCS, with a NetBIOS alias of dm110-cge0a1, hiding the NetBIOS name in the Network Neighborhood, with the interface for CIFS service as cge0, the WINS server as 172.24.102.25, and with the comment string EMC Celerra, type: $ server_cifs server_2 -add netbios=dm110-cge0,domain=NASDOCS,alias=dm110-cge0a1,hidden=y,interface=cge0, wins=172.24.102.25 -comment "EMC Celerra"...
Page 324
256 Cifs threads started Security mode = NT Max protocol = NT1 I18N mode = UNICODE Home Directory Shares ENABLED, map=/.etc/homedir Usermapper auto broadcast suspended Usermapper[0] = [172.24.102.20] state:available Default WINS servers = 172.24.103.25:172.24.102.25 Celerra Network Server Command Reference Manual...
Page 325
-comment "EMC Celerra" server_2 : done EXAMPLE #9 To join dm112-cge0 into the Active Directory domain nasdocs.emc.com, using the Administrator account, and to add this server to Engineering\Computers organizational unit, type: $ server_cifs server_2 -Join compname=dm112-cge0,domain=nasdocs.emc.com,admin=administrator,ou="ou=Compute rs:ou=Engineering" server_2 : Enter Password:********...
Page 326
To display CIFS information for a Data Mover in a Windows 2000 or later domain with external usermapper, type: $ server_cifs server_2 server_2 : 256 Cifs threads started Security mode = NT Max protocol = NT1 Celerra Network Server Command Reference Manual...
Page 327
Default WINS servers = 172.24.103.25:172.24.102.25 Enabled interfaces: (All interfaces are enabled) Disabled interfaces: (No interface disabled) Unused Interface(s): if=cge1 l=172.24.102.243 b=172.24.102.255 mac=0:60:16:4:35:4e DOMAIN NASDOCS FQDN=nasdocs.emc.com SITE=Default-First-Site-Name RC=3 SID=S-1-5-15-99589f8d-9aa3a5f-338728a8-ffffffff >DC=WINSERVER1(172.24.102.66) ref=3 time=1 ms (Closest Site) CIFS Server DM112-CGE0[NASDOCS] RC=2 (Hidden) Alias(es): DM112-CGEA1 Full computer name=dm112-cge0.nasdocs.emc.com realm=NASDOCS.EMC.COM...
Page 328
See Example #5 for a description of command outputs. EXAMPLE #15 To add a Windows 2000 or later server named, dm112-cge0, in the Active Directory domain nasdocs.emc.com, with the interface for CIFS service as cge0, and enable local users support, type: $ server_cifs server_2 -add compname=dm112-cge0,domain=nasdocs.emc.com,interface=cge0,local_users...
Page 329
EXAMPLE #19 To unjoin the computer dm112-cge0 from the nasdocs.emc.com domain, type: $ server_cifs server_2 -Unjoin compname=dm112-cge0,domain=nasdocs.emc.com,admin=administrator server_2 : Enter Password:******** done EXAMPLE #20 To delete WINS servers, 172.24.102.25, and 172.24.103.25, type:...
Page 330
EXAMPLE #28 To migrate all SIDs in the ACL database for file system, ufs1, from the <src_domain>, eng.emc.com:nb=dm112-cge1:if=cge1 to the <dst_domain>, nasdocs.emc.com:nb=dm112-cge0:if=cge0, type: $ server_cifs server_2 -Migrate ufs1 -acl eng.emc.com:nb=dm112-cge1:if=cge1 nasdocs.emc.com:nb=dm112-cge0:if=cge0 server_2 : done EXAMPLE #29 To migrate SIDs of members of the local group defined for the specified NetBIOS name, from the <src_domain>,...
Page 331
The server Commands $ server_cifs server_2 -Replace ufs1 -acl :nb=dm112-cge0:if=cge0 server_2 : done EXAMPLE #31 To configure a standalone CIFS server on server_2 with a NetBIOS name of dm112-cge0, in the workgroup NASDOCS, with a NetBIOS alias of dm112-cge0a1, hiding the NetBIOS name in the Network Neighborhood, with the interface for CIFS service as cge0, the WINS servers as 172.24.102.25 and 172.24.103.25, and with enabled local users support, type:...
Page 332
EXAMPLE #35 To reset to zero the values for all SMB statistics, type: $ server_cifs server_2 -stats -zero server_2 : done Celerra Network Server Command Reference Manual...
The ALL option executes the command for all of the Data Movers. OPTIONS -halt For the Celerra Network Server, performs an orderly shutdown of a Data Mover. To restart a Data Mover, perform a -reboot. For the NS series, a -halt causes a system reboot.
Page 334
$ server_cpu server_2 -reboot now server_2 : done EXAMPLE #4 To monitor a reboot of server_2 set to take place in one minute, type: $ server_cpu server_2 -reboot -monitor +1 server_2 : reboot in progress ..3.3.3.3.3.done Celerra Network Server Command Reference Manual...
The server Commands server_date Displays or sets the date and time for a Data Mover, and synchronizes time between a Data Mover and an external time source. SYNOPSIS server_date {<movername> | ALL} [+<format>][<yymmddhhmm>[<ss>]] | timesvc start ntp [-sync_delay] [-interval <hh>[:<mm>]] [<host>[<host>..]] | timesvc update ntp | timesvc stop ntp | timesvc delete ntp...
Page 336
Immediately polls the external source and synchronizes the time on the Data Mover without slewing the clock. timesvc stats ntp Displays the statistical information of time synchronization for the Network Time Protocol such as time differences between the Data Celerra Network Server Command Reference Manual...
Page 337
Note: See the Linux man page for tzset for information about the format. SEE ALSO Configuring Celerra Time Services, server_dns, server_nis. EXAMPLE #1 To display the current date and time on a Data Mover, type: $ server_date server_2...
Page 338
EXAMPLE #10 To display the time service configuration for a Data Mover, type: $ server_date server_2 timesvc server_2 : Timeservice State time: Thu Jan 6 17:04:28 EST 2005 type: sync delay: interval: hosts: 172.24.102.20, Celerra Network Server Command Reference Manual...
Page 339
The server Commands Where: Value Definition date and time known to the Data Mover. time time service protocol configured on the Data Mover. type sync delay whether sync delay is on or off. time interval between polls. interval specifies the IP address of the time server. hosts EXAMPLE #11 To stop time services for a Data Mover, type:...
Data Mover’s database. server_devconfig renames the device name, and lists SCSI devices. CAUTION EMC recommends that all Data Movers have the same device configuration. When adding devices to the device table for a single Data Mover only, certain actions such as standby failover will not be successful unless the standby Data Mover has the same disk device configuration as the primary Data Mover.
Page 341
CAUTION High availability can be lost when changing the storage configuration. Changing the storage configuration should only be done under the direction of an EMC Customer Service Engineer. -list -scsi [<chain_number>] {-disks | -nondisks | -all} Lists the SCSI device table database that has been saved on the Data Mover.
Page 342
APM before a set of integers, for example, APM00033900124-0019. For example, Symmetrix backends display as 002804000190-003C. EXAMPLE #1 For the Celerra Network Server with a CLARiiON backend, to list all devices, type: $ server_devconfig server_2 -list -scsi -all server_2:...
Page 343
Symmetrix backends only. storage system ID. stor_id storage system device ID. stor_dev EXAMPLE #2 For the Celerra Network Server with a CLARiiON backend, to list all SCSI-attached non-disk devices, type: $ server_devconfig server_2 -list -scsi -nondisks server_2 : server_devconfig...
Page 344
5 020710001000APM00043807043 gk161 c16t1l1 disk 5 020711001100APM00043807043 For the Celerra Network Server with a Symmetrix backend, to list all SCSI-attached non-disk devices, type: $ server_devconfig server_2 -list -scsi -nondisks server_2 : Scsi Device Table name addr type...
Page 345
14, scsi-14 : no devices on chain chain= 15, scsi-15 : no devices on chain For the Celerra Network Server with a Symmetrix backend, to discover SCSI disk devices and add them to the database table, type: $ server_devconfig server_2 -probe -scsi -disks...
Page 346
$ server_devconfig ALL -create -scsi -all -discovery n -monitor y server_2 : server_2: chain 0 ..chain 16 ..done server_3 : server_3: chain 0 ..chain 16 ..done server_4 : Celerra Network Server Command Reference Manual...
Page 347
The server Commands server_4: chain 0 ..chain 16 ..done server_5 : server_5: chain 0 ..chain 16 ..done server_devconfig...
Gets file system information. If <fs_name> specified, gets information for file system only. SEE ALSO Managing Celerra Volumes and File Systems Manually, nas_disk, nas_fs. EXAMPLE #1 To display the amount of used and available disk space on a Data Mover, type:...
Page 349
The server Commands EXAMPLE #2 To display the amount of disk space and the amount of free and unused inodes on a Data Mover, type: $ server_df server_2 -inode server_2 : Filesystem inodes used avail capacity Mounted on ufs1 131210494 131210354 /ufs1 ufs4...
Data Mover, and the dump option displays the DNS cache. SEE ALSO Configuring Celerra Naming Services, server_nis. EXAMPLE #1 To connect to a DNS lookup server, type: $ server_dns server_2 prod.emc.com 172.10.20.10 server_2 : done Celerra Network Server Command Reference Manual...
Page 351
EXAMPLE #3 To change the protocol to TCP from UDP, type: $ server_dns server_2 -protocol tcp prod.emc.com 172.10.20.10 server_2 : done EXAMPLE #4 To halt access to the DNS lookup servers, type: $ server_dns server_2 -option stop...
[-Protocol {cifs | nfs}] -unexport [-perm] -all Unexports all entries as defined by the protocol. By default, unexports are permanent for CIFS, and temporary for NFS, unless -perm is specified. If -perm is specified, removes all entries from the Celerra Network Server Command Reference Manual...
Page 353
The server Commands export table. When the entry is temporararily unexported, clients are denied access to the entry until it is re-exported or the system is rebooted, but the entries are not removed from the export table. The default is NFS. FOR NFS OPERATIONS -list <pathname>...
Page 354
The default value for anon=<uid> is the user “nobody.” If the user “nobody” does not exist, then the value 65534 is used. CAUTION Using anon=0 is not recommended for security concerns. access=<client>[:<client>]... Provides mount access for the specified NFS client(s). Celerra Network Server Command Reference Manual...
Page 355
The server Commands access=<-client>[:<-client>]... Excludes the specified NFS client(s) from access even if they are part of a subnet or netgroup that is allowed access. Clients must be preceded with - (dash) to specify exclusion. nfsv4only Specifies that the NFS export can be accessed only when a client is using NFSv4.
Page 356
There is a 256 character limit for group names. ropasswd=<share_passwd> When using share level access (see server_checkup), creates a read-only password to allow clients access to the share. Passwords can be viewed in the list of shared entries. Celerra Network Server Command Reference Manual...
Page 357
This is required because multiple CIFS entries can have same <sharename> when belonging to different NetBIOS name. SEE ALSO Configuring NFS on Celerra, Managing Celerra Volumes and File Systems Manually, and Configuring CIFS on Celerra, nas_fs, server_checkup, server_file, server_mount. EXAMPLE #1...
Page 358
$ server_export server_2 -list /ufs1 server_2 : export "/ufs1" name="/nasdocsfs" access=172.24.102.0/255.255.255.0 root=172.24.102.240 nfsv4only comment="NFS Export for ufs1" EXAMPLE #9 To temporarily unexport an NFS entry, type: $ server_export server_2 -Protocol nfs -unexport /ufs2 server_2 : done Celerra Network Server Command Reference Manual...
Page 359
The server Commands EXAMPLE #10 To export all NFS entries, type: $ server_export server_2 -Protocol nfs -all server_2 : done server_export...
Page 360
To list all NFS and CIFS entries, type: $ server_export server_2 server_2 : export "/ufs2" sec=krb5 ro root=172.24.102.240 access=172.24.102.0/255.255.255.0 export "/ufs1" nfsv4only export "/" anon=0 access=128.221.252.100:128.221.253.100:128.221.252.101:128.221.253.101 share "ufs2" "/ufs2" umask=022 maxusr=4294967295 share "ufs1" "/ufs1" ro umask=027 maxusr=200 netbios=DM112-CGE0 comment="CIFS share" Celerra Network Server Command Reference Manual...
Page 361
The server Commands Where: Value Definition a file system entry to be exported. export security mode for the file system. file system is to be exported as read-only. IP address with root access root access is permitted for those IP addresses. access entry to be shared.
To copy a file from the Control Station to a Data Mover, type: $ server_file server_2 -put passwd passwd server_2 : done EXAMPLE #2 To copy a file from the Data Mover to the Control Station, type: $ server_file server_2 -get passwd /home/nasadmin/passwd server_2 : done Celerra Network Server Command Reference Manual...
[-users valid|<user>[,<user>,<user>…]}] [-hosts <ip>[,<ip>,<ip>…]] DESCRIPTION server_http manages user and host access to a feature such as Celerra FileMover, and determines the number of HTTP threads available to take incoming service requests. The ALL option executes the command for all of the Data Movers.
Page 364
To change an existing HTTP protocol connection, type: $ server_http server_2 -append dhsm -users user1,user2,user3 server_2 : done EXAMPLE #4 To change an existing HTTP protocol connection, type: $ server_http server_2 -append dhsm -users user4 -hosts 172.24.102.20,172.24.102.21 server_2 : done Celerra Network Server Command Reference Manual...
Page 365
Celerra FileMover is enabled or disabled on the file system. users whether the Celerra Network Server should notify CIFS clients that a file is migrated. allowed IPs timeout value, in seconds, before Windows popup notification is sent to CIFS client.
For example, 255.255.255.0 would be a mask for a Class C network. The IP broadcast is a special destination address that Celerra Network Server Command Reference Manual...
Page 367
The server Commands specifies a broadcast message to a network; for example, x.x.x.255 is the broadcast address for a Class C network. For CIFS users , when an interface is created, deleted or marked up/down, using the server_setup command, stop, then restart the CIFS service in order to update the CIFS interface list.
Page 368
The server Commands SEE ALSO Configuring and Managing Celerra Networking and Configuring and Managing Celerra Network High Availability, server_netstat, server_setup, server_sysconfig. FRONT-END OUTPUT The network device name is dependent on the front-end of the system (e.g., NS series Data Mover, 514 Data Movers, 510 Data Movers, etc.) and the network device type.
Page 369
The server Commands EXAMPLE #6 To set the ID for the Virtual LAN, type: $ server_ifconfig server_2 cge0 vlan=102 server_2 : done EXAMPLE #7 To delete an IP interface, type: $ server_ifconfig server_2 -delete cge1 server_2 : done server_ifconfig...
The <alias_name> is not used for authentication. The -Q <iscsi_name> option specifies an iSCSI name string that must be entered as either an iSCSI Qualified Name (“iqn.”) or in IEEE EUI-64 format (“eui.”). If Celerra Network Server Command Reference Manual...
Page 371
The iSCSI standard requires that an iSCSI name be globally unique and in a specific format. To avoid entering illegal names, do not use the -Q option; instead let the Celerra Network Server generate a legal iSCSI name. For international support, both the target name (given by -alias) and the iSCSI name (given by -Q) support strings of Unicode characters in UTF-8 encoding.The <pg_tag>, which is the portal group tag,...
Page 372
| -delete <lun_number> -target <target_alias_name> | -info {<lun_number>|-all} [-target <target_alias_name>] | -stat {<lun_number>|-all} [-target <target_alias_name>] | -list [-target <target_alias_name>]} Enter -lun to display LUN options. The Celerra Network Server supports LUNs up to 256. -lun -number <lun_number> -create <target_alias_name> -size <size> -fs <fs_name>...
Page 373
The server Commands CAUTION When using virtually provisioned LUNs, monitoring the file system space usage is very important. Attempting to write data to a virtually provisioned LUN without sufficient free space in the underlying file system can result in client file system corruption on the iSCSI host system.
Page 374
If the administrator fails to stop the service, attempted modifications will have no effect even though the command reports "done". Available options are: -ns isns { Celerra Network Server Command Reference Manual...
Page 375
OPTIONS Starts, stops, and displays the status of the iSCSI service. SEE ALSO Configuring iSCSI Targets on Celerra, Installing Celerra iSCSI Host Components, and Using Celerra Replicator for iSCSI , nas_replicate. EXAMPLE #1 To create a target with an alias of t1, and a portal group of 100, and a network portal of np=172.24.102.242, type:...
Page 377
The server Commands EXAMPLE #9 To display a list of all LUNs on a Data Mover, type: $ server_iscsi server_2 -lun -list server_2 : target: t1 size(MB) filesystem 106496 ufs1 ( id=22 ) 10240 ufs1 ( id=22 ) 10240 ufs1 ( id=22 ) Where: Value Definition...
Page 378
$ server_iscsi server_2 -mask -set t1 -initiator iqn.1991-05.com.microsoft:winserver1.nasdocs.emc.com -grant 0,1 server_2 : done EXAMPLE #13 To display a list of LUN masks, type: $ server_iscsi server_2 -mask -list server_2 : target: t1 initiator_name grant LUNs iqn.1991-05.com.microsoft:winserver1.nasdocs.emc.com 0-1 Celerra Network Server Command Reference Manual...
Page 379
LUNs to which the initiator is granted access. grant LUNs EXAMPLE #14 To clear the LUN mask for the initiator, iqn.1991-05.com.microsoft:winserver1.nasdocs.emc.com, type: $ server_iscsi server_2 -mask -clear t1 -initiator iqn.1991-05.com.microsoft:winserver1.nasdocs.emc.com server_2 : done EXAMPLE #15 To configure an iSNS client on the Data Mover for iSNS server with IP address of 172.24.102.66, type:...
Page 380
Target Alias Name iSCSI qualified name of the target. Target iSCSI Name unique, Celerra-wide serial number for the target. Serial Number portal groups used by the target. Portal Group Tag IP address and port of the portals in the portal group.
Page 381
To display statistics for the target, t1, and the current sessions on the target, type: $ server_iscsi server_2 -target -stat t1 server_2 : Target Alias Name: t1 Target iSCSI Name: iqn.1992-05.com.emc:apm000438070430000-1 [Login/Logout Stats] Login Accepted: 1 Login Failed: 0 Redirect: 0 Authorize: 0...
Page 382
Data Digests number of session failures. Session Failures ID of the last failed session. Last Session Failed number of accepted login requests. Login Accepts number of rejected login requests. Login Failed Celerra Network Server Command Reference Manual...
Page 383
The server Commands number of logins that are redirected. Redirect number of logins that failed due to authorization failure. Authorize number of login failures due to failed authentication. Authenticate number of login failures due to errors in iSCSI parameter negotiation. Negotiate number of login failures due to other causes.
Specifies a port that the KDC listens on. [,kdc=<fqdn_kdc_name[:<port>]...] Specifies additional KDCs with ports that KDCs listen on. [,kpasswd=<fqdn_kpasswd_server_name>] Specifies a password server for the KDC. The <fqdn_kpasswd_server_name> must be a fully qualified domain name for the server. Celerra Network Server Command Reference Manual...
Page 385
Displays the principal names for the keys stored in the keytab file. -ccache Displays the entries in the Data Movers Kerberos credential cache. Note: The -ccache option can also be used to provide EMC Customer Support with information for troubleshooting user access problems. [-flush] Flushes the Kerberos credential cache removing all entries.
Page 386
Specifies the kadmin server with its associated port. Note: The kadmin tool is only relevant if you are using a UNIX/Linux Kerberos KDC. SEE ALSO Configuring NFS on Celerra, server_checkup, server_nfs. OUTPUT Dates appearing in output are in UTC format. EXAMPLE #1...
Specifies the profile which provides the iPlanet client with configuration information about the directory service. [-nisdomain <NIS_domain>] Specifies the NIS domain of which the Data Mover is a member since an iPlanet domain can host more than one NIS domain. Celerra Network Server Command Reference Manual...
Page 391
-start | -stop | -status The -start option enables the iPlanet client service. The iPlanet client service is also restarted when the Celerra Network Service is rebooted. The -stop disables the iPlanet client service, and the -status option displays the status of the iPlanet service.
Page 392
DN (distinguished name) of the ID. Proxy (Bind) DN name of the client configuration profile. Profile Name how often the Celerra Network Server checks for configuration profile changes. Profile TTL IP address and port number of the iPlanet server. Connected to LDAP...
The server Commands server_log Displays the log generated by the specified Data Mover. SYNOPSIS server_log <movername> [ -a ][ -f ][ -n ][ -s ] DESCRIPTION server_log reads and displays the log generated by the Data Mover. Information in the log file is read from oldest to newest. To view that most recent log activity, add to the end of your command line.
Page 396
1086824142: ADMIN: 4: Command succeeded: device pci pci-0 1086824142: ADMIN: 4: Command succeeded: fcp serial 1086824142: ADMIN: 4: Command succeeded: dskdumpconfig full slot=2 Note: This is a partial listing due to the length of the output. Celerra Network Server Command Reference Manual...
The server Commands server_mount Mounts file systems and manages mount options for the specified Data Mover(s). SYNOPSIS server_mount {<movername> | ALL} [-all] | [-Force] [-option <options>] <fs_name> [<mount_point>] <options>: [ro | rw] [primary=<movername>] [nonotify] [nooplock] [notifyonaccess] [notifyonwrite] [accesspolicy={NT | UNIX | SECURE | NATIVE | MIXED | MIXED_COMPAT}] [nolock | wlock | rwlock] [cvfsname=<newname>] [noscan]...
Page 398
Access Policy CIFS clients: NFS clients: NATIVE (default) ACL is checked. UNIX rights are checked. UNIX ACL and UNIX rights are checked. UNIX rights are checked. ACL is checked. ACL and UNIX rights are checked. Celerra Network Server Command Reference Manual...
Page 399
The server Commands Access Policy CIFS clients: NFS clients: SECURE ACL and UNIX rights are checked. ACL and UNIX rights are checked. MIXED ACL is checked. If there is not an ACL, one is ACL is checked. If there is not an ACL, one is created based on the UNIX mode bits.
Page 400
The default is 512. The value -1 disables the notification feature. [ntcredential] Enables the Celerra Network Server to take full account of a user’s Windows group memberships when checking an ACL for access through NFS. When a UNIX user intiates a full request for a file system object, the UNIX UID is mapped to the Windows SID, then merges the user’s UNIX and Windows groups together...
Page 401
NONE indicates that no file delegation is granted. READ indicates only read delegation is granted. RW (default) indicates write delegation is granted. SEE ALSO Managing Celerra Volumes and File Systems with Automatic Volume Management, Managing Celerra Volumes and File Systems Manually, server_mount...
Page 402
The server Commands Configuring NFS on Celerra, Configuring CIFS on Celerra, Managing Celerra for the Windows Environment, Managing Celerra for a Multiprotocol Environment, and Using SnapSure on Celerra, nas_fs, server_checkup, server_export, server_mountpoint, server_nfs, server_setup, server_umount, server_viruschk. EXAMPLE #1 To display all mounted file systems on server_2, type:...
Page 403
The server Commands EXAMPLE #8 To mount ufs1, on mount point, /ufs1, with uncached writes turned on, type: $ server_mount server_2 -option uncached ufs1 /ufs1 server_2 : done EXAMPLE #9 To mount ufs1, on mount point, /ufs1, with the trigger level of notification change set to 256, type: $ server_mount server_2 -option triggerlevel=256 ufs1 /ufs1 server_2 : done...
Deletes a mount point. -exist <pathname> Displays whether or not a mount point exists. SEE ALSO Managing Celerra Volumes and File Systems with Automatic Volume Management and Managing Celerra Volumes and File Systems Manually, nas_fs, server_export, server_mountpoint. EXAMPLE #1 To create a mount point on server_2, type:...
Page 405
The server Commands EXAMPLE #3 To verify that the mount point, /ufs1, exists on all of the Data Movers, type: $ server_mountpoint ALL -exist /ufs1 server_2 : /ufs1 : exists server_3 : /ufs1 : does not exist EXAMPLE #4 To delete the mount point, /ufs1, on server_2, type: $ server_mountpoint server_2 -delete /ufs1 server_2 : done server_mountpoint...
Increases the previously specified number of MPFS threads (default=16) by <number_of_threads> for the specified Data Mover(s). -delete <number_of_threads> Decreases the number of threads by the <number_of_threads> indicated for the specified Data Mover(s). -Stats Displays the current MPFS server statistics. Celerra Network Server Command Reference Manual...
Page 407
If a <var> is specified, only the specified value only is reset to its factory-default value. Note: Variable names are case-sensitive. SEE ALSO Using MPFS on Celerra, server_setup, server_mpfsstat. EXAMPLE #1 To set a value for a specified MPFS variable, type: $ server_mpfs server_2 -set thread=32...
Page 408
EXAMPLE #5 To add 16 threads for server_2, type: $ server_mpfs server_2 -add 16 server_2 : done EXAMPLE #6 To delete 16 threads for server_2, type: $ server_mpfs server_2 -delete 16 server_2 : done Celerra Network Server Command Reference Manual...
Displays a list of the open MPFS sessions on the specified Data Mover. Sessions are listed as pairs. <client_ip>,<time stamp> SEE ALSO Using MPFS on Celerra, server_mpfs EXAMPLE #1 To display timing and counting statistics for a Data Mover, type: $ server_mpfsstat server_2 server_2 :...
Page 410
(total): the number of shared conflicts (total of the above). conflicts (lock): number of FMP lock conflicts from multiple clients. number of FMP lock onflicts that are caused by file sharing between MPFS requests and CIFS/NFS conflicts requests. (sharing): Celerra Network Server Command Reference Manual...
Page 411
The server Commands Value Definition number of FMP lock conflicts that are denied due to previously queued requests. conflicts (starvation): the number of files opened. open files: the number of active sessions. open sessions: the number of blocks written per second and number of blocks read per second through GetMap throughput for requests.
Page 412
To reset the statistics associated with the file /ufs1/mpfs/file.dat type: $ server_mpfsstat server_2 -z -file /ufs1/mpfs/file.dat server_2 : done EXAMPLE #6 To reset the global statistics, type $ server_mpfsstat server_2 -Z server_2 : done Celerra Network Server Command Reference Manual...
The server Commands server_mt Manages the magnetic tape drive for the specified Data Mover. SYNOPSIS server_mt <movername> [-f <device>] [ -N ] <command> [ <count> ] DESCRIPTION server_mt sends commands to a magnetic tape drive located on the specified Data Mover. By default, server_mt performs the requested operation once.
Page 414
Indicates no rewind at the end of the tape. server_devconfig <movername> -list -scsi -nondisks command displays a listing of devices. EXAMPLE To send the rewind command to tape1 (magnetic tape drive) on a Data Mover, type: $ server_mt server_2 -f tape1 rewind Celerra Network Server Command Reference Manual...
The server Commands server_name Manages the hostname <movername> for the specified Data Mover(s). SYNOPSIS server_name { <movername> | ALL } [<new_name>] DESCRIPTION server_name displays and renames the current hostname for the specified Data Mover. The ALL option executes the command for all of the Data Movers. OPTIONS No arguments Displays hostnames for all Data Movers.
172.24.102.17.445 ESTABLISHED 172.24.102.237.netbios-ssn 172.24.103.63.3962 ESTABLISHED EXAMPLE #2 To display the states of the IP, ICMP, TCP, and UDP sockets, type: $ server_netstat server_2 -a Proto Local Address Foreign Address (state) ****************************************************************** 172.24.102.237.2483 172.24.102.17.445 ESTABLISHED Celerra Network Server Command Reference Manual...
Page 417
The server Commands 172.24.102.237.netbios-ssn 172.24.103.63.3962 ESTABLISHED *.microsoft-ds LISTEN *.netbios-ssn LISTEN *.12345 LISTEN *.5080 LISTEN *.2272 LISTEN *.2271 LISTEN *.2270 LISTEN *.ftp LISTEN *.10000 LISTEN *.4658 LISTEN *.2269 LISTEN *.2268 LISTEN *.nfs LISTEN *.1234 LISTEN *.5033 LISTEN *.8888 LISTEN *.sunrpc LISTEN Proto Local Address ******************* *.sunrpc...
Note: NFSv2 and v3 service is not started or stopped by this command. The ALL option executes the command for all of the Data Movers. OPTIONS -secnfs Displays the status of the secure NFS service. Celerra Network Server Command Reference Manual...
Page 421
The server Commands -service { -start | -stop } Enables or disables the secure NFS service on the Data Mover. -user -list Lists all NFS users authenticated by secure NFS. -user -info { principal=<user_principal> | handle=<handle_number> } Displays the attributes of an authenticated user as specified by the <user_principal>...
Page 422
Displays all statistics or resets to zero all NFS and RPC statistics. [-rpc | -nfs] Displays RPC statistics or displays NFS statistics. [-zero] [-rpc] Resets to zero all RPC statistics. [-zero] [-nfs] Resets to zero all NFS statistics. SEE ALSO Configuring NFS on Celerra, server_kerberos. Celerra Network Server Command Reference Manual...
Page 423
To display the status of the secure NFS service, type: $ server_nfs server_2 -secnfs server_2 : RPCSEC_GSS server stats Credential count: 2 principal: nfs@dm112-cge0.nasdocs.emc.com principal: nfs@dm112-cge0 Total number of user contexts: 1 Current context handle: 3 EXAMPLE #2 To enable secure NFS service on server_2, type:...
Page 424
$ server_nfs server_2 -secnfs -user -release handle=3 server_2 : done EXAMPLE #7 To create a secure NFS service instance, type: $ server_nfs server_2 -secnfs -principal -create nfs1@dm112-cge0.nasdocs.emc.com server_2 : done EXAMPLE #8 To delete a secure NFS service instance, type: $ server_nfs server_2 -secnfs -principal -delete nfs1@dm112-cge0.nasdocs.emc.com...
Page 425
Delegations to be removed in non-debug images. Free EXAMPLE #17 To display all NFSv4 clients, type: $ server_nfs server_2 -v4 -client -list server_2 : ------------ nfsv4 server client list ------------ hostname/ip : Index NFSCLIENT1.nasdocs.emc.com : 0xa5400000 -------------------------------------------------- server_nfs...
Multiple hostnames or IP addresses can be queried. Prior to performing a query, the NIS server must be activated and operational. -status Displays the status of the NIS lookup server even when the NIS server is not operational. SEE ALSO Configuring Celerra Naming Services, server_dns. server_nis...
Page 430
If NIS was not started, the output of this command will display as: $ server_nis server_2 -status server_2 : NIS not started EXAMPLE #5 To delete all of the NIS lookup servers for a Data Mover, type: $ server_nis server_2 -delete server_2 : done Celerra Network Server Command Reference Manual...
Modifies the value of the specified <param_name> and changes the value to <new_value>. The <facility_name> is the facility for <param_name>. SEE ALSO Celerra Network Server Parameters Guide. EXAMPLE #1 To view all facilities that can be modified on server_2, type: $ server_param server_2 -info...
Page 432
EXAMPLE #2 To view the PAX parameters that can be modified, type: $ server_param server_2 -facility PAX -list server_2 : param_name facility default current configured paxWriteBuff dump allowVLCRestoreToUFS checkUtf8Filenames paxStatBuff readWriteBlockSizeInKB filter.numFileFilter Celerra Network Server Command Reference Manual...
Page 433
The server Commands paxReadBuff filter.numDirFilter noFileStreams nFTSThreads scanOnRestore filter.caseSensitive nPrefetch nRestore writeToArch writeToTape nThread Where: Value Definition name of the parameters with the specified facility that can be modified. name facility for the parameters. facility default value for the parameter. default current value used by the Data Mover.
Page 434
= reboot DataMover range = (0,1) description = Whether to check if file names are in valid utf8 format name = paxStatBuff facility_name = PAX default_value = 128 current_value = 128 configured_value user_action = none Celerra Network Server Command Reference Manual...
Page 435
The server Commands change_effective = immediate range = (1,2048) description = Number of buffers in stat queue per backup session name = readWriteBlockSizeInKB facility_name = PAX default_value = 64 current_value = 64 configured_value user_action = reboot DataMover change_effective = reboot DataMover range = (64,256) description...
Page 436
= immediate range = (1,32) description = Number of tape records prefetched per worker thread name = nRestore facility_name = PAX default_value = 16 current_value = 16 configured_value user_action = none change_effective = immediate Celerra Network Server Command Reference Manual...
Page 437
The server Commands range = (1,64) description = Number of worker threads per restore session name = writeToArch facility_name = PAX default_value current_value configured_value user_action = none change_effective = immediate range = (0,1) description = Enables writing to a file with server_archive name = writeToTape facility_name...
Page 440
To view the verbose statistics for an active NDMP restore session on server_2: $ server_pax server_2 -stats -verbose server_2 : ************** SUMMARY PAX STATS **************** ---- NASS STATS ---- nass00 is not doing backup Celerra Network Server Command Reference Manual...
Page 441
The server Commands nass01 is not doing backup nass02 is not doing backup nass03 is not doing backup ---- NASA STATS ---- nasa thid 0 (non-DAR RESTORE) ** The first five entries of restore name list are: original name: /filt, destination name /ufsvbbr/r_filter_pax Total bytes processed: 172326912 Total...
<ip_addr> is accessible through the specified <interface>. The IP address may be used if NIS and/or DNS are not operational. SEE ALSO Configuring and Managing Celerra Networking, server_dns, server_ifconfig, server_nis. EXAMPLE #1 To display connectivity from a Data Mover to the outside world, type: $ server_ping server_2 172.24.102.2...
Page 443
The server Commands server_2 : 172.24.102.2 is alive, time= 0 ms $ server_ping server_2 172.24.102.5 server_2 : Error 6: server_2 : No such device or address no answer from 172.24.102.5 EXAMPLE #2 To display connectivity for a Data Mover to the outside world while sending continuous ECHO_REQUEST messages, type: $ server_ping server_2 -send 172.24.102.2 server_2 :...
The server Commands server_route Manages the routing table for the specified Data Mover(s). SYNOPSIS server_route { <movername> | ALL } -flush | -DeleteAll | -list | {-add | -delete} default <gateway> | {-add | -delete} [host|net ] <dest> <gateway> [<netmask>] DESCRIPTION server_route creates, displays and deletes routing entries for the specified Data Mover(s).
Page 446
<gateway> argument indicates the network gateway to which packets should be addressed. By default, a netmask of 255.255.255.255 is assigned to host routes. SEE ALSO Configuring and Managing Celerra Networking, server_netstat, server_ifconfig. EXAMPLE #1 To list the routing table for server_2, type:...
Page 447
The server Commands EXAMPLE #6 To flush the routing table for a Data Mover, type: $ server_route server_2 -flush server_2 : done EXAMPLE #7 To delete all routing entries, type: $ server_route server_2 -DeleteAll server_2 : done server_route...
DESCRIPTION server_security queries or updates the security policy settings on the Data Mover (s). The Celerra Network Server stores the GPO settings in a GPO cache on the Data Mover. When you start the CIFS service on a Data Mover, the Celerra Network Server reads the settings stored in the GPO cache, and then retrieves the most recent GPO settings from the Windows domain controller.
Page 449
Displays current CHAP security settings for the Data Mover, or the specified <client_name>. SEE ALSO Configuring iSCSI Targets on Celerra and Managing Celerra for the Windows Environment, server_iscsi, server_checkup. EXAMPLE #1 To query the GPO settings for all configured CIFS servers, type:...
Page 450
$ server_security server_2 -modify -policy chap -name client1 server_2 : Enter New Secret:**** done EXAMPLE #6 To delete CHAP security for client1, type: $ server_security server_2 -delete -policy chap -name client1 server_2 : done Celerra Network Server Command Reference Manual...
-Load <image_name> Loads an image onto a Data Mover. The image may be an emergency patch or debug image provided by EMC. Do not use this option unless directed by EMC customer service. -Protocol {cifs | mpfs | viruschk | rip | cdms} Selects the protocol configuration to be managed.
Page 452
RIP or virus checker protocol configurations. delete Deletes the protocol configuration. SEE ALSO Configuring Standbys on Celerra, server_cdms, server_checkup, server_mpfs, server_rip, server_standby, server_viruschk. EXAMPLE #1 To set up a Data Mover as a standby, type: $ server_setup server_2 -type standby...
Page 453
The server Commands EXAMPLE #5 To delete the CIFS protocol configuration for a Data Mover, type: $ server_setup server_2 -Protocol cifs -option delete server_2 : done Warning 4037: server_2 : CIFS configurations for server_2 and VDM(s) currently loaded on it EXAMPLE #6 To load a new image onto a Data Mover, type: $ server_setup server_2 -Load nas.exe...
To assign a new value of private to a server SNMP agent’s community for a Data Mover, type: $ server_snmp server_2 -community private server_2: done EXAMPLE #3 To display the syscontact value that is assigned, type: $ server_snmp server_2 -syscontact server_2: nasadmin Celerra Network Server Command Reference Manual...
Page 455
The server Commands EXAMPLE #4 To display the location value that is assigned, type: $ server_snmp server_2 -location server_2: here server_snmp...
Data Mover once it has been activated. -verify {mover} Verifies the standby status of the Data Mover after a hardware replacement. If Data Mover hardware has been replaced, the reboot cycle may not be displayed. Celerra Network Server Command Reference Manual...
Page 457
-create rdf[=<slot_number> Designates a remote RDF standby Data Mover as indicated by its slot number. SEE ALSO Configuring Standbys on Celerra, server_setup. EXAMPLE #1 To create a standby relationship between server_2 (primary) and server_3 (standby), type: $ server_standby server_2 -create mover=server_3 server_2 : server_3 is rebooting as standby Note: Before any other actions can take place, the reboot must be complete.
Page 458
: server_3 is rebooting as standby $ server_standby server_4 -create mover=server_3 server_4 : done $ server_standby server_5 -create mover=server_3 server_5 : done Note: Before any other actions can take place, the reboot must be complete. Celerra Network Server Command Reference Manual...
The server Commands server_sysconfig Manages the hardware configuration for the specified or all Data Movers. SYNOPSIS server_sysconfig { <movername> | ALL } {-Platform | -pci [<device> [-option <options>]] | -virtual -delete [-Force] <device> | -virtual [-info <device>] | -virtual -name <device> -create trk -option device=<device,..>...
Page 460
Sets the speed for the port. auto (default) turns on autonegotiation; setting a fixed speed disables autonegotiation. duplex={full | half | auto } Sets the duplex to full, half, or auto. auto (default) turns autonegotiation on; setting a fixed duplex disables autonegotiation. Celerra Network Server Command Reference Manual...
Page 461
If not, the command appears to execute, but does not pick up any options not contained within double quotes. A gigabit trunk can be created on more than two gigabit devices. The Celerra Network Server has only two gigabit devices(ace0, ace1), so a server_sysconfig...
Page 462
The -option string must be defined in sequence, separated with a space, and enclosed with double quotes. If not, the command appears to execute, but does not pick up any options not contained within double quotes. Celerra Network Server Command Reference Manual...
Page 463
The network interface cards available are dependent on the type of system used. For the Celerra Network Server, the following NICs are available: loop, ace, ana, cge, el30, el31, fpa, and fa2. Note that loop, el30, and el31 are for internal use only.
Page 466
$ server_sysconfig server_2 -virtual -name fsn0 -create fsn -option "primary=cge2 device=cge2,cge3" server_2 : done EXAMPLE #9 To view the fail-safe network device, type: $ server_sysconfig server_2 -virtual -info fsn0 server_2 : *** FSN fsn0: Link is Up *** active=cge2 primary=cge2 standby=cge3 Celerra Network Server Command Reference Manual...
Page 467
The server Commands Where: Value Definition name of the active device in the FSN. active primary device in the FSN. primary standby device in the FSN. standby EXAMPLE #10 To create an aggregated link using the LACP protocol with load balancing method set to mac, type: $ server_sysconfig server_2 -virtual -name trk0_la -create trk -option "device=cge2,cge3 protocol=lacp lb=mac"...
EXAMPLE #2 To display current blockmap memory status, type: $ server_sysstat server_2 -blockmap server_2 : total paged in total paged out page in rate page out rate block map memory quota = 1048576(KB) Celerra Network Server Command Reference Manual...
Page 469
The server Commands block map memory consumed = 624(KB) Where: Value Definition total number of blockmap pages paged in since the system booted. total paged in total number of blockmap pages paged out since the system booted. total paged out number of blockmap pages paged in per second (over last 180 seconds).
Sets write access for all users or no users (default). -clear Clears the path/readaccess/writeaccess settings TFTP service for the specified Data Mover. SEE ALSO Using TFTP on Celerra Network Server . EXAMPLE #1 To start TFTP service for server_2, type: $ server_tftp server_2 -service -start server_2 : done...
Page 471
The server Commands EXAMPLE #2 To display the status of the TFTP service for server_2, type: $ server_tftp server_2 -service -status server_2 : Tftp Running EXAMPLE #3 To modify a path on server_2 for TFTP service with read access for all, and write access for nobody, type: $ server_tftp server_2 -set -path /ufs1 -readaccess all -writeaccess none server_2 : done...
Page 472
To stop TFTP service on server_2, type: $ server_tftp server_2 -service -stop server_2 : done EXAMPLE #7 To delete the settings for the TFTP service on server_2, type: $ server_tftp server_2 -clear server_2 : done Celerra Network Server Command Reference Manual...
Forces the unmount of a production file system. CAUTION Unmounting a PFS for which automatic checkpoint scheduling (configured using the Celerra Web Manager or Celerra Native Manager) has been implemented is not recommended. Doing so will corrupt the schedule and cause checkpoint data to be lost.
Page 474
The server Commands Managing Celerra for the Windows Environment, Managing Celerra for a Multiprotocol Environment, and Using SnapSure on Celerra, server_mount, server_mountpoint, fs_ckpt. EXAMPLE #1 To permanently unmount a file system, type: $ server_umount server_2 -perm /bin server_2: done EXAMPLE #2...
The server Commands server_uptime Displays the length of time that a specified Data Mover has been running since the last reboot. SYNOPSIS server_uptime { <movername> | ALL } DESCRIPTION server_uptime displays the length of time that the specified Data Mover has been running since its last reboot. The ALL option executes the command for all of the Data Movers.
Data Mover. server_user adds or disables, locks or unlocks an optional password for a user account. Data Mover user accounts provide administrative access to certain Celerra features and third party applications. The ALL option executes the command for all of the Data Movers.
Page 477
To unlock a password, use the -force option. SEE ALSO Managing Administrative Accounts on Celerra, Using Celerra FileMover, Using FTP on the Celerra Network Server and Configuring NDMP Backups on Celerra. EXAMPLE #1 To create a user account for user1, type:...
Page 478
To disable an account password for ndmp, type: # /nas/sbin/server_user server_2 -password -disable ndmp Changing password for user ndmp Removing password for user ndmp EXAMPLE #9 To delete a user account for user1, type: # /nas/sbin/server_user server_2 -delete user1 Celerra Network Server Command Reference Manual...
Internal Usermapper service running on a Data Mover. Only one primary Usermapper service is recommended for a Celerra Network Server environment. In a single Celerra Network Server environment, there should only be one primary instance of the Usermapper service.
Page 480
Internal Usermapper. Note: If there is no specific reason to use particular UID and GID ranges for your environments’ domains, EMC encourages you to use the automatic mapping method and let Internal Usermapper automatically assign new UIDs/GIDs based on the next available values. If you need to use an existing...
Page 481
The server Commands CAUTION EMC recommends that you consult with Customer Support before issuing the -force option. This option overwrites the existing Usermapper database file and may result in users losing access to file systems. If you decide to use the -force option, you should first back up your existing Usermapper database file and usrmap.cfg...
Page 482
: done EXAMPLE #10 To remove all entries from the Usermapper database, type: $ server_usermapper server_2 -remove -all server_2 : Warning: This operation will erase all user/group mappings. CIFS users may lose access. Continue(Y/N): done Celerra Network Server Command Reference Manual...
EXAMPLE #1 To display the software version for a Data Mover, type: $ server_version server_2 server_2 : Product: EMC Celerra File Server Version: T5.5.80.0 EXAMPLE #2 To display the system software version for all Data Movers, type: $ server_version ALL server_2 : Product: EMC Celerra File Server Version: T5.5.80.0...
Sets the reference time on the virus checker configuration file to now, disables the time scan, or sets the access time in the specified format. -fsscan Displays the file system scan status for all file systems. Celerra Network Server Command Reference Manual...
Page 485
<fs_name> and the offline options allows the file system scan on all offline files. By default, offline file systems are not included. The -delete option stops the scan. SEE ALSO Using Celerra AntiVirus Agent, server_checkup, server_setup. EXAMPLE #1 To display the virus checker configuration, type: $ server_viruschk server_2...
Page 486
8 dirs scanned and 11 files submitted to the scan engine firstFNN=0x0, lastFNN=0xe0eba410, queueCount=0, burst=10 FileSystem 25 mounted on /ufs2: 9 dirs scanned and 11 files submitted to the scan engine firstFNN=0x0, lastFNN=0xe0010b70, queueCount=0, burst=10 Celerra Network Server Command Reference Manual...
Page 487
The server Commands EXAMPLE #8 To stop a scan on a file system, type: $ server_viruschk server_2 -fsscan ufs1 -delete server_2 : done server_viruschk...
{[-robot {[-vendor <vendor>] [-product <product>] [-revision <revision>]}] [-slots <num_slots>] [-impexp <num_impexp_slots>][-drives <num_drives>] [-drive {[-vendor <vendor>][-product <product>] [-revision <revision>]}]} | -delete <tlu_id>} -tlu -list Lists all of the VTLUs configured on the specified Data Mover(s). Celerra Network Server Command Reference Manual...
Page 489
Creates a VTLU on the specified Data Mover with the specified robot’s vendor, product, and revision information. If this information is not specified, the default values of EMC, svtlRobot, and 1.0 are used. These values have character limits of 8, 16, and 4, respectively.
Page 490
Specifies the destination of the virtual tape as a slot, an import/export slot, or the vault. Slot is the default location. -storage -extend <fs_name> -tlu <tlu_id> Adds more tapes to a file system that has been extended. Celerra Network Server Command Reference Manual...
Page 491
The server Commands [-tapesize <size>G] Specifies the size of the virtual tape. If no value is defined, and the -tapes <num_tapes> is not defined, then the default value of 50 GB is used. If the <num_tapes> is defined but <size> is not, then the tape size is determined by the number of tapes and the file system size.
Page 492
If the source slot is unavailable, the tape is placed in another available slot. SEE ALSO Configuring NDMP Backups to Disk on Celerra, and Celerra Network Server Parameters Guide, nas_fs. EXAMPLE #1 To set the chain_ID for server_2, type:...
Page 493
The server Commands robot revision = 1.1a robot serial number = P8gIgqs2k5 robot device name = c1t0l0 drives drive vendor = EMCCorp drive product = vtluDrive drive revision = 2.2a Where: Value Definition unique VTLU identifier that is assigned automatically. number of virtual slots in the VTLU.
Page 494
To modify vendor, product and revision information for the robot and drive of VTLU 3 for server_2, type: $ server_vtlu server_2 -tlu -modify 3 -robot -vendor EMC -product vRobot -revision 1.1b -drives 3 -drive -vendor EMC -product vDrive -revision 2.2b...
Page 495
The server Commands Where: Value Definition unique VTLU identifier that is assigned automatically. tlu_id name of the file system associated with the VTLU. filesystem barcode_prefix modifiable prefix assigned to virtual tapes that is constant across a file system. EXAMPLE #13 To list VTLU information on VTLU 3, type: $ server_vtlu server_2 -tape -list 3 server_2 :...
Page 496
To delete storage from VTLU 3, type: $ server_vtlu server_2 -storage -delete ufs1 -tlu 3 server_2 : done EXAMPLE #19 To delete VTLU 3 from server_2, type: $ server_vtlu server_2 -tlu -delete 3 server_2 : done Celerra Network Server Command Reference Manual...
Using Celerra Command Scripts This appendix contains information about command scripts that can be used to automate many Celerra tasks. Using Celerra Command Scripts...
EMC recommends that command scripts avoid starting at one minute after the hour. Note that scripts with complex commands that run for an extended period may overlap the backup period.
Page 499
Using Celerra Command Scripts Scripting examples The RECOVERABLE variable contains the following errors to retry Unable to acquire lock Resource temporarily unavailable Unable to connect to host Socket: All ports in use Database resource vanished Connection timed out NAS_DB locked object is stale...
Page 500
# check retry count if [ $retry_count -ne $RETRIES ]; then # retry count has not been exceeded LOGMSG="Command ($CMD) failed with ($RES)...retrying in $SLEEPTIME s" nas_log sleep $SLEEPTIME else # retry count has been exceeded Celerra Network Server Command Reference Manual...
Page 501
# main CMD="nas_volume -d mtv1" nas_cmd Using the NAS EMC has partially changed the layout or format of Celerra internal database and query databases. This change can impact the use of awk or grep utilities facility when used in scripts that assume specific positions of fields in databases.
Page 502
-query:id==20 -format:'%s\n' -Fields:Type List the file systems that are in use nas_fs -query:inuse==y -format:'%s\n' -Fields:Name nas_fs -query:inuse==y -format:'%s\n' -Fields:Id Identify file system of which file system ID nas_fs -query:id==28 -format:'%s' -Fields:BackupOf 28 is a backup Celerra Network Server Command Reference Manual...
Page 503
Using Celerra Command Scripts Task and query examples (Sheet 2 of 2) Table 2 Task Example List the name of the server with ID 2 nas_server -query:id==2 -format:'%s\n' -fields:name`" View which volume file system is built on nas_fs -query:Name==my_fs -format:%d...
Page 504
Exact string match Integer Minimum (not less than) Integer Maximum (not more than) NOT having the pattern NOT an exact match NOT Integer Minimum (is less than) NOT Integer Maximum (is more than) NOT Any (None) Celerra Network Server Command Reference Manual...
Page 505
License This section contains the GNU General Public License (GPL). The GPL is the license for the Linux operating system. All EMC software, including the Celerra Network Server software, is licensed by the EMC Software License included in the software kit.
You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Celerra Network Server Command Reference Manual...
GNU General Public License We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software.
Page 508
Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. Celerra Network Server Command Reference Manual...
Page 509
GNU General Public License In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.
Page 510
It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the Celerra Network Server Command Reference Manual...
Page 511
GNU General Public License integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system;...
SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS Celerra Network Server Command Reference Manual...
Page 516
Group policy object 448 read-only 398 Group quotas 217 read-write 398 Group, file system 61 renaming 169 size 169 total capacity 348 Halting a Data Mover 333 types Health checkup 128 ckpt 168 High watermark 175 Celerra Network Server Command Reference Manual...
Page 522
269 listing 269 minimum size for file system 270 renaming 269 Windows NT 4.0 295 Windows NT 4.0 domain 313 Windows NT Credential 400 Windows permissions 169 Windows popups 42 WINS server(s) 320 Celerra Network Server Command Reference Manual...
Need help?
Do you have a question about the Celerra and is the answer not in the manual?
Questions and answers