pt-slave-restartp - Online in de cloud

PROGRAMMA:

NAAM

pt-slave-restart - Bekijk en start MySQL-replicatie opnieuw na fouten.

KORTE INHOUD

Gebruik: pt-slave-restart [OPTIES] [DSN]

pt-slave-restart controleert een of meer MySQL-replicatieslaves op fouten en probeert dat te doen
start de replicatie opnieuw als deze stopt.

RISICO'S

Percona Toolkit is volwassen, bewezen in de echte wereld en goed getest, maar alle databases
tools kunnen een risico vormen voor het systeem en de databaseserver. Voordat u dit hulpmiddel gebruikt,
alstublieft:

· Lees de documentatie van de tool

· Bekijk de bekende "BUGS" van de tool

· Test de tool op een niet-productieserver

· Maak een back-up van uw productieserver en verifieer de back-ups

PRODUCTBESCHRIJVING

pt-slave-restart bewaakt een of meer MySQL-replicatieslaves en probeert instructies over te slaan
die fouten veroorzaken. Het ondervraagt ​​slaven op intelligente wijze met een exponentieel variërende slaap
tijd. U kunt fouten opgeven om de slaves over te slaan en uit te voeren tot een bepaalde binlog-positie.

Hoewel dit hulpmiddel een slaaf kan helpen fouten te voorkomen, moet u er niet op vertrouwen
replicatie "repareren". Als slave-fouten vaak of onverwacht optreden, moet u dit identificeren
en verhelp de oorzaak.

OUTPUT

Als u "--verbose" opgeeft, drukt pt-slave-restart een regel af telkens wanneer de slave wordt gezien
heeft een fout. Zie "--uitgebreid" voor details.

SLEEP

pt-slave-restart slaapt op intelligente wijze tussen het pollen van de slaaf. De huidige slaaptijd
varieert.

· De initiële slaaptijd wordt gegeven door "--sleep".

· Als het controleert en een fout vindt, halveert het de vorige slaaptijd.

· Als er geen fout wordt gevonden, verdubbelt het de vorige slaaptijd.

· De slaaptijd wordt onderaan begrensd door "--min-sleep" en bovenaan door "--max-sleep".

· Onmiddellijk nadat een fout is gevonden, gaat pt-slave-restart ervan uit dat er sprake is van een andere fout
waarschijnlijk daarna zal gebeuren, dus het slaapt de huidige slaaptijd of de initiële slaaptijd,
welke is minder.

GLOBAL TRANSACTIE IDS

Vanaf Percona Toolkit 2.2.8 ondersteunt pt-slave-restart geïntroduceerde Global Transaction ID's
in MySQL 5.6.5. Het is belangrijk om in gedachten te houden dat:

· pt-slave-restart zal geen transacties overslaan als er meerdere replicatiethreads zijn
wordt gebruikt (slave_parallel_workers > 0). pt-slave-restart weet niet wat de GTID is
gebeurtenis is van de mislukte transactie van een specifieke slave-thread.

· Het standaardgedrag is het overslaan van de volgende transactie van de master van de slaaf. Schrijft
kan afkomstig zijn van verschillende servers, elk met hun eigen UUID.

Zie "--master-uuid".

EXIT STATUS

Een exitstatus van 0 (ook wel retourwaarde of retourcode genoemd) geeft aan
succes. Elke andere waarde vertegenwoordigt de afsluitstatus van het Perl-proces zelf, of van de
laatste gevorkte proces dat werd afgesloten als er meerdere servers waren om te monitoren.

COMPATIBILITEIT

pt-slave-restart zou op veel versies van MySQL moeten werken. Lettercase van veel uitvoerkolommen
van SHOW SLAVE STATUS is in de loop van de tijd veranderd, dus het behandelt ze allemaal als kleine letters.

OPTIES

Dit hulpprogramma accepteert aanvullende opdrachtregelargumenten. Raadpleeg de "SYNOPSIS" en gebruik
informatie voor details.

--altijd
Start slaves zelfs als er geen fout is. Met deze optie ingeschakeld, pt-slave-restart
laat je de slaaf niet handmatig stoppen als je dat wilt!

--vraag-pas
Vraag om een ​​wachtwoord bij verbinding met MySQL.

--tekenset
korte vorm: -A; type: tekenreeks

Standaard tekenset. Als de waarde utf8 is, stelt u Perl's binmode op STDOUT in op utf8,
geeft de optie mysql_enable_utf8 door aan DBD::mysql en voert daarna SET NAMES UTF8 uit
verbinding maken met MySQL. Elke andere waarde stelt binmode in op STDOUT zonder de utf8-laag,
en voert SET NAMES uit na verbinding met MySQL.

--[geen]check-relay-log
standaard: ja

Controleer het laatste relaislogbestand en de laatste positie voordat u controleert op slave-fouten.

