Sun Microsystems Netscape Enterprise Server Service manual

comp.sys
TCP/IP
directory server
World Wide Web
ww
Personal
IStore
Proxy
merchant system
HTML
http://www
Internet
server
security
news
URL
HTML
mail
Inter
navigator
community system
electronic commerce
JavaScript Proxy
Mozilla
certificate
P
ublishing
Publishing
Chat
encryption
secure sockets layer
SSL
Administrator’s Guide
Netscape Enterprise Server
Version 4.0
806-2823-10
September 1999

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.
The Software includes encryption software from RSA Data Security, Inc. Copyright © 1994, 1995 RSA Data Security, Inc. All
rights reserved.
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
Recycled and Recyclable Paper

Contents iii
Contents
About This Guide ...........................................................................................21
What’s In This Guide? ..........................................................................................21
How This Guide Is Organized ............................................................................21
Part I: Server Basics ........................................................................................22
Part II: Using Enterprise Administration Server .............................................22
Part III: Configuring and Monitoring .............................................................23
Part IV: Using Programs and Objects .............................................................24
Part V: Managing Content and Access ...........................................................24
Appendixes ......................................................................................................24
Conventions Used In This Guide ........................................................................25
Using the Enterprise Server Documentation ......................................................26
Further Reading ...................................................................................................28
Contacting Technical Support .............................................................................29
Part 1 Server Basics
Chapter 1 Introduction to Enterprise Server .....................................33
Netscape Enterprise Server .................................................................................33
Enterprise Server Features ..............................................................................34
Administering and Managing Enterprise Servers ...........................................35
Netscape Enterprise Server Architecture ............................................................36
Content Engines ..............................................................................................37
Server Extensions ............................................................................................37
Runtime Environments ....................................................................................38
Application Services ........................................................................................38
How Enterprise Server is Configured .................................................................39
Enterprise Server Component Options ..........................................................39
Enterprise Server Configuration Files .............................................................40
Single-Server Configuration ............................................................................41
All Platforms ...............................................................................................41

iv Netscape Enterprise Server Administrator’s Guide
Unix-Only Platforms .................................................................................. 44
Multiple-Server Configuration ........................................................................ 45
Enterprise Administration Server ........................................................................ 45
Server Manager .................................................................................................... 46
Accessing the Server Manager ....................................................................... 47
Using the Resource Picker ............................................................................. 48
Wildcards Used in the Resource Picker ........................................................ 49
Netscape Console ................................................................................................ 50
Sending Error Information to Netscape ............................................................. 52
Details on Data Collected by the Quality Feedback Agent ......................... 52
Using the Quality Feedback Agent ................................................................ 53
Editing master.ini ....................................................................................... 54
Editing magnus.conf .................................................................................. 54
Chapter 2 Administering Enterprise Servers ..................................... 57
Accessing Enterprise Administration Server ...................................................... 57
Unix Platforms ................................................................................................ 58
Windows NT Platforms .................................................................................. 58
Adding a Server: Running Multiple Servers ....................................................... 60
Hardware Virtual Servers ............................................................................... 60
Software Virtual Servers ................................................................................. 60
Multiple Server Instances ............................................................................... 61
Installing Multiple Instances of the Server ......................................................... 61
Removing a Server .............................................................................................. 62
Migrating a Server From a Previous Version ..................................................... 63
Part 2 Using Enterprise Administration Server
Chapter 3 Setting Administration Preferences ................................. 67
Shutting Down Enterprise Administration Server .............................................. 68
Changing Network Settings ................................................................................ 68
Changing the User Account and Password ................................................... 69
Changing the Port Number ............................................................................ 69
Changing the Superuser Settings ........................................................................ 70
Enabling Distributed Administration .................................................................. 71

