Deployment as WAR / in Tomcat (tC)

Container deployment is recommended: Deployment using Container (tC)

WAR packages for deployment of tia® Core are stored at https://download.kgs-software.com/?login

An account is required. It is provided for licensed installations via kgs Customer Support https://kgs-software.atlassian.net/servicedesk/customer/portal/2/group/2/create/19

Prerequisites

Prerequisites for tia® and kgs Software Components

WAR packages can be deployed on any application web server that supports JAVA JDK 17 or higher and JarkartaEE Servlet version 5.0 or higher.

It is required, that the correct version of Java JDK and application web server is already set up before installing tia® Core application.

Installation of tia® Content Server core

Web Application Context Name

Choose a desired web application context name and rename the downloaded war file accordingly.

Example:

The downloaded war-file is tiaContentServer-saphttp-3.8.0.war. But the desired URL for accessing the Status UI is: https://1.2.3.4:8443/tiaCore-CS/info.

So the application context name is: tiaCore-CS

And the war-file before deployment needs to be renamed into tiaCore-CS.war.

Step 2:

Configure config location

The Tomcat context file is a XML file with the same name as the web application context (respective the war-file deployed. E.g. tiaCore-CS.xml) and is located in <tomcat installation>/conf/Catalina/localhost directory. For more information see Apache Tomcat documentation: https://tomcat.apache.org/tomcat-10.0-doc/config/context.html.

To access and edit the context file

shut down the app
navigate to <tomcat installation>/conf/Catalina/localhost directory
edit there the file called like the application context name with .xml extension
navigate toC:/Program Files/Apache Software Foundation/Tomcat 10.1/conf
edit there a new folder license and put the license into the folder

take the logback-spring.xml and the repository.cfg and put it into the C:/Program Files/Apache Software Foundation/Tomcat 10.1/conf folder

During the deployment the WAR file will be extracted and the default configuration will be available at /WEB-INF/classes/config/repository.cfg . In the context.xml the location of repository.cfg can be changed.

The folder and file for repository.cfg as well as the key store configuration needs to be readable by tomcat process. Don't put these configuration inside an user folder of another user like your login user! Otherwise the app inside tomcat don't have access permissions and will not start.

Example configuration in context file:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Context>
<Context>
    <Parameter
        name="logging.level.com.software.kgs"
        value="info"
        override="true" />
	<Parameter
        name="logging.config"
        value="C:/Program Files/Apache Software Foundation/Tomcat 10.1/conf/logback-spring.xml"
        override="true" />
    <Parameter
        name="volumecounter.file.counterSender.targetUrl"
        value="https://vcrs.kgs-cloud.de"
        override="true" />
    <Parameter
        name="volumecounter.file.counterSender.isActive"
        value="true"
        override="true" />
    <Parameter
        name="volumecounter.file.counterSender.proxy.uri"
        value=<yourProxyURL>
        override="true" />
    <Parameter
        name="volumecounter.file.counterSender.proxy.user"
        value=<yourProxyUser>
        override="true" />
    <Parameter
        name="volumecounter.file.counterSender.proxy.password"
        value=<yourProxyPassword>
        override="true" />
    <Parameter
		name="configDirectory"
		value="C:/Program Files/Apache Software Foundation/Tomcat 10.1/conf/repository"
        override="true" />
	<Parameter
		name="configFile"
		value="repository.cfg"
        override="true" />
	<Parameter
        name="tia.license.path"
        value="C:/Program Files/Apache Software Foundation/Tomcat 10.1/conf/license"
        override="true" />
	<Parameter
		name="webapp.security.auth.type"
		value="basic"
        override="true" />
	<Parameter
		name="webapp.security.auth.basic.username"
		value="admin"
        override="true" />
	<Parameter
		name="webapp.security.auth.basic.password"
		value="$2a$10$eswhIo8VjEviekZxaq1FLukR7I59dEdHiLE.kGEINbfSjA1cZWjG2"
        override="true" />
</Context>

restart the the Tomcat Service

Step 3:

Choose the tiaCore-CS.war-file and deploy it into the webapps folder

After this step the tomcat should create a folder in its webapps directory as well show the app in the application section of the manager.

Step 4:

Open the Tomcat configuration page and go to “Manager App”.

Verify Installation

Choose the deployed war-file from tomcat manager.

The base URL of the deployed application should forward to the web console, which looks like this: