mariadbd-multi(1)

mariadbd-multi(1)

NAMN

mariadbd-multi – hantera flera MariaDB-servrar (mariadbd-multi är nu en symbolisk länk till mariadbd-multi)

SYNOPSIS

mariadbd-multi [alternativ] {start|stop|report} [GNR[,GNR] ...]

BESKRIVNING

mariadbd-multi är utformat för att hantera flera mariadbd-processer som lyssnar efter anslutningar på olika Unix-socketfiler och TCP/IP-portar. Det kan starta eller stoppa servrar, eller rapportera deras aktuella status.

mariadbd-multi söker efter grupper med namn som [mariadbdN] i my.cnf (eller i filen som anges med alternativet --config-file). N kan vara vilket positivt heltal som helst. Detta nummer kallas i följande beskrivning för alternativgruppnummer, eller GNR. Gruppnummer skiljer alternativgrupper från varandra och används som argument till mariadbd-multi för att ange vilka servrar du vill starta, stoppa eller få en statusrapport för. Alternativen som listas i dessa grupper är desamma som du skulle använda i gruppen [mariadbd] för att starta mariadbd. När flera servrar används måste dock varje server ha egna värden för alternativ som Unix-socketfil och TCP/IP-portnummer.

För att köra mariadbd-multi, använd följande syntax:

shell> mariadbd-multi [alternativ] {start|stop|report} [GNR[,GNR] ...]

start, stop och report anger vilken operation som ska utföras. Du kan utföra den angivna operationen för en enskild server eller flera servrar, beroende på GNR-listan som följer efter operationsnamnet. Om det inte finns någon lista utför mariadbd-multi operationen för alla servrar i alternativfilen.

Varje GNR-värde representerar ett alternativgruppnummer eller ett intervall av gruppnummer. Värdet ska vara numret i slutet av gruppnamnet i alternativfilen. Till exempel är GNR för en grupp med namnet [mariadbd17] lika med 17. För att ange ett intervall av nummer, separera första och sista numret med ett bindestreck. GNR-värdet 10-13 representerar grupperna [mariadbd10] till [mariadbd13]. Flera grupper eller gruppintervall kan anges på kommandoraden, separerade med kommatecken. Det får inte finnas några blanktecken (mellanslag eller tabbar) i GNR-listan; allt efter ett blanktecken ignoreras.

Detta kommando startar en enskild server med alternativgruppen [mariadbd17]:

shell> mariadbd-multi start 17

Detta kommando stoppar flera servrar med alternativgrupperna [mariadbd8] och [mariadbd10] till [mariadbd13]:

shell> mariadbd-multi stop 8,10-13

För ett exempel på hur du kan konfigurera en alternativfil, använd detta kommando:

shell> mariadbd-multi --example

mariadbd-multi söker efter alternativfiler enligt följande:

• Med --no-defaults läses inga alternativfiler.
• Med --defaults-file=file_name läses endast den angivna filen.
• Annars läses alternativfiler på standardplatserna, inklusive eventuell fil som anges med alternativet --defaults-extra-file=file_name, om ett sådant anges. (Om alternativet anges flera gånger används det sista värdet.)

Alternativfiler som läses söks igenom efter grupperna [mariadbd-multi] och [mariadbdN]. Gruppen [mariadbd-multi] kan användas för alternativ till själva mariadbd-multi. Grupperna [mariadbdN] kan användas för alternativ som skickas till specifika instanser av mariadbd.

Grupperna [mariadbd] eller [mariadbd_safe] kan användas för gemensamma alternativ som läses av alla instanser av mariadbd eller mariadbd_safe. Du kan ange ett alternativ --defaults-file=file_name för att använda en annan konfigurationsfil för den instansen; i så fall används grupperna [mariadbd] eller [mariadbd_safe] från den filen för den instansen.

mariadbd-multi stöder följande alternativ.

--help

Visa ett hjälpmeddelande och avsluta.

--example

Visa en exempelkonfigurationsfil.

--log=file_name

Ange namnet på loggfilen. Om filen finns, läggs loggutdata till i slutet av den.

--mariadb-admin=prog_name

Binären mariadb-admin som ska användas för att stoppa servrar.

