Veritas Storage Foundation Scalable File Server Administrator's Guide 5.5

Transcription

1 Veritas Storage Foundation Scalable File Server Administrator's Guide 5.5

2 Veritas Storage Foundation Scalable File Server Administrator s Guide The software described in this book is furnished under a license agreement and may be used only in accordance with the terms of the agreement. Documentation version Legal Notice Copyright 2009 Symantec Corporation. All rights reserved. Symantec, the Symantec Logo are trademarks or registered trademarks of Symantec Corporation or its affiliates in the U.S. and other countries. Other names may be trademarks of their respective owners. This Symantec product may contain third party software for which Symantec is required to provide attribution to the third party ( Third Party Programs ). Some of the Third Party Programs are available under open source or free software licenses. The License Agreement accompanying the Software does not alter any rights or obligations you may have under those open source or free software licenses. Please see the Third Party Legal Notice Appendix to this Documentation or TPIP ReadMe File accompanying this Symantec product for more information on the Third Party Programs. The product described in this document is distributed under licenses restricting its use, copying, distribution, and decompilation/reverse engineering. No part of this document may be reproduced in any form by any means without prior written authorization of Symantec Corporation and its licensors, if any. THE DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. SYMANTEC CORPORATION SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE. The Licensed Software and Documentation are deemed to be commercial computer software as defined in FAR and subject to restricted rights as defined in FAR Section "Commercial Computer Software - Restricted Rights" and DFARS , "Rights in Commercial Computer Software or Commercial Computer Software Documentation", as applicable, and any successor regulations. Any use, modification, reproduction release, performance, display or disclosure of the Licensed Software and Documentation by the U.S. Government shall be solely in accordance with the terms of this Agreement.

3 Symantec Corporation 350 Ellis Street Mountain View, CA

4 Technical Support Symantec Technical Support maintains support centers globally. Technical Support s primary role is to respond to specific queries about product features and functionality. The Technical Support group also creates content for our online Knowledge Base. The Technical Support group works collaboratively with the other functional areas within Symantec to answer your questions in a timely fashion. For example, the Technical Support group works with Product Engineering and Symantec Security Response to provide alerting services and virus definition updates. Symantec s maintenance offerings include the following: A range of support options that give you the flexibility to select the right amount of service for any size organization Telephone and Web-based support that provides rapid response and up-to-the-minute information Upgrade assurance that delivers automatic software upgrade protection Global support that is available 24 hours a day, 7 days a week Advanced features, including Account Management Services For information about Symantec s Maintenance Programs, you can visit our Web site at the following URL: Contacting Technical Support Customers with a current maintenance agreement may access Technical Support information at the following URL: Before contacting Technical Support, make sure you have satisfied the system requirements that are listed in your product documentation. Also, you should be at the computer on which the problem occurred, in case it is necessary to replicate the problem. When you contact Technical Support, please have the following information available: Product release level Hardware information Available memory, disk space, and NIC information Operating system

5 Version and patch level Network topology Router, gateway, and IP address information Problem description: Error messages and log files Troubleshooting that was performed before contacting Symantec Recent software configuration changes and network changes Licensing and registration Customer service If your Symantec product requires registration or a license key, access our technical support Web page at the following URL: Customer service information is available at the following URL: Customer Service is available to assist with the following types of issues: Questions regarding product licensing or serialization Product registration updates, such as address or name changes General product information (features, language availability, local dealers) Latest information about product updates and upgrades Information about upgrade assurance and maintenance contracts Information about the Symantec Buying Programs Advice about Symantec's technical support options Nontechnical presales questions Issues that are related to CD-ROMs or manuals

6 Maintenance agreement resources If you want to contact Symantec regarding an existing maintenance agreement, please contact the maintenance agreement administration team for your region as follows: Asia-Pacific and Japan Europe, Middle-East, and Africa North America and Latin America Additional enterprise services Symantec offers a comprehensive set of services that allow you to maximize your investment in Symantec products and to develop your knowledge, expertise, and global insight, which enable you to manage your business risks proactively. Enterprise services that are available include the following: Symantec Early Warning Solutions Managed Security Services Consulting Services Educational Services These solutions provide early warning of cyber attacks, comprehensive threat analysis, and countermeasures to prevent attacks before they occur. These services remove the burden of managing and monitoring security devices and events, ensuring rapid response to real threats. Symantec Consulting Services provide on-site technical expertise from Symantec and its trusted partners. Symantec Consulting Services offer a variety of prepackaged and customizable options that include assessment, design, implementation, monitoring, and management capabilities. Each is focused on establishing and maintaining the integrity and availability of your IT resources. Educational Services provide a full array of technical training, security education, security certification, and awareness communication programs. To access more information about Enterprise services, please visit our Web site at the following URL: Select your country or language from the site index.

