Guide to Command Line Mining with BFGMiner

From Multipool Wiki
Jump to: navigation, search


  • Note: BFGMiner does not have a graphical interface and is both installed and run via your operating system’s Terminal or Windows console.
    1. Download BFGMiner from the official repository
      1. Be careful with prebuilt packages, spoofed addresses and corrupted mining software.
      Github BFGMiner Repository Snap
    2. Install, configure and build BFGMiner with the correct dependencies and driver configurations for your mining hardware (ie. CPU, GPU, ASIC, etc.) as outlined in the BFGMiners GitHub readme docs, which provides instructions for Linux, Mac OSX and Windows.
    3. File Location for BFGMiner ready to be complied and installed.
    4. Ensure your mining devices are properly connected and powered on.
    5. Gridseed USB mining device plugged in and lit up
    6. Open your “Terminal” on Mac OS X, Linux or “Command Prompt” in Windows.
    7. The three terminals for the different operating systems Mac, Linux and Windows.
    8. Open BFGMiner by executing one of the following in the command line (do not type the $ symbol):
      1. Open BFGMiner without any settings:
      2. $ bfgminer
        Ready to start BFGMiner in terminal.
      3. To start up with a connection to a single pool:
      4. $ bfgminer -o stratum+tcp:// -u workerName -p anyPassword
        • Note: Connect to the “us” or “eu” server, whichever has the shortest ping response.
        • Note: Replace “port” with the 4 digit server port specific to the currency you plan to mine.
        • Note: Replace “workerName” with your workerName.WorkerID.
        • Note: If you plan to mine a scrypt (or non SHA256) algorithm you need to include --scrypt (or --x11) in the command line, typically “$ bfgminer -- scrypt -o ...”.
        • Note: For more BFGMiner command line options visit the BFGMiners GitHub readme docs.
      5. To start with a connection to multiple pools enter:
      6. $ bfgminer -o stratum+tcp:// -u workerName1 -p anyPassword -o   stratum+tcp:// -u workerName2 -p anyPassword
    9. Upon opening, review the metadata BFGMiner displays at the top of the terminal window:
      1. The BFGMiner status line shows:
      2. Ready to start BFGMiner in terminal.
        Pool 0:  Diff:512  +Strtm  LU:[10:48:54] User:koinKangaroo.worker1
        Block #516011: ...497312a9 Diff:3.46T (24.79E) Started: [10:40:23] I: 0.00 BTC/hr
        1. Pool (0, 1, ...): Diff: 512 + Strtm
        2. LU (“Latest update” - Oldest work update currently being used for new work): [hh:mm:ss]
        3. User: userID.workerID
        4. Block: #516011: ...497312a9
        5. Diff (“Current network difficulty”): 3.45T (24.79E)
        6. Started: [hh:mm:ss]
        7. I (“expected income”): 0.00 BTC/hr
      3. The BFGMiner status line shows:
      4. ST:1  F:0  NB:1  AS:0  BW:[ 75/241 B/s]  E:2.42  BS:2.71k
        1. ST (“Staged work items in queue and ready to use”): 2
        2. F (“network failure occasions when the server is down or slow to provide work”): 0
        3. NB (“new blocks detected on the network”): 9
        4. AS (“Active shares in the process of being submitted”): 0
        5. BW (“bandwidth usage on the network (received/sent)”):[ 49/ 2 B/s]
        6. E (“Efficiency is (# shares accepted) * (difficulty of share per 2kB of bandwidth)”): 0.00
        7. BS (“Best all time share difficulty found by the miner”): 0.00
      5. The totals line shows the following:
      6. 0   6/32   75.0C | 171.3/170.8/171.2Gh/s | A:729 R:8+0(.01%) HW:0/.81%
        1. Device (Displayed by processor number, 0, 1, 2, …) (“devices/processors currently hashing, hottest temperature reported by any processor”): 6/32 75.0C
        2. Hash Rates: 20s decaying exponentially decaying average (configurable with --log option) / all-time average hash rate / all-time effective average ): 171.3/170.8/171.2Gh/s
        3. A (“number of accepted shares”): 729
        4. R (“rejected shares+discarded stale shares(% of total rejected shares relative to total shares hashed)”): 8+0(.01%)
        5. HW (“number of hardware errors / % of invalid nonces returned”): 0/.81%
    10. With BFGMiner is running in your terminal, manage the 6 menu options:
      • Note: ”P” or “p” works the same, there is no need to hold down the shift key when selecting the following menu options.
      • Note: When in configuration menus, reporting log will not be displayed. Press any key other than the active menu options to clear the menu and report to status and reporting screen.
      [M]anage devices [P]ool management, [S]ettings, [D]isplay options, [H]elp and [Q]uit.
      1. To manage or connect the connected devices, press “M”
        1. Add a Device by pressing “+”
        2. Search for devices by entering a target. If you don't know the specific serial port address you can enter "auto" or "all", be careful as these commands can write to and affect the operation of your computers ports.
        Select processor to manage using up/down arrow keys
        BFL 0a: 78.0C | 3.64/ 3.70/ 2.91Gh/s | A:46 R:0+0(none) HW: 2/none
        BitFORCE SHA256 SC from Butterfly Labs
        Serial: FTWN6T67
      2. Press “P” for pool management
        1. Add a Pool by pressing “A”
        2. Remove a Pool by pressing “R”
        3. Disable a Pool by pressing “D”
        4. Enable a Pool by pressing “E”
        5. Prioritize a Pool by pressing “P”
        6. Change management strategy by pressing “C”
          • Failover: The default strategy is failover. This will prioritize your mining pool list. If a pool fails it will move down the list, when a higher priority pool recovers it will move back to mining on the highest working priority pool.
          • Round Robin: This strategy moves from one pool to the next when the current pool fails, but will make no other moves.
          • Rotate: This strategy moves at user-defined intervals from one active pool to the next, skipping pools that are idle.
          • Load Balance: This strategy sends work to all the pools on a quota basis. By default, all pools are allocated equal quotas unless specified with "--quota". This apportioning of work is based on work handed out, not shares returned so is independent of difficulty targets or rejected shares. While a pool is disabled or dead, its quota is dropped until it is re-enabled. Quotas are forward looking, so if the quota is changed on the fly, it only affects future work. If all pools are set to zero quota or all pools with quota are dead, it will revert to failover mode.
          • Balance: This strategy monitors the amount of difficulty 1 shares solved for each pool and attempts do the same amount of work for each pool.
        7. Switch Pool by pressing “S”
        8. Get Information on a Pool by pressing “I”
      3. To manage the BFGMiner settings, press “S”
        1. Turn Off/On Longpool setting by pressing “L”: On
        2. Adjust the pool queue by pressing “Q”
        3. Adjust the pool scantime in seconds by pressing “S”
        4. Adjust the pool timeout in seconds by pressing “E”
        5. Adjust the number of connection retry attempts by pressing “R”
        6. Write the config file by pressing “W”
        7. Restart BFGMiner by pressing “B”
      4. To manage the BFGMiner reporting display options, press “D”
        1. Set to Normal reporting by pressing “N”
        2. Clear all reporting by pressing “C”
        3. Silent all reporting by pressing “S”
        4. Turn Debug reporting On/Off by pressing “D”
        5. Turn Per Device reporting On/Off by pressing “P”
        6. Turn Quit reporting On/Off by pressing “Q”
        7. Turn Verbose reporting On/Off by pressing “V”
        8. Turn RPC Debugging On/Off by pressing “R”
        9. Turn reporting worktime details On/Off by pressing “W”
        10. Change the summary detail level between devices, processors and X by pressing “M”
        11. Adjust the log interval between 5, 10, 20 and X by pressing “L”
        12. Adjust the statistical accounts between absolute, X and X by pressing “T”
        13. Zero out the statistics by pressing “Z”
      5. Press “H” for Help and Press “Q” to Quit.
        1. The help menu displays an acronym directory for the metadata.
        2. Upon quitting BFGMiner will display a summary of the sessions mining metadata.