jsecchiero/miner repository overview

⁠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