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 Administrative Tasks

About iPlanet Application Server Administration Tool (iASAT)
Performing Administrative Tasks Using iASAT
About Command-Line Tools
Using Command-Line Tools
Performing Administrative Tasks Using Command-Line Tools
About iPlanet Registry Editor
Performing Administrative Tasks Using iPlanet Registry Editor

Part 2 Administering a Single iPlanet Application Server

Chapter 2 Monitoring Server Activity

Monitoring iPlanet Application Server

Monitoring Process Attributes
To Log Process Data to a File
To Change a Process Data Plot
To Remove 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?

To Configure Email Notification for an Event
To Specify an Event-Invoked Script

Chapter 3 Configuring SNMP to Monitor iPlanet Application Server with Third-Party Tools

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

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

Setting Up the Master Agent and SubAgents

To Configure the Master SNMP Agent
To Start the SNMP Master Agent
To Verify SNMP Configuration

Chapter 4 Logging Server Messages

About the Logging Service

To Determine Types of Messages to Log

Logging Application Messages
How Log Messages Are Formatted

Determining the Logging Destination

To Log to a Database
To Log to a File
To Rotate Log Files

About Web Server Requests

How Web Requests Are Logged
To Log Web Server Requests

About The Administration Server
About DSync Logging Options

How DSync Messages Are Logged

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

To Log DSync Messages

About Monitoring iPlanet Application Server Log Files

To Enable Vertical Scroll Bars In The Output Windows

Chapter 5 Securing iPlanet Application Server

About Security

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

Storing and Managing Users and Groups

Implementing Security

Authorization for J2EE Applications
Authorization for C++ Applications

Using iPlanet Console to Add Entries to Directory Server

What Is a Distinguished Name (DN)?
Creating User Entries Using iPlanet Console
Creating Group Entries Using iPlanet Console
Modifying Database Entries Using iPlanet 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

Enabling Encryption Between Web Server And Application Server
Using Firewalls for Security

Basics of Network Security

Types of Firewalls

iPlanet Application Server Architecture
Inter-Process Communication Protocol

Ephemeral Ports
Transmission Control Protocol/Internet Protocol (TCP/IP)
IP Multicast
User Datagram Protocol (UDP)

Encrypting Data Channels

Configuring Firewalls With iPlanet Application Server

Single Firewall
Double Firewall - the DMZ Configuration
Triple Firewall - DMZ With Database Protection

Chapter 6 Enabling High Availability of Server Resources

About Adding and Tuning Server Processes
Adjusting the Number of Threads for Processing Requests
Specifying the Number of Requests for the Executive Process
Setting Options of the Administration Server

To Specify EJB Container Parameters for Run Time
To Specify Maximum Number of Engine Restarts
To Enable Internationalization Support
To Cache JavaServer Pages (JSP)
To Specify Maximum Server and Engine Shutdown Time

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

Setting Up Supplier-Initiated Replication

Chapter 7 Configuring the Web Connector Plug-In

About the Web Connector Plug-In
Manually Configuring a Web Server
Configuring the Web Connector Plug-in 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

To Configure Data Access Drivers

Adjusting Database Connectivity Parameters

To Set Connection Parameters
To Set Thread Parameters
To Set Database Cache Parameters

Setting up Native and Third-Party JDBC drivers
Configuring Resource Manager
Configuring Data Sources

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

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 Plug-in in a Multiple-Server Enterprise

Configuring the Web Connector Plug-in 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

About iASAT
Hosting Applications Locally on Multiple Servers
Hosting Partitioned Applications on Multiple Servers

Configuring a Partitioned Application
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 iPlanet Application Server

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?

Server Roles Within Clusters

How a Cluster Communicates

Information Flow Within a Cluster

Configuring Clusters

Configuring Clusters Using iASAT
Configuring Clusters Using iPlanet Registry Editor
Determining Sync Server Priority
Setting Cluster Parameters
Mapping the Synchronizer to the Cluster

How Sync Server Prioritization Improves Coordination

Example: Coordination Within a Seven-Server Cluster

Chapter 14 Setting Up iPlanet Application Server for Development

Setting Up Class Paths
Changing Heap Size For Java Engines
Changing The Default Application Path
Enabling Dynamic Servlet Reloading
Specifying Session And Cache Timeout Values For J2EE Components
Enabling RMI/IIOP Support
Setting Environment Variables for Databases

Sybase
Oracle
DB2
INFORMIX
Adjusting Environment Size

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?

Index