Contents v
Configuring Secure Sockets Layer (SSL) ............................................................73
Activating SSL ..................................................................................................73
Setting Encryption Preferences ......................................................................73
Setting Stronger Ciphers ............................................................................74
Specifying Log File Options ................................................................................75
Viewing the Access Log File ..........................................................................76
Viewing the Error Log File .............................................................................77
Archiving Log Files .........................................................................................77
Using Cron Controls (Unix Only) .............................................................78
Configuring Directory Services ...........................................................................79
Restricting Server Access .....................................................................................79
Chapter 4 Managing Users and Groups ...............................................81
About Users and Groups ....................................................................................82
Creating Users .....................................................................................................83
Guidelines for Creating User Entries .............................................................83
How to Create a New User Entry ..................................................................84
Directory Server User Entries .........................................................................84
Managing Users ...................................................................................................86
Finding User Information ...............................................................................86
Building Custom Search Queries ..............................................................87
Search Attribute Options ...........................................................................88
Search Type Options .................................................................................89
Editing User Information ................................................................................90
Managing a User’s Password ..........................................................................91
Managing User Licenses .................................................................................92
Renaming Users ..............................................................................................92
Removing Users ..............................................................................................93
Creating Groups ..................................................................................................93
Static Groups ...................................................................................................94
Guidelines for Creating Static Groups ......................................................94
To Create a Static Group ...........................................................................95
Dynamic Groups .............................................................................................95
How Enterprise Server 4.0 Implements Dynamic Groups .......................96

vi Netscape Enterprise Server Administrator’s Guide
Groups Can Be Static and Dynamic ......................................................... 97
Dynamic Group Impact on Server Performance ...................................... 97
Guidelines for Creating Dynamic Groups ................................................ 97
To Create a Dynamic Group ..................................................................... 99
Managing Groups ................................................................................................ 99
Finding Group Entries .................................................................................. 100
The “Find all groups whose” Field ......................................................... 101
Editing Group Attributes .............................................................................. 101
Adding Group Members .............................................................................. 102
Adding Groups to the Group Members List ............................................... 103
Removing Entries from the Group Members List ....................................... 104
Managing Owners ........................................................................................ 104
Managing See Alsos ...................................................................................... 105
Removing Groups ......................................................................................... 105
Renaming Groups ......................................................................................... 106
Creating Organizational Units .......................................................................... 106
Managing Organizational Units ........................................................................ 107
Finding Organizational Units ....................................................................... 107
The “Find all units whose” Field ............................................................. 108
Editing Organizational Unit Attributes ........................................................ 109
Renaming Organizational Units ................................................................... 109
Deleting Organizational Units ...................................................................... 110
Managing a Preferred Language List ................................................................ 110
Chapter 5 Working with Server Security .......................................... 113
About Enterprise Server Security ...................................................................... 114
Encryption ..................................................................................................... 114
FIPS-140 Compliance ............................................................................... 115
Certificates ..................................................................................................... 115
Client and Server Authentication ............................................................ 116
How Enterprise Server Uses Certificates to Authenticate Users ............ 116
128-Bit Step-Up Certificates ..................................................................... 117
Configuring Enterprise Server for SSL ......................................................... 117
Creating a New Server Instance ....................................................................... 118

Contents vii
Creating a Certificate Trust Database ............................................................... 119
Requesting a Certificate .................................................................................... 120
Required CA Information ............................................................................. 122
Installing and Managing Certificates ................................................................123
Managing Certificates ................................................................................... 126
Using Secure Sockets Layer (SSL) ..................................................................... 127
Activating SSL ................................................................................................ 128
Specifying Ciphers ........................................................................................ 128
Setting Security (SSL) Preferences ................................................................ 129
Adding a PKCS #11Module .......................................................................... 129
Guidelines for Installing a PKCS#11 Module .......................................... 130
To Import a PKCS#11 Module ................................................................. 131
Using SSL Configuration File Directives ...................................................... 131
Security ..................................................................................................... 131
SSL2 ........................................................................................................... 132
SSL3 ........................................................................................................... 132
Ciphers ...................................................................................................... 132
SSL3Ciphers .............................................................................................. 133
SSL3SessionTimeout ................................................................................. 133
SSLCacheEntries ....................................................................................... 133
SSLClientAuth ........................................................................................... 133
SSLSessionTimeout ................................................................................... 133
Using Client Certificates .................................................................................... 134
Mapping Client Certificates to LDAP ...........................................................134
Using the certmap.conf File ......................................................................... 136
Creating Custom Properties ..................................................................... 139
Example Mappings .................................................................................. 139
Changing the Trust Database/Key Pair File Password .................................... 141
Migrating Enterprise Server 3.X Certificates ..................................................... 142
Additional Server Security Considerations ....................................................... 143
Limit Physical Access .................................................................................... 143
Limit Administration Access ......................................................................... 144
Choose Good Passwords ............................................................................. 144

