Novell CLIENT FOR LINUX 1.1 Instruction Manual

Novell
www.novell.com
novdocx (ENU) 9 December 2005
Novell Client 1.1 for Linux Installation and Administration Guide
ClientTM for Linux
1.1
December 23, 2005
INSTALLATION AND
ADMINISTRATION GUIDE

novdocx (ENU) 9 December 2005
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.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the
trade laws of other countries. You agree to comply with all export control regulations and to obtain any required
licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities
on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export
laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses.
Please refer to www.novell.com/info/exports/ for more information on exporting Novell software. Novell assumes no
responsibility for your failure to obtain any necessary export approvals.
Copyright © 2005 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.
Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this
document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S.
patents listed at http://www.novell.com/company/legal/patents/ and one or more additional patents or pending patent
applications in the U.S. and in other countries.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the online documentation for this and other Novell products, and to get
updates, see www.novell.com/documentation.

novdocx (ENU) 9 December 2005
Novell Trademarks
eDirectory is a trademark of Novell, Inc.
NetWare is a registered trademark of Novell, Inc., in the United States and other countries.
NetWare Core Protocol and NCP are trademarks of Novell, Inc.
NMAS is a trademark 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.
Red Carpet is a registered trademark of Novell, Inc., in the United States and other countries.
SUSE is a registered trademark of Novell, Inc., in the United States and other countries.
Third-Party Materials
All third-party trademarks are the property of their respective owners.

novdocx (ENU) 9 December 2005

novdocx (ENU) 9 December 2005
5
Contents
About This Guide 7
1 Understanding the Novell Client for Linux 9
1.1 Understanding How the Novell Client for Linux Differs from Novell Client for Windows 2000/XP
9
1.2 Understanding the Novell Client for Linux Virtual File System. . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.1 Understanding When the Virtual File System Kernel Module Needs to Be Compiled 10
2 Installing the Novell Client For Linux 13
2.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.2 Installing the Novell Client Using the Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.3 Installing the Novell Client Using YaST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3.1 Installing the Novell Client Using XWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3.2 Installing the Novell Client from the Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.4 Starting or Restarting the Novell Client for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.5 Uninstalling the Novell Client for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.5.1 Uninstalling Using the YaST Control Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.5.2 Uninstalling Using the Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3 Configuring the Novell Client for Linux 19
3.1 Using the Novell Client Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.1.1 Configuring Login Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3.1.2 Configuring Protocol Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.1.3 Configuring Tray Application Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.1.4 Configuring File Browser Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3.1.5 Configuring OpenSLP Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.2 Using Configuration Files to Preconfigure the Novell Client . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4 Managing Login 27
4.1 Setting Up Login Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.2 Setting Up Login Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.3 Using OpenSLP to Simplify Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.3.1 Setting Up SLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.3.2 Troubleshooting SLP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
5 Managing File Security 31
5.1 Checking File or Folder Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
5.2 Changing Trustee Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
5.3 Adding a Trustee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5.4 Removing a Trustee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
5.5 Combining Multiple Trustees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

6Novell Client 1.1 for Linux Installation and Administration Guide
novdocx (ENU) 9 December 2005
A Compiling the Novell Client Virtual File System Kernel Module 37
A.1 Installing the Required Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
A.1.1 Installing the Required Packages from XWindows . . . . . . . . . . . . . . . . . . . . . . . . . . 37
A.1.2 Installing the Required Packages from the Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
A.2 Compiling the Novell Client Virtual File System Kernel Module . . . . . . . . . . . . . . . . . . . . . . . . 39
A.2.1 Compiling the Novell Client Virtual File System Kernel Module After a Kernel Update .
39
A.2.2 Compiling the Novell Client Virtual File System Kernel Module on Workstations Running
a Custom Kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
B The Novell Client for Linux Commands 41
B.1 Shell Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
B.2 GUI Utilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
B.3 Using the Novell Client for Linux Man Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
C Documentation Updates 45
C.1 December 23, 2005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

novdocx (ENU) 9 December 2005
7
About This Guide
This guide describes how to install and configure the Novell®ClientTM for Linux software.
•Chapter 1, “Understanding the Novell Client for Linux,” on page 9
•Chapter 2, “Installing the Novell Client For Linux,” on page 13
•Chapter 3, “Configuring the Novell Client for Linux,” on page 19
•Chapter 4, “Managing Login,” on page 27
•Chapter 5, “Managing File Security,” on page 31
•Appendix A, “Compiling the Novell Client Virtual File System Kernel Module,” on page 37
•Appendix B, “The Novell Client for Linux Commands,” on page 41
•Appendix C, “Documentation Updates,” on page 45
Audience
This guide is intended for network administrators.
Feedback
We want to hear your comments and suggestions about this manual and the other documentation
included with this product. Please use the User Comments feature at the bottom of each page of the
online documentation, or go to www.novell.com/documentation/feedback.html and enter your
comments there.
Documentation Updates
For the latest version of this documentation, see the Novell Client online documentation (http://
www.novell.com/documentation/linux_client/index.html) Web site.
Additional Documentation
For documentation on known issues, see the Novell Client for Linux Readme
For documentation on login scripts, see the Novell Login Scripts Guide.
For documentation on the Novell Client tray application, see the Novell Client 1.1 for Linux User
Guide.
For documentation on the command terminal utilities, see the man pages associated with these
utilities.
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.

8Novell Client 1.1 for Linux Installation and Administration Guide
novdocx (ENU) 9 December 2005

Understanding the Novell Client for Linux
1
novdocx (ENU) 9 December 2005
9
1
Understanding the Novell Client
for Linux
The Novell®ClientTM for Linux software allows users of Linux workstations to access and use all of
the services available on servers running Novell eDirectoryTM. The Novell Client brings the full
power, ease of use, manageability, and security of eDirectory to Linux workstations. The Novell
Client for Linux fully supports NetWare®, OES, and eDirectory services and utilities on a Linux
workstation, including security, file, and print services through Novell iPrint.
This section contains the following information:
•Section 1.1, “Understanding How the Novell Client for Linux Differs from Novell Client for
Windows 2000/XP,” on page 9
•Section 1.2, “Understanding the Novell Client for Linux Virtual File System,” on page 10
1.1 Understanding How the Novell Client for
Linux Differs from Novell Client for Windows
2000/XP
Using the Novell Client for Linux differs in a few ways from using the Novell Client for Windows*.
For users and network administrators who are familiar with the Novell Client for Windows,
knowing these differences can help the transition to Linux run more smoothly.
Installation and Upgrades
• The Novell Client for Linux can be installed and upgraded using either YaST or an installation
script. For more information, see Chapter 2, “Installing the Novell Client For Linux,” on
page 13.
• There is no Automatic Client Upgrade available on Linux.
• The Client Configuration Wizard lets you set up a configuration file that can be used to
preconfigure workstations during installation. For more information, see Section 3.2, “Using
Configuration Files to Preconfigure the Novell Client,” on page 25.
Logging In
• The Novell Client Login is not integrated into the initial workstation login. After you log in to
the workstation, you must also log in from the Novell tray application. This means that there is
no Novell username or password synchronization with the workstation username and
password.
• When a user logs in to a local workstation and then opens a remote SSH session and logs in as
the same user, the network resources that user has rights to are available to the user.
• The Novell Client for Linux can use the NMASTM login method to authenticate. However, the
NMAS login is not integrated in to the Novell Client for Linux login screen, so the default
login sequence cannot be set in the Novell Client Login screen.

10 Novell Client 1.1 for Linux Installation and Administration Guide
novdocx (ENU) 9 December 2005
• The Novell Client for Linux uses OpenSLP, whereas the Novell Client for Windows uses
Novell's implementation of SLP. The network administrator must set up OpenSLP before users
can look up trees, contexts, and servers using the Browse buttons in the Novell Client Login
window. If OpenSLP is not set up, the user must enter a username, tree, and context to connect
to the network. See Chapter 4, “Managing Login,” on page 27 for more information.
Because Linux uses OpenSLP, the implementation is different and the user's experience is
different. For more information, see Section 4.3, “Using OpenSLP to Simplify Login,” on
page 28.
• The Novell Client for Linux does not use the Dynamic Local User or Location Profiles that are
available in Windows.
User Interface
Both a graphical user interface and command line utilities are available to complete client actions
such as mapping drives, setting trustee rights, and copying files.
Login Scripts
Novell has been able to port the vast majority of login script functionality to the Linux platform.
This means that the login scripts you create in your network work for both Windows users and
Linux users with very little difference in functionality.
Some difference do exist, however. For example, mapped drives are implemented by creating
symbolic links and search drives are not available on Linux. Other small differences are created by
the inherent difference between Windows and Linux. All the differences and issues are listed in the
Novell Login Scripts Guide.
1.2 Understanding the Novell Client for Linux
Virtual File System
The Novell Client for Linux differs from previous Novell Clients to enable it to work on the Linux
platform. In Windows, the Novell Client loads a single binary that works on multiple operating
system platforms without modifications. The Novell Client for Linux has a Virtual File System that
consists of a kernel module (novfs.ko) that runs as part of the Linux kernel and a daemon
(novfsd) that runs in the user space. Both components must be running on the workstation for the
client to connect to the network.
The daemon can run on any of the supported Linux platforms without modification. The kernel
module, however, is dependent on the kernel version and must be compiled to match the kernel on
the workstation. When the Novell Client is installed, it compiles the kernel module during the
installation process. If this process fails, the kernel module cannot load. It attempts to recompile
when the workstation is restarted.
1.2.1 Understanding When the Virtual File System Kernel
Module Needs to Be Compiled
The following is a list of the instances when you must compile the Novell Client Virtual File System
Kernel Module (novfs.ko):
• You installed the Novell Client and received an error message. This generally occurs because
all the required packages are not installed on a workstation. You must install these packages,