The presence of the file server.uuid in the PingDirectory 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. Extract the new server bits to a directory.
  3. From the same directory's bin directory, replace the new server profile, as follows:
    manage-profile replace-profile \
      --profile /path/to/server-profile \
      --profileVariablesFile /path/to/instance-specific-variables.properties \
      --serverRoot /path/to/existing/server