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.
    Note:

    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
                  8.1.0.0 
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
    Note:

    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.

    Note:

    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-8.1.0.0.9235/update.log