Actions

ComfortUpdate: Difference between revisions

From LimeSurvey Manual

No edit summary
mNo edit summary
(38 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages />
<translate>
<!--T:1-->
__TOC__
=General= <!--T:2-->
<!--T:3-->
The ComfortUpdate tool is a LimeSurvey professional service to update your LimeSurvey installation easily from your web browser with just a few mouse clicks (instead of having to perform [[Upgrading from a previous version|a manual update]]).
<!--T:20-->
In order to use and test ComfortUpdate, you have to sign up [https://www.limesurvey.org/en/services#pricing on LimeSurvey] to receive a free trial key. After that trial key has expired you can either [https://www.limesurvey.org/en/services#pricing buy one of our premium packages] or [[Upgrading from a previous version|update your installation manually]].
<!--T:23-->
{{Alert|In order to copy and use your ComfortUpdate key, access your [https://www.limesurvey.org/your-account/your-limesurvey-profile LimeSurvey] profile and click on COMFORTUPDATE KEYS, which is located in the profile menu (left side of the page).}}
=Requirements= <!--T:4-->
<!--T:5-->
Your PHP installation must be compiled with support for [http://php.net/manual/en/book.zlib.php ZLib]. Check your PHPInfo and ask your system administrator for a confirmation.
<!--T:9-->
Your server must be able to connect by SSL to ''update.limesurvey.org'' and ''update-data.limesurvey.org'' to use the ComfortUpdate tool. If you have problems with this and get error messages such as ''10060 could not connect to the host 'update.limesurvey.org''', you will have to tweak/edit your proxy/firewall security settings or ask your server administrator for further guidance and help.
=Using ComfortUpdate= <!--T:6-->
<!--T:7-->
The LimeSurvey ComfortUpdate feature is safe to use even with active surveys. It does not delete or destroy any existing data. However, you should keep in mind that this is a beta feature. Therefore, it is important to have your database and files manually backed up before proceeding.
<!--T:11-->
*Find the ''Update'' button
**For the older LimeSurvey versions, go to the Global Settings Icon, select the first tab, and click on the ''Updates'' button
**For the recent Limesurvey versions, you may find the '''ComfortUpdate''' button in the '''Configuration''' dialog, under the ''Advanced'' tab:
<!--T:25-->
<center>[[File:ComfortUpdate.png]]</center>
<!--T:26-->
*The ComfortUpdate screen will display an update link if a new version of LimeSurvey is available. If not, click “Check now” to see if a new update is available
*If an update is found, LimeSurvey will display a link to allow you to update. Click on this to begin updating
*If you have never used ComfortUpdate before or the ComfortUpdate upgrade key is not valid, you will be asked to enter an upgrade key. Use the default key for free updates during the trial period


__TOC__


=General.=
<!--T:27-->
<center>[[File:ComfortUpdateKey.png]]</center>
 
 
<!--T:28-->
*LimeSurvey will now verify your installation directory to check if the appropriate permissions are set to allow an update. A list of proposed changes will be displayed
*If there are any problems, you must correct them at this point and then proceed to the next step
*The ComfortUpdate will now make a backup of your database (if you use MySQL) and save your old installation files in the /tmp directory. If you use a different database, you should backup your database manually before proceeding
ComfortUpdate will now update your installation to the latest version, updating also the database in order to reflect the new (possible) changes.
 
=Disabling ComfortUpdate= <!--T:21-->
If you want to disable ComfortUpdate in order not to get the ''New release available'' popup messages after each new release, you can add the following option to your "config.php" file (which is located in /limesurvey/application/config):
<syntaxhighlight lang="php" enclose="pre">
'updatable' => false
</syntaxhighlight>
 
<!--T:24-->
{{Alert|title=Attention|text=Always create a backup first!}}
 
=Known problems= <!--T:12-->
 
==Blank page on step 3== <!--T:13-->


La herramienta LimeSurvey ComfortUpdate es una nueva funci&oacute;n incluida a partir de la versi&oacute;n 1.87 o superior de LimeSurvey y est&aacute; pensada para actualizar su instalaci&oacute;n de LimeSurvey de forma autom&aacute;tica con un par de clics de rat&oacute;n, en vez de tener que realizar una [[Upgrading from a previous version|actualizaci&oacute;n manual]]. ComfortUpdate es un servicio en pruebas  - lo que significa que en alg&uacute;n momento tenga que pagar una peque&ntilde;a cuota para comprar una clave de actualizaci&oacute;n valida durante un cierto per&iacute;odo de tiempo. En la actualidad la funci&oacute;n ConfortUpdate todavia esta en periodo de prueba y por eso es gratuita.
<!--T:14-->
If you get a blank page on step 3, it usually means that the memory limit of your PHP configuration is set too low. During that step, LimeSurvey tries to create a database backup and a file backup (of the files that will be replaced).


=Requisitos=
==Using a proxy server to connect to update.limesurvey.com== <!--T:15-->


The only requirement for the ComfortUpdate is that your PHP has to be compiled with ZLib support which is pretty standard - see PHP documentation [http://php.net/manual/en/book.zlib.php].
<!--T:16-->
If you are behind a proxy, you may have to adjust some settings to be able to use ComfortUpdate. In LimeSurvey 2.05 (later than build 140404), you can set the details of your proxy server in the configuration file (see [https://manual.limesurvey.org/Optional_settings#General_settings the general settings wiki]).


=Utilizaci&oacute;n  de ConfortUpdate.=
<!--T:19-->
For earlier versions, you have to edit the http.php file in your LimeSurvey installation. Have a look at the variables in the first lines of this file in a text editor and add values if needed.


The update feature should be safe to use even when you have running/activated surveys.
<!--T:17-->
*Enter the [[Global settings]] dialog, choose the first tab and click the button to search for an update.
Example: Connect to a proxy server 111.111.111.111 port 1234 without authentication and edit the following lines to look like:
*If an update is found another link will be shown pointing to the ComfortUpdate. Click on that link to start.
  var $proxy_host_name="111.111.111.111";
*If you have never used the ComfortUpdate before or your update key is invalid you will be asked now to enter an update key. During the beta period it is fine to use the pre-filled key for an unlimited period of time.
  var $proxy_host_port=1234;
*In a second step your directories will be checked to see if all necessary files are writable. Also the change log from your actual version to the current version will be shown.
*After solving any write permission problems you will be allowed to go to the next update step.
*In this step your database (only on MySQL DB) and your files will be saved to your LimeSurvey /tmp directory. Make sure that you are moving these files after upgrading to some new location. Their file name is pretty unguessable but better safe than sorry - if you don't move these files they usually will get deleted after some time. If you don't use MySQL then backup your database using your own database backup tools.
*The last step downloads the update package (a package that only contains the changed files and so is mostly small in size) and updates your files.
*Done!


Como se dijo anteriormente,esta caracter&iacute;stica todav&iacute;a est&aacute; fase de desarrollo. Por favor utilice esta funci&oacute;n con cuidado y informe de cualquier problema que pueda encontrar durante su uso en el [http://bugs.limesurvey.org sistema de control de errores] de LimeSurvey.
<!--T:18-->
Depending on your version, you will find the file either in /admin/classes/ or in /application/libraries/admin/http/. There are pre-coded variables within the file. Therefore, only details of your proxy are needed. If your installation is running unusually slow, wrong proxy settings may be the cause.
</translate>

Revision as of 16:39, 27 December 2018

Other languages:

General

The ComfortUpdate tool is a LimeSurvey professional service to update your LimeSurvey installation easily from your web browser with just a few mouse clicks (instead of having to perform a manual update).

In order to use and test ComfortUpdate, you have to sign up on LimeSurvey to receive a free trial key. After that trial key has expired you can either buy one of our premium packages or update your installation manually.

  In order to copy and use your ComfortUpdate key, access your LimeSurvey profile and click on COMFORTUPDATE KEYS, which is located in the profile menu (left side of the page).


Requirements

Your PHP installation must be compiled with support for ZLib. Check your PHPInfo and ask your system administrator for a confirmation.

Your server must be able to connect by SSL to update.limesurvey.org and update-data.limesurvey.org to use the ComfortUpdate tool. If you have problems with this and get error messages such as 10060 could not connect to the host 'update.limesurvey.org', you will have to tweak/edit your proxy/firewall security settings or ask your server administrator for further guidance and help.

Using ComfortUpdate

The LimeSurvey ComfortUpdate feature is safe to use even with active surveys. It does not delete or destroy any existing data. However, you should keep in mind that this is a beta feature. Therefore, it is important to have your database and files manually backed up before proceeding.

  • Find the Update button
    • For the older LimeSurvey versions, go to the Global Settings Icon, select the first tab, and click on the Updates button
    • For the recent Limesurvey versions, you may find the ComfortUpdate button in the Configuration dialog, under the Advanced tab:



  • The ComfortUpdate screen will display an update link if a new version of LimeSurvey is available. If not, click “Check now” to see if a new update is available
  • If an update is found, LimeSurvey will display a link to allow you to update. Click on this to begin updating
  • If you have never used ComfortUpdate before or the ComfortUpdate upgrade key is not valid, you will be asked to enter an upgrade key. Use the default key for free updates during the trial period



  • LimeSurvey will now verify your installation directory to check if the appropriate permissions are set to allow an update. A list of proposed changes will be displayed
  • If there are any problems, you must correct them at this point and then proceed to the next step
  • The ComfortUpdate will now make a backup of your database (if you use MySQL) and save your old installation files in the /tmp directory. If you use a different database, you should backup your database manually before proceeding

ComfortUpdate will now update your installation to the latest version, updating also the database in order to reflect the new (possible) changes.

Disabling ComfortUpdate

If you want to disable ComfortUpdate in order not to get the New release available popup messages after each new release, you can add the following option to your "config.php" file (which is located in /limesurvey/application/config): 

'updatable' => false
  Attention : Always create a backup first!


Known problems

Blank page on step 3

If you get a blank page on step 3, it usually means that the memory limit of your PHP configuration is set too low. During that step, LimeSurvey tries to create a database backup and a file backup (of the files that will be replaced).

Using a proxy server to connect to update.limesurvey.com

If you are behind a proxy, you may have to adjust some settings to be able to use ComfortUpdate. In LimeSurvey 2.05 (later than build 140404), you can set the details of your proxy server in the configuration file (see the general settings wiki).

For earlier versions, you have to edit the http.php file in your LimeSurvey installation. Have a look at the variables in the first lines of this file in a text editor and add values if needed.

Example: Connect to a proxy server 111.111.111.111 port 1234 without authentication and edit the following lines to look like: 

 var $proxy_host_name="111.111.111.111";
 var $proxy_host_port=1234;

Depending on your version, you will find the file either in /admin/classes/ or in /application/libraries/admin/http/. There are pre-coded variables within the file. Therefore, only details of your proxy are needed. If your installation is running unusually slow, wrong proxy settings may be the cause.

Retrieved from "http://manual.limesurvey.org/index.php?title=ComfortUpdate&oldid=132892"