1STRATIS(8) STRATIS(8)
2
6 stratis - Configure Stratis local storage pools
7
9 stratis [GLOBAL OPTIONS] pool <command> [args] [COMMAND OPTIONS]
10 stratis [GLOBAL OPTIONS] filesystem|fs <command> [args] [COMMAND OPTIONS]
11 stratis [GLOBAL OPTIONS] blockdev <command> [args] [COMMAND OPTIONS]
12 stratis [GLOBAL OPTIONS] daemon <redundancy|version>
13
15 stratis is a command-line tool to create, modify, and destroy Stratis
16 pools, and the filesystems allocated from the pool.
17 Stratis creates a pool from one or more block devices (blockdevs), and
19 then enables multiple filesystems to be created from the pool.
20
22 --version
23 Show stratis-cli version.
24 --help, -h
26 Show help on command.
27 --propagate
29 (For debugging.) Allow exceptions raised during execution to
30 propagate.
31
33 pool create <pool_name> <blockdev> [<blockdev>..]
34 Create a pool from one or more block devices, with the given pool
35 name.
36 pool list
38 List all pools on the system.
39 pool rename <old_pool_name> <new_pool_name>
41 Rename a pool.
42 pool destroy <pool_name>
44 Destroy a pool and all the filesystems created from it.
45 pool add-data <pool_name> <blockdev> [<blockdev>..]
47 Add one or more blockdevs to an existing pool, to enlarge its
48 storage capacity.
49 pool add-cache <pool_name> <blockdev> [<blockdev>..]
51 Add one or more blockdevs to an existing pool, to be used as a
52 cache instead of additional storage. Typically, smaller and faster
53 drives, such as SSDs, are used for this purpose.
54 filesystem create <pool_name> <fs_name> [<fs_name>..]
56 Create one or more filesystems from the specified pool.
57 filesystem snapshot <pool_name> <fs_name> <snapshot_name>
59 Snapshot the filesystem in the specified pool.
60 filesystem list <pool_name>
62 List all filesystems that exist in the specified pool.
63 filesystem destroy <pool_name> <fs_name> [<fs_name>..]
65 Destroy one or more filesystems that exist in the specified pool.
66 filesystem rename <pool_name> <fs_name> <new_name>
68 Rename a filesystem.
69 blockdev list <pool_name>
71 List all blockdevs that make up the specified pool.
72 daemon redundancy
74 List the redundancy levels that the Stratis service supports.
75 daemon version
77 Show the Stratis service’s version.
78
80 Example 1. Creating a Stratis pool
81 stratis pool create mypool /dev/sdb /dev/sdc
83 Example 2. Creating a filesystem from a pool
85 stratis filesystem create mypool data1
87
89 mount(8), umount(8), fstab(5)
90
92 GitHub for issues and development
93 https://github.com/stratis-storage, against either stratis-cli or
94 stratisd projects, based on likelihood of issue being with the
95 command-line tool or the service daemon.
96 Mailing list
98 stratis-devel@lists.fedorahosted.org for general development
99 discussion
100 Unknown values
102 stratis-cli uses the Stratis API. If the API returns values that
103 stratis-cli cannot interpret, stratis-cli will substitute "???". If
104 encountered, upgrading to the latest version of stratis-cli, or
105 filing an issue, is recommended.
106
108 stratis-cli is licensed under the Apache License, Version 2.0. Software
109 distributed under this license is distributed on an "AS IS" BASIS,
110 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either expressed or
111 implied.
112 09/27/2018 STRATIS(8)