home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1997 March / PCWK0397.iso / novell / webserv3 / readme.txt < prev    next >
Text File  |  1996-12-18  |  12KB  |  275 lines
  1. Novell Web Server 3.0 Release Document README.TXT
  2.  
  3. Copyright (c) 1995, 1996 Novell, Inc. All Rights Reserved. 
  4.  
  5. THIS WORK IS SUBJECT TO U.S. AND INTERNATIONAL COPYRIGHT LAWS AND TREATIES.
  6. NO PART OF THIS WORK MAY BE USED, PRACTICED, PERFORMED, COPIED, DISTRIBUTED,
  7. REVISED, MODIFIED, TRANSLATED, ABRIDGED, CONDENSED, EXPANDED, COLLECTED,
  8. COMPILED, LINKED, RECAST, TRANSFORMED, OR ADAPTED WITHOUT THE PRIOR WRITTEN
  9. CONSENT OF NOVELL, INC. ANY USE OR EXPLOITATION OF THIS WORK WITHOUT
  10. AUTHORIZATION COULD SUBJECT THE PERPETRATOR TO CRIMINAL AND CIVIL LIABILITY. 
  11.  
  12. DISCLAIMER
  13.  
  14. Novell, Inc. makes no representations or warranties with respect to
  15. this software, and specifically disclaims any express or implied warranties
  16. of merchantability, title, or fitness for a particular purpose. 
  17.  
  18. Distribution of this software is forbidden without the express written
  19. consent of Novell, Inc. 
  20.  
  21. Novell will not be responsible for any data loss that might result from
  22. implementing this software. Novell strongly recommends a backup be made
  23. before installing this software. 
  24.  
  25. !!!!!!CAUTION!!!!!!
  26.  
  27. Always back up your system before implementing any program/utility revision
  28. involving the low-level functions of IntranetWare, including re-linking of
  29. operating system .OBJ files, bindery utilities, and drive and volume
  30. operation.
  31.  
  32. ---------------------------------------------------------------------------
  33.                                     CONTENTS 
  34. ---------------------------------------------------------------------------
  35.  
  36. Welcome to the Novell Web Server 3.0 Readme file! This document contains
  37. last-minute information that is not included in the documentation. 
  38.  
  39. >>> 1. *****Installing the Product*****
  40. Instructions for installing the Novell Web Server 3.0 are located in the 
  41. Quick Start Card. To access this document, use your browser to open the
  42. <VOL>:\WEB\DISK1\INW_WEB\SHARED\DOCS\ONLINE\QSTART\QSTART.HTM document on 
  43. the product image you downloaded. The "Quick Start" also details the
  44. system requirements for installing the product.
  45.  
  46. >>> 2. *****System Memory Requirements*****
  47. In addition to the amount of memory required for IntranetWare, extra memory
  48. is required for the Novell Web Server 3.0. The following formula should be
  49. used to determine the amount of ADDITIONAL memory that will be required for
  50. the Web Server to run properly:
  51.  
  52.    1.5M Ram + (# of threads-16 default * 70K) + (# of Virtual
  53.    Servers * 200K) + (# of Virtual Hosts * 20K) = Amount of
  54.    memory in addition to that required for IntranetWare.
  55.  
  56. >>> 3. *****TCP/IP Requirement*****
  57. Novell Web Server 3.0 requires that a new version of TCPIP.NLM replace the
  58. one that exists in the \SYSTEM directory. A backup copy of the servers
  59. existing TCPIP.NLM and TCPIP.MSG will be saved in the \SYSTEM\TCPIP.SAV
  60. directory. These files can be restored into the \SYSTEM directory if there
  61. are incompatibilities with the new version however, Novell Web Server
  62. requires v4.00 of TCPIP.NLM.
  63.  
  64. >>> 4. *****Virtual Directories and NDS Replica*****
  65. The Virtual Directories feature will only work if the servers have an NDS
  66. replica on them.  This includes the machine that the web server is running
  67. on as well as the machine that the web server uses to retrieve the remote
  68. files.
  69.  
  70. >>> 5. *****Virtual Directories and Alias Directive*****
  71. When using Virtual Directories to access a 3.x server, the 3.x server must
  72. have a guest account with NO PASSWORD for the Alias directive to work
  73. correctly.
  74.  
  75. The Alias directive CANNOT be in NDS syntax.
  76.  
  77. Example: Alias /remotedir/ sjf-server1/sys:\remotedir
  78.  
  79. >>> 6. *****Virtual Directories and File Indexing*****
  80. There is no file indexing on remote servers when using the
  81. Virtual Directories feature.
  82.  
  83. >>> 7. *****SSL Known Problem*****
  84. When accessing a Server Side Include (SSI) document on an SSL-enabled
  85. Web server, the browser will receive most of the document and then hang. 
  86. When this happens, click Stop.
  87.  
  88. >>> 8. *****MHSTATUS Utility*****
  89. In order to properly unzip MHSTATUS.ZIP, Long File name support must
  90. be enabled on IntranetWare. Do the following prior to unzipping MHSTATUS.ZIP.
  91. At the server console, LOAD LONG followed by ADD NAME SPACE <name space name>
  92. TO <volume name>. There are addition memory requirements that are determined
  93. by the size of the Volume. Refer to the IntranetWare documentation to 
  94. determine the amount. 
  95.  
  96. >>> 9. *****Language Support*****
  97. The Early Access Release of the Novell Web Server 3.0 only supports
  98. the English language. When you install Novell Web Server on a IntranetWare
  99. server with the LANGUAGE parameter set to French, Italian, German, or Spanish,
  100. the Novell Web Server installation module will automatically load using
  101. English. There is no need for you to change the LANGUAGE parameter value.
  102.  
  103. >>> 10. *****WEBMGR and Network Button*****
  104. If you notice that the File/Select Server/Network button does not work 
  105. inside the administration utility (WEBMGR.EXE), you may have an old
  106. COMMDLG.DLL in the C:\WINDOWS or C:\WINDOWS\SYSTEM directory. If you
  107. have a newer version of this DLL, you can simply delete the old version.
  108. If you only have the old version, you must delete the old COMMDLG.DLL
  109. and install a newer version to get the Network button to work. 
  110.  
  111. >>> 11. *****Scripts and Security*****
  112. Access to all directories containing scripts should be strictly controlled.
  113. Only the people responsible for writing, managing, and editing scripts
  114. should have read and write rights to the script directories
  115. <VOL>:INW_WEB\SCRIPTS, <VOL>:INW_WEB\SCRIPTS\PERL, <VOL>:NETBASIC\WEB, and
  116. any other script directories you create. 
  117.  
  118. Scripts should be designed and written with security in mind and should
  119. access resources on the server in ways that do not jeopardize the security
  120. of the server. 
  121.  
  122. >>> 12. *****Controlling Access to LCGI NLM's*****
  123. The Novell Web Server provides a special method to restrict access
  124. to LCGI programs, such as NetBasic and NDS Object Browser. To restrict
  125. access to LCGI programs, create an ACCESS.WWW file in the directory where
  126. the LCGI program resides. When a user requests an LCGI server extension
  127. in this directory, he will be prompted for a userid and password. 
  128.  
  129. It is important to note, once a user is authenticated to use the NetBasic
  130. LCGI extension, full access to all available NetBasic scripts is allowed.
  131. You cannot selectively place access control on different NetBasic scripts.
  132. Once a user is authenticated to use the NDS Object Browser, browsing to
  133. all available trees in NDS and all public object information is allowed.
  134.  
  135. Refer to the User Access Control section for details on how to set up
  136. the ACCESS.WWW file. By default, access to NetBasic is not restricted.
  137. When NDS browsing is enabled from the WEBMGR, access is not restricted.
  138.  
  139. >>> 13. *****WEBMGR.EXE Deletion of Comments in *.CFG Files*****
  140. The administration utility (WEBMGR.EXE) does not support user comments
  141. in *.CFG files. If you manually edit these files and add comments by
  142. preceding lines with a pound sign (#), these lines will be deleted when
  143. you run the WEBMGR utility. A set of sample *.CFG files with full comments
  144. is provided in the <VOL>:INW_WEB\SAMPLES\CONFIG\ directory. 
  145.  
  146. >>> 14. *****Adding the NetBasic LoadableModule Directive for Upgrades 
  147. If you are upgrading to Web Server 3.0, in order to allow users to issue
  148. requests to NetBasic scripts, you must manually edit the SRM.CFG file and
  149. add a LoadableModule directive to map URL requests to the NetBasic NLM
  150. (CGI2NMX.NLM). 
  151.  
  152. Add the following directive to the SRM.CFG file: 
  153.  
  154. LoadableModule /netbasic/ <VOL>:/lcgi/netbasic/cgi2nmx.nlm
  155.  
  156. >>> 15. *****Perl 4*****
  157. The Early Access Release of the Novell Web Server 3.0 supports
  158. Perl 4, not Perl 5 as documented in the "Dynamic Web Page Programmer's
  159. Guide."
  160.  
  161. >>> 16. *****Oracle Database Access from NetBasic*****
  162. Novell Web Server 3.0 supports access of data in an Oracle 7 database
  163. from a NetBasic script. However, the following Oracle class commands
  164. are not yet documented in the NetBasic Command Reference Guide:
  165.  
  166.    ORA:Error:Message
  167.    ORA:Field:First
  168.    ORA:Field:Get
  169.    ORA:Field:Max
  170.    ORA:Field:Next
  171.    ORA:Field:Size
  172.    ORA:Field:Type
  173.    ORA:Logoff
  174.    ORA:Logon
  175.    ORA:SQL
  176.    ORA:Record:Get
  177.  
  178. >>> 17. *****Support for Dartmouth BASIC Scripts*****
  179. The Dartmouth BASIC interpreter (BASIC.NLM) has been replaced by the NetBasic
  180. NLM (CGI2NMX.NLM). If you are upgrading from a previous version of Novell Web
  181. Server, your existing BASIC scripts will continue to work. You should use
  182. NetBasic for any new scripts.
  183.  
  184. >>> 18. *****SSL and Virtual Server's*****
  185. Upon creating the 3rd Virtual Server, the server console will prompt for an
  186. Secure Sockets Layer(SSL) password. This is a know problem and will be
  187. resolved.
  188.  
  189. >>> 19. *****Quick Finder and Access Control*****
  190. Problem: Currently a protected QFSEARCH.HTM would be in a directory outside
  191. of the Alt Doc Root(not sure if this is documented yet):
  192. SYS:\web\docs\protect\qfsearch.htm
  193.  
  194. Access control would be turned on for this directory and Netscape would
  195. require the user to have to login before filling out the form.  Once the
  196. form is submitted with the SEARCH button Netscape send the following query:
  197.  
  198. GET /QFSEARCH?Query=Novell
  199.  
  200. Since Netscape has authenticated to /PROTECT/ and not the root directory,
  201. it WILL NOT send the Username/Password information along with this /QFSEARCH
  202. request.  It will then appear as though the Web Server is not functioning
  203. correctly, but in actuality this is a configuration issue. 
  204.  
  205. Solution: The solution to this problem is two fold.  Request relative to
  206. where the QFSEARCH.HTM file exists.
  207.  
  208. QFSEARCH can be run from another location besides the root path /.
  209.  
  210. Step 1:
  211.  
  212. Currently we ship SYS:\INW_WEB\SHARED\DOCS\LCGI\QFSEARCH\QFSEARCH.HTM.
  213. Inside this document we provide a way to type in text to search for an then
  214. submit this query.  The form action must be changed as shown below:
  215.  
  216. Currently:  <FORM ACTION="/qfsearch" METHOD=GET> 
  217. Change to: <FORM ACTION="qfsearch" METHOD=GET>
  218.  
  219. Step 2:
  220.  
  221. If the QFSEARCH.HTM form is located in the following directory:
  222.  
  223. SYS:\WEB\DOCS\PROTECT\QFSEARCH.HTM
  224.  
  225. then you must add this Loadable module statement to your SRM.CFG
  226.  
  227. LoadableModule /protect/qfsearch <qfsearch>
  228.  
  229. The second parameter is the same as the existing LoadableModule statement for the 
  230. /qfsearch/ program.  
  231.  
  232. Access control can then be turned on for the /PROTECT/ directory and
  233. everything will work as expected. 
  234.  
  235. NOTE:   Each time a protected form is added to the system under a different 
  236. directory tree (ie:  /MYDOCS vs. /PROTECT) then a LoadableModule statement
  237. will need to be added!
  238.  
  239. >>> 20. *****NWAdmin and SNAP-IN Modules*****
  240. NWAdmin Snap-In for Home Page (http://servername/~username) Feature:
  241. ---------------------------------------
  242.  
  243. 1. Follow the documentation in "Publishing on the Novell Web Server" /
  244. "Publishing Documents."  Scroll down right frame to "Setting Up User
  245. Directories" for WEBMGR.EXE setup.
  246.  
  247. 2. Make sure the Snap-In is installed by following the directions in "Web
  248. Server Administration"/"NDS/"NWADMIN Snap-IN".
  249.  
  250. 3. Launch NWADMIN and select a USER or GROUP that you want to enable Web
  251. Publishing for.
  252.  
  253. 4. Select details on the object and select the "Web Publishing" tab.
  254.  
  255. 5. Make sure the "directory listed for the object" matches the directory
  256. listed in the WEBMGR configuration that was defined in WEBMGR.EXE.
  257.  
  258. 6. Select the enable button and click ok.
  259.  
  260. 7. Repeat this procedure for all USERS or GROUPS for whom you want to enable
  261. or disable Web Publishing rights.
  262.  
  263. What the Snap-In Does:
  264. ----------------------
  265.  
  266. The Snap-In makes two modifications to enable USER home directories to be
  267. accessed through the http://servername/~username method.
  268.  
  269. 1. Grant [PUBLIC] trustee rights to the User Object's "Home Directory"
  270. attribute.
  271.  
  272. 2. Grant [PUBLIC] trustee rightrs to the PUBLIC.WWW subdirectory in the file
  273. system.
  274.  
  275.