Contents


Preface

Using the Documentation
About This Guide
How This Guide Is Organized

Part I: Getting Started
Part II: Administering a Single iPlanet Application Server
Part III: Administering Multiple iPlanet Application Servers

Documentation Conventions

Part 1 Getting Started

Chapter 1 Performing Basic Tasks with the Administration Tool

About iPlanet Application Server Administration Tool
Starting the Administration Tool
Registering an iPlanet Application Server
Unregistering a Server
Starting iPlanet Application Server From the Administration Tool
Setting EJB Container Parameters for Run Time
Using the iPlanet Registry Editor
Updating the Installation Key
Changing the IP Address

Part 2 Administering a Single iPlanet Application Server

Chapter 2 Deploying and Upgrading Applications

Deploying a J2EE Application Using the Deployment Tool

Specifying Application Directories
Starting the Deployment Tool

About Packaging Application Components for Deployment
About J2EE Modules

Web Application Modules
Creating a Web Application Module
EJB-JAR Modules
Creating an EJB-JAR Module
Preparing an Enterprise Java Bean for Deployment

Editing Web Application Deployment Descriptor Files

Editing Descriptors for Individual Web Application Components

General Attributes (Servlets)
iAS Attributes (Servlets)
Initialization Parameters (Servlets)
Security Role References (Servlets)
Cache (Servlets)

Editing Descriptors for the Web Application

General (Web Application)
iAS Session (Web Application)
NLS (Web Application)
Login (Web Application)
Servlet Mapping (Web Application)
Context (Web Application)
Environment (Web Application)
EJB References (Web Application)
Resource References (Web Application)
MIME Types (Web Application)
Security (Web Application)
Security Roles (Web Application)
JSP Tag Libraries (Web Application)
Errors (Web Application)

Editing EJB-JAR Deployment Descriptor Files

General (EJBs)
iAS-Specific (EJBs)
Transactions (EJBs)
Environment (EJBs)
EJB References (EJB)
Resource References (EJBs)
Security Roles (EJBs)
Security Role References (EJBs)
Method Permissions (EJBs)
Lightweight CMP (EJBs)

About Creating an Application .ear File

Creating an Application .ear File
Linking References

Saving Archive Files
Managing Archive Files
Deploying an Application/Module
Enabling EJB Support for Rich Clients
Upgrading an Application
Deploying an Application Manually

Chapter 3 Monitoring Server Activity

Monitoring iPlanet Application Server

Monitoring Process Attributes
Logging Process Data to a File
Changing a Process Data Plot
Removing a Process Data Plot

Receiving Event Notification

About Events

What Do I Do When a Server Goes Down?
What Do I Do When Restarts Are Exceeded?
What Do I Do When an Abnormal Cluster is Detected?

Configuring Email Notification for an Event
Specifying an Event-Invoked Script

Chapter 4 Configuring SNMP to Monitor iAS with Third-Party Tools

About SNMP
Enabling SNMP Statistics Collection on iAS
About the Management Information Base (MIB)

Formatting MIB Entries
Making iAS MIB Available on SNMP Third-Party Management Software

Setting Up the Master Agent and SubAgents

Starting the SNMP Master Agent
Verifying SNMP Configuration

Chapter 5 Logging Server Messages

About the Logging Service

Determining Types of Messages to Log

Logging Application Messages
How Log Messages Are Formatted

Determining the Logging Destination

Logging to a Database
Logging to a File
Rotating Log Files

About Web Server Requests

How Web Requests Are Logged
Logging Web Server Requests

About DSync Logging Options

How DSync Messages Are Logged

Format of the Cluster Dump Files
Format of the DSync Node Dump Files

Logging DSync Messages

Chapter 6 Securing Applications

About Security

Limitations of This Document
What Is LDAP?
What Is Netscape Console?

Storing and Managing Users and Groups

Implementing Security

Authorization for J2EE Applications
Authorization for C++ Applications

Using Netscape Console to Add Entries to Directory Server

What Is a Distinguished Name (DN)?
Creating User Entries Using Netscape Console
Creating Group Entries Using Netscape Console
Modifying Database Entries Using Netscape Console

Using LDIF to Add Entries to Directory Server

Formatting LDIF Entries
Modifying Database Entries Using ldapmodify

Creating Entries Programmatically

Setting Authorization to Access Application Components

Setting Role-Based Authorization (for J2EE Applications)

Managing Roles for EJBs and Servlets

Setting Access Control List Authorization (for C++ Applications)

Creating an Access Control List
Modifying an Access Control List

Chapter 7 Increasing Fault Tolerance and Server Resources

About Adding and Tuning Server Processes
Adding and Tuning Java and C++ Processes

Adding a CXS Process

Adjusting the Number of Threads for a Process
Specifying the Number of Requests for the Queue
Setting Options of the Administrative Server

Adjusting the Restart Option of the Administrative Server
Setting JSP Caching
Enabling Internationalization
Setting Shutdown Time

