インストールしたシステムの移動

新しいサーバーに、インストールしたシステムを移動することがあるかもしれません。大体は簡単なのですが、いろいろと要素がからんで厄介になることもありえます。以下で、移動する方法と注意点、問題があった時のリカバー方法を記します。

一般に、クリーンインストールしたときの新しいLimesurveyは下のような違いがあるだけです:

1. config.php がインストールやその後のカスタマイズのときのパラメータを持っています。
2. upload/* に、カスタムテンプレートやその他のアップロードファイルが入っているかも知れません。
3. インストール時につくられた SQL database tables にデータが入っているでしょう。また、トークンや回答データを格納するために、新しいテーブルも作られています。古い回答なども同様です。テーブル名は、通常 lime_survey_nnn... lime_tokens_nnn... lime_oldsurvey_nnn lime_oldtokens_nnn といった感じです。

特にコードにパッチをあてたりしたのでなければ、違うのはそのあたりだけです。

インストールの移動時にやるべきことは、アップグレードと同様です。いちばんの違いは、新しくインストールを行うという点くらいです。新バージョンへのアップグレードも併せて行いたい場合は、後回しにして、移動したシステムがちゃんと動くのを確認してからにしましょう。

Transferring any version

• Prepare and save the old release
  • Backup your installation directory files and SQL-based database
    • At the command-line level, make a .zip or similar archive of the whole installation directory tree of files
    • Use phpMyAdmin or similar to export all tables; or use the LimeSurvey backup entire database button that is located in the Configuration dialog, under the Advanced tab
  • Copy your config.php file separately to ease the editing process
• Move the saved release to the new machine
  • Unpack your installation files
    • Create your new installation directory (same name is convenient)
    • Unpack/unzip the installation files into the same folder
  • Setup your SQL database
    • Create the new database using phpMyAdmin or a command-line interface
    • Load the saved SQL-based database to recreate the tables and content
• Edit config.php to reflect changes from the old release and check your installation
  • Be careful to check the database name, username, and password, as well as the installation server name, URL path, and physical directory path to the installation
  • Visit the survey admin page or the page of an active survey and check if everything works
• You are good to go now :)

If you do not change the location of your LimeSurvey installation and wish only to upgrade it, go through the same process described in the section related to the LimeSurvey upgrade to a newer version.

Things that could go wrong

As simple as this appears, things do seem to go wrong sometimes. Take a deep breath. Verify that you followed the steps thoroughly. Otherwise, read below to see where other people got stuck along the way.

Different LimeSurvey version (installation and DB backup file archives do not match)

There is a possibility that you did not have the correct installation backup code to match the backed-up SQL database. It could be easy to get these separate backups confused, out of sync, or otherwise separated. There are a few things that can help you find out what version each backup may be. When using the LimeSurvey SQL backup option, the default file name it creates has the date of the backup in the name. Also, if you search inside the SQL database backup file, you will find a section that looks similar to the example provided below where the database version is stored:

#-----------------------------------------------------------------------
# Table data for lime_settings_global
#-----------------------------------------------------------------------
INSERT INTO lime_settings_global VALUES("DBVersion","126");
....

This value is used by the installer to determine how to apply changes to tables when upgrading.