Aktualizace webového klienta Lizmap

Aktualizace z verze Lizmap 2.x

Aktualizace z verze Lizmap nižší než 3.5

Nejprve byste měli přejít na verzi 3.5. Viz dokumentace Lizmap 3.5. Poté můžete přejít na verzi 3.6.

Aktualizace z Lizmap 3.5 pomocí migračního skriptu

Od verze Lizmap 3.6.2 existuje skript lizmap/install/migrate_from_3_5.sh, který velmi pomáhá při přechodu z verze Lizmap 3.5. Manipuluje se soubory lizmap a automaticky aktualizuje některé další moduly.

Archiv Lizmap 3.6 získáte stažením archivu na stránce release.

Adresář lizmap/ z Lizmap 3.5 byste pak měli přejmenovat například na lizmap35.bak/:

mv lizmap lizmap35.bak

Poté rozbalte adresář lizmap/ z archivu, takže se stane novým adresářem lizmap/.

Poté spusťte lizmap/install/migrate_from_3_5.sh zadáním cesty k předchozímu adresáři lizmap. Příklad:

cd lizmap/install
./migrate_from_3_5.sh ../../lizmap35.bak

Poté můžete spustit instalační program

php installer.php -v
sudo clean_vartmp.sh

Pokud nedojde k chybě, měla by se v prohlížeči zobrazit běžící aplikace Lizmap 3.6. Poté můžete smazat lizmap35.bak a lib/ (v Lizmap 3.6 již není adresář lib/).

Pokud se během aktualizace vyskytne nějaká chyba a nenajdete řešení, stačí smazat nový adresář lizmap a přejmenovat starý adresář lizmap.

mv lizmap lizmap36.bak
mv lizmap35.bak lizmap

Můžete znovu použít Lizmap 3.5 nebo zkusit níže popsaný ruční upgrade.

Ruční aktualizace z Lizmap 3.5

Zde naleznete návod, jak provést upgrade z verze Lizmap 3.5.

Záloha dat

Zálohujte svá data a konfigurační soubory do adresáře (např.: /tmp) pomocí skriptu lizmap/install/backup.sh z Lizmap 3.5.

lizmap/install/backup.sh /tmp

Pokud chcete zálohovat ručně, měli byste zálohovat alespoň tyto soubory:

var/db/jauth.db (pokud existuje)
var/db/logs.db (pokud existuje)
var/config/installer.ini.php
var/config/liveConfig.ini.php
var/config/localframework.ini.php (pokud existuje)
var/config/lizmapConfig.ini.php
var/config/localconfig.ini.php
var/config/profiles.ini.php

Nahrazení souborů Lizmap

Archiv Lizmap získáte stažením archivu na stránce release.

Pak byste měli :

přejmenujte adresář lizmap/ na lizmap.bak/ například
rozbalí adresář lizmap/ z archivu, takže se stane novým adresářem lizmap/.
proveďte skript lizmap/install/restore.sh /tmp nebo ručně přeinstalujte zálohované soubory.

Poznámka: adresář lib/ již neexistuje.

Aktualizace dalších modulů

Pokud jste některé moduly nainstalovali do lizmap/my-packages nebo do lizmap/lizmap-modules, musíte je aktualizovat. Pravděpodobně existují nové verze pro Lizmap 3.6. Přečtěte si dokumentaci k těmto modulům.

Spuštění instalačního programu

Musíte spustit konfigurátor (provede upgrade některých konfiguračních souborů) a poté instalátor, který provede upgrade některých věcí: databázových tabulek, dat atd..

sudo lizmap/install/clean_vartmp.sh
php lizmap/install/configurator.php
php lizmap/install/installer.php

Čištění a testování

Poté byste měli odstranit všechny mezipaměť a dočasné soubory:

sudo lizmap/install/clean_vartmp.sh

Pak byste měli zavolat skript, který nastavuje práva k souborům. Parametry jsou webový uživatel a webová skupina, které webový server používá ke spuštění Lizmap. Na serveru Debian je to často www-data.

