Index of /releases

	Name	Last modified	Size	Description
	Parent Directory		-
	archive/	2018-11-05 03:33	-
	lukSticks-v3.1/	2018-06-04 05:36	-
	lukSticks-v3/	2018-06-02 21:15	-
	root_dot_ssh_from_lukstick/	2018-03-31 19:38	-
	VERSION.txt	2018-11-05 04:27	17
	README.html	2018-11-05 04:27	13K
	latest.tgz	2018-11-05 04:27	1.1M
	lukMiner-0.14.0-cpu-ocl-phi.tgz	2018-11-05 04:27	1.1M
	lukMiner-0.14.0-cpu-phi.tgz	2018-11-05 04:27	1.1M
	latest-mpss-knl.tgz	2018-11-04 21:34	1.4M
	lukMiner-0.14.0-mpss-knl.tgz	2018-11-04 21:34	1.4M
	latest-mpss-knc.tgz	2018-06-03 20:41	1.5M

lukMiner - luk's Cryptonight(-family) Miner

This README's main purpose is to instruct on how to use and run the miner; for more information relating to the miner - supported platforms, supported coins, developer shares for the various configuration, performance for various hardware platforms, plans for the future, temperature on the back side of the moon, or anything else, please refer to either one of the three links below:

• http://www.lukminer.com : The "official" Wordpress blog I use for distributing lukMiner-related news and updates
• http://www.lukminer.net/releases : Latest releases for the miner
• http://sites.google.com/site/lukxmrminer : The "original" google site with some more general information on the miner.

Using LukMiner

Basic Usage is ./<binaryName> <args> , with binary name and arguments as follows:

Pick your binary

Depending on your architecture, pick:

• luk-cpu : for cpu-only mining

• luk-phi : for mining on 'bootable' x200 Xeon Phi nodes

• luk-knc-native : for running natively x100 Phi cards (7120, 31s1p, etc)

• luk-mpss-knc : for MPSS offload to x100 Phi Cards (7120, 31s1p, etc)

• luk-mpss-knl : For MPSS offload to x200 Phi Cards (7220 or 7240), on "regular" KNL card rigs with a regular CPU (Xeon, Core, Celeron, etc)

• luk-phi-mpss-knl : For MPSS offload to x200 Phi Cards (7220 or 7240), on special builds where even the host system uses a Xeon Phi CPU (upon special request)

Command line arguments

The miner understands the following arguments:

• --algo <alg> | -a <alg> : mining algorithm to use (see below)

• --host <hostname> : hostname for the pool to use

• --port <port>: port of the pool to use

• --user <username>: username to use on the specified pool

• --pass <password>: passwrod to use on the specified pool (usually 'x')

• --nicehash|-nh: enable nicehash-mode

• --no-fail-on-malloc: Do not fatally terminate upon failed huge-page memory allocation. By default the miner fatally teminates to "gently remind you" to turn on huge-page support for your system. If this is not possible, use this flag to silently ignore this error (though you will get lower hashrate).

• --donate <host> <port> <user> <percent>: Donate the given percentage of your hash rate to the given user name / wallet name, on the given host:port pool.

• -l|--log-file <logfile> : Specify a file name where logging outputs are to go.

• --simplified-logging : Enables a (additional) simplified logging method in which all logs look like a simple "LOG:field=value" that is easier to parse by automated monitoring tools.

• --status-port <port> : Opens a TCP port at which it serves the latest status logs

Mining Algorithm to Use

The miner currnetly understands the following algorithms (via "--algo "):

• xmr-v8 : monero v8 algorithm, as will be used by monero after the Oct 2018 hard-fork

• xmr-v7, xmr : monero v7 algorithm, as will be used by monero after the march 2018 hard-fork

• xn, xnclassic : classic 'cryptonight' algorithm, as used in ETN, and (pre-fork) Monero

• xnlight, aeon : 'cryptonight light' algorithm; as used in Aeon coin.

• xnlightv1, trtl : 'cryptonight light v1' algorithm; as used in TRTL coin

• xndark : 'cryptonight dark', as used in Bitnote coin (XBN)

