Skip to content
English
More support
Contact us
  • There are no suggestions because the search field is empty.

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.

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.

If you want to launch a whole new Hyperglance instance or VM read these notes first:

NOTE 1: We are still in the process of publishing our pre-built images with this update included.  These will be rolling out over the next few days.  Check the list below for availability:

  • Installer based deployment - New Installer coming soon
  • AWS public AMIs - Available now via our Cloudformation and Terraform deployments.
  • AWS Marketplace AMIs - Coming soon
  • Azure Marketplace VM Images - Coming soon
  • GCP marketplace VM images - Coming soon

NOTE 2: If you want to migrate configuration from your old deployment can move the data disk from the old instance/VM to the new one. Follow the how-to articles [AWS | Azure]

NOTE 3: Once your new VM is created you will need to contact support@hyperglance.com to migrate your license key.

 

 

Upgrade Guide:

Part 1 - Prepare your deployment

  1. Consider snapshotting the AWS/GCP/Azure instance or VM first.

  2. 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
  3. Run this command to delete database activity logs to free up disk space: 
    sudo find /var/lib/data/postgresql/logs -mindepth 1 -delete

  4. [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

  1. 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
  2. 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.