Standaard zal pt-slave-restart niets doen (het zal alleen slapen) als geen van beide
het relaislogbestand en de relaislogpositie zijn sinds de laatste controle veranderd. Dit
voorkomt oneindige lussen (dwz het opnieuw starten van dezelfde fout in hetzelfde relay-logbestand op
dezelfde relaislogpositie).

Voor bepaalde slave-fouten moet deze controle echter worden uitgeschakeld door dit op te geven
"--geen-controle-relais-log". Doe dit niet tenzij u weet wat u doet!

--config
type: matrix

Lees deze door komma's gescheiden lijst met configuratiebestanden; indien opgegeven, moet dit de eerste zijn
optie op de opdrachtregel.

--daemoniseren
Vork naar de achtergrond en maak los van de schaal. Alleen POSIX-besturingssystemen.

--databank
korte vorm: -D; type: tekenreeks

Databank om te gebruiken.

--defaults-bestand
korte vorm: -F; type: tekenreeks

Lees alleen mysql-opties uit het opgegeven bestand. U moet een absolute padnaam opgeven.

--foutlengte
typ: int

Maximale lengte van de foutmelding die moet worden afgedrukt. Wanneer "--verbose" hoog genoeg is ingesteld om af te drukken
de fout, zal deze optie de fouttekst afkappen tot de opgegeven lengte. Dit kan
kan handig zijn om te voorkomen dat er omwikkeling op de terminal plaatsvindt.

--foutnummers
type: hasj

Start deze door komma's gescheiden lijst met fouten alleen opnieuw. Zorgt ervoor dat pt-slave-restart het alleen probeert
start opnieuw op als het foutnummer in deze door komma's gescheiden lijst met fouten staat. Als het een
fout niet in de lijst staat, wordt deze afgesloten.

Het foutnummer staat in de kolom "last_errno" van "SHOW SLAVE STATUS".

--fouttekst
type: tekenreeks

Herstart alleen fouten die overeenkomen met dit patroon. Een reguliere Perl-expressie waartegen
de eventuele fouttekst komt overeen. Als de fouttekst bestaat en overeenkomt, wordt pt-slave-
restart zal proberen de slave opnieuw op te starten. Als het bestaat maar niet overeenkomt, pt-slave-
opnieuw opstarten wordt afgesloten.

De fouttekst staat in de kolom "last_error" van "SHOW SLAVE STATUS".

--help
Help weergeven en afsluiten.

--gastheer
korte vorm: -h; type: tekenreeks

Maak verbinding met host.

--log
type: tekenreeks

Druk alle uitvoer naar dit bestand af wanneer het is gedemoniseerd.

--max-slaap
soort: vlotter; standaard: 64

Maximale slaapseconden.

De maximale tijd dat pt-slave-restart zal slapen voordat de slave opnieuw wordt ondervraagd. Dit is
ook de tijd dat pt-slave-restart zal wachten tot alle andere actieve instances zijn gestopt
als zowel "--stop" als "--monitor" zijn opgegeven.

Zie "SLAPEN".

--min-slaap
soort: vlotter; standaard: 0.015625

De minimale tijd dat pt-slave-restart zal slapen voordat de slave opnieuw wordt ondervraagd. Zien
"SLAAP".

--toezicht houden op
Of de slaaf moet worden bewaakt (standaard). Tenzij u --monitor expliciet specificeert,
"--stop" zal dit uitschakelen.

--wachtwoord
korte vorm: -p; type: tekenreeks

Wachtwoord om te gebruiken bij het verbinden. Als het wachtwoord komma's bevat, moeten deze worden ontsnapt
met een backslash: "exam\,ple"

--pid
type: tekenreeks

Maak het opgegeven PID-bestand aan. De tool start niet als het PID-bestand al bestaat en
de PID die het bevat is anders dan de huidige PID. Als het PID-bestand
bestaat en de PID die deze bevat niet meer actief is, zal de tool de PID overschrijven
bestand met de huidige PID. Het PID-bestand wordt automatisch verwijderd wanneer de tool wordt afgesloten.

--haven
korte vorm: -P; typ: int

Poortnummer dat moet worden gebruikt voor verbinding.

--stil
korte vorm: -q

Onderdrukt de normale uitvoer (schakelt "--verbose" uit).

--recursie
typ: int; standaard: 0

Bekijk slaven van de opgegeven server, tot het opgegeven aantal servers diep in
de hiërarchie. De standaarddiepte van 0 betekent "kijk gewoon naar de opgegeven slaaf."

pt-slave-restart onderzoekt "SHOW PROCESSLIST" en probeert vast te stellen welke verbindingen
afkomstig zijn van slaven, maak dan verbinding met hen. Zie "--recursie-methode".

