ServBay Gids voor Databasebestandsbeheer en Migratie

ServBay is een krachtig lokaal webontwikkelplatform dat diverse veelgebruikte databasemanagementsystemen integreert en de opslag van databasebestanden op een gestandaardiseerde manier beheert. Inzicht in de standaard bestandsstructuur van ServBay is essentieel voor ontwikkelaars bij het veilig maken van back-ups, het herstellen of migreren van hun data.

Dit artikel geeft een compleet overzicht van de standaardlocatie van databestanden binnen ServBay en biedt praktische instructies voor het beheer en de migratie van databasebestanden tussen verschillende omgevingen, met gebruik van standaard commandoregeltools.

TIP

ServBay biedt ingebouwde functies voor het automatisch of handmatig back-uppen en herstellen van MySQL-, MariaDB- en PostgreSQL-databases. Meer informatie vind je bij Back-up & Herstel.

Standaardstructuur voor databasebestanden in ServBay

Om het beheer eenvoudiger te maken en verschillende databaseversies gescheiden te houden, worden alle databasebestanden in ServBay centraal opgeslagen onder /Applications/ServBay/db. In deze directory wordt eerst op databastype geselecteerd, en daarbinnen verder onderverdeeld per hoofdversie van de betreffende database.

Hier volgt een voorbeeld van de typische structuur van de map /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 bij de mapstructuur

• /Applications/ServBay/db: De hoofdmap waarin ServBay alle databasebestanden opslaat.
• mysql: Hierin staan de data van MySQL-databases, geordend naar hoofdversies (zoals 8.0, 8.1).
• mariadb: Bevat data van MariaDB-databases, gesorteerd per hoofdversie (zoals 10.11, 11.3).
• postgresql: Opslag voor PostgreSQL-databases, per hoofdversie (zoals 15, 16).
• redis: Opslagplek voor Redis-bestanden, meestal de dump.rdb persistentiebestand.

Deze structuur maakt het mogelijk om meerdere hoofdversies van dezelfde database gelijktijdig te installeren en gebruiken zonder dat de bestanden elkaar beïnvloeden.

Databasebestanden beheren

Tijdens lokale ontwikkeling is het regelmatig nodig een database te back-uppen, te herstellen of te migreren. Hieronder vind je per database de gebruikelijke manier, gebruikmakend van de standaard commandoregeltools. Let op: deze acties voer je idealiter uit in de terminal van ServBay of nadat de juiste omgevingsvariabelen (zoals PATH) zijn ingesteld zodat je de ServBay database cliënten direct kunt aanroepen.

Database back-uppen

Regelmatige back-ups zijn cruciaal om dataverlies te voorkomen. Hieronder staat per type database hoe je deze in ServBay kunt back-uppen.

MySQL back-up maken

Gebruik het mysqldump-hulpmiddel om een MySQL-database te exporteren.

# Schakel over naar de ServBay-terminal of zet het ServBay bin-pad in je PATH
# Bijvoorbeeld: export PATH="/Applications/ServBay/bin:$PATH"

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

• your_username: Vervang dit door jouw databasegebruikersnaam.
• your_database: Vervang dit door de naam van de te back-uppen database.
• /Applications/ServBay/backup/your_database.sql: Pas dit aan naar de gewenste locaties en naam van het back-upbestand. Het is aan te raden deze buiten de ServBay-map te bewaren, bijvoorbeeld in je eigen gebruikersmap.

MariaDB back-up maken

Voor MariaDB is de werkwijze identiek; maak gebruik van de mysqldump tool.

# Schakel over naar de ServBay-terminal of zet het ServBay bin-pad in je PATH

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

• Parameters zijn gelijk aan bovenstaand.

PostgreSQL back-up maken

Gebruik pg_dump om een back-up van je PostgreSQL-database te maken. In ServBay wordt standaard verbinding gemaakt via het Unix Domain Socket op /Applications/ServBay/tmp.

# Schakel over naar de ServBay-terminal of zet het ServBay bin-pad in je PATH

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: Geeft de locatie van het socketbestand voor PostgreSQL aan.
• -U your_username: Vervang dit door jouw databasegebruikersnaam.
• -d your_database: Vervang dit door de naam van de database.
• -F c: Export in custom archive formaat (aanbevolen).
• -b: Inclusief grote objecten (blobs).
• -v: Uitgebreide uitvoer.
• -f /Applications/ServBay/backup/your_database.dump: Aanpassen naar het gewenste exportpad en -naam.

Redis back-up maken

Voor Redis maak je meestal een back-up van het persistentiebestand dump.rdb.

# Schakel over naar de ServBay-terminal
# Zorg dat de Redis-service draait of dat BGSAVE is geconfigureerd

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

• /Applications/ServBay/db/redis/dump.rdb: De standaardlocatie van het Redis-bestand.
• /Applications/ServBay/backup/dump.rdb: Pas deze aan naar jouw gewenste bewaarplek.

Database herstellen

In geval van dataverlies of wens tot rollback kun je met een back-upbestand de database herstellen.

MySQL herstel

Gebruik de mysql-client om back-ups terug te zetten.

# Schakel over naar de ServBay-terminal

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

• your_username: Jouw databasegebruikersnaam.
• your_database: Doeldatabase, deze moet meestal al aangemaakt zijn.
• /Applications/ServBay/backup/your_database.sql: Pad naar het back-upbestand.

MariaDB herstel

Dit verloopt op precies dezelfde manier als bij MySQL, ook hier gebruik je de mysql-client.

# Schakel over naar de ServBay-terminal

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

• Parameters zijn gelijk aan bovenstaand.

PostgreSQL herstel

Gebruik pg_restore om een PostgreSQL-database te herstellen (custom formaat). Vergeet niet het socketpad te specificeren.

# Schakel over naar de 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: Socketbestandlocatie voor PostgreSQL.
• -U your_username: Jouw databasegebruikersnaam.
• -d your_database: Naam van de te herstellen database (moet meestal vooraf zijn aangemaakt).
• -v: Uitgebreide uitvoer.
• /Applications/ServBay/backup/your_database.dump: Pad naar het back-upbestand.

Redis herstel

Herstellen van Redis houdt meestal in dat je het back-upbestand dump.rdb terugplaatst naar de Redis-datamap. Let op: Stop eerst de Redis-service voor je overschrijft!

# Schakel over naar de ServBay-terminal
# Stop de Redis-service in ServBay
# Kopieer het back-upbestand
cp /Applications/ServBay/backup/dump.rdb /Applications/ServBay/db/redis/dump.rdb
# Start de Redis-service in ServBay weer op

• /Applications/ServBay/backup/dump.rdb: Back-upbestandlocatie.
• /Applications/ServBay/db/redis/dump.rdb: Standaardlocatie van Redis persistentiebestand.

Database migreren

Migratie betekent het verplaatsen van een database van de ene (lokale of externe) omgeving naar een andere. Dit gebeurt meestal door eerst een export te maken en vervolgens weer te importeren in de nieuwe omgeving.

MySQL migreren

MySQL migreren komt vaak voor tijdens ontwikkelwerk.

1. Exporteer de database vanuit de bronomgeving:

   # Uitvoeren in de terminal van de bronserver
   mysqldump -u your_source_username -p your_database > your_database.sql

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

2. Transfer het exportbestand naar de doellocatie: Gebruik scp of een ander hulpmiddel om your_database.sql over te zetten naar bijvoorbeeld /Applications/ServBay/backup/ op het doelsysteem.

3. Maak de database aan in de doelomgeving:

   # Uitvoeren in de ServBay-terminal van de doelomgeving
   mysql -u your_target_username -p -e "CREATE DATABASE your_database;"

   • your_target_username: Doelgebruikersnaam.
   • your_database: Databasenaam (gelijk aan het origineel).

4. Importeer de data in ServBay:

   # Uitvoeren op de doelomgeving
   mysql -u your_target_username -p your_database < /path/to/your_database.sql

   • /path/to/your_database.sql: Werkelijk pad naar het SQL-bestand op je doelsysteem.

MariaDB migreren

MariaDB migreren werkt identiek aan MySQL vanwege dezelfde toolset en bestandsopzet:

1. Database exporteren op de bronserver:

   # Op de bronserver
   mysqldump -u your_source_username -p your_database > your_database.sql

2. Exporteer het SQL-bestand naar de doelserver.
3. Maak de database aan op de doelomgeving:

   # Op ServBay
   mysql -u your_target_username -p -e "CREATE DATABASE your_database;"

4. Importeer het SQL-bestand:

   # Op ServBay
   mysql -u your_target_username -p your_database < /path/to/your_database.sql

PostgreSQL migreren

PostgreSQL migreren doe je met pg_dump en pg_restore, let wederom op het juiste socketpad.

1. Database exporteren in de bronomgeving:

   # Op de bronserver (ServBay)
   pg_dump -h /Applications/ServBay/tmp -U your_source_username -d your_database -F c -b -v -f your_database.dump
   # Gebruik bij een andere omgeving de daar geldende verbindingsparameters

   • your_source_username: Bron gebruikersnaam.
   • your_database: Te migreren database.
   • your_database.dump: Exportbestand.

2. Zet het dumpbestand over naar de doelomgeving.

3. Database aanmaken op de doelserver:

   # In ServBay-terminal van de doelserver
   # Verbind met de standaard 'postgres' database om een nieuwe database aan te maken
   psql -h /Applications/ServBay/tmp -U your_target_username -d postgres -c "CREATE DATABASE your_database;"

   • your_target_username: Doelgebruikersnaam.
   • your_database: Aan te maken database.

4. Importeer het dumpbestand:

   # In ServBay-terminal van de doelserver
   pg_restore -h /Applications/ServBay/tmp -U your_target_username -d your_database -v /path/to/your_database.dump

   • /path/to/your_database.dump: Pad naar het dumpbestand op de doelserver.

Redis migreren

Een Redis-migratie bestaat meestal uit het verplaatsen van het bestand dump.rdb.

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

   # Op de bronserver
   # Stop Redis of wacht tot BGSAVE voltooid is
   cp /path/to/source/redis/dump.rdb ./dump.rdb

2. Transfer het bestand naar de Redis-map op de doelserver:

   # Op bronserver of via tussenstap
   scp ./dump.rdb your_target_server:/Applications/ServBay/db/redis/dump.rdb

   • your_target_server: Doelserveradres of hostnaam.
   • Let op: Stop altijd eerst de Redis-service op de doelserver voordat je het bestand overschrijft.

3. Start Redis opnieuw op de doelomgeving: Na het starten wordt het nieuwe dump.rdb bestand automatisch geladen.

Belangrijke aandachtspunten

• Stop de service: Stop alle betreffende database services (zoals MySQL/MariaDB/PostgreSQL) via de ServBay GUI of CLI vóórdat je bestanden direct kopieert of verplaatst. Bestanden kopiëren terwijl de databases actief zijn kan leiden tot datacorruptie. Ook bij het herstellen van Redis via dump.rdb moet de service altijd vooraf gestopt worden.
• Bestandsrechten: Zorg ervoor dat de gebruiker die de actie uitvoert, de juiste rechten heeft voor de betreffende mappen en bestanden.
• Bestandspaden: Controleer altijd het exacte ServBay-installatiepad (standaard /Applications/ServBay) en de locatienamen van de databasebestanden, vooral als je werkt met verschillende versies.
• Gebruikers en rechten: Controleer na migratie of gebruikers, rechten en configuratiebestanden nog correct zijn en aangepast moeten worden voor de nieuwe omgeving.
• ServBay-back-up: ServBay heeft ook een geïntegreerd back-up- en herstelmechanisme via de GUI, waarmee je eenvoudig instellingen, websitemappen, databases en SSL-certificaten kunt back-uppen. Dit is een waardevolle aanvulling of alternatief voor handmatig bestandsbeheer.

Samenvatting

ServBay biedt een gestandaardiseerde en overzichtelijke structuur voor databasebestanden, waardoor ontwikkelaars efficiënt hun data kunnen beheren. In deze gids zijn de opslaglocaties voor MySQL, MariaDB, PostgreSQL en Redis binnen ServBay tot in detail besproken, evenals praktische voorbeelden voor het back-uppen, herstellen en migreren van databases met behulp van commandoregeltools. Door deze technieken te beheersen kun je veilig en flexibel werken in je lokale ontwikkelomgeving en projecten eenvoudig tussen verschillende installaties migreren. Maak zeker ook gebruik van de ingebouwde ServBay-functionaliteiten voor extra efficiëntie en betrouwbaarheid in je databasebeheer!