7 Contents Technical Support... 4 Chapter 1 Introducing the Veritas Storage Foundation Scalable File Server About Storage Foundation Scalable File Server About the core strengths of SFS About SFS features Simple installation Administration Scalable NFS NFS Lock Management (NLM) Active/Active CIFS Storage tiering SFS key benefits and other applications High performance scaling and seamless growth High availability Consolidating and reducing costs of storage Enabling scale-out compute clusters and heterogeneous sharing of data Chapter 2 Creating users based on roles About user roles and privileges About the naming requirements for adding new users About using the SFS command-line interface Logging in to the SFS CLI About accessing the online man pages About creating Master, System Administrator, and Storage Administrator users Creating Master, System Administrator, and Storage Administrator users About the support user Configuring the support user account Displaying the command history... 37

8 8 Contents Chapter 3 Displaying and adding nodes to a cluster About the cluster commands Displaying the nodes in the cluster About adding a new node to the cluster Installing the SFS software onto a new node Adding a node to the cluster Deleting a node from the cluster Shutting down the cluster nodes Rebooting the nodes in the cluster Chapter 4 Configuring SFS network settings About network mode commands Displaying the network configuration and statistics About bonding Ethernet interfaces Bonding Ethernet interfaces About DNS Configuring DNS settings About IP commands About configuring IP addresses Configuring IP addresses About configuring Ethernet interfaces Configuring Ethernet interfaces About configuring routing tables Configuring routing tables About LDAP Before configuring LDAP settings About configuring LDAP server settings Configuring LDAP server settings About administering SFS cluster's LDAP client Administering the SFS cluster's LDAP client About NIS Configuring the NIS-related commands About NSS Configuring NSS lookup order About VLAN Configuring VLAN Chapter 5 Configuring your NFS server About NFS server commands Accessing the NFS server Displaying NFS statistics... 92

9 Contents 9 Displaying file systems and snapshots that can be exported Chapter 6 Configuring storage About storage provisioning and management About configuring storage pools Configuring storage pools About configuring disks Configuring disks About displaying information for all disk devices Displaying information for all disk devices associated with nodes in a cluster Increasing the storage capacity of a LUN Printing WWN information Initiating SFS host discovery of LUNs About I/O fencing Configuring I/O fencing Chapter 7 Creating and maintaining file systems About creating and maintaining file systems Listing all file systems and associated information About creating file systems Creating a file system Adding or removing a mirror to a file system Configuring FastResync for a file system Disabling the FastResync option for a file system Increasing the size of a file system Decreasing the size of a file system Checking and repairing a file system Changing the status of a file system Destroying a file system About snapshots Configuring snapshots About snapshot schedules Configuring snapshot schedules Chapter 8 Creating and maintaining NFS shares About NFS file sharing Displaying exported file systems Adding an NFS share Sharing file systems using CIFS and NFS protocols Unexporting a file system or deleting NFS options

10 10 Contents Chapter 9 Using SFS as a CIFS server About configuring SFS for CIFS About configuring CIFS for standalone mode Configuring CIFS server status for standalone mode About configuring CIFS for NT domain mode Configuring CIFS for the NT domain mode About leaving an NT domain Changing NT domain settings Changing security settings Changing security settings after the CIFS server is stopped About configuring CIFS for AD domain mode Configuring CIFS for the AD domain mode Leaving an AD domain Changing domain settings for AD domain mode Removing the AD interface About setting NTLM Setting NTLM About setting trusted domains Setting AD trusted domains About storing account information Storing user and group accounts About reconfiguring the CIFS service Reconfiguring the CIFS service About managing CIFS shares Setting share properties Sharing file systems using CIFS and NFS protocols About SFS cluster and load balancing Splitting a share About managing home directories Setting the home directory file systems Enabling quotas on home directory file systems Setting up home directories and use of quotas Displaying home directory usage information Deleting home directories and disabling creation of home directories About managing local users and groups Creating a local CIFS user About configuring local groups Configuring a local group

11 Contents 11 Chapter 10 Using FTP About FTP Displaying FTP server About FTP server commands Using the FTP server commands About FTP set commands Using the set commands About FTP session commands Using the FTP session commands Using the logupload command Chapter 11 Configuring event notifications About configuring event notifications About severity levels and filters About groups Configuring an group About syslog event logging Configuring a syslog server Displaying events About SNMP notifications Configuring an SNMP management server Configuring events for event reporting Exporting events in syslog format to a given URL Chapter 12 Configuring backup About backup Configuring backups using NetBackup or other third-party backup applications About NetBackup Adding a NetBackup master server to work with SFS Configuring or changing the virtual IP address used by NetBackup and NDMP data server installation Configuring the virtual name of NetBackup About Network Data Management Protocol About NDMP supported configurations About the NDMP policies Configuring the NDMP policies Displaying all NDMP policies About retrieving the NDMP data Retrieving the NDMP data Restoring the default NDMP policies

