ServBay

Deutsch

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Français
Tiếng Việt
Türkçe
Italiano

Deutsch

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Français
Tiếng Việt
Türkçe
Italiano

Appearance

ServBay Leitfaden für Datenbankdateimanagement und Migration ​

ServBay ist eine leistungsstarke lokale Web-Entwicklungsumgebung, die verschiedene beliebte Datenbankmanagementsysteme integriert und deren Datenbankdateien standardisiert verwaltet. Für Entwickler ist es essenziell, die Standardstruktur der Datenbankablage von ServBay zu verstehen, um Backups, Wiederherstellungen und Migrationen sicher durchführen zu können.

In diesem Leitfaden erfahren Sie alles über die Standardablagestruktur der ServBay-Datenbanken und erhalten praktische Anleitungen, wie Sie mithilfe gängiger Kommandozeilentools Datenbankdateien verwalten und zwischen verschiedenen Umgebungen migrieren.

TIP

ServBay bietet Backup- und Wiederherstellungsfunktionen, mit denen Sie MySQL-, MariaDB- und PostgreSQL-Datenbanken automatisch oder manuell sichern können. Weitere Informationen finden Sie unter Backup und Wiederherstellung.

Standard-Dateispeicherstruktur von ServBay-Datenbanken ​

Um das Management und die Trennung verschiedener Datenbankversionen zu erleichtern, speichert ServBay sämtliche Datenbankdateien zentral im Verzeichnis /Applications/ServBay/db. Dort sind sie nach Datenbanktyp gegliedert, anschließend erfolgt eine weitere Untergliederung nach Hauptversionsnummer (major version).

Typische Struktur des Verzeichnisses /Applications/ServBay/db:

/Applications/ServBay/db
├── mysql
│   ├── 8.0
│   └── 8.1
├── mariadb
│   ├── 10.10
│   ├── 10.11
│   ├── 10.5
│   ├── 10.6
│   ├── 10.7
│   ├── 10.8
│   ├── 10.9
│   ├── 11.0
│   ├── 11.1
│   ├── 11.2
│   └── 11.3
├── postgresql
│   ├── 10
│   ├── 11
│   ├── 12
│   ├── 13
│   ├── 14
│   ├── 15
│   └── 16
└── redis

Erläuterung der Verzeichnisstruktur ​

  • /Applications/ServBay/db: Hauptverzeichnis für alle Datenbankdateien in ServBay.
  • mysql: Speicherort für MySQL-Daten. Jede Unterversion (z. B. 8.0, 8.1) wird in einem eigenen Unterordner abgelegt.
  • mariadb: Speicherort für MariaDB-Daten. Auch hier erfolgt die Trennung nach Hauptversion (z. B. 10.11, 11.3).
  • postgresql: Hier liegen die PostgreSQL-Daten nach Hauptversion gegliedert (z. B. 15, 16).
  • redis: Ablageort für die persistente Datei von Redis, in der Regel dump.rdb.

Vorteil dieser Struktur: Sie können in ServBay gleichzeitig mehrere Hauptversionen derselben Datenbank installieren und betreiben, ohne dass sich deren Daten gegenseitig beeinflussen oder überschreiben.

Datenbankdateien verwalten ​

Beim lokalen Entwickeln ist es häufig notwendig, Backups der Datenbanken zu machen, diese wiederherzustellen oder zwischen Umgebungen zu migrieren. Im Folgenden finden Sie die Vorgehensweisen, wie Sie diese Aufgaben mit den Standard-Kommandozeilentools der jeweiligen Datenbank erledigen. Hinweis: Diese Aktionen sollten im von ServBay bereitgestellten Terminal oder bei korrekt gesetzten Umgebungsvariablen ausgeführt werden, damit die jeweiligen Datenbanktools gefunden werden.

Datenbanken sichern ​

Regelmäßige Backups sind essenziell für die Datensicherheit. Nachfolgend finden Sie Beispiele für das Backup der verschiedenen Datenbanken in ServBay.

MySQL sichern ​

Das Tool mysqldump ist der Standard zur Sicherung von MySQL-Datenbanken.

bash
# Wechseln Sie ins ServBay-Terminal oder stellen Sie sicher, dass das ServBay-Bin-Verzeichnis im PATH ist.
# Beispiel: export PATH="/Applications/ServBay/bin:$PATH"

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql
  • your_username: Ersetzen Sie dies durch Ihren Datenbankbenutzernamen.
  • your_database: Ersetzen Sie dies durch den Namen der zu sichernden Datenbank.
  • /Applications/ServBay/backup/your_database.sql: Ersetzen Sie dies durch den gewünschten Speicherort und Dateinamen für das Backup. Es wird empfohlen, Backups außerhalb des ServBay-Verzeichnisses, z. B. im eigenen Benutzerordner, abzulegen.

MariaDB sichern ​

Das Vorgehen für MariaDB gleicht dem von MySQL — ebenfalls via mysqldump.

bash
# Wechseln Sie ins ServBay-Terminal oder stellen Sie sicher, dass das ServBay-Bin-Verzeichnis im PATH ist.

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql
  • Parameter wie oben beschrieben.

PostgreSQL sichern ​

Für PostgreSQL-Backups wird pg_dump verwendet. In ServBay verbindet sich PostgreSQL in der Regel über Unix Domain Socket, Standardpfad ist /Applications/ServBay/tmp. Daher ist der Parameter -h /Applications/ServBay/tmp anzugeben.

bash
# Wechseln Sie ins ServBay-Terminal oder stellen Sie sicher, dass das ServBay-Bin-Verzeichnis im PATH ist.

pg_dump -h /Applications/ServBay/tmp -U your_username -d your_database -F c -b -v -f /Applications/ServBay/backup/your_database.dump
  • -h /Applications/ServBay/tmp: Pfad zur PostgreSQL-Socket-Datei.
  • -U your_username: Ihr Datenbankbenutzername.
  • -d your_database: Name der zu sichernden Datenbank.
  • -F c: Output ist ein benutzerdefiniertes Archivformat (empfohlen).
  • -b: Komplexe Objekte (Blobs) werden mitgesichert.
  • -v: Ausführlicher Modus.
  • -f /Applications/ServBay/backup/your_database.dump: Zielpfad und Dateiname für das Backup.

Redis sichern ​

Redis-Backups werden in der Regel durch Kopieren der Datei dump.rdb erstellt.

bash
# Wechseln Sie ins ServBay-Terminal
# Stellen Sie sicher, dass der Redis-Server läuft oder ein automatisches Speichern konfiguriert ist (BGSAVE)

cp /Applications/ServBay/db/redis/dump.rdb /Applications/ServBay/backup/dump.rdb
  • /Applications/ServBay/db/redis/dump.rdb: Standardpfad zur Redis-Persistenzdatei.
  • /Applications/ServBay/backup/dump.rdb: Zielpfad und Dateiname des Backups.

Datenbanken wiederherstellen ​

Bei Datenverlusten oder zur Rückkehr zu einem früheren Stand können Sie Datenbanken aus Backups wiederherstellen.

MySQL wiederherstellen ​

Wiederherstellung mittels MySQL-Client:

bash
# Wechseln Sie ins ServBay-Terminal

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql
  • your_username: Ihr Datenbankbenutzername.
  • your_database: Die Ziel-Datenbank, üblicherweise vorab anzulegen.
  • /Applications/ServBay/backup/your_database.sql: Ihr Backup-Dateipfad.

MariaDB wiederherstellen ​

Das Vorgehen entspricht MySQL. Nutzung des MySQL-Clients:

bash
# Wechseln Sie ins ServBay-Terminal

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql
  • Parameter wie oben beschrieben.

PostgreSQL wiederherstellen ​

Verwenden Sie pg_restore für Backups im benutzerdefinierten Format. Auch hier den Pfad zur Socket-Datei angeben.

bash
# Wechseln Sie ins ServBay-Terminal

