MariaDB-database-instellingen configureren in ServBay

ServBay biedt ontwikkelaars een krachtige lokale webontwikkelomgeving, inclusief een geïntegreerde en eenvoudig te beheren MariaDB-database. In dit document wordt uitgelegd hoe je de MariaDB-instellingen in ServBay aanpast, met de nadruk op de aanbevolen methode via de ServBay UI. Ook worden de rol van het configuratiebestand en enkele veelgebruikte opties toegelicht.

Voor wie bedoeld: Webontwikkelaars die ServBay gebruiken voor lokale ontwikkeling, in het bijzonder degenen die het gedrag van de MariaDB-database willen aanpassen.

Overzicht

De configuratie van MariaDB bepaalt hoe de databaseserver zich gedraagt, zoals welke netwerken worden beluisterd, verbindingslimieten, cachegrootte, logbeheer, enzovoorts. In ServBay kun je deze instellingen eenvoudig aanpassen via een grafische gebruikersinterface, zonder direct in lastige configuratiebestanden te hoeven werken. Hoewel configuratiebestanden (zoals my.cnf) de standaardmethode zijn voor MariaDB, raden we in de ServBay-omgeving sterk aan om instellingen altijd via de UI te beheren om stabiliteit en blijvende werking te garanderen.

Afhankelijk van de versie van MariaDB vind je het configuratiebestand doorgaans in de map /Applications/ServBay/etc/mariadb/<versie> binnen de ServBay-installatiemap.

Belangrijk: Geef voorrang aan ServBay UI

Om conflicten en het risico van overschrijvingen te voorkomen, raden we sterk aan de MariaDB-instellingen alleen te wijzigen via de grafische gebruikersinterface van ServBay. ServBay genereert en beheert automatisch de nodige configuratiebestanden volgens jouw UI-instellingen. Handmatige aanpassingen zijn enkel bedoeld voor tijdelijk testen en kunnen op elk moment door de interne logica van ServBay worden overschreven.

Instellingen wijzigen via de ServBay UI (aanbevolen)

ServBay heeft een gebruiksvriendelijke interface waarmee je in een paar klikken de belangrijkste MariaDB-instellingen kunt inzien en aanpassen. Deze aanpak is veilig, en wijzigingen worden direct toegepast zonder dat je handmatig een service hoeft te herstarten.

1. Open het ServBay-beheerpaneel: Start de ServBay-app.

2. Ga naar database-instellingen: Klik links in het menu op Database en kies vervolgens MariaDB.

3. Selecteer de MariaDB-versie: Heb je meerdere MariaDB-versies geïnstalleerd, kies dan de gewenste versie.

4. Pas de configuratie aan: Binnen het MariaDB-configuratiescherm kun je diverse instellingen wijzigen, zoals:

   • Standaard gebruikersnaam en root-wachtwoord: Hier kun je het standaard root-wachtwoord bekijken of (in sommige versies) opnieuw instellen.
   • Luisteradressen (bind-address): Bepaalt op welke netwerkinterfaces MariaDB actief is. Standaard 0.0.0.0 betekent dat het op alle interfaces luistert (lokaal en eventueel extern indien de firewall het toelaat). Je kunt dit beperken tot 127.0.0.1 of localhost voor alleen lokale verbindingen.
   • Poort (port): Stel het TCP-poortnummer in waarop MariaDB luistert. Standaard is dit 3306.
   • Maximaal aantal verbindingen (max_connections): Bepaalt hoeveel clients er tegelijk verbinding mogen maken. Pas dit aan op basis van je applicatiebehoeften en systeemcapaciteit.
   • Maximaal toegestane datapakketgrootte (max_allowed_packet): Limiteert de grootte van een enkel communicatiepakket. Dit beïnvloedt bijvoorbeeld grote SQL-query's, vooral met BLOB-data.
   • Langzame querylog inschakelen (slow_query_log): Activeer het loggen van langzame query’s voor prestatie-analyse.
   • Bestand voor langzame querylog (slow_query_log_file): Specificeer het pad naar het logbestand voor langzame query's (meestal in /Applications/ServBay/logs/mariadb/).
   • Tijdsdrempel voor langzame query’s (long_query_time): Stel een drempel (in seconden) in; query's die langer duren worden in het langzame querylog vastgelegd.
   • Bufferpoolgrootte (innodb_buffer_pool_size): Een van de belangrijkste instellingen van de InnoDB-engine; bepaalt hoeveel cachegeheugen voor tabellen en indexen gebruikt wordt. Hoger betekent betere prestaties maar meer geheugengebruik.
   • Tekenset en collatie (character-set-server, collation-server): De standaard tekenset en sorteerwijze van de server. Dit bepaalt hoe data wordt opgeslagen en vergeleken. utf8mb4 is aanbevolen vanwege brede compatibiliteit (ook met Emoji).

