Upgrading PC-lint Plus View
The PC-lint Plus View installation package can be used to upgrade an existing PC-lint Plus View installation. When an installation is upgraded, the following happens:
-
The new version of PC-lint Plus View server overwrites the previous one inside the same installation directory
-
The database is upgraded
-
The web server configuration is upgraded
-
The data files are migrated
-
All of your settings are kept, and a clean version of some configuration files is placed on your system next to the original file, with a .new extension. Here are the files:
-
<CLUSTER_DIR>/postgresql.conf
-
<PCLPVIEW_HOME>/config.xml
-
<PCLPVIEW_HOME>/server/bin/standalone.conf on Linux or <PCLPVIEW_HOME>/server/bin/standalone.conf.bat on Windows
-
<PCLPVIEW_HOME>/server/standalone/configuration/standalone.xml
-
<PCLPVIEW_HOME>/server/standalone/configuration/squore-server.properties
-
<PCLPVIEW_HOME>/server/standalone/configuration/application-users.properties
-
|
Upgrading to this PC-lint Plus View 25.1.0 version will only be possible if you are using one of the last 5 previous major versions. |
|
Having .new files can help you compare your files with the defaults from a clean installation. |
Prerequisites
When upgrading your PC-lint Plus View installation, it is strongly recommended to verify that you have all you need before starting.
-
You have a backup of your most recent data (Backing-Up PC-lint Plus View Data).
-
Around 50% of the current database size is available as additional free space on the machine hosting the database.
-
If you are using a remote database, the PC-lint Plus View server is stopped and the database is accessible and accepting connections.
|
Folders inside the installation directory are deleted during an upgrade. Ensure your <PCLPVIEW_DATA> folder or any other custom folders are not located inside your <PCLPVIEW_HOME> folder. |
|
If the upgrade fails, do not attempt a second upgrade in a row. Always restore the previous PC-lint Plus View installation and its data before attempting any other upgrade. |
|
The latest version of PC-lint Plus View installation package can be downloaded from Vector website’s Download Center. |
Linux
Before upgrading your PC-lint Plus View installation, make sure you check all the items on the list of prerequisites. Then proceed with the upgrade itself.
- Upgrade procedure
-
Extract the new installation package in the location of your choosing. For example:
tar -xf pclpview-25.1.0-linux-x86_64.tar.xz -C /tmp/pclpview-upgrade -
Upgrade your PC-lint Plus View installation by executing command:
/tmp/pclpview-upgrade/pclpview-server/bin/install -U <PCLPVIEW_HOME> [options...]No progress information is displayed on screen during the database upgrade phase, which may take a while to complete.
-
Delete the temporary upgrade folder once finished:
rm -rf /tmp/pclpview-upgrade
Docker
To upgrade PC-lint Plus View you must:
-
Stop the container.
-
Remove the container.
-
Start a new container with the latest image.
|
If you have existing data in a named volume, and you want to keep it, then you have to use the '-v' option. |
Windows
Upgrading an existing installation is not supported on Windows environment. You can however perform a backup of your data and follow the manual upgrade procedure in order to use the latest version of PC-lint Plus View.
Manual Upgrade
If the upgrade cannot be performed with the installation package, it is possible to upgrade PC-lint Plus View manually on both Windows and Linux.
Before proceeding with the upgrade:
-
Create a backup of your current PC-lint Plus View installation
-
Install a fresh PC-lint Plus View, from scratch, in the version you wish to upgrade to.
|
If you are using a remote database, backup and restore operations cannot be done automatically and are of the database administrator responsibility. |
Then, follow the procedure below:
-
Stop PC-lint Plus View :
<PCLPVIEW_HOME>/bin/sqctl stop -
Start database :
<PCLPVIEW_HOME>/bin/sqctl start postgresql -
Restore your backup : refer to the Restoring PC-lint Plus View Data section.
-
Upgrade your database, where version is the PC-lint Plus View version the restored backup is coming from:
<PCLPVIEW_HOME>/bin/sqadm upgrade-data *version*
|
sqadm upgrade-data command runs silently. It can take from a few minutes to a few hours, depending on the amount of data to migrate, the version you are coming from and your hardware performances. |
|
The manual upgrade procedure will not keep your configuration changes such as LDAP, JAVA XMX parameter and such. Be sure to report manually all these changes afterward. Here is a non-exhaustive list of configuration files that are usually modified :
|