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

 2.a Installing XMPP Server Windows Export knowledge base Export     SubscribeSubscribe      Show article info

This article describes how to install Tigase XMPP Server on windows.

 

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

 

Direct link to the download: https://github.com/tigase/tigase-server/releases/download/tigase-server-7.1.3/tigase-server-7.1.3-b4482.jar

 

Note! When running the installation. Please check the notes below!

 

 

Notes during installation process

Run the jar installation file through admin elevated cmd to ensure full write access.

 

 

In step 2

 

JDK file is usually located in C:/Program Files/Java

This version of Tigase doesn't seem to be compatible with JDK11 or later, so if it says that the JDK was not found download JDK8 instead and put it in a separate folder at the same place as JDK11, and select this path for Tigase.

Download JDK8 here (select Windows x64 zip file): https://adoptium.net/temurin/releases 

 

In step 3. 

 

Choose both installation and configuration (default).

 

In step 7.  

 

Uncheck the database drivers that not will be used. Keep the rest untouched.

 

 

In step 13. 

 

Configuration type: Default + extra components.

Your XMPP domain: Make sure it is lower case all the way. 

Choose your database (MySql or (MS) SQLServer).

 

At the end you might get a warning that the program did not install correctly but it can be ignored.

 

In step 20.

 

Input login details for your selected database. Select a password for the Tigase server (default is Tigase12)

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

On Windows you can install Tigase as a service. To do it use the InstallTigaseService.bat batch file found also in server root directory.

In this mode service will be running in background and will be controllable from the Services management snapshot. To launch the tool right click on the Computer icon on the desktop. Choose the Manage action. It will run the Computer management graphical configuration program. On the left side choose the Services item. You will be shown with a list of services. Here you can start and stop the Tigase service when it will be installed.

To uninstall Tigase service use the UninstallTigaseService.bat file from Tigase server root directory.

 

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


User comments
 Loading ...