HiveOS & Unix Install - MaynardMiner/SWARM GitHub Wiki

Remote Install On Hive

Watch Setup Video

Video can be found here:

https://www.youtube.com/watch?v=HaENG55FMt0

NOTE Fresh install/reset on HiveOS:

  • Remove SWARM from custom miner downloads:
rm -rf /hive/miners/custom/downloads/SWARM.[your version].linux.tar.gz
  • Remove SWARM from custom miner directory:
rm -rf /hive/miners/custom/SWARM.[your version].linux
  • After that, restart SWARM, it will download fresh again.

Simple Install Instructions (HIVEOS):

This is how to setup miner within HiveOS. Scroll further down if you are attempting to use a different unix operating system.

This is an example of how to remote install/update miner. It is the fastest way to get going. Simply enter tar.gz file name from latest release. If directed here from the Windows setup guide- Use the Windows.zip version instead. Then insert link into the custom miner link box. Next in wallet/worker templates enter 'blah'. Lastly, your setup arguments go in the last box, labeled extra config arguments. After that, you are are good to go! See wiki on proper argument use. Here is a photo of setup:

Coin/Wallet is irrelevant. You can basically enter whatever you want. However using a wallet you want to track through HiveOS is suggested. I merely note that you can use anything. Then navigate to custom miner:

alt text

alt text

From there you should see this window. Pool and URL are setup with arguments. However, Hive 2.0 requires those fields to not be empty. You can simply enter anything there. See photo above on how to setup miner. Just insert the name of the latest release, and the release tar.gz file link. Then insert your arguments in the bottom box.

Alternative Installation (Locally)

