...
| Code Block | ||
|---|---|---|
| ||
$ dmg system query +--verbose Rank State ---- ----- [0 Joined-1] Joined |
dmg system query
...
verbose output
| Code Block | ||
|---|---|---|
| ||
$ dmg system query -d-verbose DEBUG 16:43:20.281976 main.go:217: debug output enabled DEBUG 16:43:20.282999 main.go:244: control config loaded from /etc/daos/daos_control.yml DEBUG 16:43:20.285567 system.go:406: DAOS system query request: &{unaryRequest:{request:{deadline:{wall:0 ext:0 loc:<nil>} Sys: HostList:[]} rpc:0xf6b300} msRequest:{} sysRequest:{Ranks:{RWMutex:{w:{state:0 sema:0} writerSem:0 readerSem:0 readerCount:0 readerWait:0} HostSet:{Mutex:{state:0 sema:0} list:0xc00030f280}} Hosts:{Mutex:{state:0 sema:0} list:0xc00030f240}} retryableRequest:{retryTimeout:0 retryInterval:0 retryMaxTries:0 retryTestFn:0xf6b460 retryFn:0xf6b5a0} FailOnUnavailable:false} DEBUG 16:43:20.285939 rpc.go:209: request hosts: [boro-8:10001] Rank State ---- ----- 0 Joined |
dmg storage query usage
| No Format |
|---|
$ dmg storage query usage Hosts SCM-Total SCM-Free SCM-Used NVMe-Total NVMe-Free NVMe-Used ----- --------- -------- -------- ---------- (-v) Rank UUID Control Address Fault Domain State Reason ---- ---- --------------- ------------ ----- ------ 0 570660ae-1727-4ce0-9650-6c31e81c9d30 10.7.1.8:10001 /boro-8.boro.hpdd.intel.com Joined 1 74390dd0-7fbc-4309-8665-d5f24218c8d9 10.7.1.35:10001 /boro-35.boro.hpdd.intel.com Joined |
dmg system query with debug
| Code Block | ||
|---|---|---|
| ||
$ dmg system query --debug (-d)
DEBUG 21:17:29.765815 main.go:216: debug output enabled
DEBUG 21:17:29.766483 main.go:243: control config loaded from /etc/daos/daos_control.yml
DEBUG 21:17:29.768661 system.go:368: DAOS system query request: &{unaryRequest:{request:{deadline:{wall:0 ext:0 loc:<nil>} Sys: HostList:[]} rpc:0xc83b40} msRequest:{} sysRequest:{Ranks:{RWMutex:{w:{state:0 sema:0} writerSem:0 readerSem:0 readerCount:0 readerWait:0} HostSet:{Mutex:{state:0 sema:0} list:0xc0001909c0}} Hosts:{Mutex:{state:0 sema:0} list:0xc000190980}} retryableRequest:{retryTimeout:0 retryInterval:0 retryMaxTries:0 retryTestFn:0xc83ca0 retryFn:0xc83de0} FailOnUnavailable:false}
DEBUG 21:17:29.769332 rpc.go:196: request hosts: [boro-8:10001 boro-35:10001]
DEBUG 21:17:29.823432 system.go:200: System-Query command succeeded, absent hosts: , absent ranks:
Rank State
---- -----
[0-1] Joined |
dmg storage query usage
| Code Block | ||
|---|---|---|
| ||
$ dmg storage query usage
Hosts SCM-Total SCM-Free SCM-Used NVMe-Total NVMe-Free NVMe-Used
----- --------- -------- -------- ---------- --------- ---------
boro-35 17 GB 17 GB 0 % 0 B 0 B N/A
boro-8 17 GB 17 GB 0 % 0 B 0 B N/A |
dmg pool create help
| Code Block | ||
|---|---|---|
| ||
$ dmg pool create --help
Usage:
dmg [OPTIONS] pool create [create-OPTIONS]
Application Options:
--allow-proxy Allow proxy configuration via environment
-l, --host-list= comma separated list of addresses <ipv4addr/hostname>
-i, --insecure have dmg attempt to connect without certificates
-d, --debug enable debug output
-j, --json Enable JSON output
-J, --json-logging Enable JSON-formatted log output
-o, --config-path= Client config file path
Help Options:
-h, --help Show this help message
[create command options]
-g, --group= DAOS pool to be owned by given group, format name@domain
-u, --user= DAOS pool to be owned by given user, format name@domain
-p, --name= Unique name for pool (set as label)
-a, --acl-file= Access Control List file path for DAOS pool
-z, --size= Total size of DAOS pool (auto)
-t, --scm-ratio= Percentage of SCM:NVMe for pool storage (auto) (default: 6)
-k, --nranks= Number of ranks to use (auto)
-v, --nsvc= Number of pool service replicas
-s, --scm-size= Per-server SCM allocation for DAOS pool (manual)
-n, --nvme-size= Per-server NVMe allocation for DAOS pool (manual)
-r, --ranks= Storage server unique identifiers (ranks) for DAOS pool
-S, --sys= DAOS system that pool is to be a part of (default: daos_server) |
dmg pool create
| Code Block | ||
|---|---|---|
| ||
$ dmg pool create --size=10G
Creating DAOS pool with automatic storage allocation: 10 GB NVMe + 6.00% SCM
Pool created with 100.00% SCM/NVMe ratio
-----------------------------------------
UUID : 0a6003c6-23a7-4cb5-8895-c004ca2b75f5
Service Ranks : 0
Storage Ranks : [0-1]
Total Size : 10 GB
SCM : 10 GB (5.0 GB / rank)
NVMe : 0 B (0 B / rank)
$ dmg storage query usage
Hosts SCM-Total SCM-Free SCM-Used NVMe-Total NVMe-Free NVMe-Used
----- --------- -------- -------- ---------- --------- ---------
boro-35 17 GB 12 GB 29 % 0 B 0 B N/A
boro-8 17 GB 11 GB 36 % 0 B 0 B N/A |
dmg pool list
| Code Block | ||
|---|---|---|
| ||
$ dmg pool list Pool UUID Svc Replicas --------- --------- boro-8 17 GB 17 GB 0 % 0 B ------------ 5f362dc2-6154-44c7-8348-9de6f0a3d5d1 0 B N/A |
dmg pool
...
destroy
| Code Block | ||
|---|---|---|
| ||
$ dmg pool createdestroy --size=10GB Creating DAOS pool with automatic storage allocation: 10 GB NVMe + 6.00% SCM Pool created with 100.00% SCM/NVMe ratiopool=$DAOS_POOL Pool-destroy command succeeded $ dmg pool list no pools in system $ dmg storage query usage Hosts SCM-Total SCM-Free SCM-Used NVMe-Total NVMe-Free NVMe-Used ----- --------- -------- -------- ---------- --------- UUID : 5f362dc2-6154-44c7-8348-9de6f0a3d5d1 Service Ranks : 0 --------- boro-35 17 GB 17 GB 0 % 0 B Storage Ranks : 0 B N/A boro-8 17 GB 17 GB 0 % 0 B Total Size : 10 GB0 B N/A |
dmg pool query
| Code Block | ||
|---|---|---|
| ||
$ dmg pool create --size=10G Creating DAOS pool with automatic storage allocation: 10 GB NVMe + 6.00% SCM : 10 GB (10 GB / rank) Pool created with 100.00% SCM/NVMe ratio ----------------------------------------- UUID : NVMecf860261-4fde-4403-b10b-abe8eb9dd32f Service Ranks : 0 : 0 B (0 B / rank) $ dmg storage query usage HostsStorage Ranks SCM-Total SCM-Free SCM-Used NVMe-Total NVMe-Free NVMe-Used ----- --------- -------- -------- ---------- --------- --------- boro-8 17 GB: [0-1] 6.0 GB 65 % 0 B Total Size : 10 0GB B N/A |
dmg pool list
| No Format |
|---|
$ dmg pool list Pool UUID SCM : 10 GB Svc Replicas ---------(5.0 GB / rank) NVMe ------------ 5f362dc2-6154-44c7-8348-9de6f0a3d5d1 0 : 0 B (0 B / rank) |
dmg pool destroy
| No Format |
|---|
$ dmg pool destroy --pool=$DAOS_POOL Pool-destroy command succeeded $ dmg pool list no pools in system $ dmg storage query usage Hosts SCM-Total SCM-Free SCM-Used NVMe-Total NVMe-Free NVMe-Used ----- --------- -------- -------- ---------- Pool UUID Svc Replicas --------- --------- boro-8 17 GB 17 GB 0 % 0 B ------------ cf860261-4fde-4403-b10b-abe8eb9dd32f 0 B N/A |
dmg pool query
| No Format |
|---|
$ dmg pool query --pool=$DAOS_POOL Pool 528f4710cf860261-7eb84fde-48504403-b6aab10b-09e4b3c8f532abe8eb9dd32f, ntarget=816, disabled=0, leader=0, version=1 Pool space info: - Target(VOS) count:816 - SCM: Total size: 10 GB Free: 10 GB, min:1.2625 GBMB, max:1.2625 GBMB, mean:1.2625 GBMB - NVMe: Total size: 0 B Free: 0 B, min:0 B, max:0 B, mean:0 B Rebuild idle, 0 objs, 0 recs |
dmg pool create for specified user and group
| Code Block | |
|---|---|
| |
| |
# Create a 1GB pool for user:user_1 group:admin_group1 $ dmg pool create --group=admin_group1 --user=user_1 --size=1G Creating DAOS pool with automatic storage allocation: 1.0 GB NVMe + 6.00% SCM Pool created with 100.00% SCM/NVMe ratio ----------------------------------------- UUID : 64efd827-6bcb-434b-ab78-2010984539ff Service Ranks : 0 Storage Ranks : 0 Total Size : 1.0 GB SCM : 1.0 GB (1.0 GB / rank) NVMe : 0 B (0 B / rank) |
dmg pool create with security setting
| No Formatcode | ||
|---|---|---|
| ||
# Create a pool with access-control via a access-list test file $ dmg pool create --size=1G --acl-file=/tmp/acl_test.txt Creating DAOS pool with automatic storage allocation: 1.0 GB NVMe + 6.00% SCM Pool created with 100.00% SCM/NVMe ratio ----------------------------------------- UUID : 4533f724-7234-4c70-946c-b7a53d7d0ddf Service Ranks : 0 Storage Ranks : 0 Total Size : 1.0 GB SCM : 1.0 GB (1.0 GB / rank) NVMe : 0 B (0 B / rank) # Example of access entries on /tmp/acl_test.txt # pool OWNER: read-write permission # pool owner GROUP: read-write permission # test_user1: write-only permission # test_user2: read-only permission # test_group1: write-only permission # test_group2: read-only permission # EVERYONE else: no permission A::OWNER@:rw A:G:GROUP@:rw A::test_user1@:w A::test_user2@:r A:G:test_group1@:w A:G:test_group2@:r A::EVERYONE@: # Get pool security acl $ dmg pool get-acl --pool=$DAOS_POOL # Entries: A::OWNER@:rw A::test_user1@:w A::test_user2@:r A:G:GROUP@:rw A:G:test_group1@:w A:G:test_group2@:r A::EVERYONE@: # Update pool access entry for test_group1 to no-permission dmg pool update-acl -e A:G:test_group1@: --pool=$DAOS_POOL # Update pool access entry for new user test_user3 with rw permission dmg pool update-acl -e A::test_user3@:rw --pool=$DAOS_POOL # Get pool security acl after update-acl $ dmg pool get-acl --pool=$DAOS_POOL # Entries: A::OWNER@:rw A::test_user1@:w A::test_user2@:r A::test_user3@:rw A:G:GROUP@:rw A:G:test_group1@: A:G:test_group2@:r A::EVERYONE@: |
DAOS tool (daos) usage for daos_client
| No Formatcode | ||
|---|---|---|
| ||
$ /usr/bin/daos help
daos command (v1.2.2), libdaos 1.2.0
usage: daos RESOURCE COMMAND [OPTIONS]
resources:
pool pool
container (cont) container
filesystem (fs) copy to and from a POSIX filesystem
object (obj) object
shell Interactive obj ctl shell for DAOS
version print command version
help print this message and exit
use 'daos help RESOURCE' for resource specifics
$ daos help cont
daos command (v1.2.2), libdaos 1.2.0
container (cont) commands:
create create a container
clone clone a container
destroy destroy a container
list-objects list all objects in container
list-obj
query query a container
get-prop get all container's properties
set-prop set container's properties
get-acl get a container's ACL
overwrite-acl replace a container's ACL
update-acl add/modify entries in a container's ACL
delete-acl delete an entry from a container's ACL
set-owner change the user and/or group that own a container
stat get container statistics
check check objects consistency in container
list-attrs list container user-defined attributes
del-attr delete container user-defined attribute
get-attr get container user-defined attribute
set-attr set container user-defined attribute
create-snap create container snapshot (optional name)
at most recent committed epoch
list-snaps list container snapshots taken
destroy-snap destroy container snapshots
by name, epoch or range
rollback roll back container to specified snapshot
use 'daos help cont|container COMMAND' for command specific options
|
...