从旧版 Cloud Infrastructure 迁移 Oracle Content Management 实例

"cec migrate-site" 命令新命令，因此您将需要从 webclient git 资料档案库安装 OCE 工具包，即使您先前已经下载并安装了该工具包也是如此。

按照站点工具包页上的指示下载并安装 OCE 工具包。

注册目标服务器的连接详细信息（您要将站点迁移到的服务器）：

> 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. 在目标服务器上，适当地共享迁移的站点和资产。

迁移站点后，它将使用内容 REST v1.1 调用运行。这可能会导致一些问题，需要先解决这些问题，然后站点才能正确运行。查看以下内容来确定您需要执行的操作：

• 如果您使用 ContentSDK，将自动更新您的调用来使用 v1.1 内容 REST 调用。
• 如果您的内容布局未指示它们支持 v1.1，ContentSDK 还将在响应中添加 "data" 条目 (v1.0)，其将仅指向 "fields" 条目 (v1.1)，因此您的模板可以继续工作而无需更改。
• 如果您在您的其他查询字符串中使用 "fields.type.equals=" v1.0 内容 REST 语法，我们确实会对此项进行语法分析并将其修改为 v1.1 语法，但您应验证这一点。
• 如果您正在进行任何直接（而不是通过 ContentSDK）内容 REST v1.0 调用，这些调用将失败。您将需要修复您的定制代码并升级这些调用。
• 同样地，您需要使 "fields.type.equals=" v1.0 语法成为 'q=(type eq "..")' 语法的任何定制内容查询。
• "updateddate" 与 "updatedDate"：据称正在由 CaaS 进行修复，但是在我们获得其中内容 REST v1.1 API 支持这两个值的 EC 工作版本之前，您都需要将任何 "updateddate" 值更改为驼峰式大小写 "updatedDate" 值。

在使站点正常运行后，则需要使您的站点符合 MLS 要求。如果您要在外部计算服务器中创建企业站点，将需要默认语言和本地化策略。在将站点复制过来时，它是非 MLS 站点，因此您需要将其升级到 MLS 站点以确保您可以支持将来的功能。

下表显示了 MLS 与非 MLS 站点之间的区别。

在可将站点转变为 MLS 站点之前，需要执行以下操作：

• 升级所有内容布局组件以支持内容 REST API v1.1
• 将站点中内容列表中的任何“其他查询字符串”升级为与内容 REST API v1.1 兼容

然后，如果您碰巧有进行内容 REST 调用的任何定制组件代码，您还需要升级这些代码以进行 v1.1 调用。这是不常见的，因为大多数内容调用都是从内容布局进行。

升级内容布局

指定支持的内容 REST API 版本

内容布局需要指定它们支持的内容 REST API 版本。这是为了确保进行适当的内容 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" 的内容 REST API 响应更改。执行此操作的最简单方式是将 "data" 属性添加回去并指向新的 "fields" 属性

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

更好的选项是改为在整个内容布局中使用 v1.1 "fields" 值。这将涉及更新 JavaScript 和模板代码。

要完全支持 v1.1，将需要处理 v1.0 和 v1.1 之间的以下内容 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"        }    },

升级内容查询字符串

您可能正在任何定制代码中进行内容 API 调用，因此您需要验证正在进行内容 REST API 调用的站点使用的所有定制代码。

• 定制组件：检查以下组件：
  • 内容布局
  • 本地组件
  • 部分布局
  • 远程组件
• 主题：JavaScript：尽管可能性较小，但是您可能在主题中具有正在进行定制内容 REST API 调用的 JavaScript，因此还应对其进行验证。
• 站点属性：其他查询字符串：您验证了您已升级进行内容 REST API 调用的所有定制代码后，还应该升级站点中任何页上的任何“内容列表”组件中的“其他查询字符串”。虽然我们确实尝试在运行时分析和转换这些项，但它们应该升级为兼容的 v1.1 内容 REST 调用以得到继续支持。

将非 MLS 站点转换为 MLS

将站点转换为完全支持 v1.1 内容 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>

将在指定资料档案库中的目标服务器上创建资产，并将其与集合和通道关联。如果需要，将自动创建集合和通道。所有已迁移资产的默认语言将是在指定资料档案库中设置的默认语言。