swarm_batch Single Command Execution To All Rigs - MaynardMiner/SWARM GitHub Wiki

Using swarm_batch

API Key & HiveOS

swarm_batch requires the following arguments set to work:

  • -API_Key
  • -Hive_Hash
  • -HiveOS Yes (default is it is turned on)

Running Commands

swarm_batch allows you to run a command on one rig, that will execute on all rigs.

Scenario

Upon updating, you noticed issues with pool pricing stats. You want to run clear_profits to reset stats, but don't want to do it on every single rig individually.

Solution

Use swarm_batch

swarm_batch clear_profits

This will take advantage of HiveOS's framework, and SWARM will auto-run clear_profits command on all rigs that are running SWARM.

Scenario

You updated a miner, and want all your rigs to benchmark it.

Solution

Use swarm_batch benchmark miner [minername]

All SWARM rigs will automatically force benchmark that miner.

Scenario

A new miner is available, and you want to update your farm all at once.

Solution

swarm_batch version update [miner name] [version] [link]

Single command to upgrade your entire farm with the new miner.

Restrictions:

  • swarm_batch can run some HiveOS native commands, but not all of them. I do not support this, but you can try.
  • swarm_batch works by finding all rigs running a flight sheet with SWARM as the miner name. It will not work for all rigs.
  • Use only remote commands, or commands that will exit and return data. If you try to run a command that starts a program for example, all your rigs will go offline as agent will wait until the program closes.
  • Commands work across windows and linux versions. However commands ran in windows rigs will only run across windows rigs. Command ran on a HiveOS rig, will only send to HiveOS rigs. This is to prevent issues like updating a miner, in which is OS specific.