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 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 3 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 4 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 5 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 6 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 7 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 8 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 9 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 10 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 11 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 12 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 13 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

Index