viii Netscape Enterprise Server Administrator’s Guide
Guidelines for Creating Hard-to-Crack Passwords ................................. 144
Secure Your Key-Pair File ............................................................................ 145
Limit Other Applications on the Server ....................................................... 145
Prevent Clients from Caching SSL Files ....................................................... 146
Limit Ports ..................................................................................................... 146
Know Your Server’s Limits ........................................................................... 146
Consider Additional Measures for Unprotected Servers ............................. 147
Chapter 6 Managing Server Clusters ................................................... 149
About Clusters ................................................................................................... 149
Preliminary Guidelines for Using Server Clusters ........................................... 150
Setting up a Cluster ........................................................................................... 152
Adding a Server to the Server List .................................................................... 153
Modifying Cluster Information ......................................................................... 154
Removing Servers from a Cluster ..................................................................... 155
Managing Server Clusters ................................................................................. 155
Part 3 Configuring and Monitoring
Chapter 7 Configuring Server Preferences ....................................... 159
Starting and Stopping the Server ...................................................................... 160
Setting the Termination Timeout ................................................................. 160
Restarting the Server (Unix) ......................................................................... 161
Restarting With Inittab (Unix) ................................................................. 162
Restarting With the System RC Scripts (Unix) ........................................ 162
Restarting the Server Manually (Unix) .................................................... 162
Stopping the Server Manually (Unix) ..................................................... 163
Restarting the Server (Windows NT) ........................................................... 163
Using the Automatic Restart Utility (Windows NT) ............................... 165
Viewing Server Settings .................................................................................... 166
Configuring Network Settings .......................................................................... 167
Changing the Server’s Location (Unix) ........................................................ 167
Changing the Server’s User Account (Unix) ............................................... 167
Changing the Server’s User Account (Windows NT) ................................. 168
Changing the Server Name .......................................................................... 169

Contents ix
Changing the Server Port Number ............................................................... 169
Changing the Server Binding Address ......................................................... 170
Changing the Server’s MTA Host ................................................................. 170
Customizing Error Responses ........................................................................... 170
Working with Dynamic Configuration Files .................................................... 171
Using .htaccess Files ..................................................................................... 171
Activating .htaccess checking .................................................................. 171
Using .nsconfig Files ................................................................................ 175
Restricting Symbolic Links (Unix) .................................................................... 179
Using the Watchdog (uxwdog) Process (Unix) ............................................... 179
Chapter 8 Understanding Log Files ..................................................... 183
About Log Files ................................................................................................. 184
Viewing an Access Log File .............................................................................. 184
Viewing the Error Log File ................................................................................ 185
Monitoring the Server Using HTTP .................................................................. 186
Archiving Log Files ............................................................................................ 187
Internal-daemon Log Rotation ..................................................................... 188
Cron-based Log Rotation .............................................................................. 188
Setting Log Preferences .....................................................................................189
Easy Cookie Logging .................................................................................... 190
Relaxed Logging ........................................................................................... 190
Flushing the Log Buffer .................................................................................... 191
Running the Log Analyzer ................................................................................191
Using Performance Monitor (Windows NT) .................................................... 193
Viewing Events (Windows NT) ........................................................................ 195
Chapter 9 Using SNMP to Monitor Servers ....................................... 197
SNMP Basics ...................................................................................................... 198
SNMP Subagent ............................................................................................. 198
SNMP Master Agent ...................................................................................... 198
How SNMP Works ........................................................................................ 199
Netscape MIBs .............................................................................................. 200
The Enterprise Server MIB ...................................................................... 201
Types of SNMP Messages ............................................................................. 201

