The presence of the file server.uuid in the server’s config directory indicates whether the server is being set up initially or being updated.

  1. Create or obtain the topology.json file either manually or by using external automation. When promoting from a dev/test environment to a stage/prod environment, you can obtain a topology.json file using the manage-topology export subcommand.
  2. Unzip the new server bits to a directory.
  3. From the same directory, run the update tool to update the server instance, as follows:
    update --serverRoot /path/to/server-root \
      --bindDN bind-dn \
      --bindPassword bind-password
  4. From the same directory, replace the new server profile, as follows:
    manage-profile replace-profile \
      --profile /path/to/server-profile \
      --profileVariablesFile /path/to/instance-specific-variables.properties