Nâng cấp từ phiên bản trước

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:

• Sao lưu thư mục và cơ sở dữ liệu LimeSurvey hiện có (vâng, một lần nữa - chúng tôi sẽ gọi đây là bản sao lưu thứ 2)
• Khôi phục các tệp vào thư mục hiện có (chỉ cần ghi đè chúng là được) từ bản sao lưu ban đầu (thứ 1).
• Xóa cơ sở dữ liệu cũ và khôi phục cơ sở dữ liệu từ bản sao lưu gốc (thứ 1).

Đó là nó. Mọi thứ sẽ trở lại bình thường.

Lưu ý về việc báo cáo vấn đề này:

Nếu bạn gặp phải sự cố như thế này, vui lòng luôn báo cáo vấn đề này trong trình theo dõi lỗi của chúng tôi tại https://bugs.limesurvey.org

Lỗi chưa được báo cáo là lỗi chưa được sửa. Xin đừng chỉ dựa vào người khác báo cáo nó. Nếu bạn thấy lỗi đã được báo cáo, bạn cũng có thể giúp nâng mức độ ưu tiên của lỗi bằng cách đánh dấu lỗi đó là 'Có, lỗi này ảnh hưởng đến tôi' trong trình theo dõi lỗi.

Câu hỏi thường gặp

Tôi có thể nâng cấp ngay cả khi tôi có khảo sát đang hoạt động không?

Vâng, bạn có thể. Các trường hợp ngoại lệ có thể được đề cập trong hướng dẫn kỹ lưỡng ở trên. Chúng tôi đặc biệt khuyên bạn nên kiểm tra khảo sát sau khi nâng cấp để kiểm tra xem mẫu thiết kế của bạn có còn hoạt động tốt hay không.

Làm cách nào để chuyển đổi tệp cấu trúc khảo sát *.sql/*.csv sang phiên bản LimeSurvey mới nhất?

Cài đặt phiên bản 1.50, nhập tệp và xuất cấu trúc khảo sát sang định dạng .csv mới hơn. Sau đó cài đặt Phiên bản 2.x mới nhất rồi nhập định dạng .csv và xuất sang định dạng .lss hiện tại.

Survey theme incompatibility

With certain major version updates any custom survey themes will not be compatible, anymore:

• Update from LimeSurvey 2.6 or lower to LimeSurvey 2.50
• Update from LimeSurvey 5.x or lower to LimeSurvey 6.x

Error "Multiple primary key defined" when updating MySQL database

If you encounter this error, please check the setting sql_generate_invisible_primary_key in your MySQL server variables. This is most likely set to ON, but should be set to OFF. Then restore your database from the backup (as explained above) and try again.