Skip to content

Commit

Permalink
Emphasized restricted file warnings [ref: #3747 ]
Browse files Browse the repository at this point in the history
Added additional detail and emphasis on warnings related to restricted
file problems in Cloud Dataverse in both installation and user guides.
  • Loading branch information
dlmurphy committed May 15, 2017
1 parent 2172603 commit ba5839a
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 2 deletions.
2 changes: 1 addition & 1 deletion doc/sphinx-guides/source/installation/config.rst
Original file line number Diff line number Diff line change
Expand Up @@ -158,7 +158,7 @@ By default, a Dataverse installation stores data files (files uploaded by end us

Alternatively, rather than storing data files on the filesystem, you can opt for a experimental setup with a `Swift Object Storage <http://swift.openstack.org>`_ backend. Each dataset that users create gets a corresponding "container" on the Swift side, and each data file is saved as a file within that container.

Note: At present, any file restrictions that users apply in Dataverse will not be honored in Swift. This means that a user without proper permissions could bypass intended restrictions by accessing the restricted file through Swift.
**Note:** At present, any file restrictions that users apply in Dataverse will not be honored in Swift. This means that a user without proper permissions **could bypass intended restrictions** by accessing the restricted file through Swift.

In order to configure a Swift installation, there are two steps you need to complete:

Expand Down
6 changes: 5 additions & 1 deletion doc/sphinx-guides/source/user/dataset-management.rst
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,11 @@ There are several advanced options available for certain file types.
Cloud Storage & Computing
-------------------------

Some Dataverse installations are specifically set up to facilitate cloud-based computing. While vanilla Dataverse uses a traditional file system for storing data, Cloud Dataverse uses a Swift object storage database. This allows users to perform computations on data using an integrated cloud computing environment. You'll know you're using Cloud Dataverse if you see a "Compute" button on dataset and file pages. Clicking that Compute button will take you directly to the cloud computing environment that is integrated with Cloud Dataverse, allowing you to perform computations on the file or dataset you were just viewing.
Some Dataverse installations are specifically set up to facilitate cloud-based computing. While vanilla Dataverse uses a traditional file system for storing data, Cloud Dataverse uses a Swift object storage database. This allows users to perform computations on data using an integrated cloud computing environment. This feature is considered experimental at this time, and some of the kinks are still being worked out.

You'll know you're using Cloud Dataverse if you see a "Compute" button on dataset and file pages. Clicking that Compute button will take you directly to the cloud computing environment that is integrated with Cloud Dataverse, allowing you to perform computations on the file or dataset you were just viewing.

**Note:** At present, any file restrictions that users apply in Cloud Dataverse will not be honored in Swift. This means: if you set a file on Cloud Dataverse as "restricted", a user without proper permissions **could bypass that restriction** by accessing the file through Swift. For now, do not rely on file restrictions to limit access to data in Cloud Dataverse.

Cloud Storage Access
~~~~~~~~~~~~~~~~~~~~
Expand Down

0 comments on commit ba5839a

Please sign in to comment.