You can upgrade from PingCentral 1.2 through 1.6 directly to 1.7. To begin the upgrade, download and extract the contents of the 1.7 distribution file and run the upgrade utility for Windows or Linux, as appropriate.
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.7.
How the upgrade works
The upgrade utility uses the extracted contents of the ping-central-1.7.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.
- 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.7 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.