You can use a script to back up and restore data on your Atmosphere instance. Formerly known as iplant_backup, this script is reintroduced to Atmosphere as cyverse_backup (Z-release, July 2017). If you'd like to use this script on an existing instance that was launched prior to this release, you must redeploy to it first by selecting the instance in the Atmosphere web application and clicking Redeploy.

Backing up data from an instance to the Data Store

1. To start the backup process, log in to the instance that contains the data to be backed up. Use your CyVerse username (not the root user).

2. Execute the following in a terminal window:

   $ cyverse_backup.sh

3. In the following prompt, enter backup:

   Do you want to backup or restore local instance/volume data?[backup/restore]: backup

4. In the following prompt, enter the full path to your local directory or file for the instance:

   Specify local file/directory's full path on the instance [eg: /home/username, /home/username/file.txt]: /home/username/Desktop

5. In the following prompt, enter the full path of the directory (NOT from root) or file in the Data Store to which you want to back up the data:

   Specify file/directory path on iPlant datastore [eg: /iplant/home/username, /iplant/home/username/file.txt] [Default is /iplant/home/username/atmosphere]: /iplant/home/username/atmosphere/test.sh

   The default option for this step is /iplant/home/<username>/atmosphere. If the atmosphere directory does not exist, it will be created and the data will be stored there.

6. Enter your CyVerse password to begin the backup request.

Restoring data from the Data Store to an instance

1. To start the restore process, log in to the instance to which you want to restore the data. Use your CyVerse username (not the root user).

2. Execute the following in a terminal window:

   $ cyverse_backup.sh

3. In the following prompt, enter restore:

   Do you want to backup or restore local instance/volume data?[backup/restore]: restore

4. In the following prompt, enter the full path of the directory or file in the Data Store to which you want to restore the data:

   Specify file/directory path on iPlant datastore [eg: /iplant/home/username, /iplant/home/username/file.txt]: /iplant/home/username/atmosphere/test.sh

5. In the following prompt, enter the full path to your local directory or file for the instance:

   Specify local file/directory's full path on the instance [eg: /home/username, /home/username/file.txt]: /home/username/Desktop

6. Enter your CyVerse password to begin the restore process.