Cotonti / Open Source PHP Content Management FrameworkContent Management Framework

Updaten

Documentation / Getting started / Updaten

Uw Cotonti up2date houden, upgraden van een vorige versie of een ander systeem

Dit document helpt u door de nodige stappen om uw Cotonti website up2date te houden. Het maak een veronderstelling dat u enige ervaring heeft met een website onderhouden en het gebruiken van gekende tools zoals phpMyAdmin, FTP, etc.

Het is een goede gewoonte om een backup te maken van uw bestanden en de database alvorens een grote update te doen.

#1. Houd uw Cotonti Siena up-to-date

De meeste updates in de Siena-familie (0.9.x) zijn automatisch. Dus, als u een Siena website heeft en er zijn enkele updates beschikbaar voor de core, modules of plugins, kan u onderstaande stappen volgen.

  1. Kopieer de recentere bestanden naar uw site. Overschrijf de bestaande bestanden met de aangepaste.

  2. Als u install.php verwijderd heeft na de laatste installatie, gelieve dit bestand dan terug te zetten. Als u een volledige Cotonti-pakket update en niet enkel een specifieke module of plugin, maak datas/config.php beschrijfbaar door PHP (meestal betekend dit CHMOD 666 of CHMOD 664).

  3. Start het installatiescript in uw browser, bijvb. http://example.com/install.php

  4. Het script past automatisch veranderingen toe in config.php, kijkt na voor SQL patches en update ze, kijkt na over er updates zijn voor alle geinstalleerde modules en plugins en past ze toe. Indien er fouten optreden, worden deze weergegeven met een rode achtergrond. Normale updates worden weergegeven met een groene achtergrond. Gelieve ondersteuning te vragen in de fora als u errors tegenkomt tijdens de installatie.

  5. Nadat de update succesvol is uitgevoerd, mag u install.php verwijderen tot de volgende update en pas de schrijfbaarheid van datas/config.php terug aan (CHMOD 644).

Nota voor extensie-ontwikkelaars: Het update-script detecteert verandereingen in modules en plugins door het vergelijken van hun versie-nummer met deze die beschikbaar is in de database. Het vergelijkt geen actuele bestanden en zoekt niet naar patches. 
Indien u de setup aanpast van uw extensie (configuratie, standaard toestemmingen, etc.), de hooks of extensie-onderdelen aanpast, SQL of PHP patches toevoegd, vergeet dan niet het versie-nummer te verhogen in het extensie-setup bestand zodat het script weet dat er iets aan te passen is.

#2. Upgraden van Cotonti Genoa

Het is mogelijk om een bestaande Genoa installatie te upgraden naar Siena. Configuratie en de database zullen automatisch geconverteerd worden. En ook de modules en plugins welke geupdate zijn voor Siena. Oude Genoa en Seditio plugins zullen gedeactiveerd worden tijdens de upgrade, omdat ze een convertie naar Siena of een speciale compatibiliteitsplugin vereisen.

Volg de volgende stappen om uw site up te graden:

  1. Backup de bestanden en de database. Dit wordt streng aanbevolen. Als er iets mis gaat, kan u uw site herstellen d.m.v. een backup.

  2. Kopieer de Siena bestanden over de bestaande Genoa-structuur. Overschrijf oude bestanden.

  3. Maak datas/config.php beschrijfbaar door PHP (meestal betekend dit CHMOD 666 of CHMOD 664).

  4. Start het installatiescript in uw browser, bijvb. http://example.com/install.php

  5. Hierna zal uw site omgevormd zijn naar Siena. Dit kan enige tijd in beslag nemen, afhankelijk van de hoeveel data. Indien er fouten optreden, worden deze weergegeven met een rode achtergrond. Normale updates worden weergegeven met een groene achtergrond. Gelieve ondersteuning te vragen in de fora als u errors tegenkomt tijdens de installatie.

  6. Nadat de update succesvol is uitgevoerd, mag u install.php verwijderen tot de volgende update en pas de schrijfbaarheid van datas/config.php terug aan (CHMOD 644).

De website-thema zal veranderd worden naar Nemesis, de development/fallback thema van Siena. Dit is omdat skins nu thema's genoemd worden, ze bevinde zich in een andere folder en aanpassingen zijn veresit om een Genoa skin om te vormen naar een Siena thema.

Plugins die niet zijn omgevormd naar Siena zijn gedeactiveerd tijdens de upgrade. Wanneer een plugin een Sienaversie krijgt, kan u de bestanden overschrijven en installeren via Administration => Extensions. Indien uw site hard afhangt van Genoa plugins, kan u een gedeeltelijke backwards compatibiliteit verkrijgen door het installeren van de Geno plugin via Administration => Extensions.  Hierna kan u Genoa plugins installeren en gebruiken. Het totale functionaliteit is niet gegarandeerd maar Cotonti zal zijn best doen om oude APIs te voorzien voor deze plugins. Dit heeft wle een performance nadeel, gelieve dit dan ook enkel als tijdelijke maatregel te gebruiken totdat de plugin omgevormd is naar Siena.

Genoa skins en plugins omvormen naar Siena valt buiten de scope van deze gids, gelieve te refereren naar een specifiek hoofdstuk over dit onderwerp.

Waarschijnlijk moet u parsers en editors configureren voor uw site. Lees dit artikel hierover.

#2.1. Upgraden van Seditio

Upgraden van Seditio naar Cotonti Genoa is vereist als u wilt upgraden naar de laatste versie van Cotonti. Dit is hoe u kan upgraden van Seditio naar Cotonti Genoa:

  1. Zorg er eerst voor dat uw Seditio site gebruik maakt van v126 of v130, upgraden van vroegere versies is niet ondersteund.

  2. De Seditio database moet geconverteerd zijn naar UTF-8 characterset. Kijk de Seditio documentatie na of zoek op internet als u hulp nodig heeft.

  3.  Pak de laatste versie van Cotonti Genoa uit en overschrijf de Seditio bestanden.

  4. Open phpMyAdmin en pas de SQL patches toe die zich bevinden in de sql folder in de volgende volgorde:

    • patch-125-n-0.0.1.sql

    • patch-0.0.1-0.0.2.sql

    • patch-0.0.2-0.0.3.sql

    • patch-0.0.3-0.0.4.sql

    • en zo verder in oplopende volgorde van versie nummers patch-A.B.C-D.E.F.sql

  1. Kopieer sql/patch-0.6.txt naar patch.php in de site root. Start het in een browservenster, bijvb. http://example.com/patch.php. Verwijder hierna patch.php.

  2. Open datas/config-sample.php en datas/config.php, kopieer de nodige veranderingen van config-sample.php naar config.php.

Na het upgraden van uw site naar Genoa en enkele testen, kan u de site upgraden naar Siena zoals beschreven in het vorige hoofdstuk.



1. Eugene  2012-01-28 23:15

Thanks: 0

в части Genoa-Siena пункт 5 не совпадает с англ.версией. Лично у меня при обновлении с  Genoa 0.6.2 -> Siena 0.9.7(testing) скрипт не спрашивал о парсинге.

Сразу после апгрейда шикарно законвертил форумы и страницы в HTML.

Благодарность за удобный инструмент!

2. Dayver  2012-04-05 09:17

Thanks: 0

Документ не раскрывает вопроса как нужно обновлять - поетапно:

Если например установлена Siena 093 то нужно поочереди обновлять до 094 потом 095 и так далее до последней

или

Если например установлена Genoa 0.6.18 то нужно обновить до 0.6.19 потом 0.6.20 и аж до последней генуи а потом с нее на последнюю сиену?

 

Или же инструмент обновит с любой текущей версии движка до послелней сиены (или генуи в зависимости от требуемого конечного результата)????

3. Trustmaster  2012-04-08 17:53

Thanks: 0

С Genoa на Siena этапы описаны подробно, читайте внимательнее. В ветке Siena происходит обновление с любой версии на последнюю.

4. Oughtem  2012-06-22 17:36

Thanks: 0

фраза "скрипт.... проверит на наличие обновлений для всех установленных модулей и плагинов и применит доступные." не понятна. Имеются ввиду стандартные плагины и расширения?

5. Trustmaster  2012-06-22 18:34

Thanks: 0

Все установленные. Проверит, имеются ли патчи на диске, а не на сайте-источнике.

6. CrazyFreeMan  2015-01-16 21:54

Thanks: 0

"Если вы удалили файл install.php из корневой папки после предыдущей установки/обновления, восстановите его сейчас. "

Пункт не понятный, если у меня версия к примеру 9.16 файл я удалил инстал, теперь хочу обновится до 9.17 то мне нужно взять файл инстал с старой версии и его запустить? и после обновитсядо 9.18 нужно взять файл инстал от 9.17 ?

7. Dayver  2015-01-17 00:02

Thanks: 1

Нет, со старой ничего брать не нужно. Этот пункт как дополнение-уточнение к первому, тоесть имелось ввиду что если вы, например, имеете сайт на 0.9.16 и допустим используете не все 28 плагинов которые шли в коробке с двигом, а только к примеру 10, а остальные 18 не просто выключены в админке а и удалены с фтп физически, соответвенно при обновлении например до 0.9.17 или например сразу к 0.9.18 (минуя 0.9.17 - ведь можно и так) вы конечно можете тупо залить все файлы из архива 0.9.18 поверх старых, но ведь зачем заливать\обновлять например те 18 плагинов которые вы не использовали в предыдущей версии и естественно не нужны в новой потому логичнее из архива новой версии вы будете заливать поверх старых только 10 плагинов. Но с файлом install.php (и папкой setup - которую я так же как и install.php тоже сразу удаляю с сервера после установки\обновления двига) не так. Если во время установки 0.9.16 вы этот файл не удалили (а его стоит удалять) то при обновлении до 0..9.18 вы его должны перезалить новым из архива новой версии, а если удалили тогда всеравно взять и залить из архива с новой версией ибо он нужен будет для процеса обновления. Обновление провели и сразу удалили файл install.php (и папку setup - я так делаю) ибо они уже не нужны, а когда в следующий раз будете обновлятся то возмете их из новой версии. Может немного сумбурно но постарался пояснить детально что и почему, если всеравно вопросы возникнут - задавайте на форуме.

8. Dave  2017-08-26 14:04

Thanks: 0

help...

Fatal error: Uncaught exception 'PDOException' with message 'SQLSTATE[HY000] [2002] Connection refused' in /home/dave69/www/system/database.php on line 79( ! ) PDOException: SQLSTATE[HY000] [2002] Connection refused in /home/dave69/www/system/database.php on line 79Call Stack#TimeMemoryFunctionLocation10.0005260920{main}( )../install.php:020.01681834352CotDB->__construct( )../install.php:10830.01681834816__construct ( )../database.php:79

Totaal: 8, op pagina: 8

Alleen geregistreerde gebruikers kunnen reacties plaatsen.