Configuring Client and Server Applications

This document covers the following topics:

Configuring a Client to Call the EntireX XML/SOAP Runtime (Java API)

Configuration Information

The configuration information (which broker to use) is retrieved from the XMM file by default, or the client sets this information explicitly.

For information on available methods, see XMLRPCService (EntireX XML/SOAP Runtime); for available inherited methods, see RPCService (EntireX Java ACI).

For configuration of the behavior of XML/SOAP Runtime with setUserProperty see XMLRPCService.

Environment Settings

EntireX XML/SOAP Runtime requires correct setting for XML Stream Parser allowing access to JAXP methods. The classpath must contain the required JAR files.

The Java properties are:

javax.xml.stream.XMLInputFactory
    (default: com.ctc.wstx.stax.WstxInputFactory)
javax.xml.stream.XMLOutputFactory
    (default: com.ctc.wstx.stax.WstxOutputFactory)

These must be set for the client application if they differ from the default settings.

Configuring a Client to Call the EntireX XML/SOAP Runtime (XML/SOAP Listener)

Configuration Information

The configuration information (for the EntireX Broker) is retrieved from one of the following sources:

  • XMM file (lowest priority) by default

  • configuration xml-init.xml inside the Web service description (AAR file) generated by Packaging Wizard

  • configuration of EntireX Web service in an external configuration file

  • HTTP/payload parameters (highest priority)

See also Administering the EntireX XML/SOAP Listener under UNIX | Windows.

Environment Settings

EntireX XML/SOAP Runtime requires correct setting for the XML Stream Parser to allow access to JAXP methods. The classpath must contain the required JAR files. The Java properties are: 

javax.xml.stream.XMLInputFactory
    (default: com.ctc.wstx.stax.WstxInputFactory)
javax.xml.stream.XMLOutputFactory
    (default: com.ctc.wstx.stax.WstxOutputFactory)

If the settings differ from the default settings, set them in the start script of the Web server.

Configuring an XML/SOAP RPC Server

The XML/SOAP RPC Server reads configuration data from configuration file (lowest priority), property file and command line (highest priority). You can define location and name of property file and configuration file as command-line parameters. The property file may define the JAXP parameters and the location and name of the configuration file. Default for the properties file is entirex.xmlrpcserver.properties and for configuration file entirex.xmlrpcserver.configuration.xml located in the working directory. The configuration file (in XML format) contains information about EntireX Broker and a list of target servers, including the mapping file associated with them. If a configuration file or a properties file contains non-encrypted or base64-encoded passwords, the passwords are replaced by the encrypted ones.

See Administering the EntireX XML/SOAP RPC Server under UNIX | Windows.