Hyperglance "Update 1-2025" upgrade guide

Here are some commonly asked questions about this guide

Is this update guide for me?

Do you host your Hyperglance deployment as a AWS Instance, Azure VM or GCP VM and you want to do an in-place upgrade? Then yes this update is for you.

You can check if your system is requires this upgrade by SSHing in and running this command:

 cat /etc/docker-compose.yml | grep wildfly-v2

If you see a line like this then your system is already up-to-date and there is nothing else you need to do:

    image: hyperglance/wildfly-v2:latest

However if you do not see any result then this update needs to be applied.

Learn more about "Update 1-2025", what it is and why it's important.

What do I need and how difficult is it?

Difficulty:

Low
We have provided step-by-step the commands so you can copy and paste them one at a time (Linux skills not required).
If you get stuck please reach out to us.

Prerequisites:

You'll need terminal access to your Hyperglance instance or VM.
Your VM will need internet access to pull down Ubuntu updates and Hyperglance application updates.

Time required:

Updating Ubuntu takes approximately 30 mins

Could I create a new Hyperglance deployment instead?

Yes you could do that! This guide is for upgrading an existing deployment of Hyperglance in-place.

Upgrade Guide:

Part 1 - Prepare your deployment

Consider snapshotting the AWS/GCP/Azure instance or VM first.
Run this command to stop the Hyperglance services and prune old container images to free up disk space:
```
sudo docker-compose -f /etc/docker-compose.yml down && sudo docker image prune -af
```
Run this command to delete database activity logs to free up disk space:
```
sudo find /var/lib/data/postgresql/logs -mindepth 1 -delete
```

[Optional but recommended] Run this command to create a backup of all Hyperglance data:

sudo tar cvf - /var/lib/data/hyperglance /var/lib/data/postgresql /var/lib/data/httpd /usr/local/hyperglance | sudo gzip -9 - > ~/hg-backup.tgz

Part 2 - Update host OS from Ubuntu 20.04

We have written an instructional guide on updating Ubuntu for Hyperglance.
NOTE: If you're not sure what OS is running the guide will help you check.

If you you are using Ubuntu Pro, Ubuntu 22.04 (or newer) or another OS like RHEL then continue on to the next section below.

Part 3 - Update Hyperglance app

Run this command to download and run our update tool:

sudo docker run --rm -it \
     -v ./upgrade-logging:/root/upgrade-logging/ \
     -v /usr/local/bin:/root/mapped/usr/local/bin \
     -v /etc:/root/mapped/etc \
     -v /usr/local/hyperglance:/usr/local/hyperglance \
      hyperglance/updatetool:update-1-2025 -c "./upgrade.sh"

A successful run will output logging like this:

Unable to find image 'hyperglance/updatetool:update-1-2025' locally
update-1-2025: Pulling from hyperglance/updatetool
30a9c22ae099: Pull complete
cb502dd50c06: Pull complete
a101683ae6ae: Pull complete
87df8f10f917: Pull complete
e65798997a00: Pull complete
24a371c0991b: Pull complete
33346c985f9e: Pull complete
4f4fb700ef54: Pull complete
Digest: sha256:be1ed295f77acdc7ec1565c99f3c78fbd89e33b6ca4837754c5d330156beeb71
Status: Downloaded newer image for hyperglance/updatetool:update-1-2025
[INFO] Current Version: 1.26.0 , New Version: 2.34.0. docker-compose will be upgraded.
[INFO] Updating defaults.env with DEPLOYMENT_TARGET
[INFO] Backing up original docker-compose.yml
[INFO] Transformed file written to: /root/mapped/etc/docker-compose.yml
[INFO] Upgrade complete. Run the following command to redeploy hyperglance:
[INFO] sudo docker-compose -f /etc/docker-compose.yml pull && sudo docker-compose -f /etc/docker-compose.yml up -d

Run this command to start Hyperglance:
```
sudo docker-compose -f /etc/docker-compose.yml pull && sudo docker-compose -f /etc/docker-compose.yml up -d
```
After this command finishes Hyperglance will still be booting, it could another 5 minutes before Hyperglance is reachable in your browser again.