Upgrading from a previous version/pl

Dodatkowe strony:{toc}

Zanim zaczniesz...

... przeczytaj to, ponieważ jest to bardzo ważne: Zawsze twórz kopie zapasowe plików i bazy danych bieżącej instalacji!

Możesz to zrobić za pomocą narzędzia do administrowania bazą danych, takiego jak phpMyAdmin i menedżera plików! Jeśli nie wiesz jak to zrobić, nie powinieneś kontynuować dalej i zapytać kogoś, kto się na tym zna.

Zalecenie użycia ComfortUpdate

Najłatwiejszym/najbezpieczniejszym sposobem aktualizacji jest skorzystanie z naszej usługi ComfortUpdate.

Instrukcje aktualizacji (z wersji 2.x lub nowszej do dowolnej nowszej wersji)

Postępuj zgodnie z poniższymi instrukcjami:

• Zrób kopię zapasową plików i bazy danych (czy już o tym wspominaliśmy?).
• Usuń wszystkie stare pliki/ foldery z wyjątkiem:
  • /application/config/security.php -Ważne!! To jest klucz do wszystkich zaszyfrowanych danych w LimeSurvey (wersja 4 i nowsze)
  • /application/config/config.php;
  • /upload katalog

Uwaga: Jeśli masz jakieś niestandardowe szablony w /upload/templates, pamiętaj o ich „odświeżeniu” o wszelkie zmiany wprowadzone w nowej wersji LimeSurvey. Najłatwiejszym sposobem sprawdzenia takich zmian jest porównanie starego szablonu z nową wersją szablonu domyślnego. Jeśli zauważysz jakieś różnice poza dostosowaniami, konieczne jest odświeżenie.

• Skopiuj nowe pliki z nowego pakietu LimeSurvey do istniejącej lokalizacji.
• Otwórz stronę administracyjną w swojej przeglądarce (np. https://www.example.com/limesurvey/admin) i sprawdź, czy baza danych konieczna jest aktualizacja schematu.
• Po aktualizacji: Wyczyść pamięć podręczną przeglądarki i pliki cookie!

Instrukcje dla starszych wersji

Niestety należy wziąć pod uwagę kilka kwestii, dlatego prosimy o uważne przeczytanie poniższych instrukcji.

Aktualizacja z wersji 1.50 lub nowszej do dowolnej nowszej wersji 2.xx

• Pobierz najnowszą wersję LimeSurvey
• Utwórz kopię zapasową swojego plików i bazy danych (czy już o tym wspominaliśmy?).
• Zastąp wszystkie pliki katalogu instalacyjnego
  • Usuń wszystkie stare pliki w istniejący katalog instalacyjny
  • Prześlij i rozpakuj nowe pliki nowej wersji do tego samego katalogu instalacyjnego
  • Jeśli Twoja poprzednia wersja jest starsza niż 1.90, skopiuj dowolne niestandardowe szablony do /upload/templates - zostaniesz również musisz zmienić nazwę każdego katalogu szablonów, którego nazwa pasuje do istniejącego szablonu w /templates
  • Skopiuj katalog /upload z powrotem do starej lokalizacji
  • Sprawdź dwukrotnie uprawnienia ustawione dla katalogów (wymagany jest dostęp do zapisu do /tmp, /upload i ich podkatalogów) zgodnie z opisem w wiki instalacyjne
  • Otwórz http://<yourdomain> /<yourlimesurveydir> /admin w przeglądarce i postępuj zgodnie z instrukcjami (dane bazy danych znajdziesz w starym pliku config.php). Istniejąca baza danych zostanie automatycznie wykryta i w razie potrzeby zaktualizowana po potwierdzeniu.
• Sprawdź, czy nie obowiązują specjalne ręczne kontrole wymienione poniżej
• Teraz wyczyść pamięć podręczną przeglądarki i pliki cookie i gotowe dobrze iść

  Proszę pamiętać, że struktura szablonu uległa zmianie wraz z aktualizacją z wersji 2.0x do wersji 2.50 lub nowszej. Twoje stare szablony nie będą już działać, ponieważ system szablonów korzysta teraz z szablonów responsywnych.

Specjalne kontrole po aktualizacji:

• z dowolnej wcześniejszej wersji do 2.xx: Poprawne kody pytań są teraz obowiązkowe. Po aktualizacji instalacji sprawdź logikę ankiet we wszystkich ankietach i w razie potrzeby popraw kody
• z wersji wcześniejszej niż v1.53: podczas aktualizacji z wersji wcześniejszej niż v1.53 do najnowszej , sprawdź „globalne prawa użytkownika” każdego użytkownika. W wersji 1.53 wprowadzono nowe prawo „superadministratora”, które może dać użytkownikowi te same uprawnienia, co główne konto administracyjne utworzone podczas instalacji. Skrypt aktualizacyjny zgaduje, komu należy nadać to uprawnienie w starszych wersjach. Ponieważ nie jest to idealne rozwiązanie, należy to dokładnie sprawdzić.
• od dowolnej wcześniejszej wersji do wersji 2.06: Od wersji 2.05 do 2.06 aktywowano niektóre niewykorzystane uprawnienia podczas edycji uprawnień globalnych dla „ankiet”. Na przykład, jeśli użytkownik miał tylko uprawnienia „tworzenia” w wersji 2.05, inne uprawnienia znajdujące się po prawej stronie „tworzenia” również zostaną aktywowane wraz z aktualizacją do wersji 2.06 (Wyświetlanie/odczyt, aktualizacja, usuwanie, importowanie, eksportowanie). Sprawdź, czy po aktualizacji użytkownicy administracyjni otrzymali inne uprawnienia globalne oprócz „oryginalnych”. Jeśli tak, zmień je odpowiednio.

Aktualizacja z wersji 1.50 lub nowszej do dowolnej nowszej wersji 1.xx

• Pobierz żądaną wersję LimeSurvey
• Utwórz kopię zapasową plików i bazy danych (czy już o tym wspominaliśmy?).
• Zastąp wszystkie pliki katalogu instalacyjnego
  • Usuń wszystkie stare pliki w istniejący katalog instalacyjny
  • Prześlij i rozpakuj nową wersję kodu do tego samego katalogu instalacyjnego
  • Edytuj lub zamień plik „config.php”:
    • Jeśli Twoja poprzednia wersja was < 1.70: Edytuj nowy plik „config.php” w celu odzwierciedlenia zmian z pliku kopii zapasowej „config.php”. Nie zastępuj po prostu nowego pliku config.php starym!
    • Jeśli poprzednia wersja była >= 1.70: Po prostu zamień nowy plik config. php z kopią zapasową pliku config.php (ponieważ format pliku się nie zmienił)
  • Jeśli poprzednia wersja była starsza niż 1.90: Skopiuj wszystkie niestandardowe szablony do /upload/templates - będziesz także musiał zmienić nazwę każdego katalogu szablonów, którego nazwa pasuje do istniejącego szablonu w /templates
  • Skopiuj katalog /upload z powrotem do starej lokalizacji
  • Sprawdź dwukrotnie zestaw „uprawnień” w katalogach LimeSurvey (wymagany jest dostęp do zapisu do /tmp, /upload i ich podkatalogów), jak opisano w wiki instalacyjne
• Zakończ proces instalacji/aktualizacji
  • Po otwarciu adresu URL do administracji LimeSurvey, tabele bazy danych zostaną zaktualizowane po potwierdzeniu
  • Usuń lub zmień nazwę katalogu /admin/install na/if zgodnie ze skryptem instalacyjnym
  • Sprawdź, czy mają zastosowanie jakieś specjalne kontrole ręczne (wymienione poniżej)

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.