• xnheavy : 'cryptonight heavy', as used in Loki, Saronite, etc

• xnalloy : 'cryptonight alloy', as used by alloy coin

• xnstellite : 'cryptonight stellite', as used by stellite coin

• xnmasari : 'cryptonight masari', as used by masari coin

• xnhaven : 'cryptonight haven', as used by haven coin

Examples

Example: Running the CPU miner for mining Monero on dwarfpool (after the Apr 6, 2018 'v7' fork)

./luk-cpu -a xmrv8 --host xmr-usa.dwarfpool.com --port 8080 --user 45Pw3bWFJXQiR1hN97huM6BbNPpnYdPytWnTUbkEm6KS9MExU7Gtr3nBsVoZA746qhCEwqVsFuPdwfXVtZwXxHQ6LDyfBaL --pass x

Example: Running the x200 Xeon Phi miner for mining loki on cryptoknight pool:

./luk-phi -a xnheavy --host loki.ingest.cryptoknight.cc --port 7733 --user LEc5AVn9BeME2zwrfEaKB3BHVEc8or1vMWNvk6QGDyQNefHTfuiBsFU3UfaECTD9c2gih94K9WqVQjbD9Juto1Pe225SAUn.100000

Example: Running with x200 KNL PCI cards (7220A, 7240P) using MPSS offload (for loki on loki.miner.rocks pool):

./luk-mpss-knl -a xnheavy --host loki.miner.rocks --port 5555 --user LEc5AVn9BeME2zwrfEaKB3BHVEc8or1vMWNvk6QGDyQNefHTfuiBsFU3UfaECTD9c2gih94K9WqVQjbD9Juto1Pe225SAUn.100000 --pass w=myWorkerName

Example: Running cpu miner for turtle (TRTL) coin:

 ./luk-cpu -a trtl --host trtl.pool.mine2gether.com --port 6665 --user TRTLv1uvD2YdjbXjCtfkgLZLMbWVvJFD39hSJC3PPHHdJadVuni1myWVFx6KzZ8YRmAAQh6Uq8amyVzm533KzHBA8quAddENG1D --pass x

Example: Running cpu miner for alloy coin:

 ./luk-cpu -a xnalloy --host alloy.ingest.cryptoknight.cc --port 5662 --user A6MKy9TZabKU1LFuA7J97QXVrLMnWRMmhaM6GANzpU98i5wr31zNMEN39szAUvgPfoLw1Jvm3KnAnNzpWMBZfMYZBRPGdGr --pass x

Example: Running old, x100 Xeon Phi PCI cards using MPSS offload; mining aeon on aeon-pool

./luk-mpss-knc -a aeon --host mine.aeon-pool.com --port 8080 --user Wmt5hTKURa1bzAaUroB9JQByeiK7nPooLf4KcMXBCjMfdbeoTHVWzXePHMiyGFTNVhgtzXrxn9vZTfCqKFD57oea2UV2de3Qy --pass x

Example: Running with x200 KNL PCI cards (7220A, 7240P) using MPSS offload (for haven):

./luk-mpss-knl -a xnhaven --host haven.miner.rocks --port 4005 --user hvxxwLQB2wC1dmdSzw1fyTiMUhPa438YxgrZZPsv1Tkj5tgMLpN58SDikUGfBmkJ7RXXTRAzmYALa9vMe5P55L1m3aGHQpLWcM.100000 --pass w=myWorkerName

Example: Running with x200 KNL PCI cards (7220A, 7240P) using MPSS offload (for stellite):

./luk-mpss-knl -a xnstellite --host stellite.ingest.cryptoknight.cc --port 16222 --user Se48FcbD5uWF2AVsMgDuj918yTtRDPC5H218ZsXBP6jtCpmGdDa8D97Q6f9jWWUkeK2snno9rr8CoVjU1KKh7vxP13C6xLVGx.150000 --pass 'w=myRig'

Example: Bittube/IPBC

     ./luk-cpu -a ipbc --host tube.ingest.cryptoknight.cc --user bxcH7ypUkmt12peei8zF9ocUT92AJhxgiPi4MRotgmRaaUDa3V1uhj9ac9SQCzAVUnPeJ66HxJ9zs97ZF2MXENWj1P54GdaYh --port 5631 --pass 'w=myRig'

