📖
TrilioVault for OpenStack
Policy-based backup, recovery, and disaster recovery service for OpenStack workloads using point-in-time snapshots and one-click restore.
Who Should Use TrilioVault
Describe the primary users of TrilioVault — OpenStack admins deploying and operating the service, backup administrators managing policies and schedules, and tenant users creating and restoring workload snapshots. Distinguish admin-level responsibilities from tenant-level self-service capabilities.
Concept
The Data Protection Challenge in OpenStack
Explain the gap TrilioVault fills — native OpenStack lacks comprehensive workload-level backup and recovery. Cover the risks of data loss, the complexity of protecting multi-VM application stacks, and the need for policy-driven automation, network topology backup, and cloud-portable recovery.
Concept
TrilioVault Architecture
Cover the four main software components (TVM appliance QCOW2, wlm-api nova extension on controllers, datamover on compute nodes, Horizon plugin), the HA cluster model (single-node or three-node with VIP/HAProxy/Pacemaker), service endpoint registration in Keystone, network topology (public URL, internal/backup network for data movement), and how TrilioVault acts as both a consumer and provider of OpenStack services.
Architecture
Core Concepts
Define the fundamental TrilioVault abstractions — Workload (a backup job protecting one or more VMs under a policy), Snapshot (a point-in-time capture of the full workload including compute, network topology, storage data, and metadata), Restore types (one-click and selective), incremental-forever backup via VAST (Virtual Snapshot Technology), retention policies, and the role of the File Recovery Manager for file-level access.
Concept
Getting Started
Provide a concise end-to-end orientation for a new operator — from deploying the TVM appliance and running the configurator, to registering the service endpoint, installing datamover and Horizon plugin, creating a first workload, taking a snapshot, and verifying a restore. Reference the support matrix for compatible OpenStack distributions and storage targets.
Tutorial
Deployment Guide
Cover the full deployment lifecycle including support matrix (OpenStack distributions, storage targets — NFS and S3), hardware and network requirements, preparing the environment, spinning up the TVM VM from the QCOW2 image, installing TrilioVault components on controller and compute nodes (including RHOSP10/Red Hat Director path and generic OpenStack distribution path), uploading the File Recovery Manager image, and the uninstall procedure.
Guide+5 sub-pages
CLI Reference
Document all workloadmgr CLI commands — workload-create, workload-list, workload-show, workload-snapshot, snapshot-list, snapshot-show, snapshot-delete, restore-list, restore-show, restore-delete, snapshot-mount, snapshot-unmount, filepath-search, enable-scheduler, disable-scheduler — with all flags, argument types, and examples derived from code.
CLI reference
Horizon Plugin User Guide
Guide for tenant users operating TrilioVault through the OpenStack Horizon dashboard. Cover navigation to the Backups panel, creating and managing workloads, creating on-demand snapshots, browsing snapshot details, performing one-click and selective restores, using file search (including regex path syntax and snapshot filtering), mounting snapshots to a File Recovery Manager, managing schedules, and configuring email notifications per tenant.
Guide
Troubleshooting
Cover systematic troubleshooting approaches for TrilioVault — understanding which service is responsible at each backup/restore phase (TVM cluster, dmapi, datamover), checking service health (wlm-workloads, wlm-api, wlm-scheduler systemd status, Pacemaker cluster status), verifying backup target mount availability, diagnosing nova:nova POSIX UID/GID alignment issues, TrilioVault Trustee RBAC role assignment errors, OpenStack quota issues for Cinder snapshots and volumes, and key log file locations.
Runbook
TrilioVault Appliance Administration
Cover day-two operations on the TVM appliance cluster — accessing the appliance dashboard, reconfiguring the cluster (adding nodes, changing network settings), changing the admin GUI password, reinitializing TrilioVault, setting the OpenStack service account password, and accessing available downloads (logs, packages) from the cluster dashboard.
Guide
Workload Policies
Explain admin-defined workload policies — how policies are created and managed in the Horizon admin area, what parameters they govern (retention count, full backup interval, snapshot frequency), and how policies are assigned to workloads by tenants. Distinguish from per-workload schedule configuration.
Guide
Admin Backup Management
Cover the Horizon admin-specific Backups area — viewing and managing workloads and snapshots across all tenants, enforcing policies, and administrative controls unavailable to standard tenant users.
Guide
Workload Import and Migration
Describe the process for importing existing workloads from another TrilioVault instance or migrating workloads between OpenStack clouds, including any metadata requirements and CLI/UI steps.
Guide
Disaster Recovery
Cover TrilioVault's disaster recovery capabilities — cross-cloud workload restoration, network topology restore (recreating networks, subnets, routers, ports, floating IPs from snapshot metadata), the manual step required to reconnect private networks to the public network, and prerequisites (tenant network space must be empty before topology restore). Include guidance on DR planning with RPO/RTO targets.
Guide
Release Notes
Document TrilioVault release history. For version 3.0 specifically cover S3 storage target support (FUSE-based with incremental-forever, retention policy, mountable snapshots), tenant network topology backup and restore, and the new HA cluster architecture with single-node and three-node deployment modes managed by Pacemaker and HAProxy.
Guide