Recursie werkt door alle slaven te vinden wanneer het programma start, en ze vervolgens te bekijken. Als
er meer dan één slave is, gebruikt "pt-slave-restart" "fork()" om ze te monitoren.

Dit werkt ook als u uw slaven heeft geconfigureerd om te verschijnen in "SHOW SLAVE HOSTS".
De minimale configuratie hiervoor is de parameter "report_host", maar er zijn er nog meer
"report"-parameters, evenals voor de poort, gebruikersnaam en wachtwoord.

--recursie-methode
type: reeks; standaard: proceslijst,hosts

Voorkeursrecursiemethode die wordt gebruikt om slaven te vinden.

Mogelijke methoden zijn:

METHODE TOEPASSINGEN
=========== ==================
proceslijst TOON PROCESLIJST
gastheren TOON SLAVE GASTHEREN
geen Vind geen slaven

De proceslijstmethode heeft de voorkeur omdat SHOW SLAVE HOSTS niet betrouwbaar is.
De hosts-methode is echter vereist als de server een niet-standaardpoort gebruikt (niet
3306). Meestal doet pt-slave-restart het juiste en vindt de slaven, maar jij
kan een voorkeursmethode aangeven en deze zal als eerste worden gebruikt. Als er geen slaven worden gevonden,
de andere methoden zullen worden geprobeerd.

--looptijd
typ: tijd

Tijd om te rennen voordat je weggaat. Zorgt ervoor dat pt-slave-restart na de opgegeven tijd stopt
verstreken. Optioneel achtervoegsel: s=seconden, m=minuten, h=uren, d=dagen; indien geen achtervoegsel, s
is gebruikt.

-- schildwacht
type: tekenreeks; standaard: /tmp/pt-slave-restart-sentinel

Sluit af als dit bestand bestaat.

--set-vars
type: matrix

Stel de MySQL-variabelen in deze door komma's gescheiden lijst van "variabele=waarde"-paren in.

Standaard stelt de tool het volgende in:

wait_timeout=10000

Variabelen die op de opdrachtregel zijn opgegeven, overschrijven deze standaardwaarden. Bijvoorbeeld,
het specificeren van "--set-vars wait_timeout=500" overschrijft de standaardwaarde van 10000.

De tool drukt een waarschuwing af en gaat verder als een variabele niet kan worden ingesteld.

--overslaan
typ: int; standaard: 1

Aantal instructies dat moet worden overgeslagen bij het opnieuw opstarten van de slave.

--master-uuid
type: tekenreeks

Bij gebruik van GTID moet een lege transactie worden aangemaakt om deze over te slaan. Als
schrijfbewerkingen komen van verschillende knooppunten in de replicatieboom hierboven, maar dat is niet het geval
mogelijk om te weten welke gebeurtenis van welke UUID moet worden overgeslagen.

