Configuration Options

The most basic configuration is related to the choice of actual redirection implementation by declaring class for each connector:

bosh {
    seeOtherHost (class: <value>) {}
}
c2s {
    seeOtherHost (class: <value>) {}
}
ws2s {
    seeOtherHost (class: <value>) {}
}

Possible values are:

  • tigase.server.xmppclient.SeeOtherHost
  • tigase.server.xmppclient.SeeOtherHostHashed
  • tigase.server.xmppclient.SeeOtherHostDB
  • tigase.server.xmppclient.SeeOtherHostDualIP
  • none - disables redirection

All options are configured on a per-connection-manager basis, thus all options need to be prefixed with the corresponding connection manager ID, i.e. c2s, bosh or ws; we will use c2s in the examples:

c2s {
    'cm-see-other-host' {
        'default-host' = 'host1;host2;host3'
        'phases' = [ 'OPEN', 'LOGIN' ]
    }
}
  • 'default-host' = 'host1;host2;host3' - a semicolon separated list of hosts to be used for redirection.
  • 'phases' = [] - an array of phases in which redirection should be active, currently possible values are:

    • OPEN which enables redirection during opening of the XMPP stream;
    • LOGIN which enables redirection upon authenticating user session;

By default redirection is currently enabled only in the OPEN phase.