Lizmap Web Clientのアップグレード

Lizmap 2.xからのアップグレード

Lizmap 3.5以前のバージョンからのアップグレードについて

You should first migrate to 3.5. See documentation of Lizmap 3.5. Then you could migrate to 3.6.

Upgrading from Lizmap 3.5 with the migration script

Since Lizmap 3.6.2, there is a script lizmap/install/migrate_from_3_5.sh that helps a lot to migrate from Lizmap 3.5. It manipulates lizmap files, and upgrade automatically some additional modules.

Get the Lizmap 3.6 archive by downloading an archive on the release page.

You should then rename the lizmap/ directory of Lizmap 3.5 to lizmap35.bak/ for example:

mv lizmap lizmap35.bak

Then extract the lizmap/ directory from the archive, so it will be become the new lizmap/ directory.

Then launch lizmap/install/migrate_from_3_5.sh by given the path to the previous lizmap directory. Example:

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

Then, you can launch the installer

php installer.php -v
sudo clean_vartmp.sh

If there is no error, you should see Lizmap 3.6 in action into your browser. You can then delete lizmap35.bak and lib/ (there is not anymore a lib/ directory into Lizmap 3.6).

If there are some error during the upgrade, and you don't find a solution, just delete the new lizmap directory, and rename the old lizmap directory.

mv lizmap lizmap36.bak
mv lizmap35.bak lizmap

You can use Lizmap 3.5 again, or try the manual upgrade described below.

Upgrading manually from Lizmap 3.5

Lizmap3.5からのバージョンアップ方法は以下の通りです。

データのバックアップ

Lizmap 3.5の lizmap/install/backup.sh スクリプトで、データや設定ファイルをディレクトリ（例： /tmp ）にバックアップしてください。

lizmap/install/backup.sh /tmp

手作業でバックアップする場合は、少なくともこれらのファイルをバックアップする必要があります。

var/db/jauth.db (if it exists)
var/db/logs.db (if it exists)
var/config/installer.ini.php
var/config/liveConfig.ini.php
var/config/localframework.ini.php (あるならば）
var/config/lizmapConfig.ini.php
var/config/localconfig.ini.php
var/config/profiles.ini.php

Lizmapファイルの置き換え

‎Lizmap アーカイブを入手するには、 release <https://github.com/3liz/lizmap-web-client/releases> _ ページでアーカイブをダウンロードしてください。‎

次のことを行う必要があります‎：

rename the lizmap/ directory to lizmap.bak/ for example
アーカイブから lizmap/ ディレクトリを展開し、新しい lizmap/ ディレクトリにします。
lizmap/install/restore.sh /tmp スクリプトを実行するか、バックアップしたファイルを手作業で再インストールしてください。

注意: lib/ ディレクトリはもう存在しません。

Updating additional modules

If you installed some modules into lizmap/my-packages or into lizmap/lizmap-modules, you must update them. There are probably new versions for Lizmap 3.6. Read documentation of these modules.

インストーラーの起動

You have to launch the configurator (it will upgrade some configuration files), and then the installer, which will upgrade some stuff: database tables, data etc..

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

クリーンアップとテスト

その後、キャッシュと一時ファイルをすべて削除してください。

sudo lizmap/install/clean_vartmp.sh

そして、ファイルに権利を設定するスクリプトを呼び出す必要があります。パラメータは、WebサーバーがLizmapを実行する際に使用するWebユーザーとWebグループです。Debianサーバでは、www-dataであることが多いです。

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

その後、Lizmapをブラウザに読み込むと、エラーなく地図が表示されるはずです。

この場合、古いディレクトリである lib/ と lizmap.bak/ を削除してください。

SqliteからPostgresqlへの移行

もしかしたらSqliteと一緒にLizmapをインストールしたかもしれません。そして、これらのファイル lizmap/var/db/jauth.db と lizmap/var/db/logs.db には、ユーザー、権限、ログなどのデータが保存されているはずです。そして、この設定を lizmap/var/config/profiles.ini.php に記述する必要があります。

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

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

このような設定であれば、Postgresqlのデータベースにデータを移行することができます。

まず、Postgresqlのデータベースを作成します。次に、Postgresqlのデータベースへのアクセスパラメータを設定して、 lizmap/var/config/profiles.ini.php の設定を変更します。データベースにすでにいくつかのテーブルが含まれている場合には、例えば、 lizmap のようなスキーマを作成することをお勧めします。

例えば、

[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

これらのパラメータの詳細については、インストールの章を参照してください。

そして、データを移行するスクリプトを起動することができます。

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

エラーがなければ、ブラウザでlizmapにアクセスして、自分が認証できることを確認します。管理パネルのユーザーリストにも表示されているはずです。もし問題がある場合は、jauth.dbとlogs.dbをバックアップして、削除してください。

何か問題が発生し、問題を解決できない場合は、以下のように、データベースアクセスを以前のように lizmap/var/config/profiles.ini.php に戻してください。

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

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

これでLizmapもうまく動作するはずですが、まだSqlite版のままです。

Upgrading to a minor version of Lizmap 3.6

A new version of Lizmap 3.6 may be released (3.6.1, 3.6.2 etc.). You should upgrade your existing Lizmap 3.6 instance in order to make use of improvements and bug fixes.

Backup

In case the upgrade fail, it is a good thing to backup the entire lizmap directory before doing anything.

cp -a lizmap lizmap.bak

if the upgrade fail, delete the lizmap directory and launch:

mv lizmap.bak lizmap

Lizmapファイルの置き換え

‎Lizmap アーカイブを入手するには、 release <https://github.com/3liz/lizmap-web-client/releases> _ ページでアーカイブをダウンロードしてください。‎

You can then extract the lizmap/ directory from the archive, it will overwrite all files, except from lizmap/var/.

インストーラーの起動

You have to launch the configurator (it will upgrade some configuration files if needed), and then the installer, which will upgrade some stuff: database tables, data etc..

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

Restore the rights on files, by indicating the web user and the web group used by the web server

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

その後、Lizmapをブラウザに読み込むと、エラーなく地図が表示されるはずです。

If this is the case, you can delete the old directory lizmap.bak/.