5. Sla de wijzigingen op en pas ze toe: Klik na het aanpassen onderaan op Opslaan. ServBay werkt de configuratie automatisch bij en herlaadt of herstart MariaDB indien nodig, zodat de wijzigingen direct actief zijn.

Afbeelding: MariaDB-instellingen wijzigen via de ServBay UI

Handmatig aanpassen van configuratiebestanden (afgeraden, alleen voor tijdelijk testen)

Hoewel dit wordt afgeraden, helpt kennis over de locatie en structuur van het MariaDB-configuratiebestand bij diepgaand begrip en specifiek voor tijdelijke problemen of testen.

Risico: handmatige wijzigingen worden overschreven

Het handmatig aanpassen van ServBay-beheerde configuratiebestanden (zoals my.cnf) wordt niet aanbevolen. ServBay kan deze bestanden namelijk opnieuw genereren bij het beheren of updaten van de service, waardoor je handmatige wijzigingen verloren gaan. Gebruik de ServBay UI voor blijvende configuraties. Besef dat handmatige aanpassingen tijdelijk zijn en breng waar mogelijk je wijziging onder in de UI-opties voor blijvende werking.

Locatie van het configuratiebestand

Het belangrijkste MariaDB-configuratiebestand in ServBay heet my.cnf. De exacte locatie hangt af van welke versie je gebruikt.

• Hoofdconfiguratiebestand: /Applications/ServBay/etc/mariadb/<versie>/my.cnf

Voor bijvoorbeeld MariaDB versie 11.5 is het pad /Applications/ServBay/etc/mariadb/11.5/my.cnf.

Structuur en gangbare opties in het bestand my.cnf

my.cnf is een tekstbestand in INI-formaat, met opties gegroepeerd onder verschillende [sections]. De belangrijkste voor de serverconfiguratie is [mysqld].

Een paar veelgebruikte opties (zoals je ze ook in de UI kunt aanpassen):

1. Luisteradres aanpassen (bind-address)

   [mysqld]
   bind-address = 0.0.0.0

   Instellen op 0.0.0.0 staat verbindingen vanaf elk netwerk toe. Alleen 127.0.0.1 of localhost beperkt tot lokale verbindingen.

2. Poortnummer aanpassen (port)

   [mysqld]
   port = 3306

   TCP-poort waarop MariaDB luistert.

3. Maximaal aantal verbindingen aanpassen (max_connections)

   [mysqld]
   max_connections = 200

   Maximale hoeveelheid gelijktijdige client-verbindingen.

4. Bufferpool van InnoDB aanpassen (innodb_buffer_pool_size)

   [mysqld]
   innodb_buffer_pool_size = 256M

   Grootte van het geheugen voor caching van tabellen en indexen door InnoDB. Gebruik K, M, G voor eenheid.

5. Foutlogbestand aanpassen (log_error)

   [mysqld]
   log_error = /Applications/ServBay/logs/mariadb/error.log

   Locatie van het MariaDB-foutlogbestand.

6. Langzame querylog inschakelen (slow_query_log, slow_query_log_file, long_query_time)

   [mysqld]
   slow_query_log = 1
   slow_query_log_file = /Applications/ServBay/logs/mariadb/slow.log
   long_query_time = 2  # In seconden, logt query's die langer dan 2 seconden duren

   slow_query_log = 1 activeert loggen van langzame queries, slow_query_log_file geeft het pad voor het logbestand, long_query_time bepaalt de drempel.

