ServBay Databasebestandbeheer en Migratiegids

ServBay is een krachtige lokale webontwikkelomgeving die diverse veelgebruikte databasesystemen integreert, met gestandaardiseerd beheer van hun databestanden. Inzicht in de standaard bestandsstructuur van ServBay-gegevens is essentieel voor developers die backups, herstel of migratie van hun databases willen uitvoeren.

In dit document vind je een gedetailleerde uitleg over de standaard bestandslocaties van ServBay-databases en praktische instructies voor beheer en migratie tussen verschillende omgevingen via standaard commandline tools.

TIP

ServBay biedt backup en herstelmogelijkheden waarmee je automatisch of handmatig backups kunt maken van MySQL, MariaDB en PostgreSQL databases. Raadpleeg Backup en Herstel voor meer informatie.

Standaard Bestandslocatie van Databasebestanden in ServBay

Om het beheer en de isolatie van data van verschillende databaseversies te vereenvoudigen, slaat ServBay alle databestanden op in de directory /Applications/ServBay/db. Hier worden de gegevens per databasetype gesorteerd, en binnen elk type verder opgedeeld per hoofdversienummer.

Hieronder een typisch voorbeeld van de structuur binnen /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

Uitleg van de directorystructuur

• /Applications/ServBay/db: Dit is de hoofdmap waar ServBay alle databasebestanden opslaat.
• mysql: Bevat MySQL databestanden, gesorteerd per hoofdversie (zoals 8.0, 8.1).
• mariadb: Bevat MariaDB databestanden, gesorteerd zoals 10.11, 11.3 etc.
• postgresql: Bevat PostgreSQL databestanden, met mappen per versie (bijv. 15, 16).
• redis: Hier worden Redis persistente bestanden opgeslagen, meestal het dump.rdb bestand.

Dankzij deze structuur kun je meerdere hoofdversies van dezelfde database tegelijk in ServBay installeren en gebruiken, waarbij elke versie zijn eigen bestandsmap heeft en geen invloed heeft op de andere.

Beheer van Databasebestanden

Tijdens lokale ontwikkeling zul je regelmatig backups moeten maken, herstelopdrachten uitvoeren, of data migreren. Hieronder volgt een overzicht van hoe je deze taken voor diverse databases uitvoert met standaard commandline tools. Let op: deze stappen vereisen doorgaans dat je ServBay's terminalomgeving gebruikt, of dat je PATH-variabele correct is ingesteld zodat de database-tools toegankelijk zijn.

Database backuppen

Regelmatige backups zijn cruciaal voor het waarborgen van de veiligheid van je data. Hieronder vind je instructies voor het backuppen van verschillende database-types binnen ServBay.

MySQL backups maken

De standaard tool voor het backuppen van MySQL is mysqldump.

# Wissel naar ServBay's terminalomgeving of zorg dat PATH ServBay's bin-directory bevat
# Bijvoorbeeld: export PATH="/Applications/ServBay/bin:$PATH"

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql

• your_username: Vervang door jouw databasegebruikersnaam.
• your_database: Vervang door de naam van de database die je wilt backuppen.
• /Applications/ServBay/backup/your_database.sql: Pas dit aan naar het gewenste pad en bestandsnaam voor je backup. Het is aan te raden deze backups buiten de ServBay map op te slaan, bijvoorbeeld in je gebruikersfolder.

MariaDB backups maken

Het backuppen van MariaDB werkt hetzelfde als bij MySQL, ook met mysqldump.

# Wissel naar ServBay's terminalomgeving of zorg dat PATH ServBay's bin-directory bevat

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql

• Parameters zoals hierboven beschreven.

PostgreSQL backups maken

Gebruik pg_dump om een backup van PostgreSQL te maken. In ServBay is PostgreSQL vaak geconfigureerd voor een Unix Domain Socket verbinding, standaard via /Applications/ServBay/tmp, dus die moet je meegeven als -h parameter.

# Wissel naar ServBay's terminalomgeving of zorg dat PATH ServBay's bin-directory bevat

pg_dump -h /Applications/ServBay/tmp -U your_username -d your_database -F c -b -v -f /Applications/ServBay/backup/your_database.dump

• Verbindingsparameters: Stel de connectie met de PostgreSQL-server correct in.
  • macOS: -h /Applications/ServBay/tmp (Unix Domain Socket pad)
  • Windows: -h localhost -p 5432 (TCP-verbinding)
• -U your_username: Vervang door jouw databasegebruikersnaam.
• -d your_database: Vervang door de naam van je database.
• -F c: Output in custom archiveformat (aanbevolen).
• -b: Inclusief grote objecten (blobs).
• -v: Gedetailleerde uitvoer.
• -f /Applications/ServBay/backup/your_database.dump: Pas aan naar het gewenste backup-pad en bestandsnaam.