xNetscape Enterprise Server Administrator’s Guide
The Enterprise Server MIB ................................................................................ 202
Setting Up SNMP on a Netscape Server ........................................................... 205
Using a Proxy SNMP Agent (Unix) .................................................................. 207
Installing the Proxy SNMP Agent ................................................................. 208
Starting the Proxy SNMP Agent ................................................................... 208
Restarting the Native SNMP Daemon .......................................................... 209
Reconfiguring the SNMP Native Agent ............................................................ 209
Installing the SNMP Master Agent .................................................................... 209
Enabling and Starting the SNMP Master Agent ................................................ 211
Manually Configuring the SNMP Master Agent ........................................... 211
Editing the Master Agent CONFIG File ....................................................... 212
Defining sysContact and sysLocation Variables .......................................... 212
Configuring the SNMP Master Agent ........................................................... 213
Starting the SNMP Master Agent .................................................................. 214
Manually Starting the SNMP Master Agent ............................................. 214
Starting the SNMP Master Agent Using Enterprise Admin Server ......... 215
Configuring the SNMP Master Agent ............................................................... 215
Configuring the Community String .............................................................. 215
Configuring Trap Destinations ..................................................................... 216
Enabling the Subagent ...................................................................................... 216
Chapter 10 Configuring the Server for Performance ................... 219
About Server Performance ................................................................................ 220
Performance Issues ........................................................................................... 220
Unix Platform-Specific Issues ........................................................................... 221
Performance Buckets ........................................................................................ 222
Configuration ................................................................................................ 223
Performance Report ...................................................................................... 223
Miscellaneous magnus.conf Directives ............................................................ 225
Multi-process Mode ...................................................................................... 225
Accept Thread Information .......................................................................... 227
CGIStub Processes (Unix) ............................................................................ 227
Buffer Size ..................................................................................................... 228
Native Thread Pool Size ............................................................................... 229

Contents xi
About RqThrottle ............................................................................................... 229
The perfdump Utility ........................................................................................ 231
Sample Output .............................................................................................. 232
Using perfdump Statistics to Tune Your Server .............................................. 233
ListenSocket Information .............................................................................. 234
Address ..................................................................................................... 235
ActiveThreads ........................................................................................... 235
WaitingThreads ........................................................................................ 235
BusyThreads ............................................................................................. 235
Thread limits <min/max> ........................................................................ 236
KeepAlive Information ................................................................................. 236
AcceptTimeout ......................................................................................... 237
KeepAliveCount <KeepAliveCount/KeepAliveMaxCount> .................... 238
KeepAliveHits ........................................................................................... 238
KeepAliveFlushes ..................................................................................... 238
Cache Information ........................................................................................ 238
enabled ..................................................................................................... 239
CacheEntries <CurrentCacheEntries / MaxCacheEntries> ...................... 239
CacheSize <CurrentCacheSize / MaxCacheSize> ................................... 239
Hit Ratio <CacheHits / CacheLookups (Ratio)> ..................................... 239
pollInterval ............................................................................................... 240
maxFileSize ............................................................................................... 240
DNS Cache Information ........................................................................... 240
enabled ..................................................................................................... 240
CacheEntries <CurrentCacheEntries / MaxCacheEntries> ...................... 241
HitRatio <CacheHits / CacheLookups (Ratio)> ......................................241
Native Threads Pool ..................................................................................... 241
Idle/Peak/Limit ......................................................................................... 242
Work queue length/Limit ........................................................................ 243
Peak work queue length ......................................................................... 243
Work queue rejections ............................................................................. 243
PostThreadsEarly ...................................................................................... 243
Thread Pool Environmental Variables .................................................... 244

xii Netscape Enterprise Server Administrator’s Guide
Busy Functions ......................................................................................... 245
Asynchronous DNS Lookup (Unix) ............................................................. 245
enabled ..................................................................................................... 246
NameLookups .......................................................................................... 246
AddrLookups ............................................................................................ 247
LookupsInProgress .................................................................................. 247
File Cache in Enterprise Server 4.0 .................................................................. 247
File Cache Configuration .............................................................................. 247
FileCacheEnable ....................................................................................... 248
MaxAge ..................................................................................................... 248
MaxFiles .................................................................................................... 248
FlushInterval ............................................................................................. 248
SmallFileSizeLimit ..................................................................................... 248
SmallFileSpace .......................................................................................... 249
MediumFileSizeLimit (Unix) .................................................................... 249
MediumFileSpace ..................................................................................... 249
TransmitFile .............................................................................................. 249
File Cache Dynamic Control and Monitoring ............................................. 250
Cache-init ...................................................................................................... 251
File Cache Tuning ........................................................................................ 253
MaxFiles, SmallFileSpace, and MediumFileSpace .................................. 253
MaxAge ..................................................................................................... 254
FlushInterval ............................................................................................. 254
SmallFileSizeLimit ..................................................................................... 254
Improving Servlet Performance ........................................................................ 254
Thread Pools ................................................................................................. 255
Common Performance Problems ..................................................................... 256
Low-Memory Situations ................................................................................ 256
Under-Throttled Server ................................................................................. 256
Checking .................................................................................................. 256
Tuning ...................................................................................................... 257
Cache Not Utilized ....................................................................................... 257
Checking .................................................................................................. 257

