Alle nye utgivelser av Ayakaleaf Pro vil oppgi eventuelle endringer i hvilken versjon av MongoDB som støttes, i utgivelsesnotatene.
Bør jeg oppdatere MongoDB?
Du bør bare vurdere å oppdatere MongoDB-versjonen hvis du planlegger å oppgradere instansen din av Ayakaleaf Pro. Hvis du kjører en MongoDB-versjon som er nyere enn den som anbefales for din nåværende versjon (eller målversjon), trenger du ikke å gjøre noen endringer. Hvis du opplever et bestemt problem som du tror kan ha sammenheng med din nåværende versjon av MongoDB, kan du gjerne opprette en sak.Kontrollere MongoDB-versjonen
Når du åpnermongo-skallet, skal gjeldende versjon skrives ut umiddelbart.
Brukere av Overleaf Toolkit:
Oppdateringsprosess
Slik oppdaterer du MongoDB-versjonen under en oppgradering av Ayakaleaf Pro-instansen:- Bestem hvilken versjon av Ayakaleaf Pro du planlegger å oppgradere til.
- Finn versjonen av MongoDB som anbefales for den aktuelle utgivelsen av Ayakaleaf Pro.
- Følg instruksjonene for å oppgradere MongoDB til målversjonen.
- Oppgrader image-versjonen av Ayakaleaf Pro og start instansen på nytt.
Når du oppgraderer Ayakaleaf Pro, anbefaler vi å oppgradere til den nyeste utgivelsen av den installerte hovedversjonen før du oppgraderer til den nyeste utgivelsen av neste hovedversjon. Hvis installasjonen din ligger mer enn én hovedversjon bak den nyeste, må du utføre en oppgradering i flere trinn.Hvis du for eksempel kjører 6.2.0, oppgraderer du først til 6.2.2 og deretter til 6.3.2, se Oppgradere distribusjonen din.Du bør aldri hoppe over versjoner (6.2.0 -> 6.3.2). Hvis du bruker Toolkit og ligger mer enn én hovedversjon bak den nyeste, må du ikke bruke skriptet
bin/upgrade, siden du må utføre en manuell oppgradering i flere trinn.Informasjon om versjonsstøtte
Hvis du bestemmer deg for å gå til en tidligere versjon, viser denne tabellen anbefalt versjon av MongoDB for tidligere utgivelser, men du bør aldri nedgradere MongoDB-versjonen. Tabellen viser Overleaf-utgivelser. Ayakaleaf Pro-imagene starter på 6.0.0: 6.0.0 krever MongoDB 6.0 eller nyere, og 6.0.1 og senere krever MongoDB 8.0 eller nyere med funksjonskompatibilitetsversjon 7.0. Med en eldre MongoDB stopper containeren ved oppstart.| Overleaf-versjon | MongoDB-versjon | Minste versjon for funksjonskompatibilitet | Høyeste versjon som støttes av Node.js-driveren |
|---|---|---|---|
| 2.0.x | 3.4 | - | - |
| 2.1.x til 2.4.x | 3.6 | - | - |
| >=2.5.0 | 4.0 | - | - |
| >=3.1.0 | 4.2 | - | - |
| >=3.2.0 | 4.4 | - | - |
| >=4.2.0 | 5.0 | - | - |
| >=5.1.0 | 6.0 | - | - |
| >=5.3.1 | 6.0 | 5.0 | 8.0 |
| >=5.5.0 | 6.0 | 6.0 | 8.0 |
| >=6.0.0 | 8.0 | 7.0 | 8.0 |
Den minste versjonen for funksjonskompatibilitet ovenfor er basert på den tilsvarende MongoDB-versjonen som anbefales for bruk med den viste versjonen av Overleaf. Hvis du planlegger å bruke en høyere versjon, vil MongoDB ha sitt eget minstekrav.
Oppgradere MongoDB
MongoDB krever trinnvise oppgraderinger. Det betyr at du ikke kan gå direkte fra for eksempel4.0 til 5.0. Du må først oppdatere 4.2 til 4.4, og deretter 5.0.
MongoDB bruker partall for sine stabile versjoner.
Oppdateringsinstruksjoner når MongoDB kjøres utenfor Docker
Her er lenker til oppdateringsinstruksjonene fra mongodb.com for oppgradering av MongoDB.- MongoDB-utgivelsesnotater – oppgradere MongoDB fra
4.2til4.4 - MongoDB-utgivelsesnotater – oppgradere MongoDB fra
4.4til5.0 - MongoDB-utgivelsesnotater – oppgradere MongoDB fra
5.0til6.0 - MongoDB-utgivelsesnotater – oppgradere MongoDB fra
6.0til7.0 - MongoDB-utgivelsesnotater – oppgradere MongoDB fra
7.0til8.0
Instruksjonene for
5.0 og nyere gjelder en installasjon som replikasett (replica set) i stedet for frittstående. Siden Ayakaleaf Pro bruker transaksjoner, må MongoDB kjøres som et replikasett.- Sett kompatibilitetsflagget som beskrevet i utgivelsesnotatene for MongoDB (se eksemplene nedenfor).
- Oppdater deretter mongo-imaget:
- Toolkit-brukere Oppdater
MONGO_VERSION, f.eks.MONGO_VERSION=6.0 - Docker Compose-brukere Oppdater versjonen i taggen for
mongo-imaget,
f.eks.services -> mongo -> image: mongo:6.0;
- Toolkit-brukere Oppdater
5.0 til 6.0
La oss begynne med å forsikre oss om at vi kjører MongoDB 6.0:
Brukere av Overleaf Toolkit:
featureCompatibilityVersion er satt til 5.0. Det gjør vi ved å åpne et MongoDB-skall og kjøre den angitte kommandoen:
Brukere av Overleaf Toolkit:
Docker Compose-brukere kan kjøre
docker compose exec mongo mongosh for å få et skall og kjøre de samme kommandoene som Toolkit-brukere.bin/stop, setter MONGO_VERSION=6.0 i config/overleaf.rc, og starter deretter mongo-tjenesten på nytt med bin/up mongo) for å bekrefte at oppdateringen gikk greit.
Til slutt oppdaterer vi image-versjonen av Ayakaleaf Pro til målversjonen og gjenoppretter alle tjenestene med kommandoen bin/up -d.
Brukere av Docker Compose:
Deretter stopper vi Ayakaleaf Pro- og MongoDB-instansene med kommandoen docker compose stop, oppdaterer filen docker-compose.yml til å bruke image: mongo:6.0, og starter deretter mongo-tjenesten på nytt med kommandoen docker compose up mongo for å bekrefte at oppdateringen gikk greit.
Til slutt oppdaterer vi image-versjonen av Ayakaleaf Pro til målversjonen og gjenoppretter alle tjenestene med kommandoen docker compose up.
Begynn med å forsikre deg om at du kjører MongoDB 6.0 ved hjelp av mongod --version-kommandoene ovenfor.
Ifølge oppgraderingsinstruksjonene er det eneste kravet at featureCompatibilityVersion er satt til 6.0. Det gjør vi ved å åpne et MongoDB-skall og kjøre kommandoen db.adminCommand({ setFeatureCompatibilityVersion: "6.0" }) .
Brukere av Overleaf Toolkit:
bin/stop, setter MONGO_VERSION=7.0 i config/overleaf.rc, og starter deretter mongo-tjenesten på nytt med bin/up mongo) for å bekrefte at oppdateringen gikk greit.
Til slutt oppdaterer vi image-versjonen av Ayakaleaf Pro til målversjonen og gjenoppretter alle tjenestene med kommandoen bin/up -d.
Begynn med å forsikre deg om at du kjører MongoDB 7.0 ved hjelp av mongod --version-kommandoene ovenfor.
Ifølge oppgraderingsinstruksjonene er det eneste kravet at featureCompatibilityVersion er satt til 7.0. Det gjør vi ved å åpne et MongoDB-skall og kjøre kommandoen db.adminCommand({ setFeatureCompatibilityVersion: "7.0", confirm: true }). Merk at dette nå krever en ekstra parameter, confirm: true.
bin/stop, setter MONGO_VERSION=8.0 i config/overleaf.rc, og starter deretter mongo-tjenesten på nytt med bin/up mongo) for å bekrefte at oppdateringen gikk greit.
Til slutt oppdaterer vi image-versjonen av Ayakaleaf Pro til målversjonen og gjenoppretter alle tjenestene med kommandoen bin/up -d.
Tilsvarende kommandoer for Docker Compose-brukere
For Docker Compose-brukere er de tilsvarende kommandoene:docker compose exec mongo mongod --versionfor å vise mongo-versjonendocker compose exec mongo mongoshfor å starte et mongo-skall for administrasjonskommandoer- Kommandoen
docker compose stopfor å stoppe serveren - Rediger filen
docker-compose.ymltil å brukeimage: mongo:6.0for å oppgradere mongo-versjonen docker compose up mongofor å starte mongo-tjenesten på nytt og bekrefte at oppdateringen gikk greit- Rediger filen
docker-compose.ymltil å brukeimage: sharelatex:VERSIONfor å oppgradere image-versjonen docker compose upfor å gjenopprette alle tjenestene.
Opprette en egendefinert rolle
I versjon5.5.1 innførte vi en kontroll ved oppstart som verifiserer versjonen for funksjonskompatibilitet i MongoDB. Hvis MongoDB-databasen din bruker autentisering (f.eks. grunnleggende autentisering), kan det hende at sharelatex-containeren ikke starter og viser tillatelsesfeilen “not authorized on admin to execute command”.
For å løse dette kan du enten opprette en ny rolle i MongoDB og tildele den til brukerkontoen som brukes for å få tilgang til databasen, ved hjelp av instruksjonene nedenfor, eller sette ALLOW_MONGO_ADMIN_CHECK_FAILURES=true slik at kontrollen kan mislykkes uten å hindre installasjonen i å starte.
Denne nye rollen gir kun tillatelse til å lese MongoDB-serverparametere for hele klyngen og kan gjenbrukes til overvåkingsformål,
Q&A
Hvilken Ayakaleaf Pro-versjon fungerer med MongoDB 4.4?
Hvilken Ayakaleaf Pro-versjon fungerer med MongoDB 4.4?
Svar: Ingen. Det eldste Ayakaleaf Pro-imaget, 6.0.0, krever MongoDB 6.0, og 6.0.1 og senere krever MongoDB 8.0. For å kjøre Ayakaleaf Pro på en eksisterende MongoDB 4.4 oppgraderer du MongoDB én hovedversjon om gangen (4.4 → 5.0 → 6.0 → 7.0 → 8.0) som beskrevet i Oppgradere MongoDB, med en sikkerhetskopi før hvert trinn.

