|
||
|
|
Chapter 1 Introduction to Enterprise Server
This chapter introduces Netscape Enterprise Server and discusses some of the fundamental server concepts. Read it to obtain an overview of how Enterprise Server works.
This chapter includes the following sections:
- Enterprise Server
![]()
- Enterprise Server Architecture
![]()
- Enterprise Server Configuration
![]()
- Administration Server
![]()
- Server Manager
![]()
- Class Manager
![]()
- Virtual Server Manager
![]()
Enterprise Server 6.1 is a multi-process, multi-threaded, secure web server built on open standards. It provides high performance, reliability, scalability, and manageability for any size enterprise.
This section includes the following topics:
Enterprise Server is primarily designed to provide access to your business HTML files. In addition, it offers the following features:
- Enterprise-wide manageabilityIncluding delegated administration, cluster management, and LDAP (Lightweight Directory Access Protocol) support. LDAP integration with Directory Server enables you to store users and groups in a centralized directory. In addition, you can monitor your server in real-time by using the Simple Network Management Protocol (SNMP). SNMP is a protocol used to exchange data about network activity.
![]()
- Note that in order to add users and groups to Enterprise Server, you must have a directory server installed, such as Directory Server. See the Netscape Enterprise Server Installation and Migration Guide for more information.
- Security Users can establish encrypted and authenticated transactions between clients and the server through the Secure Sockets Layer (SSL) 3.0 protocol. In addition, Enterprise Server employs the following security-based standards: Public Key Cryptography Standard (PKCS) #11, which defines the interface used for communication between SSL and PKCS #11 modules; Federal Information Processing Standards (FIPS)-140; and special certificates that work with 56, 128, or 168 bits, depending on the capability of the client.
![]()
- Access controlYou can protect confidential files or directories by implementing access control (viewing or editing) by user name, password, domain name, IP address, and user certificates. This feature also represents another aspect of the NSAPI Content Management plug-in, which enables an end user (the owner of a document) to set access control on a document, rather than having to ask the administrator to accomplish the task.
![]()
- High performanceDelivers high performance for dynamic and secure content with features such as HTTP1.1, multi-threading, and support for SSL hardware accelerators.
![]()
- Standards-based Enterprise Server includes support for a wide range of web software standards, including: JDK 1.2; Servlet 2.3; JavaServer PagesTM 1.2; HTTP 1.1; and various security-based standards, including PKCS #11, FIPS-140, and 168-bit step-up certificates.
![]()
- Server-side Java Servlet and JavaServer Pages supportenables development of dynamic content, presentation logic, and JDBC database access.
![]()
- Additional featuresSupport for multiple processes and process monitors, failover, automatic recovery, and dynamic log rotation.
![]()
Administering and Managing Enterprise Servers
You can manage your Enterprise Server(s) via the following user interfaces:
In previous releases, the Enterprise Server and other Netscape servers were administered by a single server, called the Administration Server. In a previous release, the "administration server" became simply an additional instance of the Enterprise Server, called Enterprise Server Administration Server, or Administration Server. You use the Administration Server to administer all of your Enterprise Server instances. For more information, see "Administration Server"
.
You can also perform administrative tasks manually by editing the configuration files or by using command-line utilities.
For managing individual instances of Enterprise Server, you can use the Server Manager. For more information, see "Server Manager".
To manage virtual servers, use the Class Manager. For more information, see "Virtual Server Configuration".
Enterprise Server Architecture
Enterprise Server incorporates a modular architecture that integrates seamlessly with all of the products in the Netscape family of servers. In addition, Enterprise Server includes an administration server interface for coordinating administrative functions across all of your web servers. Note that this administrative interface is itself another instance of Enterprise Server.
Enterprise Server includes the following software modules:
These server modules are described in the following sections.
Enterprise Server content engines are designed for manipulating customer data. The following content engines make up the content layer of the Enterprise Server architecture:
- The HTTP (Web Server) engine represents the core of the Enterprise Server. From a functional perspective, the rest of the Enterprise Server architecture resides on top of this engine for performance and integration functionality.
![]()
- The Content Management engine enables you to manage your server's content. You create and store HTML pages, JavaServer Pages, and other files such as graphics, text, sound, or video on your server. When clients connect to your server, they can view your files provided they have access to them.
![]()
The Enterprise Server extensions enable you to extend or replace the function of the server to better suit your business operations. The following server extensions are part of the core Enterprise Server architecture:
- Common Gateway Interface (CGI)
![]()
- Netscape Server Application Programming Interface (NSAPI)
![]()
- Java Servlets and JavaServer Pages
![]()
Common Gateway Interface (CGI) is a stand-alone application development interface that enables you to create programs that process your client requests dynamically.
Netscape Server Application Programming Interface (NSAPI) is used to implement the functions the server calls when processing a request (Server Application Functions) which provide the core and extended functionality of the Enterprise Server. It allows the server's processing of requests to be divided into small steps which may be arranged in a variety of ways for speed and flexible configuration.
Java Servlets and JavaServer Pages extensions enable all Java servlet and JavaServer page meta-functions, including instantiation, initialization, destruction, access from other components, and configuration management. Java servlets and JavaServer pages are reusable Java applications that run on a web server rather than in a web browser.
In addition to the various server extensions, Enterprise Server includes a set of runtime environments which support the server extensions. These runtime environments include the following:
Finally, the Enterprise Server architecture includes a set of application services for various application-specific functions. These application services include the following:
Enterprise Server Configuration
Enterprise Server is configured to enable you to turn on or off various features, determine how to respond to individual client requests, and write programs that run on and interact with the server's operation. The instructions (called directives) which identify these options are stored in configuration files. Enterprise Server reads the configuration files on startup and during client requests to map your choices with the desired server activity. For more information about these files, see "Enterprise Server Configuration Files".
The server includes a number configuration files which are stored in server_root
/https-server_id/configand server_root/https-admserv/configwhen installed on your computer.This section includes the following topics:
- Enterprise Server Component Options
![]()
- Enterprise Server Configuration Files
![]()
- Single-Server Configuration
![]()
- Multiple-Server Configuration
![]()
Enterprise Server Component Options
The following component options are available when you install Enterprise Server:
Enterprise Server Configuration Files
Enterprise Server includes a variety of configuration files that enable you to set various global variables, and to customize how the server responds to specific events and client requests. You can modify the configuration files automatically using the Administrator Server, Server Manager, and Class Manager user interface, or by editing the files directly using a text editor.
The main Enterprise Server configuration files are:
magnus.conf,obj.conf,mime.types, andserver.xml.These configuration files are described in this section.
There are a number of configuration files Enterprise Server uses when your server is set up as part of a cluster of Enterprise Servers (these files include a .
clfilterfile extension). For more information regarding how you can configure a cluster of Enterprise Server, including important guidelines, see "About Clusters".
magnus.conf: contains global server configuration information (such as security and default language selection). This file sets the values for variables that configure the server during initialization. Enterprise Server reads this file and executes the variable settings on startup. The server does not read this file again until it is restarted, so you must restart the server every time you make changes to this file.
For more information, see the Netscape Enterprise Server NSAPI Programmer's Guide.
obj.conf: object configuration file. There is one
obj.conffile for each virtual server class, or grouping of virtual servers. Whenever this guide refers to "theobj.conffile," it refers to allobj.conffiles or to theobj.conffile for the virtual server class being described. All theobj.conffiles are located in server_root/server_id/config. They are typically named vsclass.obj.conf, where vsclass is the virtual server class name.The
obj.conffile contains settings for server customization, and instructions that the server uses to process requests from clients (such as browsers). Each virtual server references this information every time it processes a client request.For more information about the actual file syntax and the specific directives used by the
obj.confandmagnus.confconfiguration files, see the Netscape Enterprise Server NSAPI Programmer's Guide.server.xml: configures the addresses and ports that the server listens on and assigns virtual server classes and virtual servers to these listen sockets. For more information, see the Netscape Enterprise Server NSAPI Programmer's Guide.
mime.types: the MIME (Multi-purpose Internet Mail Extension) type configuration file. This file maps file extensions to MIME types, to enable the server to determine the type of content being requested. For example, requests for resources with .
htmlextensions indicate that the client is requesting an HTML file, while requests for resources with.gifextensions indicate that the client is requesting an image file in GIF format.For more information, see "Specifying a Default MIME Type".
Dynamic reconfiguration allows you to make configuration changes to a live web server without having to stop and restart the web server for the changes to take effect. You can dynamically change all configuration settings and attributes in
server.xmland its associated files without restarting the server.To access the dynamic reconfiguration screen and install a new configuration dynamically, click the Apply link found in the upper right corner of the Server Manager, Class Manager, and Virtual Server Manager pages, then click the Load Configuration Files button on the Apply Changes page. If there are errors in installing the new configuration, the previous configuration is restored.
If you have installed Enterprise Server on a single server machine, the installation process places all the files under the server root directory that you specified during installation.
For all platforms, the following directories are created under the server root directory:
- alias contains the key and certificate files for all Netscape servers (for example,
https-admserv-server_id-cert7.db andsecmod.db).![]()
- bin contains the binary files for the server, such as the actual server, the Administration Server forms, and so on. In addition, this directory includes the
https/installfolder that contains files needed for migrating server settings and default configuration files needed for backward compatibility.![]()
docs is the server's default primary document directory, where your server's content files are usually kept. If you are migrating settings from an existing server, this directory doesn't appear until you finish the migration process.![]()
- extras contains the log analyzer and log analysis tools.
![]()
- The
flexanlgdirectory contains a command-line log analyzer. This log analyzer analyzes files in flexlog format.![]()
- The
log_anlydirectory contains the log analysis tool that runs through the Server Manager. This log analyzer analyzes files in common log format only.![]()
- httpacl contains the files that store access control configuration information in the
generated.server-id.aclandgenwork.server-id.aclfiles. The filegenerated.server-id.aclcontains changes you make using the Server Manager access control forms after saving your changes;genwork.server-id.aclcontains your changes before you save your changes.![]()
https-admserv contains the directories for the Administration Server. This directory has the following subdirectories and files:![]()
- This directory contains shell scripts to start, stop, and restart the server, start JVM, and a script to rotate log files.
![]()
ClassCachecontains classes and Java files, generated as result of the compilation of JavaServer Pages.![]()
conf_bkcontains backup copies of the Administration Server's configuration files.![]()
configcontains the server's configuration files:admpw, admin.conf, cluster.xml, contexts.properties, cron.conf, dsgw.conf, dsgwfilter.conf, dsgw-language.conf, dsgw-orgperson.conf, dsgwserarchprefs.conf, jvm12.conf, magnus.conf, magnus.conf.clfilter, mime.types, ns-cron.conf, obj.conf, obj.conf.clfilter, server.dtd, servers.lst, server.xml, server.xml.clfilter,servlets.properties, ssl.xml, user-apps.xml, userclass.obj.conf, andweb-apps.xml.Working copies are kept here. For more information onmagnus.confandobj.conf, see the Netscape Enterprise Server NSAPI Programmer's Guide.![]()
logscontains any error or access log files.![]()
SessionDatacontains session database data fromMMapSessionManager.![]()
startsvr.batis the script that starts the Server Manager on Windows NT® and Windows® 2000 machines. The Server Manager lets you configure all servers installed in the server root directory.![]()
stopsvr.batis the script that stops the Server Manager on Windows NT and Windows 2000 machines.![]()
- https-server_id.domain are the directories for each server you have installed on the machine. Each server directory has the following subdirectories and files:
![]()
ClassCachecontains classes and Java files, generated as result of the compilation of JavaServer pages.![]()
conf_bkcontains backup copies of the server's configuration files.![]()
configcontains the server instance configuration files.![]()
logscontains the server instance log files.![]()
reconfigis the script used to reconfigure the server dynamically. If you make non-global changes to the server, you can use this script to reconfigure the server without stopping and starting it. Note that changes tomagnus.confrequire you to stop and restart the server.![]()
restartis the script that restarts the server.![]()
rotaterotates server log files without affecting users who may be connected to the server.![]()
SessionDatacontains session database data fromMMapSessionManager.![]()
startsvr.batis the script that starts the Server Manager. The Server Manager lets you configure all servers installed in the server root directory.![]()
stopsvr.batis the script that stops the Server Manager.![]()
- manual contains the online manuals for the product.
![]()
- plugins contains directories for Java and other plugins. This directory has the following subdirectories:
![]()
htaccesscontains server plugin for.htaccessaccess control andhtconvert, an.nsconfigto.htaccessconverter.![]()
digestcontains the Digest Authentication Plugin for Netscape Directory Server, as well as information about the plugin.![]()
samplescontains samples and example components, plugins and technologies supported by the Enterprise Server servlet engine. This includes binaries, all code, and a build enviroment.![]()
servletscontains information about and examples of web-apps applications.![]()
includecontains various include files.![]()
libcontains shared libraries.![]()
nsaclcontains information for your server's access control lists.![]()
loadbalcontains the required files for the Resonate load-balancer integration plugin.![]()
nsapicontains header files and example code for creating your own functions using NSAPI.![]()
snmpcontains information for your server's SNMP plugins.![]()
- setup contains the various Enterprise Server setup files, including
setup.loganduninstall.inf.![]()
- userdb contains user databases and related information.
![]()
- LICENSE.txt is the license file.
![]()
- README.txt is the readme file that contains a link to the Netscape Enterprise Server Release Notes.
![]()
In addition to the files and directories described in "All Platforms" the following files are created at the
server-rootdirectory for UNIX® and Linux® platforms:The following files are created under the server-root
/https-admservdirectory for UNIX and Linux platforms:
ClassCachecontains classes and Java files, generated as result of the compilation of JavaServer pages.![]()
conf_bkcontains backup copies of the server's configuration files.![]()
configcontains the Administration Server configuration files.![]()
logscontains the Administration Server log files.![]()
SessionDatacontains session database data fromMMapSessionManager.![]()
restartis the script that restarts the Server Manager.![]()
startis the script that starts the Server Manager. The Server Manager lets you configure all servers installed in the server root directory.![]()
stopis the script that stops the Server Manager.![]()
Virtual servers allow you, with a single installed server, to offer companies or individuals domain names, IP addresses, and some server administration capabilities. You can configure virtual servers using the Virtual tab of the Server Manager, as well as the Class Manager interface and the
server.xmlfile. The settings for virtual servers are stored in theserver.xmlfile, found in the server_root/https-server_id/configdirectory.For more information, see Chapter 11 "Using Virtual Servers."
You can have multiple web servers running on the same server machine. Multiple web servers can be configured from a single-server administration interface called the Administration Server.
The Administration Server is a web-based server that contains the Java forms you use to configure all of your Enterprise Servers.
After installing Enterprise Server, you use your browser to navigate to the Administration Server page and use its forms to configure your Enterprise Servers. When you submit the forms, the Administration Server modifies the configuration for the server you were administering.
The URL you use to navigate to the Administration Server page depends on the computer host name and the port number you choose for the Administration Server when you install Enterprise Server. For example, if you installed the Administration Server on port 1234, the URL would look like this:
http://myserver.example.com:1234
Before you can get to any forms, the Administration Server prompts you to authenticate yourself. This means you need to type a user name and password. You set up the "superuser" user name and password when you install Enterprise Server on your computer. After installation, you can use distributed administration to give multiple people access to different forms in the Administration Server. For more information about distributed administration, see "Allowing Multiple Administrators".
The first page you see when you access the Administration Server, is called Servers. You use the buttons on this page to manage, add, remove, and migrate your Enterprise Servers. The Administration Server provides the following tabs for your administration-level tasks:
- Servers
![]()
- Preferences
![]()
- Global Settings
![]()
- Users and Groups
![]()
- Security
![]()
- Cluster Mgmt (Cluster Management)
Enterprise Server requires a browser that supports frames and has JavaScript and cookies enabled.
![]()
For more information on using the Administration Server, including information regarding these administration-level tasks, see Chapter 2 "Administering Enterprise Servers."
The Server Manager is a web-based interface that contains the forms you use to configure individual instances of Enterprise Server.
You can access the Server Manager for Enterprise Server by performing the following steps:
- Install and start your Enterprise Server.
![]()
- The Administration Server displays the Servers page.
- In the Manage Servers area, select the desired server and click Manage.
![]()
You use the links on the Preferences page to manage options such as thread pool settings, and to turn the web server on and off.
In addition, the Server Manager provides the following tabs for additional Enterprise Server managerial tasks:
For more information, see the Server Manager in the online help.
Most of the Server Manager and Class Manager pages configure the entire Enterprise Server or an entire class. However, some pages can configure either the entire server (or class) or files and directories that the server (or class) maintains. These pages include the Resource Picker, shown in Figure 1-1, at the top.
The Resource Picker appears on a number of pages, including the Server Manager's Log Preferences page and most screens accessible from the Class Manager's Content Management tab.
To use the Resource Picker, choose a resource from the drop-down list for configuration. Click Browse to browse your primary document directory; clicking Options allows you to choose other directories. Click Wildcard to configure files with a specific extension.
Wildcards Used in the Resource Picker
In many parts of the server configuration, you specify wildcard patterns to represent one or more items to configure. Please note that the wildcards for access control may be different from those discussed in this section.
Wildcard patterns use special characters. If you want to use one of these characters without the special meaning, precede it with a backslash (\) character.
The Class Manager is a web-based interface that contains the Java forms you use to configure your virtual Enterprise Servers. The user interface for virtual servers has two parts, the Server Manager and the Class Manager. The Class Manager contains settings that affect a single class or single virtual server. You can set services for the class in the Class Manager, as well as add virtual servers (members of the class) and configure settings for an individual virtual server.
You can access the Class Manager for Enterprise Server by performing the following steps:
- From the Server Manager, click the Virtual Server Class tab.
![]()
- The Server Manager displays the Select a Class of Virtual Server page.
- From the drop-down list, select a virtual server class and click Manage.
![]()
- Enterprise Server displays the Class Manager's Select a Virtual Server page.
You can also access the Class Manager by simply clicking the Class Manager link in the upper right-hand corner of the browser window.
The Class Manager provides the following tabs to manage your Enterprise Server virtual servers:
For more information, see the Class Manager in the online help.
To access the Virtual Server Manager, go to the Virtual Servers tab in the Class Manager, then select a virtual server from the list on the Manager Virtual Servers page and click Manage, or click on the link to a virtual server under the tree view.
The pages provided in the Virtual Server Manager allow you to check the status and settings, set the Java web applications state to on, and generate reports for the selected virtual server.
The Virtual server Manager provides the following tabs to manage your Enterprise Server virtual servers:
© 2001 Sun Microsystems, Inc. Portions copyright 1999, 2002 Netscape Communications Corporation. All rights reserved.
Last Updated August 02, 2002