7x31
/
py-kms
mirror of https://github.com/SystemRage/py-kms.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Reformatting...

This commit is contained in:
Simon Beginn 2020-07-31 17:38:30 +02:00
parent d47f207d17
commit 28bf445127
1 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/Usage.md
View File

@ -2,9 +2,10 @@
## _How to run pykms_Server.py manually_. ## _How to run pykms_Server.py manually_.
*** ***
A Linux user with ```ifconfig``` command can get his KMS IP (Windows users can try ```ipconfig /all```).
``` A Linux user with `ifconfig` command can get his KMS IP (Windows users can try `ipconfig /all`).
user@user ~ $ ifconfig ```bash
user@host ~ $ ifconfig
eth0 Link encap: Ethernet HWaddr xx:xx:xx:xx..... eth0 Link encap: Ethernet HWaddr xx:xx:xx:xx.....
inet addr: 192.168.1.102 Bcast 192.168.1.255 Mask: 255.255.255.0 inet addr: 192.168.1.102 Bcast 192.168.1.255 Mask: 255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
@ -21,18 +22,19 @@ lo Link encap: Local Loopback
``` ```
In the example above is 192.168.1.102, so is valid: In the example above is 192.168.1.102, so is valid:
```user@user ~/path/to/folder/py-kms $ python3 pykms_Server.py 192.168.1.102 1688``` ```
user@host ~/path/to/folder/py-kms $ python3 pykms_Server.py 192.168.1.102 1688
```
To stop _pykms_Server.py_, in the same bash window where code running, simply press CTRL+C. To stop `pykms_Server.py`, in the same bash window where code running, simply press CTRL+C.
Alternatively, in a new bash window, use ```kill <pid>``` command (you can type ```ps aux``` first and have the process <pid>) or ```killall <name_of_server>```. Alternatively, in a new bash window, use `kill <pid>` command (you can type `ps aux` first and have the process <pid>) or `killall <name_of_server>`.
## _How to run pykms_Server.py automatically at start_. ## _How to run pykms_Server.py automatically at start_.
*** ***
You can simply manage a daemon that runs as a background process. You can simply manage a daemon that runs as a background process.
If you are running a Linux distro using ```upstart``` (deprecated), If you are running a Linux distro using `upstart` (deprecated), create the file: `sudo nano /etc/init/py3-kms.conf`, then add the following (change it where needed) and save:
create the file: ```sudo nano /etc/init/py3-kms.conf```,
then add the following (changing where needed) and save:
``` ```
description "py3-kms" description "py3-kms"
author "SystemRage" author "SystemRage"
@ -44,10 +46,8 @@ stop on runlevel [016]
exec $PYTHONPATH/python3 $PYKMSPATH/pykms_Server.py 0.0.0.0 1688 -V DEBUG -F $LOGPATH exec $PYTHONPATH/python3 $PYKMSPATH/pykms_Server.py 0.0.0.0 1688 -V DEBUG -F $LOGPATH
respawn respawn
``` ```
Check syntax with: ```sudo init-checkconf -d /etc/init/py3-kms.conf```, then Check syntax with: `sudo init-checkconf -d /etc/init/py3-kms.conf`, then reload upstart to recognise this process: `sudo initctl reload-configuration`.
reload upstart to recognise this process: ```sudo initctl reload-configuration```. Now start the service: `sudo start py3-kms`, and you can see the logfile stating that your daemon is running: `cat </path/to/your/log/files/folder>/pykms_logserver.log`.
Now start the service: ```sudo start py3-kms```, and
you can see the logfile stating that your daemon is running: ```cat </path/to/your/log/files/folder>/pykms_logserver.log```.
If you are running a Linux distro using ```systemd```, If you are running a Linux distro using ```systemd```,
create the file: ```sudo nano /etc/systemd/system/py3-kms.service```, create the file: ```sudo nano /etc/systemd/system/py3-kms.service```,