12 12 Contents About backup configurations Configuring backup Chapter 13 Configuring SFS Dynamic Storage Tiering About SFS Dynamic Storage Tiering (DST) How SFS uses Dynamic Storage Tiering About policies About adding tiers to file systems Adding tiers to a file system Removing a tier from a file system About configuring a mirror on the tier of a file system Configuring a mirror to a tier of a file system Listing all of the files on the specified tier Displaying a list of DST file systems Displaying the tier location of a specified file About configuring the policy of each tiered file system Configuring the policy of each tiered file system Relocating a file or directory of a tiered file system About configuring schedules for all tiered file systems Configuring schedules for all tiered file systems Displaying files that will be moved by running a policy Chapter 14 Configuring system information About system commands About setting the clock commands Setting the clock commands About configuring the locally saved configuration files Configuring the locally saved configuration files Using the more command About coordinating cluster nodes to work with NTP servers Coordinating cluster nodes to work with NTP servers Displaying the system statistics Using the swap command About the option commands Using the option commands Chapter 15 Upgrading Storage Foundation Scalable File Server About upgrading drivers Displaying the current version of SFS About installing patches

13 Contents 13 Installing patches Chapter 16 Troubleshooting About troubleshooting commands Retrieving and sending debugging information About the iostat command Generating CPU and device utilization reports About excluding the PCI ID prior to the SFS installation Excluding the PCI IDs from the cluster Testing network connectivity About the services command Using the services command Using the support login About network traffic details Exporting and displaying the network traffic details Accessing processor activity Using the traceroute command Glossary Index

14 14 Contents

15 Chapter 1 Introducing the Veritas Storage Foundation Scalable File Server This chapter includes the following topics: About Storage Foundation Scalable File Server About the core strengths of SFS About SFS features SFS key benefits and other applications About Storage Foundation Scalable File Server Storage Foundation Scalable File Server (SFS) is a highly scalable and highly available clustered Network Attached Storage (NAS) software appliance. It is based on the Storage Foundation Cluster File System technology, and is a complete solution for multi-protocol file serving. SFS provides an open storage gateway model, including a highly available and scalable Network File System (NFS), CIFS and FTP file serving platform and an easy-to-use administrative interface. The product includes the following features: Backup operations using both NDMP and/or the built-in NetBackup client Active/Active CIFS, including integration with Active Directory operations Global cluster administration through a single interface Active/Active shared data NFS sharing including shared read/write and LDAP/NIS support

16 16 Introducing the Veritas Storage Foundation Scalable File Server About the core strengths of SFS Simple administration of Fibre Channel Host Bus Adapters (HBAs), file systems, disks, snapshots, and Dynamic Storage Tiering (DST) SNMP, syslog, and notification Seamless upgrade and patch management Support information Online man pages Simple help SFS provides sharing of NFS and CIFS file systems in a simple, highly scalable, and highly available manner. The components of SFS include a security-hardened, custom-install SLES 10 SP2 operating system, core Storage Foundation services including Cluster File System, and the SFS software platform. These components are provided on a single DVD or DVD ISO image. About the core strengths of SFS SFS leverages all the capabilities and strengths of the Storage Foundation family of products. SFS contains all the key features of Storage Foundation Cluster File System 5.0 MP3 including: Dynamic Multipathing (DMP) Cluster Volume Manager Cluster File System (CFS) Veritas Cluster Server (VCS) Dynamic Storage Tiering (DST) I/O Fencing DMP provides Fibre Channel Host Bus Adapter load balancing policies and tight integration with array vendors to provide in-depth failure detection and path failover logic. DMP is compatible with more hardware than any similar product. Cluster Volume Manager provides a cluster-wide consistent virtualization layer that leverages all the strengths of Veritas Volume Manager (VxVM) including online re-layout and resizing of volumes, and online array migrations. You can mirror your underlying SFS file systems across separate physical frames to ensure maximum availability on the storage tier. This technique seamlessly adds or removes new storage, whether single drives or entire arrays.

