XX1 Proxy Adapter Configuration

The XX1 Proxy adapter allows you to use a host or database adapter that resides and runs on a remote XX1 Server.

XX1 proxy configuration is held in proxycfg.xml or as named in the xxscfg.xml adapter entry. The name of the runtime library is xxproxy and loaded as follows through the main configuration: 

<provider>
    <adapter name="MyHost" lib="xxproxy" config="proxycfg.xml"/>

See also Provider Resource Pooling with Proxy Adapter.

Configuration Parameter

NodeDescriptionDefault (if not specified)
host(optional; if not specified at least one provider element should be specified) Host address or URL of remote XX1 for a default route.
port(optional; if not specified the default port 8800 for non-SSL or 443 for SSL are used) SOAP port of remote XX1 for a default route.8800
timeout(optional) Socket connect timeout in seconds to remote XX1 for a default route.360
alt

(optional)  This can contain a list of alternate IP addresses or hostnames and ports for several XX1 for fail-over. If an alt element is specified, at least one host element must be specified. The alternate XX1's will be used in the order of the alternate list. The first one, that is responding will be used. The alt-entries are only used after the timeout for the defined default connection has passed and each alt-entry will again wait until the configured timeout has passed. The entries in that alt-element can be separated by:

  • comma (,)
  • semicolon (;)
  • space ( )
  • tabs
  • new lines
encryption

(optional) Enable data encryption between local and remote server. Possible values are:

  • SSL
  • PGP.
proxyhost(optional) A HTTP proxy IP address or hostname can be specified here, that the request will be send over.
proxyport(optional) A HTTP proxy port can be specified here, that the request will be send over.
provider

All Provider rules override the default route. A more specific provider rule will override a more generic provider rule. A provider element can have two attributes to describe the filtering rule:

  • name: the name of the provider, the rules should apply on
  • session: the name of the session, the rule should trigger for.
provider/host

(optional) same definition as above in host element, just applies for provider rule.

provider/port(optional) same definition as above in port element, just applies for provider rule.
provider/timeout(optional) same definition as above in timeout element, just applies for provider rule.
provider/alt(optional) same definition as above in alt element, just applies for provider rule.
provider/encryption(optional) same definition as above in encryption element, just applies for provider rule.
provider/proxyhost

(optional) same definition as above in proxyhost element, just applies for provider rule.

provider/proxyport(optional) same definition as above in proxyport element, just applies for provider rule.

 

Example for a proxycfg.xml: 

<proxycfg>
	<!-- Default route, applies for all providers if no override below specified -->
	<host>127.0.0.1</host>
	<port>8801</port>

	<!-- Per-Provider overrides -->
	
		<!-- Default route override for provider Amadeus -->
		<provider name="Amadeus">
			<host>10.0.0.49</host>
			<port>8800</port>
			<timeout>180</timeout>
		</provider>
		
		<!-- Default route AND provider specific rule override for provider Amadeus and session ABCD-->
		<provider name="Amadeus">
			<host>77.88.99.160</host>
			<port>443</port>
			<encryption>SSL<encryption>
			<timeout>240</timeout>
		</provider>
		
		<!-- Default route override for provider SabreWS for session ABCD.
				All other SabreWS sessions will be handled by the default route. -->
		<provider name="SabreWS" session="ABCD">
			<host>10.0.0.49</host>
			<port>8801</port>
			<timeout>120</timeout>
		</provider>
</proxycfg>