summaryrefslogtreecommitdiffhomepage
path: root/tools/unitctl/README.md
diff options
context:
space:
mode:
authorAva Hahn <a.hahn@f5.com>2024-06-18 23:06:05 -0700
committerAva Hahn <110854134+avahahn@users.noreply.github.com>2024-06-19 15:16:40 -0700
commit57a0f94efb2550ea1c6cb593b2b968e022c89346 (patch)
tree68c5e285a92ab8201de393f95c27c13e4faa6bab /tools/unitctl/README.md
parente0c15ae4575335fb079e2d33fc853a547b2380c9 (diff)
downloadunit-57a0f94efb2550ea1c6cb593b2b968e022c89346.tar.gz
unit-57a0f94efb2550ea1c6cb593b2b968e022c89346.tar.bz2
tools/unitctl: unitctl export
* new subcommand for "export" in CLI * new cmd submodule for exporting config tarballs * logic to also output to stdout * README additions * limitations documented Signed-off-by: Ava Hahn <a.hahn@f5.com>
Diffstat (limited to 'tools/unitctl/README.md')
-rw-r--r--tools/unitctl/README.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/tools/unitctl/README.md b/tools/unitctl/README.md
index dca16e63..74366007 100644
--- a/tools/unitctl/README.md
+++ b/tools/unitctl/README.md
@@ -177,6 +177,20 @@ Imported /opt/unit/config/put.json -> /config
Imported 3 files
```
+### Export configuration from a running Unit instance
+```
+$ unitctl export -f config.tar
+```
+
+Addtionally, standard out can be used:
+```
+$ unitctl export -f -
+$ unitctl export -f - | tar xf - config.json
+$ unitctl export -f - > config.tar
+```
+
+*Note:* The exported configuration omits certificates.
+
### Wait for socket to become available
```
$ unitctl --wait-timeout-seconds=3 --wait-max-tries=4 import /opt/unit/config`