This article describes how to install Tigase XMPP Server on a Linux distribution.

NOTE! The version to be installed is tigase-server-7.1.3-b4482.jar

1. First download the installation file. 

wget https://github.com/tigase/tigase-server/releases/download/tigase-server-7.1.3/tigase-server-7.1.3-b4482.jar

2. Run the console installer.

java -jar tigase-server-7.1.3-b4482.jar -console

Follow the guide at https://docs.tigase.net/tigase-server/7.1.3/Administration_Guide/html/#consoleinstall

Important! 

• In the step Basic configuration choose:  Default plus extra components.
• Run the guide until everything is installed.
• Wait with the step running the server until later.

After installation

(tigase_root is the root folder of the Tigase Server)

(vp_root is the root folder of where VisionFlow is installed)

1. Backup file tigase_root/etc/init.properties 

2. Copy file vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/init.properties into tigase_root/etc directory

3. Change the properties in that file:

--virt-hosts  - This needs to be a domain where Nginx/Tigase is located and must match the setting chatDomain, in vp_root\WEB-INF\classes\visionproject.properties, more details below.

--admins - tigase admin user you specified during installation

--user-db - database type you specified during installation (Ex: mysql or sqlserver)

--user-db-uri - url of the database for tigase, make sure it contains the parameters
"&autoCreateUser=true&useUnicode=true&characterEncoding=UTF-8"

Examples:
jdbc:mysql://localhost:3306/tigasedb?user=tigase&password=tigase12&autoCreateUser=true&useUnicode=true&characterEncoding=UTF-8

jdbc:sqlserver://localhost;databaseName=tigasedb;portNumber=1433;user=tigase;password=tigase12;autoCreateUser=true

--auth-db-uri - database url used by visionflow, (copy it form visionproject_database.properties)

--auth-db-driver - driver for the database used by visionflow (com.mysql.jdbc.Driver for mysql, com.microsoft.sqlserver.jdbc.SQLServerDriver for mssql)

--webServiceUrl - webservices url of your visionflow installation (for example; https://YOUR_VISIONFLOW_URL/service/VisionProject-v2/VisionProjectWebServiceService)

4. Copy the following files from your VisionFlow installation into your tigase_root/jars directory:

vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/gmbal-api-only-4.0.2
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/ha-api-3.1.12
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/HikariCP-4.0.3
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jakarta.activation-2.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jakarta.annotation-api-2.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jakarta.jws-api-3.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jakarta.mail-2.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jakarta.xml.bind-api-3.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jakarta.xml.soap-api-2.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jakarta.xml.ws-api-3.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jaxb-core-3.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/jaxb-impl-3.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/log4j-1.2-api-2.17.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/log4j-api-2.17.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/log4j-core-2.17.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/management-api-3.2.3
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/mimepull-1.9.13
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/policy-3.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/rt-3.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/saaj-impl-2.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/slf4j-api-1.7.32
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/slf4j-log4j12-1.7.32.jar
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/stax2-api-4.2.1
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/stax-ex-2.0.0
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/streambuffer-2.0.1
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/woodstox-core-6.2.1
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/vp-tigase-addons-2.1.8.jar
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/visionproject-ws-client-3.0.0

5. Open file vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/listeners.properties and compare it to the file vp_root/WEB-INF/classes/listeners.properties. Add any missing listeners to to the listeners.properties file in your classes folder. If you do not have a listeners.properties file in your classes folder you can simply copy the file from the chatmodule folder.

6. Open file vp_root/WEB-INF/classes/visionproject.properties and change the properties:

chatDomain - domain of the server where nginx/tigase is located

chatEnabled=true

chatSystemPassword - any set of latin symbols and/or numbers

chatSystemName=System

chatProtocol=wss (use ws if you don't have https configured on nginx. Please note that is creates an unsecure connection)

chatDomain needs to match with Nginx config later on, example is localhost.

7a. If you run VisionFlow on MS SQL Server.

Copy the MS SQL jdbc driver mssql-jdbc-9.2.1.jre8.jar from vp_root\WEB-INF\lib to tigase_root\jars

7b. If you run VisionFlow on MySQL Server.

Copy the mysql-connector driver mysql-connector-java-5.1.49.jar from vp_root\WEB-INF\lib to tigase_root\jars

Installation as a service

You can start the tigase server with the command:

 tigase_root/scripts/tigase.sh start etc/tigase.conf

or make it starting automatically:

• Take script here and put it into /etc/init.d on you server
• Open the file and change parameter TIGASE_HOME tou your own tigase installation path (tigase_root)
• Set the file executable:

sudo chmod u+x /etc/init.d/tigase

• Install init script links: 

sudo update-rc.d tigase defaults 

Then you can start(stop) it using the following command

sudo /etc/init.d/tigase start(stop)

Additional Nginx configuration

Nginx needs to be set up to support websocket. In newer version of VisionFlow the required configuration is included when following our knowledge base article on setting up nginx/proxy server but if your nginx configuration is older you need to configure it manually. Please have a look at the following article to see which configurations need to be in place: Migrate chat to websockets