lolMiner 0.43
Manual
For basic settings like changing pool and user settings and how to select a user profile please refer
to the quickstart manual.
This document presents further options when running lolMiner 0.43.
Using settings from Command Line
Every normal option that can be passed to the miner via configuration file can also be passed to
the miner by using the command line. The general syntax is if the parameter in configuration file is
a pair “KEY” : “VALUE”, then the command line equivalent is given by -KEY=VALUE. For example
./lolMiner -profile=EXAMPLE_MNX -digits=2
will overwrite any “DIGITS” : <some number> entry from config file. Generally the values in
command line have higher priority then those from other sources.
For adding connection information use the parameters
-pool=<somePoolAddress>
-port=<thePoolsPort>
-user=<userName.workerName>
and (optionally) -pass=<yourWorkerPassword> (the default is “x”).
Internally this will create a pool list with one entry corresponding to the given data. Giving fail-over
pools is currently not supported over command line.
Changing the Mining Devices
The parameter “DEVICES” can be modified in the following way:
“DEVICES” : “AUTO” : Mine will all found AMD & Nvidia GPUs in your rig
“DEVICES” : “AMD” or “DEVICES” : “NVIDIA” : Mine will all GPUs from one of the vendors (only
works with official vendor drivers, with 3
rd
party and opensource drivers this may not work)
“DEVICES” : [0,1,3] work with the first, second and 4
th
device of your rig. You can explicitly control
which GPUs to use, but stay within the range 0 to #GPUs-1 and every GPU id may only appear
once.
For selecting the devices in command line you can use -device= and then a comma separated list
of device numbers or “AUTO”, “AMD” or “NVIDIA”, e.g. -devices=0,1,2.
Mining Equihash 144.5 or 192.7 with Nvidia 3G / 4G cards
The Nvidia driver is very restrict regarding the reported maximal size of the memory allowed in a
single buffer. That said often using bigger memory buffers then reported by the driver often do in
fact work. Therefore to mine Equihash 144.5 on 3G and 4G cards or to mine 192.7 on 4G cards
you have to use the new “DISABLE_MEMCHECK” : 1 (config file) or -disable_memcheck=1
(command line) parameter.
Do not use this for mining 96.5 (MinexCoin) since it also disturbs the work-batch calculation.
Activating the API
The parameter “APIPORT” : <somePortNumer> controls the activation of the lolMiner API. When a
port numer > 0 is set the miner will try to open the selected port and the mining rig will be able to
accept connections on this port.
When connecting, lolMiner returns current mining statistics in JSON format. For example:
{
"Software": "lolMiner 0.4",
"Startup": "2018-07-22 22:08:37 ",
"Coin": "MinexCoin (MNX)",
"Algorithm": "Equihash 96.5",
"LastUpdate(5s)": "22:33:46 ",
"LastUpdate(60s)": "22:32:55 ",
"GPU0": {
"Name": "AMD Radeon (TM) RX 480 Graphics",
"Speed(5s)": "13468.8252",
"Speed(60s)": "13429.5117"
},
"GPU1": {
"Name": "Radeon RX 580 Series",
"Speed(5s)": "11253.1973",
"Speed(60s)": "11262.5537"
}
}
Trouble-Shooting:
If lolMiner is not allowed to open the port there will be a hint “access denied” on startup. The
mining process itself is not affected by this, but the API will not work. We recomment trying an
other port, best in the 4 digit range.
Modify the Statistics Output
All parameters described in this section can be seen in the EXAMPLE_BTG profile in the shipped
user_config.json.
With the parameters “SHORTSTATS” : <number> and “LONGSTATS” : <number> you can modify
the two statistic interval length. The number should be an integer and the values will be handled as
seconds. Setting one or both values to 0 will deactivate the corresponding statistics print as well in
console as in the API.
The parameter “DIGITS” : <number> can be used to fix the sol/s output of a GPU to a fixed number
of digits after the decimal delimiter. For example “DIGITS” : 0 will chop of all digits after the decimal
delimiter. The default for this parameter is 1.
The parameter “TIMEPRINT”:1 or -timeprint=1 will activate the current daytime to be printed in the
command-line console at each statistics output.
The parameter “SHORTACCEPT”:1 or -shotaccept=1 will replace the “submitting share / share
accepted” message pair by * symbols at the short statistics interval output. Every star stands for an
accepted share.
Chosing new locations for the config file and the kernel directiory
A new config file name can only be chosen by command line parameter -usercfg=<pathToFile>,
replacing the ./user_config.json. The path can be absolute or relative to the current execution
directory.
The kernels direction can be chosen by the parameter “KERNELSDIR” : “pathToDir” or -kernelsdir=
(in command line). Again the path can be relative or absolute, the default is “./kernels”.
Adjusting the Failover Pool Function
By the parameter "CONNECTION_ATTEMPTS" : <someNumber> you can specify how many
connection attempts are done before the miner tries to switch to the fail-over pool for the first time.
By the parameter “RECONNECTION_TIMER” : <someNumber> you specify the minutes on how
long the miner should stay on a failover pool before attempting to reconnect to the first priority pool.
If that is still not reachable, the miner will reconnect to the first available fail-over pool. Setting the
number to 0 will deactivate reconnection attempts, unless the end of the list of fail-over pools is
reached at some time.
Setting the WorkBatch (MNX, Equihash 96.5 only)
The Equihash 96.5 algorithm uses only few memory, so the GPU can handle multiple instances of
this algorithm at once. The parameter “WORKBATCH” : <number or special value> controls how
many will be spawned simultaneously. If a number is given this will be applied to all GPUs running
the same time. Instead if one of the special values is given each GPU will be adjusted to its own
value. The following values are allowed:
“VERYLOW” The miner will use at most 20% of the GPU memory
“LOW” The miner will use at most 40% of the GPU memory
“MEDIUM” The miner will use at most 60% of the GPU memory
“HIGH” The miner will use at most 80% of the GPU memory
“VERYHIGH” The miner will use at most 100% (minus few MByte) of the GPU memory
Note that usually the settings “HIGH” and “VERYHIGH” give the best performance, in particular on
AMD hardware. Also note that using “VERYHIGH” is not recommenced when the GPU also does
graphical output. This value should only be selected on headless rigs.
The default value is “MEDIUM”.
Note: On Windows the AMD driver requires the same amount of RAM as GPU memory is
requested on startup. If your system is suffering from too few RAM or a too small virtual memory
the miner may crash or produce 0 sol/s on some cards. To mitigate this increase the fixed space of
the temporary virtual memory or use a lower value for “WORKBATCH”.
Running Benchmark Mode
To see what cards are detected by lolMiner you can run it for a small benchmark. In order to do so
you can open the command line and change to the lolMiner directiory. Then execute
./lolMiner -benchmark=<coinShortCuT> (Linux) or ./lolMiner.exe -benchmark=<coinShortCuT>
(Windows) and the miner will start. If you specified the longStats interval in the default section of
the config file this will determine the length of the benchmark run. The coin shortcut can be any of
those given in the table in the quick start guide.
/
