Create a backup

Prerequisites

The QEMU Guest Agent enables communication between CubeCOS and the guest operating system (OS). It obtains relevant information from the guest OS and syncs and freezes the filesystem. The agent also suspends the guest, reconfigures the guest, and allows for the proper shutdown of guest machines. The agent enables CubeCOS to ensure snapshot and backup consistency by syncing and freezing the filesystem with the guest-fsfreeze-freeze and guest-fsfreeze-thaw operations.

Install the QEMU guest agent

1. Install the qemu-guest-agent through your chosen distribution's package manager.

   Installation for qemu-guest-agent

   # Ubuntu / Debian / Mint
   sudo apt install -y qemu-guest-agent
   
   # RHEL / CentOS / AlmaLinux / Rocky / Fedora
   sudo dnf install qemu-guest-agent -y
   
   # SUSE/ openSUSE
   sudo zypper install qemu-guest-agent

2. Enable and start the service.

   sudo systemctl enable --now qemu-guest-agent

3. Verify the status of the qemu-guest-agent

   Check that the agent is active without errors.

   sudo systemctl status qemu-guest-agent

   A sample status output

   ubuntu@demo-ubuntu:~$ systemctl status qemu-guest-agent.service
   ● qemu-guest-agent.service - QEMU Guest Agent
      Loaded: loaded (/usr/lib/systemd/system/qemu-guest-agent.service; static)
      Active: active (running) since Wed 2025-04-30 03:59:55 UTC; 2h 45min ago
      Main PID: 709 (qemu-ga)
         Tasks: 2 (limit: 4658)
      Memory: 1.4M (peak: 1.6M)
         CPU: 10ms
      CGroup: /system.slice/qemu-guest-agent.service
               └─709 /usr/sbin/qemu-ga
   
   Apr 30 03:59:55 demo-ubuntu systemd[1]: Started qemu-guest-agent.service - QEMU Guest Agent.

Create a volume backup

警告

To ensure the volume snapshot feature works properly, install the QEMU Guest Agent.

1. Goto Project > Volumes > Volumes, choose the volume from the list and select the CREATE BACKUP from the Actions column.

   

2. Enter the Backup Name & Container Name.

   

3. Goto Project > Volumes > Backups,The Backup has created sucessfully.