@ -28,12 +28,12 @@ When set, this changes the password on the target Anvil! sub-cluster. This is th
.TP
.TP
When not set, the Striker dashboard this command is run on will have it's passwords updated.
When not set, the Striker dashboard this command is run on will have it's passwords updated.
.TP
.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.
This is the new password to set. See '\fB\-\-password-file\fR' below for an alternate way to pass in the password.
.TP
.TP
If not set, you will be prompted to enter the new password.
If not set, you will be prompted to enter the new password.
.TP
.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.
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.
@ -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.
Set the log level to 1, 2 or 3 respectively. Be aware that level 3 generates a significant amount of log data.
.SS"Commands:"
.SS"Commands:"
.TP
.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.
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.
anvil-daemon \- Main systemd daemon for the M3 Anvil! IA cluster. Provides all job management, monitoring and Striker back-end functions.
anvil-daemon \- Main systemd daemon for the M3 Anvil! IA cluster. Provides all job management, monitoring and Striker back-end functions.
.SHSYNOPSIS
.SHSYNOPSIS
@ -13,26 +13,23 @@ anvil-daemon \- Main systemd daemon that can be run manually for testing and deb
\-?, \-h, \fB\-\-help\fR
\-?, \-h, \fB\-\-help\fR
Show this man page.
Show this man page.
.TP
.TP
\fB\-\-log-secure\fR
\fB\-\-log\-secure\fR
When logging, record sensitive data, like passwords.
When logging, record sensitive data, like passwords.
.TP
.TP
\-v, \-vv, \-vvv
\-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.
Set the log level to 1, 2 or 3 respectively. Be aware that level 3 generates a significant amount of log data.
.SS"Commands:"
.SS"Commands:"
.TP
.TP
\fB\-\-refresh-json\fR (derecated)
\fB\-\-main\-loop\-only\fR
Short hand for '\fB\-\-run-once\fR', '\fB\-\-main-loop-only\fR' and '\fB\-\-no-start\fR'. Used to be use to refresh the JSON file used by striker's web interface to know hardware states.
.TP
\fB\-\-main-loop-only\fR
This skips the one-time, start-up tasks and just goes into the main-loop.
This skips the one-time, start-up tasks and just goes into the main-loop.
.TP
.TP
\fB\-\-no-start\fR
\fB\-\-no\-start\fR
This will prevent any pending jobs from being picked up and started in this run. Note that other job checks will still happen.
This will prevent any pending jobs from being picked up and started in this run. Note that other job checks will still happen.
.TP
.TP
\fB\-\-run-once\fR
\fB\-\-run\-once\fR
This will tell the program to exit after running the main loop once.
This will tell the program to exit after running the main loop once.
.TP
.TP
\fB\-\-startup-only\fR
\fB\-\-startup\-only\fR
This will tell the program to exit after running the start up tasks, so the main loop won't run.
This will tell the program to exit after running the start up tasks, so the main loop won't run.
When logging, record sensitive data, like passwords.
When logging, record sensitive data, like passwords.
.TP
.TP
\-v, \-vv, \-vvv
\-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.
Set the log level to 1, 2 or 3 respectively. Be aware that level 3 generates a significant amount of log data.
.SS"Commands:"
.SS"Commands:"
.TP
.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.
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.
anvil-download-file \- This program downloads a file from a URL
.SHSYNOPSIS
.Banvil-download-file
\fI\,<options> \/\fR
.SHDESCRIPTION
This takes a URL (ftp, http or https) and downloads the file. If it is called without --url, it shows the progress of any other instances currently downloading files.
.TP
.SHNOTE
This tool is not complete and should not be used yet
.TP
.SHOPTIONS
.TP
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\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\-\-abort\fR (to be implemented)
.TP
Abort an active download.
.TP
\fB\-\-overwrite\fR
.TP
If the file exists already, this switch will overwrite the existing file with the new download.
.TP
\fB\-\-save\-to\fR </path/to/download/directory>
.TP
By default, downloaded files are saved in /mnt/shared/files (copied there after downloading to /mnt/shared/incoming). If you would like to save the downloaded file elsewhere, you can use this switch
.TP
\fB\-\-script\fR
.TP
If this is used, the file being downloaded will be set to be executable.
.TP
\fB\-\-url\fR
.TP
This is the ftp://, http:// or https:// path to the file to be downloaded
.IP
.SHAUTHOR
Written by Madison Kelly, Alteeve staff and the Anvil! project contributors.
anvil-join-anvil \- This tool assembles two subnodes into a node.
.SHSYNOPSIS
.Banvil-join-anvil
\fI\,<command> \/\fR[\fI\,options\/\fR]
.SHDESCRIPTION
This program takes two subnodes and merges them into an Anvil! node. This can be two new subnodes, or an existing subnode with a replacement subnode after a subnode failure.
.TP
.BNote:
.TP
As if this time, this tool only runs from a job registered in the database. As such, the job must be recorded using the Striker web interface
.TP
.SHOPTIONS
.TP
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\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
.TP
This is the job UUID that will be run.
.IP
.SHAUTHOR
Written by Madison Kelly, Alteeve staff and the Anvil! project contributors.
anvil-maintenance-mode \- This program manages flagging a machine in an Anvil! cluster as being in maintenance mode
.SHSYNOPSIS
.Banvil-maintenance-mode
\fI\,<command> \/\fR[\fI\,options\/\fR]
.SHDESCRIPTION
This can set or unset a machine in the Anvil! cluster as being in maintenance mode or not. When called without any switches, it reports if the machine is in maintenance mode or not.
.TP
.BNote:
.TP
Currently, "maintenance mode" is not fully implemented in the Anvil! cluster.
.TP
.SHOPTIONS
.TP
\-?, \-h, \fB\-\-help\fR
Show this man page.
.TP
\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\-\-set\fR {0,1}
.TP
Passing '0' disables maintenance mode, '1' enables it.
.IP
.SHAUTHOR
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
\-?, \-h, \fB\-\-help\fR
Show this man page.
Show this man page.
.TP
.TP
\fB\-\-log-secure\fR
\fB\-\-log\-secure\fR
When logging, record sensitive data, like passwords.
When logging, record sensitive data, like passwords.
.TP
.TP
\-v, \-vv, \-vvv
\-v, \-vv, \-vvv
@ -35,19 +35,19 @@ NOTE: All fields are required when editing an existing mail server or recipient!
\fB\-\-delete\fR
\fB\-\-delete\fR
This deletes an existing mail server or alert recipient.
This deletes an existing mail server or alert recipient.
.TP
.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.
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
.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.
This is required for \fB\-\-edit\fR and \fB\-\-delete\fR. It is the existing alert-override override being worked on.
.TP
.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.
This is the recipients -> recipient_uuid who we are creating the override for.
.TP
.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
This is the hosts -> host_uuid of the machine that you are creating the alert
.TP
.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.
This is the desired override alert level.
Valid values are:
Valid values are:
@ -73,41 +73,41 @@ Valid values are:
4 or "info"
4 or "info"
.TP
.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;
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
.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.
This is required for \fB\-\-edit\fR and \fB\-\-delete\fR. It is the existing mail server being worked on.
.TP
.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.
This is the URL or IP address of the mail server we're logging into to send email.
Example: mail.example.com
Example: mail.example.com
.TP
.TP
\fB\-\-mail-server-port\fR
\fB\-\-mail\-server\-port\fR
This is the TCP port used when connecting to the target mail server.
This is the TCP port used when connecting to the target mail server.
Example: 587
Example: 587
.TP
.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.
This is the mail server user name (usually an email address) used when authenticating against the mail server.
Example: admin@example.com
Example: admin@example.com
.TP
.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.
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
.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.
This is the security type used when authenticating against the mail server.
Valid values are: 'none', 'starttls' or 'tls-ssl'.
Valid values are: 'none', 'starttls' or 'tls-ssl'.
.TP
.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.
This is how passwords are passed to the mail server.
Valid values are: 'none', 'plain-text', or 'encrypted'
Valid values are: 'none', 'plain-text', or 'encrypted'
.TP
.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.
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.
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;
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
.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.
This is required for \fB\-\-edit\fR and \fB\-\-delete\fR. It is the existing alert recipient is being worked on.
.TP
.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.
This is the name of the person receiving the alerts. This is used in the email header.
Example: Austin Powers
Example: Austin Powers
.TP
.TP
\fB\-\-recipient-email\fR
\fB\-\-recipient\-email\fR
This is the email address for the alert recipient.
This is the email address for the alert recipient.
Example: notaspy@example.com
Example: notaspy@example.com
.TP
.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.
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
.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.
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:
Valid values are:
@ -148,7 +148,7 @@ Valid values are:
.TP
.TP
\fB\-\-test\fR
\fB\-\-test\fR
Tells the program to send a test alert at the desired \fB\-\-level\fR. The requested level is required.
Tells the program to send a test alert at the desired \fB\-\-level\fR. The requested level is required.
.TP
.IP
.SHAUTHOR
.SHAUTHOR
Written by Madison Kelly, Alteeve staff and the Anvil! project contributors.
Written by Madison Kelly, Alteeve staff and the Anvil! project contributors.
@ -26,7 +26,7 @@ This will delete the \fB\-\-file\fR </path/to/file> from the entire Anvil! clust
.TP
.TP
This action is permanent!
This action is permanent!
.TP
.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.
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.
@ -57,9 +57,9 @@ Must be used with \fB\-\-reboot\-self\fR to reboot the local system. Otherwise,
.TP
.TP
\fB\-\-timeout\fR <seconds, Nm, Nh>
\fB\-\-timeout\fR <seconds, Nm, Nh>
.TP
.TP
When given, if a system update doesn't complete in this amount of time, error out and abort the update. By default, updates will wait for 24 hours.
When given, if a system update doesn't complete in this amount of time, error out and abort the update. This timeout is used when waiting for actions like waiting for a machine to update, reboot, join a subcluster, and so forth.
.TP
.TP
If this is set to an integer, it is treated as a number of seconds. If this ends in 'm' or 'h', then the preceding number is treated as a number of minutes or hours, respectively.
If this is set to an integer, it is treated as a number of seconds. If this ends in 'm' or 'h', then the preceding number is treated as a number of minutes or hours, respectively. By default, updates will wait for 24 hours.
.IP
.IP
.SHAUTHOR
.SHAUTHOR
Written by Madison Kelly, Alteeve staff and the Anvil! project contributors.
Written by Madison Kelly, Alteeve staff and the Anvil! project contributors.
<keyname="error_0421">Failed to enable dual-primary for the resource: [#!variable!resource!#]! The peer: [#!variable!peer_name!#]'s connection state is: [#!variable!connection_state!#] (must be 'connected').</key>
<keyname="error_0422">Failed to enable dual-primary for the server: [#!variable!server!#]! The call to enable dual-primary, necessary for the live migration, returned a non-zero return code: [#!variable!return_code!#].</key>
<!-- Files templates -->
<!-- Files templates -->
<!-- NOTE: Translating these files requires an understanding of which lines are translatable -->
<!-- NOTE: Translating these files requires an understanding of which lines are translatable -->
@ -2409,6 +2411,8 @@ The file: [#!variable!file!#] needs to be updated. The difference is:
<keyname="log_0742">The job with the command: [#!variable!command!#] and job UUID: [#!variable!job_uuid!#] is restarting.</key>
<keyname="log_0742">The job with the command: [#!variable!command!#] and job UUID: [#!variable!job_uuid!#] is restarting.</key>
<keyname="log_0743">Will run without connecting to the databases. Some features will be unavailable.</key>
<keyname="log_0743">Will run without connecting to the databases. Some features will be unavailable.</key>
<keyname="log_0744">A cached request to reboot this host was found (likely from a --no-db update). Registering a job to reboot now!</key>
<keyname="log_0744">A cached request to reboot this host was found (likely from a --no-db update). Registering a job to reboot now!</key>
<keyname="log_0745">Adjusting the resource: [#!variable!resource!#] to ensure it's compatible with the peer's config prior to connection.</key>
<keyname="log_0746">The local resource: [#!variable!resource!#] is StandAlone, attempting to connect.</key>
<!-- Messages for users (less technical than log entries), though sometimes used for logs, too. -->
<!-- Messages for users (less technical than log entries), though sometimes used for logs, too. -->
<keyname="message_0001">The host name: [#!variable!target!#] does not resolve to an IP address.</key>
<keyname="message_0001">The host name: [#!variable!target!#] does not resolve to an IP address.</key>