Configuring the Tigase Server to Load a Component

Table of Contents

StanzaSender
How it Works
Configuration
Tigase HTTP API
Requirements
Setup & Configuration
Use of the HTTP API
Browser interface walk-through
HTTP API Scripting
REST API & HTTP Guide
Admin UI Guide
Tigase Web Client
Message Archiving Component
Installation
Configuration
Usage
Manual Activation
Automatic Activation of MUC messages
Searching for Messages
Message Tagging Support
Purging Information from Message Archive
Advanced Message Processing - AMP XEP-0079
First of all: plugins:
Secondly: component:
Optional parameters:
PubSub Component
Configuration
Pubsub naming
Configure Roster Maxmimum size
AdHoc Commands
PubSub Node Presence Protocol
Store Full XML of Last Presence
Offline Message Sink
PubSub Schema Changes
Server Monitoring
Setting Up Remote Monitoring in the Server
Retrieving statistics from the server
Statistics description
Eventbus
Setup
How it Works
Available Tasks
Configuration
Getting the Message
Mailer Extension
Server to Server Protocol Settings
Number of Concurrent Connections
Connection Throughput
Maximum Packet Waiting Time and Connection Inactivity Time
Custom Plugin: Selecting s2s Connection
Tigase MUC Component
Configuration Options
Tigase Load Balancing
Available Implementations
Configuration Options
Auxiliary setup options
External Component Configuration
Basic Configuration Options (External Component)
Tigase as an External Component
Load Balancing External Components in Cluster Mode
Client to Server Communication
Configuration
Resumption timeout
Packet Redelivery
Socks 5 Component
Installation
Database Preparation
Configuration
Database usage for specific settings
Example init.properties block
Virtual Hosts in Tigase Server
Specification for ad-hoc Commands Used to Manage Virtual Domains
Virtual Components for the Cluster Mode
Persisting component’s items configuration
Persisting items using web AdminUI
Persisting items using XMPP Client

A detailed description of all the configuration options is in the init.properties guide where you can also find information described below and much more. The purpose of this document is to give you a brief introduction on how to load a component into Tigase server without the need to dig through all the details.

I will show how to load 2 components into Tigase server using a configuration in the init.properties file: MUC and PubSub.

The only step is to tell the server what components to load, how to name them and optionally give some extra parameters. To do so open the init.properties file you use in your installation.

Let’s say you want to just add PubSub for now. All you need to do is add 2 lines to the properties file:

--comp-name-1=pubsub
--comp-class-1=tigase.pubsub.PubSubComponent

The first line contains the component name 'pubsub' and the main class for this component is: 'tigase.pubsub.PubSubClusterComponent'. It doesn’t really matter what the component name is, the only requirement is that it must be unique among other components names. Because you can load many components, it helps to provide descriptive names thus 'pubsub' is a good name for a 'PubSub' component.

You can of course add more components, even PubSub components to the same server. Just remember that each of them would need to have a different name then. For example:

--comp-name-2=pubsub-priv
--comp-class-2=tigase.pubsub.PubSubComponent

Although this may be rare, it allows for wide compatibility and platform stability.

Normally, however we want to load few different components like PubSub, MUC, MSN Transport and so on…​. Therefore instead of the above second PubSub we can load the MUC component:

--comp-name-2=muc
--comp-class-2=tigase.muc.MUCComponent

Changes to the init.properties file will take effect upon server restart.