Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

...

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

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

      Code Block
      <?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 toC:/Program Files/Apache Software Foundation/Tomcat 10.1/<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 C:/Program Files/Apache Software Foundation/Tomcat 10.1<tomcat installation>/conf folder

    View file
    namelogback-spring.xml


    View file
    namerepository.cfg

...