Upgrading from a previous version/vi

Các trang bổ sung:{toc}

Trước khi bạn bắt đầu...

... hãy đọc phần này vì nó rất quan trọng: Luôn sao lưu các tập tin và cơ sở dữ liệu của bản cài đặt hiện tại của bạn!

Bạn có thể thực hiện việc này bằng công cụ quản trị cơ sở dữ liệu như phpMyAdmin và trình quản lý tệp! Nếu bạn không biết cách thực hiện việc này, bạn không nên tiếp tục và hỏi người biết.

Khuyến nghị sử dụng ComfortUpdate

Cách dễ dàng/an toàn nhất để nâng cấp là sử dụng dịch vụ ComfortUpdate của chúng tôi.

Hướng dẫn nâng cấp (từ 2.x trở lên lên bất kỳ phiên bản nào mới hơn)

Vui lòng làm theo các hướng dẫn sau:

• Sao lưu các tệp và cơ sở dữ liệu của bạn (chúng tôi đã đề cập đến điều đó chưa?).
• Xóa tất cả các tệp cũ/ các thư mục ngoại trừ:
  • /application/config/security.php -Quan trọng!! Đây là chìa khóa cho tất cả dữ liệu được mã hóa trong thư mục LimeSurvey (phiên bản 4 trở lên)
  • /application/config/config.php;
  • /upload

Lưu ý: Nếu bạn có bất kỳ mẫu tùy chỉnh nào trong /upload/templates, hãy đảm bảo bạn 'làm mới' những mẫu đó với bất kỳ thay đổi nào đi kèm với phiên bản LimeSurvey mới. Cách dễ nhất để kiểm tra những thay đổi đó là so sánh tệp mẫu cũ của bạn với phiên bản mới của mẫu mặc định. Nếu bạn thấy bất kỳ sự khác biệt nào ngoài các tùy chỉnh của mình thì cần phải làm mới.

