Skip to content

Commit

Permalink
Update mount points in docs
Browse files Browse the repository at this point in the history
  • Loading branch information
JimMadge committed Sep 16, 2024
1 parent 44fb699 commit 126bb23
Show file tree
Hide file tree
Showing 6 changed files with 28 additions and 28 deletions.
10 changes: 5 additions & 5 deletions docs/source/deployment/security_checklist.md
Original file line number Diff line number Diff line change
Expand Up @@ -454,12 +454,12 @@ To minimise the risk of unauthorised access to the dataset while the ingress vol

### Turing configuration setting:

- Research users can write to the `/output` volume.
- A {ref}`role_system_manager` can view and download data in the `/output` volume via `Azure Storage Explorer`.
- Research users can write to the `/mnt/output` volume.
- A {ref}`role_system_manager` can view and download data in the `/mnt/output` volume via `Azure Storage Explorer`.

### Implication:

- SREs contain an `/output` volume, in which SRE users can store data designated for egress.
- SREs contain an `/mnt/output` volume, in which SRE users can store data designated for egress.

### Verify by:

Expand All @@ -469,7 +469,7 @@ To minimise the risk of unauthorised access to the dataset while the ingress vol
- Open up a file explorer and search for the various storage volumes

```{attention}
{{white_check_mark}} Verify that: the `/output` volume exists and can be read and written to.
{{white_check_mark}} Verify that: the `/mnt/output` volume exists and can be read and written to.
```

```{attention}
Expand All @@ -481,7 +481,7 @@ To minimise the risk of unauthorised access to the dataset while the ingress vol
- As the {ref}`role_system_manager`, follow the instructions in the [project manager documentation](../roles/project_manager/data_egress.md#data-egress-process) on how to access files set for egress with `Azure Storage Explorer`.

```{attention}
{{white_check_mark}} Verify that: you can see the files written to the `/output` storage volume.
{{white_check_mark}} Verify that: you can see the files written to the `/mnt/output` storage volume.
```

```{attention}
Expand Down
6 changes: 3 additions & 3 deletions docs/source/design/security/reference_configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,12 +102,12 @@ To minimise the risk of unauthorised access to the dataset while the ingress vol

### Turing configuration setting::

- Users can write to the `/output` volume.
- A {ref}`role_system_manager` can view and download data in the `/output` volume via **Azure Storage Explorer**.
- Users can write to the `/mnt/output` volume.
- A {ref}`role_system_manager` can view and download data in the `/mnt/output` volume via **Azure Storage Explorer**.

### Implication:

- SRE users can mark data as ready for egress approval by placing it in the `/output` volume.
- SRE users can mark data as ready for egress approval by placing it in the `/mnt/output` volume.

## 9. Software ingress

Expand Down
2 changes: 1 addition & 1 deletion docs/source/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ We have developed:
- A proposed default set of technical security measures for each tier.
- A set of infrastructure-as-code tools which will allow anyone to deploy their own isolated research environment.

If this sounds interesting to you, take a look at our GitHub releases: [![Data Safe Haven releases](https://img.shields.io/static/v1?label=Data%20Safe%20Haven&message=Releases&style=flat&logo=github)](https://github.com/alan-turing-institute/data-safe-haven/releases).
If this sounds interesting to you, take a look at our GitHub releases: [![Data Safe Haven releases](https://img.shields.io/static/v1?label=Data%20Safe%20Haven&message=Releases&style=flat&logo=github)](https://github.com/alan-turing-institute/mnt/input-safe-haven/releases).

## Documentation structure

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ If you upload this file then researchers will be able to independently verify da
Here are instructions to generate a checksum file using the `md5sum` algorithm for a data set stored in a directory called `data`.

```console
find ./data/ -type fl -exec md5sum {} + > hashes.txt
find ./mnt/input/ -type fl -exec md5sum {} + > hashes.txt
```

`find` searches the `data` directory for files and symbolic links (`-type fl`).
Expand Down
2 changes: 1 addition & 1 deletion docs/source/roles/researcher/accessing_the_sre.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,5 +175,5 @@ When you are connected to a workspace, you may switch to another by bringing up
:::

:::{tip}
Any files in the **/output/**, **/home/** or **/shared** folders on other workspaces will be available in this workspace too.
Any files in the **/mnt/output/**, **/home/** or **/mnt/shared** folders on other workspaces will be available in this workspace too.
:::
34 changes: 17 additions & 17 deletions docs/source/roles/researcher/using_the_sre.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,8 +53,8 @@ For instance, describing in detail what a dataset contains and how it will be us
SREs are designed to be ephemeral and only deployed for as long as necessary.
It is likely that the infrastructure, and data, will be permanently deleted when work has concluded.

The `/output/` directory is designed for storing output to be kept after a project concludes.
You should move such data to the `/output/` directory and contact your designated contact about data egress.
The `/mnt/output/` directory is designed for storing output to be kept after a project concludes.
You should move such data to the `/mnt/output/` directory and contact your designated contact about data egress.

:::{important}
You are responsible for deciding what is worth archiving.
Expand All @@ -63,8 +63,8 @@ You are responsible for deciding what is worth archiving.
While working on the project:

- store all your code in a **Gitea** repository.
- store all resources that might be useful to the rest of the project in the **/shared/** folder.
- store anything that might form an output from the project (_e.g._ images, documents or output datasets) in the **/output/** folder.
- store all resources that might be useful to the rest of the project in the **/mnt/shared/** folder.
- store anything that might form an output from the project (_e.g._ images, documents or output datasets) in the **/mnt/output/** folder.

See {ref}`the section on sharing files <role_researcher_shared_storage>` to find out more about where to store your files.

Expand Down Expand Up @@ -244,45 +244,45 @@ Type `yes` to install the packages.

There are several shared folder on each workspace that all collaborators within a research project team can see and access:

- [input data](#input-data): in the **/data/** folder
- [shared space](#shared-space): in the **/shared/** folder
- [output resources](#output-resources): in the **/output/** folder
- [input data](#input-data): in the **/mnt/input/** folder
- [shared space](#shared-space): in the **/mnt/shared/** folder
- [output resources](#output-resources): in the **/mnt/output/** folder

### Input data

Data that has been approved and brought into the secure research environment can be found in the **/data/** folder.
Data that has been approved and brought into the secure research environment can be found in the **/mnt/input/** folder.

- The contents of **/data/** will be identical on all workspaces in your SRE.
- The contents of **/mnt/input/** will be identical on all workspaces in your SRE.
- Everyone working on your project will be able to access it.
- Everyone has **read-only access** to the files stored here.

If you are using the Data Safe Haven as part of an organised event, you might find additional resources in the **/data/** folder, such as example slides or document templates.
If you are using the Data Safe Haven as part of an organised event, you might find additional resources in the **/mnt/input/** folder, such as example slides or document templates.

:::{important}
You will not be able to change any of the files in **/data/**.
If you want to make derived datasets, for example cleaned and reformatted data, please add those to the **/shared/** or **/output/** folders.
You will not be able to change any of the files in **/mnt/input/**.
If you want to make derived datasets, for example cleaned and reformatted data, please add those to the **/mnt/shared/** or **/mnt/output/** folders.
:::

### Shared space

The **/shared/** folder should be used for any work that you want to share with your group.
The **/mnt/shared/** folder should be used for any work that you want to share with your group.

- The contents of **/shared/** will be identical on all workspaces in your SRE.
- The contents of **/mnt/shared/** will be identical on all workspaces in your SRE.
- Everyone working on your project will be able to access it
- Everyone has **read-and-write access** to the files stored here.

### Output resources

Any outputs that you want to extract from the secure environment should be placed in the **/output/** folder on the workspace.
Any outputs that you want to extract from the secure environment should be placed in the **/mnt/output/** folder on the workspace.

- The contents of **/output/** will be identical on all workspaces in your SRE.
- The contents of **/mnt/output/** will be identical on all workspaces in your SRE.
- Everyone working on your project will be able to access it
- Everyone has **read-and-write access** to the files stored here.

Anything placed in here will be considered for data egress - removal from the secure research environment - by the project's principal investigator together with the data provider.

:::{tip}
You may want to consider having subfolders of **/output/** to make the review of this directory easier.
You may want to consider having subfolders of **/mnt/output/** to make the review of this directory easier.
:::

## {{pill}} Version control using Gitea
Expand Down

0 comments on commit 126bb23

Please sign in to comment.