Skip to content

Commit a92e615

Browse files
Update Storage Profile docs (#250)
Add documentation for command variables Signed-off-by: Matt Richerson <matthew.richerson@hpe.com>
1 parent 501696d commit a92e615

1 file changed

Lines changed: 26 additions & 5 deletions

File tree

docs/guides/storage-profiles/readme.md

Lines changed: 26 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -288,21 +288,29 @@ In general, `scale` gives a simple way for users to get a filesystem that has pe
288288

289289
## Command Line Variables
290290

291-
### pvcreate
291+
### global
292+
- `$JOBID` - expands to the Job ID from the Workflow
293+
- `$USERID` - expands to the User ID of the user who submitted the job
294+
- `$GROUPID` - expands to the Group ID of the user who submitted the job
295+
296+
### LVM PV commands
292297

293298
- `$DEVICE` - expands to the `/dev/<path>` value for one device that has been allocated
294299

295-
### vgcreate
300+
### LVM VG commands
296301

297302
- `$VG_NAME` - expands to a volume group name that is controlled by Rabbit software.
298303
- `$DEVICE_LIST` - expands to a list of space-separated `/dev/<path>` devices. This list will contain the devices that were iterated over for the pvcreate step.
304+
- `$DEVICE_NUM` - expands to the count of devices in `$DEVICE_LIST`
299305

300-
### lvcreate
306+
### LVM LV Commands
301307

302308
- `$VG_NAME` - see vgcreate above.
303309
- `$LV_NAME` - expands to a logical volume name that is controlled by Rabbit software.
304310
- `$DEVICE_NUM` - expands to a number indicating the number of devices allocated for the volume group.
305311
- `$DEVICE1, $DEVICE2, ..., $DEVICEn` - each expands to one of the devices from the `$DEVICE_LIST` above.
312+
- `$PERCENT_VG` - expands to the size that each LV should be based on a percentage of the total VG size
313+
- `$LV_SIZE` - expands to the size of the LV in kB in the format expected by `lvcreate`
306314

307315
### XFS mkfs
308316

@@ -326,9 +334,15 @@ In general, `scale` gives a simple way for users to get a filesystem that has pe
326334

327335
- `$FS_NAME` - expands to the filesystem name that was passed to Rabbit software from the workflow's #DW line.
328336
- `$MGS_NID` - expands to the NID of the MGS. If the MGS was orchestrated by nnf-sos then an appropriate internal value will be used.
329-
- `$POOL_NAME` - see zpool create above.
330-
- `$VOL_NAME` - expands to the volume name that will be created. This value will be `<pool_name>/<dataset>`, and is controlled by Rabbit software.
337+
- `$ZVOL_NAME` - expands to the volume name that will be created. This value will be `<pool_name>/<dataset>`, and is controlled by Rabbit software.
331338
- `$INDEX` - expands to the index value of the target and is controlled by Rabbit software.
339+
- `$TARGET_NAME` - expands to the name of the lustre target of the form `[fsname]-[target-type][index]` (e.g., `mylus-OST0003`)
340+
- `$BACKFS` - expands to the type of file system backing the Lustre target
341+
342+
### Mount/Unmount
343+
344+
- `$DEVICE` - expands to the device path to mount
345+
- `$MOUNT_PATH` - expands to the path to mount on
332346

333347
### PostMount/PreUnmount and PostActivate/PreDeactivate
334348

@@ -343,3 +357,10 @@ These variables are for lustre only and can be used to perform PostMount activit
343357
- `$NUM_MGTMDTS` - expands to the number of combined MGTMDTs for the lustre filesystem
344358
- `$NUM_OSTS` - expands to the number of OSTs for the lustre filesystem
345359
- `$NUM_NNFNODES` - expands to the number of NNF Nodes for the lustre filesystem
360+
361+
### NnfSystemStorage specific
362+
363+
- `$COMPUTE_HOSTNAME` - Expands to the hostname of the compute node that will use the allocation. This can be used to add a tag during the lvcreate
364+
```
365+
lvCreate --zero n --activate n --extents $PERCENT_VG --addtag $COMPUTE_HOSTNAME ...
366+
```

0 commit comments

Comments
 (0)