Standaard worden transacties van de master van de slaaf ('Master_UUID' uit "SHOW SLAVE
STATUS") worden overgeslagen.

Bijvoorbeeld met

meester1 -> slaaf1 -> slaaf2

Wanneer u gebeurtenissen op slave2 overslaat die naar master1 zijn geschreven, moet u de UUID opgeven
van master1, anders gebruikt de tool standaard de UUID van slave1.

Zie "ALGEMENE TRANSACTIE-ID'S".

--slaap
typ: int; standaard: 1

Initiële slaapseconden tussen het controleren van de slave.

Zie "SLAPEN".

--stopcontact
korte vorm: -S; type: tekenreeks

Socketbestand om te gebruiken voor verbinding.

--stoppen
Stop met het uitvoeren van exemplaren door het Sentinel-bestand te maken.

Zorgt ervoor dat "pt-slave-restart" het Sentinel-bestand maakt dat is gespecificeerd door "--sentinel". Dit
zou het effect moeten hebben van het stoppen van alle lopende instanties die hetzelfde bekijken
Sentinel-bestand. Als "--monitor" niet is opgegeven, wordt "pt-slave-restart" daarna afgesloten
het maken van het bestand. Als dit is opgegeven, wacht "pt-slave-restart" het interval
gegeven door "--max-sleep", verwijder vervolgens het bestand en ga verder met werken.

Misschien vindt u dit handig om cron-taken indien nodig op een elegante manier te stoppen of om er een te vervangen
instantie uitvoeren met een andere. Bijvoorbeeld als u wilt stoppen en opnieuw wilt starten
"pt-slave-restart" elk uur (om er zeker van te zijn dat het elk uur opnieuw wordt opgestart, in
geval van een servercrash of een ander probleem), zou u een "crontab"-regel kunnen gebruiken, zoals
deze:

0 * * * * pt-slave-herstart --monitor --stop --sentinel /tmp/pt-slave-herstart

De niet-standaard "--sentinel" zorgt ervoor dat de "cron"-taak per uur alleen exemplaren stopt
eerder begonnen met dezelfde opties (dat wil zeggen vanuit dezelfde "cron"-taak).

Zie ook "--schildwacht".

--tot-meester
type: tekenreeks

Ren tot dit hoofdlogbestand en positie. Start de slaaf en probeer het opnieuw als het mislukt,
totdat het de gegeven replicatiecoördinaten bereikt. De coördinaten zijn het logbestand
en positie op de master, gegeven door relay_master_log_file, exec_master_log_pos. De
argument moet de indeling "bestand,pos" hebben. Scheid de bestandsnaam en positie met een
enkele komma en geen spatie.

Dit zorgt er ook voor dat er een UNTIL-clausule wordt gegeven aan START SLAVE.

Nadat dit punt is bereikt, moet de slave worden gestopt en wordt pt-slave-restart afgesloten.

--tot-relais
type: tekenreeks

Ren tot dit relaislogbestand en positie. Zoals "--tot-master", maar dan in die van de slaaf
relaislogboeken in plaats daarvan. De coördinaten worden gegeven door relay_log_file, relay_log_pos.

--gebruiker
korte vorm: -u; type: tekenreeks

Gebruiker om in te loggen indien niet huidige gebruiker.

--uitgebreid
korte vorm: -v; cumulatief: ja; standaard: 1

Wees uitgebreid; meerdere keren opgeven. Breedsprakigheid 1 voert verbindingsinformatie uit, a
tijdstempel, relay_log_file, relay_log_pos en last_errno. Breedsprakigheid 2 voegt toe
laatste_fout. Zie ook "--foutlengte". Breedsprakigheid 3 drukt de huidige slaaptijd af
elke keer dat pt-slave-restart slaapt.

--versie
Toon versie en sluit af.

--[no]versiecontrole
standaard: ja

Controleer op de nieuwste versie van Percona Toolkit, MySQL en andere programma's.

Dit is een standaard "controleer automatisch op updates", met twee extra
Kenmerken. Eerst controleert de tool de versie van andere programma's op het lokale systeem in
aanvulling op een eigen versie. Het controleert bijvoorbeeld de versie van elke MySQL-server
het maakt verbinding met Perl en de Perl-module DBD::mysql. Ten tweede, het controleert en waarschuwt
over versies met bekende problemen. MySQL 5.5.25 had bijvoorbeeld een kritieke bug en
werd opnieuw uitgebracht als 5.5.25a.

Alle updates of bekende problemen worden naar STDOUT afgedrukt voordat de normale uitvoer van het hulpprogramma wordt uitgevoerd.
Deze functie mag nooit interfereren met de normale werking van het gereedschap.

Voor meer informatie bezoek .

Toon versie en sluit af.

DSN OPTIES

Deze DSN-opties worden gebruikt om een ​​DSN te maken. Elke optie wordt gegeven als "option=value".
De opties zijn hoofdlettergevoelig, dus P en p zijn niet dezelfde optie. Er kan niet zijn
witruimte voor of na de "=" en als de waarde witruimte bevat, moet deze tussen aanhalingstekens worden geplaatst.
DSN-opties zijn door komma's gescheiden. Zie de percona-toolkit manpage voor volledige details.

· EEN

dsn: tekenset; kopie: ja

Standaard tekenset.

· NS

dsn: databank; kopie: ja

Standaarddatabase.

F

dsn: mysql_read_default_file; kopie: ja

Lees alleen de standaardopties van het opgegeven bestand

· H

dsn: host; kopie: ja

Maak verbinding met host.

· P

dsn: wachtwoord; kopie: ja

Wachtwoord om te gebruiken bij het verbinden. Als het wachtwoord komma's bevat, moeten deze worden ontsnapt
met een backslash: "exam\,ple"

· Blz

dsn: poort; kopie: ja

Poortnummer dat moet worden gebruikt voor verbinding.

· S

dsn: mysql_socket; kopie: ja

Socketbestand om te gebruiken voor verbinding.

· u

dsn: gebruiker; kopie: ja

Gebruiker om in te loggen indien niet huidige gebruiker.

MILIEU

De omgevingsvariabele "PTDEBUG" maakt uitgebreide foutopsporingsuitvoer naar STDERR mogelijk. In staat te stellen
debuggen en alle uitvoer vastleggen in een bestand, voer de tool uit als:

PTDEBUG=1 pt-slave-herstart ... > BESTAND 2>&1

Wees voorzichtig: het debuggen van uitvoer is omvangrijk en kan enkele megabytes aan uitvoer genereren.

SYSTEM VEREISTEN

U hebt Perl, DBI, DBD::mysql en enkele kernpakketten nodig die in elk
redelijk nieuwe versie van Perl.

Gebruik pt-slave-restartp online met behulp van onworks.net-services