miner

Out-of-box toolkit for miners

The main goal is:

• automatically associate each gpu pci with the correct VM with the latest driver installed*
• provide as much possible mining tool

requirements

• cpu feature VT-d
• kernel paramenter:
  • modprobe.blacklist=your gpu driver
  • video=efifb:off [optional if another non-pci gpu is available for normal workload es. X11]
  • intel_iommu=on
  • pcie_aspm=off
• kernel module:
  • vfio
  • vfio_iommu_type1
  • vfio_pci
  • ip6_tables
• docker
• check apparmor/selinux
• ssh

prepare

1. modify this line in /etc/default/grub (disable video output)

Fedora 27

GRUB_CMDLINE_LINUX="rd.lvm.lv=fedora/root rd.lvm.lv=fedora/swap rhgb quiet modprobe.blacklist=radeon,amdgpu intel_iommu=on  video=efifb:off pcie_aspm=off"

Ubuntu 16.04

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash modprobe.blacklist=radeon,amdgpu intel_iommu=on video=efifb:off pcie_aspm=off"

2. update grub config

Fedora 27

grub2-mkconfig -o /etc/grub2-efi.cfg

Ubuntu 16.04

update-grub

3. create the file /etc/modules-load.d/vfio.conf and put those lines

vfio-pci
vfio
vfio_iommu_type1
ip6_tables

4. create a policy for selinux/apparmor or for test disable it

Fedora 27

editing this line /etc/selinux/config

SELINUX=disabled

Ubuntu 16.04

service apparmor stop
service apparmor teardown
update-rc.d -f apparmor remove
apt-get remove apparmor

5. install docker

export CHANNEL=stable
curl -fsSL get.docker.com -o get-docker.sh
sh get-docker.sh
systemctl enable docker
systemctl start docker

6. reboot to make those changes effective

reboot

for the next connection use ssh

usage

Use the SCRIPT env variable for choose the desired tool

available tools

• /usr/local/bin/ethminer
• /usr/local/bin/nsgminer

example

docker run --name miner --restart=always --privileged -d -v /sys/fs/cgroup:/sys/fs/cgroup:ro -v /dev/vfio:/dev/vfio -e SCRIPT="/usr/local/bin/ethminer -M 1 -G -F http://eth-eu.dwarfpool.com/0x4F6dc45fC0CF18ddEC6a893ACF9A3d22E919E0Cc" jsecchiero/miner

list vms

docker exec -it miner vagrant status

monitor the running job with

docker exec -it miner vagrant ssh miner-amd-0 -c 'journalctl -u tool -f'

note

This project is still in development, more documentation will be added in the future. Stay tuned!

*The hardware support is limited to AMD because i don't have any nvidia cards