======================================================================== PC-NFS(r) - Support tools for Sun's PC-NFS networking software. ======================================================================== CONTENTS: This image contains the following files: pcnfsd - PC-NFS version 2 executable, for IRIX 5 pcnfsd.conf - Sample configuration file for pcnfsd inst.sh - Installation script addpcnfs.sh - Installation script CheckItOut - Script to test the PC-NFS services clnt.pcnfsd - Test program for pcnfsd clnt.pcnfsd.log - Test results for the above msgclnt - Messaging client to send messages msgserv - Messaging server to receive messages WhatVersion - Script to print current version (if installed) README - You are reading it now WHAT IS PCNFSD AND WHY DO I NEED IT: The PC-NFS product provides its basic file-sharing features without requiring specialized server-side software (aside from the optional NFS software) or management procedures. When PC-NFS software users need only generally accessible exported file systems and do not need networked printer services, the Irix administrative tasks can be limited to issuing network addresses and host names. User authentication services and shared network printing support require the addition of the PC-NFS Daemon on an Irix server. The PC-NFS daemon (pcnfsd) program is provided because the MS-DOS operating system (on the PC) does not offer the diversity of a multiuser Irix environment. While the PC-NFS product provides its essential functions without special arrangements on the NFS server side, pcnfsd is necessary to broaden the range of options available to MS-DOS users. Specifically, pcnfsd provides the following services: AUTHENTICATION This is a way for users to identify themselves to the Irix Operating System and to be granted appropriate privileges for file access and program execution on the network. ACCESS TO PRINTER SPOOLING SERVICES This enables PC users to print on printers attached to servers on the network (including printers driven by the Impressario software), and to monito and delete print jobs in network print queues. The pcnfsd version supplied on this CDROM is version 2. This is compatible with PC-NFS versions up to and including 5.x. This version provides expanded user authentication and enhanced printing services. While the enhanced services are of general use, the printing services have been tailored to be compatible with Microsoft(r) Windows(tm) 3.x. To find out if pcnfsd is already running and what version it is, use this command on your workstation: WhatVersion or this command on your PC: rpcinfo -u SERVER 150001 2 Where SERVER is replaced with the name of the machine suspected of running the pcnfsd. If pcnsfd is running you will get one of two messages in reply: PC-NFS is not running or version 1.0 is running. ------------------------------------------------ > rpcinfo -u IRIS 150001 2 rpcinfo: Program not registered program 150001 version 2 is not available PC-NFS is running and ready to go. ---------------------------------- > rpcinfo -u IRIS 150001 2 program 150001 version 2 ready and waiting INSTALLATION: If installed via 'inst' or 'swmgr', the following steps are carried out if you install the 'pcnfsd.sw.base' sub-system, otherwise, to install pcnfsd, execute as root: > su # ./addpcnfs.sh At this point in time pcnfsd will be installed, and the system will restart pcnfsd every time the system is rebooted. You will need to re-boot your machine to start the pcnfsd initially. You may then control pcnfsd via the IRIX chkconfig configuration tool as follows: > su # chkconfig pcnfsd [on/off] followed by a reboot. HOW TO SETUP THE PC: Once you have pcnfsd running on your workstation, you may enter the following command on the PC-NFS client PC: NET PCNFSD * NET LOGIN username * These commands may be added to your PC-NFS startup file, usually named: NETWORK.BAT FILE SHARING WITH PC-NFS: In order to share files, you need to have the (optional) NFS support package installed on your Iris workstation. To find out if you have it installed, enter the following command: > versions nfs I = Installed, R = Removed Name Date Description I nfs 03/03/94 Network File System, 5.2 I nfs.books 03/03/94 IRIS InSight Books, Release 2.2 I nfs.books.NFS_AG 03/03/94 NFS Administration Guide I nfs.books.NIS_AG 03/03/94 NIS Administration Guide I nfs.man 03/03/94 NFS Documentation I nfs.man.nfs 03/03/94 NFS Support Manual Pages I nfs.man.relnotes 03/03/94 NFS Release Notes I nfs.sw 03/03/94 NFS Software I nfs.sw.nfs 03/03/94 NFS Support I nfs.sw.nis 03/03/94 NIS (formerly Yellow Pages) Support Then, you need to make sure NFS support is turned on. Check this with the following command: > chkconfig Flag State ==== ===== nfs on <= Indicates NFS is enabled. Then you need to export directories for PC-NFS to mount. You can do this as follows: > su # cd /etc # jot exports (Now add a line to this file like:) /usr/tmp -rw (Save the file and exit jot) # exportfs -a # exit In this example, the /usr/tmp directory is exported to everybody with full read/write privileges. Now, on the PC, add a line to your DRIVES.BAT file like this: NET USE T: IRIS:/usr/tmp where "IRIS" is replaced by the name of the machine who's directory you wish to mount. PRINT REDIRECTION WITH PC-NFS: One of PC-NFS's major features is to allow PC's access to the print spooling services available on your workstation. This feature is referred to as "print redirection". Several additional steps need to be done in order to support print redirection with PC-NFS. First, you need to create a print spooling directory for PC-NFS. Do that as follows: > su # umask 0 # cd /var/spool # mkdir pcnfs # exit NOTE: This directory is automatically created for you when you install the PC-NFS daemon. Then, you need to export this directory with *no* access restrictions so that PC-NFS may access the directory for print spooling. Do so as follows: > su # cd /etc # jot exports (Now add a line to this file like:) /var/spool/pcnfs (Save the file and exit jot) # exportfs -a # exit NOTE: When you export the /var/spool/pcnfs directory, be *sure* there are absolutely *no* restrictions, including, for example, '-rw' or print spooling will not work. Then, in the System Manager, open the Printers tool, add a printer definition if one does not exist yet, either local or remote, and then select one or more printers (by name) to use for PC-NFS printing, for example, assume you have a printer named "printer". Now, on the PC, add a line to your DRIVES.BAT file like this: NET USE LPT1: IRIS:printer After running the DRIVES.BAT file, you will be able to use the network printer for output from your PC-NFS system. PC-NFS DAEMON FEATURES: The following features have been enabled in this version of pcnfsd: Option Purpose --------------------- ---------------------------------- - SVR4 Build for SVR4-style system - SVR4_STYLE_PRINT Use: /usr/bin/lp -c -d%s %s - SVR4_STYLE_PR_LIST Use: /usr/bin/lpstat -v - SVR4_STYLE_QUEUE Use: /usr/bin/lpstat -p lp - SVR4_STYLE_CANCEL Cancel with: /usr/bin/lp-xx - SVR4_STYLE_STATUS Use: /usr/bin/lpstat -a lp -p lp - SVR4_STYLE_MONITOR Use: /etc/printcap - SHADOW_SUPPORT Enable use of shadow password file - USER_CACHE Cache recent (last 16) user names - WTMP Update /var/adm/wtmp database - USE_YP Consult the NIS "auto.home" map PLEASE NOTE: The executables in this directory are a gift to you from SGI. While we welcome your feedback/ideas/requests for additions/changes (and even bug-fixes), IT IS ESSENTIAL TO UNDERSTAND THAT THIS SOFTWARE IS UNSUPPORTED BY SILICON GRAPHICS CUSTOMER SUPPORT CENTER STAFF. CONTACTING SUN-SELECT: The portion of PC-NFS that resides and runs on the PC is a product of SunSelect. You should contact SunSelect for more information concerning PC-NFS. You can reach SunSelect at: Worldwide Headquarters: SunSelect Two Elizabeth Drive Chelmsford, MA. (USA) 01824 Phone: +1(508)442-2300 FAX: +1(508)250-2300 US: +1(800)24-SELECT Europe: SunSelect Bagshot Manor Green Lane, Bagshot Surrey GU19 5NL ENGLAND Phone: +44-(0)-276-451440 FAX: +44-(0)-276-453803 Japan: SunSelect Sanbancho KS Building 2-banchi Sanbancho, Chiyoda-ku Tokyo, 102 JAPAN Phone: +81-03-3221-1436 FAX: +81-03-3221-2519 TRADEMARKS: PC-NFS is a registered trademark of Sun Microsystems, Inc. Microsoft is a registered trademark of Microsoft, Inc. Windows is a trademark of Microsoft, Inc.