[FIXED] How to Restore Octopus Deploy Database from a previous backup file

Issue

After an unplanned power cut, we have been unable to view details of all previous deployments via Octopus deploy. We attempted to restore the database using raven db studio to no avail. we basically get an error as in the screenshot

I'm wondering what the recommended way is , for performing backup restore. ATM we cannot view details on the environments, projects and dashboard pages. They all come back blank. All our projects are not visible via the projects drop-down menu as well.

Any help will be appreciated.

Solution

Prior to Octopus 2.0, the backup files produced by Octopus (*.octobak files) are RavenDB exports, not backups - this is because RavenDB backups really only work on the same/similar machine that created them, while exports can be imported on any machine.

However, you shouldn't perform the restore directly in RavenDB - we have a wizard for doing this:

https://octopus.com/docs/administration/backup-and-restore

The section on restore assumes you are restoring to a new server, but the process is exactly the same when restoring on an existing server. Hope this helps!

Answered By - Paul Stovell

Answer Checked By - Mary Flores (PHPFixing Volunteer)