Johdanto

Tämä on vapaa suomennos/ohjeistus tekstistä, joka löytyy sivulta
http://docs.joomla.org/Migrating_from_1.0.x_to_1.5_Stable

Jotta migraatio olisi ymmärrettävä jokaiselle, olen lisännyt tekstin sekaan muutamia kuvia eri vaiheista.

HUOM! Lue ohjeistus läpi pariin kertaan ennen kuin aloitat migraation. Jos mahdollista, testaa tai harjoittele migraatiota kehitysympäristössä. Live sivustolle meno testaamisen jälkeen on huomattavasti helpompaa. Ennen kuin teet mitään, ota varmuuskopio sivustostasi, jolle aiot migraation suorittaa. Ok, aloitetaan.

Migraatio Joomla! 1.0.x versiosta Joomla! 1.5.x versioon käsittää käytännössä kaksi vaihetta. Ensimmäisessä vaiheessa migraatio-komponentti asennetaan Joomla! 1.0.x sivustolle ja toisessa vaiheessa komponentin tuottama sql-tiedosto viedään uudelle J! 1.5.x sivustolle J! 1.5.x asennusohjelman avulla (migraatio). Hyvin paljon tietoa on muuttunut versioiden 1.0.x ja 1.5.x välillä, joten tämä koko prosessi on automatioistu. Tämä ohjeistus tähtää mahdollisimman helppoon ja vaivattomaan migraatioon.

Alkulämmittelyt

Sinulla pitää tietenkin olla toimiva Joomla! sivusto. Suositeltavaa on, että sivustosi on viimeisintä versiota eli J! 1.0.15. Jos käytät versiota 1.0.13, asenna Rob Schleyn patchi admin istunnon bugiin.
http://forum.joomla.org/index.php/topic,200725.0.html

Muistutan, ota varmuuskopio nykyisestä sivustostasi, varmuuden vuoksi jos jotain menee pieleen. On suositeltavaa, että et tuhoa J! 1.0.x asennusta/sivustoa ennen kuin olet suorittanut migraation kokonaisuudessaan loppuun ja varmistunut siitä, että uusi J! 1.5.x sivustosi toimii oikein.

Jos olet käyttänyt J! 1.0.x sivustollasi UTF-8 tietokantaa, seuraa David Gal'in UTF-8 ohjeistusta
http://forum.joomla.org/viewtopic.php?f=11&t=55065

Valitettavasti edellä mainittujen linkkien tekstejä/ohjeistuksia en aio kääntää.

Vaihe 1: Migraatio komponentin lataaminen ja asentaminen

Viimeisin versio migraatio komponentista (tätä kirjoittaessa se on Migrator 1.1) löytyy Sam Moffatin "Pasamio Project's FRS" -sivustolta (joomlacode)
http://joomlacode.org/gf/project/pasamioprojects/frs/

Lataa tiedosto migrator.zip omalle koneellesi ja asenna se Joomla!asi normaalia komponentin asennustapaa noudattaen (Admin backend > Installers > Components > Upload package file - Browse > Valitse migrator.zip > Upload file and install. Jos/kun asennus onnistui näet onnitteluviestin "Upload component - Success".

Mene Components > Migrator ja näet seuraavan näkymän:



1. Asenna tämä komponentti (kirjoittajan huom! Olet sen jo tehnyt)
2. Asenna kolmansien osapuolten ETL liitännäiset ja tietokantataulun tekoon vaadittavat tiedostot
3. Aja migraatio prosessi
4. Lataa migraatio prosessin tuottama SQL-tiedosto omalle koneellesi
5. Lataa migraatio prosessin tuottama SQL-tiedosto Joomla! 1.5.x asennuksen yhteydessä
6. Jos sinulla ei ole kolmansien osapuolten komponentteja, olet valmis
7. Manuaalisesti asenna erikois migraatioasennus-tiedostot J! 1.5.x sivustollesi (asennuspaketit SQL "LUO TAULU JOS EI OLE" julkilausumalla)

Huomaa: Emme voi taata, että kolmannen osapuolten lisäosat tulevat toimimaan kunnolla. Joomla! 1.5.x muuttaa paljon toiminnallisuutta Joomla!n sisällä ja jotkin kohdat poistetaan. Tämä prosessi tekee lähes täydellisen tietokanta muutoksen/siirron uudelle J! 1.5.x sivustollesi, mutta joitakin asetuksia ei voida siirtää, joten ne pitää asettaa manuaalisesti jälkikäteen.

Kuvan punaisten tekstien (linkkien) selitykset:

3rd Party Information - Tietoa kolmansien osapuolten lisäosien siirrosta

Jos sinulla on kolmansien osapuolten komponentteja niin oletuksena tämä migraatio EI siirrä näiden dataa. Kuitenkin on mahdollista, että komponentin tekijä on tehnyt migraatio liitännäisiä, jotka voit asentaa migraation yhteydessä ja jonka tuloksena saat siirrettyä tarvitsemasi komponentin tiedot (hakemistot/tiedostot sekä tietokantataulut) uudelle J! 1.5.x sivustollesi.

Voit asentaa näitä liitännäisiä seuraavan kaavan mukaan:
1. Lataa kaikki tablename.php (taulunnimi.php) tiedostot hakemistoon administrator/component/com_migrator/plugins
2. Lataa kaikki componentname.sql (komponentinnimi.sql) tiedostot hakemistoon administrator/component/com_migrator/tables


Add 3rd Party Migrators - Asenna kolmansien osapuolten migraatiotiedostot


Jos sinulla on vain muutama kolmannen osapuolen lisäosa, voit käyttää alla olevaa lomaketta asentaaksesi tiedostot manuaalisesti. Jos sinulla on pääsy palvelimelle, voit asentaa tiedostot niiden oikeisiin paikkoihin (plugins ja tables) käyttäen esim. ftp-ohjelmaa tai Joomla!an asennettua joomlaXplorer-komponenttia. Migraatio prosessi käyttää vain niitä tiedostoja, jotka sijaitsevat edellä mainituissa hakemistoissa.

Selaa (Browse) ja etsi tiedosto ja lataa se (Upload Plugin).

Huomaa, että jokainen tiedosto asennetaan alla olevan lomakkeen avulla yksitellen. Jos siis olet ladannut omalle koneellesi pakatun tiedoston, sinun pitää purkaa se ensin.
Toinen huomautus! Sinun pitää varmistaa, että tarvitsemasi kolmannen osapuolen lisäosa toimii Joomla!n versiossa 1.5.x ja että migraatio ko. lisäosan kohdalla on mahdollista (joko käyttäen migraatio tiedostoja tai ei).

List Plugins - Lista migraatio liitännäisistä

Oletuksena tämä lista pitää sisällään Joomla!n core tiedot. Kun olet ladannut kolmansien osapuolten migraatio liitännäisiä niin niidenkin pitäisi näkyä listassa.

Download Files - Lataa tiedosto(t)

Lataa migraation tuottama sql-tiedosto.
Huomaa, että voit tehdä erilaisia sql-tiedostoja, jos sellaiseen on tarvetta. Tämän voit todeta kohdasta "Create Migration SQL File", jossa voit valita mitä tietoja siirretään uuteen 1.5.x sivustoon.
Tämä kohta on tyhjä niin kauan kunnes olet luonut ensimmäisen sql-tiedoston.

Purge Migrator Tasks - Tämän kohdan merkitys ei ole selvinnyt minulle (vielä)

Create Migration SQL File - Luo migraatio SQL -tiedosto

Aluksi näet listauksen kaikista niistä siirrettävistä tiedoista, jotka on mahdollista siirtää. Nyt voit siis valita, mitä haluat siirtää. Yleensä tietenkin valitaan kaikki.

Kun olet varma, että kaikki on valmista, klikkaa/napsauta "Start migration". Kun SQL-tiedosto on luotu, saat ilmoituksen "Migration Complete!". Voit ladata luodun SQL-tiedoston klikkaamalla kohdasta "Download" tai jos klikkaat ensin "Home" niin sitten kohdasta "Download Files".

Työskentelysi vanhalla sivustollasi (J! 1.0.x) on lähes lopussa. Eli kuvan mukaisesti



klikkaa "Download" ja tarvitsemasi SQL-tiedosto on käytettävissä J! 1.5.x asennuksen yhteydessä.


Vaihe 2: Kolmansien osapuolten liitännäisten asentaminen

Katso kohta
3rd Party Information - Tietoa kolmansien osapuolten lisäosien siirrosta

Kolmansien osapuolten liitännäisiä on kahta lajia:
"SQL" liitännäinen, joka on puhdas sql teksti tiedosto
"ETL" liitännäinen, joka kertoo migraatiokomponentille, miten tallennettua dataa käsitellään

Klikkaa siis linkistä "Add Third Party Migrators" ja lataa haluamasi liitännäiset. Voit katsoa ETL liitännäisten listaa klikkaamalla linkistä "List Plugins".

Vaihe 3: Migraatio SQL -tiedoston luonti

Kun olet asentanut kolmansien osapuolten migraatio liitännäiset, voit aloittaa migraatio SQL -tiedoston luonnin klikkaamalla "Create Migration SQL file". Prosessi on suunniteltu niin, että palvelimelta ei pitäisi tulla aikakatkaisua. Tulet huomaamaan, että sivu päivittyy automaattisesti ja näyttää tilanne informaation. Hetken kuluttua saat tiedon, että migraatio SQL -tiedoston luonti on onnistunut ja SQL-tiedosto on ladattavissa (katso kohta Create Migration SQL File - Luo migraatio SQL -tiedosto).

Vaihe 4: Joomla! 1.5.x asennus

(Tätä kohtaa en ole kääntänyt kokonaan, vaan olen tuonut esille sen kaikista helpoimman tavan suorittaa uuden Joomla!n asennus)

HUOM! Luo nykyisen sivustosi juureen uusi hakemisto, johon asennat uuden sivustosi (J! 1.5.x). Tällä tavalla nykyinen sivustosi pysyy koskemattomana ja voit testata uuden sivustosi toimivuutta ennen kuin siirrät sen oikealle paikalle (useimmiten juureen). Normaali J! asennushan käsittää viimeisimmän J! version lataamisen omalle koneelle, pakatun tiedoston purkamisen ja puretusta tiedostosta löytyvien hakemistojen ja tiedostojen viennin palvelimelle (edellä mainittu ja luotu hakemisto). Luo tulevalle Joomla! 1.5.x sivustollesi tietokanta ja sille käyttäjä ja salasana.

Kun olet siirtänyt Joomla_1.5.x-Stable-Full_Package hakemistot ja tiedostot haluamaasi hakemistoon, avaa selainikkuna ko. osoitteessa ja aloita asennus. Prosessi noudattaa Joomla!n normaalia asennustapaa lähes loppuun saakka.
1. Valitse kieli
2. Järjestelmän tarkistus
3. Hyväksy lisenssi
4. Tietokannan asetukset (tietokannan tyyppi, palvelimen nimi, käyttäjän nimi, salasana ja tietokannan nimi)
5. FTP-asetukset (ota käyttöön tai älä ota)
6. Perusasetukset (tämä kohta on kaikista tärkein)

Asenna esimerkkiartikkelit tai aja sisällön muuntava muunnosskripti (klikkaa kuva suuremmaksi)

Älä asenna esimerkkiartikkeleita vaan laita ruksi kohtaan "Lataa sisällön muunnosskripti"
Lisää "Taulujen vanha etuliite", useimmiten jos_
Valitse "Vanhan sivuston enkoodaus", useimmiten iso-8859-1
Selaa ja valitse "Sisällön muunnosskripti", eli se migraatio sql -tiedosto, jonka latasit nykyiseltä (tulevalta vanhalta) sivustoltasi
Laita ruksi kohtaan "Tämä on Joomla! 1.0 muunnosskripti "
Klikkaa "Vie palvelimelle ja suorita"

Huomaa, että sinun ei tarvitse tässä kohtaa (Lataa sisällön muunnosskripti) antaa sivustolle nimeä.

Kun saat ilmoituksen "Muunnos onnistui, napsauta seuraava-painiketta jatkaaksesi" tee niin kuin käsketään. Huomaat, että palaat takaisin kohtaan 6. Perusasetukset. Anna sivustolle nimi ja klikkaa seuraava. Saat ilmoituksen " Ylläpitoliittymän kirjautumistiedot
Käyttäjätunnus: Ylläpitäjän käyttäjätunnus säilytettiin päivitetyssä sisällössä".

Poista installation-kansio ja surffaa uusille Joomla! 1.5.x sivuillesi. Tämän jälkeen sivupohja kohdalleen ja sivuston tarkistus. Kun kaikki on ok, niin on hyvä ottaa uusi varmuuskopio.

Tässä vaiheessa sinulla on siis kaksi eri versiota sivustostasi, J! 1.0.x ja J! 1.5.x. Nyt uusi sivusto siirretään juureen. Mutta ennen sitä, mieti, mitä haluat tehdä vanhalle sivustolle. Toki sinulla on varmuuskopio olemassa ja jonka voi palauttaa tarvittaessa, mutta henkilökohtainen mielipide tässä kohtaa on seuraava.

Luo toinen uusi hakemisto sivustosi juureen, voit nimetä sen vaikka "vanhasivusto". Siirrä alkuperäinen sivusto (J! 1.0.x) tuohon vanhasivusto-hakemistoon, se on siellä hyvässä tallessa. Tämä siirto onnistuu erittäin helposti ftp-ohjelmalla. Kun edellä mainittu siirto on valmis, siirrä uusi sivustosi (J! 1.5.x) alihakemistosta juureen. Ko. alihakemiston tulee olla tyhjä siirron jälkeen (varmistus siitä, että uusi sivusto on siirretty kokonaisuudessaan uuteen paikkaan).

Tämän jälkeen lataat ftp-ohjelmalla uuden sivustosi configuration.php tiedoston omalle koneellesi ja muokkaat seuraavat rivit:
var $log_path = '';
var $tmp_path = '';
vastaamaan oikeita polkuja

Tähän kohtaan esitän kysymyksen. Pitääkö rivi
var $live_site = '';
täyttää myös?

Itse olen tehnyt nyt kaksi migraatiota, toiseen laitoin arvon ja sivusto futaa ok. Toiseen laitoin, mutta otin pois, kun sivusto ei toiminut oikein, ilman arvoa toimii ihan ok.

EDIT 5.3.2009: Tähänkin saatiin sitten vastaus; ketju joomlaportal.fi foorumilla.

Älä yritä asentaa uutta sivustoasi olemassa olevan päälle.
Vaiheessa 4 mainitaan Migrator assistant, tähän en ole tutustunut ollenkaan.
Jos jokin meni vikaan asennuksessa, tuhoa Joomla! asennus sekä tietokannan taulut ja aloita alusta.

SUMMA SUMMARUM

Edellä oleva sepustus saattaa tuntua pitkältä ja hankalalta, mutta todellisuudessa migraatio on melko yksinkertainen juttu, kunhan sen on ensin jollakin tavalla sisäistänyt (ja parhaimmassa tapauksessa testannut). Lyhyt yhteenveto on kuitenkin paikallaan.

1. Ota varmuuskopio sivustostasi
2. Lataa migrator komponentti ja asenna se nykyiselle sivustollesi
3. Asenna kolmansien osapuolten migraatio tiedostot
4. Aja (luo) migraatio SQL -tiedosto ja lataa se omalle koneellesi
5. Luo alihakemisto palvelimelle ja siirrä siihen J! 1.5.x hakemistot ja tiedostot
6. Luo uudelle sivustollesi tietokanta ja sille käyttäjä salasanan kera
7. Avaa selain ko. osoitteessa ja aloita Joomla!n asennus
8. Kun pääset kohtaan Perusasetukset, aja sisällön muuntava muunnosskripti, suorita asennus loppuun
9. Poista installation-kansio
10. Säädä sivusto kuntoon
11. Luo toinen alihakemisto ja siirrä alkuperäinen sivusto siihen
12. Siirrä uusi sivustosi juureen (missä alkuperäinen sivustosi oli tai missä haluatkin uuden sivustosi sijaitsevan)
13. Muokkaa configuration.php tiedosto
14. Have fun!

Palaute tähän viestiketjuun.