Portieren einer Installation

You might get the task of moving the LimeSurvey installation to a new server. The process should be simple, but it can get complicated by other factors. You may find below information on how to do the transfer and what to look out for, and information on how to recover from if you encounter a problem.

In general, the only changes from a new and clean installation are the following:

1. config.php is usually changed to store basic installation parameters as well as any custom settings made;
2. upload/* may contain custom templates or uploaded files;
3. SQL database tables should have had data added to the tables created at installation time. Note also that some new tables may have been created to save copies of token and result data from previously or currently active surveys. These new tables are usually named lime_survey_nnn..., lime_tokens_nnn..., lime_oldsurvey_nnn..., and lime_oldtokens_nnn....

Otherwise, unless you went in and made custom patches to the code, changes should be limited to these areas.

The goal in transferring an installation over to a new system is similar to upgrading. The biggest difference is that we simply try to recreate the existing installation on the new computer. If you wish to upgrade to a newer version also, do this as a later, second step once you have transferred the installation and verified that it works.

Übertragen einer Version

1. Vorbereiten und Speichern der alten Version
   1. Sichern Sie Ihr Installationsverzeichnis inkl. aller Dateien und machen Sie eine Backup Ihrer SQL-basierten Datenbank
      1. Erstellen Sie ein .zip oder ähnliches Archiv des gesamten Installationsverzeichnis mit allen Dateien
      2. Mit phpMyAdmin oder einem ähnlichen Tool, exportieren Sie alle Tabellen, oder verwenden Sie in der LimeSurvey Administration das folgende Symbol zur Sicherung der gesamten Datenbank.
   2. Kopieren Sie die config.php Datei an eine Stelle an der Sie diese einfach bearbeiten können.
2. Kopieren die gespeicherten Dateien auf den neuen Server
   1. Entpacken Sie die Installationsdateien
      1. Erstellen Sie Ihre neues Installations-Verzeichnis (gleicher Name ist am einfachsten)
      2. Entpacken Sie die Installationsdateien in dieses neue Verzeichnis
   2. Installation SQL-Datenbank
      1. Erstellen Sie die neuen Datenbank mit phpMyAdmin oder per Kommandozeile
      2. Laden Sie das Backup der zuvor gespeicherten SQL-Datenbank, und erstellen Sie so die die Tabellen und Inhalte.
3. Bearbeiten Sie config.php um evtl. Änderungen und passen Sie evtl die Datenbankzugriffsdaten oder Pfade an und überprüfen Sie Ihre Installation
   1. Überprüfen Sie den Namen der Datenbank, den Benutzernamen und das Kennwort, sowie den Installations Server-Namen, URL-Pfad und den physischen Pfad.
   2. Öffnen Sie die Umfrage Admin-Seite oder die Seite einer aktiven Umfrage, um sicherzustellen, dass alles funktioniert.
4. Fertig! (:biggrin:).

If you wish to upgrade on this machine, you can now go through the same process described in the section related to the LimeSurvey upgrade to a newer version.

Wenn Dinge schieflaufen

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

Unterschiedliche LimeSurvey Version (Installations-und DB-Backup-Datei-Archive stimmen nicht überein)

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.