hmci/doc/readme-debian.md

60 lines
1.9 KiB
Markdown
Raw Normal View History

2022-09-08 06:45:39 +00:00
# Instruction for Debian / Ubuntu Systems
Please note that the software versions referenced in this document might have changed and might not be available/working unless updated.
2023-03-08 08:49:55 +00:00
Ensure you have **correct date/time** and NTPd running to keep it accurate!
2022-09-08 06:45:39 +00:00
All commands should be run as root or through sudo.
2022-09-08 06:45:39 +00:00
## Install the Java Runtime from repository
```shell
2023-03-08 08:49:55 +00:00
apt-get install default-jre-headless wget
2022-09-08 06:45:39 +00:00
```
## Download and Install InfluxDB
```shell
wget https://dl.influxdata.com/influxdb/releases/influxdb_1.8.10_amd64.deb
dpkg -i influxdb_1.8.10_amd64.deb
systemctl daemon-reload
systemctl enable influxdb
systemctl start influxdb
2022-09-08 06:45:39 +00:00
```
Run the ```influx``` cli command and create the *hmci* database.
2023-03-08 08:49:55 +00:00
```sql
CREATE DATABASE "hmci" WITH DURATION 365d REPLICATION 1;
```
2022-09-08 06:45:39 +00:00
## Download and Install Grafana
```shell
2023-03-08 08:49:55 +00:00
apt-get install -y adduser libfontconfig1
wget https://dl.grafana.com/oss/release/grafana_9.1.7_amd64.deb
dpkg -i grafana_9.1.7_amd64.deb
systemctl daemon-reload
systemctl enable grafana-server
systemctl start grafana-server
2022-09-08 06:45:39 +00:00
```
When logged in to Grafana (port 3000, admin/admin) create a datasource that points to the local InfluxDB. Now import the provided dashboards.
## Download and Install HMCi
2023-01-18 14:40:58 +00:00
[Download](https://git.data.coop/nellemann/-/packages/generic/hmci/) the latest version of HMCi packaged for deb.
2022-09-08 06:45:39 +00:00
```shell
2023-03-08 08:49:55 +00:00
wget https://git.data.coop/api/packages/nellemann/generic/hmci/v1.4.2/hmci_1.4.2-1_all.deb
dpkg -i hmci_1.4.2-1_all.deb
2022-09-08 06:45:39 +00:00
cp /opt/hmci/doc/hmci.toml /etc/
cp /opt/hmci/doc/hmci.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable hmci
2022-09-08 06:45:39 +00:00
```
2023-03-08 08:49:55 +00:00
Now modify **/etc/hmci.toml** (edit URL and credentials to your HMCs) and test the setup by running ```/opt/hmci/bin/hmci -d``` in the foreground/terminal and look for any errors. Press CTRL+C to stop and then start as a background service with ```systemctl start hmci```. You can see the log/output by running ```journalctl -f -u hmci```.