| <load-balancer ...> | |||
|
This file contains the configuration for a HTTP(S) load-balancer.
host - The host/IP of this balancer. This is the host it accepts incoming HTTP(S) connections on to route to the backend servers. If [ALL] is specified then all the servers IP's are used. maximum-island - The maximum island ID to listen for, setting this is useful when using multiple balancers. minimum-island - The minimum island ID to listen for, setting this is useful when using multiple balancers. port - The port of this balancer, the default is 80 for regular sites and 439 for secure (SSL) sites. secure - Whether or not to use SSL. The default is false. SSL is only used when using session (not IP) based balancing and the backend and the site is using SSL. If you specify the balancer to use SSL then the backend servers will not (the balancer converts to HTTP, ie contains the SSL layer). Note that this puts the strain of decoding the SSL on the balancer. selection-type - Selection type to use when deciding which backend server gets an unbound request (new user). use-ip - Whether to look at the client's IP when routing requests to the backend servers. The default is true. use-session-id - Whether to look at the client's servlet session ID when routing requests to the backend servers. The default is true. |
|||
| <island id="x"> | |||
|
An island is a pack of (usually 2-4) servers that share session replication in case of failover etc.
id - The integer ID of this island. If none is specified an incrementing auto-assigned ID is used. |
|||
| <backend-server host="a.b.c" port="80|443" /> | |||
|
A backend server (Orion server instance) that receives routed requests from the balancer. Do not specify backend servers unless really needed (due to lack of multicast comm or similar), it will make the system static, preventing dynamic removals/readdings.
host - The host of the backend server. port - The port of the backend server. Default is 80. |
|||
| <ssl-config factory="my.own.SSLServerSocketFactory" keystore="../mykeystore" keystore-password="123456" needs-client-auth="true|false" provider="com.sun.net.ssl.internal.ssl.Provider"> | |||
|
Specifies SSL-configuration settings. These settings are used if secure="true" is specified on the balancer. If a 3rd party SSLServerSocketFactory implementation is used then x property tags can be defined to send arbitary arguments to the factory.
factory - A com.evermind.server.http.SSLServerSocketFactory implementation if not using JSSE. This is usually not specified (defaults to using JSSE: com.evermind.server.JSSESSLServerSocketFactory). keystore - The relative/absolute path to a keystore used by this site. keystore-password - The password needed to open the keystore. needs-client-auth - 'true'/'false' value specifying if the client needs to submit a valid auth, 'false' by default (enable this for SSL-based user auth). provider - The provider used if using JSSE, defaults to com.sun.net.ssl.internal.ssl.Provider. |
|||
| <property name="paramName" value="paramValue" /> | |||
|
A configuration parameter.
name - The name of the parameter. value - The value of the parameter. |
|||