From 5329166169b4686720970b63ae1e7326ee4bb047 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 2 Mar 2019 19:44:59 +0100 Subject: Merging upstream version 20190301. Signed-off-by: Daniel Baumann --- share/apache/conf/ceph-info.conf | 4 +- share/ceph-info/web/ceph-df.txt | 2 +- share/ceph-info/web/ceph-health-detail.txt | 2 +- share/ceph-info/web/ceph-osd-df.txt | 2 +- share/ceph-info/web/ceph-osd-tree.txt | 2 +- share/ceph-info/web/ceph-status.txt | 2 +- share/ceph-info/web/ceph-versions.txt | 2 +- share/ceph-info/web/ceph-watch.log | 2 +- share/ceph-info/web/date.txt | 2 +- share/doc/examples/ceph-tools | 20 +++ share/doc/examples/storage-tools | 20 --- share/logrotate/ceph-log | 2 +- share/logrotate/cephfs-snap | 2 +- share/man/Makefile | 5 +- share/man/ceph-info.1 | 78 +++++++++++ share/man/ceph-info.1.txt | 9 +- share/man/ceph-log.1 | 71 ++++++++++ share/man/ceph-log.1.txt | 7 +- share/man/ceph-remove-osd.1.txt | 66 ---------- share/man/cephfs-snap.1 | 117 +++++++++++++++++ share/man/cephfs-snap.1.txt | 5 +- share/man/storage-tools.7 | 201 +++++++++++++++++++++++++++++ share/man/storage-tools.7.txt | 6 +- 23 files changed, 510 insertions(+), 119 deletions(-) create mode 100644 share/doc/examples/ceph-tools delete mode 100644 share/doc/examples/storage-tools create mode 100644 share/man/ceph-info.1 create mode 100644 share/man/ceph-log.1 delete mode 100644 share/man/ceph-remove-osd.1.txt create mode 100644 share/man/cephfs-snap.1 create mode 100644 share/man/storage-tools.7 (limited to 'share') diff --git a/share/apache/conf/ceph-info.conf b/share/apache/conf/ceph-info.conf index a1136e0..bac9681 100644 --- a/share/apache/conf/ceph-info.conf +++ b/share/apache/conf/ceph-info.conf @@ -1,8 +1,8 @@ - Alias /ceph-info /usr/share/storage-tools/ceph-info/web + Alias /ceph-info /usr/share/open-infrastructure/ceph-info/web - + Options FollowSymlinks Options -Indexes diff --git a/share/ceph-info/web/ceph-df.txt b/share/ceph-info/web/ceph-df.txt index dff3a13..e47ee39 120000 --- a/share/ceph-info/web/ceph-df.txt +++ b/share/ceph-info/web/ceph-df.txt @@ -1 +1 @@ -/var/log/storage-tools/ceph-info/ceph-df.txt \ No newline at end of file +/var/cache/open-infrastructure/ceph-info/ceph-df.txt \ No newline at end of file diff --git a/share/ceph-info/web/ceph-health-detail.txt b/share/ceph-info/web/ceph-health-detail.txt index e78c3e7..bcedc12 120000 --- a/share/ceph-info/web/ceph-health-detail.txt +++ b/share/ceph-info/web/ceph-health-detail.txt @@ -1 +1 @@ -/var/log/storage-tools/ceph-info/ceph-health-detail.txt \ No newline at end of file +/var/cache/open-infrastructure/ceph-info/ceph-health-detail.txt \ No newline at end of file diff --git a/share/ceph-info/web/ceph-osd-df.txt b/share/ceph-info/web/ceph-osd-df.txt index c5de915..5e61d4c 120000 --- a/share/ceph-info/web/ceph-osd-df.txt +++ b/share/ceph-info/web/ceph-osd-df.txt @@ -1 +1 @@ -/var/log/storage-tools/ceph-info/ceph-osd-df.txt \ No newline at end of file +/var/cache/open-infrastructure/ceph-info/ceph-osd-df.txt \ No newline at end of file diff --git a/share/ceph-info/web/ceph-osd-tree.txt b/share/ceph-info/web/ceph-osd-tree.txt index 019a0bb..7418b7d 120000 --- a/share/ceph-info/web/ceph-osd-tree.txt +++ b/share/ceph-info/web/ceph-osd-tree.txt @@ -1 +1 @@ -/var/log/storage-tools/ceph-info/ceph-osd-tree.txt \ No newline at end of file +/var/cache/open-infrastructure/ceph-info/ceph-osd-tree.txt \ No newline at end of file diff --git a/share/ceph-info/web/ceph-status.txt b/share/ceph-info/web/ceph-status.txt index c7042bb..35e400e 120000 --- a/share/ceph-info/web/ceph-status.txt +++ b/share/ceph-info/web/ceph-status.txt @@ -1 +1 @@ -/var/log/storage-tools/ceph-info/ceph-status.txt \ No newline at end of file +/var/cache/open-infrastructure/ceph-info/ceph-status.txt \ No newline at end of file diff --git a/share/ceph-info/web/ceph-versions.txt b/share/ceph-info/web/ceph-versions.txt index bb9d86e..7bd9fb4 120000 --- a/share/ceph-info/web/ceph-versions.txt +++ b/share/ceph-info/web/ceph-versions.txt @@ -1 +1 @@ -/var/log/storage-tools/ceph-info/ceph-versions.txt \ No newline at end of file +/var/cache/open-infrastructure/ceph-info/ceph-versions.txt \ No newline at end of file diff --git a/share/ceph-info/web/ceph-watch.log b/share/ceph-info/web/ceph-watch.log index 3644891..660f345 120000 --- a/share/ceph-info/web/ceph-watch.log +++ b/share/ceph-info/web/ceph-watch.log @@ -1 +1 @@ -/var/log/storage-tools/ceph-log/ceph-watch.log \ No newline at end of file +/var/cache/open-infrastructure/ceph-info/ceph-watch.log \ No newline at end of file diff --git a/share/ceph-info/web/date.txt b/share/ceph-info/web/date.txt index 22fb159..33dad46 120000 --- a/share/ceph-info/web/date.txt +++ b/share/ceph-info/web/date.txt @@ -1 +1 @@ -/var/log/storage-tools/ceph-info/date.txt \ No newline at end of file +/var/cache/open-infrastructure/ceph-info/date.txt \ No newline at end of file diff --git a/share/doc/examples/ceph-tools b/share/doc/examples/ceph-tools new file mode 100644 index 0000000..f665390 --- /dev/null +++ b/share/doc/examples/ceph-tools @@ -0,0 +1,20 @@ +# /etc/open-infrastructure/ceph-tools.conf + +CEPH_INFO="true" +CEPH_LOG="true" + +CEPHFS_SNAP="true" +CEPHFS_SNAP_DIRECTORIES="" + +# keep hourly snapshots for 1 week: (24 * 7) + 1 +CEPHFS_SNAP_HOURLY="169" +# keep daily snapshots for 1 month: (31) + 1 +CEPHFS_SNAP_DAILY="32" +# keep weekly snapshots for 6 months: (4 * 6) + 1 +CEPHFS_SNAP_WEEKLY="25" +# keep monthly snapshots for 1 year: (12) + 1 +CEPHFS_SNAP_MONTHLY="13" +# keep yearly snapshots for 10 year: (10) + 1 +CEPHFS_SNAP_YEARLY="11" + +IRK_TARGETS="" diff --git a/share/doc/examples/storage-tools b/share/doc/examples/storage-tools deleted file mode 100644 index c74cb78..0000000 --- a/share/doc/examples/storage-tools +++ /dev/null @@ -1,20 +0,0 @@ -# /etc/default/storage-tools - -CEPH_INFO="true" -CEPH_LOG="true" - -CEPHFS_SNAP="true" -CEPHFS_SNAP_DIRECTORIES="" - -# keep hourly snapshots for 1 week: (24 * 7) + 1 -CEPHFS_SNAP_HOURLY="169" -# keep daily snapshots for 1 month: (31) + 1 -CEPHFS_SNAP_DAILY="32" -# keep weekly snapshots for 6 months: (4 * 6) + 1 -CEPHFS_SNAP_WEEKLY="25" -# keep monthly snapshots for 1 year: (12) + 1 -CEPHFS_SNAP_MONTHLY="13" -# keep yearly snapshots for 10 year: (10) + 1 -CEPHFS_SNAP_YEARLY="11" - -IRK_TARGETS="" diff --git a/share/logrotate/ceph-log b/share/logrotate/ceph-log index 7bcaf3f..2e62e60 100644 --- a/share/logrotate/ceph-log +++ b/share/logrotate/ceph-log @@ -1,4 +1,4 @@ -/var/log/storage-tools/ceph-log/ceph-watch.log { +/var/log/open-infrastructure/ceph-watch.log { compress create 0644 root root dateext diff --git a/share/logrotate/cephfs-snap b/share/logrotate/cephfs-snap index 21aae15..e444829 100644 --- a/share/logrotate/cephfs-snap +++ b/share/logrotate/cephfs-snap @@ -1,4 +1,4 @@ -/var/log/storage-tools/cephfs-snap/cephfs-snap.log { +/var/log/open-infrastructure/cephfs-snap.log { compress create 0640 root adm dateext diff --git a/share/man/Makefile b/share/man/Makefile index 101186e..2fe75b5 100644 --- a/share/man/Makefile +++ b/share/man/Makefile @@ -1,7 +1,4 @@ -# Makefile - -# storage-tools - Additional utilities to manage storage related tasks -# Copyright (C) 2014-2017 Daniel Baumann +# Copyright (C) 2014-2019 Daniel Baumann # # SPDX-License-Identifier: GPL-3.0+ # diff --git a/share/man/ceph-info.1 b/share/man/ceph-info.1 new file mode 100644 index 0000000..263437a --- /dev/null +++ b/share/man/ceph-info.1 @@ -0,0 +1,78 @@ +'\" t +.\" Title: ceph-info +.\" Author: [see the "AUTHORS" section] +.\" Generator: DocBook XSL Stylesheets v1.79.1 +.\" Date: 20171101 +.\" Manual: Open Infrastructure +.\" Source: storage-tools +.\" Language: English +.\" +.TH "CEPH\-INFO" "1" "20171101" "storage\-tools" "Open Infrastructure" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +ceph-info \- show Ceph cluster information as a website\&. +.SH "SYNOPSIS" +.sp +\fBceph\-info\fR +.SH "DESCRIPTION" +.sp +When operating large, central storage systems the trust of the users that their data is always safe is paramount\&. Specifically in the enterprise environment, gaining trust from the users to save their data on your Ceph cluster (which is "just" SDS) can be achieved with technical transparency\&. +.sp +The ceph\-info program shows Ceph cluster information as a website where anyone interested can observe the clusters health and action transparently, without requireing Ceph specific knowledge or access privileges\&. +.sp +For the system administrators it provides a neat "one page" overview of all essential health information of the cluster, rather than to do the same commands over the command line\&. +.sp +The info page is by default visible on http://localhost/ceph\-info +.SH "OPTIONS" +.sp +The ceph\-info program has no options\&. +.SH "FILES" +.sp +The following files are used: +.PP +\fB/etc/open\-infrastructure/ceph\-tools\&.conf\fR +.RS 4 +Configuration file\&. +.RE +.PP +\fB/var/cache/open\-infrastructure/ceph\-info/\fR\&.txt* +.RS 4 +Ceph cluster information dumps\&. +.RE +.PP +\fB/usr/share/open\-infrastructure/ceph\-info/web\fR +.RS 4 +ceph\-info document root\&. +.RE +.SH "SEE ALSO" +.sp +storage\-tools(7)\&. +.SH "HOMEPAGE" +.sp +More information about storage\-tools and the Open Infrastructure project can be found on the homepage at https://open\-infrastructure\&.net\&. +.SH "CONTACT" +.sp +Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List \&. +.sp +Debian specific bugs can also be reported in the Debian Bug Tracking System at https://bugs\&.debian\&.org\&. +.SH "AUTHORS" +.sp +storage\-tools was written by Daniel Baumann \&. diff --git a/share/man/ceph-info.1.txt b/share/man/ceph-info.1.txt index cf9088a..13d485b 100644 --- a/share/man/ceph-info.1.txt +++ b/share/man/ceph-info.1.txt @@ -1,5 +1,4 @@ -// storage-tools - Additional utilities to manage storage related tasks -// Copyright (C) 2014-2017 Daniel Baumann +// Copyright (C) 2014-2019 Daniel Baumann // // SPDX-License-Identifier: GPL-3.0+ // @@ -61,13 +60,13 @@ FILES ----- The following files are used: -*/etc/default/storage-tools*:: +*/etc/open-infrastructure/ceph-tools.conf*:: Configuration file. -*/var/log/storage-tools/ceph-info/*.txt*:: +*/var/cache/open-infrastructure/ceph-info/*.txt*:: Ceph cluster information dumps. -*/usr/share/storage-tools/ceph-info/web*:: +*/usr/share/open-infrastructure/ceph-info/web*:: ceph-info document root. diff --git a/share/man/ceph-log.1 b/share/man/ceph-log.1 new file mode 100644 index 0000000..9391492 --- /dev/null +++ b/share/man/ceph-log.1 @@ -0,0 +1,71 @@ +'\" t +.\" Title: ceph-log +.\" Author: [see the "AUTHORS" section] +.\" Generator: DocBook XSL Stylesheets v1.79.1 +.\" Date: 20171101 +.\" Manual: Open Infrastructure +.\" Source: storage-tools +.\" Language: English +.\" +.TH "CEPH\-LOG" "1" "20171101" "storage\-tools" "Open Infrastructure" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +ceph-log \- store Ceph cluster log as a logfile +.SH "SYNOPSIS" +.sp +\fBceph\-log\fR +.SH "DESCRIPTION" +.sp +When operating a Ceph storage cluster, the command \fIceph \-w\fR let\(cqs the system administrator watch everything that is happening in a ceph cluster, such as the health state of the cluster, any cluster changes and any commands and mounts from clients that are happening\&. +.sp +Unfortunately the \fIceph \-w\fR command is a tool that a system administrator uses for real time information, means there is no history or looking backward what happened at a given time\&. +.sp +The ceph\-log program stores the output of \fIceph \-w\fR into a logfile and rotate its\&. This allows the system administrator to go back and check what exactly happened in detail within a Ceph storage cluster at any given time\&. +.SH "OPTIONS" +.sp +The ceph\-log program has no options\&. +.SH "FILES" +.sp +The following files are used: +.PP +\fB/etc/open\-infrastructure/ceph\-tools\&.conf\fR +.RS 4 +Configuration file\&. +.RE +.PP +\fB/var/log/open\-infrastructure/ceph\-watch\&.log\fR +.RS 4 +Ceph cluster logfile\&. +.RE +.SH "SEE ALSO" +.sp +storage\-tools(7)\&. +.SH "HOMEPAGE" +.sp +More information about storage\-tools and the Open Infrastructure project can be found on the homepage at https://open\-infrastructure\&.net\&. +.SH "CONTACT" +.sp +Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List \&. +.sp +Debian specific bugs can also be reported in the Debian Bug Tracking System at https://bugs\&.debian\&.org\&. +.SH "AUTHORS" +.sp +storage\-tools was written by Daniel Baumann \&. diff --git a/share/man/ceph-log.1.txt b/share/man/ceph-log.1.txt index 16c39d8..f5ae604 100644 --- a/share/man/ceph-log.1.txt +++ b/share/man/ceph-log.1.txt @@ -1,5 +1,4 @@ -// storage-tools - Additional utilities to manage storage related tasks -// Copyright (C) 2014-2017 Daniel Baumann +// Copyright (C) 2014-2019 Daniel Baumann // // SPDX-License-Identifier: GPL-3.0+ // @@ -59,10 +58,10 @@ FILES ----- The following files are used: -*/etc/default/storage-tools*:: +*/etc/open-infrastructure/ceph-tools.conf*:: Configuration file. -*/var/log/storage-tools/ceph-log/ceph-watch.log*:: +*/var/log/open-infrastructure/ceph-watch.log*:: Ceph cluster logfile. diff --git a/share/man/ceph-remove-osd.1.txt b/share/man/ceph-remove-osd.1.txt deleted file mode 100644 index 81d35ae..0000000 --- a/share/man/ceph-remove-osd.1.txt +++ /dev/null @@ -1,66 +0,0 @@ -// storage-tools - Additional utilities to manage storage related tasks -// Copyright (C) 2014-2017 Daniel Baumann -// -// SPDX-License-Identifier: GPL-3.0+ -// -// This program is free software: you can redistribute it and/or modify -// it under the terms of the GNU General Public License as published by -// the Free Software Foundation, either version 3 of the License, or -// (at your option) any later version. -// -// This program is distributed in the hope that it will be useful, -// but WITHOUT ANY WARRANTY; without even the implied warranty of -// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -// GNU General Public License for more details. -// -// You should have received a copy of the GNU General Public License -// along with this program. If not, see . - -CEPH-REMOVE-OSD(1) -================== -:doctype: manpage -:man manual: Open Infrastructure -:man source: storage-tools -:man version: {revnumber} - - -NAME ----- -ceph-remove-osd - shortcut for removing an Ceph OSD instance completly. - - -SYNOPSIS --------- -*ceph-remove-osd* OSD - - -DESCRIPTION ------------ -When replacing a broken disk in a Ceph storage cluster, the correct OSD -needs to be shut down properly and its keys removed. - -ceph-remove-osd does all required steps. - - -SEE ALSO --------- -storage-tools(7). - - -HOMEPAGE --------- -More information about storage-tools and the Open Infrastructure project can be -found on the homepage at https://open-infrastructure.net. - - -CONTACT -------- -Bug reports, feature requests, help, patches, support and everything else -are welcome on the Open Infrastructure Software Mailing List . - -Debian specific bugs can also be reported in the Debian Bug Tracking System at https://bugs.debian.org. - - -AUTHORS -------- -storage-tools was written by Daniel Baumann . diff --git a/share/man/cephfs-snap.1 b/share/man/cephfs-snap.1 new file mode 100644 index 0000000..8bc699f --- /dev/null +++ b/share/man/cephfs-snap.1 @@ -0,0 +1,117 @@ +'\" t +.\" Title: cephfs-snap +.\" Author: [see the "AUTHORS" section] +.\" Generator: DocBook XSL Stylesheets v1.79.1 +.\" Date: 20171101 +.\" Manual: Open Infrastructure +.\" Source: storage-tools +.\" Language: English +.\" +.TH "CEPHFS\-SNAP" "1" "20171101" "storage\-tools" "Open Infrastructure" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +cephfs-snap \- create CephFS snapshots periodically +.SH "SYNOPSIS" +.sp +\fBcephfs\-snap\fR +.sp +\fBcephfs\-snap\fR [hourly|daily|weekly|monthly] +.SH "DESCRIPTION" +.sp +CephFS supports creating snapshots of the filesystem as a simple means of backups\&. +.sp +The cephfs\-snap program is a simple tool to do this periodically\&. +.SH "CONFIGURATION" +.sp +cephfs\-snap is configured in /etc/default/storage\-tools\&. The following variables are used: +.PP +\fBCEPHFS_SNAP\fR +.RS 4 +Boolean, either true or false\&. If set to false (default), cephfs will do nothing\&. +.RE +.PP +\fBCEPHFS_SNAP_DIRECTORIES\fR +.RS 4 +List of one or more space separated directories\&. If no directory is specified, cephfs\-snap will do nothing\&. +.RE +.PP +\fBCEPHFS_SNAP_HOURLY\fR +.RS 4 +Integer, number of how many most recent hourly snapshots are to be kept at any given time\&. Any older snapshots will be removed\&. Note: specify one more than you wan to keep, e\&.g\&. 25 for one day of hourly snapshots alongside the most current one\&. +.RE +.PP +\fBCEPHFS_SNAP_DAILY\fR +.RS 4 +Integer, number of how many most recent daily snapshots are to be kept at any given time\&. +.RE +.PP +\fBCEPHFS_SNAP_WEEKLY\fR +.RS 4 +Integer, number of how many most recent weekly snapshots are to be kept at any given time\&. +.RE +.PP +\fBCEPHFS_SNAP_MONTHLY\fR +.RS 4 +Integer, number of how many most recent monthly snapshots are to be kept at any given time\&. +.RE +.PP +\fBCEPHFS_SNAP_YEARLY\fR +.RS 4 +Integer, number of how many most recent yearly snapshots are to be kept at any given time\&. +.RE +.PP +\fBIRK_TARGETS\fR +.RS 4 +List of space separated IRC channels to send notifications to, e\&.g\&.: +irc://irc\&.oftc\&.net:6668/open\-infrastructure +.RE +.SH "FILES" +.sp +The following files are used: +.PP +\fB/etc/cron\&.d/cephfs\-snap\fR +.RS 4 +Cron file\&. +.RE +.PP +\fB/etc/open\-infrastructure/ceph\-tools\&.conf\fR +.RS 4 +Configuration file\&. +.RE +.PP +\fB/var/log/storage\-tools/cephfs\-snap\fR +.RS 4 +Log files\&. +.RE +.SH "SEE ALSO" +.sp +storage\-tools(7)\&. +.SH "HOMEPAGE" +.sp +More information about storage\-tools and the Open Infrastructure project can be found on the homepage at https://open\-infrastructure\&.net\&. +.SH "CONTACT" +.sp +Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List \&. +.sp +Debian specific bugs can also be reported in the Debian Bug Tracking System at https://bugs\&.debian\&.org\&. +.SH "AUTHORS" +.sp +storage\-tools was written by Daniel Baumann \&. diff --git a/share/man/cephfs-snap.1.txt b/share/man/cephfs-snap.1.txt index 2e98bf3..345ba38 100644 --- a/share/man/cephfs-snap.1.txt +++ b/share/man/cephfs-snap.1.txt @@ -1,5 +1,4 @@ -// storage-tools - Additional utilities to manage storage related tasks -// Copyright (C) 2014-2017 Daniel Baumann +// Copyright (C) 2014-2019 Daniel Baumann // // SPDX-License-Identifier: GPL-3.0+ // @@ -80,7 +79,7 @@ The following files are used: */etc/cron.d/cephfs-snap*:: Cron file. -*/etc/default/storage-tools*:: +*/etc/open-infrastructure/ceph-tools.conf*:: Configuration file. */var/log/storage-tools/cephfs-snap*:: diff --git a/share/man/storage-tools.7 b/share/man/storage-tools.7 new file mode 100644 index 0000000..bb58347 --- /dev/null +++ b/share/man/storage-tools.7 @@ -0,0 +1,201 @@ +'\" t +.\" Title: storage-tools +.\" Author: [see the "AUTHORS" section] +.\" Generator: DocBook XSL Stylesheets v1.79.1 +.\" Date: 20171101 +.\" Manual: Open Infrastructure +.\" Source: storage-tools +.\" Language: English +.\" +.TH "STORAGE\-TOOLS" "7" "20171101" "storage\-tools" "Open Infrastructure" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +storage-tools \- Additional utilities to manage storage related tasks +.SH "DESCRIPTION" +.sp +"Computer data storage [\&...] is a technology consisting of computer components and recording media used to retain digital data\&. It is a core function and fundamental component of computers\&." \(em Wikipedia (https://en\&.wikipedia\&.org/wiki/Data_storage_device) +.sp +storage\-tools contains additional utilities to manage storage related tasks\&. +.SH "DOWNLOAD" +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Upstream Releases: +https://files\&.open\-infrastructure\&.net/software/storage\-tools/upstream +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Upstream Sources: +https://sources\&.open\-infrastructure\&.net/software/storage\-tools +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Debian Releases: +https://files\&.open\-infrastructure\&.net/software/storage\-tools/debian +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Debian Sources: +https://sources\&.progress\-linux\&.org/users/daniel/debian/packages/open\-infrastructure\-storage\-tools +.RE +.SH "INSTALLATION" +.SS "SOURCE" +.sp +.RS 4 +.ie n \{\ +\h'-04' 1.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 1." 4.2 +.\} +sudo apt install asciidoc git docbook\-xml docbook\-xsl libxml2\-utils make xsltproc +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 2.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 2." 4.2 +.\} +git clone +https://sources\&.open\-infrastructure\&.net/software/storage\-tools +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 3.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 3." 4.2 +.\} +cd storage\-tools && sudo make install +.RE +.SS "DEBIAN 10 (BUSTER) AND NEWER" +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sudo apt install storage\-tools +.RE +.SH "DEVELOPMENT" +.sp +Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +https://lists\&.open\-infrastructure\&.net/listinfo/software +.RE +.sp +Please base patches against the \fInext\fR Git branch using common sense: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +https://www\&.kernel\&.org/doc/Documentation/SubmittingPatches +.RE +.sp +Debian specific bugs can also be reported in the Debian Bug Tracking System: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +https://bugs\&.debian\&.org +.RE +.SH "TOOLS" +.PP +\fBceph\-log(1):\fR +.RS 4 +store Ceph cluster log as a logfile\&. +.RE +.PP +\fBceph\-info(1):\fR +.RS 4 +show Ceph cluster information as a website\&. +.RE +.PP +\fBcephfs\-snap(1):\fR +.RS 4 +create CephFS snapshots periodically\&. +.RE +.SH "AUTHORS" +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Daniel Baumann +.RE diff --git a/share/man/storage-tools.7.txt b/share/man/storage-tools.7.txt index 78a9182..61f518b 100644 --- a/share/man/storage-tools.7.txt +++ b/share/man/storage-tools.7.txt @@ -1,5 +1,4 @@ -// storage-tools - Additional utilities to manage storage related tasks -// Copyright (C) 2014-2017 Daniel Baumann +// Copyright (C) 2014-2019 Daniel Baumann // // SPDX-License-Identifier: GPL-3.0+ // @@ -88,9 +87,6 @@ TOOLS *cephfs-snap(1):*:: create CephFS snapshots periodically. -*ceph-remove-osd(1):*:: - shortcut for removing an Ceph OSD instance completly. - AUTHORS ------- -- cgit v1.2.3