Migreren vanaf een bestaande installatie

Migreer een bestaande Overleaf Toolkit-deployment naar Ayakaleaf Pro.

Het is belangrijk dat je vóór elke migratie naar een nieuwe hoofdversie een consistente back-up maakt, zodat je zo nodig kunt terugdraaien.

​

Migreren vanaf Overleaf Community

​

Geval 01: Vanaf de Overleaf Toolkit

Als je de officiële Overleaf Toolkit voor Overleaf Community gebruikt, voeg je simpelweg een bestand met de naam docker-compose.override.yml met de volgende of vergelijkbare inhoud toe aan de map overleaf-toolkit/config:

docker-compose.override.yml

---
services:
    sharelatex:
        image: ghcr.io/ayaka-notes/overleaf-pro:X.x.x # change to specific version

Start je instantie met:

bin/up

Dat is alles! Je bent klaar. Vervolgens kun je controleren of je Ayakaleaf-instantie correct draait en of je de webinterface kunt openen. Zodra alles werkt, ga je verder met de configuratiestappen hieronder om geavanceerde functies in te schakelen, zoals:

• sandboxed-compiles.md
• authentication
• github-synchronisation.md
• zotero-integration.md

​

Geval 02: Vanaf een Docker Compose-bestand

Als je een losstaand docker-compose.yml gebruikt, migreer dit dan eerst naar de Overleaf Toolkit. De Toolkit vereenvoudigt de on-premises installatie, upgrades en het onderhoud.

Volg docker-compose.yml-to-toolkit-migration.md om je bestaande deployment om te zetten. Behoud tijdens deze migratie je huidige configuratie en de paden van je datavolumes.

Zodra de Toolkit-deployment draait, volg je #from-overleaf-toolkit om de image ervan om te zetten naar Ayakaleaf Pro. Start de instantie met bin/up en controleer vervolgens of je de webinterface kunt openen.

---

​

Migreren vanaf Overleaf Server Pro

Als je momenteel een commercieel gelicentieerde instantie van Overleaf Server Pro draait en wilt migreren naar Ayakaleaf Pro, houd er dan rekening mee dat de migratie wat extra werk kan vereisen, omdat bepaalde gegevensformaten (templates) mogelijk niet volledig compatibel zijn. We helpen je echter graag. Open een issue of neem contact met ons op via [e-mail], dan helpen we je kosteloos met de migratie naar Ayakaleaf Pro.

---

​

Migreren vanaf Overleaf CEP

We krijgen regelmatig vragen van gebruikers of ze kunnen migreren van Overleaf CEP naar Ayakaleaf Pro. In de meeste gevallen bieden Overleaf CEP en Ayakaleaf Pro grotendeels gelijkwaardige functionaliteit en zijn ze vanaf versie 6.2.0 datacompatibel. De twee projecten brengen functies mogelijk op verschillende momenten uit; zo kunnen wij bijvoorbeeld een functie uit Overleaf CEP cherry-picken, en omgekeerd. Hoewel onze implementaties van dezelfde functie licht kunnen verschillen, is er over het algemeen geen dwingende reden om te migreren.

Als je toch wilt migreren naar Ayakaleaf Pro of het wilt uitproberen, raadpleeg dan: #case-01-from-overleaf-toolkit. Het migratieproces is hetzelfde.

---

​

Migreren vanaf Overleaf SaaS

Helaas kan migreren van het Overleaf SaaS-platform naar een zelfgehoste Ayakaleaf Pro-instantie aanzienlijk lastiger zijn. Op dit moment is de enige algemeen beschikbare methode om elk project als ZIP-archief te downloaden en het daarna te uploaden naar je zelfgehoste Ayakaleaf Pro-instantie. Hiermee worden alleen de huidige projectbestanden overgezet, wat betekent dat je het volgende kwijtraakt:

• Alle projectgeschiedenis en eerdere revisies
• Alle opmerkingen en bijgehouden wijzigingen
• Alle Git-metadata en commitgeschiedenis
• Alle GitHub-synchronisatiekoppelingen en -instellingen
• Alle koppelingen tussen BibTeX-bestanden en referentiebeheerplatforms van derden

---

​

Migreren vanaf een Overleaf-fork van derden

Ayakaleaf Pro ondersteunt mogelijk geen functies die specifiek zijn voor een bepaalde Overleaf-fork van derden. Zodra een fork aanzienlijk afwijkt van de upstream Overleaf-codebase, of wijzigingen doorvoert zonder upstream-compatibiliteit te behouden, kan het mergen van latere Overleaf-releases buitengewoon moeilijk worden. Je kunt de hierboven beschreven migratiemethode nog steeds proberen, maar compatibiliteit is niet gegarandeerd, en we kunnen mogelijk geen hulp of technische ondersteuning bieden bij migraties vanaf niet-ondersteunde forks.