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

iascontrol
Example iascontrol start
Example iascontrol stop

Environment Variable Setting on Solaris
About iPlanet Registry Editor

Performing Administrative Tasks Using iPlanet Registry Editor

To Modify IP Address in Directory Server
To Modify IP Address in Local Configuration File

Configuring Multiple LDAP Domains

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
How Log Messages Are Formatted
Monitoring iPlanet Application Server Log Files

To Enable Vertical Scroll Bars In The Output Windows

About Logging Application Events

Determining the Logging Destination
To Specify Log Destination

Logging to a Database
Logging to a Console
Logging Server Events to a File

Managing Log Files

About Logging HTTP Requests

How Web Requests Are Logged
To Log Web Server Requests

About Logging DSync Messages

How DSync Messages Are Logged

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

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)?
SSL Authentication and Distinguished Names

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 Administration Server Options

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 iPlanet Web Server
Configuring Apache Web Server

Installing Apache on Windows
Configuring iPlanet Application Server Registry

Configuring Microsoft Internet Information 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 URL Rewriting
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 Third Party JDBC Drivers

During Installation
After Installation
Setting up Third Party JDBC drivers

Certified Third Party Drivers

Using Command Line Tools to Set up Third Party JDBC drivers
Registry Settings for Third Party JDBC Drivers

Driver Entry

Configuring Datasources

New Datasource Features
Registering Datasources
Datasource Configuration Parameters

Datasource Parameters
Connection Pool Parameters
Connection Sanity Parameters
Datasource Registry Settings

Modifying Third Party Datasources
Datasource Monitoring

Current Statistics
Cumulative Statistics
Statistics in Detail

Destroy Pool
Flush Pool
Datasource XML Format

Chapter 9 Administering Transactions

About the Transaction Manager

New Features

Administering Distributed Transactions from iASAT

About the Transaction Window
Configuring Transactions Per Server
Viewing Transactions Per Server
Administering Transactions Per Server
Administering Transactions Per Process
Viewing Transactions on a Selected Process
Administering Transactions Per Process

Monitoring Transactions

Configuration Parameters
Resolving In-Doubt Transactions

Chapter 10 Enabling Support For Corba-Based Clients

Configuring Support For Javasoft ORB
Configuring Support For ORBIX2000

Chapter 11 Administering Message Driven Beans

Configuring a JMS Provider
Administering Message Driven Beans

Part 3 Administering Multiple iPlanet Application Servers

Chapter 12 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 13 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 14 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
Sticky Load Balancing and Foreign Sticky Cookies

Selecting a Load Balancing Method

Load Balancing with the Web Connector 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 15 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 16 Setting Up iPlanet Application Server for Development

Setting Up Class Paths
Changing Heap Size For Java Engines
Changing The Default Application Path
Enabling Dynamic Class 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
How Do I Configure the Number of Server-Side Connections?

Index