使用迁移实用程序迁移应用程序

作为 Essbase 服务管理员，您可以使用迁移实用程序 (migrationTools.jar) 在一个过程中将整个 Essbase 实例（所有应用程序、用户和组以及其他 Artifact）从一个云实例迁移到另一个云。

您可以使用迁移实用程序通过市场从 OCI 上的 Essbase 部署中的源应用程序和元素进行迁移。该实用程序一次迁移多个应用程序。它还会迁移对象、规则、用户和组。

请注意， Essbase 命令行界面 (Command-Line Interface，CLI) 命令 lcmimport 和 lcmexport 不会迁移用户和组。

在使用迁移实用程序之前，请完成以下先决条件：设置 SSL 证书。

迁移实用程序用例

下面是使用迁移实用程序进行迁移的一些用例。

  • 将 Essbase 用户从源中的 WebLogic LDAP 迁移到目标中的 OCI Identity and Access Management (IAM) 或 Oracle Identity Cloud Service (IDCS)。
  • 使用迁移实用程序进行非定制的基本部署。如果您的部署包括定制项（例如定制的单点登录解决方案），请使用 CLI 而非迁移实用程序。
  • 源 Essbase 部署的来源
    • Oracle Cloud Infrastructure 上的 Essbase 市场，使用 OCI Identity and Access Management (IAM) 或 Oracle Identity Cloud Service (IDCS)，或者
    • Oracle Cloud Infrastructure 上的 Essbase 市场，使用嵌入式 LDAP
    然后，在使用下面的迁移实用程序步骤导出之前，请先创建一个新的机密应用程序，如创建机密身份应用程序中所述。此外，在使用迁移实用程序导入之前，请更改 import.properties 中的主机和 IAM 或 IDCS 详细信息，以指向目标 Essbase 实例。

