Installation

Installationsanleitung

Laden Sie GalataJ von GitHub Releases herunter und installieren Sie es. In wenigen Minuten einsatzbereit.

Voraussetzungen

• Java JDK 11+ - Erforderlich für das Profiling von Java-Anwendungen
• IntelliJ IDEA 2023.1+ (optional) - Für IDE-Integration

Schritt 1: Von GitHub Releases herunterladen

1. Gehen Sie zu GitHub Releases
2. Laden Sie das neueste Release-Archiv für Ihre Plattform herunter:
   • Windows: galataj-<version>-windows.zip
   • Linux: galataj-<version>-linux.tar.gz
   • macOS: galataj-<version>-macos.tar.gz

Schritt 2: Dateien extrahieren

Extrahieren Sie das heruntergeladene Archiv. Sie sollten folgende Struktur sehen:

galataj-<version>/
├── agent/
│   └── agent-core-1.0.0-SNAPSHOT.jar
├── controller/
│   └── controller-1.0.0-SNAPSHOT.jar
├── cli/
│   └── galataj.exe (Windows) or galataj (Linux/macOS)
└── intellij-plugin/
    └── galataj-1.0.0-SNAPSHOT.zip

Schritt 3: CLI zum PATH hinzufügen

Die CLI (galataj) muss von überall auf Ihrem System zugänglich sein.

Windows

1. Kopieren Sie galataj.exe in ein Verzeichnis (z.B. C:\tools)
2. Fügen Sie dieses Verzeichnis zu Ihrem System-PATH hinzu:
   • Öffnen Sie Systemeigenschaften → Umgebungsvariablen
   • Bearbeiten Sie die PATH-Variable
   • Fügen Sie C:\tools (oder Ihr gewähltes Verzeichnis) hinzu
   • Klicken Sie auf OK zum Speichern
3. Starten Sie Ihr Terminal neu

Alternative: Setzen Sie eine Systemeigenschaft in IntelliJ IDEA:

• Gehen Sie zu Help → Edit Custom VM Options…
• Fügen Sie hinzu: -Dgalataj.profiler.cli.path=C:\path\to\galataj.exe
• Starten Sie die IDE neu

Linux/macOS

Option 1: Systemweite Installation

sudo cp cli/galataj /usr/local/bin/

Option 2: Benutzer-lokale Installation

mkdir -p ~/bin
cp cli/galataj ~/bin/
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc  # or ~/.zshrc
source ~/.bashrc  # or ~/.zshrc

Schritt 4: IntelliJ Plugin installieren

Methode 1: Von ZIP installieren (Empfohlen)

1. Gehen Sie in IntelliJ IDEA zu File → Settings → Plugins
2. Klicken Sie auf ⚙️ → Install Plugin from Disk…
3. Wählen Sie die Plugin-ZIP-Datei: intellij-plugin/galataj-1.0.0-SNAPSHOT.zip
4. Klicken Sie auf OK
5. Starten Sie die IDE neu, wenn Sie dazu aufgefordert werden

Methode 2: Vom Marketplace installieren (falls verfügbar)

1. Gehen Sie in IntelliJ IDEA zu File → Settings → Plugins
2. Suchen Sie nach “GalataJ”
3. Klicken Sie auf Install
4. Starten Sie die IDE neu, wenn Sie dazu aufgefordert werden

Schritt 5: Installation überprüfen

Testen Sie, ob alles funktioniert:

# CLI-Zugriff prüfen
galataj --version

# System-Gesundheitscheck ausführen
galataj doctor

Erwartete Ausgabe:

✓ Java: Found (11.0.19)
✓ Go: Found (1.21.0)
✓ Controller JAR: Found
✓ Agent JAR: Found
✓ Tools.jar: Found
✓ Controller: Not running (expected)
✓ Ports: Available (9876, 9877)

Fehlerbehebung

CLI nicht gefunden

Fehler: galataj: command not found

Lösungen:

1. Überprüfen Sie, ob CLI im extrahierten Archiv vorhanden ist
2. Prüfen Sie, ob PATH das CLI-Verzeichnis enthält
3. Starten Sie das Terminal nach dem Hinzufügen zum PATH neu
4. Unter Windows: Überprüfen Sie, ob die Dateierweiterung .exe ist

Plugin-Installation fehlgeschlagen

Fehler: Plugin lässt sich nicht installieren oder erscheint beschädigt

Lösungen:

1. Überprüfen Sie, ob die ZIP-Datei vollständig ist (Dateigröße prüfen)
2. Versuchen Sie, das Release erneut herunterzuladen
3. Stellen Sie sicher, dass IntelliJ IDEA Version 2023.1 oder höher ist
4. Prüfen Sie die IDE-Logs: Help → Show Log in Finder

Controller JAR nicht gefunden

Fehler: Controller JAR not found

Lösungen:

1. Überprüfen Sie, ob controller/controller-1.0.0-SNAPSHOT.jar im extrahierten Archiv existiert
2. Stellen Sie sicher, dass Sie das vollständige Archiv extrahiert haben, nicht nur die CLI
3. Prüfen Sie die Dateiberechtigungen (Linux/macOS)

Agent JAR nicht gefunden

Fehler: Agent JAR not found

Lösungen:

1. Überprüfen Sie, ob agent/agent-core-1.0.0-SNAPSHOT.jar im extrahierten Archiv existiert
2. Stellen Sie sicher, dass Sie das vollständige Archiv extrahiert haben
3. Prüfen Sie die Dateiberechtigungen (Linux/macOS)

Dateispeicherorte

Nach der Installation sollten Ihre Dateien so organisiert sein:

Windows:

C:\tools\galataj.exe          # CLI (im PATH)
C:\galataj\
  ├── agent\agent-core-*.jar        # Agent JAR
  └── controller\controller-*.jar   # Controller JAR

Linux/macOS:

/usr/local/bin/galataj         # CLI (im PATH)
~/galataj/
  ├── agent/agent-core-*.jar        # Agent JAR
  └── controller/controller-*.jar   # Controller JAR

Nächste Schritte

• Folgen Sie dem Schnellstart-Leitfaden, um mit dem Profiling zu beginnen
• Erfahren Sie mehr über die IntelliJ-Integration
• Entdecken Sie CLI-Befehle
• Konfigurieren Sie erweiterte Einstellungen

Aus dem Quellcode kompilieren

Wenn Sie aus dem Quellcode kompilieren müssen (für Entwicklung oder benutzerdefinierte Builds), finden Sie die Build-Anleitung im GitHub-Repository.