17 Introducing the Veritas Storage Foundation Scalable File Server About SFS features 17 About SFS features Simple installation Administration Cluster File System complies with the Portable Operating System Interface (POSIX) standard. It also provides full cache consistency and global lock management at a file or sub-file level. CFS lets all nodes in the cluster perform metadata or data transactions. This allows linear scalability in terms of NFS operations per second. VCS monitors communication, and failover for all nodes in the cluster and their associated critical resources. This includes virtual IP addressing failover for all client connections regardless of the client protocol. DST dynamically and transparently moves files to different storage tiers to respond to changing business needs. DST is used in Storage Foundation Scalable File Server as SFS Storage Tiering. I/O fencing further helps to guarantee data integrity in the event of a multiple network failure by using the SFS storage to ensure that cluster membership can be determined correctly. This virtually eliminates the chance of a cluster split-brain from occurring. SFS has new features specific to being a clustered NAS product. A partial list of these features is discussed in the following sections. A single node in the cluster is booted from a DVD containing the operating system image, core Storage Foundation, and SFS modules. While the node boots, the other nodes are defined using IP addresses. After you install SFS and the first node is up and running, the rest of the cluster nodes are automatically installed with all necessary components. The key services are then automatically started to allow the cluster to begin discovering storage and creating file shares. SFS contains a role-based administration model consisting of the following key roles: Storage Master System These roles are consistent with the operational roles in many data centers.

18 18 Introducing the Veritas Storage Foundation Scalable File Server About SFS features For each role, the administrator uses a simple menu-driven text interface. This interface provides a single point of administration for the entire cluster. A user logs in as one of those roles on one of the nodes in the cluster and runs commands that perform the same tasks on all nodes in the cluster. You do not need to have any knowledge of the Veritas Storage Foundation technology to install or administer an SFS cluster. If you are currently familiar with core SFCFS or Storage Foundation in general, you will be familiar with the basic management concepts. Scalable NFS With SFS, all nodes in the cluster can serve the same NFS shares as both read and write. This creates very high aggregated throughput rates, because you can use sum of the bandwidth of all nodes. Cache-coherency is maintained throughout the cluster. NFS Lock Management (NLM) Active/Active CIFS Storage tiering The NFS Lock Management (NLM) module allows a customer to use NFS advisory client locking in parallel with core SFCFS global lock management. The module consists of failing over the locks among SFS nodes as well as forwarding all NFS client lock requests to a single NFS lock master. The result is that no data corruption occurs if a user or application needs to use NFS client locking with an SFS cluster. CIFS is active on all nodes within the SFS cluster. The specific shares are read/write on the node they reside on, but can failover to any other node in the cluster. SFS supports CIFS home directory shares. SFS's built-in Dynamic Storage Tiering (DST) feature can reduce the cost of storage by moving data to lower cost storage. SFS storage tiering also facilitates the moving of data between different drive architectures. DST lets you do the following: Create each file in its optimal storage tier, based on pre-defined rules and policies. Relocate files between storage tiers automatically as optimal storage changes, to take advantage of storage economies.

19 Introducing the Veritas Storage Foundation Scalable File Server SFS key benefits and other applications 19 Retain original file access paths to minimize operational disruption, for applications, backup procedures, and other custom scripts. Handle millions of files that are typical in large data centers. Automate these features quickly and accurately. SFS key benefits and other applications SFS can be used with any application that requires the sharing of files using the NFS v3, CIFS, or FTP protocol. Use-cases such as home directories or decision support applications that require sequential shared access, Web pages, and applications are all ideal for SFS. SFS is also applicable when you want general purpose, high-throughput scale-out processing for your data, together with enterprise-class highly available cluster functionality. High performance scaling and seamless growth SFS lets you scale storage and processing independently and seamlessly, online. Because an application may need to scale either storage or processing, or both, this capability gives you a lot of flexibility. SFS automates the installation of new nodes into the running cluster, configures those nodes, and adds the nodes' capacity into the processing tier. SFS can scale from 1 to 16 nodes with near linear performance scaling. You can add processing one node at a time, rather than buying a large, expensive independent appliance. A storage administrator can configure a new array or even add new LUNs from an existing array into the SFS cluster. SFS can then scan the storage, automatically see the new LUNs and place them under SFS control for use in the cluster. All of this is performed online. At the storage end, resizing of existing file systems can be performed online with no interruption of service. A simple command is used to both add space to an existing file system and to also reduce (dynamically shrink) the amount of free space in a specified file system. The product provides nearly linear scaling in terms of NFS operations per second and total I/O throughput. Figure 1-1 depicts this scaling capability.

