Versions Compared

Version Old Version 14 New Version Current
Changes made by

Armin Franke

Armin Franke

Saved on

Key

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

...

Installation of docker or another container runtime following Open Container Initiative (OCI) standard is prerequisite for deploying tia tia® Viewer as container.

Images for deployment of tia tia® Viewer Core are stored at https://nexus.kgs-cloud.de. For Docker access to this server use: https://images.docker.kgs-cloud.de .

Info

An account is required. It is provided for licensed installations via kgs Customer Support.

Note

Images that are no longer supported will be removed without further notice.

...

docker login https://images.docker.kgs-cloud.de

Docker will prompt for user and password.

Deploying

...

tia® Viewer

Deploying tia tia® Viewer Core requires a license file. This file is provided by kgs.

For more than minimal configuration, kgs recommends to create a viewer.yml fileConfiguration is possible using environment variables for simple test systems, or using a YAML file (e.g. viewer.yml) which is recommended for more complex deployments. For more information see tia® Viewer Core Configuration (Vc).

Finally prepare the command to start the container based on the specific requirements according to the following table:

Docker parameter

Placeholder name to be replaced

Mapping to container-configuration

Explanation

--name

<Name>

Give the tia tia® Viewer container a custom name. This name is also the application context name.

Info

Hint: It is possible to start multiple instances of the same containers with different ports and different names.

-p

<Hostport>

SERVER_PORT

<Hostport>: Listener port on host that forwards to the listener port in the container, which is configured by server.port application-wide setting (default: 8080).

-v

<License Folder>

/application/config/license/

The location on host system where the license file resides.

Alternatively, only the license file may be mapped:

-v ./viewerlicense.json:/application/config/license/viewerlicense.json

-v

<config directory>

/application/config

Mapping the configuration directory to the container context.

-e

/application/config/viewer.yml

info

This notifies the location in the container file system where the configuration file resides.

SPRING_CONFIG_ADDITIONALLOCATION

The YAML configuration file for the tia tia® Viewer (typically named viewer.yml). If not provided, built-in defaults will be applied.

Alternatively, for minimal installation configuration using environmental variable only is available.

For more information, see tia® Viewer Core Configuration (Vc) .

-e

<Loglevel>

LOGGING_LEVEL_ROOT

The log level sets the verbosity of the log writing. Valid are: OFF; ERROR; WARN; INFO orDEBUG.It is recommended to use ERROR or WARN in production environments and WARN or INFO in test systems. Set DEBUG level only when being ask be kgs Customer Support.

-d

Run as daemon in background

<Image>

Referencing the image as last parameter in the docker command.

The image is referenced like this:

images.docker.kgs-cloud.de/tia-viewer/<Product:<Version>

with

<Product>: The tia tia® Core product to be deployed: archivelink-oidc.

<Version>: The version of tia Core to be deployed. kgs recommends to use the latest available version.For this use latest.The tag latest is not supported.

Template of docker run command for copy & paste:

...

Code Block
docker run --name viewer-AL -p 8080:8080   -v ./tiacore/license:/application/config/license/ -v ./tiacore/config:/application/config -e SPRING_CONFIG_ADDITIONALLOCATION=/application/config/viewer.yml -e LOGGING_LEVEL_ROOT=INFO  -d images.docker.kgs-cloud.de/tia-viewer/archivelink-oidc:latest1.1.0

Explanation of docker command:

...

For information about configuration of tia tia® Viewer Core by environmental variables see tia® Viewer Core Configuration (Vc) .

When the tia Core Viewer Core® container is running,

  • access its health status in web browser. <http|https>://<host>:<port>/actuator/health

  • customize SAP to use the viewertia® Viewer Core: SAP Customizing (Vc)