pg_restore -h /Applications/ServBay/tmp -U your_username -d your_database -v /Applications/ServBay/backup/your_database.dump
  • -h /Applications/ServBay/tmp: Pfad zur PostgreSQL-Socket-Datei.
  • -U your_username: Ihr Datenbankbenutzername.
  • -d your_database: Ziel-Datenbank (vorher anzulegen).
  • -v: Ausführlicher Modus.
  • /Applications/ServBay/backup/your_database.dump: Backup-Dateipfad.

Redis wiederherstellen ​

Die Wiederherstellung bei Redis erfolgt durch Zurückkopieren der Datei dump.rdb.
Wichtig: Vorher muss der Redis-Server gestoppt werden!

bash
# Wechseln Sie ins ServBay-Terminal
# Stoppen Sie den Redis-Dienst in ServBay
# Kopieren des Backup-Files
cp /Applications/ServBay/backup/dump.rdb /Applications/ServBay/db/redis/dump.rdb
# Starten Sie den Redis-Dienst in ServBay wieder
  • /Applications/ServBay/backup/dump.rdb: Ihr Backup-Dateipfad.
  • /Applications/ServBay/db/redis/dump.rdb: Zielpfad für Redis-Persistenz.

Migration von Datenbanken ​

Datenbankmigration bedeutet, eine Datenbank von einer Umgebung (z. B. anderer ServBay-Instanz, Remote-Server oder andere lokale Umgebung) in eine neue Umgebung zu übertragen. Dazu exportieren Sie die Daten in der Ursprungsumgebung und importieren sie in der Zielumgebung wieder.

MySQL Migration ​

MySQL migrieren ist ein häufiger Fall in der Entwicklung.

  1. Export der Ursprungsdatenbank:

    bash
    # In der Quellumgebung im Terminal ausführen
mysqldump -u your_source_username -p your_database > your_database.sql
    • your_source_username: Nutzername der Quelle.
    • your_database: Name der zu migrierenden Datenbank.
    • your_database.sql: Name der Exportdatei.

  2. Übertragen der SQL-Datei in die Zielumgebung:
    Nutzen Sie scp oder ein anderes Übertragungswerkzeug, um your_database.sql z. B. nach /Applications/ServBay/backup/ zu verschieben.

  3. Anlegen der Ziel-Datenbank in ServBay:

    bash
    # Im Ziel-ServBay-Terminal ausführen
mysql -u your_target_username -p -e "CREATE DATABASE your_database;"
    • your_target_username: Benutzername der Ziel-ServBay-Instanz.
    • your_database: Name der neuen, anzulegenden Datenbank (sollte identisch mit Quelle sein).

  4. Import in die Ziel-Datenbank:

    bash
    # Im Ziel-ServBay-Terminal ausführen
mysql -u your_target_username -p your_database < /path/to/your_database.sql
    • /path/to/your_database.sql: Tatsächlicher Pfad der SQL-Datei in der Zielumgebung.

MariaDB Migration ​

MariaDB migrieren läuft exakt analog zu MySQL, da dieselben Tools und Dateiformate genutzt werden.

  1. Export der Ursprungsdatenbank:
    bash
    # In der Quellumgebung im Terminal ausführen
mysqldump -u your_source_username -p your_database > your_database.sql
  2. SQL-Datei in die Zielumgebung übertragen.
  3. Datenbank in ServBay anlegen:
    bash
    # Im Ziel-ServBay-Terminal ausführen
mysql -u your_target_username -p -e "CREATE DATABASE your_database;"
  4. Import der Datenbank ins Zielsystem:
    bash
    # Im Ziel-ServBay-Terminal ausführen
mysql -u your_target_username -p your_database < /path/to/your_database.sql

PostgreSQL Migration ​

PostgreSQL migrieren erfolgt über pg_dump und pg_restore. Auch hier ist auf den Socket-Pfad zu achten.

  1. Datenbank in der Quellumgebung exportieren:

    bash
    # Im Terminal der Quellumgebung ausführen
# Wenn Quelle ServBay ist:
pg_dump -h /Applications/ServBay/tmp -U your_source_username -d your_database -F c -b -v -f your_database.dump
# Bei anderen Systemen ggf. Verbindungsparameter anpassen
    • your_source_username: Benutzername der Quelle.
    • your_database: Zu migrierende Datenbank.
    • your_database.dump: Name der Backup-Datei.

  2. Backup-Datei in die Zielumgebung transferieren:
    Über scp oder andere Tools auf das Zielsystem bringen.

  3. Datenbank im Ziel-ServBay anlegen:

    bash
    # Im ServBay-Terminal ausführen
