Rogue Wave® HydraExpress Version 2019
HydraExpress User Guide
PART I Introduction
Chapter 1 Introduction
Welcome
HydraExpress Components
HydraExpress Libraries
The Core Library
Software Requirements
SourcePro C++ Compatibility
Shipped Examples
The Use of the HydraExpress Project File in Shipped Examples
Servlet Examples
HydraExpress Mappings to LEIF Legacy Directory Structure
Documentation
Where to Find Additional Information
Chapter 2 Setup
Configuring Your Environment
Set Your Path Environment Variable
Set RWSF_HOME (UNIX/Linux only)
Run rwsfvars
SourcePro C++
Testing Your Installation
Run an Example
View the Default Agent Page
The HydraExpress Directory Structure
PART II The HydraExpress Agent
Chapter 3 Overview of Agent Configuration
Overview
Configuring the Agent
Agent Startup and Shutdown
Agent Connectors
Agent Ports
Setting the URL of the Agent
Configuring Secure Messaging with HTTPS
Handler Chains
Configuring the Servlet Container
Configuring the Global web.xml File
Configuring Individual Servlets in the Context-Level web.xml File
Single-Thread and Multithread Issues
Configuring Multiple Single-Thread Servlet Containers
Configuring Apache as an External Web Server
Configuring the HydraExpress AJP 1.3 Connector
Configuring the Apache Web Server
Setting the Worker Type
Configuring AJP13 Workers
Configuring Logging
Additional Information
Chapter 4 Agent Administration
Introduction
The Deployment Directory Structure
Starting and Stopping the Agent
Updating an Agent
Chapter 5 Connectors
Overview
The Standard Connectors
Connector Implementation
Optimizing Connector Thread Pools
Creating a Custom Connector
Request Handling and Threading
Implementing the Virtual Methods
Configuring the Connector
Chapter 6 Logging
Overview
The Agent Logger
Agent Logging Fundamentals
Using the Default Logger in a Service
Creating and Using Custom Loggers
Defining Your Logger
Using Your Logger
Creating a Rotating Log File
The Web Services Logger for Client Applications
Chapter 7 Error Handling
Overview
Handling Exceptions
rwsf::Exception and its Derived Classes
Other Possible Exceptions
Faults
Client Faults
Server Faults
WSDL-Defined Faults
Generated Client-Side Code
PART III Appendices
Appendix A Documentation and Conventions
Documentation
Typographic Conventions
Naming Conventions
Command Line Conventions
Appendix B Technical Support and Consulting Services
Consulting Services and Training
Technical Support
To Obtain Technical Support
Web Access to Rogue Wave Technology
Appendix C 3rd‑Party Licenses
3rd-Party Software Use
Apache Software License v. 2.0
Apache Software License v. 1.1
ICU License - ICU 1.8.1 and later
OpenSSL/SSLeay Licenses
IBM Common Public License
Rogue Wave® HydraExpressVersion 2019
IBM Common Public License