Joomla! 1.5 áttelepítési útmutató
A JoomlaWiki wikiből
A Joomla! 1.0-ról 1.5-re történő áttelepítés legtöbb része automatikusan, két lépésben zajlik. Az első lépés a Joomla! 1.0-hoz készült komponensből történő exportálás, majd a második lépés a Joomla! 1.5 telepítőjén keresztüli importálás. A rendszer automatikusan elvégzi a szükséges változtatásokat az adatokban, például a menühöz tartozó paraméterek vagy a tartalmi elemek esetében. Ugyan az adatbázis mentés is használható az áttelepítéshez, ez nem ajánlott az adavesztés lehetősége miatt. Ez a leírás részletesen bemutatja, hogyan végezhetjük el az áttelepítést legkönnyebben.
Megjegyzés: Az áttelepítés megkezdése előtt figyelmesen olvassuk végig az útmutatót az esetleges hibák elkerülése végett!
Tartalomjegyzék |
Előkészületek
Szükség lesz egy működő Joomla! rendszerre, a legújabb Joomla! 1.0 kiadás használata javasolt. Ha 1.0.13-as rendszert használunk, akkor telepítsük Rob Schley munkamenet hibajavítását. Mint mindig, mielőtt bármit elkezdenénk most is készítsünk egy teljes biztonsági mentést az odalról arra az esetre, ha valami rosszul sikerülne. Javasolt megtartani az 1.0-ás telepített rendszert mindaddig, amíg teljesen be nem fejeződik az 1.5-re történő áttelepítés, illetve meg nem bizonyosodtunk arról, hogy a minden működik. Ajánlott az áttelepítést egy teszt rendszeren kipróbálni, mielőtt az éles oldalon végeznénk el.
Ha UTF-8 egybevetésű adatbázist használunk, akkor exportálás előtt bizonyosodjunk meg arról, hogy David Gal UTF-8-ra vonatkozó leírásának utasításai végre lettek hatjva. Ezáltal az SQL fájl UTF-8 formátumú lesz, tehát amikor a Joomla! 1.5 telepítés megfelelő részéhez érünk, a kódolás UTF-8 lesz.
Ha az SQL fájl nem UTF-8 kódolású, akkor szükségünk lesz a szerverre telepített iconv eszközre, amely automatikusan UTF-8 kódolásúra konvertálja a fájlt. Az iconv meglétét a phpinfo 'iconv' szekciójában ellenőrizhetjük (Joomla! 1.0 alatt Rendszer -> Rendszer infó -> PHP Infó, Joomla! 1.5 alatt Súgó -> Rendszerinformáció -> PHP tulajdonságai). Az iconv eszköz egy viszonylag népszerű alkalmazás, így a legtöbb esetben elérhető. Az engedélyezésével kapcsolatos bővebb információért olvassuk el a PHP dokumentációját, vagy keressül fel a tárhely szolgáltatóját.
1. lépés: A Migrator komponens letöltése és telepítése Joomla! 1.0 alá
A Migrator komponens legutóbbi verziója a Pasamio Project oldalán található. A leírás készítésekor a legutóbbi verzió a Migrator 1.5. Töltsük le a Migrator komponenst, majd telepítsük 1.0 alatt, mint ahogyan azt egy normális bővítménnyel tennénk. Ezt követően egy Migrator nevű elem lesz elérhető a Komponensek menü alatt, amellyel hozzáférhetünk a kezelőfelülethez.
2. lépés: Külső fejlesztésű bővítmények Migrator beépülő moduljainak telepítése
Az áttelepítő rendszer csak az alaprendszert kezeli az áttelepítéskor, ami azt jelenti, hogy ha külső fejlesztésű bővítmények tábláit is át akarjuk telepíteni, akkor Migrator beépülő modulokat kell telepíteni az adatok kezeléséhez. Két típusú beépülő modul létezik: az "SQL" beépülő modulok, amelyek egyszerű SQL szövegfájlok, illetve az "ETL" beépülő modulok, amelyek PHP kódot is tartalmaznak és utasítják a Migrator-t, hogyan kezelje a táblákban tárolt (vagy konfigurációs fájlokban lévő) adatokat. Ez úgy történik, hogy kiválasztjuk az "Add Third Party Migrators" opciót, majd feltöltjük a beépülő modul telepítő fájlját. Az SQL fájlok automatikusan bekerülnek a kimenetbe és az ETL beépülő modulok is automatikusan végrehajtódnak. Az ETL beépülő modulok listáját megtekinthetjük alul a "List Plugins"-ra kattintva. Az ETL beépülő modulokat felmásolhatjuk a Joomla! "/administrator/components/com_migrator/plugins" könyvtárába is.
A bővítménytárban található ETL beépülő modulok.
3. lépés: Az áttelepítő SQL elkészítése
Amint telepítettük a külső bővítmények áttelepítő beépülő moduljait, válasszuk ki a "Create Migration SQL file" opciót a folyamat elindításához. A rendszer úgy készült, hogy ne okozzon időbeli kiesést a szerveren, így azt vehetjük észre, hogy az oldal automatikusan frissíti magát és megjeleníti az állapotinformációt. A folyamat befejeződését egy figyelmeztetés jelzi, és az SQL fájl letölthetővé válik. Az SQL fájl készítési folyamatához tartozik a különböző adatbázis mezők módosítása, hogy azok kompatibilisek legyenek a Joomla! 1.5-ben végzett változtatásokkal, beleértve a mosimage címkék átírását.
4. lépés: Joomla! 1.5 telepítése
Megjegyzés: A Joomla! 1.5 telepítését a jelenlegi 1.0 telepítéstől elkülönített könyvtárban és adatbázisban végezzük (vagy más táblaelőtaggal, ha az új tábla létrehozása nem lehetséges). Nem szabad az 1.0 telepítés főkönyvtárába kicsomagolni az 1.5 fájljait, hanem egy új könyvtárat kell neki létrehozni. Nem igazán jó ötlet felülírni az 1.0 fájljait az 1.5 fájljaival, jobb tesztelni az áttelepítést egy elkülönített könyvtárban.
Ha a Joomla! 1.5 már telepítve van, akkor használhatjuk a Migration Assistant nevű komponenst. Fontos azonban megjegyezni, hogy saját magán kívül kitöröl mindent a Joomla! 1.5 adatbázisában, majd visszaállítja a telepítéskori állapotot és elvégzi az áttelepítést. Az 1.5-ös oldal adatbázisában lévő minden adat törlődni fog. A Migration Assistant ugyanazon a helyen érhető el, mint a Migrator, a legutóbbi verzió a Migration Assistant 1.5.2. Előfordulhat, hogy a komponensnek már van későbbi verziója, ezért nézzük meg a Pasamio Project oldalát a frissítésekért.
Ha még nem tettük volna meg, akkor készítsünk egy teljes biztonsági mentést az 1.0-ás oldalról, beleértve a fájlrendszert és az adatbázist is. Ne folytassuk biztonsági mentés nélkül.
Az áttelepítés utolsó lépése az új Joomla! 1.5 telepítése. Az 1.5-öt egy teljesen új könyvtárban kell telepíteni, amely el van különítve az 1.0 könyvtárától. Ha egyszerűen kitömörítjük a már létező 1.0-ás oldal főkönyvtárába, akkor problémákba fogunk ütközni. Tehát vagy helyezzük át a meglévő telepítést, vagy hozzunk létre egy új könyvtárat. A telepítő kezdő lépéseit hajtsuk végre úgy, mint ahogyan azt egy egyszerű telepítés során tennénk. Az utolsó lépésnél, ahol az oldal nevét kell megadni, lehetőség van az áttelepítési folyamat elvégzésére. Az áttelepítéshez az előzőleg elkészített SQL fájlra van szükség, amelyet fel kell tölteni az 1.5-ös oldalra. Ennek két módja lehet:
HTTP feltöltés FTP/SCP feltöltés
Az első módszer, a HTTP feltöltés, kisebb SQL fájlok esetén a legjobb, amelyek nem érik el a PHP feltöltési limit értékét. Az alternatív feltöltési lehetőség az FTP vagy SCP, vagy más egyéb fájl átviteli módszer, amelyet a tárhelyszolgáltató kínál. Ez különösen a nagy SQL fájlok esetén hasznos, amelyek mérete nagyobb, mint a PHP feltöltési limit értéke. A HTTP módszer használatához egyszerűen válasszuk ki a fájlt, mint egy komponens telepítésénél. Az alternatív feltöltési módszer használatakor töltsük fel a fájlt az "/installation/sql/migration" könyvtárba és nevezzük át "migrate.sql"-re. Ha valamilyen ok miatt az áttelepítés nem sikerül, az SQL fájlt újból fel kell tölteni mind a HTTP, mind az FTP/SCP módszer használatakor, ugyanis a fájl módosul az áttelepítés során. A táblaelőtag minden áttelepítő fájl esetén "jos_", ezért ezt kell beírni a szövegmezőbe. Amint befejeződött az áttelepítés, adjuk meg az oldal nevét (az oldal nevének az átvitele technikai okok miatt nem lehetséges) és fejezzük be a telepítést.
Bármelyik módszer használata esetén az "/installation/sql/migration" és az átemeneti (pl. "/tmp") könyvtárnak írhatónak kell lennie az Apache felhasználó által (például "wwwrun", "www-data" vagy "apache"). Arra is figyeljünk, hogy az "Ez egy Joomla! 1.0 áttelepítő parancsfájl." jelölőnégyzet ki legyen jelölve az áttelepítés megkezdése előtt, ellentkező esetben problémák merülhetnek fel az adatok importálásakor.
