Skip to content

Consul

The configuration of the SEAL Operator 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

Hint - no Internet Explorer 11

Do not use Internet Explorer 11 for changing the configuration in Consul due to Internet Explorer 11 displays the previous setting even after it has been changed successfully in Consul.

Keys and Values

The keys in the key value store are structured hierarchically. For example, the settings of a SEAL Operator 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 keys available for SEAL Operator are listed in the Keys reference.

Change the Value of an Existent Key

  1. In the Consul Web interface, click KEY/VALUE on the top of the page.

  2. In the tree view on the left, navigate to the level of the key, for example, dc/home/env/service/any/tag/any.

  3. For changing an existent key, select the key, for example, CONSUL_TOKEN and specify its new value.

  4. 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

  1. In the Consul Web interface, click KEY/VALUE on the top of the page.

  2. 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/.

  3. For adding a new key value pair, extend the level by the key, for example, LOG_LEVEL and specify its value, for example, DEBUG.

  4. 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 Operator 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 on Windows or Secure Consul on Linux.

Back to top