From a9241c6e475fce9f92f269f275a82ede7267bff4 Mon Sep 17 00:00:00 2001
From: ValueOn AG <p.motsch@poweron.swiss>
Date: Thu, 28 May 2026 12:58:53 +0200
Subject: [PATCH] upd

---
 b-reference/platform/infrastructure.md | 42 ++++++++++++++++++++++++++
 c-work/_CHANGELOG.md                   |  2 +-
 2 files changed, 43 insertions(+), 1 deletion(-)

diff --git a/b-reference/platform/infrastructure.md b/b-reference/platform/infrastructure.md
index f319487..1eb5693 100644
--- a/b-reference/platform/infrastructure.md
+++ b/b-reference/platform/infrastructure.md
@@ -99,6 +99,48 @@ Deploy-Workflow: `.forgejo/workflows/deploy.yml` in `service-teams-browser-bot`
 3. `docker compose build && docker compose up -d`
 4. Health-Check auf Port 4100
 
+## DB-Setup bei neuer Installation
+
+Bei einer neuen DB-Instanz (`porta-*-db`) muessen folgende Schritte ausgefuehrt werden:
+
+### 1. pgvector Extension installieren (OS-Package)
+
+SSH auf die DB-VM (via API-Server als Jump-Host, da DB-VMs kein externes SSH haben):
+
+```bash
+# Vom API-Server aus:
+ssh -i /tmp/ida-laptop.pem ubuntu@<DB_INTERNAL_IP> bash << 'EOF'
+echo 'deb http://apt.postgresql.org/pub/repos/apt jammy-pgdg main' | sudo tee /etc/apt/sources.list.d/pgdg.list
+wget -qO- https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/trusted.gpg.d/pgdg.asc > /dev/null
+sudo apt update -qq
+sudo apt install -y postgresql-14-pgvector
+sudo systemctl restart postgresql
+EOF
+```
+
+### 2. Extension in Datenbanken aktivieren
+
+```bash
+ssh -i /tmp/ida-laptop.pem ubuntu@<DB_INTERNAL_IP> bash << 'EOF'
+sudo -u postgres psql -d poweron_knowledge -c 'CREATE EXTENSION IF NOT EXISTS vector;'
+sudo -u postgres psql -d poweron_commcoach -c 'CREATE EXTENSION IF NOT EXISTS vector;'
+EOF
+```
+
+### 3. Verifizierung
+
+```bash
+ssh -i /tmp/ida-laptop.pem ubuntu@<DB_INTERNAL_IP> \
+  "sudo -u postgres psql -d poweron_knowledge -c '\dx vector'"
+```
+
+Erwartete Ausgabe: `vector | 0.8.x | public | vector data type and ivfflat and hnsw access methods`
+
+**Wichtig:**
+- Der DB-User `poweron_dev` hat keine SUPERUSER-Rechte -- Extension muss als `postgres` User erstellt werden
+- DB-VMs sind nicht direkt per SSH von aussen erreichbar; Zugang via API-Server (`porta-*-platform-core`) im internen Netzwerk
+- Ohne pgvector funktioniert keine RAG-Indexierung (semanticSearch) und kein Content-Index (browseContainer, summarizeContent, searchInFileContent)
+
 ## Zugriff
 
 | Ressource | URL / Pfad |
diff --git a/c-work/_CHANGELOG.md b/c-work/_CHANGELOG.md
index 8be39d3..4e4d001 100644
--- a/c-work/_CHANGELOG.md
+++ b/c-work/_CHANGELOG.md
@@ -14,7 +14,7 @@ Skip: reine Refactors, Formatting, Lint, Dep-Bumps, Test-only, Wiki-Tippfehler.
 
 ## 2026-05-28
 
-- 2026-05-28 | fix | private-llm+infra | **LLM-Server Recovery**: Ollama-Modelle (`qwen2.5:7b`, `qwen2.5vl:7b`, `granite3.2-vision`) auf Infomaniak GPU-Server neu installiert (waren nach Instanz-Neustart verloren). NVIDIA-Treiber-Mismatch per Reboot behoben. Doku aktualisiert: `setupserver.md` (Port 5000→8000, Flask→FastAPI/Uvicorn, korrekte Modell-Liste), `README.md`, `infrastructure.md` (DNS `llm.poweron.swiss`).
+- 2026-05-28 | fix | private-llm+infra | **LLM-Server Recovery**: Ollama-Modelle (`qwen2.5:7b`, `qwen2.5vl:7b`, `granite3.2-vision`) auf Infomaniak GPU-Server neu installiert (waren nach Instanz-Neustart verloren). NVIDIA-Treiber-Mismatch per Reboot behoben. pgvector Extension auf prod+int DB-Servern installiert (OS-Package + CREATE EXTENSION). Doku aktualisiert: `setupserver.md`, `README.md`, `infrastructure.md` (DB-Setup-Anleitung fuer neue Installationen).
 
 ## 2026-05-27