Upgrading to v19.1.0¶

Because Plixer Replicator v19.1.0 includes an OS update, v19.0.1 is required for the upgrade. If you are running an older version, follow this guide to upgrade your appliance to v19.0.1.

For assistance or clarifications, contact Plixer Technical Support.

Important notes¶

The upgrade will take at least one hour to complete.
If the Plixer Replicator appliance is able to access files.plixer.com, the REPO_HOST variable should be set to files.plixer.com for the steps outlined below. For offline upgrades, the IP address of the offline repo should be used instead.
Due to an increase in minimum specs, older VMs with 2 GB of RAM should be provisioned with 4 GB RAM before the upgrade.
The upgrade requires a minimum of 16 GB free space on root (/). There may be older logs (sudo rm /var/log/messages-*) that can be deleted to free up space.

Upgrade process¶

The process of upgrading a v19.0.1 Plixer Replicator appliance to v19.1.0 involves the following steps:

Backing up the v19.0.1 database and server-specific files using the backup interactive mode command
Downloading the operating system upgrade script, olmigrate.run, and running it a total of four times (with a reboot between runs)
Downloading and running the Plixer Replicator v19.1.0 installation script (replicator-install.run)
Verifying that the v19.0.1 data has been successfully migrated after v19.1.0 is installed

Pre-upgrade preparation¶

[Hardware appliances] Create a backup of the current Plixer Replicator appliance using the backup interactive mode command (under /home/replicator/backups) and store it on an external system/drive.
[Virtual appliances] Backup the current Plixer Replicator install by taking a VM snapshot.
Confirm the current password for the replicator SSH user (run passwd replicator)

Verify that root login is disabled by running:

sudo sed -i 's/^#PermitRootLogin.*/PermitRootLogin no/g' /etc/ssh/sshd_config

[Offline upgrades] If the Plixer Replicator appliance does not have access to files.plixer.com, set up an offline repository for this upgrade.

Upgrading the server¶

Once all preparation steps have been completed, follow these steps to upgrade the appliance:

Important

For offline upgrades, REPO_HOST should point to the IP address of the offline repo instead of files.plixer.com.
In high-availability configurations, complete the upgrade for the secondary appliance before the primary.
To verify the current progress of the OS upgrade at any time:
```
cat /etc/motd
```
or check versions between runs (NAME= and VERSION= lines):
```
cat /etc/os-release
```

SSH to the v19.0.1 appliance to be upgraded as the replicator user.
Verify that the current working directory is correct (replicator):
```
cd /home/replicator/
```

Download the OS upgrade script and its checksum file:

REPO_HOST=files.plixer.com
curl -k -o olmigrate.run https://$REPO_HOST/plixer-repo/replicator/19.1.0/olmigrate.run
curl -k -o olmigrate.run.sha256 https://$REPO_HOST/plixer-repo/replicator/19.1.0/olmigrate.run.sha256

Validate the integrity of olmigrate.run:

cat olmigrate.run.sha256
sha256sum olmigrate.run

Set the correct permissions for the OS upgrade script:
```
chmod a+x olmigrate.run
```
Run the olmigrate.run script a total of four times:
```
REPO_HOST=files.plixer.com ./olmigrate.run -- -k
```
Important

Reboots between runs of the OS upgrade script (olmigrate.run) can take a long time. Before trying to reconnect to the appliance, start a PING to the Plixer Replicator IP address and wait for it to become available again. Do NOT manually reboot the server.
After the fourth olmigrate.run run (there will be no reboot), change directories to /tmp for the installation of Plixer Replicator v19.1.0:
```
cd /tmp/
```

Download the Plixer Replicator v19.1.0 installation script and its checksum file:

REPO_HOST=files.plixer.com
curl -k -o replicator-install.run https://$REPO_HOST/plixer-repo/replicator/19.1.0/replicator-install.run
curl -k -o replicator-install.run.sha256 https://$REPO_HOST/plixer-repo/replicator/19.1.0/replicator-install.run.sha256

Validate the integrity of replicator-install.run:

cat replicator-install.run.sha256
sha256sum replicator-install.run

Update permissions for the replicator-install.run script:

chmod a+x replicator-install.run

Run replicator-install.run to install Plixer Replicator v19.1.0:

REPO_HOST=files.plixer.com ./replicator-install.run -- -k

After the installation script finishes running, reboot the appliance:

sudo shutdown -r now

After the reboot, SSH to the appliance again to reset the password for the admin UI user:

manage --cli
password webui

After completing the above steps, the Plixer Replicator appliance will be on v19.1.0.

Offline upgrades to v19.1.0¶

The following instructions for setting up an offline repo are intended for upgrading to Plixer Replicator v19.1.0 only.

Deploy a new Plixer Scrutinizer v19.5.0 VM and assign an IP address to it.
SSH to the VM as the plixer user:
```
ssh plixer@SCRUTINIZER_VM_IP
```

Create the offline repo directory and assign it the correct permissions:

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

Download the offline tar file for Plixer Replicator 19.1.0 and its checksum file:

curl -o /var/db/big/offline/19.1.0_offline.tgz https://files.plixer.com/plixer-repo/replicator/19.1.0_offline.tgz
curl -o /var/db/big/offline/19.1.0_offline.tgz.sha256 https://files.plixer.com/plixer-repo/replicator/19.1.0_offline.tgz.sha256

Validate the integrity of 19.1.0_offline.tgz:

cat /var/db/big/offline/19.1.0_offline.tgz.sha256
sha256sum /var/db/big/offline/19.1.0_offline.tgz

Extract the offline tar file:

cd /var/db/big/offline
tar xvf 19.1.0_offline.tgz

Create a symlink in the html directory to the offline repo:

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

After the offline repo has been set up, the VM’s IP address should be used in place of files.plixer.com for REPO_HOST in the upgrade instructions.