* Created empty man page files all remaining tools.

* Started fixing existing man pages, and writting needed ones.

Signed-off-by: digimer <mkelly@alteeve.ca>
main
digimer 1 year ago
parent 79497fe106
commit 4c118cf3b4
  1. 35
      man/Makefile.am
  2. 2
      man/alteeve-repo-setup.8
  3. 4
      man/anvil-change-password.8
  4. 2
      man/anvil-configure-host.8
  5. 2
      man/anvil-daemon.8
  6. 4
      man/anvil-delete-server.8
  7. 2
      man/anvil-download-file.8
  8. 35
      man/anvil-file-details.8
  9. 40
      man/anvil-manage-alerts.8
  10. 2
      man/anvil-manage-files.8
  11. 0
      man/anvil-network-profiler.8
  12. 0
      man/anvil-parse-fence-agents.8
  13. 0
      man/anvil-pcs-wrapper.8
  14. 0
      man/anvil-provision-server.8
  15. 0
      man/anvil-rename-server.8
  16. 0
      man/anvil-scan-network.8
  17. 0
      man/anvil-show-local-ips.8
  18. 0
      man/anvil-sync-shared.8
  19. 0
      man/anvil-test-alerts.8
  20. 0
      man/anvil-update-definition.8
  21. 0
      man/anvil-update-issue.8
  22. 0
      man/anvil-version-changes.8
  23. 0
      man/anvil-virsh-wrapper.8
  24. 0
      man/anvil-watch-bonds.8
  25. 0
      man/anvil-watch-power.8
  26. 0
      man/fence_delay.8
  27. 0
      man/fence_pacemaker.8
  28. 0
      man/striker-auto-initialize-all.8
  29. 0
      man/striker-boot-machine.8
  30. 0
      man/striker-db-report.8
  31. 0
      man/striker-db-status.8
  32. 0
      man/striker-file-manager.8
  33. 0
      man/striker-get-peer-data.8
  34. 0
      man/striker-manage-install-target.8
  35. 0
      man/striker-manage-peers.8
  36. 0
      man/striker-parse-os-list.8
  37. 0
      man/striker-parse-oui.8
  38. 0
      man/striker-prep-database.8
  39. 0
      man/striker-purge-target.8
  40. 0
      man/striker-scan-network.8
  41. 0
      man/striker-show-db-counts.8
  42. 0
      man/tool-fio-tester.8
  43. 0
      man/unfence_pacemaker.8
  44. 2
      tools/anvil-file-details

@ -29,18 +29,51 @@ dist_man8_MANS = \
anvil-manage-server-storage.8 \
anvil-manage-storage-groups.8 \
anvil-migrate-server.8 \
anvil-network-profiler.8 \
anvil-parse-fence-agents.8 \
anvil-pcs-wrapper.8 \
anvil-provision-server.8 \
anvil-rename-server.8 \
anvil-report-usage.8 \
anvil-safe-start.8 \
anvil-safe-stop.8 \
anvil-scan-network.8 \
anvil-show-local-ips.8 \
anvil-shutdown-server.8 \
anvil-special-operations.8 \
anvil-sync-shared.8 \
anvil-test-alerts.8 \
anvil-update-definition.8 \
anvil-update-issue.8 \
anvil-update-system.8 \
anvil-version-changes.8 \
anvil-virsh-wrapper.8 \
anvil-watch-bonds.8 \
anvil-watch-drbd.8 \
anvil-watch-power.8 \
fence_delay.8 \
fence_pacemaker.8 \
scancore.8 \
striker-auto-initialize-all.8 \
striker-boot-machine.8 \
striker-check-machines.8 \
striker-collect-debug.8 \
striker-db-report.8 \
striker-db-status.8 \
striker-file-manager.8 \
striker-get-peer-data.8 \
striker-initialize-host.8 \
striker-update-cluster.8
striker-manage-install-target.8 \
striker-manage-peers.8 \
striker-parse-os-list.8 \
striker-parse-oui.8 \
striker-prep-database.8 \
striker-purge-target.8 \
striker-scan-network.8 \
striker-show-db-counts.8 \
striker-update-cluster.8 \
tool-fio-tester.8 \
unfence_pacemaker.8

@ -33,7 +33,7 @@ To access our enterprise repository with Alteeve support please visit:
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\fB\-\-log-secure\fR
\fB\-\-log\-secure\fR
When logging, record sensitive data, like passwords.
.TP
\-d, \fB\-\-debug\fR

@ -28,12 +28,12 @@ When set, this changes the password on the target Anvil! sub-cluster. This is th
.TP
When not set, the Striker dashboard this command is run on will have it's passwords updated.
.TP
\fB\-\-new-password\fR <secret>
\fB\-\-new\-password\fR <secret>
This is the new password to set. See '\fB\-\-password-file\fR' below for an alternate way to pass in the password.
.TP
If not set, you will be prompted to enter the new password.
.TP
\fB\-\-password-file\fR </path/to/file>
\fB\-\-password\-file\fR </path/to/file>
This is an alternative way to pass the new password to this program. If set, the file is read in and the file contents are used. Be sure to use one line only in the file.
.IP
.SH AUTHOR