Contents xiii
Tuning ...................................................................................................... 257
KeepAlive Connections Flushed .................................................................. 258
Checking ................................................................................................... 258
Tuning ...................................................................................................... 258
Log File Modes ............................................................................................. 258
Using Local Variables ................................................................................... 259
Benchmarking the Netscape Enterprise Server ............................................... 259
SPECweb96 Tuning ...................................................................................... 260
WebStone Tuning .................................................................................... 261
Sizing Issues ...................................................................................................... 262
Processors ..................................................................................................... 262
Memory ......................................................................................................... 263
Drive Space ................................................................................................... 263
Networking ................................................................................................... 263
Part 4 Using Programs and Objects
Chapter 11 Extending Your Server With Programs ...................... 267
Overview of Server-Side Programs .................................................................. 268
Types of Server-Side Applications That Run on the Server ....................... 268
How Server-Side Applications are Installed on the Server ......................... 269
Java Servlets and JavaServerPages (JSP) .......................................................... 269
Overview of Servlets and JavaServerPages ................................................. 270
What Does the Server Need to Run Servlets and JSP? ................................ 271
Enabling Servlets and JSP ............................................................................. 271
Making Servlets Available to Clients ............................................................ 272
Specifying Servlet Directories ...................................................................... 272
Configuring Global Attributes ...................................................................... 273
Configuring Servlet Attributes ...................................................................... 274
Configuring Servlet Virtual Path Translations ............................................. 275
Configuring JRE/JDK Paths .......................................................................... 276
Configuring JVM Attributes .......................................................................... 277
Deleting Version Files .................................................................................. 277
Installing CGI Programs .................................................................................... 278
Overview of CGI .......................................................................................... 279

xiv Netscape Enterprise Server Administrator’s Guide
Specifying a CGI Directory .......................................................................... 280
Specifying CGI as a File Type ..................................................................... 281
Downloading Executable Files .................................................................... 282
Installing Windows NT CGI Programs ............................................................. 282
Overview of Windows NT CGI Programs ................................................... 283
Specifying a Windows NT CGI Directory ................................................... 284
Specifying Windows NT CGI as a File Type ............................................... 285
Installing Shell CGI Programs for Windows NT .............................................. 286
Overview of Shell CGI Programs for Windows NT .................................... 286
Specifying a Shell CGI Directory (Windows NT) ....................................... 287
Specifying Shell CGI as a File Type (Windows NT) ................................... 288
Using the Query Handler ................................................................................. 289
Server-Side JavaScript Programs ....................................................................... 290
Activating Server-Side JavaScript ................................................................. 290
Running the Application Manager ............................................................... 291
Securing the Application Manager .............................................................. 293
Installing Server-Side JavaScript Applications ............................................. 294
Application URLs .......................................................................................... 297
Controlling Access to a Server-Side JavaScript Application ....................... 298
Modifying Installation Parameters ............................................................... 298
Removing a Server-Side JavaScript Application .......................................... 299
Starting, Stopping, and Restarting a Server-Side JavaScript Application ... 299
Running a Server-Side JavaScript Application ............................................. 300
Configuring Default Settings ........................................................................ 300
Enabling WAI Services ...................................................................................... 301
Chapter 12 Working With Configuration Styles ............................. 303
Creating a Configuration Style .......................................................................... 304
Removing a Configuration Style ....................................................................... 306
Editing a Configuration Style ............................................................................ 307
Assigning a Configuration Style ....................................................................... 307
Listing Configuration Style Assignments .......................................................... 308

