Datenbankkonfiguration

Aus NComputing Knowledge Base
Wechseln zu: Navigation, Suche

NoTouch Center speichert seine Daten in einer SQL-Datenbank. Die primäre Datenbank ist MySQL, aber wir unterstützen auch Oracle und Microsoft SQL Server. Die NComputing Virtual Appliance wird mit MySQL ausgeliefert, Sie müssen sich also nicht darum kümmern.

Wenn Sie eine externe Datenbank verwenden möchten, sei es eine andere MySQL, die Sie irgendwo installiert haben, oder eine vorhandene Instanz von Oracle oder Microsoft SQL Server, sind die folgenden Informationen für Sie wichtig. Bitte beachten Sie auch, dass wir Ihre eigene externe Datenbank nicht unterstützen können. Wenn Sie sich beispielsweise für Oracle entschieden haben, müssen Sie über alle erforderlichen Kenntnisse und Zeit verfügen, um mit Oracle zu arbeiten!

Konfigurationseigenschaften

Eine NoTouch Center-Instanz muss wissen, wo sich ihre Datenbank befindet und wie sie sich verbindet. Es ist nur eine Datenbank konfigurierbar.

NoTouch Center wird über Konfigurationseigenschaften konfiguriert. Dies sind die relevanten Eigenschaften in der Datei tcmgr.properties:

  • lmc.dbhost DNS-Hostname oder IP-Adresse des Datenbankservers. Standardwert: localhost
  • lmc.dbname Name der Datenbank, die auf dem Datenbankserver verwendet wird. Standardwert: easyadmin
  • lmc.dbuser Benutzername, der für die Verbindung zur Datenbank verwendet wird. Standardwert: easyadmin
  • lmc.dbpass Passwort des Datenbankbenutzers. Standardwert: easyadmin
  • lmc.dbtype Ein Zeichenfolgenwert, der den Typ der verwendeten Datenbank angibt. Standardwert: mysql
    • mysql für MySQL
    • jtds für Microsoft SQL Server (bevorzugt)
    • sqljdbc ist ein alternativer Treiber für Microsoft SQL Server, der sich auf den SQL-JDBC-Treiber von Microsoft bezieht (NoTouch 4.2.14 und höher)
    • oracle für Oracle
    • derby für Apache Derby (nicht unterstützt)
    • hsqldb für HSQL (nicht unterstützt)
    • hsqldbmem für HSQL In-Memory (nicht unterstützt - "In-Memory" bedeutet, dass alle Inhalte nach dem Neustart verschwunden sind)
  • lmc.dbport eine optionale TCP-Portnummer, wenn sie für den angegebenen Datenbanktyp nicht Standard ist. Standardwert: empty
  • lmc.dbPool bezieht sich auf den #Verbindungspooling-Mechanismus, kann c3p0, dbcp, dbcp2_basic, dbcp2_pooling sein. Standardwert: empty (bedeutet, dass C3P0 verwendet wird)
  • lmc.dbUrlOptions ermöglicht das Hinzufügen von JDBC-Treiber-spezifischen URL-Optionen. Standardwert: empty

Siehe tcmgr.properties für Informationen, wie Sie auf die properties.file zuzugreifen und NoTouch Center-Konfigurationseigenschaften bearbeiten.

Externe Datenbankoperation

Datenbankvorbereitung

NoTouch Center benötigt eine eigene "Datenbank" (manchmal als Tablespace oder Schema bezeichnet) sowie einen Benutzerkontonamen und ein Kennwort mit allen Rechten in dieser Datenbank, einschließlich der Modifizierung von Tabellendefinitionen. Einige Datenbanken nennen dies "DDL-Administration".

Standardmäßig empfehlen wir den Datenbanknamen "easyadmin", den Benutzernamen "easyadmin" und das Passwort "easyadmin".

MySQL

In MySQL lauten die Befehle zum Erstellen und Vorbereiten einer solchen Datenbank: 

 create database easyadmin;
 grant all on easyadmin.* to 'easyadmin'@'localhost' identified by 'easyadmin';

Microsoft SQL Server

Erstellen Sie zuerst in MS SQL Server Studio einen Benutzer namens "easyadmin". Klicken Sie dann mit der rechten Maustaste auf den Eintrag "Databases" in der Baumansicht und wählen Sie "Create Database". Vergeben Sie einen Namen für Ihre Datenbank (wir empfehlen "easyadmin") und stellen Sie sicher, dass der Benutzer "easyadmin" als Eigentümer der Datenbank ausgewählt ist.

Oracle

Informationen zum Erstellen von Benutzern und Tablespaces finden Sie in der Oracle-Dokumentation. Wenn Sie Oracle XE verwenden, wird der Datenbankname für "XE" fest codiert.

Ersteinrichtung

Wenn NoTouch das erste Mal mit einer leeren Datenbank verbindet, erstellt es alle Datenbanktabellen und füllt die für den Betrieb notwendigen Werte aus. Achten Sie genau auf die Protokollausgabe (center.log oder Console, wenn im Vordergrund gestartet wird). NoTouch Center wird klare und aussagekräftige Fehlermeldungen in das Protokoll schreiben, wenn es keine Verbindung herstellen kann. Es gibt Konfigurations- oder Datenbankfehler.

Deaktivieren des integrierten MySQL

Die NComputing Virtual Appliance wird mit MySQL ausgeliefert. Wenn Sie eine externe Datenbank verwenden, können Sie MySQL deaktivieren.

NComputing Virtual Appliance

  1. Melden Sie sich über Secure Shell bei der Virtual Appliance an und erhalten Sie Root-Rechte wie beschrieben
  2. Stoppen Sie die MySQL-Dienste, indem Sie diesen Befehl ausführen:
    • stop mysql
  3. Stellen Sie sicher, dass MySQL deaktiviert bleibt:
    • echo "manual" >> /etc/init/mysql.override

Datenbankmigration

Manchmal muss eine Datenbank auf einen neuen Server verschoben werden, aus welchen Gründen auch immer. In diesem Fall müssen Sie das NoTouch Center über die Änderung informieren, damit es sich mit seiner Datenbank verbinden und diese nutzen kann.

Wenn Sie Ihre komplette NoTouch Center-Installation (d.h. nicht nur die Datenbank) migrieren möchten, gibt es einfach zu bedienende Migrationspfade:

Beachten Sie, dass sich dieser Abschnitt nur mit der Migration der Datenbank befasst. Bitte verwenden Sie für den Import und Export immer Ihr Datenbankserver-Tool. Wenn Sie beispielsweise die NoTouch Center-Datenbank von einem älteren MS SQL-Server auf eine neuere Version auf einem anderen Server verschieben, exportieren Sie sie mit den Microsoft SQL Server-Tools ordnungsgemäß auf die alte und importieren Sie sie auf die neue. Stellen Sie sicher, dass Benutzerkonto, Passwort und Berechtigungen auch auf dem neuen System intakt sind.

NoTouch Center unterstützt offiziell keine Cross-Migration von einer seiner unterstützten Datenbanken zu einer anderen, obwohl die nicht unterstützten NoTouch Center XML-Tools in vielen Fällen gut funktionieren. Es gibt keine Garantie dafür, dass dies funktioniert, und selbst wenn etwas gut zu funktionieren scheint, können später Probleme auftreten.

Um Ihre Datenbank zu migrieren, gehen Sie wie folgt vor:

  1. Stoppen Sie das NoTouch Center.
  2. Migrieren Sie Ihre Datenbank auf den neuen Server unter Berücksichtigung aller Informationen auf dieser Seite.
  3. Bearbeiten der Datenbank-Konfigurationswerte von tcmgr.properties (siehe oben)
  4. Starten Sie NoTouch Center

MySQL Sicherung und Wiederherstellung

Für jede MySQL-Installation, sei es die, die von der NComputing Virtual Appliance oder einer benutzerdefinierten/dritten Installation erstellt wurde, können Sie problemlos Datenbankinhalte ein- und auslagern.

Um eine MySQL-Datenbank in eine Datei zu sichern, rufen Sie Folgendes auf: 

 mysqldump -u easyadmin -p easyadmin >mydatabase.sql

Um eine MySQL-Datenbankdatei zu lesen und Inhalte in der Datenbank zu speichern, führen Sie Folgendes aus: 

 mysql -u easyadmin -p easyadmin <mydatabase.sql

Der letztgenannte Befehl impliziert, dass die Datenbank korrekt vorbereitet wurde und das Benutzerkonto erstellt und Berechtigungen erteilt wurden (siehe oben).

Hinweis: Ihre MySQL-Binärdateien befinden sich möglicherweise nicht im Standard-Pfad, d.h. Ihre Befehlszeile findet ihn möglicherweise nicht. Wenn Sie MySQL verwenden, das vom NoTouch Center Windows Installer installiert wird, müssen Sie manuell den vollständigen Pfad zum Unterverzeichnis mysql\bin\ des Installationsordners verwenden. Das bedeutet, dass der vollständige Pfad der Tools mysqldump.exe und mysql.exe höchstwahrscheinlich so ähnlich ist wie folgt: 

 C:\Program Files\NComputing\NoTouch Center\mysql\bin\