Manual:Upgrading



Oversigt
Første [http://svn.wikimedia.org/viewvc/mediawiki/branches/ ((MW stabile gren svn)) / phase3/UPGRADE? View = markup læse UPGRADE tekstfil i MediaWiki].


 * 1) Check kravene
 * 2) Læs release notes
 * 3) Back up eksisterende filer og databasen
 * 4) Pak den nye filer
 * 5) Kør opdateringen script til at kontrollere database
 * 6) Upgrade extensions
 * 7) Test update

Check krav
MediaWiki ((MW stabile gren nummer)) kræver:

PHP

 * PHP 5.0.x Eller senere
 * Vi anbefaler at Bruge PHP 5.1.x Eller 5.2.x Eller 5.3.x, undtagen 5.3.1, SOM Order da bug.
 * Bemærk, at PHP 5.0.x under Apparatus 64-bit platforme indeholder benytter normalt. SOM forårsager de grundlæggende problemer MED MediaWiki Hvis du kører in da x86_64 (AMD64, EMT64) Eller Andre berørte 64-bit platform, PHP 5.1.x Eller 5.2.x ER nødvendig.

DBMS

 * MySQL 4.0.x Eller nyere
 * Version 3.x Advocate ikke været støttet siden 1.6.0

, Eller


 * PostgreSQL 8,1 Eller senere
 * Du VII, også kræve, at  tsearch2  OG  plpgsql  moduler, hvis der Kores Postgres 8,1 Eller 8,2
 * Se også Opgradering Postgres

Læs release notes
Inden for distribution tarball, eller inden for de filer checket ud-eksporteres fra SVN, er der en række filer med aktiverede filnavne, hvoraf den ene indeholder'''[http://svn.wikimedia.org/viewvc/mediawiki/branches / ((MW stabile gren svn)) / phase3/RELEASE-NOTES? view = markup RELEASE-NOTER ]'''. Nu er det tid til at åbne den op og finde ud af hvad der er blevet ændret i denne udgivelse.

Tilbage up eksisterende filer og databasen
Mens opgraderingen scripts er velholdt og robust, kunne tingene går stadig pæreformet. Inden vi går videre til at opdatere databaseskema,foretage en fuldstændig backup  af wikien, herunder både databasen og filerne:


 * Wikien indhold fra databasen. Det kan være en god idé at skabe en XML dump ud over SQL database dump.
 * MySQL:
 * Tekst dump:  mysqldump - all-databaser> file.txt 
 * Xml dump:  mysqldump - all-databaser - xml> file.xml 
 * PostgreSQL:
 * Udgang til pg_restore:  pg_dump - create-Fc-i yourwiki> yourwiki.db.dump 
 * Billeder og andre mediefiler (indholdet af  billeder  mappe)
 * Konfigurationsfiler, dvs  LocalSettings.php  og  AdminSettings.php </ tt> (hvis det findes)
 * MediaWiki program filer, herunder alle skind og udvidelser, især hvis du har ændret dem.

Se også Sikkerhedskopiering af en wiki og  Latin-1 til UTF-8 konvertering for detaljerede instruktioner.

Brug AF en tarball pakke
Hvis du bruger en tarball pakke, dekomprimere blev slettet in Serveren, hvor Den Gamle version AF MediaWiki kører. Nar untarring en tarball pakke normalt en ny Mappe Til den Nye wiki-version VII, blive Oprettet OG du bliver nødt Til at kopiere de Nye filer OG mapper in din nuværende wiki-bibliotek. Jeg stedet for på erstatte de eksisterende filer, dekomprimere herre OG gore dette i en arbejdsgang, Skal du Bruge This page Kommando:

$ Tar xvfz MediaWiki-((MW stabile udgivelse Nummer)). Tar.gz-C / sti / til / DIT / wiki / - strip-Komponenter = 1

In Ældre Linux-distributioner (dvs. RHEL / CentOS 4.x) brug:

$ Tar xvfz MediaWiki-((MW stabile udgivelse Nummer)). Tar.gz-C / sti / Til / DIT / wiki / - strip-path = 1

For disse mennesker bruger en gammel version AF tar (f.eks GNU tar 1.13.x), SOM ikke Order - strip-Komponenter eller - strip-sti flag KAN dekomprimere arkivet Uden-C mulighed OG derefter rekursivt kopiere indholdet AF den seneste pakke i de tidligere wiki mappestruktur, SOM Folger:

$ Tar xvfz MediaWiki-((MW stabile udgivelse Nummer)). Tar.gz $ Cp-r MediaWiki-((MW stabil udgivelse Nummer)) / * / sti-Til-DIT-wiki /

(Open) Solaris brugere bor Bruge gtar, Eller:

$ Gzip-dc MediaWiki-((MW stabile udgivelse Nummer)). Tar.gz | tar xf -

