Atualizar o Lizmap Web Client

Upgrading from 3.0 to the 3.1 version

A partir da versões 3.0 e superiores, aqui está a forma de fazer o upgrade.

Backup dos dados

Backup your data into a directory (ex: /tmp) with the lizmap/install/backup.sh script, so you could reinstall them if the installation failed.

lizmap/install/backup.sh /tmp

Se quer fazer o backup manualmente, deverá pelo menos fazer backups aos seguintes ficheiros:

var/jauth.db
var/logs.db
var/config/installer.ini.php
var/config/liveConfig.ini.php (se existir)
var/config/lizmapConfig.ini.php
var/config/localconfig.ini.php
var/config/profiles.ini.php

Substituir os ficheiros lizmap

Obter o ficheiro do lizmap (descarregando o ficheiro ou através de git clone/pull)

Deverá

substituir a pasta lib/ pela nova pasta lib/
substitua os ficheiros na pasta lizmap/ pelos novos ficheiros do lizmap/
If the replacement has erased some files that you’ve been backuped, restore them with lizmap/install/restore.sh /tmp

Execute o instalador

You have to launch the installer, it will upgrade some stuff: database tables, configuration etc..

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

Upgrading from Lizmap 2.x to Lizmap 3.0

Em primeiro lugar, certificar-se de que a instalação do lizmap foi atualizada para a versão mais recente 2.x. A última é a 2.12.

Nesse caso é possível atualizar para o Lizmap 3.0.

Backup dos dados

Fazer um backup dos dados para uma pasta (ex: /tmp).

O Lizmap 2.12.2 e superior dispõe de um script lizmap/install/backup.sh . Correr

lizmap/install/backup.sh /tmp

Se não dispuser deste script, é possível fazer o backup manualmente, copiando estes ficheiros para uma pasta, por exemplo /tmp :

var/jauth.db
var/logs.db
var/config/lizmapConfig.ini.php
var/config/installer.ini.php
var/config/profiles.ini.php

Substituir os ficheiros lizmap

Obter o ficheiro do lizmap (descarregando o ficheiro ou através de git clone/pull)

Deverá

substituir a pasta lib/ pela nova pasta lib/
substituir a pasta lizmap/ pela nova pasta lizmap/

Restaurar dados e instalação de raíz

Restaurar os direitos e o dono de algumas pastas. Aqui está um exemplo em que «myuser» é o utilizador dono do ficheiro da aplicação, e «www-data», o grupo do servidor web.

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

Assim, é possível restaurar o backup, fornecendo o caminho onde o ficheiro de backup foi guardado anteriormente:

lizmap/install/restore.sh /tmp

Nota

Lizmap 3.x requires that *.db files should be stored in var/db/, not in var/ as in 2.x

Última etapa: correr o script de atualização

php lizmap/install/upgrade-to-3.php

Atualização entre versões 2.x

Backup preliminar

Antes da atualização, faça um backup dos dados de configuração: lizmap/var/config/lizmapConfig.ini.php, lizmap/var/jauth.db e o ficheiro de log (a partir da versão 2.8) lizmap/var/logs.db

MYAPP=lizmap-web-client
OLDVERSION=2.8.1 # replace by the version number of your current lizmap installation
# if you installation is 2.1.0 or less, use an empty OLDVERSION instead :
# OLDVERSION=
cp /var/www/$MYAPP-$OLDVERSION/lizmap/var/jauth.db /tmp/jauth.db # user database
cp /var/www/$MYAPP-$OLDVERSION/lizmap/var/config/lizmapConfig.ini.php /tmp/lizmapConfig.ini.php # text configuration file with services and repositories
cp /var/www/$MYAPP-$OLDVERSION/lizmap/var/logs.db /tmp/logs.db # lizmap logs

Em seguida, faça uma instalação típica da nova versão (veja acima), que criará uma nova pasta no diretório /var/www/

Copie os ficheiros guardados na pasta da nova versão

$VERSION=2.10.3
cp /tmp/jauth.db /var/www/$MYAPP-$VERSION/lizmap/var/jauth.db
cp /tmp/lizmapConfig.ini.php /var/www/$MYAPP-$VERSION/lizmap/var/config/lizmapConfig.ini.php
cp /tmp/logs.db /var/www/$MYAPP-$VERSION/lizmap/var/logs.db

Nota

Em algumas versões, também é necessário atualizar a base de dados que armazena as permissões. Consulte o seguinte para obter mais detalhes.

A partir da versão 2.3 ou inferior para a versão 2.4 ou superior

O framework Jelix (ferramenta com a qual o Lizmap Web Client foi construído) foi atualizado. É necessário alterar a base de dados SQLite de gestão de permissões:

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_1.3_1.4.sql

A partir da versão 2.6 ou inferior para a versão 2.7

O suporte para anotações e gestão de permissões relacionadas foi adicionado ao Lizmap Web Client. É necessário alterar a base de dados SQLite de gestão de permissões para proceder à instalação:

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_lizmap_from_2.0_and_above_to_2.5.sql

Da versão 2.7. * à versão 2.8

A ferramenta de edição substituiu a ferramenta de anotação e os campos para descrever cada utilizador do Lizmap Web Client foram adicionados. É necessário atualizar a base de dados SQLite de gestão de permissões:

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_2.7_2.8.sql

A partir da versão 2.8. * para a versão 2.9

A funcionalidade de filtragem de dados de camadas com base na conta do utilizador requer a adição de permissões relativas à base de dados do utilizador:

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_2.8_2.9.sql

Da versão 2.9. * à versão 2.10

A funcionalidade de filtragem de dados de camadas com base na conta do utilizador requer a adição de permissões relativas à base de dados do utilizador:

cd /var/www/$MYAPP-$VERSION/
sqlite3 lizmap/var/jauth.db < lizmap/install/sql/upgrade_jacl2db_2.9_2.10.sql

Eliminar ficheiros temporários do Jelix

rm -rf /var/www/$MYAPP-$VERSION/temp/lizmap/*

Redefinir as permissões para os ficheiros da aplicação

cd /var/www/$MYAPP-$VERSION
chown :www-data temp/ lizmap/var/ lizmap/www lizmap/install/qgis/edition/ -R
chmod 775 temp/ lizmap/var/ lizmap/www lizmap/install/qgis/edition/ -R