NetWare Web Server 2 Release Document README.TXT Copyright (c) 1995 Novell, Inc. All Rights Reserved. THIS WORK IS SUBJECT TO U.S. AND INTERNATIONAL COPYRIGHT LAWS AND TREATIES. NO PART OF THIS WORK MAY BE USED, PRACTICED, PERFORMED, COPIED, DISTRIBUTED, REVISED, MODIFIED, TRANSLATED, ABRIDGED, CONDENSED, EXPANDED, COLLECTED, COMPILED, LINKED, RECAST, TRANSFORMED, OR ADAPTED WITHOUT THE PRIOR WRITTEN CONSENT OF NOVELL, INC. ANY USE OR EXPLOITATION OF THIS WORK WITHOUT AUTHORIZATION COULD SUBJECT THE PERPETRATOR TO CRIMINAL AND CIVIL LIABILITY. DISCLAIMER Novell, Inc. makes no representations or warranties with respect to this software, and specifically disclaims any express or implied warranties of merchantability, title, or fitness for a particular purpose. Distribution of this software is forbidden without the express written consent of Novell, Inc. Novell will not be responsible for any data loss that might result from implementing this software. Novell strongly recommends a backup be made before installing this software. *************************************************************************** CAUTION *************************************************************************** Always back up your system before implementing any program/utility revision involving the low-level functions of NetWare, including re-linking of operating system .OBJ files, bindery utilities, and drive and volume operation. *************************************************************************** CONTENTS *************************************************************************** Welcome to the NetWare Web Server 2 product! This document contains last-minute information that is not included in the documentation. It includes the following sections: Before You Install the Product Installing the Product Server requirements Installing on NetWare 4.1 SMP NetWare Language Support Reinstalling the Software Running the GUI Workstation Requirements NDS Login Using the Network Button Configuring the Product Setting the NetWare Rights Checking the SYS:ETC\RESOLV.CFG File Adding New Icons Perl Interpreter Limitations Running the Product with Other Software Compatibility With the FTP NLM SFT III Support DBCS Compatibility Using DynaText Do I Need to Install the Online Documentation? Installing the DynaText Online Document Viewer Installing the WordPerfect Internet Publisher Corrections to the Online Help ============================== Before You Install the Product ============================== By default, NetWare 4.1 sets the maximum number of packet receive buffers to 100. This number is not adequate for the NetWare Web Server. Before you install the product, increase the maximum number of packet receive buffers to 1000 by entering the following command at the server console prompt: set maximum packet receive buffers=1000 To ensure that the packet receive buffers are set appropriately when the server is restarted, you should also add this command to the SYS:SYSTEM\AUTOEXEC.NCF file. ====================== Installing the Product ====================== Server Requirements ================================================ • CPU: Intel Pentium-, 80486-, 80386-based PC (80486 or higher recommended). • File Storage: Hard disk with minimum 2.5 MB available for the product software (not including storage for user-supplied hypertext documents). An additional 3.5 MB is required if you plan to install the online documentation. • Memory: 16 MB total RAM. • Network Operating System: NetWare 4.1 or later, NetWare 4.1 SMP, or NetWare 4.1 SFTIII. The TCPIP NLM must be configured and loaded. Installing on NetWare 4.1 SMP ============================= The NetWare Web Server installation utility automatically installs an SMP version of the Web NLM (HTTPSMP.NLM) to the SYS:SYSTEM directory. If you are running NetWare 4.1 SMP, you must manually unload the single-processor version of the Web server (HTTP.NLM) and load HTTPSMP.NLM. To do this, type the following commands at the server console prompt: unload http load httpsmp You will also want to edit the SYS:SYSTEM\UNISTART.NCF and SYS:SYSTEM\UNISTOP.NCF files so that they automatically load and unload HTTPSMP.NLM instead of HTTP.NLM. NetWare Language Support ======================== NetWare Web Server 2 only supports the English language. When you install NetWare Web Server 2 on a NetWare server with the LANGUAGE parameter set to French, Italian, German, or Spanish, the NetWare Web Server installation module will automatically load using English. There is no need for you to change the LANGUAGE parameter value. Reinstalling the Software ========================= If you reinstall the NetWare Web Server software, the installation program will overwrite the configuration files in the \WEB\CONFIG directory. Therefore, if you want to maintain your existing configuration, you must save the configuration files under another filename and then restore the files after you reinstall the software. ===================================================== Running the NetWare Web Server Administration Utility ===================================================== Workstation Requirements ======================== • CPU: Intel Pentium-, 80486-, or 80386-based PC. • File Storage: Hard disk with minimum 1 MB available. • Memory: At least 8 MB RAM. • Operating System: Windows 3.1, Windows for Workgroups 3.11, or Windows 95. • Network Protocols: NetWare client (VLM). WinSock 1.1 compliant TCP/IP stack. NDS Login ========= In order to restrict directory access to authenticated NDS users, you must be logged in to NDS before you launch the NetWare Web Server administration utility. If you are not logged in to NDS, the Network users list will be empty. Using the Network Button ======================== If you notice that the Network button does not work inside the NetWare Web Server administration utility, you may have an old COMMDLG.DLL in the C:\WINDOWS or C:\WINDOWS\SYSTEM directory. If you have a newer version of this DLL, you can simply delete the old version. If you only have the old version, you must delete the old COMMDLG.DLL and install a newer version to get the Network button to work. ======================= Configuring the Product ======================= Setting the NetWare Rights ========================== To maintain the security of your server, you should set the NetWare rights as follows: • Set the rights to the \CONFIG directory (SYS:WEB\CONFIG by default) so that the people responsible for administering the Web server are the only people with rights to this directory. • Set the rights to the scripts directories (SYS:WEB\SCRIPTS, SYS:WEB\SCRIPTS\PERL and any other script directories you create) so that only people responsible for writing, managing, or editing the scripts have rights to these directories. Checking the SYS:ETC\RESOLV.CFG File ==================================== If there is a SYS:ETC\RESOLV.CFG file on your server, the Web server will automatically try to query the DNS name servers listed in the file. If DNS is not used on your network or the RESOLV.CFG file is incorrect, you will notice delayed response times on your Web server. Therefore, if your server has a SYS:ETC\RESOLV.CFG file you should make sure that • DNS is used on your network • The SYS:ETC\RESOLV.CFG file syntax is correct • The DNS name servers listed in the file are up and running Adding New Icons ================ The NetWare Web Server includes default icons for use with the automatic directory indexing feature. You can map your own icons to specific filename extensions by adding the following directive to the SYS:WEB\CONFIG\SRM.CFG file: AddIcon /icons/name_of_icon_file .filename_extension You can add as many AddIcon directives as you want. You can also use this directive to change the icon that is displayed for files with a specific filename extension. ============================ Perl Interpreter Limitations ============================ The Perl Interpreter NLM has the following functional limitations: • The chmod function can only be used to set file permissions to 0x000 (read only) or 0x777 (read write). • The opendir and readdir functions are currently unsupported. ======================================= Running the Product with Other Software ======================================= Compatibility With the FTPSERV NLM ================================== The FTPSERV.NLM provided in the NetWare NFS Services, NetWare/IP, and NetWare UNIX Print Services products does not support requests from Web browsers. If you are running one of these products and would like to receive an updated FTPSERV.NLM that fixes this problem, contact your technical support representative. SFT III Support =============== This product is compatible with SFTIII. DBCS Compatibility ================== The NetWare Web Server can serve DBCS documents. However, the server will not perform any translation. Therefore, the function of RCGI extensions in DBCS environments is currently undefined. ============== Using DynaText ============== Do I Need to Install the Online Documentation? ============================================== The NetWare Web Server Extension Interface Guide documents the Remote Common Gateway Interface (RCGI). This is the interface that enables you to write custom scripts and NLMs to extend the functionality of the Web server. This guide is available both in DynaText format (included on the product CD) and in HTML (on the www.novell.com Web site). If you have a Web browser with Internet access, you can access this guide at http://occam.sjf.novell.com:8080/iamg.websvr20.english. Otherwise, you must install the online documentation on your server and then view it using the DynaText viewer (SYS:DOCVIEW\DTAPPWIN\DTEXTRW.EXE). Installing the DynaText Online Viewer ===================================== If you are installing the online documentation and the installation program detects that you already have the DynaText viewer installed, the installation program prompts you whether to overwrite the existing Dynatext viewer files. If you choose to overwrite the viewer files, you must ensure that there are no users accessing the viewer. If a user is accessing the viewer when the installation program tries to overwrite the files, the installation will fail. ============================================= Installing the WordPerfect Internet Publisher ============================================= The product CD includes a copy of the WordPerfect Internet Publisher and the Netscape Navigator browser that you can use to create and test your HTML documents. To use this product, you must have a registered copy of WordPerfect 6.1. This product is located in the \WPIP directory at the root of the product CD. For instructions on installing this product, refer to the \WPIP\README.TXT file. ============================== Corrections to the Online Help ============================== The correct syntax for restricting directory access to any user listed in a user database file is as follows: AuthType Basic AuthName any_name AuthUserFile filename require valid-user