Zum Hauptinhalt springen

One-Line-Installation (empfohlen)

Wenn der Server über eine Internetverbindung verfügt, startet die Installation mit einem einzigen Befehl. Das Installationsskript wird vom Verteilungsserver product.kopens.io bezogen.

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh | sudo bash

Im Air-Gap-Netzwerk ist dieser Weg nicht nutzbar → Air-Gap-Installation.

Vor dem Start​

Zu prüfenInhalt
BerechtigungMuss als root ausgeführt werden (sudo bash)
NetzwerkHTTPS-Zugriff auf product.kopens.io · docker.kopens.io erforderlich
HardwareAnforderungen inkl. GPU → Systemanforderungen

Was bezogen wird — das Repository-Set​

Die Compose-Konfiguration des AI-Stacks startet nur, wenn alle drei Repositories nebeneinander vorhanden sind.

/opt/kopens/
├── plantpulse-ai-docker/                  ← 설치 본체
├── plantpulse-ai-inference-server/
└── plantpulse-timeseries-insight-server/

Die One-Line-Installation lädt ein Bundle (plantpulse-ai-bundle.tar.gz), das alle drei enthält, und entpackt sie auf einmal. Sie müssen nichts separat vorbereiten. Das Skript prüft nach dem Entpacken, ob alle drei vorhanden sind, und gibt bei fehlenden Einträgen deren Namen aus, bevor es auf einen anderen Pfad wechselt — das verhindert, dass nur eine halbe Installation hochfährt.

Direkter Bezug der Repositories über interne Quellen

Mit GIT_USER · GIT_TOKEN erfolgt der Bezug statt über das Bundle direkt über dev.kopens.io via git clone. Da Kunden kein eigenes GitLab-Konto bei uns haben, gilt standardmäßig das Bundle.

Installation mit vorgegebenen Werten​

Umgebungsvariablen müssen vor bash stehen. Steht man sie vor curl, werden sie nicht über die Pipe weitergereicht.

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh \
  | sudo START=1 PP_DATALAKE_ADMIN_URL=https://192.168.0.41:4950 PP_DATALAKE_ADMIN_API_KEY=<플랫폼의 키> bash

Um fehlende Werte einzeln abzufragen, führen Sie die Installation interaktiv aus.

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh | sudo INTERACTIVE=1 bash
UmgebungsvariableStandardwertZweck
INTERACTIVE0Bei 1 werden fehlende Werte per Prompt abgefragt
START—Bei 1 wird direkt nach der Installation gestartet
DEST/opt/kopens/plantpulse-ai-dockerInstallationsort
BRANCHmasterZu beziehender Branch
REPO_HOST(interner Git-Host)Alternativer Pfad, nur wenn die Verteilung nicht bezogen werden konnte. Der Wert ist im Installationsskript enthalten
REPO_PATHplantpulse-ai/plantpulse-ai-docker.gitRepository-Pfad
GIT_USER · GIT_TOKEN—Authentifizierung für private Repositories

Werte, die unverändert an das Installationsskript (install.sh) weitergereicht werden, stehen an derselben Stelle. Hier sind nur die gängigsten aufgeführt — vollständige Liste sowie die Aufgabe jedes Schritts finden Sie unter Installationsübersicht.

UmgebungsvariableStandardwertZweck
PP_DATALAKE_ADMIN_URL · PP_DATALAKE_ADMIN_API_KEY—Adresse (https://<플랫폼 호스트>:4950) und Schlüssel zum Abruf der Platform-Zugangsdaten. Bei Angabe erfolgt keine Abfrage
PP_PROXY_CERT_SANAdresse dieses HostsZugriffsadresse(n)/Namen für das TLS-Zertifikat (mehrere durch Komma getrennt). Bei Zugriff über öffentliche IP · VIP · Domain unbedingt angeben. Bereits in der env-Datei vorhandene Werte bleiben bei erneuter Installation erhalten
ENV_TEMPLATEenv.gb10.exampleBei AWS g7e (amd64): env.g7e.example. Bei Abweichung zwischen Maschine und Architektur bricht die Installation ab
HOST_TUNINGapply (bei laufenden anderen Containern plan)Umgang mit hostweiten globalen Einstellungen: skip · plan · apply
ALLOW_DOCKER_RECONFIGURE—Bei 1 sind Änderungen und Neustarts der bestehenden Docker-Konfiguration erlaubt
SKIP_GPU—Bei 1 wird die Installation von NVIDIA-Treiber und Toolkit übersprungen
SKIP_WAIT · WAIT_READY_MIN— · 15Überspringt die Wartezeit auf eine Antwort nach START=1 oder ändert deren Obergrenze (in Minuten)
Im interaktiven Modus abgefragte Werte

Bei INTERACTIVE=1 wird zuerst die TLS-Zertifikat-SAN abgefragt, danach die Adresse und der Schlüssel zum Abruf der Platform-Zugangsdaten (PP_DATALAKE_ADMIN_URL · PP_DATALAKE_ADMIN_API_KEY). Darüber hinaus werden die übrigen Platzhalter (Platform-API-Token, Admin-Passwort, Neo4j-Passwort usw.) einzeln nachgefragt. Platform-Host sowie Platform-PG-, Aster-TSDB- und Redis-Konto/-Passwort werden ab 2026.10 nicht mehr abgefragt — der Host wird aus der obigen Adresse errechnet, Konto und Passwort werden beim Start von der Platform bezogen. Interne Geheimnisse (Gateway-Schlüssel, Salt, Inbound-Key, Session-Secret, Verschlüsselungsschlüssel für gespeicherte Zugangsdaten usw.) werden nicht abgefragt, sondern vom Installer erzeugt.

Abgefragte Werte können statt interaktiv auch über gleichnamige Umgebungsvariablen übergeben werden (… | sudo PP_API_TOKEN=<token> PI_ADMIN_PASSWORD=<password> bash). Der Installer füllt nur noch als Platzhalter vorhandene Schlüssel mit diesen Werten auf und überschreibt bereits gesetzte Werte nicht.

Der Trust-Anchor wird nicht vom Installer gesetzt (2026.10)

Der Platform-Trust-Anchor /etc/kopens/ca/root.crt (inhaltsgleich auch als CA.crt) wird nicht vom Installer erzeugt. Bei START=1 ruft der Installer vor dem Bezug der Images einmal probeweise die Zugangsdaten von der Platform ab; fehlt der Anchor oder ist der Schlüssel falsch, startet nichts und die Installation bricht ab. Setzen Sie den Anchor zuerst und führen Sie dann START=1 aus, oder führen Sie nur die Vorbereitung ohne START aus, setzen Sie danach den Anchor und starten Sie anschließend → Installationsübersicht

Nach Abschluss der Installation​

  1. Ändern des Initialpassworts — Legt das Konto für die Admin-Konsole fest. Bleibt PI_ADMIN_PASSWORD als Platzhalter stehen, wird der Start von START=1 verweigert; ist es leer, startet die Konsole gar nicht erst.
  2. Rufen Sie die AI-Admin-Konsole auf und prüfen Sie auf der Startseite den Gesamtstatus.
  3. Räumen Sie mit der Service-Port-Übersicht die Firewall-Regeln auf.
  4. Um Video-/Audio-Erfassung sowie Spracheingabe im Chat zu nutzen, fügen Sie in der Host-env die Zeile PI_MEDIA_ENABLED=true hinzu und laden Sie das Transkriptionsmodell — standardmäßig ist dies deaktiviert → Video-/Audio-Erfassung

Verwandte Dokumente​