Actions

Upgrading from a previous version/es: Difference between revisions

From LimeSurvey Manual

(Updating to match new version of source page)
(Updating to match new version of source page)
Line 3: Line 3:
=Antes de empezar...=
=Antes de empezar...=


<span style='color:#FF0000'>... read this because it is very important: '''Always backup the files and the database of your current installation!'''</span>
<div class="mw-translate-fuzzy">
<span style='color:#FF0000'>... lea esta información porque es muy importante:'''Realice siempre copias de seguridad tanto de los archivos de la aplicación como de la información contenida en la base de datos de la versión de LimeSurvey que esté funcionando en su entorno de producción'''</span>
</div>


You can do this using a database administration tool like [https://www.phpmyadmin.net phpMyAdmin] and a file manager! If you don't know how to do this, you should not proceed further and ask someone who knows or use the [[ComfortUpdate]] instead.
<div class="mw-translate-fuzzy">
Puede hacer esto utilizando una herramienta de administración de bases de datos como por ejemplo,[http://www.phpmyadmin.net phpMyAdmin], y un administrador de archivos. Si no sabe como llevar a cabo estas operaciones, debería preguntarle a alguien que sepa como realizarlas o utilizar la herramienta [[ComfortUpdate]] en su lugar.
</div>


=La forma fácil (para actualizaciones entre versiones menores)=
=La forma fácil (para actualizaciones entre versiones menores)=


You can use these instructions if you are doing a minor upgrade (for example from 2.00 to 2.01):
<div class="mw-translate-fuzzy">
*Backup your files and database ([[Upgrading from a previous version#Before you start...|did we already mention that?]]).
Puede utilizar estas instrucciones si está haciendo una actualización entre versiones que tienen cambios menores, como por ejemplo de la versión 1.86 a la 1.87
*Delete all the old files/folders except for:
*Realice copias de seguridad tanto de los archivos como de la información contenidad en la base de datos de su versión de LimeSurvey (Ya hemos mencionado esto con anterioridad)
**/application/config/config.php;
*Borre todos los archivos y directorios antiguos con la excepción de:
**/upload directory -
**El archivo config.php
<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>
**El directorio /templates
*Copy the new files from the new LimeSurvey package to the existing location.
**El directorio /upload
*Open the admin page in your browser (e.g. https://www.example.com/limesurvey/admin) and check if a database scheme upgrade is necessary.
*Copie los nuevos archivos desde el paquete que contiene la nueva versión de LimeSurvey a la ubicación donde estaba alojada la versión a actualizar. Sea cuidado, intente NO sobrescribir el archivo config.php En caso de que lo haya sobreescrito: Recuerde que en el paso anterior, ha realizado una copia de seguridad de la instalación a actualizar. Puede sobrescribir sin ningún problema el resto de los archivos existentes.
*After the upgrade: '''Clear your browser cache and cookies!'''
*Si encuentra algún problema después de la actualización: ¡Borre la caché y las cookies de su navegador!
</div>


=La forma completa (para saltos importantes entre versiones)=
=La forma completa (para saltos importantes entre versiones)=


Unfortunately, there are a couple of things to consider, so please read the following instructions carefully.
<div class="mw-translate-fuzzy">
Lamentablemente hay varias cosas que hay que tener en cuenta a la hora de llevar a cabo la actualización, por favor, lea las siguientes instrucciones con mucha atención.
</div>


==Upgrading from version 1.50 or later to any later 2.xx version==
<div class="mw-translate-fuzzy">
*[https://www.limesurvey.org/about-limesurvey/download Download] the latest version of LimeSurvey
==Actualizar desde la versión 1.50 o posterior a la última versión 1.xx.==
* Prepare and backup the old installation
#[http://www.limesurvey.org/download Descargue] la última versión of LimeSurvey.
** Backup your installation directory files and SQL-based database just in case
# Prepare y haga un backup de la instalación anterior.
*** 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 cps100 directory
## Haga copias de seguridad de los archivos del directorio de instalación previa y vuelque a un archivo SQL toda la información contenida en la base de datos de su instalación previa.
*** You can use [https://www.phpmyadmin.net phpMyAdmin] to export all tables or you can use the backup database function of LimeSurvey that is available in the configuration dialog (under the advanced tab) to backup the entire database
### Desde la línea de comandos, genere un archivo '''.zip''' o similar con el contenido completo del directorio de instalación. Por ejemplo el comando, tar cvzf foo.tgz cps100 comprimirá el contenido del directorio cps100.
<div class="simplebox">[[File:help.png]] '''Note:''' Look for the '''LimeSurvey Administration''' button [[File:button-export-sql.png]] to export the database in the older LimeSurvey versions</div>
### Utilice la herramienta phpMyAdmin o similar para exportar todas las tablas de la base de datos o utilice el botón ''' Administración de LimeSurvey''' [[File:button-export-sql.png]] para realizar una copia de seguridad de la base de datos completa.
* Copy your '''config.php''' file, modified '''template''' directories, and the /upload directory separately for quick access later
## Copie su archivo '''config.php''' y mueva los directorios '''templates''' y '''upload''' para poder acceder a ellos correctamente posteriormente.
* Replace all the installation directory files
# Reemplace todos los archivos del directorio de instalación de LimeSurvey.
** Delete all old files in the existing installation directory
## Borre todos los archivos viejos existentes en el directorio de instalación de LimeSurvey.
** Upload and unpack the new code version into the same installation directory
## Suba a su servidor y descomprima la nueva versión de LimeSurvey al mismo directorio de instalación donde ha realizado la limpieza de archivos innecesarios.
** 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
## Edite o reemplace el archivo '''config.php''':
** Copy your /upload directory back to the old location
### Si su versión de LimeSurvey es < 1.70: Edite el nuevo archivo '''config.php''' para reflejar los cambios en la configuración de la copia de seguridad del archivo '''config.php'''. '''¡No sobrescriba el archivo '''config.php''' nuevo con el viejo!'''
** Double-check the '''permissions''' set on the directories (write access to '''/tmp''', '''/upload''', and their subdirectories is required) as described in the [[Installation#Set directory permissions|installation wiki]]
### Si su versión de LimeSurvey es >= 1.70: Simplemente reemplace el archivo '''config.php''' con la copia de su archivo '''config.php''' (ya que el formato del archivo no ha cambiado).
** 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
## Copie sus nuevas plantillas, o las plantillas modificadas, al directorio templates.
* Check if any special manual checks apply as listed below
## Revise los '''permisoso''' establecidos en los directorios (write access to '''/tmp''', '''/upload''' and '''/templates''' is required) tal y como se describe en la página de [http://docs.limesurvey.org/tiki-index.php?page=Installation&structure;=English+Instructions+for+LimeSurvey#Set_Directory_permissions Installation]
* '''Now, clear your browser cache and cookies(!)''' and you are good to go
# Modifique las nuevas tablas de la base de datos y finalice el proceso de instalación
## En cuanto abra la URL del panel de administración de LimeSurvey las diferentes tablas que forman parte de la base de datos serán actualizadas automáticamente (¡Tenga cuidado!)
## Elimine o renombre el directorio '''/admin/install''' tal y como le indica el script de instalación.
## Compruebe si tiene que realizar algún tipo de chequeo manual, tal y como se muestra en la siguiente sección de este documento.
# Ha terminado (:biggrin:). Si encuentra algún problema después de la actualización: ¡Borre la caché y las cookies de su navegador!
</div>


{{Alert|title=Attention|text=If you upgrade from e.g. 1.92, it might be necessary ''first'' to upgrade to the latest 1.92 release, then to 2.00, then to 2.06, and then finally to the latest version (e.g. 2.55.x). Read below for [[Upgrading from a previous version#Upgrading from version 1.50 or later to any later 1.xx version|further details]].}}
{{Alert|title=Attention|text=If you upgrade from e.g. 1.92, it might be necessary ''first'' to upgrade to the latest 1.92 release, then to 2.00, then to 2.06, and then finally to the latest version (e.g. 2.55.x). Read below for [[Upgrading from a previous version#Upgrading from version 1.50 or later to any later 1.xx version|further details]].}}
Line 45: Line 57:
{{Alert|title=Attention|text=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.}}
{{Alert|title=Attention|text=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.}}


<div class="simplebox">'''Special checks after an upgrade''':
<div class="mw-translate-fuzzy">
*'''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
<div class="simplebox">'''Comprobaciones especiales a realizar después de una actualización''':
*'''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
*'''Desde la versión 1.53/1.7x a la versión 1.8x''': Las '''plantillas''' han sufrido demasiados cambios. Por favor comprueba que tus plantillas se muestran de forma correcta. Si no se muestran correctamente tendrás que editar tus plantillas para que funcionen correctamente (comprueba las plantillas originales para ver que es lo que ha cambiado)<br />
*'''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
*'''Desde una versión anterior a la v1.53''': Cuando actualice LimeSurvey desde una versión anterior a la v1.53 a la última versión, por favor compruebe los'''derechos globales''' de cada usuario. Hay un nuevo rol '''superadmin''' introducido en la versión1.53 que puede dar a un usuario con los mismo privilegios que la cuenta maestra creada durante la instalación. El scrip de actualización intentará adivinar a que usuario de las versiones antiguas puede darle este derecho. Como este sitema no es del todo perfecto, por favor, reviselos con cuidado para evitar posibles problemas.</div>
</div>
</div>


==Upgrading from version 1.50 or later to any later 1.xx version==
<div class="mw-translate-fuzzy">
*[https://www.limesurvey.org/about-limesurvey/download Download] the desired version of LimeSurvey
==Actualizar LimeSurvey desde una versión anterior a la 1.50 (desde la versión 1.0 a la versión 1.44)==
* Prepare and backup the old installation
 
** Backup your installation directory files and SQL-based database just in case
Debido a los cambios realizados, entre otras muchas cosasm en la estructura de los datos, '''la actualización desde una versión anterior a la v1.50 No es posible'''.  Si tiene archivos de encuestas con la extensión *.sql la única forma de que funcionen en una versión más reciente es instalar [https://sourceforge.net/projects/limesurvey/files/1._LimeSurvey_stable/Old%20versions%20up%20to%201.5/ la versión 1.50], importar los archivos .sql, y posteriormente actualizar esta versión a la versión más reciente de LimeSurvey. Para más información puede ver [[Transferring an installation]].
*** 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
</div>
*** Using [https://www.phpmyadmin.net phpMyAdmin] or similar to export all tables; or using the '''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
* 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#Set Directory permissions|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)


<div class="simplebox">'''Special checks after an upgrade''':
<div class="simplebox">'''Special checks after an upgrade''':
Line 83: Line 80:
La última versión de LimeSurvey que ofrece soporte para PHP4 es la versión 1.82+.
La última versión de LimeSurvey que ofrece soporte para PHP4 es la versión 1.82+.


Since the data structure and a lot of other things were changed, '''upgrading from any version previous to v1.50 is <u>NOT</u> 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 [http://www.limesurvey.org/en/archived-releases/289-limesurvey150zip version 1.50], import the .sql file(s) there, then upgrade that version to the most recent LimeSurvey version. Check the page related to [[Transferring an installation|how an installation can be transferred]] for more details.
<div class="mw-translate-fuzzy">
==&iquest;Puedo actualizar LimeSurvey si tengo encuestas activas?==
 
Si, si que puede. Si hay algun tipo de excepción, esta debió mencionarse en las instrucciones indicadas anteriormente. Le recomendamos encarecidamente que pruebe sus encuestas despues de la actualizaciión para comprobar si los dise&ntilde;os de sus plantillas funcionan perfectamente.
</div>
 
= Upgrading using CLI =
 
You can upgrade Database using PHP Cli using <code>php application/commands/console.php updatedb</code>. This allow you to set up an auto upgrade system only via command line in a crontab for example.
 


=FAQ=
=FAQ=

Revision as of 17:50, 1 November 2018

Additional pages:{toc}

Antes de empezar...

... lea esta información porque es muy importante:Realice siempre copias de seguridad tanto de los archivos de la aplicación como de la información contenida en la base de datos de la versión de LimeSurvey que esté funcionando en su entorno de producción

Puede hacer esto utilizando una herramienta de administración de bases de datos como por ejemplo,phpMyAdmin, y un administrador de archivos. Si no sabe como llevar a cabo estas operaciones, debería preguntarle a alguien que sepa como realizarlas o utilizar la herramienta ComfortUpdate en su lugar.

La forma fácil (para actualizaciones entre versiones menores)

Puede utilizar estas instrucciones si está haciendo una actualización entre versiones que tienen cambios menores, como por ejemplo de la versión 1.86 a la 1.87

  • Realice copias de seguridad tanto de los archivos como de la información contenidad en la base de datos de su versión de LimeSurvey (Ya hemos mencionado esto con anterioridad)
  • Borre todos los archivos y directorios antiguos con la excepción de:
    • El archivo config.php
    • El directorio /templates
    • El directorio /upload
  • Copie los nuevos archivos desde el paquete que contiene la nueva versión de LimeSurvey a la ubicación donde estaba alojada la versión a actualizar. Sea cuidado, intente NO sobrescribir el archivo config.php En caso de que lo haya sobreescrito: Recuerde que en el paso anterior, ha realizado una copia de seguridad de la instalación a actualizar. Puede sobrescribir sin ningún problema el resto de los archivos existentes.
  • Si encuentra algún problema después de la actualización: ¡Borre la caché y las cookies de su navegador!

La forma completa (para saltos importantes entre versiones)

Lamentablemente hay varias cosas que hay que tener en cuenta a la hora de llevar a cabo la actualización, por favor, lea las siguientes instrucciones con mucha atención.

Actualizar desde la versión 1.50 o posterior a la última versión 1.xx.

  1. Descargue la última versión of LimeSurvey.
  2. Prepare y haga un backup de la instalación anterior.
    1. Haga copias de seguridad de los archivos del directorio de instalación previa y vuelque a un archivo SQL toda la información contenida en la base de datos de su instalación previa.
      1. Desde la línea de comandos, genere un archivo .zip o similar con el contenido completo del directorio de instalación. Por ejemplo el comando, tar cvzf foo.tgz cps100 comprimirá el contenido del directorio cps100.
      2. Utilice la herramienta phpMyAdmin o similar para exportar todas las tablas de la base de datos o utilice el botón Administración de LimeSurvey para realizar una copia de seguridad de la base de datos completa.
    2. Copie su archivo config.php y mueva los directorios templates y upload para poder acceder a ellos correctamente posteriormente.
  3. Reemplace todos los archivos del directorio de instalación de LimeSurvey.
    1. Borre todos los archivos viejos existentes en el directorio de instalación de LimeSurvey.
    2. Suba a su servidor y descomprima la nueva versión de LimeSurvey al mismo directorio de instalación donde ha realizado la limpieza de archivos innecesarios.
    3. Edite o reemplace el archivo config.php:
      1. Si su versión de LimeSurvey es < 1.70: Edite el nuevo archivo config.php para reflejar los cambios en la configuración de la copia de seguridad del archivo config.php. ¡No sobrescriba el archivo config.php nuevo con el viejo!
      2. Si su versión de LimeSurvey es >= 1.70: Simplemente reemplace el archivo config.php con la copia de su archivo config.php (ya que el formato del archivo no ha cambiado).
    4. Copie sus nuevas plantillas, o las plantillas modificadas, al directorio templates.
    5. Revise los permisoso establecidos en los directorios (write access to /tmp, /upload and /templates is required) tal y como se describe en la página de Installation
  4. Modifique las nuevas tablas de la base de datos y finalice el proceso de instalación
    1. En cuanto abra la URL del panel de administración de LimeSurvey las diferentes tablas que forman parte de la base de datos serán actualizadas automáticamente (¡Tenga cuidado!)
    2. Elimine o renombre el directorio /admin/install tal y como le indica el script de instalación.
    3. Compruebe si tiene que realizar algún tipo de chequeo manual, tal y como se muestra en la siguiente sección de este documento.
  5. Ha terminado (:biggrin:). Si encuentra algún problema después de la actualización: ¡Borre la caché y las cookies de su navegador!
  Attention : If you upgrade from e.g. 1.92, it might be necessary first to upgrade to the latest 1.92 release, then to 2.00, then to 2.06, and then finally to the latest version (e.g. 2.55.x). Read below for further details.


  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.


Comprobaciones especiales a realizar después de una actualización:
  • Desde la versión 1.53/1.7x a la versión 1.8x: Las plantillas han sufrido demasiados cambios. Por favor comprueba que tus plantillas se muestran de forma correcta. Si no se muestran correctamente tendrás que editar tus plantillas para que funcionen correctamente (comprueba las plantillas originales para ver que es lo que ha cambiado)
  • Desde una versión anterior a la v1.53: Cuando actualice LimeSurvey desde una versión anterior a la v1.53 a la última versión, por favor compruebe losderechos globales de cada usuario. Hay un nuevo rol superadmin introducido en la versión1.53 que puede dar a un usuario con los mismo privilegios que la cuenta maestra creada durante la instalación. El scrip de actualización intentará adivinar a que usuario de las versiones antiguas puede darle este derecho. Como este sitema no es del todo perfecto, por favor, reviselos con cuidado para evitar posibles problemas.

Actualizar LimeSurvey desde una versión anterior a la 1.50 (desde la versión 1.0 a la versión 1.44)

Debido a los cambios realizados, entre otras muchas cosasm en la estructura de los datos, la actualización desde una versión anterior a la v1.50 No es posible.  Si tiene archivos de encuestas con la extensión *.sql la única forma de que funcionen en una versión más reciente es instalar la versión 1.50, importar los archivos .sql, y posteriormente actualizar esta versión a la versión más reciente de LimeSurvey. Para más información puede ver Transferring an installation.

Special checks after an upgrade:
  • from any earlier version to 1.92: The templates have been changed. Please check your customized templates if they are still looking right. If not, you will have to edit your templates accordingly (check out the original templates to see what was changed)
  • 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.

PUF de actualización.

¿Cual es la versión más reciente de LimeSurvey que todavia soporta PHP4?

La última versión de LimeSurvey que ofrece soporte para PHP4 es la versión 1.82+.

¿Puedo actualizar LimeSurvey si tengo encuestas activas?

Si, si que puede. Si hay algun tipo de excepción, esta debió mencionarse en las instrucciones indicadas anteriormente. Le recomendamos encarecidamente que pruebe sus encuestas despues de la actualizaciión para comprobar si los diseños de sus plantillas funcionan perfectamente.

Upgrading using CLI

You can upgrade Database using PHP Cli using php application/commands/console.php updatedb. This allow you to set up an auto upgrade system only via command line in a crontab for example.


FAQ

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.

What is the best way to port the *.sql survey structure files of LimeSurvey to the latest version?

Install version 1.50, import the file, and export the survey structure to the newer .csv format. The latest version can still read the .csv survey structure format.