20 20 Introducing the Veritas Storage Foundation Scalable File Server SFS key benefits and other applications Figure 1-1 Example of near-linear performance scaling with SFS High availability When using 16-node clusters, extremely high throughput performance numbers can be obtained. This is due to the benefits of near linear SFS cluster scalability. SFS has an always on" file service that provides zero interruption of file services for company critical data. The loss of single or even multiple nodes does not interrupt I/O operations on the client tier. This is in stark contrast to the traditional NFS active/passive failover paradigm. The SFS architecture provides transparent failover for other key services such as NFS lock state, CIFS and FTP daemons, reporting, logging, and backup/restore operations. The console service that provides access to the centralized menu-driven interface is automatically failed over to another node. The installation service is also highly available and can seamlessly recover from the initially installed node failing during the installation of the remaining nodes in the cluster. The use of Veritas Cluster Server technology and software within SFS is key to the ability of SFS to provide best-of-breed high availability, in addition to class-leading scale-out performance. Consolidating and reducing costs of storage The value of consolidating several independent islands of NFS or NAS appliances into fewer, larger shared pools has many cost benefits. A typical enterprise uses 30-40% of its storage. This low storage utilization rate results in excessive spending on new storage when there is more than adequate free space in the data center.

21 Introducing the Veritas Storage Foundation Scalable File Server SFS key benefits and other applications 21 With SFS, you can group storage assets into fewer, larger shared pools. This increases the use of backend LUNs and overall storage. SFS also has built-in, pre-configured heterogeneous storage tiering. This lets you use different types of storage in a primary and secondary tier configuration. Using simple policies, data can be transparently moved from the primary storage tier to the secondary tier. This is ideal when mixing drive types and architectures such as high-speed SAS drives with cheaper storage, such as SATA-based drives. Furthermore, data can be stored initially on the secondary tier and then promoted to the primary tier dynamically based on a pattern of I/O. This creates an optimal scenario when you use Solid State Disks (SSDs) because there will often be a significant change between the amount of SSD storage available, and amount of other storage availability, such as SATA drives. Data and files that are promoted to the primary tier are transferred back to the secondary tier in accordance with the configured access time policy. All of this results in substantially increased efficiency, and it can save you money because you make better use of the storage you already have. Enabling scale-out compute clusters and heterogeneous sharing of data The trend toward scale-out, or grid computing continues to gain pace. There are significant performance and cost advantages of moving applications away from large UNIX Symmetrical Multi-Processing (SMP) or mainframe environments and towards a farm of commodity computer servers running a distributed application. One of the key inhibitors to scale-out computing is the requirement to provide a shared storage infrastructure for the compute nodes, and enable you to share heterogeneously as well as scale up as performance requires. SFS solves both of these issues by providing a highly scalable and shared storage platform at the storage tier and by facilitating heterogeneous sharing on the compute tier. SFS can provide the performance and availability you need for a large-scale NFS compute and storage tier. It provides enough throughput and seamless failover for this type of architecture whether a few dozen compute nodes, or scaling to several hundred nodes.

22 22 Introducing the Veritas Storage Foundation Scalable File Server SFS key benefits and other applications

23 Chapter 2 Creating users based on roles This chapter includes the following topics: About user roles and privileges About the naming requirements for adding new users About using the SFS command-line interface Logging in to the SFS CLI About accessing the online man pages About creating Master, System Administrator, and Storage Administrator users About the support user Displaying the command history About user roles and privileges Your privileges within Storage Foundation Scalable File Server (SFS) are based on what user role (Master, System Administrator, or Storage Administrator) you have been assigned. The following table provides an overview of the user roles within SFS.

24 24 Creating users based on roles About the naming requirements for adding new users Table 2-1 User role Master System Administrator Storage Administrator User roles within SFS Description Masters are responsible for adding or deleting users, displaying users, and managing passwords. Only the Masters can add or delete other administrators. System Administrators are responsible for configuring and maintaining the file system, NFS sharing, networking, clustering, setting the current date/time, and creating reports. Storage Administrators are responsible for provisioning storage and exporting and reviewing reports. The Support account is reserved for Technical Support use only, and it cannot be created by administrators. See Using the support login on page 325. About the naming requirements for adding new users The following table provides the naming requirements for adding new SFS users. Table 2-2 Guideline Starts with Naming requirements for adding new users Description Letter or an underscore (_) Must begin with an alphabetic character and the rest of the string should be from the following POSIX portable character set: ([A-Za-z_][A-Za-z0-9_-.]*[A-Za-z0-9_-.$]). Length Case Can contain Valid syntax Can be up to 31 characters. If user names are greater than 31 characters, you will receive the error, "Invalid user name." Command names are case sensitive: username and USERNAME are the same. However, user-provided variables are case-sensitive. Hyphens (-) and underscores (_) are allowed. Valid user names include: Name: a.b a_b -

