Planning 中设置 OCI 对象存储

要在 Planning 中为任务管理器附件设置 OCI 对象存储

  1. 转至导航器,然后单击工具下的连接

    此时将显示“管理连接”页面。

  2. 单击创建以创建连接。

    此时将显示“选择提供商以创建连接”对话框。

  3. 单击其他 Web 服务提供程序

    此时将显示“输入连接详细信息”对话框。

  4. 指定以下详细信息:
    • 连接名称:对象存储连接的名称。
    • 说明:有关连接的简要说明。
    • URL:对象存储存储桶 URL。这是 Oracle Object Storage Cloud 存储桶的 URL。
    • 用户密码:您在 Oracle Cloud Infrastructure 中为 Planning 创建的用户名和密码。

      Note:

      如果用户是在联合身份提供程序创建的,则必须将联合身份提供程序名称作为用户名的前缀。例如:oracleidentitycloudservice/username。对于密码,必须使用身份验证令牌作为密码,而不使用登录密码。
  5. 单击保存并关闭以保存对象存储连接详细信息。
  6. 转至主页 > 应用程序 > 任务管理器
  7. 单击系统设置选项卡。

    此时将显示“管理系统设置”页面。

  8. 单击对象存储,然后从连接下拉列表中,选择对象存储连接。

    系统会自动填充存储桶 URL

    URL 格式为 https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace/bucket_name,其中:
    • region_identifier 是托管 Oracle Cloud Infrastructure (OCI)
    • region.namespace 是所有存储桶和对象的顶级容器。在创建帐户时,会为每个 Oracle Cloud Infrastructure 租户分配一个唯一的对象存储名称空间名称,该名称由系统生成而且不可变。租户的名称空间名称(例如,axaxnpcrorw5)在所有区域中有效
    • bucket_name 是用于存储数据和文件的逻辑容器的名称。存储桶按区间进行组织和维护。

    示例 URL:https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/fccsAttachments

    如果在存储桶中创建了文件夹,URL 格式为 https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/bucket_name/folder_name,其中 folder_name 是包含数据的文件夹的名称。

  9. 单击验证并保存。系统将进行验证以确保连接正常工作,并创建和读取测试文件。

    此时将显示“对象存储确认”对话框。

  10. 单击继续。此时将立即启动批处理作业,以将数据库中当前存在的附件移至指定的对象存储位置。此后,所有附件将保存在对象存储位置,而不是保存在数据库中。附件存储在对象存储位置后,无法恢复为存储到数据库中。
  11. 根据您是现有客户还是首次设置 OCI 对象存储Planning 的新客户来显示统计信息:
    • 迁移的附件数量:迁移了多少个附件。

    • 迁移的附件大小 (MB):已迁移的附件的大小。

    • 待迁移的附件数量:有多少个附件仍待迁移。

    • 待迁移的附件大小 (MB):待迁移的附件的大小。

    • 所有附件的数量:系统中总共有多少个附件(包括已迁移的附件、待迁移的附件和新添加的附件)。

    • 所有附件的大小 (MB):系统中所有附件的大小

    Note:

    从测试环境迁移到生产环境后,如果未更新连接详细信息的手动步骤,则在应用程序中上传和下载附件会导致出错。下载时附件大小将为 0 字节,上传时将出现验证错误。
    • 如果您是现有客户,您会看到与将附件从 Planning 数据库迁移到 OCI 对象存储相关的统计信息。随着附件的移动,您将看到统计信息递增。

      Planning 从数据库中提取附件,并将文件移到您设置的存储桶中的 OCI 对象存储。这是基于 存储桶 URL 以及您在 Oracle Cloud Infrastructure 中为 Planning 创建的用户名和密码而执行的。附件将从数据库移到 OCI 对象存储中,然后从数据库中删除。

      首次迁移之后,上传和下载的附件都存储在 OCI 对象存储中并从其中进行检索。

    • 如果您是新的 Planning 客户,则许多统计信息将显示为零,因为您未将现有的附件移到 OCI 对象存储中。

    下面是统计信息的截图示例。

    统计信息

单击重置将重置为上一个有效的连接。

对配置问题进行故障排除

设置 OCI 对象存储时,如果看到以下错误,可能是存储桶 URL 或凭据出现问题。

Error: Unable to connect to the Object Storage service using the specified URL and credentials.(错误: 无法使用指定的 URL 和凭据连接到对象存储服务。)

使用任一 REST 客户端(例如 cURL 或 Postman)测试存储桶 URL 和凭据。

cURL 命令的格式如下:curl <bucket URL> -u "<username>:<password>"

下面是用于测试 URL 和凭据的 cURL 命令示例:

curl https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/taskAttachments -u "username:password"