Skip to content

Commit 3066755

Browse files
authored
The DWS v1alpha3 API changes RequiredDaemons to Requires (#242)
Signed-off-by: Dean Roehrich <dean.roehrich@hpe.com>
1 parent 4e1b009 commit 3066755

3 files changed

Lines changed: 7 additions & 7 deletions

File tree

docs/guides/data-movement/readme.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ settings are on a per-request basis. These supplement the configuration in the
3838
The Copy Offload API requires the `nnf-dm` daemon to be running on the compute node. This daemon may
3939
be configured to run full-time, or it may be left in a disabled state if the WLM is expected to run
4040
it only when a user requests it. See [Compute Daemons](../compute-daemons/readme.md) for the systemd
41-
service configuration of the daemon. See `RequiredDaemons` in [Directive
41+
service configuration of the daemon. See `Requires` in [Directive
4242
Breakdown](../directive-breakdown/readme.md) for a description of how the user may request the
4343
daemon in the case where the WLM will run it only on demand.
4444

docs/guides/directive-breakdown/readme.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -150,14 +150,14 @@ A location constraint consists of an `access` list and a `reference`.
150150
* `status.compute.constraints.location.access.type` specifies the connection type for the storage. This can be `network` or `physical`
151151
* `status.compute.constraints.location.access.priority` specifies how necessary the connection type is. This can be `mandatory` or `bestEffort`
152152

153-
## RequiredDaemons
153+
## Requires
154154

155-
The `status.requiredDaemons` section of the `DirectiveBreakdown` tells the WLM about any driver-specific daemons it must enable for the job; it is assumed that the WLM knows about the driver-specific daemons and that if the users are specifying these then the WLM knows how to start them. The `status.requiredDaemons` section will exist only for `jobdw` and `persistentdw` directives. An example of the `status.requiredDaemons` section is included below.
155+
The `status.requires` section of the `DirectiveBreakdown` tells the WLM about any driver-specific daemons it must enable for the job; it is assumed that the WLM knows about the driver-specific daemons and that if the users are specifying these then the WLM knows how to start them. The `status.requires` section will exist only for `jobdw` and `persistentdw` directives. An example of the `status.requires` section is included below.
156156

157157
```yaml
158158
status:
159159
...
160-
requiredDaemons:
160+
requires:
161161
- copy-offload
162162
...
163163
```

docs/guides/user-interactions/readme.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ The `jobdw` directive command tells the Rabbit software to create a file system
2424
| `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` |
2525
| `name` | Yes | String including numbers and '-' | This is a name for the storage allocation that is unique within a job |
2626
| `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-
| `requires` | No | `copy-offload` | Using this option results in the copy offload daemon running on the compute nodes. This is for users that want to initiate data movement to or from the Rabbit storage from within their application. See the [Required Daemons](../directive-breakdown/readme.md#requireddaemons) section of the [Directive Breakdown](../directive-breakdown/readme.md) guide for a description of how the user may request the daemon, in the case where the WLM will run it only on demand. |
27+
| `requires` | No | `copy-offload` | Using this option results in the copy offload daemon running on the compute nodes. This is for users that want to initiate data movement to or from the Rabbit storage from within their application. See the [Required Daemons](../directive-breakdown/readme.md#requires) section of the [Directive Breakdown](../directive-breakdown/readme.md) guide for a description of how the user may request the daemon, in the case where the WLM will run it only on demand. |
2828

2929
#### Examples
3030

@@ -97,7 +97,7 @@ Persistent Lustre file systems can be accessed from any compute nodes in the sys
9797
| Argument | Required | Value | Notes |
9898
|----------|----------|-------|-------|
9999
| `name` | Yes | Lowercase string including numbers and '-' | This is a name for the persistent storage that will be accessed |
100-
| `requires` | No | `copy-offload` | Using this option results in the copy offload daemon running on the compute nodes. This is for users that want to initiate data movement to or from the Rabbit storage from within their application. See the [Required Daemons](../directive-breakdown/readme.md#requireddaemons) section of the [Directive Breakdown](../directive-breakdown/readme.md) guide for a description of how the user may request the daemon, in the case where the WLM will run it only on demand. |
100+
| `requires` | No | `copy-offload` | Using this option results in the copy offload daemon running on the compute nodes. This is for users that want to initiate data movement to or from the Rabbit storage from within their application. See the [Required Daemons](../directive-breakdown/readme.md#requires) section of the [Directive Breakdown](../directive-breakdown/readme.md) guide for a description of how the user may request the daemon, in the case where the WLM will run it only on demand. |
101101

102102
#### Examples
103103

@@ -179,4 +179,4 @@ The WLM makes a set of environment variables available to the job application ru
179179
|----------------------|-------|-------|
180180
| `DW_JOB_[name]` | Mount path of a `jobdw` file system | `[name]` is from the `name` argument in the `jobdw` directive. Any `'-'` characters in the `name` will be converted to `'_'` in the environment variable. There will be one of these environment variables per `jobdw` directive in the job. |
181181
| `DW_PERSISTENT_[name]` | Mount path of a `persistentdw` file system | `[name]` is from the `name` argument in the `persistentdw` directive. Any `'-'` characters in the `name` will be converted to `'_'` in the environment variable. There will be one of these environment variables per `persistentdw` directive in the job. |
182-
| `NNF_CONTAINER_PORTS` | Comma separated list of ports | These ports are used together with the IP address of the local Rabbit to communicate with a user container specified by a `container` directive. More information can be found in the [User Containers](../user-containers/readme.md) guide.
182+
| `NNF_CONTAINER_PORTS` | Comma separated list of ports | These ports are used together with the IP address of the local Rabbit to communicate with a user container specified by a `container` directive. More information can be found in the [User Containers](../user-containers/readme.md) guide.

0 commit comments

Comments
 (0)