Consul ???? Für aktuelles Produkt umarbeiten ????¶

The configuration of the SEAL Print Client services are stored in the key value store of Consul.

Consul Web Interface¶

For Consul, a Web interface is available. In order to open the Consul Web Interface, enter the following URL into your Web browser:

https://<operator_server>:8500

Keys and Values¶

The keys in the key value store are structured hierarchically. The settings of a SEAL Print Client system begin with dc/home/env.

For each service instance, both the service name and one or more tags are specified. A tag is any text without blanks. Both specifications can be used for identifying the instance to which the setting applies. Each setting is saved under /service/<service_name>/tag/<tag_name>.

Example - all services

dc/home/env/service/any/tag/any

Example - service instance for the PLOSSYS netdome connector

dc/home/env/service/seal-operator-p4/tag/any

The name of the key is appended to the path.

Example - log level for all instances

dc/home/env/service/any/tag/any/LOG_LEVEL

The settings available for SEAL Print Client are listed in the Keys reference.

Change the Value of an Existent Key¶

In the Consul Web interface, click KEY/VALUE on the top of the page.
In the tree view on the left, navigate to the level of the key, for example, dc/home/env/service/any/tag/any.
For changing an existent key, select the key, for example, CONSUL_TOKEN and specify its new value.
Click UPDATE.

Hint - service restart

After starting a server instance, envconsul monitors the configuration changes in the key value store. After a setting has been changed, envconsul restarts the service instances with the updated settings. Changes in the key value store not regarding to the service instance are ignored.

Add a New Key Value Pair¶

In the Consul Web interface, click KEY/VALUE on the top of the page.
In the tree view on the left, navigate to the level where the new key is to be created, for example, dc/home/env/service/operator-server/tag/any/.
For adding a new key value pair, extend the level by the key, for example, LOG_LEVEL and specify its value, for example, DEBUG.
Click CREATE.

Hint - service restart

After starting a server instance, envconsul monitors the configuration changes in the key value store. After a setting has been changed, envconsul restarts the service instances with the updated settings. Changes in the key value store not regarding to the service instance are ignored.

Export and Import the Complete Configuration¶

With SEAL Print Client CLI, you can export the complete configuration from Consul to a YAML file and import a YAML file into Consul again. For more information, refer to Administrate the System Configuration.

Secure Consul¶

For how to secure Consul, refer to Secure Consul.