25 Creating users based on roles About using the SFS command-line interface 25 See Creating Master, System Administrator, and Storage Administrator users on page 33. About using the SFS command-line interface You can enter SFS commands on the system console or from any host that can access SFS through a session using Secure Socket Shell (SSH). SFS provides the following features to help you when you enter commands on the command line: Command-line help by typing a command and then a question mark (?) Command-line manual (man) pages by typing man and the name of the command you are trying to find Table 2-3 Symbol (pipe) [ ] (brackets) { } (braces) < > Conventions used in the SFS online command-line man pages Description Indicates you must choose one of elements on either side of the pipe. Indicates that the element inside the brackets is optional. Indicates that the element inside the braces is part of a group. Indicates a variable for which you need to supply a value. Variables are indicated in italics in the man pages. Logging in to the SFS CLI When you first log in to the SFS CLI, use the default username/password of master/master. After you have logged in successfully, change your password. See To change a user's password on page 34. By default, the initial password for any user is the same as the username. For example, if you logged in as user1, your default password would also be user1. To use any of the CLI commands, first log in by using the user role you have been assigned. Then enter the correct mode. These two steps must be performed before you can use any of the commands.

26 26 Creating users based on roles Logging in to the SFS CLI To log in to the SFS CLI 1 Log in to SFS using the appropriate user role, System Admin, Storage Admin, or Master. See Logging in to the SFS CLI on page Enter the name of the mode you want to enter. For example, to enter the admin mode, you would enter the following: admin You can tell you are in the admin mode because you will see the following: Admin> The following tables describe all the available modes, commands associated with that mode, and what roles to use depending on which operation you are performing. Table 2-4 Admin mode commands Admin mode commands System Admin Storage Admin Master passwd X X X show X X X supportuser X user X Table 2-5 Backup mode commands Backup mode commands System Admin Storage Admin Master ndmp X X netbackup X X show X X start X X status X X stop X X virtual-ip X X

27 Creating users based on roles Logging in to the SFS CLI 27 Table 2-5 Backup mode commands (continued) Backup mode commands System Admin Storage Admin Master virtual-name X X Table 2-6 CIFS mode commands CIFS mode commands System Admin Storage Admin Master homedir X X local X X server X X set X X share X X show X X split X X Table 2-7 Cluster mode commands Cluster mode commands System Admin Storage Admin Master add X X delete X X reboot X X show X X shutdown X X Table 2-8 FTP mode commands FTP mode commands System Admin Storage Admin Master logupload X X server X X session X X

28 28 Creating users based on roles Logging in to the SFS CLI Table 2-8 FTP mode commands (continued) FTP mode commands System Admin Storage Admin Master set X X show X X Table 2-9 History mode commands History mode commands System Admin Storage Admin Master history X X X Table 2-10 Network mode commands Network mode commands System Admin Storage Admin Master bond X X dns X X ip X X ldap X X nis X X nsswitch X X ping X X show X X vlan X X Table 2-11 NFS mode commands NFS mode commands System Admin Storage Admin Master server X X share X X show fs X X stat X X

29 Creating users based on roles Logging in to the SFS CLI 29 Table 2-12 Report mode commands Report mode commands System Admin Storage Admin Master X X event X X exportevents X X X showevents X X X snmp X X syslog X X Table 2-13 Storage mode commands Storage mode commands System Admin Storage Admin Master disk grow X X disk list X X X fencing X X fs X X hba X X pool X X scanbus X X snapshot X X tier X X Table 2-14 Support mode commands Support mode commands System Admin Storage Admin Master debuginfo X iostat X pciexclusion X

30 30 Creating users based on roles About accessing the online man pages Table 2-14 Support mode commands (continued) Support mode commands System Admin Storage Admin Master services X tethereal X top X traceroute X Table 2-15 System mode commands System mode commands System Admin Storage Admin Master clock X X config X X more X X ntp X X option X X stat X X swap X X Table 2-16 Upgrade mode commands Upgrade mode commands System Admin Storage Admin Master patch X X show X X About accessing the online man pages You access the online man pages by typing man name_of_command at the command line. The example shows the result of entering the Network> man ldap command.

31 Creating users based on roles About accessing the online man pages 31 Network> man ldap NAME ldap - configure LDAP client for authentication SYNOPSIS ldap enable ldap disable ldap show [users groups netgroups] ldap set {server port basedn binddn ssl rootbinddn users-basedn groups-basedn netgroups-basedn password-hash} value ldap get {server port basedn binddn ssl rootbinddn users-basedn groups-basedn netgroups-basedn password-hash} You can also type a question mark (?) at the prompt for a list of all the commands that are available for the command mode that you are in. For example, if you are within the admin mode, if you type a question mark (?), you will see a list of the available commands for the admin mode. sfs> admin? Entering admin mode... sfs.admin> exit logout man passwd show supportuser user --return to the previous menus --logout of the current CLI session --display on-line reference manuals --change the administrator password --show the administrator details --enable or disable the support user --add or delete an administrator To exit the command mode, enter the following: exit. sfs.admin> exit sfs> To exit the system console, enter the following: logout. sfs> logout

