레거시 클라우드 인프라에서 Oracle Content Management 인스턴스 이전

"cec migrate-site" 명령이 새로 추가되었으므로 이전에 OCE Toolkit을 다운로드 및 설치했더라도 웹 클라이언트 git 저장소에서 툴킷을 설치해야 합니다.

Sites Toolkit 페이지의 지침에 따라 OCE Toolkit을 다운로드 및 설치합니다.

대상 서버(사이트 이전 대상이 될 서버):에 대한 접속 세부정보를 등록합니다

> cec register-server <target_server_name>
          -e http://<target_server>:<target_port>
          -u <target_username> -p <target_password>
          -t pod_ec

• <target_server_name>은 대상 끝점을 식별하기 위해 사용되며, 사용자가 선택한 모든 이름으로 지정될 수 있습니다.
• <target_server> 및 <target_port>는 대상 서버에 액세스하기 위해 사용하는 URL을 구성합니다.
• <target_username> 및 <target_password>는 소스 서버에서 사이트 템플리트를 익스포트할 사람의 사용자 이름과 비밀번호여야 합니다. 그래야 이전 중에 템플리트를 임포트할 때 권한 문제가 발생하지 않습니다.
• "pod_ec" 값은 인스턴스가 구축된 서버 유형을 식별하기 위해 사용되는 대상 서버 유형입니다.

사이트를 이전하려면 다음 단계를 수행하십시오.

1. 소스 서버에서 자산이 포함된 각 사이트에서 템플리트 생성을 수행합니다.
2. 소스 서버에서 각 템플리트 익스포트를 수행합니다. 대상 서버를 등록할 때 참조한 사용자로 이 단계를 수행해야 합니다.
3. 대상 서버에서 저장소 관리자(CECRepositoryAdministrator 롤을 가진 사용자)로 사인인합니다. 그런 다음 템플리트와 함께 임포트할 자산에 대해 저장소 생성을 수행합니다.
4. 각각 다운로드된 템플리트에 대해 다음 명령을 실행하여 <site_name>을 대상 서버에 배치할 사이트 이름으로 바꿉니다.

   > cec migrate-site <site_name> --template <template_path_and_name> 
   --destination <registered_target_server_name> --repository <repository_name>

5. 대상 서버에서 이전된 사이트 및 자산을 적절히 공유합니다.

사이트를 이전한 후 Content REST v1.1 호출을 사용하여 사이트가 실행됩니다. 이로 인해 사이트가 올바로 실행되기 전에 해결해야 하는 문제가 생길 수 있습니다. 다음을 살펴보고 수행할 작업을 결정하십시오.

• ContentSDK를 사용하는 경우 v1.1 Content REST 호출을 사용하도록 자동으로 업데이트됩니다.
• 콘텐츠 레이아웃이 v1.1을 지원하지 않으면 ContentSDK는 응답에 "data" 항목(v1.0)을 추가하여 간단히 "fields" 항목(v1.1)을 가리키도록 합니다. 그러면 템플리트가 변경 없이 계속 작동할 수 있습니다.
• 추가 질의 문자열에서 "fields.type.equals=" v1.0 Content REST 구문을 사용하는 경우 오라클이 구문분석 후 v1.1 구문으로 수정하려고 시도하겠지만 이를 검증해야 합니다.
• ContentSDK를 통하지 않고 직접 Content REST v1.0 호출을 실행하는 경우 실패합니다. 사용자정의 코드를 수정하고 해당 호출을 업그레이드해야 합니다.
• 마찬가지로 사용자정의 콘텐츠 질의에서 "fields.type.equals=" v1.0 구문을 'q=(type eq "..")' 구문으로 만들어야 합니다.
• "updateddate" 대 "updatedDate": 아마 CaaS에서 수정된 것으로 보이지만, Content REST v1.1 API가 두 값을 모두 지원하는 EC 빌드를 구할 때까지 "updateddate" 값을 camelCase: "updatedDate" 값으로 변경해야 합니다.

사이트가 올바르게 실행 중이면 MLS 호환 사이트로 설정해야 합니다. 외부 컴퓨트 서버에 엔터프라이즈 사이트를 생성하려면 기본 언어 및 지역화 정책이 필요합니다. 사이트가 상호 복사된 비MLS 사이트이므로 향후 기능을 지원할 수 있도록 MLS 사이트로 업그레이드해야 합니다.

다음 표는 MLS 사이트와 비MLS 사이트 간의 차이점을 보여줍니다.

MLS 사이트로 전환하기 전에 다음을 수행해야 합니다.

• Content REST API v1.1을 지원하도록 모든 콘텐츠 레이아웃 구성요소 업그레이드
• Content REST API v1.1과 호환되도록 사이트 콘텐츠 목록의 "추가 질의 문자열" 업그레이드

그런 다음 Content REST 호출을 실행하는 사용자정의 구성요소 코드가 있으면 이것도 v1.1 호출로 업그레이드해야 합니다. 대부분의 콘텐츠 호출은 콘텐츠 레이아웃에서 실행되므로 흔한 일은 아닙니다.

콘텐츠 레이아웃 업그레이드

지원되는 Content REST API 버전 지정

콘텐츠 레이아웃이 지원하는 Content REST API 버전을 지정해야 합니다. 이는 적절한 Content REST 호출을 실행하여 예상한 응답 데이터가 레이아웃에 반환되도록 하는 것입니다.

버전 지원을 지정하지 않으면 콘텐츠 레이아웃이 v1.0만 지원한다고 가정합니다.

콘솔은 여전히 v1.0 콘텐츠 레이아웃을 나열합니다.

콘텐츠 레이아웃이 다른 버전을 지원하도록 하려면 콘텐츠 레이아웃 객체에 "contentVersion" 속성을 추가합니다.

이 예제에서는 v1.0과 2.0 미만 사이의 모든 버전을 지원합니다. (주: 2.0은 존재하지 않지만 주 버전 변경은 호환성이 손상되는 변경을 일으킬 수 있습니다.)

// Content Layout
          definition.ContentLayout.prototype = {    // Specify the versions of
          the Content REST API that are supported by the this Content Layout.    // The value for contentVersion follows Semantic Versioning
          syntax.    // This allows applications that use the
          content layout to pass the data through in the expected format.    contentVersion: ">=1.0.0
          <2.0.0",     // Main rendering function:    // - Updates the data to handle any required additional requests and
          support both v1.0 and v1.1 Content REST APIs    // - Expand the Mustache template with the updated data
            // - Appends the expanded template HTML to the
          parentObj DOM element    render: function (parentObj)
          {

v1.1 응답 변경사항 처리

최소한 수행할 작업은 "data"에서 "fields"로 Content REST API 응답 변경을 처리하는 것입니다. 이를 위한 가장 간단한 방법은 "data" 속성을 다시 추가하여 새 "fields" 속성을 가리키는 것입니다.

render: function (parentObj)
          {    ...    if(!content.data) {        content.data =
          content.fields;    }

더 좋은 방법은 콘텐츠 레이아웃 전체에서 v1.1 "fields" 값을 사용하도록 변경하는 것입니다. 여기에는 JavaScript 및 템플리트 코드 업데이트가 포함됩니다.

v1.1을 완전히 지원하려면 v1.0과 v1.1 사이의 다음 Content REST API 변경사항을 처리해야 합니다.

"items": [{    "type": "Starter-Blog-Author",    "name": "Alex Read",    "id": "COREB62DBAB5CEDA4915A9C9F6050E554F63",    "fields":
          {        "starter-blog-author_bio": "Alex's bio",        "starter-blog-author_name": "Alex Read"        }    },

"items": [{    "type": "Starter-Blog-Author",    "name": "Alex Read",    "id": "COREB62DBAB5CEDA4915A9C9F6050E554F63",    "data":
          {        "starter-blog-author_bio": "Alex's bio",        "starter-blog-author_name": "Alex Read"        }    },

콘텐츠 질의 문자열 업그레이드

사용자정의 코드로 Content API 호출을 실행할 수 있습니다. 이때 Content REST API 호출을 실행하는 사이트에서 사용된 모든 사용자정의 코드를 검증해야 합니다.

• 사용자정의 구성요소: 다음 구성요소를 확인합니다.
  • 콘텐츠 레이아웃
  • 로컬 구성요소
  • 섹션 레이아웃
  • 원격 구성요소
• 테마: JavaScript: 가능성은 낮지만, 테마에 사용자정의 Content REST API 호출을 실행하는 JavaScript가 있을 수 있으므로 이것도 검증해야 합니다.
• 사이트 속성: 추가 질의 문자열: Content REST API 호출을 실행하는 모든 사용자정의 코드를 업그레이드했는지 검증한 후에 사이트 페이지에서 "콘텐츠 목록" 구성요소의 "추가 질의 문자열"도 업그레이드해야 합니다. 오라클이 구문분석 후 런타임에 변환하려고 시도하겠지만, 지속적 지원을 위해 호환되는 v1.1 Content REST 호출로 업그레이드해야 합니다.

비MLS 사이트를 MLS로 변환

v1.1 Content REST API를 완전히 지원하도록 사이트를 변환한 후에 MLS 사이트로 변경하여 언어 지원을 추가할 수 있습니다.

사이트 관리 UI에서 사이트를 선택하면 "번역 가능" 콘텐츠 메뉴 옵션이 표시됩니다. 이 옵션을 선택하면 지역화 정책의 필수 언어 목록에서 지역화 정책 및 사이트의 기본 언어를 선택하라는 대화상자가 표시됩니다. 지역화 정책이 없으면 이 단계를 완료할 수 없습니다. 먼저 콘텐츠 관리 화면으로 이동하여 하나 이상의 필수 언어로 지역화 정책을 생성해야 합니다.

이 단계를 완료하면 이제 사이트가 기본 로케일로 렌더링됩니다. 또한 지역화 정책에 지정된 다른 로케일로 전환할 수 있습니다.

사이트가 기본 로케일에서 예상대로 렌더링되는지 검증해야 합니다.

소스 및 대상 서버에 대한 접속 세부정보를 등록합니다.

소스 서버(자산 이전 출처가 될 서버)를 등록합니다.

> cec register-server <source_server_name>
          -e http://<source_server>:<source_port>
          -u <source_username> -p <source_password>
          -t pod_ic

• <source_server_name>은 소스 끝점을 식별하기 위해 사용되며, 사용자가 선택한 모든 이름으로 지정될 수 있습니다.
• <source_server> 및 <source_port>는 소스 서버에 액세스하기 위해 사용하는 URL을 구성합니다.
• <source_username> 및 <source_password>는 소스 서버의 자산에 액세스할 수 있는 사람의 사용자 이름과 비밀번호여야 합니다.
• "pod_ic" 값은 인스턴스가 구축된 서버 유형을 식별하기 위해 사용되는 소스 서버 유형입니다.

대상 서버(자산 이전 대상이 될 서버)를 등록합니다.

> cec-install % cec register-server <target_server_name>
          -e http://<source_server>:<source_port>
          -u <target_username> -p <target_password>
          -t pod_ec

• <target_server_name>은 대상 끝점을 식별하기 위해 사용되며, 사용자가 선택한 모든 이름으로 지정될 수 있습니다.
• <target_server> 및 <target_port>는 대상 서버에 액세스하기 위해 사용하는 URL을 구성합니다.
• <target_username> 및 <target_password>는 대상 서버의 자산을 소유할 사람의 사용자 이름과 비밀번호여야 합니다.
• "pod_ec" 값은 인스턴스가 구축된 서버 유형을 식별하기 위해 사용되는 대상 서버 유형입니다.

다음 명령을 실행하여 자산 모음을 이전합니다.

> cec migrate-content <source_collection_name> --server  <source_server_name>
      --destination <target_server_name> --repository <target_repository_name> --collection  <target_collection_name> --channel
    <target_channel_name>

대상 서버의 지정된 저장소에 자산이 생성되고 모음 및 채널과 연관됩니다. 필요한 경우 모음 및 채널이 자동으로 생성됩니다. 모든 이전된 자산의 기본 언어는 지정된 저장소에 설정된 기본 언어가 됩니다.