You can change the DAML index database password on deployed Client nodes to secure the connection between the DAML ledger and DAML index database.

Prerequisites

Identify the Client node IP addresses and the existing DAML index database password that you want to change.

Procedure

  1. SSH to the Client node using the root password.
  2. Connect to the DAML index database and change the password for the indexdb user.
  3. Get the DAML index database container ID and note down the port number.

    docker ps

  4. Retrieve the DAML index database IP address.

    docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <daml_index_db container ID>

  5. Log in to the DAML index database.

    psql -h <the-db-ip> -p <port> -U indexdb

  6. Enter the DAML index database's existing password.
  7. Change the existing DAML index database password at the prompt.

    indexdb=# \password

  8. Enter the new password.
  9. Exit the DAML index database.

    indexdb=# \q

  10. Update the Client node configuration files with the new password using a text editor.
    • Update the DAML ledger API configuration file- /config/daml-ledger-api/environment-vars.

    • Update the DAML Index DB configuration file- /config/daml-index-db/environment-vars.

    • Update the Telegraf configuration file- /config/telegraf/telegraf.conf.

  11. Restart the Docker containers with the new password.
    docker restart <daml_ledger_api ID> <daml_index_db ID> <telegraf ID>
  12. Update the VMware Blockchain Orchestrator output file with the new Client node password.
    1. Open the VMware Blockchain Orchestrator output file.
    2. Search for the Client node IP address you updated with a new password.
    3. Add the new password to the corresponding Client node in the suggested pattern to the output file.
      Node Id: <node id>, 
      name: <location, sddc>, 
      key: DAML_DB_PASSWORD, 
      value: <new password>