NFS Gateway for Netware 6 Administration Guide October 22, 2003
Total Page:16
File Type:pdf, Size:1020Kb
Novell Confidential Manual (99a) 11 September 2003 Novell * NFS Gateway for NetWare® 6 www.novell.com ADMINISTRATION GUIDE October 22, 2003 Novell Confidential Manual (99a) 11 September 2003 Legal Notices Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes. You may not export or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside. Copyright © 2003 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher. U.S. Patent No. 5,157,663; 5,349,642; 5,455,932; 5,553,139; 5,553,143; 5,572,528; 5,594,863; 5,608,903;5,633,931; 5,652,859; 5,671,414; 5,677,851; 5,692,129; 5,701,459; 5,717,912; 5,758,069; 5,758,344; 5,781,724; 5,781,724; 5,781,733; 5,784,560; 5,787,439; 5,818,936; 5,828,882; 5,832,274; 5,832,275; 5,832,483; 5,832,487; 5,850,565; 5,859,978; 5,870,561; 5,870,739; 5,873,079; 5,878,415; 5,878,434; 5,884,304; 5,893,116; 5,893,118; 5,903,650; 5,903,720; 5,905,860; 5,910,803; 5,913,025; 5,913,209; 5,915,253; 5,925,108; 5,933,503; 5,933,826; 5,946,002; 5,946,467; 5,950,198; 5,956,718; 5,956,745; 5,964,872; 5,974,474; 5,983,223; 5,983,234; 5,987,471; 5,991,771; 5,991,810; 6,002,398; 6,014,667; 6,015,132; 6,016,499; 6,029,247; 6,047,289; 6,052,724; 6,061,743; 6,065,017; 6,094,672; 6,098,090; 6,105,062; 6,105,132; 6,115,039; 6,119,122; 6,144,959; 6,151,688; 6,157,925; 6,167,393; 6,173,289; 6,192,365; 6,216,123; 6,219,652; 6,229,809. Patents Pending. Novell, Inc. 1800 South Novell Place Provo, UT 84606 U.S.A. www.novell.com NFS Gateway for NetWare 6 Administration Guide October 22, 2003 Online Documentation: To access the online documentation for this and other Novell products, and to get updates, see www.novell.com/documentation. Novell Confidential Manual (99a) 11 September 2003 Novell Trademarks ConsoleOne is a registered trademark of Novell, Inc in the United States and other countries. eDirectory is a trademark of Novell, Inc. NetWare is a registered trademark of Novell, Inc., in the United States and other countries. Novell Cluster Services is a trademark of Novell, Inc. NetWare Core Protocol and NCP are trademarks of Novell, Inc. NetWare Loadable Module and NLM are trademarks of Novell, Inc. Novell is a registered trademark of Novell, Inc., in the United States and other countries. Novell Client is a trademark of Novell, Inc. Novell Directory Services and NDS are registered trademarks of Novell, Inc., in the United States and other countries. Novell Storage Services is a trademark of Novell, Inc. Third-Party Trademarks All third-party trademarks are the property of their respective owners. Novell Confidential Manual (99a) 11 September 2003 Novell Confidential Manual (99a) 11 September 2003 Contents About This Guide 7 1 Overview 9 What’s New . 9 What’s Not Supported . 10 2 Setting Up the NFS Gateway 13 Meeting System Requirements . 13 Installing the NFS Gateway. 13 Uninstalling the NFS Gateway . 14 Configuring NFS Gateway for the First Time . 14 Loading the NFS Gateway . 16 Setting NFS Gateway Parameters . 16 Unloading the NFS Gateway . 18 3 Managing NFS Gateway Volumes 19 Setting Volume-Specific Parameters . 19 Mounting Parameters . 19 Dismounting a Gateway Volume . 23 Trustee Settings. 24 Mounting a Gateway Volume . 24 Mounting Volumes for the First Time . 24 Mounting Volumes for Subsequent Times When the Nfsgy.nlm Is Still Loaded . 27 Viewing NFS Gateway Volume Parameters . 27 4 User Settings 29 Migration Utility . 29 Migration Using Makenis at the System Console . 30 Migration Using Makenis through ConsoleOne . 31 Managing Migration Utility Log Files . 32 Setting a UNIX Profile Using ConsoleOne . 33 Adding a New User or Group . 33 Modifying User Information . 33 Modifying Group Information . 34 Accessing NFS Gateway Volumes as CIFS Users . 35 5 Cluster-Enabling the NFS Gateway for NetWare 6 37 Prerequisites . 37 Active/Passive Mode . 37 Configuring in Active/Passive Mode . 37 Active/Active Mode . 38 Configuring in Active/Active Cluster Mode . 38 6 Performance Tuning 41 Tuning for NFS Version 2. 41 Mount Parameters Combinations. 41 Contents 5 Novell Confidential Manual (99a) 11 September 2003 Read/Write Operations . 44 NFS Gateway Usage . 44 Modifying NSS Settings . 44 Enhancing Directory Operations and File Read/Write Performance . 45 7 Interoperability and Performance Data 47 Interoperability . 47 Performance Data . 48 8 Troubleshooting 49 Troubleshooting the NFS Gateway for NetWare 6 . 49 9 NFS Gateway for NetWare 6 FAQs 53 Installing / Uninstalling the NFS Gateway . 53 Loading / Unloading the NFS Gateway . 54 General Issues . 55 Importing and Mounting a Volume. 55 UNIX Profile, Permissions, and Root Access Issues . 56 File Read/Write Issues . 57 Time Stamp and File Content Synchronization Issues . 59 Performance and Scalability Issues . 59 10 Error Messages 61 NFS Gateway Error Messages . 61 6 NFS Gateway for NetWare 6 Administration Guide Novell Confidential Manual (99a) 11 September 2003 About This Guide This guide describes how to install and use the NFS* Gateway on NetWare® 6. The guide is intended for both users and network administrators and is divided into the following sections: Chapter 1, “Overview,” on page 9. Chapter 2, “Setting Up the NFS Gateway,” on page 13. Chapter 3, “Managing NFS Gateway Volumes,” on page 19. Chapter 4, “User Settings,” on page 29. Chapter 5, “Cluster-Enabling the NFS Gateway for NetWare 6,” on page 37. Chapter 6, “Performance Tuning,” on page 41 Chapter 7, “Interoperability and Performance Data,” on page 47 Chapter 8, “Troubleshooting,” on page 49 Chapter 9, “NFS Gateway for NetWare 6 FAQs,” on page 53. Chapter 10, “Error Messages,” on page 61. Documentation Conventions In this documentation, a greater-than symbol (>) is used to separate actions within a step and items within a cross-reference path. A trademark symbol (®, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party trademark. When a single pathname can be written with a backslash for some platforms or a forward slash for other platforms, the pathname is presented with a backslash. Users of platforms that require a forward slash, such as UNIX*, should use forward slashes as required by your software. User Comments We want to hear your comments and suggestions about this manual and the other documentation included with NFS Gateway on NetWare 6. To contact us, send e-mail to [email protected]. About This Guide 7 Novell Confidential Manual (99a) 11 September 2003 8 NFS Gateway for NetWare 6 Administration Guide Novell Confidential Manual (99a) 11 September 2003 1 Overview The NFS Gateway enables NetWare® servers to mount NFS file systems as virtual NetWare Novell Storage ServicesTM (NSS) volumes. Using the NFS Gateway, NetWare clients can transparently access files and directories on any NFS server system on the network. The NFS Gateway is a Loadable Storage Services (LSS) module for NSS 3.0 file systems on NetWare 6. The NFS Gateway mounts a shared UNIX directory as an NSS volume for NetWare users. The NFS Gateway for NetWare 6 has been redesigned to take advantage of the file system interface provided by NSS. This file system interface is crucial to the functioning of the NFS Gateway. The following figure illustrates the NFS Gateway functionality: Figure 1 NFS Gateway File Sharing Process The communication between NFS Gateway and UNIX machines is over the NFS protocol. Both NFS version 2 and NFS version 3 are supported over UDP. What’s New The NFS Gateway for NetWare 6 has been completely redesigned for better performance and reliability. For details of performance and performance tuning, see Chapter 7, “Interoperability and Performance Data,” on page 47 and Chapter 6, “Performance Tuning,” on page 41. For this release, the default values are tuned for NFS version 3 performance. However, if you use NFS version 2, then you must tune gymount parameters to avoid delays and timeout failures. For more details, see “Tuning for NFS Version 2” on page 41. Overview 9 Novell Confidential Manual (99a) 11 September 2003 It has better scalability when compared to the existing NFS Gateway on NetWare 5.1. It has a new install. The install provides: A prompt to accept the product license. File backup. Novell® eDirectoryTM schema extension. The uninstall provides for file restore. For details, see “Installing the NFS Gateway” on page 13. It incorporates the changes in the LSS interface for NSS 3.0.