Contents xv
Part 5 Managing Content and Access
Chapter 13 Managing Server Content ................................................. 311
Changing the Primary Document Directory .................................................... 312
Setting Additional Document Directories ........................................................ 312
Customizing User Public Information Directories (Unix) ............................... 313
Enabling Remote File Manipulation ................................................................. 315
Configuring Document Preferences ................................................................. 315
Entering an Index Filename ......................................................................... 316
Selecting Directory Indexing ........................................................................ 316
Specifying a Server Home Page ................................................................... 317
Specifying a Default MIME Type ................................................................. 317
Parsing the Accept Language Header .......................................................... 318
Setting Up Hardware Virtual Servers ................................................................ 318
Setting Up Hardware Virtual Servers for ISPs .................................................. 319
Migrating Hardware Virtual Server Configuration Files .............................. 321
Setting up Software Virtual Servers .................................................................. 322
Changing the Character Set .............................................................................. 323
Chapter 14 Controlling Access to Your Server ................................ 325
What Is Access Control? .................................................................................... 326
User-Group Authentication .......................................................................... 327
Username and Password Authentication ................................................ 327
Client Certificate Authentication .............................................................. 328
Host-IP Authentication ................................................................................. 330
Access Control Files ...................................................................................... 331
How Does Access Control Work? .................................................................... 331
Restricting Access to Your Web Site ................................................................334
Setting Access Control Actions ..................................................................... 339
Specifying Users and Groups ....................................................................... 340
Specifying Host Names and IP Addresses ................................................... 342
Setting Access Rights .................................................................................... 343
Access to Programs .......................................................................................344
Writing Customized Expressions ................................................................. 346
Selecting “Access control on” ......................................................................346

xvi Netscape Enterprise Server Administrator’s Guide
Responding When Access is Denied ........................................................... 347
Access Control Examples .................................................................................. 348
Restricting Access to the Entire Server ........................................................ 348
Restricting Access to a Directory (Path) ...................................................... 350
Restricting Access to a URI (Path) ............................................................... 352
Restricting Access to a File Type ................................................................. 354
Restricting Access Based on Time of Day ................................................... 356
Access Control For Web Publishing ................................................................. 357
Ownership of Files and Folders .................................................................. 358
Chapter 15 Configuring Web Publishing .......................................... 359
Using Netshare .................................................................................................. 360
Setting Up the Server and Creating Netshare Home Directories ............... 361
Before You Start ........................................................................................... 361
Server Features That Must Be Enabled ................................................... 361
Netshare Directory Naming Conventions ............................................... 362
The Netshare Configuration File ............................................................. 362
Marking Users As Licensed ..................................................................... 363
Access Control For Netshare ................................................................... 364
Using the Server Manager ............................................................................ 364
The Set Up Netshare Page ....................................................................... 365
The Create Netshare Page ....................................................................... 365
Using the Netshare Command-line Utility ................................................... 367
Syntax of the Netshare Utility ................................................................. 368
Netshare Utility Examples ....................................................................... 369
Accessing the Web Publisher Home Page .................................................. 370
Setting Access Control For Web Publisher Owners ........................................ 371
Indexing and Updating Properties ................................................................... 372
Changing the Web Publishing State ................................................................. 375
Maintaining Web Publishing Data .................................................................... 376
Unlocking Files ................................................................................................. 378
Adding Custom Properties ................................................................................ 379
Managing Properties ......................................................................................... 381
Customizing Your Netshare Home Page ......................................................... 382

Contents xvii
Customizing the Web Publisher User Interface ............................................... 382
The Web Publisher Attributes ................................................................. 383
The Web Publisher Pattern Files ............................................................. 385
Pointing Pattern Variables ....................................................................... 386
Conditional Variables ............................................................................... 387
Chapter 16 Using Search ......................................................................... 391
About Search ..................................................................................................... 391
Configuring Text Search ................................................................................... 392
Controlling Search Access ............................................................................ 393
Mapping URLs ............................................................................................... 393
Deciding Which Words Not to Search ........................................................ 395
Turning Search On or Off ............................................................................ 396
Configuring the Search Parameters .............................................................396
Configuring Your Pattern Files .................................................................... 398
Configuring Manually ................................................................................... 400
The Configuration Files ........................................................................... 400
Adjusting the Maximum Number of Attributes ....................................... 401
Restricting Memory for Indexing .............................................................402
Restricting Your Index File Size .............................................................. 402
Removing Access to the Web Publishing Collection ............................. 402
Indexing Your Documents ............................................................................... 403
About Collections ......................................................................................... 403
About Collection Attributes .......................................................................... 404
Installing Filters ............................................................................................. 406
Creating a New Collection ........................................................................... 407
Configuring a Collection .............................................................................. 410
Updating a Collection ................................................................................... 411
Maintaining a Collection .............................................................................. 413
Scheduling Regular Maintenance ................................................................. 414
Unscheduling Collection Maintenance ........................................................ 416
Performing a Search: The Basics ...................................................................... 417
Search Home Page ....................................................................................... 417
A Search Query ............................................................................................. 417

