home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / nfssft.exe / DISK1 / README.TXT < prev    next >
Text File  |  1995-11-02  |  16KB  |  390 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. TITLE:  NFSSFT; SFT III Update for NW NFS Services 2.1 - NW 4 Edition
  4. README FOR:  NFSSFT.EXE 
  5. NOVELL PRODUCTS and VERSIONS: NetWare NFS Services 2.1 - NetWare 4
  6. Edition
  7.  
  8. ABSTRACT:
  9.                         
  10. The SFT III Update for NetWare NFS Services 2.1 is a software update to
  11. the NetWare NFS Services 2.1 product that enables the NFS Services 2.1
  12. software to run on NetWare SFT III 4.10. 
  13.  
  14. Self-Extracting File Name: NFSSFT.EXE
  15.  
  16. -----------------------------------------------------------------
  17. DISCLAIMER
  18. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. 
  19. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.
  20. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR
  21. INFORMATION ONLY.  NOVELL  MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE
  22. VALIDITY OF THIS INFORMATION.
  23. -----------------------------------------------------------------
  24.  
  25. SYMPTOM:
  26.  
  27. NetWare NFS Services 2.1, NetWare 4 Edition requires this update in
  28. order to support NetWare 4.10 SFT III system software.
  29.  
  30. SOLUTION: 
  31.  
  32. Install NFSSFT.EXE file as described below in Installation.
  33.  
  34. This SOLUTION contains the following sections:
  35.     General Information
  36.     Installation Instructions
  37.     Additional Release Notes
  38.     TCP/IP Configuration
  39.       
  40. ===============
  41. General Information
  42. ===============
  43.  
  44. NFSSFT replaces some but not all of the NFS Services 2.1 files.  It
  45. cannot run on its own, and cannot be used to upgrade from NetWare NFS
  46. 1.x or NFS Gateway 1.x to NetWare NFS Services 2.1 NetWare 4 Edition.
  47.  
  48. NFSSFT is not intended for use with native 4.10.  The SFT III upgrade to
  49. NetWare 4.10 operating system is required.
  50.  
  51. If you remove this SFT III update from an NetWare SFT III server, make
  52. sure that you also remove the NetWare NFS Services 2.1 product.  NetWare
  53. NFS Services cannot function properly by itself and would be unstable on
  54. SFT III.
  55.  
  56. NFSSFT patch can be installed before or after the NFS Services product
  57. itself.
  58.  
  59. =================
  60. Installation Instructions
  61. =================
  62.  
  63. 1.  (Optional step)  After the base SFT III system is installed, make
  64. complete backup of SYS:SYSTEM and any critical data directories.
  65.  
  66. 2.  Apply all the latest NetWare SFT III Operating System patches to the
  67. base SFT III system.  Also, apply the latest version of DS.NLM.
  68.  
  69. You can get these either from NetWire or from the Web site at
  70. http://www.novell.com.
  71.  
  72. 3.  Configure TCP/IP on the SFT III server.  Detailed instructions are
  73. at the end of this document.
  74.  
  75. 4.  (Optional step)   Make a backup of TCPIP.NLM.  The installation
  76. process automatically upgrades TCPIP.NLM if the installation program
  77. (INSTALL.NLM) detects an older version.
  78.  
  79. 5.  From a workstation attached to the NetWare SFT III 4.10 server,
  80. create a directory named NFSSFT on any NetWare volume on the Primary MS
  81. Engine.
  82.  
  83.     MD NFSSFT
  84.  
  85. 6.  Copy NFSSFT.EXE into the new directory.
  86.  
  87.     NCOPY NFSSFT.EXE SYS:NFSSFT
  88.  
  89. 7.  Type NFSSFT <enter> to extract the files.
  90.  
  91.     CD NFSSFT
  92.     NFSSFT
  93.  
  94. 8.  From the console of the MS engine, check the mirror status to ensure
  95. both partitions are synchronized.
  96.  
  97.     MIRROR STATUS
  98.  
  99. 9.  From the server console, run UNISTOP.NCF as a general precaution.
  100.  
  101.     UNISTOP
  102.  
  103. 10. If NFS Services 2.1 is already installed on this machine, make sure
  104. that you are at the console of the same machine now.  This software
  105. update and NFS Services 2.1 both should be installed on the same
  106. physical machine.  When both partitions activates, this will be the
  107. primary server.
  108.  
  109. 11. Load the installation program.
  110.  
  111.     LOAD INSTALL
  112.  
  113. 12. Select PRODUCT OPTIONS.
  114.  
  115. The Currently Installed Products list appears.
  116.  
  117. 13. Press <Insert> to install a new product.
  118.  
  119. 14. Press <F3> to specify the location of the NFSSFT directory.  The
  120. "SPECIFY DIRECTORY PATH" dialogue box will appear.
  121.  
  122. 15. Enter the path to the directory where the NFSSFT files were
  123. previously extracted, in the DISK1 subdirectory.  
  124.  
  125.     SYS:/NFSSFT/DISK1
  126.  
  127. After the installation program installs the files, the "Currently
  128. Installed Products" list will contain a new entry:
  129.  
  130.     NFSSFT    NetWare NFS Services 2.1, SFT III Update
  131.  
  132. 16. Exit the Installation program or press <ALT-ESC> to return to the
  133. system console prompt.  The installation of the update software is now
  134. almost complete.
  135.  
  136. 17. Copy the file NFS.NAM manually from the Netware boot directory on
  137. the server where this update was installed to the boot directory of the
  138. other server in the SFT III pair.  This is necessary because the NFS.NAM
  139. is loaded from the DOS partition, usually the C: drive, which is not
  140. mirrored.  All console commands which access files in the DOS partition
  141. go to the DOS partition on the Primary MS Engine.
  142.  
  143. 18. If NFS Services 2.1 is not already installed on this machine,
  144. install it now according to its packaged instructions.
  145.  
  146. 19. Installation is now complete, NFS Services is running, and the
  147. startup files have been modified for NFS Services to autoload the next
  148. time SFT III boots.  If it is ever necessary to manually start the
  149. Services from the server console, load the TIMECHK.NLM.  Although
  150. UNISTART.NCF is still present, as with pre-upgrade NFS Services, it is
  151. better to use TIMECHK instead.  See notes below on Time Synchronization
  152. for more information.
  153.  
  154. 20. Additional steps are needed to allow replication of the NIS database
  155. with other NIS servers because NIS broadcasts cannot propagate across
  156. the internal IP router of SFT III.  Similarly, the NIS server on SFT III
  157. will never recieve the "ypbind -broadcast"  from any other UNIX NIS
  158. client.
  159.  
  160. To enable replication and proper operation of NIS:
  161.  
  162. 20a. If NetWare is an NIS slave server,  explicitly enter the IP address
  163. of the NIS master server.   From UNICON, go to Manage Replica Databases
  164. and try to create a replica domain, and enter the domain name.  When the
  165. broadcast fails, enter the IP address of the NIS master for the domain.
  166.  
  167. 20b. If NetWare is an NIS master, NIS clients have to be explicitly
  168. bound to the IP address for the MS engine. 
  169.  
  170. ===================
  171. Additional Release Notes:
  172. ===================
  173.  
  174. *   If NetWare NFS file system is mounted using the "soft" option, then
  175. I/O errors on the NFS client may be seen if the primary server fails,
  176. since it takes time for the secondary server to take over.  If you wish
  177. to prevent this possibility, use the hard mount option or increase the
  178. timeout parameter associated with the soft mount.
  179.  
  180. *   The RARP Server is not supported on NetWare SFT III.  The RARP NLM
  181. will exit when loaded on SFT III.
  182.  
  183. *   The remote access services are available only through UNICON.  Do
  184. not enable remote access (FTP and XCONSOLE) by using INETCFG utility. 
  185. Instead, use UNICON to do the same thing. 
  186.  
  187. *   XCONSOLE does not use the fault-tolerant features of SFT III, since
  188. the NLMs related to XCONSOLE service load in the I/O Engine. Therefore,
  189. in the event of the SFT III Primary Server failure, the XCONSOLE service
  190. stops and any XCONSOLE sessions are terminated.  However, the service
  191. can be restarted through UNICON and new XCONSOLE sessions can be created
  192. by attaching to the IO Engine of the new Primary Server. 
  193.  
  194. For example, consider an SFT III system having the following IP
  195. addresses for its IO Engines:
  196. IO Engine 1: IP addr=154.88.219.48
  197. IO Engine 2: IP addr=154.88.219.49
  198.  
  199. REMOTE.NLM and RSPX.NLM are loaded in both the IO Engines.
  200.  
  201. Let us assume that IO Engine 1 is initially the Primary Server.
  202.  
  203. To start an XCONSOLE session, the following steps are carried out:
  204.  
  205. 1.  Start the XCONSOLE service through UNICON.
  206. 2.  Open an XCONSOLE session from an XServer by connecting to the
  207. Primary Server IOEngine, e.g. telnet to IOEngine1 (IP
  208. addr=154.88.219.48)
  209.  
  210. Subsequently, the Primary Server fails and IOEngine2 takes over as the
  211. new Primary Server.  The XCONSOLE service stops.
  212.  
  213. To restart the XCONSOLE session, follow these steps: 
  214. 1.  Start the XCONSOLE service through UNICON.
  215. 2.  Open an XCONSOLE session from an XServer by connecting to the
  216. Primary Server current IOEngine, e.g. telnet to IOEngine2 (IP
  217. addr=154.88.219.49).
  218.  
  219. You cannot start XCONSOLE on both IO1 and IO2 concurrently, because they
  220. share the same
  221. MS Engine.
  222.  
  223. XCONSOLE clients (X servers) can attach to the IP address of the primary
  224. I/O engine.  Attempts to access the MS engine will fail.
  225.  
  226. *   TIME Synchronization is important.  NFS Services will not function
  227. properly if the time is not synchronized to the network. To ensure that
  228. the NFS Services are loaded only after time is synchronized, this update
  229. modifies MSAUTO.NCF so that it loads a TIMCHK.NLM instead of executing
  230. UNISTART.NCF.  The TIMCHK.NLM in turn executes UNISTART.NCF, but only
  231. after the time is synchronized.  Do not manually start the NFS Services
  232. or use UNISTART until time synchronization is complete (the console
  233. command TIME reports that "Time is synchronized to the network").
  234.  
  235. ===============================
  236. TCP/IP Configuration on NetWare SFT III
  237. ===============================
  238.  
  239. The SFT III system from an TCP/IP network perspective consists of the
  240. following:
  241.  
  242. 1.  The two IO Engines - IO1 and IO2 connected to the physical network,
  243. each having a unique IP address and using the same Subnet Mask as used
  244. by other Nodes on the Subnet.
  245.  
  246. 2.  The MS Engine resides on a Virtual LAN and is not directly connected
  247. to the physical or the real network.  The MS Engine interfaces to the
  248. real network through the IO Engine.  The two IO Engines (can be
  249. visualized to) have a common IO Engine interface which resides on the
  250. Virtual LAN along with the MS Engine.  Let us call this common interface
  251. as the IO Engine-MS Engine Internal Interface.
  252.  
  253. The Virtual LAN in effect is a stub-subnet with the IO Engines acting as
  254. routers between the real network and the Virtual LAN (the IO Engine on
  255. the Primary Server routes IP packets between the MS Engine and the
  256. real/physical network).
  257.  
  258. The two nodes on the Virtual LAN, the MS Engine and the IO Engine-MS
  259. Engine Internal Interface, have a common stub-subnet Mask and each has a
  260. unique IP address.
  261.  
  262. From the above description, it is clear that an SFT III system requires
  263. four IP addresses:  one for IO Engine 1, one for IO Engine 2, one for
  264. the MS Engine and one for the IO Engine-MS Engine Internal Interface.
  265.  
  266. However, it is important to note that addresses in the stub-subnet mask
  267. address range cannot be allocated to any other node on the real/physical
  268. network.  Therefore, the actual range of IP addresses to be allocated or
  269. reserved for the SFT III system extends beyond four addresses.
  270.  
  271. Figure 1.  TCP/IP Configuration Example
  272.  
  273. +-------------------------------+
  274. |  Mirrored Server - MS Engine  |
  275. |     154.88.219.33             |
  276. +-------------------------------+
  277.                 |
  278.                 |
  279.                 |            Virtual LAN
  280.      ----------------------------------------------
  281.                               |
  282.                               |      
  283.          (IO Engine-MS Engine | Internal Interface)
  284.            |------------54.88.219.34-----------|
  285. +-----------------+                 +-----------------+
  286. |  IO Engine 1    |                 |  IO Engine 2    |
  287. |  154.88.219.48  |                 |  154.88.219.49  |
  288. +-----------------+                 +-----------------+
  289.            |                                   |            
  290.            |     Real Network  154.88.219.0    |
  291. --------------------------------------------------------------
  292.  
  293. Let us assume some example addresses.  An SFT III system is to be setup
  294. on a class B subnetwork; the Subnet IP address is 154.88.219.0.  The
  295. Subnet Mask used by the IO Engines will be 255.255.255.0 (FF.FF.FF.00) -
  296. the same as for any node on a Class B Subnet.
  297.  
  298. Let us assume that the range of IP addresses from 154.88.219.32 to
  299. 154.88.219.63 is available.
  300.  
  301. The stub-subnet mask can be configured to one of the following:
  302.  
  303. Stub-Subnet Mask                 Number of IP addresses to be set aside
  304.                                        exclusively for the Stub-Subnet
  305. 1. 255.255.255.248  (FF.FF.FF.F8)                   8
  306. 2. 255.255.255.240  (FF.FF.FF.F0)                  16
  307. 3. 255.255.255.224  (FF.FF.FF.E0)                  32
  308.  
  309. Let us assume that we select the Stub-Subnet Mask as 255.255.255.240 and
  310. that we choose to allocate the following IP addresses for the Nodes on
  311. the Virtual LAN or the Stub-Subnet:
  312.  
  313. Node                                  IP Address     Stub-subnet Mask
  314. MS Engine                             154.88.219.33  255.255.255.240
  315. IOEngine-MSEngine Internal Interface  154.88.219.34  255.255.255.240
  316.  
  317. Stub-Subnet Mask = 255.255.255.240:
  318.     240 = 1111 0000
  319.      33 = 0010 0001 (MS Engine)
  320.      34 = 0010 0010 (IO-MS internal interface)
  321.  
  322. Stub-Subnet Address = 154.88.219.32:
  323.     Node ID for MS Engine = 1
  324.     Node ID for IO-MS internal interface=2
  325.  
  326. Now the range of IP addresses from 154.88.219.32 to 154.88.219.47 has to
  327. set aside or reserved exclusively for the SFT-III system and cannot be
  328. used by any other node on the Class B subnet.  So, we allocate the IP
  329. addresses for the two IO Engines as follows:
  330.  
  331. Node         IP Address     Subnet Mask
  332. IO Engine 1  154.88.219.48  255.255.255.0
  333. IO Engine 2  154.88.219.49  255.255.255.0
  334.  
  335. To setup TCP/IP configuration on SFT III system, the following steps are
  336. to be carried out:
  337.  
  338. 1.  Load INETCFG in IO Engine1 - select Bindings Option, add/select
  339. TCP/IP protocol and configure the IP address and the Subnet Mask for IO
  340. Engine1.
  341.  
  342. Then select the Protocols Option, select TCP/IP protocol and configure
  343. the following:
  344. "IP address for the SFT III Network" (i.e. IP address for the IO-MS
  345. Internal Interface) and the "Subnet Mask of SFT III Network" (i.e. the
  346. Stub-subnet Mask)
  347.  
  348. 2.  Load INETCFG in IO Engine2 and repeat the same steps as was done on
  349. IO Engine1.
  350.  
  351. 3.  Load INETCFG in the MS Engine - select Protocols Option, select
  352. TCP/IP protocol and configure the following:
  353. "IP address for the SFT III Network" (i.e. IP address for the MS Engine)
  354. and the "Subnet Mask of SFT III Network" (i.e. the Stub-subnet Mask).
  355.  
  356. Once the TCP/IP configuration for the SFT III system is complete (and
  357. TCP/IP has been loaded in both the IO Engines and the MS Engine), you
  358. can verify the same by doing a PING operation to the MS Engine IP
  359. address from another node (say, a Unix host) on the network. 
  360.  
  361. Note that the IO Engine - MS Engine Internal Interface address must
  362. exist on the same network as the IP address bound to the I/O engines, as
  363. seen below in MSAUTO.NCF.
  364.  
  365. Note also that the RIP = YES parameter is required for proper function,
  366. to allow RIP broadcasts to go to the network.
  367.  
  368. Do not modify these files with any text editor, use INETCFG only.
  369.  
  370. After successful configuration, the .NCF script files used by NetWare
  371. SFT III during bootup will contain the network configuration.  Using the
  372. same example, the script files would contain:
  373.  
  374. I/O Engine 1 SYS:ETC/IO1/NETINFO.CFG (IO engine 1) contains:
  375.  
  376.     LOAD TCPIP RIP=YES FORWARD=YES
  377.     BIND IP NE2000   ADDR=154.88.219.48 MASK=255.255.255.0
  378.     BIND IP MSENGINE ADDR=154.88.219.33 MASK=255.255.255.240
  379.  
  380. I/O Engine 2 SYS:ETC/IO1/NETINFO.CFG (IO engine 2) contains:
  381.  
  382.     LOAD TCPIP RIP=YES FORWARD=YES
  383.     BIND IP NE2000   ADDR=154.88.219.49 MASK=255.255.255.0
  384.     BIND IP MSENGINE ADDR=154.88.219.33 MASK=255.255.255.252
  385.  
  386. SYS:ETC/NETINFO.CFG (the MS engine) contains:
  387.  
  388.     LOAD TCPIP RIP=YES FORWARD=NO
  389.     BIND IP MSENGINE ADDR=154.88.219.34
  390.