7. Standaard tekenset en collatie aanpassen (character-set-server, collation-server)

   [mysqld]
   character-set-server = utf8mb4
   collation-server = utf8mb4_unicode_ci

   Default tekenset en sorteervolgorde van de server.

Wijzigingen toepassen: MariaDB-service herstarten

Of je nu via ServBay UI opslaat of tijdelijk handmatig het configuratiebestand bewerkt (wat wordt afgeraden), doorgaans is een herstart van MariaDB nodig om alle nieuwe instellingen van kracht te laten gaan. ServBay biedt daarvoor twee gemakkelijke methoden.

Herstarten via het ServBay-beheerpaneel

De eenvoudigste manier:

1. Open het ServBay-beheerpaneel.
2. Klik in het linkermenu op Pakketten (op oudere versies heet dit mogelijk Services).
3. Zoek het juiste MariaDB-pakket.
4. Klik op de knop Herstart (of Restart) naast het pakket.

Herstarten via de servbayctl commandlinetool

servbayctl is een commandlinetool die ServBay meelevert voor het beheer van pakketten en services.

Open Terminal en voer het volgende commando uit om een specifieke MariaDB-versie te herstarten:

servbayctl restart mariadb <versie>

Vervang <versie> door het versienummer van jouw MariaDB, bijvoorbeeld 11.5.

# Voorbeeld: MariaDB 11.5 herstarten
servbayctl restart mariadb 11.5

Veelgestelde vragen (FAQ)

Vraag: Waarom adviseren jullie om MariaDB-configuraties via de UI te wijzigen en niet handmatig in my.cnf?

Antwoord: ServBay is een geïntegreerde lokale ontwikkelomgeving. De UI abstraheert en beheert de onderliggende configuratie van pakketten. Als je via de UI aanpassingen maakt en opslaat, genereert of werkt ServBay automatisch de benodigde configuratiebestanden bij. Als je handmatig my.cnf bewerkt, kan ServBay dit bestand bij een volgende actie (zoals upgraden, herstarten of bij nieuwe UI-wijzigingen) overschrijven aangevuld met de UI-instellingen. Door de UI te gebruiken, ben je verzekerd van blijvende instellingen en consistentie binnen de ServBay-omgeving.

Vraag: Kan ik via ServBay UI echt álle MariaDB-instellingen wijzigen?

Antwoord: De ServBay UI biedt de meest gangbare en belangrijke ontwikkelaarsinstellingen. Sommige zeer specifieke of geavanceerde opties moeten mogelijk toch tijdelijk handmatig in het configuratiebestand toegevoegd worden. In zulke gevallen: wees je bewust dat deze handmatige aanpassing tijdelijk is en kijk of je het via een UI-optie zoals “extra configuratie” toch kunt toevoegen.

Vraag: Waar vind ik het errorlog en slow query log van MariaDB in ServBay?

Antwoord: Volgens de standaard ServBay-structuur vind je de logbestanden meestal in /Applications/ServBay/logs/mariadb/ binnen de installatiemap. Het precieze pad vind je via de ServBay UI of direct in my.cnf.

Samenvatting

De aanbevolen en veiligste manier om MariaDB-instellingen in ServBay te beheren is via de grafische gebruikersinterface. Je kunt eenvoudig sleutelinstellingen zoals luisteradres, poort, max. verbindingen, logs enzovoorts aanpassen en alle wijzigingen worden automatisch en blijvend beheerd door ServBay. Rechtstreekse handmatige wijzigingen in het onderliggende my.cnf-bestand (op /Applications/ServBay/etc/mariadb/<versie>/my.cnf) lopen het risico te worden overschreven en zijn alleen aangeraden voor tijdelijke tests. Na wijzigingen kan MariaDB simpel worden herstart via de UI of de servbayctl-commandlinetool om je aanpassingen te activeren. Door deze configuratieopties goed te begrijpen, kun je de prestaties en het gedrag van MariaDB in je lokale ontwikkelomgeving optimaliseren.