Implementing a Multi-Process, Single-Threaded Environment
Configuring Directory Server Failover

Chapter 8 Configuring the Web Connector Plug-In

About the Web Connector Plug-In
Manually Configuring a Web Server

Reconfiguring the Microsoft Internet Information Server

Configuring the Web Connector for Web Server Logging

Mapping HTTP Variables to Database Fields
Adding HTTP Variables to the Log

Configuring Cookie and Hidden Field Usage
Configuring a CGI Flag for CGI Requests
Changing the Web Connector Port Number
Specifying HTTP Variables for Input to Application Components

Chapter 9 Administering Database Connectivity

About Data Access Drivers

Configuring Data Access Drivers

Adjusting Database Connectivity Parameters

Setting Connection Parameters
Setting Thread Parameters
Setting Database Cache Parameters

Chapter 10 Administering Transactions

About the Transaction Manager
Storing Distributed Transactions Log Data
Administering Distributed Transactions in the Transaction Window

About the Transaction Window
Configuring Transactions per Server

Viewing Transactions on a Selected Server
Viewing Transaction Details

Configuring Transactions per Process

Viewing Transactions on a Selected Process

Configuring Resource Managers

Adding and Editing Resource Managers

Administering Distributed Transactions from the Command Line
Setting Up Resource Managers for Distributed Transactions

Oracle
Sybase
DB2 Unix
Microsoft SQL Server

Enabling XA Error Logging

Oracle
Sybase
DB2
Microsoft SQL Server

Resolving In-Doubt Transactions
Recovering from Log Failure

Recovering from Log Disk Failure: Running Server
Recovering from Log Disk Failure: Stopped Server
Recovering from Loss

Part 3 Administering Multiple iPlanet Application Servers

Chapter 11 Configuring Multiple Servers

The Web Connector in a Multiple-Server Enterprise

Configuring the Web Connector for Multiple Servers
Specifying the Application Server Where Requests Are Sent
Specifying the Application Server Responsible for Logging

Distributed Data Synchronization and Load Balancing

Configuring a Distributed Data Synchronization Environment

Multicast Communication

How Multicast Services Apply to Load Balancing

Chapter 12 Administering Multi-Server Applications

Hosting Applications Locally on Multiple Servers
Hosting Partitioned Applications on Multiple Servers

Disabling and Enabling Application Components

Hosting and Deploying Applications for Load Balancing
Changing Attributes of Distributed Application Components

Chapter 13 Balancing User-Request Loads

How Load Balancing Works
Requirements for Load Balancing
What Is Sticky Load Balancing?

When to Use Sticky Load Balancing
Enabling Sticky Load Balancing

Selecting a Load Balancing Method

Load Balancing with the Web Server Plug-in
Load Balancing with iAS

Per Component Response Time Load Balancing
Per Server Response Time Load Balancing
Round Robin Load Balancing
User-Defined Criteria Load Balancing

Adjusting Weight Factors for Server Load Criteria
Adjusting Weight Factors for Application Component Performance Criteria
Adjusting Update and Broadcast Intervals
Changing the Multicast Host Address for Load Balancing

Chapter 14 Managing Distributed Data Synchronization

About Distributed Data Synchronization
How Failover Keeps Data Accessible
What Is a Cluster?

Setting Up Data Synchronization

Synchronization Server Roles

How a Cluster Communicates

Information Flow Within a Cluster

Setting Up and Managing Clusters

Determining Sync Server Priority

Example: Coordination Within a Seven-Server Cluster

Modifying the Default Cluster for Fast Cluster Setup

Entering IP Addresses Using kregedit
Editing Default Cluster Keys

Mapping the Synchronizer to the Cluster
Defining a Cluster

Using the Administration Tool to Configure Clusters

Creating a Cluster
Adding a Server to a Cluster
Removing a Server from a Cluster
Changing Sync Server Priority
Setting Cluster Parameters

Appendix A Troubleshooting
Configuring the Class Path
Setting up Transactions
What if xa_open Fails?
What Is a "Lock Held by In-Doubt" Error?
How Do I Configure the Number of Server-Side Connections?
Setting Environment Variables for Databases
Importing and Deploying a Third-Party J2EE Application

Appendix B Using the Bank Application with the Deployment Tool
Opening the .ear File in the Deployment Tool
Modifying Environment Settings
Packaging Application Components to Create and Deploy the Bank.ear File

Creating the EJB-JAR Module

Specifying Source Files for the EJB-JAR Module
Declaring the EJB-JAR Deployment Descriptor Parameters

Creating the Web Application Module

Specifying Source Files for the Web Application Module
Declaring Servlet Deployment Descriptors

Declaring Web Application Deployment Descriptor Properties
Assembling the Bank.Ear File
Deploying the J2EE Bank Application
Viewing the Bank Application in the Administration Tool

Compiling the Application

Makefile Structure
Compile the Application