--mariadbd=prog_name

Binären mariadbd som ska användas. Observera att du också kan ange mariadbd_safe som värde för detta alternativ. Om du använder mariadbd_safe för att starta servern, kan du inkludera alternativen mariadbd eller ledir i motsvarande alternativgrupp [mariadbdN]. Dessa alternativ anger namnet på servern som mariadbd_safe ska starta och sökvägen till katalogen där servern finns. (Se beskrivningarna av dessa alternativ i mariadbd_safe(1).) Exempel:

[mariadbd38]
mariadbd = mariadbd-debug
ledir  = /opt/local/mysql/libexec

--no-log

Skriv loginformation till standardutmatning i stället för till loggfilen. Som standard går utdata till loggfilen.

--password=password

Lösenordet för MariaDB-kontot som ska användas när mariadb-admin körs. Observera att lösenordsvärdet inte är valfritt för detta alternativ, till skillnad från andra MariaDB-program.

--silent

Tyst läge; inaktivera varningar.

--tcp-ip

Anslut till MariaDB-servern/-servrarna via TCP/IP-porten i stället för Unix-socketen. Detta påverkar stopp och rapportering. Om en socketfil saknas kan servern fortfarande köra men bara vara åtkomlig via TCP/IP-porten. Som standard sker anslutning via Unix-socketen. Detta alternativ påverkar stop- och report-operationerna.

--user=user_name

Användarnamnet för MariaDB-kontot som ska användas när mariadb-admin körs.

--verbose

Var mer utförlig.

--version

Visa versionsinformation och avsluta.

--wsrep-new-cluster

Bootstrapa ett kluster.

Några kommentarer om mariadbd-multi:

• Viktigast av allt: Innan du använder mariadbd-multi, se till att du förstår betydelsen av de alternativ som skickas till mariadbd-servrarna och varför du vill ha separata mariadbd-processer. Var uppmärksam på riskerna med att använda flera mariadbd-servrar med samma datakatalog. Använd separata datakataloger, om du inte vet vad du gör. Att starta flera servrar med samma datakatalog ger dig inte extra prestanda i ett trådat system.

• Viktigt: Se till att datakatalogen för varje server är fullt åtkomlig för det Unix-konto som den specifika mariadbd-processen startas som. Använd inte Unix-kontot root för detta, om du inte vet vad du gör.

• Se till att MariaDB-kontot som används för att stoppa mariadbd-servrarna (med programmet mariadbadmin) har samma användarnamn och lösenord för varje server. Se också till att kontot har privilegiet SHUTDOWN. Om servrarna som du vill hantera har olika användarnamn eller lösenord för administrationskontona kan du vilja skapa ett konto på varje server som har samma användarnamn och lösenord. Du kan till exempel skapa ett gemensamt konto multi_admin genom att köra följande kommandon för varje server:

shell> mariadb -u root -S /tmp/mariadb.sock -p
Enter password:
mariadb> GRANT SHUTDOWN ON *.*
    -> TO 'multi_admin'@'localhost' IDENTIFIED BY 'multipass';

Ändra anslutningsparametrarna på lämpligt sätt när du ansluter till varje server. Observera att värdnamnsdelen i kontonamnet måste tillåta att du ansluter som multi_admin från värden där du vill köra mariadbd-multi.

• Unix-socketfilen och TCP/IP-portnumret måste vara olika för varje mariadbd. (Alternativt, om värden har flera nätverksadresser, kan du använda --bind-address för att få olika servrar att lyssna på olika gränssnitt.)

• Alternativet --pid-file är mycket viktigt om du använder mariadbd-safe för att starta mariadbd (till exempel --mariadbd=mariadbd-safe). Varje mariadbd bör ha sin egen process-ID-fil. Fördelen med att använda mariadbd-safe i stället för mariadbd är att mariadbd-safe övervakar sin mariadbd-process och startar om den om processen avslutas på grund av en signal skickad med kill -9 eller av andra skäl, till exempel en segmenteringskrasch. Observera att skriptet mariadbd-safe kan kräva att du startar det från en viss plats. Det kan innebära att du måste byta till en viss katalog innan du kör mariadbd-multi. Om du har problem att starta, se skriptet mariadbd-safe. Kontrollera särskilt raderna:

