Restore an AWS OpsWorks for Chef Automate Server from a Backup - AWS OpsWorks

Restore an AWS OpsWorks for Chef Automate Server from a Backup


AWS OpsWorks for Chef Automate reached end of life on May 5, 2024 and has been disabled for both new and existing customers. We recommend that existing customers migrate to Chef SaaS or an alternative solution. If you have questions, you can reach out to the AWS Support Team on AWS re:Post or through AWS Premium Support.

After browsing through your available backups, you can choose a point in time from which to restore your AWS OpsWorks for Chef Automate server. Server backups contain only configuration-management software persistent data (cookbooks, registered nodes, etc.). Performing an in-place restoration of a server (that is, restoring the existing AWS OpsWorks for Chef Automate server to a new EC2 instance) reregisters nodes that were registered at the time of the backup that you use to restore the server, and switches traffic to the new instance if restoration is successful, and the restored AWS OpsWorks for Chef Automate server state is Healthy. Restoring to a newly-created AWS OpsWorks for Chef Automate server does not maintain node connections. Restoring a server does not update minor versions of Chef software; it applies the same Chef versions and configuration-management data that are available in the backup that you choose.

Restoring a server typically takes more time than creating a new server; the time depends on the size of the backup you choose. After restoration is complete, the old EC2 instance remains in a Running or Stopped state, but only temporarily. It is eventually terminated.

In this release, you can use the AWS CLI to restore a Chef server in AWS OpsWorks for Chef Automate.


You can also run the restore-server command to change the current instance type, or to restore or set your SSH key if it is lost or compromised.

To restore a server from a backup
  1. In the AWS CLI, run the following command to return a list of available backups and their IDs. Make a note of the ID of the backup that you want to use. Backup IDs are in the format myServerName-yyyyMMddHHmmssSSS.

    aws opsworks-cm --region region name describe-backups
  2. Run the following command.

    aws opsworks-cm --region region name restore-server --backup-id "myServerName-yyyyMMddHHmmssSSS" --instance-type "Type of instance" --key-pair "name of your EC2 key pair" --server-name "name of Chef server"

    The following is an example.

    aws opsworks-cm --region us-west-2 restore-server --backup-id "MyChefServer-20161120122143125" --server-name "MyChefServer"
  3. Wait until restoration is complete.