Upgrading from a previous version/zh-hans: Difference between revisions
From LimeSurvey Manual
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
| Line 18: | Line 18: | ||
*'''升级之后请清空浏览器缓存与cookies！''' | *'''升级之后请清空浏览器缓存与cookies！''' | ||
<span style='color:#FF0000'>... read this because it is very important: '''Always backup the files and the database of your current installation!!'''</span> | <span style='color:#FF0000'>... read this because it is very important: '''Always backup the files and the database of your current installation!!!'''</span> | ||
You can do this using a database | You can do this using a database administration tool like [http://www.phpmyadmin.net phpMyAdmin] etc. and a file manager! If you don't know how to do this, you should not proceed but ask someone who knows or use the [[ComfortUpdate]] instead. | ||
=The quick way (for minor version changes)= | =The quick way (for minor version changes)= | ||
You can use these instructions if you are doing a minor | You can use these instructions if you are doing a minor upgrade (for example from 2.00 to 2.01): | ||
*Backup your files and database (did we already mention that?) | *Backup your files and database ([[Upgrading_from_a_previous_version#Before_you_start... did we already mention that?]]) | ||
*Delete all the old files/ | *Delete all the old files/folders except for: | ||
**/application/config/config.php | **/application/config/config.php; | ||
**/upload directory | **/upload directory - "'NOTE''': If you have any customized templates sitting under /upload/templates, make sure you refresh those with any changes from the new version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template, and 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. | *Copy the new files from the new LimeSurvey package to the existing location. | ||
* Open the admin page in your | *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!''' | ||
=The thorough way (for big version jumps)= | =The thorough way (for big version jumps)= | ||
Unfortunately there are a couple of things to consider, so please | Unfortunately there are a couple of things to consider, so please observe carefully the following instructions. | ||
==Upgrading from version 2.0x to 2.50 or later== | ==Upgrading from version 2.0x to 2.50 or later== | ||
*Please note that the template structure has changed. Your old templates will not be working anymore as the template system is now using responsive templates. | *Please note that the template structure has changed. Your old templates will not be working anymore as the template system is now using responsive templates. | ||
==Upgrading from version | ==Upgrading from version 2.0 or later to any later 2.xx version== | ||
#[http://www.limesurvey.org#download Download] the latest version of LimeSurvey. | #[http://www.limesurvey.org#download Download] the latest version of LimeSurvey. | ||
# Prepare and backup the old installation | # Prepare and backup the old installation; | ||
## Backup your installation directory files and SQL-based database just in case | ## Backup your installation directory files and SQL-based database just in case; | ||
### At the command-line level, make a '''.zip''' or similar archive of the whole installation directory tree of files. For example in Linux tar cvzf foo.tgz cps100 will tar and zip the whole of the cps100 directory | ### At the command-line level, make a '''.zip''' or similar archive of the whole installation directory tree of files. For example, in Linux 'tar cvzf foo.tgz cps100' will tar and zip the whole of the cps100 directory; | ||
### Using phpMyAdmin or similar to export all tables; or use the according '''LimeSurvey Administration''' button [[File:button-export-sql.png]] to backup the entire database | ### Using phpMyAdmin or similar to export all tables; or use the according '''LimeSurvey Administration''' button [[File:button-export-sql.png]] to backup the entire database. | ||
## Copy your '''config.php''' file, modified '''template''' directories and the /upload directory separately for quick access later | ## Copy your '''config.php''' file, modified '''template''' directories and the /upload directory separately for quick access later; | ||
# Replace all the installation directory files | # Replace all the installation directory files; | ||
## Delete all old files in the existing installation directory | ## Delete all old files in the existing installation directory; | ||
## Upload and unpack the new code version into the same installation directory | ## Upload and unpack the new code version into the same installation directory; | ||
## Copy your /upload directory back to the old location; | |||
## Copy your /upload directory back to the old location | ## Double check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''' and and their subdirectories is required) as described in the [[Installation#Set_directory_permissions|Installation section]]; | ||
## Double check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''' and and their subdirectories is required) as described in [[Installation# | ## Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (you can use the old config.php as reference). The existing database will be automatically detected and if necessary, upgraded after confirmation. | ||
## Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (you can use the old config.php as reference). The existing database will be automatically detected and | # Check if any special manual checks apply as listed below; | ||
# Check if any special manual checks apply as listed below | # '''Now clear your browser cache and cookies!''' and you are good to go. | ||
# '''Now clear your browser cache and cookies!''' | |||
{{Alert|title=Attention|text=If you upgrade from an earlier version (e.g. 2.0), it might be necessary to ''first'' upgrade to the latest 2.0.x release, then to 2.06, and then finally to the latest version (e.g. 2.67.x).}} | |||
<div class="simplebox">'''For those who update from any earlier version to v2.06''' - some unused permissions when editing global permission for 'surveys' were activated starting with the 2.06 version. So, if a user has any permission besides the 'create', they will be able to apply this additional permission on other surveys then their own. So please check the global permission of admin users that should only be able to see their own surveys and make sure they only have the 'create' permission assigned for 'surveys'. | |||
</div> | </div> | ||
==What is the most recent LimeSurvey version that still supports PHP4?== | |||
==What is the most | |||
The last release offering PHP4 support was version 1.82+. | The last release offering PHP4 support was version 1.82+. | ||
| Line 108: | Line 71: | ||
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. | 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. | ||
Revision as of 10:10, 11 August 2017
Additional pages:{toc}
开始之前...
... 请仔细阅读本信息，这非常重要： 记得在升级之前将当前的文件与数据库做好备份！！
你可以用 phpMyAdmin 和文件管理器等工具进行备份工作。如果不确定如何进行备份，最好找个懂备份的人，或者使用 ComfortUpdate 进行舒适更新。
快速升级（适用于小版本更新）
以下步骤适用于小版本更新（如1.86到1.87）
- 备份文件与数据库（上面说过一次了）
- 删除旧文件和目录，但以下三个别删：
- /config.php
- /templates 目录
- /upload 目录
- 将新版LimeSurvey软件包中的内容复制到当前目录下。注意别把 config.php 覆盖了（就算不小心误操作，你也应该有这个文件的备份吧）。其他的都可以覆盖。
- 升级之后请清空浏览器缓存与cookies！
... read this because it is very important: Always backup the files and the database of your current installation!!!
You can do this using a database administration tool like phpMyAdmin etc. and a file manager! If you don't know how to do this, you should not proceed but ask someone who knows or use the ComfortUpdate instead.
The quick way (for minor version changes)
You can use these instructions if you are doing a minor upgrade (for example from 2.00 to 2.01):
- Backup your files and database (Upgrading_from_a_previous_version#Before_you_start... did we already mention that?)
- Delete all the old files/folders except for:
- /application/config/config.php;
- /upload directory - "'NOTE: If you have any customized templates sitting under /upload/templates, make sure you refresh those with any changes from the new version. The easiest way to check for such changes is to file-compare your old template with the new version of the default template, and 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!
The thorough way (for big version jumps)
Unfortunately there are a couple of things to consider, so please observe carefully the following instructions.
Upgrading from version 2.0x to 2.50 or later
- Please note that the template structure has changed. Your old templates will not be working anymore as the template system is now using responsive templates.
Upgrading from version 2.0 or later to any later 2.xx version
- Download the latest version of LimeSurvey.
- Prepare and backup the old installation;
- Backup your installation directory files and SQL-based database just in case;
- At the command-line level, make a .zip or similar archive of the whole installation directory tree of files. For example, in Linux 'tar cvzf foo.tgz cps100' will tar and zip the whole of the cps100 directory;
- Using phpMyAdmin or similar to export all tables; or use the according LimeSurvey Administration button
to backup the entire database.
- Copy your config.php file, modified template directories and the /upload directory separately for quick access later;
- Backup your installation directory files and SQL-based database just in case;
- 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;
- Copy your /upload directory back to the old location;
- Double check the permissions set on the directories (write access to /tmp, /upload and and their subdirectories is required) as described in the Installation section;
- Open http://<yourdomain>/<yourlimesurveydir>/admin in your browser and follow the instructions (you can use the old config.php as reference). 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 : If you upgrade from an earlier version (e.g. 2.0), it might be necessary to first upgrade to the latest 2.0.x release, then to 2.06, and then finally to the latest version (e.g. 2.67.x).
For those who update from any earlier version to v2.06 - some unused permissions when editing global permission for 'surveys' were activated starting with the 2.06 version. So, if a user has any permission besides the 'create', they will be able to apply this additional permission on other surveys then their own. So please check the global permission of admin users that should only be able to see their own surveys and make sure they only have the 'create' permission assigned for 'surveys'.
What is the most recent LimeSurvey version that still supports PHP4?
The last release offering PHP4 support was version 1.82+.
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.