Overview

HydraExpress User Guide

3.1 Overview

This chapter discusses the configuration files that are shipped with HydraExpress. As a HydraExpress developer, you need to know what functionality the product provides by default in order to understand what changes and extensions you may need to make for your specific services.

Configuration files are located in the conf directory of your HydraExpress installation. Some of these files can be modified to accommodate your needs. These files are listed in Table 2. These are the only files that you can safely edit as necessary. The rest of the files in the conf directory are system files that should be left unchanged.

Note that the files discussed in this chapter affect the HydraExpress Agent runtime for hosting services. They do not affect either standalone clients or standalone servers. See the table at the end of this chapter for pointers to more complete information on Agent configurations, and information on configuring clients and standalone servers.

Table 2: Editable Agent Runtime Configuration Files

Editable File	Description
`rwagent.xml`	This file is the Agent's primary configuration file. It defines connectors, handlers, security, and other Agent-specific configuration.
`loggers.xml`	This file configures the loggers used to record significant events related to general Agent processes and service execution.
`servlet\web.xml`	This file is used to add servlets and servlet-mapping elements to a context.
`webservice\client-transports-template.xml`	This file defines the client transport objects that are needed to send messages to a server. See Note below.
`webservice\objects-template.xml`	This file makes all objects defined in it available to any running service. For standalone Web services, this file is needed to register custom handlers. See Note below.
`webservice\server-transports-template.xml`	This file defines the server transport objects that are needed to receive messages from a client. See Note below.

Note: You should not need to customize the files in the webservice directory unless you are creating custom transports for use in Web service development.

This chapter describes how to:

configure the Agent
configure the servlet container within the Agent
configure an external Web server
configure security
configure logging

The Rogue Wave name and logo are registered trademarks of Rogue Wave Software, and HydraExpress is a trademark of Rogue Wave Software. All other trademarks are the property of their respective owners.
Provide feedback to Rogue Wave about its documentation.