sudo lizmap/install/set_rights.sh www-data www-data

Poté načtěte Lizmap do prohlížeče a mapy by se měly zobrazit bez chyb.

V takovém případě můžete smazat staré adresáře lib/` a lizmap.bak/.

Migrace ze Sqlite na Postgresql

Je možné, že jste nainstalovali Lizmap se Sqlite. Pak byste měli mít tyto soubory lizmap/var/db/jauth.db a lizmap/var/db/logs.db, kde jsou uložena některá data, jako jsou uživatelé, oprávnění a logy. A tuto konfiguraci byste měli mít v lizmap/var/config/profiles.ini.php:

[jdb:jauth]
driver=sqlite3
database="var:db/jauth.db"

[jdb:lizlog]
driver=sqlite3
database="var:db/logs.db"

Pokud máte takovou konfiguraci, můžete data migrovat do databáze Postgresql.

Nejprve vytvořte databázi Postgresql a poté změňte konfiguraci v souboru :lizmap/var/config/profiles.ini.php nastavením přístupových parametrů k databázi Postgresql. Doporučujeme vytvořit do databáze schéma, například lizmap , pokud již obsahuje nějaké tabulky.

Například :

[jdb:jauth]
driver=pgsql
host=localhost
port=5432
database="your_database"
user=my_login
password=my_password
search_path=lizmap,public

[jdb:lizlog]
driver=pgsql
host=localhost
port=5432
database="your_database"
user=my_login
password=my_password
search_path=lizmap,public

Další informace o těchto parametrech naleznete v kapitole o instalaci.

Poté můžete spustit tyto skripty, které provedou migraci dat.

php lizmap/console.php database:migrateusers
php lizmap/console.php database:migratelog

Pokud se neobjeví žádné chyby, můžete pomocí prohlížeče přejít na lizmap a zkontrolovat, zda se můžete ověřit. Měli byste také vidět seznam uživatelů v panelu administrace. Pokud tomu tak je, můžete si zazálohovat soubory jauth.db a logs.db a můžete je smazat.

Pokud se něco pokazí a nemůžete problém vyřešit, vraťte přístup k databázi do lizmap/var/config/profiles.ini.php jako dříve, například takto :

[jdb:jauth]
driver=sqlite3
database="var:db/jauth.db"

[jdb:lizlog]
driver=sqlite3
database="var:db/logs.db"

A Lizmap by měl fungovat dobře, ale stále s Sqlite.

Aktualizace na nižší verzi Lizmap 3.6

Může být vydána nová verze Lizmap 3.6 (3.6.1, 3.6.2 atd.). Abyste mohli využívat vylepšení a opravy chyb, měli byste aktualizovat svou stávající instanci Lizmap 3.6.

Záloha

Pro případ, že by se aktualizace nezdařila, je dobré si předtím zazálohovat celý adresář lizmap.

cp -a lizmap lizmap.bak

pokud se aktualizace nezdaří, smažte adresář lizmap a spusťte jej:

mv lizmap.bak lizmap

Nahrazení souborů Lizmap

Archiv Lizmap získáte stažením archivu na stránce release.

Poté můžete z archivu rozbalit adresář lizmap/, který přepíše všechny soubory kromě lizmap/var/`.

Spuštění instalačního programu

Musíte spustit konfigurátor (v případě potřeby aktualizuje některé konfigurační soubory) a poté instalační program, který aktualizuje některé věci: databázové tabulky, data atd..

sudo lizmap/install/clean_vartmp.sh
php lizmap/install/configurator.php
php lizmap/install/installer.php

Obnoví práva k souborům uvedením webového uživatele a webové skupiny používané webovým serverem.

sudo lizmap/install/set_rights.sh www-data www-data

Poté načtěte Lizmap do prohlížeče a mapy by se měly zobrazit bez chyb.

V takovém případě můžete smazat starý adresář lizmap.bak/.