Restore Database
Note:
If you're restoring a backup to a new Apstra server that uses a different network
interface for access (eth1 vs eth0 for example), you must update the
metadb
variable in the [controller]
section of the /etc/aos/aos.conf
configuration file, then
restart the Apstra server.
-
Verify that the contents of the snapshot folder are on the filesystem. In the
example below, we have copied the restoration data to
/tmp/aos_test_restore
.admin@aos-server:~$ sudo ls -lah /var/lib/aos/snapshot/2021-07-28_20-56-26/ total 21M drwx------ 2 root root 4.0K Jul 28 20:56 . drwx------ 5 root root 4.0K Jul 28 20:58 .. -rw------- 1 root root 21M Jul 28 20:56 aos.data.tar.gz -rwxr-xr-x 1 root root 1.3K Jul 28 20:56 aos_restore -rw------- 1 root root 1 Jul 28 20:56 comment.txt admin@aos-server:~$
-
Run the
aos_restore
command as illustrated below. The restore process first backs up the current database.admin@aos-server:~$ sudo bash /var/lib/aos/snapshot/2021-07-28_20-56-26/aos_restore ==================================================================== Backup operation completed successfully. ==================================================================== New AOS snapshot: 2020-07-28_20-58-54 (Reading database ... 110457 files and directories currently installed.) Removing aos-compose (3.3.0-660) ... Processing triggers for ureadahead (0.100.0-21) ... Processing triggers for systemd (237-3ubuntu10.41) ... tar: Removing leading `/' from member names /etc/aos/aos.conf /etc/aos-credential/secret_key /var/lib/aos/db/ /var/lib/aos/db/_Main-000000005f1f7314-000dd7b1-checkpoint /var/lib/aos/db/_AosController-000000005f1f7314-00035dd2-checkpoint-valid /var/lib/aos/db/_Central-000000005f1f7313-000ab5f7-checkpoint-valid /var/lib/aos/db/_Metadb-000000005f1f7312-000a27e1-checkpoint /var/lib/aos/db/_AosSysdb-000000005f1f7312-000a31be-checkpoint-valid /var/lib/aos/db/_Credential-000000005f1f7312-000ea6ba-log /var/lib/aos/db/_Central-000000005f1f7313-000ab5f7-log /var/lib/aos/db/_Auth-000000005f1f7313-0001e8cf-log-valid /var/lib/aos/db/_Metadb-000000005f1f7312-000a27e1-log-valid /var/lib/aos/db/_Auth-000000005f1f7313-0001e8cf-checkpoint-valid /var/lib/aos/db/_Metadb-000000005f1f7312-000a27e1-checkpoint-valid /var/lib/aos/db/_Main-000000005f1f7314-000dd7b1-log /var/lib/aos/db/_Auth-000000005f1f7313-0001e8cf-log /var/lib/aos/db/_Metadb-000000005f1f7312-000a27e1-log /var/lib/aos/db/_AosSysdb-000000005f1f7312-000a31be-log-valid /var/lib/aos/db/_AosAuth-000000005f1f7312-000a0e46-log-valid /var/lib/aos/db/_AosSysdb-000000005f1f7312-000a31be-log /var/lib/aos/db/blueprint_backups/ /var/lib/aos/db/blueprint_backups/37321b9c-25b1-4111-849b-522a3852949d/ /var/lib/aos/db/blueprint_backups/37321b9c-25b1-4111-849b-522a3852949d/48/ /var/lib/aos/db/blueprint_backups/37321b9c-25b1-4111-849b-522a3852949d/48/graph.json.zip /var/lib/aos/db/blueprint_backups/37321b9c-25b1-4111-849b-522a3852949d/48/graph.md5sum /var/lib/aos/db/_Credential-000000005f1f7312-000ea6ba-log-valid /var/lib/aos/db/_Credential-000000005f1f7312-000ea6ba-checkpoint /var/lib/aos/db/_Main-000000005f1f7314-000dd7b1-checkpoint-valid /var/lib/aos/db/_Central-000000005f1f7313-000ab5f7-log-valid /var/lib/aos/db/_AosController-000000005f1f7314-00035dd2-log-valid /var/lib/aos/db/_AosAuth-000000005f1f7312-000a0e46-checkpoint-valid /var/lib/aos/db/_AosSysdb-000000005f1f7312-000a31be-checkpoint /var/lib/aos/db/_AosController-000000005f1f7314-00035dd2-checkpoint /var/lib/aos/db/_AosAuth-000000005f1f7312-000a0e46-checkpoint /var/lib/aos/db/.devpi/ /var/lib/aos/db/.devpi/server/ /var/lib/aos/db/.devpi/server/.nodeinfo /var/lib/aos/db/.devpi/server/.secret /var/lib/aos/db/.devpi/server/.sqlite /var/lib/aos/db/.devpi/server/.serverversion /var/lib/aos/db/.devpi/server/.event_serial /var/lib/aos/db/_AosController-000000005f1f7314-00035dd2-log /var/lib/aos/db/_Main-000000005f1f7314-000dd7b1-log-valid /var/lib/aos/db/_Central-000000005f1f7313-000ab5f7-checkpoint /var/lib/aos/db/_Auth-000000005f1f7313-0001e8cf-checkpoint /var/lib/aos/db/_Credential-000000005f1f7312-000ea6ba-checkpoint-valid /var/lib/aos/db/_AosAuth-000000005f1f7312-000a0e46-log /var/lib/aos/anomaly/ /var/lib/aos/anomaly/_Anomaly-000000005f1f7313-00060aba-log /var/lib/aos/anomaly/_Anomaly-000000005f1f7313-00060aba-checkpoint-valid /var/lib/aos/anomaly/_Anomaly-000000005f1f7313-00060aba-log-valid /var/lib/aos/anomaly/_Anomaly-000000005f1f7313-00060aba-checkpoint /opt/aos/aos-compose.deb /opt/aos/frontend_images/ /opt/aos/frontend_images/aos-web-ui.zip Selecting previously unselected package aos-compose. (Reading database ... 110440 files and directories currently installed.) Preparing to unpack /opt/aos/aos-compose.deb ... Unpacking aos-compose (3.3.0-660) ... Setting up aos-compose (3.3.0-660) ... Processing triggers for ureadahead (0.100.0-21) ... Processing triggers for systemd (237-3ubuntu10.41) ... Starting aos_sysdb_1 ... done Starting aos_controller_1 ... done Starting aos_nginx_1 ... done Starting aos_auth_1 ... done Starting aos_metadb_1 ... done admin@aos-server:~$
-
When the database has been restored and migrated to a new server, the entire
system state has been copied from the backed up installation to the new target.
Run the command
service aos status
to validate the restoration.admin@aos-server:~$ sudo service aos status * aos.service - LSB: Start AOS management system Loaded: loaded (/etc/init.d/aos; generated) Active: inactive (dead) Docs: man:systemd-sysv-generator(8) Jul 28 00:36:32 aos-server aos[1078]: [240B blob data] Jul 28 00:36:32 aos-server systemd[1]: Started LSB: Start AOS management system. Jul 28 02:45:45 aos-server systemd[1]: Stopping LSB: Start AOS management system... Jul 28 02:45:46 aos-server aos[4968]: Stopping aos_controller_1 ... Jul 28 02:45:46 aos-server aos[4968]: Stopping aos_metadb_1 ... Jul 28 02:45:46 aos-server aos[4968]: Stopping aos_auth_1 ... Jul 28 02:45:46 aos-server aos[4968]: Stopping aos_sysdb_1 ... Jul 28 02:45:46 aos-server aos[4968]: Stopping aos_nginx_1 ... Jul 28 02:45:58 aos-server aos[4968]: [240B blob data] Jul 28 02:45:58 aos-server systemd[1]: Stopped LSB: Start AOS management system. admin@aos-server:~$ docker ps -a CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 8bc9c1dd7a3a aos:3.3.0-660 "/usr/bin/aos_launch…" About a minute ago Up About a minute iba141638ea b0191320d2bd aos:3.3.0-660 "/usr/sbin/aos_launc…" About a minute ago Up About a minute aos-offbox-172_20_34_8-f 136736759f45 aos:3.3.0-660 "/usr/sbin/aos_launc…" About a minute ago Up About a minute aos-offbox-172_20_34_10-f 00a12eb03ae5 aos:3.3.0-660 "/usr/sbin/aos_launc…" About a minute ago Up About a minute aos-offbox-172_20_34_11-f c9b18cd4f55a aos:3.3.0-660 "/usr/sbin/aos_launc…" About a minute ago Up About a minute aos-offbox-172_20_34_7-f 90f35781d2a0 aos:3.3.0-660 "/usr/sbin/aos_launc…" About a minute ago Up About a minute aos-offbox-172_20_34_12-f f5c2d249176b aos:3.3.0-660 "/usr/sbin/aos_launc…" About a minute ago Up About a minute aos-offbox-172_20_34_9-f ab6c532a37ad aos:3.3.0-660 "/usr/bin/aos_launch…" 20 hours ago Up 2 minutes aos_controller_1 8e6fd8ae8f08 aos:3.3.0-660 "/usr/bin/aos_launch…" 20 hours ago Up 2 minutes aos_metadb_1 5b6359e21386 aos:3.3.0-660 "/usr/bin/aos_launch…" 20 hours ago Up 2 minutes aos_auth_1 f665ce206f46 aos:3.3.0-660 "/usr/bin/aos_launch…" 20 hours ago Up 2 minutes aos_sysdb_1 335dec5fba44 nginx:1.14.2-upload-echo "nginx -g 'daemon of…" 20 hours ago Up 2 minutes aos_nginx_1 admin@aos-server:~$
-
The database is stored on the Apstra server itself. If the server needs to be
restored or if its disk image becomes corrupt, any backups/restores are lost
along with the Apstra server. We recommend that you periodically move
backups/restores off of the Apstra server to a secure location. Also, if you've
scheduled cron jobs to periodically backup the
database, make sure to rotate those files off of the Apstra server to keep the
Apstra server VM disk from becoming full. Copy the contents of the snapshot
directory to your backup infrastructure.
admin@aos-server:~$ sudo ls -lah /var/lib/aos/snapshot/ total 20K drwx------ 5 root root 4.0K Jul 28 20:58 . drwxr-xr-x 7 root root 4.0K Jul 28 02:43 .. drwx------ 2 root root 4.0K Jul 28 02:43 2021-07-28_02-43-12 drwx------ 2 root root 4.0K Jul 28 20:56 2021-07-28_20-56-26 drwx------ 2 root root 4.0K Jul 28 20:58 2021-07-28_20-58-54 admin@aos-server:~$