Redis backup maken

Redis backups worden doorgaans gemaakt door het persistente bestand dump.rdb te kopiëren.

# Wissel naar ServBay's terminalomgeving
# Zorg dat Redis actief is, of dat BGSAVE correct is geconfigureerd

cp /Applications/ServBay/db/redis/dump.rdb /Applications/ServBay/backup/dump.rdb

• /Applications/ServBay/db/redis/dump.rdb: Standaardpad voor het Redis persistente bestand.
• /Applications/ServBay/backup/dump.rdb: Pas aan naar je gewenste backup-locatie.

Database herstellen

Wanneer data verloren gaat of je wilt terugkeren naar een eerdere status, kun je een backup terugzetten.

MySQL herstellen

Gebruik de mysql client om MySQL backups terug te zetten.

# Wissel naar ServBay's terminalomgeving

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql

• your_username: Vervang door jouw databasegebruikersnaam.
• your_database: Vervang door de naam van de database die je terug wilt zetten (deze moet vooraf zijn aangemaakt).
• /Applications/ServBay/backup/your_database.sql: Pas aan naar je backupbestand.

MariaDB herstellen

Het herstelproces van MariaDB is identiek aan MySQL, weer met de mysql client:

# Wissel naar ServBay's terminalomgeving

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql

• Parameters zoals hierboven beschreven.

PostgreSQL herstellen

Herstel een PostgreSQL custom-format backupbestand met pg_restore, waarbij je opnieuw het juiste socket-pad moet meegeven.

# Wissel naar ServBay's terminalomgeving

pg_restore -h /Applications/ServBay/tmp -U your_username -d your_database -v /Applications/ServBay/backup/your_database.dump

• Verbindingsparameters: Stel de connectie correct in.
  • macOS: -h /Applications/ServBay/tmp (Unix Domain Socket pad)
  • Windows: -h localhost -p 5432 (TCP-verbinding)
• -U your_username: Jouw databasegebruikersnaam.
• -d your_database: Naam van de bestemmingdatabase (moet zijn aangemaakt).
• -v: Gedetailleerde uitvoer.
• Pad naar backupbestand: Vervang door het pad naar je backup.
  • macOS: /Applications/ServBay/backup/your_database.dump
  • Windows: C:\ServBay\backup\your_database.dump

Redis herstellen

Herstel Redis door het backupbestand dump.rdb terug te plaatsen in de Redis gegevensmap. Belangrijk: Stop de Redis-service vóór deze handeling.

# Wissel naar ServBay's terminalomgeving
# Stop de Redis-service in ServBay
# Kopieer het backupbestand
cp /Applications/ServBay/backup/dump.rdb /Applications/ServBay/db/redis/dump.rdb
# Start de Redis-service in ServBay

• /Applications/ServBay/backup/dump.rdb: Pad naar je backupbestand.
• /Applications/ServBay/db/redis/dump.rdb: Standaard Redis persistente pad.

Database migreren

Migratie betekent het verplaatsen van een database van de ene omgeving naar een andere (bijvoorbeeld een andere ServBay instantie, een remote server of lokaal). Dit doe je meestal door export in de bronomgeving en import in de doelsituatie.

Migratie van MySQL

MySQL migreren komt veel voor tijdens development.

1. Exporteer de database uit de bronomgeving:

   # Draai deze op de terminal van de bronomgeving
   mysqldump -u your_source_username -p your_database > your_database.sql

   • your_source_username: Databasegebruikersnaam van de bron.
   • your_database: Te migreren database.
   • your_database.sql: Exportbestand.

2. Verplaats het SQL bestand naar de doelomgeving: Gebruik bijvoorbeeld scp om het bestand naar de ServBay doelomgeving te kopiëren (/Applications/ServBay/backup/).

3. Maak een nieuwe database aan in de ServBay doelomgeving:

   # Draai deze op de terminal van de ServBay doelomgeving
   mysql -u your_target_username -p -e "CREATE DATABASE your_database;"

   • your_target_username: Gebruiker in ServBay.
   • your_database: Naam van de database (zelfde als de bron).

4. Importeer het SQL bestand in de ServBay doelomgeving:

   # Draai deze op de terminal van de doelomgeving
   mysql -u your_target_username -p your_database < /path/to/your_database.sql

   • /path/to/your_database.sql: Vervang door het pad naar het SQL bestand in de doelomgeving.

Migratie van MariaDB

MariaDB migreren volgt exact dezelfde stappen als MySQL, omdat ze hetzelfde formaat en tools gebruiken.

1. Exporteer de database uit de bronomgeving:

   # Op de bronomgeving terminal uitvoeren
   mysqldump -u your_source_username -p your_database > your_database.sql

2. Verplaats het SQL bestand naar de doelomgeving.
3. Maak een nieuwe database aan in ServBay:

   # Op de ServBay doelomgeving terminal uitvoeren
   mysql -u your_target_username -p -e "CREATE DATABASE your_database;"

4. Importeer het SQL bestand in de doelomgeving:

   # Draai dit op de ServBay doelomgeving terminal
   mysql -u your_target_username -p your_database < /path/to/your_database.sql

Migratie van PostgreSQL

PostgreSQL migreren gebeurt met pg_dump en pg_restore. Let erop het juiste socketpad te gebruiken in ServBay.

1. Exporteer de database uit de bronomgeving:

   # Op de bronomgeving terminal uitvoeren
   # Indien bron ServBay is
   pg_dump -h /Applications/ServBay/tmp -U your_source_username -d your_database -F c -b -v -f your_database.dump
   # Pas verbindingsparameters aan als het geen ServBay is

   • your_source_username: Gebruikersnaam van de bron.
   • your_database: Database om te migreren.
   • your_database.dump: Exportbestand.

2. Verplaats het exportbestand naar de ServBay doelomgeving: Gebruik bijvoorbeeld scp om het bestand te kopiëren.

3. Maak een nieuwe database aan in de ServBay doelomgeving:

   # Op de ServBay doelomgeving terminal uitvoeren
   # Maak verbinding met default postgres database en maak aan
   psql -h /Applications/ServBay/tmp -U your_target_username -d postgres -c "CREATE DATABASE your_database;"

   • your_target_username: Gebruikersnaam in ServBay.
   • your_database: Nieuw database.

4. Importeer het databasebestand in de ServBay doelomgeving:

   # Op de ServBay doelomgeving terminal uitvoeren
   pg_restore -h /Applications/ServBay/tmp -U your_target_username -d your_database -v /path/to/your_database.dump

   • /path/to/your_database.dump: Vervang voor het werkelijke bestandspad in de doelomgeving.

Migratie van Redis

Redis migreren is meestal direct het bestand dump.rdb kopiëren.

1. Haal het dump.rdb bestand uit de bronomgeving:

   # Draai dit op de bronomgeving terminal
   # Zorg dat Redis is gestopt, of wacht totdat BGSAVE klaar is
   cp /path/to/source/redis/dump.rdb ./dump.rdb

2. Verplaats dump.rdb naar de ServBay Redis map op de doelomgeving:

   # Op bron of server draaien
   scp ./dump.rdb your_target_server:/Applications/ServBay/db/redis/dump.rdb

   • your_target_server: Adres of hostname van doelserver.
   • Belangrijk: Stop Redis in ServBay vóór het kopiëren naar /Applications/ServBay/db/redis/.

3. Start Redis in de ServBay doelomgeving weer op: Na het opstarten laadt Redis automatisch het nieuwe bestand.

Let op

• Services stoppen: Voordat je direct bestanden kopieert of verplaatst (met name de datafolders van MySQL/MariaDB/PostgreSQL), stop altijd het betrokken databaseservice via de ServBay GUI of CLI. Kopiëren van actieve databestanden kan leiden tot inconsistentie of corruptie. Ook Redis moet gestopt zijn bij herstel via dump.rdb.
• Rechten: Zorg dat de gebruiker die de bestanden kopieert, verplaatst of importeert voldoende rechten heeft op de betreffende directories en files.
• Bestandspaden: Controleer altijd ServBay's installatielocatie (/Applications/ServBay standaard) en de specifieke databasefolders, vooral per databaseversie.
• Gebruikers en rechten: Na migratie, controleer of de databasegebruikers, rechten en configuratie aangepast moeten worden aan de nieuwe situatie.
• ServBay ingebouwde backup: ServBay biedt ook een handige GUI-tool voor backup en herstel, waarmee je settings, websites, databases en SSL-certificaten kunt backuppen. Dit is een goed alternatief of aanvulling op handmatig bestandbeheer.

Samenvatting

Met de gestandaardiseerde bestandsstructuur van ServBay krijgen ontwikkelaars een helder en flexibel fundament voor databasebeheer. Dit document beschrijft in detail waar ServBay MySQL, MariaDB, PostgreSQL en Redis data bewaart en geeft praktische commandline gidsen voor backup, herstel en migratie. Door deze kennis kun je je lokale databases efficiënt en veilig beheren, data beschermen, en projecten flexibel migreren tussen omgevingen. De extra gemaksmogelijkheden zoals de ingebouwde backupfunctie van ServBay verhogen je ontwikkelproductiviteit en databasebeheerskwaliteit aanzienlijk.