Alteryx Server Admin study materials
Alteryx Server Admin study resources

The Backup That Restored Nothing

Alteryx Server Admin · Put your knowledge to work in context.

All case studies

The Backup That Restored Nothing

An admin backs up the Alteryx Server MongoDB and the Alteryx service configuration nightly. The backup script dumps the MongoDB database and copies the Alteryx System Settings and the RuntimeSettings.xml file to a network share. The backup has run successfully for six months. During a disaster recovery test, the admin restores MongoDB and the configuration files to a clean server, starts the Alteryx service, and finds that users can log in but all schedules are gone, and workflows that used saved data connections fail with credential errors. The admin confirms the MongoDB restore completed without errors.

1. What was missing from the backup, and why did schedules and credentials not survive?

Read the worked answer

The backup captured the MongoDB database and the service configuration, but the symptoms point to two gaps. First, schedules in Alteryx Server are stored in the MongoDB database, so if schedules are gone after a clean restore, the dump likely did not include the correct database or collection, or the restore targeted the wrong database name. The admin should verify the dump command specified the Alteryx database and that the restore used the same database name the service expects. Second, saved data connection credentials are encrypted with a key tied to the server's configuration. If the encryption key or the credential store was not backed up and restored, the restored server cannot decrypt the stored credentials, so connections fail even though the connection definitions exist.

The backup must include the full Alteryx database (including schedule and credential collections) and the encryption key material, and the restore procedure must place them where the service expects them before the service starts.

2. How should the admin validate the backup going forward?

Read the worked answer

A backup is only proven by a restore test. The admin should schedule periodic restore drills to a clean server and verify specific artifacts: user logins, the full list of schedules with correct owners and Run As settings, successful execution of a workflow that uses a saved data connection, and access to collections and permissions. The drill should be scripted and repeatable, and the results recorded. The backup script should also be changed to fail loudly if the dump does not contain the expected collections or if the key material is missing, rather than reporting success merely because the copy command exited zero.