Assume that an existing version of the Directory Proxy Server is stored at PingDirectoryProxy-old, which you want to update.

  1. Make sure you have complete, readable backup of the existing system before upgrading the Directory Proxy Server build. Also, make sure you have a clear backout plan and schedule.
  2. Download the latest version of the PingDirectoryProxy Server software and unzip the file. For this example, let’s assume the new server is located in the PingDirectoryProxy-new directory.
  3. Check the version number of the newly downloaded Directory Proxy Server instance using the --version option on any command-line utility. For example, you should see the latest revision number.
    $ PingDirectoryProxy-new/setup --version PingDirectoryProxy Server
                      8.0.0.0 
    Build 2011043200609Z Revision 9235
  4. Use the update tool of the newly unzipped build to update the Directory Proxy Server code. Make sure to specify the Directory Proxy Server instance that you are upgrading with the --serverRoot option. The Directory Proxy Server must be stopped for this update to be applied.
    $ PingDirectoryProxy-new/update --serverRoot PingDirectoryProxy-old
    Note: The PingDirectoryProxy Server provides a web console called the Administrative Console, to configure and monitor the server. If you update the Directory Proxy Server version, you should also update the Administrative Console.
  5. View the log file to see which files were changed. The log file is located in the <server-root>/history directory. For example, the file will be labelled with the Directory Proxy Server version number and revision.
    $ view <server-root>/history/1272307020420-8.0.0.0.9235/update.log