TECHNICAL INFORMATION DOCUMENT DOCUMENT PROCESSING INFO: TITLE: PTF205 - UnixWare NLMs DOCUMENT ID: TID300205 DOCUMENT REVISION: A DATE: 21APR95 ALERT STATUS: Yellow DISTRIBUTION: Public INFORMATION TYPE: Symptom Solution README FOR: ptf205 PRODUCT and VERSION: UnixWare 1.1 CATEGORY: Core OS Networking ABSTRACT: This PTF contains the NetWare Loadable Modules (NLMs) from UnixWare 2.01. You should install this PTF if you are having trouble installing or running the UnixWare 1.1 NLMs on your NetWare 4.1 Server. SYMPTOM The NetWare Loadable Modules from UnixWare 1.1 do not install or work correctly on a 4.1 Server SOLUTION Apply the ptf205 file. Installation Instructions: DATATYPE: file 1. Download the following files to the /tmp directory on your machine: ptf205.dd.1.Z ptf205.dd.2.Z ptf205.txt 2. Read the solution specifics area below for specific instructions for ptf205. Solution Specifics PTF205 OVERVIEW --------------- Title ----- PTF205 - UnixWare 2.01 NLMs Version ------- 1.0 Date ---- 18APR95 Information Type ---------------- Symptom Solution Product And Version -------------------- UnixWare 1.1 and all its Updates General Description. ------------------- The NetWare Loadable Modules (NLMs) from UnixWare 1.1 do not install or work correctly on a NetWare 4.1 Server. This PTF contains the NLMs from UnixWare 2.01, which are compatible with the NetWare UNIX Client from UnixWare 1.1 and with NetWare 4.1. New Features. ------------ None Software Notes and Recommendations. ---------------------------------- Testing of the modified software contained in this package has been conducted only to the extent necessary to confirm that it resolves the problem(s) stated above ("Symptom"). Such testing consists of recreating the problem conditions and verifying that the problem no longer occurs. No other testing of this software has been done. Hardware Notes and Recommendations. ---------------------------------- This PTF is targeted for the i386, i486 and Pentium CPU's. Installation Instructions. ------------------------- ***** Making the NLM Diskettes ***** Follow this procedure to write the NetWare Loadable Modules (NLMs) from this PTF onto diskettes. You will then use these diskettes to install the NLMs onto a NetWare server. 1) Decompress the diskette images contained in this PTF. Enter /usr/bin/uncompress ptf205.dd.?.Z 2) Format two 3.5-inch diskettes. To format a diskette, place a blank diskette into a diskette drive and enter /usr/sbin/format -i 1 device_name where device_name is /dev/rdsk/f03ht if your 3.5-inch drive is A, or /dev/rdsk/f13ht if your 3.5-inch drive is B. Do this for both diskettes. Put a paper label on each diskette, and write "NLM Disk 1" on one of them and "NLM Disk 2" on the other. 3) Copy the diskette images onto the diskettes. To do this, enter /usr/bin/dd if=image_file of=device_name bs=36b where image_file is ptf205.dd.1 (for the first diskette) or ptf205.dd.2 (for the second diskette), and device_name is as described above. The NLMs can now be installed on a NetWare 3.x or 4.x server using the diskettes you just created. See Installing the NLMs (below). ***** Installing the NLMs ***** Follow this procedure to install the UnixWare NLMs on your NetWare server from the diskettes you created in the above section. This entire procedure is performed on the NetWare server console. 1) Load the TCPIP.NLM on your server. Do this with the following command: LOAD TCPIP If the TCPIP.NLM module is not found, consult your NetWare documentation for information on how to install the module. If the TCPIP module is already loaded, the system will display a message that tells you so. The TCPIP.NLM module is required to be loaded (but not necessarily bound to a driver) before you can install the NLMs on NetWare. 2) In order to use the UnixWare telnet command to log in to the NetWare console (using XCONSOLE.NLM), and to perform remote backups of a UnixWare system via TCP/IP from the NetWare server, the IP protocol must be bound to a network interface card driver. NOTE: With UnixWare 1.1 as the client, the XCONSOLE.NLM can be used over TCP/IP via telnet, but not over IPX/SPX using Remote_Applications. Be sure to load REMOTE.NLM before loading XCONSOLE.NLM. Make sure that the TCP/IP protocol is bound to a network interface card by entering the PROTOCOL command on the NetWare console. Typical output of this command is shown below: Protocol: IPX Frame type: VIRTUAL_LAN Protocol ID: 0 Protocol: ARP Frame type: ETHERNET_II Protocol ID: 806 Protocol: IP Frame type: ETHERNET_II Protocol ID: 800 Protocol: IPX Frame type: ETHERNET_II Protocol ID: 8137 If you need to bind a protocol to a network card, use the BIND NetWare console command. An example is shown below for both IP and IPX. BIND IPX TO NE2000 NET=network_address BIND IP TO NE2000 ADDR=xxx.xxx.xxx.xxx MASK=yyy.yyy.yyy.yyy where network_address is your system's IPX address, xxx.xxx.xxx.xxx is the IP address of your system and yyy.yyy.yyy.yyy is the network mask (for example, 255.255.255.0). See the NetWare Utilities book for an explanation of the BIND command, and the NetWare Concepts book for an explanation of interface boards, binding, and related topics on NetWare. 3) Load the installation program on the server console by entering: load install at the server console prompt. 4) Once the installation program starts: a) On a NetWare 3.x server, choose Product Options from the main menu, using the arrow and Enter keys. b) On a NetWare 4.x server, choose Maintenance/Selective Install from the first menu and then choose Product Options. 5) When the Currently Installed Products screen appears, insert the diskette labeled "NLM Disk 1" into a diskette drive and press the Insert key. a) On a NetWare 3.x server, a message box appears asking in which disk drive the product files will be found. The message box contains A: by default; if you used a different diskette drive, use the Backspace key and type the appropriate drive letter, a colon, and press Enter. Otherwise, press Enter to accept the default A: drive. b) On a NetWare 4.x server, a prompt appears asking you to insert the first diskette containing the product files into the A: drive. To select a drive other than A:, press . Once you select the appropriate drive, press Enter. As the Product Installation program is started from the diskette, the Install screen will disappear; the Product Installation screen should appear in a few seconds. 6) The system now asks for the directory from which the NetWare server is booted; that is, the directory in which the file SERVER.EXE is located on the NetWare server. The location you specify depends on how you installed NetWare. (You can try looking in the file AUTOEXEC.BAT on your server's hard drive; this file usually contains a line that starts the server. See your NetWare Installation documentation for more information.) Enter the name of the directory in which the SERVER.EXE program is installed. Once you type the directory name, press Enter. The installation program begins reading the software off of the floppy and installing it on the server. 7) When the end of the first diskette is reached, the installation program prompts you for the second diskette. Remove the first diskette from the diskette drive, insert the diskette labeled "NLM Disk 2," and press the Esc key. The installation program reads files off of the second diskette and installs them on the server. 8) Once it reaches the end of the second diskette, the installation program displays: NUC 3/4.X NetWare Unix Client Product is installed. Press Esc and remove the diskette. The installation program returns you to the Currently Installed Products screen, which now displays an entry for NWUC. 9) Press the Esc key twice (three time on NetWare 4.x) and then press Enter to leave the installation utility and return to the console prompt. 10) You now need to bring the server down and restart it. To do this: a) Enter the following two commands at the console prompt: DOWN EXIT This will bring the server down and exit to DOS. b) At the DOS prompt, enter: SERVER to restart the server. As the server starts, a new virtual screen is displayed on the server console, the Product Kernel Message Screen. This screen is used by the NWUC product software to display informational and error messages. The NLM that manages this screen (PKERNEL.NLM) should remain loaded as long as any of the UnixWare NLMs are loaded. Use the key sequence Alt-Esc to switch between virtual screens on the NetWare console. 11) On a NetWare 4.x server only, execute the following command at the server console prompt: load inetdb admin-login password where admin-login is the administrative login for the server (Admin by default) and password is the password for that login. (This command needs to be performed once only; that is, you do not need to repeat it after subsequent reboots of the server.) Once you complete the above procedure, all of the available volumes on the NetWare server are available in DOS mode (unless the NFS name space has already been added to a volume). ***** Uninstalling the NLM Software ***** Follow the procedure in this section to remove the UnixWare NLMs from a NetWare 3.x or 4.x server. NOTE: The configuration files in sys:etc (hosts, nfsgroup, and nfsusers), as well as the directory sys:system\tsa are not removed by this procedure. If they are not being used by other Novell products (such as NetWare NFS or NFS Gateway), you can remove these files using FILER or some other DOS utility. To remove the UnixWare NLMs from the NetWare server: 1) If the NLMs are running on the server, enter: unistop on the NetWare console to unload them. 2) Load the installation program by entering: load install at the NetWare console prompt. 3) Once the installation program starts: a) On a NetWare 3.x server, choose Product Options from the main menu, using the arrow and Enter keys. b) On a NetWare 4.x server, choose Maintenance/Selective Install from the first menu and then choose Product Options. 4) When the Currently Installed Products screen appears, use the arrow keys to highlight the NWUC entry and press the Delete key. A message box appears asking for confirmation. 5) Use the arrow keys to highlight Yes in the message box and press Enter. 6) A message appears when the installation program completes the removal of the product. You can now exit the installation program. Troubleshooting. --------------- Be sure to "add name space NFS" to any volumes that you want your UW1.1 clients to access using the UNIX name space features. The server file sys:\system\unistart.ncf contains the commands for loading the UNIX NLMs. The command "load nuc" has some options. "load nuc" (the default) is for NetWare mode and "load nuc vol1 vol2 ..." is for NFS/UNIX mode. "load nuc all" puts all mounted volumes into NFS mode. In NFS mode, the NUC user can chmod, chown, chgrp, and so on. In NetWare mode, the NUC user can only create long file names and changed the execute (x) bit of the mode.