Lizenzierung

RAMP benötigt eine gültige Lizenz, um zu funktionieren. Lizenzen sind X.509-Zertifikate, die vom kenaro-Lizenzierungsdienst ausgestellt und an eine bestimmte Maschine gebunden werden. Ohne gültige Lizenz können sich Benutzer nicht anmelden.

---

Lizenzübersicht

Jede RAMP-Lizenz enthält:

Eigenschaft	Beschreibung
Edition	Bestimmt die maximale Anzahl von Vorlagen (Starter, Team, Business, Professional, Enterprise)
Kunde	Name Ihrer Organisation
Lizenztyp	Abonnement oder Dauerlizenz
Ablaufdatum	Wann die Lizenz abläuft
Maschinenbindung	Lizenz ist über einen Aktivierungscode an eine bestimmte Maschine gebunden

Editionen

Edition	Max. Vorlagen
Starter	5
Team	10
Business	25
Professional	50
Enterprise	Unbegrenzt

---

Lizenzstatus

Sie können den aktuellen Lizenzstatus jederzeit überprüfen:

• API-Endpunkt: GET _api/license/status (keine Authentifizierung erforderlich)
• CLI: ramp-cli license status

Die Statusantwort enthält die Edition, das Vorlagenlimit, die aktuelle Vorlagenanzahl und das Ablaufdatum.

---

Aktivierungscode

Jede RAMP-Installation hat einen eindeutigen Aktivierungscode, der aus der Seriennummer und der Maschinenidentität (Hostname + Maschinen-ID) abgeleitet wird. Dieser Code bindet die Lizenz an einen bestimmten Server.

So zeigen Sie den Aktivierungscode an:

CLI

ramp-cli license activation-code --serial IHR-SERIENCODE

API

Erfordert die Rolle Administrator:

GET _api/license/activation-code

Die Seriennummer muss zuvor in appsettings.json unter License:Serial konfiguriert sein.

Hinweis

Der Aktivierungscode ändert sich, wenn sich der Hostname oder die Maschinen-ID des Servers ändert. Halten Sie diese stabil, um eine erneute Aktivierung zu vermeiden.

---

Online-Aktivierung

Wenn Ihr RAMP-Server Internetzugang hat, verwenden Sie die Online-Aktivierung für die einfachste Einrichtung.

1. Seriencode erhalten von Ihrem Lizenzanbieter.

2. Aktivierungsbefehl ausführen:

   ramp-cli license activate --serial IHR-SERIENCODE --email ihre@email.de

3. Lizenz überprüfen:

   ramp-cli license status

Die CLI kontaktiert den Lizenzserver, aktiviert die Lizenz und schreibt das Zertifikat automatisch in die appsettings.json. RAMP lädt die Lizenz automatisch neu — kein Neustart erforderlich.

Konfiguration

Die Lizenz wird in appsettings.json gespeichert:

{
  "License": {
    "Serial": "XXXX-YYYY-ZZZZ-...",
    "Certificate": "MIIBxz..."
  }
}

Sie können diese Werte auch über Umgebungsvariablen bereitstellen:

License__Serial=XXXX-YYYY-ZZZZ-...
License__Certificate=MIIBxz...

---

Offline-Aktivierung

Wenn Ihr RAMP-Server keinen Internetzugang hat, verwenden Sie die Offline-Aktivierung mit einer .lic-Datei.

1. Aktivierungscode abrufen vom Server:

   ramp-cli license activation-code --serial IHR-SERIENCODE

   Notieren Sie den angezeigten Aktivierungscode.

2. Lizenzdatei anfordern von Ihrem Anbieter. Geben Sie an:

   • Ihren Seriencode
   • Ihren Aktivierungscode
   • Ihre E-Mail-Adresse

   Der Anbieter generiert eine .lic-Datei (PFX-Zertifikat) für Ihre Maschine.

   Alternativ können Sie, wenn Sie Zugang zum Lizenzierungsportal haben, die .lic-Datei selbst herunterladen, indem Sie Seriencode, E-Mail und Aktivierungscode eingeben.

3. .lic-Datei übertragen auf Ihren RAMP-Server (per USB-Stick, SCP, Dateifreigabe usw.).

4. Mit der Datei aktivieren:

   ramp-cli license activate --serial IHR-SERIENCODE --file /pfad/zur/lizenz.lic

5. Überprüfen:

   ramp-cli license status

Tipp

Die Offline-Aktivierung ist ideal für abgeschottete Umgebungen oder Server hinter strengen Firewalls. Die .lic-Datei enthält dasselbe Zertifikat, das die Online-Aktivierung herunterladen würde — das Ergebnis ist identisch.

