Upgrading the PingDirectoryProxy server

About this task

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

Steps

Make a complete, readable backup of the existing system.

Make sure you have a clear backout plan and schedule.
Download the latest version of the PingDirectoryProxy software and extract the file.

Assume the new server is located in the PingDirectoryProxy-new directory.
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.

Example:

You should see the latest revision number.
```
$ PingDirectoryProxy-new/setup --version PingDirectoryProxy 9.0.0.0
Build 2011043200609Z Revision 9235
```

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.

Example:

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

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.

You must stop the PingDirectoryProxy server to apply this update.

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

Example:

The file is labeled with the version number and revision.
```
$ view  <server-root>/history/1272307020420-9.0.0.0.9235/update.log
```