MySQL-database-instellingen configureren en optimaliseren in ServBay

ServBay wordt standaard geleverd met een MySQL-database en biedt flexibele configuratiemogelijkheden waarmee ontwikkelaars de instellingen kunnen aanpassen aan de behoeften van hun project. Dit artikel legt uit hoe je de MySQL-instellingen binnen ServBay wijzigt, inclusief de aanbevolen methode via de UI, de locatie van configuratiebestanden, en veelvoorkomende configuratieopties.

Afhankelijk van de geïnstalleerde MySQL-versie zijn de relevante configuratie- en databestanden gelegen in specifieke submappen van de ServBay-installatiemap (standaard /Applications/ServBay).

Belangrijke Opmerking

ServBay beheert de meeste softwarepakketten en services via de grafische gebruikersinterface (UI). Wij raden sterk aan om configuratieaanpassingen uit te voeren via de UI van ServBay. ServBay genereert en beheert configuratiebestanden automatisch. Handmatige aanpassingen kunnen worden overschreven bij een update of herstart van ServBay, waardoor je wijzigingen verloren gaan. Handmatig aanpassen is alleen geschikt voor tijdelijke tests of debugging.

Aanpassen via de ServBay UI (Aanbevolen)

ServBay biedt een krachtige grafische beheertool waarmee ontwikkelaars eenvoudig configuratieparameters kunnen aanpassen. Via de UI worden wijzigingen direct toegepast en geactiveerd na opslaan, waardoor het proces eenvoudig en foutgevoeligheid van handmatig bewerken wordt voorkomen.

Om MySQL-instellingen aan te passen, open je de ServBay-app, ga je via de navigatiebalk links naar Databases -> MySQL, en selecteer je de gewenste MySQL-versie.

In de grafische editor kun je diverse belangrijke instellingen bekijken en wijzigen:

• Standaard gebruikersnaam en wachtwoord: Bekijk de standaard MySQL-gebruikersnaam die door ServBay is ingesteld (meestal root), evenals het wachtwoord.
• Luisteradres (bind-address) en poort (port): Standaard is dit 0.0.0.0:3306, wat betekent dat MySQL luistert op alle netwerkinterfaces op poort 3306. Je kunt het luisteradres aanpassen (bijvoorbeeld 127.0.0.1 om alleen lokale toegang toe te staan) of het poortnummer wijzigen om conflicten te vermijden met andere diensten.
• Slow Query Log (slow query log): Hiermee kun je eenvoudig het registeren van trage query’s inschakelen om inefficiënte SQL-query’s op te sporen.
• Aantal gelijktijdige verbindingen (max_connections): Pas het maximum aantal gelijktijdige databaseverbindingen aan.
• Maximale toegestane pakketgrootte (max_allowed_packet): Stel de maximale grootte van ontvangen datapakketten in, wat invloed heeft op de grootte van te verwerken SQL-statements of rijen.
• Overige veelgebruikte instellingen: De UI biedt doorgaans toegang tot enkele andere gangbare parameters die je kunt afstellen.

Sla je wijzigingen op door onderaan op de Opslaan-knop te klikken. ServBay past deze automatisch toe en herstart de MySQL-service indien nodig.

Referentie: MySQL-configuratiebestand handmatig bewerken (Niet aanbevolen)

Hoewel het niet wordt aanbevolen, is het soms nuttig om te weten waar de MySQL-configuratiebestanden van ServBay zich bevinden, bijvoorbeeld voor geavanceerde debugging of tijdelijke aanpassingen.

WARNING

Nogmaals: Handmatig bewerken van ServBay’s automatisch gegenereerde configuratiebestanden is niet aanbevolen. De UI of toekomstige updates kunnen je handmatige wijzigingen overschrijven. Gebruik de grafische interface voor blijvende aanpassingen. Handmatig aanpassen is alleen geschikt voor tijdelijke oplossingen.

Overzicht

Binnen ServBay worden MySQL-configuratiebestanden per versie georganiseerd. Deze bevinden zich in specifieke paden onder de ServBay-installatiemap.

Locatie van het configuratiebestand

Het belangrijkste MySQL-configuratiebestand my.cnf bevindt zich op:

• my.cnf: /Applications/ServBay/etc/mysql/<version>/my.cnf

Hierbij is <version> het nummer van de geïnstalleerde MySQL-versie, bijvoorbeeld 8.0 of 9.0.

my.cnf

my.cnf is het belangrijkste configuratiebestand van de MySQL-server en bevat parameters die het gedrag van de database bepalen.

Voorbeelden van veelvoorkomende instellingen

Onderstaand vind je veelgebruikte my.cnf-instellingen met korte toelichting. Deze voorbeelden zijn ter illustratie – wees voorzichtig met handmatige edits!

