This section explains how the upgrade works and shows you which files are added and replaced during the process. For instructions on running the upgrade itself, see Upgrading to PingCentral 1.5.0.

How the upgrade works

The upgrade utility uses the extracted contents of the ping-central-1.5.0.zip file to copy and replace the appropriate information in the existing version installation location.

Files that were not modified since they were initially installed are overwritten with new versions during the upgrade process. Note the following:

  • The database files (h2-data directory), the log files (log directory), the external library files (ext-lib directory), and the host key file (conf/pingcentral.jwk) remain intact during the upgrade process to preserve user data.
  • If the application.properties file was modified, the current version of the file will be merged with the latest version, preserving customizations.
  • If the conf/log4j2.xml, bin/run.sh, and bin.run.bat files were modified, the new versions are installed and the old versions are renamed. Manually update the new files with customizations, as necessary.
The following image shows PingCentral 1.5.0 after it has been run and the database files that have been generated. It also shows which files are replaced with new files during the upgrade process.
A screen capture showing a side-by-side comparison of PingCentral 1.5.0 after it has been run and earlier versions of PingCentral with the database files that have been generated for PingCentral 1.5.0. It also shows which files are replaced with new files during the upgrade process using arrows.