技術情報

Matomo(Piwik) のアップデート方法について

2012年09月03日 導入ガイド

※注 この記事は Piwik1.8~2.17のアーカイブ情報です

このページでは、Matomo(Piwik)をアップデートする方法について説明します。

2つの方法があります。

  • ワンクリックアップデート
  • 手動でのアップデート

1. ワンクリックでMatomo(Piwik)をアップデート

ワンクリックアップグレード機能を使って、ボタンのワンクリックで、10秒でMatomo(Piwik)を更新できます!

1)FTPでMatomo(Piwik)のフォルダに書き込み権限を設定する

ワンクリックでのアップデート機能を実行するには、Matomo(Piwik)の新しいバージョンのファイルをダウンロードし、展開して、既存のファイルを上書きするため、Matomo(Piwik)のフォルダにWebサーバー上の正しい権限(パーミッション)を与える必要があります。

FTPソフトを使って、Matomo(Piwik)のルートフォルダに書き込み権限(CHMOD 0755)を与えてください。
いくつかのケースでは、それだけでは自動更新が動作しないかもしれません。
その場合は、Matomo(Piwik)の所有者をWebサーバのユーザに変更するか、あるいは一時的にCHMOD 0777 の権限を与えてください。

ワンクリックでのアップデートが完了したら、Matomo(Piwik)のフォルダを、通常の読み取り専用権限(CHMOD 0644)に戻してください。

FTP permissions in Filezilla

2)Matomo(Piwik)のアラートボックスをクリックします。

Matomo(Piwik)の画面では通常のインフォボックスは以下のようになっています。

Matomo(Piwik)の新しいバージョンが利用可能になると、このボックスにアラートが表示されます。

Matomo(Piwik)の新バージョンがリリースされてから、メッセージがアラートボックスに表示されるのに8時間かかることがあります。

3)メッセージを読み、Update Automatically「自動的に更新」をクリックします。

piwik one click update

4)自動で更新されます。

piwik one click update

2.手動による3ステップの更新

何らかの理由で、ワンクリックでのアップデートがうまく動作しない場合は、FTPを使用してMatomo(Piwik)を更新できます。

1)設定ファイルのバックアップ

以下の場所にあるMatomo(Piwik)の設定ファイルをバックアップしてください。

config/config.ini.php

このファイルには、既存のインストールの詳細情報が含まれています。
例えば、データベースの接続情報や、有効になっているプラグインのリストです。

2)Matomo(Piwik)のファイルを新しいファイルで置き換えてから、古い設定ファイルを上書きコピー

http://piwik.org/latest.zip から最新のMatomo(Piwik)のリリースをダウンロードします。
ダウンロードして解凍します。シェル接続が可能であれば、サーバに直接ダウンロードすることもできます。

FTPでファイルをアップロードする場合は、すべてのファイルがバイナリモードで転送されていることを確認してください。
新しいファイルは、同じ名前を持つすべての古いファイルを上書きする必要があります。(config/config.ini.phpを含む)

今、あなたのバックアップから新たにMatomo(Piwik)のコンフィギュレーションファイルを復元することができます。

config / config.ini.php

もし以前のconfig.ini.phpファイルをバックアップしなかった場合でも、データを失うことなく、Matomo(Piwik)を再インストールし、既存のデータベースを利用することができます。

3)Matomo(Piwik)のアップデート

WebブラウザでMatomo(Piwik)のインストール画面をご覧ください。
もしMatomo(Piwik)がデータベースに新しいインスタンスを加える変更を必要とする場合は、この画面が表示されます。

piwik_update

これは最新のコードと互換性を持つようにデータベースを更新します。

しばらくお待ちください:データベースの更新は(新しいインデックスの追加などで)、数分かかることがあります。
このプロセス中に、ブラウザを閉じたり、「更新」をクリックしないでください。
このステップの正常な実行に失敗した時は、Matomo(Piwik)のインストール画面が正常に表示されなくなったったり、あるいは全く機能しなくなる場合があります。

3. 高トラフィックのMatomo(Piwik)のサーバー用のデータベースのアップグレード

高いトラフィックのウェブサイトについては、更新プロセスは数分から数時間かかる可能性があります。
その場合は、コマンドラインでデータベースの更新処理を実行することをお勧めします。
シェルで以下のコマンドを実行することで、Matomo(Piwik)の更新を起動できます。

$ php /path/to/piwik/index.php — “module=CoreUpdater”

中規模および高トラフィックのMatomo(Piwik)のサーバの場合、コマンドライン上でアップグレードを実行している間は、訪問者の追跡をオフにすることと、Matomo(Piwik)のユーザーインターフェイスをオフにすることをお勧めします。
そうすることで、同時の読み取り/書き込みエラーなしで、DBスキーマの更新をできるだけ早く終了させることができます。

トラブルシューティング

一般的な質問と回答のために、Matomo(Piwik)のアップデートFAQをご覧ください。