32 32 Creating users based on roles About creating Master, System Administrator, and Storage Administrator users About creating Master, System Administrator, and Storage Administrator users The admin> user commands add or delete a user, display user settings, and rename the password. Note: By default, the password of the new user is the same as the username. Table 2-17 Command user add Creating users Definition Creates the different levels of administrator. You must have master privilege. A user can be a Master user who has all the permissions, including add and deleting users. A Storage Administrator has access to only storage commands and is responsible for upgrading the cluster and applying the patches. A System Administrator is responsible for configuring the NFS server and exporting the file system, adding and deleting new nodes to the cluster, and configuring other network parameters such as DNS and NIS. See To create a Master user on page 33. passwd Creates a password. Passwords should be eight characters or less. If you enter a password that exceeds eight characters, the password is truncated, and you need to specify the truncated password when re-entering the password. For example, if you entered "elephants" as the password, the password is truncated to "elephant," and you will need to re-enter "elephant" instead of "elephants" for the system to accept your password. By default, the initial password for any user is the same as the username. For example, if you logged in as user1, your default password would also be user1. You will not be prompted to supply the old password. See To change a user's password on page 34. show Displays a list of current users, or you can specify a particular username and display both the username and its associated privilege. See To display a list of current users on page 34. user delete Deletes a user. See To delete a user from SFS on page 35.

33 Creating users based on roles About creating Master, System Administrator, and Storage Administrator users 33 Creating Master, System Administrator, and Storage Administrator users To create the different levels of administrator, you must have master privilege. To create a Master user To create a Master user, enter the following: Admin> user add username master Admin> user add master1 master Creating Master: master1 Success: User master1 created successfully To create a System Administrator user To create a System Administrator user, enter the following: Admin> user add username system-admin Admin> user add systemadmin1 system-admin Creating System Admin: systemadmin1 Success: User systemadmin1 created successfully To create a Storage Administrator user To create a Storage Administrator user, enter the following: Admin> user add username storage-admin Admin> user add storageadmin1 storage-admin Creating Storage Admin: storageadmin1 Success: User storageadmin1 created successfully

34 34 Creating users based on roles About creating Master, System Administrator, and Storage Administrator users To change a user's password 1 To change the password for the current user, enter the following command: Admin> passwd You will be prompted to enter the new password for the current user. 2 To change the password for a user other than the current user, enter the following command: Admin> passwd [username] You will be prompted to enter the new password for the user. To display a list of current users 1 To display the current user, enter the following: Admin> show [username] 2 To display a list of all the current users, enter the following: Admin> show Admin> show List of Users master user1 user2 To display the details of the administrator with the username master, enter the following: Admin> show master Username Privileges Admin> : master : Master

35 Creating users based on roles About the support user 35 To delete a user from SFS 1 If you want to display the list of all the current users prior to deleting a user, enter the following: Admin> show 2 To delete a user from SFS, enter the following: Admin> user delete username Admin> user delete user1 Deleting User: user1 Success: User user1 deleted successfully About the support user The supportuser commands are used to enable, disable, or view the status of the support user. Only an administrator logged in as master has the privilege to enable, disable, change the password, or check the status of the support user. You log into the system console and enter Admin> mode to access the commands. See About using the SFS command-line interface on page 25. for log in instructions. Table 2-18 Command supportuser enable Support user commands Definition Enables the support user for the tracing and debugging of any node. The enable command lets the support user login remotely. See To enable the support user account on page 36. supportuser password Changes the support user password. The password can be changed at any time. See To change the support user password on page 36. supportuser status Checks the status of the support user (whether it is enabled or disabled). Note: You must have master privilege to use this command. See To check the support user status on page 37.

36 36 Creating users based on roles About the support user Table 2-18 Command supportuser disable Support user commands (continued) Definition Disables the support user without permanently removing it from the system. By default, the support user is in disable mode when SFS is installed. See To disable the support user account on page 37. Configuring the support user account To enable the support user account If you want to enable the support user, enter the following: Admin> supportuser enable Admin> supportuser enable Enabling support user. support user enabled. Admin> To change the support user password If you want to change the support user password, enter the following: Admin> supportuser password Admin> supportuser password Changing password for support. New password: Re-enter new password: Password changed Admin>

