Table of Contents
Artur Hefczyc <artur.hefczyc@tigase.net> v2.0, June 2014: Reformatted for AsciiDoc. :toc: :numbered: :website: http://tigase.net :Date: 2010-04-06 21:18
There are cases when you want to deploy one or more Tigase components separately from the main server or perhaps you want to run some Tigase components connecting to a different XMPP server or perhaps you work on a component and you do not want to restart the main server every time you make a change.
There is a way to run the Tigase server in "external component mode". In fact you can run any of Tigase components as an external component and connect them to the main XMPP server either via XEP-0114 or XEP-0225 connection.
Let’s look at the examples…
A few assumptions:
There is a special configuration type for this case which simplifies setting needed to run the Tigase as an external component:
config-type=--gen-config-comp.
This generates a configuration for the Tigase with only one component loaded by default - component used for external component connection. If you use this configuration type, your init.properties file may look like this:
config-type = --gen-config-comp --debug = server --user-db = derby --admins = admin@devel.tigase.org --user-db-uri = jdbc:derby:/tigasedb --virt-hosts = devel.tigase.org --comp-name-1 = muc --comp-class-1 = tigase.muc.MUCComponent --external = muc.devel.tigase.org:muc-pass:connect:5270:devel.tigase.org:accept
Please note, you do not need lines:
--comp-name-1 = ext --comp-class-1 = tigase.server.ext.ComponentProtocol
as the
--gen-config-comp
automatically includes them.