1. Luisteradres wijzigen (bind-address): Bepaalt op welke netwerkinterface MySQL luistert. 0.0.0.0 betekent alle interfaces, 127.0.0.1 alleen lokaal.

   [mysqld]
   bind-address = 0.0.0.0

2. Poortnummer aanpassen (port): De netwerkpoort waar MySQL op luistert, standaard 3306.

   [mysqld]
   port = 3306

3. Maximaal aantal connecties wijzigen (max_connections): Stelt het maximum aantal gelijktijdige clientverbindingen in. Pas dit aan naar gelang de belasting.

   [mysqld]
   max_connections = 200

4. InnoDB Buffer Pool Size instellen (innodb_buffer_pool_size): Het geheugen dat door de InnoDB-engine wordt gebruikt voor data en indexen. Belangrijk voor prestaties; vaak 50%-70% van het beschikbare geheugen.

   [mysqld]
   innodb_buffer_pool_size = 256M

5. Pad naar errorlog aanpassen (log_error): Specificeert waar het MySQL-foutlogbestand wordt opgeslagen.

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

6. Slow Query Log inschakelen (slow_query_log): Schakelt registratie van langzame queries in; queries langer dan long_query_time gaan naar het log.

   [mysqld]
   slow_query_log = 1
   slow_query_log_file = /Applications/ServBay/logs/mysql/slow.log
   long_query_time = 2  # In seconden: log queries langer dan 2 seconden

7. Standaardtekenset en sortering (character-set-server, collation-server): Bepaalt de standaard tekenset en collatie van de server, van invloed op databases, tabellen en kolommen. utf8mb4 wordt aanbevolen voor volledige Unicode-ondersteuning (inclusief emoji's).

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

Actie na handmatige wijziging

Voer je een handmatige aanpassing uit (alleen aanbevolen voor tijdelijke tests), dan moet je de MySQL-service herstarten om wijzigingen toe te passen.

MySQL-service herstarten

Na aanpassingen van de MySQL-instellingen (UI of handmatig) is het doorgaans nodig MySQL te herstarten ter activering.

Herstarten via het ServBay-beheerportal

1. Open de ServBay beheertool.
2. Selecteer Pakketten in het menu links.
3. Zoek de MySQL-versie die je wilt herstarten en klik op de Herstarten-knop ernaast.

Herstarten via het servbayctl CLI-hulpmiddel

Het is ook mogelijk om MySQL te herstarten via de command line-tool servbayctl.

Open Terminal en voer het volgende uit (vervang 9.0 door het in gebruik zijnde MySQL-versienummer):

servbayctl restart mysql 9.0

Veelgestelde vragen (FAQ)

• Vraag: Ik heb my.cnf handmatig aangepast, maar mijn wijzigingen lijken niet actief te zijn. Hoe kan dat?

  Antwoord: Controleer of je MySQL-service herstart hebt na je wijziging. Let er ook op dat als ServBay UI actief is of interne beheeracties uitvoert, je handmatige wijzigingen overschreven kunnen worden door automatisch gegenereerde configuratie. Wij raden aan de UI te gebruiken voor alle configuraties.

• Vraag: Na een wijziging start MySQL niet meer op. Wat moet ik doen?

  Antwoord: Vaak komt dit door een fout in het configuratiebestand. Controleer je wijzigingen in my.cnf op fouten. Raadpleeg het MySQL-foutenlog (/Applications/ServBay/logs/mysql/error.log, pad kan per versie variëren) voor diagnose. Indien je het probleem niet kan oplossen, verwijder je handmatige wijzigingen, herstel de ServBay UI-instellingen en doe alleen aanpassingen via de UI.

• Vraag: Ik ben het root-wachtwoord van MySQL in ServBay kwijt. Hoe herstel ik dat?

  Antwoord: In de MySQL-configuratiepagina van de ServBay UI kun je het huidige standaard root-wachtwoord inzien. Wil je het resetten, dan bieden recente ServBay-versies via de UI de mogelijkheid om het root-wachtwoord van de database (MySQL, MariaDB, PostgreSQL) opnieuw in te stellen. Raadpleeg de ServBay-documentatie over databasetoegangsbeheer voor stapsgewijze instructies.

Samenvatting

Het configureren van MySQL-database-instellingen in ServBay is zeer flexibel. De aanbevolen methode is via de grafische interface — dit verzekert persistente en correcte instellingen. Hoewel je voor detailinzage /Applications/ServBay/etc/mysql/<version>/my.cnf kunt raadplegen, wordt handmatige bewerking niet aanbevolen voor langdurige configuraties. Ongeacht de methode is een herstart van de MySQL-service gewoonlijk vereist na wijzigingen. Door deze opties goed te begrijpen, kun je je lokale databaseprestaties onder ServBay optimaal afstellen.