This space searches only documentation in the Atmosphere space. To search all CyVerse wiki content, use the box at the upper right.

For overview information, see Atmosphere on the CyVerse website.

Atmosphere User Manual

To keep your data safe, use a script to back up your data to the Data Store. For more information, see Backing Up and Restoring Your Data to the Data Store.

Skip to end of metadata
Go to start of metadata

 You can attach a volume to an instance that exists in the same project.


For more information about volumes, see Using Volumes.

Attaching a volume to an instance

  1. In Atmosphere, click Projects on the menu bar.
  2. Click the project with the instance to which you want to attach a new volume (the volume's status must be Unattached).
  3. Click the volume name to open the volume.
  4. In the Actions list on the right, click Attach.
  5. In the Attach Volume window:
    1. Select the instance to which you want to attach the volume.
    2. Click Attach volume to instance.
      The status changes to attaching and then to Attached to <instance>. (You may need to refresh your browser window to update the status.)
      The file system is created and mounted.

Granting users write access to a volume

This should not be necessary since mounted volumes are owned by the user by default, but if you need to change the ownership:

  1. Open a terminal window.
  2. Change permissions on the mounted volume:

    where myusername is your CyVerse username. The volume may be at other locations such as '/vol_d'.

  3. Enter your CyVerse password.

Detaching a volume from an instance

You can detach a volume that is attached to an instance. Before you detach the volume, however, you must first save all your data to the Data Store or you risk losing the data.

Step 1: Save your data.

Step 2: Detach the volume from the instance

  1. Click Projects and then click the project with the volume to detach.

  2. In the Volumes section, click the checkbox for the volume to detach.
  3. Click Detach at the top right.
  4. Click yes to the warning prompt. The volume's status changes to Unattached.

If the volume's status does not change to Unattached

 You might have one or more processes which are using the volume. You can check by running these commands.

NOTE: The instructions below assume the volume is mounted on /vol_a - replace this with your own.

  1. Enter the following in a terminal window:

    Manually unmount volume
  2. Enter your CyVerse password.
  3. If you see output like below then this is your problem:

  4. To see which processes are preventing umount from working run this command:

    Find processes which are using volume
  5. You might see something like this:

    Processes using volume
  6. In the above example two bash/shell/SSH/terminal sessions are using the volume. The solution would be to either change working directory ( cd ) or log out from these sessions ( exit ).
  7. Try the lsof command above again. Once the lsof command returns nothing then try detaching the volume again.


After you have detached the volume from the instance, you can delete the instance.

Moving a volume to a new location

Before you can move a volume to a new location, you must first unmount it from the current location and then mount it at the new location.

  1. Save any data .
  2. Unmount the volume:
    1. Enter the following in a terminal window:

    2. Enter your iPlant password.
  3. Mount the volume at the new location:

About inactive volumes

Volumes that have not been used for more than three (3) months will be considered inactive.

Once a volume is marked inactive, the data in the volume is copied to the user's Data Store home directory (under /iplant/home/yourusername/atmo/volume-name) and the volume is deleted.
Users can create a new volume and copy their data back to the new volume; contact CyVerse Staff for help restoring data to the new volume, if necessary.

Need help?

Click  at the bottom right of the screen to chat with an Atmosphere support team member during business hours. You also can go to Ask CyVerse for Atmosphere, or click Feedback & Support at the bottom of the screen.

Helpful Links

On This Page:

Related Pages: