Table of Contents

There is also a listing of tables, figures, and captioned examples.

Chapter 1: Introduction

• 1.1 Welcome
• 1.2 HydraExpress Components
• 1.3 The HydraExpress Libraries
• 1.3.1 The Core Library
• 1.4 Software Requirements
• 1.4.1 SourcePro C++ Compatibility
• 1.5 Shipped Examples
• 1.5.1 The Use of the HydraExpress Project File in Shipped Examples
• 1.6 HydraExpress Mappings to LEIF Legacy Directory Structure
• 1.7 Documentation
• 1.8 Where to Find Additional Information

Chapter 2: Installation

• 2.1 Overview
• 2.2 Installing HydraExpress
• 2.2.1 Installing on Windows
• 2.2.2 Installing on Linux
• 2.3 Configuring Your Environment
• 2.3.1 Set Your Path Environment Variable
• 2.3.2 Set the JAVA_HOME Environment Variable
• 2.3.2.1 Set RWSF_HOME (UNIX/Linux only)
• 2.3.3 Run rwsfvars
• 2.4 The HydraExpress Directory Structure
• 2.5 The HydraExpress License File

Chapter 3: Configuration

• 3.1 Overview
• 3.2 Configuring the Agent
• 3.2.1 Agent Startup and Shutdown
• 3.2.2 Connectors
• 3.2.3 Handler Chains
• 3.2.4 Localization Properties
• 3.2.5 Agent Ports
• 3.2.6 Optimizing Agent Thread Pools
• 3.3 Configuring the Servlet Execution Engine
• 3.3.1 Configuring the Global web.xml File
• 3.3.2 Configuring Individual Servlets in the Context-Level web.xml File
• 3.3.3 Single-Thread and Multithread Issues
• 3.3.3.1 Configuring Multiple Single Thread Servlet Engines
• 3.4 Configuring an External Web Server
• 3.4.1 Configuring the HydraExpress AJP 1.3 Connector
• 3.4.2 Configuring the Apache Web Server
• 3.4.2.1 Setting the Worker Type
• 3.4.2.2 Configuring AJP13 Workers
• 3.4.2.3 Configuring Load Balancing Workers
• 3.4.2.4 Declaring Workers to the Web Server
• 3.4.2.5 Sample Configuration for Load Balancing
• 3.5 Configuring Security
• 3.5.1 Transport-Level Security: HTTPS
• 3.5.1.1 Invoking a Service using HTTPS
• 3.6 Configuring Logging

Chapter 4: Agent Administration

• 4.1 Introduction
• 4.2 The Deployment Directory Structure
• 4.3 Starting and Stopping the Agent
• 4.4 Running Multiple Agents
• 4.5 Updating a Running Agent

Chapter 5: Custom Connectors

• 5.1 Overview
• 5.2 Creating a Custom Connector

Chapter 6: Agent Logging

• 6.1 Overview
• 6.2 Logging Fundamentals
• 6.3 Using the Default Logger in a Service
• 6.4 Creating and Using Custom Loggers
• 6.4.1 Defining Your Logger
• 6.4.2 Using Your Logger
• 6.4.2.1 Making Your Logger a Default Logger
• 6.4.2.2 Separating Your Log Messages from the Agent Messages
• 6.4.3 Creating a Rotating Log File

Chapter 7: Agent Localization

• 7.1 Overview
• 7.2 Configuring Localization Properties
• 7.3 Building a Message Catalog
• 7.4 Creating a Localized Message
• 7.5 Changing the Locale Dynamically

Chapter 8: Error Handling

• 8.1 Overview
• 8.2 Exceptions
• 8.2.1 Exception Class Hierarchy
• 8.2.2 Localized Exception Strings
• 8.2.3 Standard Library Exceptions
• 8.2.4 SourcePro Exceptions
• 8.3 Faults
• 8.3.1 WSDL-Defined Faults
• 8.3.2 Generated Client-Side Code
• 8.3.3 Throwing Faults in the Server-Side Code

Appendix A: Documentation and Conventions

• A.1 Documentation
• A.1.1 Typographic Conventions
• A.1.2 Naming Conventions
• A.1.3 Command Line Conventions

Appendix B: Technical Support and Consulting Services

• B.1 Consulting Services and Training
• B.2 Technical Support
• B.2.1 To Obtain Technical Support
• B.2.2 How to Contact Technical Support
• B.3 Web Access to Rogue Wave Technology

Appendix C: 3rd-Party Licenses

• C.1 3rd-Party Software Use
• C.2 Apache Software License
• C.3 ICU License - ICU 1.8.1 and later
• C.4 OpenSSL/SSLeay License
• C.5 IBM Common Public License

Topic Index

©2004-2007 Copyright Quovadx, Inc. All Rights Reserved.
Quovadx and Rogue Wave are registered trademarks of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.