Zum Inhalt

Installation auf OpenShift

Voraussetzungen

  • Ein einsatzbereiter OpenShift-Cluster.
  • Über die Befehlszeile mit dem Cluster verbunden sein.
  • Eine Maschine mit installiertem oc und helm.

Benötigte Werkzeuge installieren

Auf der Maschine oder VM, die Sie zur Verwaltung des Clusters verwenden:

Erstkonfiguration

In den Charts, die Sie herunterladen, ist eine Datei README.md enthalten, die die Grundeinstellungen des Projekts beschreibt:

  • Erstellen Sie ein Projekt namens latence. Ein anderer Name ist möglich, dann müssen die YAML-Dateien jedoch entsprechend angepasst werden.
oc new-project latence
  • Erstellen Sie einen serviceaccount mit Berechtigung für privilegierte Container.
oc create serviceaccount -n latence privilegeduser
oc adm policy add-scc-to-user privileged -n latence -z privilegeduser
oc adm policy add-scc-to-user anyuid -z privilegeduser -n latence

Analyzer auf OpenShift installieren

Benötigte Dateien beziehen

  • Laden Sie die ZIP-Datei mit den Charts herunter:
wget https://api.latence.ca/software/openshift-analyzer-helm.zip
  • Entpacken Sie die Dateien:
unzip openshift-analyzer-helm.zip

Analyzer installieren

  • Wir müssen 2 Parameter in unserer Datei values.yaml ändern:
    1) Die LatenceTech-Lizenz.
    2) Die IP-Adresse, die der Kafka-Dienst verwenden wird.

  • Ermitteln Sie den IP-Bereich Ihres Clusters mit:

oc get svc
  • In diesem Beispiel verwenden wir die Cluster-IP 172.30.0.1.
  • Wir ändern die Datei values.yaml, indem wir die Kafka-IP-Adresse auf 172.30.0.23 setzen.

So sieht der geänderte Abschnitt mit der IP-Adresse nun aus:

kafka:
    enabled: true
    pvcSize: 2Gi
    svcPort: 12092
    ingressEnabled: true
    svcClusterIp: "172.30.0.23"
    zookeeperEndpoint: "zookeeper"
  • Sobald Lizenz und IP festgelegt sind, können wir den Analyzer mit diesem Befehl installieren:
helm install analyzer openshift-analyzer-helm/
  • Warten Sie 60–75 Sekunden, bis alle Dienste und Pods bereitgestellt sind.
  • Sie können den Status der Bereitstellung prüfen mit:
oc get all
  • Wenn Sie das Flag deployLoadBalancer in der Datei values.yaml auf true gesetzt haben, erhalten Sie die externe IP-Adresse mit:
oc get svc

Wenn Sie den Load Balancer in der Datei values.yaml aktiviert haben, erhalten Sie 2 externe Adressen:

  • eine für Grafana und Influxdb
  • eine für Kafka, die in der Konfiguration des qos-agent verwendet werden muss

API

Wenn die API nicht funktioniert, löschen Sie die ConfigMap und starten Sie neu

oc delete cm org-config

helm uninstall analyzer openshift-analyzer-helm/

helm install analyzer openshift-analyzer-helm/

Um Ihren API-Schlüssel zu erhalten, können Sie die Protokolle des Containers latencetech_api einsehen mit:

oc logs <pod ID>

Reflector auf OpenShift installieren

Benötigte Dateien beziehen

Laden Sie die ZIP-Datei mit den Charts herunter:

wget https://api.latence.ca/software/openshift-reflector-helm.zip
  • Entpacken Sie die Dateien:
unzip openshift-reflector-helm.zip

Reflector installieren

  • Wir müssen 1 Parameter in unserer Datei values.yaml ändern:
    1) Die LatenceTech-Lizenz.

  • Sie können LTI_reflector_id ändern, aber auch der Wert 1 funktioniert

  • Sobald alle Parameter festgelegt sind, können wir den Reflector mit diesem Befehl installieren:
helm install reflector openshift-reflector-helm/
  • Sie können den Status der Bereitstellung prüfen mit:
oc get all
  • Der reflector-load-balancer ist die externe IP, die Sie mit Ihrem QoS-Agent verwenden.

Agent auf OpenShift installieren

Benötigte Dateien beziehen

Laden Sie die ZIP-Datei mit den Charts herunter:

wget https://api.latence.ca/software/openshift-agent-helm.zip
  • Entpacken Sie die Dateien:
unzip openshift-agent-helm.zip

Agent installieren

  • Wir müssen 4 Pflichtparameter in unserer Datei values.yaml ändern:
    1) Die LatenceTech-Lizenz.
    2) Die ID des Agents (eine Ganzzahl).
    3) Die ID des Customer (eine Ganzzahl).
    4) Die IP-Adresse des Reflector (kann ein FQDN sein)
    5) Die IP-Adresse des Analyzer (muss in CIDR-Notation sein)
# Agent Environment Variables
agent:
    LTI_agent_id: "TO-BE-SET"
    LTI_customer_id: "TO-BE-SET"
    LTI_reflector: "TO-BE-SET"
    ANALYZER_IP: "TO-BE-SET"
  • Wir können auch den Metadatenabschnitt anpassen; diese Daten werden im Analyzer angezeigt und erleichtern die Überwachung Ihres Agents.
####### Metadata
    LTI_agent_name: "TO-BE-SET"
    LTI_agent_hardware: "TO-BE-SET"
    LTI_agent_net_type: "TO-BE-SET"
    LTI_agent_net_name: "TO-BE-SET"
    LTI_agent_address: "TO-BE-SET"
    LTI_agent_gps_pos: "TO-BE-SET"
    LTI_agent_details: "TO-BE-SET"
    LTI_agent_expected_application_latency: 30
    LTI_agent_expected_stability: 95
  • Die übrigen Parameter des qos-agent können Sie im darauffolgenden Abschnitt ändern.
  • Sobald alle Parameter festgelegt sind, können wir den Agent mit diesem Befehl installieren:
helm install agent openshift-agent-helm/
  • Sie können den Status der Bereitstellung prüfen mit:
oc get all