Latest release

After completing the recommended pre-upgrade preparations, follow the instructions below to upgrade Plixer Scrutinizer to the latest version.

Note

• Only deployments on v19.5.3 (v19.5.4 for AWS AMIs) can be upgraded directly to v19.6.0 and beyond. For older versions, follow the steps in these guides to upgrade to the required Plixer Scrutinizer 19.5.x release before upgrading to the latest version.

• When upgrading to v19.6.0 from any previous version, a different NTP server address (e.g., if the Plixer Scrutinizer server cannot access the Internet) can be configured by running the following:

  sed -i -e '/^pool/aserver NTP_ADDRESS' -e 's/^pool/#&/' /etc/chrony.conf
  

• After Plixer Scrutinizer has been upgraded to v19.6.0 or higher, any Plixer ML Engine deployments must also be upgraded to v19.5.0 or the latest available version. This will enable the integrated management and configuration options in the Plixer Scrutinizer web interface.

Online upgrades

To download and install the latest version upgrade for Plixer Scrutinizer, follow these steps (UPGRADE_VER should be replaced with the target version for the upgrade, e.g., 19.6.0):

1. SSH to the primary reporter as the plixer user and start a new tmux session:

   tmux new -s upgrade
   

2. Download the installer for the latest version:

   cd /tmp
   curl -o scrutinizer-install.run https://files.plixer.com/plixer-repo/scrutinizer/UPGRADE_VER/scrutinizer-install.run
   

3. Download the checksum file and validate the integrity of scrutinizer-install.run:

   curl -o scrutinizer-checksums.txt https://files.plixer.com/plixer-repo/scrutinizer/UPGRADE_VER/scrutinizer-checksums.txt
   cat scrutinizer-checksums.txt
   sha256sum scrutinizer-install.run
   

4. Set the correct permissions for the installer:

   sudo chmod 755 scrutinizer-install.run
   

5. Run the installer as the root, plixer (recommended), or ec2-user (for AWS AMI upgrades) user:

   ./scrutinizer-install.run
   

6. [Distributed cluster upgrades only] When prompted for the authentication method to use for remote collectors in the cluster, enter either existing (recommended) or passwords.

7. After the installer finishes running, execute the following heartbeat checks to verify communication between nodes:

   scrut_util --check heartbeat --type database
   scrut_util --check heartbeat --type api
   

If the heartbeat checks are successful, the upgrade is complete.

AWS AMI upgrades only

• To obtain a copy of the AMI installer, contact Plixer Technical Support.

• Run the following to apply other permission requirements before running the installer:

  sudo chmod 755 /home/ec2-user
  

Offline upgrades

To upgrade Plixer Scrutinizer collectors/servers that are unable to access https://files.plixer.com, an offline repository can be created on the primary reporter.

To set up the offline repository and start the upgrade process, follow these steps (UPGRADE_VER should be replaced with the target version for the upgrade, e.g., 19.6.0):

Note

• To upgrade an AWS AMI deployment, see these additional notes.

• For questions or assistance, contact Plixer Technical Support.

1. Perform a backup of the current Plixer Scrutinizer install as described in the recommended upgrade preparation steps.

2. Download https://files.plixer.com/plixer-repo/scrutinizer/UPGRADE_VER_offline.tgz to a computer with Internet access.

3. Download https://files.plixer.com/plixer-repo/scrutinizer/UPGRADE_VER-checksum-offline.txt and validate the checksum of the .tar file.

4. Start an SSH session with the primary reporter as the plixer user.

5. Confirm that the primary reporter has at least 84 GB of free disk space under /var/db/big:

   df -h
   

6. Create a new directory for the offline installation files and set the correct permissions to give the plixer user access to it:

   sudo mkdir /var/db/big/offline
   sudo chown plixer:plixer /var/db/big/offline
   

7. Copy the .tar file to the new directory:

   scp UPGRADE_VER_offline.tgz [email protected]:/var/db/big/offline/UPGRADE_VER_offline.tgz
   

8. Extract the contents of the file to the same directory (this will exhaust all available storage on the appliance):

   sudo tar -zxvf /var/db/big/offline/UPGRADE_VER_offline.tgz -C /var/db/big/offline
   

9. Create a symlink to the offline directory from the html directory, so the files can be served by Apache:

   sudo ln -s /var/db/big/offline/plixer-repo /home/plixer/scrutinizer/html/plixer-repo
   

10. From the appliance to be upgraded, download the installer from the offline repository:

curl -o scrutinizer-install.run -L -k https://127.0.0.1/plixer-repo/scrutinizer/UPGRADE_VER/scrutinizer-install.run

11. Download the checksum file and validate the integrity of the scrutinizer-install.run file.

curl -o scrutinizer-checksums.txt -k https://127.0.0.1/plixer-repo/scrutinizer/UPGRADE_VER/scrutinizer-checksums.txt

cat scrutinizer-checksums.txt

sha256sum scrutinizer-install.run

12. Set the correct permissions for the installer.

sudo chmod 755 scrutinizer-install.run

13. Run the installer as the root, plixer (recommended), or ec2-user (for AWS AMI upgrades) user, replacing x.x.x.x with the IP address or hostname of the offline repository host:

REPO_HOST=x.x.x.x
LOCAL_REPO_BASEDIR=/var/db/big/offline
./scrutinizer-install.run -- -k

14. Distributed cluster upgrades only - When asked how the installer should log in to remote collectors in the cluster, enter either existing (recommended) or passwords.

15. After the installer has finished running, the following heartbeat checks should be run to verify that all nodes (including standalone deployments) are able to communicate normally:

scrut_util --check heartbeat --type database
scrut_util --check heartbeat --type api

If all heartbeat checks are successful, then the systems have been upgraded successfully.