The default operational mode is for multi_trepctl list to output the status. A specific mode can be also be specified on the command-line.
Table 9.12. multi_trepctl Commands
|backups||List all the backups available across all configured hosts and services|
|heartbeat||Inserts a heartbeat on all masters within the service|
|list||List the information about each service|
|masterof||List all the masters of configured hosts and services|
|run||Run the specified trepctl command on all hosts/services|
In addition to the two primary commands, multi_trepctl can execute commands that would normally be applied to trepctl, running them on each selected host, service or directory according to the options. The output format and expectation is controlled through the list and run commands.
Outputs the long form of the status information (as per trepctl status) for each identified host.
Lists the available backups across all replicators.
multi_trepctl backups| host | servicename | backup_date | prefix | agent | | host1 | alpha | 2014-08-15 09:40:37 | store-0000000002 | mysqldump | | host1 | alpha | 2014-08-15 09:36:57 | store-0000000001 | mysqldump | | host2 | alpha | 2014-08-12 07:02:29 | store-0000000001 | mysqldump |
Runs the trepctl heartbeat command on all hosts that are identified as masters.
multi_trepctl heartbeathost: host1 servicename: alpha role: master state: ONLINE appliedlastseqno: 8 appliedlatency: 2.619 output:
Lists which hosts are masters of others within the configured services.
multi_trepctl masterof| servicename | host | uri | | alpha | host1 | thl://host1:2112/ |
multi_trepctl| host | servicename | role | state | appliedlastseqno | appliedlatency | | host1 | firstrep | master | OFFLINE:ERROR | -1 | -1.000 | | host2 | firstrep | slave | GOING-ONLINE:SYNCHRONIZING | 5271 | 4656.264 | | host3 | firstrep | slave | OFFLINE:ERROR | -1 | -1.000 | | host4 | firstrep | slave | OFFLINE:ERROR | -1 | -1.000 |
Or selected hosts and services if options are specified. For example, to
get the status only for
multi_trepctl --hosts=host1,host2| host | servicename | role | state | appliedlastseqno | appliedlatency | | host1 | firstrep | master | ONLINE | 5277 | 0.476 | | host2 | firstrep | slave | ONLINE | 5277 | 0.000 |
The multi_trepctl command implies that the status or information is being output from each of the commands executed on the remote hosts and services.
The multi_trepctl run command can be used where the output of the corresponding trepctl command cannot be formatted into a convenient list. For example, to execute a backup on every host within a deployment:
multi_trepctl run backup
The same filters and host or service selection can also be made:
multi_trepctl run backup --hosts=host1,host2,host3host: host1 servicename: firstrep output: | Backup completed successfully; URI=storage://file-system/store-0000000005.properties --- host: host2 servicename: firstrep output: | Backup completed successfully; URI=storage://file-system/store-0000000001.properties --- host: host3 servicename: firstrep output: | Backup completed successfully; URI=storage://file-system/store-0000000001.properties ...
Return from the command will only take place when remote commands on each host have completed and returned.