Deployment as WAR / in Tomcat (tC)

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

Prerequisites

Prerequisites for tia® and kgs Software Components

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 .war file accordingly.

Example:

The .war file is called 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.

Then the application context name is: tiaCore-CS

To achieve this, the .war file must be renamed as follows: tiaCore-CS.war.

Configure the configuration location

The Tomcat context file is an XML file with the same name as the web application context name (respective the .war file deployed. E.g. tiaCore-CS.xml). For more information see Apache Tomcat documentation: https://tomcat.apache.org/tomcat-10.0-doc/config/context.html.

Best practice:

• Shut down Apache Tomcat

• Navigate to <tomcat installation>/conf/Catalina/localhost directory

• Create a file called like the application context name with .xml extension e.g. tiaCore-CS.xml. The advantage of this procedure is that the web context and the configuration are not overwritten even if the .war file is updated, as long as the name of the .war file remains the same as before the update.

  • Example configuration of the context file e.g tiaCore-CS.xml:
    
    

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

     

• Navigate to<tomcat installation>/conf

• Create a new folder license and put the license into it

• Take the logback-spring.xml and the repository.cfg and put it into the <tomcat installation>/conf folder
  
  
  
  

• restart the the Tomcat Service

WAR file deployment

Choose the tiaCore-CS.war file and deploy it into the webapps folder of the Apache Tomcat installation:

Open

After this step the tomcat should deploy and create a folder in its webapps directory

Open

Apache Tomcat Manager App

Open the Tomcat configuration page and Click on the Manager App button.

Apache Tomcat Manager App

Choose the deployed .war file from tomcat manager e. g. /tiaCore-CS.

• The successfully installed tiaCore-CS now presents the UI of tia core: