OSGi에서 AEM 6.5 Forms으로 업그레이드 upgrade-to-aem-forms-osgi

AEM 6.3 Forms 또는 AEM 6.4 Forms에서 AEM 6.5 Forms으로 직접 업그레이드할 수 있습니다.

AEM 6.0 Forms, AEM 6.1 FormsAEM 6.2 Forms ​에서 AEM 6.5 Forms으로의 직접 업그레이드 경로를 사용할 수 없습니다. AEM 6.2 Forms으로 업그레이드, AEM 6.3 Forms으로 업그레이드 또는 AEM 6.4 Forms으로 업그레이드한 다음 AEM 6.3 Forms 또는 AEM 6.4 Forms에서 AEM 6.5 Forms으로 업그레이드합니다.

AEM 6.3 Forms 또는 AEM 6.4 Forms에서 AEM 6.5 Forms으로 업그레이드하려면 다음을 수행하십시오.

  1. 기존 AEM 인스턴스를 AEM 6.5로 업그레이드합니다. 다음 단계가 나와 있습니다.

    1. AEM 6.3 Forms 또는 AEM 6.4 Forms용 최신 서비스 팩 및 패치를 설치합니다. 자세한 내용은 AEM Sustainance Hub를 참조하십시오.

    2. 업그레이드할 소스 인스턴스를 준비합니다. 자세한 단계는 AEM 6.5로 업그레이드를 참조하십시오.

    3. AEM 6.5 빠른 시작을 다운로드합니다.

    4. (Unix/Linux 기반 설치만 해당) 기본 운영 체제로 UNIX 또는 Linux를 사용하는 경우 터미널 창을 열고 crx-quickstart가 포함된 폴더로 이동한 다음 다음 명령을 실행합니다.

      chmod -R 755 ../crx-quickstart

    5. AEM 인스턴스를 AEM 6.3으로 업그레이드합니다. 단계별 지침은 AEM 6.5로 업그레이드를 참조하십시오.

      다음 단계를 계속하기 전에 ServiceEvent REGISTERED 및 ServiceEvent UNREGISTERED 메시지가 <crx-repository>/error.log 파일에 표시되지 않을 때까지 기다립니다.

      note note
      NOTE
      서버가 실행 중이면 몇 가지 AEM Forms 번들이 설치 상태로 유지됩니다. 번들 수는 설치할 때마다 달라질 수 있습니다. 이러한 번들의 상태를 무시해도 됩니다. 번들은 https://'[server]:[port]'/system/console/에 나열됩니다.
  2. AEM Forms 추가 기능 패키지를 설치합니다. 다음 단계가 나와 있습니다.

    1. 소프트웨어 배포를 엽니다. 소프트웨어 배포에 로그인하려면 Adobe ID가 필요합니다.

    2. 헤더 메뉴에서 사용할 수 있는 Adobe Experience Manager ​을(를) 선택합니다.

    3. 필터 섹션에서:

      1. 솔루션 드롭다운 목록에서 Forms ​을(를) 선택합니다.
      2. 패키지의 버전 및 유형을 선택합니다. 다운로드 검색 옵션을 사용하여 결과를 필터링할 수도 있습니다.
    4. 운영 체제에 적용할 수 있는 패키지 이름을 선택하고 EULA 약관 동의 ​를 선택한 다음 다운로드 ​를 선택합니다.

    5. 패키지 관리자를 열고 패키지 업로드 ​를 클릭하여 패키지를 업로드합니다.

    6. 패키지를 선택하고 설치 ​를 클릭합니다.

      AEM Forms 릴리스 문서에 나열된 직접 링크를 사용하여 패키지를 다운로드할 수도 있습니다.

      note note
      NOTE
      패키지를 설치한 후 AEM 인스턴스를 다시 시작하라는 메시지가 표시됩니다. 서버를 즉시 중지하지 마십시오. AEM Forms 서버를 중지하기 전에 ServiceEvent REGISTERED 및 ServiceEvent UNREGISTERED 메시지가 <crx-repository>/error.log 파일에 나타나고 로그가 안정될 때까지 기다립니다. 또한 몇 가지 패키지는 설치된 상태로 유지될 수 있습니다. 이러한 패키지의 상태를 무시해도 됩니다.
  3. AEM 인스턴스를 다시 시작합니다.

    note note
    NOTE
    SDK를 다시 시작하려면 'Ctrl + C' 명령을 사용하는 것이 좋습니다. Java 프로세스 중지와 같은 대체 방법을 사용하여 AEM SDK를 다시 시작하면 AEM 개발 환경이 일치하지 않을 수 있습니다.
  4. 설치 후 작업을 수행합니다.

    • 마이그레이션 유틸리티 실행

      마이그레이션 유틸리티를 사용하면 이전 버전의 적응형 양식 및 서신 관리 에셋이 AEM 6.5 양식과 호환될 수 있습니다. AEM Software Distribution에서 유틸리티를 다운로드할 수 있습니다. 마이그레이션 유틸리티를 구성하고 사용하는 방법에 대한 단계별 정보는 마이그레이션 유틸리티를 참조하십시오.

      초안 및 제출 구성 요소 통합에 샘플 을 사용하고 있으며 이전 버전에서 업그레이드하는 경우 업그레이드를 수행한 후 다음 SQL 쿼리를 실행하십시오.

      code language-sql
      UPDATE metadata m, additionalmetadatatable am
      SET m.dataType = am.value
      WHERE m.id = am.id
      AND am.key = 'dataType'
      
      code language-sql
      DELETE from additionalmetadatatable
      WHERE `key` = 'dataType'
      
    • (AEM 6.2 Forms 또는 이전 버전에서만 업그레이드하는 경우) Adobe Sign 다시 구성

      이전 버전의 AEM Forms에서 Adobe Sign을 구성한 경우 AEM Cloud 서비스에서 Adobe Sign을 다시 구성합니다. 자세한 내용은 Adobe Sign과 AEM Forms 통합을 참조하십시오.

    • jQuery 지원

      AEM 6.5 Forms에서 jQuery의 버전은 3.2.1로 업데이트되고 jQuery UI 버전은 1.12.1로 업데이트됩니다. AEM Form은 noConflict 모드에서 JQuery를 사용합니다. 따라서 다른 jQuery 버전을 사용하는 경우 업그레이드를 수행하는 동안 문제가 표시되지 않습니다. 그러나 AEM 6.5 Forms으로 업그레이드하는 경우:

      • 사용자 지정 구성 요소(있는 경우)가 지원되는 jQuery 버전과 호환되는지 확인합니다.
      • 사용자 지정 구성 요소에서 지원되지 않는 API를 제거합니다. 제거된 API 목록은 업그레이드 안내서를 참조하십시오. 예를 들어 load(), .unload() 및 .error() API에 대한 지원이 제거됩니다. 앞서 설명한 API 대신 .on() 메서드를 사용합니다. 예를 들어 $("img").load(fn)를 $("img").on("load", fn)으로 변경합니다.
    • (AEM 6.2 Forms 또는 이전 버전에서만 업그레이드하는 경우) 분석 및 보고서를 다시 구성하십시오

      AEM 6.4 Forms에서는 노출에 대한 소스 및 성공 이벤트에 대한 트래픽 변수를 사용할 수 없습니다. 따라서 AEM 6.2 Forms 또는 이전 버전에서 업그레이드하는 경우 AEM Forms은 Adobe Analytics 서버로 데이터 전송을 중단하고 적응형 양식에 대한 분석 보고서를 사용할 수 없습니다. 또한, AEM 6.4 Forms에서는 필드에서 보낸 시간에 대한 양식 분석 버전 트래픽 변수 및 성공 이벤트를 도입했습니다. 따라서 AEM Forms 환경에 대한 분석 및 보고서를 다시 구성합니다. 자세한 단계는 분석 및 보고서 구성을 참조하십시오.

  5. 서버가 성공적으로 업그레이드되었는지, 모든 데이터도 성공적으로 마이그레이션되었는지, 정상적으로 작동할 수 있는지 확인하십시오.

    • 번들 상태를 확인합니다. 모든 번들이 활성 상태인지 확인합니다.

    • 복제 및 역방향 복제 확인: Publish, 마이그레이션된 양식 몇 가지를 입력하고 제출하십시오. 제출된 데이터도 확인합니다.

    • 관리자 및 개발자 사용자 인터페이스에 대한 액세스 권한을 확인합니다. 관리자 계정에서 AEM 인스턴스에 로그인하고 다음 URL에 대한 액세스 권한이 있는지 확인합니다.

      • https://'[server]:[port]'/crx/packmgr
      • https://'[server]:[port]'/crx/de
      • https://'[server]:[port]'/aem/forms.html/content/dam/formsanddocuments
    note note
    NOTE
    AEM 6.4 Forms에서 crx-repository 구조가 변경되었습니다. 6.3 Forms에서 AEM 6.5 Forms으로 업그레이드하는 경우 새로 만드는 사용자 지정에 변경된 경로를 사용합니다. 변경된 경로의 전체 목록은 AEM의 Forms 저장소 재구성을 참조하십시오.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2