Automate to Automate HA

[edit on GitHub]

Upgrade with FileSystem Backup Locally

1. Create Backup of Chef Automate Standalone using the following command:

   chef-automate backup create
   chef-automate bootstrap bundle create bootstrap.abb
   

   • The first command will create the backup to the /var/opt/chef-automate/backup location unless you specify the location in config.toml file.
   • The second command will create the bootstrap.abb.
   • Once the backup is completed, save the backup Id. For example: 20210622065515.

2. Create Bundle using the following command:

   tar -cvf backup.tar.gz path/to/backup/<backup_id>/ /path/to/backup/automatebackup-elasticsearch/ /path/to/backup/.tmp/
   

3. Transfer the tar bundle to one of the Chef Automate HA Frontend Nodes.

4. Transfer the bootstrap.abb file to all the Chef Automate HA FrontEnd Nodes (both Chef Automate and Chef Infra Server).

5. Go the Chef Automate HA, where we copied the tar file. Unzip the bundle using:

   tar -xf backup.tar.gz -C /mnt/automate_backups
   

6. Stop all the services at frontend nodes in Automate HA Cluster. Run the following command to all the Automate and Chef Infra Server nodes:

   sudo chef-automate stop
   

7. Run the following command at Chef-Automate node of Automate HA cluster to get the applied config:

   sudo chef-automate config show > current_config.toml 
   

   From Automate 4.x.y version onwards, OpenSearch credentials are not stored in the config. Add the OpenSearch password to the generated config above. For example:

   [global.v1.external.opensearch.auth.basic_auth]
   username = "admin"
   password = "admin"
   

1. Restore in Chef-Automate HA using the following command:

   automate_version_number=4.x.y ## Please change this to the version of Chef Automate HA installed. Look for /var/tmp/frontend-4.x.y.aib file
   
   chef-automate backup restore /mnt/automate_backups/backups/<backup_id>/ --patch-config current_config.toml --airgap-bundle /var/tmp/frontend-${automate_version_number}.aib --skip-preflight
   

2. Unpack the bootstrap.abb file on all the Frontend nodes:

   Login to Each Frontend Node and then run after copying the bootstrap.abb file.

   chef-automate bootstrap bundle unpack bootstrap.abb
   

3. Start the Service in all the Frontend Nodes with the command shown below:

   sudo chef-automate start
   

Upgrade with FileSystem Backup via Volume Mount

1. Create Backup of Chef Automate Standalone using the following command:

   chef-automate backup create
   chef-automate bootstrap bundle create bootstrap.abb
   

   • The first command will create the backup at the file mount location mentioned in the config.toml file.
   • The second command will create the bootstrap.abb.
   • Once the backup is completed, save the backup Id. For example: 20210622065515

2. Detach the File system from Standalone Chef-Automate.

3. Attach and Mount the same file system to the Automate-HA all the nodes:

   • Make sure that it should have permission for hab user

4. Stop all the services at frontend nodes in Automate HA Cluster. Run the below command to all the Automate and Chef Infra Server nodes

   sudo chef-automate stop
   

5. Get the Automate HA version number from the location /var/tmp/ in Automate instance. For example : frontend-4.x.y.aib

6. Run the command at Chef-Automate node of Automate HA cluster to get the applied config:

   sudo chef-automate config show > current_config.toml 
   

   From Automate 4.x.y version onwards, OpenSearch credentials are not stored in the config. Add the OpenSearch password to the generated config above. For example:

   [global.v1.external.opensearch.auth.basic_auth]
   username = "admin"
   password = "admin"
   

1. Run the restore command in one of the Chef Automate node in Chef-Automate HA cluster:

   automate_version_number=4.x.y ## Please change this to the version of Chef Automate HA installed. Look for /var/tmp/frontend-4.x.y.aib file
   
   chef-automate backup restore /mnt/automate_backups/backups/<backup_id>/ --patch-config current_config.toml --airgap-bundle /var/tmp/frontend-${automate_version_number}.aib --skip-preflight
   

2. Copy the bootstrap.abb file to all the Chef Automate HA FrontEnd Nodes (both Chef Automate and Chef Infra Server).

3. Unpack the bootstrap.abb file on all the Frontend nodes. ssh to Each Frontend Node and run the following command:

   chef-automate bootstrap bundle unpack bootstrap.abb
   

4. Start the Service in All the Frontend Nodes with command shown below:

   sudo chef-automate start