globster-xmlconf

This script is a tool for quick Globster configuration. It is based on globsterctl and it is supposed to be started once right after globster is launched. Script automatically creates hubs saved in config file and connects the client to them.

Dependency

Installation and usage

Download the script and move it to any location on your filesystem. Then create config XML file and save it in the same directory as globster-xmlconf.xml, you can use the example configuration at the bottom of this document.

To start the script:

cd /path/to/script
./globster-xmlconf.pl [<config>]

Always use full path to the configuration file. If no config file is given, the script searches for globster-xmlconf.xml in the script path or /etc/globster. We changed the directory to the script path and we have the config in the same directory so we can leave this argument empty.

To run in background:

./globster-xmlconf.pl &

XML configuration

The table below shows tags used in the XML configuration file. All of them are mandatory for the script to work.

TagDescriptionContainer tagPaired/Unpaired
config Start tag of the configuration, can be replaced by any tag except other tags described here.-paired
hubNew hub object.configunpaired

The table below shows attributes used in the XML configuration file. Most of them are mandatory for the script to work.

AttributeDescriptionTag
dbusaddrDBUS_SESSION_BUS_ADDRESS of the Globster bus session. Script uses this address to identify the session of Globster in case of script restart. This attribute is optional.config
addressHub address.hub
nickDesired bot nickname.hub
descriptionDesired bot description.hub
passwordPassword used if the bot is registered on the hub.hub

Example configuration

Sample configuration can be found here.