Owncloud migration documentation: Add hints to edit version.php, and to trigger background migrations after each upgrade step

Aperta Adatta ai principianti
#13,109 4 commenti 3 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
72/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
php
Ambito
documentation

Direzione di ricerca

Inizia con la documentazione sulla migrazione di Owncloud e con la pagina collegata How to upgrade. Aggiorna le istruzioni sulla migrazione per spiegare l’adeguamento della compatibilità di version.php per Owncloud 10.14.x e 10.15.x e per attendere il completamento delle migrazioni in background o attivarle manualmente dopo ogni passaggio di aggiornamento; inserisci un link alle istruzioni di aggiornamento esistenti in modo che la sequenza sia inequivocabile.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

1. to develop bug good first issue manual: admin

The Owncloud migration documentation is helpful and mostly works, but it is missing two crucial hints:

  1. The migration documentation advertises compatibility with Owncloud versions 10.13.x, 10.14.x, and 10.15.x, but only works out of the box with Owncloud version 10.13.x.
    The reason is that Nextcloud 25.0.13 declares itself compatible with Owncloud 10.13.x only in version.php. Changing this file allows the migration to proceed.
    As it's impossible to file bugs against this unsupported old Nextcloud version, the migration documentation should explain how to change the version.php file.

  2. As documented in How to upgrade, we must wait for all background migrations to complete before taking the next upgrade step.
    The Owncloud migration documentation neither advises to pause and wait for background migrations to happen (or to trigger them manually), nor does it link to the latter page that explains the matter. Thus, it's easy to miss when going through the 25 → 26 → 27 → 28 → 29 → 30 → 31 upgrades. This is in fact what happened to me during a recent upgrade: Several background migrations were missed or aborted, leading to an inconsistent database schema.
    I suggest adding an explicit hint to the migration documentation.

Lingua principale
JavaScript
Stelle
628
Fork
2.5k
Merge medio
1g 23h
PR unite (30g)
133

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di nextcloud/documentation

Tutte le issue di nextcloud/documentation

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.