De hoofdversie van SPIP veranderen

Overzicht

1. Backup voorafgaand aan de migratie
2. Verificatie van de codering
3. Voorbereiding van de migratie
4. Aanpassen van de bestanden
5. Update van de database
6. In geval van problemen
7. Installatie van plugins en skeletten
8. Opruimen
9. Update in SPIP 3
10. Over dit document

Backup voorafgaand aan de migratie

Backup van de database
-  Indien mogelijk moet via PHPMyAdmin een backup worden gemaakt van de MySQL database, een mogelijkheid die veel providers aanbieden.
-  SPIP heeft zelf ook de mogelijkheid een backup te maken

1. kies voor een gecomprimeerde backup.
2. haal via FTP het backupbestand binnen: XML-formaat voor SPIP 2, in map tmp/dump (of in ecrire/data voor oudere SPIP versies)

Backup van persoonlijke mappen
-  Kopieer via FTP de volgende mappen:

• IMG
• config (voor zeer oude versies van SPIP moet je de codes van de database kennen)
• eventueel de map squelettes wanneer de inhoud ervan opnieuw gebruikt kan worden

Met de backup van de database en de inhoud van de map IMG (die alle ingevoegde documenten en afbeeldingen bevat) heb je een volledige backup. config bevat de informatie over de verbindingen met de database en squelettes bevat je aangepaste skeletten. Noteer voor de zekerheid wat de gebruikte versie van SPIP was (dus voor deze migratie).

Verificatie van de codering

Wanneer de site relatief recent is (in UTF-8) of de encodering al in UTF-8 is, kun je deze stap overslaan.

Om dit te controleren kijk je bij de taalparameters.
Wanneer de codering ISO-8859-1 is, kun je beter omschakelen naar UTF-8. De procedure hiervoor is beschikbaar in SPIP 2 (zie onderaan voor SPIP 3):

• maak een backup van de database (dit heb je theoretisch al gedaan)
• op de pagina voor het beheer van de taal klik je op de link naar « de conversie naar UTF-8 » (URL: ecrire/?exec=convert_utf8)
• start vervolgens de procedure: ecrire/?exec=sql_convert_utf8

Voorbereiding van de migratie

