World Wide Web security URLmerchant systemChat community system server navigator TCP/IP HTML Publishing PersonalAdministrator’s GuideInter iPlanet Web Server, Enterprise Edition ww Version 4.0 Proxy 806-2823-10 SSL September 1999 Mozilla We have changed the name of Netscape Enterprise Server to iPlanet Web Server, Enterprise Edition. The name change is not reflected in this document or in the software which is enclosed. IStore Publishing Internet secure sockets layer mail encryption HTMLhttp://www comp.syselectronic commerce JavaScript directory server news certificate Proxy Copyright © 1999 Sun Microsystems, Inc. Some preexisting portions Copyright © 1999 Netscape Communications Corp. All rights reserved. Sun, Sun Microsystems, the Sun Logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Netscape and the Netscape N logo are registered trademarks of Netscape Communications Corporation in the U.S. and other countries. Other Netscape logos, product names, and service names are also trademarks of Netscape Communications Corporation, which may be registered in other countries. Federal Acquisitions: Commercial Software — Government Users Subject to Standard License Terms and Conditions The product described in this document is distributed under licenses restricting its use, copying, distribution, and decompilation. No part of the product or this document may be reproduced in any form by any means without prior written authorization of the Sun-Netscape Alliance and its licensors, if any. THIS DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Netscape, Netscape Navigator, Netscape Certificate Server, Netscape DevEdge, Netscape FastTrack Server, Netscape ONE, SuiteSpot, and the Netscape N and Ship’s Wheel logos are registered trademarks of Netscape Communications Corporation in the United States and other countries. Other Netscape logos, product names, and service names are also trademarks of Netscape Communications Corporation, which may be registered in other countries. Other product and brand names are trademarks of their respective owners. The downloading, exporting, or reexporting of Netscape software or any underlying information or technology must be in full compliance with all United States and other applicable laws and regulations. Any provision of Netscape software or documentation to the U.S. Government is with restricted rights as described in the license agreement accompanying Netscape software. Recycled and Recyclable Paper Documentation Team: Jocelyn Becker, Rober t Fish, Ann Hillesland, Sanborn Hodges, Amanda Lee, Laila Millar, and Alan Morgenegg Version 4.0 Printed in the United States of America. 00 99 98 5 4 3 2 1 Contents About This Guide ...........................................................................................27 What’s In This Guide? ..........................................................................................27 How This Guide Is Organized ............................................................................28 Server Basics ....................................................................................................28 Using Enterprise Administration Server .........................................................28 Configuring and Monitoring ...........................................................................29 Using Programs and Objects ..........................................................................30 Managing Content and Access .......................................................................30 Appendixes ......................................................................................................30 Conventions Used In This Guide ........................................................................31 Using the Enterprise Server Documentation ......................................................31 Further Reading ...................................................................................................34 Contacting Technical Support .............................................................................34 Part 1 Server Basics Chapter 1 Introduction to Enterprise Server .....................................37 Netscape Enterprise Server .................................................................................37 Enterprise Server Features ..............................................................................38 Administering and Managing Enterprise Servers ...........................................39 Netscape Enterprise Server Architecture ............................................................40 Content Engines ..............................................................................................41 Server Extensions ............................................................................................41 Runtime Environments ....................................................................................42 Application Services ........................................................................................42 How Enterprise Server is Configured .................................................................43 Enterprise Server Component Options ..........................................................43 Enterprise Server Configuration Files .............................................................44 Single-Server Configuration ............................................................................45 All Platforms ...............................................................................................45 Contents iii Unix-Only Platforms .................................................................................. 48 Multiple-Server Configuration ........................................................................ 49 Enterprise Administration Server ........................................................................ 49 Server Manager .................................................................................................... 50 Accessing the Server Manager ....................................................................... 50 Using the Resource Picker ............................................................................. 52 Wildcards Used in the Resource Picker ........................................................ 52 Netscape Console ................................................................................................ 54 Sending Error Information to Netscape ............................................................. 56 Details on Data Collected by the Quality Feedback Agent ......................... 56 Using the Quality Feedback Agent ................................................................ 57 Editing master.ini ....................................................................................... 58 Editing magnus.conf .................................................................................. 58 Chapter 2 Administering Enterprise Servers ..................................... 61 Accessing Enterprise Administration Server ...................................................... 61 Unix Platforms ................................................................................................ 62 Windows NT Platforms .................................................................................. 62 Adding a Server: Running Multiple Servers ....................................................... 64 Hardware Virtual Servers ............................................................................... 64 Software Virtual Servers ................................................................................. 64 Multiple Server Instances ............................................................................... 65 Installing Multiple Instances of the Server ......................................................... 65 Removing a Server .............................................................................................. 66 Migrating a Server From a Previous Version ..................................................... 67 Part 2 Using Enterprise Administration Server Chapter 3 Setting Administration Preferences ................................. 71 Shutting Down Enterprise Administration Server .............................................. 72 Changing Network Settings ................................................................................ 72 Changing the User Account and Password ................................................... 73 Changing the Port Number ............................................................................ 73 Changing the Superuser Settings ........................................................................ 73 Enabling Distributed Administration .................................................................. 75 iv Netscape Enterprise Server Administrator’s Guide Configuring Secure Sockets Layer (SSL) ............................................................ 76 Activating SSL ..................................................................................................77 Setting Encryption Preferences ...................................................................... 77 Setting Stronger Ciphers ...........................................................................