Windows-brugere KAN Bruge 7zip i pakke tarball.

Brug Subversion
Hvis du bruger Subversion, eksportere filer i en ren Placering. Erstat Alle eksisterende filer MED den Nye versioner, bevarer mappestruktur. Kernen Kode is Nu op Til Dato.

Kør opdateringen script
Bemærk: Sørg for at der er en <tt>AdminSettings.php</ tt> fil i wiki rod, og det indeholder op til dato oplysninger. Brugeren skal alle tilladelser (shell adgang) på databasen.

Den foretrukne metode til at udføre opdateringen er ved hjælp af kommandolinjen vedligeholdelse script, men det er også muligt at re-køre web-baserede installationsprogram.

Shell
Fra kommandolinjen, Eller en SSH shell Eller lignende, AEndring AF <tt>vedligeholdelse</ tt> Bibliotek og udføre opdateringen script:

$ Php update.php - aconf .. / AdminSettings.php

(Bemærk Til simple installationer in Windows (fx MED XAMPP): Du KAN Kore update.php udfører den (DoubleClick), når din. Php-filer is associeret MED PHP.exe (hvis ikke, højreklik update.php, vælg Enter Med OG ga Til PHP.exe). Sorg i din server-program (f.eks Apache) OG din database (f.eks MySQL) kører).

MediaWiki VII, inspicere de eksisterende skema OG opdatere den Til ved Arbejde MED den Nye Kode, der tilføjer tabeller OG kolonner Morgen, Lys behov.

Finde Skal Gore i tilfælde AF "No superbruger akkreditiver" benytter normalt
Jeg tilfælde AF scripts afbryde MED EN tabt for længe siden:

"Nej superbruger legitimationsoplysninger kunne findes. Anfør nærmere oplysninger OM en bruger MED Rette tilladelser Til at opdatere Databasen. Se AdminSettings.sample for fre mærkning detaljer"

Dette betyder at du SKAL kontrollere, at du Bestil defineret $ wgDBadminuser OG $ wgDBadminpassword i din LocalSettings.php fil (i hovedsagen bibliotek). DET ER de bruger OG password Til brug for dette script i fa adgang Til Databasen.

Alternativ 1: phpShell
Hvis Alle tilladelser / shell adgang ikke ER tilgængelig, Skal du Kigge in muligheder, såsom phpShell, SOM emulerer en kommandoprompt ved hjælp AF PHP funktioner. DET ER Maske ikke Arbejde in nogle sidste hosting opsætninger.

Nar du bruger en Sadan Løsning, ER DET ofte ønskeligt på Springe nedtællingen Periode i starten AF scriptet. Pass den <tt>-- Hurtig</ tt> mulighed for på opdateringen script Til at gore DET:

$ Php update.php - Hurtig

Du KAN Bruge "php5" i stedet for "php", hvis forskellige versioner ER installeret. For phpshell KAN commandLine.inc OG LocalSettings.php filer SKAL redigeres, sa scriptet ikke op, fordi phpshell ER en Lober FRA webserveren. DET KAN i stedet be muligt på omgå dette problem ved at Kore:

$ Omstil REQUEST_METHOD; php update.php - Hurtig

Dette unsets den REQUEST_METHOD miljøvariablen, hvis Eksistens der forårsager scriptet på keep op, OG derefter udfører scriptet.

Alternativ 2: Re-run installationsprogrammet
Et alternativ Til på Kore opdateringen script FRA skallen is på genskabe Kore web installeret. DET KAN du gore ved på Folge disse Trin:


 * 1) Omdøb <tt>LocalSettings.php</ tt> Til <tt> LocalSettings.old.php</ tt>
 * 2) Gor <tt>config</ tt> bibliotek skrivbar AF webserveren
 * 3) Sorg for, at Databasen bruger Advocate fulde rettigheder Til Databasen
 * 4) GA Til den wiki, OG start installationsprogrammet
 * Udfyld formularen ny konto MED de samme værdier SOM DET skete i den foregående version's installation.
 * Nar installationen starter, VII, scriptet opdage eksisterende MediaWiki tabeller OG opgradere deres skemaet.
 * Nar This is Færdig, en ny <tt>LocalSettings.php</ tt> VII, blive genereret.
 * 1) Årsagen til problemet den Nye opsætningsfil (<tt>LocalSettings.php</ tt>)
 * 2) Omdøb <tt>LocalSettings.old.php</ tt> Tilbage Til <tt> LocalSettings.php</ tt>
 * 3) Genskabningen tilladelser in <tt>config</ tt> bibliotek

Upgrade extensions
Visse udvidelser er blevet opdateret med henblik på at arbejde med den nye version af MediaWiki. Vær sikker på at opgradere til de nyeste versioner af disse udvidelser. Du skal muligvis foretage manuel opdateringer til tilpassede udvidelser.