xviii Netscape Enterprise Server Administrator’s Guide
Guided Search .............................................................................................. 418
Advanced Search .......................................................................................... 420
The Search Results ....................................................................................... 421
Listing Matched Documents .................................................................... 422
Sorting the Results ................................................................................... 422
Displaying a Highlighted Document ...................................................... 423
Displaying Collection Contents ................................................................... 424
Using the Query Operators .............................................................................. 424
Default Assumptions .................................................................................... 425
Search Rules .................................................................................................. 426
Angle Brackets ......................................................................................... 426
Combining Operators .............................................................................. 426
Using Query Operators as Search Words ............................................... 426
Canceling Stemming ................................................................................ 426
Modifying Operators ................................................................................ 427
Determining Which Operators To Use ........................................................ 427
Using Wildcards ............................................................................................ 431
Non-alphanumeric Characters ................................................................. 433
Wildcards as Literals ................................................................................ 433
Customizing the Search Interface ..................................................................... 434
Dynamically Generated Headers and Footers ............................................ 434
HTML Pattern Files ....................................................................................... 435
Search Function Syntax ................................................................................ 437
URL Encodings ......................................................................................... 438
Required Search Arguments .................................................................... 439
Using Pattern Variables ................................................................................ 439
User-defined Pattern Variables ................................................................ 440
Configuration File Variables .................................................................... 441
Macros and Generated Pattern Variables ............................................... 444
Appendixes
Appendix A HyperText Transfer Protocol ........................................ 449
About HyperText Transfer Protocol (HTTP) ................................................... 449
Requests ............................................................................................................. 450

Contents xix
Request Method ............................................................................................ 450
Request Header ............................................................................................ 451
Request Data ................................................................................................. 451
Responses .......................................................................................................... 451
Status Code ................................................................................................... 452
Response Header .......................................................................................... 453
Response Data .............................................................................................. 453
Appendix B ACL File Syntax ................................................................... 455
ACL File Syntax ................................................................................................. 456
Authentication Statements ............................................................................ 457
Authorization Statements .............................................................................. 458
Hierarchy of Authorization Statements ................................................... 458
Attribute Expressions ............................................................................... 459
Operators For Expressions ...................................................................... 460
The Default ACL File .................................................................................... 461
General Syntax Items ............................................................................... 462
Referencing ACL Files in obj.conf .................................................................... 462
Appendix C Internationalized Enterprise Server ........................... 465
General Information .......................................................................................... 465
Installing the Server ...................................................................................... 466
Entering 8-bit Text ........................................................................................ 466
File or Directory Names ...........................................................................466
LDAP Users and Groups .......................................................................... 466
Using the Accept Language Header ............................................................ 467
Language Settings in Configuration Files .................................................... 468
Server-side JavaScript Information ................................................................... 469
Specifying the Character Set for the Compiler ............................................ 469
Specifying the Character Set With the <META> Tag .................................. 471
Using Server-side Javascript With Oracle’s Japanese Database ................. 471
Installing Oracle and Setting Up Your Environment ............................. 471
Verifying the Connection ......................................................................... 472
Verifying the Language Setup ................................................................. 473
Putting the Oracle Client and Database Server On Separate Hosts ...... 473

xx Netscape Enterprise Server Administrator’s Guide
Search Information ............................................................................................ 474
International Search and Auto Catalog ........................................................ 475
Searching in Chinese, Japanese, and Korean ............................................. 475
Query Operators ...................................................................................... 475
Document Formats .................................................................................. 476
Searching in Japanese .............................................................................. 476
Getting Support for Accented Characters in Filenames .................................. 477
Appendix D Server Extensions for Microsoft FrontPage ............ 479
Overview ........................................................................................................... 479
Types of FrontPage Webs ............................................................................ 480
Domain Names And Frontpage Webs ......................................................... 481
Security Issues .............................................................................................. 481
Downloading the Extensions ........................................................................... 482
Getting Ready for Installation ...................................................................... 483
Space Requirements ................................................................................. 483
Preliminary Tasks ..................................................................................... 483
Some Additional Considerations ............................................................. 484
Installing FrontPage Server Extensions ............................................................ 484
Installing FrontPage Server Extensions on Windows NT Systems ............. 484
Installing FrontPage97 Server Extensions on Unix Systems ....................... 488
Installing FrontPage98 Server Extensions on Unix Systems ....................... 492
Further Information ........................................................................................... 494
Glossary .......................................................................................................... 495
Index ................................................................................................................ 505