Assume that an existing version of the PingDirectoryProxy server is stored in the PingDirectoryProxy-old directory.

  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 PingDirectoryProxy-new directory.
  3. Use the --version option on any command-line utility to check the version number of the PingDirectoryProxy server instance that you downloaded in step 2.

    You should see the latest revision number.

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

    Use the --serverRoot option to specify the PingDirectoryProxy server instance that you're upgrading.

    $ PingDirectoryProxy-new/update --serverRoot PingDirectoryProxy-old
    Note:

    The PingDirectoryProxy server provides a web-based administrative console for configuring and monitoring the server. If you update the server version, you should also update the administrative console.

    Note:

    You must stop the PingDirectoryProxy 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 labeled with the version number and revision.

    $ view <server-root>/history/1272307020420-9.0.0.0.9235/update.log