Test opdateringen
Når opgraderingen er afsluttet, skal du gå til wiki og kontrollere, at følgende operationer som forventet:
 * Visning af sider
 * Redigering sider
 * Overførsel af en fil

Besøg Speciel: Version, og kontrollere, at den angivne version er korrekte, og at udvidelser er til stede.

Hvor svært ER DET på opgradere?
Hvis den eneste fil, du Order ændret ER LocalSettings.php, OG du opgraderer FRA 1,5 Eller senere, ER processen meget enkel. Mængden AF mennesker der ER involveret Arbejde is Kun et par minutter. Databasen schema AEndringer VII, Tage en TID proportional MED størrelsen in din database - potentielt timer for wikis MED millioner AF sider, mænd OM EN simpel typisk Størrelse in et par tusinde sider, ER DET normalt Gores in fa sekunder.

Mindre opgraderinger inden for samme større version, SiGe FRA 1.13.0 Til 1.13.1, ikke kræver Nøgen skema AEndringer overhovedet. Du KAN bare opdatere filerne.

Opgradering FRA 1,4 Eller tidligere ER potentielt kompliceret, fordi støtte Til André tegnsæt udgangen UTF-8 blev droppet, OG skema Til lagring bulk tekst ændret. Læs venligst de Relevante Afsnit i <tt> UPGRADE <-tt> fil.

Opgradering bliver vanskeligt, hvis du Order ændret vores kildekode, OG du ikke ønsker, at spise AEndringer blive overskrevet. Værktøjer såsom diff OG patch KAN be Nyttige. Der ER også potentiale for problemer, hvis du bruger vedligeholdt extensions. Opgrader din extensions in samme TID SOM du opgraderer MediaWiki.

Hvordan opgraderer jeg FRA EN Rigtig gammel version? Jeg et skridt, Eller i Fri mærkning Trin?
Jeg et skridt, FRA din Gamle version Til den seneste stabile version. Langt de fleste AF rapporterne, Samt automatiseret test viser, at gore DET in da banden virker fint.

Hvis du Administrator problemer TRO dette, KAN du læse This page postliste post.

Skal jeg backup Forst?
Kort svar: ja.

Lang svar: DET afhænger AF a) hvor meget du sætter Pris in DIT data, b) hvor svært DET ER på skabe en sikkerhedskopi, OG c) hvordan Tillid du ER MED MySQL vedligeholdelse OG administration.

En opgradering svigt KAN efterlade din database i en inkonsistent tilstand, i mellem til versioner. DET KAN flytte en vigtig Tabel Til en Midlertidig Your OG derefter svigter, For Det genskaber tabellen korrekt. DET KAN ændre et område, definition AF en urigtig datatype. DET ER meget sjældent, at en opgradering KAN forårsage uoprettelige tab AF data. Oftere, data Korruption opstår, SOM KAN vendes ved en dygtig administrator.

Recovery ER ofte kompleks. Frivillige OM den støtte fora ER usandsynligt, at blive imponeret, hvis du forsømmer at Lave en backup OG derefter brug for hjælp Til at komme væ Morgen, Lys upgrade-Relaterede Korruption. En Bedre Résultat, hvis du KAN vende Tilbage Til din backup, OG derefter [https: / / bugzilla.wikimedia.org / enter_bug.cgi? Produkt = MediaWiki rapportere benytter normalt] i opgraderingen, SOM Order forårsaget Korruption.

KAN jeg beholde mit LocalSettings.php?
Ja, mænd du SKAL Maske har nogle mindre AEndringer. Formatet for LocalSettings.php is Stort sæt bagudkompatibel. AEndringer, der bryder LocalSettings.php kompatibilitet VII, blive dokumenteret i "konfigurationsændringer" i release notes.

KAN min wiki Ophold online, herre DET ER opgradering?
Ja.

Hvis du opgraderer mellem mindre udslip AF MediaWiki, alt Finde du behøver på gore is på opdatere kildefilerne.

Hvis du opgraderer mellem de lagre udsætninger AF MediaWiki, den foretrukne procedure is SOM Folger:


 * 1) Pak den Nye version AF MediaWiki IND i en ny Mappe
 * 2) Forbered på Nye bibliotek: kopiere din nuværende LocalSettings.php FRA Det Gamle Bibliotek, kopiere Alle installerede udvidelser OG tilpassede skind (hvis Nøgen).
 * 3) Aktiver read-only mode i LocalSettings.php AF de Gamle Bibliotek:
 * 1) Kor opgraderingen script i den Nye Mappe.
 * 2) Swap Den Gamle Mappe OG den Nye bibliotek.

((Sprog)) ((Kategorier))