Controleer welke PHP-versie wordt uitgevoerd op de server (bijvoorbeeld via http://www.mijnsite.org/ecrire/?exec=info). SPIP 3 heeft een minimale PHP versie 5.1 nodig (terwijl SPIP 2 met PHP 4.x genoegen nam). Indien nodig controleer je bij je provider hoe je een recente versie kunt gebruiken, bijvoorbeeld PHP 5.3 of 5.4).

SPIP 3 heeft minimaal PHP 5.1 nodig.

Vervolgens zijn er twee mogelijkheden:

Oplossing 1

1. Download de laatste versie van SPIP (via de Franstalige pagina op deze site) en pak dit gezipte bestand uit in een map spip op je computer
2. Maak met behulp van FTP op de server mappen aan in de root van de site: /spip3 et /ancienSpip
3. Transfereer met FTP de mappen en bestanden die je zojuist het uitgepakt in je map spip op je computer naar de map spip3 op de server

Daarna bevat je map /spip3:

• php bestanden: index.php, spip.php
• mappen: ecrire ,tmp, local, squelettes-dist, plugins-dist, prive, en IMG en config (leeg)
• enkele bestanden met de extensie .txt en .png

Oplossing 2

1. Haal het script spip_loader.php op vanaf de Franstalige pagina op deze site
2. Zet dit bestand met behulp van FTP in de root van je site
3. Voer het nog niet uit!

Aanpassen van de bestanden

Verplaats de mappen en bestanden van je SPIP site naar /ancienSpip (met uitzondering van de mappen die je beslist moet bewaren: IMG en config). Om dit te doen voer je deze stappen in FTP uit:

1. selecteer alles in de remote site (ook de map /plugins !) BEHALVE

• ancienSpip,
• spip3,
• IMG,
• config
• en de bestanden en mappen die niets met SPIP te maken hebben.
• het bestand spip_loader.php wanneer je kiest voor Oplossing 2

2. Verplaats het geselecteerde naar /ancienSpip

Je site zal nu niet meer werken, maar dat zal niet lang duren. Het is belangrijk dat de mappen in de root van de site daadwerkelijk verplaatst zijn (ecrire, prive, extensions, squelettes-dist). Deze mappen bevatten bestanden die in SPIP 3 niet meer gebruikt worden en die conflicten zouden kunnen veroorzaken wanneer ze nog aanwezig zijn.

wanneer je kiest voor Oplossing 1

Nog steeds in FTP:

1. Ga naar map /spip3
2. verplaats de inhoud van de map /spip3 naar het bovenliggende niveau (normaal is dat de root van de site). Hiervoor doe je:

• Ctrl + a om alles in /spip3 te selecteren
• verplaats je de selectie naar ..
• de map /spip3 is nu leeg en kan worden verwijderd.

wanneer je kiest voor Oplossing 2

1. Ga met je browser naar je site en start het script spip_loader.php met een commando in de vorm van: http://www.mijnsite.com/spip_loader.php en volg de aanwijzingen.

Lees het artikel Het gebruik van spip_loader!

Update van de database

Afhankelijk van het type update zal een procedure worden aangeboden wanneer je in het privé gedeelte van de site gaat. Volg de aanwijzingen.

1. Raadpleeg je site. Normaal gesproken zou hij zichtbaar moeten zijn (gebruikmakend van de standaard skeletten van SPIP)
2. Ga naar het privé gedeelte van SPIP met een administrateur account.
3. Volg de voorgestelde onderhoudsprocedure.
4. Ga vervolgens naar de beheerpagina voor plugins (in configuratie)
5. Controleer of de site goed werkt.

In geval van problemen

Indien nodig moeten bepaalde tijdelijke bestanden opnieuw worden aangemaakt.

Maak daarvoor de map tmp leeg, met uitzondering van de submappen dump, sessions en visites.

Probeer daarna opnieuw op de site te komen.

Installatie van plugins en skeletten

Maak de volgende mappen aan in de root van de site:

• /plugins (en maak vervolgens in deze map een submap auto)
• /lib
• /squelettes

Pas de rechten van deze mappen zodanig aan dat de server er naartoe mag schrijven.

Ga naar de pagina voor het beheer van plugins en, geef in « dépôts » het voorgestelde depot aan - (dit is belangrijk voor de in werking stelling van deze nieuwe methode voor het beheer van plugins).

Installeer de voor je site benodigde plugins (je kunt de zoekfuncite gebruiken). Controleer of de publieke site werkt (maak eventueel de cache leeg of de map tmp zoals eerder aangegeven). Doe de juiste instelling van de plugins (klik hiervoor op het ikoon nadat een plugin werd geactiveerd).

Pas vervolgens je aanpassingen van skeletten toe door de HTML-bestanden geleidelijk in de map squelettes te plaatsen. Controleer of ieder aangepast skelet het gewenste resultaat geeft.

Opruimen

Wanneer alles is gebeurd:

• controleer of ook andere geïnstalleerde toepassingen op de site nog steeds werken.
• controleer de inhoud van map /ancienSpip. Deze zal de mappen en bestanden van je oude SPIP site bevatten: (ecrire, local, tmp, squelettes-dist of dist, extensions en enkele bestanden)
• verwijder tenslotte de map /ancienSpip.

Update in SPIP 3

Voor een eenvoudige update in dezelfde hoofdversie (van SPIP 3.0.N naar SPIP 3.0.N+1) gebruik je het best de « spip_loader » die het snelst en eenvoudigst werkt. Zoals gezegd is dit bestand bedoeld voor webmasters die zich hebben aangemeld.

Het stappenplan voor de update is eenvoudig:

• maak een backup (via de SPIP interface)
• voer de update uit (via de spip_loader methode)
• naak een backup na de update (via de SPIP interface)

Over dit document

Auteurs

• Michel Suquet
• Johan Pustoch

Originele tekst

wikitice.ac-versailles.fr, onder licentie Creative Commons Attribution.

Aanpassingen

SPIP Collectief