Server, Database, Web Client Installation

For information

• The individual PLANTA Project components Manager, Worker, Customizing (database), and Web Client are delivered as container images in docker container format.

  • Manager is responsible for database access

  • Worker establishes Client or Web Client connections

  • Customizing contains standard customizing and customer-specific adjustments

  • Web Client ensures the display of the software interface in the web browser.

• For production workloads we recommend that you set up the PLANTA secure component as a reverse proxy (TLS scheduling, single sign-on with OIDC, etc.).

• The container images can be deployed wherever an OCI-compatible container runtime or platform is available.

Download Container Image

Procedure

• All container images are available on the PLANTA registry at https://registry.planta.services. The login data will be sent to you by PLANTA upon request. For further information on this topic, please see Login PLANTA OCI Registry

Configure the Container Image with Docker Compose

Docker Compose is a tool that is used to configure and manage the Docker container application. Multiple containers can be defined in a single file (.yml).

Procedure

• The containers are configured using environment variables in the corresponding docker-compose.yml file.

• PLANTA provides several configuration templates for configuring different systems such as Oracle, MSSQL, hybrid systems etc. in our public Git Repository.

• These templates already contain a minimum set of parameters that are required for the respective system.

• If you would like to include additional parameters in your individual configurations, you can find them at:

  • Parameters for the manager container

  • Parameters for the webclient container

  • The customizing container is an init container and does not contain any configuration. Its sole task is to deliver the files from the customizing area. Subsequently it is stopped.

Make the Container Available Using Docker Compose

Procedure

1. Edit the Configuration.

2. Log in to the PLANTA registry using your usual login data: docker login registry.planta.services.

3. Download the required container image: docker-compose pull.

4. Create or start container: docker-compose up -d.

See also: Microsoft tutorial for setting up Linux containers under Windows