Restore AIR Backup using the CLI

How to restore from an AIR backup (.abf) using the CLI

Follow these commands to restore your AIR backup using the CLI.

This procedure applies to both Single-tier and 2-tier systems and is performed on the Console server.

---

1. Pre-Restore Setup

• Install a fresh AIR Console (choose Single-tier or 2-tier based on your needs).

Important: After installation, do not access the UI for first-time setup until you have completed the steps below.

---

2. Transfer and Copy the Backup File

• Use your preferred file transfer tool to transfer your backup file to the new server.

• Ensure the file has the .abf extension (e.g., 23-8-14_16.43.5.216_v3.abf).

• Copy the backup file from the host system to the APP container: docker cp <backup_file.abf> binalyze-air-app-1:/binalyze-air/

---

3. Retrieve AIR DB URIs (For Two-Tier Installations Only)

• If using a 2-tier system, retrieve the AIR DB connection strings by running: cat /opt/binalyze-air/.env

• These URIs will be needed for validation in the next step.

---

4. Run the AIR-CLI to Restore the Backup

Execute the CLI tool with: sudo docker exec -ti binalyze-air-app-1 /air-cli

In the AIR-CLI interface, select:

"1) Restore using a backup file"

When prompted, enter the directory and filename where the backup file was copied, for example: /binalyze-air/23-8-14_16.43.5.216_v3.abf

Press Enter through the default options until you see the confirmation message: "This operation will drop your current database and restore the provided backup. Are you sure to continue?" Type 'y' and press Enter to continue.

---

5. Finalize the Restore Process

Once the restore completes successfully, a confirmation message will appear.

Exit the container by typing: Exit

Restart the containers by running: cd /opt/binalyze-air

docker compose down && docker compose up -d

---

Don't hesitate to get in touch with [email protected] if you have any problems or questions about the restoration process