• Sao chép các tệp mới từ gói LimeSurvey mới vào vị trí hiện có.
• Mở trang quản trị trong trình duyệt của bạn (ví dụ: https://www.example.com/limesurvey/admin) và kiểm tra xem có cơ sở dữ liệu không nâng cấp chương trình là cần thiết.
• Sau khi nâng cấp: Xóa bộ nhớ cache và cookie trình duyệt của bạn!

Hướng dẫn cho các phiên bản cũ hơn

Rất tiếc, có một số điều cần cân nhắc, vì vậy vui lòng đọc kỹ hướng dẫn sau.

Nâng cấp từ phiên bản 1.50 trở lên lên bất kỳ phiên bản 2.xx nào mới hơn

• Tải xuống phiên bản mới nhất của LimeSurvey
• Sao lưu tập tin và cơ sở dữ liệu (chúng tôi đã đề cập đến điều đó chưa?).
• Thay thế tất cả các tập tin thư mục cài đặt
  • Xóa tất cả các tập tin cũ trong thư mục cài đặt hiện có
  • Tải lên và giải nén các tệp mới của phiên bản mới vào cùng thư mục cài đặt
  • Nếu phiên bản trước của bạn cũ hơn 1.90, hãy sao chép mọi mẫu tùy chỉnh vào /upload/templates - bạn cũng sẽ làm như vậy cần đổi tên từng thư mục mẫu có tên khớp với mẫu hiện có trong /templates
  • Sao chép thư mục /upload của bạn trở lại vị trí cũ
  • Kiểm tra kỹ quyền được đặt trên các thư mục (bắt buộc phải có quyền ghi vào /tmp', /upload và các thư mục con của chúng) như được mô tả trong installation wiki
  • Open http://<yourdomain> /<yourlimesurveydir> /admin trong trình duyệt của bạn và làm theo hướng dẫn (Bạn sẽ tìm thấy dữ liệu cơ sở dữ liệu trong config.php cũ). Cơ sở dữ liệu hiện có sẽ được tự động phát hiện và nếu cần, sẽ được nâng cấp sau khi xác nhận.
• Kiểm tra xem có áp dụng bất kỳ kiểm tra thủ công đặc biệt nào như được liệt kê bên dưới không
• Bây giờ, hãy xóa bộ nhớ cache và cookie của trình duyệt và bạn đã hoàn thành tốt để đi

Kiểm tra đặc biệt sau khi nâng cấp:

• từ bất kỳ phiên bản nào trước đó lên 2.xx: Mã câu hỏi thích hợp hiện là bắt buộc. Sau khi nâng cấp cài đặt, hãy kiểm tra logic khảo sát của tất cả các khảo sát và sửa mã khi cần thiết
• từ phiên bản cũ hơn v1.53: Khi nâng cấp từ phiên bản trước v1.53 lên phiên bản mới nhất , vui lòng kiểm tra quyền người dùng toàn cầu của mỗi người dùng. Có một quyền superadmin mới được giới thiệu trong v1.53 có thể cung cấp cho người dùng đặc quyền giống như tài khoản quản trị chính được tạo trong quá trình cài đặt. Tập lệnh nâng cấp đang đoán xem ai sẽ được cấp quyền này trong các phiên bản cũ hơn. Vì điều này chưa hoàn hảo nên cần được kiểm tra cẩn thận.
• từ bất kỳ phiên bản cũ nào đến v2.06: Từ 2.05 đến 2.06, một số quyền không được sử dụng khi chỉnh sửa các quyền chung cho 'khảo sát' đã được kích hoạt. Ví dụ: nếu người dùng chỉ có quyền 'tạo' trong 2.05 thì các quyền khác nằm ở bên phải 'tạo' cũng sẽ được kích hoạt khi cập nhật lên 2.06 (Xem/đọc, Cập nhật, Xóa, Nhập, Xuất). Vui lòng kiểm tra xem người dùng quản trị viên có bất kỳ quyền chung nào khác ngoài quyền 'gốc' sau khi cập nhật hay không. Nếu có, vui lòng chỉnh sửa chúng cho phù hợp.

Nâng cấp từ phiên bản 1.50 trở lên lên bất kỳ phiên bản 1.xx nào mới hơn

• Tải xuống phiên bản mong muốn của LimeSurvey
• Sao lưu tập tin và cơ sở dữ liệu (chúng tôi đã đề cập đến điều đó chưa?).
• Thay thế tất cả các tập tin thư mục cài đặt
  • Xóa tất cả các tập tin cũ trong thư mục cài đặt hiện có
  • Tải lên và giải nén phiên bản mã mới vào cùng thư mục cài đặt
  • Chỉnh sửa hoặc thay thế tệp config.php:
    • Nếu phiên bản trước của bạn là < 1,70: Chỉnh sửa config.php mới để phản ánh những thay đổi từ tệp config.php dự phòng. Đừng ghi đè config.php mới bằng cái cũ của bạn!
    • Nếu phiên bản trước của bạn >= 1.70: Chỉ cần thay thế config. php bằng tệp config.php dự phòng của bạn (vì định dạng tệp không thay đổi)
  • Nếu phiên bản trước của bạn cũ hơn 1.90: Sao chép mọi mẫu tùy chỉnh vào /upload/templates - bạn cũng sẽ cần đổi tên từng thư mục mẫu có tên khớp với mẫu hiện có trong /templates
  • Sao chép thư mục /upload của bạn trở lại vị trí cũ
  • Kiểm tra kỹ bộ quyền trên các thư mục của LimeSurvey (bắt buộc phải có quyền ghi vào /tmp, /upload và vào các thư mục con của chúng) như được mô tả trong wiki cài đặt
• Hoàn tất quá trình cài đặt/nâng cấp
  • Sau khi bạn mở URL tới quản trị LimeSurvey của mình, các bảng cơ sở dữ liệu sẽ được cập nhật sau khi xác nhận
  • Xóa hoặc đổi tên thư mục /admin/install thành/if được hướng dẫn bởi tập lệnh cài đặt
  • Kiểm tra xem có áp dụng bất kỳ kiểm tra thủ công đặc biệt nào không (như được liệt kê bên dưới)

Kiểm tra đặc biệt sau khi nâng cấp:

• 'Từ phiên bản cũ hơn v1.53: Khi nâng cấp từ phiên bản trước v1.53 lên phiên bản mới nhất, vui lòng kiểm tra 'quyền người dùng toàn cầu của mỗi người dùng. Có một quyền superadmin mới được giới thiệu trong v1.53 có thể cung cấp cho người dùng đặc quyền giống như tài khoản quản trị chính được tạo trong quá trình cài đặt. Tập lệnh nâng cấp đang đoán xem ai sẽ được cấp quyền này trong các phiên bản cũ hơn. Vì điều này không hoàn hảo nên cần phải kiểm tra cẩn thận.

Nâng cấp từ phiên bản cũ hơn v1.50 (v1.0 đến v1.44)

Vì cấu trúc dữ liệu và nhiều thứ khác đã được thay đổi nên Nâng cấp từ bất kỳ phiên bản nào trước đó lên v1.50 là KHÔNG thể. Nếu bạn có các tệp cấu trúc khảo sát cũ có phần mở rộng *.sql, cách duy nhất để đưa chúng vào phiên bản mới hơn là cài đặt phiên bản 1.50 , nhập (các) tệp .sql vào đó, sau đó nâng cấp phiên bản đó lên phiên bản LimeSurvey mới nhất. Kiểm tra trang liên quan đến cách chuyển cài đặt để biết thêm chi tiết.

Nâng cấp bằng CLI

Bạn có thể nâng cấp cơ sở dữ liệu thông qua PHP CLI: php application/commands/console.php updatedb . Điều này cho phép bạn thiết lập hệ thống tự động nâng cấp thông qua dòng lệnh (ví dụ: trong crontab), mặc dù điều này không được khuyến khích.

Nâng cấp cơ sở dữ liệu không thành công sau khi cập nhật thủ công/ComfortUpdate

Đôi khi, ngay cả khi bạn đã làm mọi thứ đúng, mọi thứ vẫn không diễn ra như mong đợi trong quá trình nâng cấp cơ sở dữ liệu. Điều đó có thể xảy ra vì nhiều lý do: Các phiên bản cơ sở dữ liệu khác nhau , định dạng hoặc nội dung dữ liệu không mong muốn, cấu hình bất thường hoặc bất kỳ thứ gì khác không hiển thị trong các thử nghiệm của chúng tôi (vâng, chúng tôi thử nghiệm rất nhiều!)

Nếu bạn gặp lỗi trong quá trình cập nhật cơ sở dữ liệu và phiên bản LimeSurvey của bạn ở trạng thái không sử dụng được, bạn muốn quay lại phiên bản trước. Điều này giả định rằng bạn vẫn có cơ sở dữ liệu và bản sao lưu tệp, từ bản sao lưu thông thường hoặc từ bản sao lưu thông thường của bạn. cái được tạo bởi Comfortupdate.

Vui lòng thực hiện các bước sau:

• 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.