버전 6에서 7로 업그레이드
From LimeSurvey Manual
LimeSurvey 7 메이저 버전
이 페이지는 LimeSurvey 7에서 도입된 주요 변경 사항의 개요를 제공하며 관련 문서 페이지로 연결되는 링크를 포함합니다.
LimeSurvey 7의 주요 변경 사항
응답 테이블 및 필드 이름 구조 변경
LimeSurvey 7에서는 응답 테이블과 필드 이름이 생성되는 방식의 구조를 정리했습니다. 이 변경으로 일관성이 향상되고 플랫폼을 더 쉽게 유지 관리하고 확장할 수 있습니다.
자세한 내용은 여기에서 확인하세요: 필드 이름 및 응답 테이블 리팩터링 - LimeSurvey 7
새로운 질문 편집기
LimeSurvey 7에서는 업데이트된 사용자 인터페이스와 질문을 만들고 관리하기 위한 개선된 워크플로를 갖춘 새로운 질문 편집기도 도입되었습니다.
자세한 내용은 여기에서 확인하세요: LimeSurvey 7의 새로운 질문 편집기
RemoteControl API 변경 사항
RemoteControl 2 API의 응답이 개선되어 오류 텍스트와 함께 오류 코드도 반환됩니다. 이러한 변경 사항은 RemoteControl 2 API 문서를 확인하세요. 반환 값을 처리하는 방식에 따라 하위 호환될 수 있지만, 사용 중인 구현에서는 올바르게 처리되지 않을 수도 있습니다.
자세한 내용은 여기에서 확인하세요: RemoteControl 2 API
시간대 변경 사항
버전 6 이하에서는 기록된 타임스탬프가 시간대와 관련하여 정해져 있지 않았고 서버의 날짜/시간에 따라 달라졌습니다. 버전 7로 마이그레이션하면 기존의 '시차' 설정은 가능한 경우 마이그레이션되며, 이후의 모든 타임스탬프는 UTC 타임스탬프로 기록됩니다. 기존 타임스탬프는 마이그레이션되지 않습니다. 전역 설정에서 기본 전역 시간대를 지정할 수 있으며, 사용자별로 개별 시간대를 지정할 수도 있습니다. 이 설정은 데이터 표시에만 적용됩니다. 내보내기와 RemoteControl API는 원시 타임스탬프만 수락하거나 전달합니다.
사용자 지정 설문조사 테마
LS6과 호환되는 모든 설문조사 테마는 업그레이드 후에도 활성 상태로 유지됩니다. LS6과 호환되지 않는 설문조사 테마는 제거되며, 전역 설정, 그룹 설정 및 설문조사 설정의 테마 옵션은 새 기본값으로 초기화됩니다.
업그레이드 전략:
- 기존 애플리케이션에서 설문조사 테마를 내보냅니다.
- 새 애플리케이션으로 가져오기 전에 호환성 태그가 올바르게 설정되어 있는지 확인하세요: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
- 새 애플리케이션으로 가져옵니다.
- 설문조사 테마에 대해 사용자 지정한 코드를 확인하고 사용하려는 애플리케이션의 새 버전에 맞게 업데이트합니다.
- 업데이트한 사용자 지정 설문조사 테마를 새 애플리케이션에서 내보냅니다.
- 업그레이드 후 LS6과 호환되는 설문조사 테마는 활성 상태로 유지되고, 이전 테마는 제거됩니다.
- 설문조사 테마를 업데이트하려면 이제 가져올 수 있습니다. 올바르게 업데이트되었는지 확인한 후에는 이전 테마를 삭제할 수 있습니다.
사용자 지정 관리자 테마
기본 관리자 테마가 기본적으로 활성화됩니다. 사용자 지정 테마는 그대로 유지되지만 업데이트하기 전에는 다시 활성화할 수 없습니다.
자체 호스팅 애플리케이션의 경우:
- 관리자 테마를 새 애플리케이션으로 복사하기 전에 호환성 태그가 올바르게 설정되어 있는지 확인하세요: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
- 기존 애플리케이션의 관리자 테마를 새 애플리케이션으로 복사합니다 https://manual.limesurvey.org/Custom_Admin_Themes
- 관리자 테마에 대해 사용자 지정한 코드를 확인하고 사용하려는 애플리케이션의 새 버전에 맞게 업데이트합니다.
- 기존 애플리케이션을 업그레이드하면 새 관리자 테마가 기본으로 표시됩니다. 이전에 설치한 관리자 테마를 업데이트하려면 다음 중 하나를 수행하세요.
- 현재 호환되지 않음으로 표시된 관리자 테마의 코드를 직접 업데이트합니다.
- 이전 관리자 테마를 삭제하고 테스트 환경에서 미리 업데이트해 둔 새 테마를 설치합니다.
Cloud 사용자의 경우:
지원팀에 문의해 주세요.
사용자 지정 질문 테마
현재 버전과 일치하지 않는 사용자 지정 질문 테마는 설치할 수 없지만 업그레이드 후에도 계속 활성 상태로 유지됩니다. 질문 테마에 대한 자세한 내용은 질문 테마에서 확인할 수 있습니다. 설문조사 테마나 설문조사의 질문에 삽입한 사용자 지정 JavaScript도 더 이상 작동하지 않을 가능성이 높습니다.
사용자 지정 질문 테마 업그레이드:
- 웹사이트에서 질문 테마를 다운로드하거나 현재 질문 테마를 내보냅니다.
- 업로드하기 전에 사용자 지정 질문 테마의 호환성이 올바르게 설정되어 있는지 확인하세요.
- 새 애플리케이션에 질문 테마를 업로드해 봅니다.
- 직접 만든 질문 테마인 경우 필요한 부분을 수정합니다.
- 업로드에 성공한 후 질문 테마가 표시되고 예상대로 작동하는지 확인하세요.
직접 소유하지 않은 테마 업그레이드:
테마를 제공한 웹사이트나 개발자가 업데이트를 제공하는지 확인해 보세요.
사용자 지정 플러그인
현재 버전과 일치하지 않는 사용자 지정 플러그인은 업그레이드 과정에서 비활성화됩니다.
자체 호스팅 애플리케이션의 경우:
- 플러그인을 새 버전에 설치할 수 있는지 확인합니다.
- 플러그인을 업데이트하거나 플러그인 작성자에게 업데이트를 요청합니다.
- 애플리케이션의 플러그인 파일을 새 파일로 직접 덮어쓰면 설정이 유지됩니다. 또는 이전 버전을 제거하고 새 버전을 다시 설치할 수 있으며, 이 경우 모든 설정을 다시 입력해야 합니다.
Cloud 사용자의 경우:
- LimeSAML은 활성 상태로 유지됩니다.
- 플러그인을 새 버전에 설치할 수 있는지 확인합니다.
- 플러그인 코드를 업데이트하거나 플러그인 작성자에게 업데이트를 요청합니다.
- 설치 옵션:
- 이전 버전을 제거하고 새 버전을 다시 설치합니다(모든 설정이 삭제되므로 다시 적용해야 합니다).
- 지원팀에 문의하여 구성 데이터를 잃지 않고 플러그인을 업데이트합니다.
요구 사항
| LimeSurvey 6 | LimeSurvey 7 | |
|---|---|---|
| PHP | 7.4 이상 | 8.1 이상(8.3 권장) |
| MySQL | 8.0 이상 | 8.0 이상 |
| MariaDB | 10.3.38 이상 | 10.3.38 이상 |
| PostgreSQL | 12 이상 | 14 이상 |
| MSSQL | 2016 이상 | 2019 이상 |
| URL 형식 | get 또는 path |
path, 새 편집기에 필요
|
Node.js나 npm은 필요하지 않습니다. 새 편집기는 LimeSurvey 패키지에 포함되어 있으며 바로 사용할 수 있습니다.
시작하기 전에 파일과 데이터베이스를 전체 백업하고, 먼저 설치본의 사본에서 업그레이드를 테스트하십시오. 업그레이드가 실행된 후에는 해당 백업을 복원하는 것 외에는 되돌릴 방법이 없습니다.
유지보수 시간을 계획하십시오. 데이터베이스를 업그레이드하는 동안 LimeSurvey는 사이트를 유지보수 모드로 전환하며, 답변 데이터가 많은 설치본에서는 시간이 오래 걸릴 수 있습니다.
권장: ComfortUpdate 서비스 사용
업그레이드하는 가장 쉽고 안전한 방법은 ComfortUpdate 서비스를 사용하는 것입니다. 새 버전을 자동으로 다운로드하고 설치하므로 파일을 수동으로 교체할 필요가 없습니다.
직접 업그레이드하려면 아래 단계를 따르십시오.
수동 업그레이드
- 파일과 데이터베이스를 백업하고 사이트를 유지 관리 모드로 전환합니다.
- 기존 설치본에서 다음 파일과 폴더를 보관합니다.
application/config/config.phpapplication/config/security.phpapplication/config/allowed_hosts.php- 업로드한 파일, 사용자 테마, 사용자 플러그인이 들어 있는
upload/폴더 - 플러그인을 직접 설치한 경우
plugins/폴더
- LimeSurvey 7 패키지를 다운로드하고 다음 방법 중 하나로 설치본을 업데이트합니다.
- 먼저 기존 파일을 삭제합니다. 위에 나열된 파일을 다른 곳으로 옮기고, LimeSurvey 디렉터리의 나머지 항목을 모두 삭제한 다음, 새 패키지의 압축을 해당 디렉터리에 풀고 보관해 둔 파일을 다시 넣습니다.
- 또는 새 파일을 기존 파일 위에 복사합니다. 기존 설치본 위에 새 패키지의 압축을 풀어 이미 있는 파일을 덮어쓰게 하되, 위에 나열된 파일은 그대로 둡니다.
- 어떤 방법을 선택하든 패키지에 포함된 새
.htaccess를 사용하십시오. 6.x 버전의 파일은 새 편집기에서 작동하지 않습니다. 그런 다음 버전 6의 캐시 데이터가 남지 않도록tmp/runtime/을 비우십시오. application/config/config.php에서 URL 형식을path로 설정합니다.- 웹 서버가
/editor/폴더를 직접 제공하고Authorization헤더를 PHP로 전달하는지 확인하십시오. 자세한 내용은 LimeSurvey 7의 새 질문 편집기를 참조하십시오. - 데이터베이스 업그레이드를 실행합니다. LimeSurvey가 이전 버전의 데이터베이스를 감지하여 업그레이드를 제안합니다. 확인을 선택하고 중단하지 말고 끝까지 완료되도록 기다리십시오.
- 완료되면 유지 관리 모드를 끄고 아래 체크리스트를 따라 점검하십시오.
업그레이드 후
- 관리자 페이지 바닥글에서 버전 번호를 확인합니다.
- 필요한 플러그인을 하나씩 다시 활성화합니다.
- 설문조사를 열고 새 편집기가 로드되는지 확인합니다.
- 활성화된 각 설문조사에서 조건, 할당량, 이메일, 종료 URL을 포함하여 전체 테스트 답변을 한 번씩 실행합니다.
문제 해결
URL 형식에 대한 "조치 필요" 메시지. URL 형식이 여전히 get입니다. path로 변경하고 tmp/runtime/을 비우십시오.
편집기가 로드되지만 비어 있습니다. Authorization 헤더가 PHP에 전달되지 않고 있습니다.
/editor/에 LimeSurvey 페이지 또는 "찾을수 없음" 오류가 표시됩니다. 웹 서버 구성을 확인하고 /editor/ 폴더가 LimeSurvey를 거치지 않고 직접 제공되는지 확인하십시오.
"새 질문 편집기에서는 이 테마를 사용할 수 없습니다". 설문조사가 fruity_twentythree를 기반으로 하지 않는 테마를 사용하고 있습니다. 테마를 변경하거나 기존 편집기에서 계속 작업하십시오.
플러그인을 다시 활성화한 후 오류가 발생합니다. 해당 플러그인이 LimeSurvey 7과 호환되지 않습니다. 비활성화하고 플러그인 관리자에게 문의하십시오.
참고
각 주요 변경 사항은 별도의 페이지에 문서화되어 있습니다. 이를 통해 문서의 초점을 유지하고 사용자의 환경에 맞는 정보를 더 쉽게 찾을 수 있습니다.