使用迁移实用程序迁移云应用和用户的步骤

  1. 在使用迁移实用程序之前，如果您尚未将源 Essbase 实例打补丁到最新版本。

  2. 如果尚未安装，请从 Oracle Technology Network 下载并安装 Java SE 开发工具包 (JDK) 8。

  3. 在系统上设置 JAVA_HOME 环境变量名称，以指向 JDK 安装文件夹。如果安装路径包含任何空格，请使用引号括住变量值的路径，例如 "C:\Program Files\Java\jdk1.8.0_171"。

  4. 登录到目标 Essbase Web 界面，然后导航到控制台。

  5. 在控制台上，转至桌面工具并展开命令行工具。

  6. 单击 Migration Utility 旁边的 Download（下载）。

  7. 将 Migration Utility zip 文件下载到本地驱动器。为了获得最佳结果，请选择没有空格的路径，例如 C:\Oracle 。

  8. 提取 zip 文件，并在 migrationTools 文件夹中查看提取文件（属性、jar 和自述文件）。

  9. 在运行迁移实用程序导出之前，请编辑与实用程序位于同一目录中的 export.properties 文件。提供要从中迁移的 Essbase 源实例的详细信息。

    导出特性 说明
    userName 必需。Essbase 管理者用户名。
    口令 必需。Essbase 管理员密码。
    主机 必需。负载平衡器的 IP 地址（如果在 Essbase 部署期间配置了负载平衡器）。否则，与 Essbase 公共 IP 地址对应的主机名或 IP 地址。
    port （可选）源 Essbase 实例的 HTTP 侦听端口。如果源实例是在安全 (Secure，TLS) 模式下配置的，并且假定 isTLS= true 端口 443 。如果源实例配置有 LDAP 身份提供者，请将端口设置为 80 。
    isTLS 可选： true 或 false 。如果为 true，则使用指定的 port 值在安全 (TLS) 模式下配置源实例。
    代理 （可选）HTTP 代理主机地址（如果与源 Essbase 实例的连接需要代理）。代理主机和代理端口用冒号分隔。如果省略了代理端口，则其值为 80。省略端口的示例：www-proxy-example.com。包含端口的示例：www-proxy-example.com:80
    跳过数据 （可选）默认值为假。如果只应导出 Essbase 应用程序的方案，则设置为 true 。
    跳过用户 可选： true 或 false 。仅当不需要导出用户和/或组时才设置为 true。默认值为“假”。
    idcsHost 仅当从通过市场在 OCI 上部署的实例迁移用户和/或组时才需要。源的身份域主机位于 IAM 或 IDCS 中。从身份域 URL（例如：https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)）中，仅提取字符串后的域部分。示例：identity.oraclecloud.com
    idcsTenant 仅用于从通过市场在 OCI 上部署的实例迁移用户和/或组。源主机的身份域租户标识符，位于 IAM 或 IDCS 中。从身份域 URL（示例：https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)，仅提取 idcs-<string_of_numbers_and_letters>）。
    客户端标识 仅用于从通过市场在 OCI 上部署的实例迁移用户和/或组。在集成的机密身份应用程序中找到的 OAuth 授权的源主机的客户端标识符。
    clientSecret 仅用于从通过市场在 OCI 上部署的实例迁移用户和/或组。用于 OAuth 授权的源主机的客户端密钥，可在集成的机密身份应用程序中找到。
    appId 仅用于从通过市场在 OCI 上部署的实例迁移用户和/或组。OCI 身份域（IAM 或 IDCS ）上的集成机密身份应用程序的标识符。应将此身份应用程序配置为可授予用户和组的应用程序角色。此属性允许将角色授予已迁移的用户和组。

  10. 编辑与实用程序位于同一目录中的 import.properties 文件。提供要迁移到的 Essbase 目标实例的详细信息。

    导入酒店 说明
    userName 必需。目标实例的 Essbase 管理员用户名。
    口令 必需。目标实例的 Essbase 管理员密码。
    主机 必需。目标实例的负载平衡器的 IP 地址（如果在 Essbase 部署期间配置了负载平衡器）。否则，与 Essbase 公共 IP 地址对应的主机名或 IP 地址。
    port （可选）目标 Essbase 实例的 HTTP 侦听端口。如果在安全 (TLS) 模式下配置了目标实例，则假定 isTLS= true 端口 443 。如果源实例配置有 LDAP 身份提供者，请将端口设置为 80 。
    isTLS 可选： true 或 false 。如果为 true，则使用指定的 port 值在安全 (TLS) 模式下配置目标实例。
    userPassword （可选）要分配给实用程序迁移到 IAM 或 IDCS 中的集成身份应用程序的任何新用户的初始密码。要在迁移后更改密码，请使用 OCI 控制台。
    代理 （可选）HTTP 代理主机地址（如果与目标 Essbase 实例的连接需要代理）。代理主机和代理端口用冒号分隔。如果省略了代理端口，则其值为 80。省略端口的示例：www-proxy-example.com。包含端口的示例：www-proxy-example.com:80
    跳过用户 可选： true 或 false 。仅当不需要导入用户和/或组时才设置为 true。默认值为“假”。
    idcsHost 仅将用户和/或组迁移到通过市场在 OCI 上部署的实例时需要。目标身份域主机。从身份域 URL（例如：https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)）中，仅提取字符串后的域部分。示例：identity.oraclecloud.com
    idcsTenant 仅将用户和/或组迁移到通过市场在 OCI 上部署的实例时需要。目标主机的身份域租户标识符。从身份域 URL（示例：https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)，仅提取 idcs-<string_of_numbers_and_letters>）。
    客户端标识 仅将用户和/或组迁移到通过市场在 OCI 上部署的实例时需要。目标主机的 OAuth 授权客户端标识符，位于集成的机密身份应用程序中。
    clientSecret 仅将用户和/或组迁移到通过市场在 OCI 上部署的实例时需要。目标主机的 OAuth 授权客户端密钥，位于集成的机密身份应用程序中。
    appId 仅将用户和/或组迁移到通过市场在 OCI 上部署的实例时需要。OCI 身份域（IAM 或 IDCS）上的集成机密身份应用程序的标识符。应将此身份应用程序配置为可授予用户和组的应用程序角色。此属性允许将角色授予已迁移的用户和组。
    overwrite （可选）如果要导入的应用程序已存在于目标上并且您希望覆盖它们，则设置为 true 。默认值为“假”。
    证书 （可选）所有 TLS/SSL 服务器的所有信任证书文件的完整路径。对于 Windows，使用另一个反斜杠转义反斜杠。示例：C:\\migrationTools\\all_certs.pem

  11. 使用导出命令在 Java 中运行迁移实用程序，以将所有应用程序、用户和组从 Essbase 源实例目录导出到压缩文件。 

    java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar export export.properties <new_tar_file>

    示例：

    java –jar -Dhttps.proxyHost=www-proxy-abcdef.example.com -Dhttps.proxyPort=80 migrationTools.jar export export.properties export.tar.gz

  12. 使用 import 命令在 Java 中运行迁移实用程序，以将压缩文件导入到目标实例。

    java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar import import.properties <existing_tar_file>

  13. 运行导入后，数据将迁移到目标实例的 Essbase 目录中。