@ -21,7 +21,7 @@ When logging, record sensitive data, like passwords.
Set the log level to 1, 2 or 3 respectively. Be aware that level 3 generates a significant amount of log data.
.SS "Commands:"
.TP
\fB\-\-job-uuid\fR <name>
\fB\-\-job\-uuid\fR <name>
The program is normally run as a job, with data on how to configure the host defined in the job. This switch allows the running of a specific job. If this is not set, the program will search for a job that has not yet been picked up by another process. If found, that job UUID is used automatically.
.IP
.SH AUTHOR

@ -13,7 +13,7 @@ anvil-daemon \- Main systemd daemon that can be run manually for testing and deb
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\fB\-\-log-secure\fR
\fB\-\-log\-secure\fR
When logging, record sensitive data, like passwords.
.TP
\-v, \-vv, \-vvv

@ -16,14 +16,14 @@ This action is permanent!
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\fB\-\-log-secure\fR
\fB\-\-log\-secure\fR
When logging, record sensitive data, like passwords.
.TP
\-v, \-vv, \-vvv
Set the log level to 1, 2 or 3 respectively. Be aware that level 3 generates a significant amount of log data.
.SS "Commands:"
.TP
\fB\-\-job-uuid\fR <UUID>
\fB\-\-job\-uuid\fR <UUID>
The program is normally run as a job, with data on how to configure the host defined in the job. This switch allows the running of a specific job. If this is not set, the program will search for a job that has not yet been picked up by another process. If found, that job UUID is used automatically.
.IP
.SS "Commands:"

@ -17,7 +17,7 @@ This tool is not complete and should not be used yet
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\fB\-\-log-secure\fR
\fB\-\-log\-secure\fR
When logging, record sensitive data, like passwords.
.TP
\-v, \-vv, \-vvv

@ -1,6 +1,6 @@
.\" Manpage for the Anvil! file detail tool
.\" Contact mkelly@alteeve.com to report issues, concerns or suggestions.
.TH anvil-file-details "8" "October 26 2022" "Anvil! Intelligent Availability™ Platform"
.TH anvil-file-details "8" "August 11 2023" "Anvil! Intelligent Availability™ Platform"
.SH NAME
anvil-file-details \- Display details of the file passed in
.SH SYNOPSIS
@ -14,14 +14,43 @@ All this does is stat a file and return the information in a parsable way. For t
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\fB\-\-log-secure\fR
\fB\-\-log\-secure\fR
When logging, record sensitive data, like passwords.
.TP
\-v, \-vv, \-vvv
Set the log level to 1, 2 or 3 respectively. Be aware that level 3 generates a significant amount of log data.
.SS "Commands:"
.TP
\fB\-\-file\fR /path/to/file
.TP
This is the file being examined.
.TP
\fB\-\-with\-md5sum\fR
.TP
Given how long calculating MD5 sums can take on large files, by default this is not done. If you want the md5sum calculated, use this switch.
.TP
.SS "EXAMPLE"
.TP
The output will show the following information:
.TP
.Bl -width
.It
[root@an-striker01 ~]# anvil-file-details --with-md5sum --file /mnt/shared/files/rhel-9.2-x86_64-dvd.iso
.It
File: [/mnt/shared/files/rhel-9.2-x86_64-dvd.iso]
.It
size: [9595977728]
.It
mode: [04644]
.It
uid: [1000]
.It
gid: [1000]
.It
mtime: [1690423778]
.It
md5sum: [90cf58ff7a8f6ef8cb20b8ff091e84b7]
.El
.IP
.SH AUTHOR
Written by Madison Kelly, Alteeve staff and the Anvil! project contributors.

