Actions

Upgrading from a previous version/ja: Difference between revisions

From LimeSurvey Manual

No edit summary
(Updating to match new version of source page)
Line 78: Line 78:


PHP CLIからコマンド<code>php application/commands/console.php updatedb</code>によってデータベースをアップグレードできます。これにより、たとえばcrontabなど、コマンドラインから自動アップグレードシステムを設定することができます。ただし、この方法は推奨しません。
PHP CLIからコマンド<code>php application/commands/console.php updatedb</code>によってデータベースをアップグレードできます。これにより、たとえばcrontabなど、コマンドラインから自動アップグレードシステムを設定することができます。ただし、この方法は推奨しません。
= Failed database upgrade =
Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade.
That may happen because of various reasons, different database version, unexpected data format or contents, unusual configurations or anything else that did not show up in our tests (yes, we test alot!)
If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version.
This assumes that you still have the database and file backup, either from ComfortUpdate, or you created these manually.
Please execute the following steps:
*Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup)
*Restore files to the existing directory (just overwriting them is fine) from the original (1st) backup.
*Delete the old database and restore the database from the original (1st) backup.
That's it. Everything should be back to normal.
'''A note about reporting this issue:'''
If you run into a problem like this, please always report this in our bug tracker at https://bugs.limesurvey.org
Note: A bug not reported is a bug not fixed. Please don't just rely on other people reporting it. If you see that the bug is already reported, you can also help to raise the bug priority by marking it as 'Yes, this bug affects me' in the bug tracker.


=FAQ=
=FAQ=

Revision as of 09:07, 20 August 2021

その他のページ:{toc}

始める前に

... 非常に重要なので、よく読んでください。常に現在のファイルとデータベースをバックアップしてください!

これは、phpMyAdminやファイルマネージャーのようなデータベース管理ツールを使って行うことができます。 やり方がわからない場合は、先に進めず、詳しい人に聞いてください。

ComfortUpdateの利用について(推奨)

簡単かつ安全にアップグレードする方法として、ComfortUpdateサービスが利用できます。

アップグレード手順(2.x以降のバージョンからより新しいバージョンへ)

以下の手順に従ってください。

  • ファイルとデータベースをバックアップします(上述しました)。
  • 下記を除くすべての古いファイル/フォルダを削除する
    • /application/config/security.php -重要:これは、バージョン4以降のLimeSurveyのすべての暗号化データの鍵です。
    • /application/config/config.php
    • /upload ディレクトリー
注意: /upload/templatesにカスタマイズしたテンプレートがある場合は、新しいLimeSurveyのバージョンに加えられた変更に合わせて'更新'してください。新旧の既定のテンプレートファイルを比較することによってこのような変更を簡単に確認することができます。カスタマイズした部分以外で違いがある場合は、更新が必要です。
  • 新しいLimeSurveyパッケージの新しいファイルを既存の場所にコピーします。
  • ブラウザで管理ページ(https://www.example.com/limesurvey/admin など)を開き、データベーススキームのアップグレードが必要かどうかを確認します。
  • アップグレード後: ブラウザのキャッシュとCookieをクリアしてください。

古いバージョン向けの手順

残念ながら、考慮すべき点がいくつかありますので、次の手順を注意深く読んでください。

バージョン1.50以降からバージョン2.xx以降へのアップグレード

  • LimeSurveyの最新バージョンをダウンロードします。
  • ファイルとデータベースをバックアップします(こちらで言及したとおり)。
  • すべてのインストールディレクトリファイルを置き換えます。
    • 既存のインストールディレクトリ内の古いファイルをすべて削除する。
    • 新しいバージョンの新しいファイルを同じインストールディレクトリにアップロードして解凍します。
    • 以前のバージョンが1.90より古い場合は、カスタマイズしたテンプレートを/upload/templatesにコピーします。/templates内の既存のテンプレートと名前が一致するよう、各々のテンプレートディレクトリーの名前を変更する必要もあります。
    • /uploadディレクトリーを元の場所にコピーし直します。
    • インストールに関するウィキで説明されているように、ディレクトリーに設定されている権限を再確認します(/tmp、/upload、およびそのサブディレクトリーへの書き込みアクセスが必要です)。
    • ブラウザーでhttp://<yourdomain>/<yourlimesurveydir>/adminを開き、指示に従ってください(古いconfig.phpにデータベースデータがあります)。既存のデータベースは自動的に検出され、必要に応じて確認後にアップグレードされます。
  • 下記の特別なマニュアルチェックが適用されているか確認してください。
  • ブラウザのキャッシュとCookieをクリアすれば完了です。
  注意 : テンプレート構造は2.0xから2.50またはそれ以降の更新で変更されています。テンプレートシステムはレスポンシブテンプレートを使用しているため、古いテンプレートはもう機能しません。


アップグレード後の特別なチェック:
  • 以前のバージョンから2.xxへ: 適切な質問コード付与が必要となりました。アップグレードした後、すべてのアンケートのアンケートロジックを確認し、必要に応じてコードを修正してください。
  • v1.53より前のバージョンから: v1.53より前のバージョンから最新バージョンにアップグレードする場合は、各ユーザーのグローバルユーザー権限を確認してください。v1.53には、それまでに作成したマスター管理アカウントと同じ権限をユーザーに与えることができる新しいスーパー管理者権限が導入されました。アップグレードスクリプトは、古いバージョンからこのアクセス権限を与えるべき人物を推測しています。これは完璧ではないので、慎重にチェックする必要があります。
  • 以前のバージョンからv2.06へ: 2.05から2.06への移行で、'アンケート'のグローバル権限を編集するときに未使用であった権限のいくつかが有効になりました。たとえば、ユーザーが2.05で'作成'権限のみを持っていた場合、'作成'の右側にある他の権限(読み取り、更新、削除、インポート、エクスポート)も2.06への更新によって有効になります。更新後、管理者ユーザーに'元々の'権限以外のグローバル権限があるかどうかを確認してください。必要に応じ、編集してください。

バージョン1.50から1.xx台のバージョンへのアップグレード

  • LimeSurveyの所望のバージョンをダウンロードしてください。
  • ファイルとデータベースをバックアップします(こちらで言及したとおり)。
  • すべてのインストールディレクトリーファイルを置き換えます。
    • 既存のインストールディレクトリ内の古いファイルをすべて削除する。
    • 新しいコードバージョンを同じインストールディレクトリにアップロードして解凍します。
    • config.phpファイルを編集または置き換えます。
      • 以前のバージョンが1.70より古い場合は、新しいconfig.phpを編集して、バックアップしたconfig.phpファイルの変更を反映させます。新しいconfig.phpを古い config.phpで上書きしないでください!
      • 以前のバージョンが1.70以降の場合、 新しいconfig.phpをバックアップしたconfig.phpファイルで置き換えてください(ファイル形式が変更されていないため)
    • 以前のバージョンが1.90より古い場合は、カスタマイズしたテンプレートを/upload/templatesにコピーします。/templates内の既存のテンプレートと名前が一致するよう、各々のテンプレートディレクトリーの名前を変更する必要もあります。
    • /uploadディレクトリーを元の場所にコピーし直します。
    • インストールに関するウィキで説明されているように、ディレクトリーに設定されている権限を再確認します(/tmp、/upload、およびそのサブディレクトリーへの書き込みアクセスが必要です)。
  • インストール/アップグレード手順を完了させてください。
    • LimeSurvey管理のURLを開くと、確認の後にデータベーステーブルが更新されます。
    • インストールスクリプトの指示に従って/admin/installディレクトリーを削除または名前を変更します。
    • 下記の特別なマニュアルチェックが適用されているか確認してください。
アップグレード後の特別なチェック:
  • v1.53より前のバージョンから: v1.53より前のバージョンから最新バージョンにアップグレードする場合は、各ユーザーのグローバルユーザー権限を確認してください。v1.53には、それまでに作成したマスター管理アカウントと同じ権限をユーザーに与えることができる新しいスーパー管理者権限が導入されました。アップグレードスクリプトは、古いバージョンからこのアクセス権限を与えるべき人物を推測しています。これは完璧ではないので、慎重にチェックする必要があります。

v1.50より前のバージョン(v1.0からv1.44まで)からのアップグレード

データ構造をはじめ、多くの変更があったため、v1.50より前のバージョンからアップグレードすることはできません。拡張子が*.sqlの古いアンケート構成ファイルを使用している場合、これらを新しいバージョンに変換する唯一の方法は、バージョン1.50をインストールし、そこに.sqlファイルをインポートして、それを最新バージョンのLimeSurveyにアップグレードすることです。詳細については、インストールの移設方法に関するページを確認してください。

CLIを使用したアップグレード

PHP CLIからコマンドphp application/commands/console.php updatedbによってデータベースをアップグレードできます。これにより、たとえばcrontabなど、コマンドラインから自動アップグレードシステムを設定することができます。ただし、この方法は推奨しません。

Failed database upgrade

Sometimes, even though you did everything correct, things don't work out they are supposed to during database upgrade. That may happen because of various reasons, different database version, unexpected data format or contents, unusual configurations or anything else that did not show up in our tests (yes, we test alot!)

If you have an error during database update and your LimeSurvey instance ends up in an unusable state, you want to go back to the previous version. This assumes that you still have the database and file backup, either from ComfortUpdate, or you created these manually.

Please execute the following steps:

  • Backup the existing LimeSurvey directory and database (yes, again - we will call this the 2nd backup)
  • Restore files to the existing directory (just overwriting them is fine) from the original (1st) backup.
  • Delete the old database and restore the database from the original (1st) backup.

That's it. Everything should be back to normal.

A note about reporting this issue:

If you run into a problem like this, please always report this in our bug tracker at https://bugs.limesurvey.org

Note: A bug not reported is a bug not fixed. Please don't just rely on other people reporting it. If you see that the bug is already reported, you can also help to raise the bug priority by marking it as 'Yes, this bug affects me' in the bug tracker.

FAQ

実行中のアンケートがあってもアップグレードできますか?

はい、できます。上記の徹底的な方法に例外が記載されているかもしれません。アップグレード後にアンケートをテストして、デザインテンプレートが正常に機能しているかを確認することを強くお勧めします。

アンケート構成ファイル(*.sql/*.csv)を最新バージョンのLimeSurveyに移行する方法

バージョン1.50をインストールし、ファイルをインポートし、アンケート構成を新しい.csv形式にエクスポートします。最新のバージョン2.xをインストールし、.csv形式のデータをインポートし、現行の.lss形式でエクスポートします。