Configure and Start the Configuration Microservice

This applies to: Visual Data Discovery

To install, configure, and start the Symphony configuration microservice:

  1. Verify that you have set up a PostgreSQL metastore or a GitHub repository to store the property metadata. See Set Up the Configuration Microservice Metadata Store or Repository.

  2. Open the SSH client associated with your Symphony instance.

  3. Configure all installed and enabled Symphony microservices to use the Symphony configuration microservice. Run the following script:

    for i in $(systemctl list-unit-files | grep zoomdata | grep enabled | awk '{print $1}'|sed -e 's/\.service/.properties/g' -e 's/zoomdata\-//g');
    do
    echo "config-server.enabled=true">>/etc/zoomdata/$i;
    done

  4. Each Symphony microservice supports two configuration properties related to the configuration microservice:

    • config-server.enabled: Enables or disables integration with the configuration microservice. Valid values are true (enable integration) and false (disable integration). The default is true.

    • config-client.retry.max-attempts: Sets the maximum number of attempts that should be made to connect to the configuration microservice. The default is 20. The Symphony microservice will fail if the number of attempts to connect to the configuration microservice exceeds this value. This property is useful in situations where the configuration microservice starts with a delay. If your Symphony microservice fails while waiting for the configuration microservice and you want to give it more time, increase this value.

    Update these properties, as appropriate, for each microservice.

  5. Install, enable and start the Symphony configuration microservice. Enter the following commands:

    sudo yum install zoomdata-config-server \
    && systemctl enable zoomdata-config-server \
    && systemctl start zoomdata-config-server

    After starting the configuration microservice with a valid database configuration, the microservice should connect to the database and create a properties table.

  6. Restart all the other Symphony microservices. Enter the following command:

    sudo systemctl restart $(systemctl list-unit-files | grep zoomdata | grep enabled | awk '{print $1}')

    See also Restart Symphony Microservices.