From fe60c6c8763d49ed8b9b75f186e6131e4b725195 Mon Sep 17 00:00:00 2001 From: echoDaveD Date: Wed, 12 Feb 2025 21:24:15 +0100 Subject: [PATCH] update reqierments and rreadme for venv --- README.md | 59 ++++++++++++++++++++++++++++++++++++++++++++++++ requirements.txt | 7 +++--- 2 files changed, 63 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 2720323..0cd48dd 100644 --- a/README.md +++ b/README.md @@ -60,6 +60,65 @@ EHS-Sentinel subscribes /status Topic and if it receive a `journalctl | grep ehsSentinel` +## Venv Installation (recommendet) + +In general, it is recommended to work with a virtual environment (venvs) in python to be independent of other projects. +Some Distributions like debian 12 dont allow to use system wide pip package installation, so you have to use venv. + +1. Just clone the repository + `git clone https://github.com/echoDaveD/EHS-Sentinel` + +2. Install python venv + `apt install python3.11-venv` <- modify your python verison here + +3. Create Python venv + `python3 -m venv EHS-Sentinel` + +4. change diractory + `cd EHS-Sentinel` + +5. activate venv + `source bin/activate` + +6. Install the requierments + `pip install -r requirements.txt` + +7. Copy the `data/config.yml` and provide your Configuration + +8. get path of venv python executable + `which python3` <- copy the output + +9. Change to ehs-sentinel.service file as followed: + + `ExecStart = ` <- provide here to path to your folder where startEHSSentinel.py is + + sample: `ExecStart = /root/EHS-Sentinel/bin/python3 /root/EHS-Sentinel/startEHSSentinel.py --configfile /root/EHS-Sentinel/config.yml` + +10. Change your `config.yml` to absolut paths: + `nasaRepositoryFile: /root/EHS-Sentinel/data/NasaRepository.yml` + +11. Deactivate venv + `dactivate` + +12. Copy the service File to your systemd folder: + `cp ehs-sentinel.service /etc/systemd/system` + +13. Enable the new service + `systemctl enable ehs-sentinel` + +14. Reload deamon + `systemctl daemon-reload` + +15. Start the Service + `systemctl start ehs-sentinel` + +16. check if anything is fine + `systemctl status ehs-sentinel` + +17. If your want to check the journal logs + `journalctl | grep ehsSentinel` + + # Configuration diff --git a/requirements.txt b/requirements.txt index 74a9d47..5dbe9dd 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,6 +1,7 @@ aiofiles>=24.1.0 +future>=1.0.0 +gmqtt>=0.7.0 +iso8601>=2.1.0 pyserial>=3.5 pyserial-asyncio>=0.6 -PyYAML>=6.0.2 -serial>=0.0.97 -gmqtt>=0.7.0 \ No newline at end of file +PyYAML>=6.0.2 \ No newline at end of file