37 Creating users based on roles Displaying the command history 37 To check the support user status If you want to check the status of the support user, enter the following: Admin> supportuser status Admin> supportuser status support user status : Enabled Admin> To disable the support user account If you want to disable the support user, enter the following: Admin> supportuser disable Admin> supportuser disable Disabling support user. support user disabled. Admin> Displaying the command history The history command displays the commands that you have executed. You can also view commands executed by another user. You must be logged in to the system to view the command history. For login instructions, go to About using the SFS command-line interface.

38 38 Creating users based on roles Displaying the command history To display command history To display the command history, enter the following: SFS> history [username] [number_of_lines] username number_of_lines Displays the command history for a particular user. Displays the number of lines of history you want to view. SFS> history master 7 Username : master Privileges : Master Time Status Message Command :09 Success NFS> server status (server status) :10 Success NFS> server start (server start ) :19 Success NFS> server stop (server stop ) :28 Success NFS> fs show (show fs ) :00 SUCCESS Disk list stats completed (disk list ) :31 Success Network shows success (show ) :49 Success Network shows success (show ) SFS> The information displayed from using the history command is: Time Status Message Command Displays the time stamp as MM-DD-YYYY HH:MM Displays the status of the command as Success, Error, or Warning. Displays the command description. Displays the actual commands that were executed by you or another user.

39 Chapter 3 Displaying and adding nodes to a cluster This chapter includes the following topics: About the cluster commands Displaying the nodes in the cluster About adding a new node to the cluster Installing the SFS software onto a new node Adding a node to the cluster Deleting a node from the cluster Shutting down the cluster nodes Rebooting the nodes in the cluster About the cluster commands This chapter discusses the SFS cluster commands. You use these commands to add or delete nodes to your cluster. The cluster commands are defined in Table 3-1. To access the commands, log into the administrative console (for master, system-admin, or storage-admin) and enter Cluster> mode. For login instructions, go to About using the SFS command-line interface.

40 40 Displaying and adding nodes to a cluster Displaying the nodes in the cluster Table 3-1 Commands cluster> show Cluster mode commands Definition Displays the nodes in the SFS cluster, their states, CPU load, and network load during the past 15 minutes. See Displaying the nodes in the cluster on page 40. network> ip addr add cluster> add Installs the SFS software onto the new node. See Installing the SFS software onto a new node on page 43. Adds a new node to the SFS cluster. See Adding a node to the cluster on page 44. cluster> delete Deletes a node from the SFS cluster. See Deleting a node from the cluster on page 45. cluster> shutdown Shuts down one or all of the nodes in the SFS cluster. See Shutting down the cluster nodes on page 47. cluster> reboot Reboots a single node or all of the nodes in the SFS cluster. Use the nodename(s) that is displayed in the show command. See Rebooting the nodes in the cluster on page 47. Displaying the nodes in the cluster You can display all the nodes in the cluster, their states, CPU load, and network load during the past 15 minutes. If you use the currentload option, you can display the CPU and network loads collected from now to the next five seconds.

41 Displaying and adding nodes to a cluster Displaying the nodes in the cluster 41 To display a list of nodes in the cluster 1 To display a list of nodes that are part of a cluster, and the systems that are available to add to the cluster, enter the following: Cluster> show For nodes already in the cluster, the following is displayed: Node State CPU(15 min) pubeth0(15 min) pubeth1(15 min) % rx(mb/s) tx(mb/s) rx(mb/s) tx(mb/s) sfs_1 RUNNING sfs_2 RUNNING For the nodes not yet added to the cluster, they are displayed with unique identifiers. Node dd5a565-de6c-4904-aa cf bafd13c1-536a-411a-b3ab-3e State INSTALLED 5.0SP2 ( ) INSTALLING-Stage-4-of-4

42 42 Displaying and adding nodes to a cluster Displaying the nodes in the cluster 2 To display the CPU and network loads collected from now to the next five seconds, enter the following: Cluster> show [currentload] Example output: Node State CPU(5 sec) pubeth0(5 sec) pubeth1(5 sec) % rx(mb/s) tx(mb/s) rx(mb/s) tx(mb/s) sfs_1 RUNNING sfs_2 RUNNING sfs_3 RUNNING Node Displays the node name if the node has already been added to the cluster. Displays the unique identifier for the node if it has not been added to the cluster. Example: node_1 or 35557d4c-6c a2224b State Displays the state of the node or the installation state of the system along with an IP address of the system if it is installed. Example: INSTALLED ( ) RUNNING FAULTED EXITED LEAVING UNKNOWN CPU pubeth0 pubeth1 Indicates the CPU load Indicates the network load for the Public Interface 0 Indicates the network load for the Public Interface 1 If a system is physically removed from the cluster, or if you power off the system, you will not see the unique identifier for the system, installation state, and IP address for the system when you issue the cluster> show