Skip to content

Erste Schritte

Willkommen beim TCM365 Setup-Guide. Dieser Abschnitt führt Sie durch alles, was Sie benötigen, um TCM365 einzurichten und Ihren ersten Configuration Snapshot zu erstellen.

Voraussetzungen

Bevor Sie TCM365 installieren, stellen Sie sicher, dass Ihre Umgebung die folgenden Anforderungen erfüllt.

Erforderliche Software

Software Version Zweck
Node.js 18.0 oder neuer Backend- und Frontend-Laufzeitumgebung
npm 9.0 oder neuer Paketverwaltung (wird mit Node.js ausgeliefert)
PostgreSQL 15.0 oder neuer Primäre Datenbank
Git 2.30 oder neuer Quellcode-Verwaltung

Optionale Software

Software Version Zweck
Redis 7.0 oder neuer Caching, Rate Limiting, Distributed Locks
Docker 24.0 oder neuer Containerisierte Bereitstellung
Docker Compose 2.20 oder neuer Multi-Container-Orchestrierung

Redis ist optional

TCM365 fällt automatisch auf In-Memory-Alternativen zurück, wenn Redis nicht verfügbar ist. Redis wird für Produktionsumgebungen empfohlen, ist aber für Entwicklung und Evaluierung nicht erforderlich.

Systemressourcen

Ressource Minimum Empfohlen
CPU 2 Kerne 4 Kerne
RAM 4 GB 8 GB
Festplatte 10 GB 50 GB (abhängig vom Snapshot-Volumen)

Azure AD Anforderungen (für Microsoft 365 Integration)

Um TCM365 mit Microsoft 365 Tenants zu verbinden, benötigen Sie:

  • Eine Azure AD App Registration mit den entsprechenden Microsoft Graph API-Berechtigungen
  • Den UTCM Service Principal (03b07b79-c5bc-4b5e-9bfa-13acf4a99998) im Ziel-Tenant (erforderlich für Teams- und Exchange-Capture)
  • Client Credentials (Client ID, Client Secret, Tenant ID)

Lokale Entwicklung ohne Azure

Sie können TCM365 lokal ohne Azure AD-Credentials betreiben, indem Sie STORAGE_BACKEND=local setzen. Die Plattform funktioniert vollständig für Zscaler-Integrationen und lokale Tests, aber Microsoft 365 API-Features sind nicht verfügbar.

Zscaler Anforderungen (für ZIA/ZPA Integration)

Um TCM365 mit Zscaler zu verbinden:

  • ZIA: Cloud-Name, API Key, Admin-Benutzername und Admin-Passwort
  • ZPA: Customer ID, Client ID, Client Secret und Cloud Endpoint

Setup-Optionen

TCM365 bietet drei Möglichkeiten für den Einstieg, jeweils für unterschiedliche Anwendungsfaelle:

  • Option 1: Automatisches Setup (Empfohlen)

    Der schnellste Weg zum Start. Automatisierte Skripte uebernehmen Umgebungskonfiguration, Abhaengigkeitsinstallation, Datenbankinitialisierung und Admin-User-Erstellung.

    Ideal für: Erstinstallation, Entwicklungsumgebungen, schnelle Evaluierung.

    Automatisches Setup

  • Option 2: Manuelles Setup

    Schritt-für-Schritt-Installation mit voller Kontrolle über jede Komponente. Backend und Frontend separat installieren, Datenbank manuell konfigurieren.

    Ideal für: Individuelle Umgebungen, erfahrene Benutzer, CI/CD-Pipelines.

    Manuelles Setup

  • Option 3: Docker

    TCM365 in Containern mit Docker Compose ausführen. Zwei Konfigurationen: Lightweight-Entwicklungssetup und Full-Stack-Produktionssetup.

    Ideal für: Produktionsbereitstellungen, konsistente Umgebungen, Team-Onboarding.

    Docker Setup

Inhalte dieses Abschnitts

Seite Beschreibung
Installation Detaillierte Installationsanweisungen für alle drei Setup-Methoden
Schnellstart Schritt-für-Schritt Erstnutzungs-Walkthrough: Login, Tenant hinzufügen, Snapshot, Vergleich, Drift
Konfiguration Vollständige Umgebungsvariablen-Referenz und Konfigurationsoptionen

Weitergehende Architektur

Nach der Installation möchten Sie vielleicht verstehen, wie TCM365 aufgebaut ist:

Hilfe benötigt?

Falls Sie während des Setups auf Probleme stossen:

  1. Prüfen Sie den Troubleshooting Guide für häufige Probleme und Lösungen
  2. Lesen Sie den Migration Troubleshooting Guide für datenbankbezogene Probleme
  3. Konsultieren Sie den VS Code Setup Guide für IDE-Konfiguration
  4. Nutzen Sie den integrierten Diagnostics-Endpoint: GET /api/v1/diagnostics