hmci/doc/readme-suse.md
Mark Nellemann e30d290f07
All checks were successful
continuous-integration/drone/push Build is passing
Update documentation.
2023-03-08 09:49:55 +01:00

2.2 KiB

Instruction for SLES / OpenSUSE Systems

Please note that the software versions referenced in this document might have changed and might not be available/working unless updated.

Ensure you have correct date/time and NTPd running to keep it accurate!

All commands should be run as root or through sudo.

Install the Java Runtime from repository

zypper install java-11-openjdk-headless wget

Download and Install InfluxDB

wget https://dl.influxdata.com/influxdb/releases/influxdb-1.8.10.x86_64.rpm
rpm -ivh influxdb-1.8.10.x86_64.rpm
systemctl daemon-reload
systemctl enable influxdb
systemctl start influxdb

If you are running Linux on Power, you can find ppc64le InfluxDB packages on the Power DevOps site. Remember to pick the 1.8 or 1.9 version.

Run the influx cli command and create the hmci database.

CREATE DATABASE "hmci" WITH DURATION 365d REPLICATION 1;

Download and Install Grafana

wget https://dl.grafana.com/oss/release/grafana-9.1.7-1.x86_64.rpm
rpm -ivh --nodeps grafana-9.1.7-1.x86_64.rpm
systemctl daemon-reload
systemctl enable grafana-server
systemctl start grafana-server

If you are running Linux on Power, you can find ppc64le Grafana packages on the Power DevOps site.

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

Download the latest version of HMCi packaged for rpm.

wget https://git.data.coop/api/packages/nellemann/generic/hmci/v1.4.2/hmci-1.4.2-1.noarch.rpm
rpm -ivh hmci-1.4.2-1_all.rpm
cp /opt/hmci/doc/hmci.toml /etc/
cp /opt/hmci/doc/hmci.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable hmci

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.