Linux Ubuntu

Skript herunterladen

Laden Sie das Skript über diesen Link  herunter.

Skript in ein temporäres Verzeichnis verschieben

Verschieben Sie das heruntergeladene Skript in ein temporäres Verzeichnis (das Home-Verzeichnis des Benutzers).

Dienst-Zip und Lizenzdatei hinzufügen

Legen Sie die Zip-Datei des Babel-Dienstes (babel_service_net100_x.y.z.w.zip, wobei x.y.z.w die Version ist) und die Lizenzdatei (babel.licenses) in dasselbe temporäre Verzeichnis wie das Skript.

Skript ausführen

Führen Sie die folgenden Befehle aus, um die Installation zu starten.

chmod +x ./BabelLicensingService.sh
sudo <a data-footnote-ref href="#user-content-fn-1">./BabelLicensingService.sh</a>

Dateien in das Home-Verzeichnis des Benutzers babel kopieren

Öffnen Sie ein Terminal und kopieren Sie die Zip-Datei und die Lizenzdatei mit dem folgenden Befehl an den gewünschten Ort:

cp babel_service_net100_x.y.z.w.zip /home/babel/
cp babel.licenses /home/babel/

Die Zip-Datei mit den Assemblys des Babel Licensing Service liegt nun im Home-Verzeichnis des Benutzers „babel“ (/home/babel). Mit den Dateien in diesem Verzeichnis fahren Sie mit der Installation und Konfiguration des Babel Licensing Service fort.

Installationsordner anlegen und Archiv entpacken

Legen Sie unter „/var/www“ den Ordner „svc/babel“ an und entpacken Sie den Inhalt des Zip-Archivs:

1. Führen Sie im Terminalfenster den folgenden Befehl aus, um unter „/var/www“ den Ordner „svc/babel“ anzulegen

sudo mkdir -p /var/www/svc/babel

Sie werden nach Ihrem Passwort gefragt, denn „sudo“ gewährt die administrativen Rechte, die zum Anlegen von Verzeichnissen im Systemverzeichnis nötig sind.

2. Wechseln Sie in den neu angelegten Ordner „babel“:

cd /var/www/svc/babel

3. Entpacken Sie den Inhalt des Zip-Archivs in das aktuelle Verzeichnis („/var/www/svc/babel“):

sudo unzip /home/babel/babel_service_net100_x.y.z.w.zip

Mit diesen Schritten legen Sie die nötige Ordnerstruktur an und entpacken den Inhalt des Zip-Archivs in das Verzeichnis „/var/www/svc/babel“. Damit können Sie die Installation und Konfiguration des Babel Licensing Service am richtigen Ort fortsetzen.

Lizenzdatei kopieren

Kopieren Sie die Lizenzdatei „babel.licenses“ mit dem folgenden Befehl in das Verzeichnis „/var/www/svc/babel“:

sudo cp /home/babel/babel.licenses /var/www/svc/babel/

Die Lizenzdatei „babel.licenses“ ist nun im Verzeichnis „/var/www/svc/babel“ installiert. Als Nächstes konfigurieren Sie den Benutzer, unter dem der Babel Licensing Service läuft.

Besitzer der Anwendung festlegen

Nachdem die Lizenzdatei „babel.licenses“ im Verzeichnis „/var/www/svc/babel“ installiert ist, konfigurieren Sie im nächsten Schritt den Benutzer, unter dem der Babel Licensing Service läuft. Hier verwenden wir den Benutzer „www-data“.

Führen Sie dazu im Terminal den folgenden Befehl aus:

sudo chown www-data:www-data -R /var/www/svc/babel

Dieser Befehl überträgt den Besitz des Verzeichnisses „/var/www/svc/babel“ und seines Inhalts auf den Benutzer und die Gruppe „www-data“. Mit dem richtigen Besitzer stellen Sie sicher, dass der Babel Licensing Service unter dem vorgesehenen Benutzer laufen und auf die benötigten Dateien und Verzeichnisse zugreifen kann.

Dienst konfigurieren

Um den Babel Licensing Service zu konfigurieren und in der Datei appsettings.json die Einstellungen der Datenbankverbindung und weitere Anwendungseinstellungen einzutragen, gehen Sie so vor:

1. Öffnen Sie in einem Terminalfenster mit dem folgenden Befehl die Datei appsettings.json im Texteditor Nano

sudo nano /var/www/svc/babel/appsettings.json

2. Suchen Sie in der Datei appsettings.json den Abschnitt "Database". Setzen Sie den Wert "Provider" auf "MySQL", um MySQL als Datenbankanbieter anzugeben

"Database": {
  "Provider": "MySQL"
},

3. Suchen Sie den Abschnitt "ConnectionStrings". Passen Sie unter dem Schlüssel "MySQL" die Verbindungszeichenfolge an die Konfiguration Ihres MySQL-Servers an. Tragen Sie die Werte für server, User, Password und Database entsprechend ein:

"ConnectionStrings": {
  "SQLServer": "",
  "MySQL": "Server=127.0.0.1;User=babel;Password=YourUniquePassword;Database=licenses",
  "SQLite": ""
},

Ersetzen Sie "YourUniquePassword" durch ein starkes Passwort Ihrer Wahl. Für ein sicheres Passwort empfiehlt sich eine Kombination aus Groß- und Kleinbuchstaben, Ziffern und Sonderzeichen. Bewahren Sie das Passwort auf, Sie brauchen es später bei der Konfiguration der Datenbank.

4. Optional können Sie weitere Anwendungseinstellungen anpassen. Im Abschnitt "Serilog" konfigurieren Sie zum Beispiel die Protokollierung und passen die minimale Protokollstufe an:

"Serilog": {
  "Using": [ "Serilog.Sinks.Console", "Serilog.Sinks.File" ],
  "MinimumLevel": {
    "Default": "Information",
    "Override": {
      "Microsoft": "Debug",
      "System": "Debug",
      "Grpc": "Debug"
    }
  },
  ...
},

Um Installationsprobleme zu untersuchen, kann es hilfreich sein, die minimale Protokollstufe auf Debug zu setzen. Sobald der Dienst läuft, stellen Sie die Protokollstufe wieder auf Information oder Warning.

5. Weiter unten, im Abschnitt "Application", geben Sie "LicenseFile" (babel.licenses) an und passen die Werte "SigningKey" und "TokenExpiration" an Ihre Anforderungen an:

"Application": {
  "AdminUsername": "your-admin-user",
  "AdminEmail": "admin@example.com",
  "AdminPassword": "<strong-initial-password>",
  "LicenseFile": "babel.licenses",
  "SigningKey": "Secret Token Key",
  "TokenExpiration": "00:30:00"
},

Ersetzen Sie Secret Token Key durch Ihren eigenen, eindeutigen Schlüssel. Er sichert die Kommunikation zwischen den Clients der Anwendung und dem Babel Licensing Service.

6. Um die Änderungen zu speichern und Nano zu verlassen, drücken Sie Ctrl + X, bestätigen Sie die Änderungen mit Y und drücken Sie zuletzt Enter, um die Datei zu speichern.

Mit diesen Schritten haben Sie den Babel-Dienst über die Datei appsettings.json konfiguriert. Die geänderte Konfiguration enthält die richtigen Einstellungen der Datenbankverbindung und alle weiteren Anpassungen, die Sie vorgenommen haben.

Mehr über die Konfigurationsdatei des Babel Licensing Service erfahren Sie im Abschnitt Konfiguration.

Datenbank anlegen

Legen Sie nun die Datenbank „licenses“ an, die in der Verbindungszeichenfolge des Babel Licensing Service konfiguriert ist. Legen Sie anschließend den Benutzer „babel“ an, erteilen Sie ihm die Rechte an der Datenbank und prüfen Sie seine Berechtigungen.

1. Öffnen Sie ein Terminal.
2. Melden Sie sich mit dem folgenden Befehl als Benutzer root an der MariaDB-Konsole an:

sudo mariadb -u root -p

Sie werden nach dem root-Passwort gefragt.

3. Sobald Sie an der MariaDB-Konsole angemeldet sind, listen Sie mit diesem Befehl alle vorhandenen Datenbanken auf:

SHOW DATABASES;

4. Um alle vorhandenen Benutzer aufzulisten, führen Sie die folgende Abfrage aus:

SELECT User FROM mysql.user;

5. Legen Sie die Datenbank „licenses“ mit diesem Befehl an:

CREATE DATABASE licenses;

6. Legen Sie mit den folgenden Befehlen den Benutzer „babel“ an und erteilen Sie ihm alle Rechte an der Datenbank „licenses“:

CREATE USER babel@localhost IDENTIFIED BY 'YourUniquePassword';
GRANT ALL PRIVILEGES ON licenses.* TO babel@localhost;
FLUSH PRIVILEGES;

Ersetzen Sie 'YourUniquePassword' durch das Passwort, das Sie in der MySQL-Verbindungszeichenfolge des Babel Licensing Service festgelegt haben.

7. Mit der folgenden Anweisung prüfen Sie, ob der Benutzer „babel“ die richtigen Berechtigungen hat:

SHOW GRANTS FOR babel@localhost;

Verlassen Sie nun die MariaDB-Konsole, indem Sie den Befehl quit eingeben und ENTER drücken.

Mit diesen Schritten haben Sie die Datenbank „licenses“ und den Benutzer „babel“ angelegt, ihm die Rechte an der Datenbank erteilt und seine Berechtigungen geprüft.

Terminal öffnen

Öffnen Sie ein Terminalfenster.

In das Verzeichnis des Dienstes wechseln

Wechseln Sie in das Verzeichnis, in dem der Babel Licensing Service liegt. Zum Beispiel:

cd /var/www/svc/babel

Dienst ausführen

Starten Sie den Babel Licensing Service mit dem folgenden Befehl:

dotnet Babel.Licensing.Service.dll

Wenn alles richtig konfiguriert ist, sehen Sie, wie der Dienst startet. Das Protokoll im Terminal zeigt Informationen zur Initialisierung des Dienstes, darunter das Anlegen der Tabellen in der Datenbank, je nach der Protokollstufe, die Sie in der Datei appsettings.json gewählt haben.

Achten Sie im Protokoll des Terminals auf Fehler und Warnungen. Bei Problemen prüfen Sie, ob die Konfiguration, die Einstellungen der Datenbankverbindung und die Berechtigungen stimmen.

Nach einem erfolgreichen Start ist der Babel Licensing Service bereit, Lizenzvorgänge zu verarbeiten und Ihren Anwendungen Lizenzdienste bereitzustellen.

Dienstdatei öffnen

Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus, um die Dienstdatei anzulegen und zu bearbeiten:

sudo nano /etc/systemd/system/babel.licensing.service

Dienstkonfiguration einfügen

Fügen Sie die folgende Konfiguration in die Datei ein:

[Unit]
Description=Babel Licensing Service
 
[Service]
WorkingDirectory=/var/www/svc/babel/
ExecStart=/usr/bin/dotnet /var/www/svc/babel/Babel.Licensing.Service.dll
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=babel-licensing-svc
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
 
[Install]
WantedBy=multi-user.target

Dienstdatei speichern

Speichern Sie die Datei mit Ctrl+O und verlassen Sie den Editor mit Ctrl+X.

Dienst starten

Starten Sie den Babel Licensing Service mit dem folgenden Befehl:

sudo systemctl start babel.licensing

Status des Dienstes prüfen

Den Status des Dienstes prüfen Sie mit dem folgenden Befehl:

systemctl status babel.licensing

Dieser Befehl zeigt den aktuellen Status des Dienstes an, einschließlich etwaiger Fehlermeldungen und Warnungen:

● babel.service - Babel Licensing Service
     Loaded: loaded (/etc/systemd/system/babel.licensing.service; disabled; vendor preset: enabled)
     Active: active (running) since Fri 2023-05-19 09:24:53 UTC; 1s ago
   Main PID: 2710499 (dotnet)
      Tasks: 17 (limit: 4392)
     Memory: 28.0M
        CPU: 903ms
     CGroup: /system.slice/babel.licensing
             └─2710499 /usr/bin/dotnet /var/www/svc/babel/Babel.Licensing.Service.dll
 
May 19 09:24:57 babel-licensing-svc[2710499]: [09:24:57 DBG] Hosting started

Automatischen Start einschalten

Standardmäßig startet der Dienst nicht automatisch mit dem Server. Um den automatischen Start einzuschalten, führen Sie den folgenden Befehl aus:

sudo systemctl enable babel.licensing

Danach startet der Dienst nach jedem Neustart des Servers automatisch.