PlanningにおけるOCIオブジェクト・ストレージの設定

Planningタスク・マネージャの添付用にOCIオブジェクト・ストレージを設定するには:

  1. 「ナビゲータ」に移動し、「ツール」の下で「接続」をクリックします。

    接続の管理ページが表示されます。

  2. 「作成」をクリックして接続を作成します。

    「接続を作成するためのプロバイダの選択」ダイアログ・ボックスが表示されます。

  3. 「その他のWebサービス・プロバイダ」をクリックします。

    「接続詳細の入力」ダイアログ・ボックスが表示されます。

  4. 次の詳細を指定します:
    • 接続名: オブジェクト・ストレージ接続の名前。
    • 説明: 接続に関する簡単な説明。
    • URL: オブジェクト・ストレージ・バケットのURL。これはOracle Object Storage CloudバケットのURLです。
    • ユーザーおよびパスワード: Oracle Cloud InfrastructurePlanning用に作成したユーザー名とパスワード。

      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テナントには、アカウントの作成時に、システムによって生成された一意のObject Storage名前空間名が割り当てられます。テナンシの名前空間名(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 InfrastructurePlanning用に作成したユーザー名およびパスワードに基づいて実行されます。添付はデータベースからOCIオブジェクト・ストレージに移動された後、データベースから削除されます。

      初回移行の後、添付のアップロードおよびダウンロードはOCIオブジェクト・ストレージに対して格納および取得されます。

    • Planningを初めて使用するお客様の場合、既存の添付をOCIオブジェクト・ストレージに移動していないため、表示される統計の多くはゼロと表示されます。

    統計のスクリーンショットの例を次に示します。

    統計

「リセット」をクリックすると、最後に機能した接続にリセットされます。

構成の問題のトラブルシューティング

OCIオブジェクト・ストレージの設定時に次のエラーが表示される場合は、バケットURLまたは資格証明に問題がある可能性があります:

エラー: 指定されたURLおよび資格証明を使用してオブジェクト・ストレージ・サービスに接続できません。

cURLまたはPostmanなどの任意のRESTクライアントを使用して、バケットURLおよび資格証明をテストします。

cURLコマンドの書式は次のとおりです: curl <bucket URL> -u "<username>:<password>"

次に、URLおよび資格証明をテストするcURLコマンドの例を示します:

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