Skip to content

Commit 7df6c58

Browse files
authored
Merge pull request #11 from Sydney-Informatics-Hub/tomm-workshop_updates
Tomm workshop updates
2 parents b747030 + 77e107a commit 7df6c58

2 files changed

Lines changed: 8 additions & 29 deletions

File tree

notebooks/CLI.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,17 +39,17 @@ you will be prompted for your password and Okta credentials in a browser window
3939
runai project set <my_project>
4040
```
4141

42-
3. To run an `sydneyinformaticshub/dgx-interactive-gpu` container with an interactive terminal session including mounting your projects existing PVC in /scratch inside the container you can use the following command (be sure to replace everything in brackets `<...>` with values specific to your requirements):
42+
3. To run an `sydneyinformaticshub/dgx-interactive-terminal` container with an interactive terminal session including mounting your projects existing PVC in /scratch inside the container you can use the following command (be sure to replace everything in brackets `<...>` with values specific to your requirements):
4343

4444
```bash
45-
runai workspace submit <workspace-name> --image sydneyinformaticshub/dgx-interactive-gpu --gpu-devices-request 1 --cpu-core-request 1.0 --run-as-user --existing-pvc claimname=<pvc-name>,path=/scratch --attach
45+
runai workspace submit <workspace-name> --image sydneyinformaticshub/dgx-interactive-terminal --gpu-devices-request 1 --cpu-core-request 1.0 --run-as-user --existing-pvc claimname=<pvc-name>,path=/scratch --attach
4646
```
4747

4848
Here is a brief rundown of the arguments of the command above:
4949

5050
- `runai workspace submit <workspace-name>` will run a new workspace and give it the name specified in `<workspace-name>`
5151

52-
- `--image sydneyinformaticshub/dgx-interactive-gpu` will run the base Docker image located at `sydneyinformaticshub/dgx-interactive-gpu`, you can replace this image with your own, perhaps built yourself with extra package installs and using this image as a base
52+
- `--image sydneyinformaticshub/dgx-interactive-terminal` will run the base Docker image located at `sydneyinformaticshub/dgx-interactive-terminal`, you can replace this image with your own, perhaps built yourself with extra package installs and using this image as a base
5353

5454
- `--gpu-devices-request 1 --cpu-core-request 1.0` requests 1 GPU and 1 CPU for the workflow. There are multiple options for selecting GPU and CPU RAM and devices, see [here](https://run-ai-docs.nvidia.com/self-hosted/2.22/reference/cli/runai/runai_workspace_submit) or use `runai wrkspace submit --help` for a full list of options
5555

@@ -66,7 +66,7 @@ Using the CLI it is also possible to set up a workflow that persists in the back
6666
To set this up follow the steps 1 and 2 above, then change the command in step 3 to:
6767

6868
```bash
69-
runai workspace submit <workspace-name> --image sydneyinformaticshub/dgx-interactive-gpu --gpu-devices-request 1 --cpu-core-request 1.0 --run-as-user --existing-pvc claimname=<pvc-name>,path=/scratch --command -- bash -c 'trap : TERM INT; sleep infinity & wait'
69+
runai workspace submit <workspace-name> --image sydneyinformaticshub/dgx-interactive-terminal --gpu-devices-request 1 --cpu-core-request 1.0 --run-as-user --existing-pvc claimname=<pvc-name>,path=/scratch --command -- bash -c 'trap : TERM INT; sleep infinity & wait'
7070
```
7171

7272
This will run the workload and keep it persisting in the background. You can then connect to this container whenever you like using:

notebooks/data_transfer.md

Lines changed: 4 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,19 @@ Here we assume you already have set up a [project](projects.md) and have some Pe
66

77
## Interactive data transfer to/from RDS from a web-browser
88

9-
You can easily transfer data between your Persistent Volume Claim (PVC) and RDS from inside the Run:ai web browser interface. We have set up an [environment](environments.md) called `interactive_dt` for you to do this.
9+
You can easily transfer data between your Persistent Volume Claim (PVC) and RDS from inside the Run:ai web browser interface. We have set up an [environment](environments.md) called `data-transfer` for you to do this.
1010

11-
To run the `interactive_dt` environment from a template:
11+
To run the `data-transfer` environment from a template:
1212

1313
1. Log into the Run:ai dashboard at [gpu.sydney.edu.au](https://gpu.sydney.edu.au) and use Okta to login with your credentials via the "CONTINUE WITH SSO" sign in option.
1414

1515
2. Click 'workloads' in the left panel and then the blue 'new workload' icon in the top left of the workloads screen and select 'workspace'.
1616

1717
![New Workload](../fig/workload_new.png)
1818

19-
3. Select your project from the projects available and select the `interactive-data-transfer` template and give your workspace a name before clicking with your mouse cursor on CONTINUE.
19+
3. Select your project from the projects available and select the `data-transfer` template and give your workspace a name before clicking with your mouse cursor on CONTINUE.
2020

21-
4. If you have selected the `interactive-data-transfer` template, you should now have pre-populated the required `interactive-dt` environment and the `data-transfer` compute resource fields on the following page. You can double check this now.
21+
4. If you have selected the `data-transfer` template, you should now have pre-populated the required `data-transfer` environment and the `data-transfer` compute resource fields on the following page. You can double check this now.
2222

2323
5. Expand the `Data sources` box and select the PVC associated with your project from the list.
2424

@@ -65,27 +65,6 @@ rsync -rlctP <pvc_mount_point>/<path_to_pvc_data> <your_unikey>@research-data-in
6565
The above rsync will also perform integrity checking using a *checksum*, comparing the original and copied files to make sure they are identical.
6666

6767
During file transfer, for larger files, you can close the browser and leave things running in the background. You can then reconnect to check its status by logging back into the web UI at [gpu.sydney.edu.au](https://gpu.sydney.edu.au).
68-
69-
::: {.callout-warning}
70-
71-
# For early adopters
72-
73-
Until we have correct user IDs and group IDs for your unikey and project set up in the PVC and the running workflow, you will need to update the permissions of the mounted PVC as root to be able to read/write files from there. To do this:
74-
75-
1. Change to root
76-
77-
```bash
78-
sudo su
79-
```
80-
81-
2. Use chmod to set read and write for all on your mounted PVC space
82-
83-
```bash
84-
chmod -R 666 <PVC_mount_point>
85-
```
86-
87-
You must do these steps BEFORE running the `rsync` command above.
88-
:::
8968

9069

9170

0 commit comments

Comments
 (0)