diff --git a/README.md b/README.md index b9edfb7..9b1554b 100644 --- a/README.md +++ b/README.md @@ -17,4 +17,71 @@ Here is an example of thos the graphs look like: ![alt text](https://github.com/Kris-Sekula/Hyperflex-API/blob/master/cl2018-stats-example.png "Graphana Dashboard") +## How to deploy. + +1. Install ubuntu server 16.04 64bit (I used: ubuntu-16.04.5-server-amd64.iso) + * Basic installation, only select OpenSSH from the package list, create a user. +2. Install Prometheus + + * create required user: + sudo useradd -M -s /bin/fals prometheus + + * create required folders: + sudo mkdir /etc/prometheus + sudo mkdir /var/lib/prometheus + + sudo chown prometheus:prometheus /etc/prometheus + sudo chown prometheus:prometheus /var/lib/prometheus + + * download and extract: + + curl -LO https://github.com/prometheus/prometheus/releases/download/v2.6.1/prometheus-2.6.1.linux-amd64.tar.gz + tar xvf prometheus-2.6.1.linux-amd64.tar.gz + + * copy files and change premissions: + sudo cp prometheus-2.6.1.linux-amd64/prometheus /usr/local/bin/ + sudo cp prometheus-2.6.1.linux-amd64/promtool /usr/local/bin/ + + sudo chown prometheus:prometheus /usr/local/bin/prometheus + sudo chown prometheus:prometheus /usr/local/bin/promtool + + sudo cp -r prometheus-2.6.1.linux-amd64/consoles /etc/prometheus + sudo cp -r prometheus-2.6.1.linux-amd64/console_libraries /etc/prometheus + + sudo chown -R prometheus:prometheus /etc/prometheus/consoles + sudo chown -R prometheus:prometheus /etc/prometheus/console_libraries + + * configure prometheus: + sudo vim /etc/prometheus/prometheus.yml + + tab is two spaces, no other char allowed, watch for formatting + + + * try to start prometheus: + sudo -u prometheus /usr/local/bin/prometheus --config.file /etc/prometheus/prometheus.yml --storage.tsdb.path /var/lib/prometheus --web.console.templates=/etc/prometheus/consoles --web.console.libraries=/etc/prometheus/console_libraries + + * verfiy if it works: + http://10.100.253.32:9090/status + + * if all good stop it: + CTRL+C + + * create prometheus service: + sudo vim /etc/systemd/system/prometheus.service + + + * reload services: + sudo systemctl daemon-reload + + * start Prometheus using the following command: + sudo systemctl start prometheus + + * check if Prometheus is running, check the service.s status. + sudo systemctl status prometheus + + * enable service: + sudo systemctl enable prometheus + + + Keywords: Cisco Hyperflex, API, python.