Application wide settings

The parameter names of tia Content Server are defined in lowercase strings, and reflect the hierarchy of application modules. For that reason, the . (dot character) is used to separate the levels in the hierarchy.

Application-wide settings are made depending on the chosen type of deployment:

Environment variables (container deployment)
Java command line parameters (war-file deployment)
In Tomcat context file (war-file deployment)
application.yml file (both)

Environment variables

This method is useful for containerized deployments as environment variables can be defined in the container configuration.

Note: Not all environments support the parameter name scheme for environment variables.

To convert a parameter name to an environment variable name follow these rules:

Replace dots (.) with underscores (_).
Remove any dashes (-).
Convert to uppercase.

Example for environmental variables in a docker run command:

docker run 
  [..] 
  -e TIA_LICENSE_PATH=/application/config/tialic 
  -e LOGGING_LEVEL_ROOT=ERROR
  -e WEBAPP_SECURITY_AUTH_BASIC_USERNAME=admin 
  -e WEBAPP_SECURITY_AUTH_BASIC_PASSWORD="\$2a\$10\$JKRQvv.bCNjlyLoBqORAq.79SlwpD8h9nWoo9ss35vt2Pi11KJ2B."
  [..]

Java command line parameters

In a war-file deployment, the web application server is a Java application and therefore started by a java command line.

Example:

java -D"logging.config"="my.log4j2.xml" [..]

In Tomcat context file

This is useful for a war-file deployment in a web application server. The context file is a XML file with the same name as the web application context (respective the war-file deployed. E.g. autodigit.xml) and is located in <tomcat installation>/conf/Catalina/localhost directory. For more information see Apache Tomcat documentation: Apache Tomcat 10 Configuration Reference (10.0.27) - The Context Container.

Example for Tomcat 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/tomcat/webapps/coreoftia/META-INF/my.log4j2.xml" 
          override="true" />
  </Context>

application.yml file

E.g.:

Place the file in a location accessible to the application.

The following setting can then be set using one of the three ways above:

When using container make sure the file is mounted inside the container.