----------------------------------------------------------------
MY_PWD=`pwd`
# Check if we are starting this relative (for the binary release)
if test -d $MY_PWD/data/mariadb -a \
   -f ./share/mariadb/english/errmsg.sys -a \
   -x ./bin/mariadbd
----------------------------------------------------------------

Testet som utförs av dessa rader bör lyckas, annars kan du stöta på problem. Se mariadbd-safe(1).

• Du kanske vill använda alternativet --user för mariadbd, men för att göra detta måste du köra skriptet mariadbd-multi som Unix-användaren root. Att ha alternativet i alternativfilen spelar ingen roll; du får bara en varning om du inte är superanvändare och mariadbd-processerna startas under ditt eget Unix-konto.

Följande exempel visar hur du kan sätta upp en alternativfil för användning med mariadbd-multi. Ordningen som mariadbd-programmen startas eller stoppas i beror på ordningen de förekommer i alternativfilen. Gruppnummer behöver inte bilda en obruten sekvens. Den första och femte [mariadbdN]-gruppen utelämnades avsiktligt i exemplet för att illustrera att du kan ha ”luckor” i alternativfilen. Detta ger dig större flexibilitet.

# This file should probably be in your home dir (~/.my.cnf)
# or /etc/my.cnf
# Version 2.1 by Jani Tolonen
[mariadbd-multi]
mariadbd     = /usr/local/bin/mariadbd-safe
mariadb-admin = /usr/local/bin/mariadb-admin
user       = multi_admin
password   = multipass
[mariadbd2]
socket     = /tmp/mariadb.sock2
port       = 3307
pid-file   = /usr/local/mysql/var2/hostname.pid2
datadir    = /usr/local/mysql/var2
language   = /usr/local/share/mariadb/english
user       = john
[mariadbd3]
socket     = /tmp/mysql.sock3
port       = 3308
pid-file   = /usr/local/mysql/var3/hostname.pid3
datadir    = /usr/local/mysql/var3
language   = /usr/local/share/mariadb/swedish
user       = monty
[mariadbd4]
socket     = /tmp/mysql.sock4
port       = 3309
pid-file   = /usr/local/mysql/var4/hostname.pid4
datadir    = /usr/local/mysql/var4
language   = /usr/local/share/mariadb/estonia
user       = tonu
[mariadbd6]
socket     = /tmp/mysql.sock6
port       = 3311
pid-file   = /usr/local/mysql/var6/hostname.pid6
datadir    = /usr/local/mysql/var6
language   = /usr/local/share/mariadb/japanese
user       = jani

UPPHOVSRÄTT

Copyright 2007–2008 MySQL AB, 2008–2010 Sun Microsystems, Inc., 2010–2025 MariaDB Foundation

Denna dokumentation är fri programvara; du får omdistribuera den och/eller ändra den endast enligt villkoren i GNU General Public License som publicerats av Free Software Foundation; version 2 av licensen.

Denna dokumentation distribueras i hopp om att den ska vara användbar, men UTAN NÅGON GARANTI; utan ens underförstådd garanti om SÄLJBARHET eller LÄMPLIGHET FÖR ETT VISST ÄNDAMÅL. Se GNU General Public License för mer information.

Du bör ha fått en kopia av GNU General Public License tillsammans med programmet; om inte, skriv till Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA eller se [1].

SE ÄVEN

För mer information, se MariaDB Knowledge Base, tillgänglig online på [2]

FÖRFATTARE

MariaDB Foundation ([3]).

KOLOFON

Denna sida är en del av projektet MariaDB (MariaDB-databasserver). Information om projektet finns på [4]. Om du har en felrapport för denna manualsida, se [5].

Denna sida hämtades från projektets uppströms Git-arkiv på [6] den 2026-01-16. (Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet 2026-01-16.) Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar av informationen i denna kolofon (som inte är en del av den ursprungliga manualsidan), skicka e-post till man-pages@man7.org.

'= Sidslut =

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/mariadbd-multi.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorservice som har sponsrat Linux.se med webbhotell.