NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: GWY195.EXE; NFS Gateway 1.2 Update for NW 3.x DOCUMENT ID: TID201003 DOCUMENT REVISION: B DATE: 09MAR95 ALERT STATUS: Yellow INFORMATION TYPE: Symptom Solution README FOR: GWY195.EXE NOVELL PRODUCT and VERSION: NetWare NFS Gateway 1.2 ABSTRACT: Accumulated bug fixes for NetWare NFS Gateway. Read the installation instructions INSTALL.TXT when installing. Read the supplement FEATURES.TXT to understand new features and parameters. ----------------------------------------------------------------- DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. ----------------------------------------------------------------- SYMPTOM 1) Server ABEND with GPPE when using WordPerfect 5.1 for Windows 3.11. The user has a directory which resides on a NFS Gateway volume where WordPerfect files are kept. Steps to reproduce: 1. Start WordPerfect. 2. Open a file which resides on a gateway volume. 3. Click on Open again to open two submenus. 5. From one of the submenus double click on ".." to go up one directory. 6. The server abends with a GPPE. Also, the GPPE can occur simply by using the DOS command "cd ..". 2) Documentum, or other applications which create files on the NFS server through some other means than the Gateway, may be intermittently unable to access newly created files. User gets "file not found". In the case of Documentum, the workstation sends TCP messages directly to an AIX box running Oracle. Oracle and UNIX function calls (fcreate, fopen, fread, fwrite) create a temporary directory called DATA/COMMON which lasts for duration of Documentum session. The NFS Gateway may not always see these files quickly enough, even if /ETC/NWPARAMS contains DIR_COMP_TIME = 0. Steps to reproduce without Documentum: 1. UNIX: mkdir tst/d1 2. UNIX: cp /etc/hosts tst/d1/f1 3. DOS: DIR TST/D1 /S 4. DOS: TYPE TST/D1/F1 5. UNIX: rm -rf tst/d1 6. UNIX: mkdir tst/e1 ( e1 should have the same i-node as d1 ) 7. UNIX: cp /etc/hosts tst/e1/f1 ( f1 should have the same i-node as previous f1 ) 8. DOS: TYPE TST/E1/F1 ====> THIS SHOULD FAIL 9. UNIX: rm-rf tst/e1 10.UNIX: mkdir tst/g1 (g1 should have the same i-node as d1 and e1 ) 11.DOS: CD G1 ====> THIS SHOULD FAIL 3) Cannot mount NFS server running on OS/2 because UNICON prevents user from typing "\". Changed to allow "\" character. It is no longer necessary to manually edit the SYS:ETC/NWPARAMS file. 4) NFS Gateway changes the number of allowed NCP connections as seen by SYSCON or other applications such as ARCSERV. 5) ABEND: nfsgw (gwch read_data_ release func-release(). Intermittent, occurs when gateway is under load greater than 40 workstations. There was small window of time for error in the synchronization of a write and read request, after a lock request. 7) Workstation connection can become hung. Hung connection cannot be removed by MONITOR.NLM. Fixed for known circumstances. 8) ABEND: DeleteFromHash was called with directory entry number. 9) Need tunable parameter to allow multiple ways to determine directory cache synchronization. See BACKGROUND_SYNC in FEATURES.TXT. 10) Can't read/copy files from SJF-NFSGW to local drives even though files have read/write permissions. 11) Certain applications including CC:Mail, MS Excel, and MS Access applications cannot read files on SYS: volume. They appear to be locked. If and only if NFSGW is loaded, CC:MAIL programs (such as ADMIN.EXE) get message "Cannot Unlock Database File." 12) After heavy use of the GW, some files in a directory are marked as hidden even if they do not start with a '.' Steps To reproduce: 1. UNIX: touch .xyz 2. DOS: NDIR ^XYZ 3. UNIX: mv .xyz abc 4. DOS: NDIR ABC 5. note that ABC it is marked as hidden. 13) Windows File Manager cannot copy a sub-directory from local disk to a drive which is mapped to Gateway volume using drag and drop in File Manager, error is cannot create file/directory. Steps to reproduce: From DOS: 1. touch xyz 2. flag xyz ro 3. flag xyz ro 4. del xyz Then immediately from File Manager: 5. Drag c:\dos directory to drive which is mapped to GW volume. This should give an error. NOTE: While the above test is going on, the GW should not be used by anyone else. 14) Cannot access a remote directory if it was created with the same inode as a directory deleted from unix. 15) Filename is changed on gateway volume, where NFS server is OS/2. Correct name is restored when volume is re-mounted. NFSGW is attempting to avoid a duplicate name collision when this is not necessary. If correct filename is contains non-numeric characters, the character "0" is appended to filename. If all numeric characters, the number is incremented by one. Problem occurs because some OS/2 systems support only upper case, at least as seen through the NFS daemon of OS/2. If NFS Gateway user creates file "STUB" the Gateway will create the file "stub" on the NFS server (assuming that most users will be UNIX users). OS/2 saves the file as upper case "STUB". Now when the Gateway user does a DIR, the Gateway detects that it already has "STUB" in its cache or shadow file, so to avoid duplicates it displays "STUB0" With this fix, when the volume is first mounted it will attempt to create a lower case scratch file, then read it back to test whether the file has been on upper or lower case on the NFS server. If upper, then the NFS server only supports upper case filenames. NOTE: The exported directory of the remote NFS volume must be writable by the UID used for mounting, or the scratch file test will fail. Also, a tunable parameter UPPER_CASE has been added to the SYS:ETC/NWPARAMS file. It forces the NFS Gateway to create only upper case file and directory names. See the FEATURES.TXT for details. 16) Gateway time stamps incorrect for a while after DOS COPY. To reproduce, copy some files from C: drive onto Gateway drive. Use DIR to see time stamp. Time stamp reflects the server system time for an unpredictably long time. 17) Need DBCS Character support. NFS Gateway 1.2J running on NW 3.12J does not support DBCS on NW volumes. 18) Source code error found during code review. 19) On Gateway volume of test server with directories with up to 15 levels of subdirectories, the deletion of directories via DELDIR or FILER is fast when there are 5 levels or less. More than 5 levels incurs a delay of upto 10 seconds for each level. 20) When copying files from a gateway volume in packet burst mode the file is truncated if it is large. Packet burst is off, and the nfs transfer size (NFS_XFER_SIZE) is set lower than 8k. SOLUTION Apply GWY195.EXE Self-Extracting File Name: GWY195.EXE Revision: B Files Included Size Date Time \ GWY195.TXT (This File) INSTALL.TXT 3110 03-09-95 1:20p FEATURES.TXT 4158 03-09-95 1:43p \DISK1\ SPACE.DAT 10 02-01-93 3:58p PFILES.DAT 388 01-23-95 3:19p PCONFIG.DAT 64 12-02-94 2:55p PCONFIG.HLP 2183 07-29-92 1:27p PCONFIG.NLM 15934 09-17-93 6:03p PINSTALL.HLP 6798 06-21-93 2:53p PINSTALL.NLM 130422 11-08-93 6:39p P_UNINST.HLP 892 07-27-92 12:02p P_UNINST.NLM 72042 11-08-93 6:40p \DISK1\SYSTEM\ NFSGW.NL_ 227007 12-02-94 5:26p GWADMIN.NL_ 19607 12-02-94 5:28p Installation Instructions: See INSTALL.TXT. Patch History: This version of GWY195.EXE replaces all previous versions which were missing necessary sub- directories. It also contains current instructions on proper installation of this patch. Solution Specifics: GWY195.EXE corrects the listed symptoms. ----------------------------------------------------------------- Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information. ----------------------------------------------------------------- ÿ