EMC® VMAX® eNAS CLI Reference Guide Version 8.1.12.27 For: VMAX3™ Family: VMAX 100K, 200K, 400K VMAX All Flash: 250F, 450F, 850F, 950F REVISION 01 Copyright © 2016-2017 EMC Corporation All rights reserved. Published May 2017 Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners. Published in the USA. EMC Corporation Hopkinton, Massachusetts 01748-9103 1-508-435-1000 In North America 1-866-464-7381 www.EMC.com 2 eNAS CLI Reference Guide 8.1.12.27 For: VMAX3 Family: VMAX 100K, 200K, 400K VMAX All Flash: 250F, 450F, 850F, 950F PREFACE As part of an effort to improve its product lines, EMC periodically releases revisions of its software and hardware. Therefore, some functions described in this document might not be supported by all versions of the software or hardware currently in use. The product release notes provide the most up-to-date information on product features. Contact your EMC representative if a product does not function properly or does not function as described in this document. Note This document was accurate at publication time. New versions of this document might be released on EMC Online Support (https://support.emc.com). Check to ensure that you are using the latest version of this document. Purpose This reference guide provides man pages for all the eNAS CLI commands. Audience This manual provides reference information for command-line users and script programmers that focus on configuring and managing eNAS on VMAX arrays. Related documentation The following documents provide additional eNAS information: l VMAX eNAS Release Notes Describes new features and identifies any known functionality restrictions and performance issues that may exist with the current version and your specific storage environment. l VMAX eNAS File Auto Recovery with SRDF/S Describes how to install and use File Auto Recovery to failover/move eNAS Virtual Data Movers from source eNAS systems to destination eNAS systems using SRDF/S. l Using SRDF/S with VNX for Disaster Recovery Explains how to configure and manage SRDF/S. l EMC VNX Command Line Interface Reference for File Explains the command used to configure and manage an EMC file storage system. l Managing Volumes and File Systems on VNX Manually Explains how to create and aggregate different volume types into usable file system storage. l UsingVNX SnapSure Explains how to use EMC SnapSure to create and manage checkpoints. l Configuring Virtual Data Movers on VNX Explains how to configure and manage VDMs on a file storage system. l Configuring CIFS on VNX Explains how to configure and manage NFS. l Parameters Guide for VNX for File Explains how to view and modify parameters and system settings. PREFACE 3 PREFACE Where to get help EMC support, product, and licensing information can be obtained as follows: To open a service request through EMC Online Support (https://support.emc.com), you must have a valid support agreement. Contact your EMC sales representative for details about obtaining a valid support agreement or to answer any questions about your account. Product information For documentation, release notes, software updates, or information about EMC products, go to EMC Online Support at https://support.emc.com. NoteTechnical support EMC offers a variety of support options. l Support by Product — EMC offers consolidated, product-specific information on the Web at: https://support.EMC.com/products The Support by Product web pages offer quick links to Documentation, White Papers, Advisories (such as frequently used Knowledgebase articles), and Downloads, as well as more dynamic content, such as presentations, discussion, relevant Customer Support Forum entries, and a link to EMC Live Chat. l EMC Live Chat — Open a Chat or instant message session with an EMC Support Engineer. eLicensing support To activate your entitlements and obtain your VMAX license files, visit the Service Center on https://support.EMC.com, as directed on your License Authorization Code (LAC) letter emailed to you. l For help with missing or incorrect entitlements after activation (that is, expected functionality remains unavailable because it is not licensed), contact your EMC Account Representative or Authorized Reseller. l For help with any errors applying license files through Solutions Enabler, contact the EMC Customer Support Center. l If you are missing a LAC letter, or require further instructions on activating your licenses through the Online Support site, contact EMC's worldwide Licensing team at [email protected] or call: n North America, Latin America, APJK, Australia, New Zealand: SVC4EMC (800-782-4362) and follow the voice prompts. n EMEA: +353 (0) 21 4879862 and follow the voice prompts. Your comments Your suggestions help us improve the accuracy, organization, and overall quality of the documentation. Send your comments and feedback to: [email protected] 4 eNAS CLI Reference Guide 8.1.12.27 For: VMAX3 Family: VMAX 100K, 200K, 400K VMAX All Flash: 250F, 450F, 850F, 950F eNAS components The following terminology is used throughout this document: l Management Module Control Station (MMCS): Used by EMC Customer Support to configure eNAS, if necessary. l Network Address Translation (NAT) Gateway: Used to configure the external IP address of the Control Station. l Control Station (CS): Provides management functions to the file-side components referred to as Data Movers. l Data Mover (DM): Clients communicate with a Data Mover using either/both NFS and CIFS/SMB protocols. Clients are physically connected to the Data Mover through I/O modules on the storage array that are assigned to the Data Mover. The Data Mover accesses the client data by way of an internal interface to the storage array on which the Data Mover resides eNAS components 5 eNAS components 6 eNAS CLI Reference Guide 8.1.12.27 For: VMAX3 Family: VMAX 100K, 200K, 400K VMAX All Flash: 250F, 450F, 850F, 950F Control station The Control Station provides utilities for managing, configuring, and monitoring of the Data Movers in the eNAS system. As the system administrator, you may type commands through the Control Station to perform tasks that include the following: l Managing and Configuring the database and Data Movers l Monitoring statistics of the eNAS components NoteAccessing the Control Station You may use either local or remote access to the Control Station. To access locally a connection to serial port have to be established. l Local access to the command line interface is available directly at the Control Station console. l Remote access to the command line interface by using a secure, encrypted login application allows the use of the eNAS command set. Accessing the command line interface A description of how to gain local or remote access to the command line interface for the eNAS follows. For a local connection, connect a client to the Control Station serial port. l For local access to the command line interface, at the prompt, log in with your administrative username and password. Establish the connection to the Control Station with the following settings: Table 1 Control Station serial port connection settings Setting Value Bits per second 19200 Data bits 8 Parity None Stop bits 1 Flow control None Emulation Auto Detect Telnet terminal ID ANSI l For remote access to the command line interface: Control station 7 Control station 1. Use a secure, encrypted, remote login application capable of SSH. Type the IP address of the Control Station. 2. Log in with your administrative username and password. 8 eNAS CLI Reference Guide 8.1.12.27 For: VMAX3 Family: VMAX 100K, 200K, 400K VMAX All Flash: 250F, 450F, 850F, 950F Role-Based access The administrative user account you use to access the command line interface is associated with specific privileges, also referred to as roles. A role defines the privileges (operations) a user can perform on a particular eNAS object. The ability to select a predefined role or define a custom role that gives a user certain privileges is supported for users who access eNAS through the CLI, EMC Unisphere™, and the XML API. The Security Configuration Guide for VNX provides detailed information about how role- based access is used to determine the commands a particular user can execute. You create and manage user accounts and roles in Unisphere by using Settings > User Management. Role-Based access 9 Role-Based access 10 eNAS CLI Reference Guide 8.1.12.27 For: VMAX3 Family: VMAX 100K, 200K, 400K VMAX All Flash: 250F, 450F, 850F, 950F Command set conventions This manual uses commonly known command set conventions for the eNAS for file 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 synopsis contains the actual command usage. The description contains a more detailed breakdown of the features of the command, and the options describe what each switch or option does specifically. The ’See Also’ section refers to the technical modules that support the feature, in addition to any other commands that interact with the command. The examples are at the end of the command. The naming convention for the Data Mover variable in the command line interface is <movername> (default = server_2 to server_9).