Additional Information on Different Binaries

LukMiner comes with multiple different pre-compiled binaries; typially because either a given platofrm requires a binary that isn't compatible with other platforms (say, -knc-native for knights corner devices won't run on a regular CPU; or x200 Phi binaries won't run on x100 Phi cards, etc); or because a binary requires additional dependencies that not everybody might have (e.g., the -mpss binaries requires you to have a working install of the intel MPSS stack, which many machines do not have).

As such, you first have to choose the right binary from the following list:

Binaries you run directly on the CPU

• luk-cpu : For regular CPUs: Intel Core, Intel Xeon, Intel Celeron, AMD Opteron, AMD FX, etcpp. Pretty much everything that has an x86 compatible instruction set. This binary is intentionally without any form of GPU mining, thus running even on older systems without (or with broken) GPU drivers.

• luk-phi : For bootable x200 "Knights Landing" (or "Knights Mill") Xeon Phis (ie, typically the Asrock or Exxact machines that the blog talked about.

• luk-knc-native : For the older, x100 "Knights Corner" Xeon Phis that you intend to run in "native mode"; i.e., where you manually copy the binary to the device, and run it there (most commonly this is only for advanced KNC users - if you're not a "Ninja" KNC user, use the luk-mpss-knc version).

Binaries to drive PCI cards (Xeon Phis or GPUs)

• luk-mpss-knc : For MPSS offloading to the older, x100 "Knights Corner" Xeon Phis (7120, 31s1p, 5110, etc).

• luk-mpss-knl : For MPSS offloading to the newer, x200 "Knights Landing" cards (7220 and 7240).

All all these three "offload" binaries also contain the plain cpu driver, so unless you turn CPU mining off explicitly it will automatically run on all GPUs/Phis and on the CPU.

Release Notes

• v0.14

• axed deprecated opencl and cuda codes, as well as binaries for that

• significant rewrite of v8 miner. First speedups (15-20%) for v8 on KNLs

• v0.13

• first attempt to rewrite v8 - abandoned.

• v0.12.0

• Now supporting Monero v8 fork: -a xmrv8

• v0.11.4

• Now supporting 'masari' coin: -a masari

• v0.11.3

• Now supporting 'stellite' coin: -a stellite

• v0.11.2

• Now supporting 'haven' coin: -a haven

• v0.11.0

• -a xmr now points to xmr-v7 algorithm

• new binary luk-phi-mpss-knl for rigs with knl cards in socketed phi mainboards

• xnheavy devshare now goes to loki, on cryptoknight pool (with fixed difficulty)

• pulled support for xndark algorithm; seems to me this project died.

• can now specify log-file location (-l )

• can now specify simplified status logging, as well as a status port.

• watchdog off by default

• preliminary support for alloy (-a xnalloy)

• v0.10.8

• some more performance for cryptonight heavy (loki / sumo)

• v0.10.7

• full support for "CryptoNight Light v1" as used in Turtle

• v0.10.4

• several optimizations to sumo

• v0.10.2

• support for "CryptoNight Heavy" as used in Sumo v1

• v0.10.1

• Various bugfixes, in particular re outputs

• First support for "-a xmr-v7" for monero v7 fork (fixed in all of cpu, knc, knl, and ocl)

• v0.10.0

• Lots of various bugfixes

• Added support for x200 MPSS offloading; can now do both mpss offload and native mining for both x100 and x200

• Added cryptonight dark (bitnote) algorithm

• Reduced number of binaries via unifying miners: Rather than having different miners for different algorithm we now use a single binary and specify mining algorithm via "-a ". Also all miners now support all mining algorithms.

• Better documentation via auto-generated README.html; will now automatically get distributed to public releases/

• Generating different releases based on dependencies: regular (cpu, opencl, phi), x100 KNC witht MPSS 3.8, and x200 phi MPSS offload (MPSS 4.4)

• releases now hosted on files.lukminer.net/releases

• now have auto-booting lukSticks for cpu, phi, phi-mpss, and knc-mpss