@ -17,7 +17,7 @@ When called without any switches, the list of currect mail servers, alert recipi
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\fB\-\-log-secure\fR
\fB\-\-log\-secure\fR
When logging, record sensitive data, like passwords.
.TP
\-v, \-vv, \-vvv
@ -35,19 +35,19 @@ NOTE: All fields are required when editing an existing mail server or recipient!
\fB\-\-delete\fR
This deletes an existing mail server or alert recipient.
.TP
\fB\-\-alert-overrides\fR
\fB\-\-alert\-overrides\fR
This is where an alert recipient can have alert-override overrides. Typically this is used so that a given user can ignore alerts from a specific Anvil! node pair.
.TP
\fB\-\-alert-override-uuid\fR <uuid>
\fB\-\-alert\-override\-uuid\fR <uuid>
This is required for \fB\-\-edit\fR and \fB\-\-delete\fR. It is the existing alert-override override being worked on.
.TP
\fB\-\-alert-override-recipient-uuid\fR <uuid>
\fB\-\-alert\-override\-recipient\-uuid\fR <uuid>
This is the recipients -> recipient_uuid who we are creating the override for.
.TP
\fB\-\-alert-override-host-uuid\fR
\fB\-\-alert\-override\-host\-uuid\fR
This is the hosts -> host_uuid of the machine that you are creating the alert
.TP
\fB\-\-alert-override-alert-level\fR <1, 2, 3 or 4>
\fB\-\-alert\-override\-alert\-level\fR <1, 2, 3 or 4>
This is the desired override alert level.
Valid values are:
@ -73,41 +73,41 @@ Valid values are:
4 or "info"
.TP
\fB\-\-mail-servers\fR
\fB\-\-mail\-servers\fR
This is used to manage mail servers. Specifically, this control the mail server that we send alert emails to. The options used with this are;
.TP
\fB\-\-mail-server-uuid\fR <uuid>
\fB\-\-mail\-server\-uuid\fR <uuid>
This is required for \fB\-\-edit\fR and \fB\-\-delete\fR. It is the existing mail server being worked on.
.TP
\fB\-\-mail-server-address\fR <URL or IP>
\fB\-\-mail\-server\-address\fR <URL or IP>
This is the URL or IP address of the mail server we're logging into to send email.
Example: mail.example.com
.TP
\fB\-\-mail-server-port\fR
\fB\-\-mail\-server\-port\fR
This is the TCP port used when connecting to the target mail server.
Example: 587
.TP
\fB\-\-mail-server-username\fR
\fB\-\-mail\-server\-username\fR
This is the mail server user name (usually an email address) used when authenticating against the mail server.
Example: admin@example.com
.TP
\fB\-\-mail-server-password\fR
\fB\-\-mail\-server\-password\fR
This is the password used along with \fB\-\-mail-server-username\fR when authenticating against the mail server. Not all mail servers require a password, so this is optional.
.TP
\fB\-\-mail-server-security\fR <none, starttls or tls-ssl>
\fB\-\-mail\-server\-security\fR <none, starttls or tls-ssl>
This is the security type used when authenticating against the mail server.
Valid values are: 'none', 'starttls' or 'tls-ssl'.
.TP
\fB\-\-mail-server-authentication\fR <none, plain-text, or encrypted>
\fB\-\-mail\-server\-authentication\fR <none, plain-text, or encrypted>
This is how passwords are passed to the mail server.
Valid values are: 'none', 'plain-text', or 'encrypted'
.TP
\fB\-\-mail-server-helo-domain\fR
\fB\-\-mail\-server\-helo\-domain\fR
This is the 'HELO' domain name used when communicating with the mail server. This is the domain we're telling the mail server that the email is coming from. You can use your domain, or the domain of the host.
Example: example.com
@ -117,23 +117,23 @@ See: https://www.ibm.com/docs/en/zos/2.2.0?topic=sc-helo-command-identify-domain
\fB\-\-recipients\fR
This is used to manage alert recipients. Specifically, this control the mail server that we send alert emails to. The options used with this are;
.TP
\fB\-\-recipient-uuid\fR
\fB\-\-recipient\-uuid\fR
This is required for \fB\-\-edit\fR and \fB\-\-delete\fR. It is the existing alert recipient is being worked on.
.TP
\fB\-\-recipient-name\fR
\fB\-\-recipient\-name\fR
This is the name of the person receiving the alerts. This is used in the email header.
Example: Austin Powers
.TP
\fB\-\-recipient-email\fR
\fB\-\-recipient\-email\fR
This is the email address for the alert recipient.
Example: notaspy@example.com
.TP
\fB\-\-recipient-language\fR <en_CA>
\fB\-\-recipient\-language\fR <en_CA>
In the future, languages will be added and this can be used to indicate what language the user will receive their alerts in. At the time of writing this man page, only 'en_CA' is supported.
.TP
\fB\-\-recipient-level\fR <1, 2, 3 or 4>
\fB\-\-recipient\-level\fR <1, 2, 3 or 4>
This is the default alert level this recipient is interested in. It can be adjusted on a per-host basis via the 'alert-overrides' over-rides.
Valid values are:

@ -26,7 +26,7 @@ This will delete the \fB\-\-file\fR </path/to/file> from the entire Anvil! clust
.TP
This action is permanent!
.TP
\fB\-\-job-uuid\fR <name>
\fB\-\-job\-uuid\fR <name>
The program is normally run as a job, with data on how to configure the host defined in the job. This switch allows the running of a specific job. If this is not set, the program will search for a job that has not yet been picked up by another process. If found, that job UUID is used automatically.
.IP
.SH AUTHOR

@ -81,7 +81,5 @@ mtime: [".$mtime."]
md5sum: [".$md5sum."]\n";
}
# We're done
$anvil->nice_exit({exit_code => 0});

Loading…
Cancel
Save