Upgrading from a previous version/it

Pagine aggiuntive:{toc}

Prima di iniziare...

... leggi questo perché è molto importante: Esegui sempre il backup dei file e del database della tua installazione corrente!

Puoi farlo utilizzando uno strumento di amministrazione del database come phpMyAdmin e un file manager! Se non sai come fare, non dovresti procedere oltre e chiedere a qualcuno che lo sa.

Consiglio per l'utilizzo di ComfortUpdate

Il modo più semplice/sicuro per eseguire l'upgrade è utilizzare il nostro servizio ComfortUpdate.

Istruzioni per l'aggiornamento (da 2.x o più recente a qualsiasi versione successiva)

Segui queste istruzioni:

• Esegui il backup dei file e del database (l'abbiamo già detto?).
• Elimina tutti i vecchi file/ cartelle tranne:
  • /application/config/security.php -Importante!! Questa è la chiave per tutti i dati crittografati in LimeSurvey (versione 4 e successive)
  • /application/config/config.php;
  • /upload directory

Nota: Se disponi di modelli personalizzati in /upload/templates, assicurati di "aggiornarli" con eventuali modifiche apportate con la nuova versione di LimeSurvey. Il modo più semplice per verificare tali modifiche è confrontare i file del vecchio modello con la nuova versione del modello predefinito. Se vedi differenze diverse dalle tue personalizzazioni, è necessario un aggiornamento.

• Copia i nuovi file dal nuovo pacchetto LimeSurvey nella posizione esistente.
• Apri la pagina di amministrazione nel tuo browser (ad es. https://www.example.com/limesurvey/admin) e controlla se un database è necessario l'aggiornamento dello schema.
• Dopo l'aggiornamento: Svuota la cache del browser e cancella i cookie!

Istruzioni per versioni precedenti

Sfortunatamente, ci sono un paio di cose da considerare, quindi leggi attentamente le seguenti istruzioni.

Aggiornamento dalla versione 1.50 o successiva a qualsiasi versione successiva 2.xx

• Scarica l'ultima versione di LimeSurvey
• Esegui il backup file e database (l'abbiamo già detto?).
• Sostituisci tutti i file della directory di installazione
  • Elimina tutti i vecchi file nella directory di installazione esistente
  • Carica e decomprimi i nuovi file della nuova versione nella stessa directory di installazione
  • Se la tua versione precedente è precedente alla 1.90, copia tutti i modelli personalizzati in /upload/templates: potrai anche è necessario rinominare ogni directory del modello il cui nome corrisponde a un modello esistente in /templates
  • Copia la tua directory /upload nella vecchia posizione
  • Ricontrolla i permessi impostati nelle directory (è richiesto l'accesso in scrittura a /tmp, /upload e alle relative sottodirectory) come descritto in installation wiki
  • Apri http://<yourdomain> /<yourlimesurveydir> /admin nel tuo browser e segui le istruzioni (troverai i dati del database nel vecchio config.php). Il database esistente verrà rilevato automaticamente e, se necessario, aggiornato dopo la conferma.
• Controlla se si applicano controlli manuali speciali come elencato di seguito
• Ora, cancella la cache del browser e i cookie e sei buono per andare

  Si prega di notare che la struttura del modello è cambiata con l'aggiornamento da 2.0x a 2.50 o successivo. I tuoi vecchi modelli non funzioneranno più poiché il sistema dei modelli ora utilizza modelli reattivi.

Controlli speciali dopo un aggiornamento:

• da qualsiasi versione precedente alla 2.xx: Ora i codici delle domande corretti sono obbligatori. Dopo aver aggiornato l'installazione, controllare la logica del sondaggio di tutti i sondaggi e correggere i codici ove necessario
• da una versione precedente alla v1.53: Quando si esegue l'aggiornamento da una versione precedente alla v1.53 all'ultima versione , controllare i diritti utente globali di ciascun utente. Nella v1.53 è stato introdotto un nuovo diritto superadmin che può concedere a un utente gli stessi privilegi dell'account amministratore principale creato durante l'installazione. Lo script di aggiornamento indovina a chi deve essere concessa questa autorizzazione nelle versioni precedenti. Poiché questo non è perfetto, dovrebbe essere controllato attentamente.
• da qualsiasi versione precedente alla v2.06: Dalla 2.05 alla 2.06, sono stati attivati alcuni permessi inutilizzati durante la modifica dei permessi globali per i 'sondaggi'. Ad esempio, se un utente disponeva solo dell'autorizzazione "crea" nella 2.05, anche le altre autorizzazioni situate a destra di "crea" verrebbero attivate con l'aggiornamento alla 2.06 (Visualizza/leggi, Aggiorna, Elimina, Importa, Esporta). Verifica se gli utenti amministratori hanno ottenuto altre autorizzazioni globali oltre a quelle "originali" dopo l'aggiornamento. Se sì, modificali di conseguenza.

Aggiornamento dalla versione 1.50 o successiva a qualsiasi versione successiva 1.xx

• Scarica la versione desiderata di LimeSurvey
• Fai il backup del tuo file e database (l'abbiamo già detto?).
• Sostituisci tutti i file della directory di installazione
  • Elimina tutti i vecchi file nella directory di installazione esistente
  • Carica e scompatta la nuova versione del codice nella stessa directory di installazione
  • Modifica o sostituisci il file config.php:
    • Se la tua versione precedente was < 1.70: modifica il nuovo config.php per riflettere le modifiche dal file di backup config.php. Non sovrascrivere semplicemente il nuovo config.php con quello vecchio!
    • Se la tua versione precedente era >= 1.70: Sostituisci semplicemente il nuovo config. php con il tuo file di backup config.php (poiché il formato del file non è cambiato)
  • Se la tua versione precedente era precedente alla 1.90: Copia tutti i modelli personalizzati in /upload/templates - dovrai anche rinominare ogni directory del modello il cui nome corrisponde a un modello esistente in /templates
  • Copia la tua directory /upload nella vecchia posizione
  • Ricontrolla il set di autorizzazioni nelle directory di LimeSurvey (è richiesto l'accesso in scrittura a /tmp, /upload e alle loro sottodirectory) come descritto nel installation wiki
• Termina il processo di installazione/aggiornamento
  • Dopo aver aperto l'URL della tua amministrazione LimeSurvey, le tabelle del database verranno aggiornate dopo la conferma
  • Rimuovi o rinomina la directory /admin/install come/if indicato dallo script di installazione
  • Verificare se si applicano controlli manuali speciali (come elencato di seguito)

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.