git clone https://github.com/MaynardMiner/SWARM
mv SWARM/* /hive/miners/custom/SWARM

Then you omit the Custom Url, and use SWARM as the custom miner name.

The benefit of this, is on a new release, you can just 'pull' changes directly from github. Its probably good to stash changes in SWARM, just in case you want to roll back. You could also do this through the HiveOS dashboard remotely.

cd /hive/miners/custom/SWARM && git stash
cd /hive/miners/custom/SWARM && git pull

FULL ARGUMENT LIST:

NOTE: AS OF 2.7.0, Arguments Are Not Required When First Starting SWARM! Starting SWARM Without 'Extra Config Arguments' Will Begin Guided Help, In Which After A Few Questions- You are Mining!

https://github.com/MaynardMiner/SWARM/blob/master/help/SWARM_help.txt

SAMPLE SETUP Of ARGUMENTS FOR PROFIT SWITCHING:

Items inside of [brackets] are meant to be selected by user. The brackets[] should be removed.
There is a file .\help\SWARM_help.txt that explains each parameters, and all parameters
available in SWARM.

-RigName1 SWARM -Location [Choose one: US or Europe or Asia] -PoolName [Choose Any Number Of Pools: nlpool,blockmasters,zergpool,nicehash,fairpool,ahashpool,blazepool,hashrefinery,phiphipool,zpool] -Type [Choose where applicable: AMD1 or NVIDIA1 or AMD1,NVIDIA2] -Wallet1 [Your BTC Wallet] -Donate .5

SAMPLE SETUP OF SINGLE COIN / ALGORITHM MINING

SWARM has the ability to mine a single algorithm or coin, if supported on the pool you selected.
It will go through all stored miners capable of mining your choice, and then select the best one.
Below is a sample for x16 / RVN. If you wish to mine with auto-exchange to BTC, omit -Coin argument.

-RigName1 SWARM -Location US -PoolName zergpool -Algorithm x16r -Coin RVN -Type NVIDIA1 -Wallet1 1RVNsdO6iuwEHfoiuwe123hsdfljk -Donate .5 -Auto_Coin Yes

SAMPLE SETUP OF MULTIPLE COINS / ALGORITHMS MINING

SWARM has the ability to mine a finite number of algorithms/coins.
Below is an example to mine only RVN and XCZ on zergpool.

-RigName1 SWARM -Location US -PoolName zergpool -Algorithm x16r,mtp -Coin RVN,XCZ -Type NVIDIA1 -Wallet1 1RVNsdO6iuwEHfoiuwe123hsdfljk -Donate .5 -Auto_Coin Yes

SAMPLE SETUP OF MULTIPLE COINS / ALGORITHMS MINING WITH SOLO MINING FOR 1 Coin (Auto-Exchange).##

SWARM, on top of the ability to mine certain coins/algorithms (or all of them available), it also allows you
to solo/party mine coins on pools that allow it, and will switch to solo mode if it is the most profitable.

Below is an example of mining two coins, but specifying coin params for RVN to solo mine w/BTC auto-exchange.

-RigName1 SWARM -Location US -PoolName zergpool -Algorithm x16r,mtp -Coin RVN,XCZ -Coin_Params RVN:none:solo:exchange -Type NVIDIA1 -Wallet1 1RVNsdO6iuwEHfoiuwe123hsdfljk -Donate .5 -Auto_Coin Yes

further details on argument setup is here:

https://github.com/MaynardMiner/SWARM/wiki/Arguments-(Miner-Configuration)

Alternative Option: Local Parameter Setup

SWARM has a folder labeled configs. In each directory there is .json files which make up the bulk of all the different options/configurations of SWARM. In each folder there is a readme explaining what each config does, and how to use.

SWARM in configs\parameters folder has a .json file labled "defaults.json". If this file is copied, and pasted as "newarguments.json" in the same directory- SWARM will use this file instead. No parameters are needed then. You can launch SWARM without the need of arguments, and on each update- it will transfer your parameters (as with all other .json located within the config folder).

Setup for (Ubuntu/Unix)

BELOW IS FOR INSTALLING ON A UNIX SYSTEM OTHER THAN HIVE, OR IF YOU HAVE ISSUES INSTALLING THE HIVEOS VERSION:

IMPORTANT NOTE PLEASE READ:

When SWARM first starts- it exports .\build\lib64.tar.gz to /usr/local/swarm/lib64. These are libs generally required for miners to work. They are 64-bit binary libraries that are built on an Ubuntu machine. Depending on your distribution/hardware/setup you may need to make/build your own libs in place of the ones packed. If you make your own lib, it is suggested to add it to the lib64 folder in place of the lib that is unpacked. An example of this, is if you build CUDA, you can copy the contents of /usr/local/cuda/lib64 to /usr/local/swarm/lib64.

SWARM requires these dependencies (beyond dependencies required for background miners- See their github to determine them).

screen

sudo apt-get install screen

wget (with the ability to handle https)

http://www.linuxfromscratch.org/blfs/view/svn/basicnet/wget.html

lspci

sudo apt-get install lspci

lscpu

sudo apt-get install lscpu

start-stop-daemon

sudo apt-get install start-stop-daemon

libc-ares2

sudo apt-get install libc-ares2

libuv1

sudo apt-get install libuv1

python-minimal

sudo apt-get install python-minimal

If you are using Ubuntu/Unix:

Open swarm file. Edit arguments as necessary.

Install SWARM commands and powershell:

sudo ./install_linux

Note: Depending on flavor, you may have to open install.sh or install.ps1 and modify commands as necessary to make it work. For example, changing all instances from apt to yum for redhat.

Launching Swarm:

sudo ./swarm (Ideally As ROOT)

Why root? Because some miners will fail to detect your cards in some cases. SWARM also needs access to dmidecode and other applications to get details of your rig. Powershell suggests to install pwsh within the /opt folder, which requires root access as well. This means all commands and action in SWARM is down with root, such as sudo get stats and sudo screen -r NVIDIA

If you have issues running SWARM in UNIX- See Developer's Corner for explanations on how SWARM works, what it needs to do so, and other tips in getting it to run in your OS. SWARM was meant to run in root, as it requires the ability to change/chmod/rename files. I can't control this- Some miners don't even properly chmod +x their programs. If you have security concerns, rest assured everything on linux side is 100% open sourced, or uses open sourced and regularly maintained software.

Linux is a very diverse environment. I cannot guarantee it will work right off the bat. However, I guarantee almost no issues while using with Ubuntu 16.04, and Ubuntu 18.04...But I cannot guarantee all miners will work.