git.iko.soy/xmrig-bash-scripts
on master help sign in
Update README.md
commitcef04fdc618fed7288accac876bb85a1a7c7196f authorSean Wheller <sean@prepaidmeters.com> dateFri 9 Aug 2019, 15:31 (7 years ago) parentcfb582c
1 file changed+19−10
README.md+19−10
README.md+19−10
@@ -19,11 +19,11 @@ At the start the expectation is that you have:
1919
2020Some knowledge of:
2121* Linux Command Line Interface
22−* Unix shell `bash`
22+* Linux shell `bash`
2323
2424There is more to install but the install script will install the rest.
2525
26−### Installion
26+### Installation
2727
28281. Change to your user home directory.
2929 `cd ~`
@@ -43,34 +43,40 @@ There is more to install but the install script will install the rest.
43436. Run the install script
4444 `./install.sh`
4545
46−7. Attach to the screen session created during the installation.
46+7. After install is complete. Attach to the screen session created during the installation.
4747 `screen -r`
4848
4949### Operation
5050
51−With the exception of the 'xmrig' binary, which is installed to `/usr/bin/xmrig`, all files remain in the cloned project directory `~/xmrig-bash-scripts`. Any files generated while running the scripts are created in this directory.
51+Defaults - The settings.sh contains a number of variables. With the exception of the 'xmrig' binary, which is installed to `/usr/bin/xmrig`, all files remain in the cloned project directory `~/xmrig-bash-scripts`. Any files generated while running the scripts are also created in this directory.
5252
53−During install the folder source for [xmrig cpu](https://github.com/xmrig/xmrig) is cloned to `xmrig-cpu/`in the path. The `config.json` is also created in this path.
53+During install the folder source for [xmrig cpu](https://github.com/xmrig/xmrig) is cloned to `~/xmrig-bash-scripts/xmrig-cpu/`. The `config.json` is also created in this path.
5454
55−This should work out the box, if you edit only the top section of `settings.sh`.
55+This should work out the box, if you edit only the top section of `settings.sh` and followed the steps here.
5656
5757Once you have a running xmrig then you can start playing around and tweaking to suite requirements.
5858
59−What follows is a brief of the shell scripts you will find. The names are mostly self explanatory. Comments and notes are used liberally in the scripts to help give you hints as to how it works. The scripts are designed to be modular to promote resuse, execute exclusion and standalone execution.
59+What follows is a brief of the shell scripts you will find. The names are mostly self explanatory.
60+Comments and notes are used liberally in the scripts to help give you hints as to how it works.
61+The scripts are designed to be modular to promote resuse, execute exclusion and standalone execution.
6062
6163* build.sh - clones xmrig to ``~/xmrig-bash-scripts`/xmrig-cpu`, configures, builds and copies xmrig to `/usr/bin/`
6264* config.sh - contains variables that aid in defining the values for the attributes found in config.json.
6365* crontab.sh - installs a cron to start and a cron to stop at specific times (Can be commented out of install if desired).
66+* crontab-off - removed the users crontab created during install.
67+* crontab-on.sh - redefines the users crontab as created during install.
6468* depends.sh - installs dependancies required by xmrig and these scripts.
6569* functions.sh - a collection of functions used in various of the scripts.
6670* install.sh - the main entry point when first installing.
67−* maintenance.sh - performs apt update and upgrade.
71+* maintenance.sh - performs apt update, upgrade, autoremove and autoclean operations.
6872* settings.sh - contains variables used by these scripts.
6973* start.sh - starts xmrig in a screen session.
7074* stop.sh - stops xmrig screen session.
7175
7276### Viewing the log
73−Default of the start script is to create a screen session named 'xmrig-cpu'. This can be changed in the settings script if required. To view the log after installation is finished or after running the start script, used the following command:
77+Default of the start script is to create a screen session named 'xmrig-cpu'.
78+This can be changed in the settings script if required.
79+To view the log after installation is finished or after running the start script, used the following command:
7480`screen -r xmrig-cpu`
7581
7682### Updating
@@ -79,11 +85,14 @@ A simple `git update` in `~/xmrig-bash-scripts` will update these scripts.
7985The install script can be run at any time to update the xmrig source found `~/xmrig-bash-scripts/xmrig-cpu`.
8086The branch checkout is taken from the `_XMRIG_BRANCH` variable in `settings.sh`.
8187
88+A script named update.sh is provided to perform both these steps in a single command.
89+
8290## Reporting issues
8391
8492[xmrig cpu](https://github.com/xmrig/xmrig) and [xmrig bash scripts](https://github.com/seanwhe/xmrig-bash-scripts.git) are different projects run by different people.
8593
86−While the developers of both projects may be seen interacting with one another on either project, we ask that you report issues to the respective projects. In other words, post issues for:
94+While the developers of both projects may be seen interacting with one another on either project, we ask that you report issues to the respective projects.
95+In other words, post issues for:
8796* xmrig, the Monero (XMR) CPU miner, over at [xmrig issues tracker](https://github.com/xmrig/xmrig/issues)
8897* xmrig-bash-scripts, these conveniece scripts, over at [xmrig-bash-scripts](https://github.com/seanwhe/xmrig-bash-scripts/issues)
8998