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

  1. Make a complete, readable backup of the existing system.

    Make sure you have a clear backout plan and schedule.

  2. Download the latest version of the PingDirectoryProxy software and extract the file.
    Assume the new server is located in the PingDirectory-new directory.
  3. Use the --version option on any command-line utility to check the version number of the Directory Proxy Server instance that you downloaded in step 2.

    You should see the latest revision number.

    $ PingDirectory-new/setup --version PingDirectoryProxy
    Build 2011043200609Z Revision 9235
  4. Run the update tool of the newly extracted build to update the Directory Proxy Server code.

    Use the --serverRoot option to specify the Directory Proxy Server instance that you're upgrading.

    $ PingDirectory-new/update --serverRoot PingDirectory-old

    The PingDirectoryProxy provides a web-based Administrative Console for configuring and monitoring the server. If you update the Directory Proxy Server version, you should also update the Administrative Console.


    You must stop the Directory Proxy Server to apply this update.

  5. To see which files are changed, go to the <server-root>/history directory and open the log file.

    The file is labelled with the version number and revision.

    $ view <server-root>/history/1272307020420-