Customers
User information
 Loading ...
Show article in Knowledge Base

 2.b Installing XMPP Server Linux Export knowledge base Export     SubscribeSubscribe      Show article info

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  - domain you selected during tigase installation

--admins - tigase admin user you specified during installation

--user-db - database type you specified during installation

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

--auth-db-uri - database url used by visionflow

--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 

4. Copy files 
vp_root/api/docs/VisionProjectWebService-client.jar 
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/vp-tigase-addons-2.X.X.jar 
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/slf4j-api-1.7.25
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/HikariCP-3.3.1.jar
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/logback-classic-1.2.3.jar
vp_root/WEB-INF/internal_docs/installed_version/configuration/chatmodule/logback-core-1.2.3.jar

into tigase_root/jars directory

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 )

7. (Optional) If you run VisionFlow on MS SQL Server.

Copy the MS SQL jdbc driver mssql-jdbc-7.2.2.jre8.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 configrations need to be in place: Migrate chat to websockets


User comments
 Loading ...