Novell CLIENT FOR LINUX 1.0 INSTALLATION AND ADMINISTRATION GUIDE
Novell
ClientTM for Linux
1.0
October 12, 2005
www.novell.com
INSTALLATION AND ADMINISTRATION
GUIDE
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
Novell Client 1.0 for Linux Installation and Administration Guide
October 12, 2005
Online Documentation: To access the online documentation for this and other Novell products, and to get updates, see
www.novell.com/documentation.
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.
Contents
Contents 5
About This Guide 7
1 Understanding the Novell Client for Linux 9
Understanding How the Novell Client for Linux Differs from Novell Client for Windows 2000/XP . . . . . . . . . . . . . 9
Understanding the Novell Client for Linux Virtual File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Understanding When the Virtual File System Kernel Module Needs to Be Compiled . . . . . . . . . . . . . . . . 10
2 Installing the Novell Client For Linux 13
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Package Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installing the Novell Client Using the Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installing the Novell Client Using YaST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installing the Novell Client Using XWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installing the Novell Client from the Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Starting or Restarting the Novell Client for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Uninstalling the Novell Client for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Uninstalling Using the YaST Control Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Uninstalling Using the Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3 Configuring the Novell Client for Linux 19
Using the Novell Client Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Configuring Login Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Configuring Protocol Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Configuring Tray Application Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Configuring File Browser Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Configuring OpenSLP Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Using Configuration Files to Preconfigure the Novell Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4 Managing Login 27
Setting Up Login Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Setting Up Login Restrictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Using OpenSLP to Simplify Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Setting Up SLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Troubleshooting SLP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
5 Managing File Security 31
Checking File or Folder Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Changing Trustee Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Adding a Trustee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Removing a Trustee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Combining Multiple Trustees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
A Compiling the Novell Client Virtual File System Kernel Module 37
Installing the Required Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Installing the Required Packages from XWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Contents 5
Installing the Required Packages from the Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Compiling the Novell Client Virtual File System Kernel Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Compiling the Novell Client Virtual File System Kernel Module After a Kernel Update . . . . . . . . . . . . . . . . 39
Compiling the Novell Client Virtual File System Kernel Module on Workstations Running a Custom Kernel . . . . . 39
B The Novell Client for Linux Commands 41
Shell Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
GUI Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Using the Novell Client for Linux Man Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6 Novell Client for Linux Installation and Administration Guide
About This Guide
This guide describes how to install and configure the Novell® ClientTM for Linux software.
This guide is intended for network administrators and is divided into the following sections:
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
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.0 for Linux User
Guide.
For documentation on the command terminal utilities, see the man pages associated with these
utilities.
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.
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 Linux* or UNIX*, should use forward slashes as required by your software.
About This Guide 7
User Comments
We want to hear your comments and suggestions about this manual and the other documentation
included with this product. Please use the User Comment feature at the bottom of each page of the
online documentation, or go to
www.novell.com/documentation/feedback (http://
www.novell.com/documentation/feedback) and enter your comments there.
8 Novell Client 1.0 for Linux Installation and Administration Guide
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 eDirectory
power, ease of use, manageability, and security of eDirectory to Linux workstations. The Novell
Client for Linux fully supports NetWare
workstation, including security, file, and print services through Novell iPrint.
This section contains the following information:
“Understanding How the Novell Client for Linux Differs from Novell Client for Windows
2000/XP” on page 9
“Understanding the Novell Client for Linux Virtual File System” on page 10
®
, OES, and eDirectory services and utilities on a Linux
TM
. The Novell Client brings the full
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
page 13.
Chapter 2, “Installing the Novell Client For Linux,” on
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
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.
Understanding the Novell Client for Linux 9
“Using
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
Because Linux uses OpenSLP, the implementation is different and the user’s experience is
different. For more information, see
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
Novell Login Scripts Guide.
in the
Chapter 4, “Managing Login,” on page 27 for more information.
“Using OpenSLP to Simplify Login” on page 28.
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.
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,
compile the Novell Client Virtual File System Kernel Module (novfs.ko), and restart the
workstation. See
“Package Requirements” on page 13 for more information.
You have previously compiled the Novell Client Virtual File System Kernel Module
(novfs.ko) and then made changes to the kernel.
10 Novell Client 1.0 for Linux Installation and Administration Guide
You have a custom kernel of any of the supported versions.
Kernel updates are automatically pushed to the workstation via Red Carpet®.
In all of these instances, you must recompile the Novell Client Virtual File System Kernel Module
(novfs.ko) to ensure that it is compatible with the Linux kernel version on your workstation.
However, when later shipping versions of NLD are provided by Novell, the Novell Client Virtual
File System Kernel Module (novfs.ko) is installed and you do not need to recompile it because the
module is included in the kernel.
For more information, see Appendix A, “Compiling the Novell Client Virtual File System Kernel
Module,” on page 37.
NOTE: If you patch the kernel for any reason, you must make sure that you have the required packages that
correspond to the kernel patch. For a list of the required packages, see
The Novell Client for Linux then recompiles when the workstation is restarted. Without the corresponding
packages, the recompile fails.
“Package Requirements” on page 13.
Under certain conditions, your version of novfs.ko could be rolled back when you install a new
kernel module. For example, if you download and install a patched version of novfs.ko, and then
later install an NLD 9 SP2 update to your kernel, the Novell Client Virtual File System Kernel
Module patch might be overwritten. You should then reinstall the novfs.ko patch and recompile
the kernel in order to ensure that the kernel module and the kernel are compiled.
Understanding the Novell Client for Linux 11
12 Novell Client 1.0 for Linux Installation and Administration Guide
2 Installing the Novell Client For Linux
This section explains how to install the Novell® ClientTM for Linux software on a workstation and
includes the following information:
System Requirements (page 13)
Installing the Novell Client Using the Installation Script (page 13)
Installing the Novell Client Using YaST (page 14)
Starting or Restarting the Novell Client for Linux (page 16)
Uninstalling the Novell Client for Linux (page 16)
For information on installing a preconfigured version of the Novell Client, see “Using
Configuration Files to Preconfigure the Novell Client” on page 25.
System Requirements
The Novell Client for Linux requires that the workstation be running one of the following:
(Preferred) Novell Linux Desktop (NLD) 9 SP2 or later
IMPORTANT: Other versions of NLD might have problems because of missing packages.
SUSE® Linux Professional 9.3
If workstations are not running NLD 9 SP2 or later, additional required packages must be installed.
For more information, see
“Package Requirements” on page 13.
Package Requirements
The following packages must be installed on the workstation before you install the Novell Client
for Linux:
gcc
kernel-source
make
For information on using YaST to install these packages, see “Installing the Required Packages”
on page 37.
Installing the Novell Client Using the Installation Script
An installation script called ncl_install is provided in the Novell Client for Linux .tar.gz file
(novell-client-1.0-linux-nld9.tar.gz or novell-client-1.0-linux-suse9.3.tar.gz) you download from
Novell Downloads (http://download.novell.com). This script can be used to install, verify
Installing the Novell Client For Linux 13