Actions

Upgrading from a previous version/vi: Difference between revisions

From LimeSurvey Manual

Maren.fritz (talk | contribs)
Created page with "==Khuyến nghị sử dụng ComfortUpdate== '''Cách dễ dàng/an toàn nhất để nâng cấp là sử dụng dịch vụ ComfortUpdate của chúng tôi.'''"
Maren.fritz (talk | contribs)
Created page with "Vui lòng làm theo các hướng dẫn sau: *Sao lưu các tệp và cơ sở dữ liệu của bạn (Nâng cấp từ phiên bản trước#Trước khi bạn bắt đầ..."
Line 13: Line 13:
=Hướng dẫn nâng cấp (từ 2.x trở lên lên bất kỳ phiên bản nào mới hơn)=
=Hướng dẫn nâng cấp (từ 2.x trở lên lên bất kỳ phiên bản nào mới hơn)=


Please follow these instructions:
Vui lòng làm theo các hướng dẫn sau:
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
*Sao lưu các tệp và cơ sở dữ liệu của bạn ([[Nâng cấp từ phiên bản trước#Trước khi bạn bắt đầu...|chúng tôi đã đề cập đến điều đó chưa?]]).
*Delete all the old files/folders except for:
*Xóa tất cả các tệp cũ/ các thư mục ngoại trừ:
**/application/config/security.php -'''Important!! This is the key to all encrypted data in LimeSurvey (version 4 and later)'''
**/application/config/security.php -'''Quan trọng!! Đây là chìa khóa cho tất cả dữ liệu được mã hóa trong thư mục LimeSurvey (phiên bản 4 trở lên)'''
**/application/config/config.php;
**/application/config/config.php;
**/upload directory
**/upload


<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>
<div class="simplebox">[[File:help.png]]'''Note:''' If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.</div>

Revision as of 08:35, 9 January 2024

Các trang bổ sung:{toc}

Trước khi bạn bắt đầu...

... hãy đọc phần này vì nó rất quan trọng: Luôn sao lưu các tập tin và cơ sở dữ liệu của bản cài đặt hiện tại của bạn!

Bạn có thể thực hiện việc này bằng công cụ quản trị cơ sở dữ liệu như phpMyAdmin và trình quản lý tệp! Nếu bạn không biết cách thực hiện việc này, bạn không nên tiếp tục và hỏi người biết.

Khuyến nghị sử dụng ComfortUpdate

Cách dễ dàng/an toàn nhất để nâng cấp là sử dụng dịch vụ ComfortUpdate của chúng tôi.

Hướng dẫn nâng cấp (từ 2.x trở lên lên bất kỳ phiên bản nào mới hơn)

Vui lòng làm theo các hướng dẫn sau:

  • Sao lưu các tệp và cơ sở dữ liệu của bạn (chúng tôi đã đề cập đến điều đó chưa?).
  • Xóa tất cả các tệp cũ/ các thư mục ngoại trừ:
    • /application/config/security.php -Quan trọng!! Đây là chìa khóa cho tất cả dữ liệu được mã hóa trong thư mục LimeSurvey (phiên bản 4 trở lên)
    • /application/config/config.php;
    • /upload
Note: If you have any customized templates in /upload/templates, make sure you 'refresh' those with any changes that come with the new LimeSurvey version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template. If you see any differences other than your customizations, a refresh is needed.
  • Copy the new files from the new LimeSurvey package to the existing location.
  • Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
  • After the upgrade: Clear your browser cache and cookies!

Instructions for older versions

Unfortunately, there are a couple of things to consider, so please read the following instructions carefully.

Upgrading from version 1.50 or later to any later 2.xx version

  • Download the latest version of LimeSurvey
  • Backup your files and database (did we already mention that?).
  • Replace all the installation directory files
    • Delete all old files in the existing installation directory
    • Upload and unpack the new files of the new version into the same installation directory
    • If your previous version is older than 1.90, copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
    • Copy your /upload directory back to the old location
    • Double-check the permissions set on the directories (write access to /tmp, /upload, and their subdirectories is required) as described in the installation wiki
    • Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (You will find the database data in the old config.php). The existing database will be automatically detected and if necessary, upgraded after confirmation.
  • Check if any special manual checks apply as listed below
  • Now, clear your browser cache and cookies and you are good to go
  Attention : Please note that the template structure has changed with the update from 2.0x to 2.50 or later. Your old templates will not be working anymore as the template system is now using responsive templates.


Special checks after an upgrade:
  • from any earlier version to 2.xx: Proper question codes are mandatory now. After upgrading the installation, check the survey logic of all surveys and correct the codes where necessary
  • from a version earlier than v1.53: When upgrading from a version before v1.53 to the latest version, please check the global user rights of each user. There was a new superadmin right introduced in v1.53 that can give a user the same privilege as the master administration account created during the installation. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.
  • from any earlier version to v2.06: From 2.05 to 2.06, some unused permissions when editing global permissions for 'surveys' were activated. For example, if a user had only the 'create' permission in 2.05, the other permissions located to the right of 'create' would also get activated with the update to 2.06 (View/read, Update, Delete, Import, Export). Please check whether the admin users got any other global permissions besides the 'original' ones after the update. If yes, please edit them accordingly.

Upgrading from version 1.50 or later to any later 1.xx version

  • Download the desired version of LimeSurvey
  • Backup your files and database (did we already mention that?).
  • Replace all the installation directory files
    • Delete all old files in the existing installation directory
    • Upload and unpack the new code version into the same installation directory
    • Edit or replace the config.php file:
      • If your previous version was < 1.70: Edit the new config.php in order to reflect the changes from the backup config.php file. Do not just overwrite the new config.php with your old one!
      • If your previous version was >= 1.70: Simply replace the new config.php with your backup config.php file (as the file format has not changed)
    • If your previous version was older than 1.90: Copy any customized templates to /upload/templates - you will also need to rename each template directory whose name matches an existing template in /templates
    • Copy your /upload directory back to the old location
    • Double-check the permissions set on the directories of LimeSurvey (write access to /tmp, /upload, and to their subdirectories is required) as described in the installation wiki
  • Finish the installation/upgrade process
    • Once you open the URL to your LimeSurvey administration, the database tables will be updated after confirmation
    • Remove or rename the /admin/install directory as/if instructed by the installation script
    • Check if any special manual checks apply (as listed below)
Special checks after an upgrade:
  • From a version earlier than v1.53: When upgrading from a version before v1.53 to the latest version, please check the global user rights of each user. There was a new superadmin right introduced in v1.53 that can give a user the same privilege as the master administration account created during the install. The upgrade script is guessing to whom this permission should be given in the older versions. As this is not perfect, it should be carefully checked.

Upgrading from a version earlier than v1.50 (v1.0 through v1.44)

Since the data structure and a lot of other things were changed, upgrading from any version previous to v1.50 is NOT possible. If you have old survey structure files with an *.sql extension, the only way to get these into a newer version is to install version 1.50, import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to how an installation can be transferred for more details.

Upgrading using CLI

You can upgrade the database via the PHP CLI: php application/commands/console.php updatedb. This allows you to set up an auto-upgrade system via command line (for example, in a crontab), although it is not recommended.

Failed database upgrade after manual update/ComfortUpdate

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 versions, unexpected data formats or contents, unusual configurations or anything else that did not show up in our tests (yes, we test a lot!)

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 your regular backup or the one created by Comfortupdate.

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

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

Can I upgrade even if I have active surveys?

Yes, you can. Exceptions may be mentioned in the thorough instructions above. We strongly advise to test your surveys after upgrade to check if your design templates still work alright.

How to convert *.sql/*.csv survey structure files to the latest LimeSurvey version?

Install version 1.50, import the file, and export the survey structure to the newer .csv format. Then install the latest Version 2.x and import the .csv format and export it to the current .lss format.