# Verbinden mit Standard-Datenbank postgres und neue DB anlegen
psql -h /Applications/ServBay/tmp -U your_target_username -d postgres -c "CREATE DATABASE your_database;"
    • your_target_username: Ziel-Benutzername.
    • your_database: Name der neuen Datenbank.

  4. Inhalt in die neue Datenbank importieren:

    bash
    # Im Ziel-ServBay-Terminal ausführen
pg_restore -h /Applications/ServBay/tmp -U your_target_username -d your_database -v /path/to/your_database.dump
    • /path/to/your_database.dump: Pfad der Backup-Datei im Zielsystem.

Redis Migration ​

Migration bei Redis erfolgt in der Regel durch direktes Kopieren der Datei dump.rdb.

  1. dump.rdb in der Quellumgebung bereitstellen:

    bash
    # Im Terminal der Quelle ausführen
# Redis-Server sollte gestoppt sein oder BGSAVE abgeschlossen
cp /path/to/source/redis/dump.rdb ./dump.rdb

  2. Kopieren der Datei in das Redis-Verzeichnis der Zielumgebung:

    bash
    # Auf der Quelle oder einem Zwischenserver ausführen
scp ./dump.rdb your_target_server:/Applications/ServBay/db/redis/dump.rdb
    • your_target_server: Adresse/Hostname der Ziel-ServBay-Instanz.
    • Wichtig: Vor dem Kopieren muss der Redis-Dienst in der Zielumgebung gestoppt sein!

  3. Redis in ServBay wieder starten: Beim Start lädt Redis automatisch das neue dump.rdb-File.

Wichtige Hinweise ​

  • Dienst stoppen: Bevor Sie Datenbankdateien (insbesondere Datenverzeichnisse von MySQL/MariaDB/PostgreSQL) direkt kopieren oder verschieben, stoppen Sie unbedingt den jeweiligen Service über die ServBay-GUI oder das Kommandozeilentool. Kopieren laufender Datenbankdateien kann zu Inkonsistenzen oder Datenkorruption führen. Bei Redis muss der Dienst vor der Wiederherstellung von dump.rdb ebenfalls gestoppt sein.
  • Berechtigungen: Stellen Sie sicher, dass Ihr Benutzerkonto ausreichende Rechte für die Kopier-, Verschieb- oder Importvorgänge besitzt.
  • Dateipfade prüfen: Kontrollieren Sie ServBays Installationspfad (Standard: /Applications/ServBay) und die konkreten Dateipfade — insbesondere bei verschiedenen DB-Versionen.
  • Benutzer und Rechte: Überprüfen Sie nach Migrationen die Datenbanknutzer, Rechte und ggf. Konfigurationsdateien und passen Sie diese für die neue Umgebung an.
  • ServBay-Integriertes Backup: ServBay bietet ein komfortables, integriertes Dateisicherungs- und Wiederherstellungssystem mit GUI-Unterstützung für Einstellungen, Webseiten-Dateien, Datenbanken und SSL-Zertifikate – dies kann die manuelle Dateiverwaltung teilweise ersetzen oder sinnvoll ergänzen.

Fazit ​

Dank der strukturierten Datenbankablage bietet ServBay eine übersichtliche Basis für das Management von Datenbankdateien. Dieser Leitfaden zeigt die Speicherorte von MySQL, MariaDB, PostgreSQL und Redis in ServBay und gibt praxisnahe Anleitungen zu Backup, Wiederherstellung und Migration mit Standardtools. Mit diesen Kenntnissen können Sie Ihre lokalen Datenbanken zuverlässig sichern, verwalten und effizient zwischen Umgebungen wechseln. In Kombination mit weiteren Features wie dem integrierten Backup von ServBay steigern Sie Ihre Entwicklungseffizienz und Datensicherheit nachhaltig.