You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guides/user-interactions/readme.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,9 +24,9 @@ The `jobdw` directive command tells the Rabbit software to create a file system
24
24
|`type`| Yes |`raw`, `xfs`, `gfs2`, `lustre`| Type defines how the storage should be formatted. For Lustre file systems, a single file system is created that is mounted by all computes in the job. For raw, xfs, and GFS2 storage, a separate file system is allocated for each compute node. |
25
25
|`capacity`| Yes | Allocation size with units. `1TiB`, `100GB`, etc. | Capacity interpretation varies by storage type. For Lustre file systems, capacity is the aggregate OST capacity. For raw, xfs, and GFS2 storage, capacity is the capacity of the file system for a single compute node. Capacity suffixes are: `KB`, `KiB`, `MB`, `MiB`, `GB`, `GiB`, `TB`, `TiB`|
26
26
|`name`| Yes | String including numbers and '-' | This is a name for the storage allocation that is unique within a job |
27
-
|`profile`| No | Profile name | This specifies which profile to use when allocating storage. Profiles include `mkfs` and `mount` arguments, file system layout, and many other options. Profiles are created by admins. When no profile is specified, the default profile is used. More information about storage profiles can be found in the [Storage Profiles](../storage-profiles/readme.md) guide. |
27
+
|`profile`| No | Profile name | This specifies which profile to use when allocating storage. Profiles include `mkfs` and `mount` arguments, file system layout, and many other options. When no profile is specified, the default profile is used. More information about storage profiles can be found in the [Storage Profiles](../storage-profiles/readme.md) guide. **Note:** Admins are responsible for profiles.|
28
28
|`requires`| No |`copy-offload`| Use this option with [Copy Offload](../data-movement/copy-offload.md). This is for users who want to initiate data movement to or from the Rabbit storage from within their application. |
29
-
|`requires`| No |`user-container-auth`| Use this option with [User Containers](../user-containers/readme.md) that have an application that expects to use the same kind of TLS certificate and [per-Workflow token](../data-movement/copy-offload.md#per-workflow-token) that is configured for [Copy Offload](../data-movement/copy-offload.md). |
29
+
|`requires`| No |`user-container-auth`| Use this option with [User Containers](../user-containers/readme.md) that have an application that expects to use the same kind of TLS certificate and [per-Workflow token](../data-movement/copy-offload.md#wlm-and-the-per-workflow-token) that is configured for [Copy Offload](../data-movement/copy-offload.md). |
30
30
31
31
#### Examples
32
32
@@ -59,7 +59,7 @@ The `create_persistent` command results in a storage allocation on the Rabbit no
59
59
|`type`| Yes |`raw`, `xfs`, `gfs2`, `lustre`| Type defines how the storage should be formatted. For Lustre file systems, a single file system is created. For raw, xfs, and GFS2 storage, a separate file system is allocated for each compute node in the job. |
60
60
|`capacity`| Yes | Allocation size with units. `1TiB`, `100GB`, etc. | Capacity interpretation varies by storage type. For Lustre file systems, capacity is the aggregate OST capacity. For raw, xfs, and GFS2 storage, capacity is the capacity of the file system for a single compute node. Capacity suffixes are: `KB`, `KiB`, `MB`, `MiB`, `GB`, `GiB`, `TB`, `TiB`|
61
61
|`name`| Yes | Lowercase string including numbers and '-' | This is a name for the storage allocation that is unique within the system |
62
-
|`profile`| No | Profile name | This specifies which profile to use when allocating storage. Profiles include `mkfs` and `mount` arguments, file system layout, and many other options. Profiles are created by admins. When no profile is specified, the default profile is used. The profile used when creating the persistent storage allocation is the same profile used by jobs that use the persistent storage. More information about storage profiles can be found in the [Storage Profiles](../storage-profiles/readme.md) guide.|
62
+
|`profile`| No | Profile name | This specifies which profile to use when allocating storage. Profiles include `mkfs` and `mount` arguments, file system layout, and many other options. When no profile is specified, the default profile is used. The profile used when creating the persistent storage allocation is the same profile used by jobs that use the persistent storage. More information about storage profiles can be found in the [Storage Profiles](../storage-profiles/readme.md) guide. **Note:** Admins are responsible for profiles.|
63
63
64
64
#### Examples
65
65
@@ -105,7 +105,7 @@ Persistent Lustre file systems can be accessed from any compute nodes in the sys
105
105
|----------|----------|-------|-------|
106
106
|`name`| Yes | Lowercase string including numbers and '-' | This is a name for the persistent storage that is accessed |
107
107
|`requires`| No |`copy-offload`| Use this option with [Copy Offload](../data-movement/copy-offload.md). This is for users who want to initiate data movement to or from the Rabbit storage from within their application. |
108
-
|`requires`| No |`user-container-auth`| Use this option with [User Containers](../user-containers/readme.md) that have an application that expects to use the same kind of TLS certificate and [per-Workflow token](../data-movement/copy-offload.md#per-workflow-token) that is configured for [Copy Offload](../data-movement/copy-offload.md). |
108
+
|`requires`| No |`user-container-auth`| Use this option with [User Containers](../user-containers/readme.md) that have an application that expects to use the same kind of TLS certificate and [per-Workflow token](../data-movement/copy-offload.md#wlm-and-the-per-workflow-token) that is configured for [Copy Offload](../data-movement/copy-offload.md). |
109
109
110
110
#### Examples
111
111
@@ -125,7 +125,7 @@ The `copy_in` and `copy_out` directives are used to move data to and from the st
125
125
|--------|----------|-------|-------|
126
126
|`source`| Yes |`[path]`, `$DW_JOB_[name]/[path]`, `$DW_PERSISTENT_[name]/[path]`|`[name]` is the name of the Rabbit persistent or job storage as specified in the `name` argument of the `jobdw` or `persistentdw` directive. Any `'-'` in the name from the `jobdw` or `persistentdw` directive should be changed to a `'_'` in the `copy_in` and `copy_out` directive. |
127
127
|`destination`| Yes |`[path]`, `$DW_JOB_[name]/[path]`, `$DW_PERSISTENT_[name]/[path]`|`[name]` is the name of the Rabbit persistent or job storage as specified in the `name` argument of the `jobdw` or `persistentdw` directive. Any `'-'` in the name from the `jobdw` or `persistentdw` directive should be changed to a `'_'` in the `copy_in` and `copy_out` directive. |
128
-
|`profile`| No | Profile name | This specifies the profile to use when copying data. Profiles specify the copy command to use, MPI arguments, and how output is logged. If no profile is specified then the default profile is used. **Note:**Profiles are created by an admin. |
128
+
|`profile`| No | Profile name | This specifies the profile to use when copying data. Profiles specify the copy command to use, MPI arguments, and how output is logged. If no profile is specified then the default profile is used. More information about datamovement profiles can be found in the [DataMovement Profiles](../data-movement/readme.md#data-movement-profiles) guide. **Note:**Admins are responsible for profiles.|
129
129
130
130
#### Examples
131
131
@@ -167,7 +167,7 @@ The `container` directive is used to launch user containers on the Rabbit nodes.
167
167
| Argument | Required | Value | Notes |
168
168
|----------|----------|-------|-------|
169
169
|`name`| Yes | Lowercase string including numbers and '-' | This is a name for the container instance that is unique within a job |
170
-
|`profile`| Yes | Profile name | This specifies which container profile to use. The container profile contains information about which container to run, which file system types to expect, which network ports are needed, and many other options. An admin is responsible for creating the container profiles.|
170
+
|`profile`| Yes | Profile name | This specifies which container profile to use. The container profile contains information about which container to run, which file system types to expect, which network ports are needed, and many other options. **Note:** Admins are responsible for profiles.|
171
171
|`DW_JOB_[expected]`| No |`jobdw` storage allocation `name`| The container profile lists `jobdw` file systems that the container requires. `[expected]` is the name as specified in the container profile |
172
172
|`DW_PERSISTENT_[expected]`| No |`persistentdw` storage allocation `name`| The container profile lists `persistentdw` file systems that the container requires. `[expected]` is the name as specified in the container profile |
173
173
|`DW_GLOBAL_[expected]`| No | Global lustre path | The container profile lists global Lustre file systems that the container requires. `[expected]` is the name as specified in the container profile |
0 commit comments