→ Applies to: Hyperion 9.x and above

UPS Appliance Overview

The UPS (Uninterruptible Power Supply) appliance is a virtual machine (VM) running dedicated power-management software, such as APC PowerChute or CyberPower PowerPanel.

It communicates with the physical UPS hardware using network protocols (SNMP/IP) or USB connections, and is responsible for coordinating a graceful shutdown of virtual machines and the SynetoOS host during power outages.
This process helps prevent data loss, filesystem corruption, and service interruptions.

PREREQUISITES
■ Ensure the appliance is running Hyperion
■ Ensure below ports are opened:

UPS Monitor VM - Hardware Specifications

Deploy UPS Monitor VM

Step 1. Connect to SynetoOS appliance via SSH as admin

ssh admin@<your_ip_address_or_hostname>

Step 2. Become Super User

sudo su

Step 3. Download the package 

wget -P /tmp https://storage.googleapis.com/syneto_public_files/downloads/Syneto-Tools/Networking/ups-monitor-deploy-20260202.tar.gz

PACKAGE CONTENTS

ups-monitor-deploy-20260202/
├── ups-monitor.img.gz          # Compressed VM disk image
├── ups-monitor.img.gz.sha256   # SHA256 checksum of compressed image
├── ups-monitor.img.sha256      # SHA256 checksum of uncompressed image
└── deploy-to-syneto.sh         # Deployment script

Alternatively, a third-party tool (e.g. WinSCP) can be used to upload the file to the /tmp directory on the SynetoOS appliance

Step 4 Unzip the file

tar -xzvf /tmp/ups-monitor-deploy-20260202.tar.gz

Step 5. Navigate to the deployment file

cd ups-monitor-deploy-20260202

Step 6. Give permissions to deploy-to-syneto.sh file

chmod +x deploy-to-syneto.sh

Step 7. Run the script (replace <syneto_ip> and <admin_password> with the correct information)

./deploy-to-syneto.sh --image ups-monitor.img.gz --host <syneto_ip> --password <admin_password>

EXAMPLE

./deploy-to-syneto.sh --image ups-monitor.img.gz --host 192.168.5.5 --password Test.123 --name power-monitor --network "Production Network"

Optional parameters

File	Description
-i, --image FILE	Path to ups-monitor.img.gz
-h, --host HOST	SynetoOS IP or hostname
-p, --password PASS	SynetoOS admin password
-n, --name NAME	VM name (default: ups-monitor)
-P, --pool NAME	Storage pool name (auto-detected)
-c, --compute-host ID	Compute host ID (auto-detected)
-N, --network NAME	Network name (default: VM Network)
--no-power-on	Don't power on VM after deployment
--dry-run	Show results without executing
SYNETO_HOST	Alternative to --host
SYNETO_PASSWORD	Alternative to --password

IMPORTANT
If any errors occur, re-deploy by deleting the VM from the SynetoOS GUI and perform the deploy steps again.

Manage UPS Monitor VM

Step 1. Find UPS Monitor VM IP Address ("How to Find a UPS Monitor VM IP Address in Hyperion")

Step 2. Manage UPS Monitor VM ("How to Manage UPS Monitor VM in Hyperion")