Actions

以前のバージョンからのアップグレード

From LimeSurvey Manual

Revision as of 09:52, 3 April 2024 by FuzzyBot (talk | contribs) (Updating to match new version of source page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
その他のページ:{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など、コマンドラインから自動アップグレードシステムを設定することができます。ただし、この方法は推奨しません。

手動アップデートまたはComfortUpdate後のデータベースのアップグレードの失敗

すべてを正しく実行しても、データベースのアップグレードがうまく動作しない場合があります。 これは、データベースのバージョン相違、予期しないデータ形式または内容、異常な構成、試験で発見できなかったもの(もちろん十分な試験をしていますが)など様々な原因で発生します。

データベースのアップグレード中にエラーが発生し、LimeSurveyが使用できない状態になった場合は、前のバージョンに戻す必要があります。これには、通常のバックアップまたはComfortUpdateにより作成したデータベースとそのバックアップがあることが前提になります。

次の手順を実行してください。

  • 既存のLimeSurveyディレクトリーとデータベースをバックアップする(これを2つ目のバックアップと呼ぶ)
  • 元の(1つ目の)バックアップから既存のディレクトリーにファイルを復元する(上書きすればよい)
  • 古いデータベースを削除し、元の(1つ目の)バックアップからデータベースを復元する

これですべてが正常に戻るはずです。

この問題の報告について:

このような問題が発生した場合は、もれなくバグトラッカーhttps://bugs.limesurvey.orgで報告してください。

報告されないバグは修正されないバグです。他の人の報告があるからと言ってそれに頼らないでください。バグが既に報告されている場合は、バグトラッカーで、'はい、私もこのバグで困っています'とマークすれば、バグ修正の優先順位を上げることができます。

FAQ

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

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

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

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

Survey theme incompatibility

With certain major version updates any custom survey themes will not be compatible, anymore:

  • Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
  • Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

Error "Multiple primary key defined" when updating MySQL database

If you encounter this error, please check the setting sql_generate_invisible_primary_key in your MySQL server variables. This is most likely set to ON, but should be set to OFF. Then restore your database from the backup (as explained above) and try again.