---

Deaktivierung

Die Deaktivierung einer Lizenz gibt den Aktivierungsplatz frei, sodass Sie auf einer anderen Maschine aktivieren können.

Online-Deaktivierung

ramp-cli license deactivate --serial IHR-SERIENCODE --email ihre@email.de

Dies kontaktiert den Lizenzserver, gibt die Aktivierung frei und entfernt das Zertifikat aus der appsettings.json.

Offline-Deaktivierung

Wenn der Server keinen Internetzugang hat:

1. Lizenz entfernen aus der appsettings.json, indem Sie den Wert von License:Certificate leeren (oder den gesamten License-Abschnitt entfernen).

2. Anbieter kontaktieren, um den Aktivierungsplatz auf dem Lizenzserver freizugeben. Geben Sie Ihren Seriencode und Aktivierungscode an.

Vorsicht

Jeder Seriencode hat eine begrenzte Anzahl von Aktivierungen. Deaktivieren Sie immer vor der Außerbetriebnahme eines Servers, um den Platz für die Wiederverwendung freizugeben.

---

Docker-Bereitstellungen

Für Docker-Bereitstellungen übergeben Sie die Lizenz über Umgebungsvariablen:

services:
  ramp:
    image: kenaro.azurecr.io/ramp:latest
    environment:
      - License__Serial=XXXX-YYYY-ZZZZ-...
      - License__Certificate=MIIBxz...

Hinweis

Der Aktivierungscode wird aus dem Hostname des Containers und /etc/machine-id abgeleitet. Verwenden Sie einen festen hostname in Ihrer Docker Compose-Datei und binden Sie eine stabile Maschinen-ID ein, um sicherzustellen, dass der Aktivierungscode über Container-Neustarts hinweg konsistent bleibt:

services:
  ramp:
    hostname: ramp-production
    volumes:
      - /etc/machine-id:/etc/machine-id:ro

Aktivierung in Docker

Um innerhalb eines laufenden Containers zu aktivieren:

# Container betreten
docker exec -it ramp-container bash

# Aktivierung durchführen
dotnet RAMP.Cli.dll license activate --serial IHR-SERIENCODE --email ihre@email.de

# Oder für Offline-Aktivierung
dotnet RAMP.Cli.dll license activate --serial IHR-SERIENCODE --file /pfad/zur/lizenz.lic

Kopieren Sie dann den Wert von License:Certificate aus der generierten appsettings.json in Ihre Docker Compose-Umgebungsvariablen für die Persistenz.

---

CLI-Referenz

Befehl	Beschreibung
ramp-cli license status	Lizenzgültigkeit, Edition, Vorlagenanzahl und Ablaufdatum anzeigen
ramp-cli license activation-code	Aktivierungscode dieser Maschine anzeigen
ramp-cli license activate	Lizenz aktivieren (online oder offline)
ramp-cli license deactivate	Lizenz deaktivieren und Aktivierungsplatz freigeben

Allgemeine Optionen

Option	Alias	Beschreibung
--serial	-s	Seriencode
--email	-e	E-Mail-Adresse (für Online-Aktivierung/-Deaktivierung)
--file	-f	Pfad zur .lic-Datei (für Offline-Aktivierung)
--config	-c	Pfad zu appsettings.json (Standard: aktuelles Verzeichnis)

---

Fehlerbehebung

„RAMP is not licensed”

Dieser Fehler erscheint beim Anmelden, wenn keine gültige Lizenz konfiguriert ist. Prüfen Sie:

1. Ist License:Serial in appsettings.json oder Umgebungsvariablen gesetzt?
2. Ist License:Certificate gesetzt und nicht leer?
3. Führen Sie ramp-cli license status aus, um den spezifischen Validierungsfehler zu sehen.

„Activation code mismatch”

Das Lizenzzertifikat ist an eine andere Maschine gebunden. Dies passiert, wenn:

• Der Server-Hostname geändert wurde
• Die Maschinen-ID geändert wurde (z.B. nach OS-Neuinstallation)
• Die Lizenz auf einer anderen Maschine aktiviert wurde

Lösung: Alte Lizenz deaktivieren und auf der aktuellen Maschine neu aktivieren.

„License expired”

Das Lizenzzertifikat hat sein Ablaufdatum überschritten. Kontaktieren Sie Ihren Anbieter zur Verlängerung.

Vorlagenlimit erreicht

Sie haben die maximale Anzahl von Vorlagen für Ihre Edition erreicht. Optionen:

• Nicht verwendete Vorlagen löschen
• Auf eine höhere Edition upgraden