Oracle® Enterprise Manager

Cloud管理ガイド

12c リリース5 (12.1.0.5)

B70509-13(原本部品番号:E28814-19)

2015年12月

Oracle Enterprise Manager Cloud管理ガイド 12c リリース5 (12.1.0.5)

B70509-13

Copyright © 2011, 2015, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに含まれる情報は予告なしに変更される場合があります。また、誤りが無いことの保証は致し兼ねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT RIGHTS. Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.  As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleとJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。お客様との間に適切な契約が定められている場合を除いて、オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- サポートされているプラグイン

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 このガイドの最新情報

第I部 クラウド管理の概要

2 クラウド管理 - 概要

- 2.1 クラウド管理の概要

- 2.2 Enterprise Managerによるクラウド管理ライフサイクルの管理

- 2.2.1 計画

- 2.2.2 クラウドの設定

- 2.2.3 クラウドの構築

- 2.2.4 サービスのテストおよびデプロイ

- 2.2.5 クラウドの監視および管理

- 2.2.6 メータリングとチャージ、最適化

- 2.3 Oracle Cloudサービス・モデルの概要

- 2.3.1 Oracle Cloudサービス・モデル

- 2.3.2 Oracle Cloudの構造

- 2.3.3 IaaSコンポーネント

- 2.3.4 DBaaSおよびMWaaSコンポーネント

- 2.3.5 TaaSコンポーネント

- 2.4 Oracle Cloud機能へのアクセス

- 2.4.1 Enterprise Manager Cloud Controlのコンソール

- 2.4.2 セルフ・サービス・ポータル

第II部 クラウドの設定および有効化

3 クラウド管理インフラストラクチャの設定

- 3.1 自己更新の設定

- 3.1.1 Enterprise Manager自己更新モードの設定

- 3.1.2 ユーザーへの自己更新権限の割当て

- 3.1.3 EM CLIユーティリティの設定(オプション)

- 3.2 必要なプラグインのデプロイ

- 3.3 ロールの定義およびユーザーの割当て

- 3.3.1 セルフ・サービス・アプリケーション管理者およびユーザーのカスタム・ロールの作成

- 3.3.1.1 EM_SSA_ADMINISTRATORロールに基づくカスタム・ロールの作成

- 3.3.1.2 EM_SSA_USERロールに基づくカスタム・ロールの作成

- 3.3.1.3 EM_SSA_USER_BASEロールに基づくカスタム・ロールの作成

- 3.3.2 ユーザーの作成およびロールの割当て

- 3.3.3 スナップ・クローンのストレージ・サーバーを管理するためのロールおよび権限の付与

- 3.3.3.1 一般的な権限の付与

- 3.3.3.2 ターゲット権限の付与

- 3.3.3.3 ロールの付与

- 3.3.3.4 プロビジョニング用の権限の付与

- 3.4 LDAP認証の構成

- 3.5 権限委任設定の構成

- 3.6 セルフ・サービス・ログイン・ページのカスタマイズ

- 3.6.1 セルフ・サービス・ログイン・ページの構成

- 3.6.2 Enterprise Managerのログイン・ページへの切替え

- 3.6.3 特定のOMSプールへのSSAリクエストのルーティング

4 クラウドの有効化の方法

- 4.1 Enterprise Managerのクラウド・デプロイメント・モデル

- 4.2 Infrastructure as a Service (IaaS)の有効化

- 4.2.1 Infrastructure as a Service (IaaS): スーパー管理者のタスク

- 4.2.2 Infrastructure as a Service (IaaS): クラウド管理者のタスク

- 4.2.3 Infrastructure as a Service (IaaS): セルフ・サービス管理者のタスク

- 4.2.4 Infrastructure as a Service (IaaS): セルフ・サービス・ユーザーのタスク

- 4.3 Platform as a Service (PaaS)の有効化

- 4.3.1 Platform as a Service (PaaS): スーパー管理者のタスク

- 4.3.2 Platform as a Service (PaaS): クラウド管理者のタスク

- 4.3.3 Platform as a Service (PaaS): ストレージ管理者のタスク

- 4.3.4 Platform as a Service (PaaS): セルフ・サービス管理者のタスク

- 4.4 Database as a Serviceの有効化

- 4.4.1 データベース・アーティファクトのプロビジョニング

- 4.4.1.1 データベース・テンプレートを使用したデータベースの作成

- 4.4.1.2 スキーマの作成

- 4.4.1.3 プラガブル・データベースのプロビジョニング

- 4.4.2 データベースのクローニング

- 4.4.2.1 フル・クローンの作成

- 4.4.2.1.1 RMANバックアップを使用したフル・データベース・クローンの作成

- 4.4.2.1.2 RMAN複製を使用したフル・データベース・クローンの作成

- 4.4.2.2 スナップ・クローンの作成

- 4.4.2.2.1 クローニング・ダッシュボードからのスナップ・クローンの作成

- 4.4.2.2.2 同期テスト・マスターからのスナップ・クローンの作成

- 4.4.2.2.3 個別に同期されたテスト・マスターからのスナップ・クローンの作成

- 4.4.2.2.4 テスト・マスターとデータベース・インスタンスの進行中リフレッシュ

- 4.4.2.2.5 CloneDBデータベースの作成

- 4.4.2.3 プラガブル・データベースのスナップ・クローンの作成

- 4.5 Middleware as a Service (MWaaS)の有効化

- 4.5.1 Middleware as a Service (MWaaS): クラウド管理者のタスク

- 4.5.2 Middleware as a Service (MWaaS): セルフ・サービス管理者のタスク

- 4.5.3 Middleware as a Service (MWaaS): セルフ・サービス・ユーザーのタスク

- 4.6 Testing as a Service (TaaS)の有効化

- 4.6.1 Testing as a Service (TaaS): クラウド管理者のタスク

- 4.6.2 Testing as a Service (TaaS): セルフ・サービス管理者のタスク

- 4.6.3 Testing as a Service (TaaS): セルフ・サービス・ユーザーのタスク

第III部 Infrastructure as a Serviceの設定および使用

5 IaaS用のクラウドの設定

- 5.1 開始

- 5.2 クラウド・インフラストラクチャの権限

- 5.3 Oracle VM Managerの登録

- 5.3.1 Oracle VM Managerを設定するためのポート要件

- 5.3.2 Oracle VM Manager URLの更新

- 5.3.3 Oracle VM Manager WebLogic証明書のインポート

- 5.3.4 Oracle VM Managerの検出および昇格(オプション)

- 5.3.5 構成の監視(OVM Manager)

- 5.3.6 Oracle VM Managerのアップグレード

- 5.4 Oracle VM Managerターゲットの同期

- 5.4.1 自動同期

- 5.4.2 手動同期

- 5.5 仮想サーバーの検出

- 5.6 仮想サーバーの再検出

- 5.7 ネットワークの設定

- 5.7.1 MACアドレスの生成

- 5.7.2 Oracle VM Manager 3.2以前のバージョンに対するVLANグループの構成

- 5.7.3 Oracle VM Manager 3.3用のVLANインタフェースの作成

- 5.7.3.1 VLANインタフェースの表示

- 5.7.3.2 VLANインタフェースの編集

- 5.7.3.3 VLANインタフェースの削除

- 5.7.4 ネットワークの作成

- 5.8 ネットワーク・プロファイルの作成

- 5.9 ストレージ・サーバーの登録

- 5.9.1 ファイル・サーバーの登録

- 5.9.2 ストレージ・アレイの登録

- 5.9.3 ファイル・サーバーの詳細

- 5.9.4 ストレージ・アレイの詳細

- 5.9.5 ローカル・ファイル・サーバーの詳細

- 5.10 記憶域リポジトリの作成

- 5.10.1 記憶域リポジトリでの管理操作の実行

- 5.11 記憶域リポジトリの提示

- 5.12 記憶域リポジトリへのアセンブリ、テンプレートおよび仮想ディスクのインポート

- 5.12.1 リポジトリのエクスポートの作成(オプション)

- 5.13 自己更新を使用したOracle VM TemplatesおよびVirtual Assembliesのダウンロード

- 5.14 仮想サーバー・プールの作成

- 5.14.1 仮想サーバー・プールの編集

- 5.15 ゾーンの作成

- 5.16 ストレージのサービスのクオリティ(QoS)の設定

- 5.16.1 ネットワーク・タイプの設定

- 5.16.2 マシン・サイズの設定

- 5.16.3 ソフトウェア・ライブラリ・ユーザーの構成

- 5.16.4 外部管理エージェントを使用したソフトウェア・ライブラリ・ユーザーの構成

- 5.16.5 リクエスト・パージ・ポリシーの定義

- 5.17 Oracle VM Serverへのパッチ適用

- 5.17.1 YUMリポジトリの構成

- 5.17.2 仮想サーバーのアップグレード

- 5.18 OVMイベントの確認

- 5.19 NTP構成の管理

- 5.20 仮想マシンのインポート

- 5.21 リポジトリ・イベントの確認

6 クラウド・ポリシーの定義および管理

- 6.1 クラウド・ポリシーの管理

- 6.2 クラウド・ポリシーの表示

- 6.3 ターゲットのポリシーの表示

- 6.4 パフォーマンス・ポリシーの定義

- 6.5 スケジュール・ベース・ポリシーの定義

- 6.6 ポリシーのアクティブ化および非アクティブ化

- 6.7 ポリシー・グループの表示

- 6.8 ポリシー・グループの作成

- 6.8.1 例1

- 6.8.1.1 ゲスト仮想マシン停止ポリシー

- 6.8.1.2 ゲスト仮想マシン起動ポリシー

- 6.8.1.3 ポリシー・グループの作成(起動および停止)

- 6.8.2 例2

- 6.8.2.1 層インスタンス・スケール・ダウン・ポリシー

- 6.8.2.2 層インスタンス・スケール・アップ・ポリシー

- 6.8.2.3 ポリシー・グループの作成(スケール・アップおよびスケール・ダウン)

- 6.9 DRSおよびDPMポリシー

- 6.9.1 自動DRSまたはDPMポリシーの作成

7 IaaSセルフ・サービス・ポータルの設定

- 7.1 セルフ・サービス・ポータルの設定

- 7.2 大きなサイズのファイルのセルフ・サービス・ポータルへのアップロード

- 7.2.1 emctlを使用したOMSプロパティの設定

- 7.2.2 web.xml構成ファイルの変更

8 IaaSセルフ・サービス・ポータルの使用

- 8.1 セルフ・サービス・ポータルを使用したサーバー・リソースのリクエスト

- 8.2 サーバーのリクエスト

- 8.3 リクエストの表示

- 8.4 サーバーの表示

- 8.4.1 ゾーンの詳細ページ

- 8.4.2 アセンブリの操作

- 8.4.2.1 アセンブリの詳細ページ

- 8.4.3 層の操作

- 8.4.3.1 層インスタンスのスケール・アップ

- 8.4.3.2 層インスタンスのスケール・ダウン

- 8.4.3.3 層の詳細ページ

- 8.4.4 サーバーの操作

- 8.4.4.1 サーバー構成の変更

- 8.4.4.2 サーバーのクローニング

- 8.4.4.3 サーバーの詳細ページ

- 8.5 記憶域の表示

- 8.6 チャージバックの詳細の表示

- 8.7 ライブラリの表示

- 8.8 ポリシーの表示

- 8.9 プリファレンスの表示

9 IaaSクラウドの管理および監視

- 9.1 インフラストラクチャ・クラウドのホームページの表示

- 9.2 OVMマネージャ・ホームページの表示

- 9.3 メンバーの表示および管理

- 9.4 ゾーンの管理

- 9.4.1 ゾーンのホームページの表示

- 9.4.2 ゾーンの作成または編集

- 9.4.3 ゾーンの削除

- 9.4.4 Enterprise Managerからのゾーンの削除

- 9.5 仮想サーバー・プール・ホームページの表示

- 9.6 仮想サーバーの管理

- 9.6.1 仮想サーバー・ホームページ

- 9.6.2 仮想サーバーの編集

- 9.6.3 仮想サーバーのアップグレード

- 9.6.4 仮想サーバーの起動および停止

- 9.6.5 仮想サーバーに対するメンテナンスの実行

- 9.7 ゲスト仮想マシンの管理

- 9.7.1 ゲスト仮想マシンの作成

- 9.7.2 ゲスト仮想マシン・ホームページ

- 9.7.3 ゲスト仮想マシンの移行

- 9.7.4 ゲスト仮想マシンの起動および停止

- 9.7.4.1 ゲスト仮想マシンの起動

- 9.7.4.2 ゲスト仮想マシンの再起動

- 9.7.4.3 ゲスト仮想マシンの停止

- 9.7.4.4 ゲスト仮想マシンの強制終了

- 9.7.5 ゲスト仮想マシンのクローニング

- 9.7.6 ゲスト仮想マシンの編集

- 9.7.7 テンプレートとしてのゲスト仮想マシンの保存

- 9.7.8 ゲスト仮想マシンの削除

- 9.7.9 Enterprise Managerからのみのゲスト仮想マシンの削除

- 9.8 ゲスト仮想マシンのデプロイ

- 9.8.1 開始

- 9.8.2 デプロイメント・オプション

- 9.8.3 前提条件

- 9.8.3.1 ソフトウェア・ライブラリ内の仮想化コンポーネントの作成および格納

- 9.8.3.1.1 アセンブリ・コンポーネントの作成

- 9.8.3.1.2 テンプレート・コンポーネントの作成

- 9.8.3.1.3 ISOコンポーネントの作成

- 9.8.3.1.4 仮想ディスクの作成

- 9.8.4 Oracle Virtual Assemblies (OVA)を使用したゲスト仮想マシンのプロビジョニング

- 9.8.5 Oracle VMテンプレートを使用したゲスト仮想マシンのプロビジョニング

- 9.8.6 ISOイメージを使用したゲスト仮想マシンのプロビジョニング

- 9.8.7 PXEブート可能なゲスト仮想マシンの作成

- 9.9 インフラストラクチャ・リクエスト・ダッシュボードの表示

- 9.9.1 リクエスト詳細の表示

- 9.9.2 アセンブリ・ページまたは層インスタンス・ページの表示

第IV部 直接監視

10 Xenベース・システムの直接監視

- 10.1 直接監視の概要

- 10.2 ハイパーバイザ・ターゲットの検出

- 10.2.1 ターゲットの削除

- 10.2.2 資格証明プロパティの設定

- 10.3 「Oracle Server」ホームページの表示

- 10.4 「Oracle Virtual Platform」ホームページの表示

- 10.5 Oracle VMインスタンス・ホームページの表示

第V部 Platform as a Serviceの設定および使用

11 PaaSインフラストラクチャの設定

- 11.1 サービス・ファミリについて

- 11.2 共通設定タスク

- 11.2.1 ホストの追加

- 11.2.2 リソース・プロバイダの作成

- 11.2.2.1 PaaSインフラストラクチャ・ゾーンの作成

- 11.2.2.1.1 PaaSインフラストラクチャ・ゾーンの編集

- 11.2.2.1.2 PaaSインフラストラクチャ・ゾーンの削除

- 11.2.2.2 PaaSプールの作成

- 11.2.2.2.1 データベース・プールの作成

- 11.2.2.2.2 ミドルウェア・プールの作成

- 11.2.3 リクエスト設定の構成

- 11.2.4 割当て制限の設定

12 DBaaSクラウドの有効化

- 12.1 開始

- 12.2 プロビジョニング用の資格証明の設定

- 12.3 Database as a Serviceのデータベース・ソフトウェアのプロビジョニング

- 12.4 Schema as a Serviceのデータベースのプロビジョニング

- 12.5 PDB as a Serviceのコンテナ・データベースのプロビジョニング

- 12.6 Oracleリスナーの構成

- 12.7 ストレージ・サーバーの登録および管理

- 12.7.1 ストレージ・サーバーの登録の概要

- 12.7.2 開始する前に

- 12.7.3 ストレージ・サーバーの登録の前提条件

- 12.7.3.1 ストレージ・サーバーの構成

- 12.7.3.2 ストレージ・プロキシ・エージェントのカスタマイズ

- 12.7.4 ストレージ・サーバーの登録

- 12.7.4.1 NetAppまたはSun ZFSストレージ・サーバーの登録

- 12.7.4.2 Solaris File System (ZFS)ストレージ・サーバーの登録

- 12.7.4.3 EMCストレージ・サーバーの登録

- 12.7.5 ストレージ・サーバーの管理

- 12.7.5.1 ストレージ・サーバーの同期

- 12.7.5.2 ストレージ・サーバーの登録解除

- 12.7.6 ストレージ・サーバーの管理

- 12.7.6.1 ストレージ割当ての管理

- 12.7.6.2 ストレージのアクセス権限の管理

- 12.7.6.3 ストレージ登録の概要と階層の表示

- 12.7.6.4 ストレージ・サーバーの編集

13 MWaaSクラウドの設定

- 13.1 Middleware as a Serviceについて

- 13.2 このリリースの新しい機能と強化

- 13.3 Middleware as a Serviceの開始

- 13.3.1 プロビジョニング・プロファイルの作成

- 13.3.1.1 WebLogicドメインのプロビジョニング・プロファイルの作成

- 13.3.2 ミドルウェア・ホームのプロビジョニング

- 13.3.2.1 Oracleミドルウェア・ホームのゴールド・イメージからのプロビジョニング・デプロイメント・プロシージャ

第VI部 新規データベース・アーティファクトのプロビジョニング

14 Database as a Serviceの開始

- 14.1 サポートされているDBaaSユースケース

- 14.2 DBaaSの開始

15 データベース・テンプレートを使用したデータベースの作成

- 15.1 データベース・テンプレートを使用したデータベースの作成

- 15.1.1 リソース・プロバイダの作成

- 15.1.1.1 Database as a Service用のデータベース・プールの作成

- 15.1.2 データベース・テンプレートを使用したデータベース・プロビジョニング・プロファイルの作成

- 15.1.3 リクエスト設定の構成

- 15.1.4 割当て制限の定義

- 15.1.5 データベース・テンプレート・プロファイルを使用したサービス・テンプレートの作成

- 15.1.6 チャージバックの構成

- 15.1.7 データベースのリクエスト

- 15.2 スタンバイ・データベースのプロビジョニング

- 15.2.1 スタンバイ・データベースをプロビジョニングするためのデータベース・プールの定義

- 15.2.1.1 スタンバイ・データベース・プールのプライマリ・データベース・プールへの関連付け

- 15.2.2 サービス・テンプレートの作成

16 スキーマの作成

- 16.1 開始

- 16.2 リソース・プロバイダの作成

- 16.2.1 Schema as a Service用のデータベース・プールの作成

- 16.3 エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成

- 16.4 リクエスト設定の構成

- 16.5 割当て制限の定義

- 16.6 プロファイルに基づくスキーマのサービス・テンプレートの作成

- 16.7 空のスキーマでのサービス・テンプレートの作成

- 16.8 チャージバックの構成

- 16.9 スキーマのリクエスト

17 プラガブル・データベースのプロビジョニング

- 17.1 開始

- 17.2 リソース・プロバイダの作成

- 17.2.1 PDB as a Service用のデータベース・プールの作成

- 17.3 エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成

- 17.4 リクエスト設定の構成

- 17.5 割当て制限の定義

- 17.6 プロファイルに基づくPDBのサービス・テンプレートの作成

- 17.7 空のPDBのサービス・テンプレートの作成

- 17.8 チャージバックの構成

- 17.9 プラガブル・データベースのリクエスト

第VII部 データベースのクローニング

18 サポートされるクローニング・オプション

- 18.1 データ・ライフサイクル管理について

- 18.2 サポートされるクローニング・オプション

19 フル・クローンの作成

- 19.1 RMANバックアップを使用したセルフ・サービス・ポータルからのフル・データベース・クローンの作成

- 19.1.1 リソース・プロバイダの作成

- 19.1.1.1 Database as a Service用のデータベース・プールの作成

- 19.1.2 データベース・プロビジョニング・プロファイルの作成

- 19.1.2.1 RMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成

- 19.1.2.2 既存のRMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成

- 19.1.3 リクエスト設定の構成

- 19.1.4 割当て制限の定義

- 19.1.5 RMANバックアップ・プロファイルを使用したサービス・テンプレートの作成

- 19.1.6 チャージバックの構成

- 19.1.7 データベースのリクエスト

- 19.2 RMAN複製を使用したセルフ・サービス・ポータルからのフル・データベース・クローンの作成

- 19.2.1 RMAN複製を使用したサービス・テンプレートの作成

20 データベースのスナップ・クローンの作成

- 20.1 スナップ・クローンについて

- 20.2 データベースのクローニングおよびリフレッシュ

- 20.3 クローニング・ダッシュボードからのスナップ・クローンの作成

- 20.3.1 スナップ・クローン・データベースの作成

- 20.3.2 Exadataテスト・マスター・データベースの作成

- 20.3.3 Exadataテスト・マスター・データベースのスナップショット・クローンの作成

- 20.3.4 テスト・マスター・データベースの有効化

- 20.3.5 テスト・マスター・データベースの無効化

- 20.3.6 CloneDBデータベースの作成

- 20.3.7 クローン・データベースの管理

- 20.3.8 クローン・データベースのリフレッシュ

- 20.4 同期テスト・マスターからのスナップ・クローンの作成

- 20.4.1 はじめに

- 20.4.2 ストレージ・サーバーの登録

- 20.4.3 リソース・プロバイダの作成

- 20.4.3.1 Database as a Service用のデータベース・プールの作成

- 20.4.4 リクエスト設定の構成

- 20.4.5 割当て制限の定義

- 20.4.6 テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用

- 20.4.7 スナップ・クローンのテスト・マスターの有効化

- 20.4.8 スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成

- 20.4.8.1 テスト・マスターのスナップショットの作成およびリフレッシュ

- 20.4.8.1.1

- 20.4.9 スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成

- 20.4.10 チャージバックの構成

- 20.4.11 データベースのリクエスト

- 20.4.12 例: 同期テスト・マスターからのスナップ・クローンの作成

- 20.4.13 EMCスナップ・クローンのサービス・テンプレートの作成

- 20.5 個別に同期されたテスト・マスターからのスナップ・クローンの作成

- 20.5.1 開始

- 20.5.2 ストレージ・サーバーの登録

- 20.5.3 リソース・プロバイダの作成

- 20.5.4 リクエスト設定の構成

- 20.5.5 割当て制限の定義

- 20.5.6 個別に同期されたテスト・マスターの作成

- 20.5.7 スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成

- 20.5.8 チャージバックの構成

- 20.5.9 データベースのリクエスト

- 20.5.10 テスト・マスター・データベースのリフレッシュ

- 20.5.11 スナップショット・プロファイルのリフレッシュ

- 20.5.12 例: 個別に同期されたテスト・マスターからのスナップ・クローンの作成

- 20.6 CloneDBデータベースの作成

- 20.6.1 RMANデータベース・イメージを使用したデータベース・プロビジョニング・プロファイルの作成

- 20.6.2 RMANイメージ・プロファイルを使用したサービス・テンプレートの作成

21 プラガブル・データベースのスナップ・クローンの作成

- 21.1 テスト・マスター・プラガブル・データベースの作成

- 21.1.1 テスト・マスター・プラガブル・データベースの作成

- 21.1.2 Exadataテスト・マスター・プラガブル・データベースの作成

- 21.1.3 ACFSテスト・マスター・プラガブル・データベースの作成

- 21.2 テスト・マスター・プラガブル・データベースのスナップショット・クローンの作成

- 21.2.1 Exadataテスト・マスターPDBのスナップショット・クローンの作成

- 21.2.2 ACFSテスト・マスターPDBのスナップショット・クローンの作成

- 21.3 テスト・マスター・プラガブル・データベースの有効化

- 21.4 テスト・マスター・プラガブル・データベースの無効化

22 DBaaSセルフ・サービス・ポータルの使用

- 22.1 データベース・クラウド・セルフ・サービス・ポータルの使用

- 22.2 データベースのリクエスト

- 22.2.1 スキーマのリクエスト

- 22.2.2 プラガブル・データベースのリクエスト

- 22.3 データベースのリフレッシュ

- 22.4 リクエストの履歴の表示

- 22.5 データベース・サービス・ホームページの表示

- 22.6 データベース・インスタンス・ホームページの表示

- 22.7 スタンバイ・データベース・ホームページの表示

- 22.8 クラスタ・データベース・ホームページの表示

- 22.9 プラガブル・データベース・ホームページの表示

第VIII部 データベースのメンテナンスとカスタマイズ

23 データベース・プールのメンテナンス

- 23.1 データベース・プールのメンテナンスについて

- 23.2 データベース・ゴールド・イメージの作成

- 23.3 イメージへのサブスクライブ

- 23.4 イメージのデプロイ

- 23.4.1 Oracleホームのデプロイ

- 23.4.2 新規Oracleホームのアクティブ化

- 23.4.3 データベースの更新

- 23.5 進行中のイメージ更新の実行

- 23.5.1 イメージの新規バージョンの作成

24 Database as a Serviceのカスタマイズ

- 24.1 リクエスト作成/削除の前処理および後処理スクリプト

- 24.1.1 SQL後スクリプト

- 24.1.2 サンプル・スクリプト

- 24.1.3 前処理および後処理データベース・スクリプトの入力パラメータ

- 24.1.3.1 DBaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

- 24.1.3.2 DBaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

- 24.1.3.3 SchaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

- 24.1.3.4 SchaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

- 24.1.3.5 PDBaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

- 24.1.3.6 PDBaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

- 24.1.3.7 サンプル入力ファイル

- 24.1.3.8 サンプルPDBaaS後処理スクリプト

第IX部 Middleware as a Serviceの設定

25 WebLogicセルフ・サービス・ポータルの設定

- 25.1 WebLogicセルフ・サービス・ポータルの設定

- 25.2 ミドルウェア・プールの作成

- 25.3 ロード・バランサ構成の作成

- 25.3.1 カスタム・スクリプトの作成

- 25.3.1.1 サンプル・スクリプト(Oracle Cloud Application 12.1.0.8以前)

- 25.3.1.2 サンプル・スクリプト(Oracle Fusion Middleware 12.1.0.7以降)

- 25.3.2 ソフトウェア・ライブラリへのサード・パーティLBR構成の追加

- 25.4 リクエスト設定の構成

- 25.5 割当て制限の設定

- 25.6 WebLogicサービス・テンプレートの作成

- 25.6.1 サンプル後処理スクリプト

- 25.6.1.1 サンプル・プロパティ・ファイル

- 25.6.1.2 サンプル・スクリプト

- 25.6.1.3 サンプル・スクリプトの出力

- 25.6.2 リソース管理スクリプト

- 25.6.2.1 作成操作

- 25.6.2.2 スケール・アップ操作

- 25.6.2.3 スケール・ダウン操作

- 25.6.2.4 Delete(削除)操作

- 25.7 チャージバックの構成

26 SOAaaSまたはOSBaaSセルフ・サービス・ポータルの設定

- 26.1 SOAaaSおよびOSBaaSの開始

- 26.2 SOAリポジトリのクローニングに使用されるDBaaSの設定

- 26.2.1 SOAプロファイルのデータベース・サービス・テンプレートの作成

- 26.2.2 OSBプロファイルのデータベース・サービス・テンプレートの作成

- 26.3 SOAまたはOSBプロビジョニング・プロファイルを作成する前提条件

- 26.4 SOAおよびOSBクラウド・セルフ・サービス・ポータルの設定

- 26.4.1 SOAaaSおよびOSBaaSプールの作成

- 26.4.2 SOAおよびOSBサービス・テンプレートの作成

- 26.4.3 サンプル後処理スクリプト

- 26.4.3.1 サンプル・プロパティ・ファイル

- 26.4.3.2 サンプル・スクリプト

- 26.4.3.3 サンプル・スクリプトの出力

- 26.4.4 リソース管理スクリプト

- 26.4.4.1 作成操作

- 26.4.4.2 スケール・アップ操作

- 26.4.4.3 Delete(削除)操作

27 JVMaaSセルフ・サービス・ポータルの設定

- 27.1 Javaアプリケーション・サービス・セルフ・サービス・ポータルの設定

- 27.2 カスタマイズされたミドルウェア・プロファイルの作成

- 27.3 ミドルウェア・プロファイルのソフトウェア・ライブラリへのアップロード

- 27.4 Javaアプリケーション・プロファイルに基づくサービス・テンプレートの作成

28 MWaaSセルフ・サービス・ポータルの使用

- 28.1 MWaaSセルフ・サービス・ポータルの使用

- 28.1.1 プリファレンスの設定

- 28.1.2 ミドルウェア・サービスの動的伸縮性ポリシーの定義

- 28.1.2.1 MWaaSのスケジュール・ポリシーの作成

- 28.1.2.2 MWaaSのパフォーマンス・ポリシーの定義

- 28.2 ミドルウェア・サービスのリクエスト

- 28.2.1 WebLogicサービスのリクエスト

- 28.2.2 Oracle Service BusまたはSOAインフラストラクチャ・サービスのリクエスト

- 28.3 Middleware Serviceホームページの表示

- 28.3.1 アプリケーションのデプロイおよび再デプロイ

- 28.3.1.1 アプリケーションの再デプロイ

- 28.3.1.2 アプリケーションの削除

- 28.3.2 サービスのスケール・アップおよびスケール・ダウン

- 28.3.3 データ・ソースの作成

- 28.3.3.1 データ・ソースの編集

- 28.4 SOA/OSBサービス・ホームページの表示

- 28.5 Javaアプリケーション・サービス・インスタンス・ホームページの表示

- 28.6 ソフトウェア・ライブラリへのJava EEコンポーネントのアップロード

- 28.7 アプリケーション・ホームページの表示

第X部 PaaSクラウドの監視

29 PaaSクラウドの管理および監視

- 29.1 クラウド・ホーム・ページの表示

- 29.1.1 「リソース・プロバイダ使用率ヒート・マップ」の表示

- 29.2 リソース・プロバイダのリストの表示

- 29.3 サービス・テンプレートのリストの表示

- 29.3.1 サービス・テンプレート権限の付与、取消しおよび再割当て

- 29.4 サービス・インスタンスのリストの表示

- 29.4.1 サービス・インスタンスに対する権限の付与、取消しおよび再割当て

- 29.5 「クラウド」の「リクエスト・ダッシュボード」の表示

- 29.6 すべてのクラウド・リクエストの表示

- 29.7 PaaSインフラストラクチャ・ゾーン・ホームページの表示

- 29.8 データベース・プール・ホームページの表示

- 29.9 スキーマ・プール・ホームページの表示

- 29.10 プラガブル・データベース・プール・ホームページの表示

- 29.11 ミドルウェア・プール・ホームページの表示

- 29.12 クラウド・サービス・レポートの表示

- 29.12.1 リクエスト頻度が最も高いサービス・タイプ

- 29.12.2 サービス・リクエスト・ステータス

- 29.12.3 サービス・リクエスト・タイプ

- 29.12.4 クラウド・サービス・インスタンス期間スレッド

第XI部 Oracle Compute

30 Oracle Computeのスタート・ガイド

- 30.1 Oracle Computeについて

- 30.2 Oracle Computeの用語

- 30.3 はじめに

- 30.4 Oracle Computeサイトの検出

- 30.4.1 Oracle Computeサイトと関連ターゲットの検出

- 30.4.2 サイト証明書のインポート

31 Oracle Computeセルフ・サービス・ポータルの設定

- 31.1 Oracle Computeサイトの設定

- 31.2 テナントの作成

- 31.2.1 テナントの編集

- 31.3 形状の作成

- 31.4 割当て制限の定義

- 31.5 Oracle Computeテンプレートの管理

- 31.5.1 管理エージェントの構成

- 31.6 編成サービス・テンプレートの作成

- 31.6.1 起動プランの作成

- 31.7 Enterprise ManagerロールのOracle Computeロールへのマップ

32 Oracle Computeの使用

- 32.1 Oracle Computeセルフ・サービス・ポータルの使用

- 32.2 新しい編成の作成

- 32.3 編成の詳細の表示

- 32.3.1 Oracle VMインスタンス・ホームページの表示

- 32.4 ネットワークの作成

- 32.4.1 テナント・ネットワークのIPoIBサブネットの作成

- 32.4.2 サービス・ネットワークの表示

- 32.5 記憶域ボリュームの作成

- 32.6 ライブラリの管理

- 32.6.1 テンプレートのアップロード

- 32.6.2 テンプレートまたはデプロイメント・プランの削除

- 32.7 オーケストレーションの検出

33 Oracle Computeサイトと関連ターゲットの管理

- 33.1 Oracle Computeサイトの表示

- 33.2 ネットワークの管理

- 33.2.1 テナント・ネットワークの作成

- 33.2.1.1 EoIBネットワークの作成

- 33.2.1.2 EoIBサブネットの作成

- 33.2.1.3 IPoIBサブネットの作成

- 33.2.1.3.1 IPoIBサブネットの編集

- 33.2.2 サービス・ネットワークの管理

- 33.2.2.1 サービス・ネットワークの作成

- 33.2.2.2 エンジニアド・システムへの接続

- 33.2.3 インフラストラクチャ・ネットワークの管理

- 33.3 記憶域ボリュームの作成

- 33.3.1 記憶域ボリューム・スナップショットの作成

- 33.4 ユーザーの作成

- 33.5 Oracle VMインスタンス・ホームページの表示

- 33.6 Oracle Compute Clusterのホームページの表示

- 33.7 「Oracle Virtual Platform」ホームページの表示

- 33.8 「Oracle Server」ホームページの表示

第XII部 動的リソース・プロビジョニング

34 Oracle VM Server for SPARCによる動的リソース・プロビジョニング

- 34.1 PaaSソリューション用の統合

- 34.1.1 前提条件

- 34.1.2 PaaSソリューションの構成の概要

- 34.1.2.1 Enterprise Manager Cloud Controlの構成

- 34.1.2.2 クライアント・キットの入手

- 34.1.2.3 Enterprise Manager Ops Centerの構成

- 34.2 vDCのリソースの構成

- 34.2.1 Oracle Solaris 11のソフトウェア・ライブラリへのクライアント・キットの内容の追加

- 34.2.2 vDC用のネットワーク・リソースの準備

- 34.2.2.1 ファブリックの識別

- 34.2.2.2 ネットワーク・ドメインの作成

- 34.2.2.3 パブリック・ネットワークの構成

- 34.2.3 ストレージ・リソースの準備

- 34.2.4 NASストレージ・ライブラリの作成

- 34.2.4.1 NAS Shareの識別

- 34.2.4.2 NASストレージ・ライブラリの作成

- 34.2.5 ファイバ・チャネルLUNを使用したSANストレージ・ライブラリの作成

- 34.2.5.1 必要なもの

- 34.2.5.2 ストレージ・サーバーの構成

- 34.2.5.3 静的ブロック・ストレージSANライブラリの作成

- 34.2.6 制御ドメインのデプロイ

- 34.2.6.1 Oracle VM Server for SPARCのプロビジョニング・プロファイルの作成

- 34.2.6.2 Oracle VM Server for SPARCのOS構成プロファイルの作成

- 34.2.6.2.1 CPUリソース割当て

- 34.2.6.2.2 暗号化ユニット

- 34.2.6.2.3 RAM

- 34.2.6.2.4 NVRAMRC値

- 34.2.6.3 インストール・サーバー・デプロイメント・プランの作成

- 34.2.6.4 インストール・サーバー・デプロイメント・プランの適用

- 34.2.7 サーバー・プールの作成

- 34.2.8 ライブラリのリフレッシュ

- 34.3 仮想データセンターの設定と構成

- 34.3.1 Enterprise Managerユーザーの作成

- 34.3.2 vDCの作成

- 34.3.3 PaaSのvDCアカウントの作成

- 34.3.4 vServerの準備

- 34.3.4.1 新しいvServerタイプの作成

- 34.3.4.2 プライベートvNetの作成

- 34.4 サーバー・テンプレートの設定と構成

- 34.4.1 OS更新プロファイルの作成

- 34.4.2 ゲスト用OSプロビジョニング・プロファイルの作成

- 34.4.3 ゲスト用OS構成プロファイルの作成

- 34.4.4 vServerテンプレートの作成

- 34.4.5 vServerの作成

- 34.5 統合およびPaaSの検証

- 34.5.1 vServerのボリュームの作成

- 34.5.2 テストvServerの作成

- 34.5.3 共有ストレージと接続性の確認

- 34.5.4 問題の診断

35 動的リソース・プロビジョニングの開始

- 35.1 動的リソース・プロビジョニングについて

- 35.2 Solaris SPARCアダプタの構成

- 35.2.1 ステージング・サーバーの追加

- 35.2.2 仮想マシン・アダプタ・インスタンスの作成

- 35.2.3 仮想マシン・アダプタ・インスタンスの編集

- 35.2.4 仮想マシン・アダプタ・インスタンスの削除

- 35.2.5 仮想マシン・サービス・テンプレートの作成

36 DBaaSクラウドでのリソースのプロビジョニング

- 36.1 リソースのプロビジョニング

- 36.2 リソースのプロビジョニング解除

37 MWaaSクラウドでのリソースの動的なプロビジョニング

- 37.1 リソースのプロビジョニング

- 37.2 リソースのプロビジョニング解除

- 37.3 動的リソース・プロビジョニングの有効化

- 37.3.1 動的プロビジョニングの無効化

第XIII部 JVM Diagnostics as a Service

38 JVM Diagnostics as a Serviceの設定

- 38.1 JVM Diagnostics as a Serviceについて

- 38.2 ユーザーおよびロールの作成

- 38.3 JVMDaaSの設定

- 38.4 割当て制限の定義および割当て

- 38.5 JVM診断エージェントおよびエンジンの監視

39 JVM診断セルフ・サービス・ポータルの使用

- 39.1 JVM診断クラウド・セルフ・サービス・ポータル

- 39.2 JVMのホーム・ページ

第XIV部 Testing as a Service (TaaS)の有効化

40 Testing as a Serviceについて

- 40.1 TaaSロール

- 40.1.1 テスト管理者

- 40.1.2 テスト設計者

- 40.1.3 テスト実施者

41 Testing as a Serviceの設定

- 41.1 はじめに

- 41.2 テスト管理者の作成

- 41.3 アセンブリ・コンポーネントの作成

- 41.4 デプロイメント・プランの作成

42 Testing as a Serviceポータルの使用

- 42.1 前提条件

- 42.2 テスト管理者のタスク

- 42.2.1 アプリケーション・タイプの設定

- 42.2.2 テスト・ドライバの設定

- 42.2.3 Oracle Load Testingテスト・ドライバの設定

- 42.2.4 Oracle Functional Testingテスト・ドライバの設定

- 42.2.5 カスタム・テスト・ドライバ・タイプの設定

- 42.2.6 割当て制限の設定

- 42.2.7 結果ファイル・システムの設定

- 42.2.8 テスト環境、テスト・アセットおよびテスト・ドライバの発行

- 42.2.9 チャージバック・サービスの設定

- 42.3 テスト設計者のタスク: テスト・アセットおよびテスト環境の作成

- 42.3.1 テスト・アセットの作成 - 一般情報

- 42.3.2 テスト・アセットの作成 - Oracle Load Testing

- 42.3.3 テスト・アセットの作成 - Oracle Functional Testing

- 42.3.4 テスト・アセットの作成 - カスタム・テスト

- 42.3.5 テスト環境の作成

- 42.4 テスト実施者のタスク - テスト環境の使用

- 42.4.1 使用可能なテスト・アセットおよびテスト環境の確認

- 42.4.2 テストの作成

- 42.4.3 テストの作成 - Oracle Load Testingテスト

- 42.4.4 テストの作成 - Oracle Functional Testing Testsテスト

- 42.4.5 テストの作成 - カスタム・テスト

- 42.4.6 試行の作成および実行

- 42.4.7 Oracle Load Testing試行の作成および実行

- 42.4.8 Oracle Functional Testing試行の作成および実行

- 42.4.9 進行中の試行の監視

- 42.4.10 試行結果の比較

- 42.4.11 テストの共有

- 42.4.12 アクティビティおよび使用状況情報の表示

- 42.4.13 デプロイメント情報の表示

- 42.4.14 テスト・ホームページの参照

- 42.4.15 試行ページ

- 42.4.16 TaaSレポートの表示

- 42.4.17 テストに必要なハードウェアの見積り

第XV部 統合プランナおよびチャージバックの使用

43 チャージバック管理

- 43.1 チャージバックの概要

- 43.1.1 チャージバックを実装する理由

- 43.1.2 Enterprise Manager Chargeback

- 43.1.2.1 チャージバック・エンティティ

- 43.1.2.2 チャージ・プラン

- 43.1.2.3 コスト・センター

- 43.1.2.4 レポート

- 43.2 チャージバックの設定

- 43.2.1 チャージバックとメトリック

- 43.2.2 チャージバック内のセルフ・サービス・アプリケーションおよびゾーン

- 43.2.3 チャージバックに関するグローバル設定の構成

- 43.2.4 チャージ・プランの使用

- 43.2.4.1 チャージ・プランおよび有効日

- 43.2.4.2 ユニバーサル・チャージ・プランの作成および修正

- 43.2.4.3 拡張チャージ・プランの作成

- 43.2.4.4 チャージ・アイテム・メタデータの表示

- 43.2.4.5 チャージ・プランでの条件の使用

- 43.2.4.6 拡張チャージ・プランの修正

- 43.2.5 コスト・センターの作成

- 43.2.5.1 Enterprise Managerユーザーの「コスト・センター」プロパティの設定

- 43.2.5.2 ターゲット・ホームページでのコスト・センター・プロパティの設定

- 43.2.5.3 チャージバックに関する高いレベルのコスト・センターの作成

- 43.2.5.4 LDAPサーバーからのビジネス階層のインポート

- 43.2.6 チャージバックへのエンティティの追加

- 43.2.6.1 Enterprise Managerデータベース・サービスのメトリック収集の構成

- 43.2.6.2 チャージバックのエンティティの選択

- 43.2.6.3 割当ての実行

- 43.2.6.4 エンティティ設定の確認

- 43.2.7 エンティティへのコスト・センターの割当て

- 43.2.8 エンティティへのチャージ・プランの割当て

- 43.2.9 エンティティ・タイプのデフォルトのチャージ・プランの設定

- 43.2.10 日次データ収集ジョブの実行

- 43.3 チャージバック情報へのアクセス

- 43.3.1 使用状況およびチャージの傾向の追跡

- 43.3.2 エンティティの収集済メトリック・データの表示

- 43.3.3 チャージバック・レポートの生成と配布

- 43.3.4 セルフ・サービス・ポータルでのチャージバック情報の表示

- 43.3.5 他のアプリケーションとのチャージバック・データの共有

44 統合プランナの使用

- 44.1 統合プランナの概要

- 44.1.1 主要概念

- 44.1.2 統合制約

- 44.1.2.1 ソース・サーバーの制約

- 44.1.2.2 宛先サーバーの制約

- 44.2 統合プランナの使用

- 44.2.1 統合プロジェクトの作成

- 44.2.1.1 統合タイプの宣言

- 44.2.1.2 ソース候補の指定

- 44.2.1.3 宛先の候補の指定

- 44.2.1.4 データ収集パラメータの設定

- 44.2.1.5 事前構成済のシナリオの選択

- 44.2.1.6 統合プロジェクトの確認および保存

- 44.2.2 カスタム統合シナリオの作成

- 44.2.2.1 シナリオ・パラメータの指定

- 44.2.2.2 統合制約の定義

- 44.2.2.3 宛先の候補の指定

- 44.2.2.4 宛先へのソースのマッピング

- 44.2.2.5 新しいシナリオの確認および保存

- 44.2.3 その他のシナリオ作成オプション

- 44.2.4 統合シナリオの評価

- 44.2.5 統合シナリオの分析

- 44.2.6 統合レポートの表示

- 44.2.6.1 統合プランナ・プロジェクト・レポートの表示

- 44.2.6.2 統合プランナ・シナリオ・レポートの表示

- 44.2.7 Oracle Compute Cloud形状の検討

- 44.2.8 データ収集管理

第XVI部 クラウドAPIの使用

45 クラウドAPIの概要

- 45.1 はじめに

- 45.2 クラウドREST APIを使用する場合

- 45.3 変更履歴

- 45.4 共通の動作

- 45.4.1 トランスポート・プロトコル

- 45.4.2 URI空間

- 45.4.3 メディア・タイプ

- 45.4.4 リクエスト・ヘッダー

- 45.4.5 レスポンス・ヘッダー

- 45.4.6 HTTPステータス・コード

- 45.4.7 共通リソース属性

- 45.4.7.1 リソースの状態

- 45.4.8 コレクション

- 45.4.9 エラー・レスポンス・メッセージ

46 クラウドのリソース・モデル

- 46.1 Enterprise Managerクラウド・リソース・モデル10001

- 46.2 クラウドのリソースの概要

- 46.3 リソースのデータ・モデル

- 46.3.1 クラウド[application/oracle.com.cloud.common.Cloud+json]

- 46.3.2 ServiceTemplate [application/oracle.com.cloud.common.ServiceTemplate+json]

- 46.3.3 ゾーン[application/oracle.com.cloud.common.Zone+json]

- 46.3.4 サービス・ファミリ・タイプ[application/oracle.com.cloud.common.ServiceFamilyType+json]

- 46.3.5 サービス・インスタンス・タイプ[application/oracle.com.cloud.common.InstanceType+json]

- 46.3.6 メトリック[application/oracle.com.cloud.common.Metric+json]

- 46.3.7 サービス・インスタンス[application/oracle.com.cloud.common.ServiceInstance+json]

- 46.3.8 割当て制限使用量[application/oracle.com.cloud.common.QuotaUsage+json]

- 46.3.9 サービス・テンプレート検索[application/oracle.com.cloud.common.ServiceTemplateFinds+json]

- 46.4 クラウドREST APIの例

- 46.4.1 クラウド・リソース

- 46.4.2 サービス・ファミリ・タイプ・リソース

- 46.4.3 割当て制限リソース

- 46.4.4 サービス・インスタンス・タイプ・リソース

- 46.4.5 ゾーン・リソース

- 46.4.6 サービス・テンプレート・リソース

- 46.4.7 メトリック・リソース

- 46.5 サービス・リクエストREST API

- 46.6 サービス・リクエスト・コレクション

47 Database as a Service管理者用のEM CLI動詞

- 47.1 PaaSゾーンEM CLI動詞

- 47.2 ソフトウェア・プールEM CLI動詞

- 47.3 データベース割当て制限EM CLI動詞

- 47.4 データベース・リクエスト設定EM CLI動詞

- 47.5 データベース・サイズEM CLI動詞

- 47.6 データベース・プロファイルEM CLI動詞

- 47.6.1 データベース・プロビジョニング・プロファイル・タイプについて

- 47.6.1.1 DBCAテンプレート

- 47.6.1.2 RMAN

- 47.6.1.3 スナップ・クローン

- 47.6.1.4 スキーマ

- 47.6.2 EM CLIを使用したプロビジョニング・プロファイルの作成

- 47.6.3 EM CLIプロパティ・ファイルの例

- 47.6.3.1 DBCAテンプレート

- 47.6.3.2 ソース・データベースからの新規のRMANバックアップ

- 47.6.3.3 ソース・データベースからの既存のRMANバックアップ

- 47.6.3.4 ステージングの場所の既存のRMANバックアップ

- 47.6.3.5 スナップ・クローン・データベース

- 47.6.3.6 スキーマ・データベース

- 47.6.4 データベース・プロファイルEM CLI動詞

- 47.6.5 EM CLI動詞を使用したデータベース・プロファイルの作成

- 47.6.6 EM CLI動詞を使用したデータベース・プロファイルの編集

- 47.6.7 EM CLI動詞を使用したデータベース・プロファイルの削除

- 47.6.8 すべてのデータベース・プロファイルの表示

- 47.6.9 EM CLI動詞を使用したデータベース・プロファイルのリフレッシュ

- 47.7 サービス・テンプレートEM CLI動詞

- 47.8 サービス・テンプレートの実行可能.jsonファイル

- 47.8.1 DBCAベース・サービス・テンプレートの.jsonファイル

- 47.8.2 スタンバイDBCAベース・サービス・テンプレートの.jsonファイル

- 47.8.3 RMANベースの単一インスタンス・データベース用のサービス・テンプレートの.jsonファイル

- 47.8.4 単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの.jsonファイル

- 47.8.5 RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの.jsonファイル

- 47.8.6 スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの.jsonファイル

- 47.8.7 単一インスタンス・スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの.jsonファイル

- 47.8.8 DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの.jsonファイル

- 47.8.9 DNFSベースのデータベース用のサービス・テンプレートの.jsonファイル

- 47.8.10 アーカイブが有効なスナップ・クローン単一インスタンス・データベース用のサービス・テンプレートのjsonファイル

- 47.8.11 スキーマ・ベース・サービス・テンプレートの.jsonファイル

- 47.8.12 プラガブル・データベース用のサービス・テンプレートの.jsonファイル

- 47.8.13 空のプラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの.jsonファイル

- 47.8.14 プロファイル・プラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの.jsonファイル

- 47.8.15 CloneDBベース・サービス・テンプレートの.jsonファイル

- 47.8.16 RMAN複製サービス・テンプレートを使用したフル・クローンの.jsonファイル

- 47.8.17 EMCストレージでライブ・クローン・テンプレートを使用したスナップクローン・データベース用のサービス・テンプレートの.jsonファイル

- 47.9 EM CLI動詞を使用したデータベース・クローンの作成

- 47.10 EM CLI動詞を使用したデータベースのリフレッシュ

- 47.11 EM CLI動詞を使用したデータベースの削除

- 47.12 データベース・フリート・メンテナンスEM CLI動詞

- 47.13 データベース・リクエスト処理EM CLI動詞

- 47.14 プラガブル・データベースのクローニング

- 47.14.1 プラガブル・データベースのフル・クローンの方法

- 47.14.2 プラガブル・データベースのスナップショット・クローンのタイプ

- 47.15 テスト・マスター・プラガブル・データベースの作成

- 47.16 データベース間でのデータの転送

- 47.17 プラガブル・データベースのデータファイルおよびメタデータのバックアップ

- 47.18 エクスポート・ダンプからデータベースへのデータのインポート

- 47.19 EM CLI動詞を使用したREST APIの起動

48 Database as a Service管理者REST API

- 48.1 Database as a Service管理者REST APIのサマリー

- 48.2 REST APIを使用した新しいDBaaSクラウド設定の作成

- 48.3 Database as a Service管理者操作REST API

- 48.3.1 PaaSゾーン群REST APIおよびPaaSゾーンREST API

- 48.3.1.1 PaaSゾーン群REST API

- 48.3.1.1.1 PaaSゾーン群に対してサポートされるリクエスト・メソッド

- 48.3.1.2 PaaSゾーンREST API

- 48.3.1.2.1 PaaSゾーンに対してサポートされるリクエスト・メソッド

- 48.3.1.3 PaaSゾーン群REST APIおよびPaaSゾーンREST APIの例

- 48.3.1.3.1 PaaSゾーン群リソースの詳細の表示

- 48.3.1.3.2 PaaSゾーン・リソースの詳細の表示

- 48.3.1.3.3 PaaSゾーンの作成

- 48.3.1.3.4 PaaSゾーンの更新

- 48.3.1.3.5 PaaSゾーンの削除

- 48.3.2 ソフトウェア・プール群REST APIおよびソフトウェア・プールREST API

- 48.3.2.1 ソフトウェア・プール群

- 48.3.2.1.1 ソフトウェア・プール群に対してサポートされるリクエスト・メソッド

- 48.3.2.2 ソフトウェア・プール

- 48.3.2.2.1 ソフトウェア・プールに対してサポートされるリクエスト・メソッド

- 48.3.2.3 ソフトウェア・プールREST APIの例

- 48.3.2.3.1 ソフトウェア・プール群リソースの詳細の表示

- 48.3.2.3.2 ソフトウェア・プール・リソースの詳細の表示

- 48.3.2.3.3 ソフトウェア・プール容量の詳細の表示

- 48.3.2.3.4 データベース・プールの作成

- 48.3.2.3.5 データベース・プールの更新

- 48.3.2.3.6 スキーマ・プールの作成

- 48.3.2.3.7 スキーマ・プールの更新

- 48.3.2.3.8 プラガブル・データベース・プールの作成

- 48.3.2.3.9 プラガブル・データベース・プールの更新

- 48.3.2.3.10 データベース/スキーマ/プラガブル・データベースのプールの削除

- 48.3.3 データベース・リクエスト設定REST API

- 48.3.3.1 データベース・リクエスト設定リソース・モデル

- 48.3.3.2 Dbaasリクエスト設定リソース

- 48.3.3.3 Dbaasリクエスト設定のサポートされる操作

- 48.3.3.4 Dbaasリクエスト設定REST APIの例

- 48.3.3.4.1 Dbaasリクエスト設定リソースの詳細の表示

- 48.3.3.4.2 データベース・リクエスト設定の作成

- 48.3.4 データベース割当て制限REST API

- 48.3.4.1 データベース割当て制限リソース・モデル

- 48.3.4.2 Dbaas割当て制限リソース

- 48.3.4.3 DbaaS割当て制限のサポートされる操作

- 48.3.4.4 データベース割当て制限REST APIの例

- 48.3.4.4.1 DBaas割当て制限リソースの詳細の表示

- 48.3.4.4.2 ロール用のDBaaS割当て制限の作成

- 48.3.4.4.3 ロール用のDBaaS割当て制限の更新

- 48.3.4.4.4 ロール用のDBaaS割当て制限の削除

- 48.3.5 サービス・テンプレートREST API

- 48.3.5.1 サービス・テンプレート群リソース

- 48.3.5.1.1 サービス・テンプレートでサポートされる操作

- 48.3.5.2 サービス・テンプレート・リソース

- 48.3.5.2.1 サービス・テンプレートでサポートされる操作

- 48.3.5.3 サービス・テンプレート群REST APIおよびサービス・テンプレートREST APIの例

- 48.3.5.3.1 サービス・テンプレート群リソースの詳細の表示

- 48.3.5.3.2 ServiceTemplateリソースの詳細の表示

- 48.3.5.3.3 DBCAベースのデータベース用のサービス・テンプレートの作成

- 48.3.5.3.4 RMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成

- 48.3.5.3.5 単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成

- 48.3.5.3.6 RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成

- 48.3.5.3.7 スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成

- 48.3.5.3.8 スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの作成

- 48.3.5.3.9 DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの作成

- 48.3.5.3.10 DNFSベースのデータベース用のサービス・テンプレートの作成

- 48.3.5.3.11 スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートの作成

- 48.3.5.3.12 スナップ・クローン単一インスタンス・データベース用(アーカイブが無効)のサービス・テンプレートの作成

- 48.3.5.3.13 スキーマ用のサービス・テンプレートの作成

- 48.3.5.3.14 プラガブル・データベース用のサービス・テンプレートの作成

- 48.3.5.3.15 空のプラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成

- 48.3.5.3.16 プロファイル・プラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成

- 48.3.5.3.17 データベース/スキーマ/プラガブル・データベースのサービス・テンプレートの削除

49 Database as a Service SSAユーザーREST API

- 49.1 Database as a Service SSAユーザーREST APIのサマリー

- 49.2 Database as a Service

- 49.2.1 Database as a Serviceのリソース・モデル

- 49.2.1.1 DBゾーン

- 49.2.1.2 DBプラットフォーム・テンプレート

- 49.2.1.3 DBプラットフォーム・インスタンス

- 49.2.2 Database as a Serviceリソースのサポートされる操作

- 49.2.3 Database as a Service REST APIの例

- 49.2.3.1 すべてのクラウド・リソースの詳細の表示

- 49.2.3.2 特定のリソース属性の出力のフィルタ処理

- 49.2.3.3 サービス・ファミリ・タイプ・リソースの詳細の表示

- 49.2.3.4 サービス・インスタンス・タイプ・リソースの詳細の表示

- 49.2.3.5 サービス・リクエスト・リソースの詳細の表示

- 49.2.3.6 DBゾーンの詳細の表示

- 49.2.3.7 DBプラットフォーム・テンプレート・リソースの詳細の表示

- 49.2.3.8 データベース・インスタンスの作成

- 49.2.3.8.1 DBゾーンへのリクエスト渡しによるデータベースの作成

- 49.2.3.8.2 DBプラットフォーム・テンプレートへのリクエスト渡しによるデータベースの作成

- 49.2.3.9 データベース作成の詳細の表示

- 49.2.3.10 データベースの更新

- 49.2.3.11 データベース・インスタンスの削除

- 49.2.3.12 データベース・インスタンスに対するライフサイクル操作

- 49.2.3.12.1 データベースの停止

- 49.2.3.12.2 データベースの起動

- 49.2.3.12.3 データベースのバックアップのスケジュール

- 49.2.3.12.4 バックアップからのデータベースのリストア

- 49.2.3.12.5 スタンバイ・データベースの追加

- 49.2.3.12.6 スタンバイ・データベースの削除

- 49.2.3.12.7 データベースのリフレッシュ

- 49.2.3.13 スナップ・クローン・データベース・インスタンスに対するライフサイクル操作

- 49.2.3.13.1 スナップショットの作成

- 49.2.3.13.2 スナップショット・リストからのリストア

- 49.2.3.13.3 スナップショットの削除

- 49.3 Schema as a Service

- 49.3.1 Schema as a Serviceのリソース・モデル

- 49.3.1.1 スキーマ・プラットフォーム・テンプレート

- 49.3.1.2 スキーマ・プラットフォーム・インスタンス

- 49.3.2 Schema as a Serviceリソースのサポートされる操作

- 49.3.3 Schema as a Service REST APIの例

- 49.3.3.1 スキーマ・プラットフォーム・テンプレート・リソースの詳細の表示

- 49.3.3.2 スキーマ・サービスの作成

- 49.3.3.2.1 DBゾーンへのリクエスト渡しによるスキーマの作成

- 49.3.3.2.2 スキーマ・プラットフォーム・テンプレートへのリクエスト渡しによるスキーマの作成

- 49.3.3.3 スキーマ・サービス作成の詳細の表示

- 49.3.3.4 スキーマ・サービスの削除

- 49.3.3.5 スキーマ・サービスに対するライフサイクル操作

- 49.3.3.5.1 スキーマのエクスポート

- 49.3.3.5.2 エクスポートされたスキーマ・ダンプからのスキーマのリストア

- 49.3.3.5.3 エクスポートされたスキーマ・ダンプの削除

- 49.3.3.5.4 スキーマのパスワードの変更

- 49.4 Pluggable Database as a Service

- 49.4.1 Pluggable Database as a Serviceのリソース・モデル

- 49.4.1.1 プラガブルDBプラットフォーム・テンプレート

- 49.4.1.2 プラガブルDBプラットフォーム・インスタンス

- 49.4.2 プラガブル・データベース・リソースに対してサポートされる操作

- 49.4.3 Pluggable Database as a Service REST APIの例

- 49.4.3.1 プラガブルDbプラットフォーム・テンプレート・リソースの詳細の表示

- 49.4.3.2 プラガブル・データベースの作成

- 49.4.3.2.1 DBゾーンへのリクエスト渡しによるプラガブル・データベースの作成

- 49.4.3.2.2 プラガブルDBプラットフォーム・テンプレートへのリクエスト渡しによるプラガブル・データベースの作成

- 49.4.3.3 プラガブル・データベース作成の詳細の表示

- 49.4.3.4 プラガブル・データベース・インスタンスの削除

- 49.4.3.5 プラガブル・データベース・インスタンスに対するライフサイクル操作

- 49.4.3.5.1 プラガブル・データベースの停止

- 49.4.3.5.2 プラガブル・データベースの起動

- 49.4.3.5.3 プラガブル・データベースに対するバックアップのスケジュール

- 49.4.3.5.4 バックアップからのプラガブル・データベースのリストア

50 DBaaS REST APIおよびEM CLI動詞ベースのユースケース

- 50.1 REST APIおよびEM CLI動詞でのDBaaSの開始

- 50.2 REST APIおよびEM CLI動詞でのデータベース・テンプレートを使用したデータベースの作成

- 50.2.1 REST APIおよびEM CLI動詞でのスタンバイ・データベースの作成

- 50.3 REST APIおよびEM CLI動詞での空のスキーマおよびプロファイルに基づくスキーマの作成

- 50.4 REST APIおよびEM CLI動詞での空のPDBおよびプロファイルに基づくPDBの作成

- 50.5 あるデータベースから別のデータベースへのデータの移行/転送

- 50.6 REST APIおよびEM CLI動詞でのスナップ・クローンを使用したデータベースの作成

- 50.6.1 REST APIおよびEM CLI動詞でのプロファイルを使用したスナップ・クローンの作成

- 50.6.2 REST APIおよびEM CLI動詞でのライブ・データベースを使用したスナップ・クローンの作成

- 50.6.3 連続同期

- 50.7 REST APIおよびEM CLI動詞でのRMANを使用したフル・データベース・クローンの作成

- 50.7.1 RMANバックアップを使用したフル・データベース・クローンの作成

- 50.7.2 RMAN複製を使用したフル・データベース・クローンの作成(ライブ・クローニング)

- 50.7.3 不連続同期

- 50.8 REST APIを使用したカスタム・データベース配置オプションの構成

- 50.8.1 REST APIを使用したデータベース用のカスタム・データベース配置オプション

- 50.8.2 REST APIを使用したプラガブル・データベース用のカスタム・データベース配置オプション

- 50.9 Database as a Serviceのサービス・カタログ

- 50.9.1 複数データセンターDBaaS設定

- 50.9.1.1 複数データセンターDBaaS設定を作成する管理者の手順

- 50.9.1.2 複数データセンターDBaaS設定を使用するためのSSAユーザーREST APIリクエスト

51 SSA管理REST API

- 51.1 V2のSSA管理REST APIのサマリー

- 51.2 V1のSSA管理REST APIのサマリー

- 51.3 V1およびV2のカタログAPI

- 51.3.1 CFW APIカタログREST APIの例

- 51.3.1.1 V1およびV2の上位レベルのカタログAPIの表示

- 51.3.1.2 V1カタログAPIの表示

- 51.3.1.3 V2カタログAPIの表示

- 51.3.1.4 SSAポータルのV1カタログAPIの表示

- 51.3.1.5 V2カタログ・ユーザーAPIの表示

- 51.3.1.6 V2カタログ管理APIの表示

- 51.4 V2のリソース・プロバイダ

- 51.4.1 リソース・プロバイダ - V2のコレクション・リソース

- 51.4.2 リソース・プロバイダ - V2の単一リソース

- 51.4.3 リソース・プロバイダ・リソースでサポートされるメソッド

- 51.4.4 リソース・プロバイダREST APIの例

- 51.4.4.1 すべてのリソース・プロバイダの表示

- 51.4.4.2 リソース・プロバイダのすべてのタイプの表示

- 51.4.4.3 リソース・プロバイダの作成

- 51.4.4.4 PaaSインフラストラクチャ・ゾーン・リソース・プロバイダの作成

- 51.4.4.5 データベース・スキーマ・プールの作成

- 51.4.4.6 アダプタ・インスタンスの作成

- 51.4.4.7 リソース・プロバイダ・ターゲットのフィルタ処理

- 51.4.4.8 リソース・プロバイダ・タイプ・メタデータの表示

- 51.4.4.9 PaaSインフラストラクチャ・ゾーンを作成するためのメタデータの表示

- 51.4.4.10 スキーマ・プールを作成するためのメタデータの表示

- 51.4.4.11 リソース・プロバイダの詳細の表示

- 51.4.4.12 リソース・プロバイダの更新

- 51.4.4.13 リソース・プロバイダの削除

- 51.4.4.14 リソース・プロバイダの構成の表示

- 51.4.4.15 リソース・プロバイダのメトリックの表示

- 51.4.4.16 サンプル・アダプタを使用したリソースのプロビジョニング

- 51.4.4.17 リソースのプロビジョニング解除

- 51.4.4.18 リソース・プロバイダのプロビジョニングに必要なメタデータの表示

- 51.5 サービス・テンプレート群 - V2のコレクション・リソース

- 51.5.1 サポートされる操作

- 51.5.2 V2のサービス・テンプレートREST APIの例

- 51.5.2.1 すべてのサービス・テンプレートの表示

- 51.5.2.2 すべてのサービス・テンプレート・タイプの表示

- 51.5.2.3 サービス・テンプレートの作成に必要なメタデータの表示

- 51.5.2.4 サービス・テンプレートの作成に必要なリソース・プロバイダ特性の表示

- 51.5.2.5 サービス・テンプレートの作成に必要な構成の表示

- 51.5.2.6 サービス・テンプレートの作成

- 51.5.2.7 サービス・テンプレートの更新

- 51.5.2.8 特定のサービス・テンプレートの詳細の表示

- 51.5.2.9 特定のサービス・テンプレートの構成詳細の表示

- 51.5.2.10 サービス・テンプレートの削除

- 51.5.3 V2でのサービス・テンプレートの作成

- 51.6 V2のサービス・タイプ

- 51.6.1 V2のサービス・タイプREST APIの例

- 51.6.1.1 サービス・タイプの詳細の表示

- 51.7 V2のサービス・リクエスト

- 51.7.1 サポートされる操作

- 51.7.2 V2のサービス・リクエストREST APIの例

- 51.7.2.1 すべてのサービス・リクエストの詳細の表示

- 51.7.2.2 サービス・リクエストの詳細の表示

- 51.7.2.3 サービス・リクエストの再スケジュール

- 51.7.2.4 サービス・リクエストのコレクションのクリア

- 51.7.2.5 サービス・リクエストの取消し

- 51.7.2.6 サービス・リクエストのリストの削除

- 51.8 V2のサービス・インスタンス

- 51.8.1 サポートされる操作

- 51.8.2 V2のサービス・インスタンスREST APIの例

- 51.8.2.1 すべてのサービス・インスタンスの詳細の表示

- 51.8.2.2 サービス・インスタンスの詳細の表示

- 51.8.2.3 サービス・インスタンスの起動

- 51.8.2.4 サービス・インスタンスの停止

- 51.8.2.5 サービス・インスタンスの削除

- 51.8.2.6 サービス・インスタンスのリストの開始

- 51.8.2.7 サービス・インスタンスのリストの停止

- 51.8.2.8 サービス・インスタンスのリストの削除

- 51.9 V2のリクエスト設定

- 51.9.1 リクエスト設定データ・モデル

- 51.9.2 リクエスト設定コンポジット属性データ・モデル

- 51.9.3 V2のリクエスト設定REST APIの例

- 51.9.3.1 グローバル・リクエスト設定の詳細の表示

- 51.9.3.2 グローバル・リクエスト設定の更新

- 51.9.3.3 ロールのコレクションのグローバル・リクエスト設定の詳細の表示

- 51.9.3.4 ロールのグローバル・リクエスト設定の作成

- 51.9.3.5 特定のロールのグローバル・リクエスト設定の詳細の表示

- 51.9.3.6 特定のロールのグローバル・リクエスト設定の更新

- 51.9.3.7 特定のロールのグローバル・リクエスト設定の削除

- 51.9.3.8 サービス・ファミリのリクエスト設定の詳細の表示

- 51.9.3.9 サービス・ファミリのリクエスト設定の更新

- 51.9.3.10 ロール別のサービス・ファミリ設定の詳細の表示

- 51.9.3.11 ロールのサービス・ファミリ設定の作成

- 51.9.3.12 特定のロールのサービス・ファミリ・リクエスト設定の詳細の表示

- 51.9.3.13 特定のロールのサービス・ファミリ・リクエスト設定の更新

- 51.9.3.14 特定のロールのサービス・ファミリ・リクエスト設定の削除

- 51.9.3.15 サービス・タイプのリクエスト設定の詳細の表示

- 51.9.3.16 サービス・タイプのリクエスト設定の更新

- 51.9.3.17 ロール別のサービス・タイプ設定の詳細の表示

- 51.9.3.18 ロールのサービス・タイプ設定の作成

- 51.9.3.19 特定のロールのサービス・タイプ・リクエスト設定の詳細の表示

- 51.9.3.20 特定のロールのサービス・タイプ・リクエスト設定の更新

- 51.9.3.21 特定のロールのサービス・タイプ・リクエスト設定の削除

- 51.10 V2のVMアダプタ

- 51.10.1 VMアダプタ・データ・モデル

- 51.10.2 サポートされる操作

- 51.10.3 V2のVMアダプタREST APIの例

- 51.10.3.1 すべての登録済VMアダプタの詳細の表示

- 51.10.3.2 特定の登録済VMアダプタの詳細の表示

- 51.10.3.3 ステージング・サーバーの詳細の表示

- 51.10.3.4 ステージング・サーバーの作成

- 51.11 V1のSSA管理リソース

- 51.11.1 REST APIエントリ・ポイント・リソースの詳細の表示

- 51.12 V1のPaasZones

- 51.12.1 PaasZones REST APIの例

- 51.12.1.1 PaaSゾーン群メタデータの表示

- 51.12.1.2 PaaSゾーン群のリスト

- 51.13 V1のPaasZone

- 51.13.1 PaaSゾーンREST APIの例

- 51.13.1.1 PaaSゾーンの作成

- 51.13.1.2 PaaSゾーンの更新

- 51.13.1.3 PaaSゾーンの削除

- 51.13.1.4 PaasZoneの詳細の表示

- 51.13.1.5 PaasZoneからの展開形式の表示

- 51.14 V1のSoftwarePools

- 51.14.1 ソフトウェア・プール群REST APIの例

- 51.14.1.1 ソフトウェア・プール群の詳細の表示

- 51.14.1.2 検索問合せパラメータに基づくフィルタリング出力

- 51.15 V1のSoftwarePool

- 51.15.1 SoftwarePool REST APIの例

- 51.15.1.1 ソフトウェア・プールの作成

- 51.15.1.2 ソフトウェア・プールの更新

- 51.15.1.3 ソフトウェア・プールの削除

- 51.15.1.4 ソフトウェア・プールの詳細の表示

- 51.15.1.5 問合せパラメータの展開

- 51.15.2 V1のSoftwarePoolMetadata

- 51.15.2.1 ソフトウェア・プール・メタデータREST APIの取得例

- 51.15.3 V1のSoftwarePoolFilteredTargets

- 51.15.3.1 使用可能なフィルタ処理済ターゲット取得 - REST APIの例

- 51.15.4 V1のSoftwarePoolCapacity

- 51.15.4.1 ソフトウェア・プール容量の取得

- 51.16 V1のコンポジット・リソース属性

- 51.16.1 V1のValueDescriptor

- 51.16.2 V1のValueEntity

- 51.16.3 V1のEntityValueHolder

- 51.16.4 V1のPoolEntityCapacity

- 51.16.5 V1のResourceTypeCapacity

- 51.17 V1のサービス・テンプレート管理

- 51.17.1 V1のサービス・テンプレート群

- 51.17.1.1 ServiceTemplatesリソースでサポートされるメソッド

- 51.17.1.2 ServiceTemplates REST APIの例

- 51.17.2 V1のサービス・テンプレート

- 51.17.2.1 ServiceTemplateリソースでサポートされるメソッド

- 51.17.3 V1のServiceTemplateUpdate

- 51.17.4 V1のServiceExecutableMetaEntity

- 51.17.5 V1のテンプレート構成パラメータ

- 51.17.6 V1のPayloadDescriptor

- 51.17.7 V1のServiceTemplateメタデータ

- 51.17.8 V1のPayloadMetaData

- 51.17.9 V1のServiceTemplateメタデータ

- 51.17.10 ServiceTemplates REST APIの例

- 51.17.10.1 サービス・テンプレートの作成

- 51.17.10.2 サービス・テンプレートの更新

- 51.17.10.3 サービス・テンプレートの削除

- 51.17.10.4 サービス・テンプレートの詳細の表示

- 51.17.10.5 サービス・テンプレートのメタデータの表示

- 51.17.10.6 サービス・テンプレートの構成値の作成

- 51.18 セルフ・サービス・アプリケーション用のEM CLI動詞

- 51.18.1 はじめに

- 51.18.2 V2のSSA操作用のEM CLI動詞

- 51.18.3 V1のSSA操作用のEM CLI動詞

52 SSAポータル管理REST API

- 52.1 V2のSSAユーザーREST APIのサマリー

- 52.2 V1のユーザーREST APIのサマリー

- 52.3 V2の共通RESTエンティティ

- 52.3.1 V2のCfwリソース

- 52.3.2 V2のCfwリンク

- 52.3.3 V2のCfw値記述子

- 52.4 カタログAPI

- 52.4.1 サポートされる操作

- 52.4.2 V2のREST APIカタログの例

- 52.4.2.1 使用可能なREST APIカタログの詳細の表示

- 52.4.2.2 ユーザー・タイプ別のAPIカタログの詳細の表示

- 52.4.2.3 ユーザーAPIカタログの詳細の表示

- 52.5 V2のサービス・タイプ

- 52.5.1 V2のサービス・タイプREST APIの例

- 52.5.1.1 サービス・タイプの詳細の表示

- 52.6 V2のサービス

- 52.6.1 V2のサービス・コレクション

- 52.6.2 V2のサービス提供

- 52.6.3 V2のリクエスト・メタデータ

- 52.6.4 V2のサービスでサポートされる操作

- 52.6.5 V2のサービスREST APIの例

- 52.6.5.1 サービス・リソースの詳細の表示

- 52.6.5.2 サービス提供リソースの詳細の表示

- 52.6.5.3 リクエスト・メタデータの詳細の表示

- 52.6.5.4 サービス・インスタンスの作成

- 52.6.6 V2を使用したサービス・インスタンスの作成

- 52.7 V1およびV2のサービス・リクエストREST API

- 52.7.1 V2のサービス・リクエスト・リソース

- 52.7.2 サービス・リクエスト・コレクション - V1のコレクション・リソース

- 52.7.3 サービス・リクエストに対してサポートされる操作

- 52.7.4 V1およびV2のサービス・リクエストREST API例

- 52.7.4.1 V1およびV2でのサービス・リクエストのトップ・レベル・ビューの取得

- 52.7.4.2 V2でのStatus=SUCCESSのサービス・リクエスト・リソースの問合せ

- 52.7.4.3 V2でのExpanded=trueおよびExpanded=falseのサービス・リクエスト・リソースの問合せ

- 52.7.4.4 V2でのstatus=SUCCESS&expanded=falseおよびstatus=SUCCESS&expanded=trueのサービス・リクエスト・リソースの問合せ

- 52.7.4.5 V2でのサービス・リクエストの詳細の表示

- 52.7.4.6 V2でのサービス・リクエストの削除

- 52.7.4.7 V1およびV2でのスケジュール済状態にあるサービス・リクエストの再スケジュール

- 52.7.4.8 V2でのサービス・リクエストのログの表示

- 52.7.4.9 V2でのサービス・リクエストのログの問合せ

- 52.7.4.10 V1での特定のサービス・ファミリにおけるサービス・リクエストのトップ・レベル・ビューの取得

- 52.7.4.11 V1での特定のステータスにおけるサービス・リクエストのトップ・レベル・ビューの取得

- 52.7.4.12 V1での取消済状態(またはスケジュール済以外の状態)にあるサービス・リクエストの再スケジュール

- 52.7.4.13 V1でのスケジュール済状態にあるサービス・リクエストの削除

- 52.7.4.14 V1での取消済状態(またはスケジュール済以外の状態)にあるサービス・リクエストの削除

- 52.8 V2のサービス・インスタンス

- 52.8.1 V2でサービス・インスタンスに対してサポートされるメソッド

- 52.8.2 V2のサービス・インスタンスREST APIの例

- 52.8.2.1 V2のサービス・インスタンス・リソースの詳細の表示

- 52.8.2.2 V2のサービス・インスタンス・リソースの問合せ

- 52.8.2.3 V2でのサービス・インスタンスの詳細の表示

- 52.8.2.4 V2でのサービス・インスタンスの属性の詳細の表示

- 52.8.2.5 V2でのサービス・インスタンスに対して使用可能なアクションの詳細の表示

- 52.8.2.6 V2でサービス・インスタンスに対してアクションを実行するために必要なアクションの入力の詳細の表示

- 52.8.2.7 V2でのサービス・インスタンスに対するアクションの実行

- 52.8.3 V2でのサービス・インスタンスに対するアクションの実行

- 52.9 V2の割当て制限使用量

- 52.9.1 V2の割当て制限使用量でサポートされる操作

- 52.9.2 V2の割当て制限使用量REST APIの例

- 52.9.2.1 割当て制限使用量の詳細の表示

- 52.9.2.2 サービス・ファミリ別の割当て制限使用量の詳細の表示

- 52.10 V2のユーザー・プリファレンス

- 52.10.1 V2のユーザー・プリファレンス・リソースでサポートされるリクエスト・メソッド

- 52.10.2 V2のユーザー・プリファレンスREST APIの例

- 52.10.2.1 V2のユーザー・プリファレンス・リソースの詳細の表示

- 52.10.2.2 V2の一般ユーザー・プリファレンス・リソースの詳細の表示

- 52.10.2.3 V2の一般ユーザー・プリファレンス・リソースのメタデータの表示

- 52.10.2.4 V2の一般ユーザー・プリファレンスの更新

- 52.10.2.5 V2のサービス・ユーザー・プリファレンス・リソースの詳細の表示

- 52.10.2.6 V2のサービス・ファミリ・ユーザー・プリファレンス・リソースの詳細の表示

- 52.10.2.7 V2のサービス・ファミリ・ユーザー・プリファレンスのメタデータの表示

- 52.10.2.8 V2のサービス・ファミリ・ユーザー・プリファレンスの更新

- 52.10.2.9 V2のサービス・タイプ・ユーザー・プリファレンス・リソースの詳細の表示

- 52.10.2.10 V2のサービス・タイプ・ユーザー・プリファレンスのメタデータの表示

- 52.10.2.11 V2のサービス・タイプ・ユーザー・プリファレンスの更新

- 52.11 V1のユーザー・プリファレンス

- 52.11.1 V1のマイ・プリファレンス

- 52.11.2 V1の正規のリンク

- 52.11.3 V1の一般プリファレンス

- 52.12 V1のコンポジット・リソース属性

- 52.12.1 V1のRequestEntityデータ・モデル

- 52.12.2 V1のInstanceExpiryEntityデータ・モデル

- 52.12.3 V1のQuotaEntityデータ・モデル

- 52.13 一般プリファレンスに対してサポートされるメソッド(V1の場合)

- 52.13.1 SSAユーザーの一般プリファレンスの詳細の表示

- 52.13.2 SSAユーザーの一般プリファレンスの更新

- 52.14 V1のサービス固有のユーザー・プリファレンス

- 52.14.1 V1のサービス・プリファレンス

- 52.14.2 マイ・プリファレンスに対してサポートされるメソッド(V1の場合)

- 52.14.3 V1のServicePreferenceMetadataデータ・モデル

- 52.14.4 V1のコンポジット・リソース属性

- 52.14.4.1 V1のValueEntityデータ・モデル

- 52.14.4.2 V1のEntityValueHolderデータ・モデル

- 52.14.4.3 V1のValueDescriptorデータ・モデル

- 52.14.5 V1のサービス・プリファレンスREST APIの例

- 52.14.5.1 サービス・プリファレンス・リソースの詳細の表示

- 52.14.6 V1のマイ・データベース・プリファレンスREST APIの例

- 52.14.6.1 DBaaSユーザー・プリファレンス・メタデータの詳細の表示

- 52.14.6.2 DBaaSユーザー・プリファレンスの更新

- 52.14.6.3 空白のDBaaSユーザー・プリファレンス設定の設定

- 52.14.6.4 DBaaSユーザー・プリファレンスの表示

- 52.14.7 V1のマイ・ミドルウェア・プリファレンスREST APIの例

- 52.14.7.1 MWaaSユーザー・プリファレンス・メタデータの表示

- 52.14.7.2 MWaaSユーザー・プリファレンスの更新

- 52.14.7.3 空白のMWaaSユーザー・プリファレンス設定の設定

- 52.14.7.4 MWaaSユーザー・プリファレンス設定の表示

- 52.14.8 V1のマイ・テスト・プリファレンス

- 52.14.8.1 TaaSユーザー・プリファレンス・メタデータの表示

- 52.14.8.2 TaaSユーザー・プリファレンスの更新

53 WebLogic as a Service REST API

- 53.1 V2のWebLogic as a Service REST APIのサマリー

- 53.2 V1のWebLogic as a Service REST APIのサマリー

- 53.3 V2のリソース・プロバイダ - PaaSインフラストラクチャ・ゾーンとミドルウェア・プール

- 53.3.1 リソース・プロバイダ - PaaSインフラストラクチャ・ゾーンとミドルウェア・プールREST APIの例

- 53.3.1.1 すべてのリソース・プロバイダの詳細の表示

- 53.3.1.2 PaaSインフラストラクチャ・ゾーンの作成

- 53.3.1.3 ミドルウェア・プールの作成

- 53.3.1.4 PaaSインフラストラクチャ・ゾーンの更新

- 53.3.1.5 ミドルウェア・プールの更新

- 53.3.1.6 リソース・プロバイダの削除(PaaSインフラストラクチャ・ゾーンまたはミドルウェア・プール)

- 53.4 V2の割当て制限

- 53.4.1 割当て制限REST APIの例

- 53.4.1.1 割当て制限設定の詳細の表示

- 53.4.1.2 SSAユーザー・ロールの割当て制限の作成

- 53.4.1.3 SSAユーザー・ロールの割当て制限の更新

- 53.4.1.4 SSAユーザー・ロールの割当て制限の削除

- 53.5 V2のサービス・テンプレート

- 53.5.1 サービス・テンプレートREST APIの例

- 53.5.1.1 すべてのサービス・テンプレートの詳細の表示

- 53.5.1.2 特定のサービス・テンプレートの詳細の表示

- 53.5.1.3 サービス・テンプレートの削除

- 53.6 V2のロード・バランサ構成群

- 53.6.1 V2のロード・バランサ構成

- 53.6.2 ロード・バランサ構成REST APIの例

- 53.6.2.1 すべてのロード・バランサ構成の表示

- 53.6.2.2 特定のロード・バランサ構成の詳細の表示

- 53.6.2.3 ロード・バランサ構成の作成

- 53.6.2.4 ロード・バランサ構成の更新

- 53.6.2.5 ロード・バランサ構成の削除

- 53.7 V2のサービス・インスタンス・アクション

- 53.8 V2のユーザー操作REST APIの例

- 53.8.1 すべてのサービス・テンプレートの詳細の表示

- 53.8.2 すべてのサービス・インスタンスの詳細の表示

- 53.8.3 UPステータスのすべてのサービス・インスタンスの表示

- 53.8.4 サービス・インスタンス・リクエストの作成

- 53.8.5 特定のサービス・インスタンスで可能なすべてのアクションの詳細の表示

- 53.8.6 サービス・インスタンスのスケール・アップ

- 53.8.7 サービス・インスタンスのスケール・ダウン

- 53.8.8 サービス・インスタンスの停止

- 53.8.9 サービス・インスタンスの起動

- 53.8.10 サービス・インスタンスの削除

- 53.8.11 ソフトウェア・ライブラリからのJava EEアプリケーション・コンポーネントの詳細の表示

- 53.8.12 アプリケーションのデプロイ

- 53.8.13 アプリケーションの再デプロイ

- 53.8.14 アプリケーションのアンデプロイ

- 53.8.15 アプリケーションの停止

- 53.8.16 アプリケーションの起動

- 53.8.17 ドメインにデプロイされたすべてのアプリケーションの詳細の表示

- 53.8.18 アプリケーションURLの表示

- 53.8.19 ドメインにデプロイされたライブラリの詳細の表示

- 53.8.20 WebLogicコンソールURLの表示

- 53.8.21 データ・ソースの作成

- 53.8.22 データ・ソースの編集

- 53.8.23 データソースの削除

- 53.8.24 すべてのデータソースの詳細の表示

- 53.8.25 データソースのテスト

- 53.9 V1のWebLogic as a Serviceのリソース・モデル

- 53.9.1 クラウド

- 53.9.1.1 クラウド・リソースの詳細の表示

- 53.9.2 JaaSサービス・ファミリ・タイプ

- 53.9.2.1 JaaSサービス・ファミリ・タイプ・リソースの詳細の表示

- 53.9.2.2 Jaasサービス・ファミリ・タイプ・リソースへのPOSTリクエスト渡しによるアプリケーション・インスタンス・コンポーネントの作成

- 53.9.3 ゾーン

- 53.9.3.1 ゾーン・リソースの詳細の表示

- 53.9.4 JavaPlatformTemplate

- 53.9.4.1 Javaプラットフォーム・テンプレート・リソースの詳細の表示

- 53.9.4.2 Javaプラットフォーム・テンプレートへのPOSTリクエスト渡しによるJavaプラットフォーム・インスタンスの作成

- 53.9.4.3 Javaプラットフォーム・リクエスト・リソースの詳細の表示

- 53.9.5 Javaプラットフォーム・インスタンス

- 53.9.5.1 Javaプラットフォーム・インスタンス・リソースの詳細の表示

- 53.9.5.2 Javaプラットフォーム・インスタンスへのDELETEリクエスト渡しによるサービス・インスタンスの削除

- 53.9.5.3 DELETEリクエストのステータスの表示

- 53.9.5.4 Javaプラットフォーム・インスタンスへのPOSTリクエスト渡しによるアプリケーション・インスタンス・デプロイメントの作成

- 53.9.5.5 アプリケーション・インスタンス・デプロイメント作成リクエストのステータスの表示

- 53.9.5.6 Javaプラットフォーム・インスタンス・リソースへのPOSTリクエスト渡しによるデータソースの作成

- 53.9.5.7 データソース作成リクエストのステータスの表示

- 53.9.5.8 サービス・インスタンスのスケール・アップ/スケール・ダウン

- 53.9.6 アプリケーション・インスタンス・デプロイメント

- 53.9.6.1 アプリケーション・インスタンス・デプロイメント・リソースの詳細の表示

- 53.9.6.2 アプリケーション・インスタンス・デプロイメントの削除

- 53.9.6.3 アプリケーション・インスタンス・デプロイメント削除リクエストのステータスの表示

- 53.9.6.4 アプリケーション・インスタンス・デプロイメントの起動、停止および再デプロイ

- 53.9.7 DataSource

- 53.9.7.1 データソース・リソースの詳細の表示

- 53.9.7.2 データソースの削除

- 53.9.7.3 データソース削除リクエストのステータスの表示

- 53.9.7.4 データソースの更新

- 53.9.7.5 データソース・リクエストのステータスの表示

- 53.9.8 アプリケーション・インスタンス・コンポーネント

- 53.9.8.1 アプリケーション・インスタンス・コンポーネント・リソースの詳細の表示

- 53.9.8.2 アプリケーション・インスタンス・コンポーネントの削除

- 53.10 V1のアプリケーション・コンポーネントのフィルタ処理

- 53.10.1 サービス・テンプレートのフィルタ処理

- 53.10.2 ゾーンのフィルタ処理

- 53.11 V1のロード・バランサ構成

- 53.11.1 ロード・バランサ構成REST APIの例

- 53.11.1.1 ロード・バランサ構成リソースの詳細の表示

- 53.11.1.2 指定されたロード・バランサ構成の詳細の表示

- 53.11.1.3 ロード・バランサ構成の編集

- 53.11.1.4 ロード・バランサ構成の追加

- 53.12 V1の割当て制限

- 53.12.1 割当て制限REST APIの例

- 53.12.1.1 すべてのSSAユーザー・ロールに対する割当て制限設定の詳細の表示

- 53.12.1.2 SSAユーザー・ロールの割当て制限設定の作成

- 53.12.1.3 SSAユーザー・ロールの割当て制限設定の編集

- 53.12.1.4 SSAユーザー・ロールの割当て制限設定の削除

- 53.13 V1のサービス・テンプレート群

- 53.13.1 サービス・テンプレートの作成

- 53.14 V1のユーザー操作REST APIの例

- 53.14.1 サービス・インスタンスの起動および停止

- 53.14.2 サービス・インスタンスの再スケジュール

- 53.14.3 ソフトウェア・ライブラリ内のJava EEアプリケーション・コンポーネントの詳細の表示

- 53.14.4 ライブラリとしてのアプリケーションのデプロイ

- 53.14.4.1 ライブラリとしてのアプリケーションのデプロイ

- 53.14.4.2 ライブラリとしてのアプリケーションの再デプロイ

- 53.14.4.3 ライブラリとしてのアプリケーションのアンデプロイ

- 53.14.5 スケジュールのサポートのためのユーザー操作

- 53.14.5.1 サービス・インスタンスの作成

- 53.14.5.2 サービス・インスタンスのスケール・アップ

- 53.14.5.3 サービス・インスタンスのスケール・ダウン

- 53.14.5.4 サービス・インスタンスの削除

- 53.15 EMCLIによる管理操作のサポート

54 SOAaaSおよびOSBaaS API

- 54.1 PaaSインフラストラクチャ・ゾーンとミドルウェア・プール

- 54.1.1 すべてのリソース・プロバイダの詳細の表示

- 54.1.2 SOA/OSBドメインのPaaSインフラストラクチャ・ゾーンの作成

- 54.1.3 SOA/OSBのミドルウェア・プールの作成

- 54.1.4 PaaSインフラストラクチャ・ゾーンの更新

- 54.1.5 ミドルウェア・プールの更新

- 54.1.6 リソース・プロバイダの削除(PaaSインフラストラクチャ・ゾーンまたはミドルウェア・プール)

- 54.2 割当て制限

- 54.2.1 割当て制限設定の詳細の表示

- 54.2.2 SSAユーザー・ロールの割当て制限の作成

- 54.2.3 SSAユーザー・ロールの割当て制限の更新

- 54.2.4 SSAユーザー・ロールの割当て制限の削除

- 54.3 サービス・テンプレート

- 54.3.1 すべてのサービス・テンプレートの詳細の表示

- 54.3.2 特定のサービス・テンプレートの詳細の表示

- 54.3.3 サービス・テンプレートの削除

- 54.3.4 サービス・テンプレートの作成

- 54.3.4.1 サービス・テンプレート・タイプの表示

- 54.3.4.2 サービス・テンプレート・メタデータ詳細の取得

- 54.3.4.3 リソース・プロバイダの特性の取得

- 54.3.4.4 サービス・テンプレート構成の作成

- 54.3.4.5 これらのレスポンスを使用したサービス・テンプレートの作成

- 54.4 ロード・バランサの構成

- 54.4.1 すべてのロード・バランサ構成リソースの詳細の表示

- 54.4.2 指定されたロード・バランサ構成の詳細の表示

- 54.4.3 ロード・バランサ構成の作成

- 54.4.4 ロード・バランサ構成の編集

- 54.4.5 ロード・バランサ構成の削除

- 54.5 SSAユーザー操作APIの例

- 54.5.1 すべてのサービス・テンプレートの詳細の表示

- 54.5.2 すべてのサービス・インスタンスの詳細の表示

- 54.5.3 UPステータスのすべてのサービス・インスタンスの表示

- 54.5.4 サービス提供メタデータの表示

- 54.5.5 サービス・インスタンス・リクエストの作成

- 54.5.6 サービス・インスタンスのすべてのアクションIDの表示

- 54.5.7 サービス・インスタンスの停止

- 54.5.8 サービス・インスタンスの起動

- 54.5.9 サービス・インスタンスの削除

- 54.5.10 サービス・インスタンスのスケール・アップ

55 ラピッドスタート・クラウド設定

- 55.1 はじめに

- 55.2 キットのインストール

- 55.2.1 OMSホスト

- 55.2.2 他のホスト

- 55.3 キットの内容

- 55.4 前提条件

- 55.4.1 Oracle Management Server

- 55.4.2 EMCLI設定

- 55.4.3 インフラストラクチャの設定

- 55.4.3.1 Pluggable Database as a Service

- 55.4.3.1.1 Database as a Service

- 55.5 ラピッドスタート・キットにより作成されるアーティファクト

- 55.6 ラピッド・キットのモード

- 55.6.1 簡易モード(Exadataのみ)

- 55.6.2 拡張モード(Exadataおよび非Exadata)

- 55.7 クラウド設定入力: 簡易モード

- 55.7.1 Pluggable Database as a Service: 簡易モード

- 55.7.2 Database as a Service: 簡易モード

- 55.7.3 入力カスタマイズ: 簡易モード

- 55.8 クラウド設定入力: 拡張モード

- 55.8.1 カスタム・ユーザーの作成

- 55.8.2 Pluggable Database as a Service: 拡張モード

- 55.8.3 Database as a Service: 拡張モード

- 55.9 コマンドライン・インタフェース

- 55.9.1 使用方法

- 55.9.2 Database as a Service (DBaaS)

- 55.9.3 Pluggable Database as a Service (PDBaaS)

- 55.9.4 クラウド設定の保護

- 55.9.4.1 デフォルト・パスワードの期限切れ

- 55.9.5 新しいパスワードの設定

- 55.10ラピッドスタート・キットのサンプル実行

56 EMCLI動詞によるチャージバックとメータリング

- 56.1 UIと同等のチャージバック操作の実行

- 56.1.1 list_chargeback_entity_types

- 56.1.2 list_chargeback_entities

- 56.1.3 add_chargeback_entity

- 56.1.4 remove_chargeback_entity

- 56.1.5 list_charge_plans

- 56.1.6 assign_charge_plan

- 56.1.7 unassign_charge_plan

- 56.1.8 list_cost_centers

- 56.1.9 assign_cost_center

- 56.1.10 unassign_charge_plan

- 56.2 カスタム・チャージ・アイテムの使用

- 56.2.1 list_charge_item_candidates

- 56.2.2 create_charge_item

- 56.2.3 delete_charge_item

- 56.3 カスタム・チャージ・アイテム動詞の使用例

- 56.3.1 メトリック拡張(PGA)

- 56.3.2 メトリック拡張(Application A Orders)

- 56.3.3 構成拡張

- 56.4 汎用エンティティ・タイプの作成

- 56.5 Enterprise Managerからのメータリング・データの取得

- 56.5.1 get_metering_data

- 56.5.2 データ取得の出力

- 56.5.3 get_metering_dataの例

57 ブループリントの概要

- 57.1 ブループリントの概要

- 57.2 ブループリントの使用

- 57.3 Enterprise Manager Cloudの概念

- 57.4 ブループリントの概念

- 57.5 ブループリントのデプロイ

- 57.6 ブループリントのデプロイメント処理

- 57.7 ブループリントの例

- 57.7.1 ブループリントの構造と基本

- 57.7.1.1 単純なブループリント

- 57.7.1.2 単純なリソース: データベース・サービス・インスタンス

- 57.7.1.3 固有関数

- 57.7.1.4 パラメータを使用する単純なリソース

- 57.7.1.5 Dataセクション(名前付きリテラル)

- 57.7.2 すべてを集約: 複数の独立リソース

- 57.7.2.1 マクロ・セクション

- 57.7.2.2 作成されたリソースの属性(依存関係)

- 57.7.3 ブループリント処理の視覚的表現

- 57.8 結び

58 クラウド・ブループリントおよびブループリントのリファレンス

- 58.1 ブループリント・プロセッサのインストール

- 58.1.1 Linux (Oracle Linux)

- 58.1.1.1 Pythonのインストール

- 58.1.1.2 Zipファイルからのブループリント・プロセッサのインストール

- 58.1.1.3 インストールのテスト

- 58.1.2 Windows

- 58.1.2.1 Pythonのインストール

- 58.1.2.2 Zipファイルからのブループリント・プロセッサのインストール

- 58.1.2.3 インストールのテスト

- 58.2 グラフィカル・サマリー・レポートのオプション・コンポーネント

- 58.3 ブループリント・プロセッサの実行

- 58.4 ブループリントの処理フェーズ

- 58.4.1 初期化

- 58.4.2 入力パラメータの評価

- 58.4.3 リソースの作成

- 58.4.4 出力

- 58.5 言語仕様

- 58.6 ブループリントの内容の概要

- 58.6.1 Inputsセクション

- 58.6.1.1 例1

- 58.6.1.2 例2

- 58.6.1.3 例3

- 58.6.2 Resourcesセクション

- 58.6.3 Outputsセクション

- 58.6.4 Dataセクション

- 58.6.5 Macrosセクション

- 58.6.6 式

- 58.6.6.1 パス式

- 58.6.6.2 演算子の概要

- 58.6.6.3 例: Infoのすべての値の表示

- 58.6.6.4 例: ブループリント値の表示

- 58.6.6.5 例: クラウドの参照

- 58.6.6.6 eval式またはブループリント式

- 58.6.7 固有関数

- 58.6.7.1 評価固有関数

- 58.6.7.1.1 f_path(pathExpr)

- 58.6.7.1.2 例: Dataセクションの値

- 58.6.7.1.3 例2: Inputsセクションの値

- 58.6.7.1.4 例3: クラウド検索によるデフォルトの入力パラメータ値

- 58.6.7.1.5 f_eval(blueprintExpr)

- 58.6.7.1.6 Example (Contrived)

- 58.6.7.2 リソース・アクセス固有関数

- 58.6.7.2.1 f_getResourceAttr(bpResName, pathExpr)

- 58.6.7.2.2 f_getResourceURI(bpResName)

- 58.6.7.3 検索固有関数

- 58.6.7.3.1 f_getTemplateURI(name, type)

- 58.6.7.3.2 f_getZoneURI(name, type)

- 58.6.7.3.3 f_getAppCompURI(name, owner, version) …

- 58.6.7.4 デバッグ固有関数

- 58.6.7.4.1

- 58.6.7.4.2 f_print(expression, [printpointMessage])

- 58.6.7.5 その他の固有関数

- 58.7 エラーの処理

- 58.7.1 YAML構文エラー

- 58.7.2 プロトコル・バージョンの不一致

- 58.7.3 式評価エラー

- 58.7.4 クラウド・リソース作成エラー

- 58.8 シミュレーション・モード

- 58.9 ブループリント・プロセッサを使用したデバッグ

- 58.9.1 中間結果の出力

- 58.9.2 一時停止ポイント

- 58.9.3 ブレークポイント

- 58.9.4 デバッガ・コマンド

- 58.9.4.1 pathコマンド

- 58.9.4.2 continueコマンド

- 58.9.4.3 exitコマンド

- 58.9.4.4 evalコマンド

- 58.10 アドバイスとヒント

- 58.10.1 YAMLの編集: Notepad ++の例

- 58.10.2 YAML重複と名前/値ペア

- 58.10.3 明示的な依存関係

- 58.10.4 ヒント: -Tオプションの使用

- 58.10.5 ヘルプ・フォーラム

59 Infrastructure as a Service REST API

- 59.1 Infrastructure as a Service REST APIのサマリー

- 59.2 Infrastructure as a Serviceのリソース・モデル

- 59.2.1 Infrastructure as a Serviceの変更

- 59.2.2 IaaSゾーン[application/oracle.com.cloud.iaas.Zone]

- 59.2.3 AssemblyInstance[application/oracle.com.cloud.common.AssemblyInstance+json]

- 59.2.4 スケーラビリティ・グループ[application/oracle.com.cloud.common.ScalabilityGroup+json]

- 59.2.5 VM [application/oracle.com.cloud.common.VM+json]

- 59.2.6 VNet [application/oracle.com.cloud.common.VNet+json]

- 59.2.7 NetworkInterface [application/oracle.com.cloud.common.NetworkInterface+json]

- 59.2.8 VMTemplate [application/oracle.com.cloud.common.VMTemplate+json]

- 59.2.9 AssemblyTemplate [application/oracle.com.cloud.common.AssemblyTemplate+json]

- 59.2.10 IaasServiceFamilyType [application/oracle.com.cloud.iaas.IaasServiceFamilyType+json]

- 59.2.11 Iaas割当て定義[application/oracle.com.cloud.iaas.Quota+json]

- 59.3 Infrastructure as a Service REST APIの例

- 59.3.1 サービス・インスタンスの作成

- 59.3.1.1 VMの作成

- 59.3.1.1.1 VMを配置するIaaSゾーンにPOST

- 59.3.1.1.2 VMのベースになるVMテンプレートにPOST

- 59.3.1.2 VM作成ステータスの詳細の表示

- 59.3.1.3 アセンブリ・インスタンスの作成

- 59.3.2 VMサービス・インスタンスの更新

- 59.3.2.1 VMステータスの変更

- 59.3.2.2 VMサイズの変更

- 59.3.2.3 VMディスクの追加

- 59.3.3 サービス・インスタンスの削除

- 59.3.4 サービス・インスタンスのリスト

- 59.3.5 サービス・テンプレートの検索

- 59.4 バージョン1000のサポート

60 Testing as a Service REST API

- 60.1 Testing as a Service REST APIのサマリー

- 60.2 Testing as a Service REST APIの概要

- 60.2.1 Testing as a Service REST APIの使用方法

- 60.2.2 TaaSでのリソース・モデルの使用方法

- 60.3 Testing as a Serviceのリソース・モデル

- 60.3.1 アプリケーション・リソース

- 60.3.2 TestDriverTypeリソース

- 60.3.3 TestDriverリソース

- 60.3.4 QuotaUsageリソース

- 60.3.5 TestAsset

- 60.3.6 OltScenario

- 60.3.7 CustomParameters

- 60.3.8 OFTAssetScriptリソース

- 60.3.9 OftAssetScriptCsvDatabanks

- 60.3.10 OftPlaybackSettingsリソース

- 60.3.11 OftDatabaseDatabanks

- 60.3.12 TestEnvironment

- 60.3.13 テスト

- 60.3.14 試行

- 60.3.15 メトリック

- 60.3.16 MetricValue

- 60.3.17 OltSession

- 60.3.18 OltCounter

- 60.3.19 OltCounterValue

- 60.3.20 OftTrialAssetExecution

- 60.3.21 TestDriverInstance

- 60.3.22 TestEnvironmentInstanceリソース

- 60.3.23 操作

- 60.3.24 TestType

- 60.3.25 ターゲット

- 60.3.26 OltAgent

- 60.4 Testing as a Service REST APIの例

- 60.4.1 すべてのアプリケーションの詳細の表示

- 60.4.2 コンテキストID指定によるアプリケーションの問合せ

- 60.4.3 すべてのテスト・アセットの詳細の表示

- 60.4.4 コンテキストID指定によるテスト・アセットの問合せ

- 60.4.5 すべてのテスト環境の詳細の表示

- 60.4.6 コンテキストID指定によるテスト環境の問合せ

- 60.4.7 すべてのテスト・ドライバの詳細の表示

- 60.4.8 コンテキストID指定によるテスト・ドライバの問合せ

- 60.4.9 コンテキストID指定によるテスト・ドライバ・タイプの問合せ

- 60.4.10 すべてのテスト環境インスタンスの詳細の表示

- 60.4.11 コンテキストID指定によるテスト環境インスタンスの問合せ

- 60.4.12 テスト環境インスタンスの作成

- 60.4.13 テスト環境インスタンスおよびテスト・ドライバ・インスタンス上での操作の実行

- 60.4.14 停止したテスト環境インスタンスの削除

- 60.4.15 すべてのテスト・ドライバ・インスタンスの詳細の表示

- 60.4.16 コンテキストID指定によるテスト・ドライバ・インスタンスの問合せ

- 60.4.17 テスト・ドライバ・インスタンスの作成

- 60.4.18 停止したテスト・ドライバ・インスタンスの削除

- 60.4.19 すべてのテストの詳細の表示

- 60.4.20 コンテキストID指定によるテストの問合せ

- 60.4.21 テストの作成

- 60.4.22 テストの更新

- 60.4.23 テストの削除

- 60.4.24 すべての試行の詳細の表示

- 60.4.25 コンテキストID指定による試行の問合せ

- 60.4.26 新しい試行の作成

- 60.4.27 試行の更新

- 60.4.28 試行の削除

第XVII部 付録

A ユースケース: テスト・データのリフレッシュ

- A.1 テスト・データのリフレッシュにおける課題

- A.2 Enterprise Managerソリューション

- A.3 テスト・マスター・データベースの作成

- A.4 テスト・マスター・データベースのマスクおよびサブセット

- A.5 データベース・クローンのオンデマンド作成

- A.6 シナリオ例の実装

- A.6.1 Enterprise Managerでのロールの割当てと作成

- A.6.1.1 管理者ロールの管理者への割当て

- A.6.1.2 セルフ・サービス・ユーザーへのカスタム・ロールの作成

- A.6.1.3 セルフ・サービス・ユーザーの作成

- A.6.2 本番データベースのバックアップの作成

- A.6.3 マスキングおよびサブセッティング用データの準備

- A.6.3.1 マスキング方法およびサブセッティング方法の計画

- A.6.3.2 アプリケーション・データ・モデル(ADM)の作成

- A.6.3.3 マスキング定義の作成

- A.6.4 ストレージ・サーバーの構成

- A.6.5 ストレージ・ボリューム上のテスト・マスター・データベースの作成

- A.6.6 テスト・マスター・データベースを有効化してスナップ・クローンを使用

- A.6.7 テスト・データのマスキングとサブセッティング

- A.6.7.1 サブセット定義の作成

- A.6.7.2 サブセット・スクリプトの保存と実行

- A.6.8 データベース・クラウド・セルフ・サービス・ポータルの構成

- A.6.8.1 PaaSインフラストラクチャ・ゾーンの作成

- A.6.8.2 データベース・プールの作成

- A.6.8.3 リクエスト設定の構成

- A.6.8.4 ユーザー割当て制限の設定

- A.6.8.5 スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成

- A.6.8.6 サービス・テンプレートの作成

- A.6.9 テストで使用するデータベース・クローンのオンデマンド作成

- A.7 テスト・データの進行中リフレッシュ

索引

はじめに

このマニュアルでは、Oracle Enterprise Manager 12cリリース5でのプライベート・クラウドの設定、および仮想化ターゲットの管理とデプロイの方法について説明します。このはじめにの内容は次のとおりです。

- 対象読者

- サポートされているプラグイン

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

対象読者

このドキュメントは、クラウド・インフラストラクチャの設定および管理を行う管理者を対象としています。クラウド管理者、セルフ・サービス管理者およびセルフ・サービス・ユーザーもその対象です。

サポートされているプラグイン

このマニュアル内の機能は、次のプラグインに関係があります。

注意:
My Oracle Supportノート1549855.1で最新のパッチを確認することをお薦めします。

プラグイン名(My Oracle Support)

プラグイン名(「自己更新」)

バージョン

Enterprise Manager for Oracle Cloud

Oracle Cloud Application

12.1.0.10

Enterprise Manager for Oracle Consolidation Planning and Chargeback
注意: これはオプションのプラグインです。

Oracle Consolidation Planning and Chargeback

12.1.0.7

Enterprise Manager for Oracle Virtualization

Oracle Virtualization

12.1.0.7

Enterprise Manager for Oracle Virtualization Infrastructure

Oracle Virtual Infrastructure

12.1.0.2

注意: Xenベース・システムの直接監視にはOracle Virtual Infrastructureプラグインが必要です。第10項「Xenベース・システムの直接監視」を参照してください。

Enterprise Manager for Oracle Cloud Framework

Oracle Cloud Framework

12.1.0.3

Enterprise Manager for Oracle Database

Oracle Database

12.1.0.8

Enterprise Manager for Storage Management
注意: これはオプションのプラグインです。

Oracleストレージ管理フレームワーク

12.1.0.6

Enterprise Manager for Oracle Fusion Middleware

Oracle Fusion Middleware

12.1.0.8

注意:
最新の更新を使用するには、すべてのプラグインを表にリストされているバージョンにアップグレードする必要があります。たとえば、Oracle Databaseプラグインを12.1.0.7から12.1.0.8にアップグレードする場合は、Oracle Cloud Applicationプラグインを12.1.0.9から12.1.0.10にアップグレードする必要があります。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポート・サービスへのアクセス

My Oracle Supportを介してサポートを購入したオラクル社のお客様。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs(聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、Enterprise Managerドキュメント・セットの次のドキュメントを参照してください。

- 『Oracle Enterprise Manager Cloud Control概要』

- 『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイド』

- 『Oracle Enterprise Manager Cloud Controlアドバンスト・インストレーションおよび構成ガイド』

- 『Oracle Enterprise Manager Cloud Control管理者ガイド』

これらのドキュメントやその他のオラクル社のドキュメントの最新リリースについては、Oracle Technology Networkの次のページを確認してください。

http://www.oracle.com/technetwork/documentation/index.html#em

Oracle Enterprise Managerには詳細なオンライン・ヘルプも用意されています。Enterprise Managerのページの一番上にある「ヘルプ」をクリックすると、オンライン・ヘルプ・ウィンドウが表示されます。

表記規則

このマニュアルでは、次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interfaceの要素、または用語集に記載されている用語を示します。

イタリック体

イタリック体は、特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、ユーザー名、画面に表示されるテキスト、または入力するテキストを示します。

1 このガイドの最新情報

追加されたソフトウェア・リリースまたはパッチ・セット・リリースに関するマニュアルの更新に加え、不具合の修正、顧客、プロダクトマネージャ、サポート・チームその他重要なステーク・ホルダーからの貴重なフィードバックを盛り込むため、マニュアルを定期的に更新しています。マニュアルが改訂されるたびにリビジョン番号を1ずつ上げ、Oracle Technology Network (OTN)上に公開されます。この章には、『Oracle Enterprise Manager Cloud管理ガイド』(このマニュアル)の最新の改訂版および以前のすべての改訂版に盛り込まれている変更点を示します。最新のリビジョンとはOTNに公開されている現在のリビジョンであり、最新のリビジョンには以前のリビジョンで反映されたすべての変更が常に含まれていることに留意してください。

最後の改訂の後、次の変更が行われています。

- サービス・テンプレート群REST APIが、新しい(V2)フレームワークに移動し、その結果、変更が発生しています。また、例が新しく追加および更新されています。第48.3.5.3項「サービス・テンプレート群REST APIおよびサービス・テンプレートREST APIの例」を参照してください。

- PaaSゾーン群およびPaaSゾーン・リソースが、新しい(V2)フレームワークに移動しました。その結果、データ・モデルおよびREST APIが変更されています。第48.3.1項「PaaSゾーン群REST APIおよびPaaSゾーンREST API」を参照してください。

- 第XV部「クラウドAPIの使用」の章の配置が変更されました。第XVI部「クラウドAPIの使用」を参照してください。

- DBaaSソフトウェア・プールに、新しくREST APIが追加されました。第48.3.2.3項「ソフトウェア・プールREST APIの例」を参照してください。

- REST APIを使用して、カスタム・データベース配置オプションがサポートされています。第50.8項「REST APIを使用したカスタム・データベース配置オプションの構成」を参照してください。

- Database as a Service管理者用のEM CLI動詞の章が更新されました。第47章「Database as a Service管理者用のEM CLI動詞」を参照してください。

第I部

クラウド管理の概要

この項では、Oracle Cloudで提供される内容を紹介し、使用可能な各種のCloudサービス・モデルについて説明します。

内容は次のとおりです。

- 第2章「クラウド管理 - 概要」

2 クラウド管理 - 概要

この章では、クラウド管理およびOracle Cloudプラットフォームが提供する各種のサービスやコンポーネントの概要を説明します。また、クラウド要件を計画する際に便利な統合プランナ、およびリソース管理、メータリング、チャージバック・サポートなどのOracle Enterprise Managerの様々なライフ・サイクル管理機能についても説明します。

この章の内容は次のとおりです。

- クラウド管理の概要

- Enterprise Managerによるクラウド管理ライフサイクルの管理

- Oracle Cloudサービス・モデルの概要

- Oracle Cloud機能へのアクセス

2.1 クラウド管理の概要

企業およびクラウド・サービス・プロバイダは、Oracle Enterprise Managerを使用してクラウド・サービスを構築し、運用できます。Enterprise Managerによって提供される機能はクラウドのライフ・サイクル全体に渡り、どのようなタイプのクラウド・サービスでも、その設定および管理が可能です。

企業は、増大するビジネス上の需要を満たすために、数百あるいは数千にものぼるアプリケーションをサポートする必要があります。この増大により、サーバーおよびストレージの取得と管理のコストは跳ね上がりました。クラウドにより、お客様は、サーバー、ストレージおよびデータベースのワークロードを共有ハードウェアおよびソフトウェアのインフラストラクチャに統合できます。

セルフ・サービス、伸縮自在の拡張性および従量制によるサーバーやストレージへのオンデマンド・アクセスの提供により、Enterprise Managerでは次の利点を提供します。

- サービスのクオリティの向上: IT組織は、コストを削減しようとするだけではなく、それと同時にサービスのクオリティの向上、パフォーマンス、機能およびセキュリティという観点からソリューションを考えています。クラウドのコンシューマは、クラウドに内在する高可用性という特性そのものから利益を得ます。
組織は、標準化されたプロビジョニングの一環として、統合された個人情報およびセキュリティのインフラストラクチャを実現できます。これらのポリシーおよびコンプライアンス規定は、後から追加されたようなセキュリティ・ポリシーではなく、プロビジョニング・プロセスの一環です。

- より迅速なデプロイメントが可能: 標準的なビルディング・ブロック・コンポーネント(たとえば、サーバー、CPU、ストレージ、ネットワーク)、標準的な構成およびツールを使用したクラウド・インフラストラクチャの構築により、合理化され、自動化された簡素なデプロイメント・プロセスが可能になります。

- リソースの伸縮性の提供: 記憶域サイズおよび計算能力という2つの面で、データベースの許容量を拡大および縮小する機能により、アプリケーションは本質的に絶えず変化するビジネスのワークロードに合せる柔軟性を持つことができます。

- 迅速なプロビジョニング: クラウド内のデータベースは迅速にプロビジョニングでき(多くの場合はセルフ・サービス・インフラストラクチャを介して)、機敏なアプリケーションのデプロイメントが可能になります。これにより、本番アプリケーションのデプロイメント、プラットフォームのデプロイメントまたはテスト・ベッド構成の作成にかかる全体の時間を削減できます。

2.2 Enterprise Managerによるクラウド管理ライフサイクルの管理

Enterprise Managerには次のような機能があり、クラウドのライフサイクルの全体を管理できます。

- 計画

- クラウドの設定

- クラウドの構築

- サービスのテストおよびデプロイ

- クラウドの監視および管理

- メータリングとチャージ、最適化

図2-1 クラウドのライフサイクル

2.2.1 計画

Enterprise Managerを使用すれば、既存のデータ・センターをクラウド環境に変換できます。クラウドを設定する前に、物理および仮想ネットワーク、ストレージ・アレイ、アプリケーションなどのインフラストラクチャの要件の計画を立てる必要があります。

Enterprise Managerの統合プランナは、管理者がクラウドのアーキテクチャを計画するのに役立つ強力なツールです。これにより、ソースと宛先のターゲットを識別し、アプリケーションをどこに配置するかなど、適用可能な技術、および機能的な制約を判断できます。物理から仮想(P2V)、物理から物理(P2P)、物理からExadataといった移行計画を含む統合アドバイザを生成できます。統合プランナはまた、Database-as-a-Service(DBaaS)を設定するときに役立つ、データベースの統合プランの確認にも使用できます。詳細は、第44章「統合プランナの使用」を参照してください。

2.2.2 クラウドの設定

Enterprise Managerは、Infrastructure-as-a-Service (IaaS)、Database-as-a-Service (DBaaS)およびMiddleware-as-a-Service (MWaaS)モデルのクラウドに使用できます。ユーザーや組織の必要に合った適切なクラウド・サービス・モデル(第2.3項「Oracle Cloudサービス・モデルの概要」を参照)を選択することが重要です。クラウドの設定を容易にするために、Enterprise Managerでは、物理および仮想の両方のインフラストラクチャ用の機能を提供しています。

物理インフラストラクチャの場合、Enterprise Managerでは、基本的なデプロイメント・プロシージャ、ジョブ・システムおよびエンタープライズ・ソフトウェア・ライブラリの自動化フレームワークを活用します。データベースとミドルウェアの両方に事前に必要なソフトウェアをプロビジョニングするために、即時利用可能なデプロイメント・プロシージャが用意されています。同じ自動化フレームワークは、データ・クローニングとストレージ管理の目的で、サード・パーティのストレージ・システムとの対話にも使用されます。仮想インフラストラクチャの場合は、ハイパーバイザーのベアメタル・プロビジョニングと、サーバーおよびストレージのプール設定を提供します。完了すると、これらすべてを機能やQoS特性に基づくゾーンに分類できます。Enterprise Managerでは仮想化ストレージ接続テクノロジを活用し、クラウド設定プロセスをNetapp、日立、富士通などのストレージ・テクノロジと統合します。管理者は、データベースおよびミドルウェア・プラットフォーム用に標準化されたサービス・テンプレートを定義して、これらをサービスとして公開できます。これらのサービスは、単一階層のテンプレートまたは複合的な多階層のエンタープライズ・プラットフォームとして表現されます。

Enterprise Managerは、アセンブリと呼ばれるコンポーネントを使用します。これらのアセンブリは、多階層プラットフォームをEnterprise Managerクラウド・サービスでデプロイ可能な単一のメタデータにパッケージ化するのに役立ちます。アセンブリは、基本的に完全な複数層アプリケーション・スタックで、データベース、アプリケーション・サーバー、その他のミドルウェア・コンポーネントが含まれ、単一のダウンロード可能なエンティティとしてパッケージ化されます。アセンブリをデプロイすると、アプリケーション・スタックの各層を表す一連の関連仮想マシンが作成されます。

アセンブリを使用し、プラットフォームのアーキテクトは、プラットフォーム全体のトポロジをグラフィカルにモデル化し、すべての依存関係およびデプロイメント制約を定義し、すべてのスタックをアセンブリの形態で配信できます。このアセンブリは、Enterprise Managerで集中管理されるソフトウェア・ライブラリに公開され、迅速にプロビジョニング可能なアプリケーション開発スタック全体であるクラウド・サービスとして、開発者が使用できるようになります。管理者は、ビジネス・ニーズに応じて、様々なタイプのサービスを作成できます。たとえば、管理者は、異なるバージョンのOracleデータベースに基づくデータベース・サービスを提供し、その中の1つに対してビジネスでの使用を承認します。

Enterprise Managerは、ロール型のアクセス制御をサポートします。リソース制限、すなわち割当て制限が、サービスへのアクセスを制御するためにロールに割り当てられます。これはサービスの不正な使用を防ぎ、その一方で少数のユーザーがクラウドのリソースの大部分を使用することを防ぎます。LDAPとの統合により、Enterprise Managerでエンタープライズ・ロールの継承が可能です。

2.2.3 クラウドの構築

Enterprise Managerでは、アプリケーションまたはコンポーネントの全体をパッケージ化し、サービスとしてクラウドに公開できます。これは、組織内におけるアプリケーションの開発およびプロビジョニングのプロセスを促進します。

開発者は、ユーティリティ・コンポーネントおよびアプリケーションを、グループ内で再利用可能なアセンブリおよびサービス・テンプレートという形態で公開できます。同様に、アプリケーションをアセンブリとして使用可能とすることで、テスト・チーム、ビジネス解析または製品チームは、数クリックの操作で事前作成アプリケーションをデプロイできます。

2.2.4 サービスのテストおよびデプロイ

アプリケーションを構築したら、テストが必要です。Enterprise Managerでは、アプリケーションの変更とデータベースの変更の両方をテストできる、テスト用のポートフォリオが提供されます。このテスト・ソリューションにより、テスト環境で製品のロードおよびリプレイを取得でき、結果が予測可能となります。テスト・ソリューションではまた、テクノロジ・レイヤーに埋め込まれた診断機能の利用により、改善のための処方箋が提供されます。Enterprise Managerでは、エンドユーザーがサービスをデプロイできるセルフ・サービス・アプリケーションが提供されます。このセルフ・サービス・アプリケーションもまたカスタマイズできます。エンド・ユーザーは、データベースおよびプラットフォームとともに、プロビジョニングするアプリケーション・アセンブリをオンデマンドで選択できます。リクエストごとに、それぞれのコンポーネントが必要とするCPU、メモリーなどの基礎となるリソースの量を指定できます。Enterprise Managerでは、リクエストされたサービスおよび適切なリソースが自動的にプロビジョニングされます。セルフ・サービス・アプリケーションでもまた、ユーザーは、スケジュールまたはパフォーマンス・メトリックに基づいて、リソースのスケール・アウトまたはスケール・バックのポリシーを定義できます。たとえば、既存Webサーバーのプロセッサ・ロードが一定のしきい値を超えた場合に、伸縮自在にWebサーバーをスケール・アウトするポリシーを設定できます。

2.2.5 クラウドの監視および管理

Enterprise Mangerには、多数の固有の監視および管理機能があり、これが集合的にクラウド全体の管理システムを構成しています。

たとえば、Enterprise Managerには、ターゲットをグループに照合し、管理を容易にする機能があります。この管理グループ機能により、管理者は、テンプレートを介して監視設定、コンプライアンス標準およびクラウド・ポリシーを定義でき、また、それぞれのターゲットをライン・オブ・ビジネス、ライフサイクルのステータスといった複数の階層に組織化できます。これにより、監視フレームワークは、クラウド内の何千ものサーバー、データベースおよびミドルウェア・ターゲットを対象にできます。

Enterprise Managerに組み込まれたインシデント管理システムにより、クラウドでパフォーマンスに影響を与える可能性のある複雑な操作上の問題を監視できます。必要に応じて、発生するイベントの確認、抑止、エスカレート、処置ができ、インシデントのエスカレーションを既存のサポート・チケット発行システムにも統合できます。詳細は、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。契約上のサービス・レベル合意(SLA)は、アプリケーションの所有者とクラウドのプロバイダ間の契約を管理するように定義できます。管理者は、ユーザーと同様、サービスのリソースがSLAに合致することを保証するように自動的に調整されるような管理ポリシーを定義できます。

Enterprise Managerの構成管理機能は、クラウド環境用に最適化されています。たとえば、Enterprise Managerでは、膨大な数の構成を継続的に監視することで、変更を発見し、変化を測定し、構成エラーの箇所を特定して、システムのトポロジについて見通すことが、すべて1つのコンソールでできます。Enterprise Managerのクラウド管理機能は、My Oracle Supportとも統合されています。この統合により、クラウド全体の場所や文脈に即応したパッチ・アドバイザ、サービス・リクエスト管理、ナレッジ管理などの機能が提供されます。

Enterprise Manager Cloud Controlユーザー・インタフェースで提供されるIaaS、DBaaSおよびMWaaSのホームページで、クラウド管理者は、リクエストのサマリー・ビューおよびゾーン、プール、サーバー、サービス・インスタンス、データベースなどのサービスの全体的な状態を取得できます。

2.2.6 メータリングとチャージ、最適化

Enterprise Managerのメータリングおよびチャージバック機能により、企業は実際の使用状況と代表的な使用状況との対比を明らかにできます。管理者はまた、固定コスト、構成、管理費、人件費、エネルギ消費、またはこれらの組合せの明細を明らかにするように価格モデルを拡張できます。クラウド管理では、サービス・レベルが永続的であることを保証するために、リソースおよびプロセスの持続的な最適化も必要です。Enterprise Managerでは、管理者およびアプリケーション・ユーザーに対し、資産の再発見、パフォーマンスの再評価、クラウドのリバランス、プロビジョニング・プロセスのチューニングに役立つ機能が提供されます。チャージバックでは、CPU、メモリー、ストレージの使用状況などの基本メトリックをサポートしています。また、アプリケーションの使用状況、データベースの使用状況およびミドルウェアレベルのメトリックに基づく価格モデルも提供します。

2.3 Oracle Cloudサービス・モデルの概要

この項では、使用可能なOracle Cloudサービス・モデルについて説明します。

- Oracle Cloudサービス・モデル

- Oracle Cloudの構造

- IaaSコンポーネント

- DBaaSおよびMWaaSコンポーネント

- TaaSコンポーネント

2.3.1 Oracle Cloudサービス・モデル

OracleのCloudサービス・モデルは、次の2つの主要カテゴリに分類できます。Infrastructure as a Serviceは、ユーザーがアプリケーションの実行に必要な物理インフラストラクチャをリクエストできるようにします。Platform as a Serviceは、アプリケーションで必要なデータベースおよびミドルウェアのコンポーネントを提供します。

- Infrastructure as a Service (IaaS)サービス・モデル: IaaSモデルでは、ユーザーは、ゲスト仮想マシン(ゲストVM)として作成されるサーバーをリクエストします。
IaaSモデルでユーザーは、Enterprise Managerのセルフ・サービス・ポータルを使用してゲストVMをリクエストできます。またユーザーは、リクエストしたゲストVMにデプロイするアセンブリまたはテンプレートを指定できます。オペレーティング・システム、データベース・ソフトウェアおよびミドルウェア・ソフトウェアで構成される事前パッケージ済のアセンブリがあり、プラットフォームはこのサービスを使用してデプロイされます。

ユーザーは、セルフ・サービス・ポータルを使用し、提供されるサービスを監視でき、許可されている管理操作を実行できます。また、チャージバック・レポートを実行して、リソースの使用状況と、消費リソースに対して計算されたチャージバックの額を確認できます。

IaaSクラウド・インフラストラクチャは、Oracle VM、Oracle Solaris、Oracle Enterprise LinuxなどのOracleのハードウェアおよびソフトウェア・コンポーネントで構築でき、サード・パーティのコンポーネントを使用することもできます。

- Platform as a Service (PaaS)サービス・モデル: PaaSモデルでは、コンシューマが独自のアプリケーションをデプロイできるプラットフォームを作成できます。プラットフォーム・リソースは通常、ホスト、オペレーティング・システム、Oracle WebLogic Applicationサーバーで構成され、これらはすべて仮想化できます。OracleデータベースまたはRACクラスタを含めることもできます。
PaaSで使用可能なモデルには、次のものがあります。

- Database as a Service (DBaaS)サービス・モデル: このモデルでユーザーは、セルフ・サービス・ポータルを介して、データベース・サービス(1のインスタンスまたはRAC)をリクエストできます。DBaaSは次のようなオプションで実装されます。

- 仮想マシン・ベース: データベースは仮想アセンブリまたはテンプレートの一部としてデプロイされ、それぞれの仮想マシンは同じ物理サーバーを共有します。これにより、最大レベルの独立性(オペレーティング・システム・レベル)が提供されます。

- 共有クラスタ: データベースは既存のクラスタウェアにデプロイされます。通常、グリッド・インフラストラクチャ(Oracle Clusterware、ASM)およびデータベース・ソフトウェアは、あらかじめインストールされます。クラウド・サービスは、基本的にそのインフラストラクチャの上にデプロイされるデータベースで構成されます。

- 共有インストール: データベースは、既存のデータベース・インストール上にシングル・インスタンスのデータベースとしてデプロイされます。

- Pluggable Database as a Service: プラガブル・データベースがデプロイされます。このモデルでは、高度な統合が提供され、管理とメンテナンスのオーバーヘッドは最小化されます。

- スナップ・クローン: データベースのコピー・オン・ライト・テクノロジを使用して、シン・クローンを作成できます。このモデルでは、最小限の領域で即座にクローニングが実行されるため、機能テストに最適です。

- フル・クローン: データベースの全体コピーを作成できます。このモデルは、重要なデータ更新のあるロード・テストに最適です。

- 共有データベース(Schema as a Service): データベース・サービスは、既存のデータベース上のスキーマ・デプロイメントです。データベースのそれぞれのコンシューマは、データベースにアクセスしてそれぞれが異なるサービスを使用するものと想定し、そのメータリングおよびチャージバックを目的とします。このサービス・モデルは、Schema as a Serviceとも呼ばれます。

IaaSと同様に、ユーザーは、データベースの起動/停止、バックアップおよびリカバリなどの一部の管理タスクを実行できます。セルフ・サービス・ユーザーは、チャージバック・レポートも使用可能です。

- Middleware as a Service (MWaaS): このモデルでユーザーは、ミドルウェア・ドメイン作成のリクエストを送信します。アプリケーションは、その後これらのドメインにデプロイできます。MWaaSは、次の選択により実装されます。

- 物理プロビジョニング・ベース: MWaaSプラットフォームは物理ホストおよびFusion Middlewareプロビジョニングを使用して構築されます。

- サービスとしてテスト: このモデルでは、クラウド・テスト・セルフ・サービス・ポータルにより、高速および容易にテストを実行できます。テスト中のアプリケーションを、アセンブリを使用してプライベート・クラウドに、または既存のEnterprise Managerターゲットにプロビジョニングできます。TestDriverをプライベート・クラウドにプロビジョニングする必要があります。

2.3.2 Oracle Cloudの構造

Oracleの実装では、クラウドは論理ゾーンで構成されます。ゾーンは論理プールから構成され、プールはホスト上のターゲットから構成されます。

IaaSゾーン内の論理プールは、1つ以上のOracle VM Serverとそれらの関連ストレージ・リソースの集合です。DBaaSゾーン内のプールは、同じプラットフォームとバージョン(Oracle Linux 6 x86-64上のOracle Database 11.2.0.3 RACなど)の1つ以上のOracle Databaseホーム(データベース・リクエストに使用)またはデータベース(スキーマ・リクエストに使用)、または同じプラットフォームとバージョン(Linux x86-64上のOracle Database 11.2.0.2など)のOracle Middlewareホームの集合です。

IaaSまたはPaaSのいずれでも、セルフ・サービスのユーザーは、カタログ・テンプレートからゾーン・レベルでリソースをリクエストします。次に、Enterprise Managerでは、リクエストを満たすために、選択されたゾーンのどのプールが使用できるかを決定します。必要とされるEnterprise Managerのジョブは、選択されたプール内の1つ以上のホストで開始され、リクエストを満たすために必要なエンティティを作成します。

IaaSクラウドでは、セルフ・サービスのユーザーがサーバーの作成をリクエストします。これらは実際にはゲスト仮想マシン(ゲストVM)です。1つのIaaSリクエストの結果、データベース、ミドルウェア・ソフトウェアおよびデプロイ済のアプリケーションを備えた1つ以上の仮想マシンが作成されます。

PaaSクラウドのDBaaSビューでは、セルフ・サービス・ユーザーが、新規データベースまたは既存データベースのスキーマの作成をリクエストできます。データベースは、ユーザーがアクセスするゾーンやカタログ・テンプレートに応じて、1つのインスタンスまたはRACになります。同様に、PaaSクラウドのMWaaSビューでは、セルフ・サービスのユーザーが、ミドルウェア・ドメインの作成をリクエストします。

図2-2に、クラウドの構造を示します。

図2-2 クラウドの構造

2.3.3 IaaSコンポーネント

IaaSクラウド・モデルは、次のコンポーネントで構成されています。

- クラウド: クラウドは、クラウド・コントローラによるプログラム的な制御およびクラウド管理者による管理の下にある、ストレージ・プール、サーバー・プール、ゾーンのセットです。クラウド管理者はコスト・センター管理者と協力して働き、コスト・センター管理者は、クラウドのリソース割当てを決定し、必要なチャージバック・ポリシーを決定することがその仕事です。

- ゾーン: クラウドは、1つ以上のゾーンで構成されます。ゾーンは、セルフ・サービスのプロビジョニングおよび管理を容易にするサーバー、ストレージ・エンティティなど、リソースの論理的なグループです。通常のゾーンは、数百から数千のサーバーで構成されます。
空のゾーンまたはサーバー・プールのセットからなるゾーンを構成できます。2つ目のケースは設定が単純で共有のストレージを必要としませんが、そのようなゾーンではHAおよびライブ・マイグレーションが許可されません。

ゾーンは重なり合うことはなく、あるリソースは1つのゾーンにのみ所属します。しかし、ゾーン内のリソースには、別のゾーンからアクセスすることも可能です。たとえば、ゾーン1の仮想マシンは、別のゾーンの仮想マシンと対話できます。

- サーバー・プール: サーバー・プールは、密結合のサーバー・グループ(通常は最大32サーバー)であり、ゲストVMのセットをホストします。複数のサーバーは、機能性および接続性において、大きな均一なものとみなされます。高可用性およびライブ・マイグレーションは、サーバー・プールを境界として許可されます。各サーバー・プールは、ライブ・マイグレーションを容易にするため、共有ストレージ・サブシステム(単なるNFSのマウント・ポイントでかまいません)へのアクセスを必要とします。さらに、HAのハートビート・ファイルを保持するため、クラスタ化されたファイル・システムへのアクセスが必要となることもあります。

- ストレージ・エンティティ: ストレージ・エンティティは、個別のファイル・システムまたはブロック・ストアです。各ストレージ・エンティティは、ストレージ・プールによって供給されます。自立型のエンティティは、それが削除されるまで存在します。1つ以上のゲストVMに関連付けられているその他のストレージ・エンティティは、VMがリタイアするときに削除されます。

- ストレージ・プール: ストレージ・プールは、ストレージ・エンティティのセットをホストする抽象的なストレージ・システムです。ストレージ・プールは、通常、ディスク、SSD、ストレージ・サーバーなどのストレージ・デバイスのセットを使用して実装されます。

2.3.4 DBaaSおよびMWaaSコンポーネント

DBaaSおよびMWaaSクラウドの構造は、要素で構成されます。

- PaaSインフラストラクチャ・ゾーン: PaaSインフラストラクチャ・ゾーンは、ホストのグループです。ゾーン内の各リソースは、サービス・インスタンスをデプロイする場所を表します。
DBaaSまたはMWaaSを有効化または設定する前に、PaaSインフラストラクチャ・ゾーンを作成し、このゾーンを使用可能な特定のターゲット・セットおよびユーザーの配置ポリシー制約を定義する必要があります。

- ソフトウェア・プール: ソフトウェア・プールは、同種のリソースのセットです。DBaaSおよびMWaaSのソフトウェア・プールを作成できます。DBaaSで作成されるデータベース・プールは、選択したクラウド・サービス・モデルのタイプに応じたデータベース・ホーム、データベースまたはコンテナ・データベースのコレクションです。MWaaSで使用されるミドルウェア・プール(ミドルウェア・ホームのコレクション)を作成できます。
ソフトウェア・プールには、次の制約があります。

- ターゲットは1つのソフトウェア・プールにのみ属することができます。

- ソフトウェア・プールの作成後は名前とバージョンを変更できません。

- ソフトウェア・プール内のすべてのターゲットは同種である必要があります。

- 1つのサービス・テンプレートで複数のゾーンを使用できますが、各ゾーン内では1つのソフトウェア・プールしか使用できません。

- データベース・プロビジョニング・プロファイル: データベース・プロビジョニング・プロファイルは、プロビジョニングのソース・データベース情報を取得するエンティティです。プロファイルは、完全なデータベースまたはアプリケーションを形成する一連の関連するスキーマを表すことができます。

- ミドルウェア・プロビジョニング・プロファイル: ミドルウェア・プロビジョニング・プロファイルを使用して、デプロイメントを標準化し、デプロイメント・プロシージャの構成時のエラーを削減します。

- サービス・テンプレート: サービス・テンプレートは、データベース、スキーマまたはミドルウェア・サービスを作成するためにセルフ・サービス・ユーザーに提供される標準化されたサービス定義です。

2.3.5 TaaSコンポーネント

TaaSソリューションはIaaSプラットフォームに基づきます。TaaSを設定する前に、Enterprise ManagerおよびIaaSコンポーネントが設定済か確認してください。Oracle Load Testing TestDriverでTaaSを使用するには、Enterprise Managerの自己更新によりTestDriverをダウンロードする必要があります。

2.4 Oracle Cloud機能へのアクセス

Oracle Cloud機能には、標準のEnterprise Managerコンソールか、やはりEnterprise Managerの一部であるセルフ・サービス・ポータルのいずれかからアクセスします。

Enterprise Managerのその他の機能へのアクセスは制限されています。これにより企業は、インフラストラクチャ全体をエンド・ユーザーに公開することなく、安全にクラウドを実装できます。

2.4.1 Enterprise Manager Cloud Controlのコンソール

管理者は、Enterprise ManagerのCloud Controlコンソールを使用してクラウド・サービスの設定、監視、管理を行います。各サービスは、それぞれのサービス専用のページを使用して管理されます。たとえば、IaaS、DBaaS、MWaaSおよびTaaSには、それぞれ独自のページがあり、クラウドの概要ページまたは「Enterprise Manager」メニューから直接アクセスできます。

Enterprise Managerのクラウドの概要ページには、すべてのクラウド・サービスの概要を表示する単一のペインがあります。Enterprise Managerでは、抽象化レイヤーを使用でき、その下にあるアプリケーションの複雑さをエンド・ユーザーに隠すことができます。この抽象化は、グラフィカル・ユーザー・インタフェース(GUI)およびアプリケーション・プログラミング・インタフェース(API)の2つのセルフ・サービス・インタフェース経由で提供されます。

2.4.2 セルフ・サービス・ポータル

クラウド・インフラストラクチャを直接管理できるように、Enterprise Managerでは即時利用可能なセルフ・サービス・ポータルが提供されており、セルフ・サービス・ユーザーは、ITスタッフの手を借りずにクラウド・サービス(プロビジョニング・アプリケーション)にアクセスできます。オンデマンド・プロビジョニング用に事前パッケージ済の仮想アセンブリおよびテンプレートが提供され、サービスおよびリソースの使用状況を追跡でき、チャージバック・レポートおよびキャパシティ・プランニングに使用できるデータが提供されます。

セルフ・サービス・ポータルは、セルフ・サービス・ユーザー向けのホーム・ページです。必要な権限を持つユーザーは、適切なラジオ・ボタンをクリックすることで、サービス・ページ間を移動できます。ポータルをどのように使用するかは、管理しているサービスのタイプによって異なります。

図2-3 SSAユーザー・ポータル

第II部

クラウドの設定および有効化

ここでは、仮想化の概念を紹介し、Enterprise Managerで仮想化ターゲットの管理を開始する方法を説明します。

内容は次のとおりです。

- 第3章「クラウド管理インフラストラクチャの設定」

- 第4章「クラウドの有効化の方法」

3 クラウド管理インフラストラクチャの設定

この章では、Enterprise Managerクラウド管理ソリューションの使用開始前に必要な初期設定について説明します。

この章の項目は、次のとおりです。

- 自己更新の設定

- 必要なプラグインのデプロイ

- ロールの定義およびユーザーの割当て

- LDAP認証の構成

- 権限委任設定の構成

- セルフ・サービス・ログイン・ページのカスタマイズ

注意:
Enterprise Manager 12.1.0.4リリース以上では、Enterprise Managerのインストール中にソフトウェア・ライブラリが構成されます。別途構成する必要はありません。

3.1 自己更新の設定

自己更新機能では、公式なリリースの間に新規および更新機能が使用可能になると、すぐにEnterprise Managerコンポーネントが更新されるため、Enterprise Managerの機能を強化できます。オラクル社では、リリース間の機能的な更新をEnterprise Managerストアに公開することでその入手を可能にし、この外部サイトは、利用可能な更新についての情報を得るためにEnterprise Managerによって定期的にチェックされます。

Oracle Cloudプラットフォームの更新可能なエンティティには、次のものがあります。

- クラウド・プラグイン。第3.2項「必要なプラグインのデプロイ」を参照してください

- Oracle VMテンプレートおよびアセンブリ。第5.13項「自己更新を使用したOracle VM TemplatesおよびOracle Virtual Assembliesのダウンロード」を参照してください。

- データベース・プロビジョニング・プロファイル。第15.1.2項「データベース・テンプレートを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

- ミドルウェア・プロビジョニング・プロファイル。第13.3.1項「プロビジョニング・プロファイルの作成」を参照してください。

自己更新機能を使用する前に、次の前提条件を満たしている必要があります。

- 更新をオンライン・モードで適用している場合、My Oracle Supportの資格証明はSYSMANユーザーを使用して設定されていることを確認してください。これは、My Oracle Supportサイトからのエンティティのダウンロードに必要です。

- ソフトウェア・ライブラリ(ローカル・ストアとも呼ばれています)が構成されていること。更新は、Enterprise Managerにデプロイされる前に、このローカル・ストアにダウンロードされます。

自己更新の設定手順は、次の各項を参照してください。

- Enterprise Manager自己更新モードの設定

- ユーザーへの自己更新権限の割当て

- EM CLIユーティリティの設定(オプション)

3.1.1 Enterprise Manager自己更新モードの設定

Enterprise Managerの自己更新機能を設定または変更するためには、Enterprise Managerスーパー管理者権限を持っている必要があります。

1. スーパー管理者権限のある管理者としてEnterprise Managerにログインします。

2. 「設定」メニューで、「拡張性」、「自己更新」の順に選択します。自己更新コンソールがデフォルト設定で表示されます。

3. 「一般」ステータス領域から、「接続モード」ステータスをクリックして、オフライン・モードまたはオンライン・モードのいずれかを設定します。パッチ適用設定ページに移動したら、オンラインおよびオフライン設定を指定します。

4. 必要な接続モードを設定したら、自己更新コンソールに戻ります。
ここから、エンティティ・タイプを選択し、Enterprise Manager Updateストアからの更新をスケジュールすることができます。

3.1.2 ユーザーへの自己更新権限の割当て

Enterprise Manager管理者は、自己更新機能を使用するのに必要な権限を持っている必要があります。Enterprise Managerスーパー管理者が、自己更新に関する次のロールを管理者に割り当てる必要があります。

- VIEW_SELF_UPDATE: 自己更新コンソールを表示し、ダウンロードと適用ジョブのステータスを監視できます。

- MANAGE_SELF_UPDATE: ダウンロードと適用ジョブをスケジュールできます。更新の抑止と抑止解除も可能です。この権限には、暗黙的にVIEW_SELF_UPDATEが含まれます。

- EM_INFRASTRUCTURE_ADMIN: すべての自己更新操作を実行できます。この権限には、暗黙的にMANAGE_SELF_UPDATEが含まれます。

デフォルトでは、スーパー管理者にはEM_INFRASTRUCTURE_ADMIN権限が付与されます。

自己更新の権限を通常のEnterprise Manager管理者に割り当てるには:

1. 「設定」メニューから、「セキュリティ」、「管理者」の順に選択します。

2. 管理者を選択し、「編集」をクリックします。

3. ロール・ページから、適切な自己更新ロールを割り当てます。

3.1.3 EM CLIユーティリティの設定(オプション)

ソフトウェア更新をオフライン・モードで適用する場合、Enterprise Managerコマンドライン・ユーティリティ、つまりEM CLIを使用して、デプロイ用のエンティティ・アーカイブをEnterprise Managerにインポートする必要があります。

EMCLIの設定手順を示すページがEnterprise Manager Cloud Controlコンソールに表示されます。Cloud Controlコンソールへのアクセスに使用するURLに/console/emcli/downloadを追加して、ページにアクセスします。

https://emcc_host:emcc_port/em

たとえば、次のようになります。

https://emcc_host:emcc_port/em/console/emcli/download

3.2 必要なプラグインのデプロイ

Enterprise Manager Cloud Controlで使用可能な機能の多くは、プラグインを介して使用可能になります。その名前が示すように、プラグインは、管理および監視機能を拡張するために、既存のEnterprise Managerインストールに連結できるコンポーネントまたはモジュールです。

Oracle Cloud Managementソリューションを集合的に構成する機能は、Oracle Management Service (OMS)にデプロイする必要のあるいくつかのプラグインにより提供されます。各クラウド・モデルを有効にするためにデプロイする必要のあるプラグインは、次に示すとおりです。

クラウドを有効にするために必要なプラグインは、2つの方法でデプロイできます。

- まだEnterprise Manager Cloud Controlをインストールしていない場合、またはEnterprise Managerの最新リリースにアップグレードしていない場合、インストールまたはアップグレードのプロセスの一部として、プラグインをデプロイできます。「拡張インストール」モードを選択し、「プラグインの選択」画面でインストールするプラグインを選択します。

- すでにEnterprise Manager Cloud Control 12cがインストールされている場合、必要なプラグインをソフトウェア・ライブラリにダウンロードする必要があります。その後、プラグインをOracle Management Service (OMS)にデプロイできます。
プラグインをダウンロードしてデプロイする手順は、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。

注意:

- デフォルト・プラグインは次のとおりです。
- Enterprise Manager for Oracle Database

- Enterprise Manager for Oracle Fusion Middleware

- Enterprise Manager for Oracle Cloud Framework

- Enterprise Manager for Oracle Consolidation Planning and Chargebackプラグインは、すべてのサービス・ファミリ用のオプションのプラグインであり、チャージバック機能を使用している場合にのみ必要です。

- すべてのクラウド・プラグインとそのバージョン番号の完全なリストは、「サポートされているプラグイン」を参照してください。使用可能なプラグインの更新をすべてチェックし、最新のバージョンがダウンロードされていることを確認する必要があります。

Infrastructure as a Service (IaaS)の有効化に必要なプラグイン

- Enterprise Manager for Oracle Cloud (「自己更新」のリストにはOracle Cloud Applicationとして表示)

- Enterprise Manager for Oracle Virtualization (「自己更新」のリストにはOracle Virtualizationとして表示)

- Enterprise Manager for Oracle Virtualization Infrastructure (「自己更新」のリストにはOracle Virtual Infrastructureとして表示)

- Enterprise Manager for Oracle Cloud Framework (「自己更新」のリストにはOracle Cloud Frameworkとして表示)

- Enterprise Manager for Oracle Consolidation Planning and Chargeback (「自己更新」のリストにはOracle Consolidation Planning and Chargebackとして表示)

Database as a Service (DBaaS)の有効化に必要なプラグイン

- Enterprise Manager for Oracle Cloud (「自己更新」のリストにはOracle Cloud Applicationとして表示)

- Enterprise Manager for Oracle Virtualization (「自己更新」のリストにはOracle Virtualizationとして表示)

- Enterprise Manager for Oracle Consolidation Planning and Chargeback (「自己更新」のリストにはOracle Consolidation Planning and Chargebackとして表示)

- Enterprise Manager for Oracle Database (「自己更新」のリストにはOracle Databaseとして表示)

- Enterprise Manager for Storage Management (「自己更新」のリストにはOracle Storage Management Frameworkとして表示)

- Enterprise Manager for Oracle Cloud Framework (「自己更新」のリストにはOracle Cloud Frameworkとして表示)

注意:
最新のプラグイン・バージョンにアップグレードする場合、それらを次の順序でアップグレードする必要があります。

1. Enterprise Manager for Oracle Cloud Framework

2. Enterprise Manager for Oracle Database

3. Enterprise Manager for Oracle Fusion Middleware (Fusion MiddlewareまたはMiddleware as a Serviceの操作を何も実行しない場合でも必須)。

4. Enterprise Manager for Oracle Virtualization

5. Enterprise Manager for Oracle Cloud (このプラグインは、Enterprise Manager for Oracle Fusion Middlewareプラグインがアップグレードされていないとアップグレードできません)。

6. Enterprise Manager for Storage Management

Middleware as a Service (MWaaS)の有効化に必要なプラグイン

- Enterprise Manager for Oracle Consolidation Planning and Chargeback (「自己更新」のリストにはOracle Consolidation Planning and Chargebackとして表示)

- Enterprise Manager for Oracle Fusion Middleware (「自己更新」のリストにはOracle Fusion Middlewareとして表示)

- Enterprise Manager for Oracle Cloud Framework (「自己更新」のリストにはOracle Cloud Frameworkとして表示)

注意:

- Enterprise Manager for CloudおよびEnterprise Manager for Oracle Virtualizationプラグインは、Middleware as a Serviceを初めて使用する場合は不要です。これらのプラグインの一部である機能は、現在Enterprise Manager for Oracle Fusion Middleware 12.1.0.7以降のプラグインにバンドルされています。

- Enterprise Manager for Cloudプラグイン(12.1.0.8またはそれ以前)をすでにデプロイした場合は、このリリースの新機能を使用するために次のプラグインをアップグレードする必要があります。
- Enterprise Manager for Oracle Cloudから12.1.0.10

- Enterprise Manager for Oracle Cloud Frameworkから12.1.0.3

- Enterprise Manager for Oracle Virtualizationから12.1.0.8

- Enterprise Manager for Oracle Fusion Middlewareから12.1.0.8

Testing as a Service (TaaS)の有効化に必要なプラグイン

- Enterprise Manager for Oracle Cloud (「自己更新」のリストにはOracle Cloud Applicationとして表示)

- Enterprise Manager for Oracle Virtualization (「自己更新」のリストにはOracle Virtualizationとして表示)

- Enterprise Manager for Oracle Consolidation Planning and Chargeback (「自己更新」のリストにはOracle Consolidation Planning and Chargebackとして表示)

- Enterprise Manager for Oracle Cloud Framework (「自己更新」のリストにはOracle Cloud Frameworkとして表示)

Xenベース・システムの直接監視に必要なプラグイン

- Enterprise Manager for Oracle Virtualization Infrastructure (「自己更新」のリストにはOracle Virtual Infrastructureとして表示)

Infrastructure Compute as a Serviceの有効化に必要なプラグイン

- Enterprise Manager for Oracle Cloud (「自己更新」のリストにはOracle Cloud Applicationとして表示)

- Enterprise Manager for Oracle Cloud Framework (「自己更新」のリストにはOracle Cloud Frameworkとして表示)

- Enterprise Manager for Oracle Consolidation Planning and Chargeback (「自己更新」のリストにはOracle Consolidation Planning and Chargebackとして表示)

3.3 ロールの定義およびユーザーの割当て

ロールは、関連するシステムおよびオブジェクト権限の名前付きグループです。ロールを作成し、ユーザーおよび他のロールに割り当てることができます。任意の既存のロールを、新規ロールおよび関連する権限に割り当てることができます。Enterprise Managerには、クラウド・セルフ・サービス・ポータル用に、即時利用可能な次の4つのロールがあります。

- EM_CLOUD_ADMINISTRATOR: このロールを持つユーザーは、クラウド・インフラストラクチャの設定と管理ができます。このロールは、クラウド・インフラストラクチャ(サーバー、ゾーン、ストレージおよびネットワーク)のデプロイ、およびインフラストラクチャ・クラウドのパフォーマンスおよび構成管理のための操作を担当します。このユーザーには次の権限があります。

- すべてのサービスおよびサービス・ファミリへのアクセス権。

- 任意のサービスまたはサービス・ファミリを管理する権限。

- 任意のターゲットを表示する権限。

- EM_SSA_ADMINISTRATOR: このロールを持つユーザーは、セルフ・サービス・ユーザーに対しての割当てと制約を定義したり、アクセス権を付与できます。このロールを持つユーザーはまた、プロビジョニングおよびパッチ・デザイナの権限を持ち、デプロイメント・プロシージャの作成および保存を行い、パッチ計画を作成および表示し、管理エージェント上のプラグインのライフサイクルをサポートします。これらの権限は、インフラストラクチャの初期設定および進行中のメンテナンスに必要です。このユーザーには次の権限があります。

- すべてのサービスおよびサービス・ファミリへのアクセス権。

- 任意のサービスまたはサービス・ファミリを管理する権限。

- 任意のターゲットを表示する権限。

このデフォルト・ロールとは別に、特定のサービス・ファミリおよび特定のサービスへのアクセス権を持つカスタム・セルフ・サービス管理者ロールを作成できます。

- EM_SSA_ADMINISTRATOR_BASE: このロールを持つユーザーは、どのサービスまたはサービス・ファミリにもアクセスできません。このユーザーには「任意のターゲットの表示」権限のみあります。

- EM_SSA_USER: このロールを持つユーザーは、デフォルトで、セルフ・サービス・ポータルおよびすべてのサービス・ファミリにのみアクセスできます。EM_SSA_ADMINISTRATORロールを持つ管理者は、EM_SSA_USERロールを持つユーザーに対して、Enterprise Managerのその他の機能にアクセスする追加の権限を付与できます。

- EM_SSA_USER_BASE: このロールを持つユーザーは、セルフ・サービス・ポータルにアクセスできますが、どのサービス・ファミリにもアクセスできません。このロールを持つユーザーには、特定のサービス・ファミリ(DBaaSやMWaaSなど)に対するアクセス権を明示的に付与する必要があります。このユーザーには次の権限があります。

- サービス・リクエストを発行できます。

- PaaSインフラストラクチャ・ゾーン・ターゲットを表示できます。

次の表に、それぞれのユーザーに関連するロールを示します。

ユーザー・プロファイル

EM_CLOUD_ADMINISTRATOR

EM_SSA_ADMINISTRATOR

EM_SSA_USER

EM_SSA_USER_BASE

ユーザーの作成に必要な最低限のロール

- EM_CLOUD_ADMINISTRATOR

- PUBLIC

- EM_USER

- EM_SSA_ADMINISTRATOR

- PUBLIC

- EM_USER

EM_SSA_USER
EM_SSA_USER_BASE

EM_SSA_USER_BASE

ユーザーの作成時に削除されるロール

なし

なし

- PUBLIC

- EM_USER

なし

必要に応じて特別なロールを追加できます

Oracle Cloudセルフ・サービス・ポータルは、エンドユーザーが独自のクラウド・サービスをプロビジョニングおよび管理できるようにするためのものです。EM_CLOUD_ADMINISTRATORおよびEM_SSA_ADMINISTRATORロールを持つユーザーにより実行される機能は、Enterprise Manager全体で一貫性があるため、これらの即時利用可能なロールはそのままで使用できます。EM_CLOUD_ADMINISTRATORおよびEM_SSA_ADMINISTRATORロールを持つユーザーさえ作成すればよいのです。

特定のサービス・ファミリおよび特定のサービス・タイプへのアクセスを制限する場合は、即時利用可能なEM_SSA_ADMINISTRATORロールに基づくカスタム・セルフ・サービス管理者ロールを作成できます。

しかし、EM_SSA_USERロールとEM_SSA_USER_BASEロールは、割当て制限の割当て、およびPaaSインフラストラクチャ・ゾーンおよびサービス・テンプレートへのアクセス制限に使用されます。この場合、事前定義のこのロールは、定義どおりに使用できません。第3.3.1項「セルフ・サービス・アプリケーション管理者およびユーザーのカスタム・ロールの作成」で説明するとおり、標準のEM_SSA_ROLEロールとEM_SSA_USER_BASEロールに基づいてカスタム・セルフ・サービス・ユーザー・ロールを作成する必要があります。カスタム・ロールの作成後、ユーザーをこのロールに割り当てる必要があります。

たとえば、DBaaSクラウド設定では、次のユーザーを作成できます。

- CLOUD_ADMIN: このユーザーは、EM_CLOUD_ADMINISTRATORロールを持ち、ネットワーク・システム、ストレージおよび管理アクティビティを担当します。

- SSA_ADMIN_DBAAS: このユーザーにはEM_SSA_ADMINISTRATORロールがありますが、データベース・サービス・ファミリにのみアクセスできます。このロールを持つユーザーは、すべてのデータベース管理アクティビティを担当します。データベース・サービス・ファミリ内の特定のサービス・タイプへのアクセス権のみ付与することで、アクセスをさらに制限できます。

- SSA_USER_DBAAS: この場合、デフォルトのEM_SSA_USERロールはカスタマイズが必要で、カスタム・ロールを作成する必要があります。このロールのユーザーは、通常、下級のデータベース管理者、開発者またはテスト実施者です。

- SSA_USER_BASE_DBAAS: この場合、EM_SSA_USER_BASEロールのコピーを作成し、データベース・サービス・ファミリへのアクセス権をこのロールに付与する必要があります。その後に、データベース・クラウド・セルフ・サービス・ポータルにアクセス可能なSSA_USER_BASEユーザーを作成できます。

ユーザーおよびロールの詳細は、『Oracle Enterprise Manager Cloud Controlセキュリティ・ガイド』を参照してください。

3.3.1 セルフ・サービス・アプリケーション管理者およびユーザーのカスタム・ロールの作成

この項の内容は次のとおりです。

- EM_SSA_ADMINISTRATORロールに基づくカスタム・ロールの作成

- EM_SSA_USERロールに基づくカスタム・ロールの作成

- EM_SSA_USER_BASEロールに基づくカスタム・ロールの作成

3.3.1.1 EM_SSA_ADMINISTRATORロールに基づくカスタム・ロールの作成

カスタム・セルフ・サービス管理者ロールを作成し、データベース・サービス・ファミリへのアクセス権を付与できます。このロールを持つユーザーに、すべてのサービス・タイプまたは特定のサービス・タイプへのアクセスおよびサービスの表示または管理の権限を付与できます。カスタム・ロールを作成するには、次の手順に従います。

1. スーパー管理者ユーザーとしてEnterprise Managerにログインします。

2. 「設定」メニューから、「セキュリティ」、「ロール」の順に選択します。

3. ロール・ページで「作成」をクリックし、ロールの作成ウィザードを起動します。

4. ロールの名前(SSA_ADMIN_DBAAS)と説明を入力し、「次へ」をクリックします。

5. 「使用可能なロール」の一覧からEM_SSA_ADMINISTRATORロールを選択し、「選択したロール」の表に移します。次をクリックします。

6. デフォルトのターゲット権限を承認して「次へ」をクリックします。

7. リソース権限ページで、クラウド・サービス・ファミリの「編集」アイコンをクリックします。リソース権限ページで、「追加」をクリックして「DBAAS」を選択し、「続行」をクリックして権限の管理ページに戻ります。

注意:
このロールを持つユーザーがすべてのDBaaSサービス・タイプを表示および管理できるようにする場合は、「リソース権限付与の管理」アイコンをクリックし、次の権限を選択します。

- サービス・ファミリの表示

- サービス・ファミリの管理

8. 「続行」をクリックして「リソース権限」ページに戻ります。クラウド・サービス・タイプの「編集」アイコンをクリックします。「追加」をクリックし、権限を付与するデータベース・サービス・タイプを選択します。次のいずれかを選択できます。

- DB

- PDB

- スキーマ

9. 「クラウド・サービス・タイプ」リソース・タイプの「リソース権限付与の管理」をクリックします。次の権限を選択します。

- サービス・タイプの管理

- サービス・タイプの表示

10. 「続行」をクリックして「リソース権限」ページに戻ります。

11. 変更を確認して「終了」をクリックし、カスタムのSSAユーザー・ロール(SSA_ADMIN_DBAAS)を作成します。

3.3.1.2 EM_SSA_USERロールに基づくカスタム・ロールの作成

一般的には、開発者、テスト実施者、本番DBAといった異なる機能グループ用、またはSiebel DBAチーム、BRM DBAチーム、カスタムJavaアプリケーションをホストするためのオペレーション・チームといった異なるカスタマ・チーム用のどちらかのために、新規のSSAユーザー・ロールを作成する必要があります。データベース・サービス・ファミリへのアクセス権のみ持ち、リクエストを発行できるカスタムSSAユーザー・ロールを作成するには、次の手順に従います。

1. スーパー管理者ユーザーとしてEnterprise Managerにログインします。

2. 「設定」メニューから、「セキュリティ」、「ロール」の順に選択します。

3. ロール・ページで「作成」をクリックし、ロールの作成ウィザードを起動します。

4. ロールの名前(SSA_USER_DBAAS)と説明を入力し、「次へ」をクリックします。

5. 「使用可能なロール」の一覧からEM_SSA_USERロールを選択し、「選択したロール」の表に移します。次をクリックします。

6. デフォルトのターゲット権限を承認して「次へ」をクリックします。

7. リソース権限ページで、次のリソース・タイプへのアクセス権を除去します。

- JVM診断のクラウド・セルフ・サービス・ポータル

- テスト向けクラウド・セルフ・サービス・ポータル

- インフラストラクチャ・セルフ・サービス・ポータル

8. 「クラウド・サービス・ファミリ」リソース・タイプの「権限付与の管理」をクリックします。「リソース・タイプ権限」リージョンで、「任意のサービス・ファミリの表示」チェック・ボックスを選択します。

9. 「リソース権限」リージョンの「追加」をクリックし、「DBAAS」サービス・ファミリを選択し、「続行」をクリックします。

10. 「ロールの作成: 管理者」の手順をスキップし、「次へ」をクリックします。

11. 変更を確認して「終了」をクリックし、カスタムのSSAユーザー・ロール(SSA_USER_DBAAS)を作成します。

3.3.1.3 EM_SSA_USER_BASEロールに基づくカスタム・ロールの作成

一部のセルフ・サービス・ユーザーを制限してすべてのサービス・ファミリを使用できないようにし、その必要に応じて特定のサービス・タイプにのみアクセスを許可できます。この場合、EM_SSA_USER_BASEロールに基づいてカスタム・ロールを作成し、それらに特定のサービス・タイプのみに対するアクセス権を付与できます。

カスタムのSSAユーザー・ロールを作成する手順:

1. スーパー管理者ユーザーとしてEnterprise Managerにログインします。

2. 「設定」メニューから、「セキュリティ」、「ロール」の順に選択します。

3. ロール・ページで「作成」をクリックし、ロールの作成ウィザードを起動します。

4. ロールの名前(SSA_USER_BASE_DBAAS)と説明を入力し、「次へ」をクリックします。

5. 「使用可能なロール」の一覧からEM_SSA_USER_BASEロールを選択し、「選択したロール」の表に移します。次をクリックします。

6. デフォルトのターゲット権限を選択し、「次へ」をクリックします。

7. リソース権限ページで、「クラウド・リクエスト」リソース・タイプの「権限付与の管理」アイコンをクリックします。

8. リソース権限ページで、「任意のクラウド・リクエストの作成」チェック・ボックスの選択を解除し、「続行」をクリックします。

9. 「クラウド・サービス・ファミリ」および「クラウド・サービス・タイプ」リソース・タイプの横の「権限付与の管理」アイコンをクリックし、アクセスする必要のあるサービス・ファミリおよびサービス・タイプを選択します。

10. 「ロールの作成: 管理者」の手順をスキップし、「次へ」をクリックします。

11. 変更を確認して「終了」をクリックし、カスタムのSSAユーザー・ロール(SSA_USER_BASE_DBAAS)を作成します。このユーザーは、データベース・クラウド・セルフ・サービス・ポータルにのみアクセスできます。

3.3.2 ユーザーの作成およびロールの割当て

SSA_USER1と呼ばれるユーザーを作成し、前の手順で作成したカスタム・ロール権限(SSA_USER_DBAAS)を付与するには、次の手順に従います。

1. スーパー管理者ユーザーとしてEnterprise Managerにログインします。

2. 「設定」メニューから、「セキュリティ」、「管理者」の順に選択します。

3. 管理者ページで、「作成」をクリックし、管理者の作成ウィザードを起動します。

4. ユーザー(SSA_USER1)の名前およびパスワードを入力し、「次へ」をクリックします。

5. 「使用可能なロール」の一覧からSSA_USER_DBAASロールを選択し、「選択したロール」の表に移します。選択したロールの表から、EM_USERおよびPUBLICロールを削除します。次をクリックします。

6. デフォルトのターゲット権限を承認して「次へ」をクリックします。

7. デフォルトのリソース権限を承認して「次へ」をクリックします。

8. 変更を確認して「終了」をクリックし、SSA_USER1ユーザーを作成します。

ヒント:
同じロールを持つ複数のユーザーを作成するには、新しく作成したユーザーを選択して「類似作成」をクリックします。これで、ソースと同じプロパティを持つ新しいユーザーが作成されます。その後、新規ユーザーの名前、説明および電子メール・アドレスを更新できます。

注意:
他のユーザーを作成するには、これらの手順を繰り返します。EM_CLOUD_ADMINISTRATORおよびEM_SSA_ADMINISTRATORロールを持つユーザーの場合、追加機能へのアクセスが必要なので、EM_USERおよびPUBLICロールを保持する必要があります。

3.3.3 スナップ・クローンのストレージ・サーバーを管理するためのロールおよび権限の付与

様々なストレージ・サーバー・アクティビティを実行するには、次のロールおよび権限を付与する必要があります。

- 一般的な権限の付与

- ターゲット権限の付与

- ロールの付与

- プロビジョニング用の権限の付与

3.3.3.1 一般的な権限の付与

表3-1には、ストレージ・サーバーを登録する前に設定する必要がある一般的な権限が表示されます。

表3-1 ストレージ・サーバーの登録および管理の一般的な権限

権限

説明

有効範囲

概念

含まれる権限

VIEW_ANY_STORAGE

ストレージを表示する機能。

クラス

VIEW

nil

REGISTER_STORAGE

ストレージを登録する機能。

クラス

CREATE

nil

VIEW_STORAGE

ストレージ詳細を表示する機能。

オブジェクト

VIEW

nil

MANAGE_STORAGE

ストレージを同期する機能。

オブジェクト

EDIT

VIEW_STORAGE

CREATE_JOB

MANAGE_ANY_STORAGE

登録されたストレージ・サーバーを管理する機能。

オブジェクト

EDIT

VIEW_ANY_STORAGE

CREATE_JOB

FULL_STORAGE

ストレージを変更または削除する機能。

オブジェクト

FULL

MANAGE_STORAGE

3.3.3.2 ターゲット権限の付与

表3-2には、ターゲットのスナップ・クローンを有効化または無効化するために設定する必要があるターゲット権限が示されています。

表3-2 スナップ・クローンを有効化または無効化するターゲット権限

ターゲット権限

有効範囲

概念

含まれる権限

含まれる権限

適用可能なターゲット・タイプ

SNAP_CLONE_TARGET

オブジェクト

管理

FULL_TARGET

VIEW_TARGET

oracle_database

rac_database

3.3.3.3 ロールの付与

表3-3には、ストレージ・サーバーを登録し、登録されたストレージ・サーバーで様々なアクティビティを実行できるようにするために付与する必要があるロールが表示されます。

表3-3 ストレージ・サーバーを登録および管理するロール

ロール

説明

セキュリティ・クラス

権限

付与対象のロール

EM_STORAGE_ADMINISTRATOR

ロールは、ストレージ・ハードウェアをスナップ・クローン用に登録する権限を持ちます。

STORAGE

STORAGE

TARGET

TARGET

NAMED_CREDENTIALS

JOB

SWLIB_ENTITY_MGMT

MANAGE_ANY_STORAGE

REGISTER_STORAGE

VIEW_ANY_TARGET

PERFORM_OPERATION_ANYWHERE

CREATE_CREDENTIAL

CREATE_JOB

SWLIB_CREATE_ANY_ENTITY

SWLIB_VIEW_ANY_ENTITY

EM_ALL_ADMINISTRATOR

EM_STORAGE_OPERATOR

ロールは、ストレージ・ハードウェアをスナップ・クローン用に管理する権限を持ちます。

STORAGE

TARGET

TARGET

JOB

SWLIB_VIEW_ANY_ENTITY

MANAGE_ANY_STORAGE

VIEW_ANY_TARGET

PERFORM_OPERATION_ANYWHERE

CREATE_JOB

SWLIB_VIEW_ANY_ENTITY

EM_ALL_OPERATOR

3.3.3.4 プロビジョニング用の権限の付与

プロビジョニング用にストレージ・サーバーを使用できるようにするには、次の権限が必要です。

- ストレージ・サーバーにVIEW_STORAGE

- ストレージ・サーバーにGET_CREDENTIAL

- ストレージ・サーバーのすべての管理エージェント資格証明にGET_CREDENTIAL

- ストレージ・サーバー管理エージェントにPERFORM_OPERATION

注意:
OSバージョンがB.11.31以上の場合のみ、スナップ・クローンはHP-UXホスト上のSun ZFSストレージをサポートします。OSバージョンがこれより低い場合、Sunストレージは適切に機能しないことがあるため、スナップ・クローンで予期しない結果が発生します。

3.4 LDAP認証の構成

Oracle Enterprise ManagerにはOracle環境の安全な管理に役立つツールと手順が用意されています。Enterprise Managerの認証フレームワークは、環境に最も適した認証プロトコルを使用可能にするプラガブルな認証スキームで構成されています。次の認証スキームがあります。

- Oracle Access Manager(OAM) SSO

- リポジトリベースの認証

- SSOベースの認証

- エンタープライズ・ユーザー・セキュリティベースの認証

- Oracle Internet Directory(OID)ベースの認証

- Microsoft Active Directoryベースの認証

エンタープライズ・ユーザー・セキュリティ(Enterprise User Security: EUS)により、LDAP準拠のディレクトリ・サーバーからのユーザーとロールの自動認証が可能となります。

エンタープライズ・ユーザー・セキュリティの詳細は、Oracle Enterprise Managerセキュリティ・ガイドを参照してください。

3.5 権限委任設定の構成

権限委任により、別のユーザーの権限を使用したアクティビティの実行をログイン・ユーザーに許可します。sudoおよびPowerbrokerは、ログイン・ユーザーにこれらの権限を割当てできる権限委任ツールです。これらの権限委任設定は、ホスト上のすべてのプロビジョニングおよびパッチ・アクティビティに使用されます。

権限委任設定構成の詳細は、『Oracle Enterprise Manager Cloud Controlセキュリティ・ガイド』を参照してください。

3.6 セルフ・サービス・ログイン・ページのカスタマイズ

Enterprise Managerを構成して、SSAユーザーに特定のアクセスを提供できます。SSAユーザー用にEnterprise Managerを構成するには、OMSにいくつかのプロパティを設定し、必要なイメージを特定のディレクトリにコピーします。この項の内容は次のとおりです。

- セルフ・サービス・ログイン・ページの構成

- Enterprise Managerのログイン・ページへの切替え

- 特定のOMSプールへのSSAリクエストのルーティング

3.6.1 セルフ・サービス・ログイン・ページの構成

すべてのSSAユーザーに個別にSSAログイン・ページを起動するには、次の操作を行う必要があります。

- すべてのOMSで、次の必須プロパティを設定します。
$ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.ssa_oms -value true

このプロパティがtrueに設定されていない場合、標準のEnterprise Managerのログイン・ページが表示されます。

- 次のオプションのOMSプロパティを設定します。

- $ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.show_cloud_provider_brand -value true
このプロパティがtrueに設定されていない場合、デフォルトのOracle Enterprise Manager 12cのロゴが表示されます。

- $ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.show_cloud_tenant_brand -value true
このプロパティがtrueに設定されていない場合、テナントのロゴは表示されません。

- $ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.cloud_provider_alt_text -value "Cloud Provider"

- $ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.cloud_tenant_alt_text -value "Cloud Tenant"
これらのプロパティはオプションで、設定されていない場合、「クラウド・プロバイダ」および「クラウド・テナント」のデフォルト値が表示されます。

- $ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.show_disclaimer_text -value true
このプロパティがtrueに設定されていない場合、デフォルトのOracleコピーライト・メッセージが表示されます。

- $ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.disclaimer_text -value "Customer specified Disclaimer text"
このプロパティがtrueに設定されていない場合、デフォルトのOracleコピーライト・メッセージのかわりに、指定した免責条項のテキストが表示されます。

- $ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.show_em_branding_text -value true
このプロパティがfalseに設定されていない場合、「Powered by Oracle Enterprise Manager」のテキストが、「セルフ・サービス・ログイン」ページに表示されます。

- 次のイメージを$ORACLE_HOME/sysman/config/ディレクトリにコピーします。

- cloud_provider_small_brand.png

- cloud_tenant_small_brand.png
1つのイメージを使用する場合は、推奨最大サイズは500*20ピクセルです。2つのイメージを使用する場合は、推奨最大サイズは1イメージ当たり200 * 20ピクセルです。OMSのプロパティoracle.sysman.ssa.logon.show_cloud_provider_brandおよびoracle.sysman.ssa.logon.show_cloud_tenant_brandが設定されている場合は、ログイン後、Oracleのロゴにかわり、これらのイメージが表示されます。OMSのプロパティoracle.sysman.ssa.logon.show_cloud_provider_brandがtrueに設定されていない場合は、テナントのロゴとともに、デフォルトのOracleロゴが表示されます。

- cloud_provider_large_brand.png

- cloud_tenant_large_brand.png
1つのイメージを使用する場合は、推奨最大サイズは525*60ピクセルです。2つのイメージを使用する場合、推奨最大サイズは1イメージ当たり250 * 50ピクセルです。OMSプロパティのoracle.sysman.ssa.logon.show_cloud_provider_brandおよびoracle.sysman.ssa.logon.show_cloud_tenant_brandが設定されている場合は、これらのイメージがログイン・ページに表示されます。

たとえば、ACME Corpがクラウド・サービス・プロバイダで、XYZがクラウド・テナントである場合、カスタマイズされたログイン・ページは次のように表示されます。

図3-1 カスタマイズされたSSAログイン・ページ

SSAユーザーがログインすると、カスタマイズされたインフラストラクチャ・セルフ・サービス・ポータルが次のように表示されます。

図3-2 カスタマイズされたログイン後のページ

3.6.2 Enterprise Managerのログイン・ページへの切替え

デフォルトのEnterprise Managerログイン・ページに戻すには、次のプロパティを設定します。

$ORACLE_HOME/bin/emctl set property -name oracle.sysman.ssa.logon.ssa_oms -value false

3.6.3 特定のOMSプールへのSSAリクエストのルーティング

Oracle Management Service (OMS)は、Oracle Management Agent (管理エージェント)およびプラグインとともに機能するEnterprise Manager Cloud Controlのコア・コンポーネントの1つで、ターゲットを検出して監視および管理を行い、今後の参照および分析のために、収集された情報をリポジトリ内に格納します。

初めてEnterprise Managerをインストールすると、デフォルトで、1つのOMSが1つの管理エージェントとともにインストールされます。このデフォルトの構成は、小規模な環境に適しています。複数のSSAユーザーがいるより大規模な本番環境では、単一のOMSの負荷を軽減し、データ・フローの効率を向上させるため、追加のOMSインスタンスをインストールする必要があります。その後、サーバー・ロード・バランサ(SLB)を構成して、すべてのSSAリクエストを特定のOMSプールにリダイレクトすることができます。その結果、他のOMSプールを管理用に使用することができます。複数のOMSインスタンスおよびSLBの設定の詳細は、『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイ』のOracle Management Serviceの追加に関する項を参照してください。

SSAリクエストをリダイレクトするには、次のSLB構成を指定する必要があります。

https://<slb_host_name>:<slb_em_port>/em redirecting to oms for em

https://<slb_host_name>:<slb_ssa_port>/em redirecting to oms for ssa

SSAおよび非SSA OMSプールは、ポート番号で区別されます。特定のポート番号のリクエストはすべて特定のOMSプール(SSA OMSプール)にリダイレクトされ、他のリクエストはすべて他のプールにリダイレクトされます。

4 クラウドの有効化の方法

この章では、IaaSクラウドまたはPaaSクラウドを有効にするために実行されるタスクを示しています。内容は次のとおりです。

- Enterprise Managerのクラウド・デプロイメント・モデル

- Infrastructure as a Service (IaaS)の有効化

- Platform as a Service (PaaS)の有効化

- Middleware as a Service (MWaaS)の有効化

- Testing as a Service (TaaS)の有効化

4.1 Enterprise Managerのクラウド・デプロイメント・モデル

図4-1に、Enterprise Managerによりサポートされるクラウド・デプロイメント・モデルを示します。

図4-1 クラウド・デプロイメント・モデル

次の項に、様々なクラウド・デプロイメント・モデルを設定および使用するために実行する必要のあるタスクを示します。これらのタスクとは別に、適切なプラグインがデプロイされていることも確認する必要があります。必要なプラグインの詳細は、「サポートされているプラグイン」を参照してください。

4.2 Infrastructure as a Service (IaaS)の有効化

この項では、スーパー管理者、EM_CLOUD_ADMINISTRATOR、EM_SSA_ADMINISTRATORおよびEM_SSA_USERロールを持つユーザーが、IaaSを設定および使用するために実行する必要のあるタスクについて説明します。

4.2.1 Infrastructure as a Service (IaaS): スーパー管理者のタスク

この項では、スーパー管理者が実行できるタスクを示します。

表4-1 スーパー管理者ユーザーのタスク(IaaS)

クラウド・サービス・モデル

ユースケース

Infrastructure as a Service (IaaS)

- ロールの定義およびユーザーの割当て

4.2.2 Infrastructure as a Service (IaaS): クラウド管理者のタスク

この項では、EM_CLOUD_ADMINISTRATORロールを持つユーザーが、IaaSのために実行できるタスクを示します。

表4-2 クラウド管理者のタスク(IaaS)

クラウド・サービス・モデル

ユースケース

Infrastructure as a Service (IaaS)

- Oracle VM Managerの登録

- Oracle VM Managerターゲットの同期

- 仮想サーバーの検出

- 仮想サーバーの再検出

- ネットワークの設定

- ネットワーク・プロファイルの作成

- 記憶域リポジトリの作成

- 記憶域リポジトリの提示

- 記憶域リポジトリへのアセンブリ、テンプレートおよび仮想ディスクのインポート

- 仮想サーバー・プールの作成

- ゾーンの作成

- 記憶域のサービスのクオリティ(QoS)の設定

- Oracle VM Serverへのパッチ適用

- OVMイベントの確認

- クラウド・ポリシーの管理

- クラウド・ポリシーの表示

- ターゲットのポリシーの表示

- パフォーマンス・ポリシーの定義

- スケジュール・ベース・ポリシーの定義

- ポリシーのアクティブ化および非アクティブ化

- ポリシー・グループの表示

- DRSおよびDPMポリシー

チャージバック

- チャージバックの概要

- チャージバックの設定

- チャージバック情報へのアクセス

統合プランナ

- 統合プランナの概要

- 統合プランナの使用

4.2.3 Infrastructure as a Service (IaaS): セルフ・サービス管理者のタスク

この項では、EM_SSA_ADMINISTRATORロールを持つユーザーが、IaaSのために実行する必要のあるタスクを示します。

表4-3 SSA管理者のタスク(IaaS)

クラウド・サービス・モデル

ユースケース

Infrastructure as a Service (IaaS)

- セルフ・サービス・ポータルの設定

- インフラストラクチャ・クラウドのホームページの表示

- OVMマネージャ・ホームページの表示

- メンバーの表示および管理

- 仮想サーバー・プール・ホームページの表示

- ゲスト仮想マシンの管理

- ゲスト仮想マシンのデプロイ

- インフラストラクチャ・リクエスト・ダッシュボードの表示

- リクエスト詳細の表示

4.2.4 Infrastructure as a Service (IaaS): セルフ・サービス・ユーザーのタスク

この項では、次のロールを持つユーザーが、IaaSのために実行できるタスクを示します。

- EM_SSA_USER: このロールを持つユーザーは、デフォルトで、セルフ・サービス・ポータルおよびすべてのサービス・ファミリにのみアクセスできます。

- EM_SSA_USER_BASE: このロールを持つユーザーは、セルフ・サービス・ポータルにアクセスできますが、どのサービス・ファミリにもアクセスできません。このロールを持つユーザーには、特定のIaaSサービス・ファミリに対するアクセス権を明示的に付与する必要があります。詳細は、第3.3.1.3項「EM_SSA_USER_BASEロールに基づくカスタム・ロールの作成」を参照してください。

表4-4 SSAユーザーのタスク(IaaS)

クラウド・サービス・モデル

ユースケース

Infrastructure as a Service (IaaS)

- セルフ・サービス・ポータルを使用したサーバー・リソースのリクエスト

- サーバーのリクエスト

4.3 Platform as a Service (PaaS)の有効化

この項では、スーパー管理者、EM_CLOUD_ADMINISTRATOR、EM_SSA_ADMINISTRATORおよびEM_SSA_USERロールを持つユーザーが、PaaSを設定および使用するために実行する必要のあるタスクについて説明します。

4.3.1 Platform as a Service (PaaS): スーパー管理者のタスク

この項では、スーパー管理者ロールを持つユーザーが、PaaSのために実行する必要のあるタスクを示します。

表4-5 スーパー管理者ユーザーのタスク(PaaS)

クラウド・サービス・モデル

ユースケース

Platform as a Service (PaaS)

- Database as a Service (DBaaS)

- Middleware as a Service (MWaaS)

- ロールの定義およびユーザーの割当て

- 権限委任設定の構成

4.3.2 Platform as a Service (PaaS): クラウド管理者のタスク

この項では、EM_CLOUD_ADMINISTRATORロールを持つユーザーが、PaaSのために実行する必要のあるタスクを示します。

表4-6 クラウド管理者のタスク(PaaS)

クラウド・サービス・モデル

ユースケース

Platform as a Service (PaaS)

- ホストの追加

- PaaSインフラストラクチャ・ゾーンの作成

4.3.3 Platform as a Service (PaaS): ストレージ管理者のタスク

この項では、EM_STORAGE_ADMINISTRATORロールを持つユーザーが、PaaSのために実行する必要のあるタスクを示します。

表4-7 ストレージ管理者のタスク(PaaS)

クラウド・サービス・モデル

ユースケース

Platform as a Service (PaaS)

- ストレージ・サーバーの登録および管理

4.3.4 Platform as a Service (PaaS): セルフ・サービス管理者のタスク

この項では、EM_SSA_ADMINISTRATORロールを持つユーザーが、PaaSのために実行する必要のあるタスクを示します。

表4-8 SSA管理者のタスク(PaaS)

クラウド・サービス・モデル

ユースケース

Platform as a Service (PaaS)

- リクエスト設定の構成

- リソース・プロバイダの作成

- 割当て制限の設定

- クラウド・ホームページの表示

- リソース・プロバイダのリストの表示

- サービス・テンプレートのリストの表示

- サービス・インスタンスのリストの表示

- 「クラウド」の「リクエスト・ダッシュボード」の表示

- すべてのクラウド・リクエストの表示

- PaaSインフラストラクチャ・ゾーン・ホーム・ページの表示

4.4 Database as a Serviceの有効化

注意:
Database as a Serviceを有効にする前に、第4.3項「Platform as a Service (PaaS)の有効化」で示したタスクを実行しておく必要があります。

この項では、様々なDatabase as a Service (DBaaS)オプションを有効にするために実行する必要のあるタスクについて説明します。

- データベース・アーティファクトのプロビジョニング

- データベースのクローニング

4.4.1 データベース・アーティファクトのプロビジョニング

ここでは、以下の項目について説明します。

- データベース・テンプレートを使用したデータベースの作成

- スキーマの作成

- プラガブル・データベースのプロビジョニング

4.4.1.1 データベース・テンプレートを使用したデータベースの作成

この項には、データベース・テンプレートを使用して新しいデータベースを作成するために実行する必要があるタスクをリストします。

表4-9 SSA管理者のタスク(データベース・テンプレート)

ユーザー・ロール

ユースケース

EM_SSA_ADMINISTRATOR

- 開始

- リソース・プロバイダの作成

- データベース・テンプレートを使用したデータベース・プロビジョニング・プロファイルの作成

- リクエスト設定の構成

- 割当て制限の定義

- データベース・テンプレート・プロファイルを使用したサービス・テンプレートの作成

- チャージバックの構成

表4-10 SSAユーザーのタスク(データベース・テンプレート)

ユーザー・ロール

ユースケース

EM_SSA_USER

データベースのリクエスト

4.4.1.2 スキーマの作成

この項には、データベース・テンプレートを使用して新しいスキーマをプロビジョニングするために実行する必要があるタスクをリストします。

表4-11 SSA管理者のタスク(スキーマ)

ユーザー・ロール

ユースケース

EM_SSA_ADMINISTRATOR

- 開始

- リソース・プロバイダの作成

- エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成(空のスキーマを作成する場合、このステップは必要ありません)

- リクエスト設定の構成

- 割当て制限の定義

- プロファイルに基づくスキーマのサービス・テンプレートの作成または

- 空のスキーマでのサービス・テンプレートの作成

- チャージバックの構成

表4-12 SSAユーザーのタスク(スキーマ)

ユーザー・ロール

ユースケース

EM_SSA_USER

スキーマのリクエスト

4.4.1.3 プラガブル・データベースのプロビジョニング

この項には、データベース・テンプレートを使用してプラガブル・データベースをプロビジョニングするために実行する必要があるタスクをリストします

表4-13 SSA管理者のタスク(プラガブル・データベース)

ユーザー・ロール

ユースケース

EM_SSA_ADMINISTRATOR

- 開始

- リソース・プロバイダの作成

- エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成(空のPDBを作成する場合、このステップは必要ありません)

- リクエスト設定の構成

- 割当て制限の定義

- プロファイルに基づくPDBのサービス・テンプレートの作成
または

- 空のPDBのサービス・テンプレートの作成

- チャージバックの構成

表4-14 SSAユーザーのタスク(プラガブル・データベース)

ユーザー・ロール

ユースケース

EM_SSA_USER

プラガブル・データベースのリクエスト

4.4.2 データベースのクローニング

ここでは、以下の項目について説明します。

- フル・クローンの作成

- スナップ・クローンの作成

- プラガブル・データベースのスナップ・クローンの作成

4.4.2.1 フル・クローンの作成

ここでは、以下の項目について説明します。

- RMANバックアップを使用したフル・データベース・クローンの作成

- RMAN複製を使用したフル・データベース・クローンの作成

4.4.2.1.1 RMANバックアップを使用したフル・データベース・クローンの作成

この項には、RMANバックアップを使用してフル・クローンを作成するために実行する必要があるステップをリストします。

表4-15 SSA管理者のタスク(RMANバックアップを使用したフル・クローンの作成

ユーザー・ロール

ユースケース

EM_SSA_ADMINISTRATOR

- 開始

- リソース・プロバイダの作成

- データベース・プロビジョニング・プロファイルの作成

- リクエスト設定の構成

- 割当て制限の定義

- RMANバックアップ・プロファイルを使用したサービス・テンプレートの作成

- チャージバックの構成

表4-16 SSAユーザーのタスク(RMANバックアップを使用したフル・クローンの作成)

ユーザー・ロール

ユースケース

EM_SSA_USER

データベースのリクエスト

4.4.2.1.2 RMAN複製を使用したフル・データベース・クローンの作成

この項には、RMAN複製を使用してフル・クローンを作成するために実行する必要があるステップをリストします。

表4-17 SSA管理者のタスク(RMAN複製を使用したフル・クローンの作成

ユーザー・ロール

ユースケース

EM_SSA_ADMINISTRATOR

- 開始

- リソース・プロバイダの作成

- データベース・プロビジョニング・プロファイルの作成

- リクエスト設定の構成

- 割当て制限の定義

- RMAN複製を使用したサービス・テンプレートの作成

- チャージバックの構成

表4-18 SSAユーザーのタスク(RMAN複製を使用したフル・クローンの作成)

ユーザー・ロール

ユースケース

EM_SSA_USER

データベースのリクエスト

4.4.2.2 スナップ・クローンの作成

ここでは、以下の項目について説明します。

- クローニング・ダッシュボードからのスナップ・クローンの作成

- 同期テスト・マスターからのスナップ・クローンの作成

- 個別に同期されたテスト・マスターからのスナップ・クローンの作成

- CloneDBデータベースの作成

4.4.2.2.1 クローニング・ダッシュボードからのスナップ・クローンの作成

この項には、クローニング・ダッシュボードからスナップ・クローン・データベースの作成および更新を実行するのに必要な手順をリストしています。手順は次のとおりです。

- スナップ・クローン・データベースの作成

- Exadataテスト・マスター・データベースの作成

- Exadataテスト・マスター・データベースのスナップショット・クローンの作成

- テスト・マスター・データベースの有効化

- テスト・マスター・データベースの無効化

- CloneDBデータベースの作成

- クローン・データベースの管理

- クローン・データベースのリフレッシュ

4.4.2.2.2 同期テスト・マスターからのスナップ・クローンの作成

この項には、同期テスト・マスターからスナップ・クローンを作成するために実行する必要があるステップをリストします。

表4-19 SSA管理者のタスク(同期テスト・マスターからスナップ・クローン)

ユーザー・ロール

ユースケース

EM_SSA_ADMINISTRATOR

- 開始

- ストレージ・サーバーの登録

- リソース・プロバイダの作成

- リクエスト設定の構成

- 割当て制限の定義

- テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用

- スナップ・クローンのテスト・マスターの有効化

- スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成

- スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成

- チャージバックの構成

表4-20 SSAユーザーのタスク(同期テスト・マスターからスナップ・クローン)

ユーザー・ロール

ユースケース

EM_SSA_USER

データベースのリクエスト

4.4.2.2.3 個別に同期されたテスト・マスターからのスナップ・クローンの作成

この項には、個別に同期されたテスト・マスターからスナップ・クローンを作成するために実行する必要があるステップをリストします。

表4-21 SSA管理者のタスク(スナップ・クローン - 個別同期)

ユーザー・ロール

ユースケース

EM_SSA_ADMINISTRATOR

- 開始

- ストレージ・サーバーの登録

- リソース・プロバイダの作成

- リクエスト設定の構成

- 割当て制限の定義

- 個別に同期されたテスト・マスターの作成

- スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成

- チャージバックの構成

表4-22 SSAユーザーのタスク(スナップ・クローン - 個別同期)

ユーザー・ロール

ユースケース

EM_SSA_USER

データベースのリクエスト

4.4.2.2.4 テスト・マスターとデータベース・インスタンスの進行中リフレッシュ

テスト・マスターが最新の本番データを持ち、データベース・インスタンスが最新情報を反映するようにするには、次のステップを実行する必要があります。

- テスト・マスター・データベースのリフレッシュ

- スナップショット・プロファイルのリフレッシュ

- データベースのリフレッシュ

4.4.2.2.5 CloneDBデータベースの作成

この項には、CloneDBデータベースを作成するために実行する必要があるステップをリストします。

表4-23 SSA管理者のタスク(スナップ・クローン - 個別同期)

ユーザー・ロール

ユースケース

EM_SSA_ADMINISTRATOR

- 開始

- リソース・プロバイダの作成

- リクエスト設定の構成

- 割当て制限の定義

- RMANデータベース・イメージを使用したデータベース・プロビジョニング・プロファイルの作成

- RMANイメージ・プロファイルを使用したサービス・テンプレートの作成

- チャージバックの構成

表4-24 SSAユーザーのタスク(スナップ・クローン - 個別同期)

ユーザー・ロール

ユースケース

EM_SSA_USER

データベースのリクエスト

4.4.2.3 プラガブル・データベースのスナップ・クローンの作成

この項には、テスト・マスター・プラガブル・データベースとプラガブル・データベースのスナップショット・クローンを作成する際に使用できる様々なソリューションについてリストします。

- テスト・マスター・プラガブル・データベースの作成

- テスト・マスター・プラガブル・データベースのスナップショット・クローンの作成

- テスト・マスター・プラガブル・データベースの有効化

- テスト・マスター・プラガブル・データベースの無効化

4.5 Middleware as a Service (MWaaS)の有効化

注意:
Middleware as a Serviceを有効にする前に、第4.3項「Platform as a Service (PaaS)の有効化」で示したタスクを実行しておく必要があります。

この項では、EM_CLOUD_ADMINISTRATOR、EM_SSA_ADMINISTRATORおよびEM_SSA_USERロールを持つユーザーが、MWaaSを設定および使用するために実行する必要のあるタスクについて説明します。

4.5.1 Middleware as a Service (MWaaS): クラウド管理者のタスク

この項では、EM_CLOUD_ADMINISTRATORロールを持つユーザーが、MWaaSのために実行する必要のあるタスクを示します。

表4-25 クラウド管理者のタスク(MWaaS)

クラウド・サービス・モデル

ユースケース

Middleware as a Service (MWaaS)

- Middleware as a Serviceの開始

- ソフトウェア・ライブラリへのJava EEコンポーネントのアップロード

4.5.2 Middleware as a Service (MWaaS): セルフ・サービス管理者のタスク

この項では、EM_SSA_ADMINISTRATORロールを持つユーザーが、MWaaSのために実行する必要のあるタスクを示します。

表4-26 SSA管理者のタスク(MWaaS)

クラウド・サービス・モデル

ユースケース

Middleware as a Service (MWaaS)

- ミドルウェア・プールの作成

- リクエスト設定の構成

- 割当て制限の設定

- WebLogicサービス・テンプレートの作成

- チャージバックの構成

4.5.3 Middleware as a Service (MWaaS): セルフ・サービス・ユーザーのタスク

この項では、次のいずれかのロールを持つユーザーが、MWaaSのために実行する必要のあるタスクを示します。

- EM_SSA_USER: このロールを持つユーザーは、デフォルトで、セルフ・サービス・ポータルおよびすべてのサービス・ファミリにのみアクセスできます。

- EM_SSA_USER_BASE: このロールを持つユーザーは、セルフ・サービス・ポータルにアクセスできますが、どのサービス・ファミリにもアクセスできません。このロールを持つユーザーには、MWaaSサービス・ファミリに対するアクセス権を明示的に付与する必要があります。詳細は、第3.3.1.3項「EM_SSA_USER_BASEロールに基づくカスタム・ロールの作成」を参照してください。

表4-27 SSAユーザーのタスク(MWaaS)

クラウド・サービス・モデル

ユースケース

Middleware as a Service (MWaaS)

- MWaaSセルフ・サービス・ポータルの使用

- ミドルウェア・サービスのリクエスト

- Middleware Serviceホーム・ページの表示

- アプリケーション・ホームページの表示

- ソフトウェア・ライブラリへのJava EEコンポーネントのアップロード

4.6 Testing as a Service (TaaS)の有効化

この項では、EM_CLOUD_ADMINISTRATOR、EM_SSA_ADMINISTRATORおよびEM_SSA_USERロールを持つユーザーが、TaaSを設定および使用するために実行する必要のあるタスクについて説明します。

4.6.1 Testing as a Service (TaaS): クラウド管理者のタスク

この項では、EM_CLOUD_ADMINISTRATORロールを持つユーザーが、TaaSのために実行する必要のあるタスクを示します。

表4-28 クラウド管理者のタスク(TaaS)

クラウド・サービス・モデル

ユースケース

Testing as a Service (TaaS)

- 開始

- テスト管理者の作成

- アセンブリ・コンポーネントの作成

- デプロイメント・プランの作成

4.6.2 Testing as a Service (TaaS): セルフ・サービス管理者のタスク

この項では、EM_SSA_ADMINISTRATORを持つユーザーが、TaaSのために実行する必要のあるタスクを示します。

表4-29 SSA管理者のタスク(TaaS)

クラウド・サービス・モデル

ユースケース

Testing as a Service (TaaS)

- 開始

- テスト管理者の作成

- アセンブリ・コンポーネントの作成

- デプロイメント・プランの作成

4.6.3 Testing as a Service (TaaS): セルフ・サービス・ユーザーのタスク

この項では、次のいずれかのロールを持つユーザーが、TaaSのために実行する必要のあるタスクを示します。

- EM_SSA_USER: このロールを持つユーザーは、デフォルトで、セルフ・サービス・ポータルおよびすべてのサービス・ファミリにのみアクセスできます。

- EM_SSA_USER_BASE: このロールを持つユーザーは、セルフ・サービス・ポータルにアクセスできますが、どのサービス・ファミリにもアクセスできません。このロールを持つユーザーには、TaaSサービス・ファミリに対するアクセス権を明示的に付与する必要があります。詳細は、第3.3.1.3項「EM_SSA_USER_BASEロールに基づくカスタム・ロールの作成」を参照してください。

表4-30 SSAユーザーのタスク(TaaS)

クラウド・サービス・モデル

ユースケース

Testing as a Service (TaaS)

サービスとしてのテスト・ポータルの使用

第III部

Infrastructure as a Serviceの設定および使用

ここでは、Infrastructure as a Serviceの設定方法、仮想化ターゲットの管理、ゲスト仮想マシンのデプロイ、およびSelf Serviceアプリケーションの設定および使用について説明します。

内容は次のとおりです。

- 第5章「IaaS用のクラウドの設定」

- 第6章「クラウド・ポリシーの定義および管理」

- 第7章「IaaSセルフ・サービス・ポータルの設定」

- 第8章「IaaSセルフ・サービス・ポータルの使用」

- 第9章「IaaSクラウドの管理および監視」

5 IaaS用のクラウドの設定

この章では、Oracle VMテクノロジを使用してInfrastructure as a Service(IaaS)クラウドを提供するために定義する必要のある、サーバー、ストレージおよびネットワークのインフラストラクチャについて説明します。内容は次のとおりです。

- 開始

- クラウド・インフラストラクチャの権限

- Oracle VM Managerの登録

- Oracle VM Managerターゲットの同期

- 仮想サーバーの検出

- 仮想サーバーの再検出

- ネットワークの設定

- ネットワーク・プロファイルの作成

- ストレージ・サーバーの登録

- 記憶域リポジトリの作成

- 記憶域リポジトリの提示

- 自己更新を使用したOracle VM TemplatesおよびVirtual Assembliesのダウンロード

- 記憶域リポジトリへのアセンブリ、テンプレートおよび仮想ディスクのインポート

- 仮想サーバー・プールの作成

- ゾーンの作成

- 記憶域のサービスのクオリティ(QoS)の設定

- Oracle VM Serverへのパッチ適用

- OVMイベントの確認

- NTP構成の管理

- 仮想マシンのインポート

- リポジトリ・イベントの確認

5.1 開始

この項では、この章に取り組むための手引きとして、仮想化インフラストラクチャの設定手順の概要を説明します。このセクションは、仮想化システムの設定を成功させるために必要な一連の処理を理解するためのドキュメント・マップと考えてください。

注意:
ここをクリックすると、Oracle Enterprise Manager Cloud Control 12cを使用して、クラウド内でのOVMサーバーの検出、クラウド用のストレージの構成、ネットワークの構成、およびサーバー・プールとクラウド・ゾーンの作成を行う方法について、視覚的デモンストレーションを参照できます。

1. 仮想化ターゲットの監視および管理を開始する前に、Oracle Enterprise ManagerでOracle VM Managerを登録します。詳細は、第5.3項「Oracle VM Managerの登録」を参照してください。

2. その後、1つ以上のOracle VM Serverのターゲットを検出できます。詳細は、第5.5項「仮想サーバーの検出」を参照してください。

3. クラウドのストレージ・インフラストラクチャを設定します。詳細は、第5.9項「ストレージ・サーバーの登録」を参照してください。

4. ネットワークおよびVLANグループの構成詳細は、第5.7項「ネットワークの設定」を参照してください。
Oracle VM Manager 3.3を使用している場合には、VLANインタフェースを構成する必要があります。5.7.3項「Oracle VM Manager 3.3用のVLANインタフェースの作成」を参照してください。

5. 仮想サーバー・プールを作成します。詳細は、第5.14項「仮想サーバー・プールの作成」を参照してください。

6. 1つ以上のサーバー・プールをグループ化し、ゾーンを作成します。詳細は、第5.15項「ゾーンの作成」を参照してください。

図5-1は、仮想化インフラストラクチャの設定手順の流れを示しています。

図5-1 クラウド・インフラストラクチャの設定

5.2 クラウド・インフラストラクチャの権限

この項では、次を行った場合の、インフラストラクチャ・クラウドホーム・ページの様々なターゲットで実行できるアクションを示します。

- 左側のパネルでターゲットを右クリックする。

- 親ターゲットのホーム・ページにある「メンバー」リージョンでターゲットを選択し、「アクション」メニューを選択する。

- 対応するターゲット・ホーム・ページの「ターゲット」メニューを選択する。

表5-1 インフラストラクチャ・クラウド

アクション・レベル

複数選択/単一選択

必要なターゲット状態

必要な権限

OVMマネージャの登録

単一

任意のターゲットの追加

設定

単一

インフラストラクチャ・クラウドでの表示

メンバー

単一

インフラストラクチャ・クラウドでの操作

表5-2 OVMマネージャ

アクション・レベル

複数選択/単一選択

必要なターゲット状態

必要な権限

メンバー

単一

OVMマネージャでの表示

編集

単一

OVMマネージャでの操作

同期化

単一

OVMマネージャでフル

登録解除

単一

OVMマネージャおよびそのすべてのサブ・ターゲットでフル

ゾーンの作成

単一

OVMマネージャでの操作および任意のターゲットの追加

仮想サーバー・プールの作成

単一

OVMマネージャでの操作および任意のターゲットの追加

仮想サーバーの検出

単一

OVMマネージャでの操作および任意のターゲットの追加

未所有の仮想サーバーの管理

単一

OVMマネージャでの操作

ネットワークの管理

単一

OVMマネージャでの操作

記憶域の管理

単一

OVMマネージャでの操作

記憶域リポジトリの管理

単一

OVMマネージャでの操作

Yumリポジトリの管理

単一

OVMマネージャでフル

NTP構成の管理

単一

OVMマネージャでフル

表5-3 ゾーン

アクション・レベル

複数選択/単一選択

必要なターゲット状態

必要な権限

メンバー

単一

ゾーンでの表示

編集

単一

ゾーンでの操作

削除

単一

ゾーンでフル

Enterprise Managerからのみ削除

単一

ゾーンでフル

アセンブリのデプロイ

単一

ゾーンでの操作および任意のターゲットの追加

テンプレートのデプロイ

単一

ゾーンでの操作および任意のターゲットの追加

ISOのデプロイ

単一

ゾーンでの操作および任意のターゲットの追加

PXEのデプロイ

単一

ゾーンでの操作および任意のターゲットの追加

仮想マシンのインポート

単一

ゾーンでの操作および任意のターゲットの追加

表5-4 仮想サーバー・プール

アクション・レベル

複数選択/単一選択

必要なターゲット状態

必要な権限

メンバー

単一

仮想サーバー・プールでの表示

編集

単一

仮想サーバー・プールでの操作

削除

単一

仮想サーバー・プールでフル

Enterprise Managerからのみ削除

単一

仮想サーバー・プールでフル

DRS/DPMポリシーの管理

単一

仮想サーバー・プールでの操作

アセンブリのデプロイ

単一

仮想サーバー・プールでの操作および任意のターゲットの追加

テンプレートのデプロイ

単一

仮想サーバー・プールでの操作および任意のターゲットの追加

ISOのデプロイ

単一

仮想サーバー・プールでの操作および任意のターゲットの追加

PXEのデプロイ

単一

仮想サーバー・プールでの操作および任意のターゲットの追加

仮想マシンのインポート

単一

ゾーンでの操作および任意のターゲットの追加

表5-5 仮想サーバー

アクション・レベル

複数選択/単一選択

必要なターゲット状態

必要な権限

編集

単一

稼働中

仮想サーバーでの操作

登録解除

単一

仮想サーバーでフル

Enterprise Managerからのみ削除

単一

仮想サーバーでフル

メンテナンスの開始

複数

稼働中

仮想サーバーでの操作

メンテナンスの終了

複数

ブラックアウト

仮想サーバーでの操作

アップグレード

複数

仮想サーバーでフル

開始

複数

停止中

仮想サーバーでの操作

停止

複数

稼働中

仮想サーバーでの操作

再起動

複数

稼働中

仮想サーバーでの操作

仮想サーバーの再検出

単一

仮想サーバーでフル

アセンブリのデプロイ

単一

仮想サーバーでの操作および任意のターゲットの追加

テンプレートのデプロイ

単一

仮想サーバーでの操作および任意のターゲットの追加

ISOのデプロイ

単一

仮想サーバーでの操作および任意のターゲットの追加

PXEのデプロイ

単一

仮想サーバーでの操作および任意のターゲットの追加

仮想マシンのインポート

単一

ゾーンでの操作および任意のターゲットの追加

メンバー

複数選択/単一選択: 単一

仮想サーバーでの表示

表5-6 ゲストVM

アクション・レベル

複数選択/単一選択

必要なターゲット状態

必要な権限

編集

単一

ゲストVMでの操作

削除

複数

停止中、メトリック・エラー

ゲストVMでフル

Enterprise Managerからのみ削除

複数

ゲストVMでフル

移行

複数

稼働中、停止中

ゲストVMでの操作

移動

単一

停止中

ゲストVMでの操作

クローン

単一

稼働中、停止中

ゲストVMでの操作

テンプレートとして保存

単一

停止中

ゲストVMでの操作

開始

複数

停止中

ゲストVMでの操作

停止

複数

稼働中

ゲストVMでの操作

再起動

複数

稼働中

ゲストVMでの操作

強制終了

複数

稼働中

ゲストVMでの操作

停止および起動

複数

稼働中

ゲストVMでの操作

一時停止

複数

稼働中

ゲストVMでの操作

再開

複数

ゲストVMでの操作

VNCコンソールの起動

単一

ゲストVMでの操作

表5-7 アセンブリ

アクション・レベル

複数選択/単一選択

必要なターゲット状態

必要な権限

開始

単一

アセンブリでの操作

停止

単一

アセンブリでの操作

削除

単一

アセンブリでの操作

スケール・アップ

単一

アセンブリでの操作

スケール・ダウン

単一

アセンブリでの操作

ノードの追加

単一

アセンブリでの操作

表5-8 層

アクション・レベル

複数選択/単一選択

必要なターゲット状態

必要な権限

開始

単一

層での操作

停止

単一

層での操作

スケール・アップ

単一

層での操作

スケール・ダウン

単一

層での操作

5.3 Oracle VM Managerの登録

Oracle VMマネージャは、ゾーン、仮想サーバー・プール、仮想サーバー、およびゲスト仮想マシンの作成と監視を可能にする、ユーザー・インタフェースを提供します。Enterprise Manager内の仮想ターゲットの管理にOracle VM Managerを使用する前に、Oracle VM Managerの既存のインストールを登録する必要があります。

注意:

- Enterprise Managerで登録するOracle VM Manageは、バージョン3.0.2以上が必要です。

- Oracle VM Managerは1つのEnterprise Managerインストールのみに関連付けられている必要があります。

- 管理エージェントとOracle VM Managerが同じ物理マシンにあることが推奨されます。

- Oracle VM Manager 3.3を登録するには、Enterprise Manager for Oracle Virtualization (Oracle Virtualization)プラグイン12.1.0.7以降がOracle Management Serviceおよび管理エージェント上にデプロイされていることを確認する必要があります。

Oracle VM Managerを登録するには、まずそれをEnterprise Managerのターゲットとして追加します。次の手順を実行します。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

図5-2 インフラストラクチャ・クラウド・ホーム

2. 「インフラストラクチャ・クラウド」メニューから「OVMマネージャへの登録」を選択します。Oracle VM Managerの追加ページが表示されます。

3. 図5-3 Oracle VM Managerの追加

次の手順でOracle VMマネージャの既存のインストールを登録できます。
前提条件

- OVM Manager 3.1.1以降を登録している場合、Oracle VM Manager URLを更新する前に、ノート1490283.1に記載されているTCPSを構成しておく必要があります。

- 次の手順に従って、証明書をエージェント・キーストアにインポートしておく必要があります。

- OVM Manager証明書のエクスポート<JAVA_HOME>/bin/keytool -keystore <OVM_MANAGER_HOME>/ovmmCoreTcps.ks -exportcert -alias ovmm -file <file_loc_for_certificate>

- OVM Manager証明書のインポート<AGENT_INSTANCE_HOME>/bin/emctl secure add_trust_cert_to_jks -trust_certs_loc <file_loc_for_certificate> -alias <alias_name>
証明書が複数のOracle VM Managerにインポートされる場合には、複数の別名を指定できます。

- Oracle VM Manager 3.3を登録するには、Oracle VM Manager証明書のインポートに加えて、Oracle VM Manager WebLogic証明書のエクスポートとエージェント・キーストアの証明書のインポートを行う必要があります。詳細は、5.3.3項「Oracle VM Manager WebLogic証明書のインポート」を参照してください。

1. 登録するOracle VM Managerインスタンスのターゲット名を入力します。

2. 登録するOracle VM Managerインスタンスを監視および管理するための管理エージェントを選択します。管理エージェント(「自己更新」にOracle Virtualizationと表示されるEnterprise Manager for Oracle Virtualizationプラグインを使用)が、Oracle VM Managerインスタンスを実行しているマシンと同じマシン上に存在していることをお薦めします。

3. Oracle VM Manager URLを入力します。Oracle VM ManagerにTCPSアクセスを構成する方法の詳細は、ノート1490283.1を参照してください。
URLは次のいずれかの形式である必要があります。

- tcp://localhost:<port> 例: tcp://localhost:54321 (Oracle VM Managerのバージョンが3.1.1以上の場合、tcps URLのみを指定できます)

- tcps://<hostname:<port> 例: tcps://server.domain:54322

4. Oracle VM ManagerのコンソールURLを入力します。これは、ゲストVM用にVNCコンソールを有効化するURLです。たとえば、https://ovmmgr.example.com:7002/ovm/consoleなどです。
このURLは次の書式で記述する必要があります。

https://<hostname>:<port>

注意:
Oracle VM Manager 3.3を登録するには、このURLをOracle VM Managerへの接続に使用します。

5. デフォルトでOracle VM Managerからのデータは、一定時間間隔でEnterprise Managerとの自動同期が行われます。このオプションを有効にしない場合には、「自動同期」チェックボックスの選択を解除してデータを手動で同期します。自動および手動の同期オプションの詳細は、第5.4項「Oracle VM Managerターゲットの同期」を参照してください。

6. ステップCで指定したOracle VM Manager URLに接続するための管理者ユーザー名およびパスワードを入力します。Oracle VM Managerの管理に別の資格証明を使用する場合は、「管理資格証明の使用」チェック・ボックスを選択します。この資格証明を指定しない場合は、デフォルトで監視資格証明が使用されます。

7. 「発行」をクリックし、Oracle VM Managerを登録します。これで、Oracle VM Managerを使用してEnterprise Manager内の仮想化ターゲットを監視および管理できます。

5.3.1 Oracle VM Managerを設定するためのポート要件

WebブラウザによるOracle VM Managerへの接続に必要なポートは、7002および15901です。TCP 7002は、Oracle VM Managerに接続するためにOracle VM Serverにより使用されます。次に、Oracle VM Managerは、Oracle VM Agent通信用にポート8899、および仮想マシンへのセキュアなVNCトンネリング用(1つのVM当たり1つのポート)にポート6900以上を介してOracle VM Serverに接続します。ポート7900以上は、Oracle VM ManagerがOracle VM Server上の仮想マシンへのセキュアなシリアル・コンソール・トンネルを開くことを可能にします(VMごとに1つのポート)。Oracle VMコマンドライン・インタフェースは、ポート10000を介してOracle VM Managerに接続します。TCPポート54321および54322は、Oracle VM ManagerコアへのリモートAPIアクセス用に有効にする必要があります。次の図のガイドラインに従います。

図5-4 Oracle VM Managerのファイアウォール構成

5.3.2 Oracle VM Manager URLの更新

Enterprise Managerに以前登録されたOracle VM Manager 3.0.xがあり、それをバージョン3.1.xまたは3.2.1にアップグレードした場合、Oracle VM Manager URLを更新する必要があります。

バージョン3.3にアップグレードするには、WebLogic証明書もインポートする必要があります。詳細は、5.3.3項「Oracle VM Manager WebLogic証明書のインポート」を参照してください。

前提条件

- Oracle VM Manager URLを更新する前に、ノート1490283.1に記載されているTCPSを構成しておく必要があります。

- 次の手順に従って、証明書をエージェント・キーストアにインポートしておく必要があります。

- OVM Manager証明書のエクスポート<JAVA_HOME>/bin/keytool -keystore <OVM_MANAGER_HOME>/ovmmCoreTcps.ks -exportcert -alias ovmm -file <file_loc_for_certificate>

- OVM Manager証明書のインポート<AGENT_INSTANCE_HOME>/bin/emctl secure add_trust_cert_to_jks -trust_certs_loc <file_loc_for_certificate> -alias <alias_name>

Oracle VM Manager URLを更新するには、次の手順に従います。

1. アップグレードするOVM Managerターゲットを右クリックして、「編集」を選択します。

2. 「Oracle VM Manager」フィールドにtcpsベースのURL (tcps://hostname:port)を入力します。

注意:
tcpsベースのURLを使用することをお薦めします。しかし、Oracle VM Managerがインストールされているホストと同じホストで管理エージェントが実行中の場合、tcpベースのURL (tcp://localhost:54321)を使用できます。

5.3.3 Oracle VM Manager WebLogic証明書のインポート

Oracle VM Manager 3.3には、証明書ベースの認証およびWebベースのユーザー・インタフェースに使用されるSSL証明書への署名に使用される内部認証局(CA)が含まれています。Oracle VM Managerがインストールされると、証明書が自動的に生成されます。

Oracle VM Manager WebLogic証明書をエクスポートするには、次のコマンドを入力します。

#/u01/app/oracle/ovm-manager-3/ovm_upgrade/bin/ovmkeytool.sh exportca > <file_loc_for_certificate>

エージェント・キーストアにOracle VM Manager WebLogic証明書をインポートするには、次のコマンドを入力します。

<AGENT_INSTANCE_HOME>/bin/emctl secure add_trust_cert_to_jks -trust_certs_loc <file_loc_for_certificate> -alias <alias_name>

注意:
<file_loc_for_certificate>の最初の行は、OVM Manager証明書のインポート前に削除する必要があります。

5.3.4 Oracle VM Managerの検出および昇格(オプション)

自動検出は、ホスト、Oracle VM Managerおよびその他のターゲットを検出して、Enterprise Managerで監視および管理できるようにするプロセスです。環境内のOracle VM Managerインスタンスが既知の場合、これらをEnterprise Managerに登録する手順の詳細は、第5.3項「Oracle VM Managerの登録」を参照してください。ネットワークをスキャンして未知のOracle VM Managerインスタンスを検出する場合は、Oracle VM Managerの検出と昇格を試行する必要があります。

Oracle VM Managerを検出するには、次の手順に従います。

1. スーパー管理者ロールを持つユーザーとしてEnterprise Managerにログインします。

2. 「設定」メニューから、「ターゲットの追加」、「自動検出の構成」の順に選択します。

図5-5 自動検出の構成

3. 「ネットワーク・スキャン・ベースの自動検出」表の「ホストおよびOracle VM Manager」行で、「ネットワーク・スキャンの検出の構成」をクリックします。ネットワークの検出ページが表示されます。このページを使用して、OVM Manager検出の指定を検索、参照および作成します。

図5-6 ネットワーク・スキャンの検出

4. 「作成」をクリックします。ネットワーク・スキャンの検出: 作成ページが表示されます。

図5-7 ネットワーク・スキャンの検出: 作成

5. 検出の指定の名前および説明を入力します。「ネットワーク・スキャン」領域で「追加」をクリックして、IPスキャンの実行時に使用するエージェントを選択します。各エージェントに、スキャンするIP範囲を指定します。サポートされている形式は、ホスト名、IPアドレス、IP範囲です。スペースを使用して値を区切ります。

6. ホストの検出の仕様: 作成ページの「ジョブ詳細」タブを使用し、検出IPスキャンをスケジュールします。すぐに開始するか、指定した時刻に開始することができます。「資格証明」セクションを使用して、ホストで優先する資格証明を入力します。「優先資格証明」、「名前付き資格証明」、「新規資格証明」から選択できます。検出IPスキャンはrootとして実行されます。Sudoを使用する特権ホスト資格証明か名前付き資格証明を設定する必要があります。

7. ホストの検出ページで、検出のステータスを確認し、新規に検出されたOVM Managerを表示できます。

8. ターゲットが検出された後、「設定」メニューから「ターゲットの追加」、「自動検出の結果」の順にクリックします。検出された管理対象外ターゲットを確認し、Enterprise Managerの管理対象にして監視する必要のあるターゲットを昇格できる自動検出の結果ページが表示されます。

9. ネットワーク・スキャンされたターゲット・タブの下部にある表に、ターゲット検出結果が表示されます。OVMマネージャ・ターゲットを選択し、「昇格」をクリックします。OVM Manager登録ページが表示されます。詳細は、第5.3項「Oracle VM Managerの登録」を参照してください。

5.3.5 構成の監視(OVM Manager)

OVM Managerターゲットの監視構成の詳細をカスタマイズまたは表示するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「インフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットをクリックします。

3. 「VMマネージャ」メニューから、「ターゲット設定」、「監視構成」の順に選択します。OVM Managerターゲットの監視構成ページが表示されます。

図5-8 構成の監視(OVM Manager)

4. 次の詳細が表示されます。

- LiveSyncEnabled: Enterprise ManagerとOracle VM Managerの間に自動同期が有効化されているかどうかを示します。デフォルトはtrueです。有効にすると、データは1分ごとに同期されます。

- デプロイメントのネットワーク構成のタイムアウト設定: アセンブリのデプロイメント中にネットワーク構成に許可された合計待機時間。デフォルトは60分です。

- OVMジョブの再試行回数: OVMジョブがリタイアする前に可能な試行数。デフォルトの試行回数は5です。

- OVMジョブの再試行スリープ間隔: 2つの続いたOVMジョブの再試行の間隔。デフォルトの間隔は5秒です。

- 短期で実行中のOVMジョブのタイムアウト値(分単位): OVMジョブの完了に許可される時間間隔。

- OVM ManagerコンソールのURL: VM用にVNCコンソールを起動するために使用するURL。

注意:
Oracle VM Manager 3.3ではこのURLをOracle VM Managerへの接続に使用します。

- OVM ManagerのURL: Enterprise ManagerとOracle VM Managerの間の通信に使用するOVM Manager登録URL。

- Oracle VM Managerパスワード: Oracle VM Managerへのアクセスに必要なパスワード。

- Oracle VM UUID: 内部Oracle VM識別子。

- Oracle VM Managerユーザー名: Oracle VM Managerへのアクセスに必要なユーザー名。

- デプロイメントの製品構成のタイムアウト設定: アセンブリのデプロイメント中に製品構成に許可された合計待機時間。デフォルトは60分です。

- SSHサービスがデプロイされた仮想マシンで実行しているかどうかをチェックするためのタイムアウト値: SSHサービスがゲストVM上で実行しているかどうかのチェックに許可されている合計待機時間。このパラメータは、ゲストVMに管理エージェントをデプロイするための前提条件として使用されます。

- SyncDataFetchTime: Oracle VM Managerが最後に同期された時刻。

- SyncStatus: Oracle VM Manager同期のステータス。

- Exalogicにデプロイされました: Oracle VM ManagerがExalogicラック内にあるかどうかを示します。

5. エントリを編集したら、「OK」をクリックして前ページに戻ります。

5.3.6 Oracle VM Managerのアップグレード

Enterprise ManagerおよびOracle VM Managerの以前のバージョンからOracle VM Manager 3.3にアップグレードするには、次の手順に従います。

1. Oracle Management Serviceを12.1.0.4にアップグレードして、Oracle Virtualization 12.1.0.7プラグインをデプロイします。

2. 管理エージェントを12.1.0.4にアップグレードして、Oracle Virtualization 12.1.0.7プラグインをデプロイします。

3. 古いOracle VM Managerターゲットをブラックアウトします。

4. Oracle VM Managerを3.3.1にアップグレードします。詳細は、Oracle VMインストレーションおよびアップグレード・ガイド、リリース3.3を参照してください。

5. Oracle VM Serverを3.3.1にアップグレードします。詳細は、Oracle VMインストレーションおよびアップグレード・ガイド、リリース3.3を参照してください。

6. WebLogic証明書をインポートします。詳細は、5.3.3項「Oracle VM Manager WebLogic証明書のインポート」を参照してください。

7. Oracle VM Managerターゲットのブラックアウトのステータスを変更します。

8. 必要な場合には、ターゲット・プロパティを追加または修正します。たとえば、Edit Oracle VM Managerページを使用したWebサービスのURLなどです。

5.4 Oracle VM Managerターゲットの同期

Enterprise Managerでは、OVMマネージャと、そのOVMマネージャに登録された様々な仮想化ターゲットを監視できます。OVMマネージャに登録されたターゲットは、Enterprise Managerの監視対象ターゲットでもある必要があります。OVM Managerで直接ターゲットを作成した場合、次の2つの方法でそれらを同期できます。

- 自動同期

- 手動同期

5.4.1 自動同期

Oracle VM Managerを登録または編集する際に、次のオプションを有効化できます。「自動同期」オプションを有効にした場合、Oracle VM Managerで行われたすべての変更は、一定間隔でEnterprise Managerに自動的に反映されます。デフォルトの間隔は1分間です。デフォルトの間隔を変更するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 右側のパネルでOracle VM Managerターゲットを選択して、Oracle VM Managerホーム・ページに移動します。

3. 「ターゲット」メニューから、「監視」、「メトリックと収集設定」の順に選択します。

4. 「収集されたその他のアイテム」をクリックし、OVM Managerイベント・データ・メトリックの「収集スケジュール」リンクをクリックします。

5. 必要に応じて頻度を変更し、「続行」、「OK」の順にクリックします。

注意:
現時点で自動同期を有効化していない場合、次の手順に従って、後で有効化できます。

- OVM Managerホームページに移動します。

- 「ターゲット」メニューから、「ターゲット設定」、「OVMマネージャの編集」の順に選択します。

- 「自動同期」チェック・ボックスを選択し、「発行」をクリックします。

5.4.2 手動同期

Oracle VM Managerが登録されると、Oracle VM Managerで作成されたターゲットに対して「自動同期」オプションを有効にした場合、対応するターゲットがEnterprise Managerに作成されます。このオプションを有効化しない場合、次の手順に従ってターゲットを手動で同期できます。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「同期化」を選択します。

3. 確認メッセージが表示されます。「発行」をクリックして、同期化を実行するためのジョブを発行します。Enterprise ManagerとOVMマネージャのターゲットが同期されます。

- OVMマネージャに存在しないターゲットは削除されます。

- OVMマネージャのみに存在するターゲットについては、対応するターゲットがEnterprise Managerに作成されます。

- 他のすべてのターゲットでは、構成収集がリフレッシュされます。

5.5 仮想サーバーの検出

仮想サーバーは、仮想化ソフトウェア(ハイパーバイザ)が実行されている物理ボックスを表すために使用される一般用語です。OVM Hypervisorをベアメタル・ボックスにインストールすることで、新しい仮想サーバーをプロビジョニングできます。仮想サーバーは、サーバー・プールに追加する前に検出されている必要があります。

Oracle VM Serverを検出する手順:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「仮想サーバーの検出」を選択します。

図5-9 仮想サーバーの検出

3. 仮想サーバーのホスト名またはIPアドレスを指定します。別々の行に複数のホスト名またはIPアドレスを入力できます。

4. 検出対象の仮想サーバーで実行されているOracle VMエージェントのユーザー名およびパスワードを入力します。

5. 「発行」をクリックして、仮想サーバーを検出します。

新しく検出されたOracle VM Serverにはそれ自体に関する基本的な情報およびネットワーク・ストレージへの即時接続性に関する情報が含まれますが、未構成状態とみなされます。ストレージおよびネットワークの構成が済むと、Oracle VM仮想サーバーをクラウド・インフラストラクチャとして使用する準備が整います。

5.6 仮想サーバーの再検出

仮想サーバーを再検出するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルで仮想サーバー・ターゲットを右クリックして、「仮想サーバーの再検出」を選択します。

3. 確認メッセージが表示されます。「OK」をクリックして仮想サーバーを再検出し、追加された新しいNICおよびLUNをすべて検出します。

5.7 ネットワークの設定

この項では、Oracle VMネットワークの作成および使用について説明します。各論理ネットワークに名前または別名を定義できます。ネットワークを作成したら、Oracle VM Serverの物理ネットワーク・ポートを論理ネットワークに接続します。Enterprise Managerで論理ネットワークを定義する前に、VLANやサブネットの使用状況など、使用する物理ネットワークの構成を確認する必要があります。Oracle VMネットワークの設定では、次の操作を実行します。

- MACアドレスの生成

- VLANグループ/インタフェースの作成と構成

- Oracle VM Manager 3.2以前のバージョンに対するVLANグループの構成

- Oracle VM Manager 3.3用のVLANインタフェースの作成

- ネットワークの作成

図5-10 ネットワークの設定

注意:
Oracle VM Manager 3.3では、VLANグループはVLANインタフェースに置き換えられました。VLANインタフェースを構成する際には、VLANセグメントIDおよびインタフェースが作成されるポートの入力を求められます。

5.7.1 MACアドレスの生成

仮想ネットワーク・インタフェース(VNIC)は、ネットワーク・トラフィックを仮想マシンに転送するために使用されます。仮想マシンのVNICに割り当てられるMACアドレスを生成できます。生成の必要なMACアドレスの範囲を指定します。

VLANグループはVLANインタフェースに置き換えられており、Vlanインタフェース構成時に、VLANセグメントID、次に、インタフェースが作成されるサーバーのポートを選択します。

注意:
MACアドレスは、データ・センターのすべてのOracle VM Manager全体を通じて一意である必要があります。

MACアドレスを作成する手順:

1. 「エンタープライズ」メニューから、「クラウド」、「VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「ネットワークの管理」を選択します。

3. 図5-11 仮想ネットワーク・インタフェース・カード・マネージャ

4. 「仮想ネットワーク・インタフェース・カード・マネージャ」タブをクリックします。

5. 「生成」をクリックします。MACアドレスの生成ポップアップ・ウィンドウで、3文字3組の初期MACアドレスを指定するよう求められます。これは、初期MACアドレスの2桁の数値です。「OK」をクリックして前のページに戻ります。これで、仮想マシンの作成時にこれらのVNICを使用できるようになります。

5.7.2 Oracle VM Manager 3.2以前のバージョンに対するVLANグループの構成

注意:
VLANグループの構成はオプションです。物理ネットワークにVLANが存在する場合、それをクラウドで使用するには、この項の手順に従います。

VLAN(仮想エリア・ネットワーク)は、サブネットおよび物理的位置を越えてネットワーク・インタフェースを仮想化するメカニズムであり、単一の閉じたLANのように見えます。このコンセプトは、分散されたインタフェース間でネットワーク・トラフィックを分離(およびグループ化)するために使用され、そのノード内でのセキュアなネットワーク・トラフィックを可能にします。

同じNICポート上に、複数の仮想LAN(VLAN)を作成できます。各VLANは、同じ物理接続上の他のVLANを使用して動作する独立した論理ネットワークです。VLANの構成時、それぞれが複数のVLANセグメントを含む1つ以上のVLANグループが作成されます。

各VLANには、個別VLAN IDが割り当てられます。VLAN IDは、アタッチされているVLANスイッチにより、同じリンク上で動作する異なるVLAN間のトラフィックを分離するために使用されます。構成されたVLANは、個別の物理接続とまったく同様に機能します。VLANは、使用する前に物理スイッチで構成する必要があります。VLANグループの作成手順:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「ネットワークの管理」を選択します。

3. 「Vlanグループ」タブをクリックし、「作成」をクリックします。

4. VLANグループの名前と説明を入力します。

5. 1つ以上のVLANセグメントを入力します。これは、仮想サーバーをスイッチに接続するスイッチ・ポートで有効なVLAN IDです。有効範囲は1から4094までです。

6. 「追加」をクリックし、ネットワークに追加するポートを選択します。ネットワークに追加する1つ以上の仮想サーバーを選択します。仮想サーバーのポートを3つ以上追加すると、最初の4つのポートが結合されます。ネットワーク結合とは、冗長性あるいはスループット向上を目的とする、ホスト上のネットワーク・インタフェースの組合せのことです。
ネットワークで超特大フレームがサポートされる場合は、「MTU」フィールドで最大送信単位のサイズを設定する必要があります。「MTU」フィールドを設定することで最大送信レートが設定されるため、大きいパケットを送受信できます。MTUはイーサネットでは最大1500、1GbEでは9000および10GbEでは64,000に設定できます。

注意:
選択したポートには、有効なVLANセグメントIDが必要です。

7. 「OK」をクリックして、VLANグループを作成します。

5.7.3 Oracle VM Manager 3.3用のVLANインタフェースの作成

注意:
VLANインタフェースの構成はオプションです。物理ネットワークにVLANが存在する場合、それをクラウドで使用するには、この項の手順に従います。

VLAN(仮想エリア・ネットワーク)は、サブネットおよび物理的位置を越えてネットワーク・インタフェースを仮想化するメカニズムであり、単一の閉じたLANのように見えます。このコンセプトは、分散されたインタフェース間でネットワーク・トラフィックを分離(およびグループ化)するために使用され、そのノード内でのセキュアなネットワーク・トラフィックを可能にします。VLANは、通常IDでタグ付けされるセグメントに分割されます。

異なるVLAN IDにタグ付けされたネットワーク・トラフィックを管理するには、各VLAN IDに対して別々のVLANまたは仮想インタフェースを作成できます。Oracle VM Managerに異なる論理ネットワークを作成する場合は、これらのVLANインタフェースを異なるネットワークにアタッチして、個々のVLAN IDに属するトラフィックのタイプを指定できます。

ネットワークがVLANをサポートするように構成されている場合には、それぞれのサーバー上に異なるVLAN IDに対するインタフェースを定義する必要がありますので、VLAN分離を活用したOracle VMネットワークを定義できます。

同じNICポート上に、複数の仮想LAN(VLAN)を作成できます。各VLANは、同じ物理接続上の他のVLANを使用して動作する独立した論理ネットワークです。VLANの構成時、それぞれが複数のVLAN IDを含む1つ以上のVLANインタフェースが作成されます。

各VLANには、個別VLAN IDが割り当てられます。VLAN IDは、アタッチされているVLANスイッチにより、同じリンク上で動作する異なるVLAN間のトラフィックを分離するために使用されます。構成されたVLANは、個別の物理接続とまったく同様に機能します。VLANは、使用する前に物理スイッチで構成する必要があります。VLANインタフェースを作成するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「ネットワークの管理」を選択します。

3. 「VLANインタフェース」タブをクリックし、「作成」をクリックします。

図5-12 VLANインタフェースの作成

4. 1つ以上のVLANセグメントをカンマで区切って入力します。
VLANは、通常IDでタグ付けされるセグメントに分割されます。このIDは、仮想サーバーをスイッチに接続するスイッチ・ポートで有効化されます。有効範囲は2から4094までです。

5. 「追加」をクリックし、ネットワークに追加するポートを選択します。「VLANインタフェースの作成: ポートの追加」ページで、「仮想サーバーの選択」フィールドの隣の「検索」アイコンをクリックします。ネットワークに追加する1つ以上の仮想サーバーを選択して、「選択」をクリックします。MTUサイズ、MACアドレスおよびステータスとともにポートのリストが表示されます。追加するポートを選択して、「続行」をクリックします。1台の仮想サーバーの複数ポートを選択すると、それらのポートは結合されます。ネットワーク結合とは、冗長性あるいはスループット向上を目的とする、ホスト上のネットワーク・インタフェースの組合せのことです。

6. 選択したポートが表示されます。それぞれのポートについて、次の内容を変更できます。

- 「MTU」: ネットワークで超特大フレームがサポートされる場合は、「MTU」フィールドで最大送信単位のサイズを設定する必要があります。「MTU」フィールドを設定することで最大送信レートが設定されるため、大きいパケットを送受信できます。MTUはイーサネットでは最大1500、1GbEでは9000および10GbEでは64,000に設定できます。

- アドレス・タイプ: ネットワーク・アドレスの割当てタイプは、「静的」、「動的」または「なし」のいずれかとなります。

- IPアドレス: ポートのIPアドレスです。

- ネットマスク: ポートのネットマスクです。

- 結合モード: ネットワーク・ボンディングとは、冗長性やスループットの増加に向けて1つのホスト上でネットワーク・インタフェースを組み合せることです。これには次のものがあります。

- アクティブ-バックアップ: アクティブなNICが1つと、休止状態のNICが1つ存在します。アクティブなNICが停止すると、もう一方のNICがアクティブになります。

- ロード・バランシング: マシンのNICを介してネットワーク・トラフィックが均等にバランス化され、冗長化のためにフェイルオーバーもサポートされています。

- リンクの集約: 集約されたNICが1つのNICとして機能する結果としてスループットが高くなりますが、NICが故障した場合にはフェイルオーバーの提供も行います。

注意:
選択したポートには、有効なVLANセグメントIDが必要です。

7. VLANセグメントがポート、MTU、アドレス・タイプ、IPアドレス、ネットマスクとともにVLANインタフェース領域にリストされます。必要な場合には、パラメータを修正できます。
「管理」アイコンをクリックしてVLANセグメントの追加または削除を行い、「OK」をクリックして「VLANインタフェースの作成」ページに戻ります。「OK」をクリックしてVLANインタフェースを作成し、「ネットワーク」ページに戻ります。

5.7.3.1 VLANインタフェースの表示

追加されたVLANインタフェースを表示するには、「ネットワーク」ページの「VLANインタフェース」タブをクリックします。VLANインタフェースは、次の詳細内容とともにリストされます。

- 名前: 作成されたVLANインタフェースの名前です。

- ポート: VLANインタフェースが割り当てられたネットワーク・ポートです。

- セグメント: VLANインタフェースに割り当てられたVLAN IDです。

- サーバー: VLANインタフェースが位置するサーバーです。

- ネットワーク: VLANインタフェースがアタッチされているネットワークです。

- MTU: VLANインタフェースのMTU値です。

- アドレス・タイプ: ネットワーク・アドレスの割当てタイプです。この値は、「静的」、「動的」または「なし」のいずれかです。

- IPアドレス: VLANインタフェースに割り当てられたIPアドレスです。

- ネットマスク: VLANインタフェースに適用されたネットマスクです。

5.7.3.2 VLANインタフェースの編集

VLANインタフェースを編集するには、次の手順に従います。

1. VLANインタフェースのリストから編集するVLANインタフェースを選択して「編集」をクリックします。

2. 「VLANインタフェースの編集」ページでは、MTU設定と「アドレス・タイプ」を編集できます。「静的」タイプを選択すると、「IPアドレス」および「ネットマスク」を指定できます。

3. 「OK」をクリックして、変更を保存し、前のページに戻ります。

5.7.3.3 VLANインタフェースの削除

VLANインタフェースを削除するには、次の手順に従います。

1. VLANインタフェースのリストから削除するVLANインタフェースを選択して「削除」をクリックします。

2. 「Delete Confirmation」ダイアログ・ボックスが表示されます。「OK」をクリックしてVLANインタフェースを削除します。

5.7.4 ネットワークの作成

ネットワークは、Oracle VM仮想サーバーの物理的NICポートをグループ化したものです。この項では、論理ネットワークを作成する手順について説明します。

前提条件

- ネットワーク・プロファイルをネットワークと関連付ける場合は、ネットワークを作成する前にネットワーク・プロファイルを作成する必要があります。ネットワーク・プロファイルには、ネットワーク・インタフェースの構成(IPアドレス、サブネット・マスク、ホスト名、DNSサーバー)が保存され、新規にプロビジョニングする仮想マシンのネットワーク・インタフェースに割り当てられます。

次の手順に従って、論理ネットワークを作成します。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「ネットワークの管理」を選択します。

3. 「ネットワーク」タブの「作成」オプションをクリックします。VLANグループのポートを構成するよう求められます。「VLANグループの作成」をクリックし、VLANグループを構成します。
Oracle VM Manager 3.3では、「VLANインタフェースの作成」をクリックしてVLANインタフェースを構成します。詳細は、第5.7.3項「Oracle VM Manager 3.3用のVLANインタフェースの作成」を参照してください。

VLANグループまたはインタフェースを構成せずにネットワークを作成する場合は、「ネットワーク作成の続行」をクリックします。ネットワークの作成: 一般ページで、ネットワークの名前および説明を入力します。

図5-13 ネットワークの作成: 一般

4. インターサーバーまたはイントラサーバー・ネットワークを作成するかどうかを指定します。インターサーバー・ネットワークは、標準スイッチを介してルーティング可能です。イントラサーバー・ネットワークは、外部の物理ネットワークにルーティングせずに、単一サーバー内で使用可能です。

5. 「ネットワーク・ロール」セクションで、1つ以上のチェック・ボックスを選択して、ネットワーク・ロールを指定します。

注意:
ゲストVMをデプロイするには、少なくとも1つのVirtual Machineロールを持つ論理ネットワークが必要です。

- サーバー管理: 異なる仮想サーバーでOracle VMエージェントを更新する場合など、サーバー・プール内の物理仮想サーバーを管理します。

- ライブ・マイグレーション: ライブ・マイグレーションの通信量です。仮想マシンのステータスを変更せずに、サーバー・プール内の仮想サーバー間で仮想マシンを移行できます。

- クラスタ・ハートビート: クラスタ・ハートビートの通信量です。

- 仮想マシン: サーバー・プール内の異なる仮想マシン間のネットワーク・トラフィックのために使用されます。仮想マシンのロールは、「インター・サーバー」(標準のスイッチによりルーティング可能)または「イントラ・サーバー」(外部の物理ネットワークへのルートなし)のいずれかです。仮想マシンのロールは、ネットワーク上で一意であることが必要です(つまり他のネットワーク・ロールを持つことはできません)。しかし、1つのOracle VM Manager内に「仮想マシン」のロールを持つ複数のネットワークが存在することは可能であり、それが一般的です。

- 記憶域: サーバー・プールのすべての記憶域のトランスポートに使用されます。これは、仮想サーバーがイーサネットベースの記憶域リポジトリに接続するために使用されます。

6. 次をクリックします。「ポートおよびVlanインタフェースの構成」ページにおいて、「追加」をクリックしてリストからVLANインタフェースを選択します。

図5-14 ネットワークの作成: ポートおよびVlanインタフェースの構成 (OVM Manager 3.2)

7. VLANセグメントを追加したら、「追加」をクリックし、VLANインタフェースとポートを追加します。ネットワークに追加するポートを選択します。3つ以上のポートを選択すると、結合され、1つのインタフェースに集約されます。デフォルトでは、「結合モード」はアクティブ・パッシブですが、次のいずれかを選択してこれを変更できます。

- アクティブ・パッシブ: 1つのアクティブNICがあります。これが停止すると、別のNICがアクティブになります。

- リンク集計: すべてのNICが1つのNICとして機能する結果としてスループットが高くなります。

- ロード・バランシング: マシンのNICを介してネットワーク・トラフィックが均等にバランス化されます。

ネットワークで超特大フレームがサポートされる場合は、「MTU」フィールドで最大送信単位のサイズを設定する必要があります。「MTU」フィールドを設定することで最大送信レートが設定されるため、大きいパケットを送受信できます。MTUはイーサネットでは最大1500、1GbEでは9000および10GbEでは64,000に設定できます。

注意: Oracle VM Manager 3.3を使用している場合には、次のページが表示されます。

図5-15 ネットワークの作成: ポートおよびVlanインタフェースの構成 (OVM Manager 3.3)

8. 次をクリックします。ネットワーク・プロファイルおよびQoSページが表示されます。

注意:
ネットワーク・プロファイルおよびQoSの定義はオプションです。ネットワーク・プロファイルには、ネットワーク・インタフェースの構成(IPアドレス、サブネット・マスク、ホスト名、DNSサーバー)が保存され、新規にプロビジョニングする仮想マシンのネットワーク・インタフェースに割り当てられます。

図5-16 ネットワークの作成: ネットワーク・プロファイルおよびQoS

次の項目を指定します。

- ネットワーク・タイプ: 「インターネット・ルーティング可能」、「インターネット・ルーティング不能」、または事前定義済のネットワーク・タイプのセットを選択できます。詳細は、第5.16.1項「ネットワーク・タイプの設定」を参照してください。

- ネットワーク・プロファイル: ネットワーク・プロファイルは、ホスト名(オプション)および共通ネットワーク属性に関連付けられたIPアドレスのセットを定義します。詳細は、第5.8項「ネットワーク・プロファイルの作成」を参照してください。

9. これまでに入力した詳細を確認し、「終了」をクリックしてネットワークを作成します。

5.8 ネットワーク・プロファイルの作成

ネットワーク・プロファイルを使用して、ゲスト仮想マシンに対するIPアドレスの割当てを自動化します。ネットワーク・プロファイルは、IPアドレスおよびホスト名のリストです。IPアドレス、関連するホスト名、共通のネットワーク属性のセットを定義します。

図5-17 ネットワーク・プロファイル

ネットワーク・プロファイルを作成するには、次の手順に従います:

1. 「設定」メニューから、「プロビジョニングとパッチ適用」、「ネットワーク・プロファイル」の順に選択します。

2. ネットワーク・プロファイル・ページで、「作成」をクリックします。

3. ネットワーク・プロファイルの作成ポップアップ・ウィンドウに次の詳細を入力します。

- 名前: ネットワーク・プロファイル名を識別する一意の名前。

- ドメイン名: プロファイルを定義するドメイン。ドメイン名の先頭は、ドット(.)にできません。たとえば、ドメイン名はus.example.comのように指定する必要があり、.us.example.comのように先頭をドット(.)にすることはできません。

- ネットマスク: サブネットIPのネットワーク・マスク。例: 255.255.240.0

- ゲートウェイ: IPアドレス・リストのゲートウェイ。

- DNSサーバー: 名前解決サーバー。

4. IPアドレスのリストを追加することも、範囲を指定することもできます。次のように選択します。

- リスト: IPアドレスをホスト名およびMACアドレス(オプション)とともに指定します。

- 範囲: ホスト名パターンを指定します。初期値は、生成されたホスト名に追加されます。最初のIPアドレスおよび最後のIPアドレスは、範囲を定義します。たとえば、パターンがhostprod、初期値が1である場合、最初のIPアドレスは10.1.1.1、最後のIPアドレスは10.1.1.3、ホスト名はhostprod1、hostprod2およびhostprod3になります。

5. 「OK」をクリックして、ネットワーク・プロファイルを保存します。

5.9 ストレージ・サーバーの登録

記憶域サーバー、ファイルシステムおよびLUNなどの外部記憶域要素を作成できます。外部記憶域要素は、NFS共有を提供するNAS用として構成されたサーバーなどの専用記憶域ハードウェアで作成されます。記憶域要素が存在するサーバーは、ファイバ・チャネルまたはイーサネット・ネットワークを介してOracle VM Serverからアクセスできる必要があります。このような外部記憶域デバイスを複数使用して仮想サーバー・プールを構成できます。

図5-18 記憶域サーバーおよびファイル・システムの作成

記憶域サーバーを設定するには、次の手順に従います:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「記憶域の管理」を選択します。図5-19が表示されます。

3. 図5-19 ストレージ・サーバー

4. 定義済のファイル・サーバー、ストレージ・アレイおよびローカル・ファイル・サーバーの一覧が表示されます。

- タイプ: 定義するストレージ・アレイのタイプを選択します。ストレージ・アレイは、仮想マシンの仮想ディスクを格納するために使用できる追加のネットワーク提供ストレージです。サーバー・プールは複数の外部ストレージ・デバイスを使用して構成できます。3つのタイプのストレージ・サーバーを定義できます。

- iSCSI: Oracle VM Serverで構成または検出されたiSCSIターゲット

- SAN: Oracle VM Serverで構成または検出されたファイバ・チャネルのSANターゲット

- NFS: ローカルにマウントされているNFSまたはNASファイル・システム

ファイル・サーバー(NFS)またはストレージ・アレイ(iSCSIまたはSAN)を選択します。

5. 適切なリンクをクリックすると、ファイル・サーバーまたはストレージ・アレイを登録できます。

6. ストレージ要素を選択して「検出」をクリックし、サーバー上で使用可能なファイル・システムの検出操作を開始します。ファイル・システムのリフレッシュを求める確認メッセージが表示されます。「OK」をクリックしてファイル・システムをリフレッシュし、記憶域ページに戻ります。

7. 「ファイル・サーバー」、「ストレージ・アレイ」または「ローカル・ファイル・サーバー」リンクをクリックして、詳細ページにドリルダウンします。

8. ストレージ要素を選択して、「検証」をクリックします。ストレージ・サーバーを検証する確認メッセージが表示されます。「OK」をクリックしてファイル・システムをリフレッシュし、記憶域ページに戻ります。

5.9.1 ファイル・サーバーの登録

ファイル・サーバーを登録するには、次の手順に従います:

1. ストレージ・ページで「ファイル・サーバー」リンクをクリックします。「ファイル・サーバーの登録 : 一般」ページが表示されます。

図5-20 ファイル・サーバーの登録: 一般

2. 次の詳細を入力します。

- 名前: 記憶域サーバーを識別するための名前。

- プラグイン名: Oracle VM Managerは、一連のプラグインを介して外部記憶域と通信します。汎用プラグインは、既存の記憶域リソースの検出および操作など、すべての記憶域ハードウェアに対して限定された標準記憶域操作を提供します。ベンダー固有のプラグインには、より多くの操作(スナップショット、クローニングなど)が含まれます。

- 管理ホスト: 管理サーバーのホスト名。

- 管理者のユーザー名とパスワード: 管理サーバーのユーザー名とパスワード。

- ホストにアクセス: 外部ストレージを提供するサーバーのホスト名またはIPアドレス。

- 均一エクスポート: NFSエクスポートが均一であることを指定するには、このチェック・ボックスを選択します。これによって、サーバー・プール内のすべてのVMサーバーがNFSサーバー上の同じエクスポートにアクセスできます。このチェック・ボックスを選択しない場合、NFSファイル・システムをリフレッシュするために使用する特定のサーバーしかNFSエクスポートにはアクセスできません。

3. 次をクリックします。「ファイル・サーバーの登録: サーバーの管理およびリフレッシュ」ページが表示されます。次のように入力します。

- 管理サーバー: 必要なストレージ・プラグインがインストールされていて、ストレージ・サーバーの管理ホストと情報を交換するVMサーバーが管理サーバーとして参照されます。「追加」をクリックして、管理サーバーを1つ以上追加します。

- サーバーのリフレッシュ: ファイル・サーバーの登録: 一般ページで「均一エクスポート」チェック・ボックスを選択していない場合、「追加」をクリックして、NFSファイル・システムをリフレッシュするために使用する「サーバーのリフレッシュ」リストを指定します。

4. 「終了」をクリックして、ファイル・サーバーを追加します。新規サーバーが表に表示されます。この時点で、記憶域接続プラグインによって記憶域場所へのリンクが確立されています。記憶域はまだマウントされていません。

5. 「検出」をクリックし、サーバー上で使用可能なファイルシステムの検出操作を開始します。操作が完了すると、使用可能なファイルシステムが記憶域詳細ページの「ファイルシステム」タブに表示されます。

5.9.2 ストレージ・アレイの登録

ストレージ・アレイを登録するには、次の手順に従います:

1. ストレージ・ページで「ストレージ・アレイ」リンクをクリックします。「ストレージ・アレイの登録: 一般」ページが表示されます。

図5-21 ストレージ・アレイの登録: 一般

2. 次の詳細を入力します。

- 名前: 記憶域サーバーを識別するための名前。

- 記憶域タイプ: 定義できるストレージ・アレイのタイプを選択します。ストレージ・アレイは、仮想マシンの仮想ディスクを格納するために使用できる追加のネットワーク提供ストレージです。2つのタイプのストレージ・アレイを定義できます。

- ファイバ・チャネル・ストレージ・アレイ: Oracle VM Serverで構成または検出されたファイバ・チャネルSANターゲット。

- iSCSIストレージ・アレイ: Oracle VM Serverで構成または検出されたiSCSIターゲット。

- プラグイン名: Oracle VM Managerは、一連のプラグインを介して外部記憶域と通信します。汎用プラグインは、既存の記憶域リソースの検出および操作など、すべての記憶域ハードウェアに対して限定された標準記憶域操作を提供します。ベンダー固有のプラグインには、より多くの操作(スナップショット、クローニングなど)が含まれます。

- プラグイン・プライベート・データ: 必要な任意のベンダー固有のストレージ・プラグイン・データ。これは、汎用ストレージに使用できません。

注意:
ベンダー固有のストレージ・アレイを登録するときは、「plug-in private data」フィールドに入力した情報を必ず再度確認してください。ストレージ・アレイが登録されると、このフィールドは変更できなくなります。プラグイン・プライベート・データを更新する必要がある場合は、ストレージ・アレイを登録解除してから再登録する必要があります。

- 管理ホスト: 管理サーバーのホスト名。

- 管理者のユーザー名とパスワード: 管理サーバーのユーザー名とパスワード。

3. 次をクリックします。ストレージ・アレイの登録 : アクセス情報ページが表示されます。

図5-22 ストレージ・アレイの登録: アクセス情報

4. 次の詳細を入力します。

- ホストにアクセス: 外部ストレージを提供するサーバーのホスト名またはIPアドレス。

- アクセス・ポート: ストレージのアクセスに使用するポート番号。

- アクセス・ユーザー名とアクセス・パスワード: アクセス・ホストのユーザー名とパスワード。

- Chapの使用(すべてのアクセス・ホストに適用): CHAP認証を有効にするには、このチェック・ボックスを選択します。

注意:
ストレージ・アレイの登録: 一般ページで、「記憶域タイプ」を「iSCSIストレージ・アレイ」に、「プラグイン名」をOracle汎用SCSI記憶域プラグイン(1.2.1以降)に選択した場合、図5-23に示すように複数のアクセス・ホストを追加できます。

図5-23 ストレージ・アレイの登録(複数)

5. 次をクリックします。「ストレージ・アレイの登録: 管理サーバー」ページが表示されます。「追加」をクリックして、ストレージ・プラグインがインストールされている管理サーバーを1つ以上追加します。管理サーバーは、ストレージ・サーバーの管理ホストと情報をやり取りします。

6. 「終了」をクリックして、ストレージ・アレイを追加します。新規サーバーが表に表示されます。この時点で、記憶域接続プラグインによって記憶域場所へのリンクが確立されています。記憶域はまだマウントされていません。

7. 「検出」をクリックし、サーバー上で使用可能なファイルシステムの検出操作を開始します。操作が完了すると、使用可能なファイル・システムが記憶域詳細ページの「一般」タブに表示されます。

5.9.3 ファイル・サーバーの詳細

「ファイル・サーバー」リンクをクリックし、詳細ページを表示します。このページには次のタブがあります。

- 一般: 管理サーバーのリストが表示されます。管理サーバーは、ストレージ・プラグインがインストールされている仮想サーバーです。管理サーバーを追加したり、既存のサーバーを削除したりできます。
「構成」リージョンに、ストレージ・サーバーの詳細が表示されます。「編集」をクリックして、名前、説明、外部記憶域を提供するアクセス・ホストの名前などの詳細を変更します。

「ストレージQOSマッピング」リージョンで、クラウド管理者によって定義された記憶域タイプをストレージ・サーバーで定義されたQOSにマップします。

- サーバーのリフレッシュ: 不均一なNFSファイル・システム・エクスポートでは、リフレッシュする必要のあるサーバーを指定できます。「追加」をクリックします。「サーバーのリフレッシュ」ダイアログ・ボックスが表示されます。「サーバーの選択」をクリックし、リストから1つ以上のサーバーを選択して「選択」をクリックします。「OK」をクリックするとサーバーがリフレッシュされます。

- ファイル・システム: ファイル・システムのリストが表示されます。次の操作を実行できます。

- リストからファイルシステムを選択して、「編集」をクリックします。ファイルシステムの名前と説明を変更できます。

- ファイル・システムを選択して、「削除」をクリックします。確認メッセージが表示されます。ファイル・システムを削除するには、「OK」をクリックします。

- 1つ以上のファイル・システムを選択して、「リフレッシュ」をクリックします。確認メッセージが表示されます。「OK」をクリックして、ファイル・システムをリフレッシュします。

- アクセス・グループ: リフレッシュするサーバーとファイル・システム(エクスポート)間のマッピングが表示されます。アクセス・グループを作成、編集または削除できます。

5.9.4 ストレージ・アレイの詳細

「ストレージ・アレイ」リンクをクリックし、詳細ページを表示します。このページには4つのタブがあります。

- 一般: ストレージ・アレイについての一般的な情報が提供されます。管理サーバーのリストが「管理」リージョンに表示されます。管理サーバーは、ストレージ・プラグインがインストールされている仮想サーバーです。管理サーバーを追加したり、既存のサーバーを削除したりできます。
「構成」リージョンに、ストレージ・サーバーの詳細が表示されます。「編集」をクリックして、「名前」と「説明」を変更します。

- 物理ディスク: ストレージ・アレイのすべての物理ディスクの一覧が表示されます。ストレージ・コネクタのタイプに応じて、作成、クローン、編集、サイズ変更(物理ディスクのサイズ変更または拡張)、再スキャン(物理ディスクのリフレッシュ)、削除およびファイル・システムの作成(物理ディスク上にOCFS2ファイル・システムを作成)ができます。

注意:
許可されている操作は、インストールされている記憶域接続プラグインのタイプによって異なります。たとえば、一般的なストレージ接続プラグインがインストールされている場合、物理ディスクで「作成」操作は実行できません。

- アクセス・グループ: ストレージ・イニシエータと物理ディスクのマッピングが表示されます。アクセス・グループの作成、編集、提示/非提示(物理ディスクの追加または削除)、削除ができます。

- ボリューム・グループ: このストレージ・サーバーで使用できるボリューム・グループが表示されます。

5.9.5 ローカル・ファイル・サーバーの詳細

「ローカル・ファイル・サーバー」リンクをクリックして、詳細ページを表示します。このページには次のタブがあります。

- 一般: 管理ホスト、プラグイン名など、選択したローカル・ファイル・サーバーの構成詳細が表示されます。

- 「ファイルシステム」: リストのファイルシステムを編集またはリフレッシュできます。リストからファイルシステムを選択して、「編集」をクリックします。ファイルシステムの名前と説明を変更できます。
リフレッシュするには、リストからファイルシステムを選択して「リフレッシュ」をクリックします。仮想サーバーの名前を選択し、「OK」をクリックしてファイルシステムをリフレッシュします。

5.10 記憶域リポジトリの作成

記憶域リポジトリは、サーバー・プール内のOracle VM Serverまたは各種のサーバー・プールで使用できる、物理的なストレージ・ハードウェア上にある仮想ディスク領域です。それにより、Oracle VMリソースが存在する場所が定義されます。リソースには、仮想マシン、仮想マシン作成用のテンプレート、仮想マシンのアセンブリ、ISOイメージ、共有仮想ディスクなどが含まれています。

ストレージ・サーバーを作成したら、記憶域リポジトリを作成して、ゾーン内のサーバー・プールに記憶域リソースを割り当てることができます。

記憶域リポジトリを作成するには、次の手順に従います:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「記憶域リポジトリの管理」を選択します。

図5-24 記憶域リポジトリ

3. 定義された記憶域リポジトリのリストが表示されます。「作成」をクリックして、記憶域リポジトリを作成します。

4. ポップアップ・ウィンドウで、記憶域リポジトリの名前を入力します。

図5-25 記憶域リポジトリの作成

5. 「ディスク」フィールドの「検索」アイコンをクリックして、記憶域リポジトリを作成する記憶域サーバーおよびファイルシステムを選択し、「OK」をクリックします。
NFSファイル・システムを選択した場合は、ストレージ・サーバーおよび仮想サーバーの場所を選択する必要があります。オプションで、共有パスおよび説明を指定できます。記憶域リポジトリが作成され、記憶域リポジトリ・ページに表示されます。

5.10.1 記憶域リポジトリでの管理操作の実行

記憶域リポジトリを作成した後、記憶域リポジトリに対して複数の管理操作を実行できます。記憶域リポジトリのリストは、サーバー・プールの選択内容によって異なります。複数のサーバー・プールを選択すると、すべての記憶域リポジトリが表示されます。個別のサーバー・プールを選択すると、このサーバー・プールにのみ関連する記憶域リポジトリが表示されます。次の操作を実行できます。

- 編集: リポジトリを選択し、「編集」をクリックします。リポジトリの名前や説明を変更したり、所有権をリリースできます。変更を保存する場合は、「OK」をクリックします。

図5-26 記憶域リポジトリの編集

注意:
物理ディスク上に作成された記憶域リポジトリを編集する場合、記憶域リポジトリが関連付けられているサーバー・プールを変更できます。サーバー・プールを変更するには、「編集」ダイアログ・ボックスの「サーバー・プール」フィールドの隣にある「検索」アイコンをクリックして、別のサーバー・プールを選択し、「OK」をクリックします。

- 削除: リポジトリを選択し、「削除」をクリックします。選択したリポジトリのすべてのコンテンツがその関連付けとともに削除されます。

- 自動リフレッシュ: 「自動リフレッシュ」を有効化し、すべての記憶域リポジトリのファイル・システム・サイズを定期的にリフレッシュおよび更新する場合、このオプションを選択します。表示されるダイアログ・ボックスで、「有効化」チェック・ボックスを選択して、ファイル・システム・サイズをリフレッシュする「間隔」を指定します。

注意:
「自動リフレッシュ」オプションによりリポジトリがロックされるため、このオプションはデプロイメント操作が何もスケジュールされていない場合に使用する必要があります。

5.11 記憶域リポジトリの提示

記憶域リポジトリを作成した後、記憶域リポジトリを1つ以上のサーバー・プールに伝播できます。記憶域リポジトリを準備して作成しても、使用するには仮想サーバーに対して使用可能にすることも必要です。通常、記憶域サーバーはサーバー・プール内のすべての仮想サーバーに対して提示します。

記憶域リポジトリをサーバー・プールに提示するには、次の手順に従います:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「記憶域リポジトリの管理」を選択します。

3. 記憶域リポジトリ・ページで、一覧から記憶域リポジトリを選択します。記憶域リポジトリが伝播されたサーバー・プールのリストが表示されます。

図5-27 提示されたサーバー

4. リストから1つ以上のサーバー・プールを選択し、「提示」をクリックします。「サーバーの提示」ダイアログ・ボックスで、「サーバーの選択」アイコンをクリックします。「ターゲットの選択」ダイアログ・ボックスに、メンバーの一覧が表示されます。ダイアログ・ボックス内の「メンバー」を開き、ゾーンのボックス、プール、または個別の仮想サーバーを選択し、「選択」をクリックして前のダイアログ・ボックスに戻ります。「提示」をクリックし、メンバーをサーバーにマウントします。

5.12 記憶域リポジトリへのアセンブリ、テンプレートおよび仮想ディスクのインポート

Oracle VM Serverに関連付けられた記憶域リポジトリには、Oracle VM Serverに関連付けられたバイナリ・コンポーネントが格納されます。記憶域リポジトリには、次のようなソフトウェア・コンポーネントが格納できます。

- Oracle VMテンプレート

- Oracle仮想アセンブリ

- ISO

- 仮想ディスク

- VMファイル

Oracle仮想アセンブリ、Oracle VMテンプレートおよびISOイメージは、それらを使用してゲスト仮想マシンを作成する前に、記憶域リポジトリにインポートしておく必要があります。次の手順に従って、ソフトウェア・コンポーネントを記憶域リポジトリにインポートします。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「記憶域リポジトリの管理」を選択します。

3. 「リポジトリ名」リンクをクリックします。記憶域リポジトリ詳細ページでは、選択した記憶域リポジトリが伝播されたサーバー・プールのリストが表示されます。

4. 「アセンブリ」タブをクリックします。アセンブリは、単一の.ovaファイルとしてインポートできます。

図5-28 記憶域リポジトリ - アセンブリ

- 「インポート」をクリックします。アセンブリは、ソフトウェア・ライブラリまたは外部リソースからインポートできます。次のように選択します。

- ソフトウェア・ライブラリ: ソフトウェア・ライブラリに存在するアセンブリのリストが表示されます。インポートするアセンブリを選択し、「OK」をクリックします。アセンブリがインポートされると、一連のテンプレートが作成されます。このオプションでは、構成ファイル、ディスク・イメージなどのアセンブリのコンテンツを解凍します。

- 外部: アセンブリのインポート元の外部URLを指定し、「OK」をクリックします。指定するURLは、リポジトリが存在するOVSホストからアクセスできる必要があります。

5. 「ISO」タブをクリックし、ISOイメージをインポートします。仮想マシンは、物理DVDまたはCD-ROMドライブにアクセスできません。DVDまたはCD-ROMのイメージが含まれる.isoファイルを提供することにより、仮想ドライブを仮想マシンに割り当てることができます。これらのイメージ・ファイルは、記憶域リポジトリの「ISO」タブにあります。

- 「インポート」をクリックします。ISOイメージは、ソフトウェア・ライブラリまたは外部リソースからインポートできます。次のように選択します。

- ソフトウェア・ライブラリ: ソフトウェア・ライブラリに存在するISOイメージのリストが表示されます。インポートするISOイメージを選択し、「OK」をクリックします。インポートされたISOイメージを選択し、「割当て」をクリックして、このテンプレートをサーバー・プールに割り当てます。

- 外部: ISOイメージのインポート元の有効な外部URLを指定し、「OK」をクリックします。指定するURLは、リポジトリが存在するOVSホストからアクセスできる必要があります。

6. 「VMテンプレート」タブをクリックします。テンプレートには、単一の仮想マシンの構成が含まれます。新規仮想マシンを作成する場合、最初から作成するかテンプレートから作成するかを選択します。記憶域リポジトリでは、通常、テンプレートはアーカイブ(.tgz、.tarまたはその他)としてインポートされます。アーカイブには、仮想マシンの構成が記載された.cfgファイルとともに、仮想ディスク・イメージである.imgファイルが少なくとも1つ含まれます。

図5-29 記憶域リポジトリ - VMテンプレート

- 「インポート」をクリックします。VMテンプレートは、ソフトウェア・ライブラリまたは外部リソースからインポートできます。次のように選択します。

- ソフトウェア・ライブラリ: ソフトウェア・ライブラリに存在するVMテンプレートのリストが表示されます。インポートするVMテンプレートを選択し、「OK」をクリックします。テンプレートがインポートされた後、テンプレートを選択し、「割当て」をクリックして、このテンプレートをサーバー・プールに割り当てます。

- 外部: VMテンプレートのインポート元の有効な外部URLを指定し、「OK」をクリックします。指定するURLは、リポジトリが存在するOVSホストからアクセスできる必要があります。

7. 仮想ディスクタブをクリックします。

図5-30 記憶域リポジトリ - 仮想ディスク

- 「作成」をクリックして、作成する仮想ディスクのサイズを指定します。

- 「共有」チェック・ボックスを選択して、共有ディスクであることを指定します。

- 「インポート」をクリックします。仮想ディスクは、ソフトウェア・ライブラリまたは外部リソースからインポートできます。次のように選択します。

- ソフトウェア・ライブラリ: ソフトウェア・ライブラリに存在する仮想ディスクのリストが表示されます。インポートする仮想ディスクを選択し、「OK」をクリックします。インポートされた仮想ディスクを選択し、「割当て」をクリックして、このテンプレートをサーバー・プールに割り当てます。

- 外部: 仮想ディスクのインポート元の有効な外部URLを指定し、「OK」をクリックします。指定するURLは、リポジトリが存在するOVSホストからアクセスできる必要があります。http://またはftp://プロトコルを使用して仮想ディスクを参照する場合、この参照にuser/pwを含める必要があります。
たとえば、URLとしてhttp://user:pw@host/virtualdisk_file_image_fileまたはftp://user:pw@host/virtual_disk_image_fileを指定する必要があります。NFSを介して仮想ディスクにアクセスできる場合、OVSがNFS自動マウントに対して有効であれば、file:///net/host/virtual_disk_image_fileを指定することもできます。

8. 「戻る」をクリックして、記憶域リポジトリ・ページに戻ります。

5.12.1 リポジトリのエクスポートの作成(オプション)

サード・パーティのアプリケーションを使用して記憶域リポジトリのコンテンツをバックアップするように仮想サーバーを構成できます。

前提条件

- リポジトリのエクスポート機能は、物理ディレクトリに基づく記憶域リポジトリでのみ使用でき、少なくとも1つのサーバーがリポジトリに提示されている必要があります。

- 仮想サーバーは、リポジトリのコンテンツにアクセスするNFS共有を提供するように構成する必要があります。

- 仮想サーバーはクラスタ化されたサーバー・プールにあり、OCFS2ベースの記憶域リポジトリが提示されている必要があります。

リポジトリのエクスポートを作成するには、次の手順に従います。

1. 記憶域リポジトリの詳細ページで「リポジトリのエクスポート」タブをクリックします。

2. 「作成」をクリックします。リポジトリのエクスポートの作成ウィンドウが表示されます。

図5-31 記憶域リポジトリ - リポジトリのエクスポート

3. 記憶域リポジトリのコンテンツをエクスポート・サーバーにマウントするのに使用するホストの名前を入力します。

4. リポジトリへのアクセスを制限するオプションを指定します。Linuxシステムでは、rw、async、no_root_squashです。

5. 「エクスポート・サーバー」リージョンで「追加」をクリックします。記憶域リポジトリが提示される1つ以上の仮想サーバーを選択して、「選択」をクリックします。

6. 「OK」をクリックし、ジョブを送信して記憶域リポジトリの詳細ページに戻ります。

5.13 自己更新を使用したOracle VM TemplatesおよびVirtual Assembliesのダウンロード

自己更新コンソールから、次の手順で事前構成済アセンブリおよびテンプレートがダウンロードできます。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「設定」メニューで、「拡張性」、「自己更新」の順に選択します。ダウンロードできるエンティティ・タイプのリストとともに自己更新コンソールが表示されます。

図5-32 自己更新コンソール

3. Oracle VM TemplatesおよびOracle Virtual Assembliesフォルダを選択し、「オープン」をクリックします。Oracle VM TemplatesおよびOracle Virtual Assembliesの更新ページが表示されます。

4. アップデートを選択し、「ダウンロード」をクリックします。「スケジュール・ダウンロード」ダイアログ・ボックスが表示されます。

5. アップデートをすぐにダウンロードするか後日ダウンロードするかを指定します。

6. 「選択」をクリックします。ソフトウェア・ライブラリに更新をダウンロードするためのEnterprise Managerジョブが作成されます。Enterprise Managerでは、Oracle Enterprise Managerストアからのアーカイブのダウンロードが開始します。ダウンロードが完了するまで待ちます。(オフライン・モードの場合、システムは指定された場所からの読取りを開始します。)ダウンロードが完了すると、ステータスによって更新がダウンロードされたことが示されます。

7. 「適用」をクリックします。ジョブが送信され、更新が適用されます。ダウンロードしたプラグインが適用され、Oracle VM TemplatesおよびOracle Virtual Assembliesの更新ページに表示されます。

5.14 仮想サーバー・プールの作成

この項では、要件を満たすサーバー・プールを設計する方法について説明します。

サーバー・プールを作成する前に、そのサーバー・プールに含める物理サーバーの数、およびそれぞれの物理サーバーにどのような機能を実行させるかを検討する必要があります。サーバー・プールで多くの仮想マシンを実行すればするほど、仮想マシンはそれだけ多くのリソースを消費することになり、サーバー・プールに十分なリソースを提供するために、より多くの物理サーバーが必要となります。サーバー・プールはスケーラブルです。仮想マシンおよびその中のアプリケーションを実行できる十分なリソース(CPUおよびメモリーなど)がサーバー・プールにない場合は、Oracle仮想サーバーを追加することによってサーバー・プールを拡張できます。

仮想サーバー・プールには、1つ以上の仮想サーバーおよびゲスト仮想マシンが含まれます。仮想サーバーは、必ず一度に1つの仮想サーバー・プールにのみ属することができます。ゲスト仮想マシンとリソースもサーバー・プールに関連付けられます。

前提条件

- クラスタ化されていない仮想サーバー・プールには、最大64台のVMサーバーを含めることができ、クラスタ化された仮想サーバー・プールには、最大32台のOracle VMサーバーを含めることができます。

- マスター・サーバー、ユーティリティ・サーバーまたはゲスト仮想マシン(あるいはそのすべて)としてデプロイできる仮想サーバー。サーバー・プール内に少なくとも1つの仮想サーバーが必要です。

- サーバー・プール内のすべての仮想サーバーのCPUが同じCPUファミリのものである必要があります。これらが同じCPUファミリのものでない場合、ライブ・マイグレーションなどの一部の操作が失敗する可能性があります。CPUは同じCPUファミリのものであることが必要ですが、コアの数が異なるなど、構成が異なる場合があります。また、RAMの量やディスク・ドライブのサイズなど、ホスト・コンピュータ上の他のハードウェア・コンポーネントが異なる場合もあります。

注意:
ホスト・コンピュータの構成が異なる場合がありますが、サーバー・プール内の仮想サーバーはすべて同じものにすることをお薦めします。

- サーバー・プールのファイルシステムとして使用する専用ファイルシステム(NASエクスポートまたはLUN)が使用可能であること。

- 仮想サーバーのIPアドレスを使用可能にする必要があります。マスター・サーバーの仮想IPアドレスとして使用するIPアドレスは、未使用で使用可能なIPアドレスである必要があります。

- 仮想サーバー・プールを作成するには、任意のターゲットの追加権限のある管理者としてログインする必要があります。

- 仮想サーバー・プールを削除するには、そのサーバー・プールに関するすべての権限に加え、その仮想サーバー・プールに属する仮想サーバーおよびゲスト仮想マシンに関する適切な権限が必要です。

仮想サーバー・プールを作成するには:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「仮想サーバー・プールの作成」を選択します。

図5-33 仮想サーバー・プールの作成

3. サーバー・プールの情報を入力します。

- 仮想サーバー・プール名: サーバー・プールの名前。サーバー・プール名は英数字で構成する必要があり、スペースまたは特殊文字は使用できません(アンダースコア(_)やハイフン(-)は除く)。サーバー・プール名の長さは最大で200文字です。

- 説明:サーバー・プールの説明。

- キーマップ: このサーバー・プールに作成されるゲスト仮想マシンのキーボード・タイプを指定します。

- VM開始ポリシー: 仮想マシンの開始に使用するポリシーを選択します。次の選択が可能です。

- 最適なサーバー上で開始: サーバー・プールの最適なサーバーを使用して、仮想マシンを開始します。

- 現在のサーバー上で開始: 仮想マシンは、作成されたサーバーで開始されます。

- セキュアなVM移行: 仮想マシンの暗号化移行を有効化するかどうかを指定します。このチェック・ボックスを選択すると、仮想マシンはSSLを使用して移行され、移行プロセス中にデータが保護されます。

- クラスタのアクティブ化: チェック・ボックスを選択し、サーバー・プールの高可用性を有効にします。

- クラスタ・タイムアウト: クラスタのアクティブ化を有効にすると、秒単位のクラスタ・タイムアウト期間を設定できます。ディスク・ハートビートおよびネットワーク・ハートビートはクラスタ・タイムアウト値から導出されます。

- プール・ファイル・システムのタイプ: サーバー・プールに使用するプール・ファイル・システムを選択します。プール・ファイル・システムは、サーバー・プールおよびクラスタ・データの保持に使用され、クラスタ・ハートビートにも使用されます。
タイプは、ネットワーク・ファイル・システムまたは物理ディスクのいずれかになります。サーバー・プールのファイル・サーバーを使用している場合、「ネットワーク・ファイル・システム」を選択します。サーバー・プールのストレージ・アレイの物理ディスクを使用している場合、「物理ディスク」タイプを選択します。

- 場所: 「検索」アイコンをクリックして検索し、プール・ファイル・システムを選択します。これは、サーバー・プールのすべての仮想サーバーでアクセスできる必要があります。

- 仮想IP: サーバー・プール内のマスター・サーバーを特定するために使用するIPアドレス。マスター・サーバーが別のOracle VM Serverに変更されると、このIPアドレスは新規ホストに割り当てられます。

4. 「仮想サーバー」セクションで「追加」をクリックします。検索ウィンドウから1つ以上の仮想サーバーを選択し、「OK」をクリックします。

注意:
仮想サーバーは、サーバー・プールに追加する前に検出されている必要があります。詳細は、第5.5項「仮想サーバーの検出」を参照してください。

5. 「OK」をクリックして、仮想サーバー・プールを作成します。

5.14.1 仮想サーバー・プールの編集

説明、キーマップ、開始ポリシーなどを含む仮想サーバー・プールの構成情報を編集できます。また、仮想マシンの安全な移行およびクラスタを制御するマスター・サーバーを変更することもできます。サーバー・プールに使用される仮想IPまたはプール・ファイル・システムは変更できません。仮想サーバー・プールを編集するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルから、編集する仮想サーバー・プール・ターゲットを選択します。

3. 「VMサーバー・プール」メニューから、「ターゲット設定」、「VMサーバー・プールの編集」の順に選択します。仮想サーバー・プールの編集ページが表示されます。

4. 次のフィールドも編集できます。

- キーマップ: このサーバー・プールに作成されるゲスト仮想マシンのキーボード・タイプ。

- VM開始ポリシー: 仮想マシンの開始に使用するポリシー。現在のサーバーまたは最適なサーバーでの開始を選択できます。

- セキュアなVM移行: 仮想マシンの暗号化移行を有効化するかどうかを示します。このチェック・ボックスを選択すると、仮想マシンはSSLを使用して移行され、移行プロセス中にデータが保護されます。

5. 「仮想サーバー」リージョンで、仮想サーバーを追加または削除できます。

6. 「エージェント・パスワードの変更」をクリックして、マスター・サーバーで実行されている管理エージェントのパスワードを変更します。変更されたパスワードは、サーバー・プールのすべての仮想サーバーで実行されている管理エージェントに適用されます。

注意:
仮想サーバーは、サーバー・プールに追加する前に検出されている必要があります。詳細は、第5.5項「仮想サーバーの検出」を参照してください。

7. アンチアフィニティ・グループを、追加、編集または削除できます。アンチアフィニティ・グループは、ある仮想マシン・グループを同じサーバー上で実行できないことを指定します。アンチアフィニティ・グループ・ウィンドウにグループの名前を入力し、このグループに含める必要のある1つ以上の仮想マシンを選択します。このグループに含まれる仮想マシンは、同じサーバー上で実行できません。

8. 「OK」をクリックし、変更を仮想サーバー・プールに適用します。

5.15 ゾーンの作成

ゾーンは、関連するクラウド・リソースのグループ化に使用されます。クラウド・ゾーンは、コスト・センターによるリソースのグループ化またはメータリングおよびチャージバックを目的として、場所、ソフトウェアのライフサイクルのステータスに基づいて作成できます。通常、ゾーンは1つの部門または小さなデータ・センターをカバーできます。クラウド環境は1つ以上のゾーンから構成されます。それぞれのゾーンには、ゾーンの合計使用量を示すメトリックのセットがあります。

前提条件

- ゾーンを作成するには、任意のターゲットの追加権限のある管理者としてログインする必要があります。

- ゾーンを削除するには、そのゾーンに関する操作権限または完全な権限が必要です。

次の手順を実行して、ゾーンを作成します。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでゾーンを作成するOVMマネージャ・ターゲットを右クリックして、「ゾーンの作成」を選択します。

図5-34 ゾーンの作成

3. ゾーンの作成ページで、ゾーンの名前および説明を指定します。

4. 「インフラストラクチャ・クラウド・セルフ・サービス・ゾーン」チェック・ボックスを選択して、このゾーンがセルフ・サービス・ユーザーによって使用されることを指定します。

5. 「仮想サーバー・プール」セクションで「追加」をクリックし、1つ以上の仮想サーバー・プールを追加します。詳細は、第5.14項「仮想サーバー・プールの作成」を参照してください。権限を持ち、その他のゾーンに属さない仮想サーバー・プールを追加できます。

6. 「OK」をクリックします。ホームページで、仮想サーバー・プールおよびストレージ・アレイが新しく作成されたゾーンに表示されます。

5.16 ストレージのサービスのクオリティ(QoS)の設定

ストレージQoSは、ストレージ・サーバー・レベルで定義されているサービスのクオリティを指します。ストレージQoSの設定は、様々なストレージ・プロパティの定義を必要とします。ゲスト仮想マシンをデプロイする前にストレージQoSを定義し、そのQoSをストレージ・サーバーにマッピングし、ゲスト仮想マシンのデプロイ時にこのQoSを指定します。

これには、マシン・サイズ、ネットワーク・タイプおよびストレージQoSの定義が含まれます。ストレージQoSを設定した後で、ストレージ・サーバー、ネットワーク・リポジトリおよびストレージ・アレイを設定できます。このストレージQoSはゲスト仮想マシンのデプロイ中に使用できます。

ストレージQoSを定義するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルで「インフラストラクチャ・クラウド」メニューを右クリックして、「設定」を選択します。

図5-35 ストレージのサービスのクオリティ

3. ストレージのサービスのクオリティ・ページで、「作成」をクリックします。

4. ポップアップ・ウィンドウで、ストレージQoSの名前および説明を指定して「OK」をクリックします。新しく追加されたストレージQoSがストレージのサービスのクオリティ・ページに表示されます。

5. OVMマネージャ・ホーム・ページに移動して、「OVMマネージャ」メニューから「記憶域」を選択します。

6. 「ファイル・サーバー」の下の「記憶域」リンクをクリックします。「一般」タブで「ストレージQOSマッピング」リージョンにスクロール・ダウンします。

7. 「編集」をクリックします。ストレージQOSマッピング・ウィンドウが表示されます。 「追加」をクリックし、前に作成したストレージQOSを選択します。「ストレージQOSマッピング」表に、追加したストレージQOSが表示されます。

8. アセンブリのデプロイ時にこのマッピングがどのように使用されるかを確認するには、OVMマネージャの下のゾーンのホームページに移動します。「ゾーン」メニューから、「デプロイ」、「アセンブリ」の順に選択します。

9. デプロイメント構成ページの「ディスク」セクションで「オーバーライド」をクリックして、作成したストレージQOSを選択します。このストレージQOSがアセンブリのデプロイに使用されます。

5.16.1 ネットワーク・タイプの設定

「ルーティング可能」、「インターネットに直接接続」などのネットワーク・タイプを定義して、ネットワークのQoSを定義できます。ネットワークQoSを定義した後、作成するネットワークにそれをマッピングできます。その後、ゲスト仮想マシンのデプロイ時にこのネットワーク・タイプを使用できます。

ネットワークのQoSを定義するには、次の手順に従います:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 「インフラストラクチャ・クラウド」メニューから、「設定」を選択します。

3. インフラストラクチャ・クラウド・ページで、「ネットワーク・タイプ」リンクをクリックします。

図5-36 ネットワーク・タイプ

4. ネットワーク・タイプ・ページで、「作成」をクリックします。

5. ネットワーク・タイプの名前および説明を入力し、「OK」をクリックします。

5.16.2 マシン・サイズの設定

デプロイ時にSSAユーザーに使用可能なマシン・サイズを定義できます。マシン・サイズを定義するには、次の手順に従います:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルで「インフラストラクチャ・クラウド」メニューを右クリックして、「設定」を選択します。

3. インフラストラクチャ・クラウド・ページで、「マシン・サイズ」リンクをクリックします。

4. 「マシン・サイズの追加」をクリックします。

5. 名前(マシン・サイズの内部名)、説明、VCPUの数、メモリー量、このサイズのマシンに割り当てられるローカル記憶域を入力します。「保存」をクリックし、このマシン・サイズを追加します。

5.16.3 ソフトウェア・ライブラリ・ユーザーの構成

記憶域リポジトリの設定時に、VMテンプレート、アセンブリおよびその他のソフトウェア・コンポーネントを記憶域リポジトリにインポートできます。これらのタスクを実行する権限を持つソフトウェア・ライブラリ・ユーザーを構成するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 「インフラストラクチャ・クラウド」メニューを右クリックして、「設定」を選択します。

3. インフラストラクチャ・クラウド・ページで、「ソフトウェア・ライブラリ・ユーザー構成」リンクをクリックします。

4. ソフトウェア・ライブラリからコンポーネントをインポートできるクラウド・ソフトウェア・ライブラリ・ユーザーのパスワードを入力します。このパスワードは、ユーザーがソフトウェア・ライブラリにアクセスして必要なコンポーネントをダウンロードするときに指定する必要があります。

5.16.4 外部管理エージェントを使用したソフトウェア・ライブラリ・ユーザーの構成

管理エージェントをリモート・マシンで実行している場合、仮想コンポーネントをインポートする際に次の点を確認する必要があります。

- ソフトウェア・ライブラリ・ユーザーは、リモート・ホスト上でのコマンド実行権限を持っている必要があります。

- リモート・ホスト上の管理エージェントにアクセスするために名前付き資格証明が必要である場合、ソフトウェア・ライブラリ・ユーザーは、エージェント記憶域タイプの参照ファイルの場所を作成するときに表示権限を持っている必要があります。

表示権限を設定するには、次の手順に従います。

1. 「設定」メニューから、「セキュリティ」、「名前付き資格証明」の順に選択します。

2. 記憶域タイプがエージェントのソフトウェア・ライブラリ参照場所を作成するときに使用される名前付き資格証明を選択します。

3. 「権限の追加」をクリックします。「CLOUD_SWLIB_USER」を選択して、「保存」をクリックします。

実行権限を設定するには、次の手順に従います。

1. 「設定」メニューから、「セキュリティ」、「管理者」の順に選択します。

2. 「CLOUD_SWLIB_USER」を選択して、「編集」をクリックします。

3. 「ターゲット権限」手順に移動します。「ターゲット権限」セクションで「追加」をクリックして、管理エージェントを実行しているホスト・ターゲットを選択します。ホスト・ターゲットが表に追加されます。

4. 手順3で追加したホスト・ターゲットを選択して、「権限付与の管理」列の「編集」アイコンをクリックします。既存の「ビュー」オプションに加え、「コマンドの実行」を選択して、「続行」をクリックします。

5. 「保存」をクリックして、この構成を保存します。

5.16.5 リクエスト・パージ・ポリシーの定義

すべてのデプロイメント・リクエストは、一定期間保存した後にパージできます。リクエストを使用可能にする日数を指定するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 「インフラストラクチャ・クラウド」メニューを右クリックして、「設定」を選択します。

3. インフラストラクチャ・クラウド・ページで、「リクエスト・アーカイブ・ポリシー」リンクをクリックします。

4. 「アーカイブ有効化」チェック・ボックスを選択してアーカイブ期間を指定し、「適用」をクリックします。リクエストは、指定した期間アーカイブされ、その後パージされます。

5.17 Oracle VM Serverへのパッチ適用

オラクル社では、Oracle VMのリポジトリを含むYUMリポジトリを公開しています。これらのリポジトリには、 Oracle VMの完全リリースが含まれており、これらのリリースをOracle VM DVD/ISOに反映します。Oracle VM Serverにパッチを適用して、最新のソフトウェア更新および拡張機能を確実に適用する必要があります。Oracle VM Serverにパッチを適用する手順には、次の操作が含まれます。

- YUMリポジトリの構成

- 仮想サーバーのアップグレード

5.17.1 YUMリポジトリの構成

仮想サーバーのアップグレードに使用するYUMリポジトリを構成できます。構成したYUMリポジトリは、検出されたすべての仮想サーバーのアップグレードに使用できます。

前提条件

- 構成するYUMリポジトリがhttpの場所に表示されている必要があります。内部または公開YUMリポジトリを構成できます。

YUMリポジトリを構成するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでOVM Managerターゲットを右クリックして、「YUMリポジトリの管理」を選択します。

3. YUMリポジトリ・ページで次の詳細を入力します。

- 名前: YUMリポジトリの名前。

- YUMベースURL: YUMリポジトリのHURL。

- GPGキーの有効化: GPGキーを有効にする場合、このチェック・ボックスを選択します。GPGキーによって、YUMリポジトリと、リポジトリからダウンロードされたパッケージの妥当性がチェックされます。

- YUM GPGキー: 「GPGキーの有効化」フィールドを選択した場合、ここでYUM GPGキーを指定します。

4. 「OK」をクリックします。YUMリポジトリがOracle VM Managerに構成されます。

5.17.2 仮想サーバーのアップグレード

YUMリポジトリの構成後、仮想サーバーをアップグレードして最新の更新を適用する必要があります。アップグレードされる仮想サーバーは、メンテナンス・モードである必要があります。仮想サーバーをアップグレードするには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでVMサーバーを右クリックして、「アップグレード」を選択します。

注意:
Oracle VM Managerのバージョンが3.3.x、Oracle Virtual Serverのバージョンが3.3.1未満である場合には、「アップグレード」ボタンは無効化されています。

3. 確認メッセージが表示されます。「OK」をクリックし、アップグレードを続行します。仮想サーバーは、アップグレード後に再起動されます。

5.18 OVMイベントの確認

OVMイベントは、サーバー、サーバー・プール、記憶域またはネットワークに対して実行されたすべての操作に関して生成されます。イベントは、情報、マイナーまたはクリティカルのいずれかです。ターゲットがエラー状態になると、クリティカル・イベントが生成されます。クリティカル・ステータスのターゲットは、操作を実行するために使用できません。EM_CLOUD_ADMINISTRATORは、関連ターゲットを使用できないなどのイベントを確認できます。OVMイベントを確認するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでVMサーバーをクリックして、VMサーバー・ホーム・ページに移動します。

3. 「VMサーバー」メニューから「OVMイベント」、を選択します。未確認のイベントのリストが表示されます。リストからイベントを選択し、「確認」をクリックしてイベントを確認します。

5.19 NTP構成の管理

注意:

- この機能はOracle VM Manager 3.2.1以降でのみ使用できます。

- 追加対象のNTPサーバーは、NTPサービスを提供するように事前に構成されている必要があります。

ネットワーク・タイム・プロトコル(NTP)は、Oracle VM Managerで管理されるすべてのOracle VM Serverでのクロック同期を有効にするネットワーク・プロトコルです。デフォルトでは、Oracle VM Serverが検出されると、Oracle VM Managerホスト・コンピュータをNTPタイム・ソースとして使用するように構成されます。Oracle VM Serverが検出されたときに、クロックを同期するために使用するNTPサーバーのカスタム・リストを構成できます。NTPサーバーのカスタム・リストを作成するには、次の手順に従います:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。インフラストラクチャ・クラウド・ホーム・ページが表示されます。

図5-37 NTP構成

2. 左側のパネルから「Oracle VM Manager」ターゲットを右クリックして、「NTP構成の管理」を選択します。

3. NTPサーバーを追加するには、「追加」をクリックします。「NTPサーバーの追加」ダイアログ・ボックスの「IPアドレス/DNSホスト名」フィールドにNTPサーバーのIPアドレスまたはホスト名を入力し、「OK」をクリックします。

4. NTPサーバーを編集するには、表内のサーバーを選択して、「編集」をクリックします。「NTPサーバーの編集」ダイアログ・ボックスで、新しいNTPサーバーの名前を入力するように要求されます。新しいNTPサーバーのIPアドレスまたはホスト名を入力し、「OK」をクリックします。

5. NTPサーバーを削除するには、表内のサーバーを選択して、「削除」をクリックします。確認メッセージが表示されます。サーバーを削除するには、「OK」をクリックし、操作を取り消すには、「取消」をクリックします。

6. VMマネージャで管理されるすべてのOracle VM ServerでNTPサーバー構成を更新するには、「すべてのサーバーの更新」をクリックします。以前のNTP構成が上書きされます。
または、「保存」をクリックすると、追加したNTPサーバー構成を保存できます。このオプションを使用すると、構成が保存されますが、Oracle VM Serverは更新されません。後で、VMサーバーに構成をプッシュできます。

NTPサーバー構成を変更した場合は、VMサーバーを再起動して変更内容を有効にする必要があります。

注意:
複数のNTP構成を定義した場合、定義した順番がクロック同期に使用されます。

5.20 仮想マシンのインポート

注意:
この機能はOracle VM Manager 3.2.1以降でのみ使用できます。

外部の場所から、Oracle VM Managerに仮想マシンをインポートできます。インポートされた仮想マシンは選択したVMゾーン、VMサーバー・プールまたはVMサーバーの下に配置されます。仮想マシンは、別々のファイルまたは単一のアーカイブ・ファイルに圧縮されたファイル(たとえば、.tgzまたは.zipファイル)のいずれかとして、FTPサーバーまたはWebサーバー上に存在する必要があります。

仮想マシンをインポートするには、次の手順に従います:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。インフラストラクチャ・クラウド・ホーム・ページが表示されます。

2. 左側のパネルから「VMゾーン」または「VMサーバー」ターゲットを右クリックして、「仮想マシンのインポート」を選択します。仮想マシンのインポート: ターゲットとソースの選択ページが表示されます。

図5-38 仮想マシンのインポート: ターゲットとソースの選択

3. 仮想マシンのインポート先ターゲットとターゲット名が表示されます。

4. 次の詳細を入力します。

- ソース: 仮想マシンとしてインポートするアーカイブ(tgzまたはgzip)のURLを入力します。URLの形式は、HTTP、HTTPSまたはFTPです。

- リクエスト名: 仮想マシンのインポート・リクエストの名前を入力します。

5. 次をクリックします。「仮想マシンのインポート: インスタンスの詳細」ページが表示されます。

図5-39 仮想マシンのインポート: インスタンスの詳細

6. 次の詳細を入力します。

- 高可用性の有効化: このゲスト仮想マシンで高可用性を有効にする場合は、このチェック・ボックスを選択します。このオプションによって、ゲスト仮想マシンをホストする仮想サーバーが失敗する場合、ゲスト仮想マシンをプールの他の仮想サーバーで自動的に再起動できます。

注意:
高可用性は、仮想サーバー・プールおよびゲスト仮想マシンの両方で有効にする必要があります。両方を有効にしないと、高可用性は無効になります。

- 作成後にVMを開始: 作成後にゲスト仮想マシンを自動的に起動するかどうかを指定します。

- CPUスケジューリング優先度: ゲスト仮想マシンの物理CPUへのアクセスが、同じ仮想サーバー上の他のゲスト仮想マシンと競合した場合の優先度を指定します。優先度が高くなると、ゲスト仮想マシンのCPUサイクルに対する要求の権利が高くなります。

- CPUスケジューリング上限(%): ゲスト仮想マシンにおける物理CPUの使用可能量を制限します。ゲスト仮想マシンのリソースの割当てを制限する場合に、このフィールドを使用します。

- 「キーマップ」: クローニングされるゲスト仮想マシンで使用されるキーボード・マッピング。

- タグ: 仮想マシンの1つ以上のタグを指定します。これらのタグは、仮想マシンの論理的なグループ化に使用され、特定の基準を満たす1つ以上の仮想マシンの検索に使用できます。

- VMサイズ: ゲスト仮想マシンに割り当てるメモリーの量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。ゲスト仮想マシンのサイズ(メモリーおよびCPUの値)。VMサイズを、「XSサイズ」、「Mサイズ、「XLサイズ」、「カスタム」のいずれかから選択します。

注意:
インポートされた仮想マシンでは、「ルート・パスワード」、「ネットワーク」および「記憶域」構成は変更できません。

7. 次をクリックします。仮想マシンのインポート: スケジュール・ページで、「開始日」および「終了日」を指定します。「開始日」はリクエストが送信される日付で、「終了日」は仮想マシンがリタイアされる日付です。「次」をクリックします。

8. インポートされている仮想マシンの詳細を確認し、「送信」をクリックします。「エンタープライズ」メニューから、「ジョブ」、「アクティビティ」の順に選択して、ジョブ・アクティビティ・ページを表示します。このページには、発行されたジョブの詳細が表示されます。「名前」リンクをクリックして、詳細を表示できます。

5.21 リポジトリ・イベントの確認

記憶域リポジトリのファイル・システムに障害が発生した場合、クリティカル・イベントが記憶域リポジトリに発生します。このページに記憶域リポジトリのクリティカル・イベントがすべて表示されます。リポジトリ・イベントを確認するには、次の手順に従います:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。インフラストラクチャ・クラウド・ホーム・ページが表示されます。左側のパネルからOVMマネージャ・ターゲットを選択します。

2. 「VMマネージャ」メニューから「管理」を選択し、「記憶域リポジトリ」を選択します。

3. 定義された記憶域リポジトリのリストが表示されます。記憶域リポジトリ名をクリックして、「リポジトリ・イベント」タブをクリックします。

4. 未確認のクリティカル・イベントのリストが表示されます。リストからイベントを選択し、「イベントの確認」をクリックします。確認済のイベントに関連付けられたファイル・システムは使用できません。

6 クラウド・ポリシーの定義および管理

この章では、様々なターゲット・タイプのポリシーを定義し、仮想化ターゲットで特定のアクションを実行するプロセスについて説明します。内容は次のとおりです。

- クラウド・ポリシーの管理

- クラウド・ポリシーの表示

- ターゲットのポリシーの表示

- パフォーマンス・ポリシーの定義

- スケジュール・ベース・ポリシーの定義

- ポリシーのアクティブ化および非アクティブ化

- ポリシー・グループの表示

- ポリシー・グループの作成

- DRSおよびDPMポリシー

6.1 クラウド・ポリシーの管理

クラウド管理ポリシーは、EM_CLOUD_ADMINISTRATORが定義し、パフォーマンス・メトリックしきい値またはスケジュールに基づいて一定のアクションを起こすことのできるルールです。独自のポリシーを作成することも、すぐに利用可能なポリシーを使用することもできます。Oracle提供のすぐに利用可能なポリシーは編集できませんが、ポリシーの類似作成クローニングを実行して、必要な編集を行うことができます。

注意:
セルフ・サービス・ユーザー(EM_SSA_USER)も、自分にアクセス権が付与されているサービスのクラウド・ポリシーを作成できます。

クラウド管理ポリシーには、パフォーマンス・ベース・ポリシーとスケジュール・ベース・ポリシーの2つの種類があります。パフォーマンス・ポリシーは特定のターゲット・タイプのパフォーマンス・メトリックに基づきます。スケジュールベースのポリシーは、定義したスケジュールに基づいて実行されます。1つ以上のポリシーをグループ化するとポリシー・グループを作成できます。次のことができます。

- クラウド・ポリシーの表示と監視

- 次のタイプの新規ポリシーを定義します:

- パフォーマンス・ポリシー

- スケジュール・ポリシー

- ポリシーのアクティブ化または非アクティブ化

- ポリシー・グループの定義

6.2 クラウド・ポリシーの表示

すべてのクラウド・ポリシーとポリシー・グループを「クラウド・ポリシー」のホームページから表示できます。ポリシーのステータス、ポリシーのタイプ、アクション・タイプ、ポリシー・アソシエーションおよびポリシーのスケジュールなどの詳細を表示できます。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーとしてEnterprise Managerにログインし、「エンタープライズ」メニューから「クラウド」、「インフラストラクチャ・ポリシー」の順に選択します。

注意:
EM_SSA_USERロールを持つユーザーとしてログインしている場合は、「インフラストラクチャ・クラウド・セルフ・サービス・ポータル」の「ポリシー」タブをクリックします。

2. ポリシー・ホームページで、所有し、管理者権限を持つポリシーのリストが表示されます。

図6-1 クラウド・ポリシー

3. 表からポリシーを選択します。ポリシーのタイプ、パフォーマンス(ルール、アクション、アクションの説明)、スケジュール(スケジュール、アクションおよびアクションの説明)などのポリシーの詳細、ステータス、作成日およびターゲット・タイプが表示されます。

4. このページでは、次のアクションを実行できます。

- 作成: 新規ポリシーを作成するには、「作成」メニューから次のいずれかを選択します。

- スケジュール・ポリシー: 第6.5項「スケジュール・ベース・ポリシーの定義」を参照してください。

- パフォーマンス・ポリシー: 第6.4項「パフォーマンス・ポリシーの定義」を参照してください。

- 類似作成: ポリシーを選択して「類似作成」をクリックし、既存ポリシーのコピーを作成します。

- 編集: ポリシーを選択して「編集」をクリックし、「ポリシーの編集」ウィザードを開始します。ポリシーの説明を変更し、ポリシーにメトリックを追加できます。ポリシーの名前、ポリシーのタイプ、ポリシーが関連付けられたターゲット、実行できるアクションを変更することはできません。

- ポリシーのアクティブ化または非アクティブ化: 第6.6項「ポリシーのアクティブ化および非アクティブ化」を参照してください。

- ポリシー・アソシエーションの作成: 「アソシエーション」リージョンで、選択したポリシーに関連付けられているターゲットのリストを表示できます。ポリシーを1つ以上のターゲットに関連付けることができます。「追加」をクリックします。「検索と選択: ターゲット」ウィンドウで、ターゲットを選択して「選択」をクリックし、ターゲットをポリシーに関連付けます。1つ以上のターゲットをポリシーに関連付けると、次の操作を実行できます。

- ターゲットをクリックして、そのターゲットのポリシー・ページにドリルダウンします。第6.3項「ターゲットのポリシーの表示」を参照してください。

- ターゲットを選択して「履歴の表示」をクリックし、ポリシー・アクション履歴を表示します。

- ポリシーを選択して「削除」をクリックし、ポリシーのアソシエーションを削除します。

- 注意:

- アソシエーションを非アクティブなポリシーに追加することはできません。

- 「履歴の表示」オプションは、EM_SSA_USERロールを持つユーザーには使用できません。

6.3 ターゲットのポリシーの表示

ターゲットをポリシーに関連付けると、ターゲットに関連付けることのできるすべてのポリシーをポリシー・ページで表示できます。

選択したターゲットに関連付けることができるポリシーを表示するには、次の手順に従います。

1. クラウド・ポリシー・ページに移動します。

2. リスト内のアクティブなポリシーのリストからポリシーを選択します。「アソシエーション」リージョンで、ターゲット・リンクをクリックしてターゲットのポリシー・ページにドリルダウンします。

図6-2 ポリシー - ターゲット

3. 選択したターゲットに関連付けることができるすべてのポリシーが、このページにリストされます。各ポリシーには、定義されているポリシー・アソシエーションのタイプが表示されます。これには次のものがあります。

- スタンドアロン

- テンプレート・コレクション

- ポリシー・グループ

各ポリシーに対して、次の詳細が表示されます。

- ポリシーの名前と説明。

- ポリシーのタイプ(「スケジュール」または「パフォーマンス」)。

- ポリシー・アソシエーションの方法。ポリシーは、スタンドアロン・アソシエーション、テンプレート・コレクション、ポリシー・グループ、またはこれら3つの組合せに関連付けることができます。

- 「一般」セクションには、ポリシーのステータス、アソシエーションの数、ポリシーが作成された日付、およびポリシーのタイプなどの詳細が表示されます。

- 「ポリシー・アクション履歴」リージョンには、このターゲットのアソシエーションの履歴が表示されます。

注意:

- ポリシー・アソシエーションの履歴は、EM_CLOUD_ADMINISTRATORロールを持つユーザーに対してのみ表示されます。

- アクションのステータスが「失敗」の場合、「ポリシー・アクション履歴」リージョンは空白になります。

4. アクティブなポリシーでは、次の操作を実行できます。

- ポリシーを選択して「関連付け」をクリックし、ターゲットにポリシーを関連付けます。

- すでに関連付けられているポリシーを選択し、「関連付けの解除」をクリックしてポリシーの関連付けを削除します。

6.4 パフォーマンス・ポリシーの定義

パフォーマンス・ポリシーは、特定のターゲット・タイプやその関連ターゲットのパフォーマンス・メトリックに基づいて構成されます。メトリックに基づいたポリシーの条件およびルールを作成できます。

パフォーマンス・ポリシーを定義するには、次の手順に従います:

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. ポリシー・ホームページに、所有し、管理者権限を持つポリシーのリストが表示されます。

3. 「作成」メニューから、「パフォーマンス・ポリシー」を選択します。

4. 一般情報ページで、ポリシーの名前および説明を入力します。ポリシーを関連付けるターゲット・タイプを選択します。

図6-3 パフォーマンス・ポリシーの作成 - 一般

5. 次をクリックします。ルール・ページで、右パネルからメトリックを選択して「定義に追加」をクリックするか、「メトリック」列から「定義」列にメトリックをドラッグ・アンド・ドロップします。条件、値および発生回数を指定します。「一致」ラジオ・ボタンで、次を選択できます。

- すべて: ターゲットでポリシーが実行される前に、すべての条件が満たされる必要があります。

- いずれか: ポリシーが実行される前に、いずれかの条件が満たされる必要があります。

図6-4 パフォーマンス・ポリシーの作成 - ルール

6. 次をクリックします。ポリシー条件を満たした場合に実行するアクションを指定します。選択したターゲット・タイプに応じて、使用可能なアクションのリストが異なります。
通知が無効化されている場合は、次のメッセージが表示されます。

通知アクションは、現在無効になっています。電子メール・サーバーの情報を設定するには、システム管理者に連絡してください。

図6-5 パフォーマンス・ポリシーの作成 - アクション

7. ポリシーを確認し、「保存」をクリックして、このポリシーを定義し、ポリシー・ホームページに戻ります。

注意:
ポリシーを定義したら、そのポリシーに1つ以上のターゲットを関連付けることができます。

6.5 スケジュール・ベース・ポリシーの定義

ポリシーに基づくスケジュールは、事前定義済のスケジュールに基づいています。スケジュール・ベース・ポリシーを定義するには、次の手順に従います。

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. ポリシー・ホームページで、所有し、管理者権限を持つポリシーのリストが表示されます。「作成」メニューから、「スケジュール・ポリシー」を選択します。

図6-6 スケジュール・ポリシーの作成

3. スケジュール・ポリシーの作成ページで、ポリシーの名前、説明、およびポリシーを関連付けるターゲット・タイプを入力します。

4. ポリシーの猶予期間、頻度およびスケジュールを指定します。

5. ポリシー条件が満たされると、選択したターゲットのスケジュールに従ってポリシーが実行されます。ポリシーが関連付けられたターゲット・タイプに応じて、使用可能なアクションのリストが異なります。

6. 「保存」をクリックして、このポリシーを定義します。

注意:
ポリシーを定義したら、そのポリシーに1つ以上のターゲットを関連付けることができます。

6.6 ポリシーのアクティブ化および非アクティブ化

ポリシーを定義すると、ポリシーはアクティブになり、1つ以上のターゲットに適用できます。次の手順に従って、アクティブなポリシーを非アクティブにできます。

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. ポリシー・ホームページで、所有し、管理者権限を持つポリシーのリストが表示されます。

3. 表からポリシーを選択し、「解除」をクリックします。ポリシーは非アクティブ化され、ポリシーのステータスは非アクティブとマークされます。このポリシーはアクティブになるまでターゲットに関連付けできず、現在のアソシエーションはさらに評価するために一時停止されます。

ポリシーを非アクティブ化すると、「非アクティブ」としてマークされます。非アクティブなポリシーをアクティブにするには、表からポリシーを選択して「アクティブにする」をクリックします。確認ウィンドウで、「アクティブにする」を再度クリックします。これで、ポリシーが「アクティブ」としてマークされます。

6.7 ポリシー・グループの表示

ポリシー・グループは、コンプライアンス・スコアを生成するためにまとめて適用し、評価できるポリシーの集まりです。ポリシー・グループを表示するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーとしてEnterprise Managerにログインし、「エンタープライズ」メニューから「クラウド」、「インフラストラクチャ・ポリシー」の順に選択します。

注意:
EM_SSA_USERロールを持つユーザーとしてログインしている場合は、「インフラストラクチャ・クラウド・セルフ・サービス・ポータル」の「ポリシー」タブをクリックします。

2. クラウド・ポリシー・ページが表示されます。「ポリシー・グループ」タブをクリックします。

図6-7 ポリシー・グループ

3. すでに定義されているポリシー・グループのリストが表示されます。次の操作を実行できます。

- ポリシー・グループの作成: 第6.8項「ポリシー・グループの作成」を参照してください。

- 類似作成: ポリシー・グループを選択して「類似作成」をクリックし、既存ポリシー・グループのコピーを作成します。

- 編集: ポリシー・グループを選択して「編集」をクリックし、「ポリシー・グループの編集」ウィザードを開始します。ポリシー・グループからポリシーを追加または削除できます。ポリシー・グループの名前は変更できません。

- 削除: ポリシー・グループを選択して「削除」をクリックします。ポリシー・グループが削除されると、そのポリシー・グループに定義されたすべてのアソシエーションも削除されます。

注意:
作成済または権限があるポリシー・グループは編集または削除できます。

- ポリシー・グループ・アソシエーションの作成: 「ポリシー・グループ」リージョンの「アソシエーション」タブをクリックし、選択したポリシー・グループに関連付けられているターゲットのリストを表示します。

図6-8 ポリシー・グループ: アソシエーション

ポリシー・グループは、1つ以上のターゲットに関連付けることができます。「追加」をクリックします。「検索と選択: ターゲット」ウィンドウで、ターゲットを選択して「選択」をクリックし、ターゲットをポリシー・グループに関連付けます。1つ以上のターゲットをポリシー・グループに関連付けると、次の操作を実行できます。

- ターゲットをクリックして、そのターゲットのポリシー・ページにドリルダウンします。第6.3項「ターゲットのポリシーの表示」を参照してください。

- ターゲットを選択して「履歴の表示」をクリックし、ポリシー・グループのアクションの履歴を表示します。

- ターゲットを選択して「削除」をクリックし、ポリシー・グループ・アソシエーションを削除します。

- ポリシーの表示: 「ポリシー・グループ」リージョンの「含まれるポリシー」タブをクリックし、ポリシー・グループに含まれるポリシーのリストを表示します。

図6-9 ポリシー・グループ: 含まれるポリシー

6.8 ポリシー・グループの作成

ポリシー・グループを定義するには、次の手順に従います:

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. 「ポリシー・グループ」タブをクリックします。ポリシー・グループ・ページに、定義されているポリシー・グループのリストが表示されます。

3. 「作成」をクリックします。ポリシー・グループの作成ページが表示されます。

図6-10 ポリシー・グループ: 作成

4. 「追加」をクリックします。ポリシー・グループに追加できるポリシーのリストが表示されます。リストから1つ以上のポリシーを選択し、「選択」をクリックします。

5. 選択したポリシーは、ポリシー・グループに追加されます。「OK」をクリックして、このポリシー・グループを保存します。

6. 「OK」をクリックして、このポリシー・グループを保存します。

6.8.1 例1

毎週金曜の6:00 pmにゲスト仮想マシンを停止して、毎週月曜の9:00 pmに再起動する場合、次のようにポリシーを作成できます。

- まず、ゲスト仮想マシンを毎週金曜の6:00 pmに停止するスケジュール・ベース・ポリシーを作成します。第6.8.1.1項「ゲスト仮想マシン停止ポリシー」を参照してください。

- 次に、ゲスト仮想マシンを毎週月曜の6:00に再起動する別のスケジュール・ベース・ポリシーを作成します。第6.8.1.2項「ゲスト仮想マシン起動ポリシー」を参照してください。

- これら2つのポリシーを1つのポリシー・グループに統合して、これらのポリシーを1つ以上のゲスト仮想マシン・ターゲットに関連付けます。第6.8.1.3項「ポリシー・グループの作成(起動および停止)」を参照してください。

6.8.1.1 ゲスト仮想マシン停止ポリシー

ゲスト仮想マシンを毎週金曜に停止するには、次のようにポリシーを設定します。

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. クラウド・ポリシー・ページで、「作成」メニューから「スケジュール・ポリシー」を選択します。スケジュール・ポリシーの作成ページで次の詳細を入力します。

- ポリシーの名前と説明を入力します。

- ターゲット・タイプとして「Oracle VMゲスト」を選択します。

- 「ポリシー・アクション」フィールドで「停止」を選択します。

- 「起動」フィールドで、このポリシーを有効にする日時を指定します。

- 「繰返し」フィールドで「特定の曜日」を選択し、「曜日」チェック・ボックスで「金曜」を選択します。

図6-11 スケジュール・ポリシーの作成(例1)

3. 「OK」をクリックし、このポリシーを保存してクラウド・ポリシー・ページに戻ります。

6.8.1.2 ゲスト仮想マシン起動ポリシー

ゲスト仮想マシンを毎週月曜に起動するには、クラウド・ポリシー・ページに移動して、作成したばかりのポリシーを選択します。次の手順を実行します。

1. 「類似作成」をクリックしてポリシーのコピーを作成します。

2. クラウド・ポリシー・ページで、「作成」メニューから「スケジュール・ポリシー」を選択します。スケジュール・ポリシーの作成ページで次の詳細を入力します。

- ポリシーの名前と説明を入力します。

- ターゲット・タイプとして「Oracle VMゲスト」を選択します。

- 「ポリシー・アクション」フィールドで「起動」を選択します。

- 「起動」フィールドで、このポリシーを有効にする日時を指定します。

- 「繰返し」フィールドで「特定の曜日」を選択し、「曜日」チェック・ボックスで「月曜」を選択します。

3. 「OK」をクリックし、このポリシーを保存してクラウド・ポリシー・ページに戻ります。

6.8.1.3 ポリシー・グループの作成(起動および停止)

ゲスト仮想マシン・ターゲット・タイプの2つのポリシーを定義した後、これらのポリシーを1つのポリシー・グループに統合して、ポリシーを1つ以上のターゲットに関連付けることができます。ポリシー・グループを作成するには、次の手順に従います:

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. クラウド・ポリシー・ページで「ポリシー・グループ」をクリックします。

3. 「作成」をクリックします。クラウド・ポリシー・グループ・ページが表示されます。

4. グループの名前と説明を入力します。

5. 「追加」をクリックし、作成した2つのスケジュール・ポリシーを選択します。

6. 「OK」をクリックしてクラウド・ポリシー・ページに戻り、作成したポリシー・グループをクリックします。

7. 作成したポリシー・グループの詳細(ポリシー・グループの名前、このグループに関連付けられているポリシーの数、関連付けられているターゲットの数など)が表示されます。

8. 下部にある「含まれるポリシー」タブをクリックして、このポリシー・グループに関連付けられているポリシーを表示します。

9. 「アソシエーション」タブをクリックして、このポリシーに関連付けられているゲスト仮想マシンのリストを表示します。このポリシー・グループにさらにゲスト仮想マシンを関連付けるには、「追加」をクリックします。

10. このポリシー・グループがアクティブな場合、このポリシーに関連付けられているゲスト仮想マシンはスケジュールどおりに停止および起動されます。

6.8.2 例2

層インスタンスを毎週金曜に1にスケール・ダウンし、毎週月曜に2にスケール・アップする、Oracle層インスタンス・ターゲットのポリシー・グループを定義するとします。次のポリシーを作成できます。

- まず、層インスタンスを1にスケール・ダウンするスケジュール・ポリシーを作成します。第6.8.2.1項「層インスタンス・スケール・ダウン・ポリシー」を参照してください。

- 次に、層インスタンスを毎週月曜日に2にスケール・アップする別のポリシーを作成します。第6.8.2.2項「層インスタンス・スケール・アップ・ポリシー」を参照してください。

- これらのポリシーを統合して1つのポリシー・グループを作成します。第6.8.2.3項「ポリシー・グループの作成(スケール・アップおよびスケール・ダウン)」を参照してください。

6.8.2.1 層インスタンス・スケール・ダウン・ポリシー

層インスタンスを毎週金曜にスケール・ダウンするには、次のようにパフォーマンスポリシーを設定します。

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. クラウド・ポリシー・ページで、「作成」メニューから「スケジュール・ポリシー」を選択します。スケジュール・ポリシーの作成ページが表示されます。

図6-12 スケジュール・ポリシーの例I

3. ポリシーの名前と説明を入力し、次の詳細を指定します。

- ターゲット・タイプ: 「層インスタンス」ターゲット・タイプを選択します。

- ポリシー・アクション: 「スケール・ダウン」ポリシー・アクションを選択します。

- 繰返し: 「繰返し」フィールドで、「特定の曜日」を選択します。

- 曜日: ここでは、「金曜日」を選択します。

4. 「OK」をクリックしてポリシーを保存します。

6.8.2.2 層インスタンス・スケール・アップ・ポリシー

層インスタンスを毎週金曜にスケール・ダウンするには、次のようにパフォーマンスポリシーを設定します。

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. クラウド・ポリシー・ページで、「作成」メニューから「スケジュール・ポリシー」を選択します。スケジュール・ポリシーの作成ページが表示されます。

図6-13 スケジュール・ポリシーの例II

3. ポリシーの名前と説明を入力し、次の詳細を指定します。

- ターゲット・タイプ: 「層インスタンス」ターゲット・タイプを選択します。

- ポリシー・アクション: 「スケール・アップ」ポリシー・アクションを選択します。

- アクション・パラメータ: 「ノード数」パラメータに2を入力します。

- 繰返し: 「繰返し」フィールドで、「特定の曜日」を選択します。

- 曜日: ここでは、「月曜日」を選択します。

4. 「OK」をクリックしてポリシーを保存します。

6.8.2.3 ポリシー・グループの作成(スケール・アップおよびスケール・ダウン)

Oracle層インスタンス・ターゲット・タイプの2つのポリシーを定義した後、これらのポリシーを1つのポリシー・グループに統合して、ポリシーを1つ以上のターゲットに関連付けることができます。ポリシー・グループを作成するには、次の手順に従います:

1. ユーザー・ロールに応じて、メニュー・オプションを使用してインフラストラクチャ・ポリシー・ページに移動します。

2. クラウド・ポリシー・ページで「ポリシー・グループ」をクリックします。

3. 「作成」をクリックします。クラウド・ポリシー・グループ・ページが表示されます。

4. グループの名前と説明を入力します。

5. 「追加」をクリックし、作成した2つのスケジュール・ポリシーを選択します。

6. 「OK」をクリックしてクラウド・ポリシー・ページに戻り、作成したポリシー・グループをクリックします。

6.9 DRSおよびDPMポリシー

リソースの動的スケジューリング(DRS)ポリシーおよび分散電源管理(DPM)ポリシーは、サービスの品質を改善し、負荷に基づいて実行中の仮想マシンをサーバー・プール内で動的に再配置することにより電力消費を減らします。

リソースの動的スケジューリング(Dynamic Resource Scheduling: DRS)ポリシーは、Oracle VM Serverの使用率をリアルタイムで監視してサーバー・プールをリバランスし、実行中の仮想マシンに安定したリソースを提供します。DRSにより、負荷の高いOracle VM ServerのVMが、より多くのリソースを使用可能なOracle VM Serverに移行されます。

分散電源管理(Distributed Power Management: DPM)ポリシーにより、電力消費を最小化するようにサーバー・プールが最適化されます。DPMは、リソース使用率が少ない期間はプール内の電源オンのサーバーを減らすことで、DRSをさらに完全なものにします。これによって、リソース使用率が増加したときに、必要に応じて自動的に電源がオンになります。

DRS/DPMポリシーを設定するには、次の手順に従います:

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーとしてログインし、「エンタープライズ」メニューから「クラウド」、「インフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでVMサーバー・プール・ターゲットを右クリックして、「DRS/DPMポリシーの管理」を選択します。「構成」をクリックします。DRS/DPMの構成: 一般ページが表示されます。

図6-14 DRS/DPMの構成: 一般

3. 「ポリシー・タイプ」を選択します。これには次のものがあります。

- 分散リソース・スケジューラ: サーバー・プール内の仮想マシンのリソース使用率を最適化する場合に、このポリシー・タイプを選択します。

- 分散電源管理: リソース使用率が比較的低い期間に、統合率を増やし、使用するOracle VM Serverの数を減らす場合に、このポリシー・タイプを選択します。

4. 期間(分)を指定します。これは、ポリシー・ジョブを実行する期間です。これは、ポリシー・ジョブをn分ごとに実行するように設定しますが、たとえば、10に設定すると、10分ごとにポリシー・ジョブを実行します。1から60までの数字を入力できます。

5. 「仮想サーバー」リージョンで「追加」をクリックして、ポリシーを有効化する1つ以上の仮想サーバー・ターゲットを追加します。

6. 仮想サーバーのCPUの制約を、次のように指定します。

- 有効化: このフィールドを設定して、CPUパフォーマンスおよび使用率のロギングを有効または無効にします。

- しきい値: ポリシーが成立する前に許可されるCPUパーセント使用率の最大量。0から99まで入力できます。

7. 次をクリックします。DRS/DPMの構成: ネットワーク・ページが表示されます。

図6-15 DRS/DPMの構成: ネットワーク

8. 「有効化」チェック・ボックスを選択して、ネットワークでポリシーを有効化するかどうかを示し、ネットワークでポリシーが成立するしきい値を選択します。

9. 「適用」をクリックします。

注意:
ポリシーの作成後、ポリシーは有効化され、ポリシーに含まれるすべての仮想サーバー・プール・ターゲットに適用されます。DRS/DPMポリシーを無効化するには、Oracle VM Serverプール・ターゲット・タイプのスケジュール・ベース・ポリシーを作成して、「ポリシー・アクション」フィールドで「DRS/DPMポリシーの無効化」ポリシーを選択します。スケジュール・ベース・ポリシーの作成の詳細は、第6.5項「スケジュール・ベース・ポリシーの定義」を参照してください。スケジュール・ポリシーを編集し、必要に応じて「DRSの有効化」または「DPMの有効化」を選択して、ポリシーを有効化できます。

6.9.1 自動DRSまたはDPMポリシーの作成

次の手順に従って、自動DRSまたはDPMポリシーを作成できます。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーとしてログインし、「エンタープライズ」メニューから「クラウド」、「インフラストラクチャ・ポリシー」の順に選択します。

2. 「作成」メニューから、「スケジュール・ポリシー」を選択します。

3. スケジュール・ポリシーの作成ページで、ポリシーの名前と説明を入力します。

4. ターゲット・タイプとして「Oracle VMサーバー・プール」を選択します。

5. 「ポリシー・アクション」フィールドから「DRSの有効化」または「DPMの有効化」を選択します。

6. ポリシーのスケジュールと頻度を指定し、「OK」をクリックしてポリシーを保存します。

7. クラウド・ポリシー・ページで作成したポリシーを選択し、「アソシエーション」リージョンで「追加」をクリックします。

8. ポリシーを関連付けるOracle VM Serverプール・ターゲットを選択して、「選択」をクリックします。

9. 選択したターゲットに対してDRMまたはDPMポリシーが自動的に有効化されます。

7 IaaSセルフ・サービス・ポータルの設定

この章では、セルフ・サービス・ポータルを設定するプロセスについて説明します。内容は次のとおりです。

- セルフ・サービス・ポータルの設定

- 大きなサイズのファイルのセルフ・サービス・ポータルへのアップロード

7.1 セルフ・サービス・ポータルの設定

セルフ・サービス・ポータルでは、管理者はクラウドを構成して、各ユーザーが予約可能なリソースの総量や各ユーザー・ロールの割当てなどの様々な操作を行うことができます。ユーザーは、セルフ・サービス・ポータルにログインして、必要なイメージを特定し、リソース(たとえば、処理能力、記憶域、メモリーなど)を予約し、システム固有のポリシーを定義できます。

注意:
ここをクリックすると、Enterprise Manager Cloud Control 12cを使用してクラウドのセルフ・サービス機能を有効化する方法について、視覚的デモンストレーションを参照できます。割当て制限と権限を割り当て、セルフ・サービス・ポータルにアセンブリを公開し、クラウドのメータリングとチャージバックを構成して、セルフ・サービスのロールおよびユーザーを設定する方法を確認できます。

セルフ・サービス・ポータルを使用するには、ユーザー割当て制限、ゾーン・アクセスのロールおよびソフトウェア・コンポーネントを定義する必要があります。

前提条件

- Enterprise Manager Cloud Controlは、クラウド環境を管理するように設定されます。

- Enterprise Manager管理者は、セルフ・サービス・アプリケーションを設定する権限を持っている必要があります。このユーザーにはEM_SSA_ADMINISTRATORロールが必要です。詳細は、第3.3項「ロールの定義およびユーザーの割当て」を参照してください。

このプロセスに従って、セルフ・サービス・ポータルを設定し構成します。

1. 「設定」メニューから、「クラウド」、「インフラストラクチャ」の順に選択します。左側のパネルの「マシン・サイズ」をクリックします。「XSサイズ」、「Mサイズ」および「XLサイズ」の即時利用可能なマシン・サイズが利用できます。

図7-1 セルフ・サービス・ポータルの設定 - マシン・サイズ

- セルフ・サービス・ポータル設定のデモを見るには、ページの「ページ・リフレッシュ」セクションの横のビデオ・リンクをクリックします。「作成」をクリックし、マシン・サイズを追加します。名前(マシン・サイズの内部名)、説明、VCPUの数、メモリー量、このサイズのマシンに割り当てられるローカル記憶域を入力するよう求められます。「作成」をクリックし、このマシン・サイズを追加します。

- リストからマシン・サイズを選択し、「編集」をクリックします。各マシンのメモリー量、CPUの数およびローカル記憶域を指定して、マシン・サイズを構成できます。サーバーをリクエストするとき、SSAユーザーは、ここに示すマシン・サイズを指定できます。

2. 左側のパネルの「リクエスト設定」をクリックし、リクエストに関連するポリシーを定義します。このページでは、次の詳細を入力できます。

- 将来の予約: リクエストを事前に作成できる最大期間を示します。

- リクエスト期間: リクエストを作成できる最大期間。

- ネットワーク制限: EM_SSA_USERロールごとに物理ネットワークを制限できます。この機能を有効にすると、「ロール」ページに移動してEM_SSA_USERロールごとにネットワークを割り当てることができます。

- EMエージェントの構成: 「EMエージェント構成の有効化」チェック・ボックスを選択し、セルフ・サービス・ユーザーのリクエストを処理するサーバー上の管理エージェントを構成します。

注意:
管理エージェントを構成するように選択した場合、次の点を確認する必要があります。

- 「インストールのベース・ディレクトリ」フィールドに指定したディレクトリへの書込み権限が有効であること。

- アセンブリまたはテンプレートのデプロイ時に指定した/home/oracle/agentディレクトリへの書込み権眼が有効であること。

- 必要なソフトウェア・コンポーネントが構成されていること。

- 一部デプロイメントの許可: 一部デプロイメントを有効にするには、このオプションを選択します。デフォルトでは、デプロイメントが失敗すると、アセンブリ・インスタンス、層インスタンスおよび作成したゲストVMは、自動的に削除されます。しかし、一部デプロイメントが有効化された場合、このクリーン・アップ・アクティビティは無効になります。

- ソフトウェア・ライブラリの最上位フォルダ: ユーザー固有のフォルダの作成が必要とされる、ソフトウェア・ライブラリの最上位フォルダを選択します。このフォルダは、SSAユーザーがそのアセンブリ、テンプレートおよびデプロイメント・プランを格納するために使用します。

図7-2 インフラストラクチャ・クラウド・セルフ・サービス・ポータルの設定 - リクエスト設定

3. 左側のパネルの「ロール」をクリックして、ロールとその他のエンティティ(ゾーン、割当ておよびネットワーク・プロファイルなど)間のマッピングを定義します。SSA管理者は、SSAユーザーがリクエストできる割当て制限を制御でき、クラウド・リソースの過剰なプロビジョニングを防ぎます。

図7-3 インフラストラクチャ・クラウド・セルフ・サービス・ポータルの設定 - ロール

4. ロール・ページで、「ロールへのアサイン割当て制限」をクリックして、ロール・レベルの割当て制限を定義します。ロールに割り当てられた割当て制限は、そのロールを保有するすべてのユーザーが使用できます。たとえば、SSA_USER_ROLE1の「サーバー数」が5に設定されている場合、このロールを保有するすべてのユーザーが最大5サーバーまで使用できます。割当て制限とは、特定のロールに属する各セルフ・サービス・ユーザーに付与できるリソースの合計量です。ユーザーに複数のロールがある場合、割当て制限は、それぞれの属性値を持つロールの中の最大値から算出されます。

- ロールの選択: 懐中電灯アイコンをクリックして、マッピングを定義するロールを選択します。すべてのSSAロールのリストが表示されます。

- ゾーンの選択: 懐中電灯アイコンをクリックします。ゾーン作成時に「クラウド・セルフ・サービス・ゾーン」とマークされたすべてのゾーンがここに表示されます。リストからゾーンを選択し、「OK」をクリックします。

- サーバー数: いつでも予約可能な最大サーバー数。これはゾーン全体での数です。たとえば、1ユーザーに5つを割り当てます。その場合は、すべてのゾーンのインスタンスの合計数は5になります。これで、ユーザーはゾーン1に3つのインスタンス、ゾーン2に2つのインスタンスを持ったり、同じゾーンに5つすべてのインスタンスを持つことができます。

- VCPUの数: 割当て可能なVCPUの最大数。

- メモリー: 割当て可能なメモリーの最大量。

- ローカル・ディスク: 割当て可能なローカル記憶域の最大量。

- 追加記憶域: 割当て可能な追加記憶域の最大量。

- ソフトウェア・ライブラリへのアーカイブを許可: 失効後にマシン・イメージをソフトウェア・ライブラリにアーカイブできるかどうかを示します。このオプションを選択して、ゲスト仮想マシンの停止時にマシン・イメージをテンプレートとして保存することもできます。

- ネットワークの選択: このフィールドは、「ネットワーク制限」が有効化されている場合にのみ表示されます。懐中電灯アイコンをクリックすると、そのロールのすべてのユーザーに割り当てる物理ネットワークを選択できます。

- ネットワーク・プロファイルの選択: 選択したロールに割り当てられているネットワーク・プロファイルを選択します。ネットワーク・プロファイルで定義されている特定のネットワークのすべてのデプロイの完了。

注意:
選択されたシステムに関連付けられているコンポーネントの概要が表示されます。ネットワーク・プロファイルの作成の詳細は、第5.8項「ネットワーク・プロファイルの作成」を参照してください。

- グローバル・リクエスト設定のオーバーライド: 選択したロールのリクエスト設定をオーバーライドするには、このチェック・ボックスを選択します。将来の予約とリクエスト期間を変更し、管理エージェントを構成できます。

ロールを選択し、「編集」をクリックします。割当て、ゾーンおよびネットワーク・プロファイルをロールに割当てページで、ロールのマッピングを変更できます。

5. 左側のパネルの「ソフトウェアのコンポーネント」をクリックして、SSAユーザーがアクセス可能なテンプレートまたはアセンブリのセットを選択します。アセンブリおよびテンプレートをSSAポータルに公開し、これらのソフトウェア・コンポーネントへのアクセスをSSAユーザーに提供できます。

図7-4 インフラストラクチャ・クラウド・セルフ・サービス・ポータルの設定 - ソフトウェアのコンポーネント

6. このページでは次を行えます:

- コンポーネントの追加: 「コンポーネントの追加」をクリックします。アセンブリ/テンプレートのロールへの発行ページが表示されます。

図7-5 アセンブリ/テンプレートのロールへの発行

このページで、次を行います:

1. 「追加」をクリックします。リストからアセンブリまたはテンプレートを選択し、「選択」をクリックします。

2. 「ロールの選択」セクションで、「追加」をクリックします。リストからロールを選択し、「選択」をクリックします。

3. 「公開」をクリックして、ソフトウェア・コンポーネントをSSAポータルに公開します。ソフトウェア・コンポーネントは、SSAユーザーに使用可能となり、デプロイされます。

注意:
ソフトウェア・ライブラリにアップロードされた場合、アセンブリまたはテンプレートのリストが表示されます。ソフトウェア・ライブラリへのコンポーネントのアップロードの詳細は、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。

- インポート: 公開されたアセンブリを、選択したゾーンのセットにインポートできます。アセンブリを選択し、インポートをクリックします。「ゾーンの選択」ページで、1つ以上のゾーンを選択し、「保存」をクリックして、選択したゾーンにアセンブリをインポートします。

- 構成: ソフトウェア・コンポーネントを選択して、「構成」をクリックして管理エージェントを構成します。

注意:
リクエスト設定ページでエージェント構成の有効化チェック・ボックスが選択されている場合にのみ、管理エージェントをデプロイできます。

次の詳細な管理エージェント構成が表示されます。

- インストールのベース・ディレクトリ(必須):管理エージェントのインストール先となるディレクトリへのフルパスを指定します。レスポンス・ファイル内に指定するインストールのベース・ディレクトリが空であり、書込み権限を持っていることを確認します。必須フィールドです。

- プラットフォーム(必須): 管理エージェント・ソフトウェアをダウンロードするプラットフォームです。必須フィールドです。

- パスワード(必須): 新しい管理エージェントを登録するためのパスワードを指定します。デフォルトで、Oracle Management Serviceと管理エージェント間の通信は保護およびロックされます。登録されるすべての管理エージェントは、認証される必要があります。ここで指定したパスワードは、新しい管理エージェントの認証に使用されます。

- ポート(必須): 管理エージェント処理に使用されるポートを入力します。値が指定されていない場合は、3872か、または1830から1849の間の任意の空きポートが使用されます。

- 追加パラメータ: エージェントのインストールでサポートされているいくつかのオプションを追加できます。詳細は、Enterprise Managerの基本インストレーション・ガイドを参照してください。

- SSHタイムアウト: SSHのタイムアウト(分)。

- 権限委任設定: rootとして実行。

- 層構成: 製品およびネットワーク構成のタイムアウト値とログ・ファイルの場所を指定します。

詳細を指定して「OK」をクリックし、管理エージェントを構成します。

- ルールのインポート: 事前定義済のスケジュールに基づいて、公開されたアセンブリおよびテンプレートをゾーンに定期的にインポートするルールを定義できます。ルールのインポート・セクションの「作成」をクリックします。ルール名を入力し、ゾーンのセットとインポートのスケジュールを選択し、「保存」をクリックします。公開されたアセンブリまたはテンプレートが、選択したサーバー・プールおよびゾーンに定期的にインポートされます。

7. 左側のパネルの「チャージバック」タブをクリックします。チャージバック・アプリケーションにより、SSA管理者はチャージ・プランを定義し、そのプランを特定のゾーンまたはターゲットに割り当てることができます。

図7-6 チャージバック

8. チャージバック・プランの設定では、次の操作を実行します。

- 拡張チャージ・プランの定義: 「チャージ・プランの構成」をクリックします。基本チャージ・プランを編集したり、拡張チャージ・プランを作成して、特定のターゲット・タイプ向けにチャージ・プランをカスタマイズできます。

- チャージ・プランの割当て: 「ターゲットの構成」をクリックします。チャージ・プランは、ターゲットのセットに割当て可能です。

- コスト・センターの設定: 「コスト・センターの構成」をクリックします。ユーザーのグループの中で、コストを集約するコスト・センターを設定できます。

チャージバック・プラン設定の詳細は、第43章の「チャージバック管理」を参照してください。

7.2 大きなサイズのファイルのセルフ・サービス・ポータルへのアップロード

EM_SSA_USERは、ソフトウェア・コンポーネントをライブラリの場所にアップロードできます。詳細は、第8.7項「ライブラリの表示」を参照してください。アップロードするファイルのサイズが大きい場合、EM_SSA_USERに次のメッセージが表示されます。

エラー: ファイルが大きすぎます。もっと小さいファイルを追加してください。

この問題を解決するには、次のいずれかの方法を使用します。

7.2.1 emctlを使用したOMSプロパティの設定

Oracle Management Serviceプロパティを設定するには、次の手順に従います。

1. OMSプロパティoracle.sysman.emSDK.ui.trinidad.uploadedfilemaxdiskspaceを、アップロードするファイルのサイズより大きい値(バイト単位)に設定します。たとえば、プロパティの値を3GBに設定するには、次のようにします。
$ORACLE_HOME/bin/emctl set property -name "oracle.sysman.emSDK.ui.trinidad.uploadedfilemaxdiskspace" -sysman_pwd sysman -value 3221225472

2. アップロードするファイルが巨大な場合、アップロードの進行中にページが期限切れになることがあります(通常、約10分後)。これを避けるために、OMSプロパティoracle.sysman.eml.maxInactiveTimeを、アップロード完了予定時間よりも大きい値(秒単位)に設定する必要があります。このプロパティを設定したら、新しいプロパティ値を反映するためにOMSを再起動する必要があります。

7.2.2 web.xml構成ファイルの変更

web.xml構成ファイルを変更するには、次の手順に従います。

1. Oracle Management Serviceホームの次の場所に移動して、web.xml構成ファイルを検索します。
./oms/sysman/archives/emgc/deployments/EMGC_DOMAIN/emgc.ear/em.war/WEB-INF/web.xml

このディレクトリ構造が存在しない場合、Oracle Management Serviceホームの次の場所に移動します

./oms/sysman/archives/emgc/deployments/GCDomain/emgc.ear/em.war/WEB-INF/web.xml

2. web.xmlファイルを開き、次の4行を見つけます。web.xmlに次の行がない場合は、追加する必要があります。<param_value>パラメータのサイズを、アップロードされるファイルのサイズより大きい値に増やします。
<context-param>

<param-name>org.apache.myfaces.trinidad.UPLOAD_MAX_DISK_SPACE</param-name>

<param-value>40960000</param-value>

</context-param>

<context-param>

<param-name>org.apache.myfaces.trinidad.UPLOAD_MAX_FILE_SIZE</param-name>

<param-value>40960000</param-value>

</context-param>

3. チャンク・サイズが小さいほど、大規模ファイルのアップロード時のパフォーマンスが向上します。デフォルトでは、チャンク・サイズは2GBになります。これをより小さいチャンク・サイズ(500MBなど)に設定すると、ブラウザのメモリー使用量が最適化されます。チャンク・サイズを設定するためのパラメータは、org.apache.myfaces.trinidad.UPLOAD_MAX_CHUNK_SIZEです。
<context-param>

<param-name> org.apache.myfaces.trinidad.UPLOAD_MAX_CHUNK_SIZE</param-name>

<param-value>40960000</param-value>

</context-param>

4. アップロードするファイルが巨大な場合、アップロードの進行中にページが期限切れになることがあります(通常、約10分後)。これを避けるために、OMSプロパティoracle.sysman.eml.maxInactiveTimeを、アップロード完了予定時間よりも大きい値(秒単位)に設定する必要があります。
たとえば、$ORACLE_HOME/bin/emctl set property -name oracle.sysman.eml.maxInactiveTime -value 3600を設定します。

5. 更新した設定を反映するためにOracle Management Serviceを再起動します。

6. ファイル・アップロードの進行中、アップロードされたチャンクがOMSのデフォルトの場所に書き込まれます。デフォルトの場所は、通常、WebLogic Server上にアプリケーションがデプロイされる場所のサブディレクトリです。この場所は、web.xmlファイルのパラメータorg.apache.myfaces.trinidad.UPLOAD_TEMP_DIRをカスタムの場所に設定することで構成できます。OMSで複数のユーザーが同時にファイルをアップロードする場合は、この場所にこれらのデータすべてを収容する十分なディスク領域があることを確認してください。この場所は、OMSがインストールされている場所とは別のボリュームにすることが推奨されます。これによって、ボリュームの領域が不足しても、OMSのパフォーマンスは影響を受けずに済みます。

8 IaaSセルフ・サービス・ポータルの使用

この章では、IaaSのセルフ・サービス・ポータルの使用手順について説明します。内容は次のとおりです。

- セルフ・サービス・ポータルを使用したサーバー・リソースのリクエスト

- サーバーのリクエスト

- リクエストの表示

- サーバーの表示

- 記憶域の表示

- チャージバックの詳細の表示

- ライブラリの表示

- ポリシーの表示

- プリファレンスの表示

注意:
ここをクリックすると、Enterprise Manager Cloud Control 12cを使用して、クラウド・セルフ・サービス・ポータルを通じた新しいデプロイメント・リクエストの作成、リクエストしたデプロイメントの管理、メータリングとチャージバックの情報の追跡、およびクラウド・ポリシーの作成と強制を可能にする方法について、視覚的デモンストレーションを参照できます。

8.1 セルフ・サービス・ポータルを使用したサーバー・リソースのリクエスト

IaaSのセルフ・サービス・ポータルでは、ビジネス・ユーザーおよびクラウド・コンシューマがリソースをリクエストするためのダッシュボードが提供されます。これにより、SSAユーザーは、リソースのリクエストおよび管理ができ、メータリングおよびリソースの使用状況の表示が可能となり、ワークロードを管理するポリシーを定義して自動的にデプロイできます。SSAポータルにより、ユーザーは次のことができます。

- 新規デプロイメント・リクエストの作成

- リクエストしたデプロイメントの管理

- メータリングおよびチャージバック情報の追跡

- 作成者およびクラウド・ポリシーの強制

セルフ・サービス・ポータルを使用する手順:

1. EM_SSA_USERロールを持つユーザーでログインします。

2. クラウド・セルフ・サービス・ポータル・ホーム・ページが表示されます。セルフ・サービス・ポータルの使用のデモを見るには、「ページ・リフレッシュ」セクションの横のビデオ・リンクをクリックします。次の詳細が表示されます。

- 通知: マシンの有効期限と新しいアセンブリに関連する通知をリストします。

- 使用状況: サーバーおよび記憶域のリクエストに使用可能な合計割当て制限量と、使用されている割当て制限をリストします。

- 最新10個のリクエストされたサーバー: 所有する上位の10個のマシンを作成日の降順でリストします。サーバー名をクリックすると、サーバーの詳細が表示されます。詳細は、第8.4.4.3項「サーバーの詳細ページ」を参照してください。

- 10個の最新リクエスト: このセクションは、次のようにソートされる上位10個のリクエストをリストします。

- 終了日の降順。

- 作成日の降順。

リクエストの詳細を表示するには「リクエスト名」をクリックします。

図8-1 インフラストラクチャ・クラウド・セルフ・サービス・ポータルの設定

3. 「サーバーのリクエスト」をクリックします。新規サーバー・リクエスト・ウィザードが表示されます。詳細は、第8.2項「サーバーのリクエスト」を参照してください。

8.2 サーバーのリクエスト

特定の期間にサーバーをリクエストまたは予約する必要がある場合、次のプロセスに従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「セルフ・サービス・ポータル」を選択します。

2. クラウド・セルフ・サービス・ポータル・ページで、「サーバーのリクエスト」をクリックして、仮想マシンの新規リクエストを作成します。

3. 一般ページで、リクエストの名前を入力し、サーバーを作成するゾーンを選択します。

図8-2 新規サーバー・リクエスト: 一般

4. 「ソース」フィールドの「検索」アイコンをクリックします。このリクエストに使用するアセンブリまたはテンプレートを選択し、サーバー名を入力します。アセンブリ・コンポーネントを作成する方法の詳細は、第9.8.3.1.1項「アセンブリ・コンポーネントの作成」を参照してください。テンプレート・コンポーネントの作成方法の詳細は、第9.8.3.1.2項「テンプレート・コンポーネントの作成」を参照してください。

注意:

- 選択するソース・ファイルは、アセンブリの場合は.ova形式、テンプレートの場合は.tgz形式である必要があります。

- EM_SSA_ADMINISTRATORロールを持つユーザーによって付与されたアクセス権を持っているアセンブリとテンプレートのみ参照できます。

5. 保存またはインポートされている既存のデプロイ・プランから、デプロイのフローの中で事前に値を埋め込むデプロイ・プランを選択することもできます。

6. 次をクリックします。アセンブリを選択済の場合、次のページが表示されます。

図8-3 新規サーバー・リクエスト: デプロイメント構成(アセンブリ)

7. テンプレートを選択済の場合、次のページが表示されます。

図8-4 新規サーバー・リクエスト: デプロイメント構成(アセンブリ)

8. 選択に応じて、アセンブリまたはテンプレートに定義されている構成プロパティが表示されます。構成する層をクリックします。

9. 「サーバー構成」タブをクリックします。次のリージョンを構成できます。

- 一般

- 高可用性の有効化: このサーバーで高可用性を有効にする場合は、このチェック・ボックスを選択します。

- ルート・パスワード: サーバーへのアクセスに使用されるルート・パスワード。

- キーマップ: サーバーのキーボード・タイプを選択します。

- タグ: サーバーの識別に使用できるタグを指定できます。これらのタグを使用して、「マイ・サーバー」ページでサーバーを検索できます。

- ネットワーク: サーバーのネットワーク・インタフェース。ネットワーク・インタフェース・カードを追加する場合は、「追加」をクリックします。「ネットワーク・インタフェース・カードの追加」で、NICカードの名前を指定し、「OK」をクリックします。

注意:
「編集」オプションで、NICのIP割当てを変更できます。このオプションは、次の場合にのみ使用できます。

- NICがアセンブリ定義の一部である場合。

- NICはいずれのアセンブリ・ネットワークにも関連付けられていない場合。アセンブリ・ネットワークに関連付けられているNICの場合、IP割当ての変更は、NICがバックエンド・ネットワークに割り当てられている場合のみ可能です。

QoSおよびバックエンド・ネットワークを変更する場合は、ページ右上にある「ネットワークの構成」をクリックします。

注意: セルフ・サービス管理者によって「ネットワーク制限」が有効化されている場合、バックエンド・ネットワークは編集できません。

図8-5 SSA: ネットワークの構成

このページでは、アセンブリ・ネットワークに関連付けられるネットワークQoSおよびバックエンド・ネットワークを構成できます。すべてのNICが、割り当てられたネットワークQoSおよびバックエンド・ネットワークに基づいて構成されます。「OK」をクリックして前のページに戻ります。

- サーバー・サイズ: サーバー・サイズが「large」、「medium」または「small」の場合は、サーバーに割り当てることができる最大メモリーおよび最大CPU数を変更できます。サーバー・サイズがカスタムの場合は、サーバーに割り当てることができるメモリーおよびサーバーに割り当てるCPUコア数を指定できます。

- ストレージ: サーバーに割り当てるストレージ・ディスク。これは、システム定義またはカスタムにできます。

10. 「製品の構成」タブをクリックします。このタブには、層内の製品のプロパティが表示されます。「すべてのプロパティ」または「必須プロパティ」を表示するよう選択できます。各プロパティのデフォルト値と現在の値が表示されます。該当する場合、値を変更するプロパティを選択します。

11. 層に複数のサーバーがある場合は、サーバーごとに別個に構成できます。下部リージョンの右上隅にある「個別サーバーの構成」リンクをクリックします。デプロイメント構成: 個別サーバーの構成ページが表示されます。個別サーバーの構成を変更して「続行」をクリックし、新規サーバー・リクエスト: デプロイメント構成ページに戻ります。

12. このリクエストのスケジュールを指定し、「次へ」をクリックします。

注意:
新規サーバー・リクエストのスケジュールは、セルフ・サービス・ポータルの設定ページでEM_SSA_ADMINが定義しているスケジュールに依存します。第7.1項「セルフ・サービス・ポータルの設定」を参照してください。

13. 確認ページで、「終了」をクリックし、リクエストを発行するか、「デプロイメント・プランとして保存」します。「デプロイメント・プランとして保存」を選択すると、リクエストは、新規リクエストの作成に使用可能な入力を記録するために使用できるデプロイ・プランとして保存されます。

8.3 リクエストの表示

「リクエスト」タブに、SSAユーザーの実行したすべてのリクエストが表示されます。

図8-6 リクエスト

リクエストの名前、ステータス、開始日と終了日、リクエストのタイプ、サーバーの数、合計CPU、メモリーが表示されます。「名前」をクリックして、リクエストの詳細を示すリクエスト詳細ページにドリルダウンします。

次のことができます。

- リクエストの編集: 次のタイプのリクエストを編集できます。

- スケジュール済: 「スケジュール済」のリクエストを選択し、「編集」をクリックしてリクエスト構成の詳細を変更します。サーバーのリクエスト・ウィザードが表示され、必要に応じてリクエスト・サーバー構成を変更できます。詳細は、第8.2項「サーバーのリクエスト」を参照してください。

- 実行済: 正常に実行されたリクエストを選択し、「編集」をクリックします。表示されるウィンドウで、リクエストの新しい終了日を指定し、「編集」をクリックしてリクエストを編集します。

- リクエストの削除: スケジュール済または実行済のリクエストを選択し、「削除」をクリックしてリクエストを削除します。

8.4 サーバーの表示

「サーバー」タブをクリックして、ゾーンに従ってグループ化されたサーバーのリストが表示されます。このページで、セルフ・サービス・ユーザーは、特定のアセンブリおよびテンプレートのデプロイメント、層および各層のサーバーを表示できます。リクエストしたサーバーのリストを参照し、サーバー名またはタグに基づいて検索を実行できます。

図8-7 マイ・サーバー

アセンブリまたは層インスタンスのホームページにドリルダウンするか、サーバー名をクリックしてサーバーの詳細ページにドリルダウンできます。このページから、次の操作を実行できます。

- サーバーのリクエスト: 特定の期間、サーバーをリクエストまたは予約します。詳細は、第8.2項「サーバーのリクエスト」を参照してください。

- アセンブリ: アセンブリ・インスタンスの起動、停止、削除および層の追加ができます。リストからアセンブリ・インスタンスを選択し、「アクション」メニューから適切なオプションを選択します。第8.4.2項「アセンブリの操作」を参照してください。

- 層: 層インスタンスの起動、停止、スケール・アップおよびスケール・ダウンができます。リストから層インスタンスを選択し、「アクション」メニューから適切なオプションを選択します。第8.4.3項「層の操作」を参照してください。

- サーバー: サーバーの構成変更、サーバーの停止、起動または再起動、サーバーのクローニング、VNCコンソールのテンプレートとして保存、一時停止、再開および起動ができます。「サーバーの操作」を参照してください。

8.4.1 ゾーンの詳細ページ

ゾーンの詳細ページには、SSAゾーンのすべてのアセンブリ、層およびサーバーの詳細が表示されます。

図8-8 ゾーンの詳細ページ

このページでは、選択したエンティティに応じて次のオプションを実行できます。

- サーバーのリクエスト

- アセンブリの操作

- 層の操作

- サーバーの操作

層インスタンス、アセンブリ・インスタンスまたはサーバー・リンクをクリックして、「詳細」ページにドリルダウンできます。

8.4.2 アセンブリの操作

アセンブリ・インスタンスに次の操作を実行できます。

- 起動: アセンブリ・インスタンスを選択し、「アクション」メニューから「起動」を選択します。確認メッセージが表示されます。「起動」をクリックすると、「アセンブリのインスタンスの開始」ジョブが発行されます。アセンブリ・インスタンスは、停止している場合にのみ起動できます。

- 停止: アセンブリ・インスタンスを選択し、「アクション」メニューから「停止」を選択します。確認メッセージが表示されます。「停止」をクリックすると、「アセンブリ・インスタンスの終了」ジョブが発行されます。アセンブリ・インスタンスは、起動している場合にのみ停止できます。

- 削除: アセンブリ・インスタンスを選択し、「アクション」メニューから「削除」を選択します。確認メッセージが表示されます。「削除」をクリックすると、「アセンブリ・インスタンスの削除」ジョブが発行されます。

- 層の追加: アセンブリ・インスタンスを選択し、「アクション」メニューから「層の追加」を選択します。

8.4.2.1 アセンブリの詳細ページ

このページには、SSAのアセンブリ・インスタンスの詳細が表示されます。

図8-9 アセンブリの詳細ページ

内容は次のとおりです。

- 一般: このセクションには、アセンブリの名前、所属するゾーン、アセンブリによってデプロイされたサーバーまたはゲストVMの合計数、およびアセンブリの作成日が表示されます。

- メンバー: ここには、アセンブリ内のメンバーの階層ビューが表示されます。リンクをクリックすると、メンバーのホームページにドリルダウンします。

- リクエスト: このセクションには、アセンブリとそのメンバーに対応するすべてのリクエストがリストされます。リクエストのリンクをクリックすると、リクエスト詳細ページにドリルダウンします。

アセンブリ・インスタンスに対して「起動」、「停止」、「削除」、「層の追加」などの操作を実行できます。「アセンブリ」メニューから必要なオプションを選択し、確認ページで「OK」をクリックして選択した操作を実行します。

8.4.3 層の操作

アセンブリ層インスタンスに次の操作を実行できます。

- 起動: 層インスタンスを選択し、「アクション」メニューから「起動」を選択します。確認メッセージが表示されます。「起動」をクリックすると、「層インスタンスの開始」ジョブが発行されます。層インスタンスは、停止している場合にのみ起動できます。

- 停止: 層インスタンスを選択し、「アクション」メニューから「停止」を選択します。確認メッセージが表示されます。「停止」をクリックすると、「層インスタンスの終了」ジョブが発行されます。層インスタンスは、起動している場合にのみ停止できます。

- スケール・アップ: 層インスタンスをスケール・アップするか、それに別のサーバーを追加できます。第8.4.3.1項「層インスタンスのスケール・アップ」を参照してください。

- スケール・ダウン: 層に含まれるサーバーをスケール・ダウンまたは停止できます。第8.4.3.2項「層インスタンスのスケール・ダウン」を参照してください。

8.4.3.1 層インスタンスのスケール・アップ

拡張可能な層では、複数のサーバーを作成できます(上限と下限があります)。層のスケーラビリティは、アセンブリでの層の定義方法によって異なります。詳細は、第9.8.4項「Oracle Virtual Assemblies (OVA)を使用したゲスト仮想マシンのプロビジョニング」を参照してください。層インスタンスをスケール・アップするには、次の手順に従います。

1. EM_SSA_USERロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「マイ・サーバー」タブをクリックしてアセンブリを展開し、そのアセンブリの層をクリックします。

3. 層インスタンス・ホームページで、「層」メニューから「スケール・アップ」オプションをクリックします。

4. スケール・アップ: 一般ページが表示されます。リクエストの名前、アセンブリ、ゾーンおよびインスタンス数が表示されます。「次へ」をクリックして続行します。

5. サーバーの選択ページで、スケール・アップ操作を行うサーバーを選択します。スケール・アップ操作の一環として、層の既存の停止サーバーを起動するか、必要に応じてインスタンス数の上限まで新規サーバーを作成します(またはこれら両方の操作を行います)。
層のインスタンス数の上限が4で、アセンブリのデプロイ中に1つのサーバーのみが作成された場合、3つの新規サーバーによって層をスケール・アップできます。「次へ」をクリックして続行します。

6. 新規サーバーをプロビジョニングする場合、その構成をサーバー構成ページで変更できます。値は、アセンブリのデプロイ中に指定された値が事前に移入されます。必要に応じて詳細を変更し、「次へ」をクリックして操作を継続します。

注意:

- 層が自動スケーラブルの場合、サーバー構成ページは変更できません。

- 「ネットワーク制限」が有効化されている場合(第5.7項「ネットワークの設定」を参照)、バックエンド・ネットワークは変更できません。

7. この操作のスケジュールを指定し、「次へ」をクリックします。

8. 詳細を確認し、「終了」をクリックして層をスケール・アップします。

8.4.3.2 層インスタンスのスケール・ダウン

層に属するサーバーをスケール・ダウンできます。層をスケール・ダウンするには、次の手順に従います。

1. EM_SSA_USERロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「マイ・サーバー」タブをクリックしてアセンブリを展開し、そのアセンブリの層をクリックします。

3. 「層インスタンス」ホームページで、「層」メニューから「スケール・ダウン」オプションをクリックします。

4. スケール・ダウン・ページで、スケール・ダウン操作に含めるサーバーを選択し、「OK」をクリックします。選択されたサーバーが停止し、スケール・ダウンされます。

8.4.3.3 層の詳細ページ

このページには、SSAの層インスタンスの詳細が表示されます。

図8-10

内容は次のとおりです。

- 一般: このセクションには、層の名前、所属するゾーン、デプロイされたサーバーまたはゲストVMの合計数、および層の作成日が表示されます。

- メンバー: ここには、層内のメンバーの階層ビューが表示されます。リンクをクリックすると、メンバーのホームページにドリルダウンします。

- リクエスト: このセクションには、層とそのメンバーに対応するすべてのリクエストがリストされます。リクエストのリンクをクリックすると、リクエスト詳細ページにドリルダウンします。

層インスタンスに対して、「起動」、「停止」、「スケール・アップ」、「スケール・ダウン」などの操作を実行できます。「層」メニューから必要なオプションを選択し、確認ページで「OK」をクリックして選択した操作を実行します。

8.4.4 サーバーの操作

サーバーに次の操作を実行できます。

- 構成の変更: 変更するサーバーを選択し、「アクション」メニューから「構成の変更」を選択します。構成を変更する場合、サーバーのステータスは「停止中」である必要があることに注意してください。

- クローン: クローニングするサーバーを選択し、「アクション」メニューから「クローン」を選択します。参照

- 削除: 「停止中」または「一時停止中」のサーバーを削除できます。削除するサーバーを選択し、「アクション」メニューから「削除」を選択します。確認メッセージが表示されます。「削除」をクリックすると、「サーバーの削除」ジョブが発行されます。

- テンプレートとして保存: 将来使用するために「停止中」または「一時停止中」のサーバーをテンプレートとして保存できます。サーバーを選択し、「アクション」メニューから「テンプレートとして保存」を選択します。「テンプレートとして保存」ページが表示されます。次の詳細を指定できます。

- テンプレート名: テンプレートの一意の名前を入力します。

- リクエスト名: 「テンプレートとして保存」リクエストの名前を入力します。

- キーマップ: サーバーのキーボード・タイプを選択します。

- 構成: このリージョンで、デフォルトおよび最大のメモリーとCPU数を指定できます。

「OK」をクリックするとテンプレートとして保存されます。

- 起動: 「停止中」のサーバーを選択し、「アクション」メニューから「起動」を選択します。確認メッセージが表示されます。「起動」をクリックすると、「サーバーの起動」ジョブが発行されてサーバーが起動します。

- 停止: 起動して実行中のサーバーを選択し、「アクション」メニューから「停止」を選択します。確認メッセージが表示されます。「停止」をクリックすると、「サーバーの停止」ジョブが発行されてサーバーが停止します。

- 再起動: 起動して実行中のサーバーを再起動できます。

- 一時停止: 起動して実行中のサーバーを選択し、「アクション」メニューから「一時停止」を選択します。確認メッセージが表示されます。「一時停止」をクリックすると、「サーバーの中断」ジョブが発行されます。

- 再開: 「一時停止中」のサーバーを選択し、「アクション」メニューから「再開」を選択します。確認メッセージが表示されます。「再開」をクリックすると、「サーバーの再開」ジョブが発行されてサーバーが起動します。

- VNCコンソールの起動: 「アクション」メニューからこのオプションを選択すると、VNCコンソールが起動します。このオプションは、サーバーが起動して実行中の場合にのみ使用できます。

8.4.4.1 サーバー構成の変更

変更するサーバーを選択し、「アクション」メニューから「構成の変更」を選択します。次のページが表示されます。

図8-11 サーバー構成の変更

「サーバー・サイズ」、「キーマップ」、「タグ」、「ネットワーク」、「ストレージ」などの詳細を変更できます。「OK」をクリックして、構成を保存します。

注意:
サーバーが起動して実行中の場合、「最大メモリー」、「最大CPU数」、「ネットワーク」および「ストレージ」は変更できません。これらのパラメータを変更するには、サーバーを停止してから「構成の変更」オプションを選択する必要があります。

8.4.4.2 サーバーのクローニング

サーバーをクローニングして、1つ以上のサーバーを作成できます。サーバーを選択し、「アクション」メニューから「クローン」を選択します。「クローン・サーバー・リクエスト: 一般」ページが表示されます。クローン・リクエストの名前を入力します。クローニングされるソース・サーバーの名前と、クローニングされるサーバーが出現するゾーンが表示されます。「次へ」をクリックして「クローン・サーバー・リクエスト: デプロイメント構成」ページに移動します。このページで、クローニングするサーバーの数と、リソース構成パラメータを指定できます。これらのパラメータは、クローニング対象のすべてのサーバーに適用されます。スケジュールを指定して詳細を確認し、「終了」をクリックして「クローン・サーバー」操作を発行します。

8.4.4.3 サーバーの詳細ページ

サーバーの詳細ページには、サーバーの詳細情報が表示されます。このページから、VNCコンソールの構成変更、クローニング、停止、再起動、一時停止、再開および起動ができます。

このページには、次のセクションが含まれています。

図8-12 サーバーの詳細ページ

- 一般: サーバーのステータス、関連ゾーン、使用可能開始日および有効期限などの情報が表示されます。

- 構成: CPU数、メモリー、記憶域、オペレーティング・システム、およびサーバーにインストールされたその他のソフトウェアなど、サーバーの構成詳細が表示されます。

- 可用性: 過去24時間のサーバーの可用性ステータスが表示されます。

- グラフ: 過去24時間のサーバーのステータスが表示された可用性のグラフ、および、CPU、メモリーおよび記憶域の使用率のグラフを確認できます。

- チャージバック詳細: このセクションには、サーバーのすべてのチャージバックの分割データが表示されます。発生したチャージは、サーバーのリクエスト日付から現在の日付まで計算されます。

8.5 記憶域の表示

「記憶域」タブをクリックして、関連付けられているゲストVMによってグループ化された、すべての記憶域要素を表示します。「記憶域」タブには、EM_SSA_USERの所有するすべてのサーバーが、すべての記憶域リソースとともにツリー形式で表示されます。最上位レベルのノードはユーザーの所有するサーバーを表し、サブノードはそのサーバーに属するストレージ・ディスクを表します。次の操作を実行できます。

- 記憶域のリクエスト: このアクションにより、ユーザーは共有または非共有ストレージ・ディスクをサーバーに追加できます。1つ以上のサーバーを選択し、「記憶域のリクエスト」をクリックします。ディスク名、サイズ、モードを入力します。共有ディスクを追加するには、「共有ディスク」チェック・ボックスを選択します。非共有のストレージ・ディスクを作成すると、それを作成したサーバーでのみ使用可能となります。共有ストレージ・ディスクは、その他のサーバーに割当て可能です。複数のサーバーを選択すると、非共有のストレージ・ディスクのみが作成できます。

- 記憶域の割当て: このアクションにより、ユーザーは、共有ストレージ・ディスクを、EM_SSA_USERの所有するその他の任意のサーバーに割り当てることができます。サーバーを選択し、「記憶域の割当て」をクリックします。使用可能な共有ストレージ・ディスクのリストが表示されます。リストからディスクを選択し、「OK」をクリックして共有ストレージ・ディスクをサーバーに割り当てます。

- 記憶域の解放: サーバーを選択し、「記憶域の解放」をクリックします。このアクションにより、ユーザーは、既存の共有または非共有ストレージ・ディスクを解放できます。

8.6 チャージバックの詳細の表示

「チャージバック」タブをクリックし、チャージバックの詳細を表示します。このタブには、次のセクションがあります。

- チャージ傾向: 日付範囲で、様々なメトリックのチャージが表示されます。日付範囲を設定でき、「実行」をクリックするとチャージが再計算されます。

- 詳細: このセクションには、指定した日付範囲のチャージの詳細が表示されます。「詳細レベル」ドロップダウン・メニューからオプションを選択することで、データの並替えが可能です。「エクスポート」をクリックすると、チャージ・プランの詳細がCSVファイルにエクスポートされます。

- チャージ・プラン: このアクションにより、ユーザーは、ゾーンを選択し、チャージ・プランがそのターゲット・タイプに効果的かどうかを確認できます。

- Oracle VMゲスト(デフォルト): 拡張チャージ・プランを使用する場合は、OracleゲストVMターゲット・タイプの基本プランがここに表示されます。

8.7 ライブラリの表示

「ライブラリ」タブをクリックして、アクセス可能なアセンブリ、テンプレートおよびデプロイ・プランのリストを表示します。次のビューを選択できます。

- パブリック: ロールのSSA管理者が公開したリスト。表示権限を持つ対象のアセンブリ、テンプレートおよびデプロイ・プラン。EM_SSA_ADMINISTRATORによって公開されている場合、または別のEM_SSA_USERによって共有可能になっている場合は、アセンブリ、テンプレートまたはデプロイ・プランが表示されます。

- プライベート: 所有するアセンブリ、テンプレートおよびデプロイ・プランが含まれます。一般的に、SSAユーザーはアセンブリを所有せず、テンプレートおよびデプロイ・プランを所有する場合がほとんどです。

このページからサーバーをリクエストできます。詳細は、第8.2項「サーバーのリクエスト」を参照してください。

ソフトウェアのアップロード、所有するソフトウェア・コンポーネントの共有、削除または共有の停止を行うことができます。リストからコンポーネントを選択し、「共有」をクリックします。エンティティを共有するユーザーを1人以上選択し、「共有」をクリックします。

エンティティを共有解除するには、共有されているエンティティをリストから選択し、「共有を停止」をクリックします。このコンポーネントを共有しているユーザーのリストが表示されます。1つ以上のユーザーをリストから選択し、「共有を停止」をクリックします。

ソフトウェアをアップロードするには、「アップロード」をクリックします。表示されるダイアログ・ボックスで、アップロードされるソース・ファイルを選択し、名前および説明を入力し、アップロードするコンポーネントのタイプ(アセンブリまたはテンプレート)を指定します。「アップロード」をクリックして、ソフトウェアをマイ・ライブラリにアップロードします。

8.8 ポリシーの表示

「ポリシー」タブをクリックして、定義したポリシーのリストを表示します。ポリシーまたはポリシー・グループに基づいて、新規パフォーマンスまたはスケジュールを作成できます。たとえば、CPUの使用率が90を超えることが5回連続して発生した場合に、自動的に層のスケール・アップを開始するポリシーを定義できます。

ポリシーの作成および使用の詳細は、第6.1項「クラウド・ポリシーの管理」を参照してください。

8.9 プリファレンスの表示

「適用」をクリックして、プリファレンスを保存します。ここで指定した値は、インフラストラクチャ・セルフ・サービス・ポータルを使用してリソースをリクエストする際に使用されます。

ページの右上隅にある「プリファレンス」リンクをクリックします。次のウィンドウが表示されます。

図8-13 プリファレンス

SSAを使用してリソースをリクエストする前に、次の詳細を指定してユーザー・プロファイルを設定できます。

- 一般プリファレンス

- 電子メール・アドレス: 通知の受信に使用されるデフォルトの電子メール・アドレス。

- ロケール: クラウド通知を受信するデフォルトのロケール。

- リクエスト通知: リクエストの各種ステータスの通知を受信する場合は、このチェック・ボックスを選択します。

- リクエスト・ステータス: 「リクエスト通知」チェック・ボックスを選択した場合は、通知を受信することを希望するステータスをこのドロップダウン・リストから選択します。

- 最初の通知までの日数/2回目の通知までの日数: 「インスタンス期限切れ通知」チェック・ボックスを選択した場合は、最初または2回目の通知が送信されるまでの日数を指定します。

- 割当ての通知: このチェック・ボックスを選択すると、割当て制限が指定されたしきい値に達したときに通知が送信されます。

- 割当てしきい値(%): 「割当ての通知」チェック・ボックスを選択した場合は、このフィールドで割当て制限のしきい値を指定します。

- セルフ・サービス・ポータル: セルフ・サービス・ポータルにログインしたときに表示されるデフォルトのセルフ・サービス・ポータル・ページを選択します。

9 IaaSクラウドの管理および監視

この章では、IaaSクラウド内のゾーン、仮想サーバー・プール、仮想サーバーおよびゲスト仮想マシンに対して実行する監視および管理タスクについて説明します。この章の内容は次のとおりです。

- インフラストラクチャ・クラウドのホームページの表示

- OVMマネージャ・ホームページの表示

- メンバーの表示および管理

- ゾーンの管理

- 仮想サーバー・プール・ホームページの表示

- 仮想サーバーの管理

- ゲスト仮想マシンの管理

- ゲスト仮想マシンのデプロイ

- インフラストラクチャ・リクエスト・ダッシュボードの表示

9.1 インフラストラクチャ・クラウドのホームページの表示

クラウド・ターゲットは即時利用可能で、Enterprise Manager Cloud Controlによって監視される仮想化インフラストラクチャ全体を表します。インフラストラクチャ・クラウドのホームページからデータ・センター内の様々なターゲットを表示および監視できます。インフラストラクチャ・クラウドのホームページを表示する手順:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。インフラストラクチャ・クラウドのホームページには、ゾーン、プール、仮想サーバーなど様々なターゲット、リクエスト・ステータス、ポリシーなどが表示されます。クラウド・インフラストラクチャの設定のデモを見るには、ビデオ・リンクをクリックします。

図9-1 インフラストラクチャ・クラウド・ホーム

インフラストラクチャ・クラウドのホームページには、次の詳細が表示されます。

- 一般: OVMマネージャ数、ゾーン数、サーバー数、クラウド内のゲスト仮想マシン数、および各ターゲットのステータスを表示します。リンクを選択すると、メンバー・ページにドリルダウンできます。

- ターゲット・フラックス: 過去30日に作成または削除されたターゲット(ゲストVM、Oracle VM Manager、ゾーン、サーバー・プール、仮想サーバー)の数を表示します。

- リクエスト・ステータス: 様々なリクエストおよび予約のステータスを表示します。グラフをクリックすると、リクエスト・ページにドリルダウンします。

- CPUおよびメモリー: データ・センターの仮想サーバーごとのCPUおよびメモリー使用量を表示します。

- ソフトウェア・ライブラリ: ソフトウェア・ライブラリで使用可能なアセンブリおよびテンプレートの数、およびデプロイ回数を表示します。

- ポリシー: クラウドに定義した様々なポリシーのステータスを表示します。実行された修正処理の数およびそれらが成功したかどうかを表示します。グラフをクリックすると、ポリシー・ホームページにドリルダウンできます。

- インシデントと問題の概要: 過去24時間に発生した様々なインシデントおよびポリシー違反を表示します。

- チャージ傾向: クラウド全体のチャージバックの分割データを表示します。コストの大きい上位5リクエストがリストされます。

- インベントリおよび使用状況: 仮想サーバー、ゲスト仮想マシンおよびアセンブリ・インスタンスのインベントリ・サマリーを表示します。「表示」ドロップダウン・リストからオプションを選択すると、詳細を表示できます。異なるディメンションのコンテキストで、サマリー情報を表示できます。たとえば、Oracle VM Serverについて、各Oracle VM Manager、ゾーン、仮想サーバー・プールなどにある仮想サーバー数を表示できます。
棒グラフをクリックすると、複数レベルのインベントリ詳細にドリルダウンできます。「詳細を表示」をクリックすると、選択したターゲットの詳細情報と関連するインベントリ・グラフを示すインベントリと使用状況の詳細ページにドリルダウンできます。

仮想化ターゲットの監視を開始する前に、OVMマネージャのターゲットを登録する必要があります。詳細は、第5.3項「Oracle VM Managerの登録」を参照してください。

9.2 OVMマネージャ・ホームページの表示

OVMマネージャは、ゾーン、仮想サーバー、仮想サーバー・プールおよびゲスト仮想マシンを監視するインタフェースを提供します。ゾーンは、仮想サーバー・プールのセットです。各仮想サーバー・プールには、1つ以上の仮想サーバーとゲスト仮想マシンが含まれています。1つの仮想サーバー・プールが複数のゾーンに属すことはできません。OVMマネージャ・ホームページの表示手順:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルからOVMマネージャのターゲットをクリックします。OVMマネージャ・ホームページには、次の詳細が表示されます。

図9-2 OVMマネージャ・ホーム

- 一般: OVMマネージャの下のゾーン数、サーバー数、ゲスト仮想マシン数、および各ターゲットのステータスを表示します。リンクをクリックすると、メンバー・ページにドリルダウンできます。

- リクエスト・ステータス(%): このOVMマネージャのすべてのリクエストのステータスが表示されます。グラフをクリックすると、すべてのリクエスト・ページにドリルダウンします。

- ジョブ・アクティビティ: 最近7日以内に開始されたジョブのリストを表示します。

- ポリシー: OVMマネージャに定義したすべてのポリシーのステータスを表示します。実行された修正処理の数およびそれらが成功したかどうかを表示します。

- インシデントと問題の概要: OVMマネージャおよびメンバー・ターゲットにレポートされているすべてのインシデントと問題を表示します。

- インベントリおよび使用状況: 仮想サーバー、ゲスト仮想マシンおよびアセンブリ・インスタンスのインベントリ・サマリーを表示します。「表示」ドロップダウン・リストからオプションを選択すると、詳細を表示できます。異なるディメンションのコンテキストで、サマリー情報を表示できます。たとえば、Oracle VM Serverについて、各Oracle VM Manager、ゾーン、仮想サーバー・プールなどにある仮想サーバー数を表示できます。
棒グラフをクリックすると、複数レベルのインベントリ詳細にドリルダウンできます。「詳細を表示」をクリックすると、選択したターゲットの詳細情報と関連するインベントリ・グラフを示すインベントリと使用状況の詳細ページにドリルダウンできます。

- CPUおよびメモリー: OVMマネージャの下の仮想サーバーごとのCPUおよびメモリー使用量を表示します。

- ソフトウェア・ライブラリ: デプロイされているテンプレートおよびアセンブリを表示します。

- チャージ傾向: 上位5位のテナント: OVMマネージャ全体のチャージバック分解データを表示します。コストの大きい上位5リクエストがリストされます。

3. OVMマネージャ・ホームページでは、次を実行できます。

- OVMマネージャの編集

- OVMマネージャの同期化

- OVMマネージャの登録解除

- ゾーンの作成

- 仮想サーバー・プールの作成

- 仮想サーバーの検出

- 未所有の仮想サーバーの管理

- ネットワークの管理

- 記憶域の管理

- 記憶域リポジトリの管理

- YUMリポジトリの管理

- NTP構成の管理

9.3 メンバーの表示および管理

このページで、1つ以上の仮想化ターゲットのメンバーを表示および管理できます。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 「インフラストラクチャ・クラウド」メニューを右クリックして、「メンバー」、「すべて表示」の順に選択します。

3. インフラストラクチャ・クラウドから管理できるOVMマネージャ、ゾーン、仮想サーバー・プール、仮想サーバーおよびゲスト仮想マシンのリストが表示されます。

4. 次のことができます。

1. ターゲットをクリックし、そのホームページまでドリルダウンします。

2. ターゲットを選択し、「アクション」メニューのオプションをクリックします。実行できるアクションは、選択したターゲットによって異なります。

注意:
OVMマネージャ・ターゲットの配下のメンバー、ゾーン、仮想サーバー・プールまたは仮想サーバーを表示および管理できます。インフラストラクチャ・クラウド・ホームページで、左側のパネルから適切なターゲット(OVMマネージャ、ゾーン、仮想サーバー・プール、仮想サーバーなど)を選択します。「インフラストラクチャ・クラウド」メニューから、「メンバー」、「すべて表示」の順に選択します。選択したターゲットのメンバー・ページが表示され、ターゲットに対して様々な管理アクティビティを実行できます。

9.4 ゾーンの管理

この項の内容は次のとおりです。

- ゾーンのホームページの表示

- ゾーンの作成または編集

- ゾーンの削除

9.4.1 ゾーンのホームページの表示

ゾーンは、サーバーやストレージ・エンティティなどのリソースの論理的なグループです。ゾーンは、セルフ・サービス・アプリケーションのユーザーに公開されたゲスト仮想マシンの編成に使用される論理エンティティです。ゾーンには、ゾーンの合計使用量を示すメトリックがあります。ゾーンのホームページの表示手順:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。左のパネルで表示したいゾーンをクリックすると、次の詳細が表示されます。

2. 図9-3 ゾーン・ホーム

- 一般: このゾーン内の仮想サーバー数、仮想サーバー・プール数、ゲスト仮想マシン数、および各ターゲットのステータスを表示します。リンクをクリックすると、メンバー・ページにドリルダウンできます。

- ジョブ・アクティビティ: 最近7日以内に開始されたジョブのリストを表示します。

- インシデントと問題の概要: OVMマネージャおよびメンバー・ターゲットにレポートされているすべてのインシデントと問題を表示します。

- CPUとメモリーの使用率の傾向: 過去30日間のCPUとメモリーの使用率の平均を表示します。

- CPUとメモリー: このゾーン内の仮想サーバーおよびゲスト仮想マシンによるCPUおよびメモリーの使用率を表示します。

9.4.2 ゾーンの作成または編集

ゾーンは、記憶域を共有する仮想サーバー・プールのコレクションです。次の手順を実行して、ゾーンを作成します。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. ゾーンを作成するOVMマネージャのターゲットを選択し、OVMマネージャメニューから、ゾーンの作成をクリックします。

3. ゾーンの作成ページで、ゾーンの名前および説明を指定します。

4. 「インフラストラクチャ・クラウド・セルフ・サービス・ゾーン」チェック・ボックスを選択して、このゾーンがセルフ・サービス・ユーザーによって使用されることを指定します。

5. 「仮想サーバー・プール」セクションで「追加」をクリックし、1つ以上の仮想サーバー・プールを追加します。詳細は、第5.14項「仮想サーバー・プールの作成」を参照してください。

6. 「ゾーンの作成」をクリックして、次に「OK」をクリックします。このジョブが正常に完了すると、「仮想化セントラル」ホームページには、新しく作成されたゾーン内に仮想サーバー・プールが表示されます。

注意:
既存のゾーンを編集するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルからゾーン・ターゲットを選択します。

3. 「ゾーン」メニューから、「ターゲット設定」、「VMゾーンの編集」の順に選択します。

9.4.3 ゾーンの削除

ゾーンを削除する手順:

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでゾーン・ターゲットをクリックして、ゾーン・ホーム・ページに移動します。「ゾーン」メニューから、「ターゲット設定」、「削除」の順に選択します。確認メッセージが表示されます。

3. 「OK」をクリックして、ゾーンを削除します。このゾーンのメンバーである仮想サーバー・プールが、OVMマネージャのターゲットの下に移動されます。

注意:
削除されるゾーン(または、仮想サーバー・プールあるいはゾーン内のゲスト仮想マシン)のチャージバックが有効になっている場合、そのメトリック・データは、ターゲットが削除されるときに自動的に無効化されます。

9.4.4 Enterprise Managerからのゾーンの削除

Enterprise Managerからゾーンを削除するには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでゾーン・ターゲットをクリックして、ゾーン・ホーム・ページに移動します。「ゾーン」メニューから、「ターゲット設定」、Enterprise Managerから削除の順に選択します。確認メッセージが表示されます。

3. 「OK」をクリックして、ゾーンを削除します。ゾーンおよびこのゾーン下の関連ターゲットがEnterprise Managerから削除されます。同期後に、これらのターゲットは再びEnterprise Managerに追加されます。

注意:
削除されるゾーン(または、仮想サーバー・プールあるいはゾーン内のゲスト仮想マシン)のチャージバックが有効になっている場合、そのメトリック・データは、ターゲットが削除されるときに自動的に無効化されます。

9.5 仮想サーバー・プール・ホームページの表示

仮想サーバー・プールは、論理的には1つ以上の仮想サーバーを含む独立したリージョンです。仮想サーバー・プールは、ゾーンに属する場合と属さない場合があります。ただし、一度に属することができるのは1つのゾーンのみです。次の詳細が表示されます。

図9-4 仮想サーバー・プール・ホーム

- 一般: 仮想サーバー・プールが属するゾーン、CPUの数、メモリーおよび記憶域、NICの数などの仮想サーバー・プールの詳細を表示します。

- ジョブ・アクティビティ: 最近7日以内に開始されたジョブのリストを表示します。

- 問題: 仮想サーバー・プールおよびメンバー・ターゲットにレポートされているすべてのインシデントと問題を表示します。

- CPUとメモリーの使用率の傾向: 過去30日間のゾーン内の仮想サーバーごとのCPU使用率およびメモリー使用量の平均が表示されます。

- CPUとメモリーの使用率: これらのグラフは、サーバー・プール内のすべての仮想サーバーによるCPUおよびメモリーの使用率を表示します。

9.6 仮想サーバーの管理

この項の内容は次のとおりです。

- 仮想サーバー・ホーム・ページ

- 仮想サーバーの編集

- 仮想サーバーのアップグレード

- 仮想サーバーの起動および停止

- 仮想サーバーに対するメンテナンスの実行

9.6.1 仮想サーバー・ホームページ

仮想サーバーは、仮想化ソフトウェア(ハイパーバイザ)が実行されている物理マシンを表すために使用される一般用語です。仮想サーバーは、必ず一度に1つの仮想サーバー・プールにのみ属することができます。ゲスト仮想マシンとリソースもサーバー・プールに関連付けられます。

図9-5 仮想サーバーのホーム

次のリージョンが表示されます。

- 一般: 仮想サーバーが属する仮想サーバー・プール、サーバーをアップグレードする必要があるかどうか、メンテナンス中かどうかなどの仮想サーバーの詳細を表示します。

- ジョブ・アクティビティ: 最近7日以内に開始されたジョブのリストを表示します。

- 構成: 有効なCPUコアおよびプロセッサの数、メモリー、ディスク領域、OVSエージェント・ポートなどの仮想サーバー構成。

- ネットワーク・アクティビティ: 仮想サーバーのネットワークおよびディスク・アクティビティ。

注意:
Oracle VM Manager 3.2 4を使用している場合、「ディスク・アクティビティ」はグラフに表示されません。

- CPUとメモリーの使用率: 仮想サーバーのCPUおよびメモリーの使用率。

- インシデント・サマリー: このリージョンには、すべてのゲストVMおよび関連するターゲットについてレポートされているインシデントと問題のリストが表示されます。

9.6.2 仮想サーバーの編集

仮想サーバーを編集するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルで、編集する仮想サーバーを選択します。仮想サーバーのホームページが表示されます。

3. 「仮想サーバー」メニューから、「ターゲット設定」、「VMサーバーの編集」の順に選択します。仮想サーバーの説明および次のフィールドを変更できます。

- IPMIの構成: 「サーバーIPMIの有効化」チェック・ボックスを選択して、Intelligent Platform Management Interface (IPMI)を有効化します。このオプションを選択すると、リモートで仮想サーバーの電源をオフにし、wake on lanメッセージを送信して物理的に電源ボタンを押さずに仮想サーバーの電源をオンにすることができます。このチェック・ボックスが選択されている場合、IPMIのユーザー名、パスワードおよびIPアドレスを入力する必要があります。

- サーバー・ロール: 次のいずれかのロールを指定して、ユーティリティまたは仮想マシン機能を実行するようにサーバーを指定できます。

- ユーティリティ・ロール: このロールを持つサーバーは、クローン、テンプレートのインポート、リポジトリの作成、アセンブリの削除などの仮想マシン以外の操作を実行するために使用されます。

- 仮想マシン・ロール: このロールを持つサーバーは、仮想マシンを実行するために使用されます。仮想サーバーにすでにゲストVMが含まれる場合、このロールの選択を解除することはできません。

4. 「OK」をクリックして、変更を確認します。

9.6.3 仮想サーバーのアップグレード

YUMリポジトリの設定後(第5.17.1項「YUMリポジトリの構成」を参照)、仮想サーバーをアップグレードして最新の更新を適用する必要があります。アップグレードする場合、仮想サーバーはメンテナンス・モードである必要があります。

仮想サーバーをアップグレードするには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでVMサーバーを右クリックして、「アップグレード」を選択します。

3. 仮想サーバーは、アップグレード後に再起動されます。

9.6.4 仮想サーバーの起動および停止

「停止中」状態の仮想サーバーを起動できます。仮想サーバーを起動する手順:

注意:
仮想サーバーを起動する前に、IPMIが構成されていることを確認してください。詳細は、第9.6.2項「仮想サーバーの編集」を参照してください。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルで仮想サーバー・ターゲットを右クリックして、「起動」を選択します。確認メッセージが表示されます。

3. 「OK」をクリックして、仮想サーバーを起動します。

「稼働中」の仮想サーバーを停止できます。仮想サーバーを停止する手順:

1. Enterprise Manager Cloud Controlにログインします。

2. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

3. 左側のパネルで仮想サーバー・ターゲットを右クリックして、「停止」を選択します。確認メッセージが表示されます。

4. 「OK」をクリックして、仮想サーバーを停止します。

9.6.5 仮想サーバーに対するメンテナンスの実行

ハードウェアやソフトウェアのメンテナンスを実行するため、仮想サーバーをメンテナンス・モードにできます。仮想サーバーをメンテナンス・モードにすると、仮想サーバーで実行中の仮想マシンは、サーバー・プール内の他の仮想サーバーが使用可能な場合は、そのサーバーに自動的に移行され、そうでない場合は停止します。仮想サーバーによって遂行されているサーバー・プールの役割もまた、サーバー・プール内の他の仮想サーバーが使用可能であれば移行されます。Oracle VM Serverをメンテナンス・モードにするには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルから仮想サーバーのターゲットを選択します。

3. 左側のパネルで仮想サーバー・ターゲットを右クリックして、「メンテナンスの開始」を選択します。仮想サーバー・ターゲットはメンテナンス中、ブラックアウト・モードになります。

メンテナンスの実行が終了したら、「メンテナンスの停止」をクリックして仮想サーバーをサーバー・プールに再度参加させます。

9.7 ゲスト仮想マシンの管理

この項の内容は次のとおりです。

- ゲスト仮想マシンの作成

- ゲスト仮想マシン・ホームページ

- ゲスト仮想マシンの移行

- ゲスト仮想マシンの起動および停止

- ゲスト仮想マシンのクローニング

- ゲスト仮想マシンの編集

- テンプレートとしてのゲスト仮想マシンの保存

- ゲスト仮想マシンの削除

- Enterprise Managerからのみのゲスト仮想マシンの削除

9.7.1 ゲスト仮想マシンの作成

ゲスト仮想マシンは、仮想サーバー上で実行されます。次のいずれかの方法を使用して、ゲスト仮想マシンを作成できます。

- アセンブリ

- テンプレート

- インストール・メディア(ISOまたはPXE)

ゲストVM作成の詳細は、第9.8章「ゲスト仮想マシンのデプロイ」を参照してください。

ゲスト仮想マシンを作成する前に、次が必要です。

- 仮想サーバーが検出されています。

- 仮想サーバー・プールが作成されています。

- ソフトウェア・ライブラリ内の必要なコンポーネントの作成

- 仮想マシン作成のベースとなるアセンブリ、テンプレート、ISOイメージまたはPXEがデプロイされていること。

9.7.2 ゲスト仮想マシン・ホームページ

ゲスト仮想マシンは、仮想サーバーの最上部で実行されているコンテナです。1つの仮想サーバー上で複数のゲスト仮想マシンを実行できます。次のリージョンが表示されます。

- 一般: 仮想サーバー・プール、ゲスト仮想マシンが属する仮想サーバー、説明などのゲスト仮想マシンの詳細を表示します。

- ネットワーク: ゲスト仮想マシンのネットワーク構成を表示します。

- CPUとメモリーの使用率: ゲスト仮想マシンのCPUおよびメモリーの使用率。

- ネットワークおよびネットワーク・アクティビティ: ゲスト仮想マシン内のネットワークおよびゲスト仮想マシンのネットワーク・スループット。

- 構成: 仮想CPUの数、CPU優先度、割当て記憶域およびメモリー、HAが有効かどうか、ドメイン・タイプなどの仮想サーバー構成。

- ジョブ・アクティビティ: 最近7日以内に開始されたジョブのリストを表示します。

- インシデント・サマリー: 過去31日間に発生した様々なアラートおよびポリシー違反を表示します。

ゲスト仮想マシン・ホームページでは、次を実行できます。

- ゲストVMの編集

- ゲストVMの移行

- ゲストVMのクローニング

- 起動および停止

- 再起動、一時停止および再開

9.7.3 ゲスト仮想マシンの移行

1つ以上のゲスト仮想マシンを移行するには、次の手順を実行します

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 「インフラストラクチャ・クラウド」メニューから、「メンバー」、「すべて表示」の順に選択します。

3. 表示されたターゲットのリストを展開して、リストから1つ以上のゲスト仮想マシンを選択します。「アクション」メニューから、「ゲストVM」、「移行」の順に選択します。移行ページが表示されます。次のいずれかを選択できます。

- 実行中のゲストVM

- 停止された/一時停止されたゲストVM

4. これらのリージョンから1つ以上のゲストVMを選択し、「発行」をクリックします。

注意:
実行中のゲストVMの場合、ゲスト仮想マシンが移行される仮想サーバーは、デフォルトで自動選択されます。停止または一時停止されたゲストVMの場合、必要に応じてターゲット・サーバーを変更できます。

9.7.4 ゲスト仮想マシンの起動および停止

ゲスト仮想マシンが作成された後、これを起動または停止できます。ゲスト仮想マシンが実行されている場合、これを一時的に休止または停止できます。

- ゲスト仮想マシンの起動

- ゲスト仮想マシンの再起動

- ゲスト仮想マシンの停止

9.7.4.1 ゲスト仮想マシンの起動

ゲストVMをしばらく使用しない場合、ゲストVMを停止してシステム・リソースを解放できます。ゲストVMを使用するには、ゲストVMを起動する必要があります。

前提条件

ゲスト仮想マシンは停止している必要があります。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルからゲスト仮想マシンのターゲットを選択します。

3. ゲスト仮想マシン・メニューから「起動」をクリックします。

9.7.4.2 ゲスト仮想マシンの再起動

Microsoft Windowsの更新などのオペレーティング・システムの更新のために仮想マシンの再起動が必要な場合、仮想マシンを再起動する必要がある可能性があります。ゲスト仮想マシンを再起動するには、次の手順に従います。

前提条件

ゲスト仮想マシンは稼働している必要があります。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでゲスト仮想マシン・ターゲットを右クリックして、「再起動」を選択します。

9.7.4.3 ゲスト仮想マシンの停止

使用されていないゲストVMを停止して、システム・リソースを解放しなければならないことがあります。

前提条件

ゲスト仮想マシンは稼働している必要があります。

ゲスト仮想マシンを停止するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでゲスト仮想マシン・ターゲットを右クリックして、「停止」を選択します。

9.7.4.4 ゲスト仮想マシンの強制終了

仮想マシンの強制終了は、仮想マシンの電源オフを実行することに等しく、物理マシンから電源ケーブルを抜くことと似ています。これは推奨される仮想マシン停止方法ではありませんが、「中止」コマンドで仮想マシンを停止できない場合に役立ちます。

ゲスト仮想マシンを制終了するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルでゲスト仮想マシン・ターゲットを右クリックして、「中断」を選択します。

9.7.5 ゲスト仮想マシンのクローニング

前提条件

- 少なくとも1つの仮想マシンが存在し、続行するクローニングに適切な状態である必要があります。

- ゲスト仮想マシンをクローニングして、同じサーバー・プール内に1つ以上の新規仮想マシンを作成できます。

注意:
Enterprise Manager for Oracle Virtualizationプラグイン12.1.0.3 (「自己更新」のリストにはOracle Virtualizationとして表示)以上を使用している場合、関連付けられた仮想ディスクがシン・クローン可能なときは、実行中のゲスト仮想マシンをクローニングできます。

ゲスト仮想マシンをクローニングするには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルからゲスト仮想マシンのターゲットを選択します。

3. ゲスト仮想マシン・メニューから「クローン」をクリックします。

4. ターゲットとソースの選択ページで、「リクエスト名」を指定します。

5. デプロイメント構成ページで、次の項目を修正できます。

- ゲストVM:

- ゲストVMの数: クローニングされるゲスト仮想マシン・インスタンスの数。

- ゲストVMのネーミング: ゲスト仮想マシン名を自動的に生成するか、名前をファイルからアップロードするかを示します。

- ゲストVM名: クローニングされるゲスト仮想マシンの名前を入力します。ゲスト仮想マシンの名前には、特殊文字が含まれていてはなりません。

- 一般:

- 高可用性の有効化/作成後にVMを開始: 停止後にゲスト仮想マシンを自動的に再起動するには、「高可用性の有効化」および「作成後にVMを開始」チェック・ボックスを選択します。

- CPUスケジューリング優先度: 仮想マシンの優先度を設定します。仮想CPUに対して高、中、低またはカスタム優先度を選択できます。

- CPUスケジューリング上限: このパラメータは、仮想CPUが受入れ可能なスケジュール時間のパーセントを定義します。仮想CPUに対するスケジュール時間として高、中、低またはカスタム・パーセントを選択できます。

- 「キーマップ」: クローニングされるゲスト仮想マシンで使用されるキーボード・マッピング。

- タグ: 1つ以上のカンマ区切りのタグを指定します。これらのタグは、仮想マシンの論理的なグループ化に使用され、特定の基準を満たす1つ以上の仮想マシンの検索に使用できます。

- VMサイズ

- VMサイズ: ゲスト仮想マシンに割り当てるメモリーの量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。ゲスト仮想マシンのサイズ(メモリーおよびCPUの値)。

- メモリー: ゲスト仮想マシンに割り当てるメモリーを指定します。実行中のゲスト仮想マシンの場合、この値を最大メモリーまで増やすことができます。

- CPUコア: ゲスト仮想マシンの仮想CPU数を指定します。実行中のゲスト仮想マシンの場合、この値を最大仮想CPUまで増やすことができます。

- ディスク構成: 記憶域タイプを構成して、新しくクローニングされるゲストVMのディスクの場所を指定できます。サーバー・プールで指定された「デフォルト」タイプを使用するか、「オーバーライド」を選択できます。「オーバーライド」を選択する場合は、ストレージQoSを指定し、「記憶域」フィールドの「検索」アイコンをクリックして記憶域タイプを指定する必要があります。記憶域タイプ・ウィンドウで、次の項目を指定します。

- クローン・ターゲット・タイプ: 「リポジトリ」または「ストレージ・アレイ」を指定できます。

- クローン・ターゲット: 「リポジトリ」を選択した場合、ディスクを作成する記憶域の場所を選択します。「ストレージ・アレイ」を選択した場合はタイプを指定します。SANまたはISCSIストレージ・サーバーを指定できます。

- クローン・タイプ: 「スパース・コピー」または「非スパース・コピー」を指定できます。スパース・コピーは、物理ディスクのディスク・イメージ・ファイルであり、指定されたディスク・サイズ全体ではなく、実際に使用されている量の領域のみをとります。非スパース・コピーは、物理ディスクのディスク・イメージ・ファイルであり、空のブロックを含む、指定されたディスク・サイズ全体と同等の領域をとります。

- 記憶域タイプの指定とは別に、クローニングされるゲストVMに新しいディスクを追加することもできます。新しいディスクの追加をクリックして、リポジトリに新しいディスクを作成し、ターゲットのゲストVMに接続します。ディスクのアタッチをクリックして、リポジトリの既存のディスクを指定し、ゲストVMに接続します。

6. 「次へ」をクリックして続行します。

7. スケジュール・ページで、ゲスト仮想マシンを即時クローニングするか後でクローニングするか指定します。次をクリックします。

8. 確認ページで、構成の詳細を確認し、「発行」をクリックしてクローニング・プロシージャを実行します。

9.7.6 ゲスト仮想マシンの編集

注意:

- 稼働中のゲスト仮想マシンを編集する場合、サーバー・サイズ、ストレージおよびネットワークの各フィールドは編集できません。これらの値を編集するには、ゲスト仮想マシンを停止する必要があります。

- Oracle VM Manager 3.1.1およびOracleの仮想化プラグイン12.1.0.2用のEnterprise Managerがインストールされている場合、停止中のゲスト仮想マシンに新しいディスクを作成できます。そうでない場合は、既存のディスクがゲスト仮想マシンにアタッチされます。

ゲスト仮想マシンの構成を変更するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルからゲスト仮想マシンのターゲットを選択します。「ゲストVM」メニューから、「ターゲット設定」、「VMゲストの編集」の順に選択します。ゲストVM構成ページが表示されます。

図9-6 ゲスト仮想マシンの編集: ハードウェア構成

3. ハードウェア構成ページで、次の詳細を変更できます。

- 一般:

- VMサイズ: ゲスト仮想マシンに割り当てるメモリーの量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。ゲスト仮想マシンのサイズ(メモリーおよびCPUの値)。

- メモリー: ゲスト仮想マシンに割り当てるメモリーを指定します。実行中のゲスト仮想マシンの場合、この値を最大メモリーまで増やすことができます。

- CPUコア: ゲスト仮想マシンの仮想CPU数を指定します。実行中のゲスト仮想マシンの場合、この値を最大仮想CPUまで増やすことができます。

- CPUスケジューリング優先度: 仮想マシンの優先度を設定します。仮想CPUに対して高、中、低またはカスタム優先度を選択できます。

- CPUスケジューリング上限: このパラメータは、仮想CPUが受入れ可能なスケジュール時間のパーセントを定義します。仮想CPUに対するスケジュール時間として高、中、低またはカスタム・パーセントを選択できます。

- ネットワーク: 仮想ネットワーク・インタフェースを追加または削除できます。詳細は、第5.7項「ネットワークの設定」を参照してください。

- 記憶域: 仮想ディスクやISOファイルなど、仮想マシンに必要な記憶域構成を選択します。

4. 「その他の構成」タブをクリックします。

図9-7 ゲスト仮想マシンの編集: その他の構成

- 属性: 説明や使用するオペレーティング・システムのタイプなど、ゲスト仮想マシンの基本属性を設定できます。

- 高可用性: 「高可用性」チェック・ボックスが選択されている場合、ゲスト仮想マシンは停止後に自動的に再起動されます。

- ブート順序: ゲスト仮想マシンのブート順序を指定します。これはゲスト仮想マシンのブート順序で、ゲスト仮想マシンがディスク、CDROM、ネットワークのいずれから強制的にブートされるかを示します。

- 拡張:

- 「KeyMap名」: ゲスト仮想マシンで使用されるキーボード・マッピングの名前。

- マウス・タイプ: ゲスト仮想マシンで使用するマウス・タイプ。デフォルト、PS2マウス、USBマウスまたはUSBタブレットを指定できます。

- Domain Type: 仮想マシンのドメイン・タイプ。これには次のものがあります。
Xen HVM: ハードウェア仮想化または完全仮想化。このオプションを選択するときに、(ウィザードの記憶域の作成手順で)仮想マシンの作成元リポジトリにISOファイルを格納する必要があります。

Xen HVM、PVドライバ: Xen HVMと同様ですが、仮想マシンのパフォーマンスを向上させる追加の準仮想化ドライバが含まれます。このドメイン・タイプは、許容可能なパフォーマンス・レベルでのMicrosoft Windowsゲスト・オペレーティング・システムの実行に使用されます。

Xen PVM: 仮想マシンの作成元となる、マウントされたISOファイルの場所を選択できます。準仮想化メソッドを使用して仮想マシンを作成する前に、NFS共有、あるいはHTTPまたはFTPサーバーにISOファイルをマウントします。マウントされたISOファイルの場所を、ウィザードの「Boot Options」手順の「Network Boot Path」フィールドで指定します。

OVM/SPARC: このドメイン・タイプは、サーバー・プールおよびハイパーバイザでOracle VM Server for x86ではなくOracle VM Server for SPARCをハイパーバイザとして使用する場合に選択する必要があります。

不明: ドメイン・タイプが不明の場合はこのハイパーバイザを選択する必要があります。

- VM開始ポリシー: 仮想マシンの開始に使用するポリシーを選択します。次の選択が可能です。
最適なサーバー上で開始: サーバー・プールの最適なサーバーを使用して、仮想マシンを開始します。

現在のサーバー上で開始: 仮想マシンは、作成されたサーバーで開始されます。

- タグ: 1つ以上のカンマ区切りのタグを指定します。これらのタグは、仮想マシンの論理的なグループ化に使用され、特定の基準を満たす1つ以上の仮想マシンの検索に使用できます。

9.7.7 テンプレートとしてのゲスト仮想マシンの保存

ゲスト仮想マシンをテンプレートとして保存して、このテンプレートをゲスト仮想マシンのプロビジョニングに使用できます。

ゲスト仮想マシンをテンプレートとして保存するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルからゲストVMターゲットを選択します。「ゲストVM」メニューから、「ターゲット設定」、ゲストVMをテンプレートとして保存の順に選択します。ゲストVMをテンプレートとして保存: ターゲットとソースの選択ページが表示されます。

3. テンプレートとして保存するゲスト仮想マシン・ターゲットの名前が表示されます。

4. 「ターゲット・リポジトリ」フィールドで、ゲスト仮想マシン・テンプレートを保存するリポジトリを選択します。

5. テンプレートの名前を指定して、「次へ」をクリックします。

6. ゲストVMをテンプレートとして保存: デプロイメント構成ページで、次の詳細を変更できます。

- 一般構成:

- メモリーおよびCPUコア数: 仮想マシンのメモリーおよびCPUコア(仮想CPU)の数を指定します。プロセッサの数は物理CPUコアの数で表され、32に制限されています。選択できるメモリーおよびプロセッサ数は仮想マシン・サーバーのプロパティに制限されています。ただし、仮想マシン・サーバーを選択しない場合は、目的の値を設定できます。「最大仮想CPU」および「最大メモリー」の各フィールドはゲストVMを再起動せずに変更できます。

- CPUスケジューリング優先度: 仮想マシンの優先度を設定します。仮想CPUに対して高、中、低またはカスタム優先度を選択できます。

- CPUスケジューリング上限: このパラメータは、仮想CPUが受入れ可能なスケジュール時間のパーセントを定義します。仮想CPUに対するスケジュール時間として高、中、低またはカスタム・パーセントを選択できます。

- 記憶域: 仮想ディスクやISOファイルなど、仮想マシンに必要な記憶域構成を選択します。

- タグ: 1つ以上のカンマ区切りのタグを指定します。これらのタグは、仮想マシンの論理的なグループ化に使用され、特定の基準を満たす1つ以上の仮想マシンの検索に使用できます。

- ディスク: 記憶域のタイプを指定します。サーバー・プールで指定された「デフォルト」タイプを使用するか、「オーバーライド」を選択できます。「オーバーライド」を選択する場合は、ストレージQoSを指定し、「記憶域」フィールドの「検索」アイコンをクリックして記憶域タイプを指定する必要があります。記憶域タイプ・ウィンドウで、次の項目を指定します。

- クローン・ターゲット・タイプ: 「リポジトリ」または「ストレージ・アレイ」を指定できます。

- クローン・ターゲット: 「リポジトリ」を選択した場合、ディスクを作成する記憶域の場所を選択します。「ストレージ・アレイ」を選択した場合はタイプを指定します。SANまたはISCSIストレージ・サーバーを指定できます。

- クローン・タイプ: 「スパース・コピー」または「非スパース・コピー」を指定できます。スパース・コピーは、物理ディスクのディスク・イメージ・ファイルであり、指定されたディスク・サイズ全体ではなく、実際に使用されている量の領域のみをとります。非スパース・コピーは、物理ディスクのディスク・イメージ・ファイルであり、空のブロックを含む、指定されたディスク・サイズ全体と同等の領域をとります。

9.7.8 ゲスト仮想マシンの削除

ゲスト仮想マシンを削除するには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「クラウド」、「インフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルからゲスト仮想マシンのターゲットをクリックして、ゲストVMホームページに移動します。「ゲストVM」メニューから、「ターゲット設定」、「削除」の順に選択します。確認メッセージが表示されます。

3. 「OK」をクリックして、ゲスト仮想マシンを削除します。ゲスト仮想マシンを削除するには、その前に、ゲスト仮想マシンを停止する必要があります。このオプションは、ゲスト仮想マシンをOracle VM Managerから完全に削除します。

9.7.9 Enterprise Managerからのみのゲスト仮想マシンの削除

ゲスト仮想マシンをEnterprise Managerからのみ削除するには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「クラウド」、「インフラストラクチャ・ホーム」の順に選択します。

2. 左側のパネルからゲスト仮想マシンのターゲットをクリックして、ゲストVMホームページに移動します。「ゲストVM」メニューから、「ターゲット設定」、「Enterprise Managerから削除」の順に選択します。確認メッセージが表示されます。

3. 「OK」をクリックして、ゲスト仮想マシンをEnterprise Managerリポジトリから削除します。このオプションは、ゲスト仮想マシンをOracle VM Managerから削除しません。「同期化」操作を実行することにより、ターゲットをEnterprise Managerリポジトリにリストアできます。第5.4項「Oracle VM Managerターゲットの同期」を参照してください。
ゲスト仮想マシンをEnterprise ManagerリポジトリおよびOracle VM Managerから完全に削除する方法は、第9.7.8項「ゲスト仮想マシンの削除」を参照してください。

9.8 ゲスト仮想マシンのデプロイ

この項では、ゲスト仮想マシンのデプロイに使用される様々なオプションについて説明します。内容は次のとおりです。

- 開始

- デプロイメント・オプション

- 前提条件

- Oracle Virtual Assemblies (OVA)を使用したゲスト仮想マシンのプロビジョニング

- Oracle VMテンプレートを使用したゲスト仮想マシンのプロビジョニング

- ISOイメージを使用したゲスト仮想マシンのプロビジョニング

- PXEブート可能なゲスト仮想マシン

9.8.1 開始

このセクションでは、手始めに仮想化システムのプロビジョニング手順の概要について説明します。このセクションは、仮想化システムのプロビジョニングを成功させるために必要な一連の処理を理解するためのドキュメント・マップと考えてください。各手順の参照リンクをクリックすると、詳細情報が説明されている関連セクションが表示されます。

表9-1 Oracle VMプロビジョニングの概要

手順

説明

参照リンク

手順1

デプロイメント・オプションの理解

仮想化システムのデプロイ用にEnterprise Managerが提供するデプロイメント計画を理解します。

デプロイメント・オプションの詳細は、第9.8.2項「デプロイメント・オプション」を参照してください。

手順2

前提条件の確認

デプロイメント・プロシージャを実行する前に、プロビジョニング環境の設定、必須パッチの適用、ソフトウェア・ライブラリ・コンポーネントの作成などの前提条件を満たす必要があります。

ゲスト仮想マシンをプロビジョニングするための前提条件の詳細は、第9.8.3項「前提条件」を参照してください。

手順3

ユースケースの選択

この項では、ゲスト仮想マシンのプロビジョニングのユースケースのいくつかを説明します。ご自身の要件に最適なユースケースを選択してください。

ゲスト仮想マシンのプロビジョニングには、次のものを使用します。

- アセンブリ: 第9.8.4項「Oracle Virtual Assemblies (OVA)を使用したゲスト仮想マシンのプロビジョニング」を参照してください。

- テンプレート: 第9.8.5項「Oracle VMテンプレートを使用したゲスト仮想マシンのプロビジョニング」を参照してください。

- ISOイメージ: 第9.8.6項「ISOイメージを使用したゲスト仮想マシンのプロビジョニング」を参照してください。

- PXEブート: 第9.8.7項「PXEブート可能なゲスト仮想マシン」を参照してください。

9.8.2 デプロイメント・オプション

Enterprise Managerには、ゲスト仮想マシンのプロビジョニング用に、次のデプロイメント・オプションがあります。

- アセンブリを使用した仮想マシンのプロビジョニング: アセンブリ・コンポーネントを使用して新規ゲスト仮想マシンを作成します。

- テンプレートを使用した仮想マシンのプロビジョニング: テンプレート・コンポーネントを使用して新規ゲスト仮想マシンを作成します。

- ISOを使用した仮想マシンのプロビジョニング: ISOイメージを使用して新規ゲスト仮想マシンを作成します。

- PXEを使用した仮想マシンのプロビジョニング: プリブート実行環境を使用して新規ゲスト仮想マシンを作成します。新規ゲスト仮想マシンは、PXEによりブートされ、ネットワーク経由でプロビジョニングされます。

- 仮想マシンのクローニング: ゲスト仮想マシンを1つ以上のゲスト仮想マシンにクローニングします。

9.8.3 前提条件

デプロイメント・プロシージャを実行する前に、ここで説明しているインフラストラクチャの前提条件を満たしてください。

- Enterprise Managerライフサイクルの管理者ガイドに記載されている必須のインフラストラクチャ前提条件

- Enterprise Managerライフサイクルの管理者ガイドに記載されているオプションのインフラストラクチャ前提条件

- デプロイするアセンブリ、テンプレートまたはISOイメージは、ソフトウェア・ライブラリのコンポーネントとして存在するか、または外部のHTTPまたはNFSにあるか、サーバー・プールの共有場所にインポートされている必要があります。

9.8.3.1 ソフトウェア・ライブラリ内の仮想化コンポーネントの作成および格納

この項では、ソフトウェア・ライブラリの仮想化コンポーネントを作成する手順について説明します。次が含まれています。

- アセンブリ・コンポーネントの作成

- テンプレート・コンポーネントの作成

- ISOコンポーネントの作成

- 仮想ディスクの作成

9.8.3.1.1 アセンブリ・コンポーネントの作成

アセンブリは、仮想マシン・インスタンスの集合です。アセンブリがデプロイされると、仮想マシンのグループまたはアセンブリ・インスタンスが作成されます。

前提条件

- アセンブリ・バイナリ(拡張子.ovaのファイル)は、管理エージェント上または外部のhttp/ftp/nfsの場所に存在する必要があります。

次のプロセスに従って、新規アセンブリ・コンポーネントを作成します。

1. 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」→「ソフトウェア・ライブラリ」を選択します。

2. ソフトウェア・ライブラリ・ページでフォルダを選択します。「アクション」メニューから、「エンティティの作成」、「仮想化」の順に選択します。フォルダを右クリックし、コンテキスト・メニューから仮想化オプションを選択することもできます。

3. エンティティの作成: 仮想化ポップアップ・ウィンドウで、「サブタイプの選択」ドロップダウン・リストから「アセンブリ」を選択します。

4. アセンブリの作成: 説明ページで、次の詳細を入力します。

- アセンブリの名前と説明

- 「添付ファイル」セクションで「追加」をクリックし、そのエンティティに関連するファイルを添付します。ファイル・サイズが2 MB未満であることを確認してください。

- 「ノート」セクションで、エンティティに対して行った変更や、追跡する必要のある変更履歴など、エンティティに関連する情報を追加し、「追加」をクリックします。

5. 「次へ」をクリックして続行します。アセンブリの作成: ファイルのアップロード・ページで、そのアセンブリに関連する1つ以上のファイルを選択します。次のいずれかを実行できます。

- ファイルのアップロード: ソフトウェア・ライブラリの記憶域からアップロードできます。ソフトウェア・ライブラリを使用可能にするには、少なくとも1つのアップロード・ファイルの場所が構成されている必要があります。「ファイルのアップロード」オプションを選択します。「宛先の指定」セクションで、「アップロード場所」フィールドの「参照」ボタンをクリックします。次の2つの記憶域オプションがあります。

- OMS共有ファイル・システム: OMS共有ファイル・システムの場所は、すべてのOracle Management Server(OMS)ホスト間で共有(またはマウント)されている必要があります。このオプションはUNIXシステムに最適です。
OMS環境が1つのみの場合、OMSが実行されているホスト上にも共有場所にもソフトウェア・ライブラリを構成することにより、すべてのOMS環境からソフトウェア・ライブラリにアクセスできるように構成できます。OMS環境が複数ある場合、ソフトウェア・ライブラリを共有場所に構成することにより、NFSマウント・ポイントを通じて環境内のすべてのOracle Management Serverから記憶域にアクセスできるようにすることをお薦めします

- OMSエージェント・ファイル・システム: OMSエージェント・ファイル・システムの場所は、OMSホストのエージェントの1つからアクセスできる場所です。このオプションは、WindowsホストにインストールされたOMSに最適です。ファイルのアップロード用としてこのオプションを選択することにより、参加しているすべてのOMSホスト間で場所を共有しなくてすむようになります。

OMS共有ファイル・システムまたはOMSエージェント・ファイル・システムを使用する前に資格証明を設定する必要があります。OMS共有ファイル・システムの場合、記憶域の場所を構成する前に通常ホスト資格証明を設定する必要があります。しかし、OMSエージェント・ファイル・システムの場所の構成の場合は、資格証明(優先または名前付き)を指定する必要があります。

- ファイルの参照: ソフトウェア・ライブラリのファイルが置かれている外部のファイルの場所を使用する場合は、このオプションを選択します。参照先ファイルの場所は、3つの記憶域オプションをサポートしています。

- HTTP: HTTP記憶域の場所は、参照可能なファイルのソースとして機能するベースURLを表します。たとえば、ベースURL http://my.files.com/scriptsは、http://my.files.com/scripts/perl/installMyDB.plまたはhttp://my.files.com/scripts/linux/stopMyDB.shなどのソース・ファイルのHTTPの場所として構成できます。

- エージェント: 記憶域の場所は、OMSエージェント・ファイル・システムのオプションと似ていますが、管理エージェントによって監視される任意のホストに設定できます。管理エージェントは、このホスト上にあるファイルを処理するよう構成できます。たとえば、Enterprise Managerホストmy.em.file.server上にあるディレクトリ/u01/binariesは、/u01/binaries/rpms/myCustomDB.rpmまたは/u01/binaries/templates/myTemplate.tar.gzなどのソース・ファイルのエージェントの場所として構成できます。

- NFS: NFS記憶域の場所は、サーバー上でエクスポートされたファイルシステム・ディレクトリを表します。サーバーはEnterprise Managerホスト・ターゲットである必要はありません。たとえば、サーバーmy.file.server上でエクスポートされたディレクトリ/exported/scriptsは、ターゲット・ホスト・ファイルシステムでマウントされた後、/exported/scripts/generic/installMyDB.plまたは/exported/scripts/linux/stopMyDB.shなどのソース・ファイルのNFSの場所として構成できます。

これらの場所には、管理エージェントを介してホスト上のベースの場所からファイルにアクセスするために使用される名前付き資格証明を関連付ける必要があります。

- ソースの指定: 他のファイル保存場所を追加できます。

- HTTP URLを介してアクセスできるHTTPの場所を追加するには、「記憶域のタイプ」リストから「HTTP」を選択し、「追加」をクリックします。「HTTPの場所の追加」ダイアログ・ボックスで、参照する記憶域の一意な名前と、HTTPの場所を入力し、「OK」をクリックします。「名前」、「場所」、「ステータス」などの詳細を使用して、記憶域の場所の新しいエントリが作成されます。

- 読取り専用権限が設定された管理エージェントの場所を追加する場合は、「記憶域のタイプ」リストから「エージェント」を選択し、「追加」をクリックします。

6. 次をクリックします。アセンブリ詳細ページで、事前定義済のデプロイメント・プロファイルのセットを表示します。アセンブリの構造およびアセンブリ内のすべてのアプライアンスも表示されます。「次」をクリックします。

7. 確認ページで、「保存」をクリックし、アセンブリ・コンポーネントを保存します。「アップロード」をクリックし、アセンブリ・コンポーネントをソフトウェア・ライブラリへアップロードします。

9.8.3.1.2 テンプレート・コンポーネントの作成

テンプレート・コンポーネントを作成するには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」→「ソフトウェア・ライブラリ」を選択します。

2. ソフトウェア・ライブラリ・ページでフォルダを選択します。「アクション」メニューから、「エンティティの作成」、「仮想化」の順に選択します。フォルダを右クリックし、コンテキスト・メニューから仮想化オプションを選択することもできます。

3. 「サブタイプ」を「テンプレート」として選択します。

4. テンプレートの作成: 説明ページで、テンプレートの名前および説明を入力します。

5. オペレーティング・システム名、タイプおよび仮想化タイプを選択します。仮想化タイプには、「準仮想化」、「ハードウェア仮想化」、またはその両方を選択できます。仮想化が有効になっていないマシンを使用する場合、「準仮想化」を選択します。仮想化が有効になっているマシンを使用する場合、「ハードウェア仮想化」を選択します。

- 準仮想化: 仮想環境を認識するように再コンパイルされたカーネルを使用した仮想マシン。メモリー、ディスクおよびネットワーク・アクセスが最大のパフォーマンスを実現するように最適化されるため、ほぼネイティブの速度で実行されます。

- ハードウェア仮想化: 改変なしのゲスト・オペレーティング・システムを備える仮想マシン。仮想環境用には再コンパイルされません。ハードウェア仮想化ゲストとして実行されているときは、パフォーマンスは大幅に低下する場合があります。実行するMicrosoft Windowsオペレーティング・システムおよび従来のオペレーティング・システムを有効にします。ハードウェア仮想化は、Intel VTまたはAMD SVM CPUでのみ使用可能です。

6. 「次へ」をクリックして続行します。テンプレートの作成: ファイルのアップロード・ページで、そのアセンブリに関連する1つ以上のファイルを選択します。次のことができます。

- ファイルのアップロード: ソフトウェア・ライブラリの記憶域からアップロードできます。ソフトウェア・ライブラリを使用可能にするには、少なくとも1つのアップロード・ファイルの場所が構成されている必要があります。「ファイルのアップロード」オプションを選択します。「宛先の指定」セクションで、「アップロード場所」フィールドの「参照」ボタンをクリックします。次の記憶域オプションがサポートされています。

- OMS共有ファイル・システム: OMS共有ファイル・システムの場所は、すべてのOracle Management Service(OMS)ホスト間で共有(またはマウント)されている必要があります。このオプションはUNIXシステムに最適です。
OMS環境が1つのみの場合、OMSが実行されているホスト上にも共有場所にもソフトウェア・ライブラリを構成することにより、すべてのOMS環境からソフトウェア・ライブラリにアクセスできるように構成できます。OMS環境が複数ある場合、ソフトウェア・ライブラリを共有場所に構成することにより、NFSマウント・ポイントを通じて環境内のすべてのOracle Management Serverから記憶域にアクセスできるようにすることをお薦めします

- OMSエージェント・ファイル・システム: OMSエージェント・ファイル・システムの場所は、OMSホストのエージェントの1つからアクセスできる場所です。このオプションは、WindowsホストにインストールされたOMSに最適です。ファイルのアップロード用としてこのオプションを選択することにより、参加しているすべてのOMSホスト間で場所を共有しなくてすむようになります。

OMS共有ファイル・システムまたはOMSエージェント・ファイル・システムを使用する前に資格証明を設定する必要があります。OMS共有ファイル・システムの場合、記憶域の場所を構成する前に通常ホスト資格証明を設定する必要があります。しかし、OMSエージェント・ファイル・システムの場所の構成の場合は、資格証明(優先または名前付き)を指定する必要があります。

- ファイルの参照: ソフトウェア・ライブラリのファイルが置かれている外部のファイルの場所を使用する場合は、このオプションを選択します。参照先ファイルの場所は、3つの記憶域オプションをサポートしています。

- HTTP: HTTP記憶域の場所は、参照可能なファイルのソースとして機能するベースURLを表します。たとえば、ベースURL http://my.files.com/scriptsは、http://my.files.com/scripts/perl/installMyDB.plまたはhttp://my.files.com/scripts/linux/stopMyDB.shなどのソース・ファイルのHTTPの場所として構成できます。

- エージェント: 記憶域の場所は、OMSエージェント・ファイル・システムのオプションと似ていますが、管理エージェントによって監視される任意のホストに設定できます。管理エージェントは、このホスト上にあるファイルを処理するよう構成できます。たとえば、Enterprise Managerホストmy.em.file.server上にあるディレクトリ/u01/binariesは、/u01/binaries/rpms/myCustomDB.rpmまたは/u01/binaries/templates/myTemplate.tar.gzなどのソース・ファイルのエージェントの場所として構成できます。

- NFS: NFS記憶域の場所は、サーバー上でエクスポートされたファイルシステム・ディレクトリを表します。サーバーはEnterprise Managerホスト・ターゲットである必要はありません。たとえば、サーバーmy.file.server上でエクスポートされたディレクトリ/exported/scriptsは、ターゲット・ホスト・ファイルシステムでマウントされた後、/exported/scripts/generic/installMyDB.plまたは/exported/scripts/linux/stopMyDB.shなどのソース・ファイルのNFSの場所として構成できます。

これらの場所には、管理エージェントを介してホスト上のベースの場所からファイルにアクセスするために使用される名前付き資格証明を関連付ける必要があります。

- ソースの指定: 他のファイル保存場所を追加できます。

- HTTP URLを介してアクセスできるHTTPの場所を追加するには、「記憶域のタイプ」リストから「HTTP」を選択し、「追加」をクリックします。「HTTPの場所の追加」ダイアログ・ボックスで、参照する記憶域の一意な名前と、HTTPの場所を入力し、「OK」をクリックします。「名前」、「場所」、「ステータス」などの詳細を使用して、記憶域の場所の新しいエントリが作成されます。

- 読取り専用の権限のある管理エージェントの場所を追加するには、「記憶域のタイプ」の一覧から「エージェント」を選択して「追加」をクリックし、「エージェントの場所の追加」ダイアログ・ボックスに必要な情報を入力します。

7. 次をクリックします。確認ページでテンプレートの詳細を確認し、「保存」をクリックします。「アップロード」をクリックし、テンプレート・コンポーネントをソフトウェア・ライブラリへアップロードします。これで、テンプレート・コンポーネントがソフトウェア・ライブラリ・ページにエンティティとして表示されます。

9.8.3.1.3 ISOコンポーネントの作成

ISOコンポーネントを作成するには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」→「ソフトウェア・ライブラリ」を選択します。

2. ソフトウェア・ライブラリ・ページでフォルダを選択します。「アクション」メニューから、「エンティティの作成」、「仮想化」の順に選択します。フォルダを右クリックし、コンテキスト・メニューから仮想化オプションを選択することもできます。

3. 「サブタイプ」として「ISO」を選択します。

4. ISOの作成: 説明ページで、デプロイ・プランの名前と説明を入力します。

5. 「次へ」をクリックして続行します。ISOの作成: ファイルのアップロード・ページで、そのアセンブリに関連する1つ以上のファイルを選択します。次のいずれかを実行できます。

- ファイルのアップロード: ソフトウェア・ライブラリの記憶域からアップロードできます。ソフトウェア・ライブラリを使用可能にするには、少なくとも1つのアップロード・ファイルの場所が構成されている必要があります。「ファイルのアップロード」オプションを選択します。「宛先の指定」セクションで、「アップロード場所」フィールドの「参照」ボタンをクリックします。次の記憶域オプションがサポートされています。

- OMS共有ファイル・システム: OMS共有ファイル・システムの場所は、すべてのOracle Management Service (OMS)ホスト間で共有(またはマウント)されている必要があります。このオプションはUNIXシステムに最適です。
OMS環境が1つのみの場合、OMSが実行されているホスト上にも共有場所にもソフトウェア・ライブラリを構成することにより、すべてのOMS環境からソフトウェア・ライブラリにアクセスできるように構成できます。OMS環境が複数ある場合、ソフトウェア・ライブラリを共有場所に構成することにより、NFSマウント・ポイントを通じて環境内のすべてのOracle Management Serverから記憶域にアクセスできるようにすることをお薦めします

- OMSエージェント・ファイル・システム: OMSエージェント・ファイル・システムの場所は、OMSホストのエージェントの1つからアクセスできる場所です。このオプションは、WindowsホストにインストールされたOMSに最適です。ファイルのアップロード用としてこのオプションを選択することにより、参加しているすべてのOMSホスト間で場所を共有しなくてすむようになります。

OMS共有ファイル・システムまたはOMSエージェント・ファイル・システムを使用する前に資格証明を設定する必要があります。OMS共有ファイル・システムの場合、記憶域の場所を構成する前に通常ホスト資格証明を設定する必要があります。しかし、OMSエージェント・ファイル・システムの場所の構成の場合は、資格証明(優先または名前付き)を指定する必要があります。

- ファイルの参照: ソフトウェア・ライブラリのファイルが置かれている外部のファイルの場所を使用する場合は、このオプションを選択します。参照先ファイルの場所は、3つの記憶域オプションをサポートしています。

- HTTP: HTTP記憶域の場所は、参照可能なファイルのソースとして機能するベースURLを表します。たとえば、ベースURL http://my.files.com/scriptsは、http://my.files.com/scripts/perl/installMyDB.plまたはhttp://my.files.com/scripts/linux/stopMyDB.shなどのソース・ファイルのHTTPの場所として構成できます。

- エージェント: 記憶域の場所は、OMSエージェント・ファイル・システムのオプションと似ていますが、管理エージェントによって監視される任意のホストに設定できます。管理エージェントは、このホスト上にあるファイルを処理するよう構成できます。たとえば、Enterprise Managerホストmy.em.file.server上にあるディレクトリ/u01/binariesは、/u01/binaries/rpms/myCustomDB.rpmまたは/u01/binaries/templates/myTemplate.tar.gzなどのソース・ファイルのエージェントの場所として構成できます。

- NFS: NFS記憶域の場所は、サーバー上でエクスポートされたファイルシステム・ディレクトリを表します。サーバーはEnterprise Managerホスト・ターゲットである必要はありません。たとえば、サーバーmy.file.server上でエクスポートされたディレクトリ/exported/scriptsは、ターゲット・ホスト・ファイルシステムでマウントされた後、/exported/scripts/generic/installMyDB.plまたは/exported/scripts/linux/stopMyDB.shなどのソース・ファイルのNFSの場所として構成できます。

これらの場所には、管理エージェントを介してホスト上のベースの場所からファイルにアクセスするために使用される名前付き資格証明を関連付ける必要があります。

- ソースの指定: 他のファイル保存場所を追加できます。

- HTTP URLを介してアクセスできるHTTPの場所を追加するには、「記憶域のタイプ」リストから「HTTP」を選択し、「追加」をクリックします。「HTTPの場所の追加」ダイアログ・ボックスで、参照する記憶域の一意な名前と、HTTPの場所を入力し、「OK」をクリックします。「名前」、「場所」、「ステータス」などの詳細を使用して、記憶域の場所の新しいエントリが作成されます。

- NFSの場所を追加する場合は、「NFS」を選択し、「追加」をクリックします。「NFSの場所の追加」ダイアログ・ボックスで、記憶域の「名前」フィールドに一意の名前を入力します。「NFSサーバー」フィールドに、NFSサービスが実行されているホスト先マシンの完全修飾ドメイン名またはIPアドレスを入力します。「場所」フィールドに、NFSサーバー上の共有場所またはディレクトリ・パスを入力して記憶域の場所を定義し、「OK」をクリックします。「名前」、「場所」、「ステータス」などの詳細を使用して、記憶域の場所の新しいエントリが作成されます。

- 読取り専用権限が設定された管理エージェントの場所を追加する場合は、「記憶域のタイプ」リストから「エージェント」を選択し、「追加」をクリックします。

6. 次をクリックします。確認ページで詳細を確認し、「保存」をクリックします。「アップロード」をクリックし、ISOコンポーネントをソフトウェア・ライブラリへアップロードします。ISOイメージは、ソフトウェア・ライブラリ・ページにエンティティとして表示されるようになります。

9.8.3.1.4 仮想ディスクの作成

仮想ディスク・コンポーネントを作成するには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」→「ソフトウェア・ライブラリ」を選択します。

2. ソフトウェア・ライブラリ・ページでフォルダを選択します。「アクション」メニューから、「エンティティの作成」、「仮想化」の順に選択します。フォルダを右クリックし、コンテキスト・メニューから仮想化オプションを選択することもできます。

3. 「サブタイプ」として「仮想ディスク」を選択します。

4. 仮想ディスクの作成: 説明ページで、デプロイ・プランの名前と説明を入力します。

5. 「次へ」をクリックして続行します。仮想ディスクの作成: ファイルのアップロード・ページで、アセンブリに関連付ける1つ以上のファイルを選択します。次のいずれかを実行できます。

- ファイルのアップロード: ソフトウェア・ライブラリの記憶域からアップロードできます。ソフトウェア・ライブラリを使用可能にするには、少なくとも1つのアップロード・ファイルの場所が構成されている必要があります。「ファイルのアップロード」オプションを選択します。「宛先の指定」セクションで、「アップロード場所」フィールドの「参照」ボタンをクリックします。次の記憶域オプションがサポートされています。

- OMS共有ファイル・システム: OMS共有ファイル・システムの場所は、すべてのOracle Management Server (OMS)ホスト間で共有(またはマウント)されている必要があります。このオプションはUNIXシステムに最適です。
OMS環境が1つのみの場合、OMSが実行されているホスト上にも共有場所にもソフトウェア・ライブラリを構成することにより、すべてのOMS環境からソフトウェア・ライブラリにアクセスできるように構成できます。OMS環境が複数ある場合、ソフトウェア・ライブラリを共有場所に構成することにより、NFSマウント・ポイントを通じて環境内のすべてのOracle Management Serverから記憶域にアクセスできるようにすることをお薦めします

- OMSエージェント・ファイル・システム: OMSエージェント・ファイル・システムの場所は、OMSホストのエージェントの1つからアクセスできる場所です。このオプションは、WindowsホストにインストールされたOMSに最適です。ファイルのアップロード用としてこのオプションを選択することにより、参加しているすべてのOMSホスト間で場所を共有しなくてすむようになります。

OMS共有ファイル・システムまたはOMSエージェント・ファイル・システムを使用する前に資格証明を設定する必要があります。OMS共有ファイル・システムの場合、記憶域の場所を構成する前に通常ホスト資格証明を設定する必要があります。しかし、OMSエージェント・ファイル・システムの場所の構成の場合は、資格証明(優先または名前付き)を指定する必要があります。

- ファイルの参照: ソフトウェア・ライブラリのファイルが置かれている外部のファイルの場所を使用する場合は、このオプションを選択します。参照先ファイルの場所は、3つの記憶域オプションをサポートしています。

- HTTP: HTTP記憶域の場所は、参照可能なファイルのソースとして機能するベースURLを表します。たとえば、ベースURL http://my.files.com/scriptsは、http://my.files.com/scripts/perl/installMyDB.plまたはhttp://my.files.com/scripts/linux/stopMyDB.shなどのソース・ファイルのHTTPの場所として構成できます。

- エージェント: 記憶域の場所は、OMSエージェント・ファイル・システムのオプションと似ていますが、管理エージェントによって監視される任意のホストに設定できます。エージェントは、このホスト上にあるファイルを処理するよう構成できます。たとえば、Enterprise Managerホストmy.em.file.server上にあるディレクトリ/u01/binariesは、/u01/binaries/rpms/myCustomDB.rpmまたは/u01/binaries/templates/myTemplate.tar.gzなどのソース・ファイルのエージェントの場所として構成できます。

- NFS: NFS記憶域の場所は、サーバー上でエクスポートされたファイルシステム・ディレクトリを表します。サーバーはEnterprise Managerホスト・ターゲットである必要はありません。たとえば、サーバーmy.file.server上でエクスポートされたディレクトリ/exported/scriptsは、ターゲット・ホスト・ファイルシステムでマウントされた後、/exported/scripts/generic/installMyDB.plまたは/exported/scripts/linux/stopMyDB.shなどのソース・ファイルのNFSの場所として構成できます。

これらの場所には、管理エージェントを介してホスト上のベースの場所からファイルにアクセスするために使用される名前付き資格証明を関連付ける必要があります。

- ソースの指定: 他のファイル保存場所を追加できます。

- HTTP URLを介してアクセスできるHTTPの場所を追加するには、「記憶域のタイプ」リストから「HTTP」を選択し、「追加」をクリックします。「HTTPの場所の追加」ダイアログ・ボックスで、参照する記憶域の一意な名前と、HTTPの場所を入力し、「OK」をクリックします。「名前」、「場所」、「ステータス」などの詳細を使用して、記憶域の場所の新しいエントリが作成されます。

- 読取り専用権限が設定されたエージェントの場所を追加する場合は、「記憶域のタイプ」リストから「エージェント」を選択し、「追加」をクリックします。

6. 次をクリックします。確認ページで仮想ディスクの詳細を確認し、「保存」をクリックします。「アップロード」をクリックし、仮想ディスク・コンポーネントをソフトウェア・ライブラリへアップロードします。これで、仮想ディスク・コンポーネントがソフトウェア・ライブラリ・ページにエンティティとして表示されます。

9.8.4 Oracle Virtual Assemblies (OVA)を使用したゲスト仮想マシンのプロビジョニング

アセンブリは、複数層アプリケーション・スタックをパッケージ化したもので、デプロイするとアプリケーション・スタックの各層を表す関連する一連の仮想マシンが作成されます。たとえば、SiebelアセンブリにはSiebel中間層とデータベースを含めることができます。2ノードのSiebel中間層用の2つの仮想マシンとデータベースを実行する1つの仮想マシンが作成されるようにデプロイできます。

アセンブリのデプロイメントは、アセンブリ定義に定義されているポリシー/制約に基づきます。仮想マシンの最初の配置は、記憶域、ネットワークおよび計算リソースに基づきます。アセンブリをデプロイすると、適用要求に基づいて、別のインスタンスの追加(スケール・アップ)や削除(スケール・ダウン)が可能になります。アセンブリがデプロイされるとき、アセンブリのインスタンスが生成されます。アセンブリ・インスタンスは依存仮想マシンのコレクションで、アセンブリのデプロイ後に作成されます。アセンブリ・インスタンスの構成は動的な特性があり、後続のスケール・アップやスケール・ダウンの操作によってメンバーシップが変わります。アセンブリ・インスタンスには1つ以上の層が含まれ、各層はさらに仮想マシンや層で構成されます。

次のプロセスに従って、アセンブリをデプロイし、仮想マシンを作成します。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. ゾーン、VMサーバー・プールまたはVMサーバー・ターゲットを右クリックして、「アセンブリのデプロイ」を選択します。

図9-8 アセンブリ・デプロイメント: インスタンスの詳細

3. アセンブリ・デプロイメント: インスタンスの詳細ページで、次を指定します。

- ターゲット: ゲスト仮想マシンをデプロイするサーバー・プールを選択します。

- ソース: 次のいずれかのオプションを選択できます。

- デプロイ・プラン: 「デプロイメント・プランを使用」チェック・ボックスを選択すると、事前定義済の構成でデプロイ・プランを選択できます(使用可能であれば)。デプロイ・プランは、アセンブリのデプロイ時に使用されます(デプロイ・プランが選択されると、イメージが自動的に選択されます)。

- イメージ: このデプロイに使用するアセンブリ・コンポーネント。これは、ソフトウェア・ライブラリまたは外部の場所のいずれかに存在するコンポーネントです。外部の場所に保存されている場合、コンポーネントが保存されているNFSまたたHTTPの場所を指定します。例: http://myvm_server/assemblyまたはfile://myvm_server/assembly。

- 詳細:

- リクエスト名: アセンブリ・デプロイ・リクエストの名前。

- アセンブリのインスタンス名: アセンブリ・インスタンスに割り当てる名前。

- 一部デプロイメントの許可: 一部デプロイメントを有効にするには、このオプションを選択します。デフォルトでは、デプロイ・プランが失敗すると、作成したすべての仮想マシンが自動的に削除されます。しかし、一部デプロイメントが有効になっている場合、デプロイメントに失敗しても仮想マシンは削除されません。

- アセンブリ・コンテンツ: アセンブリ層またはノードがデプロイされないようにすることができます。デフォルトでは、選択したコンポーネントのすべてのノードと層が自動的にデプロイされます。ノードまたは層がデプロイされないようにするには、表で「デプロイ」チェック・ボックスを選択解除します。

注意:

- ovfメタデータ・ファイルでノードまたは層の最小インスタンス数が0に設定されている場合、層またはノードのデプロイメントを無効にできます。

- 層またはノードのデプロイメントが有効になっているデプロイ・プランを使用する場合、そのノードまたは層は無効にできません。

4. 次をクリックします。アセンブリのデプロイ: ネットワークおよびエージェント・ページで、アセンブリ・インスタンスに使用する物理的なパブリック・ネットワークおよびプライベート・ネットワークを指定します。パブリック・ネットワークは外部トラフィックに使用されます。プライベート・ネットワークでは、ゲスト仮想マシンはクラウド管理者が設定した事前定義ネットワーク内でのみ通信できます。
アセンブリ・ネットワークとはOVFメタデータ・ファイルで定義された論理ネットワークで、ここで定義したネットワークはマップ先の実際の物理ネットワークです。ネットワークを明示的に関連付けない場合、マッピングが自動的に割り当てられます。

図9-9 アセンブリ・デプロイメント: ネットワークとエージェント

5. 「ネットワーク」フィールドで、「参照」アイコンをクリックします。ネットワークをシステムに割り当てさせるか、手動で選択するかを指定します。

6. 管理エージェントをアセンブリ層(ゲストVMのコレクション)または選択したゲスト仮想マシンにインストールする場合は、「EMエージェント・プッシュ構成の有効化」チェック・ボックスを選択します。次に、エージェント・プッシュ・アプローチを使用して管理エージェントをインストールする層またはゲスト仮想マシン(あるいはその両方)を、「EMエージェント・プッシュの選択用のアセンブリ・ノードの選択」表で選択します。

- ノード名: 管理エージェントをデプロイするアセンブリ層の名前。

- インストール・タイプ: インストールのタイプで、プッシュ・エージェント・インストール、エージェント・インストールなし、RPMインストールを指定できます。

- エージェント・プッシュの有効化: このチェック・ボックスは、「EMエージェント・プッシュ構成の有効化」チェック・ボックスが選択されている場合のみ有効です。管理エージェントをエージェント・プッシュ・アプローチでインストールする層を選択する場合は、このチェック・ボックスを選択します。
選択した層で、管理エージェントをインストールするゲスト仮想マシンを選択することもできます。

注意:

- プッシュ・エージェント・インストールを選択する場合は、「その他」タブで有効または無効にする必要のあるゲスト仮想マシンを指定できます。

- 管理エージェントを製品として(バイナリ・パッケージの一部として)持つ層では、「エージェント・プッシュの有効化」チェック・ボックスは無効になっており、RPMインストールのみ使用できます。この場合、選択した層の「製品の構成」タブで管理エージェントの詳細を指定できます。

7. 管理エージェントを構成するオプションを指定した後、次の詳細を入力します。

- インストール・ベース・ディレクトリ: これは、管理エージェントのOracleホームが作成されるリモート・ホスト上の親ディレクトリです。

- プラットフォーム: 管理エージェントをインストールするオペレーティング・システムです。

- ユーザー: Oracleインストール・ユーザーの名前がここに表示されます。

- ポート: 管理エージェントで通信に使用されるポート。

- パスワード: 「EMエージェント・プッシュ構成の有効化」チェック・ボックスが選択されている場合、PS5アセンブリではこのフィールドは必須です。

- 権限委任設定: rootとして実行。

- SSHサービス・タイムアウト: SSHのタイムアウト設定。

- 追加パラメータ: 管理エージェントのインストール時に使用される追加パラメータを指定します。このフィールドには、インストール中の前提条件チェックを無視するように-ignoreDirPrereq -enablePtyエントリが事前に移入されています。

8. 「次へ」をクリックして、アセンブリのデプロイ デプロイメント構成ページに移動します。

図9-10 アセンブリ・デプロイメント: デプロイメント構成

次の詳細が表示されます。

- コンポーネント: デプロイするアセンブリ・コンポーネントです。

- ゲストVM: デプロイメント・プロファイルに指定されているゲスト仮想マシンのデフォルトの番号が表示されます。作成するゲスト仮想マシン番号の最小値および最大値を指定します。

- 自動スケーラブル: 層インスタンスをポリシーに基づいて自動スケールできることを示すには、このチェック・ボックスを選択します。

- VMサイズ: ゲスト仮想マシンに割り当てるメモリーの量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。ゲスト仮想マシンのサイズ(メモリーおよびCPUの値)。

- デプロイ・オプション: このアセンブリ・インスタンスのデプロイ。

- ゲストVM名の接頭辞: この文字列は、ゲスト仮想マシン名の接頭辞として使用されます。Enterprise Managerを使用してゲスト仮想マシンを作成する場合、ゲスト仮想マシン名の先頭に、ここで指定した仮想マシン名の接頭辞と番号が追加されます。

9. デフォルトの構成プロパティを表示してカスタマイズするアセンブリ・コンポーネントを選択します。

図9-11 アセンブリ・デプロイメント: デプロイメント構成: 製品の構成

- 製品の構成: このタブには、アセンブリ内の製品のプロパティが表示されます。「すべてのプロパティ」または「必須プロパティ」を表示するよう選択できます。各プロパティのデフォルト値と現在の値が表示されます。該当する場合、値を変更するプロパティを選択します。

- その他: 1つ以上のアンチアフィニティ・グループを作成できます。アンチアフィニティ・グループは、同じサーバー上で実行できない仮想マシンのグループです。「追加」をクリックしてグループ名を入力し、アンチアフィニティ・グループに含めるゲスト仮想マシンを選択します。

10. 表の行をクリックして、構成する層を選択します。アセンブリの各層には構成可能な3つのタブがあります(「ゲストVM構成」、「製品の構成」および「その他」)。

11. 最初のタブ「ゲストVM構成」について説明します。このタブでは、選択したアセンブリ層のすべてのゲスト仮想マシン・インスタンスのリソース構成パラメータを変更できます。

図9-12 層: デプロイメント構成: ゲストVM構成

次のパラメータを構成できます。

- ゲストVM構成:

- 高可用性の有効化: このゲスト仮想マシンで高可用性を有効にする場合は、このチェック・ボックスを選択します。このオプションを有効化すると、仮想サーバーが停止または再起動された場合、ゲスト仮想マシンは、別の仮想サーバーで再起動されるか、または別の仮想サーバーに移行されます。

注意:
高可用性は、仮想サーバー・プールおよびゲスト仮想マシンの両方で有効にする必要があります。両方を有効にしないと、高可用性は無効になります。

- CPUスケジューリング優先度: ゲスト仮想マシンの物理CPUへのアクセスが、同じ仮想サーバー上の他のゲスト仮想マシンと競合した場合の優先度を指定します。優先度が高くなると、ゲスト仮想マシンのCPUサイクルに対する要求の権利が高くなります。

- CPUスケジューリング上限(%): ゲスト仮想マシンにおける物理CPUの使用可能量を制限します。ゲスト仮想マシンのリソースの割当てを制限する場合に、このフィールドを使用します。

- ルート・パスワード: 起動して実行中のゲスト仮想マシンにログインするためのオペレーティング・システムのルート・パスワードを指定します。

- 「キーマップ」: クローニングされるゲスト仮想マシンで使用されるキーボード・マッピング。

- タグ: 仮想マシンの1つ以上のタグを指定します。これらのタグは、仮想マシンの論理的なグループ化に使用され、特定の基準を満たす1つ以上の仮想マシンの検索に使用できます。

- メモリー(MB): ゲスト仮想マシンに割り当てるメモリーの量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。

- CPU: このゲスト仮想マシンに割り当てるCPUコアの数。これは、ゲスト仮想マシンの仮想CPU(VCPU)構成パラメータとして表示されます。

- ディスク: 記憶域のタイプを指定します。サーバー・プールで指定された「デフォルト」タイプを使用するか、「オーバーライド」を選択できます。「オーバーライド」を選択する場合は、ストレージQoSを指定し、「記憶域」フィールドの「検索」アイコンをクリックして記憶域タイプを指定する必要があります。記憶域タイプ・ウィンドウで、次の項目を指定します。
クローン・ターゲット・タイプ: 「リポジトリ」または「ストレージ・アレイ」を指定できます。

クローン・ターゲット: 「リポジトリ」を選択した場合、ディスクを作成する記憶域の場所を選択します。「ストレージ・アレイ」を選択した場合はタイプを指定します。SANまたはISCSIストレージ・サーバーを指定できます。

クローン・タイプ: 「スパース・コピー」または「非スパース・コピー」を指定できます。スパース・コピーは、物理ディスクのディスク・イメージ・ファイルであり、指定されたディスク・サイズ全体ではなく、実際に使用されている量の領域のみをとります。非スパース・コピーは、物理ディスクのディスク・イメージ・ファイルであり、空のブロックを含む、指定されたディスク・サイズ全体と同等の領域をとります。

- ディスク: すべてのゲスト仮想マシンは、最低1つのディスクを使用して作成されます。追加ディスクとそのサイズを指定します。これらのディスクは、ゲスト仮想マシンに追加されます。ゲスト仮想マシンの作成後、そのゲスト仮想マシンにログインし、追加ディスクを再フォーマットしてマウントします。「追加」をクリックし、ストレージ・デバイス(ディスク)を追加します。
ハード・ディスクの名前、そのサイズ、およびQoS優先度クラスを指定します。適切なQoS優先度クラスを設定することで、ディスクI/Oの優先度を有効にできます。優先クラスの範囲は0から7です。優先度クラス0が最も優先度が高く、7が最も低くなります。「共有ディスク」チェック・ボックスを選択し、複数のゲスト仮想マシン間でディスクを共有します。適切なQoS優先度クラスを設定することで、ディスクI/Oの優先度を有効にできます。優先クラスの範囲は0から7です。優先度クラス0は最も高い優先度を表し、7は最も低い優先度を表します。

- NIC: このゲスト仮想マシンのネットワーク・インタフェースを指定します。最小値は1、最大値は8です。「追加」をクリックしてネットワーク・インタフェースを追加し、次の詳細を指定します。
名前: ネットワーク・リソースの名前を入力します。

ネットワーク: 「アセンブリ・ネットワーク」または「バックエンド・ネットワーク」。

ネットワーク・タイプ: 「インターネット・ルーティング可能」、「インターネット・ルーティング不能」または事前定義済のIPアドレスのセットを指定します。

IP割当て: IPアドレスの割当てに使用するプロトコルを選択します。「DHCP」、「ネットワーク・プロファイル」または「なし」を指定できます。

ここで指定した構成パラメータは、選択したノードのすべてのゲスト仮想マシンに適用されます。ゲスト仮想マシン・インスタンスに別の構成を指定する場合は、「ゲストVMのインスタンス」オプションをクリックします。デプロイメント構成: ゲストVMのインスタンス・ページで、「表示」表からゲスト仮想マシン・インスタンスを選択して、そのインスタンスの構成パラメータを指定できます。

12. 次のタブは「製品の構成」です。このタブには、層内の製品のプロパティが表示されます。「すべてのプロパティ」または「必須プロパティ」を表示するよう選択できます。各プロパティのデフォルト値と現在の値が表示されます。該当する場合、値を変更するプロパティを選択します。

図9-13 層デプロイメント構成: 製品の構成

13. 次のタブは「その他」です。

図9-14 層デプロイメント構成: その他

- その他: 次の詳細を指定します。

- ログ・ファイルの場所: ログ・ファイルを格納するディレクトリを指定します。

- タイムアウトの設定: 製品構成とネットワーク構成のタイムアウトの設定を指定します。デフォルト値は60分で、この値はOracle VM Managerターゲットごとに変更できます。タイムアウト値は、アセンブリ・デプロイメントを続行する前に、Enterprise Managerが製品構成またはネットワーク構成の完了を待機する時間を指定します。

2. 層に複数のゲストVMインスタンスがある場合は、ゲストVMインスタンスごとに別個に構成できます。別個に構成する必要のある各ゲストVMインスタンスの層を選択します。下部リージョンの右上隅の「ゲストVMのインスタンス」リンクをクリックします。デプロイメント構成: ゲストVMインスタンスの構成ページが表示されます。「VM名の編集」をクリックしてゲストIMインスタンスの名前を変更し、新しい名前を指定して「OK」をクリックします。ゲストVMの構成を変更して「続行」をクリックし、アセンブリ・デプロイメント: デプロイメント構成ページに戻ります。

3. 次をクリックします。アセンブリ・デプロイメント: スケジュール・ページで、アセンブリ・デプロイメントの開始日と終了日を指定します。開始日はリクエストが発行される日付で、終了日はアセンブリ・デプロイメント・インスタンスがリタイアする日付です。「次」をクリックします。

4. 次をクリックします。アセンブリ・デプロイメント: 確認ページが表示されます。

図9-15 アセンブリ・デプロイメント: 確認

5. 次をクリックします。これまでに入力した詳細を確認します。後から使用できるプランとして保存できます。「プランとして保存」をクリックし、プランの名前および説明を指定します。デプロイメント・プランを保存するフォルダを選択し、「OK」をクリックします。デプロイ・プランはソフトウェア・ライブラリ・コンポーネントとして保存されますが、この手順によって、またはアセンブリのデフォルト・デプロイ・プランを生成するクラウドAPIによってのみ作成できます。

6. 「発行」をクリックしてジョブを発行します。「エンタープライズ」メニューから、「ジョブ」、「アクティビティ」の順に選択して、ジョブ・アクティビティ・ページを表示します。このページには、発行されたジョブの詳細が表示されます。「名前」リンクをクリックして、詳細を表示できます。
デプロイメント・リクエストの詳細を表示するには、「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・リクエスト・ダッシュボード」の順に選択します。詳細は、第9.9項「インフラストラクチャ・リクエスト・ダッシュボードの表示」を参照してください。

注意:
アセンブリのデプロイ時にゲスト仮想マシンで12c Management Agentを自動的にプッシュするように、Enterprise Managerが正しく構成されていることを確認するには、<OMS_ORACLE_HOME>/sysman/prov/agentpush/agentpush.propertiesファイルでagentpushエントリを次のように変更する必要があります。
変更前: oracle.sysman.prov.agentpush.pdpShellOutEnabled=true

変更後: oracle.sysman.prov.agentpush.pdpShellOutEnabled=false

変更を加えた後は、Oracle Management Serviceを再起動する必要があります。

9.8.5 Oracle VMテンプレートを使用したゲスト仮想マシンのプロビジョニング

テンプレートをデプロイすることで、1つ以上の仮想マシンを作成できます。テンプレートのデプロイは、テンプレートの作成時に定義された制約に基づいています。通常、テンプレートには、オペレーティング・システム、基本構成(CPUの数、メモリー、ディスク・サイズ)、およびプレインストールのアプリケーションが含まれます。仮想マシンの最初の配置は、記憶域、ネットワークおよび計算リソースに基づきます。テンプレートをデプロイすると、適用要求に基づいて、別のインスタンスの追加(スケール・アップ)や削除(スケール・ダウン)が可能になります。

注意:
Enterprise Managerは、レガシーOracle VM 2.2スタイルのテンプレートのデプロイメントをサポートしています。このテンプレートは、.tgzファイル形式で使用できます。これらのテンプレートのデプロイ時にゲスト仮想マシンが作成されますが、新しく作成された仮想マシンのVNCコンソールに手動でログインして、ネットワーク構成と製品構成を完了する必要があります。また、Oracle Virtual Assemblies(.ovaファイル形式)とは異なり、Enterprise ManagerはOracle VM 2.2 Templates(.tgzファイル形式)用に管理エージェントを自動的にプッシュしません。

前提条件

- Enterprise Manager Cloud Controlは、クラウド環境を管理するように設定されます。

- テンプレートはゾーンに使用可能で、デプロイするのに十分な権限があります。デプロイが成功するために、ゾーンで使用可能なリソースが十分にあります。

次のプロセスに従って、テンプレートをデプロイします。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 仮想サーバー・プール・ターゲットを右クリックして、「テンプレートのデプロイ」を選択します。

3. 図9-16 テンプレート・デプロイメント - ターゲットとソースの選択

4. ターゲットとソースの選択ページで、次を選択します。

- ゲスト仮想マシンを作成するターゲット・マシンを選択します。

- 「ソース」セクションで、次のオプションのいずれかを選択できます。

- デプロイ・プラン: 「デプロイメント・プランを使用」チェック・ボックスを選択すると、事前定義済の構成でデプロイ・プランを選択できます(使用可能であれば)。この段階でプランを選択することで、あらかじめ保存されているデプロイおよび構成パラメータの値を事前に確認できます。

- テンプレート: このデプロイメントで使用するテンプレート・コンポーネントこれは、ソフトウェア・ライブラリまたは外部の場所のいずれかに存在するコンポーネントです。外部の場所に保存されている場合、コンポーネントが保存されているNFSまたたHTTPの場所を指定します。例: http://myvm_server/templateまたはfile://myvm_server/template

5. 次をクリックします。「テンプレートのデプロイ: インスタンスの詳細」ページが表示されます。

図9-17 テンプレートのデプロイ - インスタンスの詳細

このページには、次のセクションが含まれています。

- ゲストVM

- ゲストVM: ゲスト仮想マシンの数が表示されます。各ゲスト仮想マシン・インスタンスを個別に構成するには、「各ゲストVMインスタンスの構成」をクリックします。

- ゲストVMのネーミング: 次のいずれかのオプションを選択できます。
接頭辞を使用したゲストVM名の生成: この文字列は、ゲスト仮想マシン名の接頭辞として使用されます。Enterprise Managerを使用してゲスト仮想マシンを作成する場合、ゲスト仮想マシン名の先頭に、ここで指定した仮想マシン名の接頭辞と番号が追加されます。

ゲストVM名をファイルからアップロード: このオプションを選択すると、ユーザー定義のゲスト仮想マシン名のファイルを参照してアップロードできます。ゲスト仮想マシンの名前には、特殊文字が含まれていてはなりません。

- 一般構成

- 高可用性の有効化: このゲスト仮想マシンで高可用性を有効にする場合は、このチェック・ボックスを選択します。このオプションを有効化すると、仮想サーバーが停止または再起動された場合、ゲスト仮想マシンは、別の仮想サーバーで再起動されるか、または別の仮想サーバーに移行されます。

注意:
高可用性は、仮想サーバー・プールおよびゲスト仮想マシンの両方で有効にする必要があります。両方を有効にしないと、高可用性は無効になります。

- 作成後にVMを開始: 作成後にゲスト仮想マシンを自動的に起動するかどうかを指定します。

- CPUスケジューリング優先度: ゲスト仮想マシンの物理CPUへのアクセスが、同じ仮想サーバー上の他のゲスト仮想マシンと競合した場合の優先度を指定します。優先度が高くなると、ゲスト仮想マシンのCPUサイクルに対する要求の権利が高くなります。

- CPUスケジューリング上限(%): ゲスト仮想マシンにおける物理CPUの使用可能量を制限します。ゲスト仮想マシンのリソースの割当てを制限する場合に、このフィールドを使用します。

- 「キーマップ」: クローニングされるゲスト仮想マシンで使用されるキーボード・マッピング。

- タグ: 仮想マシンの1つ以上のタグを指定します。これらのタグは、仮想マシンの論理的なグループ化に使用され、特定の基準を満たす1つ以上の仮想マシンの検索に使用できます。

- メモリー(MB): ゲスト仮想マシンに割り当てるメモリーの量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。

- CPUコア: このゲスト仮想マシンに割り当てるCPUコアの数。これは、ゲスト仮想マシンの仮想CPU(VCPU)構成パラメータとして表示されます。

- VMサイズ: ゲスト仮想マシンに割り当てるメモリーの量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。ゲスト仮想マシンのサイズ(メモリーおよびCPUの値)。VMサイズとして、「カスタム」、「中」のいずれを選択します。「カスタム」を選択した場合、メモリー・サイズおよびCPU数を指定します。

- NIC: このゲスト仮想マシンのネットワーク・インタフェースを指定します。最小値は1、最大値は8です。「追加」をクリックしてネットワーク・インタフェースを追加し、次の詳細を指定します。

- 名前: ネットワーク・リソースの名前を入力します。

- ネットワーク・タイプ: 「インターネット・ルーティング可能」、「インターネット・ルーティング不能」または事前定義済のIPアドレスのセットを指定します。

- IP割当て: IPアドレスの割当てに使用するプロトコルを選択します。

- ディスク:
「ディスク」セクションに、使用可能なディスクのリストが表示されます。「追加」をクリックして、追加の記憶域を追加します。ストレージ・デバイスの追加ウィンドウで、ディスクの名前およびそのサイズを入力します。共有ディスクにするかどうかを指定し、ゲスト仮想マシンの物理CPUへのアクセスが、同じ仮想サーバー上の他のゲスト仮想マシンと競合した場合の優先度を指定します。優先度が高くなると、ゲスト仮想マシンのCPUサイクルに対する要求の権利が高くなります。

6. 「次へ」をクリックして、これまでに入力した詳細を確認します。

7. ここまでに入力した詳細を確認します。後から使用できるプランとして保存できます。「プランとして保存」をクリックし、プランの名前および説明を指定します。デプロイメント・プランを保存するフォルダを選択し、「OK」をクリックします。デプロイメント・プロシージャを保存しない場合は、「発行」をクリックして、ジョブを発行します。「エンタープライズ」メニューから、「ジョブ」、「アクティビティ」の順に選択して、ジョブ・アクティビティ・ページを表示します。このページには、発行されたジョブの詳細が表示されます。「名前」リンクをクリックして、詳細を表示できます。
デプロイメント・リクエストの詳細を表示するには、「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・リクエスト・ダッシュボード」の順に選択します。詳細は、第9.9項「インフラストラクチャ・リクエスト・ダッシュボードの表示」を参照してください。

9.8.6 ISOイメージを使用したゲスト仮想マシンのプロビジョニング

ISOイメージは、インストール・メディアからEnterprise Managerにインポートされます。ISOイメージをデプロイすることで、1つ以上の仮想マシンを作成できます。

前提条件

- Enterprise Manager Cloud Controlは、クラウド環境を管理するように設定されます。

- ISOイメージはゾーンに使用可能で、イメージをデプロイするのに十分な権限があります。デプロイが成功するために、ゾーンで使用可能なリソースが十分にあります。

- デプロイするゲスト仮想マシンのドメイン・タイプは、HVM(ハードウェア仮想化)に設定する必要があります。

次のプロセスに従って、ISOイメージをデプロイします。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 仮想サーバー・プール・ターゲットを右クリックして、「ISOのデプロイ」を選択します。

図9-18 ISOのデプロイ: ターゲットとソースの選択

3. ターゲットとソースの選択ページに、ISOイメージをデプロイするサーバー・プール・ターゲットが表示されます。「宛先」セクションで、次のいずれかを選択できます。

- デプロイ・プラン: 「デプロイメント・プランを使用」チェック・ボックスを選択すると、事前定義済の構成でデプロイ・プランを選択できます(使用可能であれば)。この段階でプランを選択することで、あらかじめ保存されているデプロイおよび構成パラメータの値を事前に確認できます。

- ISO: このデプロイメントで使用するISOイメージ。これは、ソフトウェア・ライブラリまたは外部の場所のいずれかに存在するコンポーネントです。外部の場所に保存されている場合、コンポーネントが保存されているNFSまたたHTTPの場所を指定します。例: http://myvm_server/imageまたはfile://myvm_server/image。

4. リクエストの名前を入力し、「次へ」をクリックして続行します。ISOのデプロイ: デプロイメント構成ページが表示されます。

5. このページには、次のセクションが含まれています。

- ゲストVM

- ゲストVM: ゲスト仮想マシンの数が表示されます。各ゲスト仮想マシン・インスタンスを個別に構成するには、「各ゲストVMインスタンスの構成」をクリックします。

- ゲストVMのネーミング: 次のいずれかのオプションを選択できます。
接頭辞を使用したゲストVM名の生成: この文字列は、ゲスト仮想マシン名の接頭辞として使用されます。Enterprise Managerを使用してゲスト仮想マシンを作成する場合、ゲスト仮想マシン名の先頭に、ここで指定した仮想マシン名の接頭辞と番号が追加されます。

ゲストVM名をファイルからアップロード: このオプションを選択すると、ユーザー定義のゲスト仮想マシン名のファイルを参照してアップロードできます。ゲスト仮想マシンの名前には、特殊文字が含まれていてはなりません。

- 一般構成

- 高可用性の有効化: このゲスト仮想マシンで高可用性を有効にする場合は、このチェック・ボックスを選択します。このオプションを有効化すると、仮想サーバーが停止または再起動された場合、ゲスト仮想マシンは、別の仮想サーバーで再起動されるか、または別の仮想サーバーに移行されます。

注意:
高可用性は、仮想サーバー・プールおよびゲスト仮想マシンの両方で有効にする必要があります。両方を有効にしないと、高可用性は無効になります。

- 作成後にVMを開始: 作成後にゲスト仮想マシンを自動的に起動するかどうかを指定します。

- CPUスケジューリング優先度: ゲスト仮想マシンの物理CPUへのアクセスが、同じ仮想サーバー上の他のゲスト仮想マシンと競合した場合の優先度を指定します。優先度が高くなると、ゲスト仮想マシンのCPUサイクルに対する要求の権利が高くなります。

- CPUスケジューリング上限(%): ゲスト仮想マシンにおける物理CPUの使用可能量を制限します。ゲスト仮想マシンのリソースの割当てを制限する場合に、このフィールドを使用します。

- VMサイズ: ゲスト仮想マシンに割り当てるメモリーの量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。ゲスト仮想マシンのサイズ(メモリーおよびCPUの値)。VMサイズとして、「カスタム」、「中」のいずれを選択します。「カスタム」を選択した場合、メモリー・サイズおよびCPU数を指定します。

- NIC: このゲスト仮想マシンのネットワーク・インタフェースを指定します。最小値は1、最大値は8です。「追加」をクリックしてネットワーク・インタフェースを追加し、次の詳細を指定します。

- 名前: ネットワーク・リソースの名前を入力します。

- ネットワーク・タイプ: 「インターネット・ルーティング可能」、「インターネット・ルーティング不能」または事前定義済のIPアドレスのセットを指定します。

- IP割当て: IPアドレスの割当てに使用するプロトコルを選択します。

- ディスク:
「ディスク」セクションに、使用可能なディスクのリストが表示されます。「追加」をクリックして、追加の記憶域を追加します。ストレージ・デバイスの追加ウィンドウで、ディスクの名前およびそのサイズを入力します。共有ディスクにするかどうかを指定し、ゲスト仮想マシンの物理CPUへのアクセスが、同じ仮想サーバー上の他のゲスト仮想マシンと競合した場合の優先度を指定します。優先度が高くなると、ゲスト仮想マシンのCPUサイクルに対する要求の権利が高くなります。

6. 次をクリックします。スケジュール・ページで、いつISOイメージをデプロイするかを指定し、「次へ」をクリックします。

7. ここまでに入力した詳細を確認します。後から使用できるプランとして保存できます。「プランとして保存」をクリックし、プランの名前および説明を指定します。デプロイメント・プランを保存するフォルダを選択し、「OK」をクリックします。デプロイメント・プロシージャを保存しない場合は、「発行」をクリックし、プランを発行してプロセスを完了します。

9.8.7 PXEブート可能なゲスト仮想マシンの作成

プロビジョニングの主要な要求の1つが、ディスクやCD-ROMにかわるネットワークを介してのハードウェア・サーバーのブート機能です。コンピュータがネットワークを介して起動する方法はいくつかあり、Preboot Execution Environment (PXE)はその1つです。PXEは、多くのハードウェアおよびソフトウェアのベンダーによってサポートされているオープン業界標準です。PXEの仕様の詳細は、http://www.pix.net/software/pxeboot/archive/pxespec.pdfを参照してください。

最小限の構成情報を有するネットワーク起動可能(PXEブート)な仮想マシンを作成してから、後でネットワークを介してPreboot Execution Environment (PXE)から仮想マシンを起動して、ゲストのオペレーティング・システムをインストールできます。

前提条件

- Enterprise Manager Cloud Controlは、クラウド環境を管理するように設定されます。

- デプロイの成功に必要な使用可能リソースが、ゾーンに十分にあります。

次のプロセスに従って、ISOイメージをデプロイします。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・ホーム」の順に選択します。

2. 仮想サーバー・プール・ターゲットを選択します。「仮想サーバー・プール」メニューから、「PXEのデプロイ」を選択します。

3. ターゲットとソースの選択ページで、次を選択します。

- ゲスト仮想マシンをデプロイするターゲット・マシンを選択します。

- PXEブート可能ゲスト仮想マシンの作成時に使用するデプロイ・プランを選択します。デプロイ・プランには、事前構成済の値と構成パラメータが含まれています。これはオプションのフィールドです。

4. 次をクリックします。一般構成ページで、次の詳細を入力します。

- デプロイするゲスト仮想マシンの名前。複数のゲスト仮想マシンをデプロイしている場合、接頭辞を使用するか、ユーザー定義のゲスト仮想マシン名のファイルをアップロードできます。

- デプロイするゲスト仮想マシンの数。各ゲスト仮想マシン・インスタンスを個別に構成するには、「各ゲストVMインスタンスの構成」をクリックします。

- VMサイズとして、「カスタム」、「中」のいずれを選択します。「カスタム」を選択した場合、メモリー・サイズおよびCPU数を指定します。

- ゲスト仮想マシンの物理CPUへのアクセスが、同じ仮想サーバー上の他のゲスト仮想マシンと競合した場合の優先度を指定します。優先度が高くなると、ゲスト仮想マシンのCPUサイクルに対する要求の権利が高くなります。

- 容量を指定して、ゲスト仮想マシンが使用できる物理CPUの量を制限します。

- CPUコア: このゲスト仮想マシンに割り当てるCPUコアの数。これは、ゲスト仮想マシンの仮想CPU(VCPU)構成パラメータとして表示されます。

- キーマップ: ゲスト仮想マシンで使用するキーボード・マッピング。

- メモリー(MB単位): ゲスト仮想マシンに割り当てるメモリー量。仮想サーバーは、ゲスト仮想マシンの実行に十分なメモリーを搭載している必要があります。メモリーが不十分の場合、ゲスト仮想マシンは作成されますが、起動しません。

- CPUコア: このゲスト仮想マシンに割り当てるCPUコアの数。これは、ゲスト仮想マシンの仮想CPU(VCPU)構成パラメータとして表示されます。

- 「NIC構成」セクションで、ゲスト仮想マシンの仮想ネットワーク・インタフェース数を指定できます。最小値が1で、最大値が8です。1つ以上のネットワーク・インタフェースを追加するか、既存のネットワーク・インタフェースを編集できます。

- Enterprise Manager Cloud Controlでは、新規作成されたゲスト仮想マシンにVNCコンソールが提供されます。これは、VNCコンソールにアクセスするためのVNCパスワードです。

- 仮想マシンのドメイン・タイプを選択します。

- xen_hvm(ハードウェアの仮想化、つまり完全な仮想化): 仮想マシンの作成元となる、ISOファイルを選択できます。

- xen_pvm(準仮想化): 仮想マシンの作成元となる、マウントされたISOファイルの場所を選択できます。準仮想化メソッドを使用して仮想マシンを作成する前に、NFS共有、あるいはHTTPまたはFTPサーバーにISOファイルをマウントします。ISOファイルは、関連するリポジトリで使用可能である必要があります。

- xen_hvm_pv_drivers: xen_hvmと同様ですが、仮想マシンのパフォーマンスを向上させる追加の準仮想化ドライバが含まれます。このドメイン・タイプは、許容可能なパフォーマンス・レベルでのWindowsゲスト・オペレーティング・システムの実行に使用されます。

- 前の仮想サーバーが停止した場合にゲスト仮想マシンを別の仮想サーバーで自動的に実行する場合は、「高可用性の有効化」を選択します。

- マシンの作成後、そのマシンを自動的に起動するには、「作成後にVMを開始」チェック・ボックスを選択します。

- 「ディスク」セクションに、使用可能なディスクのリストが表示されます。「追加」をクリックして、追加の記憶域を追加します。

5. 次をクリックします。スケジュール・ページで、いつPXEブート可能ゲスト仮想マシンを作成するかを指定し、「次へ」をクリックします。

6. ここまでに入力した詳細を確認し、「発行」をクリックし、PXEブート可能ゲスト仮想マシンを作成します。

9.9 インフラストラクチャ・リクエスト・ダッシュボードの表示

SSA管理者は、リクエスト・ダッシュボードを使用して、リクエストおよび予約のステータスを追跡できます。SSA管理者は、すべてのユーザーのすべてのゾーン全体のリクエストを表示できます。SSAユーザーが表示できるリクエストは、ゾーンおよびインスタンス・レベルの権限によって異なります。

前提条件

- Enterprise Manager Cloud Controlは、クラウド環境を管理するように設定されます。

- 適切なセルフ・サービス・ユーザーが、LDAPディレクトリに定義されている必要があります。

- リソースのリクエストおよび予約が発行されている必要があります。

インフラストラクチャ・リクエスト・ダッシュボードを表示するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、Oracle VMインフラストラクチャ・リクエスト・ダッシュボードの順に選択します。インフラストラクチャ・クラウド・リクエスト・ダッシュボードが表示されます。

図9-19 インフラストラクチャ・リクエスト・ダッシュボード

2. 次のグラフが表示されます。

- 最新10個の失敗したリクエスト/最新10個の保留中リクエスト

- 最も古い10個の実行中リクエスト

- リクエスト・サマリー - 「失敗」、「成功」および「一部成功」のリクエスト

- 平均リクエスト待機時間(ゾーン)

- 平均リクエスト待機時間(アセンブリ)/平均リクエスト待機時間(テンプレート)

- 平均リクエスト処理時間(ゾーン)

- 平均リクエスト処理時間(アセンブリ)/平均リクエスト処理時間(テンプレート)

3. 「すべてのリクエストの表示」リンクをクリックし、すべてのクラウド・リクエスト・ページに移動します。

4. このページで、次のいずれかを検索できます。

- リクエスト名: リクエストの名前。

- リクエスト・タイプ: 表示するリクエストのタイプ。これには、アセンブリのデプロイ、テンプレートのデプロイ、ISOのデプロイ、PXEのデプロイ、ゲストVMのクローニング、ゲストVMの更新などがあります。

- アプリケーションのリクエスト: リクエストを行うアプリケーション。このダッシュボードからはセルフ・サービス・リクエストのみを表示できます。

- ステータス: リクエストのステータス(成功、取消済、スケジュール済、エラー終了など)。

5. 選択するリクエスト・タイプごとに、リクエスト名、リクエスト・タイプ、作成者、ステータス、開始日、終了日、メモリー、CPU、VMなどを表示できます。リクエストを選択して「削除」をクリックし、リクエストを削除することもできます。

6. 「リクエスト名」リンクをクリックし、リクエスト詳細ページにドリルダウンします。

9.9.1 リクエスト詳細の表示

リクエスト詳細ページには、選択したリクエストの詳細が表示されます。リクエストの名前、タイプ、リクエストに関連付けられたOVMマネージャ、ステータス、リクエストが作成された日付などが表示されます。

- 一般: このセクションには、リクエストの名前、リクエスト・タイプ、ターゲット名およびその他の詳細が表示されます。

- デプロイ: このセクションには、デプロイされているリクエストおよびターゲットの名前が表示されます。リクエスト・リンクをクリックすると、ジョブ詳細ページにドリルダウンできます。ターゲット・リンクをクリックすると、そのターゲットのホームページにドリルダウンできます。

9.9.2 アセンブリ・ページまたは層インスタンス・ページの表示

アセンブリまたは層インスタンスのホームページを表示するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「クラウド」、「Oracle VMインフラストラクチャ・リクエスト・ダッシュボード」の順に選択します。

2. インフラストラクチャ・リクエスト・ダッシュボード・ページが表示されます。「リクエスト」表で、「すべてのリクエスト」リンクをクリックします。

3. すべてのリクエスト・ページで、表のアセンブリ・デプロイメント・リクエスト名をクリックします。アセンブリ・デプロイメント・ページが表示されます。「デプロイメント」タブをクリックします。デプロイされたアセンブリ・インスタンスが表示されます。

4. 「アセンブリのインスタンス」リンクをクリックします。次のページが表示されます。

図9-20 アセンブリのインスタンス

- 一般: このセクションには、アセンブリの名前、デプロイ先のターゲット、ゲストVMの合計数、アセンブリの作成日、およびこのアセンブリ・インスタンスの所有者が表示されます。

- ステータス: 過去24時間で最も影響を受けたメンバーのステータスが表示されます。名前のリンクをクリックすると、ターゲットのホームページにドリルダウンします。

- 問題の概要: 過去24時間に発生した様々なインシデントおよびポリシー違反を表示します。

- アフィニティ関係: ここには、アセンブリまたは層に対して定義されているルールが表示されます。たとえば、2つのゲストVMを同じサーバーまたはサーバー・プールのいずれかに併存させることを指定するルールや、2つのゲストVMを必ず同じサーバーに存在させるルールなどを定義できます。

- メンバー: このインスタンスのメンバー、そのステータスおよびインストール済のソフトウェアが表示されます。

- リクエスト: デプロイ中に指定されたリクエストの名前。リンクをクリックして、デプロイメント・ページに移動します。

第IV部

直接監視

ここでは、Xenベースのハイパーバイザとそれに関連する仮想ターゲットを検出および監視する方法について説明します。

内容は次のとおりです。

- 第10章「Xenベース・システムの直接監視」

10 Xenベース・システムの直接監視

この章では、Xenベース・システムを検出および監視する手順について説明します。内容は次のとおりです。

- 直接監視の概要

- ハイパーバイザ・ターゲットの検出

- 「Oracle Server」ホームページの表示

- 「Oracle Virtual Platform」ホームページの表示

- Oracle VMインスタンス・ホームページの表示

10.1 直接監視の概要

Xenベースのハイパーバイザ、ベアメタル・マシン、オペレーティング・システム、および監視ソフトウェアに依存しない仮想マシンを直接監視できます。これらのターゲットの監視には、次のものが含まれます。

- Xen 4.1.2以上に基づくOracle Virtual Server (ハイパーバイザ上で稼働するゲストOSまたはDomU)ターゲットの直接監視

- Oracle Server (物理サーバー)の直接監視

- Oracle Virtual Server (Xenベースのハイパーバイザ)の直接監視

- Oracle Virtual Platformまたはハイパーバイザ・マシンのホスト・オペレーティング・システムの直接監視

注意:
Xenベースのハイパーバイザの直接監視を有効化するには、Oracle Virtual Infrastructure 12.1.0.2プラグインがManagement Serverにデプロイされている必要があります。このプラグインは、ハイパーバイザが登録されると管理エージェント上に自動的にデプロイされます。

次の図に、アーキテクチャの概要を示します。

図10-1 直接監視のアーキテクチャ

10.2 ハイパーバイザ・ターゲットの検出

前提条件:

- ハイパーバイザ・ターゲットを検出するには、管理者が次の権限を持っている必要があります。

- 任意のターゲットの追加

- ジョブの作成

- ハイパーバイザ・ターゲットを監視する管理エージェントに対するオペレータ権限

ハイパーバイザを検出するには、次の手順に従います。

1. 前述の権限を持つユーザーとしてEnterprise Managerにログインします。

2. 「設定」メニューから、「ターゲットの追加」、「ターゲットの手動追加」の順にクリックします。

3. ターゲットの手動追加ページで、「ガイド付きプロセスを使用してターゲットを追加(関連ターゲットも追加)」を選択して、「ターゲット・タイプ」ドロップ・ダウン・リストから「Oracle Virtual Platform」を選択します。

4. 「ガイド付きプロセスを使用した追加」をクリックします。Oracle Virtual Platformの検出ページが表示されます。

図10-2 仮想プラットフォームの検出

5. 「デフォルトの監視エージェントおよび資格証明」リージョンで、次の詳細を入力します。

注意:
このリージョンに指定された資格証明は、デフォルトで、このプロセスを通じて検出されたすべてのOracle Virtual Platformターゲットに適用されます。これらの資格証明は、特定のOracle Virtual Platformターゲットについてオーバーライドできます。

- モニタリング・エージェント: 検索アイコンをクリックし、ターゲットを監視するデフォルトのモニタリング・エージェントを選択します。

- フェイルオーバー・モニタリング・エージェント: 検索アイコンをクリックし、ターゲットを監視するフェイルオーバー・モニタリング・エージェントを選択します。

注意:
大規模環境でハイパーバイザとそれに関連するターゲットの監視をスムーズに行うには、Javaヒープ・サイズについて次の推奨事項に従う必要があります。

- ターゲットの合計数(Oracle Virtual Platform、Oracle ServerおよびOracle Virtual Serverターゲットを含む)が300個以下の場合、管理エージェントのJavaヒープ・サイズを128MBに設定する必要があります。

- さらに300個のターゲットを追加するたびに、Javaヒープ・サイズを128MBずつ増加する必要があります。

- 特権ユーザー: このフィールドは、特定の特権コマンドに対するアクセス権をユーザーに付与する場合に使用します。このアクセス権は、rootユーザーによって、またはここで指定する権限委任オプションを通じて使用できます。

- はい: 「はい」を選択する場合、ルート・アクセス権が必要とされる次のxl / xmコマンドを実行できるユーザーである必要があります。
/usr/sbin/xl list*,/usr/sbin/xl info*,/usr/sbin/xl network-list*,

/usr/sbin/xl uptime*,/usr/sbin/xl vcpu-list*,/usr/sbin/dmidecode,

/usr/sbin/xentop,/usr/bin/xenstore-read,/usr/bin/xenstore-list,

/usr/bin/xenstore-ls,/sbin/ethtool

これらのコマンドによって、実行時に仮想化メトリックを収集できます。xlコマンドがシステムに存在しない場合、次のコマンドが使用されます。

/usr/sbin/xm list*,/usr/sbin/xm info*,/usr/sbin/xm network-list*,

/usr/sbin/xm uptime*,/usr/sbin/xm vcpu-list*,/usr/sbin/dmidecode,

/usr/sbin/xentop,/usr/bin/xenstore-read,/usr/bin/xenstore-list,

/usr/bin/xenstore-ls,/sbin/ethtoo

- いいえ: 「いいえ」を選択すると、xl/xmコマンドは実行できず、Oracle Virtual Platformターゲットの仮想化および構成メトリックは収集されません。

- 資格証明タイプ: 検出するターゲットの資格証明を指定します。「ホスト資格証明」または「SSHキー資格証明」を選択できます。選択内容に応じて、第10.2.2項「資格証明プロパティの設定」の説明に従って、資格証明プロパティを入力する必要があります。

6. 「ホスト名とIPアドレス」リージョンで「追加」をクリックします。「ホスト/IPアドレスの追加」ウィンドウで、1つ以上のホスト名、IPアドレスまたはIPアドレス範囲を入力し、「追加」をクリックします。複数のホスト名、IPアドレスまたは範囲は、改行で区切る必要があります。追加したホスト名がOracle Virtual Platformの検出ページに表示されます。

7. デフォルト・エージェントおよび資格証明を使用するか、「オーバーライド」をクリックしてそれらをオーバーライドするかを選択できます。フェイルオーバー・モニタリング・エージェントの資格証明もオーバーライドできます。監視エージェントと資格証明のオーバーライド・ウィンドウで、監視エージェントおよび資格証明プロパティを入力し、「オーバーライド」をクリックします。これにより監視資格証明がオーバーライドされ、指定した新しいエージェントおよび資格証明が適用されます。

8. オプションで、グローバル・ターゲット・プロパティも指定できます。Enterprise Managerのターゲット・プロパティでは、連絡先や場所などの説明的なターゲット情報を格納することが可能で、さらにそれらを動的/管理グループの定義、レポート、インシデント・ルールおよび通知に使用できます。グローバル・ターゲット資格証明リージョンでは、このプロセスを使用して検出されたすべてのターゲットに適用されるターゲット・プロパティの値を指定できます。

9. 「発行」をクリックします。登録情報が検証され、ジョブが発行されます。ジョブの完了時に、Xenベースのハイパーバイザを実行しているホストで次のターゲットが検出されます。

- Oracle Server: ハイパーバイザを実行しているベアメタル・ボックス。

- Oracle Virtual Platform: ハイパーバイザ・プロセスを表すホスト・オペレーティング・システム。

- Oracle Virtual Server: ハイパーバイザ・ドメインによって管理される仮想マシン。

注意:
グループ内のこれらのターゲットの監視を容易にするため、ターゲットの登録中に、または既存の登録済ターゲットを編集し、グローバル・ターゲット・プロパティを指定して動的グループを作成できます。
たとえば、本番ライフサイクル・ステータスを持つ動的グループに、すべての本番仮想プラットフォームを含めることができます。

10.2.1 ターゲットの削除

検出されたターゲットを削除するには、最初にOracle Virtual Platformターゲットを削除する必要があります。このターゲットを削除すると、関連するすべてのOracle Virtual ServerおよびOracle Serverターゲットが削除されます。

ターゲットを削除するには、次の手順に従います。

1. 「ターゲット」メニューから「すべてのターゲット」を選択し、「すべてのターゲット」ページに移動します。

2. 「すべてのターゲット」ページの左側のパネルで、「サーバー」、「記憶域」および「ネットワーク」ターゲット・タイプの下で「Oracle Virtual Platform」を選択します。使用可能なOracle Virtual Platformターゲットのリストが表示されます。

3. いずれかのターゲットをクリックして、「Oracle Virtual Platform」ホームページに移動します。「Oracle Virtual Platform」メニューから「ターゲット設定」、「ターゲットの削除」の順に選択します。確認メッセージが表示されます。「はい」をクリックしてOracle Virtual Platformターゲットとその関連ターゲットを削除します。

10.2.2 資格証明プロパティの設定

検出する仮想プラットフォーム・ターゲットの資格証明を指定できます。資格証明タイプとして「ホスト資格証明」または「SSHキー資格証明」を選択できます。これらの各資格証明は、SudoまたはPowerBrokerの権限委任オプションを使用して統合できます。

図10-3 Oracle Virtual Platformの検出: 資格証明の設定

ホスト資格証明

「ホスト資格証明」を選択した場合、次の資格証明プロパティを指定する必要があります。

- ユーザー名: ターゲットにアクセスするために必要なユーザー名。

- パスワード: ターゲットにアクセスするために必要なパスワード。

- 実行権限: 次のいずれかです。

- なし: 実行権限は不要です。このオプションは、ユーザーがrootで、「特権ユーザー」オプションが「はい」に設定されている場合に使用します。

- Sudo: 「Sudo」を選択する場合、次の項目を指定する必要があります。

- sudoコマンド: Sudoでは、許可されたユーザーがスーパーユーザーまたはsudoersファイルに指定された他のユーザーとしてコマンドを実行できます。/usr/bin/sudo -S -u %RUN_AS% %COMMAND%の形式でコマンドを入力します。/usr/bin/sudoはsudo実行可能ファイルへのパス、RUN_ASはコマンドを実行しているユーザーの名前、そしてCOMMANDはSudoコマンドが実行されていることを示します。

- 別名実行: rootユーザーとしてこのコマンドを実行するためにrootを指定します。

- 疑似ターミナルの有効化: sudoコマンドでユーザーが実端末(tty)にログインする必要がある場合、このチェック・ボックスを選択します。このフラグが設定されている場合、sudoユーザーは、別個の端末を通じてマシンにログインする必要があります。

- PowerBroker: 「PowerBroker」を選択する場合、次の項目を指定する必要があります。

- /usr/bin/pbrun -l -u %RUN_AS% %COMMAND%の形式でコマンドを入力します。/usr/bin/pbrunはPowerBroker実行可能ファイルへのパス、RUN_ASはコマンドを実行しているユーザーの名前、そしてCOMMANDはPowerBrokerコマンドが実行されていることを示します。

- パスワード・プロンプト: パスワードが指定された際に表示されるプロンプトです。

- 別名実行: rootユーザーとしてこのコマンドを実行するためにrootを指定します。

- プロファイル: このコマンドを実行するために使用するユーザー・プロファイルを指定します。

SSHキー資格証明

「SSHキー資格証明」を選択した場合、ユーザー名、秘密および公開鍵、パスフレーズ(今後の暗号化のため)、および実行権限を指定する必要があります。

「実行権限」フィールドで「Sudo」または「PowerBroker」を選択する場合、「ホスト資格証明」のリストに従って追加の詳細を入力してください。

10.3 「Oracle Server」ホームページの表示

「Oracle Server」ホームページを表示するには、次の手順に従います。

1. 「ターゲット」メニューから「すべてのターゲット」を選択し、「すべてのターゲット」ページに移動します。

2. 「すべてのターゲット」ページの左側のパネルで、「サーバー」、「記憶域」および「ネットワーク」ターゲット・タイプの下で「Oracle Server」を選択します。使用可能なOracle Serverターゲットのリストが表示されます。

3. いずれかのターゲットをクリックして、「Oracle Server」ホームページに移動します。

図10-4 「Oracle Server」ホームページ

このページには、次のリージョンがあります。

- 一般: このリージョンには、Oracle Virtual Platformターゲット、ターゲットの名前、CPUソケット、CPUコア、合計メモリーおよびローカル・ディスク領域など、一般の詳細が提供されます。

- 可用性: このリージョンのチャートには、ターゲットの過去24時間のステータスが表示されます。

- インシデントと問題の概要: このリージョンには、Oracle Serverターゲットに関連するすべてのインシデントと問題が表示されます。

10.4 「Oracle Virtual Platform」ホームページの表示

「Oracle Virtual Platform」ホームページを表示するには、次の手順に従います。

1. 「ターゲット」メニューから「すべてのターゲット」を選択し、「すべてのターゲット」ページに移動します。

2. 「すべてのターゲット」ページの左側のパネルで、「サーバー」、「記憶域」および「ネットワーク」ターゲット・タイプの下で「Oracle Virtual Platform」を選択します。使用可能なOracle Virtual Platformターゲットのリストが表示されます。

3. いずれかのターゲットをクリックして、「Oracle Virtual Platform」ホームページに移動します。

図10-5 「Oracle Virtual Platform」ホームページ

このページには、次のリージョンがあります。

- 一般: このリージョンには、Oracle Serverターゲット、プラットフォーム・バージョン、ターゲット名、Dom0に割り当てられたVCPU、Oracle Virtual Serverターゲットに割り当てられた合計VCPUなどの一般的な詳細が表示されます。また、これが特権ユーザーであるかどうかも示します。仮想化メトリックは、特権ユーザーの場合のみ収集されます。

- メンバー: このリージョンには、この仮想プラットフォームに属する仮想サーバー、ステータス、および各仮想サーバーへの割当てメモリーがリストされます。
管理エージェントが仮想サーバー上に存在する場合、Oracle Virtual Serverターゲットに対応するホスト名も表示されます。デフォルトでは、この列は表示されません。「表示」ドロップダウン・メニューを使用してこの列を選択できます。

- ネットワーク・アクティビティ: このリージョンは、この24時間の総スループット(MB/秒)を示します。

- インシデントと問題の概要: このリージョンには、Oracle Serverターゲットに関連するすべてのインシデントと問題が表示されます。

- チャート: CPU使用率、メモリー使用率、ネットワークおよびディスク・アクティビティ・チャートには過去24時間のアクティビティが表示されます。CPUとメモリー使用状況の傾向を示します

- 可用性: このリージョンのチャートには、ターゲットの過去24時間のステータスが表示されます。

10.5 Oracle VMインスタンス・ホームページの表示

Oracle VMインスタンス・ホームページを表示するには、次の手順に従ってください。

1. 「ターゲット」メニューから「すべてのターゲット」を選択し、「すべてのターゲット」ページに移動します。

2. 「すべてのターゲット」ページの左側のパネルで、「サーバー」、「記憶域」および「ネットワーク」ターゲット・タイプの下で「Oracle VMインスタンス」を選択します。使用可能なOracle VMインスタンス・ターゲットのリストが表示されます。

3. Oracle VMインスタンス・ホームページに移動するには、ターゲットの1つをクリックします。

図10-6 Oracle VMインスタンス・ホームページ

このページには、次のリージョンがあります。

- 一般: このリージョンには、Oracle ServerおよびOracle Virtual Platformターゲット、ターゲット名、割当てメモリーなどの一般的な詳細が表示されます。

- 可用性: このリージョンのチャートには、ターゲットの過去24時間のステータスが表示されます。

- インシデントと問題の概要: このリージョンには、Oracle Serverターゲットに関連するすべてのインシデントと問題が表示されます。

- チャート: CPU使用率、メモリー使用率、ネットワークおよびディスク・アクティビティ・チャートには過去24時間のアクティビティが表示されます。

第V部

Platform as a Serviceの設定および使用

ここでは、Database as a Service (DBaaS)およびMiddleware as a Service (MWaaS)クラウド・モデルを含む、Platform as a Serviceを有効化するために必要な手順について説明します。

内容は次のとおりです。

- 第11章「PaaSインフラストラクチャの設定」

- 第12章「DBaaSクラウドの有効化」

- 第13章「MWaaSクラウドの設定」

11 PaaSインフラストラクチャの設定

PaaSモデルによって、ユーザーは、コンシューマが独自のアプリケーションをデプロイできるプラットフォームを作成できます。プラットフォーム・リソースは、通常、ホスト、オペレーティング・システムおよびアプリケーション・サーバーで構成され、仮想化できます。プラットフォームには、クラスタに1つのデータベースと偶数のホストも含めることができます。

この章では、Oracle単一インスタンスを使用したDatabase as a Service (DBaaS)、WebLogic Server、SOAインフラストラクチャおよびOracle Service Busを使用したRACまたはMiddleware as a Service (MWaaS)などの様々なサービス・ファミリを含むPlatform as a Service (PaaS)を有効にするために実行する必要のある一般的な操作について説明します。次のセクションがあります。

- サービス・ファミリについて

- 共通設定タスク

11.1 サービス・ファミリについて

サービス・ファミリは、特定のドメインにソリューションを提供するサービスのグループとして分類できます。たとえば、データベース・サービスはRDBMSソリューションを提供し、WebLogicサービスはJ2EEベースのアプリケーション開発およびホスティング用のJavaソリューションを提供します。

各サービス・ファミリには、1つ以上のサービス・タイプを含めることができます。サービス・タイプはサービス・ファミリ内の特殊なサービスを提供します。たとえば、データベース・サービスは、データベース・サービス、スキーマ・サービスまたはプラガブル・データベース・サービスなどのサービス・タイプを含めることができます。ミドルウェア・サービス・タイプはWebLogicサービス、OSBサービスまたはSOAサービスを含めることができます。各サービス・タイプには特定の固定属性、アクション、構成、メトリックおよびその他のプロパティがあります。

サービス・インスタンスは、セルフ・サービス・ユーザーによって要求され管理されるクラウド・リソースです。たとえば、単一インスタンスのデータベース・サービス・インスタンス、WebLogicサービス・インスタンスなどです。

11.2 共通設定タスク

この項では、この章に取り組むための手引きとして、サービス・ファミリを設定する前に実行する必要のある共通手順の概要を説明します。

表11-1 サービス・ファミリの設定

手順

作業

ロール

1

ソフトウェア・ライブラリを構成します。詳細は、ソフトウェア・ライブラリの設定の項を参照してください。

クラウド管理者

2

必要なプラグインをデプロイします。第3.2項「必要なプラグインのデプロイ」を参照してください

クラウド管理者

3

管理者およびセルフ・サービス・ユーザーのロールを定義します。第3.3項「ロールの定義およびユーザーの割当て」を参照してください。

スーパー管理者

4

管理対象外ホストに管理エージェントをインストールし、Enterprise Managerから監視できるようにします。第11.2.1項「ホストの追加」を参照してください。

クラウド管理者

5

1つ以上のリソース・プロバイダを作成します。第11.2.2項「リソース・プロバイダの作成」を参照してください。

セルフ・サービス管理者

6

リクエスト設定を構成します。第11.2.3項「リクエスト設定の構成」を参照してください。

セルフ・サービス管理者

7

セルフ・サービス・ユーザーの割当て制限を設定します。第11.2.4項「割当て制限の設定」を参照してください。

セルフ・サービス管理者

11.2.1 ホストの追加

Oracle Management Agent(管理エージェント)は、Enterprise Manager Cloud Controlのコア・コンポーネントの1つです。プラグインとともに機能し、管理対象外ホストで実行されているターゲットを監視します。管理対象外ホストにOracle Management Agentsをインストールして、Enterprise Managerで監視する必要があります。

管理対象外のサーバーに管理エージェントをインストールする手順:

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「設定」メニューから、「ターゲットの追加」を選択し、「ターゲットの手動追加」を選択します。

3. 「ホスト・ターゲットの追加」オプションを選択して「ホストの追加」をクリックします。

4. ホスト名を追加し、プラットフォームを選択する。自己更新コンソールをチェックし、必要とするプラットフォームのエージェント・ソフトウェアが使用不可としてリストされている場合は、「次へ」をクリックします。

5. パスを自動生成するために「インスタンス・ディレクトリ」フィールドをクリックしてエージェントのインストール場所を入力し、エージェント・ユーザーの名前付き資格証明を生成し(sudoまたはpbrunを使用してrootユーザーにアクセスを提供します)、「ポート」フィールドの値をクリアし(これはポートの自動選択を有効にします)、「次へ」をクリックします。

6. すべての入力値を確認して「エージェントのデプロイ」をクリックします。

7. ホスト・ステータスの追加ページで、エージェントのデプロイメントの進行状況を追跡します。エージェントのデプロイメント・タスクは、5分から10分かかります。

8. 「ターゲット」、「ホスト」の順に選択して、ホスト・ページに移動します。ページにすべてのホストが表示されていることを確認します。

11.2.2 リソース・プロバイダの作成

リソース・プロバイダは、特定のサービス・タイプのサービス・インスタンスのプロビジョニングに必要なリソースのタイプを表すターゲットです。PaaSインフラストラクチャ・ゾーンは、1つ以上のホストを含むリソース・プロバイダです。ソフトウェア・プールは、Oracleホーム・ターゲット、Oracleデータベース・ターゲットなどのリソースを含むことができる別のリソース・プロバイダです。データベース・プールまたはミドルウェア・プールなどのリソース・プロバイダは、PaaSインフラストラクチャ・ゾーンに依存します。

リソースは、管理しやすいようにリソース・プロバイダでグループ化できます。リソース・プロバイダによって管理者は、サービス・プロビジョニングおよび容量計画のためのポリシーを適用できます。

リソース・プロバイダを作成するには、次の手順を実行します。

1. 適切なロールを持つユーザーとしてログインします。PaaSインフラストラクチャ・ゾーンを作成するには、EM_CLOUD_ADMINISTRATORロールを持つユーザーとしてログインする必要があります。データベース・プール、スキーマ・プールなどの他のすべてのリソース・プロバイダを作成するには、EM_SSA_ADMINISTRATORロールを持つユーザーとしてログインする必要があります。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューから「リソース・プロバイダ」を選択し、「作成」をクリックします。「リソース・プロバイダの作成」ウィンドウが表示されます。

図11-1 リソース・プロバイダの作成

4. 作成するリソース・プロバイダのタイプを選択します。これには次のものがあります。

- PaaSインフラストラクチャ・ゾーン。第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

- PaaSプール。第11.2.2.2項「PaaSプールの作成」を参照してください。

5. 「作成」をクリックしてウィザードの手順に従い、選択したリソース・プロバイダを作成します。

11.2.2.1 PaaSインフラストラクチャ・ゾーンの作成

PaaSインフラストラクチャ・ゾーンには、ホストのグループを含めることができます。各ゾーンには、1つのタイプのみの同種のリソースを含めることができます。ゾーン内の各リソースは、サービス・インスタンスをデプロイする場所を表します。

PaaSクラウドを構築する際の最初の手順は、少なくとも1つのPaaSインフラストラクチャ・ゾーンを作成することで、これを行うには、1つ以上のEnterprise Managerホスト・ターゲットを選択し、このゾーンのリソースをリクエストするために、ユーザーが必要とするSSAが有効なロールを特定します。

図11-2 PaaSインフラストラクチャ・ゾーン

前提条件

PaaSインフラストラクチャ・ゾーンを作成する前に、次の前提条件が満たされていることを確認してください。

- EM_CLOUD_ADMINISTRATOR、EM_SSA_ADMINISTRATORおよびEM_SSA_USERの各ロールが作成されている必要があります。詳細は、第3.3項「ロールの定義およびユーザーの割当て」を参照してください。

- 注意:
ソフトウェア・ライブラリのOMS共有システムの場所を使用している場合、資格証明の所有者はCLOUD_ENGINE_USERに権限を付与する必要があります。CLOUD_ENGINE_USERは非表示のユーザー・アカウントであるため、名前付き資格証明の所有者がEnterprise Manager Consoleから表示権限を付与することはできません。この問題に対処するには(特に、ソフトウェア・ライブラリの設定にOMSエージェント・ファイルシステムの使用が推奨されるWindowsホストでは)、次のEM CLIコマンドを実行する必要があります。 emcli login -username=<username> -password =<password>
emcli grant_privs -name=CLOUD_ENGINE_USER -privileges="GET_CREDENTIAL; CRED_NAME=<namedcred>:CRED_OWNER=<loginusername>"

- PaaSインフラストラクチャ・ゾーンを作成するには、EM_CLOUD_ADMINISTRATOR権限を持つユーザーとしてログインする必要があります。

PaaSインフラストラクチャ・ゾーンを作成するには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

2. 「クラウド・ホーム」メニューから「リソース・プロバイダ」を選択し、「作成」を選択します。「リソース・プロバイダの作成」ウィンドウで、「PaaSインフラストラクチャ・ゾーン」を選択し、「作成」をクリックします。PaaSインフラストラクチャ・ゾーンの作成: 一般ページが表示されます。

3. 図11-3 PaaSインフラストラクチャ・ゾーンの作成: 一般

4. ゾーンのターゲット名、名前および説明を入力します。次をクリックします。

5. 「追加」をクリックして、1つ以上のホスト・メンバーをゾーンに追加します。選択したホストは、複数のPaaSインフラストラクチャ・ゾーンに存在できません。「次」をクリックします。

6. PaaSインフラストラクチャ・ゾーンの作成: 資格証明ページで、このゾーン内のすべてのターゲットのプロビジョニングに使用するホスト資格証明を指定します。指定された資格証明は、グローバル資格証明タイプ(ゾーン内のメンバー全体で有効)である必要があり、現在のユーザーが所有している必要があります。次をクリックします。

注意:
新しい名前付き資格証明を設定するには、「設定」メニューから「セキュリティ」を選択し、「名前付き資格証明」を選択します。ここではユーザーまたはパスワードの名前付き資格証明を作成できます。SSHなどの他のタイプの資格証明は「セキュリティ」メニューから作成する必要があり、ここで使用できます。

7. ホスト・メンバーが利用可能なリソースに基づいて、配置ポリシー制約に適切な値を指定します。配置ポリシー制約は、ゾーン内のホストの上限値を設定するために使用されます。配置ポリシーの値は、デプロイメントの際、負荷の大きすぎるホストを除外するために使用されます。それぞれのホストに次の配置ポリシー制約を定義できます。

- 最大CPU使用率: 過去7日間における平均のCPU使用率(%)です。

- 最大メモリー割当て: 過去7日間における平均のメモリー割当てです。

これらのしきい値を超えるホストには、プロビジョニング操作が考慮されません。

8. 「次へ」をクリックします。PaaSインフラストラクチャ・ゾーンの作成: 特性ページで、コスト・センター、ライフサイクル・ステータス、場所などのターゲット・プロパティを指定します。

9. 次をクリックします。PaaSインフラストラクチャ・ゾーンの作成: ロール・ページが表示されます。PaaSインフラストラクチャ・ゾーンは、EM_SSA_USERロールを持つ限定されたセルフ・サービス・ユーザーに対して使用可能にできます。「追加」をクリックして追加し、このPaaSインフラストラクチャ・ゾーンにアクセスできるロールを選択します。

10. 次をクリックします。PaaSインフラストラクチャ・ゾーンの作成: 確認ページが表示されます。作成しているゾーンの詳細を確認し、「発行」をクリックしてゾーンを作成します。データベースとクラウド・ホーム・ページに戻ります。

注意:
EMCLIコマンド(第51.13.1.1項「PaaSゾーンの作成」を参照)またはREST API (第48.3.1.3.3項「PaaSゾーンの作成」を参照)を使用して、PaaSインフラストラクチャ・ゾーンを作成できます。

11.2.2.1.1 PaaSインフラストラクチャ・ゾーンの編集

PaaSインフラストラクチャ・ゾーンを編集するには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

2. 「クラウド・ホーム」メニューから「リソース・プロバイダ」を選択します。リソース・プロバイダ・ページが表示されます。

3. リストから「PaaSインフラストラクチャ・ゾーン」を選択し、「編集」をクリックします。

注意:
PaaSインフラストラクチャ・ゾーンの定義済名前付き資格証明に対してアクセス権がないか、またはこの資格証明を所有しない場合、新規資格証明を指定する必要があります。

4. ウィザードの手順に従って必要なパラメータを編集し、「発行」をクリックして変更を受け入れます。

11.2.2.1.2 PaaSインフラストラクチャ・ゾーンの削除

PaaSインフラストラクチャ・ゾーンを削除するには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

2. 「クラウド・ホーム」メニューから「リソース・プロバイダ」を選択します。リソース・プロバイダ・ページが表示されます。

3. リストから「PaaSインフラストラクチャ・ゾーン」を選択し、「削除」をクリックします。

4. 確認メッセージが表示されます。「PaaSインフラストラクチャ・ゾーンの削除」をクリックして、ゾーンを削除します。

11.2.2.2 PaaSプールの作成

PaaSクラウドを構築する際の2番目の手順は、ソフトウェア・プール(たとえば、PaaSインフラストラクチャ・ゾーン内のホストに存在するデータベースまたはミドルウェアのOracleホーム、またはSchema as a Serviceのデータベース・インスタンス)を作成することです。次の図は、PaaSプールの例を示しています。

図11-4 PaaSプール

PaaSプールは、同じプラットフォーム、タイプおよびバージョンのOracleホームの同種のコレクションである必要があります。たとえば、Solaris 10 Oracle Database単一インスタンス・バージョン10.2.0.5またはOracle Enterprise Linux 5 x86-64 WebLogic Serverバージョン10.3.6などです。データベース・プールまたはミドルウェア・プールを作成できます。

- データベース・プールを作成するには、第11.2.2.2.1項「データベース・プールの作成」を参照してください。

- ミドルウェア・プールを作成するには、第11.2.2.2.2項「ミドルウェア・プールの作成」を参照してください。

11.2.2.2.1 データベース・プールの作成

データベース・プールには、PaaSインフラストラクチャ・ゾーン内にデータベース・インスタンスをプロビジョニングする際に使用できる一連のリソースが含まれています。データベース・プールとは、データベース・ソフトウェアがインストールされたサーバーまたはクラスタなどの、同種ターゲットのコレクションです。詳細は、第11.2.2.2項「PaaSプールの作成」を参照してください。

設定するデータベース・サービスのタイプに応じて、次のいずれかを実行できます。

- Database as a Service用のデータベース・プールの作成

- Schema as a Service用のデータベース・プールの作成

- PDB as a Service用のデータベース・プールの作成

11.2.2.2.2 ミドルウェア・プールの作成

ミドルウェア・プールには、PaaSインフラストラクチャ・ゾーン内にサービス・インスタンスをプロビジョニングする際に使用できる一連のリソースが含まれています。ミドルウェア・プールの作成の詳細は、第25.2項「ミドルウェア・プールの作成」を参照してください。

11.2.3 リクエスト設定の構成

リクエストできる時間、その期間などを指定して、リクエスト設定を構成できます。リクエスト設定を構成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」→「リクエスト設定」を選択します。

図11-5 リクエスト設定の構成

3. 次の設定を指定できます。

- 将来の予約: どの程度先までリクエストを作成できるか。

- リクエスト・アーカイブ保存: システムによって自動的に削除されるまでに、アーカイブされたリクエストが保存される期間。

- リクエスト期間: リクエストを作成できる最大期間。

- サービス・インスタンス共有設定: 次のいずれかのチェック・ボックスを選択して、サービス・インスタンスを他のユーザーまたはロールと共有することを選択できます。

- SSAユーザーが他のユーザーとサービス・インスタンスを共有できるようにします

- SSAユーザーがロールとサービス・インスタンスを共有できるようにします

注意: デフォルトでは、サービス・インスタンスはユーザーまたはロールと共有されません。

4. 「適用」をクリックします。

リクエスト設定は、すべてのサービスに対して定義することも、特定のサービス・ファミリ、サービス・タイプまたはロールに対して定義することもできます。一致したすべての値から、リクエスト設定の最も制限の多い値が取得されます。レベルの「制限なし」は、設定がこのレベルで適用されず、最終値の評価時に考慮されないことを示します。たとえば、ユーザーがスキーマ・サービスをリクエストし、「リクエスト期間」のリクエスト設定値は「すべてのサービス」が30日、「データベース・ファミリ」が10日、「スキーマ・サービス・タイプ(グローバル)」が5日、「スキーマ・サービス・タイプ(SSAUser1ロール)」が3日であるとします。この場合、最も制限の多い設定である「スキーマ・サービス・タイプ(SSAUser1ロール)」設定の3日が適用されます。

サービス・インスタンス共有設定は、有効な最上位のレベルから取得されます。たとえば、「すべてのサービス」で共有が有効になっている場合、それより低いレベルの設定に関係なく、すべてのユーザーに対して共有が許可されます。ミドルウェア・ファミリの共有をオフにするためには、「すべてのサービス」レベルで共有を無効にし、ミドルウェア・ファミリの共有を無効にしてから、他のファミリの共有を有効にします。変更した設定は、別の選択をする前に保存する必要があります。適用されていない変更は破棄されます。

11.2.4 割当て制限の設定

割当て制限は、特定のロールに属するセルフ・サービス・ユーザーそれぞれに許可されているリソース量の集計です。この割当て制限が適用されるのは、データベース・クラウド・セルフ・サービス・ポータルでプロビジョニングされるデータベースのみです。割当て制限を設定するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「クラウド」メニューから、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューから、「割当て制限」を選択します。

3. 左側の「データベース」リンクをクリックします。割当て制限定義ページが表示されます。「作成」をクリックします。

注意:
割当て制限の検証により、ユーザーの現在の使用量がそのユーザーが属するロールに指定された制限内に収まる場合にのみ、リクエストの実行が保証されます。直接指示されたロールのみが割当て制限の判断の対象となり、ネストされているロールは対象外です。

4. 新規割当て制限の作成ウィンドウで、割当て制限を許可する「ロール名」を選択します。EM_SSA_USER権限を持つロールのみが「ロールの選択」ダイアログ・ボックスに表示されます。ロールを選択したら、次の詳細を入力します。

- メモリー: 特定のユーザーが所有するすべてのデータベースで割当て可能なメモリー。これは、次のすべてに使用される合計メモリーである必要があります。

- データベース

- リクエストされたスキーマ

- プラガブル・データベース

- 記憶域: ユーザーが所有するすべてのデータベースで割当て可能な記憶域。これは、次のすべてに使用される合計記憶域である必要があります。

- データベース

- リクエストされたスキーマ

- プラガブル・データベース

注意:
バックアップに使用される記憶域は、ここには含まれません。

- データベース要求数: 任意の時点でユーザーがリクエスト可能なデータベースの数。データベース・リクエストの一部として作成されるスタンバイ・データベースは、この割当て制限には含まれません。ただし、スタンバイ・データベースの記憶域とメモリーの値は、割当て済の記憶域とメモリーの合計に追加されます。

- スキーマ・サービス・リクエストの数: ユーザーがリクエスト可能なデータベース・サービスの数。

- プラガブル・データベース・サービス・リクエストの数: ユーザーがリクエスト可能なPDBの数。

たとえば、ユーザーが、次の表に示すように割当て制限の設定されている3つのロールを持っている場合を考えます。

ロール名

属性

値

Devロール

メモリー

30 GB

記憶域

40 GB

DBリクエスト

10

スキーマ・リクエスト

2

PDBリクエスト

3

Testロール

メモリー

40 GB

記憶域

60 GB

DBリクエスト

12

スキーマ・リクエスト

3

PDBリクエスト

5

PMロール

メモリー

割当て制限は未設定

記憶域

割当て制限は未設定

DBリクエスト

割当て制限は未設定

スキーマ・リクエスト

割当て制限は未設定

PDBリクエスト

割当て制限は未設定

各属性の割当て制限は、ユーザーが直接属しているすべてのロールに基づいて決定されます。割当て制限は、それぞれの属性値を持つロールの中の最大値から算出されます。Dev、TestおよびPMロールに属するユーザーの場合、割当て制限は次のように計算されます。

メモリーの値 = MAX(Dev, Test, PM) = MAX(2, 5, NA) = 5 GB

記憶域の値 = MAX(Dev, Test, PM) = MAX(15, 10, NA) = 15 GB

DBリクエストの値 = MAX(Dev, Test, PM) = MAX(10, 12, NA) = 12データベース

スキーマ・リクエストの値 = MAX (Dev, Test, PM) = MAX (2, 3, NA) = 5データベース・サービス

PDBリクエストの値 = MAX (Dev, Test, PM) = MAX (3, 5, NA) = 8 PDBサービス

ユーザーのリクエストによる割当て制限検証ログのサンプルを次に示します。

Quota validation:
==================================================================
Quota Details
==================================================================
Total resources avaialble
Memory: 15
Storage: 20
Number of Database Instances: 5
Number of Schema Services: 5
Number of Pluggable Databases: 10

==================================================================
Current Usage
==================================================================
Memory: 0.0
Storage: 0.0
Number of Database Instances: 0.0
Number of Database Services: 0.0

==================================================================
Requested Resource
==================================================================
Memory: 0.681640625
Number Of Databases: 1
Storage: 0.681640625

-----------------------------------------------------------
Quota validation for 'Memory'
-----------------------------------------------------------
Allocated Resource: 15.0
Current Usage: 0.0
Requested: 0.681640625
------------------
Remaining Resource After Allocation: 14.318359375
-------------------

Result: Passed
-----------------------------------------------------------
Quota validation for 'Storage'
-----------------------------------------------------------
Allocated Resource: 20.0
Current Usage: 0.0
Requested: 0.681640625
------------------
Remaining Resource After Allocation: 19.318359375
-------------------

Result: Passed
----------------------------------------------------------
Quota validation for 'Number of Database Instances'
----------------------------------------------------------
Allocated Resource: 5.0
Current Usage: 0.0
Requested: 1.0
------------------
Remaining Resource After Allocation: 4.0
-------------------

12 DBaaSクラウドの有効化

この章では、DBaaSクラウドを有効化するために必要な初期構成について説明します。内容は次のとおりです。

- 開始

- プロビジョニング用の資格証明の設定

- Database as a Serviceのデータベース・ソフトウェアのプロビジョニング

- Schema as a Serviceのデータベースのプロビジョニング

- PDB as a Serviceのコンテナ・データベースのプロビジョニング

- Oracleリスナーの構成

- ストレージ・サーバーの登録および管理

12.1 開始

この項では、プライベート・データベース・クラウドの設定を開始するために実行する必要のある手順のリストを示すことで開始を支援します。データベース・クラウドを設定する前に、第11.2項「共通設定タスク」で説明した共通設定タスクを完了する必要があります。

表12-1 DBaaSの開始

手順

作業

ロール

1

管理対象ホストで権限委任設定を構成します。第3.5項「権限委任設定の構成」を参照してください。

スーパー管理者

2

プロビジョニング資格証明の設定第12.2項「プロビジョニング用の資格証明の設定」を参照してください。

セルフ・サービス管理者

3

- Database as a Serviceの設定: データベース・ソフトウェアをプロビジョニングするか、Oracleホームを作成する必要があります。第12.3項「Database as a Serviceのデータベース・ソフトウェアのプロビジョニング」を参照してください。

- Schema as a Serviceを設定するには、データベースをプロビジョニングする必要があります。第12.4項「Schema as a Serviceのデータベースのプロビジョニング」を参照してください。

- Pluggable Database as a Serviceを設定するには、1つ以上のプラガブル・データベース(PDB)を含むコンテナ・データベース(CDB)を作成する必要があります。第12.5項「PDB as a Serviceのコンテナ・データベースのプロビジョニング」を参照してください。

セルフ・サービス管理者

4

リスナーの構成第12.6項「Oracleリスナーの構成」を参照してください。

セルフ・サービス管理者

5

スナップ・クローン・プロファイルを使用する場合、ストレージ・サーバーを登録する必要があります。第12.7項「ストレージ・サーバーの登録および管理」を参照してください。

セルフ・サービス管理者

12.2 プロビジョニング用の資格証明の設定

管理対象サーバーまたはデータベースで操作を実行する前に、Enterprise Managerがターゲットへの接続に使用する資格証明を定義する必要があります。

次のタイプの資格証明を設定する必要があります。

- 通常の資格証明は、データベース・ソフトウェアのプロビジョニングおよびデータベースの作成に使用されるホスト・オペレーティング・システムの資格証明です。たとえば、oracle/<login password>などです。これらの資格証明は、データベース・プールの作成時に保存され、EM_SSA_USERがデータベースまたはスキーマをリクエストする場合に使用されます。

- 特権資格証明は、rootスクリプトの実行といった特権的な処理を行うために使用するホスト・オペレーティング・システムの資格証明です。これらの資格証明は、ソフトウェアのデプロイ(デプロイメント中のroot.shを実行するため)、記憶域ボリュームのマウントとアンマウント(スナップショットを使用して作成されたデータベースのため)などに使用されます。プールがスナップショットを使用したデータベースを作成するために使用される場合、これらの資格証明はデータベース・プールとともに保存されます。

- データベースSYSDBA資格証明は、Schema as a Serviceデータベース・プールに対して使用および保存されます。これらの資格証明は、Schema as a Serviceにのみ必要です。

注意:
ホストでOracleホームを所有する同じOSユーザーがデータベースを作成することが推奨されます。

名前付き資格証明の作成手順:

1. EM_SSA_ADMINISTRATORロールを持つ管理者でEnterprise Managerにログインします。

2. 「設定」メニューから、「セキュリティ」、「名前付き資格証明」の順に選択します。

3. 名前付き資格証明ページで、「作成」をクリックします。

4. 「資格証明名」および「資格証明の説明」を入力します。「認証ターゲット・タイプ」フィールドを「ホスト」に、「有効範囲」フィールドを「グローバル」を設定します。「資格証明プロパティ」セクションで、「ユーザー名」および「パスワード」を入力します。特権資格証明を設定する必要がある場合は、「実行権限」フォールドで、「sudo」または「PowerBroker」を選択し、「別名実行」および「プロファイル」フィールドに値を入力します。

5. 「テスト」および「保存」をクリックします。

6. これらの資格証明をホスト・ターゲットで確認し、「OK」をクリックします。

12.3 Database as a Serviceのデータベース・ソフトウェアのプロビジョニング

データベースをサービスとして有効化するためには、その前にデータベース・ソフトウェアがすべてのホストにプロビジョニングされている必要があります。データベース・ソフトウェアは、EM_SSA_ADMINISTRATORロールを持つ管理者により、次の方法でプロビジョニングできます。

- プロビジョニング・プロファイル

- プロビジョニング・プロファイルを使用して、既存のデータベースのゴールド・イメージを取得します。詳細は、Oracle Enterprise Manager Lifecycle Managementの管理者ガイドを参照してください。

- プロビジョニング・プロファイルを使用し、クラスタウェア/ASMまたはグリッド・インフラストラクチャ(Real Application Clusterデータベースの場合)およびデータベースのOracleホームをプロビジョニングします。この方法により、データベース・プロビジョニングおよびOracleホームのインストールの一環として、必要なデータベース・プラグイン(データベース・プラグインの監視機能部分)が、管理エージェント上にデプロイされます。
プロビジョニング・プロファイルを作成するには、「エンタープライズ」メニューから「プロビジョニングとパッチ適用」を選択して、次に「データベースのプロビジョニング」を選択して、使用するデータベース・プロビジョニングのデプロイメント・プロシージャを選択します。「Oracleデータベースのプロビジョニング」またはOracle RACデータベースのプロビジョニングのいずれかのデプロイメント・プロシージャを選択できます。

注意: 新規データベースをこのデプロイメント・プロシージャの一部として作成しないでください。

- データベース・インストーラの使用

- 「設定」メニューで、「拡張性」、「プラグイン」の順に選択して、SSA (Enterprise Manager for Oracle Cloud)プラグイン一式をPaaSインフラストラクチャ・ゾーンのすべての管理エージェントにデプロイします。

- クラスタウェア/ASMまたはグリッド・インフラストラクチャ・インストーラを実行して、クラスタとASM (RACデータベースの場合)を設定します。

- データベース・インストーラを実行して、すべてのホスト上で「データベースの作成」オプションを選択します。

- データベースを検出します。「設定」メニューから、「ターゲットの追加」、「ターゲットの手動追加」の順に選択し、次に「ガイド付きプロセスを使用して非ホスト・ターゲットを追加(関連ターゲットも追加)」を選択します。

- 「エンタープライズ」メニューから「ジョブ」、「ライブラリ」の順に選択して、「Oracleホーム昇格ターゲットの検出」ジョブを送信しても、Oracleホームを追加できます。

データベース・ソフトウェアのプロビジョニングの詳細は、Oracle Enterprise Manager Lifecycle Managementの管理者ガイドを参照してください。

12.4 Schema as a Serviceのデータベースのプロビジョニング

Schema as a Serviceの場合、単一インスタンスまたはRACデータベースをデプロイする必要があります。データベースをデプロイするには、Oracleデータベースのプロビジョニング・デプロイメント・プロシージャを使用する必要があります。詳細は、Oracle Enterprise Manager Lifecycle Managementの管理者ガイドを参照してください。

12.5 PDB as a Serviceのコンテナ・データベースのプロビジョニング

注意:
プラガブル・データベース(PDB)をプロビジョニングする必要がある場合には、コンテナ・データベースを作成する必要があります。

Oracle Databaseには、Oracle Netクライアントに個別のデータベースとして表示される、スキーマ、スキーマ・オブジェクト、および非スキーマ・オブジェクトのポータブル・コレクションを含めることができます。この自己完結型コレクションは、プラガブル・データベース(PDB)と呼ばれます。マルチテナントのコンテナ・データベース(CDB)は、1つ以上のPDBを含むデータベースです。

CDBを作成するには、Database Configuration Assistant(DBCA)またはCREATE_DATABASE SQL文のいずれかを使用します。詳細は、『Oracle Database管理者ガイド』を参照してください。作成したCDBには、ルートとシードが含まれます。ルートにはユーザー・データが最小限含まれているかまったく含まれず、シードにはユーザー・データは含まれていません。

PDBにはユーザー・データが含まれています。CDBを作成したら、次のオプションのいずれかを使用して、PDBをCDBに追加できます。

- 新規CDBを作成します。詳細は、Oracle Enterprise Manager Lifecycle Managementの管理者ガイドを参照してください。

- 切断されたPDBをCDBに接続します。詳細は、Oracle Enterprise Manager Lifecycle Managementの管理者ガイドを参照してください。

12.6 Oracleリスナーの構成

Enterprise Managerターゲットに追加する前に、OracleホームおよびOracleリスナーを構成する必要があります。

データベース・ホストにOracleリスナー(リスナー)を設定するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとしてログインし、第11.2.1項「ホストの追加」に記載されているように、新規に追加されたホストで、データベース・ホームのマス・デプロイメントを実行します。

2. データベース・インスタンスが生成されているものと同じOracleホームから実行されているリスナーを設定するには、Bashシェルを起動して次のコマンドを入力します。

1. <AGENT_BASE>/agent_inst/bin/emctl stop agent

2. export TNS_ADMIN=<DB_HOME_LOCATION>/network/admin

3. <AGENT_BASE>/agent_inst/bin/emctl start agent

4. export ORACLE_HOME=<DB_HOME_LOCATION>

5. $ORACLE_HOME/bin/netcaを実行し、リスナーを作成します。すべてのホストが同じリスナー名とリスナー・ポートであることを確認してください。

3. 単一インスタンスの高可用性(Single Instance High Availability: SIHA)のOracleホームから実行されているリスナーを設定するには、Bashシェルを起動して次のコマンドを入力します。

1. export ORACLE_HOME=<SIHA_HOME_LOCATION>

2. $ORACLE_HOME/bin/netcaを実行し、リスナーを作成します。すべてのホストが同じリスナー名とリスナー・ポートであることを確認してください

4. DBAAS_ADMIN_ROLEを持つユーザーでログインし、すべてのホストで新規に追加されたリスナー・ターゲットを検出します。「設定」メニューから、「ターゲットの追加」を選択し、「ターゲットの手動追加」を選択します。

5. 「ガイド付きプロセスを使用して非ホスト・ターゲットを追加(関連ターゲットも追加)」オプションを選択し、「ターゲット・タイプ」に「Oracle Database」、「リスナー」および「自動ストレージ管理」を選択し、ガイドされた検出の追加をクリックし、ウィザードの手順に従います。新しいリスナー・ターゲットを追加するには、リスナーのORACLE_HOMEが正しいORACLE_HOMEの場所を指していることを確認します。このプロセスにより、データベース・プールの作成時に使用されるOracleホーム・ターゲットが追加されます。

12.7 ストレージ・サーバーの登録および管理

注意:
スナップ・クローンに基づくプロファイルからシン・クローンを作成する場合には、NetApp、Sun ZFS、EMCなどのストレージ・サーバーの登録と管理を行う必要があります。詳細は、第20章「データベースのスナップ・クローンの作成」を参照してください。

この項の内容は次のとおりです。

- ストレージ・サーバーの登録の概要

- 開始する前に

- ストレージ・サーバーの登録の前提条件

- ストレージ・サーバーの登録

- ストレージ・サーバーの管理

- ストレージ・サーバーの管理

12.7.1 ストレージ・サーバーの登録の概要

Enterprise ManagerでNetAppストレージ・サーバー、Sun ZFSストレージ・サーバー、EMCストレージ・サーバーなどのストレージ・サーバーを登録すると、ストレージによって提供されるスナップショットおよびクローニング機能を使用してデータベースをプロビジョニングできます。

登録プロセスは、ストレージを検証し、このストレージのEnterprise Manager管理データベース・ターゲットを検出します。データベースを検出した後、スナップ・クローン用に有効化できます。スナップ・クローンは、ストレージ・スナップショット・テクノロジを使用してデータベース・クローンを作成するプロセスです。

注意:
Windowsオペレーティング・システム上のデータベースはサポートされていません。

12.7.2 開始する前に

開始する前に、次の点に注意してください。

- ストレージ検出の一部としてWindowsデータベースは検出されません。これは、WindowsストレージNFSコレクションがまったく発生しないためです。NFSコレクションは、特定のOSリリースでもサポートされていないため、これらのOSリリース上のデータベースはスナップ・クローンを行えません。詳細は、My Oracle Support Note 465472.1を参照してください。また、Windows上でのOracle Databaseのサポート用にはNASボリュームを使用できません。

- スナップ・クローンは、Sun ZFS Storage 7120、7320、7410、7420およびZS3モデル、7モードおよびcモードのNetApp 8ハードウェア、EMC VMAX 10KおよびVNX 5300、Solaris ZFSファイルシステムでサポートされています。

- OSバージョンがB.11.31以上の場合のみ、スナップ・クローンはHP-UXホスト上のSun ZFSストレージをサポートします。OSバージョンがこれより低い場合、Sunストレージは適切に機能しないことがあるため、スナップ・クローンで予期しない結果が発生します。

- デフォルトでは、Enterprise Managerによってターゲット・ホスト上で検出されるNFSファイル・システムの最大数は、100です。ただし、このしきい値は構成可能です。すべての余分なファイル・システムを監視しないようにする場合、監視するファイル・システムのリストを選択することもできます。
各ホスト・エージェントの構成ファイル$agent_inst/sysman/emd/emagent_storage.configには、様々なストレージ監視関連のパラメータが含まれています。

NFSファイル・システムのしきい値を構成するには、次のパラメータを編集する必要があります。

Collection Size:START
Disks=1000
FileSystems=1000
Volumes=1000
Collection Size:END

監視するファイル・システムのリストを指定することを選択した場合、次の行の間に指定できます。

FileSystems:START

FileSystems:END

管理エージェントを再起動し、この構成ファイルへの変更内容が有効になるよう、ホスト構成をリフレッシュします。

- RDBMS上で11.1.0.7.0およびAL32UTF8キャラクタ・セットを使用してOMSリポジトリが実行中の場合、パッチ11893621を適用する必要があります。

12.7.3 ストレージ・サーバーの登録の前提条件

ストレージ・サーバーを登録する前に、次の項で説明されている前提条件に従います。

- ストレージ・サーバーの構成

- ストレージ・プロキシ・エージェントのカスタマイズ

12.7.3.1 ストレージ・サーバーの構成

ストレージ・サーバーを登録する前に、スナップ・クローンを正常に使用するには、次の権限およびライセンスが必要です。

- NetAppハードウェアの構成

- Sun ZFSおよびZF3ハードウェアの構成

- Solaris File System (ZFS)ストレージ・サーバーの構成

- EMCストレージ・サーバーの構成

注意:
Enterprise Manager Cloud Control 12cでは、NetApp、Sun ZFS、Solaris File System (ZFS)およびEMCのストレージ・サーバーがサポートされています。

NetAppハードウェアの構成

この項の内容は次のとおりです。

- NetAppハードウェア権限の取得

- NetAppハードウェア・ライセンスの取得

- NetAppストレージ資格証明の作成

- NetApp 8クラスタ・モード・ハードウェアの構成

- クラスタ・モードでサポートされるNetApp 8構成

- NetApp 8ストレージおよびSVMの準備

NetAppハードウェア権限の取得

権限(Privileges)は総称です。NetAppでは、権限(Privileges)を機能(Capabilities)と呼びます。

NetAppストレージ・サーバーの場合、スナップ・クローンを使用するには、次の権限または機能をNetAppストレージ資格証明に割り当てます。

注意:
これらの機能(Capabilities)を個別に割り当てるか、ワイルドカード表記を使用できます。たとえば、次のようになります。

'api-volume-*', 'api-*', 'cli-*'

- api-aggr-list-info

- api-aggr-options-list-info

- api-file-delete-file

- api-file-get-file-info

- api-file-read-file

- api-license-list-info

- api-nfs-exportfs-append-rules

- api-nfs-exportfs-delete-rules

- api-nfs-exportfs-list-rules

- api-nfs-exportfs-modify-rule

- api-snapshot-create

- api-snapshot-delete

- api-snapshot-list-info

- api-snapshot-reclaimable-info

- api-snapshot-restore-volume

- api-snapshot-set-reserve

- api-system-api-get-elements

- api-system-api-list

- api-snapshot-set-schedule

- api-system-cli

- api-system-get-info

- api-system-get-ontapi-version

- api-system-get-version

- api-useradmin-group-list

- api-useradmin-user-list

- api-volume-clone-create

- api-volume-clone-split-estimate

- api-volume-create

- api-volume-destroy

- api-volume-get-root-name

- api-volume-list-info

- api-volume-list-info-iter-end

- api-volume-list-info-iter-next

- api-volume-list-info-iter-start

- api-volume-offline

- api-volume-online

- api-volume-restrict

- api-volume-set-option

- api-volume-size

- cli-filestats

- login-http-admin

NetAppハードウェア・ライセンスの取得

NetAppストレージ・サーバーのスナップ・クローンには、次のサービスの有効なライセンスが必要です。

- flex_clone

- nfs

- snaprestore

NetAppストレージ資格証明の作成

NetAppストレージ資格証明を作成するには、次の手順に従います。

注意:
スナップ・クローンはNetApp Data ONTAP® 7.2.1.1P1D18以上、およびONTAP@ 8.x (7モード、cモードおよびvサーバー・モード)でのみサポートされます。

1. api-aggr-list-info,api-file-delete-fileなどのすべての推奨される機能(Capabilities)を使用して、ロールem_smf_admin_roleを作成します。

2. ロールem_smf_admin_roleを使用してグループem_smf_admin_groupを作成します。

3. グループem_smf_admin_groupおよびセキュア・パスワードを使用して、ユーザーem_smf_adminを作成します。

注意:
ユーザーem_smf_adminは、Oracle Enterprise Managerによって使用される専用のユーザーである必要があります。Oracleでは、他の目的のためにこのアカウントの共有をお薦めしていません。

NetApp 8クラスタ・モード・ハードウェアの構成

このトピックでは、Enterprise Manager Cloud Control 12cで、スナップ・クローンをサポートするためにNetApp 8クラスタ・モード(C-モード)ハードウェアを設定する方法について説明します。

NetApp 8ハードウェアの7-モードでは、スナップ・クローンがすでにサポートされています。

NetApp 8 C-モードのハードウェアを構成するには、次の項を参照してください。

- クラスタ・モードでサポートされるNetApp 8構成

- NetApp 8ストレージおよびSVMの準備

クラスタ・モードでサポートされるNetApp 8構成

C-モードでサポートされている構成は次のとおりです。

- スナップ・クローン機能はSVM (Vserver)でのみサポートされています。

- 物理クラスタ・ノードの登録はサポートされていません。

- Enterprise Manager Cloud Control 12cには複数のSVMを登録できます。登録済のSVMはすべて個別に管理されます。

NetApp 8ストレージおよびSVMの準備

NetApp 8ストレージおよびSVMを準備するには、次の要件が満たされていることを確認してください。

- C-モードのNetApp 8ハードウェアにSVMが作成されている必要があります。作成されていない場合は、Enterprise Managerに登録するSVMを作成する必要があります。

- SVMには、管理アクセス権とデータ・アクセス権の両方を持つネットワーク・インタフェース(LIF)が必要です。Enterprise Managerの「ストレージ登録」ページで、このインタフェースのドメイン名とIPアドレスを指定する必要があります。

- 少なくとも1つの集計(ボリューム)がSVMに割り当てられている必要があります。集計をSVM間で共有しないでください。

- SVMには、ontapiアクセス用にvsadmin-volumeロールが割り当てられたユーザー・アカウントが必要です。
Enterprise Managerの「ストレージ登録」ページで、ユーザー資格証明を指定する必要があります。

- SVMのルート・ボリュームには、すべてのホストに対する読取り専用アクセスを許可するルールを含むエクスポート・ポリシーが必要です。NFS v4を使用している場合は、エクスポート・ルールの変更ダイアログ・ボックスからスーパーユーザー・アクセス権を付与する必要があります。

注意:

- SVMのルート・ボリュームの中に、em_volumesというディレクトリが権限0444とともに作成されます。このディレクトリは、Enterprise Managerネームスペースのジャンクション・ポイントとして使用されます。

- 作成されたストレージ・ボリュームではすべて、ネームスペースにジャンクション・ポイント/em_volumesが使用されます。

注意:
Enterprise Manager Cloud ControlでSVMを登録すると、それに割り当てられているすべての集計の詳細がフェッチされます。集計の合計サイズは、割当て制限の設定や領域計算の実行、およびレポートの目的で必要です。
現在、NetAppには、SVMから合計集計サイズをフェッチするためのData ONTAP APIは備わっていません。このため、使用可能な集計サイズが合計サイズとみなされ、最初の同期実行中にストレージ上限として設定されます。ストレージ上限は、Enterprise Managerが集計で使用できる最大領域です。

ストレージの集計の合計領域が増加した場合、その集計の使用可能領域を消費するまでストレージ上限を大きくすることができます。

Sun ZFSおよびZF3ハードウェアの構成

この項の内容は次のとおりです。

- Sun ZFSハードウェア権限の取得

- Sun ZFSハードウェア・ライセンスの取得

- Sun ZFSストレージ資格証明の作成

Sun ZFSハードウェア権限の取得

権限(Privileges)は総称です。たとえば、Sun ZFSでは、権限(Privileges)をアクセス権(Permissions)と呼びます。

Sun ZFSストレージ・サーバーの場合、スナップ・クローンを使用するには、次の権限またはアクセス権をSun ZFSストレージ資格証明に割り当てます。

注意:
リストされたすべてのアクセス権(Permissions)をtrueに設定する必要があります。有効範囲に'nas'を指定する必要があり、詳細なフィルタを指定しないでください。

- changeProtocolProps

- changeSpaceProps

- clone and createShare

- destroy

- rollback

- takeSnap

Sun ZFSハードウェア・ライセンスの取得

Sun ZFS Storage Appliance上のスナップ・クローンには、クローン機能のライセンスが必要です。この機能の使用制限付きライセンスが、Enterprise Manager Snap Cloneに含まれています。

Sun ZFSストレージ資格証明の作成

Sun ZFSストレージ資格証明を作成するには、次の手順に従います。

1. ロールem_smf_admin_roleを作成します。

2. ロールem_smf_admin_roleの認可を作成します。

3. nasとして範囲を設定します。

4. allow_changeProtocolProps、allow_changeSpacePropsなどの推奨されるアクセス権(Permissions)をtrueに設定します。

5. ユーザーem_smf_adminを作成して、em_smf_admin_roleとしてロール・プロパティを設定します。

注意:
ユーザーem_smf_adminは、Oracle Enterprise Managerによって使用される専用のユーザーである必要があります。Oracleでは、他の目的のためにこのアカウントの共有をお薦めしていません。

Solaris File System (ZFS)ストレージ・サーバーの構成

この項の内容は次のとおりです。

- Solaris File System (ZFS)権限の取得

- Solaris File System (ZFS)ライセンスの取得

- Solaris File System (ZFS)ストレージ・サーバーの設定

Solaris File System (ZFS)権限の取得

Solaris File System (ZFS)では、権限(Privileges)をアクセス権(Permissions)と呼びます。Solaris File System (ZFS)ストレージ・サーバーの場合、スナップ・クローンを使用するには、プールに対する次のアクセス権をSolaris File System (ZFS)ユーザーに付与します。

- clone

- create

- destroy

- mount

- rename

- rollback

- share

- snapshot

- 割当て制限

- reservation

- sharenfs

- canmount

- recordsize

Solaris File System (ZFS)ライセンスの取得

Solaris File System (ZFS)は、特別なハードウェア・ライセンスを必要としません。Oracle Solaris OSバージョン11.1のみサポートされます。

Solaris File System (ZFS)ストレージ・サーバーの設定

Solaris File System (ZFS)ストレージ・サーバーは、任意のストレージ・ハードウェアと連携できます。追加のストレージ・ハードウェアを購入する必要はありません。かわりに、社内ストレージ・ハードウェアをアタッチし、Oracle Snap Clone機能を取得できます。たとえば、EMC VMAX、VNXシステム、Hitachi VSPまたはOracle Pillar Axiom FCアレイからLUNをアタッチできます。

次のストレージ・トポロジの図で、この動作方法について説明します。

注意:
この図では、Solaris File System (ZFS)ストレージ・サーバーに公開されたSANストレージ・デバイス(4 x 1TBの論理ユニット・デバイスを含む)が存在すると仮定します。

この項の内容は次のとおりです。

- Solaris File System (ZFS)ストレージ・サーバーの設定の前提条件

- ストレージ・エリア・ネットワーク・ストレージの要件

- Solaris File System (ZFS)プールの推奨事項

- Solaris File System (ZFS)のユーザーとプールの構成

Solaris File System (ZFS)ストレージ・サーバーの設定の前提条件

Solaris File System (ZFS)ストレージ・サーバーを構成する前に、次の要件を満たしていることを確認してください。

- zfs_arc_maxが/etc/systemに設定されていないことを確認します。これを設定する必要がある場合、必ず大きい値(RAMの80%など)に設定します。

- ストレージ・サーバーが複数のLUNで構成されていることを確認します。各LUNは、最大1TBである必要があります。スナップ・クローンでは、各1TBの2つ以上のLUNが推奨されます。各LUNは、フェイルオーバーを分離するため、異なるコントローラを経由してホストにマウントされたミラーLUNを持つ必要があります。LUNは、パフォーマンスを向上するためにファイバ・チャネルを介してSolarisホストにアタッチできます。

注意:
ファイバ・チャネルを使用できない場合、任意のDirect Attached StorageまたはiSCSIベースのLUNで十分です。

- プールで使用するLUNは、すべて同じサイズである必要があります。プールでは12個より少ないLUNを使用することをお薦めします。

- LUNとは別に、zpoolのパフォーマンスを向上するため、ストレージにはキャッシュ・デバイスとログ・デバイスが必要です。これら2つのデバイスは、別個のフラッシュ/SSDデバイスであれば理想的です。別個のデバイスを調達するのが難しい場合、1つのデバイスから分割したスライスを使用できます。ログ・デバイスは、サイズを約32GBとし、データ損失を避けるために冗長性および電源のバックアップを備える必要があります。キャッシュ・デバイスは、サイズを約128GBにすることが可能で、冗長性は必要ありません。

ストレージ・エリア・ネットワーク・ストレージの要件

ストレージ・エリア・ネットワーク(SAN)ストレージの要件は次のとおりです。

- 大きなLUNを作成し、LUNの数を少なくすることをお薦めします。LUNの推奨される最大サイズは、3TBです。

- LUNは、異なるSANストレージ・プールまたは完全に異なるSANストレージ・デバイスから取得する必要があります。
これらのLUNは、プール・レベルの冗長性を維持するため、ミラー化で必要とされます。SANストレージでハードウェア・レベルの冗長性を維持する場合、この要件は無視できます。

- LUNは、ファイバ・チャネルを介して公開する必要があります。

Solaris File System (ZFS)プールの推奨事項

Solarisファイルシステム(ZFS)のプールに関する推奨事項は次のとおりです。

- 同じサイズの複数のLUNを使用してストレージ・プールを作成します。使用状況に応じて、ストレージ・プールに別のディスクを追加してサイズを増加できます。

- Solaris File System (ZFS)ストレージ・サーバー上に作成するストレージ・プールでは、異なるSANストレージ・プールまたは完全に異なるSANストレージ・デバイスから取得したLUNを使用する必要があります。SANストレージでハードウェア・レベルの冗長性を維持する場合、これは無視できます。

- データの不整合を修復するには、基礎となるストレージ・デバイスでRAIDZが実装されているかどうかにかかわらず、ミラー、RAIDZ、RAIDZ-2、RAIDZ-3などのZFS冗長性を使用してデータの不整合を修復します。

- スループットとパフォーマンスを向上させるために、キャッシュ・デバイスとログ・デバイスを使用します。これら2つのデバイスは、別個のフラッシュ/SSDデバイスであれば理想的です。別個のデバイスを調達するのが難しい場合、1つのデバイスから分割したスライスを使用できます。
ログ・デバイスは、RAMの約50%とし、データ損失を避けるために冗長性および電源のバックアップを備えることをお薦めします。キャッシュ・デバイスのサイズは、ワークロードおよびプールのサイズを基準にできます。

キャッシュ・デバイスでは、冗長性はサポートされません。これはオプションです。

- プールは、作成時に、テスト・マスター・データベースとクローン・データベースを格納できるようにサイズを変更する必要があります。クローンは、同じストレージ・プール内の親データベースと共存します。そのため、テスト・マスターとクローンのための容量を十分に確保するよう計画する必要があります。
たとえば、テスト・マスターのサイズが1TBで、10個のクローンを作成する予定があり、そのそれぞれがテスト・マスターとは100G分異なるとします。この場合、ストレージ・プールのサイズは、2.5TB以上にする必要があります。

- ストレージ・プールには20%以上の空き領域を常に確保します。空き領域がこのレベルを下回ると、プールのパフォーマンスが低下します。

Solaris File System (ZFS)のユーザーとプールの構成

Enterprise Managerからストレージを管理できるユーザーを作成する必要があります。これを行うには、rootユーザーとして次のコマンドを実行します。

# /sbin/useradd -d /home/emzfsadm -s /bin/bash emzfsadm
# passwd emzfsadm

注意:
ユーザー名は8文字以下である必要があります。

ボリュームをホストするために使用するZFSプールを構成し、作成したユーザーにそのプールに対する権限を付与する必要があります。emzfsadmユーザーは、システムのすべてのzpoolとそのマウント・ポイントに対する権限を持っている必要があります。

ZFSプールを構成するには、次の表を参照して各コマンドを実行してください。

注意:
この表には、リファレンス実装が示されていますが、これは必要に応じて変更できます。

プール名

lunpool

ディスク(FC/iSCIを介したSAN公開LUN)

lun1=c9t5006016E3DE0340Ed0,
lun2=c9t5006016E3DE0340Ed1

ディスク・ミラー(FC/iSCIを介したSAN公開LUN)

mir1=c10t5006016E3DE0340Ed2,
mir2=c10t5006016E3DE0340Ed3

フラッシュ/SSDディスク(ログ)

ssd1=c4t0d0s0

フラッシュ/SSDディスク(キャッシュ)

ssd2=c4t0d1s0

# zpool create lunpool mirror lun1=c9t5006016E3DE0340Ed0 mir1=c10t5006016E3DE0340Ed2 mirror lun2=c9t5006016E3DE0340Ed1 mir2=c10t5006016E3DE0340Ed3 log ssd1=c4t0d0s0 cache ssd2=c4t0d1s0

書式例の出力は次のとおりです。

bash-4.1# /usr/sbin/format
Searching for disks...done

AVAILABLE DISK SELECTIONS:
0. c9t5006016E3DE0340Ed0 <DGC-VRAID-0532-1.00TB>
/pci@78,0/pci8086,3c08@3/pci10df,f100@0/fp@0,0/disk@w5006016e3de0340e,0
1. c9t5006016E3DE0340Ed1 <DGC-VRAID-0532-1.00TB>
/pci@78,0/pci8086,3c08@3/pci10df,f100@0/fp@0,0/disk@w5006016e3de0340e,1
2. c10t5006016E3DE0340Ed2 <DGC-VRAID-0532-1.00TB>
/pci@78,0/pci8086,3c08@3/pci10df,f100@0/fp@0,0/disk@w5006016e3de0340e,2
3. c10t5006016E3DE0340Ed3 <DGC-VRAID-0532-1.00TB>
/pci@78,0/pci8086,3c08@3/pci10df,f100@0/fp@0,0/disk@w5006016e3de0340e,3

[ We need to find the size of pool that was created ]
# df -k /lunpool
Filesystem           1024-blocks        Used   Available Capacity  Mounted on
lunpool              1434746880          31  1434746784     1%    /lunpool

[ We use the Available size shown here to set quota as shown below ]

# zfs set quota=1434746784 lunpool

# zfs allow emzfsadm clone,create,destroy,mount,rename,rollback,share,snapshot,quota,reservation,sharenfs,canmount,recordsize,logbias lunpool

# chmod A+user:emzfsadm:add_subdirectory:fd:allow /lunpool

# chmod A+user:emzfsadm:delete_child:fd:allow /lunpool

- コマンドzfs set quotaを使用して割当て制限を設定すると、次のエラー・メッセージが表示されることがあります。
Size is less than current used or reserved space 割当て制限が使用済領域より大きい値に設定されていることを確認してください。割当て制限が適切に設定されていることを確認するには、次のコマンドを実行して割当て制限を検証することをお薦めします。
$ zfs get quota lunpool

- zfs allow emzfsadmコマンドを実行した後に、すべての必須パラメータが適切に設定されているかどうかを確認することをお薦めします。

EMCストレージ・サーバーの構成

EMC Symmetrix VMAXファミリまたはEMC VNXストレージ・サーバーを使用する前に、まず、Oracle Enterprise Manager 12cでスナップ・クローンをサポートするためにEMCストレージ・ハードウェアを設定する必要があります。次の各項で、すべての要件が満たされていることを確認してください。

- EMCストレージ・サーバーでサポートされている構成

- EMC Symmetrix VMAXファミリおよびデータベース・サーバーの要件

- ストレージ・エリア・ネットワークの準備

- VMAXの用語の理解

- EMC VMAXストレージの準備

- EMC VNXストレージの準備

- データベース・サーバーの準備

- 特権ホストの監視資格証明の設定

EMCストレージ・サーバーでサポートされている構成

EMC Symmetrix VMAXファミリまたはEMC VNXストレージ・サーバーを構成する前に、次のリストを確認してください。このリストには、EMC VMAXストレージとEMC VNXストレージでサポートされているコンポーネントとサポートされていないコンポーネントが示されています。

- EMC VMAX 10KおよびVNX 5300の使用が認定されています。同じシリーズの上位モデルは動作することが予想されます。

- LinuxおよびSolarisオペレーティング・システムのみがサポートされています。それ以外のオペレーティング・システムはまだサポートされていません。

- マルチパスは必須です。

- EMC PowerPathとSolaris MPxIOのみがサポートされています。

- 切替えファブリックはサポートされています。調停ループはサポートされていません。

- Emulex (LPe12002-E)ホスト・バス・アダプタは、動作が確認されています。それ以外のアダプタは正常に機能すると予測されます。

- ファイバ・チャネルを介するSCSIはサポートされています。iSCSIとNASはまだサポートされていません。

- Oracle Grid Infrastructure 11.2はサポートされています。

- ローカルASMストレージ・オプションを設定したOracle Grid Infrastructure 12.1はサポートされています。Flex ASMはサポートされていません。

- ASMフィルタ・ドライバはサポートされません。

- ASMのサポートはRAWデバイスに対してのみです。ファイル・システムはサポートされていません。

- VMAXでのシン・ボリューム(TDEV)のサポート。

- VNXではLUNのみをサポート。NASはまだサポートされていません。

EMC Symmetrix VMAXファミリおよびデータベース・サーバーの要件

EMC Symmetrix VMAXファミリのオペレーティング・システム・バージョンの要件は次のとおりです。

- EMC VMAX Enginuityバージョン: 5876.251.161以上

- SMI-Sプロバイダのバージョン: V4.6.1.6以上

- Solutions Enablerのバージョン: V7.6-1755以上

注意:
EMC VMAX Enginuityのバージョンは、ストレージのオペレーティング・システムのバージョンです。
SMIプロバイダおよびSolutions Enablerは、SANのホストにインストールされます。

データベース・サーバーの要件は次のとおりです。

Oracle Databaseの要件

- Oracle Database 10.2.0.5以上

オペレーティング・システムの要件

- (RHEL 5 update 8と互換性のある) Oracle Linux 5 update 8以上

- (RHEL 6と互換性のある) Oracle Linux 6以上

- Oracle Solaris 10および11

マルチパスの要件

- EMC PowerPathバージョン5.6以上(Linuxオペレーティング・システム・リリースおよびカーネル・バージョンで使用可能)

- EMC PowerPathバージョン5.5以上(Oracle Solaris 11.1リリースで使用可能)

- EMC PowerPathバージョン6はサポートされていません。

- Solaris MPxIO (最新の更新で使用可能)

Oracle Grid Infrastructureの要件

- Oracle Grid Infrastructure 11.2

- Oracle Grid Infrastructure 12.1。Flex ASMはサポートされていません。

ストレージ・エリア・ネットワークの準備

ストレージ・エリア・ネットワークを準備するには、各項で説明されている構成手順に従います。

SANファブリックの構成

次のことを確認して、マルチパスを使用してSANファブリックを構成します。

- ストレージ・レベル、スイッチ・レベルおよびサーバー・レベルで冗長性が必要です。

- ストレージからサーバーへの複数のパスが構成されるようにゾーニングを実行します。

- ターゲット・ポートにおける障害、スイッチまたはホスト・バス・アダプタが原因でストレージLUNが使用不可能になることがないように、パスを構成します。

- EMC SMI-Sプロバイダがインストールされたホストで、Gatekeeperを構成します。ゲートキーパーを構成するには、EMC Webサイトで入手できるドキュメントを参照してください。

SMI-Sプロバイダ

SMI-SプロバイダおよびSolutions Enablerは、ストレージが構成されているファブリック内のサーバーの1つにインストールする必要があります。SMI-Sプロバイダをインストールおよび構成するには、EMC Webサイトで入手できるドキュメントを参照してください。

ストレージとの対話には、SMI-SプロバイダのURLおよびログイン資格証明が必要です。SMI-Sサービス・プロバイダのURLの例はhttps://rstx4100smis:5989です。

これらの詳細はストレージ・サーバーを登録するときに必要です。次の操作を実行する必要があります。

- VMAXストレージまたはVNXストレージがSMI-Sプロバイダによって検出されていることを確認します。

- VNXストレージをSMI-Sプロバイダに追加します。

- SMI-Sプロバイダで管理者権限を持つユーザー・アカウントを作成して、VMAXストレージまたはVNXストレージにアクセスします。

- 同期間隔を1時間に設定します。

VMAXの用語の理解

次の表は、この項で使用しているVMAX用語を概説しています。EMC VMAXストレージを準備する前に、これらの用語を参照して概念をよく理解しておいてください。

表12-2 VMAX用語

用語

定義

論理ユニット

I/Oデバイスは論理ユニットと呼ばれます。

論理ユニット番号

論理ユニットに関連付けられている一意のアドレス

イニシエータ

別の論理ユニットへのサービス・リクエストを開始する論理ユニットは、イニシエータと呼ばれます。

イニシエータ・グループ

イニシエータ・グループは、最大32個のファイバ・チャネル・イニシエータ(HBAポート)、8個のiSCSI名またはその両方の組合せの論理グループです。イニシエータ・グループには、別のイニシエータ・グループの名前を含めて、グループを深さ1にカスケードすることもできます。

ポート・グループ

ポート・グループは、ファイバ・チャネルまたはiSCSI、あるいはその両方のフロントエンド・ダイレクタ・ポートの論理グループです。ポート・グループ内のポート数に対する制限は、Symmetrixシステムのポート・グループ数のみです。ポート・グループには、ワークロードを特定のポートに分離するために使用可能なポートのサブセットを含められる可能性もあります。

注意: 前提条件として、OEMはORACLE_EM_PORT_GROUPという名前で作成されたポート・グループを期待し、必要なターゲット・ポートを含んでいる必要があります。

ストレージ・グループ

ストレージ・グループは、最大4,096台のSymmetrixデバイスの論理グループです。

ターゲット

サービス・リクエストのターゲットとなる論理ユニットは、ターゲットと呼ばれます。

マスキング・ビュー

マスキング・ビューは、1つのイニシエータ・グループ、1つのポート・グループおよび1つのストレージ・グループ間の関連付けを定義します。マスキング・ビューが作成されると、ストレージ・グループ内のデバイスはポート・グループ内のポートにマップされ、イニシエータ・グループ内のイニシエータにマスクされます。

SCSIコマンド

サービス・リクエストは、SCSIコマンドと呼ばれます。

ホスト・バス・アダプタ(HBA)

ホスト・バス・アダプタ(HBA)という用語は、ファイバ・チャネル・インタフェース・カードを表すために最もよく使用されます。各HBAには固有のWorld Wide Name (WWN)があります。これは、IEEEによって割り当てられたOUIを使用するという点で、Ethernet MACアドレスに似ています。ただし、WWNの方が長くなっています(8バイト)。HBAには2種類のWWNがあります。ホスト・バス・アダプタ上のすべてのポートによって共有されるノードWWN (WWNN)と、各ポートに固有のポートWWN (WWPN)です。様々な速度のHBAモデルがあります(1Gbit/s、2Gbit/s、4Gbit/s、8Gbit/s、10Gbit/s、16Gbit/sおよび20Gbit/s)。

VMAXストレージおよび用語の詳細は、EMC Webサイトで入手できるドキュメント「EMC Symmetrix VMAX Family with Enginuity」を参照してください。

EMC VMAXストレージの準備

データベースをプロビジョニングする必要のあるすべての必須ノードでゾーニングされるように、EMC VMAXアプライアンスを構成します。EMC VMAXストレージを準備するには、ストレージ・サーバーで次を実行します。

- すべてのホスト・イニシエータ・ポートがストレージ側から使用可能であることを確認します。

- ホストごとに対応するイニシエータを含むイニシエータ・グループを1つずつ作成して、セキュリティを強化することをお薦めします。イニシエータの直接の親イニシエータ・グループの「Consistent LUNs」プロパティを「No」に設定する必要があります

- Oracle Enterprise Managerでマスキング・ビューを作成するために使用されるORACLE_EM_PORT_GROUPという名前のポート・グループを作成します。このポート・グループには、Enterprise Manager Cloud Controlシステムに登録されたすべてのホストが集合的に参照するすべてのターゲット・ポートが含まれている必要があります。
たとえば、host1がストレージ・ポートP1およびP2を参照し、host2がストレージ・ポートP3およびP4を参照するとします。この場合、ORACLE_EM_PORT_GROUPには、P1、P2、P3およびP4のポート全部が含まれている必要があります。開発インフラストラクチャに必要なターゲット・ポートのみを含めてください。

- 別個の仮想プロビジョニング・プール(シン・プールとも呼ばれる)を作成し、それをOracle Enterprise Manager専用に使用します。

- VP Snapを実行するためにTimeFinderライセンスが有効になっていることを確認します。

EMC VNXストレージの準備

データベースをプロビジョニングする必要のあるすべての必須ノードでゾーニングされるように、EMC VNXアプライアンスを構成します。EMC VNXストレージを準備するには、ストレージ・サーバーで次を実行します。

注意:
EMC VNXストレージでは、LUNの作成、クローニングおよび削除のみがサポートされています。NASはサポートしていません。

- すべてのホスト・イニシエータ・ポートがストレージ側から使用可能であることを確認します。

- 1つのホストに属する複数のイニシエータがグループ化され、EMC VNXストレージのホストに基づく名前が付けられていることを確認します。

- Enterprise Managerに登録されているホストごとに、1つのホストを含むストレージ・グループを1つ作成します。
たとえば、イニシエータi1とi2がhost1に属する場合は、Host1という名前でイニシエータを登録します。新しいストレージ・グループSG1を作成し、Host1をそれに接続します。同様に、Enterprise Managerに追加するホストごとに、ストレージ・グループを1つ作成します。

データベース・サーバーの準備

Enterprise Managerスナップ・クローン用にサーバーを準備するには、次のことを確認してください。

- サーバーは物理サーバーであり、ホスト・バス・アダプタが搭載されている必要があります。NPIVおよびVMはサポートされません。

- サポートされている推奨マルチパス・ソフトウェアを使用してサーバーを構成します。EMC PowerPathを使用する場合は、PowerPathライセンスを有効にします。PowerPathライセンスを有効にするには、次のコマンドを使用します。

emcpreg -install

- サーバーでOracle Real Application Clustersをサポートする必要がある場合は、Oracle Clusterwareをインストールします。

注意:
ASMおよびクラスタウェアをインストールする必要があり、これらのコンポーネントをEnterprise Managerでターゲットとして検出する必要があります。ASMおよびクラスタウェアがインストールされたら、追加のASMディスク・グループをEnterprise Managerから作成できます。

- すべてのサーバーの特権ホスト監視資格証明を有効化します。サーバーがクラスタの一部である場合、そのクラスタの優先ホスト監視資格証明を有効化する必要があります。
優先ホスト監視資格証明の有効化の詳細は、『Oracle Enterprise Managerフレームワーク、ホストおよびサービス・メトリック・リファレンス・マニュアル』を参照してください。

- Linuxを使用している場合は、Oracle ASMLibを構成し、asm_diskstringパラメータを有効なASMパスに設定する必要があります。たとえば、次のようになります。
/dev/oracleasm/disks/

最初にASMLibサービス、次にマルチパス・サービスが実行されるように、ブート順序を更新します。

Oracle ASMLibをインストールするには、次のWebサイトを参照してください。

http://www.oracle.com/technetwork/server-storage/linux/install-082632.html">>http://www.oracle.com/technetwork/server-storage/linux/install-082632.html

マルチパス・ディスクでOracle ASMLibを構成するには、次のWebサイトを参照してください。

http://www.oracle.com/technetwork/server-storage/linux/multipath-097959.html">>http://www.oracle.com/technetwork/server-storage/linux/multipath-097959.html

特権ホストの監視資格証明の設定

ホスト監視資格証明を設定する前に、権限委任設定を設定する必要があります。次の手順を実行します。

注意:
これは、EMCストレージでスナップ・クローニング・データベースに使用されるホストでのみ必要です。

1. 「設定」メニューから、「セキュリティ」をクリックし、「監視資格証明」を選択します。

2. モニタリング資格証明ページで、要件に従って「クラスタ」または「ホスト」を選択し、「モニタリング資格証明の管理」をクリックします。

3. クラスタ・モニタリング資格証明ページで、クラスタまたはホストに対して設定された特権ホストのモニタリング資格証明を選択し、「資格証明の設定」をクリックします。

4. 表示されるダイアログ・ボックスで、資格証明を指定し、「保存」をクリックします。

5. ホスト監視資格証明がクラスタに対して設定された後で、クラスタ・メトリックをリフレッシュします。ホストに対して「ストレージ・エリア・ネットワーク」メトリックが収集されているかどうかを確認します。

12.7.3.2 ストレージ・プロキシ・エージェントのカスタマイズ

プロキシ・エージェントは、NetApp、Sun ZFSSAまたはSolaris File System (ZFS)のファイル・システムを登録するときに必要です。

NetAppストレージ・サーバーを登録する前に、次の前提条件を満たしてください。

- サード・パーティ・ライセンスの取得

- ストレージ・ベンダーSDKのアップロード

- デフォルトSDKのオーバーライド

- サード・パーティ・サーバー・コンポーネントのオーバーライド

注意:
ストレージ・プロキシ・エージェントは、Linux Intel x64プラットフォームでのみサポートされます。

サード・パーティ・ライセンスの取得

ストレージ管理フレームワークは、Linux x86-64ビット・プラットフォーム用にデフォルトで付属しており、次のサード・パーティ・モジュールに依存しています。

- ソースCPAN - CPANライセンス適用

- IO::Tty (バージョン1.10)

- XML::Simple (バージョン2.20)

- Net::SSLeay (バージョン 1.52)

- オープン・ソース - 所有者ライセンス適用

- OpenSSL (バージョン1.0.1e)

ストレージ・ベンダーSDKのアップロード

NetAppストレージ・サーバーを登録する前に、次の手順を実行します。

1. すべてのプラットフォーム用のNetApp Manageability SDKバージョン5.0R1を、NetAppサポート・サイト(http://support.netapp.com/NOW/cgi-bin/software">>http://support.netapp.com/NOW/cgi-bin/software)からダウンロードします。

2. 5.1 SDKを解凍して、Perl NetApp Data OnTap Client SDKをtarファイルとしてパッケージ化します。通常、lib/perl/NetAppフォルダにSDKがあります。tarファイルは、解凍すると、次のようになります。

NetApp.tar
- netapp
- Na  Element.pm
- NaServer.pm
- NaErrno.pm

たとえば、ソフトウェア・ライブラリ・エンティティStorage Management Framework Third Party/Storage/NetApp/defaultは、上のtar構造を使用したNetApp.tarを含む単一ファイル・エントリを持つ必要があります。

注意:
ファイル・パス名またはソフトウェア・ライブラリ名に余分なスペースがないことを確認します。

3. tarファイルの準備ができると、ソフトウェア・ライブラリに次のフォルダ構造が作成されます。Storage Management Framework Third Party/Storage/NetApp

4. defaultという名前の汎用コンポーネントとして、tarファイルをアップロードします。

注意:
tarファイルをアップロードするには、ソフトウェア・ライブラリ用にOMS共有ファイル・システムを使用する必要があります。

tarファイルは、メイン・ファイルとして、このdefaultソフトウェア・ライブラリ・エンティティにアップロードする必要があります。

デフォルトSDKのオーバーライド

default SDKは、すべてのNetAppストレージ・サーバーに使用されます。ただし、ストレージ・サーバーは、特定のSDKとのみ連携する場合があります。このような場合、SDKをアップロードしてこの特定のストレージ・サーバーにのみ使用して、ストレージ・サーバーごとにSDKをオーバーライドできます。

ストレージ・サーバーの既存のSDKをオーバーライドするには、tarファイルをソフトウェア・ライブラリ・エンティティにアップロードします。tarファイルは、前述の項の手順3に示された構造を持つ必要があります。

ソフトウェア・ライブラリ・エンティティ名は、ストレージ・サーバー名と同じにする必要があります。

たとえば、ストレージ・サーバー名がmynetapp.example.comの場合、ソフトウェア・ライブラリ・エンティティを次のようにする必要があります。

Storage Management Framework Third Party/Storage/NetApp/mynetapp.example.com

注意:
ストレージ固有のSDKは、default SDKより優先されます

サード・パーティ・サーバー・コンポーネントのオーバーライド

デフォルトでは、すべての必要なサード・パーティ・コンポーネントがLinux Intel 64ビット・プラットフォーム用に提供されます。オーバーライドする必要がある場合、次のようにtarファイルをパッケージ化します。

注意:
tarファイルは、次に示す構造にする必要があるthirdpartyフォルダを含む必要があります。

thirdparty
|-- lib
| |-- engines
| | |-- lib4758cca.so
| | |-- libaep.so
| | |-- libatalla.so
| | |-- libcapi.so
| | |-- libchil.so
| | |-- libcswift.so
| | |-- libgmp.so
| | |-- libgost.so
| | |-- libnuron.so
| | |-- libpadlock.so
| | |-- libsureware.so
| | `-- libubsec.so
| |-- libcrypto.a
| |-- libcrypto.so
| |-- libcrypto.so.1.0.0
| |-- libssl.a
| |-- libssl.so
| `-- libssl.so.1.0.0
`-- pm
|-- CPAN
| |-- IO
| | |-- Pty.pm
| | |-- Tty
| | | `-- Constant.pm
| | `-- Tty.pm
| |-- Net
| | |-- SSLeay
| | | `-- Handle.pm
| | `-- SSLeay.pm
| |-- XML
| | `-- Simple.pm
| `-- auto
| |-- IO
| | `-- Tty
| | |-- Tty.bs
| | `-- Tty.so
| `-- Net
| `-- SSLeay
| |-- SSLeay.bs
| |-- SSLeay.so

tarファイルがプラットフォーム名x86_64に基づいた名前のソフトウェア・ライブラリ・エンティティにアップロードされることを確認します。ソフトウェア・ライブラリ・エンティティは次の下にある必要があります。

Storage Management Framework Third Party/Server

x86_64エンティティは、処理するストレージ・サーバーに関係なくアップロード時にすべてのストレージ・プロキシ・ホストにコピーされます。特定のストレージ・プロキシ・エージェントでこのエンティティを使用するには、ホスト名に基づいてエンティティの名前を付けます。

たとえば、Storage Management Framework/Third Party/Server/x86_64は、x86_64プラットフォーム上のストレージ・プロキシ・ホストにコピーされます。同様に、Storage Management Framework Third Party/Server/myhost.example.comは、ストレージ・プロキシ・ホストとして使用する場合、myhost.example.comにのみコピーされます。

ホスト名は、プラットフォーム・プリファレンスより優先されます。

12.7.4 ストレージ・サーバーの登録

特定のストレージ・サーバーを登録するには、各項に記載されている次の手順に従います。

- NetAppまたはSun ZFSストレージ・サーバーの登録

- Solaris File System (ZFS)ストレージ・サーバーの登録

- EMCストレージ・サーバーの登録

12.7.4.1 NetAppまたはSun ZFSストレージ・サーバーの登録

ストレージ・サーバーを登録するには、次の手順に従ってください。

1. 「設定」メニューから、「プロビジョニングとパッチ適用」をクリックして、「ストレージ登録」を選択します。

2. 「ストレージ登録」ページの「記憶域」セクションで、「登録」をクリックし、登録するストレージ・サーバーに基づいて、「NetAppストレージ・アプライアンス」または「Sun ZFSストレージ・アプライアンス」を選択します。

注意:
「名前付き資格証明を使用できません。」メッセージが表示される場合は、資格証明が登録されていないか、資格証明が別のユーザーによって所有されています。

注意:
ストレージ登録を完了するには、EM_STORAGE_ADMINISTRATORロールが必要です。

3. NetAppまたはSun ZFSストレージの「登録」ページにある「記憶域」セクションで、次の手順を実行します。

- 「名前」フィールドにストレージ・サーバーの名前を入力します。名前が有効なホスト名で、空白や無効な文字が含まれていないことを確認してください。

- プロトコルを選択します。

注意:
NetAppストレージの場合、HTTPまたはHTTPSで接続します。Sun ZFSストレージの場合は、SSHで接続します。

- ストレージの資格証明を選択するか、緑のプラス記号をクリックして追加します。

注意:
これらの資格証明は、ストレージ(NetAppまたはSun ZFS) APIを実行するために、管理エージェントによって使用されます。
ユーザーが所有する資格証明のみが、ここに表示されます。

表示される表示ボックスに、ストレージ・サーバー名とパスワードを入力します。パスワードを確認し、「OK」をクリックします。

- ストレージ名の別名を入力します(オプション)。
ストレージ名の別名は小文字にする必要があります。

注意:
ストレージ名の別名は、ストレージのボリュームをマウントする際に使用された任意の名前です。
たとえば、IPアドレス、FQDN、DNS別名などです。

ストレージ別名は、ストレージのデータベース・ターゲットの識別に必要です。データベース・ターゲットは、マウント・ポイントとデータベースで使用されるファイルをマッピングして識別されます。たとえば、ストレージmystorage.comが別名mystorage.netを持ち、データベースがmystorage.net:/u01としてマウントされているデータ・ファイルを使用する場合、検出を有効にするため、mystorage.netを別名として追加する必要があります。

ストレージを登録する場合、管理インタフェースをストレージ名として使用します。ストレージ別名セクションで、データ・インタフェースをリストします。登録されたストレージ名は登録操作を実行するために使用され、ターゲット・ホストにボリュームをマウントしているときは、ストレージ別名としてリストされているインタフェースを優先します。

4. ストレージを管理するエージェント・セクションで、次の手順を実行します。

- 「追加」をクリックして、管理エージェント・ホストを追加します。ストレージ・エージェント表示ボックスが表示されます。表の「ターゲット名」列から管理エージェントを選択します。次に、「選択」をクリックします。

注意:
管理エージェント・リストには、Linux X64管理エージェントのみが表示されます。

選択された管理エージェントは、ストレージ・サーバーでの操作の実行に使用されます。

- 管理エージェントを選択すると、管理エージェント資格証明が検索され、ホストの名前付き資格証明が表示されます。

注意:
管理エージェント資格証明は、Oracle Management Serviceから管理エージェントに接続する際に使用されます。

複数の管理エージェントを構成して、ストレージ・デバイスを監視できます。必要な場合は、「追加」をクリックして、2つ目の管理エージェントを選択します。

注意:
ストレージ・デバイスを監視するために複数の管理エージェントを構成しておくと、ホストが停止した場合や管理エージェントがブラックアウト中の場合に、バックアップとして機能します。

- 「発行」をクリックし、ストレージ・サーバーを登録します。

12.7.4.2 Solaris File System (ZFS)ストレージ・サーバーの登録

ストレージ・サーバーを登録するには、次の手順に従ってください。

1. 「設定」メニューから、「プロビジョニングとパッチ適用」をクリックして、「ストレージ登録」を選択します。

2. 「ストレージ登録」ページの「記憶域」セクションで、「登録」をクリックし、次に「Solarisファイルシステム(ZFS)」を選択します。

注意:
「名前付き資格証明を使用できません。」メッセージが表示される場合は、資格証明が登録されていないか、資格証明が別のユーザーによって所有されています。

注意:
ストレージ登録を完了するには、EM_STORAGE_ADMINISTRATORロールが必要です。

3. 「ファイル・システム(ZFS)の登録」ページの「記憶域」セクションで、次の操作を実行します。

- 「名前」フィールドに、Solarisシステム名を入力します。名前が有効なホスト名またはIPアドレスで、空白や無効な文字が含まれていないことを確認してください。

- プロトコルを選択します。

- ストレージの資格証明を選択するか、緑のプラス記号をクリックして追加します。

注意:
これらの資格証明は、Solarisファイル・システムAPIを実行するために、管理エージェントによって使用されます。
ユーザーが所有する資格証明のみが、ここに表示されます。

表示される表示ボックスに、ストレージ・サーバー名とパスワードを入力します。パスワードを確認し、「OK」をクリックします。

- ストレージ名の別名を入力します(オプション)。
ストレージ名の別名は小文字にする必要があります。

注意:
ストレージ名の別名は、ストレージのボリュームをマウントする際に使用された任意の名前です。
たとえば、IPアドレス、FQDN、DNS別名などです。

ストレージ別名は、ストレージのデータベース・ターゲットの識別に必要です。データベース・ターゲットは、マウント・ポイントとデータベースで使用されるファイルをマッピングして識別されます。たとえば、ストレージmystorage.comが別名mystorage.netを持ち、データベースがmystorage.net:/u01としてマウントされているデータ・ファイルを使用する場合、検出を有効にするため、mystorage.netを別名として追加する必要があります。

ストレージを登録する場合、管理インタフェースをストレージ名として使用します。ストレージ別名セクションで、データ・インタフェースをリストします。登録されたストレージ名は登録操作を実行するために使用され、ターゲット・ホストにボリュームをマウントしているときは、ストレージ別名としてリストされているインタフェースを優先します。

4. 「スケジュールの同期」セクションで、ストレージ詳細をハードウェアと同期する頻度を指定します。
「発行」をクリックする前に、zpoolの設定が完了していることを確認します。zpoolを設定するには、「Solaris File System (ZFS)のユーザーとプールの構成」を参照してください。

12.7.4.3 EMCストレージ・サーバーの登録

ストレージ・サーバーを登録するには、次の手順に従ってください。

注意:
EMCストレージ・サーバーを登録する前に、ストレージ・サーバーを準備する必要があります。ストレージ・サーバーを準備するには、「EMCストレージ・サーバーの構成」を参照してください。

1. 「設定」メニューから、「プロビジョニングとパッチ適用」をクリックして、「ストレージ登録」を選択します。

2. 「ストレージ登録」ページの「記憶域」セクションで、「登録」をクリックし、「EMCストレージ・アプライアンス」を選択します。

注意:
「名前付き資格証明を使用できません。」メッセージが表示される場合は、資格証明が登録されていないか、資格証明が別のユーザーによって所有されています。

注意:
ストレージ登録を完了するには、EM_STORAGE_ADMINISTRATORロールが必要です。

3. 「EMCストレージ・アプライアンスの登録」ページの「記憶域」セクションで、次の操作を実行します。

- 「名前」フィールドで、ストレージ・サーバー名を指定します。名前が有効なストレージ名であり、空白や無効な文字が含まれていないことを確認してください。

- EMCストレージの場合、接続にSMI-Sプロトコルを使用します。「SMI-SプロバイダのURL」を指定します。

- 「SMI-Sユーザー資格証明」を指定するか、緑色の+記号をクリックして追加します。

注意:
これらの資格証明は、Enterprise ManagerがEMCストレージ・アプライアンスと対話するために使用されます。
ストレージの資格証明ではなく、SMI-Sプロバイダの管理者の資格証明である必要があります。

ユーザーが所有する資格証明のみが、ここに表示されます。

表示される表示ボックスに、SMI-Sユーザーの名前とパスワードを入力します。パスワードを確認し、「OK」をクリックします。

4. 「スケジュールの同期」セクションで、ストレージ詳細をハードウェアと同期する頻度を指定します。

「発行」をクリックします。

12.7.5 ストレージ・サーバーの管理

ストレージ・サーバーを管理するには、次の項を参照してください。

- ストレージ・サーバーの同期

- ストレージ・サーバーの登録解除

12.7.5.1 ストレージ・サーバーの同期

初めてストレージ・サーバーを登録する際は、同期ジョブが自動的に実行されます。ただし、新しい変更または作成を検出するには、同期ジョブをスケジュールして、スナップ・クローン・アクションが進行中でない静止している期間のスケジュール時間に実行する必要があります。これを実行するには、次の手順に従います。

1. ストレージ登録ページにある「記憶域」セクションで、「同期」をクリックします。

注意:
「同期」をクリックすると、スナップ・クローンに使用可能なEnterprise Manager Cloud Controlによって監視されているすべてのデータベースを検出するデプロイメント・プロシージャが発行されます。
ストレージ検出の一部としてWindowsデータベースは検出されません。これは、WindowsストレージNFSコレクションがまったく発生しないためです。詳細は、MOSノート465472.1を参照してください

ストレージを同期できるようにするには、ストレージ・サーバーおよびストレージ管理エージェント資格証明に、GET_CREDENTIAL権限とともにEM_STORAGE_OPERATORロールが必要です。

2. 「確認」ボックスが表示されます。「OK」をクリックします。

このアクションでは、1回の同期ジョブが発行されます。

注意:
同期ジョブは、最新のストレージ情報をフェッチし、ストレージ・ボリュームおよびデータベース間のマッピングを再計算します。

3. ストレージ登録ページにある「記憶域」セクションで、管理エージェント・ホストのプロシージャ詳細を表示して、「ステータス」列の値(「スケジュール済」など)をクリックします。

4. 「プロビジョニング」ページの「プロシージャ・ステップ」セクションで、「表示」をクリックして、「すべて開く」を選択します。進行状況に合せてプロシージャ・アクティビティを表示するには、ページの「リフレッシュ」ボタンを繰り返しクリックします。

ストレージ登録ページの管理エージェントの同期ステータスは、同期処理が完了すると、「成功」に変更されます。

5. 登録されたストレージ・サーバーの同期スケジュールを更新するには、「ストレージ登録」ページのストレージ・サーバーを選択して、「編集」をクリックします。ストレージの編集ページにある「ストレージの同期」セクションで、同期ジョブの繰返し時間および頻度を編集します。

注意:
同期ジョブの頻度は、デフォルトで3時間に設定されています。

「発行」をクリックします。

注意:
「ストレージ・ボリュームをターゲットと関連付け中」ステップは、データベース・ターゲット・メトリックおよびホスト・メトリックの両方に依存します。データベース・ターゲット(oracle_database/rac_database)は、制御ファイル、データファイルおよびREDOログの最新のメトリックを持つ必要があります。ファイル・システム・メトリックは、データベースを実行しているホストに対して最新である必要があります。

12.7.5.2 ストレージ・サーバーの登録解除

登録されたストレージ・サーバーを登録解除するには、次の手順を実行します。

注意:
ストレージ・サーバーを登録解除するには、ストレージ・サーバーの同期化GUIDでのFULL_JOB権限とともに、ストレージでのFULL_STORAGE権限が必要です。

1. 「設定」メニューから、「プロビジョニングとパッチ適用」をクリックして、「ストレージ登録」を選択します。

2. 「ストレージ登録」ページにある「記憶域」セクションで、登録されたストレージ・サーバーのリストからストレージ・サーバーを選択します。

3. 「削除」を選択します。
ストレージの削除ページで、登録解除するストレージ・サーバーを選択し、「発行」をクリックします。

ストレージ・サーバーが登録解除されます。

注意:
ストレージが登録解除されると、ストレージ上のスナップ・クローン・プロファイルおよびサービス・テンプレートは機能しなくなり、これらのプロファイル、サービス・テンプレートおよびスナップ・クローンされたターゲットの間の関係が失われます。

注意:
ストレージを登録解除する前に、Enterprise Managerを使用して作成したボリュームを削除することをお勧めします。セルフ・サービス・ユーザーとして、クローニングされたデータベースの削除リクエストを発行する必要があります。
これらの削除リクエストを発行するには、ストレージ登録ページの「階層」タブから「削除」をクリックして、テスト・マスター・データベースをホストするためにEnterprise Managerによって作成されたボリュームを削除します。

12.7.6 ストレージ・サーバーの管理

ストレージ・サーバーを管理するには、次の項を参照してください。

- ストレージ割当ての管理

- ストレージのアクセス権限の管理

- ストレージ登録の概要と階層の表示

- ストレージ・サーバーの編集

12.7.6.1 ストレージ割当ての管理

次のタスクを実行することで、ストレージ割当てを管理できます。

- ストレージ上限の編集

- ストレージ・ボリュームの作成

- データベースのボリュームのサイズ変更

- シン・ボリュームの作成(EMCストレージ・サーバーの場合)

- EMCストレージ・サーバーの領域使用率について

ストレージ上限の編集

ストレージ上限は、Enterprise Managerで使用できるプロジェクト、集計またはシン・プールのストレージの最大量です。これにより、この制限に到達するまで、Enterprise Managerでは、そのプロジェクトのみでクローンを作成することが確認されます。ストレージ・プロジェクトが最初に検出されると、プロジェクトの全体容量は、この上限に設定されます。Sun ZFSの場合、プロジェクトに設定される割当てが使用されます。

注意:
ストレージ終了時に、Sun ZFSストレージ・プロジェクトに対して明示的に割当て制限プロパティを設定する必要があります。また、ストレージ終了時に、プロジェクトにはゼロ以外の割当て制限セットを持つ必要があります。それ以外の場合、Enterprise Managerでは、そこでクローニングできません。

ストレージ上限を編集するには、次の手順を実行します。

1. 「ストレージ登録」ページにある「記憶域」セクションで、ストレージ上限を編集するストレージ・サーバーを選択します。

2. 「内容」タブで、集計を選択し、「ストレージ上限の編集」をクリックします。

注意:
ストレージの上限の編集オプションを使用すると、Enterprise Managerで使用できるストレージの最大量を変更できます。この制限に達するまでの範囲でのみ、クローンの作成やボリュームのサイズ変更を行うことができます。

3. ストレージの上限の編集ダイアログ・ボックスに、ストレージの上限を入力し、「OK」をクリックします。

ストレージ・ボリュームの作成

ストレージ・ボリュームを作成するには、次の手順に従います。

1. 「ストレージ登録」ページにある「記憶域」セクションで、ストレージ・ボリュームを作成するストレージ・サーバーを選択します。

2. 「内容」タブを選択し、集計を選択して、「記憶域ボリュームの作成」を選択します。

3. 記憶域ボリュームの作成ページの「ストレージ・ボリューム詳細」セクションで、「追加」をクリックします。

4. ストレージを選択し、サイズをGB単位で指定します(サイズはストレージ・サイズを超えないようにしてください)。指定したサイズで、ストレージ・サイズ全体を使い果たすことなく、テスト・マスター・データベースのサイズを収容できる必要があります。
次に、/で始まるマウント・ポイントを指定します。

For example,
If the storage is "lunpool", select the "lunpool".
The specified size under the size column should not exceed the storage space. If the size of the "lunpool" is 100GB and the test master database is 10 GB, then specify size as 10GB.
The mount point should be a meaningful mount point starting with "/".
For example: /oracle/oradata

5. 「ホスト詳細」セクションで、次の内容を指定します:

- ホスト資格証明: Oracleソフトウェアのターゲット・ホスト資格証明を指定します。

- ストレージ目標: スナップ・クローンを使用する場合、最も重要なオプションは次のとおりです:

- RAC用のOracleデータファイル

- 単一インスタンス用のOracleデータファイル

注意:
OCRおよび投票ディスクとOracleバイナリをストレージ・ボリュームに格納することもできます。

- プラットフォーム: サポートされるターゲット・プラットフォームを選択します。ボリュームは、サポートされるターゲット・プラットフォーム上にマウントされます。

- マウント・オプション: 「マウント・オプション」フィールドは、ストレージ目標およびプラットフォームとして指定した値に基づいて自動的に入力されます。マウント・オプションは編集しないでください。

- NFS v3またはNFS v4を選択します。

6. 「追加」をクリックして、マウント操作を実行するホストを1つ以上選択します。
RAC用のOracleデータファイルを選択した場合、通常は複数のホストを指定します。そうすると、プロシージャ・アクティビティの完了後、指定したホストにボリュームが自動的にマウントされます。

7. 「発行」をクリックします。
「発行」をクリックすると、プロシージャ・アクティビティが実行されます。プロシージャ・アクティビティの完了とともに、ボリュームがターゲット・システムにマウントされます。これで、ターゲット・システムにマウントされたボリュームへのテスト・マスター・データベースの作成に進むことができます。

データベースのボリュームのサイズ変更

データベースのいずれかのボリュームの領域が不足している場合は、要件に応じてボリュームをサイズ変更できます。クローンのボリュームをサイズ変更するには、次の手順に従います。

注意:
これは、EMCストレージ・サーバーでは使用できません。

注意:
テスト・マスター・データベースのボリュームのサイズ変更は、テスト・マスターのボリュームがUI「ボリュームの作成」を使用して作成されている場合を除き、Enterprise Managerを使用して実行できません。

注意:
データベースまたはクローンのボリュームをサイズ変更するにはFULL_STORAGE権限が必要です。また、基礎となるストレージがボリュームの割当て制限管理をサポートしていることを確認してください。

1. 「ストレージ登録」ページの「ストレージ」セクションで、必要なストレージ・サーバーを選択します。

2. 「詳細」セクションで、「階層」タブを選択し、ターゲットを選択します。
「ストレージ・ボリューム詳細」表には、ターゲットのボリュームの詳細が表示されます。これにより、領域が不足しているターゲットのボリュームを識別できます。

3. 「ボリューム詳細」表で、「サイズ変更」を選択します。

4. ストレージ・ボリュームのサイズ変更ページで、サイズ変更する1つまたは複数のボリュームの「新規の書込み領域」を指定します。ボリュームのサイズを変更しない場合は、「新規の書込み領域」フィールドを空白のままにできます。

5. 即時または後で実行するようサイズ変更をスケジュールできます。

6. 「発行」をクリックします。

注意:
「プロシージャ・アクティビティ」タブからサイズ変更プロシージャを監視できます。

シン・ボリュームの作成

この項は、EMC Symmetrix VMAXファミリおよびEMC VNXストレージのみに適用されます。

EMC Symmetrix VMAXファミリまたはEMC VNXストレージを使用すると、シン・ボリュームを作成し、作成したシン・ボリュームからASMディスクを作成できます。EMC Symmetrix VMAXファミリまたはEMC VNXストレージでシン・ボリュームを作成するには、次の手順に従います。

注意:
Enterprise Managerでは、クラスタウェアとASMコンポーネントのインストール後に、シン・プールからシン・ボリュームを作成できます。
クラスタウェアとASMコンポーネントのインストール後に、asm_diskstringパラメータがNULLに設定されることがあります。これにより、シン・プールの作成中に障害が発生する可能性があります。

この発生を防ぐには、asm_diskstringパラメータに有効なディスク・パスを設定し、ASMインスタンスを再起動します。

たとえば、asm_diskstringパラメータを次のように設定します。

/dev/oracleasm/disks/*

1. 「ストレージ登録」ページの「記憶域」セクションで、シン・ボリュームを作成するEMC Symmetrix VMAXファミリまたはEMX VNXストレージを選択します。

2. 「詳細」セクションで、「内容」タブを選択し、「シン・ボリュームの作成」を選択します。

3. 「記憶域詳細」セクションでは、「ASMディスク・グループ」はデフォルトで「外部冗長性を設定して作成」に設定されています。ASMディスク・グループの作成はオプションです。冗長性を持たせてASMディスク・グループを作成する場合は、ここでは次を選択して、この手順を省略できます。作成しないでください。後で作成します。後で、Oracle Enterprise Manager ASMターゲット・ホームページまたはASM構成アシスタントを使用して作成できます。

4. 「追加」をクリックして同じサイズのLUNを複数作成し、それらのボリュームを使用してASMディスク・グループを作成します。一度に1つ以上のディスク・グループを作成できます。

5. シン・プール/記憶域プールを選択し、シン・ボリュームの数およびシン・ボリュームのサイズを指定します。

注意:
より大きなLUNを作成し、LUNの数を少なくすることをお薦めします。
たとえば、200 GBのサイズのディスク・グループが必要な場合は、200 GBのサイズのLUNを1つ作成し、そこからディスク・グループを作成します。10個の20 GB LUNは作成しないでください。

注意:
240 GBを超えるサイズのシン・ボリュームは、VMAXストレージ上でデフォルトでは許可されません。240 GBを超えるサイズのシン・ボリュームを作成するには、ストレージ管理者に、VMAX上で自動メタを有効にするようリクエストします。ストレージ管理者は、この制限を除去するか、240 GB.未満のサイズのシン・ボリュームを複数作成できます。
240 GBを超えるサイズのLUNを作成するには、ストレージ管理者に連絡して、自動メタを有効にします。

2 TBを超えるサイズのLUNは作成しないでください。

6. 「ホスト詳細」セクションで、ホストまたはクラスタを指定するか、「検索」アイコンをクリックして選択します。ディスクは、このホストまたはクラスタに存在するASMインスタンス上に作成されます。存在するすべてのディスクに、1つのディスク・パーティションが作成されます。

注意:
LinuxおよびSolarisのホストのみがサポートされています。

7. ルートおよびグリッド・インフラストラクチャ資格証明を指定します。自分が所有する資格証明のみがリストされます。

「発行」をクリックします。

注意:
「ターゲットの作成」リクエストに成功し、ディスクグループが作成された後で、ディスクグループにインストールするデータベースのバージョンに応じてcompatible.asmおよびcompatible.rdbmsにディスクグループの属性を手動で設定する必要があります。

EMCストレージ・サーバーの領域使用率について

EMCストレージ・サーバーの書込み可能領域の実装は、NetApp、Sun ZFS SAおよびSun ZFSストレージ・サーバーと異なります。NetApp、Sun ZFS SAおよびSun ZFSストレージ・サーバーでは、サービス・テンプレートで定義される書込み領域は、データがボリュームに書き込まれない場合でもストレージ・プールからクローン・データベースに割り当てられます。EMCストレージ・サーバー(VMAXおよびVNX)では、領域はストレージ・プールに予約のみされます。領域は、データがボリュームまたはLUNに書き込まれるときにのみ消費されます。

たとえば、サービス・テンプレートで10GBの書込み可能領域を定義する場合、NetApp、Sun ZFS SAおよびSun ZFSでは、データがボリュームに書き込まれない場合でもストレージ・プールからクローン・データベースに10GBの領域が割り当てられます。EMCストレージでは、領域は、データがボリュームまたはLUNに書き込まれるときにのみ消費されます。

Enterprise Managerで、ストレージ・プールに対して定義された最大サイズまでシン・ボリューム(ASMディスク・グループ/LUN)を作成するには、ストレージ登録ページの「内容」タブを選択し、「シン・ボリュームの作成」を選択します。テスト・マスター・データベースは、ASMディスク・グループまたはLUNに作成できます。

次のグラフィックは、テスト・マスター・データベースおよび作成されたクローン・データベースを示します。

次のグラフィックは、テスト・マスター・データベースのストレージ・ボリュームを示します。

次のグラフィックは、クローン・データベースのストレージ・ボリュームを示します。

注意:
説明したように、ASMディスク・グループは、「シン・ボリュームの作成」オプションを使用して作成できます。ただし、他の方法を使用して作成することもできます。次の例は、EMC VMAXおよびVNXストレージ・サーバーの領域使用状況を示しています。
ストレージ・プールのサイズが1 TBで、「ストレージ上限」が1 TBに設定されているとします。

シナリオ1:

Enterprise Managerストレージ管理者が2個のASMディスク・グループを作成した場合、たとえば、「シン・ボリュームの作成」手法と「テスト・マスター・データベース」手法を使用してそれぞれサイズが125 GBおよび75 GBのDATAおよびREDOがそれらのディスク・グループに作成され、DATAおよびREDOディスク・グループで使用される領域がそれぞれ100 GBおよび50 GB (DATAおよびREDOディスク・グループ上の残りの空き領域は25 GB)の場合、セルフ・サービス・ユーザーが作成する各クローン・データベースには、DATAおよびREDOディスク・グループ上の25 GBの書込み可能領域が割り当てられます。

クローン・データベースに書き込まれる新規データは、実際に使用される領域であり、各ディスク・グループで最大25 GBに増加することがあります。このシナリオではDATAおよびREDOディスク・グループです。

クローン・データベースが200 GBのテスト・マスター・データベースから作成されると想定した場合、Enterprise Managerストレージ管理者は、「シン・ボリュームの作成」手法を使用して600 GBのLUNを作成できます。クローン・データベースのサイズも使用可能領域から差し引かれます。セルフ・サービス・ユーザーは、複数のクローンを作成できます。作成できるクローン・データベースの数は、そのストレージ・プール内の初期クローン・データベースに書き込まれる新規データの量に依存するため、見積もることができません。

シナリオ2:

Enterprise Managerストレージ管理者が2個のASMディスク・グループを作成した場合、たとえば、「シン・ボリュームの作成」手法と「テスト・マスター・データベース」手法を使用してそれぞれサイズが850 GBおよび150 GBのDATAおよびREDOがそれらのASMディスク・グループに作成され、DATAおよびREDOディスク・グループで使用される領域がそれぞれ750 GBおよび50 GB (DATAおよびREDO上の残りの空き領域は100 GB)の場合、セルフ・サービス・ユーザーが作成する各クローン・データベースには、DATAおよびREDOディスク・グループ上の100 GBの書込み可能領域が割り当てられます。

クローン・データベースに書き込まれる新規データは、実際に使用される領域であり、各ディスク・グループで最大100 GBに増加することがあります。このシナリオではDATAおよびREDOディスク・グループです。

シナリオ1と同様に、セルフ・サービス・ユーザーは複数のクローンを作成できますが、クローン・データベース数は見積もることができません。Enterprise Managerストレージ管理者は、シナリオ2で追加のディスク・グループを作成できません。これは、シナリオ1と比較した場合の大きな違いです。

どちらのシナリオでも、クローンに実際に使用される領域は、「ストレージ上限」から引かれます。書込み可能ディスク領域の一般的な計算式は、LUNサイズとデータが実際に占める領域の差です。

12.7.6.2 ストレージのアクセス権限の管理

登録されたストレージ・サーバーのストレージ・アクセス権限を管理するには、次の手順を実行します。

1. 「ストレージ登録」ページにある「記憶域」セクションで、登録されたストレージ・サーバーのリストからストレージ・サーバーを選択します。

注意:
ストレージ登録ページには、VIEW_STORAGE権限を持つデータベースのみが表示されます。

2. 「アクセスの管理」をクリックします。

3. 「アクセスの管理」ページで、次の手順を実行します。

- 登録されたストレージ・サーバーの所有者を変更する必要がある場合は、「変更」をクリックします。

注意:
登録されたストレージ・サーバーの所有者は、ストレージ・サーバーのすべてのアクションを実行して、権限およびロールを他の管理者に付与できます。

- 「権限の追加」をクリックして、管理者、ロールまたは両方に権限を付与します。

- 「権限の追加」ページで、管理者名を入力するか、タイプを選択して、「実行」をクリックします。

- 管理者またはロールのリストから管理者を選択して、「選択」をクリックします。

4. 「アクセスの管理」ページで、「権限受領者」列から管理者またはロールを選択し、「権限の変更」をクリックして、管理者またはロールの権限を変更できます。

5. 「権限の変更」ダイアログ・ボックスで、次の3つの権限のいずれかを選択できます。

- ストレージの表示(ストレージを表示する機能)

- ストレージの管理(ストレージを編集する機能)

- フル・ストレージ(ストレージを編集または削除する機能)

「OK」をクリックします。

6. 「権限受領者」列から管理者を選択し、「権限の取消し」をクリックして、管理者への付与を取り消すこともできます。

7. 管理者またはロールへの権限の付与、取消しまたは変更を完了したら、「発行」をクリックします。

注意:
ストレージ・サーバーを使用できるようにするには、ユーザーへのストレージ・サーバーおよびストレージ管理エージェント資格証明に、具体的に権限を付与する必要もあります。

12.7.6.3 ストレージ登録の概要と階層の表示

ストレージ登録の概要を表示するには、ストレージ登録ページの「詳細」セクションで、「概要」タブを選択します。「概要」には、ストレージ使用状況の概要が表示されます。また、「スナップ・クローンのストレージ保存」グラフが表示され、データベースをスナップ・クローンとして作成した場合とスナップ・クローンを使用しない場合を比較して、節約された領域の合計が示されます。

注意:
スペース・ギャランティが設定されていないNetAppボリュームがある場合、「概要」タブには負の値の割当て領域が表示されます。ギャランティを「ボリュームギャランティ」に設定して、このことを回避します。

ストレージ登録の階層を表示するには、ストレージ登録ページの「詳細」セクションで、「階層」タブを選択します。ここには、次の間のストレージの関係が表示されます。

- テスト・マスター・データベース

- データベース・プロファイル

- スナップ・クローン・データベース

- スナップ・クローン・データベース・スナップショット

任意の行を選択すると、対応するボリュームまたはスナップショットの詳細が表示されます。

データベース・プロファイルまたはスナップ・クローン・データベースの作成に失敗し、エンティティをそれぞれのユーザー・インタフェースから削除できない場合、「削除」ボタンをクリックして記憶域の管理ページにアクセスします。このページから、ボリュームをマウント解除して、作成されたスナップショットまたはボリュームを不完全なデータベース・プロファイルまたはスナップ・クローン・データベースから削除するプロシージャを送信できます。

注意:
記憶域の管理ページでは、ストレージ・エンティティのクリーンアップのみが処理され、データベース・プロファイルまたはターゲット情報はリポジトリから削除されません。
「削除」ボタンは、FULL_STORAGE権限がある場合にのみ有効になります。

右パネルの「プロシージャ・アクティビティ」タブを選択して、該当ストレージ・エンティティに対して実行されるすべてのストレージ関連プロシージャを表示することもできます。

NFSエクスポートを表示するには、「ボリューム詳細」タブを選択します。「表示」、「列」、NFSエクスポートの順に選択します。

「階層」タブの下の「ボリューム詳細」タブには「同期」ボタンもあります。これにより、同期ターゲット・デプロイメント・プロシージャを発行できます。デプロイメント・プロシージャは、特定のターゲットとそのホストのメトリックの収集、ターゲットで使用されるボリュームの判断、最新情報の収集およびストレージ登録データ・モデルの更新を行います。ターゲットが最後に変更されたとき、データ・ファイルが別の場所に追加されたときなどに使用できます。

12.7.6.4 ストレージ・サーバーの編集

ストレージ・サーバーを編集するには、「ストレージ登録」ページでストレージ・サーバーを選択し、「編集」をクリックします。ストレージ編集ページで、次の操作を実行できます。

- 別名の追加または削除。

- ストレージ・サーバーに対して操作を実行するために使用できるエージェントの追加、削除または選択。

- ストレージ詳細をハードウェアと同期化する頻度の指定。

注意:
ストレージ・サーバーを編集するための資格証明を所有していない場合、「資格証明のオーバーライド」チェック・ボックスが「ストレージ」および「ストレージを管理するエージェント」セクションに表示されます。チェック・ボックスを選択して、同じ資格証明を使用するか、資格証明をオーバーライドするかを選択できます。

13 MWaaSクラウドの設定

この章では、WebLogic as a Service、SOA as a ServiceおよびOSB as a Serviceを含むMiddleware as a Serviceクラウドを設定および有効化するために必要な初期構成について説明します。内容は次のとおりです。

- Middleware as a Serviceについて

- このリリースの新しい機能と強化

- Middleware as a Serviceの開始

13.1 Middleware as a Serviceについて

Oracle Middleware as a Service (MWaaS)サービス・ファミリには、次のものが含まれます。

- WebLogic as a Service (WLaaS)

- SOA as a Service (SOaaS)

- Service Bus as a Service (SBaaS)

- Javaアプリケーション・サービス(JVMaaS)

Oracle Enterprise Manager Cloud Control 12cでは、プライベートMWaaS環境を作成、監視および管理するための単一の管理ツールが提供されます。MWaaSでは、アプリケーション・ホスティング、永続ストア、アプリケーション統合、および、アプリケーションが必要とする追加のコンピューティング・サービスにプログラムによってアクセスできるAPIなどのサービスを含む、エンタープライズ・クラスのアプリケーションをデプロイおよび実行する際に必要なすべてのサービスから構成される、完全なランタイム環境が提供されます。MWaaSによって、開発者は、基礎となるハードウェア・コンポーネントおよびソフトウェア・コンポーネントの複雑さを処理する必要なく、アプリケーションのデプロイメントが容易になり、これにより、コストが低くなり、納期までの時間が短くなります。

Middleware as a Serviceは次のものを提供します。

- ミドルウェア・サービスをプロビジョニングできる共有された統合プラットフォーム。

- アプリケーションをデプロイおよび管理するためのセルフ・サービス・モデル。

- Database as a Service (DBaaS)やJava Diagnostics as a Service (JDaaS)などの他のサービスとのシームレスな統合。

- リソースを手動でおよびポリシーに基づいてスケール・アップおよびスケール・ダウンする機能。

- プラットフォームの使用状況および基礎となるインフラストラクチャに基づくメータリングおよびチャージバック。

13.2 このリリースの新しい機能と強化

次の拡張機能は、このリリース用に作成されています。

- 作成、削除、スケール・アップおよびスケール・ダウンの各操作を実行する単一の統合スクリプトは、管理サーバーと管理対象サーバーが実行されているホストと、外部ホスト上で実行できます。

- デフォルトで、ドメイン・ホームのベース・ディレクトリがMiddlewareホーム配下に作成されました。このディレクトリの場所は、セルフ・サービス管理者またはセルフ・サービス・ユーザーが変更できるようになりました。

- ミドルウェア・プールの作成時には、セルフ・サービス管理者が異なる場所を指定する必要があります。

- 「拡張設定」オプションが有効な場合、セルフ・サービス・ユーザーは各インスタンスのドメイン・ホーム・ベース・ディレクトリを指定できます。

注意:
セルフ・サービス・ユーザーが指定するディレクトリ場所は、セルフ・サービス管理者が指定する場所より優先されます。

- 配置関連の拡張:

- ラック対応のExalogic配置: ミドルウェア・プールがExalogicホスト・ターゲットを含む場合、セルフ・サービス管理者は「複数ラックのExalogicですか。」フィールドを「はい」に設定して、使用できるラックに同じインスタンスのサーバーを分配し、高可用性を確保することができます。

- ホスト間の負荷分散: セルフ・サービス管理者は、「使用可能なホストに負荷を分散させますか。」フィールドを「はい」に設定して、使用できるホスト間にサーバー割当てを分散するか、「いいえ」に設定して、使用できる最初のホストを完全に使用してから次のホストに移動することができます。

- セルフ・サービス管理者は、セルフ・サービス・ユーザーに対して「拡張設定」オプションを有効化するかどうかを選択できます。これらの設定が有効の場合、セルフ・サービス・ユーザーはインスタンス・ベースディレクトリ、JVMパラメータなどのカスタム・パラメータを指定できます。

- サービス・インスタンスの作成時に、セルフ・サービス・ユーザーが、スケール・ダウン操作時に維持する必要がある最小サーバー数を指定できるようになりました。

- WebLogic Server 12.1.2と12.1.3 JRFプロファイルがサポートされるようになりました。

- カスタム証明書がサポートされるようになりました。これらの証明書を含む新しいプロファイルを作成する必要があります。これらの証明書は、ミドルウェア・プール内のすべてのホスト上の、同じ名前を持つ同じ場所、またはミドルウェア・プール内のすべてのホストにアクセスできるNFSマウントされた場所に配置される必要があります。

- ミドルウェア・プールは、バイナリを持つミドルウェア・プロファイルと組み合せて使用されるとき、Oracleホームのないメンバー・ホストを含むことができるようになりました。この場合、Oracleホームがその場で作成されます。

13.3 Middleware as a Serviceの開始

この項では、プライベート・ミドルウェア・クラウドの設定を開始するために実行する必要のある手順のリストを示すことで開始を支援します。MWaaSを設定する前に、第11.2項「共通設定タスク」にリストする共通タスクを完了する必要があります。

表13-1 Middleware as a Serviceの開始

手順

作業

ロール

1

管理対象ホストで権限委任設定を構成する必要がある場合があります。第3.5項「権限委任設定の構成」を参照してください。

注意: これはオプションの手順です。

スーパー管理者

2

ミドルウェア・ホームの作成。第13.3.2項「ミドルウェア・ホームのプロビジョニング」を参照してください。

注意: これはオプションの手順です。共有ミドルウェア・ホーム(NFSの場所)が使用される場合のみ必須です。ミドルウェア・ホームがローカルの場合、SOAまたはService Busサービスの作成に使用されるデプロイメント・プロシージャによってプロビジョニングされます。

セルフ・サービス管理者

3

ソフトウェア・ライブラリにミドルウェア・プロビジョニング・プロファイルをロードします。第13.3.1項「プロビジョニング・プロファイルの作成」を参照してください。

セルフ・サービス管理者

4

WebLogic as a Service (WLaaS)を設定する場合は、WebLogicドメインのプロビジョニング・プロファイルを作成する必要があります。第13.3.1.1項「WebLogicドメインのプロビジョニング・プロファイルの作成」を参照してください。

セルフ・サービス管理者

13.3.1 プロビジョニング・プロファイルの作成

プロビジョニング・プロファイルを使用すると、デプロイメントを標準化し、デプロイメント・プロシージャの構成時のエラーを削減できます。これらのプロビジョニング・プロファイルは、オペレータが一括デプロイメントを行う場合に使用します。ソフトウェア・ライブラリを使用して、ドメインからミドルウェア・プロビジョニング・プロファイルを作成できます。詳細は、第13.3.1.1項「WebLogicドメインのプロビジョニング・プロファイルの作成」を参照してください。

13.3.1.1 WebLogicドメインのプロビジョニング・プロファイルの作成

WebLogicドメインのプロビジョニング・プロファイルは、ミドルウェア・ホーム、バイナリおよびドメイン構成で構成されます。プロファイルを作成し、それをソフトウェア・ライブラリに保存し、保存済のプロファイルを新規WebLogicドメインを作成するためのソースとして使用できます。これにより、以降のWebLogicインストールでも標準の一貫した構成に準拠することができます。

WebLogicドメインのプロビジョニング・プロファイルを作成する前に、次の前提条件を満たしていることを確認してください。

- 管理サーバーで管理エージェントが実行されている必要があります。

- ソース・マシンで実行されている管理サーバーのホスト資格証明が必要です。

- プロファイルを作成する対象のWebLogicドメインは、Enterprise Managerの監視対象ターゲットである必要があります。

- プロファイルの作成に必要なディスク領域は、次の式で計算されます。
ディスク領域 = ミドルウェア・ホームのサイズ + WebLogicドメインのサイズ + 一時スクリプト用の領域

- サービス・インスタンスでログ表示のサポートが必要な場合、セルフ・サービス管理者は、次の操作を実行する必要があります。

- ログ・ファイルの問合せに必要なホスト資格証明を構成します。「ターゲット」メニューから、「ログ」、「ログの場所の設定の構成」の順に選択して、対応するWebLogicドメインのターゲット・ページにアクセスし、資格証明を構成します。

- 「ログの場所の設定の構成」で指定したホスト資格証明にアクセスするための権限をセルフ・サービス・ユーザーに付与します。

- このWebLogicドメインに関連付けられたすべてのホスト・ターゲットに対するターゲット表示権限をセルフ・サービス・ユーザーに付与します。

- Fusion Middlewareのコンソール・アクセス・サポートが必要な場合、Fusion Middleware Controlを使用してWebLogicドメインを構成する必要があります。こうすることで、Fusion Middleware Controlリンクがミドルウェア・セルフ・サービス・ポータルのサービス・インスタンス・ホームページに表示されます。第28.3項「Middleware Serviceホームページの表示」を参照してください。

- プロファイルの作成に使用されるWebLogicドメインは、次の要件を満たしている必要があります。

- Weblogic Serverに関連付けられたマシンは、UNIX以外のタイプである必要があります。

- 管理サーバーはマシンに関連付けられていない必要があります。

- 管理サーバーは、管理対象サーバーのいずれかと同じホスト上に存在する必要があります。

- すべてのサーバーの最大Javaヒープ・サイズは、256の倍数の適切な-Xmx設定にする必要があります。たとえば、Xms1024m -Xmx1536m -XX:PermSize=512m -XX:MaxPermSize=1536mのようにします。-Xmxサーバー設定を定義して、MWaaSのメモリー・メトリックおよび割当て制限チェック機能が正しく機能するようにします。MWaaSサービスのメモリー・メトリックの値は、サービスのすべてのサーバーで使用できる最大ヒープの合計です。

WebLogicドメインのプロビジョニング・プロファイルを作成する方法の詳細は、『Oracle Enterprise Managerライフサイクル管理ガイド』を参照してください。

13.3.2 ミドルウェア・ホームのプロビジョニング

ミドルウェア・ホームは、1つ以上のOracleホームで構成されています。PaaSインフラストラクチャ・ゾーンに含まれるホストに、ミドルウェア・ホームを作成する必要があります。詳細は、第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

次のことができます。

- 事前プロビジョニングされたOracleホームを使用する: インスタンスの作成やスケール・アップ操作に必要なターンアラウンド・タイムが少ないため、お薦めできる手法です。

- オンデマンドでOracleホームを作成する: 事前プロビジョニングされたOracleホームが存在しない場合、その場で、またはオンデマンドでOracleホームを作成できます。その場でOracleホームを作成するには、Oracleホーム・バイナリを含むプロファイルを使用する必要があります。このオプションは、必要な管理者オーバーヘッドは少なく済みますが、ターンアラウンド・タイムはより多く必要です。

- 両方を組み合せて使用する: 両方(事前プロビジョニングされたOracleホームと、Oracleホームを持たないホスト)の組合せです。この場合、Oracleホームが存在しないホストでは、その場で作成されます。

複数のホストにミドルウェア・ホームをプロビジョニングする場合、すべての宛先ホストからアクセスできる共有マウント・ディレクトリを指定する必要があります。

注意:
ミドルウェア・ホームを手動でインストールし、Oracleホーム昇格ターゲットの検出ジョブを使用して、これをEnterprise Managerで検出することもできます。

ミドルウェア・ホームを作成するには、「Oracleミドルウェア・ホームのゴールド・イメージからのプロビジョニング」デプロイメント・プロシージャを実行する必要があります。

前提条件

このデプロイメント・プロシージャを実行する前に、次の前提条件を満たしていることを確認する必要があります。

- ユーザーが次のディレクトリに対する書込み権限を持っている必要があります。

- すべての宛先ホスト上の作業ディレクトリ。

- すべての宛先ホストのミドルウェア・ホーム。

- Oracle Middlewareホームのゴールド・イメージがソフトウェア・ライブラリに存在している必要があります。このゴールド・イメージの作成の詳細。Oracle Middlewareホームのゴールド・イメージを作成して、ソフトウェア・ライブラリに保存できます。これで、以降のミドルウェア・ホーム・インストールのソースとしてこのゴールド・イメージを使用できるようになります。Oracle Middlewareホームのゴールド・イメージを作成する手順の詳細は、『Oracle Enterprise Managerライフサイクル管理ガイド』を参照してください。

13.3.2.1 Oracleミドルウェア・ホームのゴールド・イメージからのプロビジョニング・デプロイメント・プロシージャ

注意:

- 手動で作成して検出したミドルウェア・ホームがある場合、この手順は無視できます。

- 1つのホストに対して同じWeblogic Serverバージョンのミドルウェア・ホームを複数設定することはできません。

ソフトウェア・ライブラリに存在するゴールド・イメージからミドルウェア・ホームをクローニングできます。このゴールド・イメージは、既存のミドルウェア・ホームを指定して事前に作成しておく必要があります。ゴールド・イメージからミドルウェア・ホームをクローニングする方法の詳細は、『Oracle Enterprise Managerライフサイクル管理ガイド』を参照してください。

第VI部

新規データベース・アーティファクトのプロビジョニング

この項では、Database as a Serviceを使用して新規データベース、スキーマおよびプラガブル・データベースをプロビジョニングする手順を説明します。

次の章で構成されます。

- 第14章「Database as a Serviceの開始」

- 第15章「データベース・テンプレートを使用したデータベースの作成」

- 第16章「スキーマの作成」

- 第17章「プラガブル・データベースのプロビジョニング」

14 Database as a Serviceの開始

この章では、このリリースでサポートされる様々なDBaaSユースケースの手順について説明します。内容は次のとおりです。

- サポートされているDBaaSユースケース

- DBaaSの開始

14.1 サポートされているDBaaSユースケース

次の図に、Enterprise Manager DBaaSの様々な形態の概要を示します。

図14-1 DBaaSユースケース

この表では、このリリースでサポートされているDBaaSユースケースをリストし、これらのユースケースの実行に使用できる様々な方法(GUI、EMCLIおよびRest API)をリストします。

表14-1 DBaaSユースケース

サービス・タイプ

サービス提供

グラフィカル・ユーザー・インタフェースの使用

EMCLIの使用

Rest APIの使用

新規

データベース・テンプレートを使用したデータベースの作成

第15章「データベース・テンプレートを使用したデータベースの作成」

第50.2項「REST APIおよびEM CLI動詞でのデータベース・テンプレートを使用したデータベースの作成」

第50.2項「REST APIおよびEM CLI動詞でのデータベース・テンプレートを使用したデータベースの作成」

スキーマ

- 空のスキーマの作成

- プロファイルに基づくスキーマの作成

第16章「スキーマの作成」

第50.3項「REST APIおよびEM CLI動詞での空のスキーマおよびプロファイルに基づくスキーマの作成」

第50.3項「REST APIおよびEM CLI動詞での空のスキーマおよびプロファイルに基づくスキーマの作成」

プラガブル・データベース

- 空のプラガブル・データベースの作成

- プロファイルに基づくプラガブル・データベースの作成

第17章「プラガブル・データベースのプロビジョニング」

第50.4項「REST APIおよびEM CLI動詞での空のPDBおよびプロファイルに基づくPDBの作成」

第50.4項「REST APIおよびEM CLI動詞での空のPDBおよびプロファイルに基づくPDBの作成」

クローン

フル・クローン

- RMANバックアップを使用したデータベースのクローニング

- RMAN複製を使用したデータベースのクローニング

第19章「フル・クローンの作成」

第50.7項「REST APIおよびEM CLI動詞でのRMANを使用したフル・データベース・クローンの作成」

第50.7項「REST APIおよびEM CLI動詞でのRMANを使用したフル・データベース・クローンの作成」

スナップ・クローン

- ソフトウェア・ソリューション
Sun ZFS

CloneDB

- ハードウェア・ソリューション
ZFSファイル・システム

NetApp

EMC

第20章「データベースのスナップ・クローンの作成」

第50.6項「REST APIおよびEM CLI動詞でのスナップ・クローンを使用したデータベースの作成」

第50.6項「REST APIおよびEM CLI動詞でのスナップ・クローンを使用したデータベースの作成」

14.2 DBaaSの開始

Database as a Serviceを開始するには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。次のページが表示されます。

図14-2 クラウド・ホーム・ページ

2. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。最初に、第11.2項「共通設定タスク」で説明した共通設定タスクを実行する必要があります。このページは、Database as a serviceを設定するための主要エントリ・ポイントです。

3. 左パネルのデータベース・サービス・ファミリの横にある「設定」リンクをクリックします。ドロップ・ダウン・リストからサービス・タイプ(「データベース」、「プラガブル・データベース」または「スキーマ」)の1つを選択し、選択したサービス・タイプに必要なタスクを実行します。

図14-3 DBaaSの開始

4. 選択に応じて、タスクのリストは異なる場合があります。構成したステップは緑のチェック・マークでマークされ、構成されていないステップは未構成としてリストされます。

注意:
アクセスできるサービス・タイプはユーザー・ロールに基づきます。たとえば、「データベース」サービス・タイプにのみアクセスできるユーザー(たとえばDBAAS_ADMIN)としてログインした場合は、そのサービス・タイプに関連するタスクのみ表示されます。しかし、EM_SSA_ADMINISTRATORロールを持つユーザーとしてログインした場合は、すべてのサービス・タイプを表示できます。詳細は、第3.3項「ロールの定義およびユーザーの割当て」を参照してください。

5. 構成するサービス・タイプに応じて、そのサービス・タイプの設定に必要な関連タスクを実行できます。

- 第VI部「新規データベース・アーティファクトのプロビジョニング」を参照してください

- 第VI部「データベースのクローニング」を参照してください

15 データベース・テンプレートを使用したデータベースの作成

この章では、データベース・テンプレート・ベースのプロファイルを使用した単一インスタンスおよびクラスタ・データベースの作成に必要なプロセスについて説明します。次のセクションがあります。

- データベース・テンプレートを使用したデータベースの作成

- スタンバイ・データベースのプロビジョニング

15.1 データベース・テンプレートを使用したデータベースの作成

DBCAテンプレートでは、構造およびデータのタイプと、構造のみのタイプの両方がサポートされます。このデータベース・プロビジョニング・プロファイルは、Enterprise Managerに登録された本番データベースまたはソース・データベースから作成されます。構造およびデータのタイプと、構造のみのタイプの両方がサポートされます。このオプションは、作成されるデータベース・サイズが50 GB未満の場合に推奨されます。

次の表に、データベース・テンプレート・ベースのプロファイルを使用したデータベースの作成に必要なタスクのリストを示します。

表15-1 データベース・テンプレートを使用したデータベースの作成

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

2

リソース・プロバイダを作成します。

- 1つ以上のPaaSインフラストラクチャ・ゾーンを作成します。

- 1つ以上のデータベース・プールを作成します。

第15.1.1項「リソース・プロバイダの作成」を参照してください。

6

DBCAテンプレート・ベースのデータベース・プロビジョニング・プロファイルを作成します。

第15.1.2項「データベース・テンプレートを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

4

リクエスト設定を構成します。

第15.1.3項「リクエスト設定の構成」を参照してください。

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第15.1.4項「割当て制限の定義」を参照してください。

7

作成したプロファイルに基づくサービス・テンプレートを作成します。

第15.1.5項「データベース・テンプレート・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

8

チャージバック・サービスを構成します。

第15.1.6項「チャージバックの構成」を参照してください。

9

データベースの作成時に、作成した(データベース・テンプレート・ベースのプロファイルに関連付けられた)サービス・テンプレートを選択します。

第15.1.7項「データベースのリクエスト」を参照してください。

15.1.1 リソース・プロバイダの作成

次のような1つ以上のリソース・プロバイダを作成する必要があります。

- PaaSインフラストラクチャ・ゾーン: 第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

- データベース・プール: 第11.2.2.2項「PaaSプールの作成」を参照してください。

15.1.1.1 Database as a Service用のデータベース・プールの作成

Database as a Service用のデータベース・プールを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。データベース・サービス・ファミリの横の「設定」リンクをクリックし、「データベース・プール」リンク、「作成」の順にクリックします。

図15-1 データベース・プールの作成

3. 「資格証明」リージョンで、次の資格証明を指定します。

- ホスト: データベースの作成および起動に必要です。

- ルート: これは、オプション・フィールドです。スナップ・クローン・プロファイルに基づいてデータベース・リクエストにこのデータベース・プールを使用する予定の場合、これは必須です。

- グリッド・インフラストラクチャ: これは、オプション・フィールドです。データベース・サービスを資格証明に登録する場合には必須です。

- 自動ストレージ管理: これは、オプション・フィールドです。ASMで実行されているデータベースでライブ・クローニングを行うためにこのデータベース・プールを使用する場合は必須です。

4. データベース・プールの名前および説明を入力します。

5. 次の詳細を指定します。

- PaaSインフラストラクチャ・ゾーン: データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。

- データベース構成: プロビジョニングするデータベースの構成を指定します。シングル・インスタンスまたはクラスタ・データベース(RAC)のいずれかにすることができますが、両方を組み合せることはできません。

- プラットフォームおよびバージョン: デプロイするデータベースのプラットフォームおよびバージョンを指定します。

6. 「追加」をクリックし、データベース・プールに追加する1つ以上のOracleホームを選択します。

7. 「データベース・インスタンスの最大数」(1ホスト当たり)に、プール内の各ホストで実行可能なデータベース・インスタンスの最大数を入力します。

注意:
RACデータベースの場合、このフィールドに指定されている値を使用して、データベースを作成するノードがこの基準を満たしていることを確認します。

8. 「発行」をクリックして、データベース・プールを作成します。新しく作成されたプールが、データベース・クラウド・セルフ・サービス・ポータルの設定: データベース・プール・ページに表示されます。現在は、データベース・プールをサービス・テンプレートに追加できます。

15.1.2 データベース・テンプレートを使用したデータベース・プロビジョニング・プロファイルの作成

データベース・プロビジョニング・プロファイルを作成するには、次の手順に従います。

1. 次のいずれかの方法を使用して、データベースのプロビジョニング・ページにアクセスできます。

- 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページで、「Oracle Cloud」をクリックし、「設定」、「データソース」の順に選択します。データベース: データソース・ページの「データ・プロファイル」タブで、「作成」をクリックします。

- 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」、「データベースのプロビジョニング」を選択します。データベースのプロビジョニング・ページの「プロファイル」セクションで、「作成」をクリックします。

- データベース・ターゲットのホームページで、「Oracle Database」をクリックし、「プロビジョニング」、「プロビショニング・プロファイルの作成」の順に選択します。

2. 参照ターゲット・ページで、検索アイコンをクリックして、ターゲットを選択します。

3. 「検索と選択: ターゲット」ダイアログ・ボックスで、プロファイルを作成するデータベースを選択して、「選択」をクリックします。

4. 「参照ターゲット」ページで、次を選択します。

- データ・コンテンツ

- 「構造のみ」を選択し、構造ファイルのみをテンプレートに組み込みます。
注意: データベース・サイズが5GB以下の場合、「構造およびデータ」オプションを使用できます。

- 作成

- データベース・テンプレート

5. 「資格証明」セクションで、データベースを選択します。「資格証明」列で、「名前付き資格証明」を選択して「資格証明名」列から資格証明名を選択するか、「優先資格証明」を選択します。「次」をクリックします。

6. データベース・プロビジョニング・プロファイルの作成・ページの「プロファイル情報」セクションで、次の操作を行います。

- データベース・プロファイルが作成されるソフトウェア・ライブラリ内のプロファイルの場所を指定または選択します。

- 一意のプロファイル名を指定します。

For example:
Database Template for HR database

- プロファイルの説明を追加します。

- プロファイル・バージョンとベンダーを確認します。

- ホスト名、データベース、データ・コンテンツ、データ・コンテンツ・モジュールなどのノートを追加します。

7. 「スケジュール」セクションで、プロファイルの作成をすぐに開始するか、後でスケジュールできます。また、プロビジョニング・プロファイルの作成の繰返しを選択し、繰返し時間を設定することもできます。

8. 作業ディレクトリを指定または選択します。「次」をクリックします。

9. 確認ページで、前のページで行った選択内容が正しく表示されていることを確認し、「発行」をクリックします。正しく表示されていない場合は、変更を行うページに達するまで「戻る」を繰り返しクリックします。プロビジョニング・プロファイルの作成を中断するには、「取消」をクリックします。

「データの表示」が「リアル・タイム: 手動リフレッシュ」に設定されている場合、プロビジョニング・プロファイルの作成ジョブを発行したら、ページを手動でリフレッシュしてください。それ以外の場合、一定の期間経過後にリロードするように「データの表示」を設定し、左側のペインの「プロシージャ・ステップ」ツリーから実行ステップを選択して詳細を表示します。

発行したジョブを表示するには、「データ・プロファイル」タブで「プロシージャ・アクティビティ」リンクを選択します。

15.1.3 リクエスト設定の構成

リクエストできる時間、その期間などを指定して、リクエスト設定を構成できます。第11.2.3項「リクエスト設定の構成」を参照してください。

15.1.4 割当て制限の定義

リクエスト設定を構成した後で、各セルフ・サービス・ユーザーの割当て制限を定義する必要があります。第11.2.4項「割当て制限の設定」を参照してください。

15.1.5 データベース・テンプレート・プロファイルを使用したサービス・テンプレートの作成

サービス・テンプレートは、データベースまたはスキーマを作成するためにセルフ・サービス・ユーザーに提供される標準化されたサービス定義です。セルフ・サービス・ユーザーは、サービス・テンプレート定義に基づいて1つ以上のデータベースを作成できます。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図15-2 サービス・テンプレートの作成: 一般(DBCAテンプレート)

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「ソース識別」フィールドの横にある検索アイコンをクリックし、リストからDBCAテンプレート・ベースのプロファイルを選択します。

8. 「データベース定義」リージョンで、次の項目を指定します。

- タイプ: 単一インスタンスまたはReal Application Cluster (RAC)を指定できます。「RAC」を選択した場合は、ノード数を指定します。

- データベースSID: これは、オプション・フィールドです。「接頭辞の指定」または「リクエスト時にユーザーにより指定」を選択できます。

- 接頭辞の指定: このオプションを選択する場合、データベースの作成時に一意のシステム識別子(SID)を生成するために使用される接頭辞を入力します。接頭辞は、このサービス・テンプレートを使用して作成されたデータベースの識別に役立ちます。接頭辞には、最大6文字を使用できます。
生成される新しいデータベース名は、ここで指定されるSID接頭辞をベースにします。たとえば、接頭辞がMYDBと指定されている場合、新しいデータベースのSIDは、MYDB0000、MYDB0001、MYDB0002 (以降同様)と生成されます。

既存のデータベース(実行中のデータベースおよび処理中のリクエスト)については、単一インスタンス・データベースに対して一意のSID名が生成されるか、Real Application Clusterデータベースに対して一意の名前が生成されます。たとえば、ホストで実行中の既存のSIDがMYDB0000、MYDB0001、MYDB0002で、処理中がMYDB0003、MYDB0004である場合、新規リクエストに対して生成される新規SIDまたはデータベース名はMYDB0005です。

- リクエスト時にユーザーにより指定: このオプションを選択する場合、このフィールドを空白のままにして、データベース・リクエストの作成時にSIDを指定できます。

- ドメイン名: これは、オプション・フィールドです。作成する新しいデータベースに使用するドメイン名を入力します。ドメイン名の先頭には「.」(ドット)が付いていないことを確認してください。

- スタンバイ・データベースの有効化: このサービス・テンプレートを使用してスタンバイ・データベースをプロビジョニングする場合、このチェック・ボックスを選択します。このチェック・ボックスを選択する場合、スタンバイ・データベースを追加する必要があります。詳細は、第15.2.2項「サービス・テンプレートの作成」を参照してください。

9. 「ゾーン」リージョンで、「追加」をクリックして、データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。「プールの割当て」をクリックします。リストからプールを選択し、このプールをPaaSインフラストラクチャ・ゾーンに割り当てます。データベースはこのプール内にプロビジョニングされます。

10. ゾーンおよびプールを選択したら、ホスト・ターゲットが「参照ホスト」フィールドに設定されます。

11. 次をクリックします。サービス・テンプレートの作成: データベースページが表示されます。

図15-3 サービス・テンプレートの作成: データベース(DBCAテンプレート)

12. 「参照ホスト」リージョンに、データベース・クラウド・セルフ・サービス・ポータルの設定: 一般ページで選択したPaaSインフラストラクチャ・ゾーンの名前、データベース・プールおよび参照ホストが表示されます。
選択した自動ストレージ管理(ASM)ディスク・グループ、ファイル・システムの場所およびリスナー・ポートなどのデータベース値は、参照ホストで利用できる必要があります。

13. 次の項目を指定します。

- 記憶域タイプ: 次のいずれかです。

- 自動ストレージ管理: Oracle自動ストレージ管理(ASM)は、単一インスタンスおよびRAC構成をサポートするデータベース・ファイルのボリューム・マネージャおよびファイル・システムです。ASMでは、ストレージ・システム内のディスクを1つ以上のディスク・グループに分類します。ASMを選択する場合、ディスク・グループをここで選択します。

- ファイル・システム: Oracle Databaseのファイル・システムは、データベース表に格納されるファイルおよびディレクトリの標準ファイルシステム・インタフェースを作成します。このオプションを選択する場合、ファイル・システムの場所を指定するか選択する必要があります。

- 高速リカバリ(オプション): バックアップおよびリカバリ・ファイルの管理を簡略化するために、データベースに高速リカバリ領域を作成できます。「高速リカバリ領域の有効化」チェック・ボックスを選択して、リカバリに関連するファイルの格納先となる場所を指定します。高速リカバリ領域は、バックアップおよびリカバリ・ファイル用の集中化されたディスクの場所を提供する、ASMディスク・グループまたはファイル・システムである可能性があります。高速リカバリ領域の場所および高速リカバリ・サイズを指定します。高速リカバリ領域に割り当てるディスク領域の量は、データベースのサイズおよびアクティビティ・レベルによって異なります。
セルフ・サービス・ユーザーにバックアップのスケジュールとリストア操作の実行を許可するには、高速リカバリ領域を構成して「アーカイブ有効化」チェック・ボックスを選択します。

- リスナー・ポート: 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。

- 管理者資格証明: 新しいデータベースのシステム・スキーマのパスワードを指定します。これらのスキーマは、セルフ・サービス・ユーザーに使用できません。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。これらの値が指定されていない場合はデフォルト値が使用され、セルフ・サービス管理者が値を変更できます。

- 非管理者資格証明: システム・スキーマとは別に、他のスキーマへのアクセスを制限する場合、「非管理者資格証明」リージョンでそれらを選択して、パスワードを指定できます。これらのスキーマはロックされ、EM_SSA_USERSはアクセスできません。「次」をクリックします。

14. 次をクリックします。サービス・テンプレートの作成: 初期化パラメータページが表示されます。このページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択し、「セット」アイコンをクリックして、パラメータの値を変更します。

15. 次をクリックします。サービス・テンプレートの作成: カスタマイズ・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。

16. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を変更できません。

17. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

18. サービス・テンプレートの作成: 確認ページが表示されます。「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。

15.1.6 チャージバックの構成

オプションで、チャージバック・サービスを構成できます。第43章「チャージバック管理」を参照してください。

15.1.7 データベースのリクエスト

セルフ・サービス・ユーザーは、データベース・テンプレート・プロファイルに基づいてサービス・テンプレートを選択し、データベースを作成できるようになりました。第22.2項「データベースのリクエスト」を参照してください。

15.2 スタンバイ・データベースのプロビジョニング

Data Guard構成は、1つのプライマリ・データベースと1つ以上のスタンバイ・データベースで構成されます。Data Guard構成内のデータベースはOracle Netで接続され、地理的に散在していてもかまいません。データベースが相互に通信できる場合、データベースの位置に関する制限はありません。

Oracle Data Guardは、企業データの高可用性、データ保護および障害時リカバリを保証します。1つ以上のスタンバイ・データベースを作成、維持、管理、監視して、本番のOracleデータベースが障害やデータ破損に耐えられるようにするための包括的なサービス・セットが用意されています。Oracle Data Guardでは、これらのスタンバイ・データベースを本番データベースのコピーとしてメンテナンスします。計画停止または計画外停止により、本番データベースが使用できなくなった場合、Oracle Data Guardはいずれかのスタンバイ・データベースを本番ロールに切り替えることで、停止に伴う停止時間を最小化できます。

本番データベース(プライマリ・データベースとも呼ばれる)は、単一インスタンスのOracleデータベースまたはOracle Real Application Clusters (RAC)データベースのいずれかにすることができます。スタンバイ・データベースは、トランザクション上の一貫性を持つ、プライマリ・データベースのコピーです。プライマリ・データベースのバックアップ・コピーを使用することで、1つ以上のスタンバイ・データベースを作成し、それをData Guard構成に組み込むことができます。EM_SSA_ADMINISTRATORロールを持つユーザーは、Enterprise Manager Database as a Serviceを使用して、RACスタンバイ・データベースの単一インスタンスを含むDBaaSクラウドを設定できます。

表15-2 スタンバイ・データベースのプロビジョニング

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

2

リソース・プロバイダを作成します。

- 1つ以上のPaaSインフラストラクチャ・ゾーンを作成します。

- スタンバイ・データベースのプロビジョニング用に1つ以上のデータベース・プールを作成します。

第15.1.1項「リソース・プロバイダの作成」を参照してください。

6

次のいずれかのタイプのプロファイルを作成します。

- DBCAテンプレート・ベースのデータベース・プロビジョニング・プロファイル。

- RMANバックアップ・ベースのデータベース・プロビジョニング・プロファイル。

関連項目:

- 第15.1.2項「データベース・テンプレートを使用したデータベース・プロビジョニング・プロファイルの作成」

- 第19.1.2.1項「RMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成」

4

リクエスト設定を構成します。

第15.1.3項「リクエスト設定の構成」を参照してください。

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第15.1.4項「割当て制限の定義」を参照してください。

7

作成したプロファイルに基づくサービス・テンプレートを作成します。

第15.2.2項「サービス・テンプレートの作成」を参照してください

8

チャージバック・サービスを構成します。

第15.1.6項「チャージバックの構成」を参照してください。

9

データベースのデプロイ時に、作成した(DBCAテンプレート・ベースのプロファイルに関連付けられた)サービス・テンプレートを選択します。また、データベースのリクエスト時にスタンバイ・データベースの情報を指定することもできます。

第15.1.7項「データベースのリクエスト」を参照してください。

15.2.1 スタンバイ・データベースをプロビジョニングするためのデータベース・プールの定義

Data Guard構成は、1つの本番データベースおよび1つ以上のスタンバイ・データベースから構成されます。スタンバイ・データベースをプロビジョニングするためのデータベース・プールを定義するには、次の手順に従う必要があります。

1. データベース・プールを作成します。第15.1.1.1項「Database as a Service用のデータベース・プールの作成」を参照してください。

2. スタンバイ・データベースをホストする1つ以上のプールにデータベース・プールを関連付けます。第15.2.1.1項「スタンバイ・データベース・プールのプライマリ・データベース・プールへの関連付け」を参照してください。

15.2.1.1 スタンバイ・データベース・プールのプライマリ・データベース・プールへの関連付け

スタンバイ・サポートを含めるには、次の手順に従って、スタンバイ・データベースの作成先となる、1つ以上の事前作成されたデータベース・プールを追加する必要があります。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「リソース・プロバイダ」を選択し、プライマリ・データベース・プールとして指定したデータベース・プールを選択し、「編集」をクリックします。「プールの編集: 設定」ページが表示されます。

図15-4 データベース・プールの編集

3. プールの詳細とプール内のOracleホームが表示されます。これで、1つ以上のスタンバイ・データベース・プールを追加し、それをプライマリ・データベース・プールに関連付けることができます。「スタンバイ・プール」リージョンの「追加」をクリックします。「スタンバイ・プールの追加」ウィンドウが表示されます。

4. 1つ以上のスタンバイ・プールを選択して「選択」をクリックします。選択したプールが「スタンバイ・プール」リージョンに表示されます。これで、これらのプールがプライマリ・データベース・プールに関連付けられたため、スタンバイ・データベースをプロビジョニングするために使用できます。

注意:
プライマリおよびスタンバイ・データベース・プールのOSユーザーとパスワードは同じである必要がありますが、「名前付き資格証明」は異なっていてかまいません。

5. セルフ・サービス管理者がリソース使用率の最大限度を設定できるように「配置制約」を指定します。たとえば、データベース・プールを使用してスタンバイ・データベースをプロビジョニングしている場合、スタンバイ・データベースは常時アクティブな操作に使用されるわけではないため、「1ホスト当たりのデータベース・インスタンスの最大数」フィールドに比較的大きい値を指定できます。

6. 「発行」をクリックします。これで、プライマリ・プールがスタンバイ・データベース・プールに関連付けられたため、スタンバイ・データベースをプロビジョニングするために使用できます。

15.2.2 サービス・テンプレートの作成

サービス・テンプレートは、セルフ・サービス・ユーザーがスタンバイ・データベースを作成するための標準化されたサービス定義です。セルフ・サービス・ユーザーは、サービス・テンプレート定義に基づいて1つ以上のスタンバイ・データベースを作成できます。データベース・サービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

6. 「プロファイル」フィールドの隣にある「検索」アイコンをクリックして、データベース・プロビジョニング・プロファイルを選択します。

7. 次のタイプのプロファイルを選択できます。

- RMANバックアップ・ベースのデータベース・プロビジョニング・プロファイル。

- DBCAテンプレート・ベースのデータベース・プロビジョニング・プロファイル。

8. 「データベース定義」リージョンで、次の項目を指定します。

- タイプ: 単一インスタンスまたはReal Application Cluster (RAC)を指定できます。「RAC」を選択した場合は、ノード数を指定します。

- データベースSID: これは、オプション・フィールドです。「接頭辞の指定」または「リクエスト時にユーザーにより指定」を選択できます。

- 接頭辞の指定: このオプションを選択する場合、データベースの作成時に一意のシステム識別子(SID)を生成するために使用される接頭辞を入力します。接頭辞は、このサービス・テンプレートを使用して作成されたデータベースの識別に役立ちます。接頭辞には、最大6文字を使用できます。
生成される新しいデータベース名は、ここで指定されるSID接頭辞をベースにします。たとえば、接頭辞がMYDBと指定されている場合、新しいデータベースのSIDは、MYDB0000、MYDB0001、MYDB0002 (以降同様)と生成されます。

既存のデータベース(実行中のデータベースおよび処理中のリクエスト)については、単一インスタンス・データベースに対して一意のSID名が生成されるか、Real Application Clusterデータベースに対して一意の名前が生成されます。たとえば、ホストで実行中の既存のSIDがMYDB0000、MYDB0001、MYDB0002で、処理中がMYDB0003、MYDB0004である場合、新規リクエストに対して生成される新規SIDまたはデータベース名はMYDB0005です。

- リクエスト時にユーザーにより指定: このオプションを選択する場合、このフィールドを空白のままにして、データベース・リクエストの作成時にSIDを指定できます。

- ドメイン名: これは、オプション・フィールドです。作成する新しいデータベースに使用するドメイン名を入力します。ドメイン名の先頭には「.」(ドット)が付いていないことを確認してください。

- スタンバイ・データベースの有効化: このサービス・テンプレートを使用してスタンバイ・データベースをプロビジョニングする場合、このチェック・ボックスを選択します。データベース・ロック・アイコンと「スタンバイ・データベースの追加」リージョンが表示されます。データベース・ロック・アイコンをクリックして、データベースをロックします。これによって、セルフ・サービス・ユーザーはスタンバイ・データベースへのリクエストを強制されます。ロックが解除されると、セルフ・サービス・ユーザーは、データベース・リクエストの発行時にスタンバイ・データベースの選択を解除できます。

図15-5 サービス・テンプレートの作成: 一般(スタンバイ・データベース)

9. 「スタンバイ・データベースの追加」をクリックします。表示された「スタンバイ・データベースの追加」ウィンドウで、次の詳細を指定します。

図15-6 スタンバイ・データベースの追加

- スタンバイ名: スタンバイ・データベースの識別に使用される名前。

- タイプ: 単一インスタンスまたはReal Application Cluster (RAC)を指定できます。「RAC」を選択した場合は、ノード数を指定する必要があります。

- スタンバイ・ドメイン名: 作成する新しいスタンバイ・データベースのドメイン名を入力します。

- スタンバイ保護モード: 次のいずれかの保護モードを指定します。

- 保護の最大化: データ損失なしの、最高レベルのデータ保護を可能にします。このモードを選択した場合は、少なくとも1つのスタンバイ・データベースでSYNC REDOトランスポート・モードを設定する必要があります。

- 可用性の最大化: 非常に高いデータ保護を提供します。このモードを選択した場合は、少なくとも1つのスタンバイ・データベースでSYNC REDOトランスポート・モードを設定する必要があります。

- パフォーマンスの最大化: ASYNC REDOトランスポート・モードでの高いデータ保護を可能にします。このモードを選択した場合、プライマリ・データベースのパフォーマンスへの影響はありません。

- リアル・タイム問合せの有効化: データベースでのリアル・タイムのデータ問合せを有効にするには、このオプションを選択します。この機能には、Active Data Guardのライセンスが必要です。

- 遅延の適用: スタンバイ・データベースでアーカイブREDOログ・データが適用されるまでの遅延期間を指定します。プロパティが0分に設定されている場合、REDOログ・データはスタンバイ・データベースに即時に適用されます。

注意:
単一のサービス・テンプレートを使用して、複数のスタンバイ・データベースをプロビジョニングできます。

10. 「プールとゾーン」(プライマリ・プール)リージョンで「追加」をクリックして、データベース・インスタンスをプロビジョニングする1つ以上のPaaSインフラストラクチャ・ゾーンを追加します。「プールの割当て」をクリックし、スタンバイ・データベースのプライマリ・データベース・プールとなるデータベース・プールを選択します。

11. スタンバイ・プール・リージョンに、定義されているスタンバイ・データベースのリストが表示されます。ドロップダウン・リストから、スタンバイ・データベースを関連付けるスタンバイ・プールを選択します。1つのプライマリ・プールに複数のスタンバイ・プールを関連付けることができます。

注意:
プライマリ・プールが単一インスタンス・タイプの場合、単一インスタンスとRACデータベースの両方のプールがリストされます。ただし、プライマリ・プールがRACの場合、RACデータベース・プールのみが「スタンバイ・プール」リージョンにリストされます。

図15-7 サービス・テンプレートの作成: 一般(スタンバイ・データベース)

12. 「参照ホスト」フィールドの「検索」をクリックし、ホスト・ターゲットを選択します。

13. 「共有場所」を指定して「次へ」をクリックし、「データベース・クラウド・セルフ・サービス・ポータルの設定: データベース」ページに移動します。

14. 選択したゾーン、プールおよび参照ホストの名前が表示されます。ASMディスク・グループ、ファイル・システムの場所、および参照ホストで使用可能なリスナー・ポートを選択できます。

注意:
ストレージの場所とリスナー・ポートは、すべてのプライマリ・プールおよびスタンバイ・プールで同一である必要があります。

- 記憶域タイプ: 記憶域タイプは次のとおりです。

- 自動ストレージ管理: Oracle Automatic Storage Management (ASM)は、単一インスタンスおよびRAC構成をサポートするデータベース・ファイルのボリューム・マネージャおよびファイル・システムです。ASMでは、ストレージ・システム内のディスクを1つ以上のディスク・グループに分類します。ASMを選択する場合、ここでディスク・グループを指定します。

- ファイル・システム: Oracle Databaseのファイル・システムは、データベース表に格納されるファイルおよびディレクトリの標準ファイル・システム・インタフェースを作成します。このオプションを選択する場合、ファイル・システムの場所を指定する必要があります。

- 高速リカバリ: バックアップおよびリカバリ・ファイルの管理を簡略化するには、データベースの高速リカバリ領域を作成します。高速リカバリ領域は、バックアップおよびリカバリ・ファイル用の集中化されたディスクの場所を提供する、ASMディスク・グループまたはファイル・システムである可能性があります。高速リカバリ領域の場所および高速リカバリ・サイズを指定します。高速リカバリ領域に割り当てるディスク領域の量は、データベースのサイズおよびアクティビティ・レベルによって異なります。
セルフ・サービス・ユーザーにバックアップのスケジュールとリストア操作の実行を許可するには、高速リカバリ領域を構成して「アーカイブ有効化」チェック・ボックスを選択します。

15. 「ポート番号」フィールドで、新しいデータベースに関連付けられるリスナーのポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。

16. 「場所」フィールドに、RMANの重複バックアップの場所を指定します。このディレクトリは、プライマリ・プールとスタンバイ・プールのすべてのメンバー上に存在する必要があります。この場所で使用可能な空き領域は、プロファイルの作成元のデータベースのサイズ以上である必要があります。

17. 「管理者資格証明」を指定します。新しいデータベースのシステム・スキーマのパスワードを指定します。これらのスキーマは、EM_SSA_USERSに対して使用できません。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。これらの値が指定されていない場合は、デフォルト値が使用され、EM_ADMINISTRATORがそれらを変更できます。

18. システム・スキーマとは別に、他のスキーマへのアクセスを制限する場合、「非管理者資格証明」リージョンで選択して、パスワードを指定できます。これらのスキーマはロックされ、EM_SSA_USERSはアクセスできません。

19. 次をクリックします。データベース・クラウド・セルフ・サービス・ポータルの設定: 初期化パラメータ・ページが表示されます。このページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択して、「セット」アイコンをクリックして、パラメータの値を変更します。

注意:
サービス・インスタンスの作成時にセルフ・サービス・ユーザーが選択できるデータベース・サイズは、EMCLIコマンドを使用してグローバルに定義されます。これらのグローバル・データベース・サイズのサブセットは初期化パラメータ・ページで定義でき、セルフ・サービス・ユーザーはデータベースの作成時にこれらのサイズの1つを選択できます。

20. 次をクリックします。データベース・クラウド・セルフ・サービス・ポータルの設定: スクリプト・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。

21. 次をクリックします。データベース・クラウド・セルフ・サービス・ポータルの設定: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。

22. 次をクリックします。データベース・クラウド・セルフ・サービス・ポータルの設定: 確認ページが表示されます。これまでに入力した情報を確認し、「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。「サービス・テンプレート名」リンクをクリックして、追加の詳細を表示できます。

16 スキーマの作成

実行中のデータベースに1つ以上のスキーマを作成できます。スキーマは、プロファイルに基づいて空にすることができます。この章の内容は、次のとおりです。

- 開始

- リソース・プロバイダの作成

- エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成

- リクエスト設定の構成

- 割当て制限の定義

- チャージバックの構成

- スキーマのリクエスト

16.1 開始

このデータベース・プロビジョニング・プロファイルのデータ・コンテンツは、データ・ポンプ・ツールを使用して作成されたエクスポート・ダンプからコンパイルされます。スキーマ・オブジェクト(構造のみ)またはスキーマおよびデータ(構造およびデータ)のエクスポートを選択できます。

次の表に、空のスキーマの作成またはプロファイルに基づくスキーマの作成に必要なタスクのリストを示します。

表16-1 データベース・テンプレートを使用したデータベースの作成

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

2

リソース・プロバイダを作成します。

- 1つ以上のPaaSインフラストラクチャ・ゾーンを作成します。

- 1つ以上のデータベース・プールを作成します。

第16.2項「リソース・プロバイダの作成」を参照してください。

6

データベース・プロビジョニング・プロファイルを作成します。この手順はオプションで、プロファイルからスキーマをインポートする場合に必要です。

第16.3項「エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

4

リクエスト設定を構成します。

第16.4項「リクエスト設定の構成」を参照してください。

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第16.5項「割当て制限の定義」を参照してください。

7

次のものに基づくサービス・テンプレートとして作成します。

- ユーザー定義スキーマ: この場合、サービス・テンプレートは空のスキーマで作成されます。

- プロファイルからのスキーマ: この場合、データベース・プロビジョニング・プロファイルからスキーマをインポートできます。eBusinessアプリケーションなどのデータを使用したアプリケーションに対してこのオプションを選択できます。

第16.6項「プロファイルに基づくスキーマのサービス・テンプレートの作成」を参照してください。

8

チャージバック・サービスを構成します。

第16.8項「チャージバックの構成」を参照してください。

9

データベースの作成時に、作成した(データベース・テンプレート・ベースのプロファイルに関連付けられた)サービス・テンプレートを選択します。

第16.9項「スキーマのリクエスト」を参照してください。

16.2 リソース・プロバイダの作成

次のような1つ以上のリソース・プロバイダを作成する必要があります。

- PaaSインフラストラクチャ・ゾーン: 第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

- スキーマ・プール: 第16.2.1項「Schema as a Service用のデータベース・プールの作成」を参照してください。

16.2.1 Schema as a Service用のデータベース・プールの作成

シード・データおよびデータベース・オブジェクトのあるなしにかかわらず1つ以上のスキーマを使用したデータベース・サービスを作成できます。次の手順を実行します。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。データベース・サービス・ファミリの横の「設定」リンクをクリックし、ドロップ・ダウン・リストから「スキーマ」を選択し、「スキーマ・プール」、「作成」の順にクリックします。

図16-1 データベース・プールの作成(Schema as a Service)

3. スキーマ・プールの名前および説明を入力します。

4. 「資格証明」リージョンで、データベース操作の実行に使用される資格証明を指定します。次の資格証明を指定します。

- ホスト: データベースの起動に必要です。

- グリッド・インフラストラクチャ: データベース・サービスをグリッド・インフラストラクチャ資格証明に登録するために必要です。これらの資格証明は、セルフ・サービス・ユーザーがASMから取得したスキーマ・バックアップを削除する必要がある場合に使用されます。

- データベース: データベースのスキーマの作成に必要です。データベース資格証明には、SYSDBA権限が含まれる必要があります。

5. 次の詳細を指定します。

- PaaSインフラストラクチャ・ゾーン: データベースが存在するPaaSインフラストラクチャ・ゾーンを選択します。スキーマは、プールに選択したデータベースに作成されます。

- ターゲット・タイプ: スキーマをデプロイするターゲット・データベースの構成を指定します。これは、単一インスタンスまたはクラスタ・データベース(RAC)のいずれかになります。

- プラットフォームおよびバージョン: デプロイするデータベースのプラットフォームおよびバージョンを指定します。

6. 「追加」をクリックし、プールに追加する1つ以上のデータベースを選択します。選択するすべてのデータベースは、同じPaaSインフラストラクチャ・ゾーンに存在する必要があります。

注意:
「グループ」フィールドの検索文字列を指定して、要件を満たすデータベース・グループを検索できます。

7. 次をクリックします。新規プールの作成: ポリシーページが表示されます。

図16-2 データベース・プールの作成: ポリシー(Schema as a Service)

配置ポリシー制約を指定して、各データベースのリソース使用率の上限値を設定します。各データベースの配置ポリシー制約は、次のようなサービスまたはワークロードによって定義できます。

- サービス: このチェック・ボックスを選択する場合、各データベースで実行できるデータベース・サービスの最大数を指定する必要があります。

- サービス・リクエストに関連付けられているワークロード: ワークロードを管理するリソース(CPUやメモリーなど)の量をここで指定できます。各データベースの合計ワークロードを指定します。

- 最大CPU割当て: 各データベースに割り当てることができる最大CPUを指定します。

- 最大メモリー割当て: 各データベースに割り当てることができる最大メモリーを指定します。

8. サービス・リクエストに関連付けられているワークロードによる配置制約の設定を選択した場合、CPU用のリソース・マネージャの有効化チェック・ボックスを選択して、リソース・マネージャの有効化を選択できます。リソース・マネージャを使用してCPUリソースを管理し、EM_SSA_USERが最大割当て値を超えないことを確認できます。

9. 「発行」をクリックして、データベース・プールを作成します。新しく作成されたデータベース・プールが、データベース・クラウド・セルフ・サービス・ポータルの設定: データベース・プール・ページに表示されます。

16.3 エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成

データベース・プロビジョニング・プロファイルを作成するには、次の手順に従います。

1. 次のいずれかの方法を使用して、データベースのプロビジョニング・ページにアクセスできます。

- 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページで、「Oracle Cloud」をクリックし、「設定」、「データソース」の順に選択します。データベース: データソース・ページの「データ・プロファイル」タブで、「作成」をクリックします。

- 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」、「データベースのプロビジョニング」を選択します。データベースのプロビジョニング・ページの「プロファイル」セクションで、「作成」をクリックします。

- データベース・ターゲットのホームページで、「Oracle Database」をクリックし、「プロビジョニング」、「プロビショニング・プロファイルの作成」の順に選択します。

2. 参照ターゲット・ページで、検索アイコンをクリックして、ターゲットを選択します。

3. 「検索と選択: ターゲット」ダイアログ・ボックスで、プロファイルを作成するデータベースを選択して、「選択」をクリックします。

4. 「参照ターゲット」ページで、次を選択します。

- データ・コンテンツ

- データベースから物理ファイルおよび構造ファイルを組み込むための「構造およびデータ」、またはテンプレート内の構造ファイルのみを組み込むための「構造のみ」。

- スキーマ・オブジェクトのエクスポート

5. 「資格証明」セクションで、データベースを選択します。「資格証明」列で、「名前付き資格証明」を選択して「資格証明名」列から資格証明名を選択するか、「優先資格証明」を選択します。「次」をクリックします。

6. コンテンツ・オプション・ページで、次の操作を実行します。

- 「使用可能なスキーマ」リストでスキーマをクリックして「選択したスキーマ」リストに移動し、プロファイルに組み込むスキーマを選択します。

注意:
1つ以上のスキーマを選択した場合、データベースによって、依存スキーマもエクスポート用に選択されているかどうかが確認されます。依存スキーマがエクスポートされない場合、警告が表示されます。選択したスキーマでそのまま続行することも、最初に選択しなかったスキーマを含めることもできます。
依存スキーマがエクスポートされないプロファイルを選択した場合にも、同じ警告が表示されます。

注意:
「使用可能なスキーマ」セクションには、データ・コンテンツが含まれているユーザーが作成したスキーマのみが表示されます。空のスキーマはすべてデフォルトでフィルタにより除外されています。

注意:
SYS、SYSTEMおよびDBSNMPなどのシステム・スキーマはエクスポートされません。
独自の表領域を持たないユーザー・スキーマは、シャトルの左側に表示されません。

- 「並列度」セクションで、エクスポート操作を実行するために必要なスレッドの数を入力します。

注意:
スレッドの数を増やすと、プログラムの作成に必要な時間を短縮できますが、システム・リリースの使用量が増えます。

- 「ディレクトリの場所」セクションで、「追加」をクリックします。「ディレクトリを選択」ウィンドウで、エクスポート操作をするためにリストされているディレクトリ・オブジェクトを選択し、「選択」をクリックします。

注意:
エクスポート・スレッドの数によって、エクスポート中にパラレルに実行されるパラレル・エクスポート・プロセスの数が決定されます。
そのため、実行数でファイル名を自動生成してダンプ・ファイルの最大サイズに基づくパラレル操作を容易にするため、ダンプ・ファイル名に%Uを含める必要があります。たとえば、5GBとします。これは、5GBの制限に到達した後にファイル・ローテーションが開始することを意味します。

注意:
ディレクトリの場所にアクセスできることを確認してください。選択するディレクトリ・オブジェクトは、すべてのノード全体でアクセスできる場所を示している必要があります。ASMにディレクトリ・オブジェクトを作成することもできます。ただし、これはASMではサポートされません。

「ログ」サブセクションで、検索アイコンをクリックします。「ディレクトリを選択」ウィンドウで、エクスポート操作をするために必要なディレクトリ・オブジェクトを選択し、「選択」をクリックします。

「ログ」サブセクションで、ファイル名を入力し、「次」をクリックします。

注意:
ダンプ・ファイル名によって並列度を使用できます。ダンプ・ファイルのデフォルト値には、並列度が1より大きい場合に実行数を作成する%Uが含まれます。
これによって、複数のダンプ・ディレクトリを追加して必要に応じて記憶域を分散できます。

7. データベース・プロビジョニング・プロファイルの作成・ページの「プロファイル情報」セクションで、次の操作を行います。

- データベース・プロファイルが作成されるソフトウェア・ライブラリ内のプロファイルの場所を指定または選択します。

- 一意のプロファイル名を指定します。

For example:
Export Schema Objects Provisioning Profile for HR database

- プロファイルの説明を追加します。

- プロファイル・バージョンとベンダーを確認します。

- ホスト名、データベース、データ・コンテンツ、データ・コンテンツ・モジュールなどのノートを追加します。

8. 「スケジュール」セクションで、プロファイルの作成をすぐに開始するか、後でスケジュールできます。また、プロビジョニング・プロファイルの作成の繰返しを選択し、繰返し時間を設定することもできます。

9. 作業ディレクトリを指定または選択します。「次」をクリックします。

10. 確認ページで、前のページで行った選択内容が正しく表示されていることを確認し、「発行」をクリックします。正しく表示されていない場合は、変更を行うページに達するまで「戻る」を繰り返しクリックします。プロビジョニング・プロファイルの作成を中断するには、「取消」をクリックします。

「データの表示」が「リアル・タイム: 手動リフレッシュ」に設定されている場合、プロビジョニング・プロファイルの作成ジョブを発行したら、ページを手動でリフレッシュしてください。それ以外の場合、一定の期間経過後にリロードするように「データの表示」を設定し、左側のペインの「プロシージャ・ステップ」ツリーから実行ステップを選択して詳細を表示します。

発行したジョブを表示するには、「データ・プロファイル」タブで「プロシージャ・アクティビティ」リンクを選択します。

16.4 リクエスト設定の構成

リクエストできる時間、その期間などを指定して、リクエスト設定を構成できます。第11.2.3項「リクエスト設定の構成」を参照してください。

16.5 割当て制限の定義

リクエスト設定を構成した後で、各セルフ・サービス・ユーザーの割当て制限を定義する必要があります。第11.2.4項「割当て制限の設定」を参照してください。

16.6 プロファイルに基づくスキーマのサービス・テンプレートの作成

1つ以上のスキーマは、サービス・テンプレート定義に基づいて作成できます。Schema as a Service用のサービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「スキーマ」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図16-3 サービス・テンプレートの作成: 名前(スキーマ)

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「ソース」リージョンで、「プロファイルからのスキーマのインポート」オプションを選択し、スキーマのインポート元のデータベース・プロビジョニング・プロファイルを選択します。「プロファイル」フィールドの横にある「検索」アイコンをクリックし、リストからエクスポート・スキーマ・オブジェクト・ベースのプロファイルを選択します。プロファイルが存在しない場合は、作成する必要があります。第16.3項「エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

8. プロファイルを選択した後、すべてのスキーマに対する権限を持つマスター・アカウントを選択する必要があります。マスター・アカウントが選択されていない場合、セルフ・サービス・ユーザーはスキーマのリクエスト時に選択する必要があります。

9. 「ゾーン」リージョンで、「追加」をクリックして、サービス・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。プールの割当てをクリックして、ゾーンのデータベース・プールを追加します。

10. ゾーンおよびプールを選択したら、ホスト・ターゲットが「参照ホスト」フィールドに設定されます。複数のゾーンおよびプールを追加した場合、検索アイコンをクリックしてリストからホスト・ターゲットを選択する必要があります。

11. エクスポート・スキーマ・オブジェクト・プロファイルに基づいたサービス・テンプレートを作成する場合、「共有場所」リージョンで、スキーマ・ダンプが存在するパスまたは共有場所を指定します。共有場所は、すべてのデータベースからアクセスできる必要があります。

12. 次をクリックします。サービス・テンプレートの新規作成: 構成ページが表示されます。次の詳細を指定します。

- ワークロード・サイズ: ワークロードは、各サービスのCPU合計、メモリーおよび記憶域要件を表します。スキーマ・サービスに対して小、中、大などのワークロード・サイズを定義できます。「作成」をクリックし、「ワークロードの作成」ウィンドウで、各サービスの名前、CPU、メモリーおよび記憶域制限を入力します。ワークロード・サイズを選択し、「デフォルト」をクリックしてそれをデフォルト・ワークロード・サイズとして指定します。

- スキーマ権限の割当て: 既存のロールを選択するか、すべてのスキーマに割り当てられるロールを作成できます。CREATE_SESSIONやCREATE DIMENSIONなどのすべてのデータベース権限を、ロールに付与できます。ユーザー名、説明、およびユーザーに付与する権限を入力します。

注意:

- 名前が指定されたロールがデータベース内にすでに存在する場合、データベース権限は変更できません。

- マスター・アカウントには、このサービス・リクエストの一部として作成されるすべてのスキーマに対して、CREATE SESSION、CREATE DIMENSION、CREATE INDEXTYPE、CREATE OPERATOR、CREATE PROCEDURE、CREATE SEQUENCE、CREATE TABLE、CREATE TRIGGER、CREATE TYPE、CREATE VIEWおよびCREATE SYNONYMの各権限が付与されます。

- 表領域: 表領域の記憶域構成を指定します。次の詳細を入力します。

- 最大サイズ: 表領域の最大サイズは、「無制限」または「リクエスト時に選択されたワークロード・サイズで指定」のいずれかです。

- 自動拡張: このチェック・ボックスを選択して、新しいデータ・ファイルを自動的に拡張します。

注意:
空のスキーマを作成する場合、「表領域の詳細」セクションに表領域はリストされません。この場合、表領域の「初期サイズ」と「増分」の値を指定する必要があります(ただ1つの表領域が作成されます)。

- 表領域の詳細: 選択したプロファイルに基づいて、1つ以上の表領域がここにリストされます。表の次の値を編集できます。

- 初期サイズ: 「最大サイズ」フィールドで「リクエスト時に選択されたワークロード・サイズで指定」を選択している場合、表領域の初期サイズを入力します。

- 増分: 「自動拡張」チェック・ボックスを選択した場合、データ・ファイルを自動的に増やすサイズを指定します。

- 最大サイズ: リクエスト時に指定されるワークロード・サイズによって表領域の記憶域が決定される場合、表領域全体に配布可能な最大サイズをここに入力します。

13. 次をクリックします。サービス・テンプレートの作成: スクリプト・ページが表示されます。サービス・インスタンスの作成前と作成後に実行する必要があるカスタム・スクリプトを指定します。詳細は、「前処理および後処理スクリプト」セクションを参照してください。

図16-4 サービス・テンプレートの作成: スクリプト(スキーマ)

14. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、スキーマのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、スキーマのリクエスト時にこのプロパティの値を変更できません。

15. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。

16. 「次」をクリックして、「確認」ページに進みます。これまでに入力した詳細を確認し、「発行」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。「サービス・テンプレート名」リンクをクリックして、追加の詳細を表示できます。

16.7 空のスキーマでのサービス・テンプレートの作成

1つ以上のスキーマは、サービス・テンプレート定義に基づいて作成できます。空のスキーマの作成に使用できるサービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「スキーマ」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図16-5 サービス・テンプレートの作成: 名前(空のスキーマ)

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「ソース」リージョンで、「ユーザー定義スキーマの作成」オプションを選択して、ユーザーが構成できる空のスキーマを作成します。このオプションを選択する場合は、作成できる「最大スキーマ数」を指定する必要があります。

8. 「ゾーン」リージョンで、「追加」をクリックして、サービス・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。プールの割当てをクリックして、ゾーンのデータベース・プールを追加します。

9. ゾーンおよびプールを選択したら、ホスト・ターゲットが「参照ホスト」フィールドに設定されます。複数のゾーンおよびプールを追加した場合、検索アイコンをクリックしてリストからホスト・ターゲットを選択する必要があります。

10. 次をクリックします。サービス・テンプレートの新規作成: 構成ページが表示されます。次の詳細を指定します。

- ワークロード・サイズ: ワークロードは、各サービスのCPU合計、メモリーおよび記憶域要件を表します。スキーマ・サービスに対して小、中、大などのワークロード・サイズを定義できます。「作成」をクリックし、「ワークロードの作成」ウィンドウで、各サービスの名前、CPU、メモリーおよび記憶域制限を入力します。ワークロード・サイズを選択し、「デフォルト」をクリックしてそれをデフォルト・ワークロード・サイズとして指定します。

- スキーマ権限の割当て: 既存のロールを選択するか、すべてのスキーマに割り当てられるロールを作成できます。CREATE_SESSIONやCREATE DIMENSIONなどのすべてのデータベース権限を、ロールに付与できます。ユーザー名、説明、およびユーザーに付与する権限を入力します。

注意:

- 名前が指定されたロールがデータベース内にすでに存在する場合、データベース権限は変更できません。

- マスター・アカウントには、このサービス・リクエストの一部として作成されるすべてのスキーマに対して、CREATE SESSION、CREATE DIMENSION、CREATE INDEXTYPE、CREATE OPERATOR、CREATE PROCEDURE、CREATE SEQUENCE、CREATE TABLE、CREATE TRIGGER、CREATE TYPE、CREATE VIEWおよびCREATE SYNONYMの各権限が付与されます。

- 表領域: 表領域の記憶域構成を指定します。次の詳細を入力します。

- 最大サイズ: 表領域の最大サイズは、「無制限」または「リクエスト時に選択されたワークロード・サイズで指定」のいずれかです。

- 自動拡張: このチェック・ボックスを選択して、新しいデータ・ファイルを自動的に拡張します。このチェック・ボックスが選択されている場合は、次の詳細を入力します。
初期サイズ: 表領域の初期サイズを入力します。

増分: データ・ファイルを自動的に増やすサイズを指定します。

11. 次をクリックします。サービス・テンプレートの作成: スクリプト・ページが表示されます。サービス・インスタンスの作成前と作成後に実行する必要があるカスタム・スクリプトを指定します。

図16-6 サービス・テンプレートの作成: スクリプト(空のスキーマ)

12. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、スキーマのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、スキーマのリクエスト時にこのプロパティの値を変更できません。

13. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。

14. 「次」をクリックして、「確認」ページに進みます。これまでに入力した詳細を確認し、「発行」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。「サービス・テンプレート名」リンクをクリックして、追加の詳細を表示できます。

16.8 チャージバックの構成

オプションで、チャージバック・サービスを構成できます。第43章「チャージバック管理」を参照してください。

16.9 スキーマのリクエスト

セルフ・サービス・ユーザーは、データベース・テンプレート・プロファイルに基づいてサービス・テンプレートを選択し、データベースを作成できるようになりました。第22.2.1項「スキーマのリクエスト」を参照してください。

17 プラガブル・データベースのプロビジョニング

この章では、プラガブル・データベースのプロビジョニングに必要なプロセスについて説明します。次のセクションがあります。

- 開始

- リソース・プロバイダの作成

- エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成

- リクエスト設定の構成

- 割当て制限の定義

- プロファイルに基づくPDBのサービス・テンプレートの作成

- 空のPDBのサービス・テンプレートの作成

- チャージバックの構成

- プラガブル・データベースのリクエスト

17.1 開始

Oracle Databaseには、Oracle Netクライアントに個別のデータベースとして表示される、スキーマ、スキーマ・オブジェクト、および非スキーマ・オブジェクトのポータブル・コレクションを含めることができます。この自己完結型コレクションは、プラガブル・データベース(PDB)と呼ばれます。マルチテナントのコンテナ・データベース(CDB)は、1つ以上のPDBを含むデータベースです。Oracle Database 12c リリース1 (12.1)以上のバージョンでは、1つのCDB内に多数のPDBを作成できます。

表17-1 プラガブル・データベースのプロビジョニング

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

2

1つ以上のリソース・プロバイダを作成します。

第17.2項「リソース・プロバイダの作成」を参照してください。

4

リクエスト設定を構成します。

第17.4項「リクエスト設定の構成」を参照してください。

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第17.5項「割当て制限の定義」を参照してください。

6

データベース・プロビジョニング・プロファイルを作成します。この手順は、空のプラガブル・データベースを作成する場合はオプションで、必須ではありません。

第17.3項「エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

7

サービス・テンプレートを作成します。サービス・テンプレートは、次を含むことができます。

- 空のプラガブル・データベース: この場合、サービス・テンプレートは空のスキーマで作成されます。

- プロファイルのプラガブル・データベース: この場合は、データベース・プロビジョニング・プロファイルからスキーマをインポートできます。eBusinessアプリケーションなどのデータを使用したアプリケーションに対してこのオプションを選択できます。

第17.6項「プロファイルに基づくPDBのサービス・テンプレートの作成」を参照してください。

8

チャージバック・サービスを構成します。

第17.8項「チャージバックの構成」を参照してください。

9

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第22.2.2項「プラガブル・データベースのリクエスト」を参照してください。

17.2 リソース・プロバイダの作成

次のような1つ以上のリソース・プロバイダを作成する必要があります。

- PaaSインフラストラクチャ・ゾーン: 第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

- データベース・プール: 第17.2.1項「PDB as a Service用のデータベース・プールの作成」を参照してください。

17.2.1 PDB as a Service用のデータベース・プールの作成

プラガブル・データベース(PDB)は、個別のデータベースとしてアプリケーションに論理的に表示されるスキーマ、スキーマ・オブジェクト、および関連する構造の移植可能なセットです。この自己完結型コレクションは、プラガブル・データベース(PDB)と呼ばれます。各PDBは、SYSユーザーにより所有されます。

コンテナは、個別のデータベースとしてアプリケーションに論理的に表示されるコンテナ・データベース(CDB)内のスキーマ、オブジェクトおよび関連する構造のコレクションです。コンテナ・データベース(CDB)は、ゼロまたは1つ以上のユーザーが作成したPDBを含むOracle Databaseです。

PDB as a Serviceのデータベース・プールは、コンテナ・データベースのセットが含まれている必要があります。コンテナ・データベースは、次のガイドラインを満たす必要があります。

- データベース・プール内のすべてのCDBは、同じバージョンおよびプラットフォームである必要があります。

- データベース・プール内のすべてのCDBは、単一インスタンス・データベースかRACデータベースのいずれかである必要があります。データベース・タイプの混在はサポートされていません。

PDB as a Service用のデータベース・プールを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。データベース・サービス・ファミリの横の「設定」リンクをクリックし、ドロップ・ダウン・リンクから「プラガブル・データベース」を選択し、「プラガブル・データベース・プール」リンク、「作成」の順にクリックします。

図17-1 データベース・プールの作成: 設定ページ(PDB)

3. データベース・プールの名前および説明を入力します。

4. 「資格証明」リージョンで、データベース操作の実行に使用される資格証明を指定します。次の資格証明を指定します。

- ホスト: リモート・ホスト操作の実行に必要です。

- グリッド・インフラストラクチャ: データベース・サービスをグリッド・インフラストラクチャ資格証明に登録するために必要です。

- データベース: プラガブル・データベースの作成に必要です。

- コンテナ・データベース・ウォレット・パスワード: PDBを暗号化する必要がある場合、ウォレットをキーストアから開くために必要なパスワードを指定する必要があります。

5. 次の詳細を指定します。

- PaaSインフラストラクチャ・ゾーン: コンテナ・データベースが存在するPaaSインフラストラクチャ・ゾーンを選択します。PDBは、プールに選択したデータベースに作成されます。コンテナ・データベースの作成の詳細は、第12.5項「PDB as a Serviceのコンテナ・データベースのプロビジョニング」を参照してください。

- ターゲット・タイプ: PDBをデプロイするターゲット・データベースの構成を指定します。これは、単一インスタンスまたはクラスタ・データベース(RAC)のいずれかになります。

- プラットフォームおよびバージョン: デプロイするデータベースのプラットフォームおよびバージョンを指定します。

6. 「追加」をクリックし、プールに追加する1つ以上のコンテナ・データベースを選択します。選択するすべてのデータベースは、同じPaaSインフラストラクチャ・ゾーンに存在する必要があります。

注意:
「グループ」フィールドの検索文字列を指定して、要件を満たすデータベース・グループを検索できます。

7. 次をクリックします。新規プールの作成: ポリシーページが表示されます。

図17-2 「データベース・プールの作成: ポリシー」(PDB)

配置ポリシー制約を指定して、各データベースのリソース使用率の上限値を設定します。各データベースの配置ポリシー制約は、次のようなサービスまたはワークロードによって定義できます。

- プラガブル・データベース: 「プラガブル・データベース」チェック・ボックスを選択し、各CDB内に作成できるプラガブル・データベースの最大数を指定します。

- サービス・リクエストに関連付けられているワークロード: ワークロードを管理するリソース(CPUやメモリーなど)の量をここで指定できます。プラガブル・データベースに適用するワークロードを指定します。

- 最大CPU割当て: 各データベースに割り当てることができる最大CPUを指定します。

- 最大メモリー割当て: 各データベースに割り当てることができる最大メモリーを指定します。

たとえば、コンテナ・データベースが4GBのSGAを持つ2つのCPUにケージされ、最大CPU割当ておよび最大メモリー割当てを80%に指定すると、次のようになります。

- 各プラガブル・データベースの最大CPU制限は1.6

- 各プラガブル・データベースの最大SGA/メモリー制限は3.2

8. サービス・リクエストに関連付けられているワークロードによる配置制約の設定を選択した場合、CPU用のリソース・マネージャの有効化チェック・ボックスを選択して、リソース・マネージャの有効化を選択できます。リソース・マネージャを使用して、CPUリソースを管理し、コンシューマ・グループを作成できます。コンシューマ・グループは、完全にロードされたシステム上で、要求されたCPUサイクルをサービスが取得したことを確認するために使用されます。

9. 「発行」をクリックして、PDB as a Service用のデータベース・プールを作成します。新しく作成されたデータベース・プールが、データベース・クラウド・セルフ・サービス・ポータルの設定: データベース・プール・ページに表示されます。

17.3 エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成

データベース・プロビジョニング・プロファイルを作成するには、次の手順に従います。

1. 次のいずれかの方法を使用して、データベースのプロビジョニング・ページにアクセスできます。

- 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページで、「Oracle Cloud」をクリックし、「設定」、「データソース」の順に選択します。データベース: データソース・ページの「データ・プロファイル」タブで、「作成」をクリックします。

- 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」、「データベースのプロビジョニング」を選択します。データベースのプロビジョニング・ページの「プロファイル」セクションで、「作成」をクリックします。

- データベース・ターゲットのホームページで、「Oracle Database」をクリックし、「プロビジョニング」、「プロビショニング・プロファイルの作成」の順に選択します。

2. 参照ターゲット・ページで、検索アイコンをクリックして、ターゲットを選択します。

3. 「検索と選択: ターゲット」ダイアログ・ボックスで、プロファイルを作成するデータベースを選択して、「選択」をクリックします。

4. 「参照ターゲット」ページで、次を選択します。

- データ・コンテンツ

- データベースから物理ファイルおよび構造ファイルを組み込むための「構造およびデータ」、またはテンプレート内の構造ファイルのみを組み込むための「構造のみ」。

- スキーマ・オブジェクトのエクスポート

5. 「資格証明」セクションで、データベースを選択します。「資格証明」列で、「名前付き資格証明」を選択して「資格証明名」列から資格証明名を選択するか、「優先資格証明」を選択します。「次」をクリックします。

6. コンテンツ・オプション・ページで、次の操作を実行します。

- 「使用可能なスキーマ」リストでスキーマをクリックして「選択したスキーマ」リストに移動し、プロファイルに組み込むスキーマを選択します。

注意:
1つ以上のスキーマを選択した場合、データベースによって、依存スキーマもエクスポート用に選択されているかどうかが確認されます。依存スキーマがエクスポートされない場合、警告が表示されます。選択したスキーマでそのまま続行することも、最初に選択しなかったスキーマを含めることもできます。
依存スキーマがエクスポートされないプロファイルを選択した場合にも、同じ警告が表示されます。

注意:
「使用可能なスキーマ」セクションには、データ・コンテンツが含まれているユーザーが作成したスキーマのみが表示されます。空のスキーマはすべてデフォルトでフィルタにより除外されています。

注意:
SYS、SYSTEMおよびDBSNMPなどのシステム・スキーマはエクスポートされません。
独自の表領域を持たないユーザー・スキーマは、シャトルの左側に表示されません。

- 「並列度」セクションで、エクスポート操作を実行するために必要なスレッドの数を入力します。

注意:
スレッドの数を増やすと、プログラムの作成に必要な時間を短縮できますが、システム・リリースの使用量が増えます。

- 「ディレクトリの場所」セクションで、「追加」をクリックします。「ディレクトリを選択」ウィンドウで、エクスポート操作をするためにリストされているディレクトリ・オブジェクトを選択し、「選択」をクリックします。

注意:
エクスポート・スレッドの数によって、エクスポート中にパラレルに実行されるパラレル・エクスポート・プロセスの数が決定されます。
そのため、実行数でファイル名を自動生成してダンプ・ファイルの最大サイズに基づくパラレル操作を容易にするため、ダンプ・ファイル名に%Uを含める必要があります。たとえば、5GBとします。これは、5GBの制限に到達した後にファイル・ローテーションが開始することを意味します。

注意:
ディレクトリの場所にアクセスできることを確認してください。選択するディレクトリ・オブジェクトは、すべてのノード全体でアクセスできる場所を示している必要があります。ASMにディレクトリ・オブジェクトを作成することもできます。ただし、これはASMではサポートされません。

「ログ」サブセクションで、検索アイコンをクリックします。「ディレクトリを選択」ウィンドウで、エクスポート操作をするために必要なディレクトリ・オブジェクトを選択し、「選択」をクリックします。

「ログ」サブセクションで、ファイル名を入力し、「次」をクリックします。

注意:
ダンプ・ファイル名によって並列度を使用できます。ダンプ・ファイルのデフォルト値には、並列度が1より大きい場合に実行数を作成する%Uが含まれます。
これによって、複数のダンプ・ディレクトリを追加して必要に応じて記憶域を分散できます。

7. データベース・プロビジョニング・プロファイルの作成・ページの「プロファイル情報」セクションで、次の操作を行います。

- データベース・プロファイルが作成されるソフトウェア・ライブラリ内のプロファイルの場所を指定または選択します。

- 一意のプロファイル名を指定します。

For example:
Export Schema Objects Provisioning Profile for HR database

- プロファイルの説明を追加します。

- プロファイル・バージョンとベンダーを確認します。

- ホスト名、データベース、データ・コンテンツ、データ・コンテンツ・モジュールなどのノートを追加します。

8. 「スケジュール」セクションで、プロファイルの作成をすぐに開始するか、後でスケジュールできます。また、プロビジョニング・プロファイルの作成の繰返しを選択し、繰返し時間を設定することもできます。

9. 作業ディレクトリを指定または選択します。「次」をクリックします。

10. 確認ページで、前のページで行った選択内容が正しく表示されていることを確認し、「発行」をクリックします。正しく表示されていない場合は、変更を行うページに達するまで「戻る」を繰り返しクリックします。プロビジョニング・プロファイルの作成を中断するには、「取消」をクリックします。

「データの表示」が「リアル・タイム: 手動リフレッシュ」に設定されている場合、プロビジョニング・プロファイルの作成ジョブを発行したら、ページを手動でリフレッシュしてください。それ以外の場合、一定の期間経過後にリロードするように「データの表示」を設定し、左側のペインの「プロシージャ・ステップ」ツリーから実行ステップを選択して詳細を表示します。

発行したジョブを表示するには、「データ・プロファイル」タブで「プロシージャ・アクティビティ」リンクを選択します。

17.4 リクエスト設定の構成

リクエストできる時間、その期間などを指定して、リクエスト設定を構成できます。第11.2.3項「リクエスト設定の構成」を参照してください。

17.5 割当て制限の定義

リクエスト設定を構成した後で、各セルフ・サービス・ユーザーの割当て制限を定義する必要があります。第11.2.4項「割当て制限の設定」を参照してください。

17.6 プロファイルに基づくPDBのサービス・テンプレートの作成

サービス・テンプレート定義に基づいて1つ以上のプラガブル・データベースを作成できます。PDB as a Service用のサービス・テンプレートを作成するには、次の手順を実行します。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「プラガブル・データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図17-3 「サービス・テンプレートの作成: 一般」(PDB)

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「プラガブル・データベース」リージョンで、「プロファイル」オプションから「プラガブル・データベースの作成」を選択し、プラガブル・データベースの作成に使用するデータベース・プロビジョニング・プロファイルを選択します。「プロファイル」フィールドの隣にある「検索」アイコンをクリックし、リストからエクスポート・スキーマ・オブジェクト・プロファイルを選択します。プロファイルが存在しない場合は、作成する必要があります。詳細は、第16.3項「エクスポート・スキーマ・オブジェクトを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

- 注意:
切断されたPDBからPDBを作成することもできます。次の手順を実行します。

- コンテナ・データベースからPDBを切断し、PDBテンプレート(データファイルとメタデータXMLファイルを含む)を格納するソフトウェア・ライブラリ内の場所を指定します。

- サービス・テンプレートの作成ウィザードで、「共有場所」フィールドにPDBテンプレートの場所を指定します。指定したデータファイルに基づいてPDBが作成されます。

8. 「プールとゾーン」リージョンで、「追加」をクリックして、プラガブル・データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。ゾーンのデータベース・プール(プラガブル・データベース用)を追加する「プールの割当て」をクリックします。

注意:
PDB用のデータベース・プールは、ここで選択するPaaSインフラストラクチャ・ゾーンに存在する必要があります。

9. データベース・プールを割り当てると、プラガブル・データベースの追加先となるコンテナ・データベースが「参照コンテナ・データベース」フィールドに表示されます。サービス・テンプレートに対するすべての検証は、このデータベースに対して実行されます。

10. 「プラガブル・データベース」リージョンで「プロファイルからのプラガブル・データベースの作成」を選択した場合、「共有場所」フィールドで、スキーマ・ダンプが存在するすべてのホストのパスまたは共有場所を指定します。ダンプ・ファイルの場所は、すべてのデータベースからアクセスできる必要があります。

11. 「配置」リージョンで、次のいずれかのオプションを使用してコンテナ・データベースにプラガブル・データベースをプロビジョニングできます。

- 配置アルゴリズムにより選択済: このオプションが選択されている場合、コンテナ・データベースは配置アルゴリズムに基づいて選択されます。

- リクエスト中にユーザーにより選択済: このオプションが選択されている場合、新規PDBのリクエスト時に、セルフ・サービス・ユーザーはPDBがプロビジョニングされるコンテナ・データベースを選択できます。

12. 「ID」リージョンのプラガブル・データベースの接頭辞名フィールドに、データベースの作成時に一意のプラガブル・データベース名の生成に使用する接頭辞を指定します。接頭辞は、このサービス・テンプレートを使用して作成されたPDBを識別するのに役立ちます。

13. 次をクリックします。サービス・テンプレートの新規作成: 構成ページが表示されます。

図17-4 「サービス・テンプレートの作成: 構成」(PDB)

次の詳細を指定します。

- ワークロード・サイズ: ワークロードは、各サービスのCPU合計、メモリー、セッション数および記憶域要件を表します。小、中、大などのワークロード・サイズを定義できます。ここで定義するワークロード・サイズは、EM_SSA_USERロールを持つユーザーが使用できるデフォルトのワークロード・サイズになります。
「作成」をクリックし、「ワークロードの作成」ウィンドウで、各サービスの名前、CPU、メモリーおよび記憶域制限を入力します。

- プラガブル・データベース管理者権限: 次の手順を実行することにより、権限をプラガブル・データベース管理者に割り当てることができます。

- 既存データベース・ロール: このオプションを選択したら、「ロールの追加」をクリックして、1つ以上の既存のロールを追加します(このロールから、権限がプラガブル・データベース管理者に割り当てられます)。

- 新しいデータベース・ロールの作成: このオプションを選択したら、「ロール名」、説明、CREATE_SESSION、ALTER_SESSION、CREATE ANY OPERATOR、CREATE ANY PROCEDUREなどの「権限」を指定する必要があります。

- プラガブル・データベースの記憶域: PDB記憶域の最大サイズは、「無制限」または「リクエスト時に選択されたワークロード・サイズで指定」のいずれかです。

- 表領域: プロファイル内の表領域が表示されます。表領域の「初期サイズ」の値は編集できます。

注意:
表領域データ暗号化(TDE)キーを指定すると、暗号化された表領域を作成できます。これによって、表領域のデータが暗号化または復号化されます。暗号化された表領域でプロファイルを使用する場合、ここでウォレット・パスワードの入力を求められます。

14. 次をクリックします。サービス・テンプレートの作成: 初期化パラメータページが表示されます。このページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択して、「セット」アイコンをクリックして、パラメータの値を変更します。

15. 次をクリックします。サービス・テンプレートの作成: カスタマイズ・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。

16. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を変更できません。

17. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするEM_SSA_USERロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。

18. 次をクリックします。サービス・テンプレートの作成: 確認ページが表示され、それまでに指定した詳細を確認できます。

19. 「発行」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。「サービス・テンプレート名」リンクをクリックして、追加の詳細を表示できます。

17.7 空のPDBのサービス・テンプレートの作成

サービス・テンプレート定義に基づいて1つ以上のプラガブル・データベースを作成できます。PDB as a Service用のサービス・テンプレートを作成するには、次の手順を実行します。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「プラガブル・データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図17-5 「サービス・テンプレートの作成: 一般」(PDB)

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「プラガブル・データベース」リージョンで、「空のプラガブル・データベースの作成」オプションを選択して、ユーザーが構成できる空のPDBを作成します。

8. 「プールとゾーン」リージョンで、「追加」をクリックして、プラガブル・データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。ゾーンのデータベース・プール(プラガブル・データベース用)を追加する「プールの割当て」をクリックします。

注意:
PDB用のデータベース・プールは、ここで選択するPaaSインフラストラクチャ・ゾーンに存在する必要があります。

9. データベース・プールを割り当てると、プラガブル・データベースの追加先となるコンテナ・データベースが「参照コンテナ・データベース」フィールドに表示されます。サービス・テンプレートに対するすべての検証は、このデータベースに対して実行されます。

10. 「配置」リージョンで、次のいずれかのオプションを使用してコンテナ・データベースにプラガブル・データベースをプロビジョニングできます。

- 配置アルゴリズムにより選択済

- リクエスト中にユーザーにより選択済

11. 「ID」リージョンのプラガブル・データベースの接頭辞名フィールドに、データベースの作成時に一意のプラガブル・データベース名の生成に使用する接頭辞を指定します。接頭辞は、このサービス・テンプレートを使用して作成されたPDBを識別するのに役立ちます。

12. 次をクリックします。サービス・テンプレートの新規作成: 構成ページが表示されます。

図17-6 「サービス・テンプレートの作成: 構成」(PDB)

次の詳細を指定します。

- ワークロード・サイズ: ワークロードは、各サービスのCPU合計、メモリー、セッション数および記憶域要件を表します。小、中、大などのワークロード・サイズを定義できます。ここで定義するワークロード・サイズは、EM_SSA_USERロールを持つユーザーが使用できるデフォルトのワークロード・サイズになります。
「作成」をクリックし、「ワークロードの作成」ウィンドウで、各サービスの名前、CPU、メモリーおよび記憶域制限を入力します。

- プラガブル・データベース管理者権限: 次の手順を実行することにより、権限をプラガブル・データベース管理者に割り当てることができます。

- 既存データベース・ロール: このオプションを選択したら、「ロールの追加」をクリックして、1つ以上の既存のロールを追加します(このロールから、権限がプラガブル・データベース管理者に割り当てられます)。

- 新しいデータベース・ロールの作成: このオプションを選択したら、「ロール名」、説明、CREATE_SESSION、ALTER_SESSION、CREATE ANY OPERATOR、CREATE ANY PROCEDUREなどの「権限」を指定する必要があります。

- プラガブル・データベースの記憶域: PDB記憶域の最大サイズは、「無制限」または「リクエスト時に選択されたワークロード・サイズで指定」のいずれかです。

- 表領域: 新しい空のPDBに存在する必要のある表領域の数を指定します。

13. 次をクリックします。サービス・テンプレートの作成: 初期化パラメータページが表示されます。このページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択して、「セット」アイコンをクリックして、パラメータの値を変更します。

14. 次をクリックします。サービス・テンプレートの作成: カスタマイズ・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。

15. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を変更できません。

16. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするEM_SSA_USERロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。

17. 次をクリックします。サービス・テンプレートの作成: 確認ページが表示され、それまでに指定した詳細を確認できます。

18. 「発行」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。「サービス・テンプレート名」リンクをクリックして、追加の詳細を表示できます。

17.8 チャージバックの構成

オプションで、チャージバック・サービスを構成できます。第43章「チャージバック管理」を参照してください。

17.9 プラガブル・データベースのリクエスト

セルフ・サービス・ユーザーは、サービス・テンプレートを選択し、プラガブル・データベースを作成できるようになりました。第22.2.2項「プラガブル・データベースのリクエスト」を参照してください。

第VII部

データベースのクローニング

この項では、プロファイルを使用して、またはライブ・データベースからフル・クローンまたはスナップ・クローンを作成する方法を説明します。

この部の内容は次のとおりです。

- 第18章「サポートされるクローニング・オプション」

- 第19章「フル・クローンの作成」

- 第20章「データベースのスナップ・クローンの作成」

- 第21章「プラガブル・データベースのスナップ・クローンの作成」

18 サポートされるクローニング・オプション

この章では、データベースをクローニングするためにEnterprise Managerによって提供される様々なオプションについて説明します。次のセクションがあります。

- データ・ライフサイクル管理について

- サポートされるクローニング・オプション

18.1 データ・ライフサイクル管理について

データ・ライフサイクル管理(DLM)は、Enterprise Managerによって提供される完全なエンドツーエンド・ソリューションであり、管理者がマスク後の本番データベースをリフレッシュしたり、大きなデータベースをオンデマンドで瞬時にクローニングできるようにします。DLMソリューションの特徴は次のとおりです。

- フルおよびシン・データベース・クローンの作成をサポートします。

- テクノロジに依存しません(ストレージとベンダーに依存しません)。

- 本番データのマスキングとインライン・パッチ適用を統合します。

- クラウド・セルフ・サービス・ポータルとデータベースのプロビジョニング・ダッシュボードを通じてアクセスできます。

- EMCLIおよびRest APIを通じて使用できます。

18.2 サポートされるクローニング・オプション

通常、IT環境では、アプリケーションの開発とテストのために本番データの複数のコピーが必要となります。アプリケーションの開発者またはテスト実施者がデータベースのクローンを必要とする場合、一般的には承認サイクルを経る必要があり、その後に煩雑で時間のかかるクローニング・プロセスを開始しますが、これには数日かかることもあります。クローンは複数のユーザーおよびアプリケーションで共有されますが、複数ユーザーによる共有が増える結果としてパフォーマンスが低下します。このような環境において、本番データベースへの変更を反映するためのテスト・データのリフレッシュは、通常は固定したスケジュールで行われ、必要な頻度では実施されないことがあります。その結果として、ともすれば、開発者およびテスト実施者が最新データを使用してテストすることの徹底が難しくなります。

最新のデータを含むデータベース・クローンを作成するには、次の手順を実行します。

- クローン対象とする本番データベースを識別します。

- RMANバックアップやRMANイメージなどを使用して定期的なバックアップを取得します。

- 機密データをマスクします。

- テスト・マスター・データベースのデータをマスクおよびサブセット化します

- 本番データベースのサニタイズされたコピーであるテスト・マスターを作成するか、スタンバイ・データベースを作成します。

- パフォーマンスまたはストレス・テスト用にフル・クローンを、機能テスト用にスナップ・クローンを作成します。

- 本番データベースの変更との同期を維持するためにクローンをリフレッシュします。

Enterprise Managerを使用して、管理ダッシュボードまたはセルフ・サービス・ポータルからフル・クローンまたはスナップ・クローンを作成できます。次の図は、Enterprise Managerでサポートされるクローニング・オプションを示しています。

図18-1 サポートされるクローニング・オプション

Enterprise Managerでは次のものを作成できます。

- フル・クローン: 次のいずれかの方法を使用して、本番データベースのフル・コピーまたは完全コピーを作成できます。

- RMANバックアップ

- RMAN複製

- データ・ポンプ

詳細は、第19章「フル・クローンの作成」を参照してください。

- スナップ・クローン: データベースのコピー・オン・ライト・テクノロジを使用して、スナップ・クローンまたはシン・クローンを作成できます。このモデルでは、最小限の領域で即座にクローニングが実行されるため、機能テストに最適です。スナップ・クローンは、次のいずれかのソリューションを使用して作成できます。

- ソフトウェア・ソリューション

- ハードウェア・ソリューション

詳細は、第20章「データベースのスナップ・クローンの作成」を参照してください。

19 フル・クローンの作成

この章では、フル・データベース・クローンの作成方法について説明します。次のセクションがあります。

- RMANバックアップを使用したセルフ・サービス・ポータルからのフル・データベース・クローンの作成

- RMAN複製を使用したセルフ・サービス・ポータルからのフル・データベース・クローンの作成

19.1 RMANバックアップを使用したセルフ・サービス・ポータルからのフル・データベース・クローンの作成

RMAN (Recovery Manager)によって作成されたデータベース・バックアップは、イメージ・コピーまたはバックアップ・セットとして格納されます。これらのバックアップを使用してプロファイルを作成し、それらのプロファイルを使用してフル・データベース・クローンを作成できます。

表19-1 RMANバックアップを使用したフル・データベース・クローンの作成

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

2

1つ以上のリソース・プロバイダを作成します。

第19.1.1項「リソース・プロバイダの作成」を参照してください。

4

リクエスト設定を構成します。

第11.2.3項「リクエスト設定の構成」を参照してください。

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第11.2.4項「割当て制限の設定」を参照してください。

6

次のいずれかのタイプのプロファイルを作成します。

- RMANバックアップ

- 既存のRMANバックアップ

関連項目:

- 第19.1.2.1項「RMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成」

- 第19.1.2.2項「既存のRMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成」

8

作成したプロファイルに基づくサービス・テンプレートを作成します。

第19.1.5項「RMANバックアップ・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

9

チャージバック・サービスを構成します。

第19.1.6項「チャージバックの構成」を参照してください。

10

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第22.2項「データベースのリクエスト」を参照してください。

19.1.1 リソース・プロバイダの作成

次のような1つ以上のリソース・プロバイダを作成する必要があります。

- PaaSインフラストラクチャ・ゾーン: 第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

- データベース・プール: 第19.1.1.1項「Database as a Service用のデータベース・プールの作成」を参照してください。

19.1.1.1 Database as a Service用のデータベース・プールの作成

Database as a Service用のデータベース・プールを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。データベース・サービス・ファミリの横の「設定」リンクをクリックし、「データベース・プール」リンク、「作成」の順にクリックします。

図19-1 データベース・プールの作成

3. 「資格証明」リージョンで、次の資格証明を指定します。

- ホスト: データベースの作成および起動に必要です。

- ルート: これは、オプション・フィールドです。スナップ・クローン・プロファイルに基づいてデータベース・リクエストにこのデータベース・プールを使用する予定の場合、これは必須です。第20章「データベースのスナップ・クローンの作成」を参照してください。

- グリッド・インフラストラクチャ: これは、オプション・フィールドです。ASMを使用するデータベースのライブ・クローニングにこのデータベース・プールを使用する予定の場合、これは必須です。

4. データベース・プールの名前および説明を入力します。

5. 次の詳細を指定します。

- PaaSインフラストラクチャ・ゾーン: データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。

- データベース構成: プロビジョニングするデータベースの構成を指定します。シングル・インスタンスまたはクラスタ・データベース(RAC)のいずれかにすることができますが、両方を組み合せることはできません。

- プラットフォームおよびバージョン: デプロイするデータベースのプラットフォームおよびバージョンを指定します。

6. 「追加」をクリックし、データベース・プールに追加する1つ以上のOracleホームを選択します。

7. 「データベース・インスタンスの最大数」(1ホスト当たり)に、プール内の各ホストで実行可能なデータベース・インスタンスの最大数を入力します。

注意:
RACデータベースの場合、このフィールドに指定されている値を使用して、データベースを作成するノードがこの基準を満たしていることを確認します。

8. 「発行」をクリックして、データベース・プールを作成します。新しく作成されたプールが、データベース・クラウド・セルフ・サービス・ポータルの設定: データベース・プール・ページに表示されます。現在は、データベース・プールをサービス・テンプレートに追加できます。

19.1.2 データベース・プロビジョニング・プロファイルの作成

次のいずれかのタイプのプロファイルを作成できます。

- RMANバックアップ。第19.1.2.1項「RMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

- 既存のRMANバックアップ。第19.1.2.2項「既存のRMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

注意:
テスト・マスター・データベースとして指定されているデータベースからプロファイルを作成することをお薦めします。テスト・マスターの設定の詳細は、第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください。

19.1.2.1 RMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成

データベース・プロビジョニング・プロファイルを作成するには、次の手順に従います。

1. 次のいずれかの方法を使用して、データベースのプロビジョニング・ページにアクセスできます。

- 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページで、「Oracle Cloud」をクリックし、「設定」、「データソース」の順に選択します。データベース: データソース・ページの「データ・プロファイル」タブで、「作成」をクリックします。

- 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」、「データベースのプロビジョニング」を選択します。データベースのプロビジョニング・ページの「プロファイル」セクションで、「作成」をクリックします。

- データベース・ターゲットのホームページで、「Oracle Database」をクリックし、「プロビジョニング」、「プロビショニング・プロファイルの作成」の順に選択します。

2. 参照ターゲット・ページで、検索アイコンをクリックして、ターゲットを選択します。

3. 「検索と選択: ターゲット」ダイアログ・ボックスで、プロファイルを作成するデータベースを選択して、「選択」をクリックします。

4. 「参照ターゲット」ページで、次を選択します。

- データ・コンテンツ

- 「構造およびデータ」を選択し、データベースから物理ファイルと構造ファイルを含めます。

- 作成

- RMANバックアップ

5. 「資格証明」セクションで、データベースを選択します。「資格証明」列で、「名前付き資格証明」を選択して「資格証明名」列から資格証明名を選択するか、「優先資格証明」を選択します。「次」をクリックします。

6. コンテンツ・オプション・ページで、次の操作を実行します。

- 「オンライン・バックアップ」または「オフライン・バックアップ」を選択します。

- チャネルの数を入力します。

注意:
チャネルは、RMANとデータベース間の接続です。RMANバックアップのチャネルの使用方法によって、並列度が設定されます。各チャネルは、デバイス・タイプに対する1つのデータ・ストリームを表します。割り当てるチャネルの数が増えるほど、バックアップ・ジョブの実行速度が向上します。使用できるチャネルの最大数は、25です。

- (オプション)圧縮ファイルを選択し、圧縮の「高」、「中」または「低」の強度を選択します。

- (オプション)ファイル暗号化を使用を選択し、パスワードを入力した後にパスワードを確認します。

- 「バックアップ」の場所の「ディレクトリ」を選択してディレクトリ・パスを入力するか、バックアップの場所がすでに含まれている「高速リカバリ領域」を選択します。

注意:
指定の場所が、データベース・プール内のノードへアクセス可能であることを確認してください。

- バックアップ・ファイル名形式を入力します。これは、バックアップ・ファイルの生成に使用されます。
バックアップ・ファイル・タグ、制御ファイル名および制御ファイル・タグ。

- バックアップ・ファイル・タグを入力します。バックアップ・ファイルは、このタグでタグ付けされます。

- 制御ファイル名を入力します。制御ファイル・バックアップは、この名前で生成されます。

- 「次」をクリックします。

7. データベース・プロビジョニング・プロファイルの作成・ページの「プロファイル情報」セクションで、次の操作を行います。

- データベース・プロファイルが作成されるソフトウェア・ライブラリ内のプロファイルの場所を指定または選択します。

- 一意のプロファイル名を指定します。

For example:
RMAN Backup Profile for HR database

- プロファイルの説明を追加します。

- プロファイル・バージョンとベンダーを確認します。

- ホスト名、データベース、データ・コンテンツ、データ・コンテンツ・モジュールなどのノートを追加します。

8. 「スケジュール」セクションで、プロファイルの作成をすぐに開始するか、後でスケジュールできます。また、プロビジョニング・プロファイルの作成の繰返しを選択し、繰返し時間を設定することもできます。

注意:
「サービス・テンプレート」で定期的なRMANプロファイルが使用されている場合は、SSA_adminとして、すべてのバックアップ部分をプール間の共有場所に同期的に転送する方法がデバイスに必要です。または、共有nfsディレクトリにバックアップを取得する必要があります。

9. 「ポリシーのパージ」セクションには、次の3つのオプションが表示されます。

- なし。このオプションは、収集したデータをパージしない場合に選択します。

- スナップショット。このオプションでは、パージできるスナップショットの最大数を指定できます。

- 日間。このオプションでは、データ・コンポーネントのパージが必要になるまでの日数を指定できます。

10. 作業ディレクトリを指定または選択します。「次」をクリックします。

11. 確認ページで、前のページで行った選択内容が正しく表示されていることを確認し、「発行」をクリックします。正しく表示されていない場合は、変更を行うページに達するまで「戻る」を繰り返しクリックします。プロビジョニング・プロファイルの作成を中断するには、「取消」をクリックします。

「データの表示」が「リアル・タイム: 手動リフレッシュ」に設定されている場合、プロビジョニング・プロファイルの作成ジョブを発行したら、ページを手動でリフレッシュしてください。それ以外の場合、一定の期間経過後にリロードするように「データの表示」を設定し、左側のペインの「プロシージャ・ステップ」ツリーから実行ステップを選択して詳細を表示します。

発行したジョブを表示するには、「データ・プロファイル」タブで「プロシージャ・アクティビティ」リンクを選択します。

19.1.2.2 既存のRMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成

データベース・プロビジョニング・プロファイルを作成するには、次の手順に従います。

1. 次のいずれかの方法を使用して、データベースのプロビジョニング・ページにアクセスできます。

- 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページで、「Oracle Cloud」をクリックし、「設定」、「データソース」の順に選択します。データベース: データソース・ページの「データ・プロファイル」タブで、「作成」をクリックします。

- 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」、「データベースのプロビジョニング」を選択します。データベースのプロビジョニング・ページの「プロファイル」セクションで、「作成」をクリックします。

- データベース・ターゲットのホームページで、「Oracle Database」をクリックし、「プロビジョニング」、「プロビショニング・プロファイルの作成」の順に選択します。

2. 参照ターゲット・ページで、検索アイコンをクリックして、ターゲットを選択します。

3. 「検索と選択: ターゲット」ダイアログ・ボックスで、プロファイルを作成するデータベースを選択して、「選択」をクリックします。

4. 「参照ターゲット」ページで、次を選択します。

- データ・コンテンツ

- 「構造およびデータ」を選択し、データベースから物理ファイルと構造ファイルを含めます。

- 既存のRMANバックアップの使用

5. 「資格証明」セクションで、データベースを選択します。「資格証明」列で、「名前付き資格証明」を選択して「資格証明名」列から資格証明名を選択するか、「優先資格証明」を選択します。「次」をクリックします。

6. コンテンツ・オプション・ページで、示されたリストから既存のRMANバックアップを選択します。

注意:
既存のRMANバックアップのリストは、データベースからフェッチされます。複数のタグがあるバックアップがサポートされます。

「次」をクリックします。

7. データベース・プロビジョニング・プロファイルの作成・ページの「プロファイル情報」セクションで、次の操作を行います。

- データベース・プロファイルが作成されるソフトウェア・ライブラリ内のプロファイルの場所を指定または選択します。

- 一意のプロファイル名を指定します。

For example:
Existing RMAN Backup Profile for HR database

- プロファイルの説明を追加します。

- プロファイル・バージョンとベンダーを確認します。

- ホスト名、データベース、データ・コンテンツ、データ・コンテンツ・モジュールなどのノートを追加します。

8. 「スケジュール」セクションで、プロファイルの作成をすぐに開始するか、後でスケジュールできます。また、プロビジョニング・プロファイルの作成の繰返しを選択し、繰返し時間を設定することもできます。

注意:
「サービス・テンプレート」で定期的なRMANプロファイルが使用されている場合は、SSA_adminとして、すべてのバックアップ部分をプール間の共有場所に同期的に転送する方法がデバイスに必要です。または、共有nfsディレクトリにバックアップを取得する必要があります。

9. 「ポリシーのパージ」セクションには、次の3つのオプションが表示されます。

- なし。このオプションは、収集したデータをパージしない場合に選択します。

- スナップショット。このオプションでは、パージできるスナップショットの最大数を指定できます。

- 日間。このオプションでは、データ・コンポーネントのパージが必要になるまでの日数を指定できます。

10. 作業ディレクトリを指定または選択します。「次」をクリックします。

11. 確認ページで、前のページで行った選択内容が正しく表示されていることを確認し、「発行」をクリックします。正しく表示されていない場合は、変更を行うページに達するまで「戻る」を繰り返しクリックします。プロビジョニング・プロファイルの作成を中断するには、「取消」をクリックします。

「データの表示」が「リアル・タイム: 手動リフレッシュ」に設定されている場合、プロビジョニング・プロファイルの作成ジョブを発行したら、ページを手動でリフレッシュしてください。それ以外の場合、一定の期間経過後にリロードするように「データの表示」を設定し、左側のペインの「プロシージャ・ステップ」ツリーから実行ステップを選択して詳細を表示します。

発行したジョブを表示するには、「データ・プロファイル」タブで「プロシージャ・アクティビティ」リンクを選択します。

19.1.3 リクエスト設定の構成

リクエストできる時間、その期間などを指定して、リクエスト設定を構成できます。第11.2.3項「リクエスト設定の構成」を参照してください。

19.1.4 割当て制限の定義

リクエスト設定を構成した後で、各セルフ・サービス・ユーザーの割当て制限を定義する必要があります。第11.2.4項「割当て制限の設定」を参照してください。

19.1.5 RMANバックアップ・プロファイルを使用したサービス・テンプレートの作成

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図19-2 サービス・テンプレートの作成(RMANバックアップ)

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「ソース識別」セクションで、「プロファイルの使用」ラジオ・ボタンを選択し、「検索」アイコンをクリックして、リストから「RMANバックアップ」プロファイルを選択します。

8. 「プロファイルのバージョン」フィールドで、次のいずれかを選択できます。

- 最新: これにより、セルフ・サービス・ユーザーによって最新のプロファイルが常に使用されます。

- リクエスト時にユーザーが選択: このオプションが選択されている場合、セルフ・サービス・ユーザーは、サービス・リクエストの作成時に使用するプロファイルのリビジョンを選択できます。

9. 「データベース定義」リージョンで、次の項目を指定します。

- タイプ: 単一インスタンスまたはReal Application Cluster (RAC)を指定できます。「RAC」を選択した場合は、ノード数を指定します。

- データベースSID: これは、オプション・フィールドです。「接頭辞の指定」または「リクエスト時にユーザーにより指定」を選択できます。

- 接頭辞の指定: このオプションを選択する場合、データベースの作成時に一意のシステム識別子(SID)を生成するために使用される接頭辞を入力します。接頭辞は、このサービス・テンプレートを使用して作成されたデータベースの識別に役立ちます。接頭辞には、最大6文字を使用できます。
生成される新しいデータベース名は、ここで指定されるSID接頭辞をベースにします。たとえば、接頭辞がMYDBと指定されている場合、新しいデータベースのSIDは、MYDB0000、MYDB0001、MYDB0002 (以降同様)と生成されます。

既存のデータベース(実行中のデータベースおよび処理中のリクエスト)については、単一インスタンス・データベースに対して一意のSID名が生成されるか、Real Application Clusterデータベースに対して一意の名前が生成されます。たとえば、ホストで実行中の既存のSIDがMYDB0000、MYDB0001、MYDB0002で、処理中がMYDB0003、MYDB0004である場合、新規リクエストに対して生成される新規SIDまたはデータベース名はMYDB0005です。

- リクエスト時にユーザーにより指定: このオプションを選択する場合、このフィールドを空白のままにして、データベース・リクエストの作成時にSIDを指定できます。

- ドメイン名: これは、オプション・フィールドです。作成する新しいデータベースに使用するドメイン名を入力します。ドメイン名の先頭には「.」(ドット)が付いていないことを確認してください。

- スタンバイ・データベースの有効化: このサービス・テンプレートを使用してスタンバイ・データベースをプロビジョニングする場合、このチェック・ボックスを選択します。このチェック・ボックスを選択する場合、スタンバイ・データベースを追加する必要があります。

10. 「ゾーン」リージョンで、「追加」をクリックして、データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。「プールの割当て」をクリックします。リストからプールを選択し、このプールをPaaSインフラストラクチャ・ゾーンに割り当てます。データベースはこのプール内にプロビジョニングされます。

11. ゾーンおよびプールを選択したら、ホスト・ターゲットが「参照ホスト」フィールドに設定されます。

12. 共有場所を指定して「次へ」をクリックします。

13. 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。次をクリックします。サービス・テンプレートの作成: データベースページが表示されます。

図19-3 サービス・テンプレートの作成: データベース(RMANバックアップ)

14. 「参照ホスト」リージョンに、データベース・クラウド・セルフ・サービス・ポータルの設定: 一般ページで選択したPaaSインフラストラクチャ・ゾーンの名前、データベース・プールおよび参照ホストが表示されます。
選択した自動ストレージ管理(ASM)ディスク・グループ、ファイル・システムの場所およびリスナー・ポートなどのデータベース値は、参照ホストで利用できる必要があります。

15. 次の項目を指定します。

- 記憶域タイプ: 次のいずれかです。

- 自動ストレージ管理: Oracle Automatic Storage Management (ASM)は、単一インスタンスおよびRAC構成をサポートするデータベース・ファイルのボリューム・マネージャおよびファイル・システムです。ASMでは、ストレージ・システム内のディスクを1つ以上のディスク・グループに分類します。ASMを選択する場合、ディスク・グループをここで選択します。

- ファイル・システム: Oracle Databaseのファイル・システムは、データベース表に格納されるファイルおよびディレクトリの標準ファイルシステム・インタフェースを作成します。このオプションを選択する場合、ファイル・システムの場所を指定するか選択する必要があります。

- 高速リカバリ(オプション): バックアップおよびリカバリ・ファイルの管理を簡略化するために、データベースに高速リカバリ領域を作成できます。「高速リカバリ領域の有効化」チェック・ボックスを選択して、リカバリに関連するファイルの格納先となる場所を指定します。高速リカバリ領域は、バックアップおよびリカバリ・ファイル用の集中化されたディスクの場所を提供する、ASMディスク・グループまたはファイル・システムである可能性があります。高速リカバリ領域の場所および高速リカバリ・サイズを指定します。高速リカバリ領域に割り当てるディスク領域の量は、データベースのサイズおよびアクティビティ・レベルによって異なります。
「アーカイブ有効化」チェック・ボックスが選択されている場合、リフレッシュ中にデータベースは停止しません。これにより、セルフ・サービス・ユーザーは、データベースを停止せずにバックアップおよびリストア操作をスケジュールできます。

16. 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。

17. 「管理者資格証明」を指定します。新しいデータベースのシステム・スキーマのパスワードを指定します。これらのスキーマは、EM_SSA_USERSに対して使用できません。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。これらの値が指定されていない場合は、デフォルト値が使用され、EM_ADMINISTRATORがそれらを変更できます。

18. システム・スキーマとは別に、他のスキーマへのアクセスを制限する場合、「非管理者資格証明」リージョンで選択して、パスワードを指定できます。これらのスキーマはロックされ、EM_SSA_USERSはアクセスできません。

19. マスター・アカウントの名前を入力します。マスター・アカウント・ユーザーに提供する権限を指定するには、それらを「権限」フィールドに指定します。次をクリックします。

20. 次をクリックします。サービス・テンプレートの作成: 初期化パラメータページが表示されます。このページで、次のものを指定できます。

- データベース・サイズ: このサービス・テンプレートでサポートするデータベース・サイズを選択します。小、中、大などのサイズを選択できます。各データベース・サイズには、特定のメモリー、記憶域、CPUコアおよびユニットがあります。サイズを選択し、「テンプレートに含める」を選択してそれをサービス・テンプレートに関連付けます。「デフォルト」をクリックし、それをデフォルトのデータベース・サイズとして指定します。

- 初期化パラメータ: データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択し、「セット」アイコンをクリックして、パラメータの値を変更します。

21. 次をクリックします。サービス・テンプレートの作成: カスタマイズ・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。
カスタムのSQL後スクリプトを指定して、そのスクリプトを実行するユーザーを選択することもできます。詳細は、第24.1.1項「SQL後スクリプト」を参照してください。

22. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。これらのプロパティは、作成されたデータベース・クローンに適用されます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を変更できません。

23. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

24. サービス・テンプレートの作成: 確認ページが表示されます。「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。

19.1.6 チャージバックの構成

オプションで、チャージバック・サービスを構成できます。第43章「チャージバック管理」を参照してください。

19.1.7 データベースのリクエスト

セルフ・サービス・ユーザーは、データベース・テンプレート・プロファイルに基づいてサービス・テンプレートを選択し、データベースを作成できるようになりました。第22.2項「データベースのリクエスト」を参照してください。

19.2 RMAN複製を使用したセルフ・サービス・ポータルからのフル・データベース・クローンの作成

「RMAN複製」機能を使用してテスト・マスターを作成し、テスト・マスターを使用してフル・データベース・クローンを作成できます。

表19-2 ライブ・スタンバイ・データベースを使用したフル・データベース・クローンの作成

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

2

1つ以上のリソース・プロバイダを作成します。

第19.1.1項「リソース・プロバイダの作成」を参照してください。

3

ライブ・スタンバイ・データベースを使用してテスト・マスターを作成します。

第19.2.1項「RMAN複製を使用したサービス・テンプレートの作成」を参照してください。

4

リクエスト設定を構成します。

第19.1.3項「リクエスト設定の構成」を参照してください。

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第19.1.4項「割当て制限の定義」を参照してください。

6

ライブ・スタンバイ・データベースに基づいてサービス・テンプレートを作成します。

第19.2.1項「RMAN複製を使用したサービス・テンプレートの作成」を参照してください。

7

チャージバック・サービスを構成します。

第19.1.6項「チャージバックの構成」を参照してください。

8

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第22.2項「データベースのリクエスト」を参照してください。

19.2.1 RMAN複製を使用したサービス・テンプレートの作成

既存のデータベースを使用してサービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図19-4 サービス・テンプレートの作成: 一般: RMANの複製

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「ソース識別」セクションで、「既存のデータベースの使用」ラジオ・ボタンを選択し、「検索」アイコンをクリックして、前に作成したテスト・マスター・データベースを選択します。

8. ホストおよびデータベース資格証明を指定します。

9. 「データベース定義」リージョンで、次の項目を指定します。

- 作成: 「RMAN複製を使用したフル・クローン」を選択します。このオプションは、既存のデータベースを使用したフル・データベース・クローンの作成に使用します。

- タイプ: 単一インスタンスまたはReal Application Cluster (RAC)を指定できます。「RAC」を選択した場合は、ノード数を指定します。

- データベースSID: これは、オプション・フィールドです。「接頭辞の指定」または「リクエスト時にユーザーにより指定」を選択できます。

- 接頭辞の指定: このオプションを選択する場合、データベースの作成時に一意のシステム識別子(SID)を生成するために使用される接頭辞を入力します。接頭辞は、このサービス・テンプレートを使用して作成されたデータベースの識別に役立ちます。接頭辞には、最大6文字を使用できます。
生成される新しいデータベース名は、ここで指定されるSID接頭辞をベースにします。たとえば、接頭辞がMYDBと指定されている場合、新しいデータベースのSIDは、MYDB0000、MYDB0001、MYDB0002 (以降同様)と生成されます。

既存のデータベース(実行中のデータベースおよび処理中のリクエスト)については、単一インスタンス・データベースに対して一意のSID名が生成されるか、Real Application Clusterデータベースに対して一意の名前が生成されます。たとえば、ホストで実行中の既存のSIDがMYDB0000、MYDB0001、MYDB0002で、処理中がMYDB0003、MYDB0004である場合、新規リクエストに対して生成される新規SIDまたはデータベース名はMYDB0005です。

- リクエスト時にユーザーにより指定: このオプションを選択する場合、このフィールドを空白のままにして、データベース・リクエストの作成時にSIDを指定できます。

- ドメイン名: これは、オプション・フィールドです。作成する新しいデータベースに使用するドメイン名を入力します。ドメイン名の先頭には「.」(ドット)が付いていないことを確認してください。

10. 「ゾーン」リージョンで、「追加」をクリックして、データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。「プールの割当て」をクリックします。リストからプールを選択し、このプールをPaaSインフラストラクチャ・ゾーンに割り当てます。データベースはこのプール内にプロビジョニングされます。

11. ゾーンおよびプールを選択したら、ホスト・ターゲットが「参照ホスト」フィールドに設定されます。

12. 共有場所を指定して「次へ」をクリックします。

13. 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。次をクリックします。サービス・テンプレートの作成: データベースページが表示されます。

14. 「参照ホスト」リージョンに、データベース・クラウド・セルフ・サービス・ポータルの設定: 一般ページで選択したPaaSインフラストラクチャ・ゾーンの名前、データベース・プールおよび参照ホストが表示されます。
選択した自動ストレージ管理(ASM)ディスク・グループ、ファイル・システムの場所およびリスナー・ポートなどのデータベース値は、参照ホストで利用できる必要があります。

15. 次の項目を指定します。

- 記憶域タイプ: 次のいずれかです。

- 自動ストレージ管理: Oracle Automatic Storage Management (ASM)は、単一インスタンスおよびRAC構成をサポートするデータベース・ファイルのボリューム・マネージャおよびファイル・システムです。ASMでは、ストレージ・システム内のディスクを1つ以上のディスク・グループに分類します。ASMを選択する場合、ディスク・グループをここで選択します。

- ファイル・システム: Oracle Databaseのファイル・システムは、データベース表に格納されるファイルおよびディレクトリの標準ファイルシステム・インタフェースを作成します。このオプションを選択する場合、ファイル・システムの場所を指定するか選択する必要があります。

- 高速リカバリ(オプション): バックアップおよびリカバリ・ファイルの管理を簡略化するために、データベースに高速リカバリ領域を作成できます。「高速リカバリ領域の有効化」チェック・ボックスを選択して、リカバリに関連するファイルの格納先となる場所を指定します。高速リカバリ領域は、バックアップおよびリカバリ・ファイル用の集中化されたディスクの場所を提供する、ASMディスク・グループまたはファイル・システムである可能性があります。高速リカバリ領域の場所および高速リカバリ・サイズを指定します。高速リカバリ領域に割り当てるディスク領域の量は、データベースのサイズおよびアクティビティ・レベルによって異なります。
「アーカイブ有効化」チェック・ボックスが選択されている場合、リフレッシュ中にデータベースは停止しません。これにより、セルフ・サービス・ユーザーは、データベースを停止せずにバックアップおよびリストア操作をスケジュールできます。

16. 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。

17. 「管理者資格証明」を指定します。新しいデータベースのシステム・スキーマのパスワードを指定します。これらのスキーマは、EM_SSA_USERSに対して使用できません。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。これらの値が指定されていない場合は、デフォルト値が使用され、EM_ADMINISTRATORがそれらを変更できます。

18. システム・スキーマとは別に、他のスキーマへのアクセスを制限する場合、「非管理者資格証明」リージョンで選択して、パスワードを指定できます。これらのスキーマはロックされ、EM_SSA_USERSはアクセスできません。次をクリックします。

19. 次をクリックします。サービス・テンプレートの作成: 初期化パラメータページが表示されます。このページで、次のものを指定できます。

- データベース・サイズ: このサービス・テンプレートでサポートするデータベース・サイズを選択します。小、中、大などのサイズを選択できます。各データベース・サイズには、特定のメモリー、記憶域、CPUコアおよびユニットがあります。サイズを選択し、「テンプレートに含める」を選択してそれをサービス・テンプレートに関連付けます。「デフォルト」をクリックし、それをデフォルトのデータベース・サイズとして指定します。

- 初期化パラメータ: データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択し、「セット」アイコンをクリックして、パラメータの値を変更します。

20. 次をクリックします。サービス・テンプレートの作成: カスタマイズ・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。

21. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を変更できません。

22. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

23. サービス・テンプレートの作成: 確認ページが表示されます。「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。

20 データベースのスナップ・クローンの作成

この章では、スナップ・クローンの作成方法について説明します。次のセクションがあります。

- スナップ・クローンについて

- データベースのクローニングおよびリフレッシュ

- クローニング・ダッシュボードからのスナップ・クローンの作成

- 同期テスト・マスターからのスナップ・クローンの作成

- 個別に同期されたテスト・マスターからのスナップ・クローンの作成

- CloneDBデータベースの作成

20.1 スナップ・クローンについて

スナップ・クローンは、ストレージに依存せずに大規模データベースの迅速で効率的な領域を持つクローンを作成するためのアプローチを提供します。テストや開発のために本番データベースのクローンが頻繁に必要となりますが、データベースが巨大な場合には特に、クローンの作成は困難で時間のかかる作業となります。

Enterprise Managerではこの問題への対処としてスナップ・クローンが提供されていますので、一部のストレージ・システムで利用可能なコピー・オン・ライト・テクノロジを使用して本番データベースからシン・クローンを作成できます。これは、クローンが最初はわずかな領域(数テラバイトのデータベースのシン・クローンに対して約2GBの書込み可能領域)を占有し、挿入、更新および削除が行われるにつれて大きくなることを意味します。Enterprise Managerでは、スナップ・クローンに次の2つのソリューションが提供されています。

- ハードウェア・ソリューション: NetApps、Oracle Sun ZFSストレージ・アプライアンス、EMC VMAXおよびVNXがサポートされるベンダー固有のハードウェア・ソリューション。

- ソフトウェア・ソリューション: すべてのNASストレージ・デバイスおよびSANストレージ・デバイスがサポートされるストレージ非依存型のソフトウェア・ソリューション。このソリューションは、ZFSファイル・システムおよびCloneDB機能を使用してサポートされています。

スナップ・クローンの主な機能は次のとおりです。

- セルフ・サービス駆動型のアプローチ: セルフ・サービス・ユーザーは、必要に応じて非定型ベースでデータベースをクローニングできます。

- 迅速なクローニング: データベースは、数日や数週間ではなく数分のうちにクローニングできます。

- 領域の効率性: この機能によって、ユーザーは、ストレージ・フットプリントを大幅に削減できます。

20.2 データベースのクローニングおよびリフレッシュ

Enterprise Managerのデータ・ライフサイクル管理ソリューションは、本番環境からテスト環境までデータを移動する、エンド・ツー・エンドの完結した自動化フローを提供します。

本番環境で、データベース管理者はまずこの本番データベースをバックアップし、バックアップからテスト・マスター・データベースを作成し、機密データをマスクして、最後にテスト・マスターからクローンを作成します。クローンは、データが本番データと確実に同期するように、必要に応じてリフレッシュされる必要があります。データ・ライフサイクル管理ソリューションでは、このプロセスは完全に自動化され、「クローニング」ダッシュボードから、または、セルフ・サービス・ポータルを介して実行できます。次のオプションを使用できます。

- クローニング・ダッシュボードからのスナップ・クローンの作成

- 同期テスト・マスターからのスナップ・クローンの作成

- 個別に同期されたテスト・マスターからのスナップ・クローンの作成

20.3 クローニング・ダッシュボードからのスナップ・クローンの作成

管理ダッシュボードからスナップ・クローンを作成し、そのスナップ・クローンをテスト・マスター・データベースとして昇格できます。この項では、スナップ・クローン・データベースの作成と管理に使用できる次の手順について説明します。

- スナップ・クローン・データベースの作成

- Exadataテスト・マスター・データベースの作成

- Exadataテスト・マスター・データベースのスナップショット・クローンの作成

- テスト・マスター・データベースの有効化

- テスト・マスター・データベースの無効化

- CloneDBデータベースの作成

- クローン・データベースの管理

- クローン・データベースのリフレッシュ

20.3.1 スナップ・クローン・データベースの作成

データベース・スナップ・クローンを作成するには、次の手順を実行します。

1. データベース・ページで、次のいずれかの方法を使用してデータベース・スナップ・クローン・ウィザードにアクセスできます。

- 表示されているデータベースのリストから、クローニングするデータベースを選択します。データベースのホームページで、「データベース」メニューをクリックし、「クローニング」→「スナップ・クローンの作成」を選択します。

- データベース・ターゲット名を右クリックし、「データベース」→「クローニング」→「スナップ・クローンの作成」を選択します。

- データベース・ターゲット名を右クリックし、「データベース」→「クローニング」→「クローンの管理」を選択します。「クローンの管理」ページの「スナップ・クローン・データベース」ボックスで、「作成」をクリックします。

2. スナップ・クローン・データベースの作成: ソースと宛先ページで、次の操作を実行します。

- 「ソース」セクションで、SYSDBAのデータベース資格証明とデータベース・ホスト資格証明の検索アイコンをクリックして、資格証明セレクタを起動します。「OK」をクリックします。

- 「データ時系列」セクションで、「即時」または「前のポイント・イン・タイム」を選択します。
「即時」を選択した場合、SYSASMのASM資格証明を指定するか、検索して選択します。「即時」はライブ・クローンを意味します。

「データベース・スナップショット」セクションで、クローン・データベース・ジョブの一部として作成されるスナップショット・プロファイルの場所、名前、説明、バージョンおよびベンダーを指定します。ホスト名、データベース、データ・コンテンツ、データ・コンテンツ・モードなどのノートを追加できます。

- 「前のポイント・イン・タイム」を選択した場合、ストレージ・スナップショット・イメージのカルーセルが表示されます。イメージで「選択」をクリックして、適切なRMANバックアップを選択します。
カルーセルからストレージ・スナップショットを選択してスナップ・クローンを作成できます。この2つの期間の間に新規クローンを作成する必要がある場合は、これを変更できます。同様に、「SCNの選択」オプションを選択して、SCNに対して同じ操作を実行できます。

3. 宛先データベースの定義セクションで、次の操作を行います。

- 表示名を指定します。

- グローバル・データベース名およびSIDを指定します。
データベースは、「グローバル・データベース名」で一意に識別されます。名前の一般的な形式は、name.domainです。データベースは、SIDで一意に識別される1つ以上のOracleインスタンスによって参照されます。

- 次のデータベース・タイプから1つ選択します。

- 単一インスタンス・データベース
「ホスト」セクションで、Oracleホームの場所を指定します。ホストはデフォルトで指定されます。次に、データベース・ホーム資格証明およびSYSASMのASM資格証明を選択します。

- RACデータベース
「ホスト」セクションで、クラスタ・ターゲットを指定または選択します。Oracleホームの場所は、デフォルトで指定されます。次に、データベース・ホスト資格証明およびSYSASMのASM資格証明を指定します。

「ノード」セクションで、クラスタおよびOracleホームを選択し、管理者の管理対象となるOracle RACデータベースが作成される1つ以上のホストを表示します。

- RAC One Nodeデータベース
「ホスト」セクションで、クラスタ・ターゲットを指定または選択します。Oracleホームの場所は、デフォルトで指定されます。次に、データベース・ホスト資格証明およびSYSASMのASM資格証明を指定します。

「ノード」セクションで、クラスタおよびOracleホームを選択し、管理者の管理対象となるOracle RACデータベースが作成される1つ以上のホストを表示します。

「次」をクリックします。

注意:
Oracleでは、クローンの一部としてインライン・パッチ適用をサポートしています。選択された宛先ホームに、最新のCPUやPSUなどのパッチが適用されている場合、クローニングされたデータベースはそのレベルで自動的に起動します。

4. スナップ・クローン・データベースの作成: 構成ページで、次を実行します。

- 「ボリュームの構成」で、次の項目を指定して、クローン・データベースで使用されるボリュームを構成します。

- マウント・ポイント接頭辞: クローニングされるデータベースの新しいマウント・ポイントを指定します。この値は、このボリュームのクローンがマウントされる自動生成されたマウント・ポイントに接頭辞として追加されます。ボリュームは/<mount-prefix> <unique-suffix-generated-by-EM> /<source-path>にマウントされます。マウント・ポイント接頭辞には、「すべてのボリュームで同じ」または「ボリュームごとに異なる」を指定できます。

注意:
ボリュームは事前に作成されている必要があります。

- 書込み可能領域: ブロックの変更に必要な領域量を指定します。ここで指定される値は、サーバーに指定されるストレージ上限を超えることはできません。たとえば、データ変更が最小限である場合、元のボリューム・サイズの1%として値を指定します。書込み可能領域には、「すべてのボリュームで同じ」または「ボリュームごとに異なる」を指定できます。

- 選択したデータベースのストレージ詳細が「ボリューム・コンテンツ情報」セクションに表示されます。「ファイルの表示」をクリックして、ボリューム内のデータベース・ファイルのレイアウトを表示します。

- 「リスナー構成」セクションで、クローン・データベースを登録するために、新しいOracleホームで実行されているリスナー・ターゲットを選択します。「追加」をクリックし、リスナー名およびポートを指定すると、新しいリスナーを追加できます。

- 「データベース資格証明」セクションで、クローン・データベースのSYS、SYSTEMおよびDBSNMP管理ユーザーのパスワードを指定します。3ユーザーすべてに同じパスワードを指定するか、ユーザーごとに異なるパスワードを指定するかを選択できます。
「次」をクリックします。

5. スナップ・クローン・データベースの作成: 初期化パラメータ・ページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータの値を変更するには、そのパラメータを選択して「編集」をクリックします。
「次」をクリックします。

6. スナップ・クローン・データベースの作成: 後処理ページで、次を指定します。

- マスキング定義: データ・マスキングは、テスト・データベースや本稼働していないデータベースの機密データをマスキングするプロセスです。マスキング定義では、マスクされたデータの形式でマスクする列を定義します。データベースのクローニング後に適用するマスキング定義を指定します。

注意:
マスキング定義は、Subset-Maskingライセンス・パックがある場合にのみ使用できます。

- カスタム・スクリプト: データベースを作成する前後に実行が必要なカスタム・スクリプトを指定します。

「次」をクリックします。

7. スナップ・クローン・データベースの作成: スケジュール・ページで、一意のデプロイメント・プロシージャ・インスタンス名を指定します。デプロイメント・プロシージャを即時起動するか、後で起動するかを選択できます。
「通知の詳細」セクションで、次の通知の設定を選択できます。

- スケジュール済

- 実行中

- 操作必須

- 一時停止

- 成功

- 問題

「次」をクリックします。

8. スナップ・クローン・データベースの作成: 確認ページで、ソース・データベース、クローンのデータ・ソースおよび宛先データベースの詳細を確認します。
「発行」をクリックします。

20.3.2 Exadataテスト・マスター・データベースの作成

テスト・マスター・データベースとは、本番データベースのサニタイズされたバージョンです。テスト・マスターが作成される前に、オプションで本番データをマスキングできます。テスト・マスターは、前のポイント・イン・タイムで取得され、特定の間隔でリフレッシュされるスナップショットまたはRMANバックアップ・プロファイルから作成できます。このオプションは、ソース・データをマスクして機密データを隠す必要がある場合に便利です。

テスト・マスターを作成するには、次の手順に従います。

1. 「データベース」ページで、次のいずれかの方法でフル・クローン・データベース・ウィザードにアクセスできます。

- 表示されているデータベースのリストから、クローニングするデータベースを選択します。データベースのホームページで、「データベース」メニューをクリックし、「クローニング」→「テスト・マスターの作成」を選択します。

- データベース・ターゲット名を右クリックし、「データベース」→「クローニング」→「テスト・マスターの作成」を選択します。

- データベース・ターゲット名を右クリックし、「データベース」→「クローニング」→「クローンの管理」を選択します。「クローンの管理」ページの「テスト・マスター・データベース」ボックスで、「作成」をクリックします。

2. テスト・マスター・データベースの作成: ソースと宛先ページで、次の操作を実行します。

- 「ソース」セクションで、SYSDBAのデータベース資格証明とデータベース・ホスト資格証明の検索アイコンを選択して、資格証明セレクタを起動します。「OK」をクリックします。

- 「データ時系列」セクションで、「即時」または「前のポイント・イン・タイム」を選択します。
「即時」を選択した場合、SYSASMのASM資格証明を指定するか、検索して選択します。「即時」はライブ・クローンを意味します。

「前のポイント・イン・タイム」を選択した場合、RMANバックアップ・イメージのカルーセルが表示されます。イメージで「選択」をクリックして、適切なRMANバックアップを選択します。

選択したバックアップまたはスナップショットと次のバックアップまたはスナップショット(あるいは最新の時点のソース)の間の時間を選択します。バックアップまたはダンプが特定の間隔で作成され、これらを基とするテスト・マスターには、特定時点の本番データベースが反映されます。本番データベースの最新データを反映するには、テスト・マスターを定期的にリフレッシュする必要があります。

3. 宛先データベースの定義セクションで、次の操作を行います。

- 表示名を指定します。

- グローバル・データベース名およびSIDを指定します。
データベースは、「グローバル・データベース名」で一意に識別されます。名前の一般的な形式は、name.domainです。データベースは、SIDで一意に識別される少なくとも1つのOracleインスタンスによって参照されています。

- 次のデータベース・タイプから1つ選択します。

- 単一インスタンス・データベース
「ホスト」セクションで、Oracleホームの場所を指定します。ホストはデフォルトで指定されます。次に、データベース・ホーム資格証明およびSYSASMのASM資格証明を選択します。

- RACデータベース
「ホスト」セクションで、クラスタ・ターゲットを指定または選択します。Oracleホームの場所は、デフォルトで指定されます。次に、データベース・ホスト資格証明およびSYSASMのASM資格証明を指定します。

「ノード」セクションで、クラスタおよびOracleホームを選択し、管理者の管理対象となるOracle RACデータベースが作成される1つ以上のホストを表示します。

- RAC One Nodeデータベース
「ホスト」セクションで、クラスタ・ターゲットを指定または選択します。Oracleホームの場所は、デフォルトで指定されます。次に、データベース・ホスト資格証明およびSYSASMのASM資格証明を指定します。

「ノード」セクションで、クラスタおよびOracleホームを選択し、管理者の管理対象となるOracle RACデータベースが作成される1つ以上のホストを表示します。

注意:
Oracleでは、クローンの一部としてインライン・パッチ適用をサポートしています。選択された宛先ホームに、最新のCPUやPSUなどのパッチが適用されている場合、クローニングされたデータベースはそのレベルで自動的に起動します。

「次」をクリックします。

4. 「テスト・マスター・データベースの作成: 構成」ページで、次の操作を実行します。

- データベース・ファイルの場所: データ・ファイル、一時ファイル、REDOログ・ファイルおよび制御ファイルが作成される場所を指定します。

- アクセス制御および権限: データファイルに対する読取り専用権限を付与する必要があるデータ・ファイル所有者およびグループを指定します。

- リスナー構成: テスト・マスターが登録されるリスナーを選択します。

- データベース資格証明: クローニングする新しいデータベースの管理ユーザー(SYS、SYSTEMおよびDBSNMP)のパスワードを指定します。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。

- 「次」をクリックします。

5. テスト・マスター・データベースの作成: 初期化パラメータ・ページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。
パラメータの値を変更するには、そのパラメータを選択して「編集」をクリックします。db_block_sizeなどの一部の値は変更できません。

「次」をクリックします。

6. 「テスト・マスター・プラガブル・データベースの作成: 後処理」ページの「データ・マスキング」セクションで、テスト・マスターPDBの作成後に適用するデータ・マスキング定義を指定します。データ・マスキングによって、データベース内の機密データがマスクされます。
データ・マスキング定義の作成方法の詳細は、『Oracle Data Masking and Subsettingガイド』を参照してください。データ・マスキング定義は、Subset-Maskingライセンス・パックがある場合にのみ適用できます。

「カスタム・スクリプト」セクションの「前スクリプト」および「後スクリプト」で、テスト・マスターPDBの作成の前後に実行するスクリプトを含むOracleソフトウェア・ライブラリ・コンポーネントを指定します。また、「SQLスクリプト」で、テスト・マスターPDBの作成後に実行するSQLスクリプトを指定します。「実行ユーザー」で、SQLスクリプトの実行に使用するユーザー・アカウントを選択します。

「次」をクリックします。

7. 「テスト・マスター・データベースの作成: スケジュール」ページで、テスト・マスターの作成のスケジュールを指定します。すぐに作成することも(フィジカル・スタンバイを使用した場合は、すぐに作成されて、自動的にリフレッシュされます)、別の日/時間に作成して、指定した間隔でリフレッシュすることもできます。
「次」をクリックします。

8. 「テスト・マスター・データベースの作成: 確認」ページで、指定した情報をレビューして確認し、「発行」をクリックしてテスト・マスターを作成します。テスト・マスターが作成された後、必要に応じてテスト・マスターをリフレッシュして、テスト・マスターがベースとするプロファイルの新規バージョンを作成できます。

20.3.3 Exadataテスト・マスター・データベースのスナップショット・クローンの作成

Exadataテスト・マスター・データベースのスナップショット・クローンを作成するには、次の手順を実行します。

1. 「ターゲット」メニューから「データベース」を選択します。

2. データベース・ページで、次のいずれかの方法を使用してデータベース・スナップ・クローン・ウィザードにアクセスできます。

- 表示されているデータベースのリストから、クローニングするテスト・マスター・データベースを選択します。データベースのホームページで、「データベース」メニューをクリックし、「クローニング」→「スナップショット・クローンの作成」を選択します。

- テスト・マスター・データベース・ターゲット名を右クリックし、「データベース」→「クローニング」→「スナップショット・クローンの作成」を選択します。

3. Exadataスナップショット・クローン・データベースの作成: ソースと宛先ページで、次の操作を実行します。

- 「ソース」セクションで、SYSDBAのデータベース資格証明とデータベース・ホスト資格証明の検索アイコンをクリックして、資格証明セレクタを起動します。「OK」をクリックします。

- 「データ時系列」セクションで、「即時」がデフォルトで選択されます。
「即時」はライブ・クローンを意味します。

SYSASMのASM資格証明を指定または選択します。

4. 宛先データベースの定義セクションで、次の操作を行います。

- 表示名を指定します。

- グローバル・データベース名およびSIDを指定します。
データベースは、「グローバル・データベース名」で一意に識別されます。名前の一般的な形式は、name.domainです。データベースは、SIDで一意に識別される1つ以上のOracleインスタンスによって参照されます。

- 次のデータベース・タイプから1つ選択します。

- 単一インスタンス・データベース
「ホスト」セクションで、Oracleホームの場所を指定します。ホストはデフォルトで指定されます。次に、データベース・ホーム資格証明およびSYSASMのASM資格証明を選択します。

- RACデータベース
「ホスト」セクションで、クラスタ・フィールドが親データベースから自動選択され、無効化されます。Oracleホームの場所は、デフォルトで指定されます。次に、データベース・ホスト資格証明およびSYSASMのASM資格証明を指定します。

「ノード」セクションで、クラスタおよびOracleホームを選択し、管理者の管理対象となるOracle RACデータベースが作成される1つ以上のホストを表示します。

- RAC One Nodeデータベース
「ホスト」セクションで、クラスタ・ターゲットを指定または選択します。Oracleホームの場所は、デフォルトで指定されます。次に、データベース・ホスト資格証明およびSYSASMのASM資格証明を指定します。

「ノード」セクションで、クラスタおよびOracleホームを選択し、管理者の管理対象となるOracle RACデータベースが作成される1つ以上のホストを表示します。

「次」をクリックします。

注意:
Oracleでは、クローンの一部としてインライン・パッチ適用をサポートしています。選択された宛先ホームに、最新のCPUやPSUなどのパッチが適用されている場合、クローニングされたデータベースはそのレベルで自動的に起動します。

5. Exadataスナップショット・クローン・データベースの作成: 構成ページで、次の操作を実行します。

- 「データベース・ファイルの場所」で、疎ディスク・グループおよびREDOログ・ファイル・サイズを指定します。

- 「リカバリ・ファイルの場所」で、アーカイブREDOログ、RMANバックアップ、その他の関連ファイルなどのリカバリ・ファイルを作成する場所を指定します。「高速リカバリ領域の使用」を選択して、高速領域リカバリを使用することを選択できます。その場合は、高速リカバリ領域サイズを指定します。高速リカバリ領域サイズは、デフォルトでソースのサイズになります。

- 「リスナー構成」セクションで、新規Oracleホームで実行しているリスナー・ターゲットを選択して、クローン・データベースを登録します。

- 「データベース資格証明」セクションで、クローン・データベースのSYS、SYSTEMおよびDBSNMP管理ユーザーのパスワードを指定します。3ユーザーすべてに同じパスワードを指定するか、ユーザーごとに異なるパスワードを指定するかを選択できます。
「次」をクリックします。

6. Exadataスナップショット・クローン・データベースの作成: 初期化パラメータ・ページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータの値を変更するには、そのパラメータを選択して「編集」をクリックします。
「次」をクリックします。

7. Exadataスナップショット・クローン・データベースの作成: 後処理ページで、次の項目を指定します。

- マスキング定義: データ・マスキングは、テスト・データベースや本稼働していないデータベースの機密データをマスキングするプロセスです。マスキング定義では、マスクされたデータの形式でマスクする列を定義します。データベースのクローニング後に適用するマスキング定義を指定します。

注意:
マスキング定義は、Subset-Maskingライセンス・パックがある場合にのみ使用できます。

- カスタム・スクリプト: データベースを作成する前後に実行が必要なカスタム・スクリプトを指定します。

「次」をクリックします。

8. Exadataスナップショット・データベースの作成: スケジュール・ページで、一意のデプロイメント・プロシージャ・インスタンス名を指定します。デプロイメント・プロシージャを即時起動するか、後で起動するかを選択できます。
「通知の詳細」セクションで、次の通知の設定を選択できます。

- スケジュール済

- 実行中

- 操作必須

- 一時停止

- 成功

- 問題

「次」をクリックします。

9. Exadataスナップショット・データベースの作成: 確認ページで、ソース・データベースの詳細、クローンのデータ・ソースおよび宛先データベースを確認します。
「発行」をクリックします。

20.3.4 テスト・マスター・データベースの有効化

データベースをテスト・マスター・データベースに変換するには、次の手順を実行します。

1. 「ターゲット」メニューから、「データベース」を選択します。

2. データベース・ページで、テスト・マスター・データベースとして有効化するデータベース・ターゲットを右クリックします。表示されたメニューから、「Oracleデータベース」→「クローニング」→テスト・マスターの有効化を選択します。

3. テスト・マスター・データベースとして有効化ページで、SYSDBAデータベースおよびデータベース・ホスト資格証明を指定するか、検索して選択します。

4. データベースのクローニング元である親データベースを指定するか、検索して選択します。これによって、系統追跡が容易になります。

5. テスト・マスターとして有効化する前にクローン・データベースのデータをマスクする場合、データ・マスキング定義を指定または選択します。

6. 「カスタム・スクリプト」セクションで、クローニング後スクリプトを含むソフトウェア・ライブラリ・コンポーネントを選択できます。クローン・データベースは、クローニング後SQLスクリプトを実行してカスタマイズすることもできます。

7. 「アクセス制御および権限」セクションで、データファイルに対する読取り専用権限を付与する必要がある所有者およびグループを指定します。

8. 「発行」をクリックします。

20.3.5 テスト・マスター・データベースの無効化

テスト・マスター・データベースを無効化するには、次の手順を実行します。

1. 「ターゲット」メニューから、「データベース」を選択します。

2. データベース・ページで、テスト・マスター・データベースとして無効化するデータベース・ターゲットを右クリックします。表示されたメニューから、「Oracleデータベース」→「クローニング」→「テスト・マスターの無効化」を選択します。

3. テスト・マスターの無効化ページで、SYSDBAデータベースおよびデータベース・ホスト資格証明を指定するか、検索して選択します。

4. 「Exadataスナップショット・クローン・データベース」セクションに、テスト・マスターを無効化するプロセスの一環として削除されるデータベース・スナップショット・クローンがリストされます。

5. 「発行」をクリックします。このアクションによって、データファイルが読取り/書込みモードにリセットされ、データベースがオープン・モードで再起動されます。後でデータベースをさらに変更し、必要に応じて再度テスト・マスターとして有効化できます。

20.3.6 CloneDBデータベースの作成

CloneDBデータベースは、RMANイメージ・バックアップがある場合にのみ作成できます。

CloneDBデータベースを作成するには、次の手順に従います。

1. 「データベース」ページで、次のいずれかの方法を使用してCloneDBウィザードにアクセスできます。

- 表示されているデータベースのリストから、クローニングするデータベースを選択します。データベースのホームページで、「データベース」メニューをクリックし、「クローニング」→「CloneDBの作成」を選択します。

- データベース・ターゲット名を右クリックし、「データベース」→「クローニング」→「CloneDBの作成」を選択します。

- データベース・ターゲット名を右クリックし、「データベース」→「クローニング」→「クローンの管理」を選択します。「クローンの管理」ページの「CloneDBデータベース」ボックスで、「作成」をクリックします。

2. CloneDBデータベースの作成: ソースと宛先ページで、次の操作を実行します。

- 「ソース」セクションで、SYSDBAのデータベース資格証明とデータベース・ホスト資格証明の検索アイコンを選択して、資格証明セレクタを起動します。「OK」をクリックします。

- ソース・データ時系列では、「前のポイント・イン・タイム」が自動的に選択されます。
イメージで「選択」をクリックして、適切なRMANイメージ・バックアップを選択します。

フル・クローンはバックアップを選択することで作成でき、オプションでポイント・イン・タイム・リストアを行う時刻とSCNを変更します。「時間の選択」オプションには、現在のバックアップ時刻に設定された最小制限と、次回のバックアップ時刻に設定された最大時間制限があります。この2つの期間の間に新規クローンを作成する必要がある場合は、これを変更できます。同様に、「SCNの選択」オプションを選択して、SCNに対して同じ操作を実行できます。

3. 宛先データベースの定義セクションで、次の操作を行います。

- 表示名を指定します。

- グローバル・データベース名およびSIDを指定します。
データベースは、「グローバル・データベース名」で一意に識別されます。名前の一般的な形式は、name.domainです。データベースは、SIDで一意に識別される少なくとも1つのOracleインスタンスによって参照されています。

- 「シングル・インスタンス」データベース・タイプがデフォルトで選択されています。
「ホスト」セクションで、Oracleホームの場所、ホストおよびデータベース・ホスト資格証明を指定します。

「バックアップの場所」で、共有された場所を指定します。

注意:
Oracleでは、クローンの一部としてインライン・パッチ適用をサポートしています。選択された宛先ホームに、最新のCPUやPSUなどのパッチが適用されている場合、クローニングされたデータベースはそのレベルで自動的に起動します。

「次」をクリックします。

4. CloneDBデータベースの作成: 構成ページで、次を実行します。

- 「データベース・ファイルの場所」で、データファイル、一時ファイル、REDOログ・ファイルおよび制御ファイルを作成する場所を指定します。「ファイル・システム」オプションがデフォルトで選択されます。

- 「リカバリ・ファイルの場所」で、アーカイブREDOログ、RMANバックアップ、その他の関連ファイルなどのリカバリ・ファイルを作成する場所を指定します。「高速リカバリ領域の使用」を選択して、高速領域リカバリを使用することを選択できます。その場合は、高速リカバリ領域サイズを指定します。高速リカバリ領域サイズは、デフォルトでソースのサイズになります。

- 「リスナー構成」セクションで、新規Oracleホームで実行しているリスナー・ターゲットを選択して、クローン・データベースを登録します。

- 「データベース資格証明」セクションで、クローン・データベースのSYS、SYSTEMおよびDBSNMP管理ユーザーのパスワードを指定します。3ユーザーすべてに同じパスワードを指定するか、ユーザーごとに異なるパスワードを指定するかを選択できます。
「次」をクリックします。

5. CloneDBデータベースの作成: 初期化パラメータ・ページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータの値を変更するには、そのパラメータを選択して「編集」をクリックします。
「次」をクリックします。

6. CloneDBデータベースの作成: 後処理ページで、次を指定します。

- マスキング定義: データ・マスキングは、テスト・データベースや本稼働していないデータベースの機密データをマスキングするプロセスです。マスキング定義では、マスクされたデータの形式でマスクする列を定義します。データベースのクローニング後に適用するマスキング定義を指定します。

注意:
マスキング定義は、Subset-Maskingライセンス・パックがある場合にのみ使用できます。

- カスタム・スクリプト: データベースを作成する前後に実行が必要なカスタム・スクリプトを指定します。

- データ・プロファイルの作成: このオプションでは、作成後に新規クローン・インスタンスのバックアップを自動的に取得できます。クローンまたはテスト・マスターがリフレッシュされると、このセクションに、データベースに対して作成された既存のプロファイルが表示されます。データベースとともにリフレッシュする必要のあるプロファイルを選択できます。

- テスト・マスターとして作成: このオプションは、クローニングされるデータベースをテスト・マスター・データベースとして作成する場合に選択します。

「次」をクリックします。

7. CloneDBデータベースの作成: スケジュール・ページで、一意のデプロイメント・プロシージャ・インスタンス名を指定します。デプロイメント・プロシージャを即時起動するか、後で起動するかを選択できます。
「通知の詳細」セクションで、次の通知の設定を選択できます。

- スケジュール済

- 実行中

- 操作必須

- 一時停止

- 成功

- 問題

「次」をクリックします。

8. CloneDBデータベースの作成: 確認ページで、ソース・データベースの詳細、クローンのデータソース、および宛先データベースを確認します。
「発行」をクリックします。

20.3.7 クローン・データベースの管理

クローンの管理ページでは、クローン・データベースの追加、クローン・データベースの削除およびテスト・マスターとしてのクローン・データベースの昇格を行うことでクローン・データベースを管理できます。

「クローンの管理」ページにアクセスするには、Oracleデータベース・ターゲット・ホームページに移動します。ホームページで、「Oracle Database」をクリックし、「クローニング」、「クローンの管理」の順に選択します。

クローン・データベースの追加

「追加」ボタンを使用して、すでに作成されている現在のデータベースのクローンを追加します。データベース・クローン・インスタンスを追加するには、「追加」をクリックします。表示された「ターゲットの選択」ダイアログ・ボックスでデータベース・ターゲットを選択し、「選択」をクリックします。データベース・インスタンスが、データベースのクローニング・ページの「クローン」セクションに追加されます。

クローン・データベースの削除

「削除」ボタンで削除できるのは、「追加」ボタンを使用して追加したデータベースのみです。データベース・クローン・インスタンスを削除するには、削除するデータベース・クローン・インスタンスを「クローン」セクションから選択します。「削除」をクリックします。

クローン・データベースのテスト・マスターとしての昇格

データベース・クローン・データベース・インスタンスをテスト・マスターとして昇格するには、再作成するクローン・インスタンスを「クローン」セクションから選択します。テスト・マスターとして昇格をクリックします。

クローン・データベース・インスタンスのテスト・マスターからの削除は、「クローン」セクションからクローン・データベース・インスタンスを選択し、テスト・マスターから削除をクリックして行うこともできます。

クローン・データベースのリフレッシュ

クローン・データベースをリフレッシュするには、「クローン」セクションからクローン・データベース・インスタンスを選択し、「リフレッシュ」をクリックします。第20.3.8項「クローン・データベースのリフレッシュ」を参照してください。

データ・プロファイルの作成

クローンの管理ページの「データ・プロファイル」タブには、クローン・データベースから作成したデータ・プロファイルが表示されます。データ・プロファイル・ページで、既存のデータ・プロファイルのコンテンツを表示できます。これらのデータ・プロファイルの「編集」および「リフレッシュ」も実行できます。

「作成」をクリックして、新規データ・プロファイルを作成することもできます。これにより、プロビショニング・プロファイルの作成ウィザードが起動します。このウィザードを使用したプロビジョニング・プロファイルの作成方法は、Enterprise Manager Cloud Control管理者ガイドを参照してください。

20.3.8 クローン・データベースのリフレッシュ

クローン・データベースをリフレッシュするには、次の手順に従って、「クローンの管理」ページに移動します。

1. 「ターゲット」メニューから「データベース」を選択します。

2. データベースのホームページで、リフレッシュするデータベース・クローン・インスタンスをデータベースのリストから選択します。

3. データベース・ターゲットのホームページで、「Oracle Database」をクリックし、「クローニング」、「クローンの管理」の順に選択します。

4. 「クローンの管理」ページで、「リフレッシュ」タブを選択します。

リフレッシュ・ページに次のセクションが表示されます。

- ソース・データベースからドリフト
このセクションには、このデータベースのクローニング元のソース・データベースの名前が表示されます。クローン・データベースがリフレッシュされた後の日数が表示されます。「リフレッシュ」をクリックしてクローン・データベースをリフレッシュします。

- データベース・ボリュームの詳細
このセクションには、選択したデータベースのストレージ詳細が表示されます。「ファイルの表示」をクリックして、ボリューム内のデータベース・ファイルのレイアウトを表示します。選択したデータベースのストレージ・レイアウトとファイル・レイアウトを示す表示ボックスが表示されます。

- 履歴
このセクションには、データベースの過去のリフレッシュが表示されます。リフレッシュの日時、リフレッシュ元、データベースの所有者およびリフレッシュ・アクションのステータスが表示されます。

- 記憶域の使用状況
この項には、データベースのストレージ・ボリューム、ストレージ・コンテンツ、マウント・ポイント、使用されている書込み可能ストレージの量および同期日が表示されます。

20.4 同期テスト・マスターからのスナップ・クローンの作成

テスト・マスター・データベースとして指定されているスタンバイ・データベースを使用してスナップ・クローンを作成できます。テスト・マスター・データベースは常に最新で、本番データベースと同期しています。このアプローチを使用してスナップ・クローンを作成するには、次の手順に従います。

表20-1 スナップ・クローンの作成(連続フロー)

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第20.4.1項「はじめに」を参照してください。

2

ストレージ・サーバーを登録します。

第20.4.2項「ストレージ・サーバーの登録」を参照してください。

3

1つ以上のリソース・プロバイダを作成します。

第20.4.3項「リソース・プロバイダの作成」を参照してください。

4

リクエスト設定を構成します。

第20.4.4項「リクエスト設定の構成」を参照してください。

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第20.4.5項「割当て制限の定義」を参照してください。

7

スタンバイ・データベースを追加し、テスト・マスターとして指定します。

第20.4.6項「テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用」を参照してください

注意: このスタンバイ・データベースは、スナップ・クローンの作成が可能な登録されたストレージ・サーバー(NetApp、Sun ZFS、EMCなど)に存在する必要があります。

6

スナップ・クローンのテスト・マスターを有効にします。

第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください。

テスト・マスターからスナップショット・プロファイルを作成します。

第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」。

8

サービス・テンプレートを作成します。

第20.4.9項「スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

9

チャージバック・サービスを構成します(この手順はオプションです)。

第20.4.10項「チャージバックの構成」を参照してください。

10

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第22.2項「データベースのリクエスト」を参照してください。

20.4.1 はじめに

第12.1項「はじめに」を参照してください。

20.4.2 ストレージ・サーバーの登録

ストレージ・サーバーの登録対象は次のとおりです。

- NetAppおよびSun ZFSストレージ・サーバー: 第12.7.4.1項「NetAppまたはSun ZFSストレージ・サーバーの登録」を参照してください。

- Solarisファイル・システム(ZFS): 第12.7.4.2項「Solaris File System (ZFS)ストレージ・サーバーの登録」を参照してください。

- EMCストレージ・サーバー: 第12.7.4.3項「EMCストレージ・サーバーの登録」を参照してください。

20.4.3 リソース・プロバイダの作成

次のような1つ以上のリソース・プロバイダを作成する必要があります。

- PaaSインフラストラクチャ・ゾーン: 第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

- データベース・プール: 第20.4.3.1項「Database as a Service用のデータベース・プールの作成」を参照してください。

20.4.3.1 Database as a Service用のデータベース・プールの作成

Database as a Service用のデータベース・プールを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。データベース・サービス・ファミリの横の「設定」リンクをクリックし、「データベース・プール」リンク、「作成」の順にクリックします。

図20-1 データベース・プールの作成

3. 「資格証明」リージョンで、次の資格証明を指定します。

- ホスト: データベースの作成および起動に必要です。

- ルート: これらの資格証明を持つユーザーは、ルート・スクリプトの実行などの権限アクションを実行できます。スナップ・クローン・データベースでは、スナップショットがルート・ユーザーによってマウントされている必要があります。これを容易にするには、通常のルート・ユーザー・アクションをSUDO権限で実行するように特権資格証明を設定する必要があります。

- グリッド・インフラストラクチャ: これは、オプション・フィールドで、EMCストレージでスナップ・クローンを作成してASMディスクを作成する場合のみ必須です。

- 自動ストレージ管理: これは、オプション・フィールドです。ASMで実行されているデータベースでライブ・クローニングを行うためにこのデータベース・プールを使用する場合は必須です。

4. データベース・プールの名前および説明を入力します。

5. 次の詳細を指定します。

- PaaSインフラストラクチャ・ゾーン: データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。

- データベース構成: プロビジョニングするデータベースの構成を指定します。シングル・インスタンスまたはクラスタ・データベース(RAC)のいずれかにすることができますが、両方を組み合せることはできません。

- プラットフォームおよびバージョン: デプロイするデータベースのプラットフォームおよびバージョンを指定します。

6. 「追加」をクリックし、データベース・プールに追加する1つ以上のOracleホームを選択します。

7. 「データベース・インスタンスの最大数」(1ホスト当たり)に、プール内の各ホストで実行可能なデータベース・インスタンスの最大数を入力します。

注意:
RACデータベースの場合、このフィールドに指定されている値を使用して、データベースを作成するノードがこの基準を満たしていることを確認します。

8. 「発行」をクリックして、データベース・プールを作成します。新しく作成されたプールが、データベース・クラウド・セルフ・サービス・ポータルの設定: データベース・プール・ページに表示されます。現在は、データベース・プールをサービス・テンプレートに追加できます。

20.4.4 リクエスト設定の構成

リクエストできる時間、その期間などを指定して、リクエスト設定を構成できます。詳細は、第11.2.3項「リクエスト設定の構成」を参照してください。

20.4.5 割当て制限の定義

リクエスト設定を構成した後で、各セルフ・サービス・ユーザーの割当て制限を定義する必要があります。詳細は、第11.2.4項「割当て制限の設定」を参照してください。

20.4.6 テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用

テスト・マスター・データベースとは、本番データベースのサニタイズされたバージョンです。テスト・マスターは、Oracle Data Guard機能を使用してライブ・スタンバイ・データベースから作成できます。プロファイルまたはスナップショットは、テスト・マスターから作成でき(第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」を参照)、それらのプロファイルを使用して、スナップ・クローンを作成できます(第22.2項「データベースのリクエスト」を参照)。テスト・マスターは、ライブ・データを含むフィジカル・スタンバイ・データベースであるため、プロファイルに最新のデータが取得されるように、定期的にプロファイルとスナップショットをスケジュールおよび作成する必要があります(第20.4.8.1項「テスト・マスターのスナップショットの作成およびリフレッシュ」を参照)。セルフ・サービス・ユーザーは、各プロファイルから複数のスナップ・クローンを作成し、新しいプロファイルまたはスナップショットが使用できるようになったときに、それらのスナップ・クローンをリフレッシュできます(第22.3項「データベースのリフレッシュ」を参照)。

テスト・マスターを作成するには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「設定」を選択し、左側のパネルで「データベース・サービス」ファミリを選択します。「テスト・マスター・データベース」タブをクリックします。

2. ライブ・スタンバイ・データベースからテスト・マスターを作成するには、「追加」をクリックし、テスト・マスターとして指定するスタンバイ・データベースを選択します。新しく追加されたデータベースは、「テスト・マスター・データベース」ページに表示され、スナップ・クローン・データベース・インスタンスを作成するために使用できます。

20.4.7 スナップ・クローンのテスト・マスターの有効化

テスト・マスター・データベースを作成した後に、データベース上でスナップ・クローンを有効にする必要があります。

注意:
スナップ・クローンを有効にするには、データベースに対するSNAP_CLONE_TARGETまたはFULL_TARGET権限が必要です。

スナップ・クローンを有効にするには、次の手順に従います。

1. 「ストレージ登録」ページの「詳細」セクションで、「データベース」タブを選択し、表からスナップ・クローンに使用するデータベースを選択して、「スナップ・クローンの有効化」をクリックします。
リストされているデータベースでスナップ・クローンがサポートされているかどうかが、表の「サポート」列に表示されます。

注意: リストされているデータベースの「サポート」列に「サポートされていません」アイコンが表示されている場合は、「表示」メニューから「メッセージ」列を表示できます。この列には理由が表示されます。可能性のある理由は、ストレージ・サーバーにデータ・ファイルがないこと、およびローカル・ディスクまたは登録されていない別のストレージ・サーバーに配置されていることです。別の理由として、同期化されていない別のストレージにデータ・ファイルが存在するという可能性があります。

2. スナップ・クローンが正常に有効化されると、確認メッセージが表示されます。「OK」をクリックします。
ストレージ・サーバーに存在するすべてのファイルを表示するには、「ファイルの表示」をクリックします。ストレージ・サーバーのすべてのプロジェクト(集計)、ボリュームおよびスナップショットを表示するには、「コンテンツ」タブを選択します。

20.4.8 スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成

スナップショットを使用したデータベース・プロビジョニング・プロファイルを作成する前提条件

データベース・プロビジョニング・プロファイルを作成する前に、次の前提条件に従います。

- ストレージを登録するストレージ・サーバーがネットワーク上で使用可能であることを確認します。ストレージ・サーバーを登録するには、第12.7項「ストレージ・サーバーの登録および管理」を参照してください。

注意:
Enterprise Manager Cloud Control 12cではNetApp、Sun ZFS、Solaris ZFSおよびEMCストレージ・サーバーがサポートされます。

- 記憶域サーバーが通信用のEnterprise Manager Cloud Controlでインストールおよび監視される管理エージェントに接続されていることを確認します。

- ストレージ・サーバーが登録され、スナップ・クローンに有効な少なくとも1つのデータベースが存在することを確認します。

- プロファイルを作成するには、EM_STORAGE_OPERATOR権限またはEM_STORAGE_ADMINISTRATOR権限を持っている必要があります。

スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成

データベース・プロビジョニング・プロファイルを作成するには、次の手順に従います。

注意:
スナップショットがデータベースによって使用されている場合は、削除できません。スナップショットを削除すると、廃止されます。
つまり、廃止されたスナップショットを使用して新しいデータベースをリクエストすることはできません。これは、データベースに対する赤いプッシュピンで示され、スナップショットが固定され、使用できないことを意味します。

そのスナップショットを使用しているデータベースが削除されると、次回実行時に自動的にパージされます。

1. 次のいずれかの方法を使用して、データベースのプロビジョニング・ページにアクセスできます。

- 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページで、「Oracle Cloud」をクリックし、「設定」、「データソース」の順に選択します。データベース: データソース・ページの「データ・プロファイル」タブで、「作成」をクリックします。

- 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」、「データベースのプロビジョニング」の順に選択します。データベースのプロビジョニング・ページの「プロファイル」セクションで、「作成」をクリックします。

- データベース・ターゲットのホームページで、「Oracle Database」をクリックし、「プロビジョニング」、「プロビショニング・プロファイルの作成」の順に選択します。

2. 参照ターゲット・ページで、検索アイコンをクリックして、ターゲットを選択します。

3. 「検索と選択: ターゲット」ダイアログ・ボックスで、プロファイルを作成するデータベースを選択して、「選択」をクリックします。

注意:
選択したデータベースがスナップ・クローンに対して有効であることを確認します。詳細は、「スナップ・クローンの有効化または無効化」を参照してください。

4. 「参照ターゲット」ページで、次を選択します。

- データ・コンテンツ

- 「構造およびデータ」を選択し、データベースから物理ファイルと構造ファイルを含めます

- 作成

- ストレージ・スナップショット

5. 「資格証明」セクションで、データベースを選択します。「資格証明」列で、「名前付き資格証明」を選択して「資格証明名」列から資格証明名を選択するか、「優先資格証明」を選択します。「次」をクリックします。

6. データベース・プロビジョニング・プロファイルの作成・ページの「プロファイル情報」セクションで、次の操作を行います。

- データベース・プロファイルが作成されるソフトウェア・ライブラリ内のプロファイルの場所を指定または選択します。

- 一意のプロファイル名を指定します。

For example:
Snap Clone Profile for HR database

- プロファイルの説明を追加します。

- プロファイル・バージョンとベンダーを確認します。

- ホスト名、データベース、データ・コンテンツ、データ・コンテンツ・モジュールなどのノートを追加します。

7. 「スケジュール」セクションで、プロファイルの作成をすぐに開始するか、後でスケジュールできます。また、プロビジョニング・プロファイルの作成の繰返しを選択し、繰返し時間を設定することもできます。

8. 「ポリシーのパージ」セクションには、次の3つのオプションが表示されます。

- なし。このオプションは、収集したデータをパージしない場合に選択します。

- スナップショット。このオプションでは、パージできるスナップショットの最大数を指定できます。

- 日間。このオプションでは、データ・コンポーネントのパージが必要になるまでの日数を指定できます。

9. 作業ディレクトリを指定または選択します。「次」をクリックします。

10. 確認ページで、前のページで行った選択内容が正しく表示されていることを確認し、「発行」をクリックします。正しく表示されていない場合は、変更を行うページに達するまで「戻る」を繰り返しクリックします。プロビジョニング・プロファイルの作成を中断するには、「取消」をクリックします。

「データの表示」が「リアル・タイム: 手動リフレッシュ」に設定されている場合、プロビジョニング・プロファイルの作成ジョブを発行したら、ページを手動でリフレッシュしてください。それ以外の場合、一定の期間経過後にリロードするように「データの表示」を設定し、左側のペインの「プロシージャ・ステップ」ツリーから実行ステップを選択して詳細を表示します。

発行したジョブを表示するには、「データ・プロファイル」タブで「プロシージャ・アクティビティ」リンクを選択します。

20.4.8.1 テスト・マスターのスナップショットの作成およびリフレッシュ

スナップショット・プロファイルが作成された後で、スケジュールされた間隔でプロファイルをリフレッシュし、プロファイルの新規バージョンを作成できます。

テスト・マスター(またはフィジカル・スタンバイ・データベース)のスナップショット・プロファイルを作成するには、第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」にリストされている手順に従います。スナップショット・プロファイルをリフレッシュするには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「設定」を選択し、左側のパネルで「データベース・サービス」ファミリを選択します。「データ・プロファイル」タブをクリックします。

2. リフレッシュするスナップショット・プロファイルを選択します。

図20-2 データ・プロファイルのリフレッシュ

「リフレッシュ」をクリックします。プロファイルの新規スナップショット(バージョン)が作成されることを示すメッセージが表示されます。「はい」をクリックして、プロファイルのリフレッシュ・ジョブを発行し、新規スナップショットを作成します。

20.4.8.1.1

スナップショットのパージ・ポリシー

スナップショットは、ユーザーが最新の本番データを使用できるようにするため、定期的なリフレッシュが可能です。スナップショットをリフレッシュするたびに、そのスナップショットの新しいバージョンが作成されます。セルフ・サービス・ユーザーが自分のデータベースを新しいバージョンのスナップショットにリフレッシュする場合、古いバージョンを削除できます。それらは手動で削除するか、スナップショットの作成時にパージ・ポリシーを定義できます。

パージ・ポリシーの例:

図20-2で、HRMS Application Test Master Snapshotsに対して定義されているパージ・ポリシーは、6スナップショットであることがわかります。つまり、スナップショットの7番目のバージョンが作成されると、1番目のバージョンがパージされます。どの時点においても、HRMS Application Test Master Snapshotsプロファイルに対しては、6つのスナップショット・バージョンのみが存在します。

この図では、「含む」列で7スナップショットが使用可能であることと、「削除期限超過」列に1が表示されていることもわかります。これは、1つのスナップショット・バージョンが削除用にマークされているが、まだ使用されていることを示します。

「コンテンツ」リージョンの「使用者」列で、このスナップショットを1つのデータベースが使用中であるため、削除できないことがわかります。「データベース」ページにドリルダウンして、このスナップショット・バージョンを使用しているセルフ・サービス・ユーザーを特定できます。次に、そのセルフ・サービス・ユーザーに、現在のデータベースを最新のバージョンにリフレッシュする必要があることを通知できます。データベースがリフレッシュされると、スナップショットはパージされます。

20.4.9 スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成

スナップ・クローン・ベースのサービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。選択するEM_SSA_ADMINISTRATORロールには、EM_STORAGE_OPERATOR権限が含まれている必要があります。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図20-3 サービス・テンプレートの作成: 一般(スナップ・クローン)

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「ソース識別」セクションで、「プロファイルの使用」ラジオ・ボタンを選択し、「検索」アイコンをクリックして、作成したスナップ・クローン・プロファイルに基づいてテスト・マスター・データベースを選択します。

8. 「プロファイルのバージョン」フィールドで、次のいずれかを選択できます。

- 最新: これにより、セルフ・サービス・ユーザーによって最新のプロファイルが常に使用されます。

- リクエスト時にユーザーが選択: このオプションが選択されている場合、セルフ・サービス・ユーザーは、サービス・リクエストの作成時に使用するプロファイルを選択できます。

9. 「データベース定義」リージョンで、次の項目を指定します。

- タイプ: 単一インスタンスまたはReal Application Cluster (RAC)を指定できます。「RAC」を選択した場合は、ノード数を指定します。

- データベースSID: これは、オプション・フィールドです。「接頭辞の指定」または「リクエスト時にユーザーにより指定」を選択できます。

- 接頭辞の指定: このオプションを選択する場合、データベースの作成時に一意のシステム識別子(SID)を生成するために使用される接頭辞を入力します。接頭辞は、このサービス・テンプレートを使用して作成されたデータベースの識別に役立ちます。接頭辞には、最大6文字を使用できます。
生成される新しいデータベース名は、ここで指定されるSID接頭辞をベースにします。たとえば、接頭辞がMYDBと指定されている場合、新しいデータベースのSIDは、MYDB0000、MYDB0001、MYDB0002 (以降同様)と生成されます。

既存のデータベース(実行中のデータベースおよび処理中のリクエスト)については、単一インスタンス・データベースに対して一意のSID名が生成されるか、Real Application Clusterデータベースに対して一意の名前が生成されます。たとえば、ホストで実行中の既存のSIDがMYDB0000、MYDB0001、MYDB0002で、処理中がMYDB0003、MYDB0004である場合、新規リクエストに対して生成される新規SIDまたはデータベース名はMYDB0005です。

- リクエスト時にユーザーにより指定: このオプションを選択する場合、このフィールドを空白のままにして、データベース・リクエストの作成時にSIDを指定できます。

- ドメイン名: これは、オプション・フィールドです。作成する新しいデータベースに使用するドメイン名を入力します。ドメイン名の先頭には「.」(ドット)が付いていないことを確認してください。

10. 「ゾーン」リージョンで、「追加」をクリックして、データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。「プールの割当て」をクリックします。リストからプールを選択し、このプールをPaaSインフラストラクチャ・ゾーンに割り当てます。データベースはこのプール内にプロビジョニングされます。

11. ゾーンおよびプールを選択したら、ホスト・ターゲットが「参照ホスト」フィールドに設定されます。

12. 次をクリックします。データベース・クラウド・セルフ・サービス・ポータルの設定: データベースページが表示されます。

図20-4 サービス・テンプレートの作成: データベース(スナップ・クローン)

13. 「参照ホスト」リージョンに、データベース・クラウド・セルフ・サービス・ポータルの設定: 一般ページで選択したPaaSインフラストラクチャ・ゾーンの名前、データベース・プールおよび参照ホストが表示されます。
選択したファイル・システムの場所およびリスナー・ポートなどのデータベース値は、参照ホストで利用できる必要があります。

14. 次の詳細を指定します。

- ストレージ: データベースによって使用されるボリュームを構成できます。

- マウント・ポイント接頭辞: マウント・ポイント接頭辞には、「すべてのボリュームで同じ」または「ボリュームごとに異なる」を指定できます。
プロビジョニングするデータベースの新しいマウント・ポイントの接頭辞を指定します。この値は、このボリュームのクローンがマウントされる自動生成されたマウント・ポイントに接頭辞として追加されます。ボリュームが/<mount-prefix>_<unique-suffix-generated-by-EM>/<source-path>にマウントされます。マウント・ポイント接頭辞が各ボリュームで異なる場合、ボリュームごとに異なる値を指定します。

- 書込み可能領域: 書込み可能領域には、「すべてのボリュームで同じ」または「ボリュームごとに異なる」を指定できます。
ブロック変更に必要な領域の量を指定します。ここで指定される値は、サーバーに指定されるストレージ上限を超えることはできません。たとえば、データ変更が最小限である場合、元のボリューム・サイズの1%として値を指定します。

- アーカイブ有効化: このチェック・ボックスが選択されている場合、リフレッシュ中にデータベースは停止しません。これにより、セルフ・サービス・ユーザーは、データベースを停止せずにバックアップおよびリストア操作をスケジュールできます。

- スナップショット・ポリシー: スナップショットは、特定の期間についての履歴データです。デフォルトでは、1時間ごとにパフォーマンス・データのスナップショットが自動的に生成され、その統計はワークロード・リポジトリに8日間保存されます。「ユーザーに新規データベースのスナップショットの作成を許可します」チェック・ボックスを選択して、取得できる「最大スナップショット数」を指定します。
スナップショットは、特定の時点で作成できます。スナップショットの数は、セルフ・サービス管理者が「最大スナップショット数」フィールドに指定した値によって決定されます。スナップショットが取得されると、特定の時点で取得された特定のスナップショットにデータベースをリストアできます。たとえば、snap1、snap2、snap3などの複数のスナップショットがある状態で、データベースがsnap2にリストアされると、snap3は削除されます。

- 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。

- 管理者資格証明: 新しいデータベースのシステム・スキーマのパスワードを指定します。これらのスキーマは、EM_SSA_USERSに対して使用できません。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。これらの値が指定されていない場合は、デフォルト値が使用され、EM_ADMINISTRATORがそれらを変更できます。

- 非管理者資格証明: システム・スキーマとは別に、他のスキーマへのアクセスを制限する場合、「非管理者資格証明」リージョンでそれらを選択して、パスワードを指定できます。

- マスター・アカウントの権限: マスター・アカウントの名前を入力します。マスター・アカウント・ユーザーに提供する権限を指定するには、それらを「権限」フィールドに指定します。

15. 次をクリックします。サービス・テンプレートの作成: 初期化パラメータページが表示されます。

図20-5 サービス・テンプレートの作成: 初期化パラメータ(スナップ・クローン)

16. このページで、次のものを指定できます。

- データベース・サイズ: このサービス・テンプレートでサポートするデータベース・サイズを選択します。
注意: データベース・サイズの定義は、emcli create_database_sizeコマンドを使用して定義されている必要があります。詳細は、第47.5項「データベース・サイズEM CLI動詞」を参照してください。

小、中、大などのサイズを選択できます。各データベース・サイズには、特定のメモリー、記憶域、CPUコアおよびユニットがあります。サイズを選択し、「テンプレートに含める」を選択してそれをサービス・テンプレートに関連付けます。「デフォルト」をクリックし、それをデフォルトのデータベース・サイズとして指定します。

- 初期化パラメータ: データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択し、「セット」アイコンをクリックして、パラメータの値を変更します。

17. 次をクリックします。サービス・テンプレートの作成: カスタマイズ・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。
カスタムのSQL後スクリプトを指定して、そのスクリプトを実行するユーザーを選択することもできます。詳細は、第24.1.1項「SQL後スクリプト」を参照してください。

18. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。これらのプロパティは、作成されたデータベース・クローンに適用されます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を変更できません。

19. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

20. サービス・テンプレートの作成: 確認ページが表示されます。「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。

20.4.10 チャージバックの構成

オプションで、チャージバック・サービスを構成できます。第43章「チャージバック管理」を参照してください。

20.4.11 データベースのリクエスト

セルフ・サービス・ユーザーは、データベース・テンプレート・プロファイルに基づいてサービス・テンプレートを選択し、データベースを作成できるようになりました。第22.2項「データベースのリクエスト」を参照してください。

20.4.12 例: 同期テスト・マスターからのスナップ・クローンの作成

次の例は、フィジカル・スタンバイ・データベースからスナップ・クローンを作成する方法を示しています。

1. 最初に、すべての前提条件が満たされていることを確認する必要があります。第12.1項「はじめに」を参照してください。

2. 次の手順では、本番データベースとフィジカル・スタンバイ・データベースを識別します。本番データベースはprod1で、スタンバイ・データベースはprod1stbです。

3. 次に、ストレージ・サーバーを登録する必要があります。この手順では、ストレージを検証し、ストレージ・サーバーでprod1stbを検出します。第20.4.2項「ストレージ・サーバーの登録」を参照してください。

4. 1つ以上のPaaSインフラストラクチャ・ゾーンおよび1つ以上のデータベース・プールを作成する必要があります。第20.4.3項「リソース・プロバイダの作成」を参照してください。

5. セルフ・サービス・ユーザーに割り当てる割当て制限を定義する必要があります。第20.4.5項「割当て制限の定義」を参照してください。

6. 次の手順では、スタンバイ・データベースのprod1stbをテスト・マスターとして指定します。

7. スナップ・クローン用にprod1stbを有効にする必要があります。これにより、スナップショット・テクノロジを使用したスナップ・クローンの作成が可能になります。第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください。

8. 次の手順では、prod1stbからスナップショット・プロファイルを作成します。第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。
プロファイルの作成時に、「開始日」を05/15/2015に、「繰返し」スケジュールを「N日ごと」に、「頻度」を1日ごとに指定します。「最終日時」の日付を05/20/2015に指定します。スナップショット・プロファイルの新しいバージョンが、05/15/2015を開始日として毎日作成されます。

「パージ・ポリシー」フィールドで、「スナップショット数」を5に指定します。これにより、スナップショットのバージョンが5つ作成された後、1番目の(または最も古い)バージョンがパージされます。

9. このプロファイルをセルフ・サービス・ユーザーが使用できるようにするには、サービス・カタログ・エントリまたはサービス・テンプレートを作成する必要があります。スナップ・クローン・テンプレートというテンプレートを作成します。第20.4.9項「スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成」を参照してください。「プロファイルのバージョン」フィールドを「リクエスト時にユーザーが選択」に設定します。セルフ・サービス・ユーザーは、スナップ・クローンの作成に使用するプロファイル・バージョンを選択できます。

10. これで、セルフ・サービス・ユーザーは、スナップ・クローン・テンプレートを使用して、プロファイルのバージョンを選択し、それを使用してスナップ・クローンを作成できます。第22.2項「データベースのリクエスト」を参照してください。プロファイルの新しいバージョンが使用可能になると(第20.4.8.1項「テスト・マスターのスナップショットの作成およびリフレッシュ」を参照)、セルフ・サービス・ユーザーは、プロファイルを最新バージョンにリフレッシュできます。第22.3項「データベースのリフレッシュ」を参照してください。
5スナップショットに設定されたパージ・ポリシーに基づいて、スナップショットの古いバージョンは削除されます。ただし、セルフ・サービス・ユーザーがそのスナップショットを使用中のデータベースを保持している場合、プロファイルは、セルフ・サービス・ユーザーがそのプロファイルを最新バージョンにリフレッシュするまで削除できません。

20.4.13 EMCスナップ・クローンのサービス・テンプレートの作成

注意:
このオプションは、EMCストレージに作成されたスナップショットにのみ使用できます。

前提条件

EMCストレージにスナップ・クローンを作成するには、その前に、「EMCストレージ・サーバーの構成」で説明した前提条件が満たされていることを確認する必要があります。

既存のデータベースを使用してサービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図20-6 サービス・テンプレートの作成: 一般: EMCスナップ・クローン

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「ソース識別」セクションで、「既存のデータベースの使用」ラジオ・ボタンを選択し、「検索」アイコンをクリックして、前に作成したテスト・マスター・データベースを選択します。詳細は、第20.4.6項「テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用」を参照してください。

8. ホストおよびデータベース資格証明を指定します。

9. 「データベース定義」リージョンで、「スナップ・クローン・データベースの作成」オプションが選択されています。次の詳細を入力します。

- タイプ: 単一インスタンスまたはReal Application Cluster (RAC)を指定できます。「RAC」を選択した場合は、ノード数を指定します。

- データベースSID: これは、オプション・フィールドです。「接頭辞の指定」または「リクエスト時にユーザーにより指定」を選択できます。

- 接頭辞の指定: このオプションを選択する場合、データベースの作成時に一意のシステム識別子(SID)を生成するために使用される接頭辞を入力します。接頭辞は、このサービス・テンプレートを使用して作成されたデータベースの識別に役立ちます。接頭辞には、最大6文字を使用できます。
生成される新しいデータベース名は、ここで指定されるSID接頭辞をベースにします。たとえば、接頭辞がMYDBと指定されている場合、新しいデータベースのSIDは、MYDB0000、MYDB0001、MYDB0002 (以降同様)と生成されます。

既存のデータベース(実行中のデータベースおよび処理中のリクエスト)については、単一インスタンス・データベースに対して一意のSID名が生成されるか、Real Application Clusterデータベースに対して一意の名前が生成されます。たとえば、ホストで実行中の既存のSIDがMYDB0000、MYDB0001、MYDB0002で、処理中がMYDB0003、MYDB0004である場合、新規リクエストに対して生成される新規SIDまたはデータベース名はMYDB0005です。

- リクエスト時にユーザーにより指定: このオプションを選択する場合、このフィールドを空白のままにして、データベース・リクエストの作成時にSIDを指定できます。

- ドメイン名: これは、オプション・フィールドです。作成する新しいデータベースに使用するドメイン名を入力します。ドメイン名の先頭には「.」(ドット)が付いていないことを確認してください。

10. 「ゾーン」リージョンで、「追加」をクリックして、データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。「プールの割当て」をクリックします。リストからプールを選択し、このプールをPaaSインフラストラクチャ・ゾーンに割り当てます。データベースはこのプール内にプロビジョニングされます。

11. ゾーンおよびプールを選択したら、ホスト・ターゲットが「参照ホスト」フィールドに設定されます。

12. 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。次をクリックします。サービス・テンプレートの作成: データベースページが表示されます。

13. 「参照ホスト」リージョンに、データベース・クラウド・セルフ・サービス・ポータルの設定: 一般ページで選択したPaaSインフラストラクチャ・ゾーンの名前、データベース・プールおよび参照ホストが表示されます。
選択した自動ストレージ管理(ASM)ディスク・グループ、ファイル・システムの場所およびリスナー・ポートなどのデータベース値は、参照ホストで利用できる必要があります。

14. 次の項目を指定します。

- 記憶域タイプ: 「自動ストレージ管理(ASM)」を選択します。Oracle Automatic Storage Management (ASM)は、単一インスタンスおよびRAC構成をサポートするデータベース・ファイルのボリューム・マネージャおよびファイル・システムです。ASMでは、ストレージ・システム内のディスクを1つ以上のディスク・グループに分類します。ASMを選択する場合、ディスク・グループをここで選択します。

- 高速リカバリ(オプション): バックアップおよびリカバリ・ファイルの管理を簡略化するために、データベースに高速リカバリ領域を作成できます。「高速リカバリ領域の有効化」チェック・ボックスを選択して、リカバリに関連するファイルの格納先となる場所を指定します。高速リカバリ領域は、バックアップおよびリカバリ・ファイル用の集中化されたディスクの場所を提供する、ASMディスク・グループまたはファイル・システムである可能性があります。高速リカバリ領域の場所および高速リカバリ・サイズを指定します。高速リカバリ領域に割り当てるディスク領域の量は、データベースのサイズおよびアクティビティ・レベルによって異なります。
「アーカイブ有効化」チェック・ボックスが選択されている場合、リフレッシュ中にデータベースは停止しません。これにより、セルフ・サービス・ユーザーは、データベースを停止せずにバックアップおよびリストア操作をスケジュールできます。

15. 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。

16. 「管理者資格証明」を指定します。新しいデータベースのシステム・スキーマのパスワードを指定します。これらのスキーマは、EM_SSA_USERSに対して使用できません。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。これらの値が指定されていない場合は、デフォルト値が使用され、EM_ADMINISTRATORがそれらを変更できます。

17. システム・スキーマとは別に、他のスキーマへのアクセスを制限する場合、「非管理者資格証明」リージョンで選択して、パスワードを指定できます。これらのスキーマはロックされ、EM_SSA_USERSはアクセスできません。次をクリックします。

18. 次をクリックします。サービス・テンプレートの作成: 初期化パラメータページが表示されます。このページで、次のものを指定できます。

- データベース・サイズ: このサービス・テンプレートでサポートするデータベース・サイズを選択します。
注意: データベース・サイズの定義は、emcli create_database_sizeコマンドを使用して定義されている必要があります。詳細は、第47.5項「データベース・サイズEM CLI動詞」を参照してください。

小、中、大などのサイズを選択できます。各データベース・サイズには、特定のメモリー、記憶域、CPUコアおよびユニットがあります。サイズを選択し、「テンプレートに含める」を選択してそれをサービス・テンプレートに関連付けます。「デフォルト」をクリックし、それをデフォルトのデータベース・サイズとして指定します。

- 初期化パラメータ: データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択し、「セット」アイコンをクリックして、パラメータの値を変更します。

19. 次をクリックします。サービス・テンプレートの作成: カスタマイズ・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。

20. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を変更できません。

21. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

22. サービス・テンプレートの作成: 確認ページが表示されます。「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。

20.5 個別に同期されたテスト・マスターからのスナップ・クローンの作成

テスト・マスターがNASストレージ・デバイスに存在する場合、個別に同期されたテスト・マスターからスナップ・クローンを作成できます。この表では、スナップショット・プロファイルを使用したスナップ・クローンの作成に必要な手順を示します。

表20-2 スナップ・クローンの作成 - 個別フロー

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第20.5.1項「はじめに」を参照してください。

2

ストレージ・サーバーを登録します。

第20.5.2項「ストレージ・サーバーの登録」を参照してください。

3

1つ以上のリソース・プロバイダを作成します。

第20.5.3項「リソース・プロバイダの作成」を参照してください。

4

リクエスト設定を構成します。

第20.5.4項「リクエスト設定の構成」を参照してください。

4

各セルフ・サービス・ユーザーの割当て制限を定義します。

第20.5.5項「割当て制限の定義」を参照してください。

5

RMANバックアップからテスト・マスター・データベースを作成します。

第20.5.6項「個別に同期されたテスト・マスターの作成」を参照してください。

6

スナップ・クローンのテスト・マスターを有効にします

第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください

6

テスト・マスターからスナップ・クローン・プロファイルを作成します。

第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

9

作成したプロファイルに基づくサービス・テンプレートを作成します。

第20.5.7項「スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

10

チャージバック・サービスを構成します(この手順はオプションです)。

第20.5.8項「チャージバックの構成」を参照してください。

11

作成したサービス・テンプレートを選択してデータベースをリクエストします。

第20.5.9項「データベースのリクエスト」を参照してください。

12

テスト・マスターとデータベース・インスタンスをリフレッシュします。

- テスト・マスターをリフレッシュします。

- スナップショット・プロファイルをリフレッシュします。

- スナップ・クローン・データベース・インスタンスをリフレッシュします。

関連項目:

- 第20.5.10項「テスト・マスター・データベースのリフレッシュ」

- 第20.5.11項「スナップショット・プロファイルのリフレッシュ」。

- 第22.3項「データベースのリフレッシュ」

20.5.1 開始

第12.1項「はじめに」を参照してください。

20.5.2 ストレージ・サーバーの登録

第12.7項「ストレージ・サーバーの登録および管理」を参照してください。

20.5.3 リソース・プロバイダの作成

第20.4.3項「リソース・プロバイダの作成」を参照してください。

20.5.4 リクエスト設定の構成

第11.2.3項「リクエスト設定の構成」を参照してください。

20.5.5 割当て制限の定義

第20.4.5項「割当て制限の定義」を参照してください。

20.5.6 個別に同期されたテスト・マスターの作成

テスト・マスター・データベースとは、本番データベースのサニタイズされたバージョンです。テスト・マスターが作成される前に、オプションで本番データをマスキングできます。テスト・マスターは、前のポイント・イン・タイムで取得され、特定の間隔でリフレッシュされるスナップショットまたはRMANバックアップ・プロファイルから作成できます。このオプションは、ソース・データをマスクして機密データを隠す必要がある場合に便利です。

テスト・マスターを作成するには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「設定」を選択し、左側のパネルで「データベース・サービス」ファミリを選択します。「データ・ソース」を選択し、「テスト・マスター・データベース」タブをクリックします。

2. 新しいテスト・マスターを作成するには、「作成」メニューをクリックします。テスト・マスターの作成元にする本番データベースを選択し、「選択」をクリックします。データベースのクローニング: ソースと宛先ページが表示されます。

3. テスト・マスター・データベースの作成: ソースと宛先ページで、次の操作を実行します。

- 「ソース」セクションで、SYSDBAのデータベース資格証明とデータベース・ホスト資格証明の検索アイコンを選択して、資格証明セレクタを起動します。「OK」をクリックします。

- 「データ時系列」セクションで、「即時」または「前のポイント・イン・タイム」を選択します。
「即時」を選択した場合、SYSASMのASM資格証明を指定するか、検索して選択します。「即時」はライブ・クローンを意味します。

「前のポイント・イン・タイム」を選択した場合、RMANバックアップ・イメージのカルーセルが表示されます。イメージで「選択」をクリックして、適切なRMANバックアップを選択します。

選択したバックアップまたはスナップショットと次のバックアップまたはスナップショット(あるいは最新の時点のソース)の間の時間を選択します。バックアップまたはダンプが特定の間隔で作成され、これらを基とするテスト・マスターには、特定時点の本番データベースが反映されます。本番データベースの最新データを反映するには、テスト・マスターを定期的にリフレッシュする必要があります。

4. 宛先データベースの定義セクションで、次の操作を行います。

- 表示名を指定します。

- グローバル・データベース名およびSIDを指定します。
データベースは、「グローバル・データベース名」で一意に識別されます。名前の一般的な形式は、name.domainです。データベースは、SIDで一意に識別される少なくとも1つのOracleインスタンスによって参照されています。

- 次のデータベース・タイプから1つ選択します。

- 単一インスタンス・データベース
「ホスト」セクションで、Oracleホームの場所を指定します。ホストはデフォルトで指定されます。次に、データベース・ホーム資格証明およびSYSASMのASM資格証明を選択します。

- RACデータベース
「ホスト」セクションで、クラスタ・ターゲットを指定または選択します。Oracleホームの場所は、デフォルトで指定されます。次に、データベース・ホスト資格証明およびSYSASMのASM資格証明を指定します。

「ノード」セクションで、クラスタおよびOracleホームを選択し、管理者の管理対象となるOracle RACデータベースが作成される1つ以上のホストを表示します。

- RAC One Nodeデータベース
「ホスト」セクションで、クラスタ・ターゲットを指定または選択します。Oracleホームの場所は、デフォルトで指定されます。次に、データベース・ホスト資格証明およびSYSASMのASM資格証明を指定します。

「ノード」セクションで、クラスタおよびOracleホームを選択し、管理者の管理対象となるOracle RACデータベースが作成される1つ以上のホストを表示します。

注意:
Oracleでは、クローンの一部としてインライン・パッチ適用をサポートしています。選択された宛先ホームに、最新のCPUやPSUなどのパッチが適用されている場合、クローニングされたデータベースはそのレベルで自動的に起動します。

「次」をクリックします。

5. 「テスト・マスター・データベースの作成: 構成」ページで、次の操作を実行します。

- データベース・ファイルの場所: データ・ファイル、一時ファイル、REDOログ・ファイルおよび制御ファイルが作成される場所を指定します。登録されたストレージ・ボリュームに存在する必要があるマウント・ポイントを指定して、セルフ・サービス管理者がこのテスト・マスターでスナップ・クローンを有効化できるようにする必要があります。
次のいずれかを選択できます。

- ファイル・システム: Oracle Databaseのファイル・システムは、データベース表に格納されるファイルおよびディレクトリの標準ファイル・システム・インタフェースを作成します。このオプションを選択する場合、ファイル・システムの場所を指定するか選択する必要があります。すべてのファイルに共通の場所を指定することも、「Oracle Optimal Flexible Architecture (OFA)に準拠したディレクトリ構造を使用」チェック・ボックスを選択して、データ・ファイル、REDOログ・ファイルなどに別々の場所を指定することも可能です。

- 自動ストレージ管理: Oracle Automatic Storage Management (ASM)は、単一インスタンスおよびRAC構成をサポートするデータベース・ファイルのボリューム・マネージャおよびファイル・システムです。ASMでは、ストレージ・システム内のディスクを1つ以上のディスク・グループに分類します。ASMを選択した場合は、データベース・ファイルに共通の場所を選択してください。

- リカバリ・ファイルの場所: バックアップおよびリカバリ・ファイルの管理を簡略化するには、データベースに高速リカバリ領域を作成します。高速リカバリ領域にすることができるのは、バックアップおよびリカバリ・ファイル向けに一元化されたディスクの場所を提供するASMディスク・グループまたはファイル・システムです。セルフ・サービス・ユーザーがバックアップをスケジュールし、リストア操作を実行できるようにするには、「高速リカバリ領域の使用」チェック・ボックスを選択し、高速リカバリ領域および高速リカバリ・サイズの場所を指定します。高速リカバリ領域に割り当てるディスク領域の量は、データベースのサイズおよびアクティビティ・レベルによって異なります。

- リスナー構成: 「追加」をクリックして、新しいデータベースに関連付けるリスナー・ターゲットを1つ以上追加します。

- データベース資格証明: クローニングする新しいデータベースの管理ユーザー(SYS、SYSTEMおよびDBSNMP)のパスワードを指定します。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。

6. 次をクリックします。db_block_sizeなどの一部の値は変更できません。

7. 次をクリックします。「テスト・マスター・データベースの作成: 後処理」ページが表示されます。

図20-7 テスト・マスターの設定: 後処理

後処理ページで、次の内容を指定します。

- マスキング定義: データ・マスキングは、テスト・データベースや本稼働していないデータベースの機密データをマスキングするプロセスです。マスキング定義では、マスクされたデータの形式でマスクする列を定義します。データベースのクローニング後に適用するマスキング定義を指定します。マスキング定義を選択した後、「インプレース・マスキング」オプションを選択すると、クローニングされたデータベースの機密データをマスクされたデータでインプレースに置換するスクリプトが生成されます。マスキング定義の作成の詳細は、Enterprise Manager Database Testingガイドを参照してください。

注意:
マスキング定義は、Oracle Data Masking and Subsettingライセンス・パックがある場合にのみ使用できます。

- データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。

- SYS、SYSTEM、その他の指定されたユーザーなどのユーザーとして新規にクローニングしたデータベースに対してスクリプトを実行できるようにするSQLスクリプトのパスを指定します。SQLスクリプトでは、クローニングされたデータベースをカスタマイズできます。詳細は、第24.1.1項「SQL後スクリプト」を参照してください。

- テスト・マスターに基づいたデータベース・プロビジョニング・プロファイルを作成する場合は、「データ・プロファイルの作成」チェック・ボックスを選択します。これらのプロファイルは、自動的に、または指定した間隔でリフレッシュできます。異なるバージョンのプロファイルが保存され、これらがパージされるまで、セルフ・サービス・ユーザーが使用できます。これにより、テスト・マスターが定期的に更新され、セルフ・サービス・ユーザーが最新のデータを使用できます。次の場合は、データベース・プロビジョニング・プロファイルを作成できます。

- このバージョンのテスト・マスターを今後、テスト・マスターのリフレッシュ後もクローニングに使用できるようにする必要がある。

プロファイルについて、次の詳細を入力します。

- プロファイル・タイプ: 「RMANバックアップ」または「RMANイメージ」を選択します。

- バックアップ・モード: 「RMANバックアップ」プロファイル・タイプを選択する場合は、「オンライン・バックアップ」を選択してデータベースの稼働中にバックアップを作成するか、「オフライン・バックアップ」を選択してバックアップの期間中データベースを停止し、バックアップの完了後に再び起動します。

- バックアップの場所: バックアップの場所をすでに含むディレクトリ・パスを入力します。

- バックアップ・ファイル・タグ: バックアップ・ファイルは、ここで指定したタグでタグ付けされます。

- 場所: バックアップの場所のディレクトリを選択します。

- 名前、説明、バージョン番号、ベンダーおよび追加のノートを入力します。

- パージ・ポリシー・タイプ: これは、「なし」、「スナップショット」または「日」にすることができます。「なし」を選択した場合、必要に応じてプロファイルを手動で削除する必要があります。「スナップショット」を選択した場合は、保持できるスナップショットの最大数を指定します。「日間」を選択した場合は、プロファイルを保持できる日数を指定します。

- スケジュール: プロファイルを即時に作成する必要があるか、後で作成するかを指定します。

8. 次をクリックします。テスト・マスター作成のスケジュールを指定します。すぐに作成することも(フィジカル・スタンバイを使用した場合は、すぐに作成されて、自動的にリフレッシュされます)、別の日/時間に作成して、指定した間隔でリフレッシュすることもできます。

9. 次をクリックします。これまでに入力した情報を確認し、「発行」をクリックしてテスト・マスターを作成します。テスト・マスターが作成された後、必要に応じてテスト・マスターをリフレッシュして、テスト・マスターがベースとするプロファイルの新規バージョンを作成できます。

注意:
emcli create_cloneコマンドを使用してテスト・マスターを作成することもできます。詳細は、第47.9項「EM CLI動詞を使用したデータベース・クローンの作成」を参照してください。

20.5.7 スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成

第20.4.9項「スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

20.5.8 チャージバックの構成

オプションで、チャージバック・サービスを構成できます。第43章「チャージバック管理」を参照してください。

20.5.9 データベースのリクエスト

セルフ・サービス・ユーザーは、データベース・テンプレート・プロファイルに基づいてサービス・テンプレートを選択し、データベースを作成できるようになりました。第22.2項「データベースのリクエスト」を参照してください。

20.5.10 テスト・マスター・データベースのリフレッシュ

テスト・マスター・データベースは、特定の時点で取得された本番データベースのRMANバックアップ・プロファイルから作成されます。本番データベースは継続的に更新されるため、テスト・マスターは、最新の本番データを使用できるように定期的にリフレッシュする必要があります。

テスト・マスター・データベースをリフレッシュするには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「設定」を選択し、左側のパネルで「データベース・サービス」ファミリを選択します。「テスト・マスター・データベース」タブをクリックします。

2. リフレッシュするテスト・マスターを選択し、「リフレッシュ」をクリックします。データベースのリフレッシュ: ソースと宛先ページが表示されます。

3. 「前のポイント・イン・タイム」オプションを選択し、テスト・マスターをリフレッシュするバックアップを選択します。ソースと宛先の資格証明を変更できます。

4. 「即時」オプションを選択した場合は、次の画面が表示されます。

図20-8 テスト・マスターのリフレッシュ: ソースと宛先(即時)

次をクリックします。「構成」ページが表示されます。

図20-9 テスト・マスターのリフレッシュ: 構成

5. クローン・データベースとデータベース資格証明で使用されるストレージ・ボリュームの「マウント・ポイント接頭辞」を指定します。次をクリックします。

6. 初期化パラメータ・ページでは、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を編集します。次をクリックします。

7. 後処理ページで、次の内容を指定します。

- マスキング定義: データ・マスキングは、テスト・データベースや本稼働していないデータベースの機密データをマスキングするプロセスです。マスキング定義では、マスクされたデータの形式でマスクする列を定義します。データベースのクローニング後に適用するマスキング定義を指定します。マスキング定義を選択した後、「インプレース・マスキング」オプションを選択すると、クローニングされたデータベースの機密データをマスクされたデータでインプレースに置換するスクリプトが生成されます。マスキング定義の作成の詳細は、Enterprise Manager Database Testingガイドを参照してください

注意:
マスキング定義は、Oracle Data Masking and Subsettingライセンス・パックがある場合にのみ使用できます。

- データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。

- SYS、SYSTEM、その他の指定されたユーザーなどのユーザーとして新規にクローニングしたデータベースに対してスクリプトを実行できるようにするSQLスクリプトのパスを指定します。SQLスクリプトでは、クローニングされたデータベースをカスタマイズできます。詳細は、第24.1.1項「SQL後スクリプト」を参照してください。

8. 次をクリックします。テスト・マスター作成のスケジュールを指定します。すぐに作成することも(フィジカル・スタンバイを使用した場合は、すぐに作成されて、自動的にリフレッシュされます)、別の日/時間に作成して、指定した間隔でリフレッシュすることもできます。

9. 次をクリックします。これまでに入力した情報を確認し、「発行」をクリックしてテスト・マスターをリフレッシュします。

注意:
emcli refresh_databaseコマンドを使用してデータベースをリフレッシュできます。詳細は、第47.6項「データベース・プロファイルEM CLI動詞」を参照してください。

テスト・マスターがリフレッシュされたら、更新されたテスト・マスターに基づいて新しいプロファイルを作成できます。セルフ・サービス・ユーザーは、データベース・インスタンスを最新のプロファイルにリフレッシュできます。テスト・マスターの古いバージョンによって使用されていたストレージ領域は、更新(リフレッシュ)されたテスト・マスターによって再利用されます。

20.5.11 スナップショット・プロファイルのリフレッシュ

テスト・マスターをリフレッシュした後、スナップショット・プロファイルの新しいリビジョンを作成する必要があります。それには、次の手順に従って、スナップショット・プロファイルをリフレッシュする必要があります。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「設定」を選択し、左側のパネルで「データベース・サービス」ファミリを選択します。「データ・ソース」をクリックします。

2. データソース・ページで、「データ・プロファイル」タブをクリックします。プロファイルのリストが表示されます。

図20-10 スナップショット・プロファイルのリフレッシュ

3. リフレッシュするプロファイルを選択して、「プロファイルのリフレッシュ」をクリックします。確認メッセージが表示されます。「はい」をクリックして、プロファイルのリフレッシュ・ジョブを発行します。

20.5.12 例: 個別に同期されたテスト・マスターからのスナップ・クローンの作成

次の例は、個別の間隔でリフレッシュされるテスト・マスター・データベースからスナップ・クローンを作成する方法を示しています。

1. 最初に、すべての前提条件が満たされていることを確認する必要があります。第12.1項「はじめに」を参照してください。

2. 次に、ストレージ・サーバーを登録する必要があります。第20.4.2項「ストレージ・サーバーの登録」を参照してください。

3. 1つ以上のPaaSインフラストラクチャ・ゾーンおよび1つ以上のデータベース・プールを作成する必要があります。第20.4.3項「リソース・プロバイダの作成」を参照してください。

4. セルフ・サービス・ユーザーに割り当てる割当て制限を定義する必要があります。第20.4.5項「割当て制限の定義」を参照してください。

5. 次の手順では、本番データベース(prod1)を識別し、RMANバックアップ(prod1_backup)を作成します。

6. prod1_backupに基づいてテスト・マスター(testmaster1)を作成します。第20.5.6項「個別に同期されたテスト・マスターの作成」を参照してください。

7. スナップ・クローン用にtestmaster1を有効にする必要があります。これにより、スナップショット・テクノロジを使用したスナップ・クローンの作成が可能になります。第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください。

8. testmaster1に基づいたプロファイル(snap_profile)を作成する必要があります。第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

9. このプロファイルをセルフ・サービス・ユーザーが使用できるようにするには、サービス・カタログ・エントリまたはサービス・テンプレートを作成する必要があります。スナップ・クローン・テンプレート1というテンプレートを作成します。第20.5.7項「スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成」を参照してください。「サービス・テンプレート」で、「プロファイルのバージョン」フィールドが「最新」に設定されます。これにより、セルフ・サービス・ユーザーは、常に最新バージョンのプロファイルを使用してデータベース・インスタンスを作成できます。

10. これで、セルフ・サービス・ユーザーは、スナップ・クローン・テンプレート1を使用してスナップ・クローンを作成できます。第22.2項「データベースのリクエスト」を参照してください。

11. 最新の本番データを取得するため、セルフ・サービス管理者は、TestMaster1をリフレッシュします。第20.5.10項「テスト・マスター・データベースのリフレッシュ」を参照してください。

12. 現在、テスト・マスターには更新済データが含まれるため、新しいリビジョンのプロファイルを作成する必要があります。第20.5.11項「スナップショット・プロファイルのリフレッシュ」を参照してください。

13. 新しいリビジョンのプロファイル(snap_profile)が使用可能になったら、セルフ・サービス・ユーザーは、自分のデータベース・インスタンスをリフレッシュして最新の本番データを取得できます。第22.3項「データベースのリフレッシュ」を参照してください。テスト・マスターの古いバージョンによって使用されていたストレージ領域は、リフレッシュされたテスト・マスターによって再利用されます。

20.6 CloneDBデータベースの作成

CloneDB機能を使用すると、様々な場所にデータをコピーすることなく、データベースを複数回クローニングできます。Oracle Databaseでは、かわりにcopy-on-writeテクノロジを使用してCloneDBデータベースにファイルを作成するため、ディスク上に追加の記憶域が必要となるのは、CloneDBデータベースで変更されたブロックのみとなります。CloneDBによって、テスト目的で必要とされる記憶域の容量を削減し、複数のデータベース・クローンを迅速に作成できます。CloneDBは、11.2.0.3以上のリリースのデータベースでサポートされます。

次の手順に従って、個別に同期されたテスト・マスターを使用することで、CloneDBデータベースを作成できます。

表20-3 スナップ・クローンの作成 - 個別フロー

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第20.5.1項「はじめに」を参照してください。

3

1つ以上のリソース・プロバイダを作成します。

第20.5.3項「リソース・プロバイダの作成」を参照してください。

4

リクエスト設定を構成します。

第20.5.4項「リクエスト設定の構成」を参照してください。

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第20.5.5項「割当て制限の定義」を参照してください。

6

スナップショットを使用してRMANイメージ・バックアップからデータベース・プロビジョニング・プロファイルを作成します。

第20.6.1項「RMANデータベース・イメージを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

9

作成したプロファイルに基づくサービス・テンプレートを作成します。

第20.6.2項「RMANイメージ・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

10

チャージバック・サービスを構成します(この手順はオプションです)。

第20.5.8項「チャージバックの構成」を参照してください。

11

作成したサービス・テンプレートを選択してデータベースをリクエストします。

第20.5.9項「データベースのリクエスト」を参照してください。

20.6.1 RMANデータベース・イメージを使用したデータベース・プロビジョニング・プロファイルの作成

データベース・プロビジョニング・プロファイルを作成するには、次の手順に従います。

1. 次のいずれかの方法を使用して、データベースのプロビジョニング・ページにアクセスできます。

- 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページで、「Oracle Cloud」をクリックし、「設定」、「データソース」の順に選択します。データベース: データソース・ページの「データ・プロファイル」タブで、「作成」をクリックします。

- 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」、「データベースのプロビジョニング」を選択します。データベースのプロビジョニング・ページの「プロファイル」セクションで、「作成」をクリックします。

- データベース・ターゲットのホームページで、「Oracle Database」をクリックし、「プロビジョニング」、「プロビショニング・プロファイルの作成」の順に選択します。

2. 参照ターゲット・ページで、検索アイコンをクリックして、ターゲットを選択します。

3. 「検索と選択: ターゲット」ダイアログ・ボックスで、プロファイルを作成するデータベースを選択して、「選択」をクリックします。

4. 「参照ターゲット」ページで、次を選択します。

- データ・コンテンツ

- データベースから物理ファイルおよび構造ファイルを組み込むための「構造およびデータ」、またはテンプレート内の構造ファイルのみを組み込むための「構造のみ」。

- 作成

- RMANデータベース・イメージ

5. 「資格証明」セクションで、データベースを選択します。「資格証明」列で、「名前付き資格証明」を選択して「資格証明名」列から資格証明名を選択するか、「優先資格証明」を選択します。「次」をクリックします。

6. 「コンテンツ・オプション」ページで、RMANイメージ・モードのバックアップの場所を指定します。デフォルトでは、バックアップの場所として「オフライン・バックアップ」が選択されます。「オンライン・バックアップ」は、それが有効な場合にのみ選択できます。
次に、バックアップの場所の「ディレクトリ」を選択してディレクトリ・パスを入力するか、バックアップの場所がすでに含まれている「高速リカバリ領域」を選択します。

注意:

- 指定した場所にデータベース・プールのすべてのノードからアクセスできることを確認してください。

- データベース・バージョンによっては、プロファイル(イメージ)をNFSの共有場所に手動でステージングする必要があります。

「次」をクリックします。

7. データベース・プロビジョニング・プロファイルの作成・ページの「プロファイル情報」セクションで、次の操作を行います。

- データベース・プロファイルが作成されるソフトウェア・ライブラリ内のプロファイルの場所を指定または選択します。

- 一意のプロファイル名を指定します。

For example:
RMAN Database Image for HR database

- プロファイルの説明を追加します。

- プロファイル・バージョンとベンダーを確認します。

- ホスト名、データベース、データ・コンテンツ、データ・コンテンツ・モジュールなどのノートを追加します。

8. 「スケジュール」セクションで、プロファイルの作成をすぐに開始するか、後でスケジュールできます。また、プロビジョニング・プロファイルの作成の繰返しを選択し、繰返し時間を設定することもできます。

9. 「ポリシーのパージ」セクションには、次の3つのオプションが表示されます。

- なし。このオプションは、収集したデータをパージしない場合に選択します。

- スナップショット。このオプションでは、パージできるスナップショットの最大数を指定できます。

- 日間。このオプションでは、データ・コンポーネントのパージが必要になるまでの日数を指定できます。

10. 作業ディレクトリを指定または選択します。「次」をクリックします。

11. 確認ページで、前のページで行った選択内容が正しく表示されていることを確認し、「発行」をクリックします。正しく表示されていない場合は、変更を行うページに達するまで「戻る」を繰り返しクリックします。プロビジョニング・プロファイルの作成を中断するには、「取消」をクリックします。

「データの表示」が「リアル・タイム: 手動リフレッシュ」に設定されている場合、プロビジョニング・プロファイルの作成ジョブを発行したら、ページを手動でリフレッシュしてください。それ以外の場合、一定の期間経過後にリロードするように「データの表示」を設定し、左側のペインの「プロシージャ・ステップ」ツリーから実行ステップを選択して詳細を表示します。

発行したジョブを表示するには、「データ・プロファイル」タブで「プロシージャ・アクティビティ」リンクを選択します。

20.6.2 RMANイメージ・プロファイルを使用したサービス・テンプレートの作成

RMANイメージ・プロファイルを使用してサービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

3. 左パネルの「データベース」オプションの横にある「設定」リンクをクリックします。ドロップ・ダウン・メニューから「データベース」を選択します。

4. 「サービス・テンプレート」リンクをクリックします。サービス・テンプレート・ページが表示されます。「作成」をクリックします。サービス・テンプレートの作成: 一般ページが表示されます。

5. 図20-11 サービス・テンプレートの作成: 一般(CloneDB)

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「プロファイル」フィールドの隣にある「検索」アイコンをクリックして、RMANイメージ・プロファイルに基づいてテスト・マスター・データベースを選択します。

8. 「プロファイルのバージョン」フィールドで、次のいずれかを選択できます。

- 最新: これにより、セルフ・サービス・ユーザーによって最新のプロファイルが常に使用されます。

- リクエスト時にユーザーが選択: このオプションが選択されている場合、セルフ・サービス・ユーザーは、サービス・リクエストの作成時に使用するプロファイルを選択できます。

9. 「データベース定義」リージョンで、次を選択します。

- 作成: 「CloneDBデータベース」オプションを選択します。各ファイルは、ディスクに作成されたデータベース・ファイルのビット対ビットのコピーであるイメージ・コピーとしてコピーされます。イメージ・コピーは、LinuxのcpやWindowsのCOPYなどのオペレーティング・システム・コマンドで作成したコピーと同じですが、RMANのリポジトリに記録されるため、RMANで使用できます。このオプションによって、記憶域の容量を削減し、複数のデータベースを迅速に作成できます。
オンライン・バックアップを実行する場合は、テスト・マスター・データベースがARCHIVELOGモードに設定され、必要なすべてのアーカイブREDOログ・ファイルが保存され、CloneDBデータベース環境にアクセスできることを確認します。オフライン・バックアップを実行する場合は、CloneDBデータベース環境からバックアップ・コピーにアクセスできることを確認します。

- タイプ: 単一インスタンスまたはReal Application Cluster (RAC)を指定できます。「RAC」を選択した場合は、ノード数を指定します。

- データベースSID: これは、オプション・フィールドです。「接頭辞の指定」または「リクエスト時にユーザーにより指定」を選択できます。

- 接頭辞の指定: このオプションを選択する場合、データベースの作成時に一意のシステム識別子(SID)を生成するために使用される接頭辞を入力します。接頭辞は、このサービス・テンプレートを使用して作成されたデータベースの識別に役立ちます。接頭辞には、最大6文字を使用できます。
生成される新しいデータベース名は、ここで指定されるSID接頭辞をベースにします。たとえば、接頭辞がMYDBと指定されている場合、新しいデータベースのSIDは、MYDB0000、MYDB0001、MYDB0002 (以降同様)と生成されます。

既存のデータベース(実行中のデータベースおよび処理中のリクエスト)については、単一インスタンス・データベースに対して一意のSID名が生成されるか、Real Application Clusterデータベースに対して一意の名前が生成されます。たとえば、ホストで実行中の既存のSIDがMYDB0000、MYDB0001、MYDB0002で、処理中がMYDB0003、MYDB0004である場合、新規リクエストに対して生成される新規SIDまたはデータベース名はMYDB0005です。

- リクエスト時にユーザーにより指定: このオプションを選択する場合、このフィールドを空白のままにして、データベース・リクエストの作成時にSIDを指定できます。

- ドメイン名: これは、オプション・フィールドです。作成する新しいデータベースに使用するドメイン名を入力します。ドメイン名の先頭には「.」(ドット)が付いていないことを確認してください。

10. 「プールとゾーン」リージョンで、「追加」をクリックして、データベース・インスタンスをプロビジョニングするPaaSインフラストラクチャ・ゾーンを選択します。「プールの割当て」をクリックします。リストからプールを選択し、このプールをPaaSインフラストラクチャ・ゾーンに割り当てます。データベースはこのプール内にプロビジョニングされます。

11. ゾーンおよびプールを選択したら、ホスト・ターゲットが「参照ホスト」フィールドに設定されます。

12. 「参照ホスト」リージョンに、データベース・クラウド・セルフ・サービス・ポータルの設定: 一般ページで選択したPaaSインフラストラクチャ・ゾーンの名前、データベース・プールおよび参照ホストが表示されます。

13. 「場所」フィールドに、データベース・ファイルの場所を指定します。これは、NFSの場所である必要があります。

14. バックアップおよびリカバリ・ファイルの管理を簡略化するには、オプションでデータベースの高速リカバリ領域を作成します。「高速リカバリ領域の有効化」チェック・ボックスを選択して、リカバリに関連するファイルの格納先となる場所を指定します。高速リカバリ領域には、バックアップおよびリカバリ・ファイル用の集中化されたディスクの場所を提供するファイル・システムを指定できます。高速リカバリ領域の場所および高速リカバリ・サイズを指定します。高速リカバリ領域に割り当てるディスク領域の量は、データベースのサイズおよびアクティビティ・レベルによって異なります。
「アーカイブ有効化」チェック・ボックスが選択されている場合、リフレッシュ中にデータベースは停止しません。これにより、セルフ・サービス・ユーザーは、データベースを停止せずにバックアップおよびリストア操作をスケジュールできます。

15. CloneDBデータベースを作成する場合、オプションで、ユーザーによるデータベースのバックアップ・コピーの取得を許可できます。「ユーザーに新規データベースのバックアップの作成を許可します」チェック・ボックスを選択します。許可するバックアップの最大数とバックアップの場所を指定します。

16. 「リスナー・ポート」フィールドで、新しいデータベースに関連付けるリスナー・ポート番号を指定します。11.2以上のRACデータベースを選択した場合、スキャン・ポート番号を指定する必要があります。

17. 「管理者資格証明」を指定します。新しいデータベースのシステム・スキーマのパスワードを指定します。これらのスキーマは、EM_SSA_USERSに対して使用できません。すべてのスキーマに同じパスワードを使用するか、各スキーマに異なるパスワードを使用できます。これらの値が指定されていない場合は、デフォルト値が使用され、EM_ADMINISTRATORがそれらを変更できます。

18. システム・スキーマとは別に、他のスキーマへのアクセスを制限する場合、「非管理者資格証明」リージョンで選択して、パスワードを指定できます。これらのスキーマはロックされ、EM_SSA_USERSはアクセスできません。次をクリックします。

19. 次をクリックします。サービス・テンプレートの作成: 初期化パラメータページが表示されます。このページで、データベース・インスタンスの操作に影響する様々な初期化パラメータの値を構成できます。パラメータを選択して、「セット」アイコンをクリックして、パラメータの値を変更します。

20. 次をクリックします。サービス・テンプレートの作成: カスタマイズ・ページが表示されます。データベースを作成する前後に実行する必要があるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。

21. 「ターゲット・プロパティ」リージョンで、「場所」、「部門」、「ライン・オブ・ビジネス」などのグローバル・ターゲット・プロパティを指定できます。次の作業が実行できます。

- 「必須」チェック・ボックスを選択して、プロパティを必須としてマークします。プロパティが必須としてマークされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を指定する必要があります。

- プロパティをロックします。プロパティがロックされている場合、セルフ・サービス・ユーザーは、データベースのリクエスト時にこのプロパティの値を変更できません。

22. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

23. サービス・テンプレートの作成: 確認ページが表示されます。「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。

21 プラガブル・データベースのスナップ・クローンの作成

この章では、テスト・マスター・プラガブル・データベースとプラガブル・データベースのスナップショット・クローンを作成する、次の様々なソリューションについて説明します。内容は次のとおりです。

- テスト・マスター・プラガブル・データベースの作成

- テスト・マスター・プラガブル・データベースのスナップショット・クローンの作成

- テスト・マスター・プラガブル・データベースの有効化

- テスト・マスター・プラガブル・データベースの無効化

21.1 テスト・マスター・プラガブル・データベースの作成

この項では、プラガブル・データベース・クローニング・ウィザードを使用してテスト・マスター・プラガブル・データベースを作成する様々なソリューションについて説明します。次のサブセクションが含まれます:

- テスト・マスター・プラガブル・データベースの作成

- Exadataテスト・マスター・プラガブル・データベースの作成

- ACFSテスト・マスター・プラガブル・データベースの作成

注意:
EM CLIを使用してテスト・マスター・プラガブル・データベースを作成するには、第47.15項「テスト・マスター・プラガブル・データベースの作成」を参照してください。

21.1.1 テスト・マスター・プラガブル・データベースの作成

Enterprise Manager for Oracle Database 12.1.0.8プラグインがシステムにデプロイされている場合は、新しいPDBのクローニング・ウィザードを使用して、ソースPDBからテスト・マスターPDBを作成できます。

ソースPDBからテスト・マスターPDBを作成するには、次の手順を実行します。

1. 「ターゲット」メニューから「データベース」を選択します。

2. 「表示」で、「検索リスト」を選択します。「表示」メニューから、「すべてを開く」を選択します。

3. リストでソースCDB (ソースPDBが含まれるCDB)を見つけ、テスト・マスターPDBの作成元にするPDBの名前をクリックします。

4. 「Oracleデータベース」メニューから、「クローニング」→「テスト・マスターの作成」を選択します。
別の方法として、手順3で、テスト・マスターPDBの作成元にするPDBの名前を右クリックし、「Oracleデータベース」→「クローニング」→「テスト・マスターの作成」を選択できます。

5. 「テスト・マスター・プラガブル・データベースの作成: ソースと宛先」ページで、次の操作を実行します。

- ソースCDBのSYSDBA資格証明を指定します。優先資格証明を使用するか、名前付き資格証明の保存済セットを使用するか、資格証明の新規セットを指定するかを選択できます。

- 「プラガブル・データベース定義」セクションで、テスト・マスターPDBの名前と表示名を指定します。Enterprise Managerでは、テスト・マスターPDBターゲットの識別に表示名を使用します。

- 「PDB管理者資格証明」セクションで、テスト・マスターPDBの管理に使用する管理者ユーザー・アカウントの資格証明を指定します。

- 「コンテナ・データベース」セクションで、宛先CDB (テスト・マスターPDBを含む必要のあるCDB)を指定します。

- 「資格証明」セクションで、宛先CDBのSYSDBA資格証明と、宛先CDBのホスト資格証明を指定します。また、宛先CDBで自動ストレージ管理(ASM)を使用してディスク・ストレージを管理している場合、ASM資格証明を指定する必要があります。
「次」をクリックします。

6. 「テスト・マスター・プラガブル・データベースの作成: 構成」ページで、次の操作を実行します。
「データベース・ファイルの場所」セクションで、テスト・マスターPDBのデータファイルを格納する記憶域の場所を指定します。宛先CDBでASMを使用してディスク・ストレージを管理している場合、テスト・マスターPDBのデータファイルを格納するディスク・グループを指定します。

ソースPDBのデータ・モデル定義のみをクローニングし、ソースPDBデータはクローニングしない場合、「ユーザー・データの除外」を選択します。

「PDB管理者資格証明」セクションで、テスト・マスターPDBの管理に使用する管理者ユーザー・アカウントの資格証明を指定します。

「拡張構成」セクションで、テスト・マスターPDBの最大サイズの記憶域制限と、テスト・マスターPDB内の共有表領域の最大サイズを指定します。デフォルトでは、これらの属性の値に制限はありません。「その他」セクションで、テスト・マスターPDB内に作成される表領域に対して使用するロギング・オプションを選択します。

宛先CDBがExadataマシンの一部である場合、「拡張構成」セクションのかわりに「アクセス制御および権限」セクションが表示されることに注意してください。この場合、データファイルに対する読取り専用権限を付与する必要がある所有者およびグループを指定する必要があります。

「次」をクリックします。

7. 「テスト・マスター・プラガブル・データベースの作成: 後処理」ページの「データ・マスキング」セクションで、テスト・マスターPDBの作成後に適用するデータ・マスキング定義を指定します。データ・マスキングによって、データベース内の機密データがマスクされます。
データ・マスキング定義の作成方法の詳細は、『Oracle Data Masking and Subsettingガイド』を参照してください。データ・マスキング定義は、Subset-Maskingライセンス・パックを所有している場合にのみ適用できることに注意してください。

「カスタム・スクリプト」セクションの「前スクリプト」および「後スクリプト」で、テスト・マスターPDBの作成の前後に実行するスクリプトを含むOracleソフトウェア・ライブラリ・コンポーネントを指定します。また、「SQLスクリプト」で、テスト・マスターPDBの作成後に実行するSQLスクリプトを指定します。「実行ユーザー」で、SQLスクリプトの実行に使用するユーザー・アカウントを選択します。

「次へ」をクリックします。

8. デプロイメント・プロシージャのインスタンス名を指定します。また、デプロイメント・プロシージャを開始する時点を指定します。
「通知」セクションで、電子メール通知を受信するデプロイメント・プロシージャの状態を選択します。たとえば、「通知のステータス」で「スケジュール済」および「成功」を選択すると、デプロイメント・プロシージャがスケジュールされたときと、それが成功したときに電子メール通知を受信できます。

「次」をクリックします。

9. 指定したすべての詳細を確認します。特定の詳細を編集する場合、「戻る」をクリックして必要なページに移動します。
「クローン」をクリックして、ソースPDBからテスト・マスターPDBを作成するデプロイメント・プロシージャを発行します。

21.1.2 Exadataテスト・マスター・プラガブル・データベースの作成

Enterprise Manager for Oracle Database 12.1.0.8プラグインがシステムにデプロイされている場合は、新しいPDBのクローニング・ウィザードを使用して、ソースPDBからテスト・マスターPDBを作成できます。

ソースPDBからテスト・マスターPDBを作成するには、次の手順を実行します。

1. 「ターゲット」メニューから「データベース」を選択します。

2. 「表示」で、「検索リスト」を選択します。「表示」メニューから、「すべてを開く」を選択します。

3. リストでソースCDB (ソースPDBが含まれるCDB)を見つけ、テスト・マスターPDBの作成元にするPDBの名前をクリックします。

4. 「Oracleデータベース」メニューから、「クローニング」→「テスト・マスターの作成」を選択します。
別の方法として、手順3で、テスト・マスターPDBの作成元にするPDBの名前を右クリックし、「Oracleデータベース」→「クローニング」→「テスト・マスターの作成」を選択できます。

5. 「テスト・マスター・プラガブル・データベースの作成: ソースと宛先」ページで、次の操作を実行します。

- ソースCDBのSYSDBA資格証明を指定します。優先資格証明を使用するか、名前付き資格証明の保存済セットを使用するか、資格証明の新規セットを指定するかを選択できます。

- 「プラガブル・データベース定義」セクションで、テスト・マスターPDBの名前と表示名を指定します。Enterprise Managerでは、テスト・マスターPDBターゲットの識別に表示名を使用します。

- 「PDB管理者資格証明」セクションで、テスト・マスターPDBの管理に使用する管理者ユーザー・アカウントの資格証明を指定します。

- 「コンテナ・データベース」セクションで、宛先CDB (テスト・マスターPDBを含む必要のあるCDB)を指定します。

- 「資格証明」セクションで、宛先CDBのSYSDBA資格証明と、宛先CDBのホスト資格証明を指定します。また、宛先CDBで自動ストレージ管理(ASM)を使用してディスク・ストレージを管理している場合、ASM資格証明を指定する必要があります。
「次」をクリックします。

6. 「テスト・マスター・プラガブル・データベースの作成: 構成」ページで、次の操作を実行します。
「データベース・ファイルの場所」セクションで、テスト・マスターPDBのデータファイルが作成されるディスク・グループを指定します。

ソースPDBのデータ・モデル定義のみをクローニングし、ソースPDBデータはクローニングしない場合、「ユーザー・データの除外」を選択します。

「アクセス制御および権限」セクションで、データファイルに対する読取り専用権限を付与する必要がある所有者およびグループを指定します。

「次」をクリックします。

7. 「テスト・マスター・プラガブル・データベースの作成: 後処理」ページの「データ・マスキング」セクションで、テスト・マスターPDBの作成後に適用するデータ・マスキング定義を指定します。データ・マスキングによって、データベース内の機密データがマスクされます。
データ・マスキング定義の作成方法の詳細は、『Oracle Data Masking and Subsettingガイド』を参照してください。データ・マスキング定義は、Subset-Maskingライセンス・パックを所有している場合にのみ適用できることに注意してください。

「カスタム・スクリプト」セクションの「前スクリプト」および「後スクリプト」で、テスト・マスターPDBの作成の前後に実行するスクリプトを含むOracleソフトウェア・ライブラリ・コンポーネントを指定します。また、「SQLスクリプト」で、テスト・マスターPDBの作成後に実行するSQLスクリプトを指定します。「実行ユーザー」で、SQLスクリプトの実行に使用するユーザー・アカウントを選択します。

「次へ」をクリックします。

8. デプロイメント・プロシージャのインスタンス名を指定します。また、デプロイメント・プロシージャを開始する時点を指定します。
「通知」セクションで、電子メール通知を受信するデプロイメント・プロシージャの状態を選択します。たとえば、「通知のステータス」で「スケジュール済」および「成功」を選択すると、デプロイメント・プロシージャがスケジュールされたときと、それが成功したときに電子メール通知を受信できます。

「次」をクリックします。

9. 指定したすべての詳細を確認します。特定の詳細を編集する場合、「戻る」をクリックして必要なページに移動します。
「クローン」をクリックして、ソースPDBからテスト・マスターPDBを作成するデプロイメント・プロシージャを発行します。

21.1.3 ACFSテスト・マスター・プラガブル・データベースの作成

Enterprise Manager for Oracle Database 12.1.0.8プラグインがシステムにデプロイされている場合は、新しいPDBのクローニング・ウィザードを使用して、ソースPDBからテスト・マスターPDBを作成できます。

ソースPDBからテスト・マスターPDBを作成するには、次の手順を実行します。

1. 「ターゲット」メニューから「データベース」を選択します。

2. 「表示」で、「検索リスト」を選択します。「表示」メニューから、「すべてを開く」を選択します。

3. リストでソースCDB (ソースPDBが含まれるCDB)を見つけ、テスト・マスターPDBの作成元にするPDBの名前をクリックします。

4. 「Oracleデータベース」メニューから、「クローニング」→「テスト・マスターの作成」を選択します。
別の方法として、手順3で、テスト・マスターPDBの作成元にするPDBの名前を右クリックし、「Oracleデータベース」→「クローニング」→「テスト・マスターの作成」を選択できます。

5. 「テスト・マスター・プラガブル・データベースの作成: ソースと宛先」ページで、次の操作を実行します。

- ソースCDBのSYSDBA資格証明を指定します。優先資格証明を使用するか、名前付き資格証明の保存済セットを使用するか、資格証明の新規セットを指定するかを選択できます。

- 「プラガブル・データベース定義」セクションで、テスト・マスターPDBの名前と表示名を指定します。Enterprise Managerでは、テスト・マスターPDBターゲットの識別に表示名を使用します。

- 「PDB管理者資格証明」セクションで、テスト・マスターPDBの管理に使用する管理者ユーザー・アカウントの資格証明を指定します。

- 「コンテナ・データベース」セクションで、宛先CDB (テスト・マスターPDBを含む必要のあるCDB)を指定します。

- 「資格証明」セクションで、宛先CDBのSYSDBA資格証明と、宛先CDBのホスト資格証明を指定します。また、宛先CDBで自動ストレージ管理(ASM)を使用してディスク・ストレージを管理している場合、ASM資格証明を指定する必要があります。
「次」をクリックします。

6. テスト・マスター・プラガブル・データベースの作成: 構成ページの「データベース・ファイルの場所」セクションで、テスト・マスターPDBのデータ・ファイルが作成されるACFSマウント・ポイント記憶域の場所を指定します。
ソースPDBのデータ・モデル定義のみをクローニングし、ソースPDBデータはクローニングしない場合、「ユーザー・データの除外」を選択します。

「次」をクリックします。

7. 「テスト・マスター・プラガブル・データベースの作成: 後処理」ページの「データ・マスキング」セクションで、テスト・マスターPDBの作成後に適用するデータ・マスキング定義を指定します。データ・マスキングによって、データベース内の機密データがマスクされます。
データ・マスキング定義の作成方法の詳細は、『Oracle Data Masking and Subsettingガイド』を参照してください。データ・マスキング定義は、Subset-Maskingライセンス・パックを所有している場合にのみ適用できることに注意してください。

「カスタム・スクリプト」セクションの「前スクリプト」および「後スクリプト」で、テスト・マスターPDBの作成の前後に実行するスクリプトを含むOracleソフトウェア・ライブラリ・コンポーネントを指定します。また、「SQLスクリプト」で、テスト・マスターPDBの作成後に実行するSQLスクリプトを指定します。「実行ユーザー」で、SQLスクリプトの実行に使用するユーザー・アカウントを選択します。

「次へ」をクリックします。

8. デプロイメント・プロシージャのインスタンス名を指定します。また、デプロイメント・プロシージャを開始する時点を指定します。
「通知」セクションで、電子メール通知を受信するデプロイメント・プロシージャの状態を選択します。たとえば、「通知のステータス」で「スケジュール済」および「成功」を選択すると、デプロイメント・プロシージャがスケジュールされたときと、それが成功したときに電子メール通知を受信できます。

「次」をクリックします。

9. 指定したすべての詳細を確認します。特定の詳細を編集する場合、「戻る」をクリックして必要なページに移動します。
「クローン」をクリックして、ソースPDBからテスト・マスターPDBを作成するデプロイメント・プロシージャを発行します。

21.2 テスト・マスター・プラガブル・データベースのスナップショット・クローンの作成

この項では、プラガブル・データベース・クローニング・ウィザードを使用してテスト・マスター・プラガブル・データベースのスナップショット・クローンを作成する様々なソリューションについて説明します。次のサブセクションが含まれます:

- Exadataテスト・マスターPDBのスナップショット・クローンの作成

- ACFSテスト・マスターPDBのスナップショット・クローンの作成

注意:
EM CLIを使用してプラガブル・データベースのスナップショット・クローンを作成するには、第47.14.2項「プラガブル・データベースのスナップショット・クローンのタイプ」を参照してください。

21.2.1 Exadataテスト・マスターPDBのスナップショット・クローンの作成

重要:
スナップショット・クローンを作成できるのは、バージョン12.1.0.2.0以上のテスト・マスターPDBのみです。

システムに12.1.0.8のEnterprise Manager for Oracle Databaseプラグインをデプロイしている場合、新しいPDBのクローニング・ウィザードを使用してテスト・マスターPDBのスナップショット・クローンを作成できます。

Exadataテスト・マスターPDBのスナップショット・クローンを作成するには、次の手順を実行します。

1. 「ターゲット」メニューから「データベース」を選択します。

2. 「表示」で、「検索リスト」を選択します。「表示」メニューから、「すべてを開く」を選択します。

3. リストでソースCDB (ソース・テスト・マスターPDBが含まれるCDB)を見つけ、クローニングするテスト・マスターPDBの名前をクリックします。

4. 「Oracleデータベース」メニューから、「クローニング」→「スナップショット・クローンの作成」を選択します。
別の方法として、手順3で、クローニングするテスト・マスターPDBの名前を右クリックし、「Oracleデータベース」→「クローニング」→「スナップショット・クローンの作成」を選択できます。

5. 「スナップショット・クローン・プラガブル・データベースの作成」で、次の手順を実行します。

- ソースCDBのSYSDBA資格証明を指定します。優先資格証明を使用するか、名前付き資格証明の保存済セットを使用するか、資格証明の新規セットを指定するかを選択できます。

- 「資格証明」セクションで、CDBのSYSDBA資格証明を指定します。

- 「プラガブル・データベース定義」セクションで、PDBの名前と、PDBスナップショット・クローンの表示名を指定します。Enterprise Managerでは、PDBスナップショット・クローン・ターゲットの識別に表示名を使用します。

- 「PDB管理者資格証明」セクションで、PDBスナップショット・クローンの管理に使用する管理者ユーザー・アカウントの資格証明を指定します。
ソースCDBとは異なるCDBにテスト・マスターPDBをクローニングする場合、「プラガブル・データベースの異なるコンテナ・データベースへのクローニング」を選択し、宛先CDBを指定します。

- 「資格証明」セクションで、CDBのホスト資格証明を指定します。また、ディスク・ストレージを管理するために使用されるASMのASM資格証明を指定します。

6. これ以上詳細を指定する必要がなければ、「クローン」をクリックします。これにより、パブリック・クラウド設定にデプロイされたCDBにPDBをクローニングするためのデプロイメント・プロシージャが発行されます。
他の構成詳細の指定やデータのマスキング、クローニング・プロセスのスケジュールを行う場合は、「拡張」をクリックします。

「拡張」オプションを選択した場合は、それ以降の手順に従います。各ページにクローニングのためのオプションがあります。

7. 「スナップショット・クローン・プラガブル・データベースの作成: ソースと宛先」ページで、詳細を確認して「次へ」をクリックします。

8. 「スナップショット・クローン・プラガブル・データベースの作成: 構成」ページで、次の操作を実行します。

- 「データベース・ファイルの場所」セクションで、PDBスナップショット・クローンのデータファイルが作成されるスパース・ディスク・グループの名前を指定します。

- 「拡張構成」セクションで、PDBスナップショット・クローンの最大サイズの記憶域制限と、PDBスナップショット・クローン内の共有表領域の最大サイズを指定します。デフォルトでは、これらの属性の値に制限はありません。

- 「その他」セクションで、PDBスナップショット・クローン内に作成される表領域に対するデフォルトのロギング・オプションを選択します。

- 「次」をクリックします。

9. 「スナップショット・クローン・プラガブル・データベースの作成: 後処理」セクションの「データ・マスキング」セクションで、PDBのクローニング後に適用するデータ・マスキング定義を指定します。データ・マスキングによって、データベース内の機密データがマスクされます。
データ・マスキング定義の作成方法の詳細は、『Oracle Data Masking and Subsettingガイド』を参照してください。データ・マスキング定義は、Subset-Maskingライセンス・パックを所有している場合にのみ適用できることに注意してください。

「カスタム・スクリプト」セクションの「前スクリプト」および「後スクリプト」で、PDBのクローニングの前後に実行するスクリプトを含むOracleソフトウェア・ライブラリ・コンポーネントを指定します。また、「SQLスクリプト」で、PDBのクローニング後に実行するSQLスクリプトを指定します。「実行ユーザー」で、SQLスクリプトの実行に使用するユーザー・アカウントを選択します。

「次」をクリックします。

10. 「スナップショット・クローン・プラガブル・データベースの作成: スケジュール」ページで、クローニングのデプロイメント・プロシージャのインスタンス名を指定します。また、クローニング・プロシージャを開始する時点を指定します。
「通知」セクションで、電子メール通知を受信するデプロイメント・プロシージャの状態を選択します。たとえば、「通知のステータス」で「スケジュール済」および「成功」を選択すると、クローニング・デプロイメント・プロシージャがスケジュールされたときと、それが成功したときに電子メール通知を受信できます。

「次」をクリックします。

11. 「スナップショット・クローン・プラガブル・データベースの作成: 確認」ページで、入力したすべての詳細を確認します。特定の詳細を編集する場合、「戻る」をクリックして必要なページに移動します。
「クローン」をクリックしてデプロイメント・プロシージャを発行し、Exadataテスト・マスターPDBのスナップショット・クローンを作成します。

21.2.2 ACFSテスト・マスターPDBのスナップショット・クローンの作成

重要:
スナップショット・クローンを作成できるのは、バージョン12.1.0.2.0以上のテスト・マスターPDBのみです。

システムに12.1.0.8のEnterprise Manager for Oracle Databaseプラグインをデプロイしている場合、新しいPDBのクローニング・ウィザードを使用してテスト・マスターPDBのスナップショット・クローンを作成できます。

Exadataテスト・マスターPDBのスナップショット・クローンを作成するには、次の手順を実行します。

1. 「ターゲット」メニューから「データベース」を選択します。

2. 「表示」で、「検索リスト」を選択します。「表示」メニューから、「すべてを開く」を選択します。

3. リストでソースCDB (ソース・テスト・マスターPDBが含まれるCDB)を見つけ、クローニングするテスト・マスターPDBの名前をクリックします。

4. 「Oracleデータベース」メニューから、「クローニング」→「スナップショット・クローンの作成」を選択します。
別の方法として、手順3で、クローニングするテスト・マスターPDBの名前を右クリックし、「Oracleデータベース」→「クローニング」→「スナップショット・クローンの作成」を選択できます。

5. 「スナップショット・クローン・プラガブル・データベースの作成」で、次の手順を実行します。

- ソースCDBのSYSDBA資格証明を指定します。優先資格証明を使用するか、名前付き資格証明の保存済セットを使用するか、資格証明の新規セットを指定するかを選択できます。

- 「資格証明」セクションで、CDBのSYSDBA資格証明を指定します。

- 「プラガブル・データベース定義」セクションで、PDBの名前と、PDBスナップショット・クローンの表示名を指定します。Enterprise Managerでは、PDBスナップショット・クローン・ターゲットの識別に表示名を使用します。

- 「PDB管理者資格証明」セクションで、PDBスナップショット・クローンの管理に使用する管理者ユーザー・アカウントの資格証明を指定します。
ソースCDBとは異なるCDBにテスト・マスターPDBをクローニングする場合、「プラガブル・データベースの異なるコンテナ・データベースへのクローニング」を選択し、宛先CDBを指定します。

- 「資格証明」セクションで、CDBのホスト資格証明を指定します。また、ディスク・ストレージを管理するために使用されるASMのASM資格証明を指定します。

6. これ以上詳細を指定する必要がなければ、「クローン」をクリックします。これにより、パブリック・クラウド設定にデプロイされたCDBにPDBをクローニングするためのデプロイメント・プロシージャが発行されます。
他の構成詳細の指定やデータのマスキング、クローニング・プロセスのスケジュールを行う場合は、「拡張」をクリックします。

「拡張」オプションを選択した場合は、それ以降の手順に従います。各ページにクローニングのためのオプションがあります。

7. 「スナップショット・クローン・プラガブル・データベースの作成: ソースと宛先」ページで、詳細を確認して「次へ」をクリックします。

8. 「スナップショット・クローン・プラガブル・データベースの作成: 構成」ページで、次の操作を実行します。

- 「データベース・ファイルの場所」セクションで、PDBスナップショット・クローンのデータファイルが作成されるスパース・ディスク・グループの名前を指定します。

- 「拡張構成」セクションで、PDBスナップショット・クローンの最大サイズの記憶域制限と、PDBスナップショット・クローン内の共有表領域の最大サイズを指定します。デフォルトでは、これらの属性の値に制限はありません。

- 「その他」セクションで、PDBスナップショット・クローン内に作成される表領域に対するデフォルトのロギング・オプションを選択します。

- 「次」をクリックします。

9. 「スナップショット・クローン・プラガブル・データベースの作成: 後処理」セクションの「データ・マスキング」セクションで、PDBのクローニング後に適用するデータ・マスキング定義を指定します。データ・マスキングによって、データベース内の機密データがマスクされます。
データ・マスキング定義の作成方法の詳細は、『Oracle Data Masking and Subsettingガイド』を参照してください。データ・マスキング定義は、Subset-Maskingライセンス・パックを所有している場合にのみ適用できることに注意してください。

「カスタム・スクリプト」セクションの「前スクリプト」および「後スクリプト」で、PDBのクローニングの前後に実行するスクリプトを含むOracleソフトウェア・ライブラリ・コンポーネントを指定します。また、「SQLスクリプト」で、PDBのクローニング後に実行するSQLスクリプトを指定します。「実行ユーザー」で、SQLスクリプトの実行に使用するユーザー・アカウントを選択します。

「次」をクリックします。

10. 「スナップショット・クローン・プラガブル・データベースの作成: スケジュール」ページで、クローニングのデプロイメント・プロシージャのインスタンス名を指定します。また、クローニング・プロシージャを開始する時点を指定します。
「通知」セクションで、電子メール通知を受信するデプロイメント・プロシージャの状態を選択します。たとえば、「通知のステータス」で「スケジュール済」および「成功」を選択すると、クローニング・デプロイメント・プロシージャがスケジュールされたときと、それが成功したときに電子メール通知を受信できます。

「次」をクリックします。

11. 「スナップショット・クローン・プラガブル・データベースの作成: 確認」ページで、入力したすべての詳細を確認します。特定の詳細を編集する場合、「戻る」をクリックして必要なページに移動します。
「クローン」をクリックしてデプロイメント・プロシージャを発行し、Exadataテスト・マスターPDBのスナップショット・クローンを作成します。

21.3 テスト・マスター・プラガブル・データベースの有効化

プラガブル・データベースをテスト・マスターに変換するには、次の手順を実行します。

1. テスト・マスターとして有効化するプラガブル・データベース・ターゲット名を右クリックし、「Oracle Database」を選択し、「クローニング」を選択し、「テスト・マスターとして有効化」を選択します。

2. 「テスト・マスターとして有効化」ページの「資格証明」セクションで、プラガブル・データベースのコンテナ・データベースの資格証明とOracleホームの資格証明を指定します。

3. 「ソース」セクションで、データベース作成元の親データベースを指定または検索します。これによって、系統追跡が容易になります。

4. 「データ・マスキング」セクションで、マスキング・テンプレートの適用、または選択した追加スクリプトの実行によって、データの機密性を隠蔽することができます。

5. 「カスタム・スクリプト」セクションで、クローニング後スクリプトを含むソフトウェア・ライブラリ・コンポーネントを選択できます。クローン・データベースは、クローニング後SQLスクリプトを実行してカスタマイズすることもできます。

6. 「発行」をクリックします。

21.4 テスト・マスター・プラガブル・データベースの無効化

テスト・マスター・プラガブル・データベースを無効にすると、データ・ファイルは読み書きモードに再設定され、プラガブル・データベースはオープン・モードで再起動されます。データベースをさらに変更してから、再度テスト・マスターとして有効化できます。

テスト・マスター・プラガブル・データベースを無効化するには、次の手順を実行します。

1. テスト・マスター・プラガブル・データベースを右クリックし、「Oracle Database」を選択し、「クローニング」を選択し、「テスト・マスターとして無効化」を選択します。

2. 「テスト・マスターの無効化」ページで、テスト・マスター・プラガブル・データベースのコンテナ・データベースの資格証明を指定します。また、Oracleホームの資格証明を指定します。

3. 「発行」をクリックします。

22 DBaaSセルフ・サービス・ポータルの使用

この章では、セルフ・サービスのユーザーがデータベース・クラウド・セルフ・サービス・ポータルを使用してデータベース・サービスをリクエスト、監視および管理する手順について説明します。内容は次のとおりです。

- データベース・クラウド・セルフ・サービス・ポータルの使用

- データベースのリクエスト

- データベース・サービス・ホーム・ページの表示

- データベース・インスタンス・ホーム・ページの表示

- クラスタ・データベース・ホーム・ページの表示

- プラガブル・データベース・ホームページの表示

22.1 データベース・クラウド・セルフ・サービス・ポータルの使用

データベース・セルフ・サービス・ポータルを使用すると、セルフ・サービスのユーザーは、選択したゾーンのデータベースを表示、監視およびデプロイし、実行中のデータベースにスキーマを作成できます。「データベース・クラウド・セルフ・サービス・ポータル」を表示するには、EM_SSA_USERロールを持つユーザーまたはEM_SSA_USER_BASEロールを持つユーザーとしてEnterprise Managerにログインします。これらのロールを持つユーザーは、DBAASクラウド・サービス・ファミリの一部である必要があり、「DB」、「スキーマ」または「PDB」サービス・タイプに対する権限を持っている必要があります。「セルフ・サービス・ポータル」が表示されます。「管理」ドロップ・ダウン・リストから、「データベース」を選択します。

図22-1 データベース・クラウド・セルフ・サービス・ポータル

データベース・セルフ・サービス・ポータルによって、SSAユーザーは、選択したゾーンにデータベースを表示、監視およびデプロイし、実行中のデータベースにスキーマを作成できます。

次の詳細が表示されます。

- ホーム: データベース・セルフ・サービス・ポータルのホームページです。内容は次のとおりです。

- 通知: このセクションには、7日以内に期限切れとなるデータベースの数が表示されます。

- 使用状況: このリージョンには、次のものの現在の割当て制限と使用量が表示されます。

- データベース: これまでにリクエストしたデータベースの数およびリクエストできるデータベースの最大数。

- スキーマ・サービス: これまでにリクエストしたスキーマの数およびリクエストできるスキーマの最大数。

- プラガブル・データベース: これまでにリクエストしたPDBの数およびリクエストできるPDBの最大数。

- メモリー: ユーザーに割り当てられるメモリーの合計量およびこれまでにリクエストしたすべてのデータベースおよびスキーマで使用されるメモリー。

- 記憶域: ユーザーに割り当てられる合計記憶域ボリュームおよびこれまでにリクエストしたすべてのデータベースで使用される記憶域。

- サービス: この表には、現在所有しているサービスの一覧が表示されます。「新規サービスのリクエスト」メニューから適切なオプションを選択して、追加のデータベース、スキーマまたはPDBをリクエストできます。所有する任意のデータベースを削除し、期限が切れる前に解放することもできます。サービス・インスタンス名をクリックすると、データベース詳細ページにドリルダウンできます。このページには基本的な監視機能が用意されており、サービスのライフサイクル操作を実行できます。
「アクション」メニューから、次の操作を実行できます。

- サービス・インスタンスの起動/サービス・インスタンスの停止: 停止されているサービス・インスタンスを起動または実行されているサービス・インスタンスを停止できます。

- 履歴の表示: サービス・インスタンスを選択し、「履歴の表示」をクリックしてサービス・インスタンスに対して実行した操作の履歴を表示します。

- 権限: サービス・インスタンスに対する表示または完全な権限を他のユーザーまたはロールに付与できます。第29.4.1項「サービス・インスタンスに対する権限の付与、取消しおよび再割当て」を参照してください。

- 取消: 他のユーザーまたはロールに付与した権限を取り消すことができます。第29.4.1項「サービス・インスタンスに対する権限の付与、取消しおよび再割当て」を参照してください。

- リクエスト: この表では、作成、削除またはリフレッシュしたリクエストを追跡します。各リクエストに対して、そのリクエストのステータス、リクエスト・タイプ、サービス・タイプおよび発行日が表示されます。「作成」や「削除」などのスケジュール済のリクエストを選択して、「再スケジュール」をクリックすると、リクエストを再スケジュールできます。スケジュール済のリクエストを削除するには、リクエストを選択してから「取消」をクリックします。作成などのスケジュールされたリクエストが取り消された場合、他のすべての関連リクエストも取り消されます。

- チャージバック: このページは、データベースのチャージバックの分類データ、およびそれぞれのゾーンの価格を表示します。発生したチャージは、データベースのリクエスト日付から現在の日付まで計算されます。このページには、次のセクションが含まれています。

- チャージ傾向: このグラフは、時間の推移に伴う使用状況とチャージの傾向を表示します。

- 集計方法: リソースまたはメトリックごとにデータベースのチャージバック・データを集計できます。このデータは、スプレッドシートなどの外部アプリケーションにエクスポートできます。

- チャージ・プラン: 個別に割り当てられているチャージ・プランが表示されます。ゾーンを選択して価格を表示します。特定の期間のデータベース・ゾーンのそれぞれのメトリックのレートが表示されます。

- プリファレンス: このリンクをクリックして、デフォルトのサービス・ポータル、デフォルトのPaaSインフラストラクチャ・ゾーン、通知用のデフォルト電子メール・アドレスなどのプリファレンスを設定します。

22.2 データベースのリクエスト

新規データベースをリクエストするには、次の手順に従います。

1. 「データベース・クラウド・セルフ・サービス・ポータル」で、「新規サービスのリクエスト」リンクをクリックします。サービス提供ウィンドウが表示されます。

2. 「サービス・タイプ」ドロップ・ダウンで、「すべて」を選択して、データベース・サービス・ファミリに使用可能なすべてのサービス提供を表示します。「データベース」、「プラガブル・データベース」または「スキーマ」を選択して、選択したサービス・タイプのサービス提供のみ表示できます。

図22-2 新規サービスのリクエスト

3. 一覧からサービス・テンプレートを選択して「選択」をクリックします。選択するサービス・テンプレートは、RMANバックアップ・プロファイル、フィジカル・スタンバイ・データベース、スナップショット・ベースのプロファイルのいずれに基づくものでもかまいません。要件に応じて適切なテンプレートを選択してください。

4. 新しいデータベース・サービス・リクエスト・ページが表示されます。

図22-3 データベースの作成

次の詳細を入力します。

- リクエスト名: リクエストの名前を入力します。

- ゾーン: データベースをデプロイするPaaSゾーンを選択します。

- データベースSID: このフィールドは、選択したサービス・テンプレートによってリクエスト時にデータベースSIDを指定できる場合に表示されます。一意のデータベースSIDを入力します。

- データベース・サービス名: 一意のデータベース・サービス名を入力します。指定する名前は、すべてのデータベース、プラガブル・データベースおよびスキーマ・サービス・リクエストを通じて一意である必要があります。
将来のスケジュール・リクエストに使われているものと同じデータベース・サービス名を使用することはできません。削除操作が失敗した場合には、失敗したリクエストで指定されていた名前を使用することはできません。

注意:

- 選択するサービス・テンプレートにスタンバイ・データベースを含むデータベース・プールが含まれている場合にのみ、スタンバイ・データベースを作成できます。

- サービス・テンプレートがスタンバイ・データベースをサポートしている場合、セルフ・サービス管理者が設定したプリファレンスによっては、必要に応じてスタンバイ・データベースの作成を選択できます。1つ以上のスタンバイ(サービス・テンプレートで定義された内容のサブセット)から選択することもできます。スタンバイ・データベースを作成せず、サービス・テンプレートでサポートされているトポロジのサブセットのみを選択した場合は、後で現在のリクエストが完了した後、残りのスタンバイの1つ以上をリクエストできます。

- デプロイメント入力: データベースのユーザー名およびパスワードを指定します。RMANベースまたはスナップ・クローン・ベースのサービス・テンプレートを選択した場合、アクティブ・データ・ポイントからの選択が可能であれば、RMANバックアップまたはスナップショットをここで選択できます。

- リクエストのスケジュール: リクエストのスケジュールを指定します。

- サービス・インスタンス・プロパティ: 必須およびオプションのターゲット・プロパティがここに表示されます。プロパティが必須としてマークされている場合は、そのプロパティの値を入力する必要があります。

5. 「RMANバックアップ」、「スナップショット」または「RMANイメージ」プロファイルに基づくサービス・テンプレートを選択した場合は、「スナップショット」リージョンに、使用可能なバックアップ、スナップショットまたはイメージのリストが表示されます。これらのスナップショットは、任意の時点でのテスト・マスター・データベースの状態を反映しています。

図22-4 データベースの作成(スナップショット)

リストからスナップショットを選択し、「発行」をクリックして、選択したゾーンにデータベースをデプロイします。選択したスナップショットに基づくデータベースが新しく作成されます。

22.2.1 スキーマのリクエスト

1つ以上のスキーマのあるデータベース・サービスを作成して、スキーマに必要なデータを移入できます。

エクスポート・プロファイル・ベースのスキーマのリクエスト

スキーマ・エクスポート・プロファイルを含むサービス・テンプレートまたは空のサービス・テンプレートに基づいてスキーマを作成できます。スキーマ・エクスポート・プロファイルに基づいてスキーマを作成するには、次の手順に従います。

1. Enterprise ManagerにEM_SSA_USERロール、またはEM_SSA_USERを含むロールを持つユーザーでログインします。

2. データベース・クラウド・セルフ・サービス・ポータル・ページが表示されます。「管理」ドロップダウン・リストから「データベース」を選択し、「データベース・クラウド・セルフ・サービス・ポータル」に移動します。

3. 「サービス」リージョンで、「新規サービスのリクエスト」をクリックします。

4. リストからスキーマ・エクスポート・プロファイルを含むスキーマ・サービス・テンプレートを選択し、「選択」をクリックします。「スキーマの作成」ページが表示されます。選択したサービス・テンプレートの名前および説明が表示されます。次の詳細を入力します。

- リクエスト名: スキーマ・サービス・リクエストの名前を入力します。

- ゾーン: スキーマを作成するゾーンを選択します。

- データベース・サービス名: データベース・サービスの一意の名前を入力します。

- ワークロード・サイズ: サービス・リクエストのワークロード・サイズを指定します。

- スキーマ接頭辞: スキーマの接頭辞を入力します。クラスタ・データベースの場合は、サービスはグリッド・インフラストラクチャ資格証明を使用して登録されます。

5. 「スキーマ名の変更」をクリックして、スキーマの新しい名前を入力します。ソース・スキーマ名を保持する場合は、「スキーマ接頭辞」フィールドを空白にしてください。

6. スキーマのパスワードを指定します。すべてのスキーマに同じパスワード・チェック・ボックスを選択して、すべてのスキーマに同じパスワードを使用します。

7. スキーマのマスター・アカウントが表示されます。マスター・アカウント権限を持つスキーマは、サービス・リクエストの一部として作成された他のすべてのスキーマにアクセスできます。

8. 「表領域の詳細」リージョンに、スキーマ内のすべての表領域の名前が表示されます。表領域名を変更し、「新規表領域名」ボックスに新しい名前を指定できます。

9. リクエストのスケジュールを指定し、「発行」をクリックしてスキーマを作成します。

空のスキーマのリクエスト

空のスキーマ・テンプレートを含むスキーマを作成するには、次の手順に従います。

1. 前述の手順1から3を実行し、「サービス・テンプレートの選択」ウィンドウで、リストから空のスキーマ・テンプレートを選択します。

2. 手順4から7のリストに従ってスキーマの詳細を指定します。

3. 「表領域の詳細」リージョンで、スキーマごとに個別の表領域を指定するか、すべてのスキーマに同じ表領域を使用します。

4. スキーマ・リクエストのスケジュールを指定し、「発行」をクリックしてスキーマを作成します。

22.2.2 プラガブル・データベースのリクエスト

選択したサービス・テンプレートに基づいて、プラガブル・データベースをリクエストできます。プラガブル・データベースをリクエストするには、次の手順に従います。

1. Enterprise ManagerにEM_SSA_USERロール、またはEM_SSA_USERを含むロールを持つユーザーでログインします。

2. インフラストラクチャ・クラウド・セルフ・サービス・ポータル・ページが表示されます。「管理」ドロップ・ダウン・リストから、「データベース」を選択します。

3. 「サービス」リージョンで、「新規サービスのリクエスト」をクリックします。表示される「新規サービスのリクエスト」ウィンドウで、「サービス・タイプ」ドロップ・ダウンから「プラガブル・データベース」を選択します。

4. 一覧からサービス・テンプレートを選択して「選択」をクリックします。プラガブル・データベースの作成ページが表示されます。

図22-5 新規プラガブル・データベース・サービスのリクエスト

5. 次の詳細を指定します。

- リクエスト名: リクエストの名前を入力します。

- ゾーン: プラガブル・データベースのデプロイ先となるコンテナ・データベースを含むPaaSインフラストラクチャ・ゾーンを選択します。

- PDB名: 一意のプラガブル・データベース名を入力します。

注意:

- 指定するデータベース・サービス名は、すべてのデータベース、プラガブル・データベースおよびスキーマ・サービス・リクエストを通じて一意である必要があります。

- 将来のスケジュール・リクエストに使われているものと同じデータベース・サービス名を使用することはできません。

- 削除操作が失敗した場合には、失敗したリクエストで指定されていた名前を使用することはできません。

- データベース・サービス名: 一意のデータベース・サービス名を入力します。

- ワークロード・サイズ: ワークロードは、各サービスのCPU合計、メモリーおよび記憶域要件を表します。ドロップダウン・リストから、「ワークロード・サイズ」を選択します。

- デプロイメント入力: プラガブル・データベース管理者のユーザー名とパスワードを指定します。

- リクエストのスケジュール: リクエストのスケジュールを指定します。

- サービス・インスタンス・プロパティ: 必須およびオプションのターゲット・プロパティがここに表示されます。プロパティが必須としてマークされている場合は、そのプロパティの値を入力する必要があります。

6. 「送信」をクリックし、選択したゾーンにデータベースをデプロイします。

22.3 データベースのリフレッシュ

データベースを作成した後は、定期的にリフレッシュすることで、データを最新の状態にし、本番データベースとの一貫性を保つことができます。データベースをリフレッシュするには、次の手順に従います。

1. データベース・セルフ・サービス・ポータルのホームページで、「サービス」リージョンの「名前」リンクをクリックし、データベース・ホーム・ページにドリルダウンします。

図22-6 データベースのリフレッシュ

2. 「リフレッシュ」をクリックします。使用可能なスナップショットまたはRMANバックアップのリストが表示されます。

図22-7 スナップショット

リストからスナップショット・プロファイルを選択して、「リフレッシュ」をクリックします。データベースが選択したスナップショット・バージョンにリフレッシュされ、古いスナップショットが削除されるというメッセージが表示されます。「はい」をクリックして、データベースのリフレッシュ・リクエスト・ジョブを発行します。リクエストが正常に完了すると、データベースがリフレッシュされて、選択したスナップショット・プロファイルと一貫性のある状態になります。

22.4 リクエストの履歴の表示

データベース・インスタンスの履歴を表示するには、「サービス」列で行を選択し、「アクション」メニューから「履歴」を選択します。データベース・インスタンスに発行されたすべてのリクエストと、各リクエストのステータスが表示されます。

22.5 データベース・サービス・ホームページの表示

データベース・サービスは、Oracle Databaseでワークロードを管理するための論理的な抽象概念です。サービスにより、ワークロードは相互に切り離されたグループに分割されます。各サービスは、一般的な属性、サービス・レベルしきい値および優先度でワークロードを表します。データベース・サービス・ホーム・ページには、データベース・サービスの詳細表示が示されます。

図22-8 データベース・サービス・ホーム

次のリージョンが含まれます。

- サマリー: データベース・サービスのステータスおよびデータベース・バージョンを表示します。

- 接続の詳細: 「接続文字列」と「マスター・アカウント名」を含むデータベース接続詳細が表示されます。

- エクスポート: 次を実行できます。

- エクスポート: 「エクスポート」をクリックして、サービスの一部であるすべてのスキーマのエクスポート・ダンプを取得します。「エクスポート」ウィンドウで、名前および説明を入力し、エクスポート・ダンプのスケジュールを指定して、「スケジュール」をクリックします。

- インポート: 「リストア」をクリックして、選択したエクスポート・ダンプからスキーマをリストアします。

- 削除: エクスポート・ダンプを選択し、「削除」をクリックして、そのエクスポート・ダンプを削除します。

- リクエスト: このリージョンには、作成済のリクエストが表示されます。各リクエストに対して、リクエストのステータス、タイプ、開始日および送信日が表示されます。スケジュール済のリクエストを選択して、「再スケジュール」をクリックすると、リクエストを再スケジュールできます。スケジュール済のリクエストを削除するには、リクエストを選択してから「取消」をクリックします。

- スキーマ: データベース・サービスに関連付けられているスキーマおよび表領域の名前が表示されます。

- リソース使用率: このリージョンには、スキーマに関連付けられているワークロードが表示されます。これには、データベース・サービスに割り当てられたCPU、メモリーおよび記憶域が含まれます。

- パフォーマンス: このリージョンには、過去5分のアクティブ・セッションの平均数を示すグラフが表示されます。

22.6 データベース・インスタンス・ホームページの表示

データベース・インスタンス・ホームページには、データベース・インスタンスに関する情報が詳細に表示されます。

このページには、次のリージョンがあります。

- サマリー: データベース・インスタンス・ホームページのリージョンには、データベース・ステータスの概要とデータベースの基本情報が表示されます。これには、データベースの現在のステータスと、インスタンスの開始時間のタイム・スタンプ、データベース・バージョン、最新のバックアップの日付などの詳細が表示されます。

- 接続の詳細: 「接続文字列」およびデータベースにアクセスしているユーザーの名前を含むデータベース接続詳細が表示されます。

- バックアップとリストア: データベースに高速リカバリ領域が構成されている場合は、このデータベースの日次バックアップをスケジュールできます。「バックアップのスケジュール」をクリックし、このタスクを実行します。バックアップが使用可能になっていれば、「リストア」をクリックし、データベースを特定の時点にリストアできます。高速リカバリ領域が構成されていない場合は、データベース管理者は、高速リカバリ領域を構成するか、またはリクエストが実現した時点で高速リカバリ領域が構成されるデータベースのリクエストを可能にする新規サービス・テンプレートを公開できます。

注意:
データベース・インスタンスがスナップ・クローンに基づくプロファイルを使用して作成されている場合、「バックアップとリストア」リージョンではなく、スナップショットのリスト付きの「スナップショットとリストア」リージョンが表示されます。「リストア」をクリックすると、スナップショットからデータをリストアできます。参照

図22-9 データベース・インスタンス・ホームページ(スナップ・クローン)

- パフォーマンス: データベースのパフォーマンス監視情報が表示されます。アクティブ・クラス・タブをクリックすると、リソースの待機またはCPUの消費に費やされた時間を示す棒グラフが表示されます。

- リソース: ホストCPU、アクティブ・セッション、メモリー、データ記憶域などのリソースの使用量を示すグラフが表示されます。

- SQL監視: 追跡されたSQLの現在のレスポンスと参照収集のレスポンスを対比して示すSQLレスポンス時間チャートが表示されます。

- リクエスト: このリージョンには、作成済のリクエストが表示されます。各リクエストに対して、リクエストのステータス、タイプ、開始日および送信日が表示されます。スケジュール済のリクエストを選択して、「再スケジュール」をクリックすると、リクエストを再スケジュールできます。スケジュール済のリクエストを削除するには、リクエストを選択してから「取消」をクリックします。

データベースの起動および停止

データベースの状態に応じて、データベースが開いている場合に「停止」をクリックしてデータベースを停止すること、データベースが停止している場合に「起動」ボタンをクリックすること、またはデータベースの状態が不明か「ステータス保留」状態の場合に「停止」ボタンをクリックすることができます。

22.7 スタンバイ・データベース・ホームページの表示

スタンバイ・データベース・インスタンスのホーム・ページには、次のリージョンが含まれます。

- サマリー: このリージョンには、データベース・ステータスの概要とデータベースの基本情報が表示されます。これには、データベースの現在のステータスと、インスタンスの開始時間のタイム・スタンプ、データベース・バージョン、最新のバックアップの日付などの詳細が表示されます。

- 接続の詳細: プライマリ・データベースおよび1つ以上のスタンバイ・データベースのデータベース接続の詳細が表示されます。これには、接続文字列や、データベースにアクセスするユーザーの名前が含まれます。

- Data Guardサマリー: このリージョンには、すべてのデータベース(プライマリおよびスタンバイ)の保護モードと、各データベースの詳細(データベース・タイプ、ロール、REDOトランスポート・モードなど)が表示されます。詳細は、第15.2.2項「サービス・テンプレートの作成」を参照してください。

- パフォーマンス: データベースのパフォーマンス監視情報が表示されます。アクティブ・クラス・タブをクリックすると、リソースの待機またはCPUの消費に費やされた時間を示す棒グラフが表示されます。

- リソース: ホストCPU、アクティブ・セッション、メモリー、データ記憶域などのリソースの使用量を示すグラフが表示されます。

- SQL監視: 追跡されたSQLの現在のレスポンスと参照収集のレスポンスを対比して示すSQLレスポンス時間チャートが表示されます。

- リクエスト: このリージョンには、作成済のリクエストが表示されます。各リクエストに対して、リクエストのステータス、タイプ、開始日および送信日が表示されます。スケジュール済のリクエストを選択して、「再スケジュール」をクリックすると、リクエストを再スケジュールできます。スケジュール済のリクエストを削除するには、リクエストを選択してから「取消」をクリックします。

22.8 クラスタ・データベース・ホームページの表示

「クラスタ・データベース」 ホームページでは、次のことができます。

- 一連のメトリックを表示することによるOracle Real Application Clustersデータベースの現行のステータスの確認

- クラスタ・データベースの起動または停止

- 日次バックアップをスケジューリングし、データベースのポイント・イン・リストアを実行します。

注意:
このホームページには、クラスタ・データベースの高レベルのビューが提供されます。左余白の矢印キーをクリックすると、マスター・パネルが展開され、「ターゲット・ナビゲーション」ペインが表示されます。左パネルからデータベース・インスタンスを選択すると、そのインスタンスの詳細を表示できます。さらに、データベース・インスタンスの起動や停止などの操作を行えます。

図22-10 クラスタ・データベース・ホームページ

ホーム・ページのセクション

クラスタ・データベース: ホームページには、次のセクションの情報が表示されます。

- サマリー

- パフォーマンス

- 構成の変更

- リソース

- 実行中のジョブ

- SQLモニター

- 問題

サマリー

「サマリー」セクションには、クラスタ・データベースに関するステータスおよび診断情報が表示されます。

ステータス

このセクションには、クラスタ・データベースのステータスのクイック・ビューおよびクラスタ・データベースに関する基本情報が表示されます。ステータスは、「稼働中」、「停止中」、「ブラックアウト中」、「未監視」、「不明」のいずれかで、ステータスは左側に表示される矢印アイコンにミラー化されます。

クラスタ内のデータベース・インスタンスの数、「稼働時間」、「バージョン」、「負荷」、「合計セッション」、「使用可能な領域」および他の詳細が表示されます。このセクション表示されるフィールドは次のとおりです。

- インスタンス: 稼働中のクラスタ・データベース・インスタンスの数を表示します。

- 稼働時間: クラスタ・データベースが起動されてから経過した合計時間を表示します。

- 可用性: クラスタ・データベースが使用可能だった時間の割合を表示します。

- バージョン: このOracleデータベースのバージョンを表示します。

- ロード: このクラスタ・データベースが起動されてからの平均アクティブ・セッションの数を表示します。

- 合計: 実行中のクラスタ・データベース・セッションの合計を表示します。

- 最新のバックアップ: データベースの最後のバックアップがいつ実行されたかを表示します。

- 使用可能な領域: クラスタ・データベースの使用可能な領域を表示します。

- SGA合計: システム・グローバル領域の合計を表示します。

- 問題のサービス: 問題のあるサービスを表示します。

注意: クラスタ・データベース・ホーム・ページには、データベースでQoS管理が有効になっているかどうかが表示されます。可能な状態は次のとおりです。

- 有効: そのデータベースではQoS監視が有効になっていることを示します。

- 無効: そのデータベースではQoS監視が無効になっていることを示します。

- アクティブ: データベースはQoSによって有効化および監視されていることを示します。

クラスタ・データベース・ホームページに表示されるQoSステータスは、サービスのクオリティ・ダッシュボードに表示されるステータスとは異なります。QoSダッシュボードには、クラスタ内のQoS自体の全体的なステータスが表示されます。

実行中のジョブ

この表には、スケジュール済、実行中、一時停止、問題のある実行(停止中/失敗)などを表示する、クラスタ・データベース上のすべてのEnterprise Managerで実行中のジョブのレポートが、クラスタ・データベースまたは任意のメンバー・インスタンスへのジョブ送信日でソートされて表示されます。フィールドに0以外の値が表示される場合は、数値をクリックしてジョブ・アクティビティ・ページに移動できます。このページで、すべてのスケジュール済ジョブ、現在実行中のジョブおよび過去のジョブに関する情報を参照できます。

注意: 表示される4つのジョブ・ステータスのカテゴリは、同種のステータスのジョブ実行をまとめたものです。ジョブ・ステータス値の完全なリストは、「ジョブ・ステータスについて」を参照してください。すべてのジョブを表示したり、特定のステータスのジョブを検索するには、「ジョブ」タブを使用します。

パフォーマンス

「パフォーマンス」セクションには、アクティビティ・クラスおよび上位サービスの1時間分のアクティブ・セッションが表示されます。

アクティビティ・クラス

「アクティブ・セッション」グラフはデータベース内部の潜在的な問題を表します。待機クラスと呼ばれるカテゴリは、データベース内でCPUまたはディスクI/Oなどのリソースを待機している量を表します。グラフには、インスタンスの負荷が表示され、パフォーマンスのボトルネックを特定できます。

問題の領域を迅速に特定するために、グラフには、より重大度の高い問題を示す大きなカラー・ブロックが表示されます。最高ピーク時の最大待機クラスをクリックするか、対応する待機クラス(黄色のハイライト表示で示されます)をクリックします。どちらの操作でも、選択された待機クラス用の待機中アクティブ・セッション・ページが表示され、このページに、待機クラスの上位SQL、上位セッション、上位ファイル、上位オブジェクトと、関連する待機イベントが表示されます。

サービス

「アクティブ・セッション」グラフには、表示される期間の待機イベントに対応する上位サービスが表示されます。アクティブ・セッションのみが表示されます。グラフの右側にあるいずれかのサービスの凡例を選択して、サービス・アクティビティ・ページにアクセスします(ここでは、サービスに関連付けられているすべての待機クラスによるセッションの負荷を表すリアルタイム・データを参照できます)。

リソース

「リソース」セクションには、Oracleホストの相対的なCPU使用率を示す棒グラフが表示されます。この即時的な値は、エージェントによってホストから毎分ごとにリフレッシュされます。100%は、ホスト・システムが提供するCPU合計を表します。「インスタンス」タブは、リソースのインスタンスに関するメジャーのブレークダウンで、「データベース」タブは、メジャー全体を表します。

ホストCPU

このセクションには、クラスタのホスト全体の相対CPU使用率を示す棒グラフが表示されます。この即時的な値は、エージェントによって1分ごとにリフレッシュされます。100%は、クラスタの全ホストのCPU合計を表します。2つの値が棒グラフに表示されます。一番下の暗い色は、データベースの凡例に対応し、このデータベースのすべてのインスタンスが消費しているCPU量を表します。すべての待機クラスおよび関連する統計を表示するには、 「データベース」 リンクをクリックしてトップ・アクティビティ・ページにアクセスします。上側のより明るい色の部分はその他の凡例に相当し、その他のすべてのプロセスを表します。このホストの使用率の統計(CPU、メモリー、ディスクI/Oおよびプログラム・リソース使用率)の概要を参照するには、 「その他」 リンクをクリックしてホスト・パフォーマンス・ページにアクセスします。

「負荷」の数値は、「ホストCPU」グラフに関連していません。「負荷」の数値は、すべてのクラスタ・ホストの「現在のCPU負荷」に関連します。このホストの使用率の統計(CPU、メモリー、ディスクI/Oおよびプログラム・リソース使用率)の概要を参照するには、 「負荷」 リンクをクリックしてホスト・パフォーマンス・ページにアクセスします。

注意: 「ホストCPU」セクションは、Oracle 10gより前のデータベースでは表示されません。

アクティブ・セッション

棒グラフは、すべてのインスタンスがI/OおよびCPUの使用に消費した時間量と、ボトルネックで消費した時間量を示します。棒グラフの横に表示される数値は、合計セッション数ではなく、アクティブなセッション数を表すリテラル数値です。このグラフは履歴の値ではなく最新の値を示します。3つのセッション・カテゴリは、常に「CPU」、「ユーザーI/O」および「待機」です。

「待機」カテゴリは、「ユーザーI/O」を除く、すべての待機クラスを組み合せた値を表します。すべてのリンクは、クラスタ・データベースのパフォーマンス・ページにアクセスします。

「ユーザーI/O」には、ユーザーI/Oの待機に費やされた平均アクティブ・セッションを表示します。ユーザーI/Oは、ディスクからのデータの読取りまたはディスクへのデータの書込みがデータベースで行われる、ユーザーから生じたワークロードを意味します。「ユーザーI/O」リンクをクリックしてパフォーマンス・ページにアクセスし、現在のデータベースの内部および外部の潜在的な問題を表示します。

「CPU」には、CPUの消費に費やされた平均アクティブ・セッションが表示されます。「CPU」リンクをクリックしてトップ・アクティビティ・ページにアクセスし、すべての待機クラスと関連する統計を表示します。

「最大CPU」の数値は、すべてのクラスタ・データベース・ホストの合計CPU数です。

注意: 「アクティブ・セッション」セクションは、Oracle 10gよりも前のデータベースでは表示されません。

メモリー

このグラフには、データベースによって使用されるメモリーがGB単位で表示されます。

「共有プール」には、ユーザー間で共有できる様々な構成が表示されます。たとえば、次のようになります。

- ユーザーが実行するSQL文がキャッシュされ、同じ文が再度使用される際に再利用可能になります。

- データ・ディクショナリの情報がキャッシュされ、クイック・アクセスおよび再利用が可能になります。

- データベースに保存される実行可能コードのストアド・プロシージャをキャッシュすることにより、アクセスが速くなります。

「バッファ・キャッシュ」では、データベースから取得されたデータのブロックをキャッシュします。バッファ・キャッシュ内でデータの一部が見つかれば、これをディスクから読み取る必要がなくなります。複数のブロック・サイズ(使用される場合)用のサブキャッシュもあります。

「ラージ・プール」には、様々なサーバー・プロセスの大きいI/Oリクエストをバッファするために使用されるオプション領域が表示されます。

「Javaプール」は、Java Virtual Machine(JVM)すべてのセッションに特化したJavaコードおよびデータに対して使用されます。

他のSGAには、インスタンスのデータおよび制御情報を含む共有メモリー領域が表示されます。複数のユーザーがこの(Oracleによって制御される)メモリー領域内でデータを共有できるだけでなく、SGA内に格納される情報により、時間のかかる処理である、物理ディスクから繰り返されるアクセスを回避できます。

データ記憶域

このグラフには、UNDOTBS、SYSAUXおよびSYSTEMの表領域のデータ記憶域の詳細が表示されます。

SQL監視 - 過去1時間

このセクションには、過去1時間のSQL監視の詳細がリストされます。Oracle DatabaseのリアルタイムSQL監視機能を使用すれば、SQL文を実行しながらそのパフォーマンスを監視することができます。SQL監視は、SQL文がパラレルに実行されるか、単一の実行で最低5秒以上のCPU時間またはI/O時間を消費すると、デフォルトで自動的に開始されます。リストされる項目はステータス、期間、SQL ID、セッションID、パラレル、およびデータベース時間です。

インスタンス

「インスタンス」表に、クラスタ・データベースのインスタンス、可用性、インシデント、コンプライアンス・スコア、ASMインスタンス情報およびADDM結果が一覧表示されます。左側のパネルのインスタンス名をクリックし、そのインスタンスのホームページに移動します。特定のインシデントの詳細を表示するには、表内の各リンクをクリックします。

22.9 プラガブル・データベース・ホームページの表示

プラガブル・データベース・ホームページを表示するには、「データベース・クラウド・セルフ・サービス・ポータル」の「データベース」リージョンにあるPDB名リンクをクリックします。

このページには、次のリージョンがあります。

- サマリー: データベース・インスタンス・ホームページのリージョンには、データベース・ステータスの概要とデータベースの基本情報が表示されます。これには、データベースの現在のステータスと、インスタンスの開始時間のタイム・スタンプ、データベース・バージョン、最新のバックアップの日付などの詳細が表示されます。

- 接続の詳細: データベースに接続するための接続文字列を表示します。

- リソース使用率: 「予測されるワークロード」や「実際のワークロード」などの使用率詳細が表示されます。

- バックアップとリストア: データベースに高速リカバリ領域が構成されている場合は、このデータベースの日次バックアップをスケジュールできます。「バックアップのスケジュール」をクリックし、このタスクを実行します。バックアップが使用可能になっていれば、「リストア」をクリックし、データベースを特定の時点にリストアできます。高速リカバリ領域が構成されていない場合は、データベース管理者は、高速リカバリ領域を構成するか、またはリクエストが実現した時点で高速リカバリ領域が構成されるデータベースのリクエストを可能にする新規サービス・テンプレートを公開できます。

- パフォーマンス: データベースのパフォーマンス監視情報が表示されます。アクティブ・クラス・タブをクリックすると、リソースの待機またはCPUの消費に費やされた時間を示す棒グラフが表示されます。

- SQL監視: 追跡されたSQLの現在のレスポンスと参照収集のレスポンスを対比して示すSQLレスポンス時間チャートが表示されます。

- リクエスト: この表では、作成したリクエストが追跡されます。各リクエストに対して、リクエストのステータス、タイプ、開始日および送信日が表示されます。スケジュール済のリクエストを選択して、「再スケジュール」をクリックすると、リクエストを再スケジュールできます。スケジュール済のリクエストを削除するには、リクエストを選択してから「取消」をクリックします。

データベースの起動および停止

データベースの状態に応じて、データベースがオープンしている場合には「停止」ボタンを使用してデータベースを停止することができ、データベースがクローズしている場合には「起動」ボタンを使用でき、データベースの状態が不明または「ステータス保留」の場合には、「停止」ボタンを使用できます。

第VIII部

データベースのメンテナンスとカスタマイズ

この項には、データベース・プールのメンテナンス方法とデータベースのカスタマイズ方法に関する章が含まれます。次の章で構成されます。

- 第23章「データベース・プールのメンテナンス」

- 第24章「Database as a Serviceのカスタマイズ」

23 データベース・プールのメンテナンス

この章では、データベース・プールのメンテナンス機能について説明します。次のセクションがあります。

- データベース・プールのメンテナンスについて

- データベース・ゴールド・イメージの作成

- イメージへのサブスクライブ

- イメージのデプロイ

- データベースの更新

- 進行中のイメージ更新の実行

23.1 データベース・プールのメンテナンスについて

Enterprise Managerは、セルフ・サービス管理者が次のものを含むデータベース更新を適用することでメンテナンスできるソフトウェア・メンテナンス機能に基づくサブスクリプションを提供します。

- マイナー更新: 四半期ごとのセキュリティ・パッチ更新(SPU/CPU)とパッチセット更新(PSU)を含む仮の個別パッチ。

- メジャー更新: (11.2.0.2から11.2.0.4)などのパッチセットと11.2.0.xから12.1.0.xなどのメジャー・バージョン・アップグレード。

新規データベース・パッチ、パッチセットまたは更新は、イメージの形式で使用可能になります。イメージ(ゴールド・イメージとも呼ぶ)は、必要なレベルにパッチ適用されるソフトウェア・バイナリを表します。特定のデータベース・バージョンについて新規パッチまたはパッチセットから新規に作成された各イメージは、新しいバージョンです。たとえば、Oracle Databaseバージョン11.2.0.4のイメージには、異なるパッチまたはパッチセット・レベルのゴールド・イメージ(Ver. 1、Ver. 2など)が含まれます。

スタンドアロン・データベース・プールには、Oracleホーム・インフラストラクチャとともにデータベースが含まれます。RACデータベース・プールには、グリッド・インフラストラクチャ・インスタンスおよびその関連OracleホームとともにRACデータベースが含まれます。データベース・プールのメンテナンスには、次の操作が関係します。

- 必要なレベルにパッチ適用されたイメージをデータベース・プールでサブスクライブします。このタスクは、EM_SSA_ADMINISTRATORロールを持つユーザーが実行する必要があります。

- イメージをデプロイし、データベースを古いOracleホームから新しいOracleホームに切り替えます。このタスクは、EM_SSA_ADMINISTRATORロールを持つユーザーが実行する必要があります。

- データベースを更新します。このタスクは、EM_SSA_ADMINISTRATORロールまたはEM_SSA_USERロールを持つユーザーが実行できます。

このメンテナンス・アクティビティは、新しいパッチまたはパッチセット更新が使用可能になったときに実行できます。データベース・プールは、プール内のターゲットがイメージの最新バージョンに関連付けられている場合に完全準拠とみなされます。ターゲットがまだ古いバージョンのイメージに関連付けられている場合、データベース・プールは非準拠とみなされます。セルフ・サービス管理者の目標は、データベース・プール内のすべてのターゲットが100%準拠になるようにすることです。

注意:

- 11.2.0.xから12.1.0.xなどのデータベース・アップグレードの場合は、『Oracle Enterprise Managerライフサイクル管理ガイド』の手順に従ってメンテナンス・アクティビティを実行します。

- データベース・プールのメンテナンスは、グリッド・インフラストラクチャ・ターゲットに対しても実行できます。

データベース・プールのメンテナンス機能は次の点で役立ちます。

- プール内の異なるデータベース・ソフトウェア・バージョンおよびパッチの数を減らせます。

- エンタープライズ全体のデータベース・ソフトウェア・バージョンおよびパッチが標準化されます。

- ソフトウェア・アップグレードとパッチ適用が合理化および自動化されます。

- セルフ・サービス・ユーザーは、新しいソフトウェア・バージョンへの移行とデータベースの更新を自由に行うことができます。

注意:
EMCLIコマンドを使用して、プール・メンテナンス・アクティビティを実行することもできます。詳細は、第47.12項「データベース・フリート・メンテナンスEM CLI動詞」を参照してください。

図23-1 データベース・プールのメンテナンス・ワークフロー

次の表に、データベース・プールの更新とメンテナンスに関連するタスクのリストを示します。

表23-1 データベース・プールのメンテナンス・タスク

手順

作業

ロール

1

データベース・ゴールド・イメージの作成

EM_SSA_ADMINISTRATOR

2

イメージへのサブスクライブ

EM_SSA_ADMINISTRATOR

3

イメージのデプロイ

EM_SSA_ADMINISTRATOR

4

データベースの更新

EM_SSA_ADMINISTRATOR

EM_SSA_USER

5

進行中のイメージ更新の実行

EM_SSA_ADMINISTRATOR

23.2 データベース・ゴールド・イメージの作成

イメージは、特定のプラットフォーム上のターゲット(Oracleデータベースなど)のソフトウェア・ライブラリと必要なパッチ・レベルを含むリリースです。たとえば、イメージDB_11203_Linuxは、必要なレベルのPSUやその他の個別パッチを含む、Linux x86_64プラットフォームに適用される11.2.0.3リリース用のデータベース・ソフトウェアを表します。新しいパッチがある場合は、特定の認定済またはテスト済パッチ・レベルに引き上げられた圧縮されたOracleホームを含む参照ターゲットから新しいバージョンのイメージを作成する必要があります。

データベース・プールをメンテナンスするには、最新のパッチまたはパッチセットを含むイメージをサブスクライブする必要があります。イメージが存在しない場合は、最初にイメージを作成してから、データベース・プールでイメージをサブスクライブする必要があります。

イメージを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとしてログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「リソース・プロバイダ」を選択し、リストで「データベース・プール」をクリックしてデータベース・プール・ホームページに移動します。「データベース・プール」メニューから、「メンバー」を選択し、「メンテナンス」をクリックします。メンテナンス・ページが表示されます。「サブスクリプションの管理」をクリックします。

3. サブスクリプションの管理ページが表示されます。

4. 新規データベース・ホーム・イメージの作成をクリックします。次のダイアログ・ボックスが表示されます。

図23-2 新規イメージの作成

5. 新規イメージの作成ダイアログ・ボックスの「参照ターゲット」セクションで、次の詳細を指定します。

- 参照ターゲットの名前。検索アイコンを選択すると、表示されたリストからターゲットを選択できます。ターゲットを選択するとOracleホームおよびホスト名の詳細が自動的に追加されます。

- Oracleホーム資格証明。「検索」アイコンをクリックすると、既存のOracleホーム資格証明を選択できます。「OK」をクリックします。次に、「テスト」ボタンをクリックすると、資格証明が有効であるかどうかを確認できます。

- 作業ディレクトリ。作業ディレクトリを指定するか、「検索」アイコンをクリックして1つ選択します。

6. 「ソフトウェア・ライブラリのアップロード場所」に、場所、タイプおよびアップロード・ファイルの場所を指定します。このような詳細は、デフォルトですでに指定されています。確認または変更できます。

7. イメージ情報セクションで、次の詳細を指定します。

- イメージ名。イメージの新しい一意の名前を指定します。たとえば、DB11203_Linux_SALES_XYZです。

- イメージの説明。たとえば、次のようになります。

DB Image for 11.2.0.3 Database software on Linux x86_64 starting with Oct PSU 2014 patch level

- バージョン: バージョンを表すために使用される表示名。たとえば、イメージの説明に基づき、バージョン名はOCT PSU 2014として指定できます。

- プラットフォーム:

- バージョン名。新しい一意のバージョン名を指定します。

- 注意: イメージの追加の説明を指定します。たとえば、説明を次のように指定できます。

Database Patchset Update (PSU) October 2014 with additional 5 one-off patches for the Database Software.

8. 「作成」をクリックします。新規に作成されたイメージは「Oracle Databaseホームのイメージ」表に表示され、新規に作成されたイメージをサブスクライブします。この時点で、データベース・プールのコンプライアンスは0%です。データベース・プールを100%準拠にするには、次の操作を行う必要があります。

- イメージをデプロイします。第23.4項「イメージのデプロイ」を参照してください。

- イメージを更新します。第23.4.3項「データベースの更新」を参照してください。

23.3 イメージへのサブスクライブ

新規イメージが作成されると、データベース・プールはイメージを自動的にサブスクライブします。メンテナンスを開始するには、まずイメージをデプロイします。第23.4.1項「Oracleホームのデプロイ」にリストされている手順に従います。

データベース・プールを別のイメージでメンテナンスする場合は、イメージをサブスクライブする必要があります。既存のイメージをサブスクライブするには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとしてログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。ページ上の「リソース・プロバイダ」リンクをクリックします。データベース・プールとPaaSインフラストラクチャ・ゾーンのリストが表示されます。

3. 「データベース・プール」をクリックして、データベース・プール・ページを表示します。

4. 「データベース・プール」メニューから、「メンバー」、「メンテナンス」の順に選択します。

5. 「サブスクリプションの管理」をクリックします。Oracleデータベースに対して使用可能で適用可能なイメージのリストが表示されます。Oracleデータベースのサブスクリプションの更新チェック・ボックスを選択し、リストからイメージを選択して「サブスクライブ」をクリックします。

図23-3 サブスクリプションの管理ページ

プールがイメージを正常にサブスクライブしたことを示すメッセージが表示されます。新規にサブスクライブしたイメージがデータベース・プールに対して使用可能になり、データベース・プールは0%準拠です。イメージ・サブスクリプション・ページの「イメージ・バージョンへの更新」リージョンに、実行する必要のあるアクションがリストされます。データベース・プールを100%準拠にするには、イメージをデプロイし、データベースを更新する必要があります。

6. 図23-4 イメージ・サブスクリプション・ページ

円グラフには、イメージおよびイメージの様々なバージョンについて、データベース・プール内のターゲットの分布率が表示されます。各バージョンは次のように表されます。

- システム・バージョン番号(バージョン表示名) (バージョン内のターゲット数)。たとえば、V1 (DEC PSU 2014) (2)です。

- 各バージョンは、次のいずれかの状態になります。

- ドラフト: これはテスト・バージョンです。

- 制限付き: これは、制限されたターゲット・セットにリリースされるベータ・バージョンを表します。

- 現行: これは、イメージの最新バージョンを表します。

管理者のメンテナンス目標は、プール内のすべてのターゲットをイメージの「現行」バージョンに移行して、プールを最新かつ準拠状態に保つことです。

23.4 イメージのデプロイ

セルフ・サービス管理者が新規イメージにデータベース・プールをサブスクライブしたら、新規イメージをデプロイする必要があります。イメージをデプロイするには、次の手順に従います。

1. イメージ・メンテナンス・ページに移動します。ページの「イメージ・バージョンへの更新」リージョンの「選択」ボタンをクリックします。次のページが表示されます。

図23-5 イメージのデプロイ

メンテナンス・プロセスを完了し、データベースを更新するには、3つの手順が必要です。

- デプロイ: 第23.4.1項「Oracleホームのデプロイ」を参照してください。

- アクティブ化: 第23.4.2項「新規Oracleホームのアクティブ化」を参照してください。

- 更新: 第23.4.3項「データベースの更新」を参照してください。

2. デプロイメントのスケジュールを指定し、「発行」をクリックしてジョブを発行します。

23.4.1 Oracleホームのデプロイ

このオプションは、イメージ・バイナリをデータベース・プール内の各ホストにコピーし、そのすべてに新しいOracleホームを作成します。このページに移動すると、「デプロイ」手順がハイライト表示され、ステータスが「保留中」になります。イメージをデプロイするターゲットのリスト、ターゲット所有者、およびイメージのバージョンが表示されます。イメージをデプロイするには、次の手順に従います。

1. 「デプロイ」をクリックします。次のダイアログ・ボックスが表示されます。

図23-6 メンテナンス・アクティビティ

2. 「名前」、「説明」、「新規Oracleホームの場所」、「作業ディレクトリ」および「ディスパッチャの場所」を指定します。

3. 「発行」をクリックしてイメージをデプロイし、新規Oracleホームを作成します。

23.4.2 新規Oracleホームのアクティブ化

この手順は、新規更新が使用可能であるという通知をセルフ・サービス・ユーザーに送信します。新規にデプロイされたOracleホームをアクティブにすると、データベース・プールに関連付けられているセルフ・サービス・テンプレートも更新され、新規Oracleホームから作成する新規データベース・サービス・リクエストがリダイレクトされます。「アクティブ化」をクリックして、正常にデプロイされたOracleホームをアクティブにします。

23.4.3 データベースの更新

この手順は、データベースを古いOracleホームから新しいOracleホームに切り替え、イメージに関連するすべてのパッチに対してインストール後の手順を完了します。この手順は、セルフ・サービス管理者またはセルフ・サービス・ユーザーが実行できます。

イメージの最新バージョンをデプロイした後、セルフ・サービス管理者は次のいずれかを実行できます。

- 最新バージョンを適用し、データベースを更新します。プールに関連付けられたデータベース・ターゲットを更新するには、図23-5に示す「更新」オプションを選択し、「更新」をクリックします。最新パッチは、プール内のすべてのデータベース・ターゲットに適用されます。これで、データベース・プールは100%準拠になります。

- セルフ・サービス・ユーザーへの職責の委任フィールドで「はい」をクリックして、セルフ・サービス・ユーザーに、更新について通知します。セルフ・サービス・ユーザーは、次の手順に従って更新を適用することを選択できます。

1. EM_SSA_USERロールを持つユーザーでログインします。

2. セルフ・ポータル・ページで、「管理」ドロップ・ダウン・リストから「データベース」を選択します。更新が使用可能なデータベースをクリックし、ホーム・ページにドリル・ダウンします。

図23-7 データベースの更新

3. 「更新」をクリックして、データベースを新規Oracleホームに切り替えます。

注意:

- すべてのタスク(デプロイ、アクティブ化および更新)が実行されると、プールが新規イメージを正常にサブスクライブします。

- データベース・プールが新しいバージョンのイメージをサブスクライブすると、プールのコンプライアンス・ステータスが0%に変更されます。新しいバージョンがデプロイされ、データベース・プールに関連付けられたすべてのデータベースが更新されると、コンプライアンスが100%になります。

23.5 進行中のイメージ更新の実行

新規パッチまたはパッチセットが使用可能になったときに、データベース・プールに新規パッチをデプロイするには、次のタスクを実行する必要があります。

- イメージの新規バージョンの作成

- イメージのデプロイ

- データベースの更新

23.5.1 イメージの新規バージョンの作成

イメージの新規バージョンを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとしてログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。ページ上の「リソース・プロバイダ」リンクをクリックします。データベース・プールとPaaSインフラストラクチャ・ゾーンのリストが表示されます。

3. 「データベース・プール」をクリックして、データベース・プール・ページを表示します。

4. 「データベース・プール」メニューから、「メンバー」、「メンテナンス」の順に選択します。イメージ・サブスクリプション・ページが表示されます。

5. ページの「イメージの管理」リンクをクリックします。イメージの管理ページが表示されます。

図23-8 イメージの管理

このページには、次の詳細が含まれます。

- データベース・イメージ: このリージョンには、イメージの名前、サブスクライブされたターゲット数、コンプライアンス・スコア、製品バージョン、データベース・タイプおよびプラットフォームが表示されます。

- デプロイ: このリージョンには、イメージ内の各バージョンに関するデプロイメントの割合で構成される円グラフが表示されます。

- アクティブ・バージョン: このリージョンには、アクティブなバージョンの数、バージョンの名前、バージョン番号、バージョンのステータス(現行またはアクティブ)、各バージョンのデプロイメントの数、各バージョンの作成日およびバージョンのSSA所有者がリストされます。

- 一般: 「一般」タブには、データベース・タイプ、製品バージョン、プラットフォーム、状態、説明、作成日およびイメージの所有者がリストされます。「ソフトウェア」タブには、Oracleホームの場所、製品名およびホスト名が表示されます。イメージのスナップショットを保存している場合は、「表示」をクリックすると表示できます。

6. 「バージョンの管理」をクリックして、イメージのバージョンを管理します。

図23-9 データベース・イメージのバージョンの管理

このページは、各バージョンの名前、バージョン番号、バージョンのステータス、各バージョンのデプロイメントの数、バージョンの作成日およびバージョンの所有者をリストする表から構成されます。

バージョンを選択すると、「一般」タブおよび「ソフトウェア」タブには、バージョンの一般的な情報とソフトウェア詳細が自動的に表示されます。

7. 「アクション」メニューから、「作成」を選択して、イメージの新規バージョンを作成します。新規イメージの作成ダイアログ・ボックスが表示されます。

8. 第23.2項「データベース・ゴールド・イメージの作成」にリストされている手順に従って、新規イメージ・バージョンを作成します。データベース・プールは、新規バージョンをサブスクライブします。
新規バージョンが作成された後、「現行バージョンの設定」をクリックして、このバージョンをイメージの現行バージョンとして設定できます。「制限されたバージョンの設定」をクリックして、このバージョンを使用できるユーザーを制限できます。バージョンのステータスを「制限付き」に設定した場合、他のユーザーはそのバージョンにアクセスできません。

イメージの編集

イメージ・バージョンを編集するには、イメージを選択し、「アクション」メニューの「編集」をクリックします。このオプションにより、イメージ・バージョンの名前を変更できます。

イメージの削除

データベース・イメージを削除するには、「イメージ」セクションで削除するイメージを選択し、「削除」をクリックします。「はい」をクリックして確認し、イメージを削除します。

24 Database as a Serviceのカスタマイズ

この章では、Database as a Serviceのカスタマイズ方法について説明します。内容は次のとおりです。

- リクエスト作成/削除の前処理および後処理スクリプト

24.1 リクエスト作成/削除の前処理および後処理スクリプト

サービス・インスタンスの作成前後にカスタム・スクリプトを実行できます。これらのリクエストは、データベースが作成されたマシン上のいくつかの追加ホスト・コマンドから、新規にプロビジョニングされたデータベース上で追加のブック・アクティビティやその他の操作を実行するコマンドまで、多岐にわたります。

同様に、サービスのクリーンアップ中に行った変更のやり直しが必要な場合、サービス・インスタンスの削除後にスクリプトを実行できます。

カスタム・スクリプトはいくつかのガイドラインに従う必要があり、次の4つの部分で構成されています。

- レスポンス・ファイル: レスポンス・ファイルには、サービス・テンプレートおよびリクエスト固有の情報が含まれます。カスタム・スクリプトが実行される前に、リクエスト・プロシージャにより、自動計算されるSID、データベースがデプロイされるホストなど、サービス・テンプレートやリクエスト固有のデータからのデータが含まれるレスポンス・ファイル(名前/値ペアのファイル)が生成されます。

- ドライバ・スクリプト: リクエスト・プロシージャにより呼び出される主要なドライバ・スクリプトです。ドライバ・スクリプトは、レスポンス・ファイルの場所を指定する1つの引数のみを受け入れます。

- その他のスクリプト: ドライバ・スクリプトの他に、その他のPerlまたはSQLスクリプトを指定できます。これらのスクリプトは、ドライバ・スクリプトから呼び出す必要があります。

- 追加変数: 状況に応じて、カスタム・スクリプトにより使用される追加の変数が含まれるファイルを含めることができます。

スクリプトを作成したら、これらをディレクティブとしてソフトウェア・ライブラリにアップロードする必要があります。ディレクティブの詳細は次のとおりです。

図24-1 前処理または後処理DBスクリプト: 説明

説明ページに、ディレクティブの名前および説明が表示されます。「構成」タブをクリックします。

図24-2 前処理または後処理DBスクリプト: 構成

ドライバ・スクリプトは、INPUT_FILE形式の1つのコマンドライン引数を受け入れます。この変数は、生成されたレスポンス・ファイルの場所を実行時に指定するために使用されます。「ファイルの選択」タブをクリックします。

図24-3 前処理または後処理DBスクリプト: ファイルの選択

カスタム・スクリプトで必要となるすべての追加ファイルを指定します。スクリプトは、データベース・インスタンスまたはデータベース・サービスが作成または削除されたホストと同じホストから実行できます。

注意:
スクリプトの内容を変更する必要がある場合は、新しいバージョンのスクリプトをソフトウェア・ライブラリにアップロードする必要があります。最新バージョンのスクリプトを使用するには、サービス・テンプレートの編集ウィザードを起動して、スクリプトの更新されたバージョンを選択してテンプレートを保存する必要があります。これにより、最新バージョンのスクリプトが使用されるようになります。

24.1.1 SQL後スクリプト

SQL後スクリプトを作成し、ソフトウェア・ライブラリにアップロードできます。セルフ・サービス管理者は、サービス・テンプレートの作成中にスクリプトを選択できます。スクリプトを指定する手順は、次のとおりです。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとしてログインします。

2. 「エンタープライズ」メニューから、「クラウド」を選択します。「クラウド・ホーム」メニューから、「サービス・テンプレート」、「作成」の順に選択します。

3. 「サービス・テンプレート」タイプとして「データベース」を選択し、「作成」をクリックします。

4. 構成ページに移動します。「SQL後スクリプト」フィールドの横の「検索」アイコンをクリックし、「ソフトウェア・ライブラリ」からスクリプトを選択します。

5. 「実行ユーザー」ドロップ・ダウンで、「SYS」ユーザーがデフォルトで選択されています。
このユーザーが選択されている場合は、ウィザードのデータベース・ページで指定したSYSパスワードは、データベース作成SQL後スクリプトの実行に使用されます。

マスター・アカウントを含む他のユーザーが選択されている場合、セルフ・サービス・ユーザーがサービス・リクエストの作成時にマスター・アカウントに対して指定したパスワードが使用されます。

注意:
ユーザー・アカウントがロックされている場合は、エラー・メッセージが表示されます。ユーザー・アカウントは、ソース・データベースに開く必要があります。

24.1.2 サンプル・スクリプト

ソフトウェア・ライブラリ内のサンプル・スクリプトを使用できます。サンプル・スクリプトを表示するには、「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」を選択し、「ソフトウェア・ライブラリ」を選択します。DBaaSフォルダを選択し、次に「ディレクティブ」を選択して、サンプル・フォルダをクリックしてカスタム・スクリプトを表示します。

図24-4 サンプル・スクリプト

24.1.3 前処理および後処理データベース・スクリプトの入力パラメータ

この項の内容は次のとおりです。

- DBaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

- DBaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

- SchaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

- SchaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

- PDBaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

- PDBaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

- サンプル入力ファイル

- サンプルPDBaaS後処理スクリプト

24.1.3.1 DBaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

次の表に、DBaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータを示します。

表24-1 DBaaS: リクエスト作成の前処理および後処理スクリプトの入力パラメータ

変数名

説明

例

ssaRequestId

SSAユーザー・リクエストのリクエストID。

3

ssaUser

SSAユーザー名。

Ssa_user1

ssaTargetName

ゾーン・ターゲット名。

Myzone1

ssaTargetType

ゾーン・ターゲット・タイプ。

Self_service_zone

zoneTargetName

ゾーン・ターゲット名。

Myzone1

zoneTargetType

ゾーン・ターゲット・タイプ。

Self_service_zone

DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URN

PDBターゲットの作成前に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

DBAAS_SSA_CUSTOM_POST_SCRIPTS_URN

PDBターゲットの作成後に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

SEL_HOST

新しいデータベースが作成される配置の一部として選択されるホスト。

Myhost.oracle.com

MEM_SIZE

リクエストされるデータベースのメモリー・サイズ。これは、SGAおよびPGAの集計サイズの合計または合計メモリー・サイズになります。

2324

STORAGE_SIZE

リクエストされたデータベースの合計記憶域サイズ

2324

HOST_CREDS

データベースが作成されるホストの資格証明。

Mycred1:dbaas_admin

PROFILE_COMPONENT_URN

プロファイル・コンポーネントURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:E9C8A650EFA5291DE04354B2F00AFF3E:0.1

WORK_DIR

プロビジョニング関連ファイルをステージングするために使用される一時作業ディレクトリ

/tmp

DB_ADMIN_PASSWORD_SAME

sys、systemおよびdbsnmpに指定されたパスワードが同じかどうかを示します。

必須

DB_ORACLE_HOME_LOC

新しいデータベースの作成元となる、選択されたホストのOracleホーム。

/scratch/aime/oraclehomes/dbbase/112030/dbhome1

DB_ORACLE_BASE_LOC

選択されたOracleホームのOracleベース。

/scratch/aime/oraclehomes/dbbase

TOTAL_MEMORY

選択されたデータベースの合計メモリー(メモリー管理タイプがAMMの場合)。

0

SGA_MEMORY

データベースに設定されたSGAメモリーの値。

1744

PGA_MEMORY

データベースに設定されたPGAターゲットの値。

580

INIT_PARAMS

サービス・テンプレートに設定された初期化パラメータ値のリスト。値は、paramName=paramValue[,paramName=paramValue]として格納されます。

processes=150,cluster_database=FALSE,db_name=,open_cursors=300,sga_target=1828716544,db_block_size=8192,audit_file_dest={ORACLE_BASE}/admin/{DB_UNIQUE_NAME}/adump,diagnostic_dest={ORACLE_BASE},*.cpu_count=0,db_recovery_file_dest={ORACLE_BASE}/fast_recovery_area,log_archive_format=%t_%s_%r.dbf,compatible=11.2.0.0.0,audit_trail=DB,remote_login_passwordfile=EXCLUSIVE,undo_tablespace=UNDOTBS1,db_recovery_file_dest_size=4322230272,control_files=("{ORACLE_BASE}/oradata/{DB_UNIQUE_NAME}/control01.ctl", "{ORACLE_BASE}/fast_recovery_area/{DB_UNIQUE_NAME}/control02.ctl"),pga_aggregate_target=608174080

DATABASE_TYPE

リクエストの一部としてプロビジョニングされるデータベースのタイプ。

oracle_databaseまたはrac_database

USER_NAME

マスター・アカウントとして扱われ、リクエストされたデータベースへのログインに使用されるユーザー名(任意のOracleデフォルト・アカウント以外)。

Useracct1

INSTANCE_COUNT

リクエストの対象がRACデータベースの場合に作成されるデータベース・インスタンスの数。

1

COMMON_DB_SID

一意のデータベース名の生成に使用される、サービス・テンプレートで指定されたSID接頭辞。

db000000

COMMON_DOMAIN_NAME

Enterprise Managerでのデータベース・ターゲットの作成に使用される、サービス・テンプレートで指定されたデータベース・ドメイン名。

Mycompany.com

LISTENER_PORT

データベースがアタッチされるホストのリスナーのポート番号。

1521

REF_ZONE

検証で使用される参照ゾーン。

Myzone1

REF_POOL

参照ゾーンで選択されるプール。

Mypool1

REF_HOST

プールから選択される参照ホスト。

Myhost1.oracle.com

REF_TGT

プールから選択される参照ホスト

Myhost1.oracle.com

COMMON_GLOBAL_DB_NAME

グローバル・データベース・ドメイン・ネーム。

db000000.myhost.oracle.com

24.1.3.2 DBaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

次の表に、DBaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータを示します。

表24-2 DBaaS: リクエスト削除の前処理および後処理スクリプトの入力パラメータ

変数名

説明

ExampleDB

DB_SID

削除対象に選択されたデータベースのデータベースSID。これは、データベースに接続するために使用できます。

db000000

HOST_NAME

削除対象に選択されたDBが存在するホストの名前。

Myhost.oracle.com

DATABASE_TGT_GUID

削除対象に選択されたデータベースのGUID

E9C5A1149C266846E04354B2F00A9D7B

HOST_CREDS

データベース・ホストにログインしてOracleホームにアクセスするための資格証明。

MYCREDS:DBAAS_ADMIN

ROOT_CREDS

プールの指定に従ってスーパーユーザーとしてホストにログインするためのルート資格証明。

MYROOTCREDS:DBAAS_ADMIN

TARGET_GUID

削除対象に選択されたデータベースのGUID。

E9C5A1149C266846E04354B2F00A9D7B

BACKUP_ENABLED

バックアップがスナップ・クローン・データベース・ターゲットに対して有効化されているかどうか。

True

WORK_DIR

削除に使用される一時作業ディレクトリ。

/tmp/workdir1

CUSTOM_DEL_PRE_SCRIPTS_URN

スキーマの削除前に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

CUSTOM_DEL_POST_SCRIPTS_URN

スキーマの削除後に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

24.1.3.3 SchaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

次の表に、Schema as a Serviceのリクエスト作成の前処理および後処理スクリプトの入力パラメータを示します。

表24-3 SchaaS: リクエスト作成の前処理および後処理スクリプトの入力パラメータ

変数名

説明

ExampleDB

ssaRequestID

SSAユーザー・リクエストのリクエストID。

3

ssaUser

SSAユーザー名。

Ssa_user1

ssaTargetName

ゾーン・ターゲット名。

Myzone1

ssaTargetType

ゾーン・ターゲット・タイプ。

Self_service_zone

zoneTargetName

ゾーン・ターゲット名。

Myzone1

zoneTargetType

ゾーン・ターゲット・タイプ。

Self_service_zone

SCHAAS_CUSTOM_PRE_SCRIPTS_URN

スキーマ・ターゲットの作成前に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

REQUEST_NAME

リクエストの名前。

SYSMAN - Tue Oct 29 02:04:21 PDT 2013_CREATE_4_41

SERV_TEMPLATE_GUID

サービス・テンプレートguid。

E9C5A1149C266846E04354B2F00A9D7B

CREATE_SCHEMA_OPTION

空のスキーマまたはプロファイルによるスキーマの作成を区別するオプション。可能な値は、EMPTY_SCHEMASまたはSCHEMAS_FROM_PROFILEです。

EMPTY_SCHEMAS

MAX_NUMBER_OF_SCHEMAS

ユーザーがプロファイルを選択しない場合に許可するスキーマの最大数。空のスキーマの作成オプションが選択されている場合にのみ適用されます。

4

MASTER_ACCOUNT

選択されたスキーマのリストからのマスター・アカウント。

MySchema

ROLE_NAME

すべてのスキーマに割り当てられるデータベース・ロールの名前。

Mynewrole1

SCHEMA_PRIVILEGES

ユーザー・アカウントに適用されるスキーマ権限のリスト。

CREATE VIEW, CREATE DIR

ENFORCE_STORAGE_CONSTRAINT

サービス・リクエストに記憶域制約を強制します。可能な値は、trueまたはfalseです。

True

INITIAL_BLOCK_SIZE

表領域の初期サイズ。

2048M

AUTO_EXTEND_BLOCK_SIZE

自動拡張ブロック・サイズ。

100M

TABLESPACE_ENCRYPTION_ALGORITHM

表領域の暗号化に使用されるアルゴリズム

AES128

SHARED_STORAGE_LOCATION

選択されたプールのホスト全体にダンプ・ファイルが配置される共有ステージングの場所。スキーマ作成オプションが既存のプロファイルに基づく設定である場合にのみ指定します。

/oradbnfs/dumpfiles/

DBSERVICE_NAME

リクエスト中に提供されるデータベース・サービス名。

Service_88A370FC0FC1

DB_ORACLE_HOME_LOC

新しいスキーマが作成されるデータベースのOracleホーム。

/scratch/aime/app/aime/11.2.0/dbhome_1

COMMON_DB_SID

ホストでデータベースが接続できるサービスの名前。

Mydb1

REMAP_SCHEMA_LIST

ターゲットに作成されるスキーマのリスト。

MySchema

24.1.3.4 SchaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

次の表に、Schema as a Serviceのリクエスト削除の前処理および後処理スクリプトの入力パラメータを示します。

表24-4 SchaaS: リクエスト削除の前処理および後処理スクリプトの入力パラメータ

変数名

説明

例

DB_CONNECT_STRING

データベースへの接続を確立するための接続文字列。

DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = myhost.oracle.com)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED)(SID= Myservice1)))

SCHEMA_NAME

削除対象に選択されたスキーマの名前。

Myservice1

PERM_TABLESPACE_NAME

プライマリ表領域。

Myschema1

HOST_NAME

削除対象に選択されたDBが存在するホストの名前。

Myhost.oracle.com

DATABASE_CREDS

データベースに接続するために使用される名前付き資格証明。

MYDBCREDS:DBAAS_ADMIN

GI_CREDS

RACの場合にグリッド・インフラストラクチャに接続するために使用される名前付き資格証明。

MYHOSTCREDS:DBAAS_ADMIN

WORK_DIR

一時作業ディレクトリ

/tmp/myworkdir1

CUSTOM_DEL_PRE_SCRIPTS_URN

スキーマの削除前に実行されるソフトウェア・ライブラリのディレクティブのURN

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

CUSTOM_DEL_POST_SCRIPTS_URN

スキーマの削除後に実行されるソフトウェア・ライブラリのディレクティブのURN

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

24.1.3.5 PDBaaSのリクエスト作成の前処理および後処理スクリプトの入力パラメータ

次の表に、PDB as a Serviceのリクエスト作成の前処理および後処理スクリプトの入力パラメータを示します。

表24-5 PDBaaS: リクエスト作成の前処理および後処理スクリプトの入力パラメータ

変数名

説明

例

ssaRequestId

SSAユーザー・リクエストのリクエストID。

3

ssaUser

SSAユーザー名。

Ssa_user1

ssaTargetName

ゾーン・ターゲット名。

Myzone1

ssaTargetType

ゾーン・ターゲット・タイプ。

Self_service_zone

PDBAAS_CUSTOM_PRE_SCRIPTS_URN

PDBターゲットの作成前に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

PDBAAS_CUSTOM_POST_SCRIPTS_URN

PDBターゲットの作成後に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

CREATE_PDB_OPTION

空のPDBまたはプロファイルによるPDBが含まれるプラガブル・データベースを作成するオプション。可能な値は、EMPTY_PDBまたはPDB_FROM_PROFILEです。

EMPTY_PDB

PDB_CONNECT_STRING

プラガブル・データベースへの接続を確立するための接続文字列。

(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=myhost.mycompany.com)(PORT=1531)))(CONNECT_DATA=(SERVICE_NAME=svc_mypdb)(INSTANCE_NAME=CDB01)(UR=A)(SERVER=DEDICATED)))

PDB_NAME

作成されるPDBターゲットの名前。

mypdb

CDB_CONNECT_STRING

コンテナ・データベースへの接続を確立するための接続文字列。

(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=myhost.mycompany.com)(PORT=1531)))(CONNECT_DATA=(SID=CDB01)))

MAX_TABLESPACE_ALLOWED

Pluggable Database as a Serviceで許可される表領域の最大数。

10

ENFORCE_STORAGE_CONSTRAINT

サービス・リクエストに記憶域制約を強制します。可能な値は、trueまたはfalseです。

True

TABLESPACE_ENCRYPTION_ALGORITHM

表領域の暗号化に使用されるアルゴリズム。

AES128

TABLESPACE_SIZE

一意のデータベース名の生成に使用される、サービス・テンプレートで指定されたSID接頭辞。

mydb

PDB_SID_PREFIX

新しいプラガブル・データベースのSID接頭辞。

Mypdb1

SHARED_STAGE_LOCATION

選択されたプールのホスト全体にダンプ・ファイルが配置される共有ステージングの場所。

/oradbnfs/dumpfiles/

PDB_ADMIN_USER_NAME

新しいプラガブル・データベースの管理者ユーザー名。

Myadmin

PDB_SERVICE_NAME_PREFIX

プラガブル・データベースのサービス名の接頭辞。

Service

PDBSERVICE_NAME

プラガブル・データベースのサービス名。

Service_000

DB_ORACLE_HOME_LOC

新しいスキーマが作成されるデータベースのOracleホーム。

/scratch/aime/app/aime/11.2.0/dbhome_1

COMMON_DB_SID

ホストでデータベースが接続できるサービスの名前。

Mydb1

ROLE_OPTION

プラガブル・データベース管理者に割り当てられる「カスタム新規ロール/既存のロールのロール・オプション」。

CUSTOM_NEW_ROLE

INIT_PARAMS

サービス・テンプレートに設定された初期化パラメータ値のリスト。値は、paramName=paramValue[,paramName=paramValue]として格納されます。

*.open_cursors 300,*.cursor_sharing EXACT

CUSTOM_ROLE_NAME

プラガブル・データベース管理者に割り当てられるデータベース・ロールの名前。

PDBAAS_OCT_29_2013_02_27_AM

CUSTOM_ROLE_DESC

作成される新しいロールの説明。

プラガブル・データベース管理者に割り当てられる新しいDBロール。

PRIVILEGES

プラガブル・データベース管理者に適用されるカスタム新規ロールの権限のリスト。

CREATE SESSION, ALTER SESSION, CREATE DIMENSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY

ROLES

すべてのスキーマに割り当てられるデータベース・ロールの名前。

Mynewrole1

DB_ORACLE_HOME_LOC

選択されたコンテナ・データベースのOracleホーム。

/scratch/aime/oraclehomes/dbbase/121010/dbhome1

COMMON_DB_SID

新しいPDBの作成場所となる選択されたコンテナ・データベースのデータベースSID。

cdb

24.1.3.6 PDBaaSのリクエスト削除の前処理および後処理スクリプトの入力パラメータ

次の表に、PDB as a Serviceのリクエスト削除の前処理および後処理スクリプトの入力パラメータを示します。

表24-6 SchaaS: リクエスト削除の前処理および後処理スクリプトの入力パラメータ

変数名

説明

例

DB_CONNECT_STRING

データベースへの接続を確立するための接続文字列。

DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = myhost.oracle.com)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED)(SID= mypdb0001)))

PDB_NAME

削除対象に選択されたPDBターゲットの名前。

Mypdb001

HOST_NAME

削除対象に選択されたPDBが存在するホストの名前。

Myhost.oracle.com

DATABASE_CREDS

データベースに接続するために使用される名前付き資格証明。

MYDBCREDS:DBAAS_ADMIN

GI_CREDS

RACの場合にグリッド・インフラストラクチャに接続するために使用される名前付き資格証明。

MYHOSTCREDS:DBAAS_ADMIN

WORK_DIR

一時作業ディレクトリ

/tmp/myworkdir1

CUSTOM_DEL_PRE_SCRIPTS_URN

PDBターゲットの削除前に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

CUSTOM_DEL_POST_SCRIPTS_URN

PDBターゲットの削除後に実行されるソフトウェア・ライブラリのディレクティブのURN。

oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1

24.1.3.7 サンプル入力ファイル

この項には、DBaaS、Schema as ServiceおよびPDB as a Serviceのいくつかのサンプル入力ファイルが含まれます。

例24-1 DBaaSのサンプル入力ファイル

ssaRequestId=2
ssaUser=ssa_user1
ssaTargetName=My Zone
ssaTargetType=self_service_zone
zoneTargetName=My Zone
zoneTargetType=self_service_zone
SEL_HOST=myhost.oracle.com
MEM_SIZE=2324
STORAGE_SIZE=2324
HOST_CREDS=AIME:SYSMAN
INIT_PARAMS=processes=150,cluster_database=FALSE,db_name=,open_cursors=300,
sga_target=1828716544,db_block_size=8192,audit_file_dest={ORACLE_BASE}/admin/
{DB_UNIQUE_NAME}/adump,diagnostic_dest={ORACLE_BASE},*.cpu_count=0,db_recovery
_file_dest={ORACLE_BASE}/fast_recovery_area,log_archive_format=%t_%s
_%r.dbf,compatible=11.2.0.0.0,audit_trail=DB,remote_login
_passwordfile=EXCLUSIVE,undo_tablespace=UNDOTBS1,db_recovery_file_dest
_size=4322230272,control_files=("{ORACLE_BASE}/oradata/{DB_UNIQUE
_NAME}/control01.ctl", "{ORACLE_BASE}/fast_recovery_area/{DB_UNIQUE
_NAME}/control02.ctl"),pga_aggregate_target=608174080
PROFILE_COMPONENT_URN=oracle:defaultService:em:provisioning:1:cmp:COMP
_Component:SUB_DbProfile:E9C8A650EFA5291DE04354B2F00AFF3E:0.1
DATABASE_TYPE=oracle_database
WORK_DIR=/tmp
DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URN=oracle:defaultService:em:provisioning:1:cmp:COMP
_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1
USER_NAME=rv
INSTANCE_COUNT=2
DB_ADMIN_PASSWORD_SAME=true
COMMON_DB_SID=db000000
COMMON_DOMAIN_NAME=mycompany.com
LISTENER_PORT=1527
COMMON_GLOBAL_DB_NAME=db000000.myhost.oracle.com
DB_ORACLE_HOME_LOC=/scratch/aime/oraclehomes/dbbase/112030/dbhome1
DB_ORACLE_BASE_LOC=/scratch/aime/oraclehomes/dbbase
TOTAL_MEMORY=0
SGA_MEMORY=1744
PGA_MEMORY=580
MEM_SIZE=2324
STORAGE_SIZE=2324
REF_ZONE=My Zone
REF_POOL=dbpool1
REF_HOST=myhost.oracle.com
REF_TGT= myhost.oracle.com

例24-2 サンプルSQLスクリプト

REM --- your custom sql script ---
REM --- sample: select * from v$database ---
REM --- If there are more that one sql file all files can be uploaded to the same component, and be called from the main script using
@/<staging location>/sqlfile1.sql ----

例24-3 Schema as a Serviceのサンプル入力ファイル

ssaRequestId=1
ssaUser=SYSMAN
ssaTargetName=My Zone
ssaTargetType=self_service_zone
zoneTargetName=My Zone
zoneTargetType=self_service_zone
REQUEST_NAME=SYSMAN - Tue Oct 29 02:04:21 PDT 2013_CREATE_4_41
SERV_TEMPLATE_GUID=E9C5A1149C266846E04354B2F00A9D7B
CREATE_SCHEMA_OPTION=EMPTY_SCHEMAS
MAX_NUMBER_OF_SCHEMAS=4
REMAP_SCHEMA_LIST=MySchema
MASTER_ACCOUNT=MySchema
ROLE_NAME=schtemplate1_Oct_29_2013_02
SCHEMA_PRIVILEGES=CREATE SESSION,CREATE DIMENSION,CREATE INDEXTYPE,CREATE
OPERATOR,CREATE PROCEDURE,CREATE SEQUENCE,CREATE TABLE,CREATE TRIGGER,CREATE
TYPE,CREATE VIEW,CREATE SYNONYM
ENFORCE_STORAGE_CONSTRAINT=false
SCHAAS_CUSTOM_PRE_SCRIPTS_URN=oracle:defaultService:em:provisioning:1:cmp:COMP
_Directives:none:E9DE463D356E7433E04354B2F00A56C6:0.1
DBSERVICE_NAME=Service_88A370FC0FC1
DB_ORACLE_HOME_LOC=/scratch/aime/oraclehomes/dbbase/112030/dbhome1
COMMON_DB_SID=refdb

例24-4 PDB as a Serviceのサンプル入力ファイル

ssaRequestId=3
ssaUser=SYSMAN
ssaTargetName=My Zone
ssaTargetType=self_service_zone
zoneTargetName=My Zone
zoneTargetType=self_service_zone
CREATE_PDB_OPTION=EMPTY_PDB
MAX_TABLESPACE_ALLOWED=2
ENFORCE_STORAGE_CONSTRAINT=true
TABLESPACE_ENCRYPTION_ALGORITHM=None
PDBAAS_CUSTOM_POST_SCRIPTS_URN=oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:0008270085383BBDE0535C56F20AB27E:0.5
PDB_SID_PREFIX=PDB
PDB_ADMIN_USER_NAME=oracle
PDB_SERVICE_NAME_PREFIX=svc_pdbps1
PDBSERVICE_NAME=svc_pdbps1
ROLE_OPTION=CUSTOM_NEW_ROLE
INIT_PARAMS=*.open_cursors=300,*.cursor_sharing=EXACT
CUSTOM_ROLE_NAME=PDBAAS_JUN_12_2014_23_16_PM
CUSTOM_ROLE_DESC=New db role to be assigned to pluggable database administrator.
PRIVILEGES=CREATE SESSION,ALTER SESSION,CREATE DIMENSION,CREATE INDEXTYPE,CREATE ANY OPERATOR,CREATE ANY PROCEDURE,CREATE ANY SEQUENCE,CREATE ANY INDEX,CREATE JOB,CREATE ANY MATERIALIZED VIEW,CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY
DB_ORACLE_HOME_LOC=/scratch/12c_rdbms/product/12.1.0/dbhome_1
COMMON_DB_SID=CDB06
PDB_NAME=pdbps1
PDB_CONNECT_STRING=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=xx.example.com)(PORT=1531)))(CONNECT_DATA=(SERVICE_NAME=svc_pdbps1)(INSTANCE_NAME=CDB06)(UR=A)(SERVER=DEDICATED)))
CDB_CONNECT_STRING=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=xx.example.com)(PORT=1531)))(CONNECT_DATA=(SID=CDB06)))

24.1.3.8 サンプルPDBaaS後処理スクリプト

この項では、PerlとSQLのPDBaaS用サンプル・スクリプトを示します。

例24-5 サンプルPDBaaS Perlスクリプト

use Getopt::Long;
use File::Path;
use File::Spec;

#Store the passed input file path in a variable
my $fileName = $ARGV[0];

#Print the input file content as it is...
print "Printing the variable values received from cloud request ...\n";
open IN,"<",$fileName or die "Can't open file due to :$!";
while(<>){
print $_;
}
close IN;

#Reads a text file with var=values pairs line delimited
#Setting the values in the environment
sub readDat {
#Grab the passed parameter
my $filename = $_[0];
my @Data;

#The ubiquitous $i counter
my $i = 0;

#Register a filehandle
local (*DATFILE);

#Open the file for read
open (DATFILE, $filename) or print ( "Can't open $filename: $1");

#Read through the file one line at a time
FORA:while (<DATFILE>) {

#Skip over any comments
if ( /#.*/ ) {
next FORA;
}

#Clean up any extraneous garbage
chomp;
# no newline
s/^\s+//;
# no leading white
s/\s+$//;
# no trailing white

#                If clean up eliminated any data worth reading

#l       ets skip to the next line
next unless length;

#                        We can't load the lines with $VARS as we will
#loose any values so we'll make sure to escape them
#(the $'s that is)
s/\$/\\\$/g;

#localizing $var and $value to make sure
# they are clean out on every read.
my ($var, $value) = split(/=/,$_);

#                                        Load variable into enviroment
$ENV{$var}="$value";

$i++;
}

}
print "Loading custom variables into ENV..\n";
readDat("custom_sample_variables.txt");
print "Print custom variables...\n";
print "VAR1=" . $ENV{'VAR1'} . "\n" ;
print "VAR2=" . $ENV{'VAR2'}  . "\n";
print "VAR3=" . $ENV{'VAR3'}  . "\n";

print "Loading cloud variables into ENV..\n";
readDat($fileName);

my $service_name="$ENV{'COMMON_DB_SID'}";
$ENV{"ORACLE_HOME"}="$ENV{'DB_ORACLE_HOME_LOC'}";

#find sid by parsing pmon process.
my $pmon_ora = ".*pmon_".$service_name.".*";
my $process = `ps -eaf |grep $pmon_ora |grep -v grep`;
chomp($process);
my $sid = ( split "pmon_", $process )[ -1 ];

$ENV{"ORACLE_SID"}= $sid;

print "Executing attached SQL ...\n";
my $CMD = $ENV{"ORACLE_HOME"} . "/bin/sqlplus / as sysdba \@sample.sql $ENV{\"PDB_NAME\"}";

print "Firing SQL ...\n";
print "$CMD\n";
system($CMD);
my $ERROR_CODE = $?;
print "Error code is $ERROR_CODE \n";
if ( $ERROR_CODE == 0 )
{
print "Script Completed\n";
}
else
{
print "Error occured while executing \n";
}

例24-6 サンプルPDBaaS SQLスクリプト

alter session set container=&1;
REM --- you custom sql goes here ---
select name, con_id from v$pdbs;
exit;

例24-7 サンプルPDBaaS RACスクリプト

alter session set container=&1;
REM --- you custom sql goes here ---
select name, con_id from gv$pdbs;
exit;

第IX部

Middleware as a Serviceの設定

この項では、WebLogic as a Service (WLaaS)、SOA as a Service (SOAaas)およびOSB as a Service (OSBaaS)の各サービス・タイプを設定および使用する方法について説明します。次の章で構成されます。

- 第25章「WebLogicセルフ・サービス・ポータルの設定」

- 第26章「SOAaaSまたはOSBaaSセルフ・サービス・ポータルの設定」

- 第28章「MWaaSセルフ・サービス・ポータルの使用」

25 WebLogicセルフ・サービス・ポータルの設定

この章では、WebLogic as a Serviceのミドルウェア・セルフ・サービス・ポータルを設定する手順について説明します。内容は次のとおりです。

- WebLogicセルフ・サービス・ポータルの設定

- ミドルウェア・プールの作成

- リクエスト設定の構成

- ロード・バランサ構成の作成

- 割当て制限の設定

- WebLogicサービス・テンプレートの作成

- チャージバックの構成

25.1 WebLogicセルフ・サービス・ポータルの設定

EM_SSA_ADMINISTRATORは、ミドルウェア・プールの作成、割当て制限の設定、リクエスト設定の定義、ロード・バランサの構成、サービス・テンプレートの作成およびチャージバックの構成により、WebLogicクラウド・セルフ・サービス・ポータルを構成および設定できます。

図25-1のダイアグラムは、WebLogicミドルウェア・セルフ・サービス・ポータルの設定に含まれる様々なエンティティの初期設定およびそれらの関連性を示しています。

図25-1 WebLogic as a Serviceの設定

前提条件

- 1つ以上のPaaSインフラストラクチャ・ゾーンを作成しておく必要があります。詳細は、第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

WebLogic as a Serviceを設定するには、次の手順に従います。

1. 1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。詳細は、第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

2. ミドルウェア・プールを作成します。第25.2項「ミドルウェア・プールの作成」を参照してください。

3. オプションで外部ロード・バランサを構成できます。第25.3項「ロード・バランサ構成の作成」を参照してください。

4. リクエスト設定を構成します。第25.4項「リクエスト設定の構成」を参照してください。

5. 各セルフ・サービス・ユーザー・ロールの割当て制限を定義します。第25.5項「割当て制限の設定」を参照してください。

6. サービス・テンプレートを作成します。選択した一連のゾーンで、サービスのインスタンスのプロビジョニングに使用可能なサービス・テンプレートを作成できます。第25.6項「WebLogicサービス・テンプレートの作成」を参照してください。

7. オプションで、チャージバック・サービスを構成できます。第25.7項「チャージバックの構成」を参照してください。

25.2 ミドルウェア・プールの作成

ミドルウェア・プールには、PaaSインフラストラクチャ・ゾーン内にサービス・インスタンスをプロビジョニングする際に使用できる一連のリソースが含まれています。

注意:
ミドルウェア・プールは、物理フローのシナリオでMWaaSを設定する場合のみ構成する必要があります。第25.1項「WebLogicセルフ・サービス・ポータルの設定」を参照してください。

ミドルウェア・プールを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。特定のサービス・ファミリを設定する前に実行する必要がある一般的なタスクが表示されます。左パネルのミドルウェア・サービス・ファミリの横の「設定」リンクをクリックします。

4. サービス・タイプのドロップ・ダウン・リストから「Weblogic」を選択します。

5. 「ミドルウェア・プール」をクリックします。既存のミドルウェア・プールがミドルウェア・プール・ページにリストされます。

6. 「作成」をクリックします。ミドルウェア・プールの作成: 一般ページが表示されます。ミドルウェア・プールの名前および説明を入力します。ミドルウェア・プールを作成するPaaSインフラストラクチャ・ゾーンを選択します。
注意: 「クラウド・ホーム」メニューから「リソース・プロバイダ」を選択して、このページに移動することもできます。リソース・プロバイダ・ホームページが表示されます。「作成」をクリックし、作成するリソース・プロバイダのタイプとして「ミドルウェア・プール」を選択して、ミドルウェア・プールの作成ウィザードを起動します。

図25-2 ミドルウェア・プールの作成: 一般

7. 次をクリックします。メンバー・ページで、次の指定をします。

- Exalogic: すべてのメンバー・ホストのターゲットがExalogic上にある場合は「はい」を選択します。

- 複数ラックのExalogicですか。: ホストがExalogicにあるとき、ホスト・ターゲットが複数のExalogicラックのものである場合は「はい」を選択します。これにより、ラック全体で高可用性を実現できます。

- オペレーティング・システムおよびプラットフォーム: オペレーティング・システムおよびプラットフォームを指定します。

8. 「追加」をクリックし、1つ以上のホストをミドルウェア・プールに追加します。「次」をクリックします。

9. ミドルウェア・プールの作成: 配置制約ページが表示されます。配置制約を使用して、各ホストのリソース使用率の最大限度を設定します。「Javaサーバーの最大数(1ホスト当たり)」フィールドに、プール内の各ホストで実行可能なJavaサーバー・インスタンスの最大数を入力します。次をクリックします。

注意:
共有Oracleホームを使用している場合、$WL_HOME/common/libディレクトリで書込み権限が有効であることを確認します。これは、WebLogic Serverバージョン12.1.1以前に適用されます。

10. 「特性」リージョンで、次を指定します。

- ドメイン・ホームのベース・ディレクトリ: これは必須フィールドです。このミドルウェア・プールでプロビジョニングされたドメインまたはインスタンスが配置されるベース・ディレクトリを指定します。

- ミドルウェア・ホームのベース・ディレクトリ: これは必須フィールドです。Oracleホームが作成されるディレクトリを指定します。Oracleホームは、同じタイプおよびバージョンのサービス間で共有されます。

- 共有Oracleホーム: このフィールドを「はい」に設定すると、このミドルウェア・プールのすべてのホストは、他のOracleホームがこれらのホストに存在してもこの共有Oracleホームを使用します。

11. 「ターゲット・プロパティ」リージョンで、ターゲットのプロパティのタグ付けと識別に使用される特性を指定します。次をクリックします。

12. 情報を確認し、「発行」をクリックしてミドルウェア・プールを作成します。新しく作成されたミドルウェア・プールをミドルウェア・サービス・テンプレートの作成に使用できます。

25.3 ロード・バランサ構成の作成

Oracle HTTP Server (バージョン11xがサポートされますが、11g PS6の使用を推奨)、Oracle Traffic Director (バージョン11xがサポートされますが、OTD 11x PS6の使用を推奨)またはサード・パーティのロード・バランサなど、事前構成された外部ロード・バランサを構成できます。

注意: 11g PS6の管理対象または同一配置のOHSロード・バランサを使用する場合、管理/MBeanインタフェースを通じて変更が行われていないことを確認する必要があります。as-a-serviceソリューションでは、ファイル・システムのOHSファイルを直接変更するため、同一配置されたOHSでの変更は、管理サーバーにレプリケートされない可能性があります。また、管理インタフェース(MBeanやWLSTなど)を通じて行われた変更は、*.confファイルに直接行われた変更をオーバーライドする可能性があります。

サード・パーティのロード・バランサを構成する場合、カスタム・スクリプトを使用して、ロード・バランサ構成を更新する必要があります。このスクリプトの詳細は、第25.3.1項「カスタム・スクリプトの作成」を参照してください。ミドルウェア・プールまたはデプロイメント・プランは、1つのロード・バランサ構成のみに関連付けることができます。

注意:
ロード・バランサ構成を設定する手順は、オプションです。

前提条件

- 構成されるOTDおよびOHSロード・バランサは、Enterprise Managerの監視対象ホスト上にインストールする必要があり、Webトラフィックを1つ以上のMWaaSサービス・インスタンスにルーティングするために使用します。MWaaSサービス・インスタンスを作成、更新(スケール・アップまたはスケール・ダウン)または削除すると、ロード・バランサ構成は自動的に更新されます。

- HTTPS Webトラフィックをルーティングするには、次を実行する必要があります。

- OTD構成の作成(Oracle Traffic Directorタイプのロード・バランサを構成する場合にのみ必要)。

- 証明書の作成またはインストール。

SSL認証の詳細は、Oracle Traffic Director管理者ガイドおよびOracle HTTP Server管理者ガイドを参照してください。

ロード・バランサを構成するには、次の手順に従います:

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。特定のサービス・ファミリを設定する前に実行する必要がある一般的なタスクが表示されます。左パネルのミドルウェア・サービス・ファミリの横の「設定」リンクをクリックします。

注意:
別のナビゲーション・パスを使用してこのページにアクセスすることもできます。「クラウド・ホーム」メニューから、「設定」、「サービス設定」の順に選択し、「ミドルウェア」をクリックします。

4. サービス・タイプのドロップ・ダウン・リストから「WebLogic」を選択し、「ロード・バランシング構成」リンクをクリックします。

5. 「作成」をクリックして、新規ロード・バランサ構成を作成します。

図25-3 ロード・バランサ構成: 一般

6. 次の詳細を入力します。

- ロード・バランサ構成の名前。

- 構成されるロード・バランサのタイプを選択します。これは、Oracle HTTP Server (OHS)、Oracle Traffic Director (OTD)またはサード・パーティのロード・バランサです。

- OHSおよびOTDを使用する場合、ロード・バランサがインストールされるホストを選択します。これは、Enterprise Managerの監視対象のホストである必要があります。OTDロード・バランサを使用する場合、ここでOTD 11g管理サーバーを入力する必要があります。
注意: 別のサード・パーティのロード・バランサを使用する場合、そのロード・バランサをローカルまたはリモートで構成できるホストを選択します。

- ルーティング・プロトコル(HTTPまたはHTTPS、あるいはその両方)とフリー・ルーティング・ポート範囲を指定します。

- 監視エージェント(管理エージェント)を選択し、名前付き資格証明を指定します。

注意:

- OTDとOHSでは、OTD/OHSロード・バランサ・インスタンスが実行されている同じホスト上に監視エージェントが存在する必要があります。サード・パーティのロード・バランサでは、ロード・バランサが構成されるホスト上に監視エージェントが存在する必要があります。

- サード・パーティのロード・バランサでは、ロード・バランサが実行されている同じホスト上に監視エージェントは存在できません。この場合、カスタム・スクリプトを実行してサード・パーティのロード・バランサにアクセスしたりそれを構成できる、他のホストで使用可能な他の任意の監視エージェントを選択できます。

7. 次をクリックします。ロード・バランサ構成の作成: プロパティ・ページが表示されます。

図25-4 ロード・バランシング構成の作成: プロパティ

「ロード・バランサ・タイプ」を選択した場合の指定は、次のとおりです:

- Oracle HTTP Server: 次の詳細情報を入力します。

- インスタンス・ホーム: Oracle HTTP Serverインスタンスに関連する構成データとバイナリ・ファイルが格納されるディレクトリ。

- コンポーネント名: 構成対象の特定のインスタンスのコンポーネント。

- Oracle Traffic Director: 次の詳細情報を入力します。

- Oracleホーム: Oracle Traffic Directorバイナリがインストールされているディレクトリ。

- 管理プロトコル: リクエストを転送するために、Oracle Traffic Directorの管理サーバーで使用されるプロトコル(HTTPまたはHTTPS)を指定します。デフォルトでは、これはHTTPSです。

- 管理リスニング・ポート: 管理サーバーのリスニング・ポート番号を指定します。

- SNMPポート: Oracle Traffic Directorに構成されているSNMPポート。デフォルトのポート番号は11161です。

- インスタンス・ノード: Oracle Traffic Directorインスタンス・ノード名を指定します。

- 構成名: このフィールドはオプションであり、「ロード・バランサ構成: 一般」セクションの「ルーティング・プロトコル」としてHTTPSまたはHTTP_HTTPSを選択した場合のみ必須です。HTTP管理プロトコルを選択し、このフィールドで値を指定しない場合、「OTD構成名」がデフォルトでconfig1として作成されます。OTD構成がすでに作成済である場合、Enterprise Managerの管理対象ターゲットである必要があります。
注意: HTTPプロトコルを選択する場合、OTD構成を手動で作成し、Enterprise Managerで管理対象ターゲットとして検出することをお薦めします。

- 証明書名: このフィールドはオプションです。「ロード・バランサ構成: 一般」セクションの「ルーティング・プロトコル」としてHTTPSまたはHTTP_HTTPSを選択した場合、自己署名証明書の名前を入力します。

- 仮想サーバー名: 仮想サーバーの名前。仮想サーバーが存在しない場合、ここで指定した名前の仮想サーバーが作成されます。このリリースでは、各仮想サーバーの構成でホスト・パターンは定義されていません。

- 特権名前付き資格証明: 管理サーバーの名前付き資格証明を指定します。

- サード・パーティ・ロード・バランサ: ロード・バランサを構成するスクリプトを選択します。このスクリプトは、ソフトウェア・ライブラリにアップロードされている必要があり、そのスクリプトの入力としてソフトウェア・ライブラリのディレクティブURNを指定する必要があります。

8. 次をクリックします。ロード・バランサ構成の作成: ターゲット・ページが表示されます。

9. 「追加」をクリックして、ロード・バランサが関連付けられる1つ以上のミドルウェア・プール(第25.2項「ミドルウェア・プールの作成」参照)を追加します。

注意:
ミドルウェア・プールは、1つのロード・バランサ構成のみに関連付けることができます。

10. 次をクリックします。構成を確認し、「発行」をクリックしてロード・バランサ構成を作成します。新しく作成したロード・バランサ構成が、ロード・バランシング構成表に表示されます。ロード・バランサ構成の詳細を表示するには、表内の「ロード・バランサ名」リンクをクリックします。ロード・バランサ構成およびその構成を使用しているミドルウェア・サービス・インスタンスに関連付けられたターゲットが表示されます。

25.3.1 カスタム・スクリプトの作成

カスタム・スクリプトを使用して、ロード・バランサを構成できます。このスクリプトは、ソフトウェア・ライブラリにディレクティブとして存在する必要があります。ディレクティブは次のガイドラインに従う必要があります:

- LBR_WORK_DIRECTORY: lbr.propertiesファイルのステージング先となるディレクトリを指定します。lbr.propertiesファイルに存在する名前/値ペアがカスタム・スクリプトにより抽出され、これらの値はロード・バランサの構成に使用されます。

- 次のプロパティがlbr.propertiesファイル内にある必要があります。

- THIRDPARTY_ROUTING_PROTOCOL: これは、HTTP、HTTPSまたはHTTP_HTTPSのいずれかです。

- HTTP_PORT_RANGE: HTTPプロトコルの場合に構成に使用できるポートの範囲(ハイフン「-」区切り)。たとえば、5000-6000です。

- HTTPS_PORT_RANGE: HTTPSプロトコルの場合に構成に使用できるポートの範囲(ハイフン「-」区切り)。たとえば、7000-8000です。

- LBR_HOST: ロード・バランサがインストールされているホスト。

- UNIQUE_URI_REFERENCE: これは、一意の値であるサービス・インスタンスIDです。これは、サービス・インスタンスにマップされます(WebLogicドメイン)。必要に応じて、仮想サーバーやルートなどのエンティティを一意に識別するために使用できます。

- CONFIGURATION_ACTION: 実行できるアクションは次のとおりです:

- CREATE: サービス・インスタンスを作成します。

- ADD_SERVERS: 1つ以上のサーバーをスケール・アップまたは追加します。

- DELETE_SERVERS: 1つ以上のサーバーをスケール・ダウンまたは削除します。

- REMOVE: サービス・インスタンスを削除します。

- HTTP_WLS_MANAGED_SERVER_PORT_LIST: portがhttpポートである、カンマ区切りのhost:port(管理対象サーバー)リストです。たとえば、abc:123、xyz:456など。

- HTTPS_WLS_MANAGED_SERVER_PORT_LIST: portがSSLポートである、カンマ区切りのhost:port (管理対象サーバー)リストです。たとえば、abc:123、xyz:456など。

25.3.1.1 サンプル・スクリプト(Oracle Cloud Application 12.1.0.8以前)

このサンプル・スクリプトは、Oracle Cloud Applicationプラグインの12.1.0.8以前のバージョンを使用している場合に利用できます。

例25-1 サンプル・スクリプトI

#!/usr/bin/perl
use File::Path;
#use File::Spec();
use File::Spec;
use Cwd;

my $dir = getcwd();
my $WORK_DIR = $ARGV[0];

print "The Input Parameters to the Third Party Script are as follows : "."\n";
print "lbrWorkDirectory = ".$WORK_DIR."\n";
print "======================================================================"."\n";
print "The lbr.property file contents accessible to this script are as follows "."\n";
my $textfile = "lbr.properties";

my @prop;
chdir($WORK_DIR) or die "Can't chdir to $WORK_DIR $!";
#Create Hash from properties
open FILE, "<$textfile" or die("Could not open text file '" . $textfile . "': $!");
my %hash;
while ($line4 = <FILE>)
{
chomp($line4);
my ($key, $val) = split(/=/,$line4);
print $key."= ".$val."\n";
$hash{$key}=$val;
}
close FILE;
print "======================================================================"."\n";
my $ACTION          = $hash{'CONFIGURATION_ACTION'};
if ( $ACTION eq "CREATE" ) {
print " The Configuration Action is Create \n";
} elsif ( $ACTION eq "ADD_SERVERS" ) {
print " The Configuration Action is Scale Up \n";
} elsif ( $ACTION eq "DELETE_SERVERS" ) {
print " The Configuration Action is Scale Down \n";
} elsif ( $ACTION eq "REMOVE" ) {
print " The Configuration Action is Remove \n";
} else {
print " Unsuppported Configuration Action".$ACTION."\n";
}
print "======================================================================"."\n";
#
# logic to configure the LBR goes here
#

25.3.1.2 サンプル・スクリプト(Oracle Fusion Middleware 12.1.0.7以降)

このサンプル・スクリプトは、Oracle Fusion Middlewareプラグインの12.1.0.7以降のバージョンを使用している場合に利用できます。

例25-2 サンプル・スクリプト II

#!/usr/bin/perl
use File::Path;
#use File::Spec();
use File::Spec;
use Cwd;

my $dir = getcwd();
my $WORK_DIR = $ARGV[0];

print "The Input Parameters to the Third Party Script are as follows : "."\n";
print "lbrWorkDirectory = ".$WORK_DIR."\n";
print "======================================================================"."\n";
print "The lbr.property file contents accessible to this script are as follows "."\n";
my $textfile = "lbr.properties";

my @prop;
chdir($WORK_DIR) or die "Can't chdir to $WORK_DIR $!";
#Create Hash from properties
open FILE, "<$textfile" or die("Could not open text file '" . $textfile . "': $!");
my %hash;
while ($line4 = <FILE>)
{
chomp($line4);
my ($key, $val) = split(/=/,$line4);
print $key."= ".$val."\n";
$hash{$key}=$val;
}
close FILE;

print "TP OUTPUT:FRONT_END_HOST_VALUE=example.host.com#FRONT_END_HTTP_PORT_VALUE=9000#FRONT_END_HTTPS_PORT_VALUE=9090#URI_PREFIX=app1#"."\n";
#
# logic to configure the LBR goes here
#

print "======================================================================"."\n";

注意:
Oracle Fusion Middleware 12.1.0.7以降を使用している場合、スクリプトは次のガイドラインを満たす必要があります。

- 構成が正常に完了した後に、コマンド・ステータス0 (ゼロ)でプログラムを終了する必要があります。

- 構成に失敗した場合、ゼロ以外のコマンド・ステータスでプログラムを終了する必要があります。

- 次の情報を示されているとおりの書式で出力します。
print "TP OUTPUT:FRONT_END_HOST_VALUE=<host-name>#FRONT_END_HTTP_PORT_VALUE=<http_port>#FRONT_END_HTTPS_PORT_VALUE=<https_port>#URI_PREFIX=<uri-prefix-if-applicable>#"."\n";

25.3.2 ソフトウェア・ライブラリへのサード・パーティLBR構成の追加

ソフトウェア・ライブラリにディレクティブとしてサード・パーティLBR構成スクリプトを追加するには、次の手順に従います。

1. 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」→「ソフトウェア・ライブラリ」を選択します。

2. 「アクション」メニューから「エンティティの作成」を選択し、「ディレクティブ」をクリックしてエンティティの作成: ディレクティブ・ウィザードを起動します。

3. 「説明」ページで、名前と説明を入力します。次をクリックします。

4. 「構成」ページで、「追加」をクリックして、ディレクティブを構成するために使用するコマンドライン引数を指定します。「コマンドライン引数の追加」ダイアログ・ボックスが表示されます。

5. 「コマンドライン引数の追加」ダイアログ・ボックスで、「プロパティ名」フィールドにLBR_WORK_DIRECTORYを入力し、他の2つのフィールド(「引数の接頭辞」および「引数の接尾辞」フィールド)は空白のままにします。

図25-5 「ソフトウェア・ライブラリ: 構成」ページ

6. 「構成プロパティ」セクションで、スクリプトに定義されている「Bash」または「Perl」を選択します。次をクリックします。

7. ファイルの選択ページで、エンティティに関連付ける1つ以上のファイルを選択できます。「ファイルのアップロード」を選択し、「アップロード場所」を選択します。

8. 「ソースの指定」セクションで、「ローカル・マシン」を選択し、「追加」をクリックします。「ファイルの追加」ダイアログ・ボックスで、「参照」をクリックしてソースの場所からサード・パーティLBR構成スクリプト・ファイルを選択し、一意の名前を指定して「OK」をクリックします。

図25-6 「ソフトウェア・ライブラリ: ファイルの選択」ページ

9. 「確認」ページで、すべての詳細を確認して「保存とアップロード」をクリックし、ディレクティブを作成してそれをソフトウェア・ライブラリにアップロードします。
これで、サード・パーティLBR構成スクリプトがディレクティブとしてソフトウェア・ライブラリに配置されました。このディレクティブは、ロード・バランサ構成の作成ページで、サード・パーティのディレクティブURNパラメータとして選択できます。ソフトウェア・ライブラリ・ディレクティブの作成の詳細は、『Enterprise Manager Cloud Control管理者ガイド』を参照してください。

注意:
複数のサービス(WLaaS、SBaaSまたはSOAaaS)でサード・パーティのロード・バランサを使用する場合、サービス・タイプごとに一意のIDが維持されるように、次のプロパティを設定する必要があります。

- SVC_INST_ID: 一意のサービス・インスタンスID。

- SVC_Name: サービスの名前。

25.4 リクエスト設定の構成

リクエストできる時間やその期間などを指定することにより、リクエスト設定を構成できます。リクエスト設定を構成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。特定のサービス・ファミリを設定する前に実行する必要がある一般的なタスクが表示されます。左パネルのミドルウェア・サービス・ファミリの横の「設定」リンクをクリックします。

注意:
別のナビゲーション・パスを使用してこのページにアクセスすることもできます。「クラウド・ホーム」メニューから、「設定」、「リクエスト設定」、ミドルウェアの順に選択し、「Weblogic」をクリックします。

4. サービス・タイプのドロップ・ダウン・リストから「Weblogic」を選択し、「リクエスト設定」をクリックします。

5. 次のパラメータを指定して、特定のロールのグローバル設定または設定を設定できます。

- 将来の予約: どの程度先までリクエストを作成できるか。

- リクエスト期間: サービスが存在できる最大期間。

- アーカイブ・ポリシー: アーカイブ済のリクエストが自動的に削除されるまでの最長継続時間。

- サービス・インスタンス承認: すべてのリクエストがセルフ・サービス管理者によって承認される必要がある場合には、このチェックボックスを選択します。

- サービス・インスタンス共有設定: サービス・インスタンスは別のユーザーまたはロールと共有できます。次のいずれかまたは両方のチェックボックスを選択できます。

- SSAユーザーを有効にして、サービス・インスタンスを他のユーザーと共有します。

- SSAユーザーを有効にして、サービス・インスタンスをロールと共有します。

これらのパラメータの設定方法の詳細は、第11.2.3項「リクエスト設定の構成」を参照してください。

6. 「適用」をクリックします。

25.5 割当て制限の設定

割当て制限は、特定のロールに属するセルフ・サービス・ユーザーそれぞれに許可されているリソース量の集計です。この割当て制限は、ミドルウェア・セルフ・サービス・ポータルを介してプロビジョニングされたサービス・インスタンスにのみ適用されます。プロビジョニングされた各サービス・インスタンスは、新規サービス・リクエストおよび既存のサービス・インスタンスのスケール・アップを含めて、セルフ・サービス・ユーザーに適用される割当て制限の対象です。使用量が自分の割当て制限に到達したセルフ・サービス・ユーザーは、より高い割当て制限が割り当てられるか、既存のサービス・インスタンスを解放するまで、新しいサービス・リクエストを作成できません。

割当て制限を定義するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

注意:
別のナビゲーション・パスを使用してこのページにアクセスすることもできます。「クラウド・ホーム」メニューから、「設定」、「割当て制限」の順に選択し、「ミドルウェア」をクリックします。

3. 「ミドルウェア・サービス・ファミリ」の横の「設定」リンクをクリックして、ドロップ・ダウン・リストからWebLogicサービス・タイプを選択します。

4. 「割当て制限」リンクをクリックし、「作成」をクリックします。

注意:
割当て制限の検証により、ユーザーの現在の使用量がそのユーザーが属するロールに指定された制限内に収まる場合にのみ、リクエストの実行が保証されます。直接指示されたロールのみが割当て制限の判断の対象となり、ネストされているロールは対象外です。

5. 「割当て制限の作成」ウィンドウで、割当て制限を許可する「ロール名」を選択します。次のようにして、ロールの割当て制限を指定します。

- メモリー: 特定のユーザーが所有するインスタンスに割当て可能な最大メモリー。

- Javaサーバー: 任意の時点でユーザーが所有できるJavaサーバーの数。

- Oracle JVM以外の数: Oracle JVM以外の数を指定します。

注意:
クラウド・セルフ・サービス・ポータル権限を持っているユーザー(EM_SSA_USER_BASEロールに属しているユーザー)のみが「ロールの選択」ダイアログ・ボックスに表示されます。

25.6 WebLogicサービス・テンプレートの作成

サービス・テンプレートを使用して、サービスのインスタンスを、選択したPaaSインフラストラクチャ・ゾーンのセットにプロビジョニングできます。

前提条件

- 第13.3項「Middleware as a Serviceの開始」の説明に従って、MWaaSを設定および有効化します。

- PaaSインフラストラクチャ・ゾーンを作成しておく必要があります。

- 適切な値を含むWebLogicドメインのプロビジョニング・プロファイル(第13.3.1.1項「WebLogicドメインのプロビジョニング・プロファイルの作成」を参照)がソフトウェア・ライブラリに存在する必要があります。

- ミドルウェア・プールを作成しておく必要があります。

- 名前付き資格証明を作成する必要があり、サービス・テンプレートを作成するユーザーは、名前付き資格証明の所有者である必要があります。

注意:
アクティブ・インスタンスを持つサービス・テンプレートを編集し、構成パラメータを変更できます。サービス・テンプレートが変更された場合:

- 変更が加えられた後に作成された新しいインスタンスでは、新しいパラメータが使用されます。

- 古いインスタンスまたはテンプレートが変更される前に作成されたインスタンスでは、以前の値が使用されます。

- ゾーンとロールに加えられた変更は、古いインスタンスと新しいインスタンスの両方に適用可能です。

WebLogicサービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。

注意:
別のナビゲーション・パスを使用してこのページにアクセスすることもできます。「Oracleホーム」メニューから「サービス・テンプレート」を選択し、「作成」をクリックして「Weblogic」サービス・タイプを選択します。

3. 「ミドルウェア・サービス・ファミリ」の横の「設定」リンクをクリックして、ドロップ・ダウン・リストから「Weblogic」サービス・タイプを選択します。

4. 「サービス・テンプレート」リンクをクリックします。選択した一連のゾーンで、サービスのインスタンスのプロビジョニングに使用可能なサービス・テンプレートを作成できます。「作成」をクリックします。

5. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

6. 「プロビジョニング・プロファイル」フィールドで、「検索」アイコンをクリックしてWebLogicドメインのプロビジョニング・プロファイルを選択します。選択したWebLogicドメインのプロビジョニング・プロファイルには、次のいずれかを含めることができます。

- 1つ以上のWebLogic Serverを持つ1つのクラスタ。このクラスタに対してWebLogicサーバーを追加または削除することで、スケールアップまたはスケールダウンできます。

- 1つのWebLogic Server。この場合、「スケール・アップ」および「スケール・ダウン」オプションは使用できません。

7. 次をクリックします。

図25-7 WebLogicサービス・テンプレートの作成: 特性

「サービス特性」リージョンで、次を指定します。

- 異なるExalogicラックからホストにサービス・インスタンスのWebLogic Serverを分散しますか。: サービス・インスタンスのWebLogic Serverが使用可能なExalogicラックで均一に分散される場合、「はい」を選択します。ホストを使用可能な最初のラックに配置する場合は、「いいえ」を選択します。

- 使用可能なホストに負荷を分散させますか。: WebLogic Serverが使用可能なホストで均一に分散される場合、「はい」を選択します。「いいえ」を選択すると、最大許容数のサーバーが最初に使用可能なホストにプロビジョニングされ、その後で他のホストにプロビジョニングされます。

- ロード・バランサの有効化: このサービス・テンプレートで作成されるすべてのサービス・インスタンスに対してロード・バランサ構成を有効にするには、「はい」を選択します。

注意:
「サービス特性」リージョンの選択内容に基づいて、関連するミドルウェア・プールが表示されます。

- SSAユーザーに拡張設定を公開しますか。: 「はい」に設定すると、セルフ・サービス・ユーザーは、オペレーティング・システム、他のSSAユーザーとのサービス・インスタンスの共有の有効化、モニタリング・テンプレート用のターゲット・プロパティの設定などの拡張オプションにアクセスできます。

- WebLogic管理コンソールおよびFusion Middleware ControlをSSAユーザーに公開: 「はい」を選択すると、EM_SSA_USERロールを持つユーザーは、このサービス・テンプレートを使用して作成された各サービス・インスタンスについて、WebLogic管理コンソールおよびFusion Middleware Controlへのアクセス権を持ちます。

注意:
EM_SSA_USERがWebLogic ServerおよびFusion Middleware Controlコンソールを完全に制御する必要がある場合にのみ、このフィールドを「はい」に設定してください。EM_SSA_USERは、各コンソールからすべての構成の変更とライフサイクル管理操作を実行できるようになります。

- JRF対応のプロファイルですか。: 選択されたプロファイルがJRFに対応しているかどうかを示します。WebLogic Server 12.1.2および12.1.3インスタンスで「はい」に設定すると、セルフ・サービス・ユーザーがサービスをリクエストするときにデータベース接続文字列とスキーマ・パスワードを求められます。接続文字列を指定する対象となるデータベースは、ソース・プロファイルのクローンである必要があります。
セルフ・サービス・ユーザーは、DBaaS RMANバックアップ・オプションを使用してクローニングされたデータベースを使用するか、DBaaS以外でクローニングされたがEnterprise Managerで検出されたデータベースを使用できます。後者のオプションの場合、データベースの検出後に、データベース・ターゲットに対する表示権限をセルフ・サービス・ユーザーに付与する必要があります。

注意: JRF対応プロファイルは非JRF WebLogicドメインの作成には使用できません。このフィールドの値が「はい」に設定されている場合、それを変更しないことをお薦めします。

8. 「ターゲット・プロパティ」リージョンで、ターゲットのプロパティのタグ付けと識別に使用される特性を指定します。テンプレートから作成されたサービス・インスタンスには特性があります。

9. 次をクリックします。ミドルウェア・サービス・テンプレートの作成: リソース・プロバイダ・ページで「追加」をクリックして、サービス・インスタンスをプロビジョニングするミドルウェア・プールを選択します。ミドルウェア・プールが関連付けられているPaaSインフラストラクチャ・ゾーンが表示されます。

10. 次をクリックします。「構成」ページが表示されます。

図25-8 WebLogicテンプレートの作成: 構成

次の詳細を入力します。

- WebLogic管理資格証明:

- WebLogicユーザー名: Weblogic Serverにログインするユーザーの名前として8文字以上の値を入力します。必須フィールドです。

- WebLogicパスワード: Weblogic Serverユーザーのパスワードとして8文字以上の値を入力します。必須フィールドです。

- Javaホームの場所: Javaホームの絶対パスを指定します。このフィールドを指定する必要があるのは、前に選択した「WebLogicドメインのプロビジョニング・プロファイル」にミドルウェア・ホーム・バイナリが含まれる場合です。

- 前処理および後処理スクリプト

- サービス・インスタンスの前処理スクリプト: サービス・インスタンスの作成、削除、スケールアップまたはスケールダウンの前に実行する必要があるスクリプトを選択します。

- サービス・インスタンスの後処理スクリプト: サービス・インスタンスの作成、削除、スケールアップまたはスケールダウンの後に実行する必要があるスクリプトを選択します。

- スクリプト実行用の外部ホスト: これらのスクリプトを実行する必要がある外部ホストを指定します。

- 外部ホストでスクリプトを実行するための名前付き資格証明: 外部ホストでスクリプトを実行するために使用される資格証明を指定します。

- 管理サーバー・ホストでスクリプトを実行: スクリプトが管理サーバー・ホストで実行される場合、「はい」を選択します。

- 管理対象サーバー・ホストでスクリプトを実行しますか。: スクリプトが管理対象サーバー・ホストで実行される場合、「はい」を選択します。

注意:
管理サーバー・ホストと管理対象サーバー・ホストでこれらのスクリプトを実行するためにはゾーン・レベルの資格証明が使用されます。

スクリプトは、次のガイドラインを満たしている必要があります。

- 作成するディレクティブはPERLディレクティブである必要があります。

- INPUT_FILE_LOCATIONという名前の入力パラメータを定義する必要があります。

- プロパティ・ファイルの場所のパスは、INPUT_FILE_LOCATIONパラメータで指定する必要があります。

- プロパティ・ファイルには、サービス・インスタンスおよびドメインの情報が含まれています。

サンプル・スクリプト・ファイル、プロパティ・ファイルおよび生成される出力については、第25.6.1項「サンプル後処理スクリプト」を参照してください。

- サービス設定:

- トポロジ: このフィールドは、物理用ミドルウェア・サービス・テンプレートの作成: 一般ページで選択したプロファイルに基づいて自動的に設定されます。

- ポート範囲(開始 - 終了): WebLogicサーバーのポート範囲を入力します。デフォルトの範囲の開始は1024で、範囲の終了は65000です。

- 配置パラメータ:

- インスタンス当たりのメモリー使用量: 追加のWebLogic Serverインスタンスのそれぞれに対して必要なメモリーを指定します。このパラメータは指定する必要があり(空白にはできません)、その値はプロファイルで指定された-Xmx値と一致する必要があります。たとえば、プロファイルで-Xmx512mを指定した場合、メモリーに必要な値に0.5を設定する必要があります。同様に、プロファイルの値が-Xmx1024mの場合、必要なメモリーの値は1となります。

- インスタンス当たりのCPU使用率: 追加のWebLogic Serverインスタンスのそれぞれに対して必要なCPUを指定します。

- サーバーの起動引数

- 管理対象サーバーの起動引数: 管理対象サーバーを起動するために必要なメモリーおよびJava引数を指定します。これらの引数は、JVMサーバーのメモリー・サイズを制御し、同じプロファイルを持つ複数のテンプレートを作成するために使用します。たとえば、-Xms1280m -Xmx1280m -XX:PermSize=128m -XX:MaxPermSize=256m -Dweblogic.security.SSL.ignoreHostnameVerification=trueと指定できます。
注意: 「SSAユーザーに拡張設定を公開しますか。」フラグが「True」に設定された場合、セルフ・サービス・ユーザーがサービスをリクエストするときにこれらの引数を変更できます。

- リソース管理スクリプト・パラメータ

- Resource Management Script: ミドルウェア・プールのサイズの増加または減少を可能にするリソースの動的管理用スクリプトを指定します。このスクリプトは、ソフトウェア・ライブラリにディレクティブとして存在する必要があります。

11. 次をクリックします。物理用ミドルウェア・サービス・テンプレートの作成: ロール・ページで「追加」をクリックし、このサービス・テンプレートを使用可能にするセルフ・サービス・ユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。

12. 次をクリックします。物理用ミドルウェア・サービス・テンプレートの作成: 確認ページが表示されます。これまでに入力した情報を確認し、「発行」をクリックします。新しく作成されたサービス・テンプレートが、ミドルウェア・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。「サービス・テンプレート名」リンクをクリックして、追加の詳細を表示できます。

既存のMWaaSサービス・テンプレートを編集するには、次の手順に従います。

1. サービス・テンプレート・ページで、「編集」クリックし、サービス・テンプレートの編集ウィザードを起動します。

2. このモードでは、プロビジョニングするWebLogic Serverインスタンスの説明、ユーザー名、パスワード、ポート範囲の変更、テンプレートをデプロイするPaaSインフラストラクチャ・ゾーン、ソフトウェア・プールの追加または削除、およびこのテンプレートを使用できるユーザーの追加または削除を行うことができます。

25.6.1 サンプル後処理スクリプト

このサンプル後処理スクリプトでは、プロパティ・ファイルの内容に加え、管理対象サーバーや管理サーバーなどの詳細が出力されます。

25.6.1.1 サンプル・プロパティ・ファイル

プロパティ・ファイルの内容は次のとおりです。

OPERATION= CREATE
SERVICE_INSTANCE= inst_01
DOMAIN_NAME= inst_01_SSA_USER1
DOMAIN_HOME= /middleware/inst_01_SSA_USER1
MW_HOME= /middleware
WLS_HOME= /middleware/wlserver_10.3
ADMIN_SERVER= example.com,27877,8142
MANAGED_SERVERS= example.com,13614,1488,4166;
EXTERNAL_HOSTS= example.com
EXECUTE_SCRIPTS_ON_ADMIN_SERVER_HOST=  Yes
EXECUTE_SCRIPTS_ON_MANAGED_SERVER_HOSTS=  Yes

25.6.1.2 サンプル・スクリプト

サンプル・スクリプトは次のとおりです。

#!/usr/bin/perl
use File::Path;
#use File::Spec();
use File::Spec;
use Cwd;

my $dir = getcwd();
my $inputFile = $ARGV[0];

print "Imput File Location = ".$inputFile."\n";
print "===================================================================="."\n";
print "The properties file contents accessible to this script are as follows "."\n";

my @prop;
#Create Hash from properties
open FILE, "<$inputFile" or die("Could not open text file '" . $inputFile . "': $!");
my %hash;
while ($line4 = <FILE>)
{
chomp($line4);
my ($key, $val) = split(/=/,$line4);
print $key."= ".$val."\n";
$hash{$key}=$val;
}
close FILE;
print "===================================================================="."\n";
my $ACTION = $hash{'OPERATION'};
if ( $ACTION eq "CREATE" ) {
print " This is Service Instance Creation Operation \n";
} elsif ( $ACTION eq "SCALEUP" ) {
print " This is Scale Up Operation \n";
} elsif ( $ACTION eq "SCALEDOWN" ) {
print " This is Scale Down Operation \n";
} elsif ( $ACTION eq "DELETE" ) {
print " This is Delete Service Instance Operation \n";
} else {
print " Unsuppported Configuration Action".$ACTION."\n";
}
print "===================================================================="."\n";

my $ADMIN_SERVER = $hash{'ADMIN_SERVER'};

print "======================Admin Server Details Begins==================="."\n";
my @fields = split (/,/, $ADMIN_SERVER);
my $arraySize = @fields;
if ($arraySize == 4) {
print "Admin Server Name is ".$fields[0]."\n";
print "Admin Server Host Name is ".$fields[1]."\n";
print "Admin Server NON SSL Port is ".$fields[2]."\n";
print "Admin Server SSL Port is ".$fields[3]."\n";
} else {
print "Admin Server Host Name is ".$fields[0]."\n";
print "Admin Server NON SSL Port is ".$fields[1]."\n";
print "Admin Server SSL Port is ".$fields[2]."\n";
}
print "======================Admin Server Details Ends===================="."\n";

print "\n";

print "======================Managed Server's Details Begins==============="."\n";
my $MANAGED_SERVERS = $hash{'MANAGED_SERVERS'};
my $managedServer;
my @noOfManagedServers = split (/;/, $MANAGED_SERVERS);
for ($count = 0; $count < @noOfManagedServers; $count++) {
$managedServer = $noOfManagedServers[count];
@fields = split (/,/, $managedServer);
$arraySize = @fields;
if ( $ACTION eq "SCALEDOWN" || $ACTION eq "DELETE" ) {
print "Managed Server Name is ".$fields[0]."\n";
print "Managed Server Host Name is ".$fields[1]."\n";
print "Managed Server NON SSL Port is ".$fields[2]."\n";
print "Managed Server SSL Port is ".$fields[3]."\n";
} else {
print "Managed Server Host Name is ".$fields[0]."\n";
print "Managed Server NON SSL Port is ".$fields[1]."\n";
print "Managed Server SSL Port is ".$fields[2]."\n";
}
print "\n"
}
print "===================Managed Server's Details Ends===================="."\n";

print "\n";

print "===================External Host's Details Begins==================="."\n";
my $EXTERNAL_HOSTS = $hash{'EXTERNAL_HOSTS'};
my @hosts = split (/,/, $EXTERNAL_HOSTS);
for ($count = 0; $count < @hosts; $count++) {
print "External Host is ".$hosts[count]."\n";
}

print "=====================External Host's Details Ends==================="."\n";

25.6.1.3 サンプル・スクリプトの出力

ディレクティブの出力は次のとおりです。

Imput File Location = /jan1215/work/agentStateDir/1422547083465.properties
======================================================================
The properties file contents accessible to this script are as follows
OPERATION= CREATE
SERVICE_INSTANCE= inst_01
DOMAIN_NAME= inst_01_SSA_USER1
DOMAIN_HOME= /middleware/inst_01_SSA_USER1
MW_HOME= /middleware
WLS_HOME= /middleware/wlserver_10.3
ADMIN_SERVER= example.com,27877,8142
MANAGED_SERVERS= example.com,13614,1488,4166;
EXTERNAL_HOSTS= example.com
EXECUTE_SCRIPTS_ON_ADMIN_SERVER_HOST=  Yes
EXECUTE_SCRIPTS_ON_MANAGED_SERVER_HOSTS=  Yes
======================================================================
This is Service Instance Creation Operation
======================================================================
=======================Admin Server Details Begins===================
Admin Server Host Name is example.com
Admin Server NON SSL Port is 27877
Admin Server SSL Port is 8142
=======================Admin Server Details Ends====================

=======================Managed Server's Details Begins===============
Managed Server Host Name is example.com
Managed Server NON SSL Port is 13614
Managed Server SSL Port is 1488

=======================Managed Server's Details Ends====================

=======================External Host's Details Begins===================
External Host is example.com
=======================External Host's Details Ends===================

25.6.2 リソース管理スクリプト

リソース管理スクリプトでは、名前/値ペアのリストを含むプロパティ・ファイルの場所を指定します。ファイルの内容は、作成、スケール・アップ、スケール・ダウンおよび削除の各操作に基づいて変化します。

25.6.2.1 作成操作

作成操作のファイルの内容は、次のとおりです。

ACTION=CREATE

ZONE_NAME=<value>

POOL_NAME=<value>

NUMBER OF SERVERS BEFORE THIS REQUEST=<value>

NUMBER OF SERVERS REQUESTED=<value>

NUMBER OF SERVERS POSSIBLE WITH AVAILABLE RESOURCES=<value>

NUMBER OF SERVERS NEEDED=<value>

MAXIMUM SERVERS ALLOWED PER HOST=<value>

MIDDLEWARE_HOME=<value>

EXPECTED CPU UTILIZATION IN PERCENTAGE=<value>

EXPECTED MEMORY CONSUMPTION IN GB==<value>

25.6.2.2 スケール・アップ操作

スケール・アップ操作のファイルの内容は、次のとおりです。

ACTION=SCALEUP

ZONE_NAME=<value>

POOL_NAME=<value>

NUMBER OF SERVERS BEFORE THIS REQUEST=<value>

NUMBER OF SERVERS REQUESTED=<value>

NUMBER OF SERVERS POSSIBLE WITH AVAILABLE RESOURCES=<value>

NUMBER OF SERVERS NEEDED=<value>

MAXIMUM SERVERS ALLOWED PER HOST=<value>

MIDDLEWARE_HOME=<value>

DOMAIN_NAME=<value>

EXPECTED CPU UTILIZATION IN PERCENTAGE=<value>

EXPECTED MEMORY CONSUMPTION IN GB==<value>

25.6.2.3 スケール・ダウン操作

スケール・ダウン操作のファイルの内容は、次のとおりです。

ACTION=SCALEDOWN

ZONE_NAME=<value>

POOL_NAME=<value>

NUMBER OF SERVERS BEFORE THIS REQUEST=<value>

NUMBER OF SERVERS BEING REMOVED=<value>

HOSTS FROM WHERE SERVERS BEING REMOVED=<value>

MIDDLEWARE_HOME=<value>

DOMAIN_NAME=<value>

25.6.2.4 削除操作

削除操作のファイルの内容は、次のとおりです。

ACTION=DELETE

ZONE_NAME=<value>

POOL_NAME=<value>

NUMBER OF SERVERS BEFORE THIS REQUEST=<value>

NUMBER OF SERVERS BEING REMOVED=<value>

HOSTS FROM WHERE SERVERS BEING REMOVED=<value>

MIDDLEWARE_HOME=<value>

DOMAIN_NAME=<value>

25.7 チャージバックの構成

「チャージバック」タブをクリックして、ミドルウェア・プールをチャージバック・アプリケーションに追加します。このページで、チャージバック・ゾーン、サービス、アイテムおよび価格を決定できます。チャージバックの設定後、チャージおよびプランの詳細を表示できます。

ホスト、管理対象サーバー、PaaSインフラストラクチャ・ゾーンなどの関連するターゲットから収集された構成および監視のメトリックに基づいてチャージバックおよび測定のデータを構成できます。チャージ・プランは、ホスト、WebLogic (ドメイン、クラスタおよびサーバー)、PaaSインフラストラクチャ・ゾーンおよび構成(WebLogicドメインのバージョン、OSバージョン、ベンダーなど)に基づきます。

チャージバック・サービスの設定の詳細は、第43章「チャージバック管理」を参照してください。

26 SOAaaSまたはOSBaaSセルフ・サービス・ポータルの設定

この章では、SOAセルフ・サービス・ポータルまたはOSBセルフ・サービス・ポータルを設定して有効化する手順について説明します。次のセクションがあります。

- SOAaaSおよびOSBaaSの開始

- SOAリポジトリのクローニングに使用されるDBaaSの設定

- SOAまたはOSBプロビジョニング・プロファイルを作成する前提条件

- SOAおよびOSBクラウド・セルフ・サービス・ポータルの設定

26.1 SOAaaSおよびOSBaaSの開始

この項では、この章に取り組むための手引きとして、SOA as a Service (SOAaaS)およびOSB as a Service (OSBaaS)を設定して1つ以上の物理ホストにサービス・インスタンスをプロビジョニングする手順の概要を説明します。

表26-1 Middleware as a Serviceの開始

手順

作業

1

ソースSOAドメインまたはOSBドメインによって使用されるデータベースをクローニングします。Oracleでは、Enterprise Managerで使用可能なDBaaS機能の使用をお薦めします。第26.2項を参照してください。

2

SOA/OSBプロビジョニング・プロファイルを作成する前提条件を満たします。第26.3項を参照してください。

3

SOAおよびOSBセルフ・サービス・ポータルの設定。第26.4項を参照

26.2 SOAリポジトリのクローニングに使用されるDBaaSの設定

データベース・セルフ・サービス・ポータルの設定およびSOAセルフ・サービス・ポータルの設定に使用できるデータベース・インスタンスのリクエストの手順の概要を次に示します。SOAのデータベース・インスタンスの設定で従ったクローニング手法では、RMANバックアップを使用しています。手順の概要を次に示します。

表26-2 RMANバックアップ・プロファイルを使用したデータベースのプロビジョニング

手順

作業

ロール

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

2

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。

注意: Oracleでは、データベースとSOA/OSBに同じインフラストラクチャ・ゾーンを使用することをお薦めします。

第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

3

「RMANバックアップ」オプションを使用してデータベース・プロビジョニング・プロファイルを作成します。

注意: ソースSOA/OSBドメインで使用されるSOA/OSBデハイドレーション・ストア・データベースを選択してプロファイルを作成します。

第19.1.2.1項「RMANバックアップを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

4

データベース・プールを作成します。

第19.1.1.1項「Database as a Service用のデータベース・プールの作成」を参照してください。

5

SOAのデータベース・サービス・テンプレートを作成します。

OSBのデータベース・サービス・テンプレートを作成します。

「SOAプロファイルのデータベース・サービス・テンプレートの作成」を参照してください。

「OSBプロファイルのデータベース・サービス・テンプレートの作成」を参照してください。

6

SOA/OSBのデータベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第22.2項「データベースのリクエスト」を参照してください。

- 注意:
データベース・サービス・インスタンスの作成に使用されるのと同じユーザー資格証明を、SOA/OSBサービス・インスタンスの作成に使用する必要があります。他の資格証明を使用するかわりに、データベースに対する必要な権限がSOAサービス・ユーザーに付与されていることを確認する必要があります。

26.2.1 SOAプロファイルのデータベース・サービス・テンプレートの作成
前提条件:
SOAデハイドレーション・ストア(ソース環境)の内部に存在するビジネス・データを切り捨てるには、SOA製品の一部として提供されている切捨てスクリプトを使用します。このためには、最初に「汎用コンポーネント」を作成し、truncate_soa_oracle.sqlスクリプトをソフトウェア・ライブラリにアップロードする必要があります。この操作の詳細は、『Oracle Enterprise Manager Cloud Control管理者ガイド』を参照してください。

切捨てスクリプト(truncate_soa_oracle.sql)は、ディレクトリ・パス/MW_HOME/SOA_ORACLE_HOME/rcu/integration/soainfra/sql/truncateにあります。

SOAプロファイル用のサービス・テンプレートを作成するには、次の手順に従います。

1. 第19.1.2.1項の手順に従ってデータベース・プロファイルを作成します。

2. 「次」をクリックします。

3. サービス・テンプレートの作成: カスタマイズ・ページで、データベースの作成の前と後に実行する必要のあるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。
「SQL後スクリプト」フィールドで、ソフトウェア・ライブラリにアップロードしたコンポーネントtruncate_soa_oracle.sqlを選択します。

「実行ユーザー」ドロップダウン・メニューから、データベース・スキーマを選択します。スクリプトは{prefix}_SOAINFRAデータベース・ユーザーとして実行する必要があります。たとえば、DEV_SOAINFRAなどです。

4. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。

5. 「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

6. サービス・テンプレートの作成: 確認ページが表示されます。「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。

26.2.2 OSBプロファイルのデータベース・サービス・テンプレートの作成

前提条件(OSB 11gターゲットにのみ適用)

OSBは、管理サーバーなど、OSBドメイン内の各管理対象サーバーについてOSBスキーマにLLR表を作成するロギング・ラスト・リソース(LLR)トランザクション最適化機能を使用します。

OSBデータベースのクローニングの一環として、これらの表を削除する必要があります。そうしないと、クローニングされたOSBドメインの起動に失敗します。これらの表を削除するには、「汎用コンポーネント」を作成し、llr_table.sqlスクリプトをソフトウェア・ライブラリにアップロードできます。

ソースOSB環境に存在する各LLR表のスクリプトを作成するには、SQLスクリプトに次の文を追加します。

DROP table WL_LLR_<SERVER_NAME>

たとえば、OSBドメインに管理サーバーとOSB_SERVER1およびOSB_SERVER2という名前の2つの管理対象サーバーがある場合、SQLスクリプトの内容は次のようになります。

DROP table WL_LLR_ADMINSERVER

DROP table WL_LLR_OSB_SERVER1

DROP table WL_LLR_OSB_SERVER2

OSBプロファイル用のサービス・テンプレートを作成するには、次の手順に従います。

1. 第19.1.2.1項の手順に従ってデータベース・プロファイルを作成します。

2. 「次」をクリックします。

3. サービス・テンプレートの作成: カスタマイズ・ページで、データベースの作成の前と後に実行する必要のあるカスタム・スクリプトを指定します。第24.1項「リクエスト作成/削除の前処理および後処理スクリプト」を参照してください。
「SQL後スクリプト」フィールドで、ソフトウェア・ライブラリから、データベースに存在するLLR表(llr_table.sql)を切り捨てるために作成したコンポーネントを選択します。この手順を実行しない場合は、OSBサービスのリクエストが失敗します。

「実行ユーザー」ドロップダウン・メニューから、データベース・スキーマを選択します。スクリプトは{prefix}_SOAINFRAデータベース・ユーザーとして実行する必要があります。たとえば、OSB_SOAINFRAなどです。

4. 次をクリックします。サービス・テンプレートの作成: ロール・ページが表示されます。

5. 「追加」をクリックし、このサービス・テンプレートを使用可能にするSSAユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

6. サービス・テンプレートの作成: 確認ページが表示されます。「作成」をクリックします。新しく作成されたサービス・テンプレートが、データベース・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。

26.3 SOAまたはOSBプロビジョニング・プロファイルを作成する前提条件

SOAまたはOSBプロビジョニング・プロファイルを作成する前に、Oracle Enterprise Managerライフサイクル管理の管理者ガイドに記載されているすべての前提条件を満たします。

26.4 SOAおよびOSBクラウド・セルフ・サービス・ポータルの設定

EM_SSA_ADMINISTRATORは、ミドルウェア・プールの作成、割当て制限の設定、リクエスト設定の定義、ロード・バランサの構成、サービス・テンプレートの作成およびチャージバックの構成により、SOA/OSBクラウド・セルフ・サービス・ポータルを構成および設定できます。

注意:
SOAまたはOSBドメインのデータベース・プロファイルを作成するには、単一インスタンス・データベースまたはRACデータベースを使用する必要があります。RACデータベースの場合は、GridLinkデータ・ソースを使用します。複数データソースはサポートされません。

次の表に、実行する必要のあるタスクと、タスクを実行できるユーザー・ロールを示します。

手順

作業

ユーザー・ロール

1

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

EM_CLOUD_ADMINISTRATOR

2

SOAプロビジョニング・プロファイルの作成
第26.3項に記載されている前提条件を満たします。

SOAプロファイルの作成方法の手順は、Oracle Enterprise Managerライフサイクル管理の管理者ガイドを参照してください。

注意: プロファイルに対する権限をSSA_USERロールに付与してください。基本要件は、SSA_USERロールにSOAプロファイルに対する表示権限があることです。権限を付与するには、次の手順に従います。

1. Cloud Controlで、「エンタープライズ」メニューから「プロビジョニングとパッチ適用」を選択し、「ソフトウェア・ライブラリ」をクリックします。

2. ソフトウェア・ライブラリ・ホームページで、「Fusion Middlewareプロビジョニング」オプションと「プロファイル」メニューを展開し、すべてのSOA/OSBプロファイルを表示します。

3. プロファイルの1つを選択し、「アクション」メニューから「権限の付与/権限の取消し」を選択します。

4. 権限の付与/権限の取消しページで、「追加」をクリックしてSSA_USERロールを選択し、表示権限を付与します。

EM_SSA_ADMINISTRATOR

3

第26.4.1項「SOAaaSおよびOSBaaSプールの作成」

EM_SSA_ADMINISTRATOR

4

第25.3項「ロード・バランサ構成の作成」

EM_SSA_ADMINISTRATOR

5

第25.4項「リクエスト設定の構成」

EM_SSA_ADMINISTRATOR

6

第25.5項「割当て制限の設定」

EM_SSA_ADMINISTRATOR

7

第26.4.2項「SOAおよびOSBサービス・テンプレートの作成」

EM_SSA_ADMINISTRATOR

8

第25.7項「チャージバックの構成」

EM_SSA_ADMINISTRATOR

26.4.1 SOAaaSおよびOSBaaSプールの作成

ミドルウェア・プールには、PaaSインフラストラクチャ・ゾーン内にサービス・インスタンスをプロビジョニングする際に使用できる一連のリソースが含まれています。ミドルウェア・ホームのWebLogicバージョンごとに、PaaSインフラストラクチャ・ゾーンに個別のミドルウェア・プールを作成する必要があります。

SOAプールまたはOSBプールを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。特定のサービス・ファミリを設定する前に実行する必要がある一般的なタスクが表示されます。左パネルのミドルウェア・サービス・ファミリの横の「設定」リンクをクリックします。

4. ドロップダウン・リストから「SOAインフラストラクチャ」または「Oracle Service Bus」を選択し、「ミドルウェア・プール」をクリックします。ミドルウェア・プール・ページが表示されます。

5. ミドルウェア・プール・ページで、「作成」をクリックします。

6. ミドルウェア・プールのターゲット名、名前および説明を入力します。

7. ミドルウェア・プールを作成するPaaSインフラストラクチャ・ゾーンを選択します。次をクリックします。

8. 「追加」をクリックし、1つ以上のホストをミドルウェア・プールに追加します。「次」をクリックします。

9. 配置制約ページの「WebLogicサーバーの最大数(1ホスト当たり)」フィールドに、プール内の各ホストで実行できるサーバー・インスタンスの最大数を入力します。

10. 特性ページで、ターゲットのプロパティのタグ付けと識別に使用される特性を指定します。次のオプションが可能です。

- 共有の場所を使用するには、「共有Oracleホーム」メニューから「はい」を選択し、「ミドルウェア・ホームのベース・ディレクトリ」にNFCパスを指定します。この場合、SSA管理者は、NFSパスがミドルウェア・リソース・プロバイダ(SOAおよびOSBに使用)のすべてのホストにマウントされていることを確認する必要があります。

- ローカル・パスを使用するには、「共有Oracleホーム」メニューから「いいえ」を選択し、ミドルウェア・リソース・プロバイダのホスト全体に一貫性のある場所を指定します。

11. 確認ページで、「発行」をクリックしてSOAまたはOSBプールを作成します。これで、新規に作成したプールを使用して、対応するSOAおよびOSAサービス・テンプレートを作成できます。

26.4.2 SOAおよびOSBサービス・テンプレートの作成

サービス・テンプレートは、ミドルウェア・プールでサービス・インスタンスをプロビジョニングするために使用できるサービス定義です。

前提条件

- PaaSインフラストラクチャ・ゾーンを作成しておく必要があります。

- ミドルウェア・プールを作成しておく必要があります。

- 適切な値が設定されたミドルウェア・プロビジョニングプロファイルがソフトウェア・ライブラリに存在している必要があります。プロファイルの所有者は、SSAユーザーにプロファイルの「表示」権限を付与する必要があります。

- SOAプロファイルとOSBプロファイルのデータベース・サービス・テンプレートは異なります。作成方法の詳細は、第26.2.1項および第26.2.2項を参照してください。

注意:
アクティブ・インスタンスを持つサービス・テンプレートを編集し、構成パラメータを変更できます。サービス・テンプレートが変更された場合:

- 変更が加えられた後に作成された新しいインスタンスでは、新しいパラメータが使用されます。

- 古いインスタンスまたはテンプレートが変更される前に作成されたインスタンスでは、以前の値が使用されます。

- ゾーンとロールに加えられた変更は、古いインスタンスと新しいインスタンスの両方に適用可能です。

ミドルウェア・サービス・テンプレートを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。特定のサービス・ファミリを設定する前に実行する必要がある一般的なタスクが表示されます。左パネルのミドルウェア・サービス・ファミリの横の「設定」リンクをクリックします。

4. ドロップ・ダウン・リストから「SOAインフラストラクチャ」または「Oracle Service Bus」を選択し、「サービス・テンプレート」をクリックします。

5. サービス・テンプレート・ページで、「作成」をクリックします。

6. 一般ページで、サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. 「プロファイルSOA」フィールドで、「検索」アイコンをクリックし、プロビジョニング・プロファイルを選択します。これらのプロファイルの作成方法の詳細は、Oracle Enterprise Managerライフサイクル管理の管理者ガイドを参照してください。「次」をクリックします。

8. 特性ページで、ターゲットのプロパティのタグ付けと識別に使用される特性を指定します。テンプレートから作成されたサービス・インスタンスには特性があります。「次」をクリックします。

9. リソース・プロバイダ・ページで「追加」をクリックして、サービス・インスタンスをプロビジョニングできるミドルウェア・プールを選択します。ミドルウェア・プールが関連付けられているPaaSインフラストラクチャ・ゾーンが表示されます。「次」をクリックします。

10. 構成ページで、次の詳細を入力します。

表26-3 SOA構成の詳細

Name

説明

ミドルウェア・ホーム・ベース・パスおよびJavaホーム

ミドルウェア・ホーム・ベース・パス: リソース・プロバイダの作成時にNFSパスを設定した場合、そのパスがデフォルトでここに入力されるので、これと同じパスを保持することをお薦めします。ただし、リソース・プロバイダの作成時にパスを設定しなかった場合、プロファイルのミドルウェア・ホーム・ベース・パスが表示され、必要に応じて更新できます。

ドメイン・ホーム・ベース・パス: このドメインを作成するベース・ディレクトリの絶対パスを入力するか、ミドルウェア・ホーム・ベース・パスの相対パスを'$MIDDLEWARE_HOME/'接頭辞として指定します。たとえば、$MIDDLEWARE_HOME/domainsなどです。

または、リソース・プロバイダ特性ページからこれを設定できます。すでに値を設定している場合、ここに移入された状態で表示されます。

注意: 共有ミドルウエア・ホームの場合、このドメイン・ホーム・ベース・パスは絶対値である必要があります。

Javaホーム: (プロファイルの作成元の)ソース・ドメインで使用されているJavaホーム・パスがここに表示されます。このパスは必要に応じて変更できます。宛先ドメインでも同じJavaバージョンが使用されていることを確認してください。

注意: Windowsオペレーティング・システムを使用している場合は、Javaホーム・パスに空白が含まれていないことを確認してください。

作業ディレクトリ: ファイルは、プロビジョニング中にこのディレクトリでステージされます。絶対パスまたはミドルウェア・ホーム・ベース・パスからの相対パスを指定します。たとえば、$MIDDLEWARE_HOME/workなどです。

配置パラメータ

予想されるメモリー消費率: 各追加インスタンスが使用するCPUの概算(%)。メモリー消費は、XmsとMaxPermSizeの合計以上である必要があります。

たとえば、-Xms1280m、MaxPermSize=256mとします。合計 = 1280MB + 256MB = 1536MB (1.536GB)です。メモリー消費として入力する値は、1.5GB以上である必要があります。

予想されるCPU使用率: 各追加インスタンスに必要なメモリーの概算(GB)

注意: これらのプロパティは、インスタンスの作成に使用可能なリソースが十分にあるホストを割り当てるために使用されます。

サーバーの起動引数

管理対象サーバーの起動引数: サーバーを起動するためのメモリーおよびJava引数を入力します。例: -Xms1280m -Xmx1280m -XX:PermSize=128m -XX:MaxPermSize=256m -Dweblogic.security.SSL.ignoreHostnameVerification=true”

注意: Coherence構成は自動的に行われます。Coherenceパラメータをここで指定する必要はありません。

WebLogic管理ユーザー資格証明

ユーザー名: これは、プロファイルの作成に使用するWebLogicユーザー名です。ユーザー名はデフォルトで移入されるため、更新することはできません。

パスワード: これは作成されたweblogicアカウントのパスワードとして設定されます。

前処理および後処理スクリプト

サービス・インスタンスの前処理スクリプト: サービス・インスタンスの作成、削除またはスケール・アップの前に実行する必要があるスクリプトを選択します。

サービス・インスタンスの後処理スクリプト: サービス・インスタンスの作成、削除またはスケール・アップの後に実行する必要があるスクリプトを選択します。

注意: FMWプラグイン12.1.0.7からFMWプラグイン12.1.0.8にアップグレードした場合、サービス用に統合された前処理スクリプトおよび後処理スクリプトを作成する必要があります。このスクリプトには、作成、削除、スケール・アップなどの操作を含める必要があります。ファイルをディレクティブとしてソフトウェア・ライブラリに保存します。

その後、既存のサービス・テンプレートの「構成」ページを、新しく作成されたスクリプトを含めるように編集する必要があります。

スクリプト実行用のホスト: Enterprise Managerで検出された、スクリプトを実行する必要のあるホスト。複数のターゲット・ホストを指定する場合は、「,」で区切ります。

スクリプトの実行用の名前付き資格証明: スクリプトを実行する必要のあるホストの名前付き資格証明を入力します。SSA管理者には、これらの名前付き資格証明に対する「表示」権限が必要です。たとえば、CredName:CredOwnerなどです。

管理サーバー・ホストでスクリプトを実行: 管理対象ホストでスクリプトを実行するには1 (はい)を入力し、管理者サーバー・ホストをスキップするには0 (いいえ)を入力します。

管理対象サーバー・ホストでスクリプトを実行: 管理者サーバー・ホストでスクリプトを実行するには1 (はい)を入力し、管理対象サーバー・ホストをスキップするには0 (いいえ)を入力します。

注意: アップグレード後、このフラグの値はリセットされます。既存のサービス・テンプレートを編集し、フラグの値を適切に設定する必要があります。

スクリプトは、次のガイドラインを満たしている必要があります。

- 作成するディレクティブはPERLディレクティブである必要があります。

- INPUT_FILE_LOCATIONという名前の入力パラメータを定義する必要があります。

- プロパティ・ファイルの場所のパスは、INPUT_FILE_LOCATIONパラメータで指定する必要があります。

- プロパティ・ファイルには、サービス・インスタンスおよびドメインの情報が含まれています。

サンプル・スクリプト・ファイル、プロパティ・ファイルおよび生成される出力については、第26.4.3項を参照してください。

ポート範囲

ポート範囲開始: 空きポートを選択する場合の下限

ポート範囲終了: 空きポートを選択する場合の上限。

注意: ポート範囲は、サーバーおよびノード・マネージャのポートの割当てに使用されます。1024から65535の範囲内である必要があります。

ロード・バランサの有効化: ロード・バランサを有効にするには、「はい」を入力し、無効にするには「いいえ」を入力します。「はい」を選択した場合は、選択したリソース・プロバイダでロード・バランサを構成する必要があります。

ロード・バランサ

サービス・テンプレートで使用されるソース・ドメインがロード・バランサによってすでに構成されている場合にのみ、「はい」を選択します。ソース・ドメインがロード・バランサによって構成されていない場合、「いいえ」を選択する必要があります。

「次」をクリックします。

11. ロール・ページで、「追加」をクリックして、このサービス・テンプレートを使用できるセルフ・サービス・ユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。「次」をクリックします。

12. 確認ページで、これまでに入力した情報を確認し、「発行」をクリックします。新しく作成されたサービス・テンプレートが、ミドルウェア・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。「サービス・テンプレート名」リンクをクリックして、追加の詳細を表示できます。

26.4.3 サンプル後処理スクリプト

このサンプル後処理スクリプトでは、プロパティ・ファイルの内容に加え、管理対象サーバーや管理サーバーなどの詳細が出力されます。

26.4.3.1 サンプル・プロパティ・ファイル

プロパティ・ファイルの内容は次のとおりです。

OPERATION= CREATE
SERVICE_INSTANCE= inst_01_14b3668772c
DOMAIN_NAME= inst_01_14b3668772c_SSA_USER1
DOMAIN_HOME= /scratch/middleware_ps4/inst_01_14b3668772c_SSA_USER1
MW_HOME= /scratch/middleware_ps4
WLS_HOME= /scratch/middleware_ps4/wlserver_10.3
ADMIN_SERVER= example.com,27877,8142
MANAGED_SERVERS= example.com,13614,1488,4166;
EXTERNAL_HOSTS= example.com
EXECUTE_SCRIPTS_ON_ADMIN_SERVER_HOST=  Yes
EXECUTE_SCRIPTS_ON_MANAGED_SERVER_HOSTS=  Yes

注意:
作成操作と同様に、削除操作またはスケール・アップ操作を実行できます。

26.4.3.2 サンプル・スクリプト

サンプル・スクリプトは次のとおりです。

#!/usr/bin/perl
use File::Path;
#use File::Spec();
use File::Spec;
use Cwd;

my $dir = getcwd();
my $inputFile = $ARGV[0];

print "Input File Location = ".$inputFile."\n";
print "===================================================================="."\n";
print "The properties file contents accessible to this script are as follows "."\n";

my @prop;
#Create Hash from properties
open FILE, "<$inputFile" or die("Could not open text file '" . $inputFile . "': $!");
my %hash;
while ($line4 = <FILE>)
{
chomp($line4);
my ($key, $val) = split(/=/,$line4);
print $key."= ".$val."\n";
$hash{$key}=$val;
}
close FILE;
print "===================================================================="."\n";
my $ACTION = $hash{'OPERATION'};
if ( $ACTION eq "CREATE" ) {
print " This is Service Instance Creation Operation \n";
} elsif ( $ACTION eq "SCALEUP" ) {
print " This is Scale Up Operation \n";
} elsif ( $ACTION eq "DELETE" ) {
print " This is Delete Service Instance Operation \n";
} else {
print " Unsuppported Configuration Action".$ACTION."\n";
}
print "===================================================================="."\n";

my $ADMIN_SERVER = $hash{'ADMIN_SERVER'};

print "======================Admin Server Details Begins==================="."\n";
my @fields = split (/,/, $ADMIN_SERVER);
my $arraySize = @fields;
if ($arraySize == 4) {
print "Admin Server Name is ".$fields[0]."\n";
print "Admin Server Host Name is ".$fields[1]."\n";
print "Admin Server NON SSL Port is ".$fields[2]."\n";
print "Admin Server SSL Port is ".$fields[3]."\n";
} else {
print "Admin Server Host Name is ".$fields[0]."\n";
print "Admin Server NON SSL Port is ".$fields[1]."\n";
print "Admin Server SSL Port is ".$fields[2]."\n";
}
print "======================Admin Server Details Ends===================="."\n";

print "\n";

print "======================Managed Server's Details Begins==============="."\n";
my $MANAGED_SERVERS = $hash{'MANAGED_SERVERS'};
my $managedServer;
my @noOfManagedServers = split (/;/, $MANAGED_SERVERS);
for ($count = 0; $count < @noOfManagedServers; $count++) {
$managedServer = $noOfManagedServers[count];
@fields = split (/,/, $managedServer);
$arraySize = @fields;
if ( $ACTION eq "DELETE" ) {
print "Managed Server Name is ".$fields[0]."\n";
print "Managed Server Host Name is ".$fields[1]."\n";
print "Managed Server NON SSL Port is ".$fields[2]."\n";
print "Managed Server SSL Port is ".$fields[3]."\n";
} else {
print "Managed Server Host Name is ".$fields[0]."\n";
print "Managed Server NON SSL Port is ".$fields[1]."\n";
print "Managed Server SSL Port is ".$fields[2]."\n";
}
print "\n"
}
print "===================Managed Server's Details Ends===================="."\n";

print "\n";

print "===================External Host's Details Begins==================="."\n";
my $EXTERNAL_HOSTS = $hash{'EXTERNAL_HOSTS'};
my @hosts = split (/,/, $EXTERNAL_HOSTS);
for ($count = 0; $count < @hosts; $count++) {
print "External Host is ".$hosts[count]."\n";
}

print "=====================External Host's Details Ends==================="."\n";

26.4.3.3 サンプル・スクリプトの出力

ディレクティブの出力は次のとおりです。

Input File Location = /ade/jan1215/oracle/work/agentStateDir/1422547083465.properties
======================================================================
The properties file contents accessible to this script are as follows
OPERATION= CREATE
SERVICE_INSTANCE= inst_01_14b3668772c
DOMAIN_NAME= inst_01_14b3668772c_SSA_USER1
DOMAIN_HOME= /scratch/middleware_ps4/inst_01_14b3668772c_SSA_USER1
MW_HOME= /scratch/middleware_ps4
WLS_HOME= /scratch/middleware_ps4/wlserver_10.3
ADMIN_SERVER= example.com,27877,8142
MANAGED_SERVERS= example.com,13614,1488,4166;
EXTERNAL_HOSTS= example.com
EXECUTE_SCRIPTS_ON_ADMIN_SERVER_HOST=  Yes
EXECUTE_SCRIPTS_ON_MANAGED_SERVER_HOSTS=  Yes
======================================================================
This is Service Instance Creation Operation
======================================================================
=======================Admin Server Details Begins===================
Admin Server Host Name is example.com
Admin Server NON SSL Port is 27877
Admin Server SSL Port is 8142
=======================Admin Server Details Ends====================

=======================Managed Server's Details Begins===============
Managed Server Host Name is example.com
Managed Server NON SSL Port is 13614
Managed Server SSL Port is 1488

=======================Managed Server's Details Ends====================

=======================External Host's Details Begins===================
External Host is example.com
=======================External Host's Details Ends===================

26.4.4 リソース管理スクリプト

リソース管理スクリプトでは、名前/値ペアのリストを含むプロパティ・ファイルの場所を指定します。ファイルの内容は、作成、スケール・アップおよび削除の各操作に基づいて変化します。

26.4.4.1 作成操作

作成操作のファイルの内容は、次のとおりです。

ACTION=CREATE

ZONE_NAME=<value>

POOL_NAME=<value>

NUMBER OF SERVERS BEFORE THIS REQUEST=<value>

NUMBER OF SERVERS REQUESTED=<value>

NUMBER OF SERVERS POSSIBLE WITH AVAILABLE RESOURCES=<value>

NUMBER OF SERVERS NEEDED=<value>

MAXIMUM SERVERS ALLOWED PER HOST=<value>

MIDDLEWARE_HOME=<value>

EXPECTED CPU UTILIZATION IN PERCENTAGE=<value>

EXPECTED MEMORY CONSUMPTION IN GB==<value>

26.4.4.2 スケール・アップ操作

スケール・アップ操作のファイルの内容は、次のとおりです。

ACTION=SCALEUP

ZONE_NAME=<value>

POOL_NAME=<value>

NUMBER OF SERVERS BEFORE THIS REQUEST=<value>

NUMBER OF SERVERS REQUESTED=<value>

NUMBER OF SERVERS POSSIBLE WITH AVAILABLE RESOURCES=<value>

NUMBER OF SERVERS NEEDED=<value>

MAXIMUM SERVERS ALLOWED PER HOST=<value>

MIDDLEWARE_HOME=<value>

DOMAIN_NAME=<value>

EXPECTED CPU UTILIZATION IN PERCENTAGE=<value>

EXPECTED MEMORY CONSUMPTION IN GB==<value>

26.4.4.3 Delete(削除)操作

削除操作のファイルの内容は、次のとおりです。

ACTION=DELETE

ZONE_NAME=<value>

POOL_NAME=<value>

NUMBER OF SERVERS BEFORE THIS REQUEST=<value>

NUMBER OF SERVERS BEING REMOVED=<value>

HOSTS FROM WHERE SERVERS BEING REMOVED=<value>

MIDDLEWARE_HOME=<value>

DOMAIN_NAME=<value>

27 JVMaaSセルフ・サービス・ポータルの設定

この章では、JVM as a Serviceのミドルウェア・セルフ・サービス・ポータルを設定する手順について説明します。内容は次のとおりです。

- Javaアプリケーション・サービス・セルフ・サービス・ポータルの設定

- カスタマイズされたミドルウェア・プロファイルの作成

- ミドルウェア・プロファイルのソフトウェア・ライブラリへのアップロード

- Javaアプリケーション・プロファイルに基づくサービス・テンプレートの作成

27.1 Javaアプリケーション・サービス・セルフ・サービス・ポータルの設定

EM_SSA_ADMINISTRATORは、ミドルウェア・プールの作成、割当て制限の設定、リクエスト設定の定義、サービス・テンプレートの作成およびチャージバックの構成により、JVMクラウド・セルフ・サービス・ポータルを構成および設定できます。

Javaアプリケーション・サービスを設定するには、次の手順に従います。

1. 1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。詳細は、第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

2. ミドルウェア・プールを作成します。第25.2項「ミドルウェア・プールの作成」を参照してください。

3. リクエスト設定を構成します。第25.4項「リクエスト設定の構成」を参照してください。

4. 各セルフ・サービス・ユーザー・ロールの割当て制限を定義します。第25.5項「割当て制限の設定」を参照してください。

5. サービス・テンプレートを作成します。第27.4項「Javaアプリケーション・プロファイルに基づくサービス・テンプレートの作成」を参照してください。

6. オプションで、チャージバック・サービスを構成できます。第25.7項「チャージバックの構成」を参照してください。

27.2 カスタマイズされたミドルウェア・プロファイルの作成

独自のカスタム・プロファイルを作成する場合は、必須とオプションのパラメータをすべて含めてXMLファイルを作成する必要があります。これは、tomcatServiceのプロファイルの作成方法を示す次の例を使用して説明します。

1. 「内部名」や「所有者」など、プロファイルの定義に必要な必須の詳細すべてを入力します。また、プロファイルの表示名や簡単な説明を指定することもできます。次に、プラットフォーム情報、製品リスト、製品の表示名などを指定する必要があります。

<?xml version="1.0"?>
<mw:profile xmlns:mw="http://xmlns.oracle.com/mw/profile"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.oracle.com/mw/profile ../../../../../../../../FmwProvisioningPojo/src/oracle/sysman/fmw/provisioning/pojo/profile/genericProfile.xsd"
name="TomcatProfile4" vendor="Oracle" version="1.0"
content="softwareOnly">
<mw:displayName>
Tomcat As A Service with Free Ports
</mw:displayName>
<mw:description>
Profile for Provisioning single Node Tomcat Server with Bundled Application.
</mw:description>

<mw:platformInfo os="Linux" platform="x86-64" platformId="226"/>
<mw:products>
<mw:product name="Tomcat" version="10.3.6.0">
<mw:displayName>
Tomcat Bundled With Application
</mw:displayName>
</mw:product>
</mw:products>

2. このプロファイルを使用してプロビジョニングされた各サービス・インスタンスは、空きポートで提供されます。これらは、プロファイルの指定どおりに使用できます。PORT_RANGE_START、PORT_RANGE_ENDおよびPORTS_COUNTに値を指定する必要があります。
PORT_RANGE_STARTおよびPORT_RANGE_ENDでは、指定されるポート値の範囲を定義します。何も指定しないと、デフォルトでそれぞれ2000と3000が指定されたとみなされます。

PORTS_COUNTでは、サービスで必要とされるポートの数を定義します。定義しない場合、いずれのポートもサービスに割り当てられません。

<mw:properties>
<mw:stringProperty name="PORT_RANGE_START" value="2000"/>
<mw:stringProperty name="PORT_RANGE_END" value="3000"/>
<mw:stringProperty name="PORTS_COUNT" value="3"/>
</mw:properties>

3. プロファイルXMLファイルに定義されたプロビジョニング、起動、停止、削除などのアクションは、サービス・インスタンスのライフサイクルの異なるフェーズで実行されます。

- プロビジョニング・アクションによって、サービス・インスタンスの最初の作成方法が決定されます。ソフトウェアの設定と構成が、このステップの一部として実行されます。ここで次のパラメータを定義する必要があります。

- ペイロード: プロファイルに含める実際のアプリケーション。

- プロシージャ: 実行時に動的に置換される変数。

- 起動アクションでは、プロビジョニングされるソフトウェアの起動方法を定義します。

- 停止アクションでは、プロビジョニングされるソフトウェアの停止方法を定義します。

- 削除アクションでは、サービス・インスタンスを削除します。クリーンアップ・アクションがこのステップの一部として実行されます。

プロビジョニング: このアクションはEnterprise Managerでアプリケーションをプロビジョニングします。

<!-- [Mandatory] Action list -->
<mw:actions default="provision">
<mw:action name="provision" retryFrom="first">
<!-- [Optional] Display name and description -->
<mw:displayName>
Provision Tomcat Server
</mw:displayName>
<mw:description>
This action provisions only the Oracle Home from the profile.
</mw:description>
<!-- [Mandatory] Define the complete command including the executable and parameters -->
<!-- EL is supported, variables can be taken from 3 sources: env, procedure and profile -->
<mw:command name="createDirectory" executable="mkdir"  errorMode="continue">
<mw:param value="-p"/>
<mw:param value="#{procedure.STAGING_DIRECTORY}" required="true"/>
</mw:command>
<mw:command name="unpack" executable="#{procedure.JAVA_HOME}/bin/jar" directory="#{procedure.STAGING_DIRECTORY}">
<mw:param value="-xvf"/>
<mw:param value="#{payload:tomcat_app.jar}" required="true"/>
</mw:command>
<mw:command name="configure" executable="/bin/sh" directory="#{procedure.STAGING_DIRECTORY}">
<mw:param value="#{payload:fixpath_tc.sh}" required="true"/>
<mw:param value="#{procedure.FREE_PORTS}"/>
<mw:env name="SERVICE_HOME" value="#{procedure.STAGING_DIRECTORY}" />
</mw:command>
</mw:action>

プロビジョニング・ステップの一部として、ステージング・ディレクトリでservice.outファイルを作成する必要があります(このファイルでは、変数jvm_jmx_portおよびjvm_service_console_urlを定義する必要があります)。

たとえば、前述のXMLファイルには、jvm_jmxポートとjvmサービスURLを出力するfixpath_tc.shというシェル・スクリプトがあります。スクリプトの内容は次のとおりです。

echo "jvm_jmx_port=${PORT_LIST[1]}" >> $SERVICE_HOME/service.out
echo "jvm_service_console_url=http://$HOSTNAME:${PORT_LIST[0]}/tc_hello/HelloWorld" >> $SERVICE_HOME/service.out

service.outファイルは、ステージング・ディレクトリに配置される必要があります。このファイルには、定義された変数の値が含まれます。たとえば、次のようになります。

jvm_jmx_port=2610
jvm_service_console_url=http://blr2201958.idc.oracle.com:2482/tc_hello/HelloWorld

注意: このステップは、Enterprise Manager CloudコンソールでJavaアプリケーション・サービス・ターゲットを検出しようとする場合に必須です。

起動: このアクションはプロビジョニング済のアプリケーションを起動します。

<mw:action name="start">
<!-- [Optional] Display name and description -->
<mw:displayName>
Start Tomcat Server
</mw:displayName>
<mw:description>
This action Starts the provisioned Tomcat Server
</mw:description>

<!-- [Mandatory] Define the complete command including the executable and parameters -->
<!-- EL is supported, variables can be taken from 3 sources: env, procedure and profile -->

<mw:command name="StartTomcat" executable="/bin/sh"  errorMode="continue" background="true" directory="#{procedure.STAGING_DIRECTORY}">
<mw:param value="#{procedure.STAGING_DIRECTORY}/apache-tomcat-7.0.54/bin/startup.sh" required="true"/>
</mw:command>

</mw:action>

停止: このアクションはプロビジョニング済のアプリケーションを停止します。

<mw:action name="stop">
<!-- [Optional] Display name and description -->
<mw:displayName>
Start Tomcat Server
</mw:displayName>
<mw:description>
This action stops the provisioned Tomcat Server
</mw:description>
<!-- [Mandatory] Define the complete command including the executable and parameters -->
<!-- EL is supported, variables can be taken from 3 sources: env, procedure and profile -->

<mw:command name="stopTomcat" executable="/bin/sh"  errorMode="continue"  directory="#{procedure.STAGING_DIRECTORY}" >
<mw:param value="apache-tomcat-7.0.54/bin/shutdown.sh" required="true"/>
</mw:command>

</mw:action>

<mw:action name="delete">
<!-- [Optional] Display name and description -->
<mw:displayName>
Remove Tomcat Server
</mw:displayName>
<mw:description>

削除: このアクションはプロビジョニング済のアプリケーションを停止して削除します。

</mw:description>
<!-- [Mandatory] Define the complete command including the executable and parameters -->
<!-- EL is supported, variables can be taken from 3 sources: env, procedure and profile -->

<mw:command name="stopTomcat" executable="/bin/sh"  errorMode="continue"  directory="#{procedure.STAGING_DIRECTORY}" >
<mw:param value="apache-tomcat-7.0.54/bin/shutdown.sh" required="true"/>
</mw:command>

<mw:command name="removeTomcat" executable="rm"  errorMode="continue"  directory="#{procedure.STAGING_DIRECTORY}" >
<mw:param value="-rf"/>
<mw:param value="#{procedure.STAGING_DIRECTORY}" required="true"/>
</mw:command>

</mw:action>

</mw:actions>

4. Enterprise ManagerでのJVMターゲットの検出はデフォルトでサポートされています。これを行うには、次のようにoracle.sysman.emas.mwc.jvmaas.discovery.JVMTargetDiscoveryスクリプトを実行します。

<mw:discovery className="oracle.sysman.emas.mwc.jvmaas.discovery.JVMTargetDiscovery" dpName="JVMDiscovery"/>
</mw:profile>

27.3 ミドルウェア・プロファイルのソフトウェア・ライブラリへのアップロード

すでに作成したカスタムXMLスクリプトを使用してプロファイルを作成するには、次のコマンドを実行します。

emcli create_mw_profile -input_file=propertiesXml:"/scratch/profile/genericProfiles/profile/tomcatService.xml"
-host=blr2201958.idc.oracle.com
-files="/scratch/profile/genericProfiles/profile/tomcat_app.jar,/scratch/profile/genericProfiles/profile/fixpath_tc.sh"

Where,
tomcatService.xml is the input file that describes the characteristics of the profile.
blr2201958.idc.oracle.com is the host target where the stored during provisioning.
tomcat_app.jar and fixpath_tc.sh are the files that have to be uploaded to Software Library.

プロファイルが作成された後でそのプロファイルにアクセスするには、Enterprise Manager Cloudコンソールにログインして、ソフトウェア・ライブラリ・ホームページに移動する必要があります。これには、「エンタープライズ」メニューから「パッチ適用とプロビジョニング」を選択し、「ソフトウェア・ライブラリ」をクリックします。ソフトウェア・ライブラリ・ホームページでミドルウェア・プロビジョニング汎用プロファイル・フォルダの下に新規プロファイルが表示されます。あるいは、emcli list_mw_profileコマンドを実行してプロファイルの詳細を表示することができます。

注意: プロファイルの特定のアクションで使用されるパラメータをすべてリストするには、emcliコマンドのlist_prov_parametersを使用します。たとえば、tomcatServiceプロファイルのアクション・プロビジョニングで使用されるすべてのパラメータの場合、次のコマンドを実行します。

emcli list_prov_parameters -profile="Middleware Provisioning/Generic Profile/tomcatService"
-action="provision"

27.4 Javaアプリケーション・プロファイルに基づくサービス・テンプレートの作成

前提条件

- カスタマイズされたミドルウェア・プロビジョニング・プロファイルをXMLファイルを使用して作成します。詳細は27.2項を参照してください。
汎用プロビジョニング・プロファイルの作成については、「ミドルウェア・プロビジョニング・プロファイルの作成」を参照してください。

- ソフトウェア・ライブラリにプロファイルをアップロードします。詳細は27.3項を参照してください。

ミドルウェア・サービス・テンプレートは、ミドルウェア・プールでサービス・インスタンスをプロビジョニングするために使用できるサービス定義です。

注意:
アクティブ・インスタンスを持つサービス・テンプレートを編集し、構成パラメータを変更できます。サービス・テンプレートが変更された場合:

- 変更が加えられた後に作成された新しいインスタンスでは、新しいパラメータが使用されます。

- 古いインスタンスまたはテンプレートが変更される前に作成されたインスタンスでは、以前の値が使用されます。

- ゾーンとロールに加えられた変更は、古いインスタンスと新しいインスタンスの両方に適用可能です。

Javaアプリケーションのプロファイルを作成するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューから「設定」を選択し、「はじめに」を選択します。特定のサービス・ファミリを設定する前に実行する必要がある一般的なタスクが表示されます。左パネルのミドルウェア・サービス・ファミリの横の「設定」リンクをクリックします。

4. ドロップダウン・メニューから「Javaアプリケーション・サービス」を選択して、「サービス・テンプレート」をクリックします。

5. Javaアプリケーション・サービス: サービス・テンプレート・ページで「作成」をクリックします。

6. サービス・テンプレートの名前と説明を入力します。説明は一意で、作成するサービス・テンプレートのタイプに関する情報を指定する必要があります。

7. テンプレートの作成に使用するJavaアプリケーション・プロファイルを選択します。検索アイコンをクリックし、「ソフトウェア・ライブラリ・コンポーネントの選択」ダイアログ・ボックスで、テンプレートを選択して、「選択」をクリックします。

8. 「次」をクリックします。特性ページで、ターゲットのプロパティのタグ付けと識別に使用される特性を指定します。テンプレートから作成されたサービス・インスタンスには特性があります。

9. 「次」をクリックします。ミドルウェア・サービス・テンプレートの作成: リソース・プロバイダ・ページで「追加」をクリックして、サービス・インスタンスをプロビジョニングできるミドルウェア・プールを選択します。ミドルウェア・プールが関連付けられているPaaSインフラストラクチャ・ゾーンが表示されます。

10. 「次」をクリックします。「構成」ページで、プロシージャ変数を含むカスタムXMLファイルでの定義として、またはinput.propertiesファイルの一部としてすべてのパラメータ(名前/値ペア)を参照できます。このページを使用して、プロパティの新しい値を入力するか、既存の値を更新します。また、ロックや非表示などの機能もサポートされており、パラメータのページの対応するチェック・ボックスを選択して、パラメータの値をロックしたり非表示にすることができます。
たとえば、サービス・テンプレートのOracle_INVENTORYの値をロックした場合、このテンプレートを使用してサービスをリクエストしたときに、このパラメータが読取り専用で編集できないことがわかります。

11. 「次」をクリックします。ロール・ページで「追加」をクリックし、このサービス・テンプレートを使用可能にするセルフ・サービス・ユーザー・ロールを選択します。選択したロールに属するすべてのユーザーが、このサービス・テンプレートを使用できます。

12. 「次」をクリックします。入力したすべての情報を確認し、「発行」をクリックします。新しく作成されたサービス・テンプレートが、ミドルウェア・クラウド・セルフ・サービス・ポータルの設定: サービス・テンプレート・ページに表示されます。「サービス・テンプレート名」リンクをクリックして、追加の詳細を表示できます。

28 MWaaSセルフ・サービス・ポータルの使用

この章では、セルフ・サービス・アプリケーションのユーザーがMWaaSセルフ・サービス・ポータルを使用してミドルウェア・サービスをリクエストおよび監視する手順について説明します。内容は次のとおりです。

- MWaaSセルフ・サービス・ポータルの使用

- ミドルウェア・サービスのリクエスト

- Middleware Serviceホーム・ページの表示

- SOA/OSBサービス・ホームページの表示

- Javaアプリケーション・サービス・インスタンス・ホームページの表示

- ソフトウェア・ライブラリへのJava EEコンポーネントのアップロード

- アプリケーション・ホームページの表示

28.1 MWaaSセルフ・サービス・ポータルの使用

ミドルウェア・セルフ・サービス・ポータルを使用すると、セルフ・サービス・ユーザーはミドルウェア・サービスを表示、監視およびリクエストできます。ユーザーは事前定義されている任意のサービス・テンプレートを使用して、ミドルウェア・サービスをリクエストできます。セルフ・サービス管理者の操作なしで、または最小限の操作で、アプリケーションのデプロイおよびアンデプロイ、データソースの作成、サービスのスケール・アップおよびスケール・ダウンを行うことができます。

前提条件

「ミドルウェア・クラウド・セルフ・サービス・ポータル」を表示するには、EM_SSA_USERロールを持つユーザーまたはEM_SSA_USER_BASEロールを持つユーザーとしてEnterprise Managerにログインします。これらのロールを持つユーザーは、ミドルウェア・クラウド・サービス・ファミリの一部である必要があり、「Service Bus」、「SOAインフラストラクチャ」および「WebLogic」サービス・タイプに対する権限を持っている必要があります。

MWaaSセルフ・サービス・ポータルを表示するには、次の手順に従います。

1. EM_SSA_USERロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「管理」ドロップダウン・リストから「ミドルウェア」を選択します。ミドルウェア・クラウド・セルフ・サービス・ポータル・ページが表示されます。

3. このページには次のタブがあります。

- ホーム: 「ホーム」タブには、次のリージョンがあります。

- 通知: このリージョンには、次の7日間以内に期限切れになるサービスの数、および過去7日以内に発行されたサービス・テンプレートの数が表示されます。

- 使用状況: ユーザーが作成したすべてのサービスを含む、SSAユーザーがこれまでに使用した合計割当て制限(サーバーおよびメモリー)を表示するには、「使用状況」アイコンをクリックします。この表は、各サービス・インスタンスで使用されている割当て制限の量を示します。割当て制限には、すべてのミドルウェア・サービス・インスタンス間で使用することが許可されている合計最大ヒープ・メモリーとWebLogicサーバーの総数の両方が含まれます。この表は、各サービス・インスタンスで使用されている割当て制限の量を示します。

注意:
追加されたOracle JVM以外のJVMは、「使用状況」リージョンに含まれません。

- サービス: このリージョンには、セルフ・サービス・ユーザーが所有するミドルウェア・サービスのリストが表示されます。各サービスについて、名前、ステータス、サービス・タイプ(Weblogic、SOAインフラストラクチャ、Service BusまたはJavaアプリケーション・サービス)、サービスが関連付けられるリソース・プロバイダ、ポリシー、サービスが作成された日付、サービスの有効期限、およびOracle JVM以外のJVM (存在する場合)が表示されます。権限を付与したサービスを表示することもできます。
サービスをリクエストするには、「新規サービスのリクエスト」をクリックします。詳細は、第28.2項「ミドルウェア・サービスのリクエスト」を参照してください。

「名前」リンクをクリックしてミドルウェア・サービス・ホームページにドリル・ダウンすると、サービスの詳細が表示されます。

サービスを削除するには、表からサービスを選択し、「削除」をクリックします。

表からサービスを選択し、「アクション」メニューの「起動」を選択できます。サービスの開始リクエストが発行されます。

表からサービスを選択し、「アクション」メニューの「停止」を選択できます。サービスの停止リクエストが発行されます。

サービス・インスタンスに対する「表示」、「管理」または「完全」権限を他のユーザーおよびロールに付与できます。他のユーザーおよびロールに付与した権限を取り消すこともできます。第29.4.1項「サービス・インスタンスに対する権限の付与、取消しおよび再割当て」を参照してください。

- リクエスト: このリージョンにすべてのリクエストのリストが表示されます。現在のユーザーが所有および共有するすべてのリクエストが表示されます。各リクエストに対して、リクエストのステータス、タイプ、開始日、および送信日が表示されます。リクエストの実行の詳細を表示するには、リクエスト名または「ステータス」アイコンをクリックします。このような詳細は、失敗したリクエストのトラブルシューティングに役立ちます。
「表示」メニューから列を選択し、リクエストの詳細を表示します。スケジュール済のリクエストを選択して、「再スケジュール」をクリックすると、リクエストを再スケジュールできます。スケジュール済リクエストを選択し、「削除」をクリックして、リクエストを削除できます。作成などのスケジュールされたリクエストが取り消された場合、他のすべての関連リクエストも取り消されます。

- チャージバック: このタブには、サービスのチャージバック分割データがすべて表示されます。発生したチャージは、サービスのリクエスト日付から現在の日付まで計算されます。このページには、次のリージョンがあります。

- チャージ傾向: このグラフは、時間の推移に伴う使用状況とチャージの傾向を表示します。

- 詳細: メトリックのリソースごとに、サービスのチャージバック・データを集約できます。このデータは、スプレッドシートなどの外部アプリケーションにエクスポートできます。

- チャージ・プラン: それぞれのPaaSインフラストラクチャ・ゾーンに割り当てられているチャージ・プランが表示されます。ゾーンを選択して価格を表示します。特定の期間におけるゾーンの各メトリックの比率が表示されます。

チャージバック・サービスの設定の詳細は、第43章「チャージバック管理」を参照してください。

- ライブラリ: このタブには、SSAユーザーが使用可能なJava EEアプリケーション・コンポーネントのリストが表示されます。次の操作を実行できます。

- アップロード: 新しいJava EEアプリケーション・コンポーネントをソフトウェア・ライブラリにアップロードできます。詳細は、第28.6項「ソフトウェア・ライブラリへのJava EEコンポーネントのアップロード」を参照してください。

- 削除: リストからJava EEコンポーネントを選択し、「削除」をクリックしてライブラリから削除します。

- 共有/共有を停止: 1つ以上のユーザーおよびロールとコンポーネントを共有できます。コンポーネントを選択し、「共有」をクリックします。選択と共有: ユーザーおよびロール・ウィンドウが表示されます。「タイプ」ドロップ・リストから、「ユーザー」または「ロール」を選択し、「検索」をクリックします。コンポーネントを共有できるユーザーまたはロールです。1つ以上のユーザーまたはロールを選択し、「共有」をクリックします。選択されたコンポーネントは、指定されたユーザーおよびロールで共有されます。コンポーネントの共有を停止するには、コンポーネントを選択して「共有を停止」をクリックします。

- ポリシー: 「ポリシー」タブをクリックして、定義したポリシーのリストを表示します。1つ以上のミドルウェア・サービスに対して新規のパフォーマンス・ベースまたはスケジュール・ベースのポリシーまたはポリシー・グループを作成し、それらのポリシーにスケール・アップまたはスケール・ダウンを定義できます。第28.1.2項「ミドルウェア・サービスの動的伸縮性ポリシーの定義」を参照してください。

28.1.1 プリファレンスの設定

ページの右上にある「プリファレンス」リンクをクリックして、「デフォルト・サービス・タイプ」、「通知用のデフォルト電子メール・アドレス」、「デフォルト・ロケール」、「デフォルトPaaSインフラストラクチャ・ゾーン」などのプリファレンスを設定します。ミドルウェア・クラウド・セルフ・サービス・ポータルをセルフ・サービス・ポータルへのログイン時に表示されるデフォルトのページとして設定する場合は、「デフォルト・サービス・タイプ」ドロップダウン・リストで「ミドルウェア」を選択し、「適用」をクリックします。プリファレンスの設定の詳細は、第8.9項「プリファレンスの表示」を参照してください。

28.1.2 ミドルウェア・サービスの動的伸縮性ポリシーの定義

注意:
これらのポリシーは、「Weblogic」サービス・タイプにのみ適用されます。

ポリシーを定義するには、次の手順に従います:

1. EM_SSA_USERロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「ポリシー」タブをクリックします。

3. ポリシーを作成するには、「作成」メニューから次のいずれかを選択します。

- スケジュール・ベースのポリシー

- パフォーマンス・ベースのポリシー

28.1.2.1 MWaaSのスケジュール・ポリシーの作成

たとえば、ミドルウェア・サービスを月曜日ごとにスケール・アップする必要があることを宣言するスケジュール・ベースのポリシーを作成する場合、次の手順に従います。

1. 「作成」メニューから、「スケジュール・ポリシー」を選択します。次のページが表示されます。

図28-1スケジュール・ポリシーの作成

2. ポリシーの名前と説明を入力します。

3. 「ポリシー・アクション」フィールドで「スケール・アップ」を選択し、「アクション・パラメータ」フィールドの「値」に2を入力します。

4. 「起動」フィールドで、このポリシーを有効にする日付を指定します。

5. 「繰返し」フィールドで「特定の曜日」を選択し、「曜日」フィールドで「月曜」を選択します。これにより、サービスは月曜日ごとに2ずつスケール・アップされます。

6. 「OK」をクリックして、ポリシーを作成します。ポリシー・ページに戻ると、定義したポリシーが「ポリシー」表に表示されます。これらのポリシーをターゲットに適用するには、「アソシエーション」リージョンで「追加」をクリックし、ポリシーを関連付ける必要のあるターゲットを選択します。

28.1.2.2 MWaaSのパフォーマンス・ポリシーの定義

パフォーマンス・ポリシーは、特定のターゲット・タイプやその関連ターゲットのパフォーマンス・メトリックに基づいて構成されます。メトリックに基づいたポリシーの条件およびルールを作成できます。パフォーマンス・ポリシーを定義するには、次の手順に従います:

1. ミドルウェア・セルフ・サービス・ポータルで「ポリシー」タブをクリックします。ポリシー・ページが表示されます。

2. 「作成」をクリックし、「パフォーマンス」ポリシー・タイプを選択します。

3. 一般情報ページで、ポリシーの名前および説明を入力します。

4. ルールおよび関係ページで右側のパネルからメトリックを選択して、「定義に追加」をクリックします。条件、値および発生回数を指定します。この条件を満たした場合にポリシーが実行されます。

5. 次をクリックします。パフォーマンス・ポリシーの作成: ルール・ページが表示されます。ポリシー・ルールが表示されます。

6. 「アクション」ドロップダウン・リストから「スケール・アップ」または「スケール・ダウン」を選択します。

7. 「アクション・パラメータ」フィールドで、「WebLogic Serverの数」の隣に値を入力します。ここで指定した値は、選択したアクションに基づいてWebLogicサーバーの数を増やしたり減らしたりするのに使用されます。

8. 「次へ」をクリックします。パフォーマンス・ポリシーの作成: 確認ページが表示されます。ポリシー詳細を確認して「保存」をクリックし、ミドルウェア・サービス・ポータルのポリシー・ページに戻ります。

9. 「アソシエーション」リージョンで「追加」をクリックし、このポリシーに関連付ける1つ以上のターゲットを選択します。関連付けられたターゲットは、「アソシエーション」リージョンに一覧表示されます。
ターゲットに関連付けられているポリシーのリストを表示するには、ターゲット・リンクをクリックします。ターゲットが関連付けられると、ポリシーはアクティブ化されます。ポリシー・アクション履歴を表示するには、「履歴の表示」をクリックします。

28.2 ミドルウェア・サービスのリクエスト

「新規サービスのリクエスト」オプションを使用して、新規ミドルウェア・サービスをリクエストできます。次のタイプのミドルウェア・サービスをリクエストできます。

- WebLogicサービス。第28.2.1項を参照してください。

- SOA/OSBサービス。第28.2.2項を参照してください。

28.2.1 WebLogicサービスのリクエスト

このページで、新しいWebLogicサービスをリクエストできます。

サービスをリクエストするには、次の手順に従います。

1. ミドルウェア・クラウド・セルフ・サービス・ポータルのホームページで、「新規サービスのリクエスト」をクリックします。

2. 「新規サービスのリクエスト」ウィンドウが表示されます。セルフ・サービス・ユーザーが使用可能なサービス・テンプレートのリストが表示されます。WebLogicサービス・テンプレートを選択し、「選択」をクリックして新規サービス・リクエスト・ページを表示します。

図28-2 新規ミドルウェア・サービス・インスタンスのリクエスト

3. サービスの名前を入力し、新しいサービスをデプロイするPaaSインフラストラクチャ・ゾーンを選択します。

4. 選択したサービス・テンプレートが、1つ以上のWebLogicサーバーを含むプロファイルに基づいている場合、「WebLogic Serverの数」フィールドで新しいサービス・インスタンス内に存在できるサーバーの初期数を指定します。

注意:
ここで指定したWebLogicサーバーの数は、プロファイルで指定されたサーバーの数より少なくすることはできません。

5. WebLogic Serverの最小数フィールドで、ミドルウェア・サービス・インスタンスに存在する必要があるWebLogicサーバーの最小数を指定します。ここで指定する値は、「WebLogic Serverの数」フィールドに指定した値以下である必要があります。

6. 「データベース」リージョンで、選択したテンプレートのミドルウェア・プロファイルと同じWebLogicドメインからクローニングされたデータベースを選択します。

注意:
「データベース」リージョンは、選択したテンプレートがJRF対応プロファイル(12.x以上のバージョン)に基づいている場合にのみ表示されます。

次のことができます。

- データベース・サービス・インスタンスの選択: このオプションを選択して、ドロップダウン・リストからデータベース・サービス・インスタンスを選択します。

- データベースURLの指定: データベースのURLを入力します。

- スキーマ・パスワード: スキーマ・パスワードを入力します。

7. サービス・リクエストのスケジュールを指定します。

- 開始日: 「即時」(リクエストをすぐに実行)または「後で」のいずれかを選択できます。「後で」オプションを選択した場合は、サービスを使用可能にする日付を指定します。

- 終了日: サービスを無期限に使用可能にする場合は、「無期限」を選択します。「終了」を選択した場合は、削除されて使用できなくなる日付を指定します。

8. 「WebLogicユーザー・アカウントの作成(オプション)」リージョンでは、オプションで、サービスがプロビジョニングされた後にサービス上に作成されるWebLogicユーザー・アカウントを指定できます。WebLogicのユーザー名とWebLogicのパスワードを入力します。ここで指定したユーザー名およびパスワードを使用して、WebLogic Server管理コンソールにアクセスできます。

注意:
WebLogicユーザー・アカウントの作成は、テンプレートの作成時にWebLogic管理コンソールおよびFusion Middleware ControlをSSAユーザーに公開フィールドが「はい」に設定されていた場合にのみ表示されます。

9. セルフ・サービス管理者にサービス・テンプレートの「詳細設定」へのアクセス権が付与されている場合、ここで「詳細」リージョンが表示されます。次のものを指定できます。

- ミドルウェア・サービス・インスタンスの共有: このチェック・ボックスを選択して、サービス・インスタンスを他のユーザーおよびロールで共有します。「追加」リージョンが表示されます。「追加」をクリックし、権限を付与するユーザーまたはロールを権限の付与ウィンドウで選択します。「付与する権限」ドロップダウン・リストで、付与する権限(「表示」、「管理」または「完全」)を選択して「付与」をクリックします。

注意:
権限は、「リクエスト設定」オプションを使用してセルフ・サービス管理者が明示的に付与する必要があります。詳細は、第29.4.1項「サービス・インスタンスに対する権限の付与、取消しおよび再割当て」を参照してください。

- 管理対象サーバーの起動引数: ミドルウェア・サービス・インスタンスのすべての管理対象サーバーを起動する場合に使用されるメモリーおよびJavaシステム・プロパティ引数を指定します。たとえば、次のように指定できます。
-Xms1280m -Xmx1280m -XX:PermSize=128m -XX:MaxPermSize=256m -Dweblogic.security.SSL.ignoreHostnameVerification=true

これらのパラメータは、サービス・テンプレートで指定された値を上書きします。

- オペレーティング・システム詳細: このチェック・ボックスを選択して、カスタム・オペレーティング・システム資格証明を指定します。次を指定する必要があります。

- ドメイン・ホームのベース・ディレクトリ: インスタンスが作成されるベース・ディレクトリを指定します。ここで指定されたパスは、ミドルウェア・プールで指定されたパスを上書きします。

- ユーザー名: 指定したベース・ディレクトリへの書込み権限を持つオペレーティング・システム・ユーザー名。

- パスワード:オペレーティング・システムのユーザーのパスワード。

注意:
ユーザー名およびパスワードのデフォルト値は、ミドルウェア・セルフ・サービス・ポータル・ページの「プリファレンス」オプションを使用して設定できます。これらの値が設定されると、ここに表示されます。

10. サービス・インスタンスのターゲット・プロパティを指定します。

11. 「発行」をクリックして、サービス・リクエストを作成します。このリクエストは、ミドルウェア・セルフ・サービス・ポータルのホームページの「リクエスト」表に表示されます。この表で、このリクエストのステータスを監視できます。リクエストが完了したら、ページをリフレッシュして、「サービス」表の新規サービスを表示できます。

28.2.2 Oracle Service BusまたはSOAインフラストラクチャ・サービスのリクエスト

ミドルウェア・セルフ・サービス・ポータルを使用してSOA/OSBサービスの表示、監視およびリクエストを行うには、SSA_USERロールでログインします。

前提条件

DBaaSを使用してデータベースをクローニングすることをお薦めします。データベースが別のSSAユーザー・アカウント(たとえばuser1)を使用してクローニングされている場合は、user2がSOA/OSBインスタンスをリクエストすると想定して、user1がuser2にデータベース・サービス・インスタンスに対するアクセス権を付与する必要があります。サービスをリクエストするには、次の手順に従います。

1. ミドルウェア・クラウド・セルフ・サービス・ポータルで、「新規サービスのリクエスト」をクリックします。

2. 「新規サービスのリクエスト」ダイアログ・ボックスが表示されます。SSAユーザーがアクセスできるゾーンで使用可能なサービス・テンプレートのリストが表示されます。サービス・テンプレートを選択し、「選択」をクリックしてサービス・リクエスト・ページを表示します。

3. 一般ページで、サービスの名前を入力し、新しいサービスをデプロイするPaaSインフラストラクチャ・ゾーンを選択します。

4. サービス・リクエストのスケジュールを指定します。

- 開始日: 「即時」(リクエストをすぐに実行)または「後で」のいずれかを選択します。「後で」を選択した場合は、サービスを使用可能にする日付を指定します。

- 終了日:サービスを無期限に使用可能にする場合は、「無期限」を選択します。「終了」を選択した場合は、サービスが削除されて使用できなくなる日付を指定します。

5. 構成ページで、次の詳細を入力します。

- SOAサービスのテンプレートの場合

- 「SOAデハイドレーション・ストア」セクションで、SOAデハイドレーション・ストアとして使用するデータベースを選択し、スキーマ・パスワードを指定します。
DBaaS RMANバックアップ・オプションを使用してクローニングされたデータベースを選択するオプションと、DBaaSの外部でクローニングされ、Cloud Controlで検出されたデータベースを選択するオプションがあります。後者のオプションを使用する場合は、データベースを検出した後で、データベース・ターゲットに対する表示権限をSSAユーザーに付与する必要があります。

- 「SOAトークン構成」セクションで、「値」フィールドをクリックし、SOAトークンの値をカスタマイズします。

- 「管理対象サーバーの起動引数」で、管理対象サーバーを起動するためのメモリーおよびJava引数を入力します。

- Oracle Service Busテンプレートの場合:

- データベース・インスタンスを選択し、OSBスキーマ・パスワードを指定します。

6. 「WebLogicユーザー・アカウントの作成」リージョンで、プロビジョニング後にサービスに対して作成するWebLogicユーザー・アカウントを指定します。「WebLogicユーザー名」と「WebLogicパスワード」に入力します。これらの資格証明は、WebLogic管理サーバー・コンソールおよびFusion Middlewareコンソールへのアクセスに使用されます。
これに加えて、OSBサービス・インスタンスの場合は、このセクションで指定した資格証明を使用してOSBコンソールにアクセスできます。

「次」をクリックします。

7. 確認ページで、構成詳細をすべて確認します。

8. 「発行」をクリックして、サービス・リクエストを作成します。このリクエストは、ミドルウェア・セルフ・サービス・ポータルのホームページの「リクエスト」表に表示されます。このリクエストのステータスをこの表で監視できます。リクエストが完了したら、ページをリフレッシュして、「サービス」表の新規サービスを表示できます。

28.3 Middleware Serviceホームページの表示

Middleware Serviceホームページには、「サービスのリクエスト」オプションを使用してリクエストしたサービスの詳細情報が表示されます。Middleware Serviceホームページを表示するには、「ミドルウェア・クラウド・セルフ・サービス・ポータル: ホーム」タブの「Middleware Services」リージョンにある「名前」リンクをクリックします。このページには、次のリージョンがあります。

- パフォーマンス・サマリー: サービスの可用性ステータス、WebLogicサービスのステータス・サマリーおよびこのサービスに関連付けられた基礎となるWebLogicクラスタのパフォーマンス・メトリックを表示します。次のチャートが表示されます。

- 可用性: サービスの可用性ステータスです。

- リソース使用率: クラスタの全サーバーのCPU使用率およびヒープ使用量のチャートが表示されます。

- レスポンスと負荷: 現在のサービスのリクエスト処理時間および1分当たりのリクエスト数が表示されます。

- 一般: サービスの様々なパフォーマンス・メトリックのチャートを表示します。

- デプロイメント: このリージョンは、WebLogicサービスに対してのみ表示されます。次の内容が含まれます。

- アプリケーション: このサービスにデプロイされているすべてのアプリケーションがリストされます。各アプリケーションに対して、名前、ステータス、および「アクティブなセッション」、「リクエスト処理時間」、リクエスト/分などの主要なメトリックが表示されます。「名前」リンクをクリックし、アプリケーション・ホームページにドリルダウンします。次の操作を実行できます。

- デプロイ: 「デプロイ」をクリックして、サービスにアプリケーションをデプロイします。詳細は、第28.3.1項「アプリケーションのデプロイおよび再デプロイ」を参照してください。

- 削除: アプリケーションを選択し、「削除」をクリックしてアプリケーションをアンデプロイします。

- 再デプロイ: 更新されたJava EEアプリケーション・コンポーネントがある場合は、アプリケーションを選択し、「再デプロイ」をクリックしてアプリケーションを再デプロイできます。詳細は、第28.3.1項「アプリケーションのデプロイおよび再デプロイ」を参照してください。

- 起動/停止: アプリケーションを選択し、「起動」または「停止」をクリックして、アプリケーションを起動または停止します。

- テスト: アプリケーションを選択し、「テスト」アイコンをクリックします。「アプリケーションURL」ダイアログ・ボックスには、URLのリストが表示されます。関連付けられたページに移動するには、URLをクリックします。

- ライブラリ: 任意のアプリケーションがライブラリとしてデプロイされている場合は、それらがここにリストされます。次の操作を行うことができます。

- デプロイ: 「デプロイ」をクリックして、サービスにアプリケーションをデプロイします。詳細は、「アプリケーションのデプロイ」を参照してください。

- 削除: アプリケーションを選択し、「削除」をクリックしてアプリケーションをアンデプロイします。

- 再デプロイ: 更新されたJava EEアプリケーション・コンポーネントがある場合は、アプリケーションを選択し、「再デプロイ」をクリックしてアプリケーションを再デプロイできます。

注意:
アプリケーションによって参照されているライブラリを選択した場合、「再デプロイ」ボタンおよび「削除」ボタンは無効であり、このライブラリは削除または再デプロイできません。

セルフ・サービス・ポータルを使用してデプロイする場合、通常のアプリケーションまたはライブラリとしてデプロイメントを作成できます。ライブラリは、他のデプロイメントと共有できるデプロイメントです。Middleware Serviceホームページでは、「アプリケーション」表に通常のアプリケーションが、「ライブラリ」表にライブラリが表示されます。ライブラリを削除したり再デプロイすることができますが、これらの操作が可能なのは、参照しているアプリケーションがない場合のみです。

- データソース: このリージョンは、WebLogicサービスに対してのみ表示されます。このサービスで使用可能なすべてのデータ・ソースが表示されます。データ・ソースごとに、データベースの名前、データベース・サービス名、JNDI名およびURLが表示されます。データベース・サービスを使用してデータ・ソースが作成されている場合、「データベース・サービス」列にその名前が表示されます。名前をクリックすると、データベース・サービス・ホーム・ページにドリルダウンします。新しいデータ・ソースの作成、既存データ・ソースの編集または削除、および指定されたデータ・ソースの接続のテストを実行できます。

- リクエスト: この表には、このサービスに発行されたすべてのリクエストが表示されます。これには、データ・ソースのデプロイ、アンデプロイ、再デプロイ、スケール・アップ、スケール・ダウン、起動、停止、作成、編集および削除などのリクエストが含まれます。
次のオプションは、「ミドルウェア・サービス・インスタンス」メニューから使用できます。

- 終了日の設定: このオプションを選択して、ミドルウェア・サービスの終了日を指定します。サービスの終了日を設定できます。表からサービスを選択して「終了日の設定」をクリックします。表示されるポップアップ・ウィンドウで、ミドルウェア・サービス・インスタンスの新しい終了日を指定できます。サービスを有効期限切れにしたくない場合は、「無期限」を選択して「OK」をクリックします。

- 「開始」および「停止」: 「Middleware Service」メニューから適切なオプションを選択すると、サービスを開始または停止できます。

- 「スケール・アップ」および「スケール・ダウン」: 第28.3.2項「サービスのスケール・アップおよびスケール・ダウン」を参照してください。

- サービス・インスタンスの設定: ここには、「WebLogic Serverの最小数」の現在の値が表示され、その値を変更できます。

- メトリックの選択: 新しいチャートの追加、既存のチャートの削除、およびチャートへのメトリックのドラッグ・アンド・ドロップを行うには、「メトリックの選択」をクリックします。表示されるメトリック・パレット・ウィンドウで、メトリックを選択するか、既存のチャートにメトリックをドラッグ・アンド・ドロップするか、あるいは新しいチャートを作成します。デフォルトでは、すべての新規チャートは「一般」セクションに表示されますが、別のセクションにドラッグ・アンド・ドロップできます。「メトリック・パレット」でボックスの選択を解除するか、チャートの右側のドラッグ・バーの「x」をクリックして、チャート/メトリックを削除できます。このバーでチャートをドラッグして、これらのセクション内でチャートを移動できます。

- デフォルト・チャートのリストア: チャートをデフォルト設定にリストアするには「デフォルト・チャートのリストア」をクリックします。すべてのチャートの追加、変更および削除は特定のサービスに適用されます。SSAユーザーは、サービスごとに異なるチャートを指定できます。

- ログ・メッセージ: メッセージ・タイプ、日付などでソートされたメッセージのリストを表示するには、「ログ・メッセージ」をクリックします。日付範囲、メッセージ・タイプを選択し、「メッセージ」フィールドに他のフィルタを指定します。「フィールドの追加」をクリックし、メッセージに含める他のフィールドを選択して、「検索」をクリックします。検索基準を満たす最初の1000件のメッセージが表示されます。.txt、.xmlまたは.csv形式のログ・ファイルにメッセージをエクスポートするには、「メッセージをファイルにエクスポート」をクリックします。

- WebLogicサーバー管理コンソール: WebLogic管理コンソールを起動するには、このオプションをクリックします。

- Fusion Middleware Control: Fusion Middleware Controlコンソールを起動するには、このオプションをクリックします。

注意:
WebLogic Server管理コンソールおよびFusion Middleware Controlインタフェースでは、Oracle Fusion Middlewareコンポーネントを管理および監視できます。「WebLogicサーバー管理コンソール」および「Fusion Middleware Control」オプションは、ミドルウェア・サービス・テンプレートで「WebLogicおよびFMWコンソールURLをSSAユーザーに公開します」フィールドが「はい」に設定されている場合のみ、「ミドルウェア・サービス」メニューで使用できます。詳細は、第25.6項「WebLogicサービス・テンプレートの作成」を参照してください。

28.3.1 アプリケーションのデプロイおよび再デプロイ

事前構成されたJava EEアプリケーションをサービス・インスタンスにデプロイできます。アプリケーションをデプロイするには、次の手順に従います。

1. EM_SSA_USERロールを持つユーザーとしてEnterprise Managerにログインし、ミドルウェア・クラウド・セルフ・サービス・ポータル・ページに移動します。

2. 「Middleware Service」リージョンで「名前」リンクをクリックします。Middleware Serviceホーム・ページが表示されます。

3. 「アプリケーション」表の「デプロイ」をクリックします。アプリケーションのデプロイ・ページが表示されます。

図28-3 アプリケーションのデプロイ

4. 次の詳細を入力します。

- アプリケーション名: デプロイするアプリケーションの名前を入力します。

- アプリケーション・コンポーネント: 次の操作を選択できます。

- ソフトウェア・ライブラリからアプリケーション・コンポーネントを選択します。: 「検索」アイコンをクリックし、ソフトウェア・ライブラリからJava EEアプリケーション・コンポーネントを選択します。

- デスクトップからアプリケーション・アーカイブを選択「参照」をクリックし、デスクトップからアプリケーション・アーカイブを選択します。

- アプリケーションとしてデプロイ: デプロイメントは通常のアプリケーションまたはライブラリとして作成できます。このオプションを選択した場合、「デプロイ・プラン」フィールドで「参照」をクリックして、デプロイメント・オプションを含む.xmlファイルを選択します。このファイルは、アプリケーション・コンポーネントで指定されたデプロイ・プラン(存在する場合)を上書きします。

- ライブラリとしてデプロイ: アプリケーションをライブラリとしてデプロイできます。ライブラリは、他のデプロイメントと共有できるデプロイメントです。ライブラリは、参照側アプリケーションを実行中のすべてのターゲットで使用可能である必要があります。

5. いつデプロイ操作を発生させるかを指定し、「デプロイ」をクリックします。アプリケーションのデプロイ・リクエストが作成されたら、確認のメッセージが表示されるミドルウェア・サービスのホームページに戻ります。

28.3.1.1 アプリケーションの再デプロイ

サービス・インスタンスにデプロイされたアプリケーションを再デプロイできます。アプリケーションを再デプロイするには、デプロイされたアプリケーションを「アプリケーション」表から選択し、「再デプロイ」をクリックします。アプリケーションの再デプロイ・ページで、再デプロイするアプリケーション・コンポーネント、ある場合はデプロイ・プランを選択し、「再デプロイ」をクリックします。アプリケーションが再デプロイされたことを示す確認メッセージが表示されます。

28.3.1.2 アプリケーションの削除

デプロイされたアプリケーションを削除(アンデプロイ)できます。削除するアプリケーションを「アプリケーション」表から選択し、「削除」をクリックします。確認メッセージが表示されます。「はい」をクリックして、アプリケーションをアンデプロイします。

28.3.2 サービスのスケール・アップおよびスケール・ダウン

サービスをスケール・アップまたはスケール・ダウンできます。

注意:
「スケール・アップ」および「スケール・ダウン」オプションは、サービスが、1つのクラスタを伴うミドルウェア・プロビジョニング・プロファイルを含むミドルウェア・サービス・テンプレートに基づく場合のみ使用できます。プロファイルにクラスタが含まれない場合、これらのメニュー・オプションは使用できません。

ミドルウェア・サービスのホームページで、「Middleware Service」メニューから次のオプションを選択します。

- スケール・アップ: サーバーをもう1つ追加することで、サービスをスケール・アップできます。追加できるサーバーの数は、割当てごとに制限されています。「スケール・アップ」をクリックし、サービスをスケール・アップするサーバーの数を入力します。「発行」をクリックし、スケール・アップ・リクエストを発行して、サーバーを追加します。

- スケール・ダウン: 「スケール・ダウン」をクリックし、サービスをスケール・ダウンするサーバーの数を入力します。「発行」をクリックし、スケール・ダウン・リクエストを発行して、サーバーの数を減らします。

28.3.3 データ・ソースの作成

WebLogic Serverでデータベース接続を構成するには、データ・ソースをWebLogicドメインに追加します。WebLogic JDBCデータ・ソースにより、データベースへのアクセスおよびデータベース接続管理が可能になります。アプリケーションは、データベースにアクセスする前に、JDBCデータ・ソースを使用するよう構成する必要があります。

サービスのデータ・ソースを作成するには、次の手順に従います。

1. EM_SSA_USERロールを持つユーザーとしてEnterprise Managerにログインし、ミドルウェア・クラウド・セルフ・サービス・ポータル・ページに移動します。

2. ミドルウェア・サービスのホームページにある「データ・ソース」表の「作成」をクリックします。データ・ソースの作成ページが表示されます。

図28-4 データソースの作成

3. 「データソース名」と「JNDI名」に入力します。

4. 「データベース・ドライバ・クラス」を選択します。

5. データベース・サービス・インスタンスを構成済の場合は、「データベース・サービス」を選択でき、これにより対応するURLが表示されます。構成済でない場合、データベースURLを手動で入力する必要があります。

6. 「データベース・ユーザー名」および「パスワード」を指定します。

7. 「作成」をクリックしてデータソースを作成します。

28.3.3.1 データ・ソースの編集

データ・ソースのプロパティを編集できます。ミドルウェア・サービスのホームページにある「データ・ソース」表の「名前」リンクをクリックします。データソースの編集ページが表示されます。データ・ソースのプロパティを編集できます。一部のプロパティを変更した場合は、データ・ソースを再デプロイし、そのデータ・ソースを使用するアプリケーションを再起動する必要があります。

28.4 SOA/OSBサービス・ホームページの表示

SOAホームページには、「リクエスト」オプションを使用してリクエストしたサービスの詳細情報が表示されます。Middleware Serviceホームページを表示するには、「ミドルウェア・クラウド・セルフ・サービス・ポータル: ホーム」タブの「Middleware Services」リージョンにある「名前」リンクをクリックします。

このページには、次のリージョンがあります。

- パフォーマンス・サマリー: サービスの可用性ステータス、WebLogicサービスのステータス・サマリーおよびこのサービスに関連付けられた基礎となるWebLogicクラスタのパフォーマンス・メトリックを表示します。次のチャートが表示されます。

- 可用性: サービスの可用性ステータスです。

- リソース使用率: クラスタの全サーバーのCPU使用率およびヒープ使用量のチャートが表示されます。

- レスポンスと負荷: 現在のサービスのリクエスト処理時間および1分当たりのリクエスト数が表示されます。

- 一般: サービスの様々なパフォーマンス・メトリックのチャートを表示します。

- リクエスト: この表には、このサービスに発行されたすべてのリクエストが表示されます。
次のオプションは、「ミドルウェア・サービス・インスタンス」メニューから使用できます。

- 終了日の設定: このオプションを選択して、ミドルウェア・サービスの終了日を指定します。

- 「開始」および「停止」: 「Middleware Service」メニューから適切なオプションを選択すると、サービスを開始または停止できます。

- 「スケール・アップ」および「スケール・ダウン」: 第28.3.2項「サービスのスケール・アップおよびスケール・ダウン」を参照してください。

- メトリックの選択: 新しいチャートの追加、既存のチャートの削除、およびチャートへのメトリックのドラッグ・アンド・ドロップを行うには、「メトリックの選択」をクリックします。表示されるメトリック・パレット・ウィンドウで、メトリックを選択するか、既存のチャートにメトリックをドラッグ・アンド・ドロップするか、あるいは新しいチャートを作成します。デフォルトでは、すべての新規チャートは「一般」セクションに表示されますが、別のセクションにドラッグ・アンド・ドロップできます。「メトリック・パレット」でボックスの選択を解除するか、チャートの右側のドラッグ・バーの「x」をクリックして、チャート/メトリックを削除できます。このバーでチャートをドラッグして、これらのセクション内でチャートを移動できます。

- デフォルト・チャートのリストア: チャートをデフォルト設定にリストアするには「デフォルト・チャートのリストア」をクリックします。すべてのチャートの追加、変更および削除は特定のサービスに適用されます。SSAユーザーは、サービスごとに異なるチャートを指定できます。

- ログ・メッセージ: メッセージ・タイプ、日付などでソートされたメッセージのリストを表示するには、「ログ・メッセージ」をクリックします。日付範囲、メッセージ・タイプを選択し、「メッセージ」フィールドに他のフィルタを指定します。「フィールドの追加」をクリックし、メッセージに含める他のフィールドを選択して、「検索」をクリックします。検索基準を満たす最初の1000件のメッセージが表示されます。.txt、.xmlまたは.csv形式のログ・ファイルにメッセージをエクスポートするには、「メッセージをファイルにエクスポート」をクリックします。

- WebLogicサーバー管理コンソール: WebLogic管理コンソールを起動するには、このオプションをクリックします。

- Fusion Middleware Control: Fusion Middleware Controlコンソールを起動するには、このオプションをクリックします。

注意:
WebLogic Server管理コンソールおよびFusion Middleware Controlインタフェースでは、Oracle Fusion Middlewareコンポーネントを管理および監視できます。「WebLogicサーバー管理コンソール」および「Fusion Middleware Control」オプションは、ミドルウェア・サービス・テンプレートで「WebLogicおよびFMWコンソールURLをSSAユーザーに公開します」フィールドが1に設定されている場合のみ、「Middleware Service」メニューで使用できます。

28.5 Javaアプリケーション・サービス・インスタンス・ホームページの表示

「一般」セクションに、サービスにアクセスするために使用できるURLが表示されます。「JVMDエージェントのダウンロード」をクリックして、JVM診断エージェントのwarファイルをダウンロードします。監視対象のアプリケーション・サーバーのWebAppsフォルダにwarファイルをデプロイしてください。こうすることで、JVM診断エージェントがCloud ControlでJavaアプリケーション・ターゲットの監視を開始できます。

「Javaアプリケーション・サービスの履歴」セクションには、アプリケーションのイベント・ログのクイック・ビューがタイムスタンプとともに提供されます。基本的には、特定のアプリケーションの起動時刻または作成時刻などの詳細がキャプチャされてこのセクションに記録されます。

service.outファイルに出力されるパラメータは「サービスの詳細」セクションに表示されます。これは、JVM JMXポートに割り当てられたポート番号を確認する場合に特に便利です。

さらに、メモリー使用量およびパフォーマンス・サマリーの詳細がこのページでも確認できます。

28.6 ソフトウェア・ライブラリへのJava EEコンポーネントのアップロード

事前構成されたear、war、jarまたはrarファイルを、ソフトウェア・ライブラリにアップロードできます。これらのファイルは、Java EEアプリケーション・コンポーネントとしてソフトウェア・ライブラリにアップロードされ、サービスにデプロイされます。ファイルをソフトウェア・ライブラリにアップロードするには、「ライブラリ」タブをクリックします。「ソフトウェア・ライブラリへのアップロード」フィールドが表示されます。

図28-5 ソフトウェア・ライブラリへのアップロード

アップロードするファイルの名前と説明を入力します。その後、次のようにファイルをアップロードするよう選択できます。

- 個々のファイル: 「ファイルの個別アップロード」オプションを選択した場合は、次の内容を指定する必要があります。

- アーカイブ: ソフトウェア・ライブラリにアップロードするアーカイブ・ファイルを選択します。これは、ear、war、jarまたはrarファイルです。オプションで、次の内容を指定できます。

- デプロイ・プラン: これは、Java EEアプリケーション・コンポーネントのデプロイメント・オプションを含むxmlファイルです。

- デプロイ前スクリプト: これはWLSTコマンドが入っているスクリプトです。アプリケーションがデプロイされる前に、各インスタンスに関連付けられている管理サーバーでこのスクリプトが実行されます。このスクリプトを使用して、データ・ソース、JMSエンド・ポイント、およびデプロイするアプリケーションに必要になる可能性があるその他のリソースを作成できます。

- デプロイ後スクリプト: これは、アプリケーションのデプロイ後に管理エージェントによって管理サーバーで実行されるWLSTスクリプトです。このスクリプトを使用して、デプロイメント後の構成を実行できます。たとえば、デプロイ前スクリプトによって変更された内容をロールバックしたり取り消す必要がある場合に、このオプションを選択します。

- Zipファイル: 「Zipファイルのアップロード」オプションを選択した場合は、Zipファイルのコンテンツを説明するJavaEEAppComp.manifestファイルを含むZipファイルをアップロードする必要があります。

「アップロード」をクリックして、ファイルをソフトウェア・ライブラリにアップロードします。

28.7 アプリケーション・ホームページの表示

アプリケーションのホームページを表示するには、アプリケーションを選択し、ミドルウェア・サービスのホームページにある「アプリケーション」表の「名前」リンクをクリックします。

図28-6 MWaaSアプリケーションのホーム

このページには、レスポンスとロードが表示されたチャートとともに、アプリケーションのパフォーマンスと可用性が表示されます。「アプリケーション」メニューのオプションを使用して、アプリケーションの再デプロイ、削除(アンデプロイ)、起動または停止を実行できます。

第X部

PaaSクラウドの監視

この項では、Database as a Service (DBaaS)とMiddleware as a Service (MWaaS)を管理および監視する方法について説明します。次の章で構成されています。

- 第29章「PaaSクラウドの管理および監視」

29 PaaSクラウドの管理および監視

この章では、DBaaSおよびMWaaSサービスの監視に使用できる様々なオプションについて説明します。内容は次のとおりです。

- クラウド・ホームページの表示

- リソース・プロバイダのリストの表示

- サービス・テンプレートのリストの表示

- サービス・インスタンスのリストの表示

- 「クラウド」の「リクエスト・ダッシュボード」の表示

- すべてのクラウド・リクエストの表示

- PaaSインフラストラクチャ・ゾーン・ホーム・ページの表示

- データベース・プール・ホーム・ページの表示

- スキーマ・プール・ホーム・ページの表示

- プラガブル・データベース・プール・ホームページの表示

- ミドルウェア・プール・ホーム・ページの表示

29.1 クラウド・ホーム・ページの表示

クラウド・サービスの設定後、1人以上のセルフ・サービス・ユーザーがリクエストを発行すると、クラウド・ホームページに様々なサービス・タイプの統合されたビューが表示されます。ロールアップされたデータを使用して、問題のある領域を特定し詳細にドリルダウンできます。「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択して、このページに移動します。

図29-1 クラウド・ホーム・ページ

注意:

- ページを表示するには、クラウド・ターゲットでの表示権限が必要です。初期状態のユーザー・ロールはデフォルトでこの権限を持っています。

- パーソナライズ・オプションを使用すると、クラウド・ホームページをカスタマイズできます。このオプションでは、リージョンの追加または削除、ページ・レイアウトの変更などを行えます。

- 一般: このリージョンには、次が表示されます。

- リソース・プロバイダ: 作成されたPaaSインフラストラクチャ・ゾーンおよびソフトウェア・プールの合計数が表示されます。リンクをクリックし、リソース・プロバイダ・ページにドリルダウンします。

- サービス・テンプレート: 定義されたサービス・テンプレートの合計数。

- リクエスト合計: 構成されたクラウド・サービスの合計リクエスト数。リンクをクリックして、すべてのリクエスト・ページにドリルダウンします。

- サービス・インスタンス: 起動または停止しているメンバーの合計数。リンクをクリックして、サービス・インスタンス・ページにドリルダウンします。

- リクエスト・ステータス: 指定した期間内のサービス・リクエストのステータス。デフォルトでは、過去24時間のリクエスト・ステータスが表示されますが、7日間、30日間など別の期間を選択できます。すべてのリクエストまたは特定のサービス・タイプのリクエスト・ステータスを表示できます。特定のサービス・タイプのステータスを表示するには、「表示」ドロップダウン・リストからタイプを選択します。

- 問題: 構成されたすべてのサービス・プロバイダの可用性、パフォーマンス、セキュリティおよびその他のインシデント。

- 上位リソース・プロバイダ使用率: このリージョンは、構成されたリソース・プロバイダの上位レベルのリソース使用率を示します。たとえば、PaaSインフラストラクチャ・ゾーンのCPUおよびメモリー使用率などです。詳細を表示するには、リージョン上部にある「マップの表示」リンクをクリックします。リソース・プロバイダ使用率に関する詳細情報を含むヒート・マップ・ページが表示されます。リソース・プロバイダの数および色を計算するためのしきい値を、「パーソナライズ」機能を使用して構成できます。

- 最後の30日間の日次チャージ: すべてのサービス・タイプのロールアップされたチャージバック・データが表示されます。

- リクエストが多い上位サービス: このリージョンには、最もリクエストの多いサービス・テンプレートがリストされます。24時間、7日間または30日間の選択した期間について、ユーザーまたはサービス・テンプレート別にサービスの利用傾向を表示できます。

「クラウド・ホーム」メニューから次のオプションを使用できます。

注意:
次のページは、EM_SSA_ADMINISTRATORロールを持っているユーザーのみがアクセスできます。これらページを変更するには、対応するサービスおよびファミリでの管理権限を持っている必要があります。初期状態の管理者はデフォルトでこの権限を持っています。

- リソース・プロバイダ: 少なくともターゲットの表示権限を持つリソース・プロバイダのリストを表示できます。新規リソース・プロバイダの作成、既存のリソース・プロバイダの編集または削除を行えます。「リソース・プロバイダ・ページ」を参照してください。
注意: 新規サービス・プロバイダを作成するには、そのリソース・プロバイダ・ターゲット・タイプに対する「ターゲットの作成」権限が必要です。

- サービス・テンプレート: 様々なサービス・ファミリ間でサービス・テンプレートを作成、編集および削除することができるサービス・テンプレート・ページにこのオプションを使用します。詳細は、「サービス・テンプレート・ページ」を参照してください。

- サービス・インスタンス: サービス・インスタンスのリストを表示します。詳細は、「サービス・インスタンス・ページ」を参照してください。

- リクエスト: すべてのリクエストを表示、またはリクエスト・ダッシュボード・ページでサマリーを表示するにはこのオプションを使用します。

- 設定: 「設定」メニューでは異なるサービス・タイプ間でグローバル設定を定義できます。使用可能なオプションは次のとおりです。

- はじめに: はじめにページには、サービス・タイプを構成するために必要な最低限のタスクおよびこれらのタスクを完了する必要がある順序がリストされます。このページは、製品に精通していないセルフ・サービス管理者にとって役に立ちます。

- サービス設定: MWaaS用のロード・バランシング設定など、サービス固有の設定を指定できます。

- リクエスト設定: 多くの様々なレベルで(すべてのサービスから特定のサービス・タイプまで)リクエスト設定を指定できます。「リクエスト設定の構成」を参照してください。

- 割当て制限: 各サービス・ファミリの割当て制限を定義できます。「割当ての設定」を参照してください

- データ・ソース: サービス・タイプで必要な場合、プロファイルの作成ウィザードおよびテスト・マスターの作成ウィザードを起動するために使用します。

29.1.1 「リソース・プロバイダ使用率ヒート・マップ」の表示

「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページで、「上位リソース・プロバイダ使用率(%)」リージョンの「マップの表示」リンクをクリックして、「リソース・プロバイダ使用率ヒート・マップ」を表示します。

図29-2 リソース・プロバイダ使用率ヒート・マップ

このページには、PaaSインフラストラクチャ・ゾーン、データベース・プール、ミドルウェア・プールなどのすべてのリソース・プロバイダの使用率メトリックが表示されます。このヒート・マップは、リソース・プロバイダ使用率をグラフィカルに表示したものです。ヒート・マップ・ビューでは、メトリックがボックスとして表示され、各ボックスのサイズと色は潜在的な問題の領域を示します。ボックスを選択し、メトリック値をクリックして、メトリック履歴ページに移動します。

29.2 リソース・プロバイダのリストの表示

リソース・プロバイダは、特定のサービス・タイプのクラウド・サービスのプロビジョニングに必要な実際のリソースを含むエンティティです。「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択して、クラウド・ホーム・ページに移動します。「クラウド・ホーム」メニューから、「リソース・プロバイダ」を選択して、リソース・プロバイダのリストを表示します。

図29-3 リソース・プロバイダ・ページ

- 名前: リソース・プロバイダの名前。

- タイプ: リソース・プロバイダのタイプ。これには次のものがあります。

- PaaSインフラストラクチャ・ゾーン

- ミドルウェア・プール

- データベース・プール

- スキーマ・プール

- プラガブル・データベース・プール

- 所有者: リソース・プロバイダを作成したユーザー。

- 親: リソース・プロバイダに親がある場合、ここにリストされます。たとえば、PaaSインフラストラクチャ・ゾーンはミドルウェアまたはデータベース・プールの親です。

- メンバー: リソース・プロバイダに関連付けられているメンバー(これにはメンバー・タイプおよびメンバー番号が含まれます)。

- サービス・インスタンス: リソース・プロバイダに関連付けられているサービス・インスタンス。リンクをクリックし、ホーム・ページにドリルダウンします。

- 説明: リソース・プロバイダの作成時に管理者が指定したリソース・プロバイダの説明。

リソース・プロバイダの作成、既存のリソース・プロバイダの編集またはリソース・プロバイダの削除を行えます。

29.3 サービス・テンプレートのリストの表示

「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「サービス・テンプレート」を選択して、このページを表示します。

図29-4 サービス・テンプレート・ページ

このページには、異なるサービス・ファミリ間でセルフ・サービス管理者が使用できるすべてのサービス・テンプレートのリストが表示されます。サービス・テンプレートごとに、次の詳細が表示されます。

- サービス・テンプレートの名前

- 属しているサービス・ファミリ(たとえば、データベース、ミドルウェアなど)。

- サービスのタイプ。

- サービスの所有者。

- サービス・テンプレートに関連付けられているリソース・プロバイダ。

- サービス・テンプレートに関連付けられているサービス・インスタンスの数。

- サービス・テンプレートの説明。

実行可能な操作は次のとおりです。

- 作成: このオプションを選択して、サービス・テンプレートの作成ウィザードを起動します。

- 類似作成: このオプションを選択して、既存のサービス・テンプレートのコピーを作成します。

- 編集: サービス・テンプレートを選択して「編集」をクリックすると、既存のテンプレートを変更できます。テンプレートの変更後に「発行」をクリックすると、テンプレートが更新されます。

- 削除: サービス・テンプレートを選択して「削除」をクリックすると、テンプレートを削除できます。

- 権限の付与と取消し: EM_SSA_ADMINISTRATORは、EM_SSA_ADMINISTRATORロールを持つ他のユーザーにサービス・テンプレートに対する権限を付与および取り消すことができます。

29.3.1 サービス・テンプレート権限の付与、取消しおよび再割当て

所有者(テンプレートを作成したセルフ・サービス管理者)またはSUPER_USERは、1つ以上のユーザーまたはロールにサービス・テンプレートに対する権限を付与または取り消すことができます。SUPER_USERのみが、他のユーザーおよびロールにすべてのサービス・テンプレートに対する権限を付与または取り消すことができます。

- 権限の付与: 権限が付与されるサービス・テンプレートを選択し、「アクション」メニューから「権限」を選択します。
他のユーザーに権限を付与するには、「タイプ」ドロップダウン・リストから「ユーザー」を選択し、「検索」をクリックします。権限を付与できるユーザーのリストが表示されます。リストから1人以上のユーザーを選択し、「権限」をクリックして権限を付与します。

「付与する権限の選択」ドロップダウン・リストで、「管理」または「すべて」を選択してユーザーに権限を付与します。ユーザーにサービス・テンプレートの構成の編集および変更を許可するには、「管理」アクセスを選択します。ユーザーにサービス・テンプレートの編集、削除および変更を許可するには、「完全」アクセスを選択します。

1つ以上のユーザー・ロールに権限を付与するには、「タイプ」ドロップダウン・リストで「ロール」を選択し、「検索」をクリックします。権限を付与できるロールのリストが表示されます。リストから1つ以上のロールを選択し、「権限」をクリックして権限を付与します。

- 取消: 権限が付与されているサービス・テンプレートを選択し、「取消」をクリックします。「検索」ドロップダウン・リストで、次のいずれか1つを選択できます。

- 名前: 権限が付与されているユーザーの名前。

- タイプ: 権限が付与されているタイプ(「ユーザー」または「ロール」)を選択します。

- 権限: 付与されている権限のタイプ(「表示」、「管理」または「すべて」)。

検索基準に基づいて、権限が付与されているユーザーまたはロールのリストが表示されます。権限を取り消す対象のユーザーまたはロールを選択し、「取消」をクリックします。

- サービス・テンプレートの再割当て: スーパー管理者ユーザーとしてログインし、テンプレートを選択して「再割当て」をクリックすると、サービス・テンプレートの所有権を別のユーザーに再割当てできます。ユーザーを選択して「再割当て」をクリックすると、サービス・テンプレートを再割当てできます。

29.4 サービス・インスタンスのリストの表示

サービス・インスタンス・ページには、すべてのサービス・インスタンスのリストが表示されます。「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「サービス・インスタンス」を選択して、このページを表示します。

図29-5 サービス・インスタンス・ページ

次の詳細が表示されます。

- サービス・インスタンス名: サービス・インスタンスに関連付けられている名前。リンクをクリックして、ターゲットのホームページにドリルダウンします。

- ステータス: サービス・インスタンスのステータス。

- サービス・インスタンス・タイプ: リクエストのタイプ(ミドルウェアまたはデータベース)。

- リソース・プロバイダ: インスタンスが関連付けられているリソース・プロバイダ。

- サービス・テンプレート: サービス・インスタンスの作成に使用されたサービス・テンプレート。

- ポリシー: サービス・インスタンスに関連付けられているポリシー数。ポリシー・ページにドリルダウンするには、リンクをクリックします。

- 作成者: このサービス・インスタンスを作成したユーザー。

- 作成日: サービスが作成された日付。

- 有効期限: サービスが期限切れになり、使用できなくなる日付。

実行可能な操作は次のとおりです。

注意:
これらの操作が実行されるサービス・タイプでの管理権限を持っている必要があります。この権限は、初期状態のセルフ・サービス管理者ロールにデフォルトで割り当てられます。

- 開始: 停止されているサービス・インスタンスを選択して「開始」をクリックすると、サービスを開始できます。

- 停止: 実行中のサービスを選択して「停止」をクリックすると、サービスを停止できます。

- 削除: サービスを選択し、「削除」をクリックします。スケジュールを指定して、サービス・インスタンスをすぐに削除するか、後日削除するかを示すように求められます。スケジュールを選択して「OK」をクリックすると、リクエストを削除できます。

- 履歴: サービスを選択して「履歴」をクリックすると、サービス・インスタンスで実行されているすべてのアクションのリストを表示できます。

- 権限の付与、取消しおよび再割当て: 「サービス・インスタンスに対する権限の付与、取消しおよび再割当て」を参照してください。

29.4.1 サービス・インスタンスに対する権限の付与、取消しおよび再割当て

セルフ・サービス管理者は、1つ以上のユーザーまたはロールにサービス・インスタンスに対する権限を付与または取り消すことができます。また、セルフ・サービス・ユーザーは、所有しているサービス・インスタンスに対する権限を付与または取り消すこともできます。サービス・インスタンスを作成したユーザー(所有者)またはSUPER_USERは、サービス・インスタンスの所有権を別のユーザーに再割当てできます。

サービス・インスタンスへのアクセス権を付与または取り消すには、「エンタープライズ」→「クラウド・ホーム」→「設定」→「リクエスト設定」を選択し、次のフラグを有効にする必要があります。

- セルフ・サービス・ユーザーが他のユーザーとサービス・インスタンスを共有できるようにします。

- セルフ・サービス・ユーザーがサービス・インスタンス・ロールを共有できるようにします

これらの設定は、グローバル・レベル、サービス・ファミリ・レベルまたは他のユーザーまたはロール・レベルで定義できます。詳細は、第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

- 権限の付与: 権限が付与されるサービス・インスタンスを選択し、「アクション」メニューから「権限」を選択します。
他のユーザーに権限を付与するには、「タイプ」ドロップダウン・リストから「ユーザー」を選択し、「検索」をクリックします。権限を付与できるユーザーのリストが表示されます。リストから1人以上のユーザーを選択し、「権限」をクリックして権限を付与します。

「付与する権限の選択」ドロップダウン・リストで、「表示」、「管理」または「すべて」を選択してユーザーに権限を付与します。サービス・インスタンスの構成の編集および変更をユーザーに許可する場合は、「管理」アクセスを選択します。サービス・インスタンスの編集、削除および変更をユーザーに許可する場合は、「すべて」アクセスを選択します。読取り専用アクセスをユーザーに付与する場合は、「表示」アクセスを選択します。

1つ以上のユーザー・ロールに権限を付与するには、「タイプ」ドロップダウン・リストで「ロール」を選択し、「検索」をクリックします。権限を付与できるロールのリストが表示されます。リストから1つ以上のロールを選択し、「権限」をクリックして権限を付与します。

- 取消: 権限が付与されているサービス・インスタンスを選択し、「取消」をクリックします。「検索」ドロップダウン・リストで、次のいずれか1つを選択できます。

- 名前: 権限が付与されているユーザーの名前。

- タイプ: 権限が付与されているタイプ(「ユーザー」または「ロール」)を選択します。

- 権限: 付与されている権限のタイプ(「表示」、「管理」または「すべて」)。

検索基準に基づいて、権限が付与されているユーザーまたはロールのリストが表示されます。権限を取り消す対象のユーザーまたはロールを選択し、「取消」をクリックします。

- サービス・インスタンスの再割当て: スーパー管理者ユーザーとしてログインし、インスタンスを選択して「再割当て」をクリックすると、サービス・インスタンスの所有権を別のユーザーに再割当てできます。ユーザーを選択して「再割当て」をクリックすると、サービス・インスタンスを再割当てできます。

29.5 「クラウド」の「リクエスト・ダッシュボード」の表示

セルフ・サービス管理者は、クラウド・リクエスト・ダッシュボードを使用して、すべてのデータベースおよびミドルウェアのリクエストのステータスを追跡できます。セルフ・サービス管理者は、すべてのユーザーのすべてのリソース・プロバイダのリクエストを表示できます。セルフ・サービス管理者が表示できるリクエストは、インスタンス・レベルの権限によって異なります。このページのすべての傾向およびグラフは、指定されている現在のフィルタおよび期間に適用されます。デフォルトでは、過去7日間のすべてのサービスのステータスが表示されます。

「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「リクエスト」を選択し、「ダッシュボード」を選択して「クラウド」の「リクエスト・ダッシュボード」を表示します。

図29-6 「クラウド」の「リクエスト・ダッシュボード」

次のグラフが表示されます。

- リクエスト傾向: 失敗、成功、平均待機時間、平均処理時間およびスケジュール済リクエストの最新の傾向を表示できます。傾向は、2つの期間(例: 前の週、現在の週)で表示されます。「完了したリクエスト」チャート内のドロップダウン・リストをクリックして、失敗、成功、一部成功または完了のリクエストをフィルタ処理し表示します。

- 平均リクエスト待機時間: スケジュールされたリクエストの開始時刻およびその実際の開始時刻からの経過時間。

- 平均リクエスト処理時間(ゾーン): 選択した条件のリクエストの処理にかかった平均時間。たとえば、特定のサービス・テンプレートがフィルタ条件として選択されている場合、指定した期間(過去24時間、過去7日間または過去30日間)に選択したサービス・テンプレートからのサービス・インスタンスの作成にかかった平均時間が表示されます。

「表示方法」ドロップダウン・リストで値を選択し、「フィルタ」値および「タイプ」を指定することで、ページにリストされたリクエストのフィルタ処理を選択できます。たとえば、「表示方法」ドロップダウン・リストで「リソース・プロバイダ」、「フィルタ」列で「すべて」、「タイプ」列で「作成」を選択した場合、すべてのリソース・プロバイダに対する作成リクエストが表示されます。

「編集」 (レンチ・アイコン)オプションをクリックして、リクエスト・ダッシュボード・ページのレイアウトを編集できます。次のサービス設定を変更できます。

- サマリー列: 「サマリー」リージョンに表示できる列の数。

- 長時間実行のしきい値: リクエストの完了に要する時間が通常より長いかどうかを判断するために使用される、平均処理時間の割合。

- 最大チャート・アイテム数: 各チャートに表示できるリソース・プロバイダ、サービス・タイプまたはサービス・ファミリの最大数。残りのアイテムは「その他すべて」カテゴリにリストされます。

- アーカイブ・リクエストを含める: 削除されたがまだパージされていないリクエストをチャートに含める場合はこのチェック・ボックスを選択します。このオプションは、ある期間で処理されたリクエスト総数のより正確なイメージの提供に役立ちます。

- チャートの期間: チャートのデフォルトの表示期間(7日間)。

必要に応じて値を変更して「OK」をクリックします。以前の設定をリストアするには、「デフォルト値に戻す」をクリックします。

29.6 すべてのクラウド・リクエストの表示

「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。「Oracle Cloud」メニューから、「リクエスト」を選択し、「すべて表示」を選択してすべてのクラウド・サービス・リクエストを表示します。

図29-7 すべてのクラウド・リクエスト

各リクエストについて、リクエストまたはジョブの名前、リクエストのステータス、リクエスト・タイプ(作成、削除など)、リクエストを発行したユーザー、サービス・タイプ(データベース、スキーマ、WebLogicなど)、リクエストが発行された日付などが表示されます。「名前」リンクをクリックし、ジョブ・アクティビティ・ページにドリルダウンします。「ステータス」リンクには、「リクエスト詳細」ポップアップ・ウィンドウが表示されます。

次の操作を実行できます。

- 再スケジュール: 将来の日付に実行が予定されているリクエストを選択して「再スケジュール」をクリックすると、リクエストが開始する予定の日付を変更できます。

- 削除: リクエストを選択して「削除」をクリックすると、リクエストを削除できます。削除したリクエストはリポジトリにまだ存在し、リクエスト設定ページで定義したパージ・ポリシーに従ってパージされます。詳細は、第11.2.3項「リクエスト設定の構成」を参照してください。

- クリーンアップ: 失敗したリクエストをクリーンアップするには、このオプションを使用します。これには、一部構成済サービスの停止、および失敗したサービスに使用されている一部構成済ストレージの削除が含まれる場合があります。
注意: 失敗したプロビジョニング・リクエストは、クリーンアップされるまで削除できません。

29.7 PaaSインフラストラクチャ・ゾーン・ホームページの表示

ゾーンは、同種のリソースをグループ化できる論理エンティティです。リソースは、新しいサービスの作成に必要なコンポーネント(サーバー、ストレージ、ネットワーク、オペレーティング・システム、アプリケーション)で構成されています。「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホーム・ページのリソース・プロバイダ・リンクをクリックしてリソース・プロバイダ・ページに移動し、「PaaSインフラストラクチャ・ゾーン」リンクをクリックしてPaaSインフラストラクチャ・ゾーン・ホームページにドリル・ダウンします。

図29-8 PaaSインフラストラクチャ・ホーム

PaaSインフラストラクチャ・ゾーン・ホーム・ページには、次のリージョンがあります。

- 一般: このリージョンにはゾーン内の「ホスト」、「依存プロバイダ」(ソフトウェア・プール)、「リクエスト」および「サービス・インスタンス」の総数が一覧表示されます。また、ゾーンに定義されている配置ポリシー制約も表示されます。

- リクエスト・サマリー: 処理中、失敗、成功、部分的に成功、またはスケジュール済のリクエストの割合が表示されます。

- CPUとメモリー: これらのチャートには、ゾーン内の平均CPUおよびメモリー使用量がホストごとに表示されます。

注意:
これらのメトリックのしきい値は、すべてのメトリック・ページで設定できます。このページに移動するには、「PaaSインフラストラクチャ・ゾーン」メニューから「モニタリング」→「すべてのメトリック」を選択します。しきい値を設定するメトリックを選択し、「変更」をクリックして設定を変更します。

- 問題: ターゲットの未処理のインシデントと問題が表示されます。

- メンバー: ゾーンのメンバーおよびメンバー・タイプ(Oracle VMゾーンまたはホスト)が表示されます。

- ホスト: PaaSインフラストラクチャ・ゾーン内のホストがリストされます。「使用率」リンクをクリックして、すべてのホストについて使用されているCPUおよびメモリーの詳細と、ホストに作成されたサービス・インスタンス数を表示します。「名前」リンクをクリックして、ホスト・ホームページにドリルダウンします。

- サービス・テンプレート・サマリー: ゾーンに関連付けられているサービス・テンプレートが表示されます。各サービス・テンプレートに関連付けられているソフトウェア・プール、および各リソース・プールのサービス・インスタンスの数も表示されます。

29.8 データベース・プール・ホームページの表示

データベース・プールには、PaaSインフラストラクチャ・ゾーン内にデータベース・インスタンスをプロビジョニングする際に使用できる一連のリソースが含まれています。

図29-9 データベース・プール・ホーム

このページには、次のリージョンがあります。

- 一般: このリージョンには、次の項目が表示されます。

- サマリー: データベース・プールおよび所属するPaaSインフラストラクチャ・ゾーンの説明が表示されます。

- メンバーおよびデータベース: プールのメンバー(Oracleホームおよびホスト)およびデータベースが表示されます。「データベース」リージョンには、データベースの合計数およびプールの単一のインスタンスまたはRACデータベースの数がリストされます。

- 配置ポリシー制約: プール内の各ホスト・メンバーの上限を指定する配置ポリシー制約が表示されます。

- スタンバイ・プール: 1つ以上のスタンバイ・プールが存在する場合、ここにリストされます。

- 上位使用ホスト: このリージョンには、過去7日間の上位使用ホストのリストが表示されます。リンクをクリックして、ホストのホームページにドリルダウンします。次の項目でソートできます。

- メモリー: ホスト上の合計メモリーの割合として示される、過去7日間に使用された平均メモリー。

- CPU: ホスト上で使用可能なCPUの割合として示される、過去7日間に使用された平均CPU。

- 記憶域: ホスト上で使用可能な合計記憶域の割合として示される、過去7日間に使用された平均記憶域。

- インスタンス: ホスト上のデータベース・インスタンスの数。

- メンバー: データベース・ブール内のすべてのメンバーの一覧が表示されます。「メンバー」表のリンクをクリックして、データベースまたはホスト・ホームページにドリルダウンします。

- インシデントと問題の概要: このリージョンには、発生したすべてのインシデントまたは問題の一覧が表示されます。

- メモリー使用率: このグラフは、データベース・プール内に存在する異なるホストによるメモリー使用率を示します。色分けされたグラフによって、異なるホスト全体にわたる異なるメモリー使用率の範囲が示されます。

- CPU使用率: このグラフは、データベース・プール内に存在する異なるホストによるCPU使用率を示します。色分けされたグラフによって、異なるホスト全体にわたる異なるCPU使用率の範囲が示されます。

- 記憶域の使用状況: このグラフは、データベース・プール内に存在する異なるホストによる記憶域使用率を示します。色分けされたグラフによって、異なるホスト全体にわたる異なる記憶域使用率の範囲が示されます。

- サービス・テンプレートおよびサービス・インスタンス: データベース・プールに関連するサービス・テンプレートおよびサービス・インスタンスを示します。

29.9 スキーマ・プール・ホームページの表示

データベースにデプロイできる1つ以上のスキーマを定義できます。

図29-10 スキーマ・プール・ホーム

- 一般: このリージョンには、次の項目が表示されます。

- サマリー: スキーマ・プールおよび所属するPaaSインフラストラクチャ・ゾーンの説明が表示されます。I

- メンバーおよびサービス: プール内のメンバー(データベースとホスト)およびサービスの一覧を示します。

- 配置ポリシー制約: プール内の各データベース・メンバーの上限を指定する配置ポリシー制約が表示されます。

- 上位割当てデータベース: このリージョンには、スキーマ・プール内の使用率上位データベースのリストが表示されます。リンクをクリックして、データベース・インスタンス・ページにドリルダウンします。

- メモリー: データベースの合計SGAサイズの割合として示される、ワークロードに基づいてサービスごとに割り当てられた合計メモリー。

- CPU: CPU数の割合として示される、ワークロードに基づいてサービスごとに割り当てられた合計CPU。

- 記憶域: データベースの合計サイズの割合として示される、データベースのすべての表領域で使用された合計記憶域。

注意:
ここでの合計には、すでにリクエストされ、現在アクティブなサービスに対して割り当てられているリクエストが含まれます。

- サービス: データベース・サービスの数。

- メンバー: スキーマ・ブール内のすべてのメンバーの一覧が表示されます。「メンバー」表のリンクをクリックして、データベース・インスタンス・ホームページにドリルダウンします。

- インシデントと問題の概要: このリージョンには、発生したすべてのインシデントまたは問題の一覧が表示されます。

- メモリーの割当て: このグラフは、スキーマ・プールに存在する異なるデータベース全体のメモリー割当てを示します。色分けされたグラフによって、すべてのデータベース全体にわたるメモリー割当ての範囲が示されます。

- CPU割当て: このグラフは、スキーマ・プールに存在する異なるデータベース全体のCPU割当てを示します。色分けされたグラフによって、すべてのデータベース全体にわたるCPU割当ての範囲が示されます。

- 記憶域の割当て: このグラフは、スキーマ・プールに存在する異なるデータベース全体の記憶域割当てを示します。色分けされたグラフによって、すべてのデータベース全体にわたる記憶域割当ての範囲が示されます。

- サービス・テンプレートおよびサービス・インスタンス: スキーマ・プールに関連するサービス・テンプレートおよびサービス・インスタンスを示します。

29.10 プラガブル・データベース・プール・ホームページの表示

PDBプールには、PaaSインフラストラクチャ・ゾーン内のPDBを作成する際に使用できる1つ以上のコンテナ・データベースが含まれています。

図29-11 PDB Poolのホームページ

このページには、次のリージョンがあります。

- 一般: このリージョンは、次の項目で構成されます。

- サマリー: このリージョンには、データベース・プールおよび所属するPaaSインフラストラクチャ・ゾーンの説明が表示されます。「親PaaSインフラストラクチャ・ゾーン」リンクをクリックして、ホームページにドリルダウンします。

- メンバーおよびデータベース: このリージョンには、プールのメンバー(Oracleホームおよびホスト)およびデータベースが表示されます。「データベース」リージョンには、データベースの合計数およびプールの単一のインスタンスまたはRACデータベースの数がリストされます。

- 配置ポリシー制約: プールの上限を指定する配置ポリシー制約が表示されます。

- 上位割当てデータベース: このリージョンには、(選択に応じて)5から15のプラガブル・データベースが、メモリー、CPU、記憶域またはサービス別にソートされて表示されます。

- メモリー: コンテナ・データベースの合計SGAサイズの割合として示される、ワークロードに基づいてサービスごとに割り当てられた合計メモリー。

- CPU: 合計CPU数の割合として示される、ワークロードに基づいてサービスごとに割り当てられた合計CPU。

- サービス: データベース・サービスの数。

- メンバー: このリージョンには、PDBプールのメンバーのリストが表示されます。「メンバー」表のリンクをクリックして、データベースまたはホスト・ホーム・ページにドリルダウンします。

- インシデントと問題の概要: このリージョンには、PDBプール内のターゲットに発生したすべてのインシデントと問題のリストが表示されます。

- メモリーの割当て: このグラフは、データベース・プール内の異なるコンテナ・データベースによるメモリー割当てを示します。色分けされたグラフによって、すべてのコンテナ・データベース全体にわたるメモリー割当ての範囲が示されます。

注意:
ここでの合計には、すでにリクエストされ、現在アクティブなサービスに対して割り当てられているリクエストが含まれます。

- CPU割当て: このグラフは、プール内の異なるコンテナ・データベースによるCPU割当てを示します。色分けされたグラフによって、すべてのコンテナ・データベース全体にわたるCPU割当ての範囲が示されます。

- サービス・テンプレートおよびインスタンス: このリージョンには、PDBプールに関連付けられているサービス・テンプレートのリストが表示されます。「サービス・テンプレート」リンクをクリックし、サービス・テンプレート詳細ページにドリルダウンします。

29.11 ミドルウェア・プール・ホームページの表示

ミドルウェア・プール・ホーム・ページには、ミドルウェア・プールの詳細情報が表示されます。このページを表示するには、「エンタープライズ」メニューから「クラウド」、「クラウド・ホーム」の順に選択します。クラウド・ホーム・ページの「リソース・プロバイダ」リンクをクリックして、リソース・プロバイダ・ページに移動します。ミドルウェア・プール名をクリックして、ミドルウェア・プール・ホーム・ページにドリルダウンします。ミドルウェア・プール・ホーム・ページには、次のリージョンがあります。

図29-12 ミドルウェア・プール・ホーム

- サマリー: このリージョンには次の情報が表示されます。

- 親PaaSインフラストラクチャ・ゾーン: ミドルウェア・プールが関連付けられているゾーン。リンクをクリックして、PaaSインフラストラクチャ・ゾーン・ホーム・ページにドリルダウンします。

- Oracleホーム: ミドルウェア・プールのOracleホームの合計数。

- Oracleホーム・バージョン: Oracleホームのバージョン。

- 配置ポリシー制約:

- Javaサーバー合計(1ホスト当たり): 各ホストで実行可能なWebLogic Serverの最大数。

- Javaサーバー: ミドルウェア・プールのWebLogic Serverの合計数。

- ロード・バランサ: このリージョンには次の詳細が表示されます。

- ロード・バランシング構成: ミドルウェア・プールに関連するロード・バランサ構成の名前。ロード・バランサの詳細を表示するには、リンクをクリックします。

- ロード・バランサ・タイプ: ロード・バランサのタイプ。これは、Oracle HTTP Server、Oracle Traffic Directorまたはサード・パーティのロード・バランサです。

- サービス・テンプレート: ミドルウェア・プールが関連付けられているサービス・テンプレートの数。各サービス・テンプレートに対して、名前、ロード・バランサ構成が有効になっているかどうかを示す列およびテンプレートの説明が表示されます。詳細ページにドリルダウンして、各サービス・テンプレートが関連付けられているMWaaSインスタンスを確認できます。

- サービス・インスタンス: ミドルウェア・プールで実行中のサービス・インスタンスが表示されます。各サービス・インスタンスについて、名前、ステータス、期限切れとなるようにスケジュールされている日付、関連付けられているサービス・テンプレート、およびOracleホームの場所が表示されます。

- メンバー: このリージョンには、ミドルウェア・プールのメンバーのリストが表示されます。ターゲット名、ターゲット・タイプ、実行されているホスト、Oracleホームの場所が表示されます。

29.12 クラウド・サービス・レポートの表示

Oracle BI Publisherはオラクル社のエンタープライズ・レポート・ソリューションの1つで、すべてのレポートおよびビジネス文書を作成、管理および配信するための、単一のレポート環境を提供します。Microsoft Word、Microsoft Excel、Adobe Acrobatなどの使い慣れた一連のデスクトップ・ツールを利用して、様々なソースのデータに基づいてレポート・レイアウトを作成および管理できます。クラウド・サービスBIレポートの内容は次のとおりです。

- リクエスト頻度が最も高いサービス・タイプ

- サービス・リクエスト・ステータス

- サービス・リクエスト・タイプ

- クラウド・リクエスト期間スレッド

各レポートをオンラインで表示し、それらをPDF、RTF、PowerPointおよびExcel形式でエクスポートできます。レポートを表示するには、Enterprise ManagerにEM_CLOUD_ADMINISTRATORロールを持つユーザーとしてログインし、「エンタープライズ」メニューから「レポート」→「BI Publisherレポート」を選択します。「クラウド・サービス」メニューにあるレポートをクリックし、BI Publisherアプリケーションを起動してレポートを直接表示します。

29.12.1 リクエスト頻度が最も高いサービス・タイプ

このレポートには、サービス・タイプ別にソートされた、最も高いリクエスト頻度のレポートが表示されます。次のパラメータのいずれかを選択することで、表示されるデータをフィルタできます。

- サービス・ファミリ

- サービス・タイプ

- ユーザー名

- 開始日

- 終了日

図29-13 リクエスト頻度が最も高いクラウド・サービス・タイプ

29.12.2 サービス・リクエスト・ステータス

このレポートには、ステータス別にソートされたサービス・リクエストのトレンドが表示されます。次のパラメータのいずれかを選択することで、表示されるデータをフィルタできます。

- サービス・ファミリ

- サービス・タイプ

- リクエスト・タイプ

- リクエスト・ステータス

- ユーザー名

- 開始日

- 終了日

図29-14 クラウド・リクエスト・ステータス

29.12.3 サービス・リクエスト・タイプ

このレポートには、リクエスト・タイプ別にソートされたクラウド・リクエストのトレンドが表示されます。次のパラメータのいずれかを選択することで、表示されるデータをフィルタできます。

- サービス・ファミリ

- サービス・タイプ

- リクエスト・タイプ

- リクエスト・ステータス

- ユーザー名

- 開始日

- 終了日

図29-15 クラウド・リクエスト・タイプ

29.12.4 クラウド・サービス・インスタンス期間スレッド

このレポートには、クラウド・サービス・インスタンス期間が表示されます。次のパラメータのいずれかを選択することで、表示されるデータをフィルタできます。

- 発行時間

- リソース・プロバイダ

- サービス・タイプ

- サービス・テンプレート

図29-16 クラウド・サービス・インスタンス期間

第XI部

Oracle Compute

この項では、Oracle Infrastructure Computeの設定および使用の手順について説明します。この部は、次の章で構成されています。

- 第30章「Oracle Computeのスタート・ガイド」

- 第31章「Oracle Computeセルフ・サービス・ポータルの設定」

- 第32章「Oracle Computeの使用」

- 第33章「Oracle Computeサイトと関連ターゲットの管理」

30 Oracle Computeのスタート・ガイド

この項では、Infrastructure Oracle Compute (このドキュメントではOracle Computeと呼びます)およびOracle Computeサイトを検出する手順の概要について説明します。内容は次のとおりです。

- Oracle Computeについて

- Oracle Computeの用語

- はじめに

- Oracle Computeサイトの検出

30.1 Oracle Computeについて

Enterprise Managerにより、エンド・ユーザーはインフラストラクチャ・クラウド・リソースをデマンド・セラピーでプロビジョニングし、資本および操作コストを削減できます。Oracle Computeを使用すると、Enterprise Managerが強化された監視機能を提供し、ユーザーはクラウド・リソースを様々なリソース・プロバイダからプロビジョニングし、異なるタイプのストレージおよびネットワーク・インフラストラクチャ設定をサポートできます。

このリリースでは、Oracle ComputeはExalogicエンジニアド・システムと統合され、ユーザーは、完全なクラウド・サービス・ソフトウェア・ソフトウェア・スタック(DBaas、WSaaS、TaaSおよびIaaS)をExalogicシステムに基づくOracle Compute上にデプロイ、管理および監視できます。Oracle ComputeをEnterprise Managerと統合することにより、ユーザーは共通クラウド管理システムおよびセルフ・サービス・フローにすべてのクラウド・サービス全体でアクセスできます。

30.2 Oracle Computeの用語

次の表に、いくつかの重要な用語および定義をリストします。

表30-1 Oracle Computeの用語

用語

定義

ノード

ノードは、Oracle Computeクラスタ内の物理サーバー(Hypervisor)です。

クラスタ

Oracle Computeインフラストラクチャは、サーバー・プールまたはクラスタを中心にして形成されます。クラスタには、3つ以上のノードが含まれます。

サイト

サイトは、1つ以上のOracle Computeクラスタを実行している場所です。

インスタンス

インスタンスはゲスト仮想マシンです。

テナント

マルチテナンシ対応のサーバーまたはサービスにコンシューマとして参加するすべてのクライアント組織または顧客はテナントと呼ばれます。テナントは、コンテキストで、そこにユーザーやマシン・イメージなどのシステム・オブジェクトが作成されます。

顧客は、組織、組織の中の部門、場合によっては1人の個人であることもあります。少なくとも1つの顧客を、サイトごとに作成する必要があります。

ユーザー

ユーザーは、リクエストを作成できるエンティティです。各ユーザーは、1つの顧客と関連付けられます。ユーザー名は、特定の顧客内で一意で、顧客ユーザー名は、システム内全体で一意です。

形状

仮想マシンの形状とは、仮想マシンに割り当てられたCPUの数、利用できるRAM容量および相対的なI/Oプロセス数などの定義を指します。形状がこれらのリソースの組合わせを特徴付けるために使用され、エンド・ユーザーは、それらのインスタンスの配置のリソース要件を指定できます。

イメージ・リスト

イメージ・リストは、マシン・イメージのリストです。マシン・イメージをイメージ・リストに追加して、関連するマシン・イメージのバージョン管理された選択を作成し、ライフタイムを通してイメージのバージョンを記録できます。

InfiniBand

InfiniBandは、ポイント・ツー・ポイントで双方向のシリアル・リンクを提供し、ディスクなどの高速機器とプロセッサの接続で使用されます。ポイント・ツー・ポイント機能に加え、InfiniBandはマルチキャスト操作を提供します。Exalogicシステムでは、すべてのコンポーネントはInfinibandネットワークで相互接続されています。

Oracle Computeテンプレート

Oracle Computeテンプレートは、オペレーティング・システムがインストールされた仮想ハード・ディスクのコピーであり、仮想マシン・インスタンスの起動に使用されます。それはgzipで圧縮されてtarアーカイブに格納されたディスク・イメージ全体(パーティション表とカーネルを含む)です。

編成

編成とは、高可用性、監視と永続性のための、システム構成要素の自動管理です。編成は、作成するコンポーネントを、単一の、管理可能なコレクションに結びつけます。

起動プラン

起動プランは、1つ以上のVMインスタンスの構成設定を定義します。

30.3 はじめに

この項では、Oracle Computeサイトを検出し、それをセルフ・サービス・ユーザーに設定する前に、実行する必要があるタスクをリストします。

表30-2 サービス・ファミリの設定

手順

タスク

ロール

1

必要なプラグインをデプロイします。第3.2項「必要なプラグインのデプロイ」を参照してください

クラウド管理者

2

管理者およびセルフ・サービス・ユーザーのロールを定義します。第3.3項「ロールの定義およびユーザーの割当て」を参照してください。

スーパー管理者

30.4 Oracle Computeサイトの検出

前提条件

- Enterprise Manager for Oracle Virtual Infrastructureプラグインは、Oracle Management ServiceとManagement Agent上にデプロイする必要があります。

追加の構成

- Oracle Computeターゲットを監視しているManagement Agent上で、次のコマンドを実行します。
<AGENT_INST_HOME>/bin/emctl setproperty agent -allow_new -name _disableLoadDPFromCache -value true

<AGENT_INST_HOME>/bin/emctl setproperty agent -allow_new -name agentJavaDefines -value "-Xmx512M -XX:MaxPermSize=96M"

- Oracle Computeサイト検出が無効になっている場合、次のコマンドを使用して有効化する必要があります。
<OMS_HOME>/bin/emctl register oms metadata -sysman_pwd <sysman_pwd> -pluginId oracle.sysman.vi -service discovery -file <VI_OMS_PLUGIN_HOME>/metadata/discovery/vi_discovery.xml.nimbula

- オプションで、仮想マシンのVNCコンソールにアクセスする必要がある場合、VncViewer.jarをダウンロードして、すべてのOMSの、次の場所にコピーする必要があります。
<OMS_HOME>/sysman/archives/emgc/deployments/EMGC_DOMAIN/emgc.ear/em.war

jarファイルをコピーする前に、ホスト・マシンがOracle Virtual Serverが実行されているHypervisorへのアクセス権を持っていることを確認します。

30.4.1 Oracle Computeサイトと関連ターゲットの検出

Oracle Compute階層のトップ・レベル・ターゲットはOracle Computeサイトです。サイトとはOracle Compute Clustersを実行している場所で、Oracle Computeサイトは1つ以上のクラスタで構成されています。Oracle Computeサイトを検出、登録するには、次の手順に従います。

1. CLOUD_ADMINロールを持つユーザーとしてEnterprise Managerにログインします。

2. 「設定」メニューから、「ターゲットの追加」、「ターゲットの手動追加」の順にクリックします。

3. 「ターゲットの手動追加」ページで、「ガイド付きプロセスを使用したターゲットの追加」を選択し、ドロップダウン・リストから「Oracle Computeサイト」を選択し、「ガイド付きプロセスを使用した追加」をクリックします。「Oracle Computeサイトの追加」が表示されます。

図30-1 Oracle Computeサイトの登録

4. 次のリージョンに登録の詳細を入力します。

- サイト詳細

- ターゲット名 :作成中のOracle Computeサイトに使用される名前。

- 関連付けられたExalogicターゲット: Oracle Computeサイトに関連付けられるExalogicターゲットを選択します。検出済の場合のみ、Exalogicターゲットが表示されます。Exalogicターゲットの検出方法の詳細は、<to provide the link>を参照してください。

- モニタリング・エージェント: Oracle Computeサイトおよび関連ターゲットをモニターするために使用されるデフォルトの管理エージェント。

- フェイルオーバー・モニタリング・エージェント: モニタリング・エージェントが停止した場合、ここで指定したエージェントが使用されます。

- サービス・マネージャ・エンドポイントURL:

- Oracle Compute資格証明

- エンドポイントURL: 既存のインストール済Oracle ComputeのAPIエンドポイントURL。これは、HTTPリクエストまたはコマンドの送信先となるURLです。Oracle Computeターゲットを検出するには、Oracle Computeサイトのセキュリティ証明書がモニタリング・エージェント・キーストアに確実に追加されている必要があります。

- ユーザー名 :エンドポイントURLにアクセスするために必要なユーザー名。このフィールドは、情報提供目的にのみ使用されます。

- パスワード: エンドポイントURLにアクセスするために必要なパスワード。「テスト接続」をクリックして、サイト資格証明をテストします。

- その他の資格証明

- SNMP V3資格証明: Oracle Computeターゲットのステータス変更を容易に速くするには、SNMP資格証明を指定します。ユーザー名、承認パスワードおよびプライバシ・パスワードを入力します。

5. 「続行」をクリックします。Oracle Computeサイトは、ターゲットとともに次の階層で検出されます。

- Oracle Computeクラスタ

- Oracle Server

- Oracle Virtual Platform

- Oracle Virtual Server

Oracle Computeサイトが検出されたあと、Oracle Compute Site Homeページを表示するには、「ターゲット」メニューから「すべてのターゲット」を選択し、続いて「グループ、システムおよびサービス」でOracle Computeサイトのターゲットをクリックします。新しく追加されたOracle Computeサイトは、今後、Oracle Computeサービス・ファミリのためのリソース・プロバイダの1つになります。

30.4.2 サイト証明書のインポート

Enterprise ManagerとSecure Socket Layer(SSL)プロトコルを使用して、Oracle Computeサイトを検出およびモニターする場合、セキュアな通信リンクを確立するには、その前にセキュア証明書をインポートする必要があります。管理エージェントは、セキュア接続の確立時に、信頼できる認証機関(CA)の証明書か、自己署名された証明書を含むJava Keystore(JKS)トラストストアを維持します。

JKSエージェントのトラストストアは、次の場所で利用できます。

$ORACLE_HOME/sysman/config/montrust/AgentTrust.jks

ここで、ORACLE_HOMEは管理エージェントのインスタンス・ホームです。

証明書(CA証明書またはルート証明書)をダウンロードするには、次の手順に従います。

1. ブラウザ・ウィンドウを開いて、アドレス・ウィンドウにサイトのURLを入力します。

2. 「リスクを理解する」をクリックして展開し、「例外の追加」をクリックします。

3. 「証明書ステース」で、右側の「表示」ボタンをクリックします。

4. 「詳細」タブをクリックします。左側下部の列で、「エクスポート」をクリックします。

5. 希望するファイル名で希望する場所に証明書を保存します。

証明書をダウンロードした後で、Agentトラストストア(AgentTrust.jks)を更新する必要があります。Oracle Computeサイトで、自己署名CAの証明書が使用されている場合、管理エージェントがこれらのOracle Computeサイトを検出、監視できるように、これのルートCA証明書をJKS Agentトラストストアに追加する必要があります。AgentTrust.jksを更新するには、次のコマンドを入力します。

emctl secure add_trust_cert_to_jks -password <password> -trust_certs_loc <loc> -alias <alias>

説明:

- passwordは、AgentTrust.jksのパスワードです(未指定の場合、コマンド・ラインでパスワードの入力を求められます)

- trust_certs_locは、インポートされる証明書ファイルの場所です。

- aliasは、インポートされる証明書の別名です。

たとえば: emctl secure add_trust_cert_to_jks -password welcome -trust_certs_loc /home/asaral/certs/emdev1_nimbula.crt -alias emdev1_nimbula

31 Oracle Computeセルフ・サービス・ポータルの設定

この章では、Oracle Computeをセルフ・サービス・ユーザーに設定および構成する方法について説明します。内容は次のとおりです。

- Oracle Computeサイトの設定

- テナントの作成

- 形状の作成

- 割当て制限の定義

- Oracle Computeテンプレートの管理

- 編成サービス・テンプレートの作成

- Enterprise ManagerロールのOracle Computeロールへのマップ

31.1 Oracle Computeサイトの設定

Oracle Computeサイトの検出後、テナントを定義し、形状、割当て制限、テンプレートなどを構成して、サイトをセルフ・サービス・ユーザーに構成する必要があります。

Oracle Computeサイトを設定するには、次の手順に従います:

1. テナント管理者およびユーザーを作成します。詳細は、第31.2項「テナントの作成」を参照してください。

2. 形状を構成します。詳細は、第31.3項「形状の作成」を参照してください。

3. 割当て制限を定義します。詳細は、第31.4「割当て制限の定義」を参照してください。

4. Oracle Computeテンプレートをアップロードします。詳細は、第31.5項「Oracle Computeテンプレートの管理」を参照してください。

5. オーケストレーション・テンプレートを設定します。第31.6項「オーケストレーション・サービス・テンプレートの作成」を参照してください

6. Enterprise ManagerロールをOracle Computeロールに関連付けます。第31.7項「Enterprise ManagerロールのOracle Computeロールへのマップ」を参照してください

7. リクエスト設定を構成します。第11.2.3項「リクエスト設定の構成」を参照してください。

8. チャージ計画を設定します。第43.2項「チャージバックの設定」を参照してください。

31.2 テナントの作成

テナント(または顧客)は、コンテキストまたはフレームワークで、そこにユーザーやテンプレートなどのシステム・オブジェクトが作成されます。企業では、テナントは組織や、組織の中の部門、場合によっては1人の個人であることもあります。各Oracle Computeサイトは、少なくとも1つのテナントを含む必要があります。

テナントを作成する前に、次のことを実行する必要があります:

- テナントに割り当てられるリソース割当て制限を見積ります

- テナント・ユーザーおよびテナント管理者を識別します

vCPU、メモリーおよびストレージ・リソースの割当て制限は、テナント作成プロセス中に定義できます。テナントに必要なリソースがない場合、テナント・ユーザーはそのテナントでインスタンスを作成および実行できません。

クラウド管理者は、選択したOracle Computeサイトに、1つ以上のテナントを作成できます。各テナントは、1人以上のテナント管理者およびテナント・ユーザーと関連付けることができます。

テナントを作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 「Oracle Cloud」メニューから「はじめに」を選択し、左側のパネルのインフラストラクチャ - Oracle Computeサービス・ファミリの横にある「設定」リンクをクリックします。

4. 「テナント管理」をクリックし、ドロップ・ダウン・リストから「Oracle Computeサイト」を1つ選択します。選択されたサイトに作成済のテナントのリストが表示されます。

図31-1 テナント管理

5. 「作成」をクリックします。「テナントの作成」ウィンドウが表示されます。

図31-2 テナントの作成

6. 名前、パスワード、説明およびテナント管理者の電子メール・アドレスを入力します。

7. 「サービス・ネットワークにアクセスできません」リージョンで、次から1つ以上を選択します:

- OMSサービス名:このオプションを選択して、テナントで作成されたVMインスタンスを有効化し、Enterprise Managerで監視します。

- インスタンス記憶域サービス・ネットワーク: このオプションを選択して、テナントで作成されたVMインスタンスを有効化し、ZFSストレージ・プールにアクセスします。

- サービス・マネージャ・ネットワーク:このオプションを選択して、プラットフォーム・サービス・マネージャ・ネットワークへのアクセスを有効化します。

8. 「割当て」リージョンでは、次を選択できます。

- デフォルト: このオプションを選択すると、デフォルトの割当てがこのテナントに割り当てられます。

- カスタム: このオプションを選択すると、テナントが利用できるカスタム割当てを定義できます。次の基準を指定できます。

- テンプレート: イメージの数とサイズを指定します。

- 計算: VMインスタンスの数、vCPUの数およびこのテナントのすべてのユーザーが利用できるようになる合計メモリーを指定します。カンマ区切りのキーと値のペアを使用できる制限を指定して、許可されるインスタンスの数に割当てを設定することもできます。たとえば、os_license=20を指定する場合、属性キーとしてos_licenseを持つマシン・イメージに基づいて起動されるインスタンスの数は20より大きくできません。

- 記憶域: このテナント内のすべてのユーザーが利用できる記憶域ボリュームのサイズを指定します。

- ネットワーク: テナントが利用できるVNETから予約可能なIPアドレスの数を指定します。

9. 「作成」をクリックします。新しく作成されたテナントは「テナント管理」ページに表示され、テナントに対して作成された割当ては「ユーザー管理: 割当て」ページに表示されます。詳細は、「割当ての定義」を参照してください。テナントが作成された後、クラウド管理者またはセルフ・サービス管理者は各テナント内にテナント管理者とテナント・ユーザーを作成できます。<ユーザーの作成>を参照してください。

31.2.1 テナントの編集

「テナント管理」ページに表示されるリストから、テナントを選択し、「編集」をクリックします。「テナントの編集」ウィンドウが表示されます。テナントの名前を除き、テナントのすべての詳細を変更できます。テナントを変更した後に「編集」をクリックすると、変更を確認して「テナント管理」ページに戻ることができます。

31.3 形状の作成

形状とは、仮想マシンに割り当てられたCPUの数、利用できるRAM容量および相対的なI/Oプロセス数などの、仮想マシンの特性を指します。各形状はこれらの特性の組み合わせで、仮想マシンのリクエスト時にテナント・ユーザーが使用できます。形状を定義するときに、マシンの容量とインスタンスの予想ワークロードを検討する必要があります。

形状を作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 「Oracle Cloud」メニューから「はじめに」を選択し、左側のパネルのインフラストラクチャ - Oracle Computeサービス・ファミリの横にある「設定」リンクをクリックします。

4. 「形状管理」をクリックし、ドロップ・ダウン・リストから「Oracle Computeサイト」を1つ選択します。選択されたサイトに作成済の形状のリストが表示されます。

図31-3 形状管理

5. 「作成」をクリックします。Computeマシンの作成ウィンドウが表示されます。名前、説明、CPUの数、メモリーおよび仮想マシンに割り当てられるIOプロセスの相対的な数を入力します。

6. 「作成」をクリックします。新しく作成された形状は、「形状管理」ページに表示されます。

31.4 割当て制限の定義

管理者(クラウド管理者またはセルフ・サービス管理者)は、テンプレート、インスタンス、記憶域およびネットワークなどのシステム・リソースに対する割当てを定義できます。システム・リソースに対する割当ては、管理者が明示的に設定する場合のみ強制されます。テナントが作成され、カスタム割当て設定が定義されない場合、テナントにはデフォルトの割当て設定が割り当てられます。テナント作成時に定義された割当て設定は、「ユーザー管理: 割当て」ページで変更できます。

割当て設定を編集するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから、「クラウド」、「クラウド・ホーム」の順に選択して、Oracle Computeサイトのホームページに移動します。

3. 「Oracle Computeサイト」メニューから、「ユーザー管理」、「割当て」の順に選択します。「ユーザー管理: 割当て」ページが表示されます。各テナントに関連付けられた割当て制限設定が表示されます。「使用量」または「割当て量」から割当て制限の表示を選択するか、「表示」ドロップ・ダウン・リストから適切なオプションを選択します。

図31-4 割当て容量管理

4. 変更する割当てを選択し、「編集」をクリックします。「割当て制限の編集」ウィンドウが表示されます。

5. 割当ての説明と、次の基準を変更できます。

- テンプレート: イメージの数とサイズを指定します。

- 計算: VMインスタンスの数、vCPUの数およびこのテナントのすべてのユーザーが利用できるようになる合計メモリーを指定します。カンマ区切りのキーと値のペアを使用できる制限を指定して、許可されるインスタンスの数に割当てを設定することもできます。たとえば、os_license=20を指定する場合、属性キーとしてos_licenseを持つマシン・イメージに基づいて起動されるインスタンスの数は20より大きくできません。

- 記憶域: このテナント内のすべてのユーザーが利用できる記憶域ボリュームのサイズを指定します。

- ネットワーク: テナントが利用できるVNETから予約可能なIPアドレスの数を指定します。

6. 「編集」をクリックすると、割当てを変更して「ユーザー管理: 割当て」ページに戻ります。

31.5 Oracle Computeテンプレートの管理

Oracle Computeテンプレートは、オペレーティング・システムがインストールされた仮想ハード・ディスクのコピーであり、仮想マシン・インスタンスの起動に使用されます。それはgzipで圧縮されてtarアーカイブに格納されたディスク・イメージ全体(パーティション表とカーネルを含む)です。テンプレートとしては、Linuxの各バージョン(たとえばRed HatやUbuntu)、Microsoft Windowsまたは他のオペレーティング・システムが可能です。

テンプレートをアップロードするには、次の手順を実行します:

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから、「クラウド」、「クラウド・ホーム」の順に選択して、Oracle Computeサイトのホームページに移動します。

3. 「Oracle Computeサイト」メニューから、「イメージ管理」を選択します。ソフトウェア・ライブラリまたはローカル・ディスクのいずれかからアップロードしたテンプレートのリストが表示されます。

図31-5 イメージ管理

4. 「アップロード」をクリックします。「テンプレート管理: テンプレートのアップロード」ウィンドウが表示されます。イメージのアップロード時に、テンプレートの適用範囲は次のいずれかです。

- パブリック: イメージは、すべてのユーザーが利用できます。このオプションを選択する場合、名前フィールドにイメージの名前を入力します。

- テナント: イメージは、選択したテナントに属するユーザーのみが利用できます。このオプションを選択する場合、「名前」ドロップダウン・フィールドで「テナント」を選択し、テンプレートの名前を指定します。イメージは、選択したテナント内のすべてのユーザーが利用できます。

5. サービス・インスタンスがプロビジョニングされたときに使用される追加の属性を指定します。

6. 「テンプレートの選択」フィールドで、アップロードされるイメージを選択します。ローカル・ディスク内か、ソフトウェア・ライブラリにあるイメージをアップロードできます。

7. 「アップロード」をクリックすると、テンプレートがアップロードされます。新しくアップロードされたイメージは、「イメージ管理: Computeテンプレート」ページに、次の詳細とともに表示されます。

- 名前: イメージの名前。すべてのユーザーがイメージを利用できる場合、名前の形式は/oracle/public/<image_name>です。選択したテナントに属するユーザーのみがイメージを利用できる場合、形式は<tenant_name>/public/<image_name>です。

- 属性: イメージのアップロード時に指定された、任意のユーザー定義の属性。

- 割当て: イメージに指定された割当て。

- アップロード済のサイズ: アップロードされたイメージのサイズ。

- 合計サイズ: イメージの合計サイズ。

- 解凍済サイズ: 解凍された状態でのイメージのサイズ。

- 構成済エージェント: このイメージに対して管理エージェントが構成されているかどうかを示します。「管理エージェントの構成」を参照してください。

31.5.1 管理エージェントの構成

イメージ・リストに関連付けられる管理エージェントの詳細を指定できます。エージェントを構成するには、次の手順を実行します。

1. EM_CLOUD_ADMINロールを持つユーザーとしてEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、Computeホームを選択します。Compute Cloudページが表示されます。

3. Oracle Compute Cloudメニューから、「リソース・プロバイダ」を選択し、リストの「Oracle Computeサイト」をクリックします。Oracle Compute Cloudページが表示されます。

4. 「Oracle Compute Cloud」メニューから、「イメージ管理」を選択します。テンプレートのリストのある「イメージ管理」ページが表示されます。

5. リストからテンプレートを選択し、「エージェントの構成」をクリックします。次の詳細を指定します。

- エージェント構成タイプ: 「新規」または「共有」を選択します。

- インストールのベース・ディレクトリ: 「新規」を選択した場合、管理エージェントがインストールされるホスト・マシン上のベース・ディレクトリを指定します。

- 共有エージェント: エージェント構成タイプに共有を選択した場合、共有エージェントの名前を入力します。

- Oracleホーム: エージェント構成タイプに「共有」を選択した場合、既存の管理エージェントの共有Oracleホームの場所を指定します。

- プラットフォーム: インストールするプラットフォームを選びます。

- インスタンス・ディレクトリ: Oracleホームのインスタンス・ディレクトリを指定します。

- 「ユーザー名」および「パスワード」: エージェントにアクセスするために必要な資格証明を指定します。

- SSHタイムアウト: デプロイメント中のゲスト仮想マシン通信に対するSSHタイムアウト期間。

- 権限委任設定: 権限委任設定を指定します。

6. 「OK」をクリックしてエージェントを構成し、前のページに戻ります。

31.6 編成サービス・テンプレートの作成

前提条件

- 1つ以上のOracle Computeサイトが検出されている必要があります。

- 1つ以上のOracle Computeテンプレートが使用できる必要があります。

編成とは、高可用性、監視と永続性のための、システム構成要素の自動管理です。編成は、作成するコンポーネントを、単一の、管理可能なコレクションに結びつけます。たとえば、編成を使用すると、ネットワーク、ネットワーク・セキュリティおよび記憶域を、仮想マシンのインスタンス化に関連付けることができます。管理者は、Oracle Computeサービス・インスタンスの作成に使用できる編成サービス・テンプレートを作成できます。サービス・テンプレートを作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーとしてログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 「Oracle Cloud」メニューから「はじめに」を選択し、左側のパネルのインフラストラクチャ - Oracle Computeサービス・ファミリの横にある「設定」リンクをクリックします。

4. 「サービス・テンプレート」、「作成」の順にクリックします。サービス・テンプレートの作成ウィンドウが表示されます。

5. サービス・タイプには「編成」、続いて「編成カスタム・サービス・テンプレート」を選択し、「作成」をクリックして、編成カスタム・サービス・テンプレートを作成するウィザードを起動します。

6. テンプレートの名前と説明を入力し、「次へ」をクリックします。

7. 「特性」ページで、ターゲット・プロパティ(たとえば連絡先、コスト・センター、ライフサイクル・ステータスなど)を入力します。これらのプロパティまたは特性は、サービス・インスタンスの作成時に、ターゲット・プロパティとしてインスタンスに適用されます。「次へ」をクリックします。

8. 「リソース・プロバイダ」ページで、「追加」をクリックして、サービス・インスタンスがプロビジョニングされるOracle Computeサイトを選択します。

9. 「次へ」をクリックします。「構成」ページが表示されます。

図31-6 オーケストレーション・サービス・テンプレートの作成: 構成

オーケストレーション・テンプレートは、1つ以上の起動プランと関連付けられます。「起動プランの追加」をクリックして、新しい起動プランを作成します。詳細は、31.6.1項「起動プランの生成」を参照してください。

10. 1つ以上の起動プランを定義した後に、起動プランの実行順を選択することによって、起動プラン間の関係を構成できます。左のパネルで編成テンプレートのリンクを選択します。「編成の構成」ページの「起動順序」リージョンで「追加」をクリックして、起動プランの順序を選びます。「次へ」をクリックします。

11. 「ロール」ページで、「追加」をクリックして、サービス・テンプレートを利用できるロールを選択します。「次へ」をクリックします。

12. 「確認」ページで、テンプレートの詳細を検討して「送信」をクリックすると、編成テンプレートが作成されます。

31.6.1 起動プランの作成

起動プランは、1つ以上のVMインスタンスの構成設定を定義します。「起動プラン」ウィンドウで起動プランの名前を入力して、「追加」をクリックします。入力した起動プラン名は、起動パネルの編成プラン・ヘッダーの下に表示されます。起動プラン名をクリックし、構成の詳細を指定します。

図31-7 起動プランの構成

- 起動プランの構成: 次の詳細を指定します。

- 高可用性: オーケストレーションに対して高可用性ポリシーを指定できます。これは、オーケストレーションがシステムによってどのように管理されるかに影響します。次のものがあります:

- 高可用性なし: このオプションを選択した場合、オーケストレーション・コンポーネントは再起動もモニターも行われません。

- アクティブ: オーケストレーションで定義されたコンポーネントは、電源障害、ノードの切断などが原因で予期せずに停止した場合に再起動されます。
注意: インスタンスの再起動、無効なイメージ・リストまたは形状などのオペレータ・エラーのために停止された場合、コンポーネントは再起動されません。この場合は、オーケストレーションのステータスにはエラーが反映されますが、コンポーネントは再作成されません。レポートされたオペレータ・エラーを修正して、オーケストレーションを再起動する必要があります。

- モニター: コンポーネントは再起動されず、モニタ－のみ実行されます。

- 異なるノードでのデプロイ: 異なるノードに起動プランをデプロイする場合に、このチェック・ボックスを選択します。

- 共通設定: このタブをクリックして、この起動プランのすべてのVMインスタンスに対して使用されるデフォルト設定を定義します。デフォルトの設定はVMインスタンス・レベルでオーバーライドできます。

図31-8 共通設定

次の詳細を指定します。

- Oracle Computeテンプレート: テンプレートは、オペレーティング・システムがインストールされた仮想ハード・ディスクのコピーであり、インスタンスの起動に使用されます。テンプレートは、gzipで圧縮されてtarアーカイブに格納されたディスク・イメージ全体(パーティション表とカーネルを含む)である必要があります。「検索」アイコンをクリックして、リストから「テンプレート」を選択します。「ロック」アイコンをクリックしてテンプレートをロックすると、サービス・インスタンスのプロビジョニング時に、テナント管理者またはテナント・ユーザーはテンプレートを変更できません。

- 形状: 形状とは、仮想マシンの特性を定義するCPU、メモリーおよびIOの組合せです。ドロップダウン・リストから形状を選択します。「ロック」アイコンをクリックして形状をロックすると、サービス・インスタンスのプロビジョニング時に、テナント管理者またはテナント・ユーザーは形状を変更できません。

- EMエージェントの構成: このチェックボックスを選択して、EoIBおよびIPoIBストレージ・ネットワークをネットワーク表に追加します。

- 資格証明: VMインスタンスへのパスワード不要アクセスのためにSSH key資格証明を設定したり、管理エージェントをデプロイするために資格証明をホスティングしたりできます。次を使用できます:

- Oracle SSHキー: SSHキー資格証明が設定されており、優先資格証明として使用できる場合、プリファレンスの使用を選択し、ドロップダウン・ボックスから資格証明のセットを選択します。「キーの入力」を選択する場合は、VMインスタンスにアクセスするために必要なSSH公開および秘密鍵のペアを指定する必要があります。「キーはファイル内にあります」を選択した場合、「参照」をクリックし、ファイルの公開/秘密鍵をクリックします。

- Root SSHキー: ホストにSSHキー資格証明が設定されており、優先資格証明として使用できる場合、プリファレンスの使用を選択し、ドロップダウン・ボックスから資格証明のセットを選択します。「キーの入力」を選択する場合は、VMインスタンスにアクセスするために必要なSSH公開および秘密鍵のペアを指定する必要があります。「キーはファイル内にあります」を選択した場合、「参照」をクリックし、ファイルの公開/秘密鍵をクリックします。

- Oracleユーザー: プリファレンスの使用を選択した場合、ドロップダウン・ボックスから優先資格証明を選択します。「パスワードの入力」を選択した場合、Oracleユーザーのパスワードを入力する必要があります。

- ルート・ユーザー: プリファレンスの使用を選択した場合、ドロップダウン・ボックスから優先資格証明を選択します。「パスワードの入力」を選択する場合、ルート・ユーザーのパスワードを入力する必要があります。

- ネットワーク構成: 「追加」をクリックして、VMインスタンスに関連付けられた1つ以上のネットワーク・インタフェースを選択します。ネットワークは、IPoIBまたはEoIBネットワークです。「ネットワークの選択」ウィンドウで、次を選択できます。

- テナント・ネットワーク: これは、各テナントがExalogic内またはExalogic外の他のサーバーと通信するために構成されたネットワークです。

- サービス・ネットワーク: これは、ZFSSAまたはExadataシステムなど、他のサービス・プロバイダと通信するために構成されたネットワークです。

外部ネットワーク・インタフェースに、次から1つ以上を選択します:

- デフォルトのゲートウェイ: 選択したネットワークは、デフォルトのゲートウェイ・ネットワークとして構成されます。

- 対称ルーティング: このオプションを選択すると、vNet IPへのパケットの受信と同じネットワーク・インタフェースを介してリプライ・パケットをルーティングします。

- プロバイダ・ロール: *** 情報が必要 ***

ネットワークを追加した後に、ネットワークを選択して「ロック」アイコンをクリックすると、ネットワーク構成をロックできます。

- ドメイン・ネーム・システム(DNS)構成: ネットワークのDNS構成を指定します。

- サーバー: 選択したネットワークにDNSサーバーのカンマ区切りリストを入力します。

- ドメインの検索: 選択したネットワークにDNS検索ドメインのカンマ区切りリストを入力します。

- ネットワーク・インフォメーション・サービス(NIS)構成

- NISドメイン名: 選択したOracle VMインスタンスのNISドメイン名を入力します。

- ネットワーク・インフォメーション・サービス(NIS)のサービス: 「追加」をクリックして、NISサーバーを追加します。NISサーバーの名前およびIPアドレスを入力し、「追加」をクリックして、NISサーバーを追加します。

- 記憶域構成: 作成されるVMインスタンスに、1つ以上の記憶域ボリュームを関連付けることができます。「作成」をクリックします。「記憶域ボリュームの作成」ウィンドウで、記憶域ボリュームの名前、サイズ、作成されるボリュームの数を入力して、「追加」をクリックします。続いて「ロック」アイコンと記憶ボリュームのロックをクリックできます。

- 拡張構成: オプションでVMインスタンスの追加の属性を指定できます。属性のキーと値を追加するには、「追加」をクリックします。

- 起動プランを作成した後で、起動プランを使用できる1つ以上のVMインスタンスを追加できます。作成した起動プランを選択して、「VMインスタンスの追加」をクリックします。「VMインスタンスの追加」ウィンドウで、作成されるVMインスタンスの名前と数を指定します。複数のインスタンスを追加する場合、指定した名前は各VMインスタンスの一意の名前を生成するための接頭辞として使用されます。
インスタンス・レベルで構成設定を定義して、起動プラン・レベルで定義された設定をオーバーライドすることができます。インスタンス・レベル固有の構成設定を定義するには、左のパネルからVMインスタンスを選択します。「Oracle VMインスタンス構成」ページが表示されます。インスタンス・レベル設定を定義するには、共通設定をオーバーライドするチェックボックスを選択して、デフォルトの起動プラン・レベル設定をオーバーライドします。Oracle Computeテンプレート、形状を選択し、ネットワークおよび記憶域構成を選択します。

「拡張構成」リージョンで、オプションで追加の属性を指定できます。「追加」をクリックします。「属性の追加」ウィンドウで、属性のキーと値を指定します。「タグ」フィールドでは、タグを入力してインスタンス・デプロイメント・リクエストを特定できます。

オプションのネットワーク構成リージョンで、「ネットワーク構成」リージョンで定義したネットワークに追加の構成パラメータを指定できます。DNSサーバーのリストを指定したり、ネットワークをデフォルト・ゲートウェイ・ネットワークとして構成したり、基礎となる選択されたサービス・ネットワーク上でVMインスタンスをプロバイダとして構成したりすることができます。

31.7 Enterprise ManagerロールのOracle Computeロールへのマップ

Enterprise ManagerロールをOracle Computeロールに関連付けることができます。ロール・マッピングを定義するには、次の手順に従います:

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーとしてログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 「Oracle Cloud」メニューから「はじめに」を選択し、左側のパネルのインフラストラクチャ - Oracle Computeサービス・ファミリの横にある「設定」リンクをクリックします。

4. 「ロール・マッピング」をクリックします。ロール・マッピング・ページで、ドロップダウン・リストからロール・マッピングを定義するOracle Computeサイトを選択します。

5. 「作成」をクリックします。ロール・マッピングを作成するには、「ロール・マッピングの作成」ウィンドウで、Enterprise Managerロールとそれに関連付けるOracle Computeロールを選択して、「追加」をクリックします。

32 Oracle Computeの使用

この章では、セルフ・サービスのユーザーがOracle Computeセルフ・サービス・ポータルを使用してOracle Computeインスタンスをリクエスト、監視および管理する手順について説明します。内容は次のとおりです。

- Oracle Computeセルフ・サービス・ポータルの使用

- 新しい編成の作成

- 編成の詳細の表示

- ネットワークの作成

- 記憶域ボリュームの作成

- ライブラリの管理

- オーケストレーションの検出

32.1 Oracle Computeセルフ・サービス・ポータルの使用

「Oracle Computeセルフ・サービス・ポータル」ページへ移動するには、EM_SSA_USERロールを持つユーザーとしてログインします。「セルフ・サービス・ポータル」ページが表示されます。ドロップ・ダウン・リストから「インフラストラクチャ - Oracle Compute」を選択します。次のページが表示されます。

図32-1 Oracle Computeセルフ・サービス・ポータル

これには次のタブが含まれます。

- ホーム: ホームページには、次のリージョンがあります。

- サービス: このリージョンには、作成されたインスタンスおよびそれが「稼働中」か「停止中」かを示すステータスのリストが表示されます。

- 通知: このリージョンには、検出されなかったオーケストレーション、過去7日間に公開されたサービス・オファーの数などの通知が表示されます。

- 使用量: 「使用量」アイコンをクリックすると、ユーザーが作成したすべてのサービスを含む、セルフ・サービス・ユーザーによってこれまで使用された割当ての合計(サーバーおよびメモリー)が表示されます。割当てには、Oracle VMインスタンスの数、CPU、メモリーおよびすべてのインスタンスにわたる記憶域が含まれます。

- サービス: このリージョンには、セルフ・サービス・ユーザーが所有するOracle VMインスタンスのリストが表示されます。サービスごとに、サービスの名前、ステータス、サービス・タイプ、リソース・プロバイダ、作成日および期限切れ予定日が表示されます。権限が付与されたサービスも表示できます。次の作業が実行できます。

- 新規サービスのリクエスト: オーケストレーションを作成するには、「新規サービスのリクエスト」をクリックします。「新しいオーケストレーションの作成」を参照してください。

- サービスの表示: 「名前」リンクをクリックして、VMインスタンス・ホームページにドリルダウンします。

- サービスの削除: 表からサービスを選択し、「削除」をクリックします。確認メッセージが表示されます。インスタンスを削除するには、インスタンスを選択し、「はいをクリックします。

- サービスの開始: 表からサービス・インスタンスを選択し、「開始」をクリックします。サービスの開始リクエストが発行されます。

- サービスの停止: 表からサービス・インスタンスを選択し、「停止」をクリックします。確認メッセージが表示されます。「はいをクリックして、サービスを停止するリクエストを発行します。

- 履歴: サービス・インスタンスを選択して「履歴」をクリックすると、サービス・インスタンスで実行されている操作の履歴を表示できます。

- 検出: このオプションを選択すると、任意のオーケストレーションを検出してサービス・インスタンスにプロモートします。

- 付与: 他のユーザーまたはロールにサービス・インスタンスに対する表示権限またはFULL権限を付与できます。「権限の付与と取消し」を参照してください。

- 権限の取消し: 他のユーザーまたはロールに付与された権限を取り消すことができます。

- リクエスト: このリージョンには、「オーケストレーションの開始」、「オーケストレーションの検出」および「サービスの削除」リクエストが表示されます。各リクエストに対して、リクエストのステータス、タイプ、開始日、および送信日が表示されます。「表示」メニューから列を選択し、リクエストの詳細を表示します。スケジュール済のリクエストを選択して、「再スケジュール」をクリックすると、リクエストを再スケジュールできます。スケジュール済のリクエストを削除するには、リクエストを選択してから「取消」をクリックします。作成などのスケジュールされたリクエストが取り消された場合、他のすべての関連リクエストも取り消されます。

- ネットワーク: 第32.4項「ネットワークの作成」を参照してください。

- 記憶域: 第32.5項「記憶域ボリュームの作成」を参照してください。

- チャージバック: 第43章「チャージバック管理」を参照してください。

- ライブラリ: 第32.6項「ライブラリの管理」を参照してください。

32.2 新しい編成の作成

カスタマイズされた構成を持つOracle VMインスタンスのセットを作成するには、次の手順を実行して新しい編成を作成する必要があります。

1. インフラストラクチャ - Oracle Computeセルフ・サービス・ポータル・ページで「新規サービスのリクエスト」をクリックします。
注意: 初めてログインするときに、Oracle Compute資格証明を設定する必要があります。ページの右上隅にある「プリファレンス」リンクをクリックします。「プリファレンス」ウィンドウが表示されます。左パネルの「インフラストラクチャ: Oracle Compute」リンクをクリックします。「Oracle Computeサイトの資格証明」リージョンの設定をクリックして、Oracle Computeサイトへのアクセスに必要なユーザー名とパスワードを入力します。オプションで、管理エージェントをデプロイするためのホスト資格証明を指定できます。

2. 「オーケストレーション・サービス・テンプレート」を「サービス・カタログ」から選択します。編成のリクエスト・ウィザードが表示されます。

図32-2 オーケストレーションのリクエスト: 一般

3. VMインスタンスが作成されるOracle Computeサイトを選択します。

4. 編成の名前を入力して説明を指定します。

5. なんらかの編成がデプロイメント・プランやJSONファイルとして保存されている場合はここで選択します。保存されている使用可能なオーケストレーションがない場合は、「次へ」クリックして続行します。デプロイメント構成ページが表示されます。

6. このページでは、1つ以上の起動プランを使用して、編成内の様々なコンポーネントの構成を指定することができます。起動プランは、1つ以上のVMインスタンスの構成設定を定義します。「起動プラン」ウィンドウで起動プランの名前を入力して、「追加」をクリックします。入力した起動プラン名は、起動パネルの編成プラン・ヘッダーの下に表示されます。

7. 「起動プランの構成」タブをクリックします。次の詳細を入力します。

- 高可用性: オーケストレーションに対して高可用性ポリシーを指定できます。これは、オーケストレーションがシステムによってどのように管理されるかに影響します。次のものがあります:

- 高可用性なし: このオプションを選択した場合、オーケストレーション・コンポーネントは再起動もモニターも行われません。

- アクティブ: オーケストレーションで定義されたコンポーネントは、電源障害、ノードの切断などが原因で予期せずに停止した場合に再起動されます。
注意: インスタンスの再起動、無効なテンプレート・リストまたは形状などのオペレータ・エラーのために停止された場合、コンポーネントは再起動されません。この場合は、オーケストレーションのステータスにはエラーが反映されますが、コンポーネントは再作成されません。レポートされたオペレータ・エラーを修正して、オーケストレーションを再起動する必要があります。

- モニター: コンポーネントは再起動されず、モニタ－のみ実行されます。

- 異なるノードでのデプロイ: このチェック・ボックスを選択すると、異なるノードに起動プランをデプロイします。

8. 「共通設定」タブをクリックして、この起動プランのすべてのVMインスタンスに対して使用されるデフォルト設定を定義します。デフォルトの設定はVMインスタンス・レベルでオーバーライドできます。

図32-3 オーケストレーションのリクエスト: デプロイメント構成

次の詳細を指定します。

- Oracle Computeテンプレート: テンプレートは、オペレーティング・システムがインストールされた仮想ハード・ディスクのコピーであり、インスタンスの起動に使用されます。テンプレートは、gzipで圧縮されてtarアーカイブに格納されたディスク・イメージ全体(パーティション表とカーネルを含む)である必要があります。「検索」アイコンをクリックして、リストから「テンプレート」を選択します。

- 形状: 形状とは、仮想マシンの特性を定義するCPU、メモリーおよびIOの組合せです。ドロップダウン・リストから形状を選択します。

- EMエージェントの構成: セルフ・サービス・ユーザーが、仮想マシンに管理エージェントをデプロイするために必要なEoIB OMSネットワークおよびIPoIBインスタンス記憶域ネットワークへのアクセス権を持っていない場合、このチェック・ボックスは無効化されています。

- 資格証明: VMインスタンスにパスワードなしでアクセスするSSHキー資格証明および管理エージェントをデプロイするためのホスト資格証明を設定できます。次を使用できます:

- Oracle SSHキー: SSHキー資格証明が設定されており、優先資格証明として使用できる場合、プリファレンスの使用を選択し、ドロップダウン・ボックスから資格証明のセットを選択します。「キーの入力」を選択する場合は、VMインスタンスにアクセスするために必要なSSH公開および秘密鍵のペアを指定する必要があります。「キーはファイル内にあります」を選択した場合、「参照」をクリックし、ファイルの公開/秘密鍵をクリックします。

- Root SSHキー: ホストにSSHキー資格証明が設定されており、優先資格証明として使用できる場合、プリファレンスの使用を選択し、ドロップダウン・ボックスから資格証明のセットを選択します。「キーの入力」を選択する場合は、VMインスタンスにアクセスするために必要なSSH公開および秘密鍵のペアを指定する必要があります。「キーはファイル内にあります」を選択した場合、「参照」をクリックし、ファイルの公開/秘密鍵をクリックします。

- Oracleユーザー: 「プリファレンスの使用」を選択した場合、ドロップダウン・ボックスから優先資格証明を選択します。「パスワードの入力」を選択した場合、Oracleユーザーのパスワードを入力する必要があります。

- ルート・ユーザー: 「プリファレンスの使用」を選択した場合、ドロップダウン・ボックスから優先資格証明を選択します。「パスワードの入力」を選択する場合、ルート・ユーザーのパスワードを入力する必要があります。

- ネットワーク構成: 「追加」をクリックして、VMインスタンスに関連付けられた1つ以上のネットワーク・インタフェースを選択します。ネットワークは、IPoIBまたはEoIBネットワークです。「ネットワークの選択」ウィンドウで、次を選択できます。

- テナント・ネットワーク: これは、各テナントがExalogic内またはExalogic外の他のサーバーと通信するために構成されたネットワークです。

- サービス・ネットワーク: これは、ZFSSAまたはExadataシステムなど、他のサービス・プロバイダと通信するために構成されたネットワークです。

- 記憶域構成: 作成されるVMインスタンスに、1つ以上の記憶域ボリュームを関連付けることができます。「作成」をクリックします。「記憶域ボリュームの作成」ウィンドウで、記憶域ボリュームの名前やサイズを入力し、記憶域プロパティと、作成されるボリュームの数を選択して、「追加」をクリックします。

- 拡張構成: オプションでVMインスタンスの追加の属性を指定できます。属性のキーと値を追加するには、「追加」をクリックします。

9. 起動プランを作成した後で、起動プランを使用できる1つ以上のVMインスタンスを追加できます。作成した起動プランを選択して、「VMインスタンスの追加」をクリックします。「VMインスタンスの追加」ウィンドウで、作成されるVMインスタンスの名前と数を指定します。複数のインスタンスを追加する場合、指定した名前は各VMインスタンスの一意の名前を生成するための接頭辞として使用されます。インスタンス・レベルで構成設定を定義して、起動プラン・レベルで定義された設定をオーバーライドすることができます。
インスタンス・レベル固有の構成設定を定義するには、左のパネルからVMインスタンスを選択します。「Oracle VMインスタンス構成」ページが表示されます。インスタンス・レベル設定を定義するには、共通設定をオーバーライドするチェックボックスを選択して、デフォルトの起動プラン・レベル設定をオーバーライドします。Oracle Computeテンプレート、形状、ネットワークおよび記憶域構成を選択します。

10. 「拡張構成」リージョンで、オプションで追加の属性を指定できます。「追加」をクリックします。「属性の追加」ウィンドウで、属性のキーと値を指定します。「タグ」フィールドでは、タグを入力してインスタンス・デプロイメント・リクエストを特定できます。オプションのネットワーク構成リージョンで、「ネットワーク構成」リージョンで定義したネットワークに追加の構成パラメータを指定できます。DNSサーバーのリストを指定したり、ネットワークをデフォルト・ゲートウェイ・ネットワークとして構成したり、基礎となる選択されたサービス・ネットワーク上でVMインスタンスをプロバイダとして構成したりすることができます。「次へ」をクリックします。

11. 確認ページが表示されます。ここまでに入力した情報を検討し、「送信」をクリックして編成リクエストを送信するか、「デプロイメント・プランとして保存」をクリックして、他の編成に使用できるデプロイメント計画として編成を保存します。

32.3 編成の詳細の表示

編成の詳細を表示するには、「インフラストラクチャ - Oracle Computeセルフ・サービス・ポータル」ページの「サービス」リージョンにある「名前」リンクをクリックします。

図32-4 「Oracle Computeオーケストレーション」ページ

このページには、次のリージョンがあります。

- 一般: このリージョンには、Oracle Computeサイトの名前、ターゲット名、起動プランの数、CPU、および割当て済メモリーが表示されます。

- VMインスタンス: 起動プラン内のVMインスタンスと、各VMインスタンスの構成(ステータス、形状、テンプレート、VNC URL、IPアドレスなど)がリストされます。VMインスタンスのホームページにドリルダウンするには、「VMインスタンス」リンクをクリックします。VMインスタンスが稼働中の場合は、「VMインスタンス」を選択し、「停止」をクリックすると、インスタンスが停止します。VMインスタンスが停止している場合にインスタンスを再開するには、「再開」をクリックします。

このページでは、次の操作を実行できます。

- 起動

- 停止

- 更新

- 停止

32.3.1 Oracle VMインスタンス・ホームページの表示

このページを表示するには、「Oracle Computeオーケストレーション」の詳細ページで、「VMインスタンス」リージョンの「名前」リンクをクリックします。

図32-5 Oracle VMインスタンス・ホームページ

このページには、VMインスタンスの詳細が表示されます。このインスタンスが関連付けられているOracle Computeサイトの名前、CPUの数、割り当てられているメモリー、記憶域、ネットワーク、関連するCPU使用率などが表示されます。次の作業が実行できます。

- 記憶域のアタッチ: VMインスタンスに記憶域をアタッチするには、このオプションを使用します。1つ以上の記憶域ボリュームを選択し、各ボリュームの索引を指定します。索引値は1から10の間にする必要があります。「アタッチ」をクリックすると、VMインスタンスに記憶域ボリュームをアタッチできます。

- 記憶域のデタッチ: VMインスタンスから記憶域をデタッチするには、リストから1つ以上の記憶域ボリュームを選択し、「デタッチ」をクリックします。

- VMインスタンスの編集: VMインスタンスの形状およびネットワーク構成を変更するには、このオプションを選択します。

- VNCコンソールの起動: VNCコンソールを起動するには、このオプションを選択します。

32.4 ネットワークの作成

VMインスタンスのために予約されている可能性があるVNetの範囲を含むネットワーク・サブネットを作成できます。ネットワーク・ページに移動するには、「ネットワーク」アイコンをクリックします。各ネットワーク内のテナント・ネットワーク、ビュー・サービス・ネットワークおよび予備IPアドレスを作成および編集できます。

図32-6 Oracle Computeセルフ・サービス・ポータル: ネットワーク

「作成」をクリックして、テナント・ネットワークのIPoIBサブネットを作成します。参照先

32.4.1 テナント・ネットワークのIPoIBサブネットの作成

IPoIBネットワークは、プライベート・セキュリティ・ドメインにデプロイされます。複数のIPoIB仮想ネットワークを、テナントのセキュリティ・ドメインにデプロイできます。これらのIPoIBネットワークは相互に隔離されず、各テナントに対して作成できます。

IPoIBサブネットを作成するには、次の手順に従います。

1. 「テナント・ネットワーク」ボックスを選択し、「作成」をクリックします。次の詳細を入力します。

- 名前: テナント管理者ユーザーの名前を入力します。

- vEthernet名: 「検索」アイコンをクリックして、リストから「VEthernet」を選択します。

- 作成モード: 「CIDR/IP範囲」または「グローバルIP」です。

- CIDR: サブネットのIPアドレスをCIDR(Classless Inter-Domain Routing)形式で入力します。CIDRアドレスは標準の32ビットIPアドレスを含み、いくつのビットが接頭辞として使用されるかを示します。
たとえば、206.13.1.48/25というアドレスは、最初の25ビットが一意のネットワークを識別するために使用されることを示しています。残りのビットは、特定のホストを識別するために利用できます。指定したネットワークを他のEoIBネットワークで使用することはできません。

- グローバルIP: IPプールは、1つ以上のIPプール・エントリで構成される公開IP範囲のプールです。グローバルIPプールがサイト構成で有効化されている場合、グローバルIPプール・アドレス番号を指定します。この番号が指定されている場合、IPアドレスはIPアドレスのグローバル・プールから割り当てられます。

- Ethernetインタフェース索引: このチェック・ボックスを選択してEthernetインタフェース索引番号を指定します。

- 説明: EoIBネットワークの説明を入力します。

- IP範囲: 「追加」をクリックして、IP-IPの形式で、IPアドレス範囲を追加します。たとえば、10.242.2.211-10.242.2.215となります。

2. 「作成」をクリックすると、IPoIBサブネットが作成され、「ネットワーク」ページに戻ります。

32.4.2 サービス・ネットワークの表示

使用可能なサービス・ネットワークがここにリストされます。サブネット、タイプ、説明、CIDRおよびIPアドレス範囲が表示されます。

32.5 記憶域ボリュームの作成

記憶域ボリューム・ページを表示するには、「記憶域」アイコンをクリックします。記憶域ボリューム・オブジェクトはインスタンスにアタッチできる単一ボリュームです。このページには、記憶域ボリュームの名前、ステータス、サイズおよびそのプロパティが表示されます。

図32-7 Oracle Computeセルフ・サービス・ポータル: 記憶域

「作成」をクリックします。記憶域ボリュームの作成ページに、記憶域ボリュームの名前が表示されます。サイズ、説明を入力し、ボリュームのテンプレートを選択します。「OK」をクリックすると、記憶域ボリュームが作成されます。

記憶域ボリュームのスナップショットまたはコピーをとって、別のテナントに属するユーザーが利用できるようにできます。リストから記憶域ボリュームを選択して、「スナップショット」をクリックします。記憶域ボリュームのスナップショットのウィンドウの「ターゲット・ボリューム」ドロップダウン・フィールドでターゲット・テナント名を選択し、スナップショットの名前を入力して、サイズとスナップショットの説明を指定します。「OK」をクリックするとスナップショットが作成され、「記憶域」ページに戻ります。

32.6 ライブラリの管理

このページにはテンプレートと、テナント・ユーザーが利用できる保存済デプロイメント・プランがリストされます。このページにアクセスするには、「ライブラリ」アイコンをクリックします。

図32-8 Oracle Computeセルフ・サービス・ポータル: ライブラリ

各テンプレートに、テンプレートの名前、属性、割り当てられた割当て制限およびサイズが表示されます。すべてのテンプレート、パブリックで使用できるテンプレートまたは選択されたテナンシーで使用できるテンプレートを選択して表示できます。

32.6.1 テンプレートのアップロード

テンプレートは、オペレーティング・システムがインストールされた仮想ハード・ディスクのコピーであり、インスタンスの起動に使用されます。テンプレートは、gzipで圧縮されてtarアーカイブに格納されたディスク・イメージ全体(パーティション表とカーネルを含む)である必要があります。テンプレートをアップロードするには、次の手順に従います。

1. 「アップロード」をクリックします。「テンプレート管理: テンプレートのアップロード」ウィンドウが表示されます。テンプレートのアップロード時に、テンプレートの適用範囲は次のいずれかです。

- パブリック: テンプレートはすべてのユーザーが利用できます。このオプションを選択した場合、「名前」フィールドにテンプレートの名前を入力します。

- テナント: テンプレートは、選択したテナントに属するユーザーのみが利用できます。このオプションを選択する場合、「名前」ドロップダウン・フィールドで「テナント」を選択し、テンプレートの名前を指定します。テンプレートは、選択したテナント内のすべてのユーザーが利用できます。

2. サービス・インスタンスがプロビジョニングされたときに使用される追加の属性を指定します。

3. 「テンプレートの選択」フィールドで、アップロードするテンプレートを選択します。アップロードするテンプレートは、ローカル・ディスクまたはソフトウェア・ライブラリのどちらにあるものでも使用できます。

4. 「アップロード」をクリックすると、テンプレートがアップロードされます。新規にアップロードされたテンプレートは、次の詳細とともに表示されます。

- 名前: テンプレートの名前。すべてのユーザーがテンプレートを利用できる場合、名前の形式は/oracle/public/<image_name>です。選択したテナントに属するユーザーのみがテンプレートを利用できる場合、形式は<tenant_name>/public/<image_name>です。

- 属性: テンプレートのアップロード時に指定された、任意のユーザー定義の属性。

- 割当て: テンプレートに指定された割当て。

- アップロード済のサイズ: アップロードされたテンプレートのサイズ。

- 合計サイズ: テンプレートの合計サイズ。

- 解凍済サイズ: 解凍された状態でのテンプレートのサイズ。

- 構成済エージェント: このテンプレートに対して管理エージェントが構成されているかどうかを示します。

32.6.2 テンプレートまたはデプロイメント・プランの削除

テンプレートを削除するには、「ライブラリ」リージョンのリストからテンプレートを選択し、「削除」をクリックします。確認メッセージが表示されます。「削除」をクリックして確認します。

後でデプロイメントするために保存されたデプロイメント・プランは、保存済デプロイメント・プランのリージョンに表示されます。プランを選択して「削除」をクリックし、「OK」をクリックして削除を確認します。

32.7 オーケストレーションの検出

このオプションを使用して、Enterprise Managerを使用せずに外部的に作成した任意のオーケストレーションを検出できます。

オーケストレーションを検出するには、次の手順を実行します:

1. 「アクション」メニューから、「検出」を選択し、「オーケストレーションを選択します。」

2. 確認メッセージが表示されます。「送信」をクリックして、リクエストを送信し、オーケストレーションを検出します。

33 Oracle Computeサイトと関連ターゲットの管理

この項では、Oracle ComputeサイトおよびOracle Compute Cluster、Oracle Virtual PlatformおよびOracle VM Instanceなどの関連ターゲットの表示表法および管理方法について説明します。内容は次のとおりです。

- Oracle Computeサイトの表示

- ネットワークの管理

- 記憶域ボリュームの作成

- ユーザーの作成

- Oracle VMインスタンス・ホームページの表示

- Oracle Compute Clusterのホームページの表示

- 「Oracle Virtual Platform」ホームページの表示

- 「Oracle Server」ホームページの表示

33.1 Oracle Computeサイトの表示

Oracle Computeサイトは、1つ以上のクラスタを持ち、Oracle Compute Directorを実行している場所です。Oracle Computeサイトのホームページを表示するには、「ターゲット」メニューから、「すべてのターゲット」を選択します。左上の「検索」パネルのグループ、システムおよびサービスで、「Oracle Computeサイト」をクリックします。検出されたOracle Computeサイトのリストが表示されます。「ターゲット名」リンクをクリックして、ホームページをドリルダウンします。

図33-1 Oracle Computeサイトのホームページ

このページには、次のリージョンがあります。

注意:
このページには、ドメイン0 (制御ドメイン)のメトリックのみが表示されます

- 一般: このリージョンには、次の詳細が表示されます。

- 監視するターゲットの数

- すべてのターゲットの集約ステータス

- クラスタ、仮想プラットフォーム、VMインスタンスの数およびサイト内のCPUコアの総数

- サーバー・メモリーの合計

- 利用できるDom0メモリーの合計

- Oracle ComputeエンドポイントURL

- Oracle Computeターゲットを監視するGraphite URL。

- 検出されれば、Exalogic Elastic Cloudターゲット。

- 集約されたDom0 CPUとメモリーの使用率: このリージョンには、集約CPUとサイト内のすべてのターゲットのメモリー使用量が表示されます。

- 上位テナント: このリージョンには、サイト内の上位テナントが表示されます。「表示方法」ドロップダウン・リストから、次を選択できます。

- 使用量: vCPU、メモリーおよび記憶域を横断して、サイト内のテナントごとの最大使用量が表示されます。「テナント名」リンクをクリックして、「テナント」ホームページをドリルダウンします。

- 割当て量: サイト内の上位テナントに割り当てられているvCPUの数、メモリーおよび記憶域が表示されます。「テナント名」をクリックして、「テナント」ホームページをドリルダウンします。

注意:このリージョンには、EM_CLOUD_ADMINISTRATORロールを持つユーザーの優先資格証明が指定された場合にのみ表示されます。

- リソース使用率: このリージョンには、割当ておよび実際の使用状況に関して、物理リソースがテナントにどのように割り当てられているかが表示されます。割当てのホームページにドリルダウンするには、割当て量のリンクをクリックします。

- メンバー・インスタンス: Oracle Computeサイト内のすべてのメンバー・インスタンスをリストします。各メンバー・インスタンスに対して、Oracle VMインスタンスの名前、Oracle Virtual Platform、ステータス、割当てメモリーおよびvCPUの数が表示されます。例による問合せ機能を使用して、表示されるメンバーのリストをフィルタできます。Oracle VMインスタンスまたはOracle Virtual Platformのホームページにドリルダウンするには、それぞれのリンクをクリックします。

- 集約されたDom0 CPUとメモリーの使用率: このチャートには、直近24時間の、このサイト内のすべてのターゲットごとの集計済CPUとメモリー使用率が表示されます。

- CPU使用率: このリージョンには、クラスタごとの相対的なCPU使用率が表示されます。すべてのクラスタを表示するか、上位の1つまたは5つのクラスタを表示するかを選択できます。

- メモリー使用率: このリージョンには、クラスタごとのメモリー使用率が表示されます。すべてのクラスタを表示するか、上位の1つまたは5つのクラスタを表示するかを選択できます。

- インシデントと問題: このリージョンには、最近7日間に発生したインシデントまたは問題が表示されます。

- ジョブ: このリージョンには、開始日が最近7日以内であるジョブのサマリーが表示されます。

「Oracle Computeサイト」メニューでは、次のオプションが選択できます:

- ネットワーク: 第33.2項「ネットワークの管理」を参照してください。

- 記憶域: 第33.3項「記憶域ボリュームの作成」を参照してください。

- ユーザー管理

- テナント: 第31.2項「テナントの作成」を参照してください。

- ユーザー: 第33.4項「ユーザーの作成」を参照してください。

- 割当て: 第31.4項「割当て制限の定義」を参照してください。

- イメージ管理: 第31.5項「Oracle Computeテンプレートの管理」を参照してください。

- 形状管理: 第31.3項「形状の作成」を参照してください。

33.2 ネットワークの管理

Exalogicマシンには、計算ノード、ストレージ・アプライアンス、スイッチおよび使用するネットワークに計算ノードを接続するための装置が含まれます。ネットワークの接続により、サーバーをリモートで管理できるようになり、クライアントから計算ノードへの接続が可能になり、クライアントがストレージ・アプライアンスにアクセスできます。Exalogicネットワーク構成の詳細は、Oracle Exalogic Elasticマシン・オーナーズ・ガイドを参照してください。

このリリースでは、Oracle Computeサービスが拡張されて、InfiniBandネットワークをサポートしています。ネットワーク隔離は、クラウド・インフラストラクチャ内で次の方法により採用されます。

- テナント内のネットワーク隔離。テナントを作成すると、プライベートおよびパブリック・セキュリティ・ドメインが作成されます。プライベート・ドメイン・セキュリティは、Exalogicラックのテナント内の隔離された通信で使用されます。パブリック・セキュリティ・ドメインは、NM2 Gatewayを介した、テナントとExalogic外部のEthernetインフラストラクチャとの間の隔離された通信で使用されます。パブリックおよびプライベート・ドメインのどちらも、通信は特定のテナントとそのテナントのセキュリティ・ドメイン内で隔離されます。

- サービス・プロバイダにインスタンスがアクセスするために作成されたサービス・ネットワークにより、通信がサービス・プロバイダとサービス・コンシューマとの間またはサービス・プロバイダ同士でのみ許可されます。サービス・ネットワーク接続性は、サービス・コンシューマ同士の通信では許可されません。

サポートされるネットワーク形式は、仮想Ethernet(vEthernets)、フラット・ネットワーク、ネットワーク・アドレス変換(NAT)およびネットワーク・サービス・クラスタです。vEthernetは、VLANをサポートする仮想OSIレイヤー2ネットワークです。vEthernetを使用すると、特定の部門またはビジネス・ユニットで実行されるインスタンスのためのネットワークの隔離が容易になります。Oracle ComputeのvEthernetには、スイッチング・インフラストラクチャ上のVLANとの1対1のマッピングがあり、通常、ビジネス・ユニットまたは部門に関連付けられます。フラット・ネットワークは単一のIPルーテッド・ドメインで、そこではいかなるIPアドレスも相互にルーティング可能です。インスタンスの保護は、セキュリティ・リスト(Hypervisor上のソフトウェア・ファイアウォール)によります。そのようなネットワーク上の仮想マシン間の隔離では、Oracle Computeはセキュリティ・リストを使用してハイパーバイザ自身にセキュリティ・ポリシーを強制します。

次のタイプのネットワークを作成できます。

- テナント・ネットワーク

- サービス・ネットワーク

- インフラストラクチャ・ネットワーク

33.2.1 テナント・ネットワークの作成

テナント・ネットワークは、仮想ネットワークおよびその仮想ネットワークと対話するVMのデプロイメントに、隔離または保護された環境を提供します。Exalogicでは、テナントは、2つの隔離されたドメイン(パブリックおよびプライベート)を定義する基本構造体です。各ドメインは、それに割り当てられたInfiniBandパーティション・キーを持っています。パブリック・ドメインは、Ethernet上で動作するExalogicの外部にあるComputeノードおよびエンティティ相互の間の通信を可能にするための、vlanタグを付けられた仮想ネットワークをデプロイするために使用されます。プライベート・ドメインは、Computeノード間の通信のためのIBプライベート・ネットワークをデプロイするために使用されます。次のネットワークが作成されます:

- EoIBネットワーク: パブリック・テナント・ネットワーク

- IPoIBネットワーク: プライベート・テナント・ネットワーク

33.2.1.1 EoIBネットワークの作成

EoIB (Ethernet over Infiniband)ネットワークは、パブリック・セキュリティ・ドメインにデプロイされ、VLANに関連付けられます。これらは、テナントのVMを特定のVLANに関連付けるために使用されます。EoIBは、Exalogicマシン・ラック内部のコンポーネントがExalogicマシン・ラック外のコンポーネントとの通信に使用します。複数のEoIB仮想ネットワークを、テナントのパブリック・セキュリティ・ドメインにデプロイできます。これらのネットワークは相互に隔離されません。これらのネットワーク・サブネットはExalogicマシンの外部に定義されるため、EoIBネットワークを作成および管理できるのは、クラウド管理者のみです。

EoIBネットワークを作成するには、次の手順に従います:

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 左側のパネルで「Oracle Computeサイト」リンクをクリックします。登録されたOracle Computeサイトのリストが表示されます。Oracle Computeサイトのホームページにドリルダウンするには、「Oracle Computeサイト」をクリックします。

4. 「Oracle Computeサイト」メニューから「ネットワーク」を選択し、続いて「テナント・ネットワーク」を選択します。

5. EoIBネットワークを作成するテナントを選択します。「アクション」メニューから、「EoIB vEthernetの作成」を選択します。

6. 図33-2 EoIB vEthernetの作成

次の詳細を入力します。

- 名前: テナント管理者ユーザーの名前を入力します。

- vLAN: このネットワークのVLAN ID (2から4095の範囲)を指定します。

- 説明: EoIBネットワークの説明を入力します。

- ポートの切替え: ドロップダウン・リストからスイッチ・ポートを選択します。

7. EoIBネットワークを作成するには、「作成」をクリックします。新しく作成されたネットワークは、「ネットワーク」ページに表示されます。

33.2.1.2 EoIBサブネットの作成

EoIBサブネットを作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 左側のパネルで「Oracle Computeサイト」リンクをクリックします。登録されたOracle Computeサイトのリストが表示されます。Oracle Computeサイトのホームページにドリルダウンするには、「Oracle Computeサイト」をクリックします。

4. 「Oracle Computeサイト」メニューから「ネットワーク」を選択し、続いて「テナント・ネットワーク」を選択します。

5. EoIBネットワークを作成するテナントを選択します。「アクション」メニューから、「EoIBサブネットの作成」を選択します。

図33-3 EoIBサブネットの作成

次の詳細を入力します。

- 名前: テナント管理者ユーザーの名前を入力します。

- VEthernet名: vEthernet名を入力します。

- CIDR: サブネットのIPアドレスをCIDR(Classless Inter-Domain Routing)形式で入力します。CIDRアドレスは標準の32ビットIPアドレスを含み、いくつのビットが接頭辞として使用されるかを示します。
たとえば、206.13.1.48/25というアドレスは、最初の25ビットが一意のネットワークを識別するために使用されることを示しています。残りのビットは、特定のホストを識別するために利用できます。指定したネットワークを他のEoIBネットワークで使用することはできません。

- ゲートウェイ: ゲートウェイのIPアドレスを入力します。

- Ethernetインタフェース索引: 作成したvNetsに索引番号を指定する場合、このチェックボックスを選択します。

- 説明: EoIBネットワークの説明を入力します。

- IP範囲: 「追加」をクリックして、IP-IPの形式で、IPアドレス範囲を追加します。たとえば、10.242.2.211-10.242.2.215となります。

6. 「作成」をクリックすると、EoIBサブネットが作成され、「ネットワーク」ページに戻ります。

33.2.1.3 IPoIBサブネットの作成

IPoIBネットワークは、プライベート・セキュリティ・ドメイン上にデプロイされ、テナント内にVMを関連付けるために使用されます。複数のIPoIB仮想ネットワークを、テナントのセキュリティ・ドメインにデプロイできます。これらのIPoIBネットワークは相互に隔離されず、各テナントに対して作成できます。IPoIBサブネットを作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 左側のパネルで「Oracle Computeサイト」リンクをクリックします。登録されたOracle Computeサイトのリストが表示されます。Oracle Computeサイトのホームページにドリルダウンするには、「Oracle Computeサイト」をクリックします。

4. 「Oracle Computeサイト」メニューから「ネットワーク」を選択し、続いて「テナント・ネットワーク」を選択します。

5. EoIBネットワークを作成するテナントを選択します。「アクション」メニューから、「IPoIBサブネットの作成」を選択します。

図33-4 IPoIBサブネットの作成

- 名前: テナント管理者ユーザーの名前を入力します。

- 作成モード: 「CIDR/IP範囲」または「グローバルIP」です。

- CIDR: サブネットのIPアドレスをCIDR(Classless Inter-Domain Routing)形式で入力します。CIDRアドレスは標準の32ビットIPアドレスを含み、いくつのビットが接頭辞として使用されるかを示します。
たとえば、206.13.1.48/25というアドレスは、最初の25ビットが一意のネットワークを識別するために使用されることを示しています。残りのビットは、特定のホストを識別するために利用できます。指定したネットワークを他のEoIBネットワークで使用することはできません。

- グローバルIP: IPプールは、1つ以上のIPプール・エントリで構成される公開IP範囲のプールです。グローバルIPプールがサイト構成で有効化されている場合、グローバルIPプール・アドレス番号を指定します。この番号が指定されている場合、IPアドレスはIPアドレスのグローバル・プールから割り当てられます。

- ゲートウェイ: ゲートウェイのIPアドレスを入力します。

- Ethernetインタフェース索引: 作成したvNetsに索引番号を指定する場合、このチェックボックスを選択します。

- 説明: EoIBネットワークの説明を入力します。

- IP範囲: 「追加」をクリックして、IP-IPの形式で、IPアドレス範囲を追加します。たとえば、10.242.2.211-10.242.2.215となります。

6. 「作成」をクリックすると、IPoIBサブネットが作成され、「ネットワーク」ページに戻ります。

33.2.1.3.1 IPoIBサブネットの編集

IPoIBサブネットを編集するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 左側のパネルで「Oracle Computeサイト」リンクをクリックします。登録されたOracle Computeサイトのリストが表示されます。Oracle Computeサイトのホームページにドリルダウンするには、「Oracle Computeサイト」をクリックします。

4. 「Oracle Computeサイト」メニューから「ネットワーク」を選択し、編集するIPoIBサブネットを選択します。次の詳細が表示されます。

- 名前

- CIDR

- IPアドレスの数

- IP範囲

- 合計: 使用可能なIPアドレスの合計数。

- 予約済: 割当て済IPアドレスの数。

- 使用済: インスタンスが使用しているIPアドレスの数。

- 失敗割当: VNetの作成または更新以降、失敗したIPアドレス割当ての数。

5. 1つ以上のIP予約を追加するには、「IP予約」リージョンで「追加」をクリックします。「IP予約の作成」ウィンドウに予約の名前とIPアドレスを入力して、「OK」をクリックします。

6. 「アクション」メニューから「編集」を選択します。「IPoIBサブネットの更新」ページで、「IPアドレスの数」、「Ethernetインタフェース索引」および「説明」を編集できます。「説明」をクリックして詳細を更新し、前のメニューに戻ります。

33.2.2 サービス・ネットワークの管理

サービス・ネットワークは、複数のテナント同士でサービスを共有するためにExalogic内で作成されます。共有サービスには、ストレージ、ネットワークおよびその他のエンジニアド・システムが含まれます。外部サービス・プロバイダの例は、テナントを通じて共有されるストレージを提供するZFSストレージ・アプライアンスです。

InfiniBandパーティションは、サービス・ネットワークに割り当てられます。クラスタの計算ノードは、プロバイダまたはコンシューマとして定義されます。プロバイダは、InfiniBandパーティションの完全なメンバーシップが付与されます。一方、コンシューマは、InfiniBandパーティションへの制限されたメンバーシップが付与されます。このサービス・ネットワークを通じ、コンシューマはプロバイダと通信できますが、互いに通信することはできません。プロバイダは、通常、1つ以上のテナントでサービスが使用できるストレージのような共通サービスです。

各サービスは自動的にInfiniBandパーティションに割り当てられ、2つのサービス・ネットワークがパーティションを共有することはありません。サービス・ネットワークは、クラウド管理者により作成されます。

サービス・ネットワークには、次の2つのタイプがあります:

- IPoIBサービス・ネットワーク: IPoIBサービス・ネットワークは、Exalogicシステム内か、InfiniBandファブリックに直接接続されている(Exadataなど)、サービス・プロバイダとの通信に使用されます。たとえば、Oracle ZFSストレージ・アプライアンスからの共有ストレージなどです。

- EoIBサービス・ネットワーク: EoIBサービス・ネットワークは、Exalogicシステムの外部にあるサービス・プロバイダとの通信のために使用されます。

33.2.2.1 サービス・ネットワークの作成

サービス・ネットワークは、ユーザーに特定のサービスを提供します。サービス・ネットワークは、2つ以上のテナントが使用可能である必要がある共通サービスに必要です。たとえば、共有記憶域へのアクセスを提供するZFSアプライアンスなどです。

サービス・ネットワークを作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 左側のパネルで「Oracle Computeサイト」リンクをクリックします。登録されたOracle Computeサイトのリストが表示されます。Oracle Computeサイトのホームページにドリルダウンするには、「Oracle Computeサイト」をクリックします。

4. 「Oracle Computeサイト」メニューから「ネットワーク」を選択し、続いて「サービス・ネットワーク」を選択します。「アクション」メニューから、「サービスの作成」を選択して、次の詳細を入力します。

- 名前: テナント管理者ユーザーの名前を入力します。

- プロバイダ・ノード: チェック・ボックスを選択すると、すべての既存のノードがサービス・ネットワークのプロバイダ・ノードのリストに追加されます。

- 説明: サービス・ネットワークの説明を入力します。

5. 「作成」をクリックすると、サービス・ネットワークが作成され、「ネットワーク」ページに戻ります。

33.2.2.2 エンジニアド・システムへの接続

Infinibandファブリックを使用するExadataサーバーに、Exalogicマシンを接続できます。エンジニアド・システムに接続するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 左側のパネルで「Oracle Computeサイト」リンクをクリックします。登録されたOracle Computeサイトのリストが表示されます。Oracle Computeサイトのホームページにドリルダウンするには、「Oracle Computeサイト」をクリックします。

4. 「Oracle Computeサイト」メニューから「ネットワーク」を選択し、続いて「サービス・ネットワーク」を選択します。「アクション」メニューから、「エンジニアド・システムの接続」を選択して、次の詳細を入力します。

- 名前: テナントの名前。

- パーティション・キー: InfiniBandパーティションは、相互の通信を許可されるInfiniBandノードのグループを定義します。InfiniBandファブリックにネットワーク隔離を実装することによって、InfiniBandパーティションを使用してExalogicマシンのセキュリティを向上させることができます。さらに、特定のVLANにInfiniBandノードを関連付けることができます。パーティション・キーは、InfiniBandパーティションに割り当てられる一意のIDです。サービス・ネットワークに関連付けられる外部パーティション・キーを指定します。指定するパーティション・キーは、別のサービス・ネットワークで使用されていてはなりません。

- 外部パーティション: このチェックボックスが選択されている場合、外部的に定義されたパーティション・キーに関連付けられたサービス・ネットワークが作成されます。

- プロバイダ・ノード: このチェックボックスを選択すると、プロバイダ・ノードが追加されます

- 説明: サービス・ネットワークの説明を入力します。

5. 「作成」をクリックすると、サービス・ネットワークが作成され、「ネットワーク」ページに戻ります。

33.2.3 インフラストラクチャ・ネットワークの管理

インフラストラクチャ・サービス・ネットワークは、Exalogicマシンの構成中にExalogic Configuration Utility (ECU)で作成されるサービス・ネットワークです。これらのネットワークは、プラットフォーム上で使用可能な基本的ないくつかのサービスを活用できるExalogicネットワーク・アクセスを提供するために使用します。これらは、制御ネットワークで、顧客によってデプロイされたインスタンスおよびExalogicコントロールで結合的に使用されます。

次のインフラストラクチャ・ネットワークはスイッチおよびZFSストレージ上に作成されます(EoIBネットワークを除く)。

- IPoIB管理: このネットワークはOracle Compute pxeサービスに使用され、flexbootはこのパーティションに対して構成されます。

- IPoIBストレージ: Dom0からのすべてのOracle Compute関連のZFSアクセスに使用されます。

- IPoIBインスタンス・ストレージ: ZFSストレージにアクセスするコントロールVM (読取り/書込み)およびクライアントVM (読取り専用)に使用されます。

- EoIB管理ネットワーク: Oracle Compute APIサービス・アクセスおよびコントロールVMに使用されます。

- デフォルト: IPoIBのデフォルトのパーティション(0x7FF)。

33.3 記憶域ボリュームの作成

記憶域プールは記憶域サーバー上の単一の論理記憶領域(NFSエクスポート)を表します。記憶域プールの名前、記憶域プールの合計サイズ(物理)、使用される領域の容量、記憶域プールのパスおよびプロパティが表示されます。

記憶域ボリューム・オブジェクトはインスタンスにアタッチできる単一ボリュームです。このページには、記憶域ボリュームの名前、ステータス、サイズ、それが関連付けられるOracle仮想サーバーおよびそのプロパティが表示されます。記憶域ボリュームを作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 左側のパネルで「Oracle Computeサイト」リンクをクリックします。登録されたOracle Computeサイトのリストが表示されます。Oracle Computeサイトのホームページにドリルダウンするには、「Oracle Computeサイト」をクリックします。

4. 「Oracle Computeサイト」メニューから「記憶域」を選択して、記憶域プールのホームページを表示します。「記憶域プール」リージョンに、記憶域プールの名前、サイズ、ステータス、パスおよびプロパティまたはプールの特性が表示されます。

図33-5 記憶域プール

5. Oracle Computeサイトの記憶域ボリュームが表示されます。記憶域ボリューム・オブジェクトはインスタンスにアタッチできる単一ボリュームです。各ボリュームはサイズを持ち、選択されたテナントのすべてのユーザーが使用できます。記憶域ボリュームは、複数のインスタンス全体で共有できます。新しい記憶域ボリュームを作成するには、「作成」をクリックします。

図33-6 記憶域ボリュームの作成

6. 「記憶域ボリュームの作成」ウィンドウで、名前(<tenant_name/public/<storage_vol_name>形式)、サイズ、説明を入力し、オプションでボリュームのテンプレートを選択します。「OK」をクリックすると、記憶域ボリュームが作成されます。

33.3.1 記憶域ボリューム・スナップショットの作成

記憶域ボリュームのスナップショットまたはコピーをとって、別のテナントに属するユーザーが利用できるようにできます。記憶域ボリューム・スナップショットを作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

3. 左側のパネルで「Oracle Computeサイト」リンクをクリックします。登録されたOracle Computeサイトのリストが表示されます。Oracle Computeサイトのホームページにドリルダウンするには、「Oracle Computeサイト」をクリックします。

4. 「Oracle Computeサイト」メニューから「記憶域」を選択して、記憶域プールのホームページを表示します。記憶域プールの名前、サイズ、ステータス、パスおよびプロパティまたはプールの特性が表示されます。

5. Oracle Computeサイトの記憶域ボリュームが表示されます。リストから記憶域ボリュームを選択して、「スナップショット」をクリックします。

6. 記憶域ボリュームのスナップショットのウィンドウの「ターゲット・ボリューム」ドロップダウン・フィールドでターゲット・テナント名を選択し、スナップショットの名前を入力して、サイズとスナップショットの説明を指定します。「OK」をクリックするとスナップショットが作成され、「記憶域」ページに戻ります。

33.4 ユーザーの作成

ユーザーは、リクエストすることができるOracle Computeサイト内のエンティティです。各ユーザーは、1つのテナントと関連付けられます。

ユーザーを作成するには、次の手順に従います。

1. EM_CLOUD_ADMINISTRATORロールを持つユーザーでEnterprise Managerにログインします。

2. 「エンタープライズ」メニューから、「クラウド」、「クラウド・ホーム」の順に選択して、Oracle Computeサイトのホームページに移動します。

3. 「Oracle Computeサイト」メニューから、「ユーザー管理」、「ユーザー」の順に選択します。

4. 「ユーザー管理」ページが表示されます。「作成」をクリックします。「ユーザーの追加」ウィンドウが表示されます。

図33-7 「Add User」ページ

5. 次のいずれかのロール・タイプを入力します。

- クラウド管理者: このロールを持つユーザーは、ターゲットの検出、ユーザーの作成およびその他の設定操作を実行できます。詳細は、Enterprise Manager Cloud管理者ガイドを参照してください。

- テナント管理者: このロールを持つユーザーは、新しいインスタンスのリクエスト、1人以上のテナント・ユーザーの追加、およびユーザーへの割当て制限の割当てなどの操作を実行できます。

- テナント・ユーザー: このロールをもつユーザーは、新しいインスタンスをリクエストできます。

6. 作成するユーザー・ロールに応じて、「ユーザー名」フィールドに、次の形式でユーザー名を入力する必要があります。

- クラウド管理者: /cloud/<user_name>

- テナント管理者: /<tenant_name>/<tenant_admin_name>

- テナント・ユーザー: /<tenant_name>/<tenant_user_name>

7. ユーザーのフル・ネーム、パスワードおよび電子メール・アドレスを入力します。

8. 「ログインが有効」フィールドで、「True」を選択します。このフィールドでは、管理者はユーザーのログインを有効化または無効化できます。

9. 「追加」をクリックします。新しく作成されたユーザーは、「ユーザー管理」ページに表示されます。

33.5 Oracle VMインスタンス・ホームページの表示

Oracle VMインスタンスは、仮想マシンとして実行されるマシン・イメージをインスタンス化したものです。インスタンスには、たとえば割当て済RAM、使用可能CPU数、アタッチ済ネットワーク・インタフェースなどの属性があります。インスタンスは、起動元のイメージと、ホスト間に存在する配置関係をリストして、希望するセットのホストを指定する編成を介して作成されます。Oracle VMインスタンスのホームページを表示するには、Oracle Computeサイト・ホームページの、Oracle VMインスタンスのリンクをクリックします。

図33-8 Oracle VMインスタンス・ホームページ

このページには、次のリージョンがあります。

- 一般: このリージョンには、インスタンスが実行されているOracle Computeサイト、Oracle Compute Cluster、Oracleサーバー、Oracle Virtual Platform、およびこのインスタンスに関連付けられたOracle Compute Orchestrationが表示されます。リンクをクリックして、いずれかのホームページにドリルダウンすることができます。また、ターゲット名、CPUの数、割当て済メモリー、形状、割当て(設定されている場合)、VNC URL、IPアドレスおよびDNSゾーンも表示されます。

- 可用性: 直近24時間のインスタンスの可用性が表示されます。

- 関連CPU使用率: 仮想マシンごとの相対的なCPU使用率が表示されます。

- インシデントと問題の概要: このリージョンには、直近7日間に発生したインシデントと問題がリストされます。

- ネットワーク: ネットワーク・インタフェースとMACアドレスの名前がリストされます。

- 記憶域: 存在するすべての記憶ボリュームがリストされます。

33.6 Oracle Compute Clusterのホームページの表示

Oracle Computeクラスタは、同じEthernetドメインでOracle Computeソフトウェアを実行している、3つ以上の物理ノードのグループです。通常のマルチ・クラスタ構成では、ルーターは2つ以上のサブネットとブロードキャスト・ドメイン(クラスタあたり1つ)をリンクします。サイトは1つ以上のクラスタで構成されます。Oracle Compute Clusterのホームページを表示するには、Oracle ComputeサイトのホームページでOracle Compute Clusterのリンクをクリックします。

図33-9 Compute Clusterのホームページ

このページには、次のリージョンがあります。

注意:
このページには、ドメイン0 (制御ドメイン)のメトリックのみが表示されます

- 一般: このリージョンには、クラスタ内のすべてのターゲットの集計済ステータス、このクラスタが属するOracle Computeサイト、クラスタの仮想プラットフォームとVMインスタンスの数、CPUコアの総数、合計サーバー・メモリー、利用可能な合計Dom0メモリーおよびターゲット名が表示されます。

- 集計済Dom0 CPUとメモリーの使用率: このリージョンには、直近1時間の集計済CPUとメモリー使用率が表示されます。

- メンバー・インスタンス: クラスタ内のOracle VMインスタンスをリストします。Oracle VMインスタンスまたはOracle Virtual Platformのホームページにドリルダウンするには、それぞれのリンクをクリックします。

- CPU使用率: このリージョンには、クラスタ内の仮想プラットフォームごとのCPU使用率が表示されます。すべての仮想プラットフォームと上位5つのどちらを表示するかを選択できます。ホームページにドリルダウンするには、Oracle Virtual Platformのリンクをクリックします。

- メモリー使用率: このリージョンには、クラスタ内の仮想プラットフォームごとのメモリー使用率が表示されます。すべての仮想プラットフォームと上位5つのどちらを表示するかを選択できます。ホームページにドリルダウンするには、Oracle Virtual Platformのリンクをクリックします。

- インシデントと問題: このリージョンには、最近7日間に発生したインシデントまたは問題が表示されます。

33.7 「Oracle Virtual Platform」ホームページの表示

このページへドリルダウンするには、Compute Clusterのホームページの「Oracle Virtual Platform」リンクをクリックします。

図33-10 「Oracle Virtual Platform」ページ

このページには、次のリージョンがあります。

- 一般: このリージョンには、Oracle Computeサイトの名前と、Oracle Virtual Platformが属するOracle Computeクラスタが表示されます。これらのいずれかのリンクをクリックして、それぞれのホームページにドリルダウンすることができます。Dom0割当て済メモリー、ターゲット名およびOracle Compute名も表示されます。

- CPU使用率: このリージョンには、直近24時間の仮想プラットフォームごとのCPU使用率が表示されます。

- メンバー: このリージョンには、この仮想プラットフォームの上で実行されているすべてのVMインスタンス、それらのステータスおよび各仮想サーバーに割り当てられているメモリーがリストされます。Oracle VMインスタンスまたはOracle Virtual Platformのホームページにドリルダウンするには、それぞれのリンクをクリックします。

- メモリー使用率: このリージョンには、直近24時間の仮想プラットフォームごとのメモリー使用率が表示されます。

- ネットワーク・アクティビティ: このリージョンには、直近24時間の仮想プラットフォームごとのネットワーク・アクティビティが表示されます。

- インシデントと問題の概要: このリージョンには、Oracle Serverターゲットに関連するすべてのインシデントと問題が表示されます。

- 可用性: このリージョンのチャートには、ターゲットの過去24時間のステータスが表示されます。

33.8 「Oracle Server」ホームページの表示

このページへドリルダウンするには、Oracle Virtual Platformのホームページの「Oracle Server」リンクをクリックします。

図33-11 「Oracle Server」ホームページ

このページには、次のリージョンがあります。

- 一般: このリージョンには、Oracle Computeサイト、Oracle Compute Clusterおよびサーバーが存在するOracle Virtual Platformが表示されます。クロック周波数、ターゲット名、CPUソケットの数、ソケットあたりのCPUコアの数、コアあたりのCPUスレッドの数、CPUコアの総数、合計メモリーおよびローカル・ディスク領域も表示されます。

- 可用性: このリージョンのチャートには、ターゲットの過去24時間のステータスが表示されます。

- インシデントと問題の概要: このリージョンには、Oracle Serverターゲットに関連するすべてのインシデントと問題が表示されます。

第XII部

動的リソース・プロビジョニング

この項では、動的リソース・プロビジョニング機能について説明します。

次の章で構成されます。

- 第34章「Oracle VM Server for SPARCによる動的リソース・プロビジョニング」

- 第35章「動的リソース・プロビジョニングの開始」

- 第36章「DBaaSクラウドでのリソースのプロビジョニング」

- 第37章「MWaaSクラウドでのリソースの動的なプロビジョニング」

34 Oracle VM Server for SPARCによる動的リソース・プロビジョニング

Oracle Enterprise Manager Cloud Controlは、仮想データセンター(vDC)を作成および管理するために、Enterprise Manager Ops Centerに統合されています。vDC内で、vServerはユーザーにとって完全なシステムとして認識され、ユーザーは、それをDBaaSまたはMWaaSプライベート・クラウドとしてオンデマンドで最適化できます。

34.1 PaaSソリューション用の統合

Oracle Enterprise Manager Ops Centerで、IaaSクラウド・プラットフォーム・サービスは、仮想データセンター(vDC)、つまり、プールされたサーバー、ストレージおよびネットワーク・リソースによりサポートされる仮想環境です。クラウド管理者は、vDCを設定してSPARC(論理ドメイン)用のOracle VMサーバーを実行します。Enterprise Manager Cloud Controlユーザーは、論理ドメインで必要に応じてvServerを自動的に作成します。各vServerは、vDCのリソースから要件を引き出します。

この項では、Enterprise Manager Ops CenterでvDCを作成する方法とそれをEnterprise Manager Cloud Controlに接続する方法を説明します。

34.1.1 前提条件

- Enterprise Manager 12c Cloud Controlリリース5 (Ops CenterのEnterprise Controllerに接続するように構成された仮想サービス・アダプタ付き)。「動的リソース・プロビジョニングの開始」を参照してください。

- 管理対象のストレージおよびネットワーク・アセットを持つEnterprise Manager Ops Centerリリース3。製品のインストールとアセットの検出に関する情報は、Oracle Enterprise Manager Ops Centerの『インストレーション・ガイドfor Oracle Solaris Operating System』および『構成リファレンス』を参照してください。

- Oracle Enterprise Manager Ops Centerクライアント・キット(2つのソフトウェア製品の間の通信を有効化する変更が含まれています)。このキットは、My Oracle Supportのhttps://support.oracle.com/epmos/faces/PatchDetail?patchId=21190506で入手できます。

Ops Centerの最小要件は、同一配置構成です(1つのシステムでEnterprise Controller、Proxy Controllerおよび埋込みOracle Databaseをホストします)。

- Enterprise Controllerの要件:

- T4-1以上のSun Server

- Oracle VM Server for SPARCを実行しているvServerにプロビジョニングされるバージョンと同じかそれ以上のバージョンのOracle Solaris 11。サポートされているバージョンはOracle Solaris 11、11.1および11.2ですが、最適パフォーマンスを得るには、Oracle Solaris 11.2の最新のSRUを使用してください。

- Proxy Controllerの要件:

- Enterprise Controllerと同一配置にするか、Enterprise Controller用のサーバー、ネットワークおよびオペレーティング・システムと同じ最小要件を備えたシステムで実行されていること。

- Oracle VM Server for SPARC制御ドメインの要件:

- Oracle VM Server for SPARC 3.1以上

- Oracle Solaris 11、11.1および11.2。バージョンは、vServerで実行されるバージョンと同じかそれ以上である必要があります。異なるバージョンのOracle Solaris 11を提供するには、オペレーティング・システムごとに制御ドメインを作成します。

- ストレージ・エレメントと管理ドメインの間で最適パフォーマンスを得るには、管理ドメインをホスティングしている各サーバーに、4Gb以上のファイバ・チャネルHBAと、10Gbのイーサネット・カードを搭載してください。1GBのイーサネット・カードが最小要件です。

- ネットワーク・アセットと仮想アセットの適切なサイズは一様ではありません。このドキュメントでお薦めしている内容は、ユーザーの目的とサイト要件にも左右されます。サイジングの検討については、https://blogs.oracle.com/jsavit/entry/best_practices_top_ten_tuningのOracleブログにある、仮想アセット用のリソース調整におけるいくつかの適切な慣行を参照してください。

- Oracle VMS Server for SPARC論理ドメインの要件:

- Oracle VM Server for SPARC 3.1以上

- Ops Center OSイメージ・リポジトリで使用可能なバージョンのOracle Solaris。

- ストレージ・リソースの要件:

- 適切なWWNにのみ公開された専用LUN。LUNは、シン・プロビジョニングではなく完全プロビジョニングする必要があります。ファイバ・チャネルLUNまたはiSCSI LUN (あるいはその両方)を使用できます。

- ファイバ・チャネルLUNでは、1つ以上のSAN静的ストレージ・ライブラリを作成します。

- iSCSI LUNでは、ストレージ・サーバーの検出時にSAN動的ストレージ・ライブラリが作成されますが、vDCにはこのライブラリを使用できません。少なくとも1つの静的SANストレージ・ライブラリを作成します。10Gbのイーサネット・ネットワーク接続を使用し、iSCSI接続の数を調整します。8スレッド/接続の場合: iscsiadm modify initiator-node -c 8。

- ストレージ・エレメントと管理ドメインの間で最適パフォーマンスを得るには、管理ドメインをホスティングしている各サーバーに、4Gb以上のファイバ・チャネルHBAと、10Gbのイーサネット・カードを搭載してください。1GBのイーサネット・カードが最小要件です。

- ネットワークの要件:

- 仮想ネットワークをプロビジョニングする専用のVLAN IDを使用して各コントロール・ドメインに別々のインタフェースを提供するための、アイソレーテッドEthernetスイッチで支援されているファブリック、または複数のネットワーク・スイッチを横断している1組のルーティング不可能なVLAN。

- 専用ネットワーク・ドメイン。デフォルト・ネットワーク・ドメインは使用しないでください。

- OSをプロビジョニングしてvServerにアクセスするための1つ以上のパブリック・ネットワーク。パブリック・ネットワークは、vServerをプロビジョニングするためのIPアドレスのブロックを提供します。IPアドレスの数は、サポートできるvServerの数と同一です。現在と将来のすべての要件に対応できるネットワークのサイズを検討します。クラスC(たとえば、10.0.0.1/24)ネットワークを使用すると256のvServerを作成でき、クラス16Cネットワーク(たとえば、10.0.0.2/20)を使用すると4096のvServerを作成できます。

- クラスタウェアおよび内部ホスト接続用のプライベート・ネットワーク。

- ソフトウェア・ライブラリの要件:

- 転送レートの高いストレージ・サーバーにライブラリを配置します。

- OSバージョンをプロビジョニングするには、Oracle Solaris 11ソフトウェア更新ライブラリにそのバージョンのパッケージが含まれる必要があります。このリポジトリは、製品のインストール中に作成されます。さらに、Oracle Solaris 11 SRUライブラリをダウンロードする必要があります。マスターIPSリポジトリ(MSR)ダウンロードが完了していることを確認します。

- Oracle Solaris 11ソフトウェア・ライブラリを、アクティブに使用中のリリースおよびSRUのバージョンに制限します。

- クライアント・キットからOracle Solaris 11ソフトウェア・ライブラリにパッケージを追加します。

34.1.2 PaaSソリューションの構成の概要

PaaSソリューションを設定するには、ソリューションの次の各コンポーネントに対してタスクを実行します。

- Enterprise Manager Cloud Controlの構成

- クライアント・キットの入手

- Enterprise Manager Ops Centerの構成

34.1.2.1 Enterprise Manager Cloud Controlの構成

Enterprise Managerの仮想サービス・アダプタは、Enterprise ManagerとEnterprise Manager Ops Centerの間のインタフェースです。統合を構成するため、Enterprise Manager Ops Centerのメイン・コンポーネントであるEnterprise Controllerがステージング・サーバーとして追加されます(「ステージング・サーバーの追加」を参照)。

Oracle Enterprise Manager Ops Centerの構成が完了したら、次の情報を使用してEnterprise Manager Cloud Controlを構成します。

- Enterprise ControllerのIPアドレス

- クラウド・ユーザー・アカウントのユーザー名とパスワード

34.1.2.2 クライアント・キットの入手

https://support.oracle.com/に移動して、Ops Centerクライアント・キット、p21190506_121050_Generic.zipを入手します。キットは、OC DVDバンドルでも入手できます。

キットには、PaaS操作とスクリプトを有効化するために変更された、論理ドメインをプロビジョニングするパッケージが含まれます。

- ORCLsysman-iaas-cli.pkg

- ORCLsysman-paas-cli.pkg

- post-script-paas-$<post-script-paas.version>.p5p

圧縮ファイル中のファイルを、選択した場所に展開します。これらのパッケージとスクリプトは、Oracle Solaris 11用のOps Centerリポジトリにアップロードされ、OS更新プロファイルで使用されます。

34.1.2.3 Enterprise Manager Ops Centerの構成

次に示すのは、Enterprise Manager Ops Centerを構成するために必要な主要タスクです。

1. vDCのリソースの構成

2. 仮想データセンターの設定と構成

3. サーバー・テンプレートの設定と構成

4. 統合およびPaaSの検証

タスクをすべて完了するのに、2、3時間かかる可能性があります。タスクのいくつかを同時に実行できます。つまり、あるものを開始する前に1つのジョブの完了を待機する必要はありません。

34.2 vDCのリソースの構成

vDCは、ネットワーク、ストレージおよび制御ドメインのプールに依存します。これは、リポジトリ内のプロファイルに従って、現在のOSリポジトリのイメージからそのサーバーをプロビジョニングします。Ops Center Admin、Storage Admin、Virtualization AdminおよびCloud Adminロールまたはroot権限を持つユーザーとしてログインし、リソースを構成します。

- Oracle Solaris 11のソフトウェア・ライブラリへのクライアント・キットの内容の追加

- vDC用のネットワーク・リソースの準備

- ストレージ・リソースの準備

34.2.1 Oracle Solaris 11のソフトウェア・ライブラリへのクライアント・キットの内容の追加

PaaSソリューションを有効化するパッケージは、post-script-paas-$<post-script-paas.version>.p5pです。このファイルは、My Oracle Supportからダウンロードした圧縮ファイル内にあり、圧縮ファイルの内容を展開したEnterprise Controller上のディレクトリに存在します。この手順でOps CenterのOracle Solaris 11リポジトリにファイルをインポートし、Enterprise Manager Cloud Controlステージング・サーバーとOps Centerリソースの間の通信を有効化できるようにします。

「コンテンツの追加」アクションを使用して、Oracle Solaris 11ソフトウェア更新ライブラリに手動でISOイメージ・ファイルを追加します。

1. 新しいリポジトリでイメージを見つけます。

2. ナビゲーション・ペインで「ライブラリ」を展開します。

3. 「ソフトウェア・ライブラリ」をクリックし、Oracle Solaris 11ソフトウェア更新ライブラリをクリックします。

4. 「アクション」ペインで、「コンテンツの追加」をクリックします。

5. 「リポジトリURL」フィールドに、file:///<fullpath>/post-script-paas-$<post-script-paas.version>.p5pという構文を使用して、Enterprise Controllerのファイルの場所を入力します。使用するファイルに基づいて、パスとバージョンを記入します。
使用する環境で資格証明が必要な場合、システムの資格証明のSystemDefinedSupportCredentialを指定します。

図34-1 リポジトリの指定

6. ジョブが完了すると、ファイルはOracle Solaris 11ソフトウェア・ライブラリの「コンテンツ」タブにリストされます。確認するには、Oracle Solaris 11ソフトウェア・ライブラリの「コンテンツ」タブを開き、PaaSを検索します。

34.2.2 vDC用のネットワーク・リソースの準備

ファブリックは、ネットワーク・インタフェース・カードとネットワーク・スイッチから構成される物理インフラストラクチャです。ネットワーク・ドメインは、少なくとも1つのファブリックからのネットワーク・リソースを組み合せた論理インフラストラクチャです。仮想アセットが使用するネットワークは、ネットワーク・ドメインによって管理されるVLAN IDから作成されます。物理ファブリックでは、これらの仮想ネットワークが、ネットワーク・ドメインを通じて、そのタイプに応じた方法でサポートされます。ネットワーク・リソースをvDCに提供するには、適切な構造からネットワーク・ドメインを作成します。

ネットワーク・ドメインを作成するには、ネットワーク管理者のロールを持っている必要があります。

34.2.2.1 ファブリックの識別

使用可能なファブリックを確認するには、「アセット」ペインの「ネットワーク」を展開します。ファブリックを選択します。ファブリックごとに、中央ペインのダッシュボードに管理機能フィールドが含まれます。新しいネットワーク・ドメインに物理ネットワーク・リソースを提供する場合、次のオプションがあります。

- 既存のホスト管理のファブリックを使用します。

- 管理対象外のファブリックをホスト管理のファブリックに変換してから使用します。

- 新しいホスト管理のファブリックを作成します。

- 管理対象外のファブリックを使用します。

管理対象外のファブリックをホスト管理のファブリックに変換するには、VLAN ID範囲の割当てアクションを使用します。ファブリックをサポートするアイソレーテッド・スイッチのVLANに一致する範囲を指定します。ファブリックがアイソレーテッド・スイッチでサポートされない場合、構成済のルーティングされていないVLANS(たとえば、1001-1200)を表す任意のVLAN ID範囲を使用できます。

新しいホスト管理ファブリックを作成するには、次の手順を実行します。

1. ナビゲーション・ペインで、「ネットワーク」に移動し、ドロップダウン・リストからファブリックを選択します。

2. 「アクション」ペインで、「イーサネット・ファブリックの定義」をクリックします。

3. ウィザードで、「ファブリック名」フィールドに名前を入力します。説明を入力します。「次へ」をクリックします

4. VLAN IDの範囲を入力します。ファブリックがアイソレーテッド・スイッチでサポートされる場合、スイッチのVLANに一致する範囲を指定します。ファブリックがアイソレーテッド・スイッチでサポートされない場合、1001-1200などの任意のVLAN ID範囲を使用します。

5. ファブリックに関連付けるネットワークを選択し、「次へ」をクリックします。

6. サマリーを確認し、「終了」をクリックします。新しいファブリックはホスト管理型です

管理対象外のファブリックを使用するには、そのパブリック・ネットワークのセットをプライベート・ネットワークとして割り当てるか、ファブリックをホスト管理のファブリックに変換します。

34.2.2.2 ネットワーク・ドメインの作成

Ops Centerによる物理ファブリックの管理後、そのネットワーク・リソースはシステム定義のデフォルト・ネットワーク・ドメイン内に存在しますが、仮想データセンターのためにデフォルト・ネットワーク・ドメインを使用することはできません。かわりに、特にvDCを含むサーバー・プールをサポートするために、ネットワーク・ドメインを作成します。

ネットワーク・ドメインはネットワークのためのコンテナで、物理ファブリックとサーバー・プールの関係を処理します。ファブリックは、リンクやIPサブネットなどのネットワーク・リソースを提供します。ネットワーク・ドメイン内で、検出または指定されたネットワークは、割当てに使用できます。これらは、パブリック・ネットワークと呼ばれます。そのネットワーク・リソースは定義済です。もう1つのネットワークのタイプは、動的です(つまり、ネットワークは、必要時にネットワーク・ドメインで使用可能なIPアドレス領域を使用して作成されます)。これらは、特定の目的で特定のネットワーク・ドメイン内にのみ存在するため、プライベート・ネットワークと呼ばれます。

仮想データセンターを使用する場合、ネットワーク・ドメインは、プライベート・ネットワークを提供する必要があります。既存のパブリック・ネットワークにはIPサブネット・アドレスとVLAN IDがすでにあるため、仮想データセンターの既存のパブリック・ネットワークを使用するには、ネットワーク・ドメインに各ネットワークを追加し、それを静的プライベート・ネットワークにする必要があります。

注意:
仮想データセンターをサポートするためにデフォルト・ネットワーク・ドメインを使用しないでください。デフォルト・ネットワーク・ドメインを指定することは禁止されていませんが、そのネットワークを選択することはできません。

ネットワーク・ドメインはネットワークをサーバー・プールに提供していますが、これはVLAN IDを使用した論理的な関連付けにすぎません。ネットワーク・リソースを使用するには、サーバー・プールのコントロール・ドメインをサポートする各物理サーバーに、ネットワーク・ドメイン内のファブリックに対する物理接続が含まれる必要があります。

1. ナビゲーション・ペインで「ネットワーク」を展開します。

2. 標準ビューにネットワークが表示されます。デフォルト・ネットワーク・ドメインが選択されています。

図34-2 ネットワーク・ナビゲーション

3. 「アクション」ペインで、「ネットワーク・ドメインの作成」をクリックします。

4. ネットワーク・ドメインの識別ペインで、ネットワーク・ドメインの名前と説明を入力します。タグも追加できます。

5. ファブリックを追加するステップで、少なくとも1つのファブリックを選択します。

6. ネットワーク作成制限は、デフォルト値を使用します。この値は、同時に使用中にできる動的プライベート・ネットワークの最大数で、設定したVLAN IDの範囲で、VLAN IDの数によって設定されます。
プライベート・ネットワークでは、ネットワーク・ドメインの使用可能なIPアドレスのプールからIPアドレスを使用します。組織で他の目的のために使用しているIPアドレスを除外するには、それらを予約済IPアドレスの範囲表に指定します。これらのアドレスは、動的プライベート・ネットワークで使用できません。

7. ネットワークの関連付けステップで、既存のネットワークを新しいネットワーク・ドメインに追加します。パブリック・ネットワークとして使用するネットワークを追加します。このネットワークは、vServerをプロビジョニングするために使用されます。

8. 確認して「終了」をクリックします。
ジョブが完了すると、ナビゲーション・ペインに新しいネットワーク・ドメインがリストされます。

34.2.2.3 パブリック・ネットワークの構成

パブリック・ネットワークを選択して、管理対象IP範囲の編集を選択します。ネットワーク管理者が提供する、一定範囲または一連のIPアドレスを指定します。これらのアドレスは、後でvServerをサポートするために使用されます。

34.2.3 ストレージ・リソースの準備

Ops Centerでストレージ・デバイスが検出されると、動的ストレージ・ライブラリが作成されますが、そのライブラリを使用してvDCをサポートすることはできません。そのかわりに、静的ストレージ・ライブラリを作成します。

- 管理ドメインのメタデータを格納するNASストレージ・ライブラリを作成します。このストレージは、vDC専用です。このライブラリは他の目的に使用しないでください。

- 操作上のデータを格納するSANライブラリを、少なくとも1つ作成します。

ストレージ・ライブラリはブロック・ストレージで、論理ユニット番号(LUN)を使用します。LUNは、LUNの形式のファイバ・チャネル・ディスクまたはiSCSIディスクによって支援されます。

SAN LUNは、ファイバ・チャネルまたはiSCSIターゲット・グループに関連付けられます。ファイバ・チャネル・ターゲットは専用の光ネットワークを使用し、iSCSIターゲットはIPネットワークを使用しますが、どちらのプロトコルでも、ターゲット・グループのターゲットは、そのターゲットのイニシエータのストレージ・リソースとして1つ以上のLUNを公開します。

どちらのプロトコルでも、Oracle Enterprise Manager Ops Centerはイニシエータとして機能します。ターゲット・グループとOracle Enterprise Manager Ops Centerで、相互に適格なイニシエータおよびターゲットとして認識できるようにするには、それぞれのファイバ・チャネルWorld Wide Number (WWN)またはiSCSI IQNを相互に登録する必要があります。ストレージ・サーバーの検出時にストレージ・サーバーのWWNまたはIQNが記録されているため、Oracle Enterprise Manager Ops Centerは、ターゲットを認識します。WWNまたはIQNに割り当てられているLUNは、すべてストレージ・ライブラリで使用できます。

34.2.4 NASストレージ・ライブラリの作成

次に、NASストレージ・ライブラリを設定するためのタスクを示します。

1. NAS Shareの識別

2. NASストレージ・ライブラリの作成

34.2.4.1 NAS Shareの識別

NFSシェアは、NASストレージ・デバイス上のファイル・システムです。Oracle Enterprise Manager Ops Centerユーザー・インタフェースから、管理対象ストレージ・サーバー上のシェアを表示できます。

1. 「ナビゲーション」ペインで「アセット」を展開して、クリックします

2. 「すべてのアセット」をクリックしてセクションを展開します。

3. 「記憶域」セクションで、NASストレージ・サーバーをクリックします。

4. 中央のペインで、ストレージ・シェアのタブをクリックします。

図34-3 記憶域共有タブ

5. シェアを表示し、サーバー・プールをサポートするために、容量は1を選択します。次の手順でこのシェアを使用します。

34.2.4.2 NASストレージ・ライブラリの作成

1. ナビゲーション・ペインで「ライブラリ」を展開します。新しいライブラリが、「ファイルシステム記憶域」セクションに作成されます。

2. 「アクション」ペインの新規NASソフトウェア・ライブラリをクリックします。

3. ライブラリの名前と説明を入力します。たとえば、新しいライブラリが使用される方法を特定します。

4. 新しいストレージ・ライブラリにはサーバー・プールを関連付けないでください。サーバー・プールは、後で作成されます。次をクリックします。

5. デフォルトで、ウィザードには、ストレージ・デバイスのエクスポート済シェアを使用するためのオプションが表示されます。この手順はNFS共有を持つため、「その他」を選択します。

6. NFSサーバーのURLまたはIPアドレスを、「URL」フィールドに入力します。

図34-4 記憶域の識別

7. (オプション)このストレージが使用するNFSのバージョンを指定できます。デフォルトで、Oracle Enterprise Manager Ops Centerはオペレーティング・システムのデフォルトNFSバージョンを使用します。異なるバージョンを指定するには、バージョンの変更を可能にします。

1. NFSバージョンのオーバーライドを選択します。

2. NFSバージョンのドロップダウン・リストをクリックします。バージョンを選択します。

図34-5 NFSバージョンのオーバーライド

8. 「次」ボタンをクリックして、ストレージ・ライブラリのサマリーを検討します。

9. ジョブを送信するには、「終了」ボタンをクリックします。

ジョブが完了すると、「ナビゲーション」ペインのライブラリ・セクションに新しいストレージ・ライブラリが表示されます。

34.2.5 ファイバ・チャネルLUNを使用したSANストレージ・ライブラリの作成

この項では、ファイバ・チャネルLUNによって支援される静的ブロック・ストレージ・ライブラリを設定する方法について説明します。ストレージ・ライブラリのLUNの数によって、ライブラリがサポートできる仮想ホストの数が決まります

34.2.5.1 必要なもの

ブロック・ストレージ・ライブラリを設定および使用する場合に必要なものは、次のとおりです。

- ファイバ・チャネル・プロトコルを使用した管理対象SANサーバーによって支援されるLUN

- ストレージ管理者のロール

ストレージ・サーバーにLUNを作成するには、そのストレージ・サーバーにログインしてターゲットとしてLUNを作成するためのユーザー・アカウントとパスワードを持っている必要があります。

34.2.5.2 ストレージ・サーバーの構成

LUNを作成してそれらをOracle Enterprise Manager Ops Centerで使用できるようにする場合、ストレージ・サーバーのドキュメントで次の操作の実行方法に関する指示を参照してください。

- イニシエータとターゲットを構成します。イニシエータ(Oracle Enterprise Manager Ops Center)は、ターゲット(LUN)を認識できる必要があり、ターゲットもイニシエータを認識できる必要があります。ストレージ・サーバーの検出時にストレージ・サーバーのWWNが記録されているため、Oracle Enterprise Manager Ops Centerは、ターゲットを認識します。WWNに割り当てられているLUNは、すべてストレージ・ライブラリで使用できます。ストレージ・サーバーで、イニシエータとしてOracle Enterprise Manager Ops CenterのWWNを指定し、そのイニシエータにLUNを割り当てる必要があります。

- ファイバ・チャネル・ポートでマルチパスを有効化します。マルチパスは、Oracle Solaris x86ベース・システムではデフォルトで有効ですが、Oracle Solaris SPARCベース・システムではデフォルトで無効です。stmsboot -eコマンドを使用してマルチパスを有効化します。

- 新しいLUNを作成します。Oracle Enterprise Manager Ops Centerのユーザー・インタフェースに新しいLUNが表示されるまで、数時間かかることがあります。
仮想化ホストでiSCSI LUNが使用できるかどうかを確認するには、次のコマンドを使用します。

# iscsiadm list target -S

仮想化ホストでファイバ・チャネルLUNが使用できるかどうかを確認するには、Oracle Solaris 11で次のコマンドを使用します。

# fcadm lu

34.2.5.3 静的ブロック・ストレージSANライブラリの作成

ストレージ・ライブラリでLUNを指定するには、そのストレージ・ライブラリを使用するサーバー・プールを指定し、そのサーバー・プールで使用できるLUNの中からLUNを選択します。

1. ナビゲーション・ペインで「ライブラリ」を展開します。

図34-6 記憶域ライブラリのナビゲート

2. 「アクション」ペインで、「新規SANストレージ・ライブラリ」をクリックします。

3. ライブラリの名前と説明を入力します。「次」をクリックします。

4. 新しいライブラリを選択されたアイテムと関連付けるおよびLUNs sharing to LDOMsを選択します。RACインスタンスを作成するには、SANライブラリがLDom共有をサポートして、各論理ドメインがサーバー・プールの任意のドメインからその記憶域にアクセスできる必要があります。「次」をクリックします。

図34-7 ライブラリ・アソシエーションの識別

5. LUNの識別ステップで、使用可能なLUNのリストから1つ以上のLUNを選択します。1つのLUNを選択しておき、後でより多くのLUNを追加することができます。次をクリックします。

6. 「サマリー」ペインでストレージ・ライブラリの詳細を確認します。「終了」をクリックしてジョブを発行します。

ジョブが完了すると、ナビゲーション・ペインの「ライブラリ」セクションにある静的ブロック・ストレージ・セクションに新しいストレージ・ライブラリが表示されます。中央ペインに、ライブラリの「サマリー」タブが表示されます。

34.2.6 制御ドメインのデプロイ

- Oracle VM Server for SPARCのプロビジョニング・プロファイルの作成

- Oracle VM Server for SPARCのOS構成プロファイルの作成

- インストール・サーバー・デプロイメント・プランの作成

- インストール・サーバー・デプロイメント・プランの適用

34.2.6.1 Oracle VM Server for SPARCのプロビジョニング・プロファイルの作成

このプロファイルは、Oracle VM Server for SPARCを、Oracle Solaris 11 OSにプロビジョニングします。プロビジョニング・プロファイルを作成する前に、MSRインポート・ジョブが完了していることを確認します。

1. ナビゲーション・ペインで計画管理セクションを選択し、プロファイルとポリシーを展開します。

2. OSプロビジョニング・プロファイルを選択し、「アクション」ペインで「プロファイルの作成」をクリックします。

3. OSプロファイルの作成 - OSプロビジョニング・ウィザードで次の詳細を入力します。

- プロファイルの名前と説明。この場合、プロファイルの名前はcontrol_domain_ospです。

- 「サブタイプ」には「Oracle VM Server for SPARC」、ターゲット・タイプにはVクラスを選択します。

図34-8 Oracle VMサーバー・プロビジョニング・プロファイルの識別

次をクリックします。

4. Oracle SolarisおよびOracle VM Server (LDom)のバージョンを選択します。次のパラメータを選択し、「次」をクリックします:

- Oracle VM Server for SPARCのバージョンで、使用するOracle VM Server for SPARCのバージョンを含むOracle Solaris 11 SRUを選択します。たとえば、Solaris 11.2 SRU 11.5.0 (LDom 3.2.0.1)です。必要なOracle Solaris 11リリースが表示されない場合、MSRインポートが完了していることを確認する、または使用するMSRでサポートされているOracle Solaris 11バージョンを選択します。

- システム・ソフトウェア・グループには、solaris-small-serverを選択します。複雑な環境を持っている場合、大規模サーバーを選択できます。

図34-9 OSPパラメータの指定

5. OS設定パラメータのデフォルト値を維持するか、現在の環境に応じて言語、タイムゾーンおよびNFS4ドメインの値を編集します。

6. ルート・パスワードを入力してそのパスワードを確認します。

7. マニュアルNetブートのオプションとNVRAMRCの保存オプションを選択解除します。
次をクリックします。

8. 管理ドメインにログインするためのユーザー・アカウントを指定します。プロビジョニング後に、OSに対するSSHのユーザー・アカウントを作成します。アカウントのユーザー名とパスワードを指定し、「次」をクリックします。

図34-10 ユーザー・アカウントの指定

9. Oracle VM Server for SPARCのプロビジョニングのためにiSCSIディスクを使用しないでください。iSCSIディスクを使用の選択を解除し、「次」をクリックします。

10. スワップ・サイズを編集し、「次」をクリックします。
スワップ・サイズは、8192MB以上を使用します。root(/)とスワップ・ファイル・システムはデフォルトで定義されますが、サイジングとパフォーマンスの推奨事項に従って、スワップ・サイズを変更する必要があります。一般に、この管理ドメインがサポートする各論理ドメインは、1GBを必要とします。

図34-11 ファイル・システム・レイアウトの指定

11. 適切なネーミング・サービスとしてDNSを選択し、サーバー名などの詳細を記入します。ネーミング・サービスは必須ではありません。次をクリックします。

12. プロファイルに選択したパラメータを確認し、「終了」をクリックしてOSプロビジョニング・プロファイルを作成します。

中央ペインと、計画管理のプロファイルとポリシー・セクションにプロファイルが表示されます。

34.2.6.2 Oracle VM Server for SPARCのOS構成プロファイルの作成

OS構成プロファイルでは、オペレーティング・システムで使用するネットワーク・インタフェースを定義できます。最初に定義するインタフェースは、ブート・インタフェースであり、プライマリ・インタフェースでもあります。複数のネットワーク・インタフェースを追加できます。ターゲットにプランを適用する場合、プライマリ・インタフェースにするネットワーク・インタフェースを選択し、IPアドレスを定義できます。

- CPUスレッドまたはコア全体、メモリー、暗号化ユニット、仮想コンソール・ポート範囲、仮想ディスク・サーバー名などの制御ドメイン構成。

- MPxIOとSR-IOVの有効化、未使用バスのデタッチ、NVRAMRC値の保存などのオプション。

- エージェント・コントローラをインストールするためのOS管理オプション。

- IPMPまたはリンク・アグリゲーションを使用するためのネットワーク・オプション。

制御ドメインに推奨される最小構成については、後続の各項を参照してください。

34.2.6.2.1 CPUリソース割当て

システムCPUの数によって、制御ドメインのCPUスレッドの数が決まります。

- システムCPUが16個未満の場合、制御ドメインのCPUスレッドを2に設定します。

- システムCPUが16個から64個の間の場合、制御ドメインのCPUスレッドを4に設定します。

- システムCPUが64個を超える場合、制御ドメインのCPUスレッドを8に設定します。

CPUリソースは、CPUスレッドまたはコア全体として割り当てることができます。コア全体は、Oracle Enterprise Manager Ops Centerのデフォルト値です。コア全体として割り当てると、コアのすべてのCPUスレッドが制御ドメインに割り当てられます。たとえば、UltraSPARC T2サーバーの2つのコアを割り当てると、制御ドメインにコアの16のCPUスレッドすべてが割り当てられます。また、コア全体の割当てタイプを選択するときに、最大コア制約を設定することもできます。コア制約の最大数によって、ドメインに割り当てる必要のあるコアの数を指定します。

34.2.6.2.2 暗号化ユニット

暗号化ユニットは、高性能な専用暗号エンジンを備えたサポート対象プラットフォームのリソースです。これらは、Secure Sockets Layer (SSL)のWebサーバーとアプリケーション・サーバー間のネットワーク・トラフィックを暗号化および復号化するなどのタスクで使用できます。

各CPUコアには、1つの暗号化ユニットと、4つまたは8つのCPUスレッドがあります。暗号化ユニットは、コアの一部であるため、親のコアの1つ以上のスレッドを含むドメインにのみバインドされます。暗号化ユニットは、CPUスレッドの分割のように分割することはできません。たとえば、第1 CPUコアの暗号化ユニットを制御ドメインに割り当てているとします。新しい論理ドメインに第1 CPUコアのスレッドが割り当てられ、そのコアの暗号化ユニットがすでに割り当てられている場合、制御ドメインでは、その暗号化ユニットを新しい論理ドメインに割り当てることができません。暗号化ユニットの割当ては、特にコアが複数のドメイン間で分割されている場合、成功しない可能性があります。Oracle VM Serverでは、より少ない数の暗号化ユニットを割り当てる場合と、まったく割り当てない場合があります。

暗号化ユニットによってドメイン移行が可能になるため、1つ以上の暗号化ユニットを制御ドメインに割り当てる必要があります。

暗号化ユニットの使用は、論理ドメイン移行を高速化しますが、必須ではありません。暗号化ユニットの割当ては、ハードウェアのすべてで使用できるわけではありません。

34.2.6.2.3 RAM

制御ドメインのRAMの容量は、システムRAMのサイズとシステムの負荷に応じて異なります。

- システムRAMが8GB未満の場合、制御ドメインのRAMを1GBに設定します。

- システムRAMが8GBから16GBの間の場合、制御ドメインのRAMを2GBに設定します。

- システムRAMが64GBを超える場合、制御ドメインのRAMを8GBに設定します。

Oracle Enterprise Manager Ops Centerで、論理ドメインの推奨される開始点となるデフォルト値は4GBで、最小値は1GBです。

34.2.6.2.4 NVRAMRC値

SPARCシステムの自動ブートでは、不揮発性RAM (NVRAM)で定義されたデフォルトのブート・デバイスを使用します。起動時に実行されたユーザー定義のコマンドは、NVRAMのNVRAMRCファイルに格納されます。SPARCマシンでOSプロビジョニング・ジョブを実行すると、Oracle Enterprise Manager Ops Centerによって、構成は工場出荷時のデフォルト構成にリセットされ、NVRAMRCファイルに格納されている情報は削除されます。制御ドメインのOS構成プロファイルによって、サーバーを工場出荷時のデフォルトにリセットする前にNVRAMRCファイルに情報を保存し、リセット後にその情報をリストアするオプションが提供されます。

OS構成プロファイルを作成するには、次の手順に従います。

1. 計画管理セクションを選択し、プロファイルとポリシーを展開します。

2. OS構成を選択し、「アクション」ペインで「プロファイルの作成」をクリックします。

3. プロファイルの作成 - OS構成ウィザードで名前と説明を入力します。この場合、新しいプロファイルの名前はinstall_cdoms_oscで、サブタイプとしてOracle VM Server for SPARCを選択し、「次」をクリックします。

図34-12 OS構成プロファイルの識別

4. インストールするOracle VM Server for SPARCのバージョンを選択します。このバージョンは、OSプロビジョニング・プロファイルで選択したバージョンに一致している必要があります。

5. 推奨される最小構成に従って、制御ドメインに割り当てるリソースを指定します。コントロール・ドメインは、ネットワークとファイバ・チャネルLUNをルーティングします。パフォーマンスの問題を回避するには、必ず環境とコントロール・ドメインに十分なコアとメモリーを使用するようします。
残りのリソースは、論理ドメインで使用できます。

- CPUモデル: コア全体を選択して、コアのCPUリソースを割り当てます。

- CPUコア: 制御ドメインに割り当てるCPUコアの数を入力します。

- 最大CPUコア: コントロール・ドメインに割り当てる必要があるCPUコアの数を入力します。

- 「メモリー」: 管理ドメインに必要なメモリーの量を入力します。

- リクエスト済暗号化ユニットには何も値を入力しないでください。

- 仮想コンソール・ポート範囲: 5000から6000の間の範囲を入力します。

- 仮想ディスク・サーバーには、デフォルト名を保持します。

次のオプションの選択を解除し、「次」をクリックします:

- シングル・ルートI/O仮想化の有効化(SR-IOV)

- 未使用バスのデタッチ

図34-13 制御ドメイン・パラメータの指定

6. 多重化I/Oの有効化オプションを選択し、ストレージのSANやiSCSIなどのブロック・ストレージ・ライブラリを制御ドメインに関連付けられるようにします。「次」をクリックします。

7. ネットワークの指定ページで、Oracle VM Server for SPARCのネットワーク・オプションとして「なし」を選択します。「次」をクリックします。

8. OSプロビジョニングで使用するネットワーク・インタフェースを選択します。ネットワーク・インタフェースとそれに対応するネットワーク・インタフェースをホストする「コントローラ」を選択します。アドレス割当ては、デフォルトで静的IPの使用になっており、変更できません。
「自動」を選択して、制御ドメインに対するネットワーク接続の仮想スイッチを自動的に作成し、「次」をクリックします。仮想スイッチは、デフォルトの形式で作成されます。たとえば、ネットワークが192.0.2.0/24の場合、仮想スイッチは192.0.2.0_24として作成されます。

図34-14 ネットワーク・インタフェースの指定

9. パラメータを確認し、「終了」をクリックしてOS構成プロファイルを作成します。

ジョブが開始され、新しいOS構成プロファイルが計画管理セクションのプロファイルとポリシーの下に表示されます。OS構成プロファイルを選択して、中央のペインにその詳細を表示することができます。

34.2.6.3 インストール・サーバー・デプロイメント・プランの作成

OSプロビジョニングと、作成したOS構成プロファイルを使用する、インストール・サーバー・デプロイメント・プランを作成します。

1. ナビゲーション・ペインで計画管理を展開します。

2. 「デプロイメント・プラン」配下で、「サーバーのインストール」を選択します。

3. 「アクション」ペインで、「テンプレートから計画を作成」をクリックします。

4. プラン名と説明を入力します。「失敗ポリシー」は、できるかぎり多くのプランを完了するオプションを選択します。

5. 以前に作成したプロファイルを関連付けます。

1. OSプロビジョニングのステップで、その行の「関連するプロファイル」/「デプロイ・プラン」フィールドにカーソルを移動して、作成したOSプロビジョニング・プロファイルを選択します。

2. OS構成のステップで、その行の「関連するプロファイル」/「デプロイ・プラン」フィールドにカーソルを移動して、作成したOS構成プロファイルを選択します。

6. 「保存」をクリックします。

34.2.6.4 インストール・サーバー・デプロイメント・プランの適用

インストール・サーバー・デプロイメント・プランを適用してOracle VM Server for SPARCをプロビジョニングします。

デプロイ・プランを適用してOracle VM Server for SPARCをプロビジョニングする場合、インストールを完了するためには、次の情報を持っている必要があります。

- サーバー・ハードウェアで、Oracle Enterprise Manager Ops Centerによって管理されているネットワークに物理的に接続されたネットワーク・インタフェースを取得します。

- タグ付けされたネットワークとタグ付けされていないネットワークの両方が、ネットワーク構成でリストされます。OpenBoot PROM (OBP)を使用する場合、タグ付けされたネットワークからはブートできないため、OSプロビジョニングには、タグ付けされていないネットワークのみを使用できます。

- ブート・インタフェースのIPアドレス。

- MACアドレスを使用してネットワーク・インタフェースを識別する場合、ブート・インタフェースのかわりにMACアドレスを入力できます。

- ブート後にOSを構成するために使用するネットワーク接続の詳細。複数のネットワーク構成では、最初のインタフェースは、OSプロビジョニングの手順で定義されたブート・インタフェースによって常に上書きされます。単一のネットワーク構成では、これはブート・インタフェース・ネットワークと同じです。

- Oracle VM Server for SPARCをサーバー・プールに配置するオプションは選択しないでください。

1. 「デプロイメント・プラン」リストで「サーバーのインストール」プランを選択します。

2. 「アクション」ペインで、デプロイ・プランの適用を選択します。

3. 1つ以上のアセットを選択して、「ターゲット・リストに追加」をクリックします。

4. 「最小の相互作用で適用」を選択します。プロファイル・パラメータを確認および変更する場合は、「任意のプロファイル値のオーバーライドを許可」を選択し、OSプロビジョニングおよびOS構成プロファイルの構成を確認します。「次」をクリックします。

5. 「最小の相互作用で適用」を選択した場合、プランに含まれないステップは確認しないように選択し、「次」をクリックします。

6. ウィザードによって、Oracle VM Server for SPARCをプロビジョニングするための情報が収集されます。次をクリックします。

7. ブート・インタフェース・リソース割当てステップで、次の情報を入力します。

- ネットワーク: ブート・インタフェースのネットワーク。

- コントローラ: OSプロビジョニングのネットワーク・インタフェースを提供するコントローラを選択します。これは、常にOracle VM Server for SPARCのプロビジョニングのデフォルトです。

- インタフェース: リストからnet0インタフェースを選択します。このネットワーク・インタフェースは、選択したネットワークに物理的に接続されています。

- IPアドレス: 各ターゲットのブート・インタフェースのIPアドレスを入力します。

- (オプション)プライマリ・ホスト名: Oracle VM Server for SPARCのホスト名を入力します。

ネットワーク・インタフェースをそのMACアドレスで識別する場合、「MACアドレスでネットワーク・インタフェースを識別」オプションを選択し、コントローラとインタフェースを選択するかわりにMACアドレスを入力します。

「次へ」をクリックしてOSプロビジョニングのサマリーを参照します。

8. OSプロビジョニングのパラメータを確認して「次へ」をクリックします。

9. ウィザードの後続のステップでは、OS構成に関する情報を収集します。
次をクリックします。

10. プロファイルに定義されているネットワーク・リソースを指定します。ネットワークを選択し、ネットワークごとにネットワーク・インタフェースを選択してIPアドレスを入力します。
リストされている最初のネットワーク・インタフェースが、ブート・インタフェースです。複数のネットワーク構成では、最初のネットワーク・インタフェースは、ブート・インタフェース・ネットワークによって常に上書きされます。OSのプロビジョニング後に、プライマリ・ネットワーク・インタフェースを選択できます。

単一のネットワークでは、OSの構成中にブート・インタフェース・ネットワークがプライマリ・ネットワークとして定義されます。

次をクリックします。

11. オプション「サーバー・プールには割り当てない」を選択します。「次」をクリックします。

12. OS構成パラメータのサマリーを確認し、「次へ」をクリックしてジョブをスケジュールします。

13. プロビジョニング・ジョブを今実行するようにスケジューリングします。「適用」をクリックして、選択したターゲットにデプロイ・プランを適用します。
ジョブが完了すると、コントロール・ドメインがインストールされて「すべてのアセット」セクションに表示され、それぞれOracle VM Server for SPARCエージェントによって管理されます。

34.2.7 サーバー・プールの作成

サーバー・プールは、同じ仮想ネットワークと物理ネットワーク、およびストレージ・リソースにアクセスできる制御ドメインのグループです。サーバー・プールにより、ロード・バランシング、高可用性機能、およびプール内のすべてのメンバーによるリソースの共有が可能になります。

この手順は、作成したコントロール・ドメイン(作成したストレージ・ライブラリと作成したネットワーク・ドメインの両方)を含むサーバー・プールを作成します。

始める前に、コントロール・ドメインをサポートするシステムへの物理接続であるネットワーク・インタフェースを知っている必要があります。

1. ナビゲーション・ペインのリソース管理ビューで「サーバー・プール」を選択します。

2. 「アクション」ペインで、「サーバー・プールの作成」をクリックします。

3. サーバー・プールの名前と説明を入力します。

4. 「仮想化技術」リストからOracle VM Server - SPARCを選択します。

5. 次をクリックします。

6. サーバー・プールに追加するOracle VM Serverを選択します。次をクリックします。

図34-15 サーバー・プールのメンバーの選択

7. サーバー・プールに関連付ける新しいネットワーク・ドメインを選択します。ネットワーク・ドメインを選択すると、物理インタフェースの指定表には、ネットワーク・ドメインのファブリックが移入されます。

図34-16 ネットワーク・ドメインの指定

8. 各ファブリックがどのようにOracle VM Serverに接続するか指定し、「次」をクリックします。

注意:
各Oracle VM Serverの「物理インタフェース」列で、Oracle VM Serverをホスティングするシステムがファブリックに接続するために使用するNICの名前を選択します。最初に表示されるNICはデフォルトではありません。使用するNICを指定する必要があります。適切なインタフェースが選択されていることを確認します。パブリック・ネットワークが誤っている場合、仮想サーバーを作成できません。プライベート・ファブリック接続が誤っている場合、アタッチ済プライベート・ネットワークを作成できません。

9. ネットワーク・ドメインで、サーバー・プールのサーバーにパブリック・ネットワークを関連付けるには、ネットワークの追加アイコンをクリックします。「合計接続数」フィールドで、ネットワークへの接続の数を1と入力します。Enterprise Manager Ops Centerの外で管理されている事前定義プライベート・ネットワークがある場合、ここに追加できます。「次」をクリックします。

図34-17 ネットワークの追加

10. 各Oracle VM Serverのネットワーク構成設定を指定します。コントロール・ドメインを正しくデプロイすると、インタフェースの構成の情報が正しく記入され、Oracle VM Serverが選択されたネットワークに接続されます。UIに、ネットワークに対する既存の接続の詳細が表示されます。
次は、ネットワーク・ドメインの各ファブリックのインタフェースです。

- パブリック・ネットワーク(ルーティング可能ネットワーク)をサポートするファブリックの場合、制御ドメインに対する既存のインタフェースを選択します。制御ドメインに接続されたインタフェースがない場合、イーサネット・スイッチに接続されたインタフェースを選択します。

- ホスト管理のファブリックの場合、イーサネット・スイッチに接続されたインタフェースを選択します。結合インタフェースは使用しないでください。次をクリックします。

注意:
各Oracle VM Serverの「NIC」列で、Oracle VM Serverをホスティングするシステムがファブリックに接続するために使用するNICの名前を選択します。ステップ8で選択したのと同じNICを指定します。

図34-18 インタフェースの構成

11. プールで選択したメンバーからアクセス可能なストレージ・ライブラリが表示されます。サーバー・プールに関連付けるNASおよびSANストレージ・ライブラリを選択します。動的ストレージ・ライブラリは選択しないでください。次をクリックします。

図34-19 ライブラリの関連付け

12. 配置ポリシーと自動バランシング・ポリシーを選択し、「次」をクリックします:

- 最小の相対負荷でOracle VM Serverにゲストを配置vDCは、この配置ポリシーをオーバーライドします。

- サーバー・プールの自動バランシングを行わない

- 自動回復のオプションを選択解除します。Enterprise Manager Cloud Controlは、高可用性を管理します。

図34-20 ポリシーの定義

13. サーバー・プールの情報を確認し、「終了」をクリックしてサーバー・プールを作成します。

ジョブが完了すると、サーバー・プールが作成され、「アセット」セクションの「サーバー・プール」ビューに表示されます。ジョブを開いて、ジョブが正常に完了したことを確認します。

34.2.8 ライブラリのリフレッシュ

vDCを作成する前に、静的ブロック・ストレージ・ライブラリをリフレッシュします。vDCを作成する前に数値がリフレッシュされない場合、プロビジョニングは停止します。

1. 「ライブラリ」を展開し、「ナビゲーション」ペインでストレージ・ライブラリを展開します。

2. 静的ブロック・ストレージ配下でストレージ・ライブラリを選択します。

3. 中央のペインの最上部にある「リフレッシュ」ボタンをクリックします。
vDCを作成する前に数分間待ち、リフレッシュが完了したことを確認します。リフレッシュによりジョブが起動されることはなく、ライブラリがリフレッシュされたという通知は何も受け取りません。

34.3 仮想データセンターの設定と構成

- Enterprise Managerユーザーの作成

- vDCの作成

- PaaSのvDCアカウントの作成

- vServerの準備

34.3.1 Enterprise Managerユーザーの作成

Enterprise Manager Cloud ControlにEnterprise Manager Ops Centerを接続するユーザーを追加します。ユーザーは、Enterprise Manager Ops Centerへのフル・アクセス権を持っている必要はありません(Cloudロールのみ)。ローカル・ユーザーを作成することも、ネーミング・サービスを使用することもできます。

ユーザーを追加するには、Enterprise Manager Ops Center User Adminロールを持つ必要があります。

1. 「ナビゲーション」ペインの「管理」を選択します。

2. 「ローカル・ユーザー」をクリックします。

3. ユーザーの追加アイコンをクリックします。

4. ユーザー名としてocadminと入力します。

5. 「選択したロール」リストに、Cloudロールを追加します。他のロールも追加できますが、必須ではありません。「ユーザーの追加」をクリックします。

34.3.2 vDCの作成

vDCは、サーバー・プールからネットワーク・リソースとストレージ・リソースを継承します。vDCによって、クラウド・ユーザーは、仮想マシンを作成してアプリケーションを実行できます。クラウド・ユーザーは、各アカウントに割り当てられたパブリック・ネットワークから、またはプライベート・ネットワークを作成することで、その仮想マシンにネットワークを提供します。クラウド・ユーザーは、パブリック・ネットワークを使用するか、そのアカウントで使用するためにプライベートvNetを作成できます。クラウド・ユーザーがプライベートvNetを作成すると、動的プライベート・ネットワークが作成されるか、そのアカウントで静的プライベート・ネットワークを使用できます。

vDCを作成するには、Enterprise Manager Ops Center Cloud Adminロールを持つ必要があります。

1. ナビゲーション・ペインでvDC管理を選択します。

2. 「アクション」ペインで、「仮想データセンターの作成」をクリックします。

3. 最初のステップ仮想データセンターの作成 Wizardは、vDCへの導入であり、vDC作成の前提条件です。次をクリックします。

4. 仮想データセンターの詳細の指定で、次の操作を実行します。

- vDCの名前と説明を入力します。

- このvDCと他のvDCを区別するためのタグを入力します。

- 「パスワードが必要」を選択して、vDCでvServerを作成する場合に資格証明の使用を強制します。このオプションが有効な場合、クラウド・ユーザーは、SSHキーを使用して、または使用せずに、ルート・パスワードを指定する必要があります。また、クラウド・ユーザーは、Oracle Solaris 11 OSを使用するvServerを作成するときに、SSHキーまたはリモート・ユーザー資格証明を指定する必要があります。

次をクリックします。

5. リストから新しいサーバー・プールを選択します。
サーバー・プールがリストに表示されない場合、サーバー・プールは正しく構成されていません。メタデータ・ライブラリが作成され、専用のネットワーク・ドメインがあることを確認します。vDCは同種です。Oracle VM Server for SPARCを持つ、互換性のあるサーバー・プールを追加できるのみです。CPUとメモリー構成が異なるマシンを混用しないことをお薦めします。

6. パブリック・ネットワークから1つ以上のブート・ネットワークを選択します。1つ以上のネットワークを選択する必要があります。

注意:
ブート・ネットワークは、vServer OSのデプロイメントに必要です。アカウントでvServerを作成するには、vDCで各アカウントに1つ以上のブート・ネットワークを追加する必要もあります。また、アカウントにブート・ネットワークを割り当てて、それをそのアカウントのパブリック・ネットワークとして使用できます。

次をクリックします。

7. vCPUサイズ指定に次の情報が表示されます。

- vCPUの合計数: 更新されたvCPUと物理CPUスレッドの比率におけるvDCでのvCPUの合計数。

- vCPU当たりの平均メモリー: vCPU当たりの平均メモリー(GB)。vCPUの合計数で割ったvDCで使用可能な合計メモリー。CPUおよびメモリー・リソースを最大限に活用する場合、vServerでこの容量のリソースを使用する必要があります。

デフォルトの値を受け入れ、「次へ」をクリックします。

8. ルート・ディスクのストレージ・タイプは静的ブロック・ストレージ・ライブラリを選択します。

9. 作成したSANストレージ・ライブラリを選択します。

10. ボリュームのストレージ・タイプは静的ブロック・ストレージ・ライブラリを選択します。

11. 作成したSANストレージ・ライブラリを選択します。
次をクリックします。

12. vDC構成を確認して「終了」をクリックし、vDCを作成します。vServerは、vServerタイプに従って、このvDCで実行されます。

34.3.3 PaaSのvDCアカウントの作成

アカウントを作成するときに、vDCからアカウントにリソースを割り当てます。vDCのすべてのアカウントに対するリソース割当ては、vDCの実際のリソースを超えることが可能です。このリソースのオーバーサブスクリプションは、計画する必要があります。必要量が増加した場合は、リソースを更新する必要があります。

1. ナビゲーション・ペインでvDC管理を展開します。

2. vDCを展開し、新しいvDCを選択して、「アカウント」をクリックします。

図34-21 vDC管理のナビゲート

3. 「アクション」ペインで、「アカウントの作成」をクリックします。

4. アカウントの名前: PaaS_Accountを入力し、「次へ」をクリックします。

5. アカウントのvCPU、メモリーおよびストレージの割当て制限を指定します。
リソースを制御するのは1つのアカウントのみです。このPaaS_Accountに対して、各リソースの最大容量を指定します。

プライベートvNetの数フィールドに、このアカウントのプライベートvNetの数を入力します。これは割り当てられているVLAN IDの数と同じです。次をクリックします。

図34-22 アカウントのリソース制限の指定

6. 以前に作成した、Cloudロールを持つEnterprise Manager Ops Centerユーザー、ocadminを選択します。右矢印キーを使用して、このユーザーを割当て済クラウド・ユーザーのリストに追加します。rootユーザーは割り当てないでください。「次」をクリックします。
ocadminユーザーは、Enterprise Manager Ops CenterとEnterprise Manager Cloud Controlの間の接続です。Cloud Controlは、このユーザー・アカウントを使用してOps Centerに接続します。

図34-23 ユーザーの割当て

7. サマリーを参照し、「終了」をクリックしてアカウントを作成します。ジョブが完了すると、新しいアカウントが作成されます。

34.3.4 vServerの準備

vServerは、CPU、ストレージおよびメモリー・リソースを使用するスタンドアロン・オペレーティング・システムの外部インタフェースを提供するエンティティです。vServerには、vServerの存続期間全体にわたり存在する独自のID、ローカル・ストレージ、インタフェースおよび構成があります。アカウントの割当て制限とアプリケーション要件に従って、新しいvServerの作成を決定します。

vServerを作成する場合、次のアカウント・リソースが必要です。

- vServerタイプ: vServerタイプは、仮想CPU、メモリー、ストレージ・サイズなどのコンピューティング・リソースを定義するプロファイルです。アカウントで使用できるvServerタイプから最も適したものを選択します。vServerタイプは、vServerの作成プロセス中にクラウド・ユーザーに表示されます。

- サーバー・テンプレート: サーバー・テンプレートは、vServerのOSプロビジョニングとOS構成を指定します。アカウントに存在しているサーバー・テンプレートから選択することも、新しいサーバー・テンプレートを作成することもできます。

- 1つ以上の仮想ネットワーク: vServerネットワークの接続のため、vServerを作成する前に、使用可能なvNetから1つ以上のvNetを選択するか、新しいものを作成する必要があります。vServerは、vServerの作成時に仮想ネットワークにのみ割り当てられます。

34.3.4.1 新しいvServerタイプの作成

vServerタイプを作成する場合、VMホスティングの詳細として、定義されたリソースに基づいてウィザードに次の情報が表示されます。

- 選択したリソースを備えたvServerをホストするために十分な物理リソースを持つvDCの仮想サーバーの数。

- vDCの物理リソースの合計数でホストできるvServerの数の見積り。

- メモリー・サイズの現在の値が選択したストレージ・サイズを超えた場合の警告。

1. vDCを選択し、「アクション」ペインで「vServerタイプの作成」をクリックします。

2. タイプを識別するための名前と説明を入力します。たとえば、次のようになります。

- single instance DBAAS

- RAC instance DBAAS

- RAC big instance DBAAS

3. vServerタイプの識別と分類に役立つタグを追加します。次をクリックします。

4. CPU、メモリーおよびストレージ・リソースの値を指定して、「次」をクリックします。
VMホスティング詳細に、入力した数値に基づく、ホスティングできるvServer数の見積もりが表示されます。Oracle Solaris 11.2の最小RAM量は2GBです。たとえば、表34-1には、Oracle 12c DatabaseをデプロイするDBaaSインスタンスの推奨値が示されています。

表34-1 Oracle 12cデータベースを使用するDBaaSの推奨値

インスタンス

RAM

ルート

vCPU

single instance DBAAS

4GB

45GB

16

RAC instance DBAAS

5GB

45GB

16

RAC big instance DBAAS

12GB

45GB

16

5. 指定した情報を確認し、「終了」をクリックしてvServerタイプを作成します。

34.3.4.2 プライベートvNetの作成

プライベートvNetは、アカウントに排他的に設定されるプライベート仮想ネットワークです。このvNetに関連付けられたvServerは、内部通信用のプライベート仮想IPアドレスを持ちます。このPaaSソリューションでは、RACインスタンスのみがプライベート・ネットワークを使用します。一般に、ネットワークの数は、クラウド上でホスティングする実際のアプリケーション・クラスタ数に等しくなります。プライベート・ネットワークはクラスタ相互接続として使用されますが、それを使用して、パブリック・ネットワークから認識できないネットワークを持つ異なる仮想マシンを相互に接続できます。

1. ナビゲーション・ペインでvDC管理を展開します。

2. vDCを展開し、新しいvDCを選択して、「アカウント」をクリックします。

3. 作成したアカウントを選択します。

4. 「アクション」ペインで、「プライベートvNetの作成」をクリックします。

5. プライベート仮想ネットワークの名前と説明を入力します。たとえば、large_private_vnetまたはsmall_private_vnet。次をクリックします。

6. 要素またはホストの数を設定するには、スライド・バーを使用します。「次」をクリックします。
入力した値は、13、29、61、125、253、509、1021、2045、4093および8189の値まで切り上げられます。1または5の値は使用しないでください。作成後にはネットワークのサイズを変更できないため、現在と将来の要件に対応するのに必要なサイズを指定します。

- 要素の数は、このvNetの一部であることができるvServerの最大数でもあります。クラスCネットワーク(たとえば、10.0.0.1/24)を使用すると256のvServerを作成でき、クラス16Cネットワーク(たとえば、10.0.0.2/20)を使用すると4096のvServerを作成できます。

- vNetsが共有か、専用か。複数のRACインスタンスが1つ以上のネットワークを共有する場合、ネットワーク・サイズを509以上に設定します。各RACインスタンスが専用のネットワークを持っている場合、ネットワーク・サイズを29または13に制限します。

図34-24 プライベートvNet構成

7. サマリーを確認し、「終了」をクリックしてプライベート仮想ネットワークを作成します。
新しいプライベート仮想ネットワークが、ナビゲーション・ペインの「ネットワーク」およびvDCセクションにリストされます。

図34-25 新しいプライベート仮想ネットワークのビュー

8. プライベートvNets表で、プライベートvNetの接続アイコンを使用して、この新しいプライベート仮想ネットワークからvServerに、IPアドレスを接続します。「Connect」をクリックします。

注意:
複数のvNetsを持っている場合、各vNetを一度に1つずつ接続します。次の接続を行う前に、各ジョブの完了を待機します。

34.4 サーバー・テンプレートの設定と構成

ゲスト・ドメインを作成するには、その前にゲスト用のオペレーティング・システムを定義するために必要なプロファイルとプランを作成する必要があります。プロファイルを作成した後、サーバー・テンプレートを作成してプロファイルを適用します。

サーバー・テンプレートは、OS更新、OSプロビジョニング、およびOS構成の各プロファイルの組み合せです。複数のプロファイルとサーバー・テンプレートを作成できます。

- OS更新プロファイルの作成

- ゲスト用OSプロビジョニング・プロファイルの作成

- ゲスト用OS構成プロファイルの作成

- vServerテンプレートの作成

- vServerの作成

34.4.1 OS更新プロファイルの作成

Oracle Solaris 11 OS更新プロファイルは、OSプロビジョニング・プロファイルの一部としてパッケージをインストールします。この例では、統合パッケージをインストールするOS更新プロファイルの作成方法を示します。その後、このプロファイルをOSプロビジョニング・プロファイルに追加します。

1. ナビゲーション・ペインで計画管理を展開し、プロファイルとポリシーの下の更新プロファイルを選択します。

図34-26 「プロファイルの更新」のナビゲート

2. 「アクション」ペインで、「新規プロファイル」をクリックします。

3. プロファイルの名前と説明を入力します。この場合、プロファイルはPaaS base updateです。続いて「タイプ」メニューから「Solaris 11」を選択します。

図34-27 OS更新プロファイルの作成

4. デフォルト・フィルタを使用し、次のパッケージとファイルそれぞれを検索して、「インストール」アイコンをクリックします。複数のバージョンが表示される場合、最新バージョンを選択します。

- SUNWhea

- SUNWsprot

- developer/assembler

- developer/java/jdk-6

- developer/java/jdk-7

- post-script-paas

5. 「OS更新プロファイルの作成」をクリックします。更新プロファイルのリストにプロファイルが表示されます。

34.4.2 ゲスト用OSプロビジョニング・プロファイルの作成

OSプロビジョニング・プロファイルは、ゲスト上にインストールするオペレーティング・システム・イメージとPaaSパッケージを定義します。この例では、Oracle Solaris 11.2 SRU 11.5.0をインストールします。

新しいOSプロビジョニング・プロファイルを作成するには、次の手順を実行します。

1. ナビゲーション・ペインで計画管理セクションを選択します。

2. プロファイルとポリシーを展開してOSプロビジョニング・プロファイルを選択します。

3. 「アクション」ペインで、「プロファイルの作成」をクリックします。
プロファイルの作成 - OSプロビジョニング・ウィザードが表示されます。

4. プロファイルの識別のために次の詳細を指定して、「次」をクリックします。

- プロファイルの名前としてldom_guest_ospを入力します。

- OSを記述したプロファイルの適切な説明を入力します。

- 「サブタイプ」として「論理ドメイン」を、「ターゲット・タイプ」として「仮想マシン」を選択します。

図34-28 論理ドメイン・プロファイルの識別

5. 次のOSPパラメータを選択します。

- Oracle Solaris 11.1 OSおよびSRU (リストから)。

- solaris-small-server (リストからソフトウェア・グループとして)。

- Solaris 11更新プロファイルの場合、作成したOS更新プロファイル、PaaS base updateを選択します。

図34-29 OSPパラメータの指定

「次へ」をクリックしてOS設定を指定します。

6. OS設定パラメータを指定し、続いて「次」をクリックします。

- タイムゾーン、言語、ターミナル・タイプ、コンソール・シリアル・ポートおよびコンソール・ボー・レートを入力します。

- rootパスワードを入力します。ここで入力するパスワードは上書きされます。Cloud Controlは、独自のパスワードをデプロイします。

- この例では、NFS4ドメインが「動的」に設定されています。ネーミング・サービスが現在の環境で構成されている場合、NFS4ドメインの値を入力します。

図34-30 OS設定の定義

7. ユーザー・アカウントの指定ページで、作成するユーザー・アカウントのユーザー名とパスワードを入力し、「次」をクリックします。

注意:
Cloud Controlはこのパスワードを上書きして、独自のパスワードをデプロイします。

8. (オプション)iSCSIディスクをOSプロビジョニングで使用する場合、チェック・ボックスを選択します。次をクリックします。

図34-31 iSCSIディスクをプロビジョニングで使用するかどうか指定

9. ルート(/)およびスワップ・ファイル・システムは、デフォルトで定義されます。スワップ・サイズを変更できます。「追加」アイコンをクリックして別のZFSファイル・システムを追加します。「次へ」をクリックしてネーム・サービスを指定します。

注意:
最小スワップ容量は、6GBにしてください。より大きなデプロイメントを使用する場合、スワップを増やしたり、複数のサーバー・テンプレートを作成したりすることもできます。

図34-32 ファイル・システム・レイアウトの指定

10. DNSネーミング・サービスを選択して、「次」をクリックします。

注意:
DNSネーミング・サービスが機能しており、パブリック・ネットワークの要件に準拠していることを確認します。パブリックIPはすべて、ネーミング・サービスが解決できる必要があります。

11. プロファイルに選択したパラメータを確認し、「終了」をクリックしてOSプロビジョニング・プロファイルを作成します。

OSプロビジョニング・プロファイルが作成されて、OSプロビジョニング・プロファイルの下にリストされます。このプロファイルを使用して、OSプロビジョニング・プランを作成します。

34.4.3 ゲスト用OS構成プロファイルの作成

1. 計画管理セクションを選択し、プロファイルとポリシーを展開します。

2. OS構成を選択し、「アクション」ペインで「プロファイルの作成」をクリックします。

3. プロファイルを識別する次の詳細を入力して、「次」をクリックします。

- プロファイルの名前と説明。

- 「サブタイプ」として「論理ドメイン」を、「ターゲット・タイプ」として「仮想マシン」を選択します。

図34-33 ゲスト用のOS構成プロファイルの識別

4. 「Oracle Enterprise Manager Ops Centerによる自動管理」と「エージェント・コントローラをデプロイする」を選択します。仮想マシンを管理するために、多重化I/Oの有効化オプションを選択し、ストレージのFCやiSCSIなどのブロック・ストレージ・ライブラリをOSに関連付けられるようにできます。コントロール・ドメインが管理を制御するため、MPxIOは必要ありません。
シングル・ルートI/O仮想化の有効化(SR-IOV)オプションを選択解除します(このオプションは、ルート・ドメインにのみ適用されます)。「次」をクリックします。

図34-34 OS管理の定義

5. ネットワークの指定ページで、OSのネットワーク・オプションとして「なし」を選択し、「次」をクリックします。

6. ネットワーク・インタフェース・フィールドに1を入力します。vDCはネットワーク・インタフェースを作成して、この値を上書きします。次をクリックします。

7. パラメータを確認し、「終了」をクリックしてOS構成プロファイルを作成します。

34.4.4 vServerテンプレートの作成

作成した新しいOSプロファイル(更新プロファイルを含むプロビジョニングと、構成)からvServerテンプレートを作成します。異なるプロファイルとデプロイメントに対して、異なるテンプレートを作成できます。

1. vDC管理セクションでアカウントを選択します。

2. 「アクション」ペインで、「サーバー・テンプレートの作成」をクリックします。

3. ウィザードで、概要をスキップして「次へ」をクリックします。

4. サーバー・テンプレートの名前と説明を入力します。次をクリックします。

5. 新しいOSプロビジョニング・プロファイルを選択し、「次へ」をクリックします。

6. リストから新しいOS構成プロファイルを選択し、「次へ」をクリックします。

7. 情報を確認し、「終了」をクリックしてサーバー・テンプレートを作成します。

新しいテンプレートが作成され、vServerを作成するために使用できます。

34.4.5 vServerの作成

1つ以上のvServerを作成するには、サーバー・テンプレートを使用します。

1. vDC管理セクションでアカウントを選択します。

2. 「アクション」ペインで、「サーバーの作成」をクリックします。

3. ウィザードで、概要をスキップして「次へ」をクリックします。

4. サーバーの名前と説明を入力します。
次をクリックします。

5. 新しいOSプロビジョニング・プロファイルを選択し、「次へ」をクリックします。

6. リストから新しいOS構成プロファイルを選択し、「次へ」をクリックします。

7. 情報を確認し、「終了」をクリックしてサーバーを作成します。

34.5 統合およびPaaSの検証

Enterprise Manager Cloud ControlおよびEnterprise Manager Ops Centerから、クラウド・ユーザーとして接続をテストします。このテストでは、同じストレージおよびネットワーク・リソースを備えた2つのvServerを作成します。成功すると、一方のvServerは、他方のvServerを対象に情報を送受信できます。テストするには、管理者ユーザーとしてログアウトし、クラウド・ユーザーとしてログインします。

34.5.1 vServerのボリュームの作成

次の手順を使用して、共有ディスクからボリュームを作成します。通常の運用では、Enterprise Managerはボリュームを作成します。

1. ナビゲーション・ペインでvDC管理を展開します。

2. vDCアカウント・リストからアカウントを選択します。

3. 「アクション」ペインで、「ボリュームの作成」をクリックします。

4. ボリュームの名前を入力し、「次」をクリックします。

5. 「共有」オプションを選択して、ボリュームのサイズを入力します。「次」をクリックします。

6. 「終了」をクリックしてボリュームを作成します。
ジョブが完了したら、ボリュームを削除します。

34.5.2 テストvServerの作成

同じプライベート・ネットワークを持つ2つのvServerを作成します。

1. ナビゲーション・ペインでvDC管理を展開します。

2. vDCアカウント・リストからアカウントを選択します。

3. 「アクション」ペインで、「vServerの作成」をクリックします。
vServerの作成ウィザードが表示されます。

4. 「vServer詳細」ステップで次の情報を入力します。

- vServerの名前と説明。

- vServerの識別と分類に役立つタグ。

- 作成するvServerの数。

- 高可用性サポート・オプションは、PaaS統合には効果がありません。

次をクリックします。

5. リストからサーバー・テンプレートを選択します。次をクリックします。

6. リストからvServerタイプを選択します。次をクリックします。

7. 使用可能なボリューム・リストから1つ以上のボリュームを選択します。矢印キーを使用して、選択したボリュームをアタッチされたボリューム・リストに移動します。
このテストでは、同じボリュームを2つのvServerにアタッチします。

次をクリックします。

8. リストから1つ以上のvNetを選択します。次をクリックします。

9. IPアドレスを割り当てるために静的な方法を選択します。

10. IPアドレスを新しいプライベート仮想ネットワークからvServerに割り当てます。次をクリックします。
vServerの作成後にこの手順を実行するには、プライベートvNet表で、アカウントの「ネットワーク」タブにあるvNetに接続アイコンをクリックします。

配布グループを選択しないでください。次をクリックします。

11. rootパスワードを指定します。次をクリックします。

12. 「サマリー」に示されたvServerの情報を確認し、「終了」をクリックしてvServerを作成するジョブを起動します。
ジョブが完了すると、vServerが作成されてナビゲーション・ペインにリストされます。デフォルトで、選択したvNetまたはサーバー・テンプレートからDNSなどのネーミング情報が取得され、vServerの/etc/resolv.confファイルに追加されます。

34.5.3 共有ストレージと接続性の確認

2つのvServerの接続性を検証する手順。コンソールから1つのvServerにログインして、他のvServerのIPアドレスに対してpingコマンドを使用します。これは、パブリック・ネットワークまたはプライベート・ネットワーク上で成功します。

共有ストレージを検証する手順:

- ファイバ・チャネルSANストレージの場合: fcadm lu

- iSCSI SANストレージの場合: iscsiadm list target -S

クライアント・キットには、問題の診断に役立つnew_vDC.kshスクリプトも含まれます。Enterprise Managerは、統合を開始するとき、ファイル・パス/tmp/INPUT/bootstrap.xmlを使用してファイルを使用しますが、手動でこれを実行することもできます。

注意:
テストを完了した後、パスワードとURLなどのセキュリティ情報を含むbootstrap.xmlファイルとoc-pass.txtファイルを削除します。

1. サイトの情報を使用して、次の形式を持つ、bootstrap.xmlという名前のファイルを作成します。

<bootStrap version="1.0" name="boot_strap"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="bootstrap.xsd">
<!-- Ops-center details required to establish connection before running the ops center commands -->
<opsCenterDetails>
<opsCenterURL>https://<yourhostname>.com</opsCenterURL>
<!-- OpsCenter credentials -->
<opsCenterUser>ocadmin</opsCenterUser>
<opsCenterHome>/opt/oracle/iaas/cli/</opsCenterHome>
<!-- Stage location on Ops Center Host -->
<opsCenterStageLoc>/tmp/</opsCenterStageLoc>
</opsCenterDetails>

</bootStrap>

2. 次のコマンドを発行します。

-bash-4.1$ echo password > /tmp/INPUT/oc-pass.txt
-bash-4.1$ /opt/oracle/paas/tools/new_vDC.ksh

3. 出力を確認します。

Certificate added to truststore /export/home/ocadmin/.oracle_iaas/truststore
Vserver types
4159 EXTRA_LARGE Logical Domain extra-large instance type for vDC PaaS_vDC 17179869184 28          4
4158 LARGE       Logical Domain large instance type for vDC PaaS_vDC       8589934592  24          2
4157 SMALL       Logical Domain small instance type for vDC PaaS_vDC       4294967296  20          1
4161 paas_RAC                                                              12884901888 45          16
4160 paas_SI                                                               4294967296  45          16
Vnets
VNET-321a93e4-2d11-4642-b3ec-3ebde6e86b04 big_private_net  big_private_net OK     172.16.0.0/20  private
VNET-badc34e5-021a-44c7-a7ad-d11915e04ec3 small_rac_net1   small_rac_net1  OK     192.168.0.0/28 private
VNET-47f06e55-7c72-4116-919f-bb940c978b8a 10.163.96.0/22.1                 OK     1x.16x.x6.0/22 public_external
Vserver s
TMPL-116826d2-6a96-4217-ab16-0d4a71157028 paas_default             OK     12884901888 false            false

34.5.4 問題の診断

仮想データセンターでvNetを作成できない場合、ネットワーク・ドメインを編集して、同時に提供できるプライベート・ネットワークの制限数を増加します。

制御ドメインがすでに実行中で、サーバー・プールをサポートするファブリックを変更する場合、次のようにファイバ・チャネル・コントローラを構成する必要があります。

1. fcadm hba-port

2. アクティブ・ポートを特定します。

3. fcadm remote-port -p <each_portID_from_output>

4. # cfgadm -c configure <controller_to_be_configured>

35 動的リソース・プロビジョニングの開始

この章では、動的リソース・プロビジョニングの概要と、仮想サービス・アダプタが仮想データセンターと通信できるように設定する方法について説明します。内容は次のとおりです。

- 動的リソース・プロビジョニングについて

- Solaris SPARCアダプタの構成

35.1 動的リソース・プロビジョニングについて

Oracle Enterprise Manager Ops Centerには、管理者がクラウドに仮想オペレーティング・システム、仮想システムまたは仮想データセンターを作成できる集中化された管理および最適化システムがあります。Enterprise Manager Platform as a Serviceによって、管理者は、ユーザーがデータベースとミドルウェア・アプリケーションをデプロイできるプラットフォームを作成できます。動的リソース・プロビジョニング機能を使用することで、Enterprise Managerでは、Enterprise Manager Ops Centerとのインタフェースを通じて、オンデマンドでPaaSクラウドを対象にリソースを追加または削除できます。

これにより、大規模なインフラストラクチャ・サービスの計画および設定時に必要となる管理者の作業負荷が軽減されます。この機能によって、管理者は次の操作を実行できます。

- 仮想ハードウェアの動的な追加または削除

- ミドルウェア・リソースを、自動化した方法で拡張またはダウンサイジングします。

プライベート・クラウドの容量を拡張するには、クラウド管理者は、Enterprise Manager Ops Centerのインフラストラクチャ管理者からハードウェアとソフトウェアの割当てを受ける必要があります。インフラストラクチャ管理者は、クラウド管理者にホスト、ネットワークおよびストレージの詳細を提供し、次にクラウド管理者はそれらの詳細を使用してクラウドでPaaSインフラストラクチャを設定します。

以前のリリースでは、これらのタスクは手動で実行する必要がありました。このリリースでは、複数の手順が自動化されており、クラウド管理者は、数回のクリックのみで容量を増加または減少できます。Solaris SPARCでDBaaS / MWaaSを設定するには、次の手順が必要です。

- 仮想データセンターを構成する必要があります。これには、ネットワークやストレージ・ボリュームの設定、サーバー・テンプレートの作成、およびサイズの定義が含まれます。第34.3項「仮想データセンターの設定と構成」を参照してください。

- 仮想マシン・アダプタを構成する必要があります。第35.2.2項「仮想マシン・アダプタ・インスタンスの作成」を参照してください。

- 管理者は、プロビジョニングまたはプロビジョニング解除ウィザードを起動して、プールの容量を増加または減少できます。参照先は次のとおりです。

- DBaaS: 第36章「DBaaSクラウドでのリソースのプロビジョニング」を参照してください。

- MWaaS: 第37章「MWaaSクラウドでのリソースの動的なプロビジョニング」を参照してください。

35.2 Solaris SPARCアダプタの構成

Solaris SPARCアダプタは、Enterprise ManagerとEnterprise Manager Ops Centerの間のインタフェースとして機能し、これによってクラウド管理者とセルフ・サービス管理者は、プライベート・クラウド設定でリソースを動的にプロビジョニングまたはプロビジョニング解除できます。追加のサービス・インスタンスのプロビジョニングが必要な場合にリソースを追加することができ、また既存のリソースが使用されていない場合に減らすことができます。リソースには、ホストなどの(仮想マシンに基づく)インフラストラクチャ・リソース、またはデータベースおよびミドルウェアOracleホームなどのプラットフォーム・リソースを指定できます。

仮想サービス・アダプタを構成するには、次の手順に従います。

手順

作業

リンク

1

ステージング・サーバーの追加

第35.2.1項「ステージング・サーバーの追加」を参照してください。

2

仮想マシン・アダプタ・インスタンスの構成

第35.2.2項「仮想マシン・アダプタ・インスタンスの作成」を参照してください。

3

仮想マシン・テンプレートの作成

第35.2.5項「仮想マシン・サービス・テンプレートの作成」を参照してください。

35.2.1 ステージング・サーバーの追加

ステージング・サーバーは、Enterprise Manager Ops Centerと通信して次の1つ以上のタスクを実行する管理対象ホストです。

- 問合せ: 問合せを行って、Enterprise Manager Ops Centerの仮想データセンターからSolaris SPARCシステムの構成情報を取得します。

- 仮想マシンのプロビジョニング: Enterprise Manager Ops Centerにアクセスし、仮想マシンの作成、ネットワークの予約、仮想マシンへのストレージの割当てなどのプロビジョニング操作を実行します。

- 仮想マシンのプロビジョニング解除: Enterprise Manager Ops Centerにアクセスし、仮想マシンのネットワーク、IPアドレスおよびストレージの解放などのプロビジョニング解除操作を実行します。

Enterprise Manager Ops Centerクライアント・キットがインストールされてプラットフォームで使用できる場合、管理対象ホストは、すべてステージング・サーバーとして使用できます。次のプラットフォームがサポートされています。

- Linux_x86

- Solaris_x64

- Solaris SPARC 64

ステージング・サーバーでEnterprise Manager Ops Centerと通信する前に、Ops Centerクライアントをインストールする必要があります。Enterprise Manager Ops Centerと通信するには、Ops Centerクライアントを構成した後に、Ops CenterのEnterprise ControllerのIPアドレスとクラウド・ユーザー・アカウントの資格証明を指定します(第34章「Oracle VM Server for SPARCによる動的リソース・プロビジョニング」参照)。

ステージング・サーバーを追加するには次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

2. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。「仮想アダプタ」サービス・ファミリの隣にある「設定」リンクをクリックして、「ステージング・サーバー」リンクをクリックします。

3. 「ステージング・サーバー」ページで「追加」をクリックします。「ステージング・サーバーの追加」ウィンドウが表示されます。

図35-1 ステージング・サーバーの追加

4. 「ホスト」フィールドで、ステージング・サーバーとして使用する管理対象ホストを選択します。

5. ステージング・ファイルを格納するディレクトリを指定します。このディレクトリは、スクリプトのステージングと実行、および一時データと結果の格納に使用されます。

6. 次のいずれかの資格証明タイプを指定します。

- 名前付き: 資格証明が定義されている名前付きプロファイルを選択します。

- 新規: 新規資格証明を指定するには、このオプションを選択します。ユーザー名とパスワードを入力して「実行」権限を指定し、「OK」をクリックします。

7. 「OK」をクリックして、ステージング・サーバーを追加します。
Solarisアダプタ・インスタンスを作成するときに、Enterprise Manager Ops Centerと通信するために使用できる1つ以上のステージング・サーバーを追加できます。ステージング・サーバーの1つが停止した場合、次に使用可能なサーバーを使用してEnterprise Manager Ops Centerと通信できます。

35.2.2 仮想マシン・アダプタ・インスタンスの作成

仮想マシン・アダプタ・インスタンスは、クライアント・マシンを管理するためにインフラストラクチャ・プロバイダ・システム(Enterprise Manager Ops Center)とのインタフェースとして使用できる管理対象ターゲットです。

仮想マシン・アダプタ・インスタンスを作成するには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

2. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。「仮想アダプタ」サービス・ファミリの隣にある「設定」リンクをクリックして、「インスタンス」リンクをクリックします。

3. 「作成」をクリックします。インフラストラクチャ・アダプタの作成: 一般ページが表示されます。アダプタの名前と説明を入力します。

4. アダプタを関連付けるPaaSインフラストラクチャ・ゾーンを選択します。このアダプタを使用してプロビジョニングされたすべての仮想マシンは、ここで選択したPaaSインフラストラクチャ・ゾーンにホスト・メンバーとして追加されます。PaaSインフラストラクチャ・ゾーンは、1つのアダプタ・インスタンスのみに関連付けることができます。

図35-2 インフラストラクチャ・アダプタの作成: 接続詳細

5. 次をクリックします。インフラストラクチャ・アダプタの作成: 接続詳細ページで、次を指定します。

- Ops Center WebサービスURL: Enterprise Manager Ops Centerサーバーに接続するために使用するURLを入力します。

- Ops Center管理ユーザー: Enterprise Manager Ops Centerサーバーにアクセスする管理者の名前を入力します。このユーザーは、仮想データセンターの設定時に作成されます。

- パスワード:管理者のパスワードを入力します。

- ステージング・サーバー: 「追加」をクリックして、プロビジョニングや問合せなどの様々な操作を行うスクリプトの実行のために使用するステージング・サーバーを選択します。このアダプタ・インスタンスにとって適切なステージング・サーバーを選択する必要があります。たとえば、異なるアカウントを含む2つの異なる仮想データセンターを管理し、それらのアカウントごとに別個のステージング・サーバーを使用する2人の管理者が存在する場合があります。この場合、ここで適切なステージング・サーバーを選択することが重要です。

6. 次をクリックします。「配置制約」ページで、プロビジョニングできる仮想マシンの最大数を指定します。

7. 次をクリックします。「特性」ページで、仮想マシン・アダプタ・ターゲットにターゲット・プロパティとして適用する特性を指定します。新しい仮想マシンが作成されると、これらのプロパティが適用されます。

8. 「発行」をクリックします。仮想化リソース・プロバイダ・システム(Enterprise Manager Ops Center)と通信するために使用できるSolaris SPARCアダプタ・インスタンスが作成されます。Solaris SPARCアダプタ・インスタンスとともに、デフォルトの仮想マシン・サービス・テンプレートも作成されます。このテンプレートは、別のサービス・テンプレートを作成するために変更してコピーできます。これらのテンプレートは、作成される仮想マシンの構造定義を提供します。

35.2.3 仮想マシン・アダプタ・インスタンスの編集

仮想マシン・アダプタ・インスタンスを編集するには、次の手順に従います。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

2. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。「仮想アダプタ」サービス・ファミリの隣にある「設定」リンクをクリックして、「インスタンス」リンクをクリックします。

3. リストから仮想マシン・アダプタ・インスタンスを選択し、「編集」をクリックします。

図35-3 仮想アダプタ・インスタンスの編集

4. 次の詳細を編集できます。

- アダプタの名前と説明。

- PaaSインフラストラクチャ・ゾーン: アダプタ・インスタンスを関連付ける新しいPaaSインフラストラクチャ・ゾーンを選択できます。

- 構成のフェッチ: アダプタで使用できるサブネットやストレージなどの最新の構成情報を取得する場合、このチェック・ボックスを選択します。構成が変更された場合、既存のサービス・テンプレートが無効になる可能性があり、状況によってはスケジュールされたプロビジョニング操作を手動でパージする必要があります。

5. 次をクリックします。「接続の詳細」ページで、接続の詳細の変更、新しいステージング・サーバーの追加、または既存のステージング・サーバーの削除を行うことができます。「次」をクリックします。

6. 必要に応じて「配置制約」を変更します。「次へ」をクリックし、必要に応じてアダプタ・インスタンスに対して定義した特性を変更します。

7. 「次へ」をクリックし、これまでに入力した情報を確認します。「発行」をクリックし、アダプタ・インスタンスに加えた変更を発行します。

35.2.4 仮想マシン・アダプタ・インスタンスの削除

仮想マシン・アダプタ・インスタンスを削除するには、リストからインスタンスを選択して「削除」をクリックします。確認メッセージが表示されます。確認のため「はい」をクリックし、アダプタ・インスタンスを削除します。

注意:
アダプタ・インスタンスを使用してプロビジョニングされた仮想マシンがある場合、インスタンスを削除することはできません。

35.2.5 仮想マシン・サービス・テンプレートの作成

仮想マシン・テンプレートは、インフラストラクチャ・アダプタ・インスタンス上で仮想マシンをプロビジョニングするために使用できる仮想マシンの構成について説明します。

このテンプレートは、次の場合に使用できます。

- 管理者が仮想インフラストラクチャをプロビジョニングする場合。

- 自動プロビジョニングがサービス・リクエストに含まれない場合。(この機能は、Middleware as a Serviceでのみ使用できます。)

仮想マシン・テンプレートを作成するには、次の手順に従います:

1. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。

2. 「Oracle Cloud」メニューで、「設定」を選択し、「はじめに」を選択します。「仮想アダプタ」サービス・ファミリの隣にある「設定」リンクをクリックして、「サービス・テンプレート」リンクをクリックします。

3. 「作成」をクリックします。「一般」ページが表示されます。テンプレートの名前と説明を入力し、「次へ」をクリックします。

4. 「特性」ページで、Solaris SPARCアダプタを使用してプロビジョニングされる仮想マシンに適用する特性を指定します。

5. 次をクリックします。Solarisアダプタ・ページで、「追加」をクリックし、サービス・テンプレートを関連付けるSolaris SPARCアダプタを選択します。

6. 次をクリックします。「仮想マシン構成」ページが表示されます。実際の使用例(単一インスタンス、RACまたはミドルウェア)に応じて、指定する構成の詳細は異なります。

図35-4 仮想マシン構成(単一インスタンス)

仮想マシンの構成の詳細を入力します。

- ホスト名の接頭辞: ホスト名の接頭辞を入力します。これは、特定のリクエスト・タイプのホストをグループ化するために使用する論理名です。

- インスタンスの大きさ: 使用可能な仮想マシンのハードウェア構成(メモリー、CPUおよびストレージ)のリストが示されます。構成は、Solarisアダプタの登録時にEnterprise Manager Ops Centerから取得されます。オペレーティング・システムの実行に必要なCPU、ストレージ、メモリーの量、デプロイされるソフトウェア、およびメンテナンスのための追加領域に基づいて、現在の要件に最も適した構成を選択します。
選択されたすべての構成は、リクエストの発行時に表示されます。

たとえば、オペレーティング・システムに2GB、デプロイされるデータベース・ホームに2GBが必要な場合、メンテナンス領域(データベース・ホームの3.5倍) + 予想される格納データ(1GB)を考慮すると、10GB以上のサイズを選択する必要があります。

- サーバー・テンプレート: サーバー・テンプレートでは、使用するオペレーティング・システム・イメージを定義します。サーバー・テンプレートを選択すると、管理者がアクセスして使用できる仮想マシン・テンプレート、仮想マシン・サイズ、ネットワーク、ストレージ・ボリュームなどの構成の詳細が、Enterprise Manager Ops Centerから取得されます。ソフトウェア・プール全体で一貫性を維持するには、プール内のすべてのOracleホームが同じタイプで、同じオペレーティング・システム・イメージを使用する必要があります。

例35-1 サンプルXML: サーバー・テンプレート

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<result xmlns="http://www.oracle.com/xml/ns/iaas"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="DescribeServerTemplatesResult" requestId="8886">
<items>
<id>TMPL-1005a3b8-cc8b-4f3e-83c2-ee65b849c871</id>
<name>paas-templ</name>
<status>OK</status>
<size>12884901888</size>
<public>false</public>
<readOnly>false</readOnly>
</items>
<items>
<id>TMPL-55e78615-e896-4521-a9bd-d037dc5c981b</id>
<name>paas-tmpl-simple-post-script</name>
<status>OK</status>
<size>12884901888</size>
<public>false</public>
<readOnly>false</readOnly>
</items>
</result>

例35-2 サンプルXML: サーバー・テンプレート: RAC

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<result xmlns="http://www.oracle.com/xml/ns/iaas" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="DescribeVserverTypesResult" requestId="8889">
<items>
<id>16019</id>
<name>PaaS_RAC_big</name>
<description>Custom vserver type: PaaS_RAC_big, CPU: 8 Memory: 12GB</description>
<tags>
<name>oracle.cloud.uuid.cloud</name>
<value>VDC-db24f716-feda-4bd2-8127-d88848d04687</value>
</tags>
<tags>
<name>oracle.vm.profile.type</name>
<value>CLOUD_CUSTOM</value>
</tags>
<tags>
<name>oc.internal.ui.hide</name>
<value>TRUE</value>
</tags>
<memorySize>12884901888</memorySize>
<storageSize>20</storageSize>
<vcpu>8</vcpu>
</items>
<items>
<id>16017</id>
<name>PaaS_SI</name>
<description>Custom vserver type: PaaS_SI, CPU: 4 Memory: 6GB</description>
<tags>
<name>oracle.cloud.uuid.cloud</name>
<value>VDC-db24f716-feda-4bd2-8127-d88848d04687</value>
</tags>
<tags>
<name>oracle.vm.profile.type</name>
<value>CLOUD_CUSTOM</value>
</tags>
<tags>
<name>oc.internal.ui.hide</name>
<value>TRUE</value>
</tags>
<memorySize>6442450944</memorySize>
<storageSize>20</storageSize>
<vcpu>4</vcpu>
</items>
</result>

- ネットワーク: 使用可能なネットワークまたはVNET IDのリストが表示されます。作成される仮想マシンのパブリックおよびプライベート・ネットワーク・インタフェースを選択します。複数のプライベートおよびパブリック・ネットワークを使用可能であり、このサービス・テンプレートを使用して作成された仮想マシンに対して使用するネットワークを決定する必要があります。たとえば、使用可能なIPアドレスを十分に持つネットワークを選択します。

- 単一インスタンス・データベース: 単一インスタンス・データベースの仮想マシンを作成するために使用するサービス・テンプレートを定義する場合、「パブリック・ネットワークの詳細」を指定します。

- RACデータベース: クラスタ・データベースの仮想マシンを作成するために使用するサービス・テンプレートを定義する場合、「パブリック・ネットワークの詳細」を指定し、仮想マシンのパブリック・ネットワーク、ホストIP、スキャンIPおよび仮想IPを選択します。プライベート・インターコネクトでは、「プライベート・ネットワークの詳細」を選択し、使用可能なIPアドレスを十分に持つプライベート・ネットワークを指定します。

- ミドルウェア: Middleware as a Serviceの仮想マシンを作成するために使用するサービス・テンプレートを定義する場合、「パブリック・ネットワークの詳細」を指定します。

例35-3 サンプルXML: ネットワーク

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<result xmlns="http://www.oracle.com/xml/ns/iaas"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="DescribeVnetsResult" requestId="8887">
<items>
<id>VNET-90db3003-3518-4988-8920-4f66fd85aefc</id>
<name>bigpriv</name>
<description>bigpriv</description>
<status>OK</status>
<tags>
<name>network.normalized.name</name>
<value>com.sun.hss.domain:name=NORM-192.168.0.0_24,type=Network</value>
</tags>
<ipAddress>192.168.0.0/24</ipAddress>
<vnetType>private</vnetType>
</items>
<items>
<id>VNET-d7ae94f1-ff1c-4eb9-8b69-3d087a9344be</id>
<name>10.163.96.0/22.1</name>
<status>OK</status>
<ipAddress>10.163.96.0/22</ipAddress>
<vnetType>public_external</vnetType>
</items>
</result>

- ストレージ: 作成する仮想マシンの共有ストレージとローカル・ストレージを選択します。デフォルトでは、すべての使用可能なリソースが選択されます。現在の要件に最も適したストレージを選択する必要があります(または、リクエストの発行時にストレージの詳細を指定できます)。
注意: 共有ストレージ(RAW)は、RACデータベースに適用されます。

たとえば、このサービス・テンプレートを作成してRACデータベースをプロビジョニングする場合、十分なストレージを持つインスタンス・サイズを選択する必要があります。

例35-4 サンプルXML: ストレージ

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<result xmlns="http://www.oracle.com/xml/ns/iaas"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="DescribeVolumesResult" requestId="8888">
<items>
<id>VOL-08391b8d-8f9f-4894-adc4-8214346d64a4</id>
<name>soanew-14d95dbf7f6-2-1-20</name>
<description>no_description_provided</description>
<status>OK</status>
<tags>
<name>keepDisk</name>
<value>True</value>
</tags>
<size>30.0</size>
<shared>false</shared>
<vservers>VSRV-d984031b-8385-4473-a0ce-07d71e33756e</vservers>
<paths>/dev/dsk/c1d1</paths>
</items>
<items>
<id>VOL-c0249120-d9be-42df-bb7d-f9f811a1fb8a</id>
<name>racsk2-s-1-10</name>
<description>no_description_provided</description>
<status>OK</status>
<tags>
<name>keepDisk</name>
<value>True</value>
</tags>
<size>10.0</size>
<shared>true</shared>
<vservers>VSRV-291b879b-5dbd-45ae-b5e3-c4f1239f0804</vservers>
<paths>/dev/dsk/c1d1</paths>
</items>
</result>

7. 「ホスト構成」リージョンで、ホストおよびエージェント・ターゲットの所有者を指定します。

8. 「エージェント構成」リージョンで、「EMエージェントのプッシュ」チェック・ボックスを選択して仮想マシンに管理エージェントをデプロイし、次のエージェント構成の詳細を指定します。

- プラットフォーム: 「SPARC (64ビット)上のOracle Solaris」プラットフォームを選択します。

- ポート: 「管理エージェント」プロセスに使用するポートを入力します。値が指定されていない場合は、3872か、または1830から1849の間の任意の空きポートが使用されます。

- ベースの場所: 「管理エージェント」をインストールするディレクトリのフルパスを指定します。レスポンス・ファイルで指定する「ベースの場所」が空で書込み権限があることを確認してください。これは必須フィールドです。

- 権限委任設定: 権限委任設定を指定します。詳細は、Enterprise Manager基本インストレーション・ガイドを参照してください。

- インストール前とインストール後のスクリプト: これらのシェル・スクリプトは、仮想マシンでカスタム操作を実行する必要がある場合に使用できます。これらのスクリプトは、Oracle Management Serviceが実行されているホスト上か、仮想マシン上に存在している必要があります。
注意: スクリプトは、それがOSイメージにバンドルされていた場合のみ、仮想マシン上に存在します。

- 資格証明: 名前付き資格証明または新規資格証明を指定します。

9. 次をクリックします。確認ページが表示されます。

図35-5 「確認」ページ

これまでに入力した詳細を確認し、「発行」をクリックすると、仮想マシン・テンプレートが作成されます。

仮想サービス・アダプタが作成されて構成された後、それをソフトウェア・プールに関連付けて仮想マシンをプロビジョニングできます。

36 DBaaSクラウドでのリソースのプロビジョニング

この章では、DBaaSクラウドを対象にオンデマンドでリソースを追加または削除するプロセスについて説明します。内容は次のとおりです。

- リソースのプロビジョニング

- リソースのプロビジョニング解除

36.1 リソースのプロビジョニング

仮想サービス・アダプタを設定および構成した後、必要に応じてDBaaSクラウドを対象に仮想リソースを動的に追加または削除できます。

前提条件

- ステージ・サーバーを特定する必要があります。第35.2.1項「ステージング・サーバーの追加」を参照してください

- Enterprise Manager Ops Centerクライアント・キットがEnterprise Managerによって管理されているホストにデプロイされている必要があります。

- Solaris SPARCアダプタ・インスタンスが作成され、構成されている必要があります。第35.2.2項「仮想マシン・アダプタ・インスタンスの作成」を参照してください。

DBaaSクラウドに新しい仮想リソースをプロビジョニングするには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューから「リソース・プロバイダ」を選択します。既存のリソース・プロバイダのリストが表示されます。次のいずれかを選択できます。

- データベース・プール: データベース・プールを選択すると、プロビジョニング・プロシージャが完了したときに、仮想マシンが作成され、管理エージェントおよびデータベース・ソフトウェアが(プールがサブスクライブされている場合はイメージを使用して、またはプールの参照ホームを使用して)仮想マシンにデプロイされ、Oracleホームがプールに追加されます。これでプールの容量が増加します。

- PaaSインフラストラクチャ・ゾーン: PaaSインフラストラクチャ・ゾーンを選択すると、プロビジョニング・プロシージャが完了したときに、仮想マシンが作成され、管理エージェントがデプロイされ、ホストがプールに追加されます。

4. リストから前述のリソース・プロバイダのいずれかを選択します。「リソース」メニューから「プロビジョニング」を選択します。

5. 「一般」ページで、「実行名」フィールドにプロビジョニング・プロシージャの名前を入力します。
このプールが関連付けられている仮想マシン・アダプタが表示されます。

6. 「プロビジョニングされるリソース」フィールドに、プロビジョニングする仮想マシンの数を入力します。

7. 次をクリックします。「仮想マシン構成」ページが表示されます。

図36-1 仮想マシン構成(単一インスタンス・データベース)

「サービス・テンプレート」ドロップダウン・フィールドで、リストからSolarisアダプタ・サービス・テンプレートを選択します。サービス・テンプレートに定義されている構成の詳細が表示され、変更できます。

たとえば、RACデータベースで使用するサービス・テンプレートには、プライベート・ネットワークと、スキャンIPおよび仮想IP用のパブリック・ネットワークが必要です。適切なテンプレート、VMサイズ、ネットワークおよびストレージを選択し、スタンドアロンの仮想マシンを作成するか、またはこの例を使用してクラスタ化されたデータに設定されたマルチノード・ネットワークを作成できます。各フィールドの詳細な説明は、第35.2.5項「仮想マシン・サービス・テンプレートの作成」を参照してください

単一インスタンス・データベースでは、仮想サーバー・タイプの選択時にデータベース・サイズを考慮する必要があります。単一インスタンス・データベースで準拠する必要のあるサイズ・ガイドラインは、次のとおりです。

SIDB VMサイズ > OSサイズ + (3.5 * Oracleホーム・サイズ) + 予想データ・サイズ

RACデータベースでは、次のサイズ指定ガイドラインを使用する必要があります。

RAC VMサイズ > OSサイズ + (3.5 * Oracleホーム・サイズ) RACデータベースの場合、データはASMを使用した共有ディスクに格納されます。

図36-2 仮想マシン構成(RACデータベース)

8. 次をクリックします。RACマシンをプロビジョニングする場合、クラスタ名と、スキャンIPの割当て元になるネットワークを指定します。スキャンIPは、このネットワークのIPのプールから動的に割り当てられます。

図36-3 クラスタ構成

9. 次をクリックします。プロビジョニング・プロシージャのスケジュールを指定して、「次へ」をクリックします。

10. 情報を確認し、「発行」をクリックしてプロビジョニング・ジョブを発行します。

36.2 リソースのプロビジョニング解除

DBaaSクラウドのリソースを削除またはプロビジョニング解除するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューから「リソース・プロバイダ」を選択します。既存のリソース・プロバイダのリストが表示されます。

4. リストからデータベース・プールまたはPaaSインフラストラクチャ・ゾーンを選択します。「リソース」メニューから「プロビジョニング解除」を選択します。

図36-4 リソースのプロビジョニング解除

5. プロシージャの名前と説明を入力します。

6. 「プロビジョニング解除するリソース」リージョンで、「追加」をクリックし、プロビジョニング解除する1つ以上のOracleホームを選択します。

- 単一インスタンス・データベース: 削除するOracleホームを選択する必要があります。これらのOracleホームをホストするすべての仮想マシンが削除されます。

- RACデータベース: クラスタに含まれるすべてのOracleホームを選択する必要があります。これにより、クラスタに含まれるすべての仮想マシンが削除されます。

7. 「プロビジョニング解除」をクリックしてジョブを発行します。選択したOracleホームは削除され、仮想マシンはプロビジョニング解除されます。

37 MWaaSクラウドでのリソースの動的なプロビジョニング

この章では、MWaaSクラウドを対象にオンデマンドでリソースを追加または削除するプロセスについて説明します。内容は次のとおりです。

- リソースのプロビジョニング

- リソースのプロビジョニング解除

- 動的リソース・プロビジョニングの有効化

37.1 リソースのプロビジョニング

仮想マシン・アダプタを設定および構成した後、必要に応じてMWaaSクラウドを対象に仮想リソースを動的に追加または削除できます。

前提条件

- ステージ・サーバーを特定する必要があります。第35.2.1項「ステージング・サーバーの追加」を参照してください。

- Enterprise Manager Ops Centerクライアント・キットは、ステージ・サーバーにデプロイする必要があります。

- Solaris SPARCアダプタ・インスタンスが作成され、構成されている必要があります。第35.2.2項「仮想マシン・アダプタ・インスタンスの作成」を参照してください。Solarisイメージ(サーバー・テンプレート)は、選択されたアプリケーションでサポートされているJDKバージョンを含んでいる必要があります。

MWaaSクラウドに新しい仮想リソースをプロビジョニングするには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューから「リソース・プロバイダ」を選択します。既存のリソース・プロバイダのリストが表示されます。

4. リストからミドルウェア・プールを選択します。「リソース」メニューから「プロビジョニング」を選択します。

5. 「一般」ページに、ミドルウェア・プールが関連付けられている仮想アダプタ・インスタンスが表示されます。

6. 「実行名」フィールドにプロビジョニング・プロシージャの名前を入力します。

7. 「プロビジョニングされるリソース」フィールドに、プロビジョニングする仮想マシンの数を入力します。

8. このミドルウェア・プールに対して動的プロビジョニングが有効化されている場合、「動的プロビジョニングをオンにする」フラグが選択されます。有効化されていない場合、フラグを選択してここで有効化できます。第37.3項「動的リソース・プロビジョニングの有効化」を参照してください。

9. 次をクリックします。「仮想マシン構成」ページが表示されます。

図37-1 仮想マシン構成

次の詳細を入力します。

- 仮想マシン・テンプレート: 仮想マシン・テンプレートを選択します。これは、仮想サービス・アダプタの設定時に作成された仮想アダプタ・サービス・テンプレートです。第35.2.5項「仮想マシン・サービス・テンプレートの作成」を参照してください。選択したテンプレートに基づいて、デフォルトの仮想マシン構成が表示されます。構成の詳細を変更できます。

10. 次をクリックします。プロビジョニング・プロシージャのスケジュールを指定して、「次へ」をクリックします。

11. 情報を確認し、「発行」をクリックしてプロビジョニング・ジョブを発行します。

37.2 リソースのプロビジョニング解除

MWaaSクラウドのリソースを削除またはプロビジョニング解除するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「クラウド」メニューから、「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューから「リソース・プロバイダ」を選択します。既存のリソース・プロバイダのリストが表示されます。

4. リストからミドルウェア・プールを選択します。「リソース」メニューから「プロビジョニング解除」を選択します。

図37-2 リソースのプロビジョニング解除: MWaaS

5. プロシージャの名前と説明を入力します。

6. 「プロビジョニング解除するリソース」リージョンで、「追加」をクリックし、プロビジョニング解除する1つ以上のホストを選択します。

7. 「プロビジョニング解除」をクリックしてジョブを発行し、選択したホストを削除します。

37.3 動的リソース・プロビジョニングの有効化

ミドルウェア・プールの動的プロビジョニングを有効化できます。動的プロビジョニングが有効な場合、セルフ・サービス・ユーザーがミドルウェア・サービス(WLaaS、JVMaaS、SBaaS、SOAaaS)をリクエストすると、仮想マシンが自動的にプロビジョニングされます。同様に、セルフ・サービス・ユーザーが仮想マシンを必要としなくなると、自動的にプロビジョニング解除が行われます。

動的プロビジョニングを有効化するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「Enterprise Manager」メニューから、「クラウド」→「クラウド・ホーム」を選択します。クラウド・ホームページが表示されます。

3. 「Oracle Cloud」メニューから「リソース・プロバイダ」を選択します。

4. 「リソース」ドロップダウン・メニューからミドルウェア・プールを選択し、「動的プロビジョニングをオンにする」を選択します。

5. 「一般」ページに、リソース・プロバイダが関連付けられている仮想マシン・アダプタが表示されます。第35.2.2項「仮想マシン・アダプタ・インスタンスの作成」を参照してください。

6. 「プロビジョニングされるリソース」フィールドに、指定した構成でプロビジョニングするリソースの数を入力します。サービス・テンプレートで使用されているミドルウェア・プロファイルで指定されたサーバーの数は、ここで指定した値をオーバーライドします。次をクリックします。「仮想マシン構成」ページが表示されます。

図37-3 動的プロビジョニングの有効化: 仮想マシン構成

7. 「サービス・テンプレート」フィールドで、ドロップダウン・リストから仮想マシン・テンプレートを選択します。テンプレートに定義されている構成の詳細が表示されます。選択したサービス・テンプレート構成を使用するか、必要に応じてそれを変更できます。詳細は、第35.2.5項「仮想マシン・サービス・テンプレートの作成」を参照してください。

8. 次をクリックします。これまでに入力した情報を確認し、「保存」をクリックして構成を保存します。保存された構成は、セルフ・サービス・ユーザーがプロビジョニングしたすべての仮想マシンに適用されます。

37.3.1 動的プロビジョニングの無効化

特定のリソース・プロバイダの動的プロビジョニングを無効化できます。「リソース」ドロップダウンから、動的プロビジョニングが有効化されているミドルウェア・プールを選択し、「動的リソース・プロビジョニングをオフにする」を選択します。確認メッセージが表示されます。「はい」を選択すると、選択したリソース・プロバイダで動的プロビジョニングが無効化されます。

第XIII部

JVM Diagnostics as a Service

ここでは、JVM Diagnostics as a Serviceを有効化して使用するプロセスについて説明します。内容は次のとおりです。

- 第38章「JVM Diagnostics as a Serviceの設定」

- 第39章「JVM診断セルフ・サービス・ポータルの使用」

38 JVM Diagnostics as a Serviceの設定

この章では、JVM Diagnostics as a Serviceを設定して有効化する手順について説明します。内容は次のとおりです。

- JVM Diagnostics as a Serviceについて

- ユーザーおよびロールの作成

- JVMDaaSの設定

- 割当て制限の定義および割当て

- JVM診断エージェントおよびエンジンの監視

38.1 JVM Diagnostics as a Serviceについて

JVM Diagnostics as a Service (JVMDaaS)によって、IT組織では、セルフ・サービスの方法でJVM診断機能を提供し、Webベースのポータル内でJVMを監視できます。監視するJVMとして、Enterprise Managerの監視対象ターゲットまたはリモート・ターゲットを指定できます。

たとえば、開発組織では、開発者やQA担当者にJVM診断機能を提供できます。システム管理者は、JVMDaaSを通じてこのサービスを提供できます。これによって、開発者とQA担当者は、作業中のインスタンスで簡単にJVM診断にアクセスできるため、開発タスクが迅速に完了し、組織のコストを低下できます。セルフ・サービス・アプローチを使用しているため、システム管理者の作業負荷が増加することはありません。

38.2 ユーザーおよびロールの作成

Oracle Enterprise Managerでは、管理している環境や、Oracle Enterprise Managerを使用しているコンテキストに応じて、Oracleユーザーの様々なクラスをサポートしています。ユーザー権限は、Enterprise Managerの基本レベルのセキュリティを提供します。ユーザー権限はデータへのユーザーのアクセスの制御およびユーザーが拡張できるSQL文の種類の制限をするように設計されています。ユーザーを作成したら、データベースへの接続、問合せの実行および更新、スキーマ・オブジェクトの作成などを行うための権限を付与します。ロールはEnterprise Managerリソース権限またはターゲット権限(あるいはその両方)の集まりであり、管理者または他のロールに付与することができます。これらのロールは、地理的位置(カナダのシステムを管理するためのカナダの管理者用ロールなど)、業務系列(人事管理システムや販売システムの管理者用ロールなど)または他のモデルに基づいて作成できます。ロールの作成により、多数の権限を個別に付与するのではなく、チーム・メンバーに適切な権限をすべて含むロールを割り当てます。

JVMDaaSを使用する前に、スーパー管理者は、次のロール用のユーザーを作成する必要があります。

- EM_SSA_ADMINISTRATOR: このロールを持つユーザーはセルフ・サービス・ユーザーの割当て制限と制約を定義し、アクセス権限を付与できます。このロールを持つユーザーはまた、プロビジョニングおよびパッチ・デザイナの権限を持ち、デプロイメント・プロシージャの作成および保存を行い、パッチ計画を作成および表示し、管理エージェント上のプラグインのライフサイクルをサポートします。これらの権限は、インフラストラクチャの初期設定および進行中のメンテナンスに必要です。

- JVMDAAS: このロールを持つユーザーは、クラウドJVM診断セルフ・サービス・ポータルにアクセスできます。EM_SSA_ADMINISTRATORロールを持つユーザーは、このロールを持つユーザーがEnterprise Managerの他の機能にアクセスできる追加の権限を提供できます。このロールを作成する場合、次のことを確認してください。

- このロールにEM_SSA_USER_BASEロールが明示的に付与されていること。

- このロールに次のリソース権限が付与されていること。

- 任意のサービス・ファミリの表示

- サービス・ファミリ表示権限の付与

38.3 JVMDaaSの設定

前提条件

EM_SSA_ADMINISTRATORおよびJVMDAASロールを持つユーザーが作成されている必要があります。「ユーザーおよびロールの作成」を参照してください。

JVMDaaSを設定するには、次の手順に従います。

1. EM_SSA_ADMINISTRATORロールを持つユーザーとして、Enterprise Managerにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「JVM診断ホーム」を選択します。

図38-1 JVMDAAS - ホーム

3. 「割当て制限」タブをクリックし、JDAASロールを持つ1人以上のユーザーに割当て制限を割り当てます。「割当て制限の定義および割当て」を参照してください。

4. 「ホーム」タブをクリックし、JVM診断エージェントを管理および監視します。「JVM診断エージェントおよびエンジンの監視」を参照してください。

38.4 割当て制限の定義および割当て

特定のロールに属するセルフ・サービス・ユーザーに割当て可能なJVMの合計数を指定するために割当て制限を定義できます。EM_SSA_ADMINISTRATORロールを持つユーザーはセルフ・サービス・ユーザーの割当て制限を定義できます。

前提条件

- EM_SSA_ADMINISTRATORロールを持つユーザーが作成されている必要があります。このユーザーは、EM_SSA_ADMINおよびJVM診断管理者権限を持っている必要があります。

- JVMDAASロールを持つ1人以上のユーザーが作成されている必要があります。

割当て制限を設定するには、次の手順に従います。

1. 「割当て制限」タブをクリックします。このページには、ロールおよび各ロールに割り当てられたJVMの最大数のリストが表示されます。

図38-2 JVMDAAS - 割当て制限

2. 「作成」をクリックします。表示された割当て制限の作成ウィンドウで、次の指定をします。

- ロール名: 割当て制限が割り当てられるEM_SSA_USERロールを指定します。

- JVM: 選択したロールに使用可能なJVMの最大数または割当て制限を指定します。

- JVMDエンジン: 次のいずれかを選択できます。

- JVM診断エンジン: JVM診断サービスに対して登録するJVM診断エンジンを選択します。

- カスタム: ロード・バランサが有効になっているJVM診断マネージャのホストおよびポート番号を指定します。

3. 「OK」をクリックして割当て制限を作成し、JVM診断クラウド・セルフ・サービス・ポータル設定ページに戻ります。指定されたJVMの数の割当て制限(JVMプール)が割当て制限ページにリストされます。

割当て制限が割り当てられているロールの名前を選択し、必要に応じて、 「編集」または「削除」オプションをクリックして、割当て制限を編集または削除できます。

注意:
アクティブなJVMを含む割当て制限を変更すると、新しい割当て制限は、新しいJVM接続にのみ適用されます。既存のJVMは、古い割当て制限を引き続き使用します。

38.5 JVM診断エージェントおよびエンジンの監視

「ホーム」タブをクリックし、JVM診断ホームページを表示します。次のリージョンが含まれます。

- 概要: このリージョンには、割当て制限が割り当てられているJVMプールおよびJVMの合計数が表示されます。ここには、アクティブなJVMおよび非アクティブ化されたJVMの数が表示されます。

- JVMの状態: このリージョンには、JVMの様々な状態を示すグラフが表示されます。

- アクティブなJVM: 「アクティブなJVM」リージョンには、指定した期間においてアクティブなJVMの数が表示されます。

- JVMおよびプール: このリージョンには、割当て制限が割り当てられているJVMおよびJVMプールがリストされます。JVMプールごとに、プール内のJVMの数、所有者、JVMプールの作成日が表示されます。JVMごとに、JVMのステータス(アクティブまたは非アクティブ)、所有者、およびJVMの作成日が表示されます。
JVMの「アクティブ化」、「非アクティブ化」、またはJVMプールの「削除」が可能です。対応するホーム・ページにドリルダウンするには、JVMプールまたはJVMをクリックします。

- エンジンおよびエージェント: このリージョンには、JVMエンジンおよびJVMエージェントのリストが表示されます。

39 JVM診断セルフ・サービス・ポータルの使用

39.1 JVM診断クラウド・セルフ・サービス・ポータル

JVM診断クラウド・セルフ・サービス・ポータルでは、セルフ・サービス・ユーザーは割り当てられたJVMを表示および監視できます。このページを表示するには、次の手順に従います。

1. JDAAS_USERロールを持つユーザーとして、Enterprise Managerにログインします。クラウド・セルフ・サービス・ポータル・ページが表示されます。

2. JVM診断クラウド・セルフ・サービス・ポータル・ページが表示されます。次のリージョンが含まれます。

- サマリー: このリージョンには、セルフ・サービス・ユーザーに割り当てられたJVMの合計数が表示されます。使用可能なJVMおよび非アクティブ化されたJVMの数も表示されます。

- はじめに: このリージョンには、概念的なトピックへのリンクが含まれています。

- JVM診断: このリージョンには、セルフ・サービス・ユーザーに割り当てられたJVMプールのリストが表示されます。次のアクションが実行できます。

- エージェントのダウンロード: JVMを監視する前に、「エージェントのダウンロード」をクリックしてJVM診断エージェントWARファイルをダウンロードし、監視対象のアプリケーション・サーバーにデプロイします。

注意:
セルフ・サービス・ユーザーに割り当てられた割当て制限は0より大きい必要があります。

- アクティブ化: WARファイルがデプロイされたら、JVMを選択して「アクティブ化」をクリックし、監視を開始します。

- 非アクティブ化: JVMを選択して「非アクティブ化」をクリックし、JVMの監視を停止します。

- 注意:
JVMを削除する前に、アプリケーション・サーバーからJVM診断エージェントをアンデプロイする必要があります。アンデプロイされていない場合は、JVM診断エージェントは再接続して、JVMの監視を再度開始します。

- 「名前」リンクをクリックすると、Java仮想マシン・ホームページにドリルダウンします。Java仮想マシン・ホームページには、JVMのサマリー・ビューが表示され、リアル・タイムのスレッドの状態が表示されます。「JVM診断」リンクをクリックすると、JVM診断クラウド・セルフ・サービス・ポータル・ページに戻ります。

39.2 JVMのホーム・ページ

JVMホームページに次の詳細が表示されます。

- サマリー: JVMが属するJVMプール、ホスト、JVMバージョン、ベンダー、ヒープ・サイズ、エージェント最適化レベル、およびエージェントのログ・レベルの詳細などのJVMに関する詳細を表示します。

- リアルタイムのスレッドの状態: 色分けされた列で、JVM内の様々なスレッドの状態を表示します。JVMの現在のアクティビティ(CPU使用率、メモリー、データベース・レスポンス、ネットワーク・レスポンスを待機しているスレッドの数、同期ロックを待機しているスレッドの数、アイドル・スレッドの数を含む)が表示されます。JVMをクリックすると、JVM内のスレッドのリストと各スレッドの詳細が表示されます。

- アクティブ・スレッド: 過去24時間におけるJVM内のアクティブ・スレッドの数です。

- 上位リクエスト: 過去24時間における上位リクエストが表示されます。

このページから、次のページにナビゲートできます。

- JVMパフォーマンス診断: JVMのパフォーマンス診断データが表示されます。

- ライブ・スレッド分析: 選択したJVMのリアルタイムJVMデータが表示されます。

- クラウド・セルフ・サービス・ポータル: JVM診断クラウド・セルフ・サービス・ポータルに戻ります。

第XIV部

Testing as a Service (TaaS)の有効化

この項では、Testing as a Service (TaaS)の概要を紹介し、構成手順およびテスト・セルフ・サービス・ポータルについて説明します。

章構成は次のとおりです。

- 第40章「Testing as a Serviceについて」

- 第41章「Testing as a Serviceの設定」

- 第42章「Testing as a Serviceポータルの使用」

40 Testing as a Serviceについて

Testing as a Service (TaaS)は、自動アプリケーション・テスト・サービスを配信するためのクラウド・ベースのプラットフォームです。これはプライベート・クラウド用に設計されたセルフ・サービス・ソリューションであり、次の特徴があります。

- テスト下のアプリケーションやテスト・ツールなど、テスト・ラボのプロビジョニングを自動化することにより、エンドツーエンドでテスト・プロセスを編成します。

- アプリケーションに対して負荷テストまたは機能テスト(あるいはその両方)のスクリプトを実行します。

- アプリケーション監視および診断の豊富なデータを分析のために提供します。

- エンドユーザーによるテスト・クラウドの使用状況を測定およびチャージするための高度なチャージバック機能を備えています。

Enterprise Manager Cloud Controlを介して提供されるTaaSは、品質を損なうことなくテストの時間とコストを大幅に削減することを可能にし、組織はこれを使用して、より機敏にクリティカルなビジネス・アプリケーションをユーザーに配信できます。

TaaSの主な機能は次のとおりです。

- アプリケーションの負荷テストと機能テストを実行するためのセルフ・サービス・ポータル。

- エンド・ユーザーに使用可能なすべてのテスト・アセット(スクリプト、データバンク・ファイル、シナリオ説明およびユーザー構成可能パラメータ)が格納される、完全なアクセス制御とセキュリティ制御を備えたテスト・ライブラリ。

- 複雑な複数層アプリケーション、テスト・ツールおよびテスト・スクリプトをデプロイする機能を含む、完全なテスト・ラボのオンデマンド自動プロビジョニング。Oracle Load Testing、Oracle Functional Testingおよびカスタム・テスト・ドライバ用の事前作成アセンブリ

- クラウド・ハードウェア・リソース・プールを共有することにより、セキュリティ・ポリシーに準拠しながらハードウェア使用率を最大限に高めることができます。

- 中間層およびデータ層に対する統合された豊富なアプリケーション監視および診断により、テスト下のアプリケーションのボトルネックおよび問題を確実に検出できます。

- コスト・センターにチャージする必要のあるテストのリソース測定およびチャージバック。これらの測定機能により、使用されているリソースを計算するための追跡およびチャージが可能になります。

40.1 TaaSロール

TaaSでは、3つのロール(テスト管理者、テスト設計者およびテスト実施者)が使用されます。次の各項で、これらのロールについて詳しく説明します。

- テスト管理者

- テスト設計者

- テスト実施者

40.1.1 テスト管理者

TaaSを使用すると、テスト管理者は、テスト・アクティビティのアプリケーション・インフラストラクチャの管理、セルフサービス・テストのユーザー・アクティビティの定義、およびテスト環境とテスト・アセットの管理を行うことができます。図40-1を参照してください。

図40-1 クラウド管理のテスト・アクティビティ

TaaSから、テスト管理者は、次を実行できます。

- アプリケーションの設定

- テスト・ドライバの設定

- 割当て制限の設定

- ユーザー・ロールに発行

- チャージバック・サービスの設定

40.1.2 テスト設計者

TaaSを使用すると、テスト設計者は、テスト・アクティビティを実行するためにユーザーが使用できるテスト・アセットおよびテスト環境を作成できます。テスト設計者は、テスト・ドライバのネイティブ機能を使用して、テスト・スクリプトおよびテスト・シナリオを作成します。これらのシナリオには、実行時にどのパラメータが構成可能かが含まれています。図40-2を参照してください。

図40-2 クラウド設計者のテスト・アクティビティ

TaaSから、テスト設計者は、次を実行できます。

- テスト・アセットの作成

- テスト環境の作成

40.1.3 テスト実施者

TaaSを使用すると、テスト実施者は、テスト管理者が発行したテスト・アセットおよびテスト環境からテストを作成できます。テスト実施者は、テスト・アセットおよびテスト環境に基づいて試行を実行し、進行中の試行を監視して、完了した試行の結果を分析します。テスト実施者は、パッチを環境に適用し、試行を再実行して結果を比較して、環境の変更がキー・メトリックおよびパフォーマンス全体にどのように影響するかを判断できます。図40-3を参照してください。

図40-3 クラウドのエンド・ユーザーのテスト・アクティビティ

TaaSから、テスト実施者は次を実行できます。

- 使用可能なテスト・アセットおよびテスト環境の確認

- テストの作成

- 試行の作成および実行

- テストの共有

- 進行中の試行の監視

- 前の試行からの試行データの報告と比較

- アクティビティおよび使用状況情報の表示

- デプロイメント情報の表示

41 Testing as a Serviceの設定

この章では、Testing as a Service (TaaS)の設定に関連する手順の概要を示します。

これらの設定タスクの多くは、Infrastructure as a Serviceを使用する場合にも必要です。IaaSの設定が完了している場合は、これらのタスクの多くをすでに完了したことになります。この章の内容は次のとおりです。

- 開始

- テスト管理者の作成

- アセンブリ・コンポーネントの作成

- デプロイメント・プランの作成

41.1 はじめに

下の表に、TaaSの設定タスクの概要を示します。

表41-1 TaaSの開始

手順

作業

ロール

1

TaaSプラグインのインストール

第3.2項「必要なプラグインのデプロイ」を参照してください

スーパー管理者

2

テスト実施者の作成

第41.2項「テスト管理者の作成」を参照してください。

CLOUD_ADMIN

3

必要なアセンブリZipファイルを使用した仮想化(VT)アセンブリの作成

第41.3項「アセンブリ・コンポーネントの作成」を参照してください。

CLOUD_ADMIN

4

Oracle VM Manager (OVM)のインストール

これは、クラウド・インフラストラクチャの設定の一部です。第3章「クラウド管理インフラストラクチャの設定」を参照してください。

CLOUD_ADMIN

5

Enterprise ManagerからのVTプラグインのインストール

第3.2項「必要なプラグインのデプロイ」を参照してください

CLOUD_ADMIN

6

OVMの登録

第5.3項「Oracle VM Managerの登録」を参照してください。

CLOUD_ADMIN

7

Oracle VM Server (OVS)の登録

手順のイメージの再適用

第5.5項「仮想サーバーの検出」を参照してください。

CLOUD_ADMIN

8

記憶域の追加

第5.10項「記憶域リポジトリの作成」を参照してください。

CLOUD_ADMIN

9

マウント位置のリフレッシュ

CLOUD_ADMIN

10

記憶域リポジトリの追加

第5.10.1項「記憶域リポジトリでの管理操作の実行」を参照してください。

CLOUD_ADMIN

11

サーバーの提示

第5.11項「記憶域リポジトリの提示」を参照してください。

CLOUD_ADMIN

12

サーバー・プールの作成

第5.14項「仮想サーバー・プールの作成」を参照してください。

CLOUD_ADMIN

13

ゾーンの作成

第5.15項「ゾーンの作成」を参照してください。

CLOUD_ADMIN

14

記憶域リポジトリへのアセンブリのインポート

第5.12項「記憶域リポジトリへのアセンブリ、テンプレートおよび仮想ディスクのインポート」を参照してください。

CLOUD_ADMIN

15

ネットワークの設定

第5.7項「ネットワークの設定」を参照してください。

CLOUD_ADMIN

16

MACアドレスの生成

第5.7.1項「MACアドレスの生成」を参照してください。

CLOUD_ADMIN

17

デプロイメント・プランの作成

第41.4項「デプロイメント・プランの作成」を参照してください。

CLOUD_ADMIN

41.2 テスト管理者の作成

テスト管理者を作成するには、次の手順に従います。

1. スーパー管理者として、または新規管理者の作成権限のあるユーザーとして、Enterprise Managerにログインします。

2. 「設定」メニューから、「セキュリティ」、「管理者」の順に選択します。

3. EM_SSA_ADMINISTRATORロールを持つTAASADMIN管理者を作成します。

4. EM_TAAS_DESIGNERロールを持つTAASDESIGNER管理者を作成します。

5. EM_SSA_ROLEを持つTAASUSER管理者を作成します。

41.3 アセンブリ・コンポーネントの作成

VTアセンブリを作成するには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「プロビジョニングとパッチ適用」を選択し、「ソフトウェア・ライブラリ」を選択します。

2. ルート・ディレクトリを選択します。「アクション」、「フォルダの作成」の順に選択します。

3. 書込みアクセス権のあるディレクトリを選択します。「アクション」メニューから、「エンティティの作成」、「仮想化」の順に選択します。

4. タイプとして「アセンブリ」を選択し、「OK」をクリックします。

5. 必要な値を指定し、「次へ」をクリックします。

6. アップロード・メカニズムを選択します。「OK」をクリックします。

7. 「追加」ボタンをクリックしてファイル名を入力し、「OK」をクリックします。

8. 「確認」ページが表示されるまで「次へ」を繰り返しクリックし、「保存とアップロード」をクリックします。
OMSまたはエージェントからファイルをアップロードする場合は、ファイルのアップロード先にファイルをアップロードする必要があります。

41.4 デプロイメント・プランの作成

デプロイメント・プランを作成するには、次の手順を実行します。

1. 「エンタープライズ」メニューから、「クラウド」、「インフラストラクチャ・ホーム」の順に選択します。

2. 右パネルで、ゾーンを選択して右クリックします。
注意: サポートされているオプションは、ゾーンから作成するデプロイメント・プランのみです。(デプロイメント・プランをサーバー・プールまたはOracle VM Serverから作成した場合、そのデプロイメント・プランはTaaSに表示されません。)

3. 「アセンブリのデプロイ」を選択します。ソフトウェア・ライブラリ内に作成されたアセンブリ、または記憶域リポジトリに直接インポートされたアセンブリを選択します。「次」をクリックします。

4. アセンブリ・デプロイメント: ネットワークとエージェント・ページで、エージェント・プッシュ構成の有効化を選択します。プッシュとは、OVMの作成後にEnterprise ManagerエージェントがEnterprise Managerからプッシュされることを意味します。

5. 「インストールのベース・ディレクトリ」、「プラットフォーム」、「ユーザー名」および「パスワード」を指定します。

6. 「プランとして保存」をクリックします。計画の名前を指定し、ソフトウェア・ライブラリ・フォルダを選択します。指定する他の情報は、インストールするアセンブリによって異なります。

42 Testing as a Serviceポータルの使用

TaaS環境の設定が完了したら、テスト管理者およびテスト設計者が事前タスクを実行すると、テスト実施者がテストを開始できるようになります。一般的に、タスクは次のとおりです。

- テスト管理者は、クラウドの環境に対するアクセス権と割当て制限、テスト・アセット、およびOracle Load Testingテスト・ドライバの仮想ユーザー・テスト制限を指定します。

- テスト設計者は、ユーザーが消費するテスト・アセット(事前パッケージされたテスト・スクリプトとシナリオ)およびテスト環境(Oracle Assembliesに基づいたテスト下のアプリケーション用のテンプレート)を作成します。

- テスト実施者は、テスト設計者が作成したテストのテスト・アセットとテスト環境のコンシューマです。テスト実施者は、テスト結果の計画、実行および分析も行います。

表42-1 TaaSのタスク

作業

方法

ロール

前提条件が満たされているかどうかの確認

前提条件

テスト管理者、テスト設計者、テスト実施者

アプリケーションの追加

アプリケーション・タイプの設定

テスト管理者

テスト・ドライバの定義

Oracle Load Testingテスト・ドライバの設定

Oracle Functional Testingテスト・ドライバの設定

カスタム・テスト・ドライバ・タイプの設定

テスト管理者

割当て制限の設定

割当て制限の設定

テスト管理者

テスト環境およびテスト・アセットの発行

テスト環境、テスト・アセットおよびテスト・ドライバの発行

テスト管理者

チャージバック・サービスの設定

チャージバック・サービスの設定

テスト管理者

テスト・アセットの作成

テスト・アセットの作成 - 一般情報

テスト・アセットの作成 - Oracle Load Testing

テスト・アセットの作成 - Oracle Functional Testing

テスト・アセットの作成 - カスタム・テスト

テスト設計者

テスト環境の作成

テスト環境の作成

テスト設計者

使用可能なテスト・アセットおよびテスト環境の確認

使用可能なテスト・アセットおよびテスト環境の確認

テスト実施者

テストの作成

テストの作成

テストの作成 - Oracle Load Testingテスト

テストの作成 - Oracle Functional Testing Testsテスト

テストの作成 - カスタム・テスト

テスト実施者

試行の作成および実行

試行の作成および実行

Oracle Load Testing試行の作成および実行

Oracle Functional Testing試行の作成および実行

テスト実施者

進行中の試行の監視

進行中の試行の監視

テスト実施者

試行結果の比較

試行結果の比較

テスト実施者

アクティビティおよび使用状況情報の表示

アクティビティおよび使用状況情報の表示

テスト実施者

デプロイメント情報の表示

デプロイメント情報の表示

テスト実施者

42.1 前提条件

テスト・クラウド・セルフ・サービス・ポータルを使用する場合、次の前提条件を満たしていることを確認します。

作業を行う前に

- クラウド環境を管理するためにEnterprise Manager Cloud Controlが設定されていることを確認します。

- Testing as a ServiceはSSAプラグインの一部であるため、セルフ・サービス・アプリケーション・プラグインがインストールされていることを確認します。

テスト設計者に固有の前提条件

- Testing as a Service (TaaS)テスト設計者オプションにアクセスする権限があります。このユーザーにはEM_TAAS_DESIGNERロールが必要です。

- Enterprise Managerを使用してテストするアプリケーションおよびその構造(データベース・サーバー、アプリケーション・サーバー、サーバーの構成など)の知識が必要です。

- Oracle Application Testing Suiteのスクリプティング・ツールOpenScript、Oracle Load Testingシナリオ、自己包含.scnzipファイルおよび自己包含.zipファイルを含むOracle Functional Testingシナリオを使用してテスト・スクリプトを作成済です。スクリプトの作成および記録の詳細は、次からドキュメント・セットをダウンロードすることで入手できるOracle Application Testing Suiteドキュメントを参照してください。
http://www.oracle.com/technetwork/oem/downloads/index-084446.html

- Enterprise Manager Cloud Control機能に精通している必要があります。

- Oracle Load Testing、Oracle Functional TestingまたはOracleアセンブリに基づくその他のテスト・ドライバおよびテスト環境のスクリプトおよびシナリオに基づくテスト・アセットを作成済です。

- クラウド・ゾーンでのデプロイ権限があります(ない場合は、デプロイ・プランを作成できません)。

- クラウド・インフラストラクチャへのアクセス権を持っています。

テスト管理者に固有の前提条件

- テスト・クラウド・セルフ・サービス・ポータル・テスト管理者オプションにアクセスする権限があります。このユーザーにはEM_SSA_ADMINISTRATORロールが必要です。

- Enterprise Managerを使用してデプロイ、管理およびテストするアプリケーションおよびその構造(データベース・サーバー、アプリケーション・サーバー、サーバーの構成など)の知識が必要です。

- 基本的なDB管理の知識および仮想化技術の十分な理解が必要です。

- Enterprise Manager Cloud Control機能に精通している必要があります。

- テスト設計者がテスト・アセットおよびテスト環境を作成していることを確認します。

- テスト実施者にテスト・クラウド・セルフ・サービス・ポータルのユーザー・オプションにアクセスする権限があることを確認します。

- テスト・アセット、テスト環境およびテスト・ドライバをテスト実施者ロールおよびEM_SSA_USERロールに公開します。

- クラウド・ゾーンでのデプロイ権限があります(ない場合は、デプロイ・プランを作成できません)。

- クラウド・インフラストラクチャへのアクセス権を持っています。

テスト実施者およびSSAユーザーに固有の前提条件

- EM_SSA_USERロールを持っている必要があります。

- テスト設計者がテスト・アセットおよびテスト環境を作成していることを確認します。

- テスト管理者がテスト・アセット、テスト環境およびテスト・ドライバにテスト実施者ロール(EM_SSA_USER)を割り当てていることを確認します。

- TaaSテスター・オプションにアクセスする権限を持っています。

- テスト・クラウド・セルフ・サービス・ポータル・ユーザー・オプションにアクセスする権限があります。

- Enterprise Manager Cloud Control機能に精通している必要があります。

42.2 テスト管理者のタスク

Enterprise Managerでは、TaaSテスト管理者によるテスト・アクティビティのアプリケーション・インフラストラクチャの管理、セルフサービス・テストのユーザー・アクティビティの定義、ならびにテスト環境およびテスト・アセットの管理が可能です。

具体的には次のような役割があります。

- テスト・ドライバを管理します。

- ユーザー・ロールおよびテスト・ドライバへのアクセスを管理します(該当するプラグインおよびアクセスするユーザーを指定します)。

- ユーザーおよびロールに基づいてテスト環境およびテスト・アセットのアクセスを管理します。

- OVMおよびゾーン権限を次のロールおよびユーザーに割り当てます。

- OVM - テスト設計者およびテスト管理者の表示権限

- ゾーン - テスト設計者およびテスト管理者のオペレータ権限

TaaSはユーザー・デプロイメントに存在するゾーンおよびOracle仮想マシンを事前に確認できないため、スーパー管理者、クラウド管理者または各ターゲット所有者が使用するゾーンおよびOracle仮想マシンを決定します。

次のタスクは、テスト管理者が実行します。

- アプリケーション・タイプの設定

- Oracle Load Testingテスト・ドライバの設定

- Oracle Functional Testingテスト・ドライバの設定

- カスタム・テスト・ドライバ・タイプの設定

- 割当て制限の設定

- テスト環境、テスト・アセットおよびテスト・ドライバの発行

- チャージバック・サービスの設定

42.2.1 アプリケーション・タイプの設定

テスト・クラウド・セルフ・サービス・ポータルでは、テスト管理者によるテスト・アクティビティのアプリケーション・インフラストラクチャの管理、セルフサービス・テストのユーザー・アクティビティの定義およびテスト環境とテスト・アセットの管理が可能です。具体的には次のような役割があります。

- テスト・ドライバを管理します。

- ユーザー・ロールおよびテスト・ドライバへのアクセスを管理します(該当するプラグインおよびアクセスするユーザーを指定します)。

- ユーザーおよびロールに基づいてテスト環境およびテスト・アセットのアクセスを管理します。

- OVMおよびゾーン権限を次のロールおよびユーザーに割り当てます。

- OVM - テスト設計者およびテスト管理者の表示権限

- ゾーン - テスト設計者およびテスト管理者のオペレータ権限

TaaSはユーザー・デプロイメントに存在するゾーンおよびOracle仮想マシンを事前に確認できないため、スーパー管理者、クラウド管理者または各ターゲット所有者が使用するゾーンおよびOracle仮想マシンを決定します。

注意: テスト・クラウド・セルフ・サービス・ポータルを使用する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、テストするアプリケーション・タイプを設定します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト管理者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「設定」メニューから、「クラウド」、「テスト中」の順に選択します。テスト管理者ページが表示されます。

3. 左側のパネルの「アプリケーション・タイプ」をクリックして、アプリケーション・タイプを定義します。

4. 「追加」をクリックして、テストに使用できるアプリケーション・タイプの名前および説明を定義します。

5. 名前および説明を定義して、「保存」をクリックします。

42.2.2 テスト・ドライバの設定

テスト・ドライバは、デプロイ・プランに基づいてテスト・システムに対してテストまたはワークロードを生成するためにEnterprise Managerで使用するソフトウェアのパッケージです。

Oracle Load TestingとOracle Functional Testingの2つのタイプのドライバが提供されています。Oracle Load Testingテスト・ドライバは、ロード、スケーラビリティおよびストレス・テストに使用されます。同時に、このソフトウェアを使用して、数百または数千のユーザーをシミュレートできます。Oracle Functional Testingテスト・ドライバは、機能および回帰テストに使用されます。

Oracle Load TestingおよびOracle Functional TestingはOracleが作成するため、Oracleは、テスト・ドライバの詳細を認識しており、これらのドライバへのシームレスな統合を提供します。

テスト製品およびソフトウェアを含むアセンブリのデプロイメント・プランを作成するかぎり、独自のタイプのテスト・ドライバを登録できます。ただし、カスタム・テスト・ドライバを作成する場合、テストの起動方法および監視方法に関してスクリプトを指示する必要があります。

カスタム・テスト・ドライバにより、テスト実施者はサード・パーティ・ベンダーのテスト・ツールをTaaSとともに使用できます。カスタム・テスト・ドライバ・タイプを使用して、特定のテスト要件を満たすテスト・ドライバ・タイプを定義および登録します。

次の各項では、特定のテスト・ドライバを登録する方法について説明します。

- Oracle Load Testingテスト・ドライバの設定

- Oracle Functional Testingテスト・ドライバの設定

- カスタム・テスト・ドライバ・タイプの設定

42.2.3 Oracle Load Testingテスト・ドライバの設定

Oracle Load Testingテスト・ドライバは、ロード、スケーラビリティおよびストレス・テストに使用されます。同時に、このソフトウェアを使用して、数百または数千のユーザーをシミュレートできます。

注意: Oracle Load Testingテスト・ドライバを設定する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

Oracle Load Testingテスト・ドライバを登録するには、次の手順に従います。

1. テスト・クラウド・セルフ・サービス・ポータルの管理者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「設定」メニューから、「クラウド」、「テスト中」の順に選択します。テスト管理者ページが表示されます。

3. 左側のパネルの「テスト・ドライバ」をクリックします。テスト・ドライバ・ページが表示されます。

4. 「登録」メニューから、「Oracle Load Testing」を選択します。

5. 次の情報を指定します。

- 名前: このテスト・ドライバのわかりやすい名前を入力します。

- デプロイ・プラン: テスト・ドライバのベースとなるデプロイ・プランを選択する拡大鏡をクリックします。表示されたダイアログ・ボックスで、テスト・ドライバに使用するデプロイ・プランを選択して、「選択」をクリックします。
テスト設計者およびテスト管理者がデプロイ・プランをゾーン上に作成することを確認します。また、このゾーンに正しい権限があることを確認します。デプロイ・プランの詳細は、Oracle Enterprise Manager Lifecycle Managementの管理者ガイドを参照してください。

- バージョン: 「バージョン」フィールドは自動的に入力されます。この情報は、デプロイ・プランから導出されます。

- エージェントのデプロイ・プラン: エージェントのデプロイ・プランを選択するための拡大鏡をクリックします。
エージェントのデプロイ・プランは、クラウド上の独立したエージェント・マシンを定義する構成ファイルです。TaaSは、エージェント・デプロイ・プランをテスト・ドライバに登録するため、エージェント・マシン・インスタンスがテスト・ドライバ・デプロイ・プランと一緒に使用され、ロード・テストが作成されます。

このため、TaaSは独立したエージェント・マシンをクラウド上に作成でき、テスト・ドライバのロード生成容量を試行の構成および要求に応じてスケール・アップできます。

エージェント・デプロイ・プランが拡張可能であることを確認します。

注意: Application Testing Suiteのデプロイ・プランのバージョンとApplication Testing Suiteのエージェント・デプロイ・プランのバージョンは同じである必要があります。

- 説明: テスト・ドライバの説明を入力します。

6. 「登録」をクリックします。

すでに登録されているテスト・ドライバの詳細を表示するには、表のテスト・ドライバをハイライト表示します。デプロイ・プラン、エージェント・デプロイ・プランおよびアセンブリ構造の情報が提供されます。

42.2.4 Oracle Functional Testingテスト・ドライバの設定

Oracle Functional Testingテスト・ドライバは、機能および回帰テストならびにアプリケーション機能の検証に使用されます。

注意: Oracle Load Testingテスト・ドライバおよびOracle Functional Testingテスト・ドライバを設定する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

Oracle Functional Testingテスト・ドライバを登録するには、次の手順に従います。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト管理者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「設定」メニューから、「クラウド」、「テスト中」の順に選択します。テスト・クラウド・セルフ・サービスの設定ページが表示されます。

3. 左側ペインの「テスト・ドライバ」をクリックします。「テスト・ドライバ」ペインが表示されます。

4. 「登録」メニューから、「Oracle Functional Testing」を選択します。

5. 次の情報を指定します。

- 名前: このテスト・ドライバのわかりやすい名前を入力します。

- デプロイ・プラン: テスト・ドライバのベースとなるデプロイ・プランを選択する拡大鏡をクリックします。表示されたダイアログ・ボックスで、テスト・ドライバに使用するデプロイ・プランを選択して、「選択」をクリックします。
テスト設計者およびテスト管理者がデプロイ・プランをゾーン上に作成することを確認します。また、このゾーンに正しい権限があることを確認します。デプロイ・プランの詳細は、Oracle Enterprise Manager Lifecycle Managementの管理者ガイドを参照してください。

- バージョン: 「バージョン」フィールドは自動的に入力されます。この情報は、デプロイ・プランから導出されます。

- 説明: テスト・ドライバの説明を入力します。

- 結果のストレージ: 結果ファイル・システムまたはリポジトリを使用します。結果ファイル・システムを使用すると、長い期間にわたる機能テストの結果をサイズ制限なしで格納および管理でき、これらにアクセスできます。これらの結果へは、HTTPおよびNFSプロトコルを使用して、外部のWebクライアントおよびサーバーからアクセスできます。
リポジトリを使用する場合、記憶域は10MBに制限されます。ローカルに格納された結果は2日後にパージされます。

6. 「登録」をクリックします。

すでに登録されているテスト・ドライバの詳細を表示するには、表のテスト・ドライバをハイライト表示します。デプロイ・プランおよびアセンブリ構造の情報が提供されます。

42.2.5 カスタム・テスト・ドライバ・タイプの設定

カスタム・テスト・ドライバを使用すると、テスト実施者は、サード・パーティ・ベンダーのテスト・ツールをTaaSとともに使用できます。カスタム・テスト・ドライバ・タイプを使用して、特定のテスト要件を満たすテスト・ドライバ・タイプを定義および登録します。

Oracle Load TestingおよびOracle Functional TestingはOracleが作成するドライバのタイプであるため、Oracleはドライバの詳細を認識しています。ただし、テスト・ドライバを作成する場合、テストの起動方法および監視方法をスクリプトに指示する必要があります。テスト製品およびソフトウェアを含むアセンブリのデプロイメント・プランを作成するかぎり、独自のタイプのテスト・ドライバを登録できます。

注意:
サード・パーティのテスト自動化ツールを使用している場合は、これらのツールをカスタム・テスト・ドライバとして登録する必要があります。
Oracle Load Testingテスト・ドライバおよびOracle Functional Testingテスト・ドライバを設定する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

カスタム・テスト・ドライバを登録するには、次の手順に従います。

1. テスト・クラウド・セルフ・サービス・ポータルの管理者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「設定」メニューから、「クラウド」、「テスト中」の順に選択します。テスト・クラウド・セルフ・サービスの設定ページが表示されます。

3. 左側のパネルの「カスタム・タイプ」をクリックします。カスタム・テスト・ドライバ・タイプ・ページが表示されます

4. 「作成」をクリックします。

5. カスタム・テスト・ドライバ・タイプの追加ダイアログで、次の情報を指定します。

1. わかりやすい名前および説明を入力します。

2. 「作業ディレクトリ」は、操作が発生するテスト・ドライバの仮想マシン(VM)に作成されるフォルダです。

3. 「結果ディレクトリ」は、テストの結果が表示される、テスト・ドライバ仮想マシン(VM)に作成されるフォルダで、TaaSは、フォルダ全体を圧縮してEnterprise Managerに送信します。

4. 「実行前スクリプト」は、テストの実行前ステップを実行するファイルです。「ブラウズ」をクリックしてファイルを選択します。

5. 「実行スクリプト」は、テストを起動するファイルです。「ブラウズ」をクリックしてファイルを選択します。

6. 「進行状況の監視スクリプト」は、TaaSがテスト・ドライバで実行し、テストが実行中か完了しているか(およびその結果)を特定するスクリプトです。「ブラウズ」をクリックしてファイルを選択します。
テストが完了している場合、TaaSはテストの結果を報告します。TaaSは、このスクリプトによって戻される値を参照して、テストの結果(成功、失敗、警告)を判別します。

注意: TaaSで試行の結果を認識できるように、スクリプトにより、標準出力の最後の行として合格、失敗または警告のいずれかの結果が出力されることを確認します。

7. 「実行後スクリプト」は、テストの実行後にクリーン・アップ・ステップを実行するファイルです。「ブラウズ」をクリックしてファイルを選択します。

8. 「実行スクリプトの停止」は、TaaSがテストの実行を停止するためにテスト・ドライバ上で実行するスクリプトです。

9. 「カスタム・パラメータ」は、テストの実行に渡される実行時パラメータを含むプロパティ・ファイルです。試行の発行中にこれらのパラメータを構成できます。

10. 「OK」をクリックします。

これらの入力を指定したら、タイプが定義され、このタイプの新しいドライバを登録できます。

6. ドライバを登録するには、テスト・ドライバ・ページで、「登録」メニューから「カスタム」を選択します。

7. このテスト・ドライバのわかりやすい名前を指定します。

8. テスト・ドライバのベースとなるデプロイ・プランを選択する拡大鏡をクリックします。表示されたダイアログ・ボックスで、カスタム・テスト・ドライバに使用する必要があるデプロイ・プランを選択して、「選択」をクリックします。

9. テスト・ドライバの説明を入力して、「登録」をクリックします。

10. リストのテスト・ドライバを選択し、コンポーネントをクリックして、デプロイ・プランの詳細にドリルダウンします。

42.2.6 割当て制限の設定

Testing as a Serviceポータルを使用すると、テスト管理者は、特定のロールでテスト実施者の使用状況の割当て制限を設定できます。割当て制限を設定するには、次の手順に従います。

注意: 割当て制限を設定する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

1. テスト・クラウド・セルフ・サービス・ポータルの管理者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「設定」メニューから、「クラウド」、「テスト中」の順に選択します。テスト管理者ページが表示されます。

3. 左側のパネルの「割当て制限」をクリックします。割当て制限ページが表示されます。

4. 「作成」をクリックします。

5. 「ロール名」で、ロールを選択するための拡大鏡をクリックします。表示されたダイアログ・ボックスで、割当て制限を設定するロールを選択して、「選択」をクリックします。

6. ゲストVM (仮想マシン)の数、CPUの数、メモリー (GB)、記憶域サイズ(GB)およびVU (仮想ユーザー)の数を入力して選択したロールに割り当て、「作成」をクリックします。

42.2.7 結果ファイル・システムの設定

Testing as a Service (TaaS)ポータルでは、テスト管理者がテスト実施者用に結果ファイル・システムを設定できます。

結果ファイル・システムを使用すると、長い期間にわたる機能テストの結果をサイズ制限なしで格納および管理でき、これらにアクセスできます。これらの結果へは、HTTPおよびNFSプロトコルを使用して、外部のWebクライアントおよびサーバーからアクセスできます。

注意: テスト環境およびテスト・アセットを発行する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

結果ファイル・システムを設定するには、次の手順に従います。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト管理者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「設定」メニューから、「クラウド」、「テスト中」の順に選択します。テスト管理者ページが表示されます。

3. 左側のパネルにある結果ファイル・システムをクリックします。結果ファイル・システム・リージョンが表示されます。

4. 「追加」をクリックします。

5. 結果ファイル・システムの追加ダイアログ・ボックスで、次の情報を指定します。

- Name

- エクスポート・パス - 結果を格納するファイルへのパス(例: nfs-server.mydomain.com:/export/OFTResults)

- HTTPアクセスURL - 指定されたNFSパスに対応するHTTP URL

- 説明

6. 「追加」をクリックします。

42.2.8 テスト環境、テスト・アセットおよびテスト・ドライバの発行

Testing as a Service (TaaS)ポータルでは、テスト・アセット、テスト環境およびテスト・ドライバをテストの作成中に使用できるように、テスト管理者が、選択されたロールにこれらを発行できます。

注意: テスト環境およびテスト・アセットを発行する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

テスト環境、テスト・アセットおよびテスト・ドライバを発行するには、次の手順に従います。

1. テスト・クラウド・セルフ・サービス・ポータルの管理者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「設定」メニューから、「クラウド」、「テスト中」の順に選択します。テスト管理者ページが表示されます。

3. 左側のパネルの「発行」をクリックします。発行ページが表示されます。

4. 「追加」をクリックします。

5. 「テスト・アセット、テスト環境、テスト・ドライバの選択」リージョンの「追加」メニューから、「テスト・アセット」、「テスト環境」または「テスト・ドライバ」を選択します。表示されたダイアログ・ボックスで、適切な項目を選択して、「選択」をクリックします。
「詳細」リージョンには、各テスト・アセット、テスト環境およびテスト・ドライバ固有の情報が表示されます。

6. 「ロールの選択」リージョンの「追加」をクリックします。表示されたダイアログ・ボックスで、発行するロールを選択して、「選択」をクリックします。

7. すべてのテスト・アセット、テスト環境、テスト・ドライバ、およびロールを選択した後、「発行」をクリックします。

42.2.9 チャージバック・サービスの設定

注意: チャージバック・サービスを設定する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

チャージバック・サービスの詳細は、『Oracle Enterprise Managerクラウド管理ガイド』の「チャージバックの管理」を参照してください。

次のプロセスに従って、テストするアプリケーションを設定します。

1. テスト管理者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「設定」メニューから、「クラウド」、「テスト中」の順に選択します。テスト管理者ページが表示されます。

3. 左側のパネルの「チャージバック」をクリックして、チャージバック・サービスを定義します。

4. 「チャージ・プランの構成」をクリックして、拡張チャージ・プランを定義します。構成や使用状況によってプランを定義できます。使用状況によってプランを定義する場合、チャージはユニバーサル・メトリック(CPU、メモリー、記憶域)やターゲットに固有のメトリックに基づくことができます。拡張チャージ・プランを使用して、個々の価格を設定します。

5. 「ターゲットの構成」をクリックして、チャージ・プランを割り当てます。チャージ・プランをターゲットに割り当てる必要があります。ターゲットがゾーンにグループ化されている場合、チャージ・プランはゾーンに割り当てることができ、そのゾーン内のすべてのターゲットに適用されます。複数のゾーンがある場合、各ゾーンに異なるチャージ・プランを割り当てることができます。セルフサービス・アプリケーション(SSA)管理者は、既存のチャージ・プランを様々なゾーンに割り当てることで、チャージバックの価格設定を決定できます。

6. 「コスト・センターの構成」をクリックして、コスト・センターを設定します(オプション)。コスト・センターはユーザーのグループ間でコストを集約するよう設定できますが、必須ではありません。コスト・センターが設定されている場合、コスト・センター別チャージバック・レポートを使用できるのはSSA管理者のみです。

42.3 テスト設計者のタスク - テスト・アセットおよびテスト環境の作成

次のタスクは、テスト設計者が実行します。

- テスト・アセットの作成 - 一般情報

- テスト・アセットの作成 - Oracle Load Testing

- テスト・アセットの作成 - Oracle Functional Testing

- テスト・アセットの作成 - カスタム・テスト

- テスト環境の作成

42.3.1 テスト・アセットの作成 - 一般情報

テスト・アセットとは、テスト環境に対して実行可能なテスト・アーティファクト(シナリオ、スクリプト、テスト)の集まりです。テスト・アセットは、テスト環境に対してワークロードを再現するために実行する必要があるアクションを定義します。テスト・クラウド・セルフ・サービス・ポータルで、テスト設計者は、テスト管理者が定義した使用可能なテスト・ドライバに基づいたテスト・アセットを作成できます。

テスト設計者は、テスト下のアプリケーションおよびそれに関連するキー・パフォーマンス・インジケータ(KPI)を確認する必要があります。テスト設計者は、実行するテスト・シナリオのビジネス・ユースケースも確認する必要があります。具体的には次のような役割があります。

- テスト設計者は、Oracle OpenScriptに精通している必要があります。Oracle Load Testingテスト・ドライバを使用する場合、テスト設計者はOracle Load Testingに精通している必要があります。カスタム・テスト・ドライバを使用する場合、テスト設計者は、対応するテスト・スクリプト・ツールの使用方法に精通している必要があります。

- テスト設計者は、DBAとしての経験が必要です。

- Testing as a Serviceポータルを使用して、テスト・アセットを作成します。

- Testing as a Serviceポータルを使用して、テスト環境を作成します。

- テスト設計者が環境を作成する必要がある場合、テスト設計者はアセンブリの作成方法を把握する必要があります。

注意: テスト・アセットを作成する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

42.3.2 テスト・アセットの作成 - Oracle Load Testing

次のプロセスに従って、Oracle Load Testingテスト・アセットを作成します。

1. テスト設計者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「セルフ・サービス・ポータル」を選択します。インフラストラクチャ・クラウド・セルフ・サービス・ポータル・ページが表示されます。

3. 「マイ・テスト」をクリックします。「マイ・ライブラリ」タブが表示されます。

4. 「テスト・アセット」をクリックして、ライブラリに追加するテスト・アセットを定義します。

5. 「作成」メニューから、「Oracle Load Testing」を選択します。Oracle Load Testingアセット・プロパティ・ページが表示されます。

6. 次の情報を指定します。

- 名前: このテスト・アセットのわかりやすい名前を入力します。

- 説明: このテスト・アセットの意味のある説明を入力します。

- アプリケーション・タイプ: 「アプリケーション」ドロップダウン・リストをクリックして、リストからテストするアプリケーションを選択します。

- タグ: キーワードとして使用するタグを入力して、このテスト・アセットを詳細に識別します。これらのタグによって、テスト・アセットの特定およびアセットの目的の理解が容易になります。

- シナリオ: 「参照」をクリックし、アップロードするアセット・ファイルを選択します。Oracle Load Testingのファイル・タイプはSCNZIPです。テスト・アセットが、多くのエージェント・マシンを使用する大規模な拡張可能テストを実行するために使用されていた場合、シナリオ構成ファイルでは、ハードウエア見積り機能が有効化され、また、終了条件、ランプアップ・レートおよび仮想ユーザー数の値が指定されます。

- 構成可能なパラメータ: パラメータについて、「なし」、「任意」、「すべて」を選択します。選択したパラメータはTaaS内で公開され、パラメータをTaaSテスト実行用に変更できます。

7. すべての情報を指定したら、「発行」をクリックします。テスト・アセットがライブラリに追加されます。テスト・アセット名をクリックすると、テスト・アセット詳細ページにドリルダウンします。

42.3.3 テスト・アセットの作成 - Oracle Functional Testing

次のプロセスに従って、Oracle Functional Testingテスト・アセットを作成します。

1. テスト設計者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「セルフ・サービス・ポータル」を選択します。インフラストラクチャ・クラウド・セルフ・サービス・ポータル・ページが表示されます。

3. 「マイ・テスト」をクリックします。「マイ・ライブラリ」タブが表示されます。

4. 「テスト・アセット」をクリックして、ライブラリに追加するテスト・アセットを定義します。

5. 「作成」メニューから、「Oracle Functional Testing」を選択します。Oracle Functional Testingアセット・プロパティ・ページが表示されます。

6. 次の情報を指定します。

- 名前: このテスト・アセットのわかりやすい名前を入力します。

- 説明: このテスト・アセットの意味のある説明を入力します。

- アプリケーション・タイプ: 「アプリケーション」ドロップダウン・リストをクリックして、リストからテストするアプリケーションを選択します。

- タグ: キーワードとして使用するタグを入力して、このテスト・アセットを詳細に識別します。これらのタグによって、テスト・アセットの特定およびアセットの目的の理解が容易になります。

- スクリプト: 「参照」をクリックし、アップロードするスクリプト・ファイルを選択します。Oracle Functional Testingのファイル・タイプはZIPです。(オープン・スクリプト・ツールからエクスポートされたテスト・スクリプトZip)
注意: 複数のスクリプトを選択する場合は順序が重要です。スクリプトは、リストに表示されている順序で実行されます。

7. すべての情報を指定したら、「発行」をクリックします。
テスト・アセットがライブラリに追加されます。Oracle Load Testingシナリオ・ファイルにハードウェア見積り結果が含まれている場合は、ハードウェア見積り可能ラベルがtrueに設定されます。

テスト・アセット名をクリックすると、テスト・アセット詳細ページにドリルダウンします。

42.3.4 テスト・アセットの作成 - カスタム・テスト

次のプロセスに従って、カスタム・テスト・アセットを作成します。

1. テスト設計者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「セルフ・サービス・ポータル」を選択します。インフラストラクチャ・クラウド・セルフ・サービス・ポータル・ページが表示されます。

3. 「マイ・テスト」をクリックします。「マイ・ライブラリ」タブが表示されます。

4. 「テスト・アセット」をクリックして、ライブラリに追加するテスト・アセットを定義します。

5. 「作成」メニューから、「カスタム」を選択します。カスタム・テスト・アセット・プロパティ・ページが表示されます。

6. カスタム・テスト・ドライバのタイプを選択します。
テスト・アセットの名前および説明を入力します。加えて、カスタム・アセット・タイプの場合は、ユーザーに公開されるパラメータを決定します。

7. 「アプリケーション」ドロップダウン・リストをクリックして、リストからテストするアプリケーションを選択します。

8. キーワードとして使用するタグを入力して、このテスト・アセットを詳細に識別します。これらのタグによって、テスト・アセットの特定およびアセットの目的の理解が容易になります。

9. 「参照」をクリックし、アップロードするアセット・ファイルを選択します。カスタムのファイル・タイプは、含まれるテスト・ドライバによって認識されるファイル・タイプのいずれかです。

10. 「OK」をクリックします。テスト・アセットがライブラリに追加されます。テスト・アセット名をクリックすると、テスト・アセット詳細ページにドリルダウンします。

42.3.5 テスト環境の作成

テスト環境はアプリケーション・スタック全体を表すエンティティの集まりなので、環境は次の要素で構成されます。

- テスト下のアプリケーション(AuT): ソフトウェア・ビットおよびアプリケーション・データを含みます。たとえば、デプロイされたSiebelアプリケーションなどで、エンド・ユーザーはアプリケーションの設定、構成およびパラメータを変更できます。

- テスト下のインフラストラクチャ(IaT): これらは、テスト下のアプリケーションが依存するエンティティです(クラウド・デプロイメント内のクラウド設定/インフラストラクチャなど)。通常、インフラストラクチャは、管理者によってエンド・ユーザーの使用のために作成されます。

注意: テスト環境を作成する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、テスト環境を作成します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト設計者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。

2. 「エンタープライズ」メニューから「クラウド」を選択し、「セルフ・サービス・ポータル」を選択します。セルフ・サービス・ページが表示されます。

3. 「マイ・テスト」をクリックします。「マイ・ライブラリ」タブが表示されます。

4. 「テスト環境」をクリックして、ライブラリに追加するテスト環境を定義します。

5. 「作成」をクリックします。テスト環境プロパティ・ページが表示されます。

6. テスト環境の名前および説明を入力します。

7. 「アプリケーション」ドロップダウン・リストをクリックして、リストからテストするアプリケーションを選択します。

8. キーワードとして使用するタグを入力して、このテスト環境を詳細に識別します。これらのタグによって、テスト環境の特定および環境の目的の理解が容易になります。

9. 拡大鏡アイコンをクリックして、このテスト環境に使用するデプロイ・プランを選択します。
デプロイ・プランは、テスト設計者またはテスト管理者がオペレータ権限を持っているゾーン上ですでに作成済である必要があります。また、そのゾーンは同じテスト設計者またはテスト管理者に表示権限が割り当てられているOracle VM Managerの一部である必要があります。

10. テスト環境にWebアプリケーションが含まれている場合は、「はい」をクリックします。

11. 「Webアプリケーションの選択」ドロップダウンをクリックして、環境がクラウドにデプロイされる場合にアプリケーションまたはWebサーバーとして機能するアプライアンスを選択します。

12. 「OK」をクリックします。テスト環境がライブラリに追加されます。テスト環境名をクリックすると、テスト環境詳細ページにドリルダウンします。デプロイ・プラン名をクリックすると、デプロイメント・プランの詳細ページにドリルダウンします。

42.4 テスト実施者のタスク - テスト環境の使用

テスト管理者およびテスト設計者がそれぞれのタスクの実行を完了すると、テスト実施者がテストを開始できるようになります。

テスト・クラウド・セルフ・サービス・ポータルによって、テスト実施者は、テスト・アクティビティを実行するため、テスト・アセットおよびテスト環境からテストを作成できます。テスト実施者は、テスト管理者が割り当てたテスト・アセットおよびテスト環境を使用して、テストを作成します。

テスト実施者は、テスト下のアプリケーションおよびそれに関連するキー・パフォーマンス・インジケータ(KPI)を確認する必要があります。テスト実施者は、実行するテスト・シナリオのビジネス・ユースケースも確認する必要があります。具体的には次のような役割があります。

- テスト設計者が作成してテスト管理者が割り当てたテスト・アセットおよびテスト環境を使用して、テストを実行。

- クラウドのリソースの予約、今後の予約の取消し、予約されているリソース(CPU、メモリーなど)の構成の更新。

- テスト設計者が設定したテスト・シナリオを編集して、ランタイム・テスト・パラメータを指定して実行用のテストをスケジュール。

- アプリケーションおよびビジネス・ユースケースに関連する様々なメトリックを比較するテスト実行分析を実行。

次のタスクは、テスト実施者が実行します。

- テストの作成

- テストの作成 - Oracle Load Testingテスト

- テストの作成 - Oracle Functional Testing Testsテスト

- テストの作成 - カスタム・テスト

- 試行の作成および実行

- Oracle Load Testing試行の作成および実行

- Oracle Functional Testing試行の作成および実行

- 進行中の試行の監視

- 試行結果の比較

- テストの共有

- アクティビティおよび使用状況情報の表示

- デプロイメント情報の表示(「マイ・デプロイメント」の参照)

- テスト・ホーム・ページの参照

42.4.1 使用可能なテスト・アセットおよびテスト環境の確認

テスト実施者は、テスト・クラウド・セルフ・サービス・ポータルを使用して、テスト管理者が割り当てたテスト・アセットおよびテスト環境を確認できます。

注意: 使用可能なテスト・アセットおよびテスト環境を確認する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、ロールに割り当てられたテスト・アセットおよびテスト環境を確認します。

1. テスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。テスト・クラウド・セルフ・サービス・ポータル・ホーム・タブが表示されます。

3. 「マイ・ライブラリ」タブをクリックします。「マイ・ライブラリ」タブには、テスト管理者が発行するテスト環境およびテスト・アセットが表示されます。

4. 「テスト環境」をクリックします。

5. 環境をクリックして、環境の詳細を表示します。コンポーネントをクリックして、アセンブリ構造詳細にドリルダウンします。

6. 「テスト・アセット」をクリックします。

7. テスト・アセットをクリックして、アセットの詳細を表示します。

42.4.2 テストの作成

テスト・クラウド・セルフ・サービス・ポータルによって、テスト実施者は、テスト・アクティビティを実行するため、テスト・アセットおよびテスト環境からテストを作成できます。テスト実施者は、テスト管理者が割り当てたテスト・アセットおよびテスト環境を使用して、テストを作成します。

注意: テストを作成する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

作成できるテストのタイプについては、次の項を参照してください。

- テストの作成 - Oracle Load Testingテスト

- テストの作成 - Oracle Functional Testing Testsテスト

- テストの作成 - カスタム・テスト

42.4.3 テストの作成 - Oracle Load Testingテスト

注意: テストを作成する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、Oracle Load Testingテストを作成します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。インフラストラクチャ・クラウド・セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・テスト」タブをクリックします。

4. 「作成」メニューから、「Oracle Load Testing」を選択します。テストの作成ページが表示されます。

5. 名前と説明を指定します。また、拡大鏡アイコンをクリックし、このテストに使用するテスト・アセットを選択して、「続行」をクリックします。

6. ソースを選択し、拡大鏡アイコンをクリックして、このテストに使用するテスト環境を選択します。必要に応じて、「マッピングURL」設定を変更します。

7. 「テスト・ドライバ」ドロップダウンをクリックして、クラウドのテストを実行するために使用するテスト・ドライバを選択します。

8. テスト・ドライバがエージェント・デプロイ・プランで構成されている場合、テスト・アセットおよびテスト・ドライバに基づいて、このテストに使用するエージェント・マシンの推奨数がハードウェア見積りリージョンに表示されます。

9. 「OK」をクリックします。テストは、アセット、環境およびテスト・ドライバを指定するライブラリに追加されます。テスト名をクリックすると、詳細ページにドリルダウンします。

42.4.4 テストの作成 - Oracle Functional Testing Testsテスト

注意: テストを作成する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、Oracle Functional Testingテストを作成します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。インフラストラクチャ・クラウド・セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・テスト」タブをクリックします。

4. 「作成」メニューから、「Oracle Functional Testing」を選択します。テストの作成ページが表示されます。

5. 名前と説明を指定します。

6. テストに対して1つ以上の機能テスト・アセットを選択するには、「追加」をクリックします。アセットがリストされる順序は、試行でのその実行の順序になります。
「上に移動」および「下に移動」矢印を使用して、必要に応じて、アセットの順序を変更します。また、必要に応じてアセットを削除できます。

7. 「続行」をクリックします。

8. ソースを選択し、拡大鏡アイコンをクリックして、このテストに使用するテスト環境を選択します。必要に応じて、マッピングURLを変更します。

9. 「テスト・ドライバ」ドロップダウンをクリックして、クラウドのテストを実行するために使用するテスト・ドライバを選択します。

10. 「OK」をクリックします。テストは、アセット、環境およびテスト・ドライバを指定するライブラリに追加されます。テスト名をクリックすると、詳細ページにドリルダウンします。

42.4.5 テストの作成 - カスタム・テスト

注意: テストを作成する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、カスタム・テストを作成します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。インフラストラクチャ・クラウド・セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・テスト」タブをクリックします。

4. 「作成」メニューから、「カスタム」を選択します。テストの作成ページが表示されます。

5. テストの名前および説明を入力します。

6. 拡大鏡アイコンをクリックし、このテストに使用するテスト・アセットを選択して、「選択」をクリックします。

7. テスト・アセットを選択し、詳細を確認して、「続行」をクリックします。

8. ソースを選択し、拡大鏡アイコンをクリックして、このテストに使用するテスト環境を選択します。

9. テスト環境を選択して、「選択」をクリックします。

10. 「テスト・ドライバ」ドロップダウンをクリックして、クラウドのテストを実行するために使用するテスト・ドライバを選択します。

11. 「OK」をクリックします。テストは、アセット、環境およびテスト・ドライバを指定するライブラリに追加されます。テスト名をクリックすると、詳細ページにドリルダウンします。

42.4.6 試行の作成および実行

テスト・クラウド・セルフ・サービス・ポータルを使用すると、テスト実施者は、ポータルで作成されたテスト・インスタンスから試行を作成および実行できます。テスト実施者は、テスト・アセットおよびテスト環境に基づいて試行を実行し、進行中の試行を監視して、完了した試行の結果を分析します。

注意: 試行を作成および実行する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

作成および実行できる試行のタイプについては、次の項を参照してください。

- Oracle Load Testing試行の作成および実行

- Oracle Functional Testing試行の作成および実行

42.4.7 Oracle Load Testing試行の作成および実行

次のプロセスに従って、Oracle Load Testing試行を作成し、実行します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。インフラストラクチャ・クラウド・セルフ・サービス・ポータルにログインします。

2. セルフ・サービス・ポータルの「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・テスト」タブをクリックします。

4. この試行に実行するテストを選択します。

5. 「試行」セクションの作成...をクリックします。試行の作成ページが表示されます。

6. 試行の名前および説明を入力します。

7. 「テスト下のアプリケーション」リージョンで、テスト下のアプリケーション・インスタンスの詳細を指定します。

- 新しいインスタンスの作成: テスト下のアプリケーションに対してクラウドに新しい仮想マシンを作成できます。

- 既存のインスタンスの使用: このテストまたはこのアプリケーションのインスタンスを以前に作成していた場合、新規作成ではなく仮想マシンの同じセットを再利用できます。
既存のインスタンスを再利用すると、インスタンスをデプロイする必要がなくなるため、時間を短縮できます。

- 新しいインスタンスを作成する場合は、ルート・パスワードの任意のパスワードを入力し、確認のため再入力します。

重要:
この値は取得できません。このパスワードを忘れないでください。

- (オプション)「インスタンスの停止」および「インスタンスの削除」設定を指定して、「続行」をクリックします。

8. 「テスト・アセット・パラメータ」リージョンで、次の操作を実行できます。

- 各スクリプトの「試行仮想ユーザー」列で、この試行に実行する仮想ユーザーの数を変更します。
(アセットを作成した)テスト設計者がユーザーによる値の上書きを許可した場合のみ、これらの値を設定できます。それ以外の場合、アプリケーションはアセットで使用可能な情報を使用し、これらのコントロールはグレー表示されます。

- この試行のランプアップ率設定を指定します。
アセットを作成したテスト設計者がユーザーによる値の上書きを許可した場合のみ、これらの値を変更できます。それ以外の場合、アプリケーションはアセットで使用可能な情報を使用し、これらのコントロールはグレー表示されます。

- 試行の「終了条件」設定を設定して、「続行」をクリックします。
(アセットを作成した)テスト設計者がユーザーによる値の上書きを許可した場合のみ、これらの値を設定できます。それ以外の場合、アプリケーションはアセットで使用可能な情報を使用し、これらのコントロールはグレー表示されます。

テスト終了条件を設定しない場合、テストは手動で停止するまで実行されます。

テスト・アセット・パラメータを確認した後に、「続行」をクリックします。

9. 「テスト・ドライバ」リージョンで、新しいインスタンスを作成したり既存のインスタンスを使用したりできます。既存のインスタンスが別の試行によって使用されている場合は使用できません。
マスター・パスワードに選択したパスワードを入力し、確認のために再入力します。これは、テスト・クラウド・セルフ・サービス・ポータルでOracle Load Testing仮想マシンおよびOracle Load Testingのすべてのアカウントに設定するパスワードです。

「インスタンスの停止」および「インスタンスの削除」設定を指定して、「続行」をクリックします。

10. ハードウェア見積りリージョンで、エージェント・マシンの見積りおよび追加を行えます(ハードウェア見積り機能)。
これが試行の場合、エージェント・デプロイ・プランを持つテスト・ドライバを使用します。前のステップおよびエージェント・デプロイ・プランで設定されたパラメータに基づいて数が計算されます。また、新しい数値を指定することもできます。ハードウェア見積り設定は、テスト・ドライバにエージェント・デプロイ・プランがある場合にのみ有効です。

11. 「スケジュール」リージョンで、試行を即時に開始するか、後で実行するようにスケジュールするかを指定します。新しい試行が実行するために作成および発行されます。
「OK」をクリックします。試行の初期実行は、仮想マシンのデプロイ、必要なソフトウェアのコピーおよびテストの開始に時間がかかる場合があります。

42.4.8 Oracle Functional Testing試行の作成および実行

次のプロセスに従って、Oracle Functional Testing試行を作成し、実行します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。インフラストラクチャ・クラウド・セルフ・サービス・ポータルにログインします。

2. セルフ・サービス・ポータルの「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・テスト」タブをクリックします。

4. この試行に実行するテストを選択します。

5. 「試行」セクションの作成...をクリックします。試行の作成ページが表示されます。

6. 試行の名前および説明を入力します。

7. 「テスト下のアプリケーション」リージョンで、テスト下のアプリケーション・インスタンスの詳細を指定します。

- 新しいインスタンスの作成: ユーザーは、テスト下のアプリケーションに対してクラウドに新しい仮想マシンを作成できます。

- 既存のインスタンスの再利用: ユーザーがこのテストまたはこのアプリケーションのインスタンスを以前に作成した場合、新規作成ではなく仮想マシンの同じセットを再利用できます。
既存のインスタンスを再利用すると、インスタンスをデプロイする必要がなくなるため、時間を短縮できます。

- 新しいインスタンスを作成する場合は、マスター・パスワードの任意のパスワードを入力し、確認のため再入力します。

重要:
この値は取得できません。このパスワードを忘れないでください。

- 「インスタンスの停止」および「インスタンスの削除」設定を指定します。

8. アセットの実行設定リージョンで、実行するアセットを選択します。「続行」をクリックします。

9. 再生設定リージョンで、必要に応じてこの試行の設定を変更します。時間を節約するために、別のアセットから設定をコピーできます。
この試行に対して元の設定に戻すには、「リセット」をクリックします。

10. データ・バンク・リージョンで、このアセットで使用されるデータ・バンクを確認し変更します。「続行」をクリックします。

11. 「テスト・ドライバ」リージョンで、テスト・ドライバの新しいインスタンスを作成するか、既存のインスタンスを使用します。
既存のインスタンスが別の試行によって使用されている場合は使用できません。

- マスター・パスワードに選択したパスワードを入力し、確認のために再入力します。

- 「インスタンスの停止」および「インスタンスの削除」設定を指定します。

12. 「スケジュール」リージョンで、試行の実行を開始するスケジュールを指定し、「OK」をクリックします。新しい試行が実行するために作成および発行されます。試行の初期実行は、仮想マシンのデプロイ、必要なソフトウェアのコピーおよびテストの開始に時間がかかる場合があります。

42.4.9 進行中の試行の監視

テスト・クラウド・セルフ・サービス・ポータルを使用すると、テスト実施者は、実行中の試行を監視し、テスト下のアプリケーションのキー・パフォーマンス・インジケータのグラフを作成できます。

注意: 進行中の試行を監視する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、進行中のテストを監視します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。インフラストラクチャ・クラウド・セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・テスト」タブをクリックします。

4. テストを選択して、試行の詳細を表示します。試行ステータス情報が「試行」ペインに表示されます。

5. 「試行」ペインの試行名リンクをクリックして、試行ホーム・ページに移動します。
「ステータス」をクリックして、試行の進行状況を監視できます。試行のステータスが「進行中」の場合、試行名をクリックすると、試行ホームおよび残りの試行情報に移動します。

6. メトリック・ノードを開き、メトリックまたはカウンタを選択してグラフに表示します。Oracle Functional Testingの場合、試行結果の項目を選択して結果の詳細を表示できます。

7. テスト・ドライバ・インスタンス・セッションで現在の試行に関連付けられたエージェントの数を表示します。

42.4.10 試行結果の比較

テスト・クラウド・セルフ・サービス・ポータルを使用すると、テスト実施者は、試行結果を比較し、テスト下のアプリケーションのキー・パフォーマンス・インジケータのグラフを作成できます。

注意: この機能は、Oracle Load Testingテスト・ドライバ・ベースの試行に対してのみ使用可能です。

注意: 試行結果を比較する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、試行結果を比較します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。インフラストラクチャ・クラウド・セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・テスト」タブをクリックします。

4. テストを選択して、試行の詳細を表示します。試行ステータス情報が「試行」ペインに表示されます。

5. 以前に実行した同じテストの2つの試行を選択します。
同じテストの2つの試行を選択するには、1つの試行を選択し、[Shift]/[Ctrl]をクリックして、もう1つの試行を選択します。試行は、同じテストに属する必要があります。

6. 「結果の比較」をクリックします。2つの試行のメトリックを比較して、違いを表示できます。
このモードのときにメトリックを選択すると、選択した試行に1行ずつ、2行が表示されます。Oracle Load Testingセッション・サマリー・レポートを並べて比較することもできます。

42.4.11 テストの共有

二重手間を避けるために、他のユーザーとテストを共有できます。テストを作成および共有したユーザーは、共有テストに関連付けられたリソース使用に応じてチャージされることに注意してください。

テストを共有するには、次の手順を実行します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・テスト」タブをクリックします。

4. マイ・テスト・ページで、テストのリストからテストを選択します。

5. 「共有」をクリックします。

6. テストを共有するユーザーを選択します。

7. 「共有」をクリックします。

8. 「ログアウト」をクリックします。

テストが共有されていることを確認するには、次の手順を実行します。

1. テストを共有したユーザーとしてログインします。

2. 共有テストにアクセスできることを確認します。

42.4.12 アクティビティおよび使用状況情報の表示

テスト・クラウド・セルフ・サービス・ポータルによって、テスト実施者は、使用できるテスト・アセットおよびテスト環境のサマリー情報、ユーザー・ロール用にテスト管理者が定義した割当て制限、ハードウェア・リソースの現在の使用率、および発行およびスケジュールされた試行を表示できます。

注意: アクティビティおよび使用状況情報を表示する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、アクティビティおよび使用状況情報を表示します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「ホーム」タブをクリックします。このタブには、使用できるテスト・アセットおよびテスト環境のサマリー情報、ユーザー・ロール用にテスト管理者が定義した割当て制限、ハードウェア・リソースの現在の使用率、および発行およびスケジュールされた試行が表示されます。

42.4.13 デプロイメント情報の表示

テスト・クラウド・セルフ・サービス・ポータルを使用すると、テスト実施者は、テスト・アセットおよびテスト環境からテストを作成して、テスト・クラウド・セルフ・サービス・ポータルを使用してテスト・アクティビティを実行できます。テスト実施者は、テスト管理者が割り当てたテスト・アセットおよびテスト環境を使用して、テストを作成します。テスト実施者は、テスト・アセットおよびテスト環境に基づいて試行を実行し、進行中の試行を監視して、完了した試行の結果を分析します。

注意: デプロイメント情報を表示する前に、前提条件が満たされていることを確認してください(「前提条件」を参照)。

次のプロセスに従って、アクティビティおよび使用状況情報を表示します。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「マイ・デプロイメント」タブをクリックします。このタブには、デプロイされるすべての環境およびテスト・ドライバの表が表示されます。

4. テスト環境またはテスト・ドライバ・インスタンスを選択します。詳細ペインには、選択したテスト環境またはテスト・ドライバ・インスタンス内のアプライアンスが表示されます。

5. 選択したテスト環境またはテスト・ドライバ・インスタンス内のアプライアンスをクリックして、アプライアンスの詳細表示に移動します。

42.4.14 テスト・ホームページの参照

ユーザーの「HOME」タブには、ユーザーが実行した内容(ユーザーが消費したリソースやユーザーが作成したテストなど)のサマリーが表示されます。「HOME」タブから、ユーザーは、結果の比較や詳細な実行後分析を行う目的で、以前に実行したテスト試行に迅速にアクセスできます。

テスト・ホームページには、進行中のテストの統計に関する情報が示されます。テスト・アセットおよびテスト環境、進行中のテストおよび試行、Oracle Load Testingおよびインフラストラクチャとともに、一般的な統計が示されます。プロビジョニングされるサーバーの数、CPUの数、RAMおよび記憶域など、サーバーの概要およびユーザーが使用するインフラストラクチャ・リソースも示されます。

テスト設計者としてログインした場合、「マイ・ライブラリ」タブのみが表示されます。テスト管理者としてログインした場合、「ホーム」タブが表示されます。スーパー管理者としてログインする場合、「ホーム」および「マイ・ライブラリ」タブの両方が表示されます。

「ホーム」タブのセクションは次のとおりです。

- 一般 - システムに存在するテスト合計、すべての試行で実行された試行合計など、システムで使用できる様々なアーティファクトの合計数。

- テスト・アセット/環境 - テスト・クラウド内のテスト・アセット、環境および使用中のマシンの累積グラフ。数および傾向データが含まれます。これは、テスト実施者に関係なくTaaSポータル全体のテスト管理者の概要です。

- テストおよび試行 - 作成されたテストの数の日次合計または試行の実行の数の日次合計。

- インフラストラクチャ - インフラストラクチャ・リソース(CPU、メモリーおよびディスク領域の記憶域)の日次消費。

- Oracle Load Testing (OLT) - 実行されたOLT仮想ユーザー(VU)の数の日次合計。Oracle Load Testingは、OpenScriptスクリプトを使用して、テスト下のアプリケーションにアクセスするユーザーをシミュレートします。

垂直軸は、各リージョンの表示選択に基づく日次使用状況の合計を示します。

「マイ・ライブラリ」タブは、テスト・アセットおよびテスト環境の詳細を示します。

1. テスト実施者資格証明を使用して、Enterprise Managerにログインします。

2. 「マイ・テスト」ラジオ・ボタンをクリックします。

3. 「ホーム」タブをクリックします。

使用できるテスト・アセットおよびテスト環境のサマリー、ユーザー・ロール用にテスト管理者が定義した割当て制限、ハードウェア・リソースの現在の使用率、発行およびスケジュールされた試行が表示されます。

42.4.15 試行ページ

試行ページには、試行の結果、テスト環境、構成およびパフォーマンス情報が表示されます。

ページの上部には、試行のステータス、試行の結果、試行を停止するオプションを含む試行の開始時間、実行中のテスト、および使用中のテスト環境などの試行の一般情報が表示されます。

結果

注意: 「結果」タブは、Oracle Functional Testingのみに適用されます。

「結果」タブから、次の操作を実行できます。

- 別の時点で表示される結果のダウンロード

- 結果の場所の参照

- BI Publisherで発行されるレポートの生成

テスト環境

「テスト環境」タブから、次の操作を実行できます。

- テストに使用するゲスト仮想マシンの起動、停止および再起動

- テストに使用するテスト・ドライバ・インスタンスの起動、停止および再起動

構成

「構成」タブから、次の操作を実行できます。

- テストされたアプリケーションの詳細の表示

- テストに使用されたテスト・ドライバ

- 使用されたテスト・アセット・パラメータのリスト

- 試行のスケジュール

パフォーマンス

注意: 「パフォーマンス」タブは、Oracle Load Testingの試行に対してのみ使用可能です。

「パフォーマンス」タブから、次の操作を実行できます。

- すべての収集されたOracle Load TestingカウンタとEnterprise Managerターゲットのメトリックの表示

- 関心のあるカウンタ/メトリックの選択およびそれらのチャートでの表示

サマリー

注意: 「サマリー」タブは、Oracle Load Testingの試行に対してのみ使用可能です。

「サマリー」タブから、次の操作を実行できます。

- この試行のサマリー・レポートおよびAWRレポート(使用可能な場合)の確認

- Oracle Load Testing試行レポートおよびAWRレポート(使用可能な場合)の生成

42.4.16 TaaSレポートの表示

試行に関する情報の共有を促進するために、TaaSは、Business Intelligence Publisher (BI Publisher)を使用してレポートを提供します。これらのレポートには、TaaS Oracle Functional Testing試行レポートおよびTaaS Oracle Load Testing試行レポートが含まれます。

これらのレポートを表示するには、次の手順に従います。

1. テスト・クラウド・セルフ・サービス・ポータルのテスト実施者資格証明を使用して、Enterprise Manager Cloud Controlにログインします。インフラストラクチャ・クラウド・セルフ・サービス・ポータルにログインします。

2. 「マイ・テスト」をクリックします。

3. テスト・クラウド・セルフ・サービス・ポータルの「ホーム」タブをクリックします。このタブには、使用できるテスト・アセットおよびテスト環境のサマリー情報、ユーザー・ロール用にテスト管理者が定義した割当て制限、ハードウェア・リソースの現在の使用率、および発行済、スケジュール済および完了した試行が表示されます。

4. 試行をハイライト表示します。

5. 「結果」タブで、「レポートの生成」をクリックします。

42.4.17 テストに必要なハードウェアの見積り

テスト・ドライバ・ハードウェア・リソース要件は、試行の仮想ユーザー数、ランプアップ・レート、スクリプト・ステップの数、スクリプトおよびスクリプト・タイプの変数の数などの要因によって異なります。

TaaSがテスト試行に対して適切な量のリソースを提供するように、TaaSはハードウェア見積り機能を提供しています。TaaSは、テスト試行でテスト・アセットによって消費されたCPUおよびメモリー・リソースの見積り結果に基づいてエージェント・マシンを計算し、作成します。

注意:
ハードウェア見積り機能を使用する場合は、Oracle Load Testingアプリケーションでscenario.zipファイルを作成する際に、「エクスポート・ファイル」画面の「ハードウェア見積りデータ」オプションを選択しておく必要があります。

この機能を使用するには、テスト管理者およびテスト実施者は、次の手順を実行する必要があります。

1. Oracle Load Testingテスト・ドライバのエージェント・デプロイ・プランを定義します。

1. 「設定」メニューから、「クラウド」、「テスト」の順に選択します。

2. テスト・クラウド・セルフ・サービスの設定ページでのナビゲーション・ツリーで、「テスト・ドライバ」を選択します。

3. 「登録」メニューから、「Oracle Load Testing」を選択します。

4. 名前、デプロイ・プランおよびバージョンなどの情報を指定します。
使用するデプロイ・プランは拡張可能であることを確認します。

2. テストOracle Load Testingアセットのハードウェア見積り結果を表示します。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「セルフ・サービス・ポータル」を選択します。

2. 「マイ・テスト」を選択します。

3. テスト・クラウド・セルフ・サービス・ポータル・ページで、「マイ・ライブラリ」タブをクリックします。

4. 「テスト・アセット」を選択します。関心のあるアセットをハイライト表示します。「シナリオ構成」セクションは、このアセットのハードウェア見積りが使用可能かどうかを示します。「X」は見積りが使用可能でないことを示し、一方、チェック・マークは使用可能であることを示します。

3. テスト・アセットを作成するには、「作成」をクリックし、「Oracle Load Testing」を選択します。必要な情報を指定します。

- シナリオのzipファイルは、Oracle Load Testingアプリケーションからエクスポートされます。
ハードウェア見積りデータ機能の有効化は、シナリオzipファイルで設定されます。シナリオを作成する方法については、Oracle Application Testing Suiteのダウンロード・ページ(http://www.oracle.com/technetwork/oem/downloads/index-084446.html)から入手可能なOracle Load Testingユーザーズ・ガイドを参照してください。

- このアセットを使用して試行を作成する際、構成可能なパラメータを選択して、これらの設定を変更できます。

4. 見積りリソース結果でテスト・ドライバを評価します。

1. 「マイ・テスト」タブから、「作成」、「Oracle Load Testing」の順に選択します。

2. 必要な情報を指定し、そのソース(テスト・アセット)がハードウェア見積りデータ機能を持っていることを確認します。
注意: エクスポート・ファイル・ページのハードウェア見積りデータ機能の有効化は、シナリオzipファイルで設定されます。

また、ハードウェア見積りリージョンには、選択したテスト・アセットのテストに使用するエージェント・マシンの推奨数が含まれていることに注意してください。

5. 見積りリソース結果を使用してOracle Load Testing試行を開始します。

1. 「マイ・テスト」タブをクリックします。試行に使用するテストをハイライト表示します。

2. 「試行」セクションで、「作成」を選択します。

3. 「試行の作成」画面で、次の操作を行います。
- 「概要」および「テスト下のアプリケーション」リージョンで、必要な情報を指定します。「続行」をクリックします。

- テスト・アセット・パラメータについて、必要な場合は試行の仮想ユーザー、ランプアップ・レートおよび終了条件の値を変更します。「続行」をクリックします。

- テスト・ドライバ、ハードウェア見積りおよびスケジュールのパラメータを指定します。「OK」をクリックします。

ハードウェア見積りリージョンでは、エージェントの数が、試行に必要なリソースを満たすようにTaaSによって計算されることに注意してください。ただし、必要に応じてエージェントの数を変更できます。

6. 試行ホーム内のエージェント・ステータスを表示します
「マイ・テスト」タブで、目的の試行をハイライト表示します。

7. 「マイ・デプロイメント」タブで、エージェントのステータスを表示します。
「マイ・デプロイメント」タブで、目的のデプロイメントをハイライト表示します。エージェントのステータスが、「エージェント」タブに表示されます。

8. 異なるテスト・ドライバ・インスタンス間のエージェントを共有/共有解除します。

第XV部

統合プランナおよびチャージバックの使用

この項では、Enterprise Managerの統合プランナおよびチャージバックの機能について説明します。

内容は次のとおりです。

- 第44章「統合プランナの使用」

- 第43章「チャージバック管理」

43 チャージバック管理

この章では、チャージバック・アプリケーション、およびそのアプリケーションの設定および実行に必要となる管理作業の詳細について説明します。また、チャージバックで収集および集計された情報にアクセスして使用するための様々な方法を示します。

内容は次のとおりです。

- チャージバックの概要

- チャージバックの設定

- チャージバック情報へのアクセス

43.1 チャージバックの概要

この項では、チャージバックの最も重要な側面について簡単に説明します。内容は次のとおりです。

- チャージバックを実装する理由

- Enterprise Managerのチャージバック

43.1.1 チャージバックを実装する理由

チャージバックの目的は、リソースの使用に関するデータを収集し、これらのリソースの使用に対してチャージを割り当てて、結果を包括的な形式で表示することです。

チャージバックは、ITリソースを消費する個人または組織に対するコストの割当てに使用されます。チャージバックは、ITリソースが専有されている状況にも適用できますが、消費量を計測し、それに応じて請求する方法がない場合、ユーザーの必要とする以上のリソースを使用する傾向があるため、リソースが共有されている状況では特に意味を持ちます。ユーザーが自身のリソースをセルフ・サービスでプロビジョニングできるクラウド環境では、これがさらに大きな問題となります。

次の主要なユースケースについて考えます。

- 組織はOracle ExadataやOracle Exalogicなどの統合プラットフォームを採用するようになっていますが、共有ハードウェア・プラットフォーム上では複数のアプリケーションが実行されています。各アプリケーションで消費されるリソースを測定し、それに応じてチャージを適用できる方法が必要です。これは、ひいては、IT投資のビジネス価値を測定し、アプリケーションに投資利益率(ROI)が高い順に優先順位を付けるのに役立ちます。

- クラウド・コンピューティングの人気が上昇しています。クラウド・コンピューティングでは、データベースや仮想マシンなどのリソースのセルフサービス・プロビジョニングが可能であるため、各クラウド・コンシューマが使用するリソースを測定し、消費量に基づいてチャージできることが望まれます。クラウド・コンシューマもまた、最良のビジネス価値を提供し、それによって組織のIT投資のROIに貢献するものに消費を分配することで利益が得られます。

要約すると、チャージバック(またはショーバック)モデルを採用することで、ITおよび部門ユーザーの両方に大きな利益をもたらすことができます。

- チャージバックは、ITコストをコントロールできることで、コンシューマの利益となります。

- チャージバックは、管理を必要とする物理的なリソースの数を減らしながら使用率を高め、ITにとっての利益となります。

43.1.2 Enterprise Managerのチャージバック

Chargebackは、その名前が示すように、アカウンタビリティのツールです。このアプリケーションの主な用途は、一般に次のように説明できます。

- Enterprise Managerが収集する膨大なメトリック・データを集計および正規化することで、リソース使用率を測定します。

- リソースを使用するコンシューマに金額をチャージする方法を提供します。

- コンシューマに使用明細および関連するチャージ明細を提供します。

43.1.2.1 チャージバック・エンティティ

チャージバックはリソースの使用に基づいてチャージを計算します。通常、リソースはEnterprise Managerターゲットに関連付けられています。チャージバックは、Enterprise Managerターゲットのサブセットのメトリックおよび構成情報を収集してチャージを計算します。リソースには、Enterprise Managerで監視およびチャージするようにインテグレータがカスタマイズするものもあります。チャージバックでは、これらのEnterprise Managerターゲットとカスタム・リソースをエンティティとして集合的に認識します。カスタム・エンティティの作成の詳細は、『Oracle Enterprise Manager Cloud Control拡張プログラマーズ・ガイド』を参照してください。

注意:
現在、即時利用可能なチャージバック・サポートが存在しないEnterprise Managerターゲット・タイプにチャージバック・サポートを追加することもできます。詳細は、第56章「EMCLI動詞によるチャージバックとメータリング」を参照してください。

チャージバックには、使用モードの概念、つまり、エンティティの計測方法が含まれます。エンティティ・タイプを作成するインテグレータが、関連付けられた使用モードを定義します。すべてのエンティティ・タイプにはデフォルトの使用モードがあります。管理者は、チャージバックにエンティティを追加するときに、そのエンティティにデフォルト以外の使用モードがある場合、ある状況下で適用可能な使用モードを決定します。一般的な使用モードは次のとおりです。

- メーター制 - 単一のコスト・センターに対してチャージが発生

- サービスによる計測 - 複数のサービスを伴うデータベース・インスタンスのサービスによる請求。サービスによるチャージは、異なるコスト・センターに対してチャージすることも、すべてのサービスを同じコスト・センターに対してチャージすることもできます

- J2EEアプリケーションによる計測 - J2EEアプリケーションによるWebLogic Serverの請求。アプリケーションによるチャージでは、異なるコスト・センターに対しチャージします

チャージバックにエンティティを追加する方法の詳細は、第43.2.6項を参照してください。

43.1.2.2 チャージ・プラン

チャージ・プランは、チャージ対象のリソースおよびそれらに関連付けられているレートを定義します。チャージバックには、ユニバーサル・チャージ・プランと拡張チャージ・プランの2つのタイプがあります。

ユニバーサル・チャージ・プラン

ユニバーサル・チャージ・プランには、次の3つの共通リソースに対するレートが含まれます。

- CPU

- メモリー

- 記憶域

ユニバーサル・プランはすべてのエンティティ・タイプに適用されるわけではありません。たとえば、ユニバーサル・レートは、J2EEアプリケーションには適用されません。

拡張チャージ・プラン

CPU、メモリーおよび記憶域は様々なエンティティ・タイプのチャージバックに使用できますが、エンティティ固有のチャージが必要な場合もあります。たとえば、ホストOSのタイプ(WindowsまたはLinux)、またはパーティション化などのデータベース・オプションに基づいてチャージすることが必要な場合があります。このような場合に、拡張チャージ・プランを使用できます。拡張チャージ・プランは非常に柔軟性があり、チャージバックの管理者は次のことを行うことができます。

- エンティティ・タイプ固有のチャージの定義

- 構成および使用ベースのレートの定義

- 構成または使用状況に関係しない定額チャージの定義

- ユニバーサル・プランのレートのオーバライドまたは調整

チャージバックでは、お客様の環境に適した独自の拡張プランを作成するためのサンプルとして使用できる、即時利用可能な拡張プランが提供されています。付属のプランは、マシン・サイズによってチャージ・アイテムや適用可能レートが異なる、Oracle VMゲスト・エンティティ・タイプに対するチャージを定義します。

チャージ・プランの使用方法の詳細は、第43.2.4項を参照してください。

43.1.2.3 コスト・センター

リソースの消費に対するチャージを計算したら、これらのチャージをどこかに割り当てる必要があります。チャージバックでは、これらのコストをコスト・センターに割り当てます。コスト・センターは一般にビジネス階層に編成され、販売、エンジニアリング、人事などのビジネス単位に対応しています。コスト・センター階層はチャージバック・アプリケーション内で定義され、使用量およびチャージをレポートする際に、ロールアップおよびドリルダウンのために使用されます。チャージバック以外に設定されたコスト・センター・プロパティに基づくデフォルトのメカニズムもあります。コスト・センターを作成する方法の詳細は、第43.2.5項を参照してください。

43.1.2.4 レポート

チャージバックを設定するメリットは、情報という資産をすぐに入手できることです。円グラフ、棒グラフなど様々な形式で、情報を入手できます。コスト・センター、エンティティ・タイプ、リソースごとに詳細にドリルダウンできます。傾向レポートには、一定期間(最大1年)のチャージおよびリソース使用率が示され、ITリソース・プランニングに役立ちます。アプリケーション内で管理者が利用できるレポート機能の他に、セルフ・サービス・ユーザーはセルフ・サービス・ポータル内でエンティティに関連するチャージバック情報を確認でき、部門ユーザーはBIパブリッシャ・レポートでチャージバック情報を確認できます。

レポート・サイクル

チャージバックは、現在のカレンダ月に対するチャージを計算します。これは、レポート・サイクルとなります。構成されているチャージ・プランおよびレートに対するすべての調整は、レポート・サイクルの最初の日(現在の月の最初の日)からの使用状況に対して、遡及的に適用されます。以前のカレンダ月で発生したチャージは、チャージ済とみなされます。このため、チャージ・プランを変更しても、以前の月について計算されたチャージは影響を受けません。

チャージバック情報にアクセスする方法の詳細は、第43.3項を参照してください。

43.2 チャージバックの設定

この項では、チャージバック・サービスを実装およびサポートするために実行すべき次のタスクについて説明します。

- チャージバックに関するグローバル設定の構成

- チャージ・プランの使用

- コスト・センターの作成

- チャージバックへのエンティティの追加

- エンティティへのコスト・センターの割当て

- エンティティへのチャージ・プランの割当て

- 日次データ収集ジョブの実行

これらのタスクを実行する担当者は、必要な権限を持っている必要があります。これらの権限は、EM_CBA_ADMINロールを使用して付与できます。

注意:
チャージバックを設定して使用する方法の視覚的デモンストレーションを表示するには、次のURLを使用して、「Oracle Enterprise Manager 12c: Metering and Chargeback」というビデオを視聴してください。

https://apex.oracle.com/pls/apex/f?p=44785:24:0::NO:24:P24_CONTENT_ID,P24_PREV_PAGE:5772,1

図43-1は、チャージバックの設定に必要な手順の簡単なワークフローを示しています。

図43-1 チャージバック設定ワークフロー

次のような初期設定は、タスクを定期的に実行します。

- チャージバックへの新規エンティティの追加

- チャージ・プランの更新

- チャージ・プランおよびコスト・センターの割当て

次のような他のイベントは、自動的に発生します。

- SSAエンティティのチャージが上位のコスト・センターにロールアップされる

- コンポジット・エンティティのメンバーである新規エンティティ(VMゾーン内のVMゲストなど)が検出され、チャージバックに追加される

日次データ収集ジョブでは、メトリックおよび構成データの収集に加え、これらの変更を取得します。

日次の収集ジョブの詳細は、第43.2.10項を参照してください。

43.2.1 チャージバックとメトリック

チャージバックでは、Enterprise Managerが測定のベースとして収集した情報が使用されます。構成ベース、使用状況ベースまたは可用性ベースのチャージバック・メトリックを設定できます。

- 構成ベースのメトリックとは、CPU数やデータベース・バージョンを指します。これらのメトリックは静的であるとみなされるため、毎日集計されます。

- 使用状況ベースのメトリックとは、CPU使用率やメモリー消費量を指します。これらのメトリックは、毎時集計されます。

- 可用性ベースのメトリックは、エンティティを利用できる時間を測定します。エンティティの稼働時間とも呼ばれます。特定時間内でエンティティを利用できるとみなされる分数です。チャージは停止時間用に按分されます。

固定レートでチャージを適応することも可能です。

特定のメトリックにチャージ・レートを定義できるエンティティ・タイプには、ホスト、仮想マシン、WebLogic Server、データベース・インスタンス、スキーマ・サービスおよびプラガブル・データベース(PDB)があります。コンポジット・エンティティ・タイプも、チャージバックに追加できます。これには、クラスタ・データベース、Oracle WebLogicクラスタ、Oracle WebLogicドメイン、Oracle VMゾーン、PaaSインフラストラクチャ・ゾーン、Oracle VMサーバー・プールなどがあります。グループとシステムを追加すると、有効なチャージバック・エンティティであるすべてのメンバーが自動的に含められます。エンティティがチャージバックに追加されると、Enterprise Managerのエンティティ表に対して収集ジョブが1日に1回実行され、チャージバックで使用される情報が抽出されます。

チャージバック・データの保存期間

チャージバックは、収集したデータを次のように保存します。

- 毎時データは、デフォルトで3か月間使用できます。毎時データの現在の保存期間を表示するには、次の問合せを実行します。

select * from  EM_INT_PARTITIONED_TABLES where table_name like@ 'EMCT_CBA_CHARGE_1HOUR'

毎時の保存期間を調整するには、次のコマンド・シーケンスを実行します。

begin
gc_interval_partition_mgr.SET_RETENTION('SYSMAN', 'EMCT_CBA_CHARGE_1HOUR',
4);
end;

この例では、毎時の保存期間が4か月に延長されます。

- 日次データは、デフォルトで24か月間使用できます。日次データの現在の保存期間を表示するには、次の問合せを実行します。

select * from  EM_INT_PARTITIONED_TABLES where table_name like
@ 'EMCT_CBA_CHARGE_1DAY'

日次の保存期間を調整するには、次のコマンド・シーケンスを実行します。

begin
gc_interval_partition_mgr.SET_RETENTION('SYSMAN', 'EMCT_CBA_CHARGE_1DAY',
36);
end;

この例では、日次の保存期間が36か月に延長されます。

43.2.2 チャージバック内のセルフ・サービス・アプリケーションおよびゾーン

クラウド・コンピューティングの主要コンポーネントは、セルフ・サービス・アプリケーションの機能です。Enterprise ManagerにはOracle VM、データベースおよびミドルウェアのSSAが含まれています。

1. 個々のポータルにアクセスするには、「Enterprise」メニューから「クラウド」を選択し、「セルフ・サービス・ポータル」を選択します。

2. セルフ・サービス・ポータル・ページで、「管理」ドロップダウン・メニューからサービス・タイプを選択します。

3. チャージバック用に構成された場合、左ペインの「チャージバック」アイコンをクリックして、選択したサービス・タイプのチャージ傾向と詳細を表示します。

クラウド設定の実行時には、チャージバックに直接リンクして各ゾーンを構成できます。ゾーンの設定は前提条件です。

1. 「設定」メニューから、「クラウド」を選択して、次のように選択します。

- インフラストラクチャ: VMタイプを設定します。

- PaaSインフラストラクチャ・ゾーン: PaaSインフラストラクチャ・ゾーンを管理します。

- データベース: データベース・リソース・プールを設定します。

- ミドルウェア: ミドルウェア・リソース・プールを設定します。

- テスト: テスト・デザイナがテスト関連のアクティビティを整理するために使用するアプリケーション・タイプを追加します。

2. 各ホーム・ページの左側では、「チャージバック」が選択されています。クリックすると、設定を実行するためのチャージバックへのリンクがある、チャージバック設定の情報ページが表示されます。

チャージバックは、Oracle VMやPaaSインフラストラクチャなど、DBaaS、MWaaS、Schema as a Service (SchaaS)およびPluggable Database as a Service (PdbaaS)を含むいくつかのゾーンをサポートします。

チャージバック内の各ゾーン階層は、「エンティティ」タブで次のように表示されます(「クラウド」カテゴリの下にPaaSインフラストラクチャが、「サーバー、ストレージおよびネットワーク」カテゴリの下にOracle VMが表示されます)。

注意:
PaaSインフラストラクチャ・ゾーンには、次に示すように、データベース・インスタンス、RACインスタンス、データベース・サービス、コンポジット・アプリケーション、またはこれらの任意の組合せを含めることができます。

ゾーン

ゾーン階層

PaaSインフラストラクチャ

PaaSインフラストラクチャ・ゾーン
単一インスタンス・データベース

クラスタ・データベース

データベース・インスタンス1

データベース・インスタンス2

スキーマ・サービス

プラガブル・データベース

Oracle Composite Application

WebLogicドメイン

Weblogicクラスタ

Oracle WebLogic Server1

Oracle WebLogic Server2

Oracle WebLogic Server

Oracle VM

Oracle VMゾーン
Oracle VM Serverプール

Oracle VMゲスト1

Oracle VMゲスト2

次の特性は、すべてのエンティティ・タイプ・ゾーンに当てはまります。

- チャージバックにゾーンを追加すると、自動的にすべての子インスタンスが含められます。

- チャージバックからゾーンを削除すると、自動的にすべての子インスタンスが削除されます。

- 明示的にチャージ・プランが割り当てられていない子インスタンスは、階層内のすぐ上の祖先のプランを継承します。

- 明示的にコスト・センターが割り当てられていない子インスタンスは、階層内のすぐ上の祖先のコスト・センターを継承します。

- 階層内の特定レベルでチャージを問い合せると、そのレベルより下のすべてのチャージが含められます(直接的または間接的に)。

- ゾーンで検出された、またはゾーンに追加された新規メンバーは、次のデータ収集サイクルでチャージバックによって自動的に認識されます。

セルフ・サービスに関するチャージバック管理者は、すべての構成関連タスクを子エンティティ上ではなくセルフ・サービス・ゾーン上で実行する必要があります。

SSAエンティティがチャージバックに追加されるときに、SSAユーザーはコスト・センターとして自動的にSSAエンティティに関連付けられます。コスト・センターを割り当てる方法については、第43.2.7項を参照してください。チャージ・プランを割り当てる場合、ゾーンに割り当てるプランは、他のプランを割り当てられていないゾーン内のすべてのメンバーに適用されます。チャージ・プランを割り当てる方法は、第43.2.8項を参照してください。

43.2.3 チャージバックに関するグローバル設定の構成

「ホーム」タブの「設定」サブタブをクリックして、通貨記号および稼働時間計算のグローバル設定を構成します。

通貨記号

通貨記号のテキスト・ボックスをクリックし、目的の通貨記号を入力して、デフォルトの通貨(USD)を変更できます。新規に選択した通貨は、すべてのチャージ・プラン(ユニバーサル・プランおよびすべての拡張チャージ・プラン)全体のデフォルトの通貨になります。新規の通貨は、履歴レポートを含め、すべてのレポートに反映されます。通貨を変更しても通貨換算は行われません。つまり、数値は同じ状態のままです。ドルからユーロに変更すると、1ドルのチャージは1ユーロのチャージになります。

稼働時間の計算

該当するラジオ・ボタンを選択して、チャージの計算に稼働時間を含めるか無視します。デフォルトでは、稼働時間を考慮事項に含めます。稼働時間を含めると、すべてのエンティティの固定および構成ベースの全チャージの計算に影響します。

チャージバックでは、チャージと割引をそれ相応に按分します。このため、たとえば、エンティティが24時間のうち22.5時間使用可能な場合、日次チャージは1.5時間調整されます。稼働時間設定の変更は、現在のレポート・サイクルの初めから有効になりますが、前のレポート・サイクルには影響しません。すなわち、履歴レポートのチャージが、現在のサイクルの設定に加えられた変更に基づいて比例配分されることはありません。

「保存」をクリックして設定を更新します。

例

稼働時間を計算に入れる場合の差異を示すために、次のチャージ・プラン構成を考えます。

- GBのメモリー割当てごとに1日2ドル、およびGBの記憶域ごとに1日1ドルをチャージし、CPU使用率にはチャージしないユニバーサル・チャージ・プラン

- 基本チャージが1時間1ドルでx5のメモリー割当て調整を行う、ゲストVM (中規模)用の拡張チャージ・プラン

これらのチャージ・プランで、あるユーザーが4 GBのメモリーおよび100 GBのディスク領域を持つゲストVMを2日連続で依頼するとします。初日の稼働時間メトリック・レコードは20時間で、2日目は24時間でした。

稼働時間を計算に入れない場合、1日当たりのチャージは164ドルです。次のように計算されます。

- メモリーに1日当たり4ドル(4 GB* $2 * 5)

- 記憶域に1日当たり100ドル(100 GB * $1)

- 基本チャージは1日当たり24ドル(24 hours * $1)

稼働時間を計算に入れる場合、1日当たりのチャージから4時間の停止時間を引いて(20/24 * 164)、初日のチャージは137ドル(切上げ)になります。

43.2.4 チャージ・プランの使用

概要で説明したとおり、チャージ・プランには、ユニバーサル・チャージ・プランと拡張チャージ・プランの2つのタイプがあります。

ユニバーサル・チャージ・プランは、3つの基本的なメトリック(CPU、メモリーおよび記憶域)に対するレートを設けています。たとえば、1つのCPU (汎用)ごとに1日1ドル、メモリーの1GBごとに週2ドル、記憶域の1GBごとに週1ドルをチャージします。オプションで、CPUアーキテクチャごとに別のレートを適用できます。たとえば、PA-RISC、SPARC、x86のそれぞれに異なるレートでチャージします。ユニバーサル・チャージ・プランのリビジョンを複数作成して、後から使用することが可能です。

拡張チャージ・プランは、ユニバーサル・プランを拡張してエンティティ固有のメトリックを含めたものです。エンティティの特性に関連するチャージの実装が必要な場合があります。拡張チャージ・プランは柔軟性をもたらします。エンティティ・タイプによって、レートをチャージできるアイテムが決定されます。

特定のエンティティ・タイプでの使用に適したチャージ・プランを定義する場合、CPU、メモリー、記憶域の3つの基本メトリックでリソースの使用を十分にチャージできるかどうかを、ケースバイケースで判断する必要があります。そうできない場合、エンティティ・タイプに拡張プランを定義する必要があります。

いずれの場合も、一般的な目的でユニバーサル・チャージ・プランを定義できます。その後、拡張チャージ・プランで、ユニバーサル・プランのレートを適用する方法を示すことができます。

拡張チャージ・プランは、エンティティ・タイプ固有のチャージ・アイテムのグループで構成されます。次のエンティティ・タイプで、エンティティ固有のチャージ・テンプレートを使用できます。

- Host

- Oracle WebLogic Server (J2EEアプリケーションを含む)

- Oracle VMゲスト

- データベース・インスタンス(データベース・サービスを含む)

- プラガブル・データベース(PDB)

- スキーマ・サービス

チャージ可能なアイテムと適用されるレート調整は、エンティティ・タイプによって異なります。

拡張プランでは、エンティティ固有のチャージ・アイテムをチャージのベースにすることができます。たとえば、Windows OSが実行するホスト、またはパーティショニング・オプションがインストールされているデータベースに対する追加のチャージを要求できます。さらに、構成または使用ベースのアイテムといった、固定チャージも可能です。たとえば、消費量に関わらず、各ホストに対して1か月100ドルをチャージします。

拡張プランでも、指定されたエンティティ・タイプで使用可能なチャージ・アイテムが、特定のニーズを満たさない場合があります。この場合は、CLI動詞を使用して、カスタム・チャージ・アイテムを導入できます。詳細は、第56章「EMCLI動詞によるチャージバックとメータリング」を参照してください。

この項の内容は次のとおりです。

- チャージ・プランおよび有効日

- ユニバーサル・チャージ・プランの作成および修正

- 拡張チャージ・プランの作成

- チャージ・アイテム・メタデータの表示

- チャージ・プランでの条件の使用

- 拡張チャージ・プランの修正

43.2.4.1 チャージ・プランおよび有効日

チャージ・プラン(ユニバーサルまたは拡張)を作成する際には、プランの有効日(常に月の初日)を確定します。プラン・リビジョンは、新しいプラン・リビジョンが作成されるまで使用されますが、このプラン・リビジョンの有効日が前のプラン・リビジョンの終了を決定します。

たとえば、四半期ごとに新しいプラン・リビジョンが有効になる、カレンダ年のチャージ・プランを設定するとします。1月1日に有効になる最初のプラン・リビジョンを作成します。プランの有効日は、「Jan. 1, yyyy - 以降」と表示されます。4月1日に有効になるプラン・リビジョンを作成します。最初のプラン・リビジョンの有効日が「Jan. 1, yyyy - Mar. 31, yyyy」になり、新しいプラン・リビジョンの有効日が「Apr. 1, yyyy - 以降」と表示されます。プラン・リビジョンをさらに2つ作成し、1つの有効日を7月1日に、もう1つの有効日を10月1日にします。これで、有効日が次の日付のプラン・リビジョンが4つになります。

- Jan. 1, yyyy - Mar. 31, yyyy

- Apr. 1, yyyy - Jun. 30, yyyy

- Jul. 1, yyyy - Sep. 30, yyyy

- Oct. 1, yyyy - 以降

現在および将来のプラン・リビジョンのみが、「チャージ・プラン」ナビゲーション・ペインに表示されます。期限切れのプラン・リビジョンを取得するには、「表示」メニューから「履歴リビジョン」を選択します。

43.2.4.2 ユニバーサル・チャージ・プランの作成および修正

ユニバーサル・チャージ・プランは次のようにして設定します。

1. 実行方法はリビジョン日によって異なります。

- 「ユニバーサル・チャージ・プラン」の有効日が過去から始まる場合、ナビゲーション・ペインでリビジョンを選択し、「作成」メニューから「リビジョン」を選択します。

- 「ユニバーサル・チャージ・プラン」の有効日が現在または将来の場合、ナビゲーション・ペインでリビジョンを選択し、「レートの設定」をクリックします。

2. 表示されるダイアログで、リビジョンの有効日を選択します。現在使用されているレートへの変更は、サイクルの初めに遡って適用されます。「OK」をクリックします。

3. チャージ・プラン・エディタで、3つの基本メトリックに対してレートおよびチャージ頻度を設定します。
行を選択してレートを入力し、ドロップダウン・メニューから頻度を選択します。

ここで設定するレートは現在の月の始めから有効になり、それよりも前の月には影響しません。

4. 必要に応じて、異なるCPUアーキテクチャに追加入力を行います。

1. 「追加」ボタンをクリックします。

2. ドロップダウン・メニューからCPUを選択し、「OK」をクリックします。

3. 表に追加された新しい行にレートを入力し、ドロップダウン・メニューからチャージ頻度を選択します。

5. 実行したら、右上にある「保存」ボタンをクリックして、ユニバーサル・チャージ・プランのリビジョンを完了します。

43.2.4.3 拡張チャージ・プランの作成

拡張チャージ・プランは次のようにして設定します。

1. 「作成」メニューから、「プラン」を選択します。チャージ・プラン・エディタが表示されます。

2. プランの名前を入力します。名前は一意にする必要がありますが、プランから日付ベースの複数のリビジョンを作成できます。

3. 「追加」をクリックします。「エンティティ・タイプの追加」ダイアログが開きます。

4. サポート対象のエンティティ・タイプのリストから選択します。1つのプランで複数のエンティティ・タイプに対応できるため、ダイアログで複数選択することが可能です。「OK」をクリックします。
1つの構成(デフォルト)が示された状態で、選択したエンティティ・タイプが表に表示されます。

5. 「構成の設定」をクリックして「構成の設定」ダイアログを表示し、「追加」をクリックして「構成の追加」ダイアログを開きます。

選択したエンティティ・タイプの構成を設定する条件を追加します。使用できる条件のリストは、エンティティ・タイプから取得されます。一覧から演算子を選択し、条件値を設定します。値を指定して条件値をリストから選択するか、検索アイコンをクリックしてその他の値を検索できます。

たとえば、ホスト・エンティティ・タイプのマシン・アーキテクチャ(sparc sun4uとAMD64の2つのオプションがある)の条件を設定するとします。必要に応じて「上に移動」および「下に移動」ボタンを使用して、一致する条件の優先順位を設定できます。

構成設定が完了したら、「OK」をクリックします。

図43-2に示すように、チャージ・プラン表には、条件構成と、「その他」というデフォルト構成に関する別の列が表示されます。

図43-2 エンティティ構成の設定

構成に設定できる条件は1つのみであることに注意してください。条件を、VMゲストのマシン・サイズから高可用性に変更するとします。これを実行するには、「構成の設定」ダイアログを開き、マシン・サイズの条件アイテムを削除します。「追加」をクリックすると、高可用性の条件アイテムが使用可能になっています。

6. 「アイテムの追加」をクリックして、「アイテムの追加」ダイアログを開きます。このダイアログは、請求目的のエンティティ・タイプに基づいてチャージ・アイテムを追加するために使用します。

ドロップ・ダウン・リストからチャージ・アイテムを選択します。アイテムのリストはエンティティ・タイプから取得されます。特定のアイテムには、ドロップダウン・リストからフラット・レート、単位別などのチャージ・タイプを選択できます。手順5の構成と同じように、条件も設定できます。サービスによって計測されるデータベースの場合、チャージはサービス単位です。J2EEアプリケーションによって計測されるWebLogic Serverの場合、チャージはアプリケーション単位です。選択して「OK」をクリックします。

チャージ・プラン表に、追加したチャージ・アイテムの行が表示されます。各構成に対して列が1つ表示されます。「ヘルプ」アイコンをクリックして、チャージ・アイテムの説明をポップアップで表示します。

7. チャージ・アイテムの行でレートを指定し、各構成の頻度を選択します。たとえば、SPARCアーキテクチャにユニット当たり1ドル/週、AMDアーキテクチャにユニット当たり0.50ドル/週、その他すべてのアーキテクチャに週当たり0.75ドル/ユニットを請求するエンティティ・タイプ・ホストのCPU数チャージ・アイテムを追加したとします。図43-3に示すように、それぞれの列に適切に入力します。

図43-3 チャージ・アイテムへの条件の設定

8. エンティティ・タイプに追加のチャージ・アイテムを含めるには、手順6および7を繰り返します。

9. オプション。この拡張チャージ・プランのユニバーサル・チャージ・プラン基本メトリックに対してレート調整を行います。基本レートの係数を指定することにより、調整を行います。デフォルトは1で、一般的な基本レートを表します。このため、たとえば、1.5と入力して率を50パーセント上げたり、.5と入力して率を50パーセント下げます。ユニバーサル・プラン・レートをすべて無視する場合は、0を入力します。
メトリックのレート係数を開いて、実際のチャージを確認します。たとえば、メモリー割当てのレート調整が1.5で、レートが月に2ドルの場合、調整されたレートは月に3ドルになります。

エンティティ・タイプに使用可能なメトリックは、レート調整が可能かどうかを決定します。たとえば、J2EEアプリケーションによって計測されるWebLogic Serverに対してレート調整を行うことはできません。

たとえば、前述の例のCPUレートについて、AMDアーキテクチャに対しては75パーセントに調整し、SPARCに対しては125パーセントに調整し、その他についてはそのままにするとします。図43-4に示すように、適切に入力します。

図43-4 カスタマイズされたチャージ・アイテムを示す拡張プラン

10. 実行したら、右上にある「保存」ボタンをクリックして、エンティティ・タイプの拡張チャージ・プランのリビジョンを完了します。
適切なエンティティ・タイプのエンティティ・インスタンスに拡張チャージ・プランを割り当てることができます。拡張チャージ・プランは、月の始めから自動的に有効となることを忘れないでください。

43.2.4.4 チャージ・アイテム・メタデータの表示

チャージ・アイテム・ライブラリにより、チャージバック・インストール内で既知のチャージ・アイテムに関する詳細情報を一目で確認できます。これには、既知のEnterprise Managerターゲット・タイプに加えて、インテグレータによって導入されたカスタム・エンティティ・タイプのすべてのチャージ・アイテムが含まれます。

多くの場合、チャージ・アイテムはそのとおり(使用されるメモリーの量)に受け取ることができます。ただし、それほど明確ではない場合もあります。データベース・メモリー使用のチャージは、割り当てられたSGAメモリーと使用されるメモリー量のどちらについて計算されますか。CPU時間またはDB時間の使用量を判断するために使用される基になるメトリックまたは構成は何ですか。このようなケースでは、使用値はチャージの計算に使用される式またはカスタマイズされた問合せの一部にすぎません。任意のイベントで、拡張チャージ・プランを作成する際に使用可能な詳細情報を利用できます。

1. 「Enterprise」メニューで、「チャージバック」を選択し、「チャージ・プラン」タブをクリックします。

2. チャージ・アイテム・ライブラリ・アイコンをクリックします。
チャージ・アイテム・メタデータ・ブラウザが開き、すべての既知のチャージ・アイテムの表が表示されます。

3. オプション。「表示」メニューから「列」を選択し、表示を変更したり、関心がありそうな非表示の列を表示させたりします。

4. オプション。「エクスポート」をクリックして、スプレッドシート内のチャージ・アイテムのメタデータ・コンテンツを保存します。

チャージ・アイテムのメタデータを表示する際は、次の点を考慮してください。

- 情報は、エンティティ・タイプ別に編成されます。

- リソース・カテゴリは、チャージバックがチャージ・アイテムを整理するために使用する内部バケットです。

- ソース・タイプは、使用ベース、構成ベース、または固定としてチャージ・アイテムを示します。

- 「チャージ可能」とは、アイテムに定義できるレートのことです。「チャージ可能」列にチェックがないアイテムには、定義されたレートがありません。たとえば、マシン・アーキテクチャは、チャージ可能アイテムではなく、条件です。

- 「無効」インジケータは、選択した使用モードがエンティティ・タイプに適していないことを意味します。

- 「ユーザー定義」は、カスタム・チャージ・アイテムをデフォルトのチャージ・アイテムと区別します。

- 非アクティブなチャージ・アイテムは新しい計画に追加できませんが、既存の計画で使用できます。これは履歴プランを意味する可能性もあります。

- 「メトリック・グループ」および「メトリック列」は、チャージ・アイテムをEnterprise Managerの収集データにリンクします。詳細は、『Oracle Enterprise Manager Cloud Control管理者ガイド』の「メトリック拡張の使用」の章を参照してください。

43.2.4.5 チャージ・プランでの条件の使用

拡張チャージ・プランの作成時に指定する条件は、相当な柔軟性を生み出します。構成と呼ばれる変動を作成すると、エンティティ構成に基づいて、チャージする一連のレートを決定できるようになります。構成は、仮想マシンのサイズなど、エンティティのプロパティまたは属性をベースにします。たとえばサンプルの拡張プラン(サンプル・チャージ・プランとして識別)では、マシン・サイズに応じて異なるチャージのセットを適用できるように、仮想マシンのサイズに基づいてVMゲスト・エンティティ・タイプの条件を設定します。構成が設定されていない場合のチャージ・プラン自体や、一致する構成条件がない場合のレコードのチャージ・プランなど、暗黙のデフォルト構成もあります。そのため、サンプルの拡張計画には、小、中、大それぞれのマシン・サイズと、デフォルトの「その他」の4つの構成があります。

同様に、個別のチャージ・アイテムに、チャージを適用するかどうかを決定する条件を設定できます。たとえば、「パーティショニング」という条件のセットは、パーティショニングが使用される場合にのみチャージします。

文字列値の範囲と一致するように、文字列ベースのエンティティ・タイプとチャージ・アイテムでLike演算子を使用します。たとえば、すべての11gリリースと一致するように、データベース・インスタンスにLike演算子を設定します(Like 11%)。または、任意の文字列(またはなし)と一致するように、ワイルドカードとして使用します(Like %)。任意の単一文字と一致するように、アンダースコアを使用します(Like _)。バックスラッシュを使用して、ワイルドカード文字をエスケープします(Like \%)。二重バックスラッシュを使用して、エスケープ文字をエスケープします(Like\\%)。

複数の構成がある場合は、条件をどのように適用するかを決定する優先順位を設定する必要があります。ホスト・オペレーティング・システムに基づいて、次のような構成の順序があるとします。

- %Linux%などのOS

- %Linux 6%などのOS

- デフォルト

OSがどのバージョンのLinuxであっても、常に1つ目が優先されるため、2つ目の条件(Linux 6)がテストされることはありません。そのため、チャージの基準が明確にLinux 6 OSになるよう、Linux 6用のテストを最初にする必要があります。

Like演算子と対比して、Equals演算子は、完全に一致する必要があり、ワイルドカードは認識しません。そのため、たとえばEquals 11.2%と指定した場合、11.2.0や11.2.1は一致しません。Equals 11.2.0またはEquals 11.2.1と指定する必要があります。また、すべての文字列の一致では、大/小文字が区別されることに注意してください。Equals UPPERはEquals upperと同じではありません。また、Not Equals演算子を使用すると、特定の文字列値を除外できます。

次の、その他の条件の例を考えます。

- 共有データベースに、RACのノードに基づいてチャージする条件を設定します。

- 専用データベース・インスタンスで、SQL実行チャージ・アイテムを使用して、秒当たりのSQL文の実行に対するチャージ・レートを設定します。

条件を使用すると柔軟性が増します。たとえば、条件なしで多数のチャージ・プランを作成し、エンティティに対して個別に割り当てることができます。または、多数の条件がある単一のチャージ・プランを作成し、これを多くのエンティティに割り当てることもできます。

43.2.4.6 拡張チャージ・プランの修正

次の方法で拡張チャージ・プランを更新できます。

- 現在および将来のサイクルで有効なチャージ・レートに変更を加えます。

- 既存のプランをベースに次またはそれ以降のレポート・サイクルのプラン・リビジョンを作成します。

現在および将来のサイクルで有効なチャージ・レートに変更を加えるには

1. ナビゲーション・ペインでプラン・リビジョンを選択して、「レートの設定」をクリックします。

2. チャージ・アイテムを調整して、レートを有効化します。

3. 「保存」をクリックして、プラン・リビジョンを更新します。

現在のサイクルのチャージ・レートを変更する場合、変更はサイクルの初めに遡って適用されるという警告が示されます。

既存のプランをベースに次またはそれ以降のレポート・サイクルのプラン・リビジョンを作成するには

1. ナビゲーション・ペインでプランを選択して、「作成」メニューから「リビジョン」を選択します。

2. 表示されるダイアログで、リビジョンの有効日を選択します。デフォルトの日付は、直近に追加されたリビジョンの次の月です。たとえば、現在のサイクルが5月分で、6月のリビジョンが存在している場合、デフォルトの有効日は7月1日です。「OK」をクリックします。

3. 使い慣れた類似物作成モデルでは、ナビゲーション・ペインで選択したプランの構成、チャージ・アイテムおよびレート調整が、右側のプランの詳細表に表示されます。
必要に応じて、プランの詳細を編集します。

- エンティティ・タイプを追加および削除します。

- 構成を追加および削除します。

- チャージ・アイテムを追加、変更および削除します。

- メトリック・レートを調整します。

4. 終了したら、「保存」をクリックして、プラン・リビジョンを完了します。

43.2.5 コスト・センターの作成

コスト・センターは、チャージを集計するための手段です。コスト・センターは、個人、組織内の部門または企業全体にチャージを分配する複数層のビジネス階層です。コスト・センターを設定し、ビジネス・ユニットにユーザーを割り当てることで、ビジネス階層を作成できます。

Enterprise Managerユーザー設定の一部として、管理者をコスト・センターに割り当てることができます。このコスト・センターのプロパティは、デフォルトのコスト・センターのかわりにチャージバックの内の親になります。たとえば、次のようになります。

- 日次データ収集ジョブは、Enterprise Managerの各ユーザーに対するコスト・センターを作成します。コスト・センターがユーザー設定の一部として割り当てられている場合、ユーザーの日次収集コスト・センターの親になります。それ以外の場合は、チャージバックのデフォルトのコスト・センターが、ユーザーの日次収集コスト・センターの親になります。

- コスト・センターは、セットアップ中に自動的にSSAエンティティに割り当てられます。SSAエンティティがチャージバックに追加される前に、コスト・センターがEnterprise Managerユーザー設定の一部としてSSAリクエスタに割り当てられた場合、SSAコスト・センターの親になります。それ以外の場合は、チャージバックのデフォルトのコスト・センターが、SSAコスト・センターの親になります。

Oracleは、チャージバック内のコスト・センター階層を管理する方法として、Enterprise Managerユーザーのコスト・センター・プロパティを使用することをお薦めします。

コスト・センターは、次の方法で生成できます。

- Enterprise Managerユーザーの「コスト・センター」プロパティの設定

- ターゲット・ホーム・ページでのコスト・センター・プロパティの設定

- チャージバックに関する高いレベルのコスト・センターの作成

- LDAPサーバーからのビジネス階層のインポート

43.2.5.1 Enterprise Managerユーザーの「コスト・センター」プロパティの設定

チャージバックを管理するEnterprise Managerのユーザーは、そのアカウント・プロファイルのコスト・センターに割り当てられる必要があります。

1. 「設定」メニューから、「セキュリティ」、「管理者」の順に選択します。

2. 検索して対象の管理者を選択してから「編集」をクリックします。

3. プロパティ・ページで、このユーザーに発生する請求に関連するように、「コスト・センター」プロパティに適切な値を入力します。

4. 確認ページに進み、「終了」をクリックします。

全体的なユーザー・アカウントの作成プロセスの一部として、コスト・センター・プロパティを設定することもできます。

このコスト・センターはチャージバックのデフォルトのコスト・センターに優先されます。

43.2.5.2 ターゲット・ホームページでのコスト・センター・プロパティの設定

セルフ・サービス・アプリケーションの設定中にサーバー・リクエストを作成すると、ターゲット(たとえばVMゲスト)のコスト・センター・ターゲット・プロパティが、リクエストを作成した担当者のユーザー・ログインに自動的に設定されます。チャージバックにエンティティを構成している場合、ユーザー・ログインがインポートされ、「エンティティ」タブのそのエンティティの「コスト・センター」列に表示されます。その親がEnterprise Managerユーザーのコスト・センターです(割り当てられている場合)。それ以外の場合、チャージバックのデフォルトのコスト・センターに割り当てられます。

SSAエンティティのコスト・センターの割当てを変更することはできませんが、第43.2.5.3項で説明されているとおり、必要に応じてSSAユーザーをデフォルトのコスト・センターから別のより適切なコスト・センターに再割当てすることができます。

同様にチャージバックにエンティティが構成されている場合は、エンティティのコスト・センター・ターゲット・プロパティを適切な値(ユーザーID)に手動で設定すると、その後、この値はインポートされて、「エンティティ」タブの「コスト・センター」列に表示されます。その親がEnterprise Managerユーザーのコスト・センターです(割り当てられている場合)。それ以外の場合、ユーザーIDがチャージバックのデフォルトのコスト・センターに割り当てられ、後で別のコスト・センターに再度割り当てることができます。この方法は、セルフ・サービス以外のエンティティにのみ適していて、チャージバックにエンティティが追加されたときにコスト・センターを自動的に設定する方法を提供します。

この方法でコスト・センターを作成するには

1. すべてのターゲット・ページで問題のターゲットを選択して、ターゲット・ホーム・ページに移動します。

2. ターゲット・タイプのメニューから、「ターゲット設定」、「プロパティ」の順に選択します。

3. 「編集」をクリックして「コスト・センター」プロパティの値を入力し、「OK」をクリックします。
ターゲットにチャージバックを構成している場合、説明したとおりに値が表示されます。

チャージバックにすでに追加されているエンティティの「コスト・センター」プロパティを変更した場合、新しい値は認識されません。

43.2.5.3 チャージバックに関する高いレベルのコスト・センターの作成

セルフ・サービス・ポータルを使用してエンティティをプロビジョニングするユーザーは、チャージバックにSSAエンティティを追加した結果として、関連付られたEnterprise Managerユーザーのコスト・センターの下に表示されます。Oracle Enterprise Managerユーザーのコスト・センターが割り当てられていない場合、SSAユーザーは、チャージバックのデフォルト・コスト・センターの下に表示され、次のプロセスのステップ4に示すように、ユーザーは後で適切なコスト・センターに再割当てできます。また、再割当ては、LDAPを使用して自動化することもできます。

コスト・センターを手動で作成するには:

1. 「エンタープライズ」メニューから「チャージバック」を選択します。

2. 「コスト・センター」タブを選択し、「追加」ボタンをクリックします。

3. 「新規コスト・センター」ダイアログに、適切な情報を入力します。

- コスト・センターには、システム内部で一意に識別できる名前があります。

- コスト・センターには、ユーザー・インタフェースや生成されたレポートに表示される意味のわかりやすい名前もあります。

- ツリー階層内のコスト・センターの位置、つまり、ルートなのか、ネストされるのかを示します。それに続き、階層内の位置を変更できます。

「OK」をクリックすると、新規コスト・センターが表に示されます。

4. コスト・センターは一般に、ビジネス組織に相当します。コスト・センター行を選択すると、組織に含まれるユーザーが下の領域に表示されます。ユーザーを割当て解除することもできます。
ユーザーが作成するコスト・センターの他に、未割当てユーザーの決済機構として機能するシステムのデフォルトのコスト・センターもあります。これには次のものがあります。

- セルフ・サービス・ユーザー。つまり、SSAを設定する個人のユーザー・ログインで、それ以外に、Enterprise Managerユーザーのコスト・センターが割り当てられていないユーザー

- ターゲットのホーム・ページでコスト・センターのターゲット・プロパティとして指定され、それ以外に、Enterprise Managerユーザーのコスト・センターが割り当てられていないユーザー

これらのユーザーを再割当てして、チャージを上位のコスト・センターにロールアップできます。

1. まず、「コスト・センター」表でデフォルトのコスト・センターを選択します。これにより、デフォルトのコスト・センターに割り当てられているユーザーが公開されます。

2. 次に、「ユーザー」表でユーザーを選択します。

3. アクティブになった「コスト・センターへの割当て」ボタンをクリックします。

4. 開かれたダイアログでユーザーを割り当てるコスト・センターを指定して、「OK」をクリックします。
ユーザーが指定されたコスト・センターに表示されます。

5. コスト・センター・リストが大きくなるにつれて、コスト・センターを、たとえばマーケティングごとの売上などで結合する場合があります。そのためには、コスト・センター行を選択し、「アクション」メニューから「移動」を選択します。変更は、現在のレポート・サイクルの最初から有効になります。
開かれたダイアログで、ネストされたコスト・センターを含めるかどうかを指定し、コスト・センターをツリーのどこに移動するかを選択して、「OK」をクリックします。

6. ある時点で、コスト・センターを非アクティブ化する場合があります。これを行うには、コスト・センターの行を選択し、「削除」ボタンをクリックします。ネストされたコスト・センターも非アクティブ化するかどうかを示します。変更は、現在のレポート・サイクルの最初から有効になります。非アクティブ化とは、コスト・センターをエンティティに割り当てることはできなくなったが、エンティティとの関連付けは前のレポート・サイクルに残ることを意味します。すなわち、前のサイクルのレポートを実行すると、エンティティ割当てが非アクティブ化されたコスト・センターに影響します。

コスト・センターの移動に関する次の点に注意してください。たとえば、コスト・センター(およびそのユーザー)が別の親に移動する場合などです。

- エンティティ・リソースのユーザー割当ては同じままです。JDoeに割り当てられたPCはJDoeに割り当てられたままです。

- 同様に、管理者が割当てを変更していないかぎり、リソース使用量の割当ては同じままです(ただし、レポートのロールアップには新規コスト・センターの親子関係が反映されます)。コスト・センター移動の影響は、コスト・センターおよびユーザーIDに関連する使用量割当ての変更に影響します。

43.2.5.4 LDAPサーバーからのビジネス階層のインポート

LDAPサーバーからビジネス階層をインポートできます。LDAPサーバーは次のものをサポートしています。

- Oracle Internet Directory

- Microsoft Active Directory

- Sun iPlanet

- Novell eDirectory

- OpenLDAP

1. 「エンタープライズ」メニューから「チャージバック」を選択します。

2. 「コスト・センター」タブを選択します。

3. 「アクション」メニューから「LDAP設定」を選択します。

4. 「LDAP設定」ダイアログが開き、次の値が指定されます。

- ドロップダウン・リストからLDAPサーバー・タイプを選択します(デフォルトはOracle Internet Directory)。

- LDAPサーバーのホスト名を指定します。

- 認証IDとして使用するIDを選択します(ユーザー名または電子メール・アドレスなど、LDAPサーバーが認証に使用する属性)。

- ログインが必要な場合、チェック・ボックスを選択し、資格証明を指定します(cn=orcladminなど、ユーザー名がLDAPサーバーのプリンシパル)。

- LDAPサーバーのポート番号を入力します。

- セキュアな接続のチェック・ボックスを選択します。

- チェック・ボックスを選択して、カスタム検索ベースを入力します(dc=oracle、dc=comなど、ユーザーを格納するベースDN)。

- コスト・センターを保持するレベルを選択します。これは、各レポート・サイクルの最後にLDAPサーバーと同期化するコスト・センター階層内のレベルを示します。LDAP内で指定したレベルより低いレベルは、Chargebackに指定したレベルに含まれます。このため、たとえば、レベル5を指定するときにLDAPに7つのレベルがある場合、LDAPレベル6および7はChargeback内のレベル5に含まれます。
「OK」をクリックします。

LDAPコスト・センターは、手動で作成された同じ名前のコスト・センターを上書きしながら、エンティティ割当てを保持します。エンティティを他のコスト・センターに再割当てすることもできます。

正常にインポートされたLDAPコスト・センター階層により、階層をLDAPサーバー上の階層と同期するために、各レポート・サイクルの最初(通常、月の第1日目)に実行する、スケジュールされた反復可能ジョブが生成されます。「アクション」メニューから「オンデマンドLDAP同期」を選択して、この操作を臨時に実行することもできます。

LDAP同期ジョブは既存のSSAユーザー(SSAエンティティをチャージバックに追加した結果として、すでにチャージバックで認識されているSSAユーザー)のみ同期します。同期ジョブでは、LDAPディレクトリ内のその他(SSAなど)のユーザーを自動的に同期しません。

SSAエンティティがチャージバックに追加される場合、SSAユーザーはデフォルトのコスト・センターに自動的に表示されます。LDAP同期ジョブは、次に、LDAPディレクトリのMANAGER属性によって決定される管理階層構造に基づいて、デフォルトのコスト・センターSSAユーザーをコスト・センター階層に移入します。また、手動で再割当てされたすべてのSSAユーザーのコスト・センターも、同期ジョブによって、同じ管理階層構造に基づいて上書きされます。

43.2.6 チャージバックへのエンティティの追加

リソースをチャージバック内で管理するエンティティを決定します。エンティティを追加し、チャージを計算するメトリックの収集を開始する必要があります。メンバー・インスタンスがチャージバックですでに監視されているReal Application Cluster (RAC)を追加する場合は、まずそれらのインスタンスをチャージバックから削除する必要があります。

特定のデータベース・エンティティ・タイプの場合は、チャージバックにこれらのタイプのエンティティを追加する前に、メトリック収集を有効化する必要があります。

- サービスごとに測定されるデータベース・インスタンス

- サービスごとに測定されるクラスタ・インスタンス

- CDB (単一インストールとRACの両方)

- スキーマ・サービスのプロビジョニングに使用されるプール・データベース、およびPaaSインフラストラクチャ・ゾーンの一部として提供されるプラガブル・データベース・サービス

メトリック収集を有効にする方法の詳細は、第43.2.6.1項を参照してください。

CDBはコンポジット・エンティティです。CDBインスタンスを追加する際は、すべてのプラガブル・データベース(PDB)が自動的に検出され、CDBインスタンスの子としてレポートされます。使用状況とチャージは、PDBレベルで計算されます。

PaaSインフラストラクチャ・ゾーン・エンティティを追加する場合、そのすべてのデータベース(単一インスタンスおよびRAC)、データベース・サービスおよびPDBは、自動的に検出され、ゾーンの子としてレポートされます。使用状況とチャージは、エンティティ・レベルで計算されます。

注意:
チャージバックで追跡されているPaaSインフラストラクチャ・ゾーンのサービスをプロビジョニングするプール・エンティティは、チャージバックでエンティティとして個別に追跡することはできません。そうすると、チャージ・プランの割当てで動作が不定になることがあります。このため、たとえばPaaSインフラストラクチャ・ゾーンの一部であるPDBサービス・エンティティのプール・エンティティとして機能するCDBは、チャージバックにコンポジット・エンティティとしても追加することはできません。

チャージバック・サポートを受けられるEnterprise Managerインスタンスで監視されるエンティティを追加するには、ADD_CHARGEBACK_TARGETロールが割り当てられている必要があります。これがない場合、「エンティティの追加」ボタンは無効になっています。エンティティの追加のプロセスとして、チャージ・プランおよびコスト・センターを割り当てることもでき、MANAGE_CBA_ENTITY_OBJ_PRIV、ASSIGN_CHAREG_PLAN_PRIVおよびASSIGN_CBA_COST_CENTER_PRIVの権限を含める必要があります。

VIEW_CAT_TARGETロールでは、特定のエンティティに関連するチャージバック・データを確認できます。VIEW_ANY_CAT_TARGETロールでは、すべてのエンティティに関連するチャージバック・データを確認できます。

1. 「エンタープライズ」メニューから「チャージバック」を選択します。

2. 「エンティティ」タブを選択し、「エンティティの追加」ボタンをクリックします。
エンティティの追加ウィザードが開き、ここで次の手順を実行します。

1. チャージバックのエンティティの選択

2. 割当ての実行

3. エンティティ設定の確認

測定データが表示されるまで、エンティティのチャージバックへの追加後、最大24時間かかることがあります。エンティティでのデータ収集を中止するには、該当するエンティティを選択し、「エンティティの削除」ボタンをクリックします。

注意:
チャージバック範囲からエンティティを削除すると、使用量およびチャージ・データが現在のレポート・サイクルから削除されます。この操作への警告は、削除プロセスの一部として表示されます。

クラスタ・メンバーの新規サービスが毎日の収集において検出されると、そのサービスはツリー階層のRACノードの下に自動的に表示されます。有効なチャージ・プランが自動的に割り当てられます。それに従ってコスト・センターの割当を行います。

43.2.6.1 Enterprise Managerデータベース・サービスのメトリック収集の構成

Enterprise Managerデータベース・サービスのメトリックの収集は、デフォルトでは次のエンティティ・タイプに対して無効になります。

- データベース・サービスにより計測されるデータベース・インスタンス

- データベース・サービスまたはPDBにより計測されるRAC

- CDB (単一インストールとRACの両方)

- スキーマ・サービスのプロビジョニングに使用されるプール・データベース、およびPaaSインフラストラクチャ・ゾーンの一部として提供されるプラガブル・データベース・サービス

チャージバックがこれらのエンティティでリソースを管理できるようにするには、メトリック収集を有効にする必要があります。

メトリック・データ収集の変更を有効にするには、そのターゲットのMANAGE_TARGET_METRICSロールの割当てが必要です。

1. 「ターゲット」メニューから「データベース」を選択します。

2. 表内でターゲットを特定し、そのホームページを開きます(要求された場合、資格証明を提供します)。

3. 「Oracle Database」メニューから、「監視」を選択し、「メトリックとコレクション設定」を選択します。

4. メトリックとコレクション設定ページで、ビューを「すべてのメトリック」に変更します。

5. 図43-5で示されているとおり、「EMデータベース・サービス」(単純な「データベース・サービス」ではなく)にスクロールし、「無効」をクリックして、有効化プロセスを完了します。

図43-5 データベース・サービスに対するメトリック収集の有効化

RAC内の各クラスタ・メンバーおよびCDBインスタンスに対してこれを実行します。

また、その代替方法として、次のEMCLIコマンドを使用して、対応するデータベース・エンティティ・インスタンスでメトリック収集を有効にすることもできます。

emcli modify_collection_schedule -targetType='oracle_database' -targetNames=target_name1;target_name2 -collectionStatus='ENABLED' -collectionName='DBService' -preview='N';

ここで、target_namenは、該当するデータベース・ターゲット・インスタンスです。

43.2.6.2 チャージバックのエンティティの選択

エンティティの追加ウィザードのステップ1では、チャージバックに追加および該当する場合に使用モードを設定するエンティティを選択します。

特定のデータベース・エンティティ・タイプの場合は、チャージバックにこれらのタイプのエンティティを追加する前に、Enterprise Managerメトリック収集を有効化する必要があります。

- サービスごとに測定されるデータベース・インスタンス

- サービスごとに測定されるクラスタ・インスタンス

- CDB (単一インストールとRACの両方)

- Oracleデータベース・サービスのプロビジョニングに使用されるプール・データベース、およびPaaSインフラストラクチャ・ゾーンの一部として提供されるプラガブル・データベース・サービス

メトリック収集を有効にする方法の詳細は、第43.2.6.1項を参照してください。

1. 「追加」ボタンをクリックします。

2. 開いたダイアログで、追加するエンティティ・タイプを検索します。検索内容をフィルタするには条件を使用します。
データベースをサービス・エンティティ・タイプ(DBaaSまたはSchaaS)として追加するには、「PaaSインフラストラクチャ・ゾーン」エンティティ・タイプを選択します。データベース・サービスおよびPDBは、ゾーンの親の子として表示されます。

注意:
データベース(単一インスタンスおよびRAC)とPaaSインフラストラクチャ・ゾーンのサービス・エンティティをプロビジョニングするCDBエンティティは、チャージバックにエンティティとして自身を追加できません。そうすると、チャージ・プランの割当てで動作が不定になることがあります。

3. 検索結果のリストで、追加する特定のエンティティを選択します。複数のエンティティを選択できます。「選択」をクリックします。
ダイアログが閉じ、進捗状況インジケータに関連エンティティの検索が示されます。選択されたエンティティが表に表示されます。コンポジット・エンティティの場合、そのメンバーが「メンバー」列に表示されます。メーター・フラグは、エンティティに対してメトリックおよび構成データが収集されていることと、チャージの計算に使用されていることを示します。したがって、たとえばデータ収集はWebLogicサーバー・レベルで発生するため、メーター・フラグはWebLogicドメインに対して設定されません。

4. オプション。測定を実行する方法の宣言に該当する場合は、デフォルト以外の使用モードを設定します。
ドロップダウン・リストから、使用モードを選択します。選択肢は、エンティティのタイプによって異なります。選択肢が「メーター制」の1つしかない場合があります。たとえば、データベースの場合は、次の3つの選択肢を提供します。「データベース・インスタンスによる計測」、「サービスによる計測」、「PDBによる計測」です。

5. 「次へ」をクリックして、チャージ・プランとコスト・センターの割当てを行います。

43.2.6.3 割当ての実行

エンティティの追加ウィザードのステップ2では、チャージ・プランとコスト・センターの割当てを行います。

チャージ・プランは、リソース消費のコストを計算するための基準を提供します。

1. 表でエンティティを選択して、「プランの割当て」ボタンをクリックします。

2. 開いたダイアログで、エンティティの選択内容に適したユニバーサルまたは拡張チャージ・プランを選択して、「OK」をクリックします。ダイアログが閉じ、エンティティ表の行にプランの割当てが表示されます。

今はチャージ・プランを割り当てず、チャージバックにエンティティを追加した後に割り当てることも選択できます。詳細は、第43.2.8項を参照してください。

コスト・センターを使用すると、リソース消費に対して発生したチャージを集計できます。

1. 表でエンティティを選択して、「コスト・センターの割当て」ボタンをクリックします。

2. 開いたダイアログで、エンティティの選択内容に適したコスト・センターを選択して、「OK」をクリックします。
ダイアログが閉じ、エンティティ表の行にコスト・センターの割当てが表示されます。

今はコスト・センターを割り当てず、チャージバックにエンティティを追加した後に割り当てることも選択できます。詳細は第43.2.7項を参照してください。

終了したら「次へ」をクリックしてエンティティの設定を確認し、チャージバックへのエンティティの追加タスクを完了します。

43.2.6.4 エンティティ設定の確認

エンティティの追加ウィザードのステップ3では、タスクを完了する前に、選択内容と割当てを確認できます。問題ない場合は、「発行」をクリックします。

「エンティティ」タブに戻り、メッセージで、n個のエンティティが正常に追加されたことを確認します。エンティティが追加された後の動作の詳細は、第43.2.6項の3つのウィザード手順以降の段落を参照してください。

43.2.7 エンティティへのコスト・センターの割当て

コスト・センターは、リソース使用率にチャージを分散する方法です。コスト・センターは、SSA設定の一部としてSSAエンティティに自動的に割り当てられます(コスト・センター・ターゲット・プロパティ)。この手動プロセスは、コスト・センターをSSA以外のエンティティに割り当てる場合にのみ使用します。

注意:
エンティティをチャージバックに追加するときに、コスト・センターの割当てを実行することもできます。第43.2.6.3項で説明されているエンティティの追加ウィザードのステップ2を参照してください。

1. 「エンタープライズ」メニューから「チャージバック」を選択します。

2. 「エンティティ」タブを選択します。

3. コスト・センターを割り当てるエンティティを選択して、「コスト・センターの割当て」ボタンをクリックします。

4. コスト・センターのリストが表示されたダイアログが開きます。エンティティのコスト・センターを選択し、「OK」をクリックします。
エンティティ割当ての表がリフレッシュされ、割当てが反映されます。

チャージが計算されると、未割当てのエンティティはデフォルトのコスト・センターに割り当てられます。コスト・センターをコンポジット・エンティティに割り当てると、コンポジット・エンティティに直接マップされ、直接割り当てられたコスト・センターがない場合は、子に割り当てられます。

影響を受けるグループ・メンバーについて、「エンティティ」タブに示されているように、あるコスト・センター割当てを持ち、別コスト・センター割当てを持つ別のグループのメンバーであるグループ・メンバーは競合します。グループ・メンバーがグループと同じように通常のターゲット階層に含まれることもあります。たとえば、データベース(DB1)が、ゾーン(PaaSゾーン1)の下とグループ(グループ1)の下に表示されるとします。この場合、チャージの計算は続行されますが、チャージが適切なコスト・センターに対して発生しても、管理者が競合を解決するまではデフォルトのコスト・センターにチャージされます。

RACノードの下の共有サービスは、異なるコスト・センターに割当てできます。

注意:
SSAを介してリクエストされプロビジョニングされるエンティティの場合、コスト・センター・ターゲット・プロパティはユーザー・ログインに設定されます。SSAユーザーは、チャージバックにSSAエンティティを追加した結果として、関連付られたEnterprise Managerユーザーのコスト・センターの下に表示されます。Enterprise Managerユーザーのコスト・センターが割り当てられていない場合、SSAユーザーは、チャージバックのデフォルト・コスト・センターの下に表示されます。SSAエンティティのコスト・センターの割当てを変更することはできませんが、第43.2.5.3項で説明されているとおり、必要に応じてSSAユーザーをデフォルトのコスト・センターから別のより適切なコスト・センターに再割当てすることができます。

コスト・センターを割当て解除するには、該当するエンティティを選択して「アクション」メニューから「コスト・センターの割当て解除」を選択します。

43.2.8 エンティティへのチャージ・プランの割当て

エンティティにチャージ・プランを割り当てる場合、子メンバーに個別にプランを割り当てたり、祖先レベルで割り当てて、割り当てられたプランを子メンバーに継承させることができます。

拡張チャージ・プランには、割当て済エンティティにユニバーサル・チャージ・レートを適用する方法を示すパラメータが含まれています。ユニバーサル・プランをエンティティに再割当てして、拡張プランを置き換えることもできます。

SSAエンティティ(ゾーン)の場合、SSA設定を実行する担当者が設定の一部としてチャージ・プランをゾーンに割り当てて、ゾーン内のすべてのエンティティがそのプランを継承します。

注意:
チャージ・プランの割当ては、エンティティをチャージバックに追加するときでも実行できます。第43.2.6.3項で説明されているエンティティの追加ウィザードのステップ2を参照してください。

1. 「エンタープライズ」メニューから「チャージバック」を選択します。

2. 「エンティティ」タブを選択します。割当て済コスト・センターおよびチャージ・プランを示すエンティティの階層リストが表示されます。

3. チャージ・プランを割り当てるエンティティを選択して、「プランの割当て」ボタンをクリックします。

4. 選択したエンティティ・タイプのみに適用されるプランのリストを表示しているダイアログが開きます。割り当てるプランを選択し、「OK」をクリックします。
エンティティ割当ての表がリフレッシュされ、割当てが反映されます。

チャージ・プランをコンポジット・エンティティに割り当てると、コンポジット・エンティティに直接マップされ、直接割り当てられたプランがない場合は、暗黙的に子に割り当てられます。

影響を受けるグループ・メンバーについて、「エンティティ」タブに示されているように、あるプラン割当てを持ち、別プラン割当てを持つ別のグループのメンバーであるグループ・メンバーは競合します。グループ・メンバーがグループと同じように通常のターゲット階層に含まれることもあります。たとえば、データベース(DB1)が、ゾーン(PaaSゾーン1)の下とグループ(グループ1)の下に表示されるとします。この場合、計算が再開されても、管理者が競合を解決するまでは、エンティティのチャージは計算されません。レポート・サイクルのクローズ前に解決されないと、チャージが計算できなくなります。

RACはデータベース・インスタンス、データベース・サービスまたはPDBで計測できます。各RACメンバーがツリー階層のRACノードの下に表示され、異なるチャージ・プランや異なるコスト・センターに割り当てることができます。

チャージ・プランを割当て解除するには、該当するエンティティを選択して「アクション」メニューから「プランの割当て解除」を選択します。

43.2.9 エンティティ・タイプのデフォルトのチャージ・プランの設定

チャージバックにエンティティを追加するプロセスの一環として、エンティティ・タイプのデフォルトのチャージ・プランを設定するオプションがあります。このため、そのタイプのエンティティを追加するかエンティティが検出されるたびに、指定したプランが自動的に割り当てられます。チャージ・プランの可用性は、少なくとも1つの拡張チャージ・プランが特定のエンティティ・タイプに対して作成されていることを前提とします。ユニバーサル・チャージ・プランは、すべてのエンティティ・タイプに対して使用可能です。

1. 「Enterprise」メニューで、「チャージバック」を選択し、「エンティティ」タブをクリックします。

2. 「アクション」メニューで、「デフォルト・プランの設定」を選択します。

3. エンティティ・タイプ行をクリックすると、「デフォルト・プラン」列にドロップダウン・コントロールが表示されます。

4. ドロップダウン・リストからプランを選択します。

5. デフォルト・プランの設定が終了したら、「OK」をクリックします。
デフォルトのプランが設定されているエンティティを追加すると、エンティティの追加ウィザードで「割当ての作成」ステップに進んだときに、プランが自動的に「チャージ・プラン」列に表示されます。

デフォルト・チャージ・プランについて次の点に注意してください。

- 後でデフォルト・プランが割り当てられているエンティティのチャージ・プラン割当てを変更できます。

- デフォルトとして指定されたチャージ・プランは、デフォルト・ステータスから削除されるまで削除できません。

- デフォルトの割当ておよびプランの継承は異なることがあります。デフォルトのプランがWebLogicドメインおよびWebLogic Serverエンティティ・タイプに対して設定されている、次のシナリオを考えてみます。

- WebLogic Serverを含むWebLogicドメインを追加します。デフォルトのプランがドメイン・レベルでのみ割り当てられます。

- これまでWebLogicドメインが追加されていないWebLogic Serverを追加します。デフォルトのプランがWebLogic Serverに割り当てられます。

- 以前にWebLogicドメインが追加されたWebLogic Serverを追加します。デフォルトのプランはWebLogic Serverに割り当てられません。

43.2.10 日次データ収集ジョブの実行

チャージバックの日次データ収集は、情報が1つのソースから抽出され、適切な形式に変換され、リポジトリにロードされる、ETL(抽出、変換、ロード)プロセスです。

Enterprise Managerは、エンティティに関するメトリックおよび構成情報を収集し、管理リポジトリに格納します。これらの収集は、様々な頻度で行われます。チャージバックにエンティティが追加されると、アプリケーションはリポジトリからデータを抽出して、チャージバック専用表で使用するために変換します。このデータを抽出および変換するプロセスは、チャージバック・データ収集プロセスで、24時間ごとに実行するようにスケジュールされています。チャージバックでは様々なデータ変換を実行し、履歴データ参照を提供する必要があるため、独自のデータ収集表が保持されます。

24時間サイクルの場合、すべてのチャージバック・アクティビティが即座に明白になるわけではありません。たとえば、コスト・センター割当てを変更した場合、レポートに変更が表示されるまでに最大24時間かかることがあります(次のデータ収集ジョブが実行されるまで)。このサイクルを回避する場合、オンデマンドで収集ジョブを実行して、即座に表を更新できます。

1. 「エンタープライズ」メニューから「チャージバック」を選択します。

2. 「エンティティ」タブを選択します。

3. 「アクション」メニューから、「オンデマンド・データ収集」を選択します。
チャージバック・データ収集表が、直近のアクティビティを反映するために更新されます。

ジョブのスケジュールを確認するには、次の手順を実行します。

1. 「エンタープライズ」メニューから「ジョブ」、「アクティビティ」の順に選択します。

2. ジョブ・アクティビティ・ページで「拡張検索」をクリックします。

3. 「拡張検索」リージョンで、「ジョブ・タイプ」ドロップダウン・リストから「チャージバック・データ・ローダー」を選択し、「実行」をクリックします。

4. 次にスケジュールされているジョブ実行の「スケジュール済」列を確認します。

ジョブのスケジュールを変更しないでください。

アップグレードの考慮事項

データベースまたはWebLogic Server共有ターゲットが存在する環境でチャージバックを12.1.0.5から12.1.0.6にアップグレードした場合、オンデマンドで日次データ収集ジョブを実行するまで(またはジョブがスケジュールどおりに実行されるまで)「エンティティ」および「レポート」タブは適切に表示されません。ジョブが実行されると、共有コンポーネントは、新しいリリースに従って独自のコスト・センターおよびチャージ・プランに割当て可能なチャージバック・エンティティになることに注意してください。

43.3 チャージバック情報へのアクセス

チャージバック・データ収集サイクルが完了したら、様々な方法で情報の解析を開始できます。この項の内容は次のとおりです

- 使用状況およびチャージの傾向の追跡

- エンティティの収集済メトリック・データの表示

- チャージバック・レポートの生成と配布

- セルフ・サービス・ポータルでのチャージバック情報の表示

- 他のアプリケーションとのチャージバック・データの共有

43.3.1 使用状況およびチャージの傾向の追跡

チャージ・プランを定義し、コスト・センターを設定して、エンティティの監視を開始すると、使用状況およびチャージの傾向が表れます。傾向レポートは、定義済期間のメトリックまたはチャージの傾向を示し、チャージが時間経過とともにどのように変化するかを確認したいエンド・ユーザーにとって役立ちます。また、IT部門にとっても、キャパシティ・プランニング用として役立ちます。

「ホーム」タブに、時間の経過に伴う使用状況やチャージの傾向を示す棒グラフが表示されます。それぞれの傾向リージョンの右上隅には、表示をカスタマイズするダイアログを開く「オプション」リンクがあります。

使用状況傾向オプション

使用状況の傾向の表示をカスタマイズするには、次の手順に従います。

- 期間–使用状況の傾向を図示する期間を選択します(デフォルトは今年1年)

- 集計–選択した期間内で、使用状況をどのようにグループ化するかを選択します(デフォルトは月ごと)

- 使用状況値タイプ–使用状況をパーセント(使用率)または消費量を示す値として表示します(デフォルトは使用率)

- リソース–使用状況を特定のメトリック(CPU、メモリー、記憶域)ごとに表示します(デフォルトは3つのメトリック)

図43-6は、毎日集計された前週のCPU、ディスク、メモリーの使用率の傾向を示しています。

図43-6 使用率の傾向グラフのサンプル

チャージ傾向オプション

チャージの傾向の表示をカスタマイズするには、次の手順に従います。

- 期間–チャージの傾向を図示する期間を選択します(デフォルトは今年1年)

- 集計–選択した期間内で、チャージをどのようにグループ化するかを選択します(デフォルトは月ごと)

- グループ化 - コスト・センターまたはエンティティ・タイプのいずれかでチャージをグループ化します。デフォルト: コスト・センター

- コスト・センター–すべてのコスト・センター、特定のコスト・センターまたは未割当てユーザーのチャージの傾向を表示します(デフォルトはすべて)

図43-7は、毎日集計された前週のVMゲスト・エンティティ・タイプのチャージを示すチャージ傾向です。

図43-7 チャージの傾向グラフのサンプル

43.3.2 エンティティの収集済メトリック・データの表示

エンティティのメトリックは、グラフ・フォームまたはRAWメトリック・データのタイムスタンプ付きレポートとして表示できます。後者のビューは、スプレッドシートなどの外部アプリケーションにエクスポートできます。メトリック収集ステータスを確認することもできます。

後述の指示で参照されるサブタブを公開するには、「エンティティ」タブの下部のメトリック・データ・リージョンを展開する必要があるので注意してください。

1. 「エンタープライズ」メニューから「チャージバック」を選択します。

2. 「エンティティ」タブを選択し、表示するエンティティを選択します。

- エンティティ・リストの下の「メーター・データ(チャート)」サブタブを選択し、エンティティのデータ・メトリックの波グラフを表示します。右側のドロップ・ダウン・リストから表示するメトリックを選択します。メトリックの選択はエンティティ・タイプによって異なります。J2EEアプリケーションによって計測されるWebLogic Serverの場合、メトリックはアプリケーションごとになります。サービスによって計測されるデータベースの場合、メトリックはサービス関連になります。RACの場合、メトリックはクラスタ・メンバーによってグループ化された複数行グラフとして表されます。各行は、選択したサービスに対する特定のメンバーによる使用状況にマップされます。

- 「メーター・データ(表)」サブタブを選択して、RAW番号を表示します。このビューでは、データをフィルタ処理し、CSV形式ファイルにエクスポートできます。対象を別のエンティティに変更することもできます。RACの場合、ビューではRAC内のすべてのクラスタ・メンバーに対して同じサービス・データが表示されます。

- 「収集のステータス」サブタブを選択して、エラー数、メトリック・データが最後に収集されたタイミングなど、統計データを収集します。RACの場合、選択したサービスに関係なく、収集のステータスはRAC内のすべてのクラスタ・メンバーが対象です。

- 「問題」サブタブを選択して、データ収集プロセスなど、選択したエンティティに関連する問題を表示します。サマリー・エントリはインシデント・マネージャに直接リンクしており、問題および考えられる解決策の詳細を表示することができます。サービス・リクエスト(SR)番号が表示されます(割り当てられている場合)。「ホーム」タブには、チャージバック全体に関連する問題が表示される「問題」サブタブもあります。同様に、ここには、インシデント・マネージャへの直接リンクもあります。

注意:
インシデント・マネージャ内で、問題とその関連インシデントのライフサイクルを表示、追跡および管理できます。サポート・ワークベンチでは、問題をさらに調査してレポートできます。サポート・ワークベンチで問題の詳細を表示するには、チャージバック管理者は、すべてのホストおよびOracle Management Serviceに関連付けられた管理エージェントに対する完全な権限を持っている必要があります。

- チャージの詳細行に表示するヘルプ・アイコンをクリックすると、該当するチャージ・アイテムの説明がポップアップで表示されます。

図43-8は、選択したエンティティの16日間のインスタンス稼働時間を追跡するグラフを示しています。

図43-8 エンティティのメトリック・データのサンプル

ジョブ・アクティビティ・ページで、その他の詳細を確認できます。

1. 「エンタープライズ」メニューから「ジョブ」、「アクティビティ」の順に選択します。

2. 「拡張検索」をクリックして、次のフィルタ条件を指定します。

- ジョブ・タイプとして「チャージバック・データ・ローダー」を選択します。

- ターゲット・タイプとして「ターゲットなし」を選択します。

- 「ステータス」および「スケジュール開始」に適切な値を指定します。

3. 「実行」をクリックします。

各ジョブ・ステップのログ出力に、警告または発生したエラーが表示されます。

43.3.3 チャージバック・レポートの生成と配布

チャージバック・サマリー・レポートは、リソース使用率およびチャージ配分を追跡する強力な分析ツールです。これらのサマリー・レポートは、コスト・センター、エンティティ・タイプおよびリソース別に分類されたチャージまたはリソース使用率に関連する情報を表示します。これらにより、チャージまたはリソース使用率が最大のエンティティまたはコスト・センターを迅速に評価できます。サマリー・レポートは、主に、ドリルダウンの用途で役立ちます。

データの収集は、1日に1回行われます。現在のサイクルのための日次データ収集ジョブは、チャージ・プランとコスト・センターの割当てに基づいています。レポート・サイクルは、チャージを計算する期間を定義します。このサイクルは現在の月のもので、その月の最初の日から始まります。

非定型レポートの生成手順:

1. 「エンタープライズ」メニューから「チャージバック」を選択します。

2. 「レポート」タブを選択します。

3. 次のオプションで、レポートを設計します。

- 現行レポート・サイクルを使用するか、レポートの日付範囲をカスタマイズします。

- サマリーおよび傾向のレポート・タイプを選択します。サマリー・レポートは円グラフによって内訳を示し、傾向レポートはY軸が複数の棒グラフで使用状況の傾向を示します。

- 特定のコスト・センターを選択するか、すべてのユーザーについてレポートします。

- 特定のエンティティまたはエンティティ・タイプを選択するか、すべてのエンティティ・タイプ内のすべてのエンティティについてレポートします。

- レポートするメトリックを選択します。

「レポートの表示」をクリックして、結果を表示します。

レポートには、コスト・センター、エンティティ・タイプおよびリソースごとのチャージをまとめて色分けしたグラフが表示され、下部には詳細が表で示されます。対応するグラフの絵の具箱リンクをクリックすると、色分けされた選択のレポート・コンテンツが再計算されます(例: リソース内のメモリーのグラフ)。

図43-9は、現在のレポート・サイクルでのすべてのコスト・センターおよびエンティティ・タイプのチャージをリソース別に示したサマリー・レポートです。

図43-9 コスト・センターとエンティティ・タイプのサマリー・レポート

4. ドロップ・ダウン・リストから選択することで、詳細をフィルタ処理します(デフォルトは「すべて」)。例示問合せ機能(アクション・ボタンの右側のアイコン)を使用してレポートの詳細を検索します。このアイコンはトグルし、クリックすると、表の列の上のテキストおよび選択ボックスを交互に表示または非表示します。この機能は「表示」メニューでも使用できます。それぞれの列で、日付を選択したり値を入力したりして、様々な組合せで検索基準を入力します。「入力」をクリックして検索をアクティブ化します。

5. 詳細リージョンの「エクスポート」ボタンをクリックして、レポートの内容をファイルにエクスポートします。

6. 「レポートの公開」をクリックし、レポート・コンテンツを公開します。このアクションはBI Publisherと結合し、次のことができます。

- 様々なフォーマット(Excel、PowerPoint、HTML、PDF)でのレポートの保存

- 定義済のスケジュールに基づく、生成されたレポートの電子メール・リスト(Enterprise Managerへのアクセス権がないユーザーなど)への配信

BIパブリッシャの設定の詳細は、『Enterprise Manager Cloud Controlアドバンスト・インストレーションおよび構成ガイド』の「Enterprise ManagerでのBIパブリッシャのインストール」を参照してください。

稼働時間のレポート

稼働時間メトリックのレポートを選択すると、詳細情報に、レポート・サイクルを通して1日のうちでエンティティを使用できた時間数が表示されます。稼働時間のレポートでチャージは按分されないことに注意してください。レポート結果に基づいてチャージを調整するための最適な方法を、顧客に知らせます。そのためには、Microsoft Excel HTML形式ファイルに結果をエクスポートして、さらに分析および検討します。

43.3.4 セルフ・サービス・ポータルでのチャージバック情報の表示

セルフ・サービス・ポータルから、セルフ・サービス・アプリケーションに関連するチャージバック情報にアクセスできます。

1. 「エンタープライズ」メニューから「クラウド」を選択し、「セルフ・サービス・ポータル」を選択します。

2. セルフ・サービス・ポータル・ページで、「管理」ドロップダウン・メニューからサービス・タイプを選択します。

3. チャージバック用に構成された場合、左ペインの「チャージバック」アイコンをクリックして、選択したサービス・タイプのチャージ傾向と詳細を次の情報ごとに分類して表示します。

- チャージ傾向: ある日付範囲の様々なメトリックのチャージを計算します。あるメトリック(たとえば、メモリー)の上にカーソルを置くと、そのメトリックのみを反映して棒グラフが変更されます。日付範囲を設定し、「実行」をクリックしてチャージを再計算します。

- 詳細: 上述のチャージおよび日付範囲が反映されます。「詳細レベル」ドロップダウン・メニューから選択して、データを並べ替えることができます。より多くの列を表示して、追加情報を示すこともできます。

- チャージ・プラン: ゾーンを選択して、実施されているチャージ・プラン(この場合、特定のエンティティ・タイプに定義されている拡張チャージ・プラン)を表示できます。そのエンティティ・タイプ(たとえば、Oracle VMゲスト)には、プラン定義の一部として設定された特定のチャージ・アイテムがあり、「チャージ・アイテム」タブに表示されます。チャージ・プランにより、左側の傾向と詳細に表示されるチャージが決定されます。もう1つのタブ、「ユニバーサル・レート調整」には、基本プラン・レート(CPU、メモリー、記憶域)に対して行われた調整が表示されます。

図43-10は、セルフ・サービス・ポータルにチャージバック情報を分けて表示するサンプルを示しています。

図43-10 セルフ・サービス・アプリケーション別にチャージバックを分類

43.3.5 他のアプリケーションとのチャージバック・データの共有

蓄積されたチャージバック・データは、他のアプリケーションが使用できる有用なデータです。これを行うには、次のいくつかの方法があります。

- 管理レポートをエクスポートします(チャージバックの「レポート」タブの「エクスポート」ボタン)

- BIパブリッシャを使用して管理レポートを公開します(チャージバックの「レポート」タブの「公開」ボタン)

- セルフ・サービス・アプリケーションのチャージ傾向の詳細をエクスポートします(セルフ・サービス・ポータルの「チャージバック」タブの「エクスポート」ボタン)

- EM CLI動詞get_metering_dataを実行して、使用状況およびチャージ・データ(オプション)に関するカンマ区切りの出力を生成します(詳細は第56章「EMCLI動詞によるチャージバックとメータリング」を参照)。

また、Enterprise Managerはリポジトリ・ビューをサポートするため、管理リポジトリ内の情報にアクセスしてさらに処理や表示を行えます。管理リポジトリ内のチャージバック情報にアクセスするために使用できる、2つのビュー(MGMT$EMCT_CBA_CHARGE_HOURLYおよびMGMT$EMCT_CBA_CHARGE_DAILY)があります。詳細は、Enterprise Manager Cloud Controlの拡張性に関するプログラマ・リファレンスを参照してください。

44 統合プランナの使用

この章では、Oracle Enterprise Manager Cloud Controlによって提供される統合プランナ機能の使用方法を説明します。

この章の内容は次のとおりです。

- 統合プランナの概要

- 統合プランナの使用

44.1 統合プランナの概要

長年にわたり、標準的なエンタープライズ・データ・センターは、ビジネスのニーズを満たすために必要とされるサーバーの追加のため、絶え間なく成長を続けています。この成長は、多くの場合、ラック・スペースを占領し、冷却のために多くの電力を消費し、セキュリティやパッチなどのシステムのメンテナンスを必要とする、多すぎるサーバーという事態を招きます。

調達サイクルまたは特定のハードウェア・ベンダーと結んだ契約のため、企業は異なるタイプのサーバー・ハードウェアおよびオペレーティング・システムを手にすることになり、ふとしたことからシステム配置の混乱を生み、管理者による管理や運用、パッチ、アップグレードを必要とすることになります。その結果、仕事を増やし、IT予算における、絶え間のないメンテナンスとサポートのコストが増加します。企業は、コスト削減の究極の目標である、種々雑多なシステムを標準化されたオペレーティング・システムおよびハードウェアに移行する手段として、統合に注目しています。

企業はまた、物理サーバーから仮想サーバーに移行する、Oracle仮想マシンのような仮想化テクノロジについての調査を進めています。これは、仮想化がもたらす独立性の利益を得る一方で、共有ハードウェア・インフラストラクチャの使用を可能にします。

統合の目的は、そのような十分に活用されていないサーバーを見つけ出し、それを統合する手段を発見し、企業がそのサービス・レベルを維持しながら、できるかぎり多くのサーバーを解放できるようにすることです。それぞれのサーバーの持つCPU容量のレベルが異なるため、統合プランナは、与えられたハードウェアのCPU使用状況を正規化するため、統合プロセスでコンピュータのベンチマーク・データを使用します。特に、統合プランナでは、ハードウェアの様々なクラスに、次のCPUベンチマークを使用します。

- SPECint®_base_rate2006: データベース・ホスト、アプリケーション・ホストまたは混合ワークロード・ホスト

- SPECjbb®2005: ミドルウェア・プラットフォーム

統合プランナでは、統合する管理対象ターゲット・ソースを新規または既存のターゲット宛先と一致させることができます。汎用的な物理マシンであるOracle Engineered System (Exadataデータベース・マシンまたはExalogic Elastic Cloudシステム)またはOracle Virtual Machine (VM)サーバーにソース・サーバーを統合します。

また、Oracle Cloudで構成されている物理マシンにソース・サーバーを統合できます。このタイプの統合では、Oracle Cloud Compute構成はホストを模倣します(検討するリソースとして重要なメモリーおよびCPU性能だけは除く)。

統合プランナでは、Enterprise Manager Cloud Controlによって管理対象ターゲット・サーバーから収集されたメトリックおよび構成データを利用でき、最適な統合シナリオを決定でき、それは、統合プロセスでビジネスおよび技術的な制約にも反映されます。

44.1.1 主要概念

次の概念が、統合プランナ使用の中核となります。

ソース・サーバー

統合の対象となる既存のサーバーです。

宛先サーバー

ソース・サーバーをそれに統合する既存または購入前のサーバーです。統合のターゲットと考えることもできます。これには、個々のマシン、仮想サーバー・プール、Oracle Exadata Database MachineやExalogic Elastic Cloudシステムなどのエンジニアド・システム、またはOracle Cloud Compute構成を使用できます。

統合プロジェクト

次のようなものを含み、統合作業を可能とする有効範囲を定義します。

- 統合のタイプ現在のリリースでは、2つのタイプの統合スキーマがサポートされています。

- P2V: 物理的なソース・サーバーからOracle仮想マシン(VM)の宛先サーバー

- P2P: 物理的なソース・サーバーから物理的な宛先サーバー

- 統合元の検討対象とするソース・サーバー候補の仮のセット

- 統合先の検討対象とするソース・サーバー候補の仮のセット

- 統合シナリオの生成に使用されるデータがソース・サーバーから収集される期間

- 宛先サーバーに統合できるソース・サーバーの数を決定するときの、CPU容量の測定に使用されるベンチマーク

統合シナリオ

それぞれの統合プロジェクトには、次のような入力に基づいて生成される1つ以上の統合シナリオがあります。

- 宛先サーバーが満たさなくてはならないソース・サーバーのリソース要件(CPU、メモリー、ディスクI/O、ネットワークI/Oおよびディスク・ストレージの1つ以上)。

- 考慮する必要のある、なんらかのビジネス、コンプライアンスまたは技術的制約

- シナリオで考慮する宛先サーバー

事前構成された統合シナリオのセットが提供されており、保守的な統合シナリオ、中間的な統合シナリオ、積極的な統合シナリオがあります。それぞれのシナリオは、お客様の入力を基に生成されます。また、お客様の状況に最適な独自のカスタム・シナリオを作成することもできます。作成したら、どの統合計画が要求に最適かを判断するため、様々なシナリオを比較できます。

それぞれのシナリオには、統合される各ソース・サーバーと宛先サーバー間の初期のマッピングも含まれます。マッピングは、手動生成、または統合プランナによる自動生成を選択できます。すべての入力を指定したら、シナリオを実行してその結果を評価できます。その後、前に指定された条件に基づくシナリオを、使用可能な最新のデータを使用して再評価するために、シナリオを返すこともできます。前の分析の結果は上書きされます。既存のシナリオに基づいて新しいシナリオを作成し、特定の値を微調整して新しいシナリオをカスタマイズすることも可能です。

44.1.2 統合制約

統合プランナでは、統合プロジェクトおよびシナリオの作成時に考慮すべき、様々な制約を指定できます。

この項の内容は次のとおりです。

- ソース・サーバーの制約

- 宛先サーバーの制約

44.1.2.1 ソース・サーバーの制約

ソース・サーバーには、互換性または排他性に基づく制約を定義できます。

互換サーバー

特定のプロパティおよび構成の値と一致する場合、サーバーは互換性があるとみなされます。

プロパティには次のものがあります。

- ライフサイクル・ステータス

- 部門

- 場所

たとえば、データ・センターの場所または地理的条件のように、特定のサーバーを特定の場所に残す必要があるような場合です。

構成アイテムには次のものがあります。

- ネットワーク・ドメイン

- システム・ベンダー

- システム構成

- CPUベンダー

- CPU名

- オペレーティング・システム

たとえば、同じシステムとCPUベンダーを使用するアカウンティング・ポリシーがある場合です。

これらのターゲット・プロパティおよび構成アイテムの一部または全部に互換性を確立する、またはいずれにも確立しないことができます。

相互に排他的なサーバー

サーバーが特定のOracleベスト・プラクティスに反する場合、それらのサーバーを統合範囲から除外することができます。次のいずれかまたは両方の条件を設定して、一致するサーバーを除外します。

- RACデータベースのノード: 同じRACデータベースのノードを単一の宛先サーバーに統合しません。

- Oracle Clusterのノード: Oracle Clusterのノードを同じ障害グループに配置しません。

44.1.2.2 宛先サーバーの制約

宛先サーバーでは、候補を新しい候補または既存の候補にスコープできますが、制約は主としてCPUおよびメモリー・リソースの使用率(宛先サーバーでリソース・タイプを最大どれだけ使用できるか)として表されます。

44.2 統合プランナの使用

統合プランナのプロセスの手順は、次のとおりです。

1. 統合プロジェクトを作成します。第44.2.1項「統合プロジェクトの作成」を参照してください。

2. プロジェクトに1つ以上の統合シナリオを定義します。次の2つのオプションがあります。

- 事前定義済の統合シナリオを使用。第44.2.1.5項「事前構成済のシナリオの選択」を参照してください。

- カスタム統合シナリオを作成。第44.2.2項「カスタム統合シナリオの作成」を参照してください。

3. 統合プランナ・コンソールで統合シナリオを評価し、ニーズに最適な統合戦略を決定します。第44.2.4項「統合シナリオの評価」を参照してください。

4. シナリオの設定を変更し、異なる結果を生成します。お客様の状況にとって最良のシナリオが得られるまでこの手順を続けます。

このリリースでは、計画の目的でのみ統合シナリオを作成できます。ソースから宛先へ実際にデータが移動するシナリオの実行は、サポートされていません。

複数のソースを複数の宛先に統合する場合、ソースのリソース要件は、宛先のリソース容量に対してチェックされます。識別されるすべてのソースを最小限の数の宛先に統合するために、統合プランナは、宛先の対応する使用可能なリソースにできるだけ厳密に適合する既知のリソース要件があるソースのセットを識別しようとします。

たとえば、宛先サーバーで使用可能なメモリーが2GBの場合、統合プランナは、必要なメモリーの合計が2GBにできるだけ近くて、宛先サーバー内のソース・サーバーに適合する、候補となるソース・サーバーのセットを見つけようとします。目標は、ソース・サーバーを最も少ない数の宛先サーバーへ「適合」させることです。

この項には、次の項目が含まれます。

- 統合プロジェクトの作成

- カスタム統合シナリオの作成

- その他のシナリオ作成オプション

- 統合シナリオの評価

- 統合シナリオの分析

- 統合レポートの表示

- Oracle Compute Cloud形状の検討

- データ収集管理

44.2.1 統合プロジェクトの作成

各統合処理に対して、統合プロジェクトを作成し、個々の統合シナリオをその中に追加します。統合シナリオを比較して、どの統合方法が最も有用であるかを決定できます。

プロジェクトを定義した後で、指定したターゲットで使用可能なデータを管理リポジトリから収集するために、Cloud Controlジョブが発行されます。ジョブが終了すると、そのプロジェクトがアクティブなプロジェクトになります。プロジェクトがアクティブ状態にあるかぎり、データの収集が続きます。

注意:
Exadata Engineered Systemにレガシー・ホストを統合するためのプロジェクトを作成する方法の視覚的デモンストレーションを表示するには、次のURLを使用して、「Oracle Enterprise Manager 12c: Consolidation Planner」というビデオを視聴してください。

https://apex.oracle.com/pls/apex/f?p=44785:24:0::NO:24:P24_CONTENT_ID,P24_PREV_PAGE:6427,2

作成プロセス全体を通してウィザードのガイダンスに従って、次の手順を実行します。

- 統合タイプの宣言

- ソース候補の指定

- 宛先の候補の指定

- データ収集パラメータの設定

- 事前構成済のシナリオの選択

- 統合プロジェクトの確認および保存

44.2.1.1 統合タイプの宣言

統合プロジェクトの一般的な情報を、次に示すとおりに指定します。

1. 「エンタープライズ」メニューから、「統合プランナ」を選択します。

2. 「プロジェクトの作成」ボタンをクリックします。

3. 統合プロジェクト名と、オプションで説明を入力します。

4. 物理ソース・サーバーからOracle VMサーバー(P2V)または物理ソース・サーバーから物理サーバー(P2P)のホスト統合タイプを選択します。

5. 「次へ」をクリックして、ソースの候補を指定します。

44.2.1.2 ソース候補の指定

次のようにソースの選択に進みます。

1. ドロップダウン・メニューから適切なベンチマークを選択します。

- データベース・ホスト、アプリケーション・ホストまたは混合ワークロード・ホストには、SPECint®_base_rate2006を指定します。

- ミドルウェア・プラットフォームには「SPECjbb®2005」を指定します。

2. 「ソース・サーバーの追加」をクリックして、管理対象サーバー候補のリストから、統合するソース・サーバーを選択します。フィルタ基準を使用してターゲット検索を絞り込みます。フィルタした結果から選択し、「選択」をクリックします。
選択したターゲットが表に表示されます。選択したソース・サーバーを削除して、リストを間引くことができます。

3. オプションで、ディスクI/OリクエストのサーバーI/O容量とネットワークI/Oボリューム容量を設定します。「サーバーI/O容量の指定」をクリックして、統合プロジェクトに関係するすべてのソースについてこれらのI/O容量を見積もります。行をクリックし、様々な容量の値を編集することで、これらの見積もりを後で微調整できます。

4. 「次へ」をクリックして、宛先の候補を指定します。

44.2.1.3 宛先の候補の指定

次のように宛先の選択に進みます。

1. オプションで、ソース・サーバーを統合する1つ以上の既存のサーバーを選択します。

- 物理サーバーからOracle Virtual Server (P2V)に統合する場合は、「既存の仮想サーバーを宛先として追加」をクリックし、ソース・サーバーの統合先となる既存のVMベースのExalogic Elastic CloudシステムとOracle Virtual Machineの宛先サーバーのリストを表示します。2つを区別するには、ターゲット・タイプ・フィルタを使用します。追加するサーバーを選択し、「選択」をクリックします。
選択したターゲットが表に表示されます。選択した宛先サーバーを削除して、リストを間引くことができます。

- 物理サーバーから物理サーバーに統合する場合は(P2P)、既存のOracleエンジニアド・システムを宛先として追加をクリックして、ソース・サーバーを統合するExadataデータベース・マシン・サーバーまたはExalogic Elastic Cloudサーバーを検索します。2つを区別するには、ターゲット・タイプ・フィルタを使用します。追加するサーバーを選択し、「選択」をクリックします。
選択したターゲットが表に表示されます。選択した宛先サーバーを削除して、リストを間引くことができます。

注意:
統合は、新しい宛先サーバーまたはソース・サーバーとして選択された既存のサーバーに対するものになります。

2. オプションで、行をクリックして値を変更することにより、見積もられたCPU容量、I/OリクエストおよびネットワークI/Oボリュームを編集します。「サーバーI/O容量の指定」をクリックしてI/O値を編集し、統合プロジェクトに関係するすべての宛先サーバーについてこれらのI/O容量を見積もることもできます。

3. 「次へ」をクリックしてデータ収集を設定します。

44.2.1.4 データ収集パラメータの設定

統合シナリオを生成するのに使用されるデータを、「データ収集」リージョンのプロジェクトで指定したソース・サーバーに収集する期間を指定します。このデータは、宛先サーバーが満たす必要があるリソース要件を決定するのに使用されます。

1. データを収集する最小日数を指定します。デフォルトの最小値は21日です。実行に既存の履歴データを使用し、統合シナリオを即時に表示するには、日の最小値に0を指定します。

2. データを収集する最大日数を指定します。デフォルトの最大値は90日です。

3. データ収集プロセスの開始時を指定します。
データ収集が開始したら、「統合プランナ」コンソールの「アクション」メニューから収集の中断と再開をいつでも選択できます。

4. オプションで、最大日数の間データ収集を続行を選択して、新しい日付のデータが追加された場合に古い日付のデータをパージします。

5. 「次へ」をクリックして、事前構成済のシナリオを選択します。

44.2.1.5 事前構成済のシナリオの選択

統合プロジェクトの作成時に、オプションで、最大3つの事前構成済の統合シナリオを生成するよう選択し、プロジェクトに追加できます。これらの即時利用可能なシナリオは、保守的、積極的および中間の統合スキームを表します。

プロジェクトの作成時に統合プロジェクトで定義されたソース・ターゲットに収集されたデータを使用して、これらのシナリオが生成されます。プロジェクトの作成時に使用可能なデータがない場合、最小量のデータを収集すると、事前構成済のシナリオが自動的に生成されます。

統合プランナには、保守的、積極的および中間の統合スキームを表す3つの即時利用可能なシナリオが付属しています。

1. 適切なラジオ・ボタンをクリックして、事前構成済のシナリオを使用するかどうかを選択します。オプションを選択すると、使用できる即時利用可能な統合シナリオのリストが表示されます。デフォルトで、ソース・ターゲットのリソース使用量を日次で集計するのに使用される方法で、シナリオが指定されます。

- 積極的: 平均の日次の使用量に基づいて、時間ごとにデータを集計します。
この場合、通常、多くのソースが各宛先に適合するため、高い統合の比率(ソース:宛先)となります。しかし、多くのソースが含まれるため、1つ以上がリソースの要件を満たさない可能性が高くなります。

- 保守的: 最大の日次の使用量に基づいて、時間ごとにデータを集計します。
この場合、通常、ほとんどのソースが各宛先に適合しないため、低い比率(ソース:宛先)となります。

- 中: 80%の使用率に基づいてデータが集計されます。
この場合、通常、積極的な集計と保守的な集計の間の比率(ソース:宛先)となります。

2. 使用する事前構成済のシナリオを選択します。いずれかまたはすべてのシナリオを選択できます。

3. シナリオの新規または既存の宛先を繰り込むかどうかを選択します。新規(phantom)サーバーを選択する場合は、リソース・メトリックの見積もりを指定します。

4. 「次へ」をクリックして、統合プロジェクトを確認します。

統合プロジェクトで定義されたソース・サーバーに対して収集されたデータを使用して、プロジェクトを作成する場合、事前構成済のシナリオが生成されます。

統合プロジェクトが完了すると、独自のカスタム・シナリオを作成するよう選択することもできます。

44.2.1.6 統合プロジェクトの確認および保存

統合プロジェクトの詳細を確認します。「戻る」ボタンを使用して、変更する手順に戻ります。問題ない場合は、「発行」をクリックします。メッセージにより、プロジェクトが作成され、ジョブが発行されたことが確認されます。

プロジェクトが作成されると、統合プランナ・コンソールに表示されます。統合シナリオをこのプロジェクトに定義できます。

44.2.2 カスタム統合シナリオの作成

事前構成済のシナリオを使用するかわりに、またはそれに追加して、カスタムの統合シナリオを作成できます。1つのプロジェクトで複数のシナリオを作成でき、ソリューションを決定する前に異なるシナリオを比較できます。既存の統合プロジェクト内に新しい統合シナリオが作成されます。

作成プロセス全体を通してウィザードのガイダンスに従って、次の手順を実行します。

- シナリオ・パラメータの指定

- 統合制約の定義

- 宛先の候補の指定

- 宛先へのソースのマッピング

- 新しいシナリオの確認および保存

44.2.2.1 シナリオ・パラメータの指定

シナリオの一般的なパラメータを、次に示すとおりに指定します。

1. 「エンタープライズ」メニューから、「統合プランナ」を選択します。

2. シナリオの適用対象となる統合プロジェクトをクリックします。

3. シナリオの作成ボタンをクリックします。

4. シナリオ名など、シナリオの詳細を指定します。

5. 対象となるソース・リソースを指定します。統合プランナは指定されたリソースを集計して合計の要件を決定します。

- リソース・タイプ: CPU、メモリー(GB)、I/O容量など、考慮する必要のあるサーバー要件。

- スケール係数: 各ソースの宛先におけるサイズ増加に備えて余裕を作ります。スケール計数は、統合の見積もりに余裕を持たせるために、リソース要件の見積に使用されます。たとえば、使用状況データに基づくと、指定されたソースの見積もり要件が、スケール係数1に相当するメモリー2GBで、1.1のスケール係数を指定している場合、そのソースの統合には2.2GBが必要です。

- 該当する日数: 週のうち、リソース使用量メトリックを収集する日数。

- リソース割当て: 毎日のソース・サーバー・リソースの使用率の集計に使用するメソッド。値は次のとおりです。

- 積極的: 平均の日次の使用量に基づいて、時間ごとにデータを集計します。
この場合、通常、多くのソースが各宛先に適合するため、高い統合の比率(ソース:宛先)となります。しかし、多くのソースが含まれるため、1つ以上がリソースの要件を満たさない可能性が高くなります。

- 保守的: 最大の日次の使用量に基づいて、時間ごとにデータを集計します。
この場合、通常、ほとんどのソースが各宛先に適合しないため、低い比率(ソース:宛先)となります。

- 中: 80%の使用率に基づいてデータが集計されます。この場合、通常、積極的な集計と保守的な集計の間の比率(ソース:宛先)となります。

- 日付範囲には、標準的なリソース要件でよく使用される期間を定義する必要があります。

6. 推定される合計のリソース要件を表示するには、推定要件をクリックします。
リソース要件は、集計された1時間ごとの要件に基づいて表示されます。表示される要件は、リソースに指定されたスケール係数(存在する場合)を反映しています。24時間の要件パターンは、統合ターゲットが満たす必要のある最低要件として使用されます。

7. 「次へ」をクリックして、統合制約を定義します。

44.2.2.2 統合制約の定義

適用する必要があるビジネス、企業または技術的な制約を指定します。これらの制約は次の目的で使用されます。

- ソースから宛先への自動マッピング中における割当てプロセスのガイド

- ソースと宛先間の手動マッピングが使用されている場合の違反の計算

1. 互換性のあるサーバーの基準を選択します。
サーバーは、同じターゲット・プロパティと構成が指定されている場合に互換性があると判断されます。複数のソース・サーバーを1つのターゲット・サーバーに統合する場合は、互換性のあるサーバーのみが同じターゲット・サーバーに統合されます。

2. 相互に排他的なサーバーの基準を指定します。
特定タイプのソース・サーバーは相互に排他的であり、様々な理由で同じ宛先サーバー上に統合することができません。たとえば、Oracleクラスタのノードは、同じ障害グループに配置しないでください。

3. 「制約の結果のプレビュー」をクリックし、定義済の制約に基づいて、互換性のないソース・サーバーのリストを表示します。

4. 「次へ」をクリックして、宛先サーバーの候補を指定します。

44.2.2.3 宛先の候補の指定

要件を満たすために必要な宛先の候補を決定します。プロジェクト・タイプに従って続行します。

- 物理サーバーから仮想サーバーへのプロジェクト

- 物理サーバーから物理サーバーへのプロジェクト

物理サーバーから仮想サーバーへのプロジェクト

P2Vプロジェクトの場合:

1. 次のいずれかのオプションを使用して、宛先サーバーの候補を選択します。

- まだプロビジョニングされていないか購入されていないターゲット・サーバーを使用する場合は、「新規(ファントム)サーバーの使用」をクリックし、次のいずれかのオプションを選択します。

- 「Oracle Engineered Systemの使用」を選択し、検索アイコンをクリックして、Exalogic Elastic Cloudシステムの適切な構成タイプを選択します。

- 「汎用サーバーの使用」を選択し、可能な場合は予想されるCPU容量を指定します。それ以外の場合はCPU容量入力フィールドの横にある検索アイコンをクリックして、要件を最も満たすサーバー構成を選択します。
必要に応じて、メモリーおよびストレージの推定量を調整します。

仮想環境では、データベース・マシンでスーパーバイザ・ソフトウェアが使用できるように確保(予約)しておくリソースの量を指定することもできます。この量は、ソース・サーバーを残りのリソースに統合する前に、宛先の合計容量から差し引かれます。たとえば、予想されるメモリー要件が12GBで、2GBの予約を指定した場合、統合に使用できるのは10GBのみです。

統合プランナにより、統合結果の一部として、必要な宛先サーバー数が決定されます。

- ターゲットとして使用する既存の管理対象サーバーのセットを指定するには、既存のサーバーを使用をクリックします。
これが、統合プロジェクトの範囲を定義する際に指定したサーバーです。統合プランナにより、収集された使用量のデータに基づいて、使用可能なハードウェア・リソースが決定されます。

デフォルトでは、できるだけ少ない数のターゲット・サーバーを使用して統合プロセスが実行されるよう設定されています。必要な場合は、宛先全体でソース負荷を平均化することを選択します。

2. 「宛先サーバーで許可される最大リソース使用量」で、デフォルトを受け入れるか、割合を編集します。宛先サーバーにヘッドルームを提供するこれらの許容値を、個々のソース・サーバーにヘッドルームを提供するスケール係数と対比します。

3. 「次へ」をクリックして、ソース・サーバーを宛先サーバーにマップします。

物理サーバーから物理サーバーへのプロジェクト

P2Pプロジェクトの場合:

1. 次のいずれかのオプションを使用して、宛先サーバーの候補を選択します。

- まだプロビジョニングされていないか購入されていない宛先サーバーを使用する場合またはOracle Cloud Computingを使用する場合は、「新規(ファントム)サーバーの使用」をクリックし、次から該当するオプションを選択します。

- 「Oracle Engineered Systemの使用」を選択して、Exadataデータベース・マシンまたはExalogic Elastic Cloudのいずれかを選択します。検索アイコンをクリックして、いずれかの選択に適した構成タイプを選択します。

- 「汎用サーバーの使用」を選択し、可能な場合は予想されるCPU容量を指定します。それ以外の場合はCPU容量入力フィールドの横にある検索アイコンをクリックして、要件を最も満たすサーバー構成を選択します。

- Oracle Compute Cloudの使用を選択し、宛先として使用するクラウド計算構成(形状)を選択します。詳細は、第44.2.7項「Oracle Compute Cloud形状の検討」を参照してください。

必要に応じて、メモリーおよびストレージの推定量を調整します。

- プロジェクトの宛先として使用する既存の管理対象サーバーのセットを指定するには、「既存のサーバーの使用」をクリックします。
これが、統合プロジェクトの範囲を定義する際に指定したサーバーです。統合プランナにより、収集された使用量のデータに基づいて、使用可能なハードウェア・リソースが決定されます。宛先の候補を明示的に指定しなかった場合は、すべてのソース・サーバーが統合の潜在的な宛先になります。

デフォルトでは、できるだけ少ない数の宛先サーバーを使用して統合プロセスが実行されるよう設定されています。必要な場合は、宛先全体でソース負荷を平均化することを選択します。

2. 「宛先サーバーで許可される最大リソース使用量」で、デフォルトを受け入れるか、割合を編集します。宛先サーバーにヘッドルームを提供するこれらの許容値を、個々のソース・サーバーにヘッドルームを提供するスケール係数と対比します。

3. 「次へ」をクリックして、ソース・サーバーを宛先サーバーにマップします。

44.2.2.4 宛先へのソースのマッピング

次に、統合先の宛先にソースをマップします。目的は、ソース要件を、各宛先の使用可能なリソースにできるだけ厳密に適合させることです。

このマッピングは、統合プランナで自動的に実行することをお薦めします。そうすることで、リソース性能および指定されている様々な統合制約に基づいて、宛先のリソース使用率を最大化できます。

既存の宛先を選択した場合は、オプションで、各ソースおよび宛先を手動でマップできます。

1. リスト内のソースをクリックします。

2. 懐中電灯アイコンをクリックし、ソースにマップする宛先を選択します。宛先には単一のソースまたは複数のソースをマップできますが、宛先は1つのみ指定できます。
結果の統合レポートには、手動マッピングが原因のリソースまたは制約の違反(あるいはその両方)が表示されます。

3. 「次へ」をクリックして、統合シナリオを確認します。

44.2.2.5 新しいシナリオの確認および保存

新しいシナリオに設定されている様々なパラメータを確認します。オプションで、シナリオをテンプレートとして保存することもできます。変更が必要な場合は、「戻る」ボタンを使用します。それ以外の場合は、次のように続行します。

- オプションで、テンプレートとしてシナリオを保存し、他のユーザーと共有できます。このことを実行する場合は、「シナリオをテンプレートとして保存」をクリックします。開かれたダイアログで、ローカル・ファイル・システムの場所を参照し、XMLファイルとしてテンプレートを保存します。

- 「発行」をクリックします。ジョブがシナリオのより詳細な分析のために発行されたことを確認するメッセージが表示されます。完了すると、統合プランナ・ページの下部に結果が表示されます。

44.2.3 その他のシナリオ作成オプション

既存のシナリオに基づいて統合シナリオを作成することもできます。統合プロジェクトの下で適用可能なシナリオを選択し、「アクション」メニューから「シナリオの類似作成」を選択します。必要に応じてシナリオを変更し、意味のある名前を指定して、通常どおり分析のために発行します。

テンプレートとしてシナリオを保存した場合、後でシナリオを別の環境にインポートできます。

1. 統合プランナ・ホームページで、「アクション」メニューから「テンプレートからのシナリオの作成」を選択します。

2. ローカル・ファイル・システムで保存されたテンプレートXMLファイルを参照します。「開く」をクリックします。

3. 保存されたテンプレートをレプリケートする範囲(テンプレートで表現されるリソース、制約およびターゲット計画)を示します。変更する場合は、「更新」をクリックします。

4. 「OK」をクリックして、保存されたテンプレートをインポートします。
インポートしたシナリオは、統合プランナでシナリオを編集および保存できるウィザードで開きます。

44.2.4 統合シナリオの評価

統合プランナ・コンソールを使用して、統合シナリオの詳細を表示できます。統合シナリオの結果を評価したら、別の計画を定義することも、既存のシナリオを再実行し、使用可能な最新のデータで、前に指定された条件に基づいて再評価することもできます。前の分析の結果は上書きされます。既存のシナリオに基づいて新しいシナリオを作成し、特定の値を微調整して新しいシナリオをカスタマイズすることも可能です。この反復プロセスは、様々な要因に折り合いを付け、それぞれのトレードオフを秤にかけて生成される、最適化された統合シナリオを得るために役立ちます。

作成した統合シナリオを比較して、どの統合計画が最も要件を満たすかを決定します。

目的は次のとおりです。

- ソース・リソースの要件を、その要件を最も満たす宛先と一致させます。

- ソースの要件と各宛先の使用可能なリソースをできるだけ緊密に適合させ、宛先の容量を最大限に使用できるようにします。

- リソース要件の係数としてヘッドルームを準備しておくことで、宛先におけるサイズ増加に備えて余裕を作ります。

- オプションで、使用可能なすべての宛先全体で、ソースの作業負荷のバランスをとります。

現在のリリースでは、統合シナリオは計画目的でのみ作成できます。統合プランナを使用して統合シナリオを実行できません。

1. 「エンタープライズ」メニューから、「統合プランナ」を選択します。

2. まず、表示するシナリオを含むプロジェクトを調査します。

- 「ステータス」列は、プロジェクトに指定された最小および最大の収集日数に基づいて、データ収集のステータスを示します。

- 「一般」タブは、プロジェクトをタイプ、収集の詳細、ソース数などで要約します。

- 「ソース」タブをクリックして、プロジェクトで定義されたソースに対して収集された様々な使用状況データを表示します。データには、プロジェクト・タイプに応じてCPU、メモリー、記憶域およびディスクとネットワークのI/Oの使用率が含まれます。

- 「ソース・ワークロード」タブをクリックして、収集されたソースのリソース使用量データを示すグラフを表示します。データは、月次スパンで24時間の期間ごとに表示されます。ビューは、ソース、リソース・タイプおよび月でフィルタできます。

- 「宛先候補」タブをクリックして、統合されるソースに基づいて、ハードウェア詳細および予測されるリソース使用率を宛先候補ごとに分類して表示できます。

- プロジェクトが選択されているときに「レポート」ボタンをクリックし、要約された情報および詳細を表示します。

3. 次に、特定のシナリオのデータを表示します。完了済の分析の場合は、詳細を表示する行で任意のメトリックをクリックします。「ソース」メトリックをクリックすると、シナリオのサマリーを表示できる「一般」タブが表示されます。その他のメトリックをクリックすると、次のように、それぞれのタブが表示されます。

- 宛先: ソースの統合先の宛先のリスト。宛先ごとにリソース構成および計算された使用量が表示されます。
クラウドへの統合で重要なリソースはCPU性能とメモリーです。

- 比率: 宛先に対するソースの比率。デフォルトでは、統合プランナはできるだけ少ない宛先にソースを適合させようとします。

- マッピング: 特定のソースがマップされる宛先。分析には予想されるCPUとメモリーの要件および使用率が含まれ、考慮する推奨のCPUおよびメモリー割当ての数値で拡張されます。これらの推奨は、要件と宛先サーバーの容量の間での合理的な妥協点を表します。

- 信頼度: シナリオで定義したソースの使用要件を満たすソースについて収集されたデータの割合。この値は、プロジェクトで定義されたすべてのソースについて集計されます。

- 違反: シナリオで定義された技術的な違反またはビジネス制約の数。

- 排他: 宛先への修飾されたマッピングがないソースの数。これらは、使用可能な宛先の容量を超えたソースです。ソースから宛先への自動マッピングを使用している場合のみ、このメトリックは適用可能です。

制約のセットが異なると、最適なシナリオが異なることがあります。別のシナリオ結果を得るには、制約を変更します。

44.2.5 統合シナリオの分析

統合シナリオを分析するために、統合プランナは定義済のプロセスに従います。

最初に、統合プランナは、各統合ソースの時間ごとおよび全体的なリソース要件を見積もります。Enterprise Managerで収集されたメトリック・データを使用して、統合プランナは(指定した収集日数内の)時間ごとおよびすべての時間の要件を計算し、選択したリソース割当てスタイル(「積極的」、「中」または「保守的」)に応じて平均、80パーセンタイルまたは最大値を選択します。スケール係数が指定されている場合、統合プランナはこの値を調整します。ソースに対して表示されるリソース要件は、リソース割当てスタイルと調整によって決定される全体的な要件です。

統合シナリオに既存の宛先が含まれている場合、統合プランナは同様の計算を実行して、各宛先の時間ごとおよび全体的な使用状況の値を決定します。統合プランナは、これらの値をスケーリングまたは調整せず、リソース割当てスタイルに応じて、平均、80パーセンタイルまたは最大値を使用してこれらを計算します。

ソースを新規または既存の宛先に統合するために、統合プランナは、各ソースの時間当たりの要件を宛先の1時間当たりの使用可能容量と照合します。(既存の宛先は、既存の時間当たりのワークロードが移入されたこのプロセスを開始します。新しい宛先は空の状態で開始します。)宛先がすべてのリソースに対する時間当りのすべての要件に対応できる場合は、統合が正常に行われます。任意の要件を統合できない場合、統合プランナは、十分な容量が検出されるまで次の宛先を試行します。統合が既存の宛先に対するもので、十分な容量が残っていない場合、ソースは統合から除外されます。新しい宛先への統合の場合は、ソースに対応するために別の宛先が作成されます。デフォルトでは、統合プランナは可能な最少の宛先にソースを統合します。ただし、複数の既存の宛先があるシナリオでは、ワークロードをすべての宛先に分散させることを選択できます。

シナリオの「マッピング」ページには、統合の結果が表示されます。このページの内容は、統合に対して選択したプロジェクト・タイプとリソースによって異なりますが、一般には次の内容が表示されます。

- 予測される宛先、および各宛先に統合されたソース。

- 各リソースについて、宛先の容量と、既存のワークロードに統合されたソースによって消費されるリソースの割合および量(存在する場合)。統合プランナは、宛先のリソースの1時間当たりの最大のリソース使用状況を検出することで、この量を見積もります。ソース行は、そのソースによって使用される宛先のリソースの割合を示します。

44.2.6 統合レポートの表示

統合プロジェクトおよびシナリオの詳細を、様々な書式で取得できるレポート形式で再利用し、より多くのユーザーに配布できます。

44.2.6.1 統合プランナ・プロジェクト・レポートの表示

プロジェクト・レポートを表示するには、「統合プランナ」ホームページでプロジェクトを選択し、表の上にある「レポート」ボタンをクリックします。「レポート」ページでは、ホームページのプロジェクト詳細に表示されているタブ情報を表示するスタック済でスクロール可能な表としてプロジェクト詳細を再度表示します。

「レポートの公開」をクリックし、レポート・コンテンツを取得します。このアクションはBI Publisherと結合し、次のことができます。

- 様々な形式(Excel、PowerPoint、HTML、PDF)によるレポートの保存。

- 定義済のスケジュールに基づく、生成されたレポートの電子メール・リスト(Enterprise Managerへのアクセス権がないユーザーなど)への配信。

「OK」をクリックして「統合プランナ」ホームページに戻ります。

44.2.6.2 統合プランナ・シナリオ・レポートの表示

プロジェクト・シナリオ・レポートを表示するには、「統合プランナ」ホームページでプロジェクトにあるシナリオを選択し、表の上にある「レポート」ボタンをクリックします。「レポート」ページでは、ホームページのシナリオ詳細に表示されているタブ情報を表示するスタック済でスクロール可能な表としてシナリオ詳細を再度表示します。

「レポートの公開」をクリックし、レポート・コンテンツを取得します。このアクションはBI Publisherと結合し、次のことができます。

- 様々な形式(Excel、PowerPoint、HTML、PDF)によるレポートの保存。

- 定義済のスケジュールに基づく、生成されたレポートの電子メール・リスト(Enterprise Managerへのアクセス権がないユーザーなど)への配信。

「OK」をクリックして「統合プランナ」ホームページに戻ります。

44.2.7 Oracle Compute Cloud形状の検討

形状では、1つのインスタンスに使用可能なOracle Compute Unit (OCPU)の数およびRAM容量を定義します。1 (OCPU)は、現在ハイパー・スレッドが使用可能な3.0 GHz 2012 Intel Xeonプロセッサ相当のCPU性能を提供します。各OCPUは、vCPUと呼ばれる、2つのハードウェア実行スレッドに対応します。

広範な形状は、ビジネス要件に最適な、インスタンスの処理能力とメモリーの組合せを選択する際に役立ちます。インスタンスの形状を選択する際に、インスタンスにデプロイするアプリケーションの特性、アプリケーションの使用が予想されるユーザー数、および将来予想される負荷のスケールの程度について検討します。OSで使用されるCPUおよびメモリー・リソースも忘れずに考慮してください。

リソース要件を満たす形状を決定するために、形状を試して典型的なワークロードでテストできます。

表44-1には、Oracle Compute Cloud Serviceで現在利用可能な形状のリストが示されています。OC3からOC7の形状は標準のOCPUとメモリーの組合せを表しています。OC1MからOC5Mの形状は上位のメモリー構成を表していて、メモリー割当てが標準構成の2倍です。

表44-1 Oracle Compute Cloud Serviceの形状

Name

OCPU

vCPU

メモリー(GB)

OC3

1

2

7.5

OC4

2

4

15

OC5

4

8

30

OC6

8

16

60

OC7

16

32

120

OC1M

1

2

15

OC2M

2

4

30

OC3M

4

8

60

OC4M

8

16

120

OC5M

16

32

240

44.2.8 データ収集管理

プロジェクトのステータスを表示して、データ収集を管理します。

1. 統合プランナ・ホームページで、「アクション」メニューから「データ収集の表示」を選択します。

2. 次のタスクを実行できるプロジェクト内のソース・ターゲットが、ビューにリストされます。

- プロジェクトによる最新の収集ステータスを表示します。

- ターゲットを選択して収集履歴を確認し、収集の潜在的な問題のトラブルシューティングを行います。

- 「データ収集ジョブ」の下のリンクをクリックして、表示できるジョブ・アクティビティ・ページに移動し、最新のデータ収集ジョブを管理します。

- 手順に従って最新のSPECintレートを更新し、最新レートでCSVファイルをダウンロードします。ファイルをダウンロードしたら、「参照」をクリックしてローカル・ファイル・システムのファイルを検索し、「ロード」をクリックして統合プランナのレートを更新します。

第XVI部

クラウドAPIの使用

この項では、クラウド・アプリケーション・プログラミング・インタフェース(API)およびRESTful (Representational State Transfer) APIについて説明します。

内容は次のとおりです。

- 第45章「クラウドAPIの概要」

- 第46章「クラウドのリソース・モデル」

- 第47章「Database as a Service管理者用のEM CLI動詞」

- 第48章「Database as a Service管理者REST API」

- 第49章「Database as a Service SSAユーザーREST API」

- 第50章「DBaaS REST APIおよびEM CLI動詞ベースのユースケース」

- 第51章「SSA管理REST API」

- 第52章「SSAポータル管理REST API」

- 第53章「WebLogic as a Service REST API」

- 第54章「SOAaaSおよびOSBaaS API」

- 第55章「ラピッドスタート・クラウド設定」

- 第56章「EMCLI動詞によるチャージバックとメータリング」

- 第57章「ブループリントの概要」

- 第58章「クラウド・ブループリントおよびブループリントのリファレンス」

- 第59章「Infrastructure as a Service REST API」

- 第60章「Testing as a Service REST API」

45 クラウドAPIの概要

クラウド・コンピューティングは、動的に拡張可能なデプロイ済リソースをサービスとしてネットワーク経由で提供するスタイルのコンピューティングです。提供するサービスをサポートするクラウドの基盤となるインフラストラクチャについての知識や経験は不要で、これらのインフラストラクチャを管理する必要もありません。エンタープライズ(企業、政府、その他の組織)は既存のITインフラストラクチャおよびITリソースを共有可能なクラウド・パラダイムに統合するため、クラウド・イネーブラは、エンタープライズがビジネス・プロセスや経済モデルにあわせてクラウドをカスタマイズする際に使用できる統一APIを用意する必要があります。

ここで説明するRepresentational State Transfer (REST) APIは、リソース・モデルとその属性に重点が置かれています。

この章の内容は次のとおりです。

- はじめに

- クラウドREST APIを使用する場合

- 変更履歴

- 共通の動作

45.1 はじめに

ITデプロイメントが複雑になるにつれて、インフラストラクチャ・リソースの抽象化はコンプライアンスや構成に関する問題への対処に関連するようになってきました。さらに、このようなリソースの抽象化により、管理者が大幅に介入する必要なしに、コンシューマは必要なサービスを自ら用意し、操作時にサービスを制御できるようになります。

REST APIにより、インフラストラクチャ・プロバイダは、顧客に次の作業を許可する形でサービスを提供できます。

- サービスの論理単位の定義とメタデータを含むテンプレートの参照。

- テンプレートのクラウドへのデプロイおよびオンデマンドでのITトポロジの構成。

- リソースに対する操作の実行(ONLINE、OFFLINEなど)。

このREST APIはHTTPプロトコルに基づいており、GET、POST、PUTおよびDELETEリクエストがすべて使用されます。ここで説明するリソース表現は、JavaScript Object Notation (JSON)を使用しています。

このREST APIはUniform Resource Identifier (URI)空間の特定の構造を前提としていません。開始点はクラウド・サービス・プロバイダによって提供されるURIで、クラウドそのものを識別します。クラウドの表現には、クラウド内の他のリソースのURIが含まれます。クラウド・リソースに対する操作は、リソースのURIへのHTTPリクエストを作成することで実行されます。

このクラウドREST APIの仕様には、次のようなものがあります。

- すべてのリクエストおよびレスポンス、エラー・メッセージ、共通リソース属性に適用される共通の動作。

- リクエストとレスポンスで使用されるJSONデータ構造を説明するリソース・モデル。

- クラウド・リソースに送信されるリクエストおよび予想されるレスポンス。

45.2 クラウドREST APIを使用する場合

クラウドREST APIを使用すると、Enterprise Managerをカスタムビルドまたはサード・パーティのセルフ・サービス・コンソールおよびサービス・デスクと統合できます。サンプル・シナリオをいくつか示します。

- データベースおよびOracle VMアセンブリを、カスタムビルドのセルフ・サービス・コンソールからデプロイする。

- 承認ワークフローの後に行われるプロビジョニングなど、大規模な調整フローへの統合。

- データベースおよびOracle VMアセンブリをサービス・デスクからデプロイする。

- 一般にクラウドのテナント・インタフェースが異なり、サービスの調達、テナント登録などを提供するパブリック・クラウドの一部として。

45.3 変更履歴

次の表では、Enterprise Manager Cloud Controlクラウド・サービス・ポータルの、プラグイン12.1.0.4から12.1.0.5での重要な変更点について説明します。

Table 45-1 リソース・モデルに関する変更点(12.1.0.4から12.1.0.5)

概要

説明

影響

QuotaUsageリソースの可用性

サービス・ファミリ・タイプからAPIを介してリソース割当て制限使用量情報を確認できます。

割当て制限使用量を参照するための追加属性が各リソース・モデルに追加されます。

ServiceTemplateFindsリソースの可用性

サービス・ファミリ・タイプでは、サービス・テンプレートのリソースの問合せのサポートを提供できます。

クラウド・レベル相互作用により、リスト基準を満たすサービス・テンプレートのリストが返されます。

次の表に、Enterprise Manager Cloud Controlクラウド・サービス・ポータルの、プラグイン12.1.0.2から12.1.0.4での重要な変更点を示します。

Table 45-2 リソース・モデルに関する変更点(12.1.0.2から12.1.0.4)

概要

説明

影響

x-specification-versionヘッダーの導入

x-specification-versionは、このリリースで導入された新しいヘッダーです。このヘッダーの目的は、サポートされる様々なバージョンのクラウド・リソース・モデル間の切替えをバックエンド・サーバーに通知することです。

デフォルトで、このヘッダーを指定しない場合、サーバーでは最新バージョンのリソース・モデルが自動的に使用されます。

現在、各サーバー・レスポンスもx-specification-versionを含むことができます。

クライアントが以前(12.1.0.4クラウド・サービス・ポータル以前)のリソース・モデルを12.1.0.4クラウド・サービス・ポータルで使用する必要がある場合、次のヘッダーを指定できます。

x-specification-version: 10000

たとえば、GET /em/cloud with x-specifcation-version: 10000で、12.1.0.4以前のリリースのクラウド・サービス・ポータルのクラウド・リソースが返されます。

サービス指向性に更新されたクラウド・メディア・タイプ

このリリース以前、最上位のクラウド・メディア・タイプはIaaS中心のものでした。しかし、このリリースではMiddleware as a Serviceが追加され、クラウド・メディア・タイプは汎用サービス・モデルとなり、メディア・タイプを再構築しないで、XaaSをシステムにプラグインして追加できるようになりました。

クラウド・メディア・タイプは下位互換性でなくなりました。(ただし、x-specifiction-versionヘッダーの使用により、クライアントの以前のメディア・タイプへの切替えは引き続き可能です)。

ゾーンに統合されるVDC概念

IaaS中心のVDCがサポートするリソース関係は、汎用性の高いゾーン・リソースに統合されます。VDCリソースは、現在、12.1.0.4クラウド・サービス・ポータルのリソース・モデルから表示できません。

12.1.0.4クラウド・サービス・ポータルのリソース・モデルとの相互作用は、VDCではなくゾーン中心となります。

リソースへのmedia_type属性の追加

各リソースにmedia_type属性が追加され、汎用サービス・モデルのクライアント・イントロスペクションがサポートされます。つまり、同じ抽象メディア・タイプを展開する異なるメディア・タイプのリソースのリストをリソースのコレクション属性に含めることができます。

Webサービスとの相互作用をイントロスペクトできます。たとえば、クラウド・リソースには、様々なXaaSから取得されたサービス・テンプレートのリストを説明するservice_templates属性があります。

service_templates内の各サービス・テンプレート・アイテムは様々なメディア・タイプにできますが、これらのメディア・タイプには、汎用サービス・テンプレート・モデルのすべての属性を含める必要があります。

受入れヘッダーはオプションに

相互作用の目的が明白な場合、受入れヘッダーを指定する必要はありません。

WebサービスによってリソースURIが自動的にイントロスペクトされ、最も固有のメディア・タイプのリソースが返されます。

汎用メディア・タイプと固有メディア・タイプ

継承をサポートするため、このバージョンには汎用メディア・タイプと固有メディア・タイプの概念が導入されています。たとえば、application/oracle.com.cloud.common.ServiceTemplateは汎用メディア・タイプ、application/oracle.com.cloud.common.VMTemplateは前述の汎用タイプを展開する固有タイプです。

固有タイプから他の固有タイプを展開できます(オブジェクト継承と同様)。

汎用タイプを使用してリソースを照会できるようになりました。たとえば、URIが固有タイプYのリソースを表し、Yが汎用タイプXを展開する場合、GET URIは値Xの受入れヘッダーも受け入れます。

さらに、固有タイプYの属性には汎用タイプXの属性を含める必要があり、これにより、クライアントは汎用タイプのリソースと相互作用できるようになります。

45.4 共通の動作

この項では、Oracle Cloud Computing PlatformでサポートされるREST APIで発生するすべてのリクエストとレポートに適用される制約を指定します。

45.4.1 トランスポート・プロトコル

すべてのプラットフォームAPIは、ハイパーテキスト転送プロトコル(HTTP)バージョン1.1(RFC 2616)に基づいています。各リクエストは、特別の定めのないかぎり、HTTP基本認証(RFC 2617)を使用して認証されます。このため、公共インターネット(およびVPNなどの安全なチャネル以外)から送信されるリクエストはHTTPSプロトコルを使用する必要があります。

45.4.2 URI空間

システム内のリソースはURIによって識別されます。操作を開始するには、リソースのURIが既知である必要があります。URIを逆参照すると、リソース属性を含むリソースの表現および関連するリソースへのリンクが生成されます。

URIのレイアウトについての仮定またはリソースURIの構造は作成されません。

45.4.3 メディア・タイプ

この仕様では、リソース表現とリクエストの本文は、RFC 4627で指定されたとおりにJavaScript Object Notation (JSON)でエンコードされます。各リソース・タイプには、次のパターンと一致する独自のメディア・タイプがあります。

application/oracle.com.cloud.common.Xxxxx+json

Xxxxxは、各リソースの個別の表現形式に固有の識別子の一部です。この識別子は、vnd.com.oracle.cloudの空間でグローバルに一意である必要があります。また、メディア・タイプをRFC 4288に従って登録する必要があります。

プラットフォームには、JSONで使用できるすべてのリソースの表現が用意されている必要があります。プラットフォームは、JSONでエンコードされたリクエストを受け入れる必要があります。

45.4.4 リクエスト・ヘッダー

Oracle Cloud Platform APIを実装するサービスに対するリクエストでは、次の表に示すいくつかのHTTPヘッダーが使用されます。

表45-3 リクエスト・ヘッダー

ヘッダー

サポートされる値

説明

必須

Accept

メディア・タイプまたはメディア・タイプ・パターンのカンマ区切りリスト

受入れ可能なメディア・タイプをサーバーに示します。

レスポンス・メッセージ本文を生成するリクエストで推奨されます。

Authorization

「Basic」およびユーザー名とパスワード(RFC 2617に準拠して)。

このリクエストを作成したユーザーを識別します。

ほとんどのリクエストで必須。

Content-Length

リクエスト・メッセージ本文の長さ(バイト単位)。

メッセージ本文のサイズを示します。

メッセージ本文を含むリクエストでは必須。

Content-Type

リクエスト・メッセージ本文を示すメディア・タイプ。

リクエスト・メッセージ本文の表現と構文を示します。

メッセージ本文を含むリクエストでは必須。

Host

メッセージを受信するホストを識別します。

単一のIPアドレスで複数のオリジン・ホストをサポートするのに必要です。

すべてのリクエスト。

X-YYYYYClient-Specification-Version

仕様バージョン番号を含む文字列。

このクライアントがプログラムされたYYYYY APIの仕様バージョンを宣言します。

いいえ。

45.4.5 レスポンス・ヘッダー

次の表に、プラットフォームから返されるレスポンスに含まれる、特定のHTTPヘッダーを示します。

表45-4 レスポンス・ヘッダー

ヘッダー

サポートされる値

説明

必須

Content-Type

レスポンス・メッセージの本文を示すメディア・タイプ。

レスポンス・メッセージ本文の表現と構文を示します。

メッセージ本文を含むレスポンスでは必須。

Location

新しく作成されたリソースまたは参照された元のリソースの正規のURI。

リソース表現のリクエストに使用できるURIを返します。

新規リソースの作成リクエストまたは既存リソースの変更リクエストに対するレスポンスでは必須。

Cache-Control

Max-age、public、no-store、mustrevalidate、proxyrevalidate。

リソース表現をキャッシュする方法と、その鮮度を示します。

いいえ。頻繁には変更されないパブリック・リソース(パブリック・アセンブリやテンプレートのリストなど)の場合、緩やかなキャッシュ制約を許可してレスポンスを最適化します。

特権リソースや認可ヘッダーを含むリソース・リクエストで、これが返されることはありません。

45.4.6 HTTPステータス・コード

Oracle Cloud Computing Platform APIは、説明に示されている状況下で、次の表に示す標準のHTTPレスポンス・コードを返します。

表45-5 HTTPレスポンス・コード

ヘッダー

説明

100 Continue

クライアントは要求を継続する必要があります。この仮のレスポンスを使用して、プラットフォームで要求の最初の部分が受信され、まだ拒否されていないことをクライアントに通知します。クライアントはリクエストの残りを送信して続行します。リクエストがすでに完了している場合は、このレスポンスを無視します。

200 OK

リクエストは正常に完了しました。このリクエストによって、URIでアドレス可能な新規リソースが作成され、新規リソースの表現を含むレスポンス本文が返された場合、200ステータスは新しく作成されたリソースの正規のURIを含むLocationヘッダーとともに返されます。

201 Created

新規リソースを作成したリクエストは完了し、新規リソースの表現を含むレスポンス本文は返されません。新しく作成されたリソースの正規のURIを含むLocationヘッダーが返されます。

202 Accepted

要求の処理は受け入れられましたが、処理は完了していません。HTTP/1.1仕様どおり、返されるエンティティ(ある場合)にはリクエストの現在のステータスの表示が含まれる必要があります。まだ完了していないリソースの正規のURIを含むLocationヘッダーが、進行状況を示すステータス属性とともに返されます。

400 Bad Request

情報が欠落しているか不適切であるため(入力フィールドでの検証エラー、必須値の欠落など)、リクエストを処理できませんでした。

401 Unauthorized

このリクエストに認証資格証明がないか、または無効です。

403 Forbidden

資格証明はサーバーによって認識されましたが、ユーザーはこのリクエストを実行する権限を持っていません。

404 Not Found

リクエストで、存在しないリソースのURIが指定されました。

405 Method Not Allowed

リクエストで指定されたHTTP動詞(DELETE、GET、HEAD、POST、PUT)は、このリクエストURIではサポートされていません。

406 Not Acceptable

このリクエストによって識別されたリソースは、リクエストのAcceptヘッダーのいずれかのメディア・タイプに対応する表現を生成できません。

409 Conflict

プラットフォームでサポートされるリソースの現在の状態の競合の原因となるため、作成または更新リクエストを完了できません。たとえば、既存のリソースにすでに割り当てられている一意の識別子で新規リソースを作成しようとしたり、まだ完了していないリソース属性を変更しようとしました。

410 Gone

要求されたリソースはサーバーで使用できなくなりました。転送アドレスが不明です。この状況は永続的なものと想定されます。リンク編集機能を持つクライアントは、ユーザー承認の後でRequest-URIへの参照を削除する必要があります。

この状況が永続的であるかどうかをサーバーが特定できない、またはそのことを判断する機能がサーバーにない場合は、ステータス・コード404(Not Found)をかわりに使用する必要があります。このレスポンスはキャッシュ可能です(キャッシュ不可と指定されていない場合)。

412 Precondition Failed

1つ以上の要求ヘッダー・フィールドに指定されている事前条件が、サーバーでのテストで+と評価されました。クライアントはこのレスポンス・コードを使用して、現在のリソース・メタ情報(ヘッダー・フィールド・データ)に事前条件を設定できます。これにより、リクエストされたメソッドが目的外のリソースに適用されるのを阻止できます。

500 Internal Server Error

サーバーに予期しない状況が発生し、リクエストを遂行できなくなりました。

501 Not Implemented

サーバーは(現在)、要求を満たすために必要な機能をサポートしていません。

503 Service Unavailable

現在、サーバーは、一時的なオーバーロードまたはメンテナンスのため、要求を処理できません。

45.4.7 共通リソース属性

この仕様のすべてのリソース・エンティティには、次の共通リソース属性を含めることができます。

45.4.7.1 リソースの状態

この属性は、リソースのライフサイクルを示すリソースの状態を表します。これは、エンティティ固有のセマンティクを持つリソースによって表されるエンティティのステータスとは異なります。

次の表に、この属性のデータ・モデルを示します。

表45-6 ResourceStateデータ・モデル

フィールド

タイプ

説明

発生

state

文字列

リソースの最新の既知の現行状態。ライフサイクル状態を含むラベルです(例: INITIATED、CREATING、CREATED、DESTROYING、DESTROYED、READY)。

ベンダーの拡張機能がある場合、ベンダーはセマンティックを公開して文書化する必要があります。

1

progress

0から100の整数

進行状況をおおよそのパーセントで示します。すべてのstateラベルがこのフィールドに意味を与えるわけではありません。

0..1

messages

Message[]

注目すべきやり取りを示す、メッセージ・データ・モデル・インスタンスを含みます。

0..1

45.4.8 コレクション

この属性は、リソースのコレクション・フィールドを表すメタ・リソースです。たとえば、VDCにVMのコレクションが含まれ、VMのリストを表すフィールドがこのタイプに実装されます。

リソース・モデルでは、コレクション・フィールドはコレクション<タイプ>として示されます(例: コレクション<VM>)。

表45-7 コレクション<タイプ>データ・モデル

データ・モデル" title="コレクション<type>データ・モデル" width="100%">

フィールド

タイプ

説明

発生

uri

URI

エンティティのコレクションを表すURI。

1

type

文字列

このコレクションに含まれるエンティティのタイプ。

1

total

整数

要素リストで安全に収容できると想定される要素数合計。

0..1

elements

<TYPE>[]

このコレクション内のエンティティのリスト。エンティティのURIは、プラットフォームによって移入される必要があります。URIを逆参照する場合、クライアントはAcceptヘッダーのtypeフィールドを使用する必要があります(type = URIの場合を除く)。

返されない場合、コレクションは空白のリストです。

0..1

リソース・タイプの他に、コレクションはtypeフィールドがURIのコレクション<URI>もサポートしています。この基本的なタイプ・コレクションには、URIを適切に逆参照できる追加のタイプ・キャストが必要です。

この基本的なタイプ・コレクションには、URIを適切に逆参照できる追加のタイプ・キャストが必要です。コレクション・タイプのコレクションを持つこともできます(例: コレクション<コレクション<サーバー>>)。

45.4.9 エラー・レスポンス・メッセージ

リクエストが成功すると、一般にリクエストしたアクションが正常に実行または送信されたことを示す、200 (OK)、201 (Created)、202 (Accepted)または204 (No Content)などのHTTPステータス・コードが返されます。

さらに、リクエストした情報の表現を含むレスポンス・メッセージ本文(適切なメディア・タイプの)が含まれることもあります。しかし、エラーが発生することもあります。

様々な根本的な原因が、400-499(クライアント側のエラー)または500-599(サーバー側の問題)の範囲のHTTPステータス・コードによって示されます。

レスポンスがエラー・ステータス・コード(400-499または500-599)で返される場合、エラーの内容を示すゼロ以上のメッセージ・データ・モデルを含むレスポンス・メッセージ本文も返されます。これらのメッセージのテキスト値は、クライアント側アプリケーションのユーザーとのやり取りなどに使用されます。

1つのエラー・レスポンスに含まれるメッセージのリスト全体が、メッセージ・データ・モデルにカプセル化されます。メディア・タイプはContent-Typeヘッダーで返されます。クライアントはMessagesメディア・タイプをAcceptヘッダーに含めることはできません。

表45-8 メッセージ・データ・モデル

フィールド

タイプ

説明

発生

messages

Message

個別メッセージごとに、ゼロ以上のメッセージ・データ。

0..n

個別メッセージには、次のフィールドが含まれます。

表45-9 個別メッセージ・データ・モデル

フィールド

タイプ

説明

発生

code

文字列

個別メッセージごとに、ゼロ以上のメッセージ・データ。

0..1

field

文字列

このメッセージが関連付けられているリクエスト・データ・モデルのフィールド名。

0..1

hint

文字列

問題の性質を示す、ローカライズされたテキスト。クライアントが試すことのできた可能性のある回避策が含まれることがあります。

0..1

text

文字列

このメッセージによりレポートされた問題の性質を示す、ローカライズされたテキスト。

1

severity

文字列

このメッセージで示されたエラー状態の重大度を表すラベル。

ベンダーは、このフィールドに関連する列挙子とそのセマンティックを公開する必要があります。

0..1

stack_trace

文字列

このメッセージに関連するベンダー固有のスタック・トレース。

0..1

source

文字列

このメッセージをトリガーしたサービス実装コンポーネントのシンボリック識別子。

0..1

46 クラウドのリソース・モデル

この章では、REST APIで操作するリソースの表現について説明します。内容は次のとおりです。

- Enterprise Managerクラウド・リソース・モデル10001

- クラウドのリソースの概要

- リソースのデータ・モデル

46.1 Enterprise Managerクラウド・リソース・モデル10001

このバージョンのクラウド・リソース・モデルはCloud Service PortalプラグインのXaaS実装を結集させたものであり、追加のサービス・タイプを使用してサービス・インスタンスの作成およびライフサイクル管理をサポートできます。

Enterprise Manager Cloud ControlのCloud Service Portalプラグインのこのリリースでは、クライアントが/em/cloudにアクセスする場合、10001がデフォルト・バージョンです。特に、クライアントはHTTPヘッダーでx-specification-version: 10001を指定して、リソースでバージョン10001がサポートされるかどうかを確認できます。1つのリクエストに異なるバージョンのリソース・タイプを混在させることはできないことに注意してください。たとえば、コンテンツがリソースの10000バージョンの形をしている場合、10001はリクエストを拒否することがあります。

次の表で、最上位レベルのリソースについて説明します。

表46-1 最上位レベルのリソースの説明

リソース

説明

application/oracle.com.cloud.common

このメディア・タイプ・ネームスペースには、XaaS実装のリソース・タイプに固有でない共通リソースが含まれます。XaaS実装では通常、accept/content-typeがベース・タイプのリクエストに応答することで、共通リソース・タイプを拡張します。これは、いつでもベース・クラスを実装クラスにタイプキャストできるJavaのクラスの型付けと似ています。

Cloud

これは、クライアントがクラウド全体の上位レベル・ビューを取得できる、エントリ・ポイント/em/cloudの最上位レベルのメディア・タイプです。

ServiceTemplate

これは、各XaaSがサービス・インスタンスを作成するために拡張できるサービス・テンプレートを表す、共通メディア・タイプです。

ServiceInstance

サービス・インスタンスを表す、共通メディア・タイプです。各XaaSはこのメディア・タイプを拡張して、サポートするサービス・インスタンスを表します。

ServiceFamilyType

XaaSまたはサービス・ファミリを表します。

InstanceType

サービス・インスタンスのタイプを表します。たとえば、VMはServiceInstanceを拡張するメディア・タイプで、VMインスタンスに含まれる内容を示す対応するInstanceType?があります。

Metric

リソースのメトリックを表します。たとえば、CPU使用率およびネットワーク使用率などのパフォーマンス・メトリックは、VMインスタンスのメトリックです。パフォーマンス・メトリックのみに制限する必要はありません。測定可能または監視可能な時系列データすべて、メトリックとして表すことができます。

MultipartMetric

メトリックを拡張しますが、多次元の監視を表します。

CloudInteractions

クラウドでサポートされる相互作用のコレクションを表します。このリソースのデータは、プロトコルに依存します。たとえば、HTTPプロトコルでは、データはサポートされているHTTPリクエストの3つのセット(requestメソッド、acceptタイプ、コンテンツ・タイプ)で構成されます。

QuotaUsage

サービス・ファミリのコンテキストにおける割当て制限情報を表します。

46.2 クラウドのリソースの概要

クラウドのリソース表現は、それぞれに名前と値があるフィールドで構成され、JavaScript Object Notation (JSON)ディクショナリを使用してエンコードされます。値には、RFC 4627に従ったJSON形式のリスト、ディクショナリ、数値または文字列リテラルを指定できます。

各クラウド・リソース・タイプは、それぞれ独自のインターネット・メディア・タイプを持ちます。メディア・タイプはapplication/oracle.com.cloud.common.Xxxxxxxx+jsonというパターンにする必要があり、各リソース・モデル固有のメディア・タイプが対応するセクション・ヘッダーに角カッコで囲まれて含められます。

クラウドのリソースは現在、共通サービス・エンティティで編成されており、特定のサービス(Infrastructure as a Serviceなど)が共通サービス・エンティティを拡張するリソースを提供しています(該当する場合)。次の図は、共通リソースとInfrastructure as a Service固有のリソースとのリソース・モデル関係を示しています。

図46-1 クラウドのリソース・モデル

46.3 リソースのデータ・モデル

次の項では、様々なクラウド・リソースのデータ・モデルについて詳しく説明します。

46.3.1 クラウド[application/oracle.com.cloud.common.Cloud+json]

クラウドは、アクセス可能なすべてのリソースのユーザーの開始ビューを表します。次の表では、クラウドのデータ・モデルについて説明します。

表46-2 クラウドのデータ・モデル

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

12.1.0.1

name

文字列

1

ユーザー用の名前。様々な言語をサポートするUNICODE文字列です。

12.1.0.1

description

文字列

0..1

簡単な説明。様々な言語をサポートするUNICODE文字列です。

12.1.0.1

service_templates

コレクション<ServiceTemplates>

0..1

ユーザーがアクセス可能なサービス・テンプレートのリスト。

12.1.0.4

service_family_types

コレクション<ServiceFamilyType>

0..1

クラウドでサポートされるサービス・ファミリ・タイプのリスト。

12.1.0.4

zones

コレクション<ゾーン>

0..1

クラウドでサポートされる、ユーザーがアクセス可能なゾーンのリスト。

12.1.0.2

resource_state

ResourceState

0..1

実行中のオンラインのクラウドの状態はREADYです。このフィールドが返されない場合、クライアントはクラウドがREADYであると想定できます。返されたフィールドの状態がREADYでない場合、クライアントはクラウドへのその後の相互作用の実行可能性を想定できません。

12.1.0.1

media_type

文字列

1

このメディア・タイプのペイロード形式の値。例: application/oracle.com.cloud.common.Cloud+json。

12.1.0.4

46.3.2 ServiceTemplate [application/oracle.com.cloud.common.ServiceTemplate+json]

ServiceTemplateは、デプロイ可能なサービスの定義を表します。ユーザーにとって、ServiceTemplateはデプロイ可能なサービスの定義を表します。ユーザーはServiceTemplateのURIと相互作用して、クラウドのリソースを作成できます。クラウドは、リソースとその構成をServiceTemplateの定義で指定されているとおりにインスタンス化する必要があります。

VMTemplateはServiceTemplateリソースのサブクラスであるため、VMTemplateのURIからServiceTemplateを取得できます。次の表に、ServiceTemplateデータ・モデルを示します。

表46-3 ServiceTemplateデータ・モデル

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、このユーザーに対するServiceTemplate定義のクライアント表現がリフレッシュされます。

12.1.0.4

name

文字列

1

ServiceTemplateのユーザー用の名前。様々な言語をサポートするUNICODE文字列です。

12.1.0.4

description

文字列

0..1

ServiceTemplateの簡単な説明。様々な言語をサポートするUNICODE文字列です。

12.1.0.4

type

文字列

1

サービス・テンプレートのタイプを示す文字列。

12.1.0.4

created

Timestamp

1

ServiceTemplateが作成された日付と時刻(ISO 8601形式)。

12.1.0.4

service_family_type

文字列

0..1

このサービス・テンプレートを分類するサービス・ファミリ・タイプの名前。

12.1.0.4

default_instance_media_type

文字列

0..1

このテンプレートを使用して作成できるサービス・インスタンスのデフォルト・メディア・タイプ。

たとえば、VMTemplateでこの属性をVMに指定して、VMTemplateをVMサービス・インスタンスにデプロイ可能なことを示します。

12.1.0.4

resource_state

ResourceState

1

READY状態のサービス・テンプレートのみデプロイできます。

12.1.0.4

deployment_params

デプロイメント・パラメータのリスト

0..1

デプロイメント・パラメータのデータ構造のリストが含まれ、このテンプレートを使用してサービス・インスタンスのデプロイ時に指定できるパラメータを示します

12.1.0.4

zones

ゾーンのリスト

0..1

このサービス・テンプレートを使用してサービス・インスタンスを作成できるゾーン・リソースのリストが含まれます

12.1.0.4

service_instances

コレクション<?>

0..1

このテンプレートで作成されるサービス・インスタンスのリストが含まれます。

12.1.0.4

次の表に、デプロイメント・パラメータの構造を示します。

表46-4 デプロイメント・パラメータの構造

フィールド

タイプ

発生

説明

name

文字列

1

デプロイ時に指定する必要のあるパラメータの名前。

description

文字列

0..1

デプロイメント・パラメータの簡単な説明。

type

文字列

1

デプロイメント・パラメータのタイプ。値STRING、INTEGER、NUMBERおよびLISTの列挙です。

default_value

文字列

0..1

このパラメータのデフォルト値。

required

Boolean

1

このパラメータが必須の場合はTRUE、そうでない場合はFALSE。

sensitive

Boolean

1

このパラメータがパスワードを指す場合はTRUE。そうでない場合はFALSE。

46.3.3 ゾーン[application/oracle.com.cloud.common.Zone+json]

ゾーンは、リソースを配置できる論理境界を表します。ゾーンはヨーロッパ・ゾーン、北米ゾーン、東アジア・ゾーンなど、特定の地理的な場所を表すことができます。ゾーンは高帯域幅ネットワークや保護されたDMZなどの特性を表すこともできます。さらに、ゾーンを財務部門ゾーン、テスト・ゾーン、開発ゾーンなどの組織にすることもできます。

特に定めのないかぎり、ゾーンの基礎となるインフラストラクチャの排他性を想定することはできません。たとえば、ゾーンAとゾーンBは、2つの異なる部門にサービスを提供する同じ物理ネットワーク上に配置できますが、その物理インフラストラクチャ設定はクラウド・ユーザーには見えません。

表46-5 ゾーンのデータ・モデル

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、このユーザーに対するゾーン定義のクライアント表現がリフレッシュされます。

12.1.0.1

name

文字列

1

ゾーンの名前。

12.1.0.1

description

文字列

0..1

ゾーンのユーザー用の説明。様々な言語をサポートするUNICODE文字列です。

12.1.0.1

media_type

文字列

1

リソースのメディア・タイプ。

12.1.0.4

resource_state

ResourceState

0..1

リソースのリソース状態。

12.1.0.1

service_family_type

文字列

0..1

このゾーンが関連付けられているサービス・ファミリ・タイプの名前。

各ゾーンはサービス・ファミリ・タイプのコンテキストに当てはめられます。

12.1.0.4

service_templates

コレクション<ServiceTemplate>

0..1

このゾーンがサポートする、このゾーンをデプロイ可能なサービス・テンプレートのコレクション。

12.1.0.4

service_instances

コレクション<ServiceInstance>

0..1

このゾーン内にあるサービス・インスタンスのコレクション。

12.1.0.4

46.3.4 サービス・ファミリ・タイプ[application/oracle.com.cloud.common.ServiceFamilyType+json]

サービス・ファミリ・タイプは、クラウドによって提供されるサービスのカテゴリです。たとえば、IaaSはインフラストラクチャ・サービスをカプセル化するカテゴリです。Mwaasはミドルウェア・サービスをカプセル化するカテゴリです。これらのカテゴリは事前定義されています。

次の表で、ServiceFamilyTypeデータ・モデルについて説明します

表46-6 サービス・ファミリ・タイプ

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、このユーザーに対するServiceFamilyType定義のクライアント表現がリフレッシュされます。

12.1.0.4

name

文字列

1

ServiceFamilyTypeの名前。

12.1.0.4

description

文字列

0..1

サービス・ファミリ・タイプのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

12.1.0.4

resource_state

ResourceState

0..1

リソースのリソース状態。

12.1.0.4

media_type

文字列

1

リソースのメディア・タイプ。

12.1.0.4

service_templates

コレクション<ServiceTemplate>

0..1

このサービス・ファミリ・タイプのサービス・テンプレートのコレクション。

12.1.0.4

zones

コレクション<ゾーン>

0..1

このサービス・ファミリ・タイプのサービス・インスタンスをサポートするゾーンのコレクション。

12.1.0.4

instance_types

コレクション<InstanceType>

0..1

このサービス・ファミリ・タイプによってサポートされるインスタンス・タイプのコレクション。

12.1.0.4

quota_usages

コレクション<QuotaUsage>

0..1

認証済ユーザーのパースペクティブ・ファミリ・タイプの割当て制限使用量のコレクション。

12.1.0.5

quota_def

Jsonオブジェクト

0..1

ファミリ・タイプ固有の割当て制限メタデータ情報で、いくつかの権限情報が含まれることがあります。

このオブジェクトの構造は、パースペクティブ・ファミリ・タイプ・リソース・モデルで文書化されます。

12.1.0.5

46.3.5 サービス・インスタンス・タイプ[application/oracle.com.cloud.common.InstanceType+json]

サービス・インスタンス・タイプは、タイプのサービス・インスタンスの共有メタデータを示します。タイプのサービス・インスタンスがクラスのインスタンス化であるクラスに例えることができます。

次の表で、ServiceFamilyTypeデータ・モデルについて説明します。

表46-7 サービス・インスタンス・タイプ

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、このユーザーに対するServiceInstanceType定義のクライアント表現がリフレッシュされます。

12.1.0.4

name

文字列

1

ServiceInstanceTypeの名前。

12.1.0.4

description

文字列

0..1

サービス・インスタンス・タイプのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

12.1.0.4

resource_state

ResourceState

0..1

リソースのリソース状態。

12.1.0.4

media_type

文字列

1

リソースのメディア・タイプ。

12.1.0.4

instance_media_type

文字列

0..1

このタイプのインスタンスのメディア・タイプ。

12.1.0.4

metrics

リスト<リスト<文字列>>

0..1

インスタンス・タイプでサポートされるメトリックのリスト。各リスト要素は、メトリックの名前、説明、タイプの3つのセットを表します。

12.1.0.4

46.3.6 メトリック[application/oracle.com.cloud.common.Metric+json]

このリソースは、パフォーマンスまたは構成に関連する時系列データを表します。たとえば、CPU使用率はVMリソースのメトリック、表領域使用率はデータベース・リソースのメトリックです。

次の表で、メトリック・データ・モデルについて説明します。

表46-8 メトリック・データ・モデル

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、このユーザーに対するメトリック定義のクライアント表現がリフレッシュされます。

12.1.0.4

name

文字列

1

メトリックの名前。

12.1.0.4

description

文字列

0..1

メトリックのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

12.1.0.4

resource_state

ResourceState

0..1

リソースのリソース状態。

12.1.0.4

media_type

文字列

1

リソースのメディア・タイプ。

12.1.0.4

type

文字列

1

メトリック値のタイプ。STRING、INTEGER、PERCENTAGE、NUMBER、MIXの列挙です。

12.1.0.4

current_value

文字列

0..1

メトリックの最新の既知の値

12.1.0.4

current_time

ISO 8601日付

0..1

current_valueが最後に確認されたUTC時間

12.1.0.4

time_range

2つのISO 8601日付のリスト

0..1

最初の日付が開始日で、次の日付が終了日です。この範囲により、"values"属性の時系列ウィンドウが決定されます

12.1.0.4

rollup_unit

文字列

0..1

時系列データのロールアップ単位。DAY、DAILY、DAYLY、HOUR、HOURLY、RAWのいずれかを指定できます

12.1.0.4

values

オブジェクトのリスト

0..1

rollup_unit = RAWの場合、これは時間指定された監視を示す、それぞれに"time_utc"および"value"属性を含むオブジェクトのリストです。

他のすべてのrollup_unitの場合、これはサポートされている集計された監視を示す、それぞれに"time_utc"、"average"、"min"、"max"、"std"属性を含むオブジェクトのリストです。

12.1.0.4

time_range_epoch

2つの数値のリスト

0..1

time_rangeと同じですが、Epoch時間形式です。

12.1.0.4

46.3.7 サービス・インスタンス[application/oracle.com.cloud.common.ServiceInstance+json]

サービス・インスタンスは、サービス・インスタンスのいくつかの共有メタデータを示します。これは抽象メディア・タイプで、実際の実装は各XaaSサービスによって提供されます。拡張リソースは、この抽象メディア・タイプのGETリクエストに適合すると予想されます。

次の表で、サービス・インスタンス・データ・モデルについて説明します。

表46-9 サービス・インスタンス・データ・モデル

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、このユーザーに対するServiceInstance定義のクライアント表現がリフレッシュされます。

12.1.0.4

name

文字列

1

ServiceInstanceの名前。

12.1.0.4

description

文字列

0..1

サービス・インスタンスのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

12.1.0.4

resource_state

ResourceState

1

リソースのリソース状態。

12.1.0.4

media_type

文字列

1

リソースのメディア・タイプ。

12.1.0.4

metrics

コレクション<メトリック>

0..1

リソースで監視されるメトリックのコレクション。

12.1.0.4

service_family_type

文字列

1

このサービス・インスタンスのコンテキストであるServiceFamilyTypeの名前。

12.1.0.4

status

文字列

0..1

サービス・インスタンスによって表されるエンティティのステータス。たとえば、サービス・インスタンスVMの場合、値はSTARTED、STOPPEDまたはVMに適したその他の値になります。各拡張リソースは、適用可能なステータスの列挙を示します。

12.1.0.4

created

ISO 8601日付

0..1

サービス・インスタンスが作成された日付。

12.1.0.4

46.3.8 割当て制限使用量[application/oracle.com.cloud.common.QuotaUsage+json]

割当て制限使用量は、サービス・ファミリ・タイプのコンテキストで使用される認証によって使用されるいくつかのリソースの量を説明します。たとえば、IaaSでは、CPU、メモリー、サーバー数に割当て制限が定義され、それぞれの使用量は割当て制限使用量リソースにカプセル化されています。

次の表では、割当て制限使用量のデータ・モデルについて説明します。

表46-10 QuotaUsageデータ・モデル

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、QuotaUsageのクライアント表現がリフレッシュされます。

12.1.0.5

name

文字列

1

QuotaUsageの名前。

12.1.0.5

description

文字列

0..1

サービス・インスタンスのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

12.1.0.5

media_type

文字列

1

リソースのメディア・タイプ。

12.1.0.5

id

文字列

1

リソースのID表現。

12.1.0.5

type

文字列

1

リソースのサービス・ファミリ・タイプ。

12.1.0.5

used

Number

1

使用されるリソースの量。タイプは、unit属性によって表現されます。

12.1.0.5

maxAllowed

Number

0..1

認証済ユーザーが使用する可能性があるリソースの最大量。

12.1.0.5

unit

文字列

1

リソースの単位。

12.1.0.5

46.3.9 サービス・テンプレート検索[application/oracle.com.cloud.common.ServiceTemplateFinds+json]

サービス・テンプレート検索は、検索基準が指定されたクラウド全体でサービス・テンプレートを検索およびフィルタリングするリソースです。各サービス・ファミリ・タイプでは、サポート範囲が文書化されます(フィルタ属性のリストなど)。

次の表では、サービス・テンプレート検索のデータ・モデルについて説明します。

表46-11 ServiceTemplateFindsデータ・モデル

フィールド

タイプ

発生

説明

開始

uri

URI

1

このURIに対してGETを実行すると、ServiceTemplateFindsのクライアント表現がリフレッシュされます。

検索条件に合うサービス・テンプレートが追加/削除された場合、リンクをリフレッシュすると変更が反映されます。

12.1.0.5

name

文字列

1

ServiceTemplateFindsの名前。

12.1.0.5

description

文字列

0..1

サービス・インスタンスのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

12.1.0.5

filters

Jsonオブジェクト

1

フィルタ条件を示すキー値のペアのマップ。

12.1.0.5

finds

コレクション<*>

1

フィルタ基準を満たすエンティティのコレクション(サービス・テンプレートのサブ・タイプになることがあります)。

12.1.0.5

次の表では、フィルタでサポートされる属性について説明します。

表46-12 フィルタ属性

属性

説明

開始

media_type

検索する特定のサービス・テンプレート・メディア。これは、メディア・タイプの完全一致になります。

12.1.0.5 Cloud Service Portalプラグイン(IaaSサービス・ファミリ・タイプのみ)

name

名前に指定の文字列が含まれる場合は、サービス・テンプレートが返されます。大文字と小文字は区別されないため、OELとoelは同じ結果を返します。

12.1.0.5 Cloud Service Portalプラグイン(IaaSサービス・ファミリ・タイプのみ)

46.4 クラウドREST APIの例

次の各項では、Enterprise Manager Cloud Control 12.1.0.2と12.1.0.5 Cloud Service Portalプラグインとの異なる相互作用の例を示します。これらの例では、様々なリソースの構造を示しています。このバージョンでは、デフォルトのx-specification-versionは10001と想定されます。

46.4.1 クラウド・リソース

最上位の/em/cloudを使用してクラウド・リソースをイントロスペクトします。次の表では、GETメソッド機能について説明します。

表46-13 クラウド・リソースのGETメソッド

機能

説明

URL

https://example.oracle.com/em/cloud

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI

=X-specification-Version: 10001

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

次により、クラウド・リソースが返されます。

{
"uri" : "/em/cloud" ,
"name" : "Oracle Cloud by Enterprise Manager" ,
"description" : "This represents the Cloud resource of the Oracle Enterprise Manager Cloud Management solution" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.common.Cloud+json" ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.common.Zone+json" ,
"total" : "3" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/zone/450121204B4703131FC0FDD72E7BF494" ,
"name" : "PaaS_Zone_Middleware" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas"
} ,
{
"uri" : "/em/cloud/opc/opczone" ,
"name" : "OPC Zone" ,
"media_type" : "application/oracle.com.cloud.opc.OpcZone+json" ,
"service_family_type" : "opc" ,
"type" : "opc"
} ,
{
"uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" ,
"name" : "cloud_zone" ,
"media_type" : "application/oracle.com.cloud.iaas.Zone+json" ,
"service_family_type" : "iaas" ,
"type" : "VM_ZONE"
}
]
} ,
"service_templates" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" ,
"total" : "7" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1" ,
"name" : "template_sanity" ,
"media_type" : "application/oracle.com.cloud.common.VMTemplate+json" ,
"service_family_type" : "iaas" ,
"type" : "Template"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1" ,
"name" : "sidb_assembly" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"service_family_type" : "iaas" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC769B1F361529309E040578CDA813D57%3A0.1" ,
"name" : "wls_assembly" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"service_family_type" : "iaas" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76F733BC7A41AF7E040578CDA812CDC%3A0.1" ,
"name" : "fmw_venkat" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"service_family_type" : "iaas" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C144A4A245B62E040578CDA8163B9%3A0.1" ,
"name" : "fmw_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"service_family_type" : "iaas" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC77122B0A916D95CE040578CDA814854%3A0.1" ,
"name" : "sidbasmA_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"service_family_type" : "iaas" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C8792DE2A0937E040578CDA81795E%3A0.1" ,
"name" : "WLS_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"service_family_type" : "iaas" ,
"type" : "Assembly"
}
]
} ,
"service_family_types" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"total" : "4" ,
"elements" :
[
{
"uri" : "/em/cloud/service_family_type/jaas" ,
"name" : "jaas" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "jaas"
} ,
{
"uri" : "/em/cloud/service_family_type/dbaas" ,
"name" : "dbaas" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "dbaas"
} ,
{
"uri" : "/em/cloud/service_family_type/opc" ,
"name" : "opc" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "opc"
} ,
{
"uri" : "/em/cloud/service_family_type/iaas" ,
"name" : "iaas" ,
"media_type" : "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json" ,
"type" : "iaas"
}
]
}
}

注意:
許容タイプは指定されていませんが、Webサービスによりクラウド・リソースが"/em/cloud"アドレスとして明確に返されます。このアドレスは、クラウドを返されるデフォルト・リソースとして一意に識別します。

次の表では、特定の属性を選択するクラウド・リソースを示します。

表46-14 クラウド・リソースのGETメソッド

機能

説明

URL

https://example.oracle.com/em/cloud?service_family_types,name

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

選択的属性を次に示します。

{
"name" : "Oracle Cloud by Enterprise Manager" ,
"service_family_types" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"total" : "4" ,
"elements" :
[
{
"uri" : "/em/cloud/service_family_type/jaas" ,
"name" : "jaas" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "jaas"
} ,
{
"uri" : "/em/cloud/service_family_type/dbaas" ,
"name" : "dbaas" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "dbaas"
} ,
{
"uri" : "/em/cloud/service_family_type/opc" ,
"name" : "opc" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "opc"
} ,
{
"uri" : "/em/cloud/service_family_type/iaas" ,
"name" : "iaas" ,
"media_type" : "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json" ,
"type" : "iaas"
}
]
}
}

この機能は、選択的属性のみが収集されてクライアントに返される、すべての共通リソースでサポートされます。

46.4.2 サービス・ファミリ・タイプ・リソース

次の表では、サービス・ファミリ・タイプ・リソースの機能を示します。

表46-15 サービス・ファミリ・タイプ・リソース

機能

説明

URL

https://example.oracle.com/em/cloud/service_family_type/iaas

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

この相互作用で返されるヘッダーとコンテンツは次のとおりです。

X-specification-version: 10001
Content-Type: application/oracle.com.cloud.iaas.IaasServiceFamilyType+json; charset=ISO-8859-1
{
"uri" : "/em/cloud/service_family_type/iaas" ,
"name" : "iaas" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json" ,
"type" : "iaas" ,
"service_templates" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" ,
"total" : "7" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1" ,
"name" : "template_sanity" ,
"media_type" : "application/oracle.com.cloud.common.VMTemplate+json" ,
"type" : "Template"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1" ,
"name" : "sidb_assembly" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC769B1F361529309E040578CDA813D57%3A0.1" ,
"name" : "wls_assembly" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76F733BC7A41AF7E040578CDA812CDC%3A0.1" ,
"name" : "fmw_venkat" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C144A4A245B62E040578CDA8163B9%3A0.1" ,
"name" : "fmw_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC77122B0A916D95CE040578CDA814854%3A0.1" ,
"name" : "sidbasmA_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C8792DE2A0937E040578CDA81795E%3A0.1" ,
"name" : "WLS_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
}
]
} ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.common.Zone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" ,
"name" : "cloud_zone" ,
"media_type" : "application/oracle.com.cloud.iaas.Zone+json" ,
"service_family_type" : "iaas" ,
"type" : "VM_ZONE"
}
]
} ,
"instance_types" :     {
"media_type" : "application/oracle.com.cloud.common.InstanceType+json" ,
"total" : "2" ,
"elements" :
[
{
"uri" : "/em/cloud/instance_type/vm%40iaas" ,
"name" : "vm" ,
"media_type" : "application/oracle.com.cloud.common.InstanceType+json" ,
"instance_media_type" : "application/oracle.com.cloud.common.VM+json"
} ,
{
"uri" : "/em/cloud/instance_type/assembly%40iaas" ,
"name" : "assembly" ,
"media_type" : "application/oracle.com.cloud.common.InstanceType+json" ,
"instance_media_type" : "application/oracle.com.cloud.common.AssemblyInstance+json"
}
]
} ,
"quota_usages" :     {
"media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" ,
"total" : "6" ,
"elements" :
[
{
"uri" : "/em/cloud/quota_usage/iaas_3" ,
"name" : "Local Storage Quota" ,
"description" : "Local Storage Quota" ,
"context_id" : "3" ,
"media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" ,
"used" : "10240" ,
"maxAllowed" : "2000" ,
"unit" : "GB"
} ,
{
"uri" : "/em/cloud/quota_usage/iaas_2" ,
"name" : "RAM Quota" ,
"description" : "RAM Quota" ,
"context_id" : "2" ,
"media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" ,
"used" : "512" ,
"maxAllowed" : "600000" ,
"unit" : "MB"
} ,
{
"uri" : "/em/cloud/quota_usage/iaas_1" ,
"name" : "CPU Quota" ,
"description" : "CPU Quota" ,
"context_id" : "1" ,
"media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" ,
"used" : "1" ,
"maxAllowed" : "100" ,
"unit" : "COUNT"
} ,
{
"uri" : "/em/cloud/quota_usage/iaas_6" ,
"name" : "Servers Quota" ,
"description" : "Servers Quota" ,
"context_id" : "6" ,
"media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" ,
"used" : "1" ,
"maxAllowed" : "20" ,
"unit" : "COUNT"
} ,
{
"uri" : "/em/cloud/quota_usage/iaas_5" ,
"name" : "SWLIB Storage Quota" ,
"description" : "SWLIB Storage Quota" ,
"context_id" : "5" ,
"media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" ,
"used" : "0" ,
"maxAllowed" : "-1" ,
"unit" : "GB"
} ,
{
"uri" : "/em/cloud/quota_usage/iaas_4" ,
"name" : "Extra Storage Quota" ,
"description" : "Extra Storage Quota" ,
"context_id" : "4" ,
"media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" ,
"used" : "0" ,
"maxAllowed" : "-1" ,
"unit" : "GB"
}
]
} ,
"quota_def" :     {
"uri" : "/em/cloud/iaas/quota" ,
"name" : "iaas Quota" ,
"description" : "iaas Quota" ,
"media_type" : "application/oracle.com.cloud.iaas.Quota+json"
} ,
"instance_options" :
[
{
"name" : "Medium" ,
"cpu" : "4" ,
"memory" : "8192" ,
"local_storage" : "512000" ,
"id" : "2"
} ,
{
"name" : "Large" ,
"cpu" : "8" ,
"memory" : "15360" ,
"local_storage" : "1024000" ,
"id" : "3"
} ,
{
"name" : "Small" ,
"cpu" : "2" ,
"memory" : "4096" ,
"local_storage" : "256000" ,
"id" : "1"
}
]
}

application/oracle.com.cloud.iaas.IaasServiceFamilyType+jsonメディア・タイプが詳細リソースとして自動的に返されます。同様に、共通タイプを受け入れることでシステムと相互作用できます。

表46-16 サービス・ファミリ・タイプ・リソース

機能

説明

URL

https://example.oracle.com/em/cloud/service_family_type/iaas

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Accept-Type: application/oracle.com.cloud.common.ServiceFamilyType+json

メソッド

GET

Webサービスによって、前の相互作用で示されたコンテンツが返されます。

46.4.3 割当て制限リソース

次の表では、IaaSサービスの割当て定義をイントロスペクトするためにIaaSサービス・ファミリ・タイプを介して公開される、割当て制限リソースについて説明します。

表46-17 サービス・ファミリ・タイプ・リソース

機能

説明

URL

https://example.oracle.com/em/cloud/iaas/quota

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.5 Cloud Service Portalプラグイン

次の例では、この相互作用で返されるヘッダーとコンテンツを示します。

X-specification-version: 10001
Content-Type: application/oracle.com.cloud.iaas.Quota+json; charset=ISO-8859-1
{
"uri" : "/em/cloud/iaas/quota" ,
"name" : "iaas Quota" ,
"description" : "iaas Quota" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.iaas.Quota+json" ,
"service_family_type" : "iaas" ,
"allowedSaveToSwlib" : "1" ,
"allowedSaveToSwlibOnExpiry" : "0" ,
"resourceQuotas" :     {
"total" : "6" ,
"elements" :
[
{
"name" : "Local Storage Quota" ,
"description" : "Local Storage Quota" ,
"maxAllowed" : "2000" ,
"unit" : "GB"
} ,
{
"name" : "RAM Quota" ,
"description" : "RAM Quota" ,
"maxAllowed" : "600000" ,
"unit" : "MB"
} ,
{
"name" : "CPU Quota" ,
"description" : "CPU Quota" ,
"maxAllowed" : "100" ,
"unit" : "COUNT"
} ,
{
"name" : "Servers Quota" ,
"description" : "Servers Quota" ,
"maxAllowed" : "20" ,
"unit" : "COUNT"
} ,
{
"name" : "SWLIB Storage Quota" ,
"description" : "SWLIB Storage Quota" ,
"maxAllowed" : "-1" ,
"unit" : "GB"
} ,
{
"name" : "Extra Storage Quota" ,
"description" : "Extra Storage Quota" ,
"maxAllowed" : "-1" ,
"unit" : "GB"
}
]
}
}

46.4.4 サービス・インスタンス・タイプ・リソース

これは、特定のサービス・ファミリ・タイプによって提供されるサービスのタイプを説明するリソースです。

表46-18 サービス・インスタンス・タイプ・リソース

機能

説明

URL

https://example.oracle.com/em/cloud/instance_type/vm%40iaas

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

次に、サービス・インスタンス・タイプ・リソースを示します。

{
"uri" : "/em/cloud/instance_type/vm%40iaas" ,
"name" : "vm" ,
"description" : "A Virtual Machine represents a computational unit that contains CPU, Memory, Network Instances, and Disks" ,
"media_type" : "application/oracle.com.cloud.common.InstanceType+json" ,
"instance_media_type" : "application/oracle.com.cloud.common.VM+json" ,
"metrics" :
[
[
"CPU_Utilization" ,
"CPU Utilization of the Server" ,
"GENERIC"
] ,
[
"Total_Network_Throughput" ,
"Total Network Throughput of the Server" ,
"GENERIC"
] ,
[
"Total_Disk_Throughput" ,
"Total Disk Throughput of the Server" ,
"GENERIC"
] ,
[
"Filesystem_Total_Used" ,
"Summary of the total file system usage" ,
"GENERIC"
]
] ,
"instance_options" :
[
{
"name" : "Medium" ,
"cpu" : "4" ,
"memory" : "8192" ,
"local_storage" : "512000" ,
"id" : "2"
} ,
{
"name" : "Large" ,
"cpu" : "8" ,
"memory" : "15360" ,
"local_storage" : "1024000" ,
"id" : "3"
} ,
{
"name" : "Small" ,
"cpu" : "2" ,
"memory" : "4096" ,
"local_storage" : "256000" ,
"id" : "1"
}
]
}

46.4.5 ゾーン・リソース

次の表では、ゾーン・リソースの機能を示します。

表46-19 ZoneResource

機能

説明

URL

https://example.oracle.com/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

次に、application/oracle.com.cloud.iaas.Zone+jsonメディア・タイプに自動的にキャストするゾーン・リソースを示します。

{
"uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" ,
"name" : "cloud_zone" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "D73AF0D42C8459E11419862797D1F37D" ,
"media_type" : "application/oracle.com.cloud.iaas.Zone+json" ,
"service_family_type" : "iaas" ,
"type" : "VM_ZONE" ,
"service_templates" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" ,
"total" : "7" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1" ,
"name" : "template_sanity" ,
"media_type" : "application/oracle.com.cloud.common.VMTemplate+json" ,
"type" : "Template"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1" ,
"name" : "sidb_assembly" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC77122B0A916D95CE040578CDA814854%3A0.1" ,
"name" : "sidbasmA_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC769B1F361529309E040578CDA813D57%3A0.1" ,
"name" : "wls_assembly" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C144A4A245B62E040578CDA8163B9%3A0.1" ,
"name" : "fmw_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C8792DE2A0937E040578CDA81795E%3A0.1" ,
"name" : "WLS_abby" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76F733BC7A41AF7E040578CDA812CDC%3A0.1" ,
"name" : "fmw_venkat" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
}
]
} ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "0" ,
"elements" :
[      ]
} ,
"vnets" :     {
"media_type" : "application/oracle.com.cloud.common.VNet+json" ,
"total" : "3" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3AnetConfig%3AC76CEADBBBE6B23FE040578CDA817FB1" ,
"context_id" : "oracle:defaultService:em:provisioning:1:netConfig:C76CEADBBBE6B23FE040578CDA817FB1" ,
"media_type" : "application/oracle.com.cloud.common.VNet+json" ,
"id" : "oracle:defaultService:em:provisioning:1:netConfig:C76CEADBBBE6B23FE040578CDA817FB1"
} ,
{
"uri" : "/em/cloud/iaas/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3AnetConfig%3AC77076C8FDEC6BD7E040578CDA813B2B" ,
"context_id" : "oracle:defaultService:em:provisioning:1:netConfig:C77076C8FDEC6BD7E040578CDA813B2B" ,
"media_type" : "application/oracle.com.cloud.common.VNet+json" ,
"id" : "oracle:defaultService:em:provisioning:1:netConfig:C77076C8FDEC6BD7E040578CDA813B2B"
} ,
{
"uri" : "/em/cloud/iaas/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3AnetConfig%3AC76F741AFD7EB760E040578CDA812CD8" ,
"context_id" : "oracle:defaultService:em:provisioning:1:netConfig:C76F741AFD7EB760E040578CDA812CD8" ,
"media_type" : "application/oracle.com.cloud.common.VNet+json" ,
"id" : "oracle:defaultService:em:provisioning:1:netConfig:C76F741AFD7EB760E040578CDA812CD8"
}
]
} ,
"delegated_credentials" :     {
"media_type" : "application/oracle.com.cloud.iaas.ExalogicZoneCredential+json" ,
"total" : "0" ,
"elements" :
[      ]
}
}

46.4.6 サービス・テンプレート・リソース

前の例で示したように、リソース・タイプを明確に指定するために、表示されたコレクションのすべての要素にmedia_typeが属性として付けられています。次の表では、サービス・テンプレート・リソースの機能を示します。

表46-20 サービス・テンプレート・リソース

機能

説明

URL

https://example.oracle.com/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

次に、完全なVMTemplateリソースとして返されるリソースを示します。

{
"uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1" ,
"name" : "template_sanity" ,
"description" : "test template" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "oracle:defaultService:em:provisioning:1:cmp:Virtualization:Template:C76CEB5563EA5E13E040578CDA817FAF:0.1" ,
"media_type" : "application/oracle.com.cloud.common.VMTemplate+json" ,
"type" : "Template" ,
"created" : "2012-08-17T11:53:26+0000" ,
"default_instance_media_type" : "application/oracle.com.cloud.common.VM+json" ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.iaas.Zone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" ,
"name" : "cloud_zone" ,
"media_type" : "application/oracle.com.cloud.iaas.Zone+json" ,
"service_family_type" : "iaas" ,
"type" : "VM_ZONE"
}
]
} ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "0" ,
"elements" :
[      ]
} ,
"deployment_params" :
[
{
"name" : "zone" ,
"description" : "'zone' attribute is the URI of the zone that the 'application/oracle.com.cloud.common.VM' resource is to be created in" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "based_on" ,
"description" : "'based_on' attribute is the URI of the service template or format String of the originated source which the deployed 'application/oracle.com.cloud.common.VM' resource is to be followed" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "cpu" ,
"description" : "The information that determined how much 'CPU' is to be allocated to the deployed resource" ,
"type" : "LIST" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "memory" ,
"description" : "The information that determined how much 'MEMORY' is to be allocated to the deployed resource" ,
"type" : "NUMBER" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "disks" ,
"description" : "The list of disks to be included in the deployed resource" ,
"type" : "LIST" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.domain_type" ,
"description" : "The domain type of the Virtual Machine" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.network_profile" ,
"description" : "The identifier of the network profile to be used for the network instances of the Virtual Machine" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.server_prefix" ,
"description" : "The server prefix to be specified for the Virtual Machine" ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "false"
} ,
{
"name" : "params.server_size" ,
"description" : "The name of the server instance size" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.request_name" ,
"description" : "The request name to be tracked for the Virtual Machine creation" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.request_description" ,
"description" : "The request description to be tracked for the Virtual Machine creation" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.vnc_password" ,
"description" : "The VNC password for the Virtual Machine" ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "true"
} ,
{
"name" : "params.root_password" ,
"description" : "The Root password for the Virtual Machine" ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "true"
} ,
{
"name" : "params.start_vm" ,
"description" : "Whether or not the Virtual Machine should be started after creation" ,
"type" : "STRING" ,
"defaultValue" : "YES" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.ha_enabled" ,
"description" : "Whether or not the Virtual Machine should be HA enabled" ,
"type" : "STRING" ,
"defaultValue" : "NO" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.disks_overwrite" ,
"description" : "Whether or not the default Virtual Machine disks should be overwritten" ,
"type" : "STRING" ,
"defaultValue" : "NO" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "params.networks" ,
"description" : "Whether or not the default Virtual Machine disks should be overwritten" ,
"type" : "LIST" ,
"require" : "false" ,
"sensitive" : "false"
}
] ,
"directory" : "COMP_Components" ,
"updated" : "2012-08-17T11:53:26+0000" ,
"creator" : "DMBHAT1" ,
"last_modified_by" : "DMBHAT1" ,
"componenttype" : "Virtualization" ,
"oracle_owned" : "false"
}

46.4.7 メトリック・リソース

メトリックには時系列情報が含まれ、メトリックのタイプに応じてロールアップ情報を取得することもできます。次に例を示します

表46-21 サービス・テンプレート・リソース

機能

説明

URL

https://example.oracle.com/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

Webサービスからのレスポンスは次のとおりです。

{
"uri" : "/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD" ,
"name" : "CPU_Utilization" ,
"media_type" : "application/oracle.com.cloud.common.Metric+json" ,
"resource_state" :     {
"state" : "READY"
} ,
"type" : "NUMBER" ,
"current_value" : "52.53868103027344" ,
"current_time" : "2012-08-22T01:28:14+0000" ,
"time_range" :
[
"2012-08-22T01:18:14+0000" ,
"2012-08-22T01:28:14+0000"
] ,
"time_range_epoch" :
[
"1345598294965" ,
"1345598894965"
] ,
"rollup_unit" : "RAW" ,
"values" :
[
{
"time_utc" : "2012-08-22T01:21:44+0000" ,
"value" : "52.53868103027344"
}
] ,
"key" : "iaas:vm:CPU_Utilization:523CAE80A305928C9C5BE8A67A4181FD"
}

デフォルトの時間範囲は10分です。時間範囲を変更するために、問合せパラメータを使用して時間範囲を指定できます。たとえば、次の例では、最後の50分のメトリック・データが取得されます。

表46-22 サービス・テンプレート・リソース

機能

説明

URL

https://example.oracle.com/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD?time_range_epoch=1345595894965~1345598894965

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

問合せパラメータtime_range_epochには"~"で区切られた2つの数値が含まれ、FROM時間からTO時間までを示しています。レスポンスは次のとおりです。

{
"uri" : "/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD" ,
"name" : "CPU_Utilization" ,
"media_type" : "application/oracle.com.cloud.common.Metric+json" ,
"resource_state" :     {
"state" : "READY"
} ,
"type" : "NUMBER" ,
"current_value" : "52.53868103027344" ,
"current_time" : "2012-08-22T01:29:19+0000" ,
"time_range" :
[
"2012-08-22T00:38:14+0000" ,
"2012-08-22T01:28:14+0000"
] ,
"time_range_epoch" :
[
"1345595894965" ,
"1345598894965"
] ,
"rollup_unit" : "RAW" ,
"values" :
[
{
"time_utc" : "2012-08-22T01:21:44+0000" ,
"value" : "52.53868103027344"
} ,
{
"time_utc" : "2012-08-22T01:16:44+0000" ,
"value" : "52.67461395263672"
} ,
{
"time_utc" : "2012-08-22T01:11:44+0000" ,
"value" : "51.93536376953125"
} ,
{
"time_utc" : "2012-08-22T01:06:44+0000" ,
"value" : "52.61101531982422"
} ,
{
"time_utc" : "2012-08-22T01:01:44+0000" ,
"value" : "52.30859375"
} ,
{
"time_utc" : "2012-08-22T00:56:44+0000" ,
"value" : "52.778690338134766"
} ,
{
"time_utc" : "2012-08-22T00:51:44+0000" ,
"value" : "52.08208084106445"
} ,
{
"time_utc" : "2012-08-22T00:46:44+0000" ,
"value" : "52.42387771606445"
} ,
{
"time_utc" : "2012-08-22T00:41:44+0000" ,
"value" : "52.2672004699707"
}
] ,
"key" : "iaas:vm:CPU_Utilization:523CAE80A305928C9C5BE8A67A4181FD"
}

同様に、別のロールアップ単位を指定するために、次の相互作用では最後の7時間のHOURLYロールアップを示しています。

表46-23 サービス・テンプレート・リソース

機能

説明

URL

https://example.oracle.com/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD?time_range_epoch=1345571178252~1345611178252&rollup_unit=HOURLY

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

メソッド

GET

開始

12.1.0.4 Cloud Service Portalプラグイン

集計情報についてのWebサービスからのレスポンスは次のとおりです。

{
"uri" : "/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD" ,
"name" : "CPU_Utilization" ,
"media_type" : "application/oracle.com.cloud.common.Metric+json" ,
"resource_state" :     {
"state" : "READY"
} ,
"type" : "NUMBER" ,
"current_value" : "52.37758255004883" ,
"current_time" : "2012-08-22T04:55:13+0000" ,
"time_range" :
[
"2012-08-21T17:46:18+0000" ,
"2012-08-22T04:52:58+0000"
] ,
"time_range_epoch" :
[
"1345571178252" ,
"1345611178252"
] ,
"rollup_unit" : "HOUR" ,
"values" :
[
{
"time_utc" : "2012-08-21T23:00:00+0000" ,
"average" : "52.6733585993448905" ,
"min" : "52.130245208740234" ,
"max" : "53.29022216796875" ,
"std" : "3.55263697371071501307481053785512321532E-01"
} ,
{
"time_utc" : "2012-08-21T22:00:00+0000" ,
"average" : "5.24303614298502599166666666666666666667E01" ,
"min" : "51.621360778808594" ,
"max" : "52.85725402832031" ,
"std" : "3.63521555326025399658498002900543252046E-01"
} ,
{
"time_utc" : "2012-08-21T21:00:00+0000" ,
"average" : "52.6410032908121745" ,
"min" : "52.04186248779297" ,
"max" : "53.23821258544922" ,
"std" : "3.21552680564547999623645642115362106482E-01"
} ,
{
"time_utc" : "2012-08-21T20:00:00+0000" ,
"average" : "7.60534032185872416666666666666666666667E00" ,
"min" : "0" ,
"max" : "52.8489990234375" ,
"std" : "1.80268512452981440717409537961069439254E01"
} ,
{
"time_utc" : "2012-08-21T19:00:00+0000" ,
"average" : "0" ,
"min" : "0" ,
"max" : "0" ,
"std" : "0"
} ,
{
"time_utc" : "2012-08-21T18:00:00+0000" ,
"average" : "0" ,
"min" : "0" ,
"max" : "0" ,
"std" : "0"
}
] ,
"key" : "iaas:vm:CPU_Utilization:523CAE80A305928C9C5BE8A67A4181FD"
}

46.5 サービス・リクエストREST API

この項では、DBaaSおよびMWaaSのサービス・リクエストを再スケジュールしたり削除する次のREST APIを説明します。

表46-24 サービス・リクエストに対してサポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

レスポンス・ペイロード

正規のリンク

説明

PUT

該当せず

{"newdate": "8/23/2013 4:46:12 AM"}

ステータス・メッセージ(Jsonペイロード)

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/<id>

サービス・リクエストをIDおよび属性に基づいて再スケジュールします。

日時は、yyyy-MM-dd'T'HH:mm:ss'Zの形式で指定する必要があります。

DELETE

該当せず

なし

なし

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/<service-request-id>

GETで指定したServiceRequestを取り消します。

GET

該当せず

該当せず

jsonペイロードとしてのリクエストのリスト

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/

すべてのサービス・リクエストのリストを取得します。

46.6 サービス・リクエスト・コレクション

ServiceRequestCollectionは、すべてのアクセス可能なサービス・リクエスト・リソース(取消しまたは再スケジュールが可能)のクラウド管理者ビューを表すコレクション・リソースです。次の表で、ServiceRequestCollectionデータ・モデルについて説明します。

表46-25 ServiceRequestCollectionデータ・モデル

フィールド

タイプ

発生

説明

name

文字列

1

このコレクション・リソースの名称が表示されます。

type

文字列

1

コレクション・リソースのタイプが表示されます。

hasMore

Boolean

1

コレクションに他の要素があるかどうかを示します。

count

整数

1

コレクション・リソースの要素数です。

items

コレクション<リクエスト>

1

ServiceRequestリソースのリストです。インスタンスがない場合、このリストは空白です。

totalCount

整数

1

リクエストの合計数。

canonicalLink

URI

1

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

selfLink

URI

1

これを含む要素と同等のリソースを参照します。

47 Database as a Service管理者用のEM CLI動詞

この章では、Enterprise Managerセルフ・サービス・アプリケーション管理ユーザー用の、Database as a Service (DBaaS)のためのEnterprise Managerコマンドライン・インタフェース(EM CLI)動詞について詳しく説明します。クラウド管理に関連する他のEM CLI動詞については、『Enterprise Managerコマンドライン・インタフェース』を参照してください。

EM CLIにより、各種オペレーティング・システムのテキスト・ベースのコンソール(シェルおよびコマンド・ウィンドウ)からEnterprise Manager Cloud Control機能にアクセスできます。管理者は、SQL*Plus、OSシェル、Perl、Tclなどのカスタム・スクリプトを使用してEnterprise Manager機能をコールできるため、Enterprise Managerの機能と企業のビジネス・プロセスを容易に統合できます。

この章は次の各項で構成されています。

- PaaSゾーンEM CLI動詞

- ソフトウェア・プールEM CLI動詞

- データベース割当て制限EM CLI動詞

- データベース・リクエスト設定EM CLI動詞

- データベース・サイズEM CLI動詞

- データベース・プロファイルEM CLI動詞

- データベース・プロビジョニング・プロファイル・タイプについて

- EM CLIを使用したプロビジョニング・プロファイルの作成

- EM CLIプロパティ・ファイルの例

- データベース・プロファイルEM CLI動詞

- EM CLI動詞を使用したデータベース・プロファイルの作成

- EM CLI動詞を使用したデータベース・プロファイルの編集

- EM CLI動詞を使用したデータベース・プロファイルの削除

- すべてのデータベース・プロファイルの表示

- EM CLI動詞を使用したデータベース・プロファイルのリフレッシュ

- サービス・テンプレートEM CLI動詞

- サービス・テンプレートの実行可能.jsonファイル

- EM CLI動詞を使用したデータベース・クローンの作成

- EM CLI動詞を使用したデータベースのリフレッシュ

- EM CLI動詞を使用したデータベースの削除

- データベース・フリート・メンテナンスEM CLI動詞

- データベース・リクエスト処理EM CLI動詞

- プラガブル・データベースのクローニング

- データベース間でのデータの転送

- プラガブル・データベースのデータファイルおよびメタデータのバックアップ

- エクスポート・ダンプからデータベースへのデータのインポート

- EM CLI動詞を使用したREST APIの起動

PaaSインフラストラクチャ・ゾーンのEM CLI操作はすべて、EM_CLOUD_ADMINISTRATORロールを持つユーザーのみ使用できます。また、ソフトウェア・プールの操作は、EM_SSA_ADMINISTRATORロールを持つユーザーのみ使用できます。EM CLI動詞は、セキュリティ・コンテキストからユーザー情報を取得し、これらの操作を実行する権限を持つユーザーのみに権限を付与します。

47.1 PaaSゾーンEM CLI動詞

次の表に、PaaSゾーンのリソースでサポートされる動詞の詳細を示します。

表47-1 PaaSゾーンEM CLI動詞

動詞

説明

形式

emcli create_paas_zone

PaaSインフラストラクチャ・ゾーンを作成します。

- name: 作成するPaaSインフラストラクチャ・ゾーンの名前。

- credential: このPaaSインフラストラクチャ・ゾーンでプロビジョニングに使用するグローバル名前付き資格証明。

- hosts: このPaasインフラストラクチャ・ゾーンのメンバーとして追加するホスト・ターゲットのカンマ区切りのリスト。PaaSインフラストラクチャ・ゾーンには、メンバーとしてホストまたはOracle VMゾーンのいずれかを含めることができます。

- ovm_zones: このPaasインフラストラクチャ・ゾーンのメンバーとして追加するOracle VMゾーン・ターゲットのカンマ区切りのリスト。

- roles: このPaaSインフラストラクチャ・ゾーンにアクセスできるSSAロールのカンマ区切りのリスト。

- description: PaaSインフラストラクチャ・ゾーンの説明。

- cpu_utilization: この配置ポリシー制約を使用すると、クラウド管理者はどのホストにも最大しきい値を設定できます。入力値は、1から100の間にする必要があります。指定しない場合、デフォルト値は、80パーセントになります。Oracle VMゾーン・ターゲットをメンバーとして追加する場合、このパラメータは必要ありません。

- memory_utilization: これは、PaaSインフラストラクチャ・ゾーンの配置ポリシー制約です。入力する値は、1から100の間である必要があります。指定しない場合、デフォルト値は、80パーセントになります。Oracle VMゾーン・ターゲットをメンバーとして追加する場合、このパラメータは必要ありません。

例:

emcli create_paas_zone
-name=MyPaaSZone
-credential=AIME__N
-hosts=xyxy.example.com
-roles="SSA_USER_ROLE1"
-description="Test PaaS zone"
-cpu_utilization=90
-memory_utilization=90

Sample Output:
PaaS Infrastructure Zone "MyPaaSZone" created successfully.

emcli create_paas_zone

-name=<Name of PaaS zone>

-credential=<Global Named Credential>

[-hosts=<Host1,Host2,Host3...>]

[-ovm_zones=<OVMZone1,OVMZone2,OVMZone3...>]

[-roles=<SsaRole1,SsaRole2,...>]

[-description=<Description of PaaS zone>]

[-cpu_utilization=<Value between 1 and 100>]

[-memory_utilization=<Value between 1 and 100>]

emcli update_paas_zone

PaaSインフラストラクチャ・ゾーンを更新します。

- name: 既存のPaaSインフラストラクチャ・ゾーンの名前。

- credential: 更新するグローバル名前付き資格証明。

- add_hosts: PaaSインフラストラクチャ・ゾーンのメンバーとして追加するホスト・ターゲットのカンマ区切りのリスト。追加するホストは、他の既存のPaaSゾーンにまだ追加されていない必要があります。

- remove_hosts: PaaSインフラストラクチャ・ゾーンから削除するホスト・ターゲットのカンマ区切りのリスト。

- add_ovm_zones: PaaSインフラストラクチャ・ゾーンのメンバーとして追加するOracle VMゾーン・ターゲットのカンマ区切りのリスト。追加するOracle VMゾーンは、他の既存のPaaSゾーンにまだ追加されていない必要があります。

- remove_ovm_zones: PaaSインフラストラクチャ・ゾーンから削除するOracle VMゾーン・ターゲットのカンマ区切りのリスト。

- add_roles: PaaSインフラストラクチャ・ゾーンにアクセスできる、追加するSSAロールのカンマ区切りのリスト。

- remove_roles: PaaSインフラストラクチャ・ゾーンから削除するSSAロールのカンマ区切りのリスト。

- description: PaaSインフラストラクチャ・ゾーンの更新後の説明。

- cpu_utilization: この配置ポリシー制約を使用すると、クラウド管理者はどのホストにも最大しきい値を設定できます。入力する値は、1から100の間である必要があります。

- memory_utilization: この配置ポリシー制約は、PaaSインフラストラクチャ・ゾーンのメモリー使用率を対象とします。入力する値は、1から100の間である必要があります。

例:

emcli update_paas_zone
-name=MyPaaSZone
-credential=AIME_N
-add_hosts=xyxy.example.com
-remove_hosts=xxy.example.com
-add_roles="SSA_USER_ROLE1"
-remove_roles="SSA_USER_ROLE2"
-description="Test PaaS zone"
-cpu_utilization=90
-memory_utilization=90

Sample Output:
PaaS Infrastructure Zone "MyPaaSZone" updated successfully.

emcli update_paas_zone

-name=<Name of PaaS zone>

[-description=<Description of PaaS zone>]

[-credential=<Global Named Credential>]

[-add_hosts=<Host1,Host2,Host3...>]

[-remove_hosts=<Host4,Host5...>]

[-add_ovm_zones=<OVMZone1,OVMZone2,OVMZone3...>]

[-remove_ovm_zones=<OVMZone4,OVMZone5...>]

[-add_roles=<SsaRole1,SsaRole2,...>]

[-remove_roles=<SsaRole3,SsaRole4,...>]

[-cpu_utilization=<Value between 1 and 100>]

[-memory_utilization=<Value between 1 and 100>]

emcli delete_paas_zone

PaaSインフラストラクチャ・ゾーンを削除します。PaaSインフラストラクチャ・ゾーンは、関連付けられている既存のソフトウェア・プールがある場合、削除できません。

- name: 削除する既存のPaaSインフラストラクチャ・ゾーンの名前。

例:

emcli delete_paas_zone
-name=MyPaaSZone

Sample Output:
PaaS Infrastructure Zone "MyPaaSZone" deleted successfully

emcli delete_paas_zone

-name=<Name of PaaS zone>

emcli get_paas_zone_detail

PaaSインフラストラクチャ・ゾーンの詳細を取得します。

- name: 名前、説明、名前付き資格証明、ホストの数、ロール、最大メモリー割当て(%)、最大CPU使用率(%)など、既存のPaaSインフラストラクチャ・ゾーンの詳細。

例:

emcli  get_paas_zone_detail
-name=MyPaaSZone

Sample Output:
Name               MyPaaSZone
Description        TEST zone
Named Credentials  AIME_N
Number of Hosts    1
Roles              SSA_USER_ROLE1
Maximum Memory Allocation (%)    90
Maximum CPU Utilization (%)      90

emcli get_paas_zone_detail

-name=<Name of PaaS zone>

47.2 ソフトウェア・プールEM CLI動詞

次の表に、ソフトウェア・プールのリソースでサポートされる動詞の詳細を示します。

表47-2 ソフトウェア・プールEM CLI動詞

動詞

説明

形式

emcli create_pool

データベース、スキーマまたはプラガブル・データベース・プールを作成します。

- name: 作成するソフトウェア・プールの名前。

- target_type: 作成するソフトウェア・プールのターゲット・タイプ。例: ミドルウェア・プールの場合はmwaas_zone、データベース・プールの場合はoracle_cloud_zone、スキーマ・プールの場合はschaas_pool。

- paas_zone: ソフトウェア・プールを作成するPaaSインフラストラクチャ・ゾーンの名前。

- members: ソフトウェア・プールのメンバーとして追加するターゲットのカンマ区切りのリスト。

- description: ソフトウェア・プールの説明。

- placement_constraints: セルフ・サービス管理者がリソース使用率の上限を設定できるようにする配置制約のカンマ区切りのキー値ペア。これにより、リソース使用量の観点からデータベース・プールのメンバーを保護できます。プール・ターゲット・タイプの使用可能な配置制約を取得する場合は、get_pool_allowed_placement_constraints動詞を使用します。

- member_constraints: 設定条件によってソフトウェア・プールへのメンバー・ターゲットの追加を制限するカンマ区切りのキー値ペア。プール・ターゲット・タイプの使用可能なメンバー制約およびその可能な値を取得する場合は、get_pool_allowed_member_constraints動詞を使用します。

- properties: ソフトウェア・プール・ターゲット・タイプに基づいて指定する必要がある追加のプロパティに対するカンマ区切りのキー値ペア。

注意:

- GUIDを取得するには、次のコマンドを実行します。

emcli get_procedures
[-type={procedure type}]

Sample command:
emcli get_procedures -type=DBPROV

- ルート資格証明はオプションです。これが必要になるのは、スナップ・クローン・データベース・リクエストのプールを使用する場合です。

- グリッド・インフラストラクチャ資格証明はオプションです。これが必要になるのは、単にRACデータベースを作成する場合です。

- ASM資格証明はオプションです。これが必要になるのは、ASMを使用するデータベースのライブ・クローニングでデータベース・プールを使用する場合です。

- 同様の構成を持つ既存のプールは、スタンバイ・プールとして新しいデータベース・プールに関連付けることができます。これを行うには、standby_poolsプロパティを使用します。複数のプールを関連付けるには、パイプ記号を使用してプール名を区切る必要があります。

例:

- データベース・プール -

emcli  create_pool
-name=MyDbPool
-target_type=oracle_cloud_zone
-paas_zone=MyPaaSZone
-members=OraDb11g_home1_1_slc03qtn
-description="Test Database Pool"
-member_constraints=
"CONFIGURATION=oracle_database,
VERSION=11.2.0.2.0,
PLATFORM=226"
-placement_constraints=
"MAX_INSTANCES=7"
-properties=
"host_credential_guid=DBA449B8967AAF77E040F00A73B11F55,
root_credential_guid=DBA449B8967AAF77E040F00A73B11F55"
grid_credential_guid=DBA449B8967AAF77E040F00A73B11F55,
asm_credential_guid=DBA449B8967AAF77E040F00A73B11F55,
standby_pools=DB_POOL1|DB_POOL2
Sample Output:
Software Pool "MyDbPool" created successfully.

- スキーマ・プール -

emcli  create_pool
-name= MySchemaPool
-target_type= schaas_pool
-paas_zone=MyPaaSZone
-members= simple.us.example.com
-description="Test Schema Pool"
-member_constraints=
" TARGET_TYPE=oracle_database,
VERSION=11.2.0.2.0,
PLATFORM=226"
-placement_constraints=
"MAX_SERVICES=7,
USE_WORKLOAD=true,
MAX_CPU_USAGE=90,
MAX_MEMORY_USAGE=90,
ENFORCE_CPU=true"
-properties=
"host_credential_guid=DBA449B8967AAF77E040F00A73B11F55,
database_credential_guid =DBA449B8967AAF77E040F00A73B11F55"

Sample Output:
Software Pool "MySchemaPool" created successfully.

- プラガブル・データベース・プール -

emcli  create_pool
-name= MyPdbPool
-target_type= pdbaas_pool
-paas_zone=MyPaaSZone
-members= database
-description="Test PDB Pool"
-member_constraints=
TARGET_TYPE_CDB=oracle_database,
VERSION_CDB=12.1.0.1.0,
PLATFORM_CDB=226"
-placement_constraints=
"MAX_PDB_SERVICES=7,
PDBS_USE_WORKLOAD=true,
MAX_CPU_USAGE_BY_PDBS=90,
MAX_MEMORY_USAGE_BY_PDBS=90,
PDBS_ENFORCE_CPU=true"
-properties=
"host_credential_guid=DBA449B8967AAF77E040F00A73B11F55, gi_credential_guid=DBA449B8967AAF77E040F00A73B11F55,
cdb_credential_guid =DBA449B8967AAF77E040F00A73B11F55"

Sample Output:
Software Pool "MySchemaPool" created successfully

emcli create_pool

-name=<Name of Software Pool>

-target_type=<Target type of Software Pool>

-paas_zone=<PaaS Infrastructure Zone of Software Pool>

-members=<Member1, Member2...>

[-description=<Description of Software Pool>]

[-placement_constraints=<constraint1=value1, constraint2=value2...>]

[-member_constraints=<constraint1=value1, constraint2=value2>]

[-properties=<property1=value1, property2=value2>]

emcli update_pool

指定に従ってデータベース、スキーマまたはプラガブル・データベース・プールを更新します。

- name: 既存のソフトウェア・プールの名前。

- target_type: 既存のソフトウェア・プールのターゲット・タイプ。例: ミドルウェア・プールの場合はmwaas_zone、データベース・プールの場合はoracle_cloud_zone、スキーマ・プールの場合はschaas_pool。

- description: ソフトウェア・プールの説明。

- add_members: ソフトウェア・プールのメンバーとして追加するターゲットのカンマ区切りのリスト。追加するターゲットは、ソフトウェア・プールのメンバー制約を満たす必要があります。

- remove_members: ソフトウェア・プールから削除するメンバー・ターゲット。

- placement_constraints: セルフ・サービス管理者がリソース使用率の上限を設定できるようにする配置制約のカンマ区切りのキー値ペア。これにより、リソース使用量の観点からソフトウェア・プールのメンバーを保護できます。

- properties: ソフトウェア・プール・ターゲット・タイプに基づいて更新する必要があるプロパティに対するカンマ区切りのキー値ペア。

例:

- データベース・プール -

emcli update_pool
-name=MyDbPool
-target_type=oracle_cloud_zone
-paas_zone=MyPaaSZone
-add_members=
OraDb11g_home1_1_slc03qtn
-remove_members=
OraDb11g_home1_2_slc01mdr
-description="Test Database Pool"
-placement_constraints=
"MAX_INSTANCES=7"
-properties=
"host_credential_guid=DBA449B8967AAF77E040F00A73B11F55,
root_credential_guid=DBA449B8967AAF77E040F00A73B11F55"

Sample Output:
Software Pool "MyDbPool" updated successfully.

- スキーマ・プール -

emcli update_pool
-name= MySchemaPool
-target_type= schaas_pool
-add_members=
simple.us.example.com
-remove_members=
Simple1.us.example.com
-description="Test Database Pool"
-placement_constraints=
"MAX_SERVICES=17,
USE_WORKLOAD=false,
MAX_CPU_USAGE=90,
MAX_MEMORY_USAGE=90,
ENFORCE_CPU=false"

Sample Output:
Software Pool "MySchemaPool" updated successfully.y.

- プラガブル・データベース・プール -

emcli update_pool
-name= MyPdbPool
-target_type= pdbaas_pool
-paas_zone=MyPaaSZone
-add_members=database
-remove_members=database
-description="Test PDB Pool"
-placement_constraints=
"MAX_PDB_SERVICES=7,
PDBS_USE_WORKLOAD=true,
MAX_CPU_USAGE_BY_PDBS=90,
MAX_MEMORY_USAGE_BY_PDBS=90,
PDBS_ENFORCE_CPU=true"
-properties=
"host_credential_guid=DBA449B8967AAF77E040F00A73B11F55, gi_credential_guid=DBA449B8967AAF77E040F00A73B11F55,
cdb_credential_guid =DBA449B8967AAF77E040F00A73B11F55"

Sample Output:
Software Pool "MyPdbPool" updated successfully.

emcli update_pool -name=<Name of Software Pool>

-target_type=<Target type of Software Pool>

[-description=<Description of Software Pool>]

[-add_members=<Member1, Member2...>]

[-remove_members=<Member4, Member5...>]

[-placement_constraints=<constraint1=value1,constraint2=value2...>]

[-properties=<property1=value1, property2=value2>]

emcli delete_pool

データベース、スキーマまたはプラガブル・データベース・プールを削除します。ソフトウェア・プールは、関連付けられている既存のサービス・テンプレートがある場合、削除できません。

- name: 既存のソフトウェア・プールの名前。

- target: ソフトウェア・プールのターゲット・タイプ。

例:

- データベース・プール -

emcli delete_pool
-name=MyDbPool
-target_type=oracle_cloud_zone
Sample Output:
Software Pool "MyDbPool" deleted successfully.

- スキーマ・プール -

emcli delete_pool
-name=MySchemaPool
-target_type= schaas_pool

Sample Output:
Software Pool "MySchemaPool" deleted successfully.

- プラガブル・データベース・プール -

emcli delete_pool
-name= MyPdbPool
-target_type= pdbaas_pool

Sample Output:
Software Pool "MyPdbPool" deleted successfully.

emcli delete_pool

-name=<Name of Software Pool>

-target_type=<Target type of Software Pool>

emcli get_pool_detail

名前、ターゲット・タイプ、説明、PaaSインフラストラクチャ・ゾーン、メンバーの数、配置制約、メンバー制約など、ソフトウェア・プールの詳細を取得します。

- name: ソフトウェア・プールの名前。

- target: ソフトウェア・プールのターゲット・タイプ

例:

- データベース・プール -

emcli get_pool_detail
-name=MyDbPool
-target_type=oracle_cloud_zone

Sample Output:
Name              MyDbPool
Target Type       oracle_cloud_zone
Description       Test Database Pool
Paas Infrastructure Zone SLC01MDR_ZONE
Number of Members               1
Placement Constraints
MAX_INSTANCES : 10
Member Constraints
CONFIGURATION : DatabaseInstance
VERSION : 11.2.0.2.0 ,
PLATFORM : Linux x86-64

- スキーマ・プール -

emcli get_pool_detail
-name=MySchemaPool
-target_type= schaas_pool

Sample Output:
Name                MyRchemaPool
Target Type         schaas_pool
Description         Test Schema Pool
Paas Infrastructure Zone   SLC01MDR_ZONE
Number of Members   1
Placement Constraints
MAX_CPU_USAGE : 90 ,
ENFORCE_CPU : false ,
MAX_MEMORY_USAGE : 90 ,
MAX_SERVICES : 17 ,
USE_WORKLOAD : false
Member Constraints
VERSION : 11.2.0.2.0 ,
PLATFORM : Linux x86-64 ,
TARGET_TYPE : Database Instance

- プラガブル・データベース・プール -

emcli get_pool_detail
-name= MyPdbPool
-target_type= pdbaas_pool

Sample Output:
Name                 MyPdbPool
Target Type          pdbaas_pool
Description          Test PDB Pool
Paas Infrastructure Zone  PDB_ZONE
Number of Members     1
Placement Constraints
MAX_MEMORY_USAGE_BY_PDBS : 90 ,
MAX_CPU_USAGE_BY_PDBS : 90 ,
MAX_PDB_SERVICES : 7 ,
PDBS_ENFORCE_CPU : false ,
PDBS_USE_WORKLOAD :false
Member Constraints
PLATFORM_CDB : Linux x86-64 ,
TARGET_TYPE_CDB : Database Instance,
VERSION_CDB : 12.1.0.1.0

emcli get_pool_detail

-name=<Name of Software Pool>

-target_type=mwaas_zone

47.3 データベース割当て制限EM CLI動詞

次の表に、データベースの割当て制限でサポートされる動詞の詳細を示します。

表47-3 データベース割当て制限EM CLI動詞

動詞

説明

形式

emcli create_database_quota

EM_SSA_USERロール用のデータベース割当て制限を作成します。

- role_name: 割当て制限の作成対象となるSSAユーザー・ロールの名前

- databases: 許可されるデータベース・サービス・リクエストの数。

- schema_services: 許可されるスキーマ・サービス・リクエストの数。

- pluggable_databases: 許可されるプラガブル・データベース・リクエストの数。

- memory: 許可されるメモリー使用量。

- storage: 許可される記憶域使用量。

例

emcli create_dbaas_quota
-role_name="My Role"
-databases="10"
-schema_services="10"
-pluggable_databases="10"
-memory="99"
-storage="99"

Sample Output
Quota for "MyRole" setup successfully.

emcli create_dbaas_quota

-role_name="<SSAユーザー・ロールの名前>"

-databases="<データベース・リクエストの数>"

-schema_services="<スキーマ・サービス・リクエストの数>"

-pluggable_databases="<プラガブル・データベース・サービス・リクエストの数>"

-memory="<Memory(GB)>"

-storage="<Storage(GB)>"

emcli update_dbaas_quota

SSAユーザー・ロール用のデータベース割当て制限を更新します。

- role_name: 割当て制限の更新対象となるSSAユーザー・ロールの名前。

- databases: 許可されるデータベース・サービス・リクエストの数。

- schema_services: 許可されるスキーマ・サービス・リクエストの数。

- pluggable_databases: 許可されるPDBサービス・リクエストの数。

- memory: 許可されるメモリー使用量。

- storage: 許可される記憶域領域使用量。

例

emcli update_dbaas_quota
-role_name="My Role"
-databases="10"
-schema_services="10"
-pluggable_databases="10"
-memory="99"
-storage="99"

Sample Output
Quota for "My Role" updated successfully.

emcli update_dbaas_quota

-role_name="<SSAユーザー・ロールの名前>"

-databases="<データベース・リクエストの数>"

-schema_services="<スキーマ・サービス・リクエストの数>"

-pluggable_databases="<プラガブル・データベース・サービス・リクエストの数>"

-memory="<Memory(GB)>"

-storage="<Storage(GB)>"

emcli delete_dbaas_quota

SSAユーザー・ロール用のデータベース割当て制限を削除します。

- role_name: 割当て制限の削除対象となるSSAユーザー・ロールの名前。

例

emcli delete_dbaas_quota           -role_name="My Role"

Sample Output
Quota for "My Role" deleted successfully.

emcli delete_dbaas_quota

-role_name="<SSAユーザー・ロールの名前">

emcli get_dbaas_quota

SSAユーザー・ロール用のデータベース割当て制限設定をリストします。

例

emcli get_dbaas_quota

Sample Output:
ROLE_NAME: SSA_USER_ROLE1 NUMBER_OF_SCHEMA_SERVICES: 99
MEMORY: 99
STORAGE: 99
NUMBER_OF_PLUGGABLE_DATABASES: 99NUMBER_OF_DB_INSTANCES : 99

Quotas for Roles retrieved successfully

emcli get_dbaas_quota

47.4 データベース・リクエスト設定EM CLI動詞

次の表に、データベースのリクエスト設定でサポートされる動詞の詳細を示します。

表47-4 データベース・リクエスト設定EM CLI動詞

動詞

説明

形式

emcli update_dbaas_request_settings

データベース・リクエスト設定を更新します。

- future_reservation_length: セルフ・サービス・ユーザーがリクエストをスケジュールできるようになるまでの期間。

- maximum_archive_duration: セルフ・サービスの作成リクエストが、「完了済」となった後、リポジトリからパージされるまでの期間。

- default_retirement_period: セルフ・サービス・ユーザーがサービス・インスタンスを保持できる最大時間量。

例:

emcli update_dbaas_request_settings
-future_reservation_length="2 Months"
-maximum_archive_duration="10 Weeks"
-default_retirement_period="No Reservation"
Sample Output:
Request settings updated successfully

emcli update_dbaas_request_settings

-future_reservation_length="<後続のリクエスト・スケジュール期間>"

-maximum_archive_duration="<リクエスト・パージ期間>"

-default_retirement_period="<デフォルト保存期間>"

emcli get_dbaas_request_settings

PaaSインフラストラクチャ・ゾーンの詳細を取得します。

例:

emcli get_dbaas_request_settings
Sample Output:
Future Reservation Length  : 2 Months
Maximum Archive Duration : 10 Weeks
Default Retirement Period : 1 Years
Request Settings retrieved successfully.

emcli get_dbaas_request_settings

47.5 データベース・サイズEM CLI動詞

次の表に、データベース・サイズのリソースでサポートされる動詞を示します。

表47-5 データベース・サイズEM CLI動詞

動詞

説明

形式

emcli create_database_size

このデータベース・サイズを構成する1つ以上の属性を指定します。異なる属性はセミコロン(;)で区切られます。データベース・サイズで指定された属性は、サービス・テンプレートで指定された値を上書きします

- name - サイズの名前を作成します。

- description - サイズの説明を作成します。

- attributes - 異なる属性はセミコロン(;)で区切られます。ユーザーは次の属性の値を指定できます。

- cpu: CPUコアの総数。

- memory: GB単位での合計最大メモリー。

- processes: Oracleに同時に接続できるプロセスの総数。

- storage: Oracleに割り当てられる合計ストレージ(GB単位)。

例:

emcli create_database_size -name=Small -description="Small size database" -attributes="cpu:4;storage:50;memory:4"
Sample Output:
Database size 'Small' has been successfully created.

emcli create_database_size

-name="<サイズ名>"

-description="<サイズの説明>"

[-attributes="cpu:<コア数>;

memory:<GB単位でのメモリー>;

processes:<プロセスの最大数>;

storage:<データベースに割り当てられる合計ストレージ(GB単位)>;"

]

emcli update_database_size

変更する必要のある1つ以上の属性を指定します。異なる属性はセミコロン(;)で区切られます。データベース・サイズ定義から属性を削除する場合は、その属性に対して'remove'を指定します。

- name - 既存のデータベースの名前。

- description - 既存のサイズの説明を更新します。

- attributes - 異なる属性はセミコロン(;)で区切られます。ユーザーは次の属性の値を指定できます。

- cpu: CPUコアの総数。

- memory: GB単位での合計最大メモリー。

- processes: Oracleに同時に接続できるプロセスの総数。

- storage: Oracleに割り当てられる合計ストレージ(GB単位)。

例:

emcli update_database_size -name=Small -description="Small size database" -attributes="cpu:4;storage:50;memory:4"
Sample Output:
Database size 'Small' has been successfully updated.

emcli update_database_size

-name="<既存のサイズ名>"

-description="<サイズの説明>"

[-attributes="cpu:<コア数>;

memory:<GB単位でのメモリー>;

processes:<プロセスの最大数>;

storage:<データベースに割り当てられる合計ストレージ(GB単位)>;"]

emcli delete_database_size

データベース・サイズを削除します。

name - 既存のデータベース・サイズの名前。

例:

emcli delete_database_size -name=small
Sample Output:
Database size 'Small' has been successfully deleted.

emcli delete_database_size

-name="<既存のサイズ名>"

emcli list_database_sizes

作成されたすべてのデータベース・サイズをリストします。[name]: 完全または部分文字列。

例:

eemcli list_database_sizesemcli list_database_sizes -name="Extra*"
Sample Output:
Name:Extra-Small
Description:Extra-small
CPU(cores):4
Memory(GB):4
Storage(GB):Not Specified
Processes(Units):Not Specified

Name:Small
Description:Small database
CPU(cores):8
Memory(GB):8
Storage(GB):Not Specified
Processes(Units):Not Specified

emcli list_database_sizes[name]: 完全または部分文字列。

47.6 データベース・プロファイルEM CLI動詞

この項では、Database as a Serviceで使用される様々なデータベース・プロビジョニング・プロファイルについて説明します。また、EM CLI動詞を使用してこれらのプロファイルを作成する方法について説明します。次の項目について説明します。

- データベース・プロビジョニング・プロファイル・タイプについて

- EM CLIを使用したプロビジョニング・プロファイルの作成

- EM CLI動詞を使用したデータベース・プロファイルの作成

- EM CLI動詞を使用したデータベース・プロファイルの編集

- EM CLI動詞を使用したデータベース・プロファイルの削除

- すべてのデータベース・プロファイルの表示

- EM CLI動詞を使用したデータベース・プロファイルのリフレッシュ

47.6.1 データベース・プロビジョニング・プロファイル・タイプについて

Database as a ServiceおよびSchema as a Serviceで使用される4タイプのデータベース・プロビジョニング・プロファイルは、次のとおりです。

- DBCAテンプレート

- RMAN

- スナップクローン

- スキーマ

47.6.1.1 DBCAテンプレート

DBCAテンプレートでは、構造およびデータのタイプと、構造のみのタイプの両方がサポートされます。このデータベース・プロビジョニング・プロファイルは、Enterprise Managerに登録された本番データベースまたはソース・データベースから作成されます。

注意:
構造およびデータでは、データベースの停止が必要です。非常に小さいデータベース(< 50GB)に使用されます。

47.6.1.2 RMAN

このデータベース・プロビジョニング・プロファイルのデータ・コンテンツは、RMANバックアップ・ピースで構成されます。RMANプロファイルの作成に使用できる方法は、次のとおりです。

- ホットRMANバックアップ - このオプションは、ソース・データベースでアーカイブ・ログ・モードがONの場合にのみ有効です。

- コールドRMANバックアップ - この場合、ソース・データベースはRMANバックアップを取るために停止されます。

- 既存のバックアップ - このオプションは、ソースに対するRMANバックアップがすでに取得されており、プロファイルを作成するために既存のRMANバックアップの1つを使用する場合に使用できます。

- ソース・データベースへのアクセス権がない場合の既存のバックアップ・ピース - ソース・データベースへのアクセス権がない場合は、既存のバックアップ・ピースを使用してプロファイル・ソース・データベースを作成します。このオプションは、ソースに対するRMANバックアップがすでに取得されており、既知の場所に保持されている場合に使用できます。このオプションは、EM CLI動詞を使用する場合にのみサポートされます。

47.6.1.3 スナップ・クローン

このデータベース・プロビジョニング・プロファイルのデータ・コンテンツは、ソース・データベースのデータファイルが存在するすべてのボリュームのファイラ(NetAppまたはSunZFSファイラ)のスナップショット情報から導出されます。

47.6.1.4 スキーマ

このデータベース・プロビジョニング・プロファイルのデータ・コンテンツは、データ・ポンプ・ツールを使用して作成されたエクスポート・ダンプからコンパイルされます。スキーマ・オブジェクト(構造のみ)またはスキーマおよびデータ(構造およびデータ)のエクスポートを選択できます。

空のスキーマをエクスポートしたり、Oracleスキーマを含めることはできません(これらのスキーマは選択できません)。フィルタで除外されるスキーマは、次のとおりです。

表47-6 フィルタで除外されるスキーマ

ANONYMOUS

DMSYS

OASPUBLIC

OWBSYS

TSMSYS

APEX_030200

EXFSYS

ODM

OWBSYS_AUDIT

WEBSYS

APEX_PUBLIC_USER

FLOWS_

ODM_MTR

SCOTT

WK_PROXY

APPQOSSYS

FLOWS_03000

OLAPSYS

SI_INFORMTN_SCHEMA

WK_TEST

AURORA$JIS$UTILITY$

FLOWS_FILES

ORACLE_OCM

SPATIAL_CSW_ADMIN_USR

WKPROXY

AURORA$ORB$UNAUTHENTICATED

LBACSYS

ORDDATA

SPATIAL_WFS_ADMIN_USR

WKSYS

BI

MDDATA

ORDPLUGINS

SYS

WMSYS

CTXSYS

MDSYS

ORDSYS

SYSMAN

XDB

DBSNMP

MGMT_VIEW

OSE$HTTP$ADMIN

SYSTEM

XS$NULL

DIP

MTSSYS

OUTLN

TRACESRV

47.6.2 EM CLIを使用したプロビジョニング・プロファイルの作成

この方法を使用すると、管理者またはクラウド・プロビジョニング・オペレータはEM CLI動詞を使用してデータベース・プロビジョニング・プロファイルを作成できます。動詞の構文を次に示します。

emcli create_dbprofile -input_file=data:<Prop file name>

動詞の説明とオプションについては、表47-13を参照してください。

データベース・プロファイルを作成する場合に準拠する手順については、第47.6.5項「EM CLI動詞を使用したデータベース・プロファイルの作成」を参照してください。

このコマンドは、作成されるプロファイルのタイプと使用されるオプションについて完全に記述するプロパティ・ファイルを受け入れます。様々なデータベース・プロビジョニング・プロファイルのプロパティ・ファイルは、第47.6.3項「EM CLIプロパティ・ファイルの例」を参照してください。

47.6.3 EM CLIプロパティ・ファイルの例

次の項で、データベース・プロビジョニング・プロファイルのEMCLIプロパティ・ファイルの例を示します。

- DBCAテンプレート

- ソース・データベースからの新規のRMANバックアップ

- ソース・データベースからの既存のRMANバックアップ

- ステージングの場所の既存のRMANバックアップ

- スナップクローン・データベース

- スキーマ・データベース

47.6.3.1 DBCAテンプレート

表47-7 DBCAテンプレートのEMCLIプロパティ・ファイル

Name

必須

説明

変数

参照データベース

必須

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE=

参照データベースのタイプ

必須

ソース・データベースのターゲット・タイプ(oracle_databaseまたはrac_database)。

REFERENCE_DATABASE_TYPE=

参照ノード

省略可

プロファイルが作成される参照ノード。RACおよびクラスタ・ターゲットにのみ適用できます。

REF_NODE_SELECTED=

データベース・ゴールド・イメージの作成

省略可

プロファイルの一部としてデータベース・ゴールド・イメージを含みます。

DATABASE_GOLD_IMAGE_TYPE=

GIゴールド・イメージの作成

省略可

プロファイルの一部としてGIゴールド・イメージを含みます。

GI_GOLD_IMAGE_TYPE=

データベース・ゴールド・イメージの作成

省略可

プロファイルの一部としてデータベース・ゴールド・イメージを含みます。

DATA_CONTENT_MODE=

データ・コンテンツのモードの作成

省略可

作成モードは、既存のデータを使用するか、新しいデータを作成するかを決定します。

CREATE_DATA_OPTION=

バックアップに含まれるコンテンツ

省略可

バックアップに含まれるデータ・コンテンツは、メタデータまたはデータです。

DATA_CONTENT=

参照ホスト資格証明

省略可

OS認証に使用される資格証明。

REF_HOST_CREDENTIALS=

データベース資格証明

省略可

データベース関連の操作の実行に使用される資格証明。

REF_DB_CREDENTIALS=

グリッド・インフラストラクチャの資格証明

省略可

グリッド・インフラストラクチャのOS認証に使用される資格証明。

REF_GI_CREDENTIALS=

ルート資格証明

省略可

ホストの権限付き操作の実行に必要なルート資格証明。

REF_HOST_ROOT_CREDENTIALS=

OFAフォーマットへの変換

省略可

OFAフォーマットに変換します。

CONVERT_TO_OFA=

プロファイル名

必須

プロファイル名。

PROFILE_NAME=

プロファイルの説明

省略可

作成されるプロファイルの名前。

PROFILE_DESC=

プロファイルの場所

必須

ソフトウェア・ライブラリ内のプロファイルの場所。

PROFILE_LOCATION=

プロファイルのバージョン

省略可

プロファイルのバージョン。何も指定しない場合、データベース・バージョンが使用されます。

PROFILE_VERSION=

プロファイル・ベンダー

省略可

プロファイルのベンダー。デフォルトは「Oracle」です。

PROFILE_VENDOR=

プロファイル・ノート

省略可

プロファイルの備考。

PROFILE_NOTES=

イメージ・バージョン・フラグの作成

省略可

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

DB_GOLD_IMAGE_CREATE_VERSION_ONLY=

イメージ・バージョン・フラグの作成

省略可

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

GI_GOLD_IMAGE_CREATE_VERSION_ONLY=

GIホーム・ゴールド・イメージID

省略可

ゴールド・イメージのエンティティID。

GI_GOLD_IMAGE_ID=

データベース・ホーム・ゴールド・イメージID

省略可

ゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ID=

データベース・ゴールド・イメージID

省略可

ゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ID=

データベース・ゴールド・イメージ名

省略可

データベース・ゴールド・イメージのエンティティ名。

DB_GOLD_IMAGE_ENTITY_NAME=

グリッド・インフラストラクチャのゴールド・イメージ名

省略可

データベース・ゴールド・イメージのエンティティ名。

GI_GOLD_IMAGE_ENTITY_NAME=

データ・ゴールド・イメージ名

省略可

データ・ゴールド・イメージのエンティティ名。

DATA_GOLD_IMAGE_ENTITY_NAME=

作業ディレクトリ

省略可

作業ディレクトリは、ファイルがステージングされる場所です。

WORKING_DIRECTORY=

記憶域タイプ

省略可

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです。

STORAGE_TYPE_FOR_SOFTWARE=

ストレージ名

省略可

ソフトウェア・ライブラリで構成されるストレージ名。

STORAGE_NAME_FOR_SOFTWARE=

NFSマウント・ポイント

省略可

NFSサーバーがホストにマウントされる場所。

NFS_LOCAL_MOUNT_POINT_FOR_SOFTWARE=

記憶域タイプ

省略可

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです

STORAGE_TYPE_FOR_DATA=

ストレージ名

省略可

ソフトウェア・ライブラリで構成されるストレージ名。

STORAGE_NAME_FOR_DATA=

NFSマウント・ポイント

省略可

NFSサーバーがホストにマウントされる場所。

NFS_LOCAL_MOUNT_POINT_FOR_DATA=

エンド・ユーザーによって開始されるプロファイルです

省略可

エンド・ユーザーによって開始されるプロファイルが、バックアップ・プロセスまたはデータベースの一部であるかどうかを示します。

USER_INITIATED=

使用可能なデータベース・ターゲット

省略可

データベース・ターゲットが使用可能であるかどうかを示します。

DB_TARGET_AVAILABLE=

ソース・データベースのプラットフォーム名

省略可

ソース・データベースのプラットフォーム名。たとえば、Linux x86-64、x86-64 (64ビット)上のOracle Solarisなど。

SOURCE_DB_PLATFORM_NAME=

プロファイル実行のスケジュール

省略可

プロファイル実行のスケジュール。

PROFILE_SCHEDULE=

プロファイルの単一リフレッシュ

省略可

プロファイルの単一リフレッシュ。

PROFILE_SINGLE_REFRESH=

プロファイル・パージ・ポリシー・タイプ

省略可

プロファイル・パージ・ポリシー・タイプ。

PROFILE_PURGE_POLICY_TYPE=

プロファイル・パージ・ポリシー値

省略可

プロファイル・パージ・ポリシー値。

PROFILE_PURGE_POLICY_VALUE=

プロファイル・イメージ・バージョン

省略可

プロファイル・イメージ・バージョン。

PROFILE_IMAGE_VERSION=

プロファイルの場所リスト

省略可

プロファイルの場所リスト。

PROFILE_LOC_LIST

47.6.3.2 ソース・データベースからの新規のRMANバックアップ

表47-8 新規のRMANバックアップのEMCLIプロパティ・ファイル

Name

必須

説明

変数

参照データベース

必須

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE=

参照データベースのタイプ

必須

ソース・データベースのターゲット・タイプ(oracle_databaseまたはrac_database)。

REFERENCE_DATABASE_TYPE=

参照ノード

省略可

プロファイルが作成される参照ノード。RACおよびクラスタ・ターゲットにのみ適用できます。

REF_NODE_SELECTED=

データのバックアップ・メカニズム

省略可

バックアップ・データの作成に使用する必要があるモードを特定するための変数。可能な値は、EXPORT、DBCA_TEMPLATE、RMANおよびTHIN_PROVISIONINGです。

DATA_CONTENT_MODE=RMAN

バックアップに含まれるコンテンツ

省略可

バックアップに含まれるデータ・コンテンツは、メタデータまたはデータです。可能な値は、METADATA_ONLYおよびMETADATA_AND_DATAです。

DATA_CONTENT=METADATA_AND_DATA

参照ホスト資格証明

必須

OS認証に使用される資格証明。形式は、<資格証明名:所有者>です。指定されない場合は、優先資格証明がNormalHostCredsで確認されます。

REF_HOST_CREDENTIALS=

データベース資格証明

省略可

データベース認証の実行に使用される資格証明。形式は、<資格証明名:所有者>です。指定されない場合は、優先資格証明がSysDbaCredsで確認されます。

REF_DB_CREDENTIALS=

プロファイル名

必須

プロファイルの名前。

PROFILE_NAME=

プロファイルの説明

省略可

作成されるプロファイルの名前。

PROFILE_DESC=

プロファイルの場所

必須

ソフトウェア・ライブラリ内のプロファイルの場所。

PROFILE_LOCATION=

プロファイルのバージョン

省略可

プロファイルのバージョン。何も指定されていない場合は、データベースのバージョンが使用されます。

PROFILE_VERSION=

プロファイル・ベンダー

省略可

プロファイルのベンダー。デフォルトはOracleです。

PROFILE_VENDOR=

プロファイル・ノート

省略可

プロファイルの備考。

PROFILE_NOTES=

作業ディレクトリ

省略可

作業ディレクトリは、ファイルがステージングされる場所です。

WORKING_DIRECTORY=

エンド・ユーザーによって開始されるプロファイルです

必須

バックアップ・プロセスまたはデータベースの一部としてエンド・ユーザーが開始するプロファイルです。

USER_INITIATED=false

使用可能なデータベース・ターゲット

省略可

使用可能なデータベース・ターゲット。このユースケースでは、trueに設定する必要があります。

DB_TARGET_AVAILABLE=true

バックアップ・タイプ

省略可

バックアップのタイプ。

RMAN.BACKUP_TYPE=

使用するRMANチャネルの数(チャネルのデフォルト数: 2)

省略可

使用するチャネル数。可能な値は、1、2、3などです。

RMAN.RMAN_CHANNELS=

次までバックアップを保存

省略可

バックアップの保存期限。形式は、mm/dd/yyyyです。

RMAN.RETAIN_UNTIL=

暗号化タイプ

省略可

暗号化タイプ。可能な値は、ON、OFFです。

RMAN.ENCRYPTION_TYPE=

暗号化パスワード/鍵

省略可

バックアップの暗号化に使用された暗号化鍵。

RMAN.ENCRYPTION_PASSWORD=

圧縮タイプ

省略可

圧縮タイプ。可能な値は、HIGH、MEDIUM、LOWです。

RMAN.COMPRESSION_TYPE=

RMANバックアップの場所

必須

RMANバックアップの場所。

RMAN.RMAN_BACKUP_LOCATION=

バックアップ・ファイルの形式

省略可

バックアップ・ファイルの形式。

RMAN.BACKUP_FILE_FORMAT=

バックアップ・ファイル・タグ

省略可

バックアップ・ファイル・タグ。

RMAN.BACKUP_FILE_TAG=

ソース: 制御ファイルの場所

省略可

制御ファイルの場所。

RMAN.CONTROL_FILE_NAME=

制御ファイル・タグ

省略可

制御ファイル・タグ。

RMAN.CONTROL_FILE_TAG=

ソース: データベースSID

省略可

ソース・データベースのデータベースSID。

RMAN.ORACLE_DB_SID=

ファイル名の初期化

省略可

ファイル名を初期化します。

RMAN.INIT_FILE_NAME=

ユーザー・リスト・ファイル名

省略可

ユーザー・リスト・ファイルの名前。このファイルは、RMAN_BACKUP_LOCATIONに指定された場所に保持されます。

RMAN.USERLIST_FILE_NAME=

ソースDbのGDB名

省略可

ソースDbのGDB名。

RMAN.DATABASE_NAME=

既存のRMANバックアップの使用

必須

既存のRMANバックアップを使用します。このユースケースでは、NOに設定する必要があります。

RMAN.USE_EXISTING_BACKUP=NO

47.6.3.3 ソース・データベースからの既存のRMANバックアップ

表47-9 既存のRMANバックアップのEMCLIプロパティ・ファイル

Name

必須

説明

変数

参照データベース

必須

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE=

参照データベースのタイプ

必須

ソース・データベースのターゲット・タイプ(oracle_databaseまたはrac_database)。

REFERENCE_DATABASE_TYPE=

参照ノード

省略可

プロファイルが作成される参照ノード。RACおよびクラスタ・ターゲットにのみ適用できます。

REF_NODE_SELECTED=

データのバックアップ・メカニズム

省略可

バックアップ・データの作成に使用する必要があるモードを特定するための変数。可能な値は、EXPORT、DBCA_TEMPLATE、RMANおよびTHIN_PROVISIONINGです。

DATA_CONTENT_MODE=RMAN

バックアップに含まれるコンテンツ

省略可

バックアップに含まれるデータ・コンテンツは、メタデータまたはデータです。可能な値は、METADATA_ONLYおよびMETADATA_AND_DATAです。

DATA_CONTENT=METADATA_AND_DATA

参照ホスト資格証明

必須

OS認証に使用される資格証明。形式は、<資格証明名:所有者>です。指定されない場合は、優先資格証明がNormalHostCredsで確認されます。

REF_HOST_CREDENTIALS=

データベース資格証明

省略可

データベース認証の実行に使用される資格証明。形式は、<資格証明名:所有者>です。指定されない場合は、優先資格証明がSysDbaCredsで確認されます。

REF_DB_CREDENTIALS=

プロファイル名

必須

プロファイルの名前。

PROFILE_NAME=

プロファイルの説明

省略可

作成されるプロファイルの名前。

PROFILE_DESC=

プロファイルの場所

必須

ソフトウェア・ライブラリ内のプロファイルの場所。

PROFILE_LOCATION=

プロファイルのバージョン

省略可

プロファイルのバージョン。何も指定されていない場合は、データベースのバージョンが使用されます。

PROFILE_VERSION=

プロファイル・ベンダー

省略可

プロファイルのベンダー。デフォルトはOracleです。

PROFILE_VENDOR=

プロファイル・ノート

省略可

プロファイルの備考。

PROFILE_NOTES=

作業ディレクトリ

省略可

作業ディレクトリは、ファイルがステージングされる場所です。

WORKING_DIRECTORY=

エンド・ユーザーによって開始されるプロファイルです

必須

バックアップ・プロセスまたはデータベースの一部としてエンド・ユーザーが開始するプロファイルです。

USER_INITIATED=false

使用可能なデータベース・ターゲット

省略可

使用可能なデータベース・ターゲット。このユースケースでは、trueに設定する必要があります。

DB_TARGET_AVAILABLE=true

ソース・データベースのプラットフォーム名

省略可

ソース・データベースのプラットフォーム名。たとえば、Linux x86-64またはOracle Solaris on x86-64 (64ビット)などです。

SOURCE_DB_PLATFORM_NAME=

バックアップ・タイプ

省略可

バックアップのタイプ。

RMAN.BACKUP_TYPE=

使用するRMANチャネルの数(チャネルのデフォルト数: 2)

省略可

使用するチャネル数。可能な値は、1、2、3などです。

RMAN.RMAN_CHANNELS=

次までバックアップを保存

省略可

バックアップの保存期限。形式は、mm/dd/yyyyです。

RMAN.RETAIN_UNTIL=

暗号化タイプ

省略可

暗号化タイプ。可能な値は、ON、OFFです。

RMAN.ENCRYPTION_TYPE=

ソース: 暗号化パスワード/鍵

省略可

バックアップの暗号化に使用された暗号化鍵。

RMAN.ENCRYPTION_PASSWORD=

圧縮タイプ

省略可

圧縮タイプ。可能な値は、HIGH、MEDIUM、LOWです。

RMAN.COMPRESSION_TYPE=

RMANバックアップの場所

必須

RMANバックアップの場所。

RMAN.RMAN_BACKUP_LOCATION=

バックアップ・ファイルの形式

省略可

バックアップ・ファイルの形式。

RMAN.BACKUP_FILE_FORMAT=

バックアップ・ファイル・タグ

省略可

バックアップ・ファイル・タグ。

RMAN.BACKUP_FILE_TAG=

ソース: 制御ファイルの場所

省略可

制御ファイルの場所。

RMAN.CONTROL_FILE_NAME=

制御ファイル・タグ

省略可

制御ファイル・タグ。

RMAN.CONTROL_FILE_TAG=

ソース: データベースSID

省略可

ソース・データベースのデータベースSID。

RMAN.ORACLE_DB_SID=

ファイル名の初期化

省略可

ファイル名を初期化します。

RMAN.INIT_FILE_NAME=

ユーザー・リスト・ファイル名

省略可

ユーザー・リスト・ファイルの名前。このファイルは、RMAN_BACKUP_LOCATIONに指定された場所に保持されます。

RMAN.USERLIST_FILE_NAME=

ソースDbのGDB名

省略可

ソースDbのGDB名。

RMAN.DATABASE_NAME=

既存のRMANバックアップの使用

必須

既存のRMANバックアップを使用します。このユースケースでは、YESに設定する必要があります。

RMAN.USE_EXISTING_BACKUP=YES

47.6.3.4 ステージングの場所の既存のRMANバックアップ

表47-10 ステージングの場所の既存のRMANバックアップのEMCLIプロパティ・ファイル

Name

必須

説明

変数

参照データベース

必須

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE=

参照データベースのタイプ

必須

ソース・データベースのターゲット・タイプ(oracle_databaseまたはrac_database)。

REFERENCE_DATABASE_TYPE=

参照ノード

省略可

プロファイルが作成される参照ノード。RACおよびクラスタ・ターゲットにのみ適用できます。

REF_NODE_SELECTED=

データのバックアップ・メカニズム

省略可

バックアップ・データの作成に使用する必要があるモードを特定するための変数。可能な値は、EXPORT、DBCA_TEMPLATE、RMANおよびTHIN_PROVISIONINGです。

DATA_CONTENT_MODE=RMAN

バックアップに含まれるコンテンツ

省略可

バックアップに含まれるデータ・コンテンツは、メタデータまたはデータです。可能な値は、METADATA_ONLYおよびMETADATA_AND_DATAです。

DATA_CONTENT=METADATA_AND_DATA

参照ホスト資格証明

必須

OS認証に使用される資格証明。形式は、<資格証明名:所有者>です。指定されない場合は、優先資格証明がNormalHostCredsで確認されます。

REF_HOST_CREDENTIALS=

データベース資格証明

省略可

データベース認証の実行に使用される資格証明。形式は、<資格証明名:所有者>です。指定されない場合は、優先資格証明がSysDbaCredsで確認されます。

REF_DB_CREDENTIALS=

プロファイル名

必須

プロファイルの名前。

PROFILE_NAME=

プロファイルの説明

省略可

作成されるプロファイルの名前。

PROFILE_DESC=

プロファイルの場所

必須

ソフトウェア・ライブラリ内のプロファイルの場所。

PROFILE_LOCATION=

プロファイルのバージョン

省略可

プロファイルのバージョン。何も指定されていない場合は、データベースのバージョンが使用されます。

PROFILE_VERSION=

プロファイル・ベンダー

省略可

プロファイルのベンダー。デフォルトはOracleです。

PROFILE_VENDOR=

プロファイル・ノート

省略可

プロファイルの備考。

PROFILE_NOTES=

作業ディレクトリ

省略可

作業ディレクトリは、ファイルがステージングされる場所です。

WORKING_DIRECTORY=

エンド・ユーザーによって開始されるプロファイルです

必須

バックアップ・プロセスまたはデータベースの一部としてエンド・ユーザーが開始するプロファイルです。

USER_INITIATED=false

使用可能なデータベース・ターゲット

省略可

使用可能なデータベース・ターゲット。このユースケースでは、falseに設定する必要があります。

DB_TARGET_AVAILABLE=false

ソース・データベースのプラットフォーム名

省略可

ソース・データベースのプラットフォーム名。たとえば、Linux x86-64またはOracle Solaris on x86-64 (64ビット)などです。

SOURCE_DB_PLATFORM_NAME=

バックアップ・タイプ

省略可

バックアップのタイプ。

RMAN.BACKUP_TYPE=

使用するRMANチャネルの数(チャネルのデフォルト数: 2)

省略可

使用するチャネル数。可能な値は、1、2、3などです。

RMAN.RMAN_CHANNELS=

次までバックアップを保存

省略可

バックアップの保存期限。形式は、mm/dd/yyyyです。

RMAN.RETAIN_UNTIL=

暗号化タイプ

省略可

暗号化タイプ。可能な値は、ON、OFFです。

RMAN.ENCRYPTION_TYPE=

ソース: 暗号化パスワード/鍵

省略可

バックアップの暗号化に使用された暗号化鍵。

RMAN.ENCRYPTION_PASSWORD=

圧縮タイプ

省略可

圧縮タイプ。可能な値は、HIGH、MEDIUM、LOWです。

RMAN.COMPRESSION_TYPE=

RMANバックアップの場所

必須

RMANバックアップの場所。

RMAN.RMAN_BACKUP_LOCATION=

バックアップ・ファイルの形式

省略可

バックアップ・ファイルの形式。可能な値は、%Uです。

RMAN.BACKUP_FILE_FORMAT=

ソース: 制御ファイルの場所

省略可

制御ファイルの場所。

RMAN.CONTROL_FILE_NAME=

制御ファイル・タグ

省略可

制御ファイル・タグ。デフォルトは、control01.ctlです。

RMAN.CONTROL_FILE_TAG=

ソース: データベースSID

省略可

ソース・データベースのデータベースSID。

RMAN.ORACLE_DB_SID=

ファイル名の初期化

省略可

ファイル名を初期化します。

RMAN.INIT_FILE_NAME=

ユーザー・リスト・ファイル名

省略可

ユーザー・リスト・ファイルの名前。このファイルは、RMAN_BACKUP_LOCATIONに指定された場所に保持されます。

RMAN.USERLIST_FILE_NAME=

ソースDbのGDB名

省略可

ソースDbのGDB名。

RMAN.DATABASE_NAME=

RMDBのバージョン

省略可

RMDBSのバージョン。

RMAN.DATABASE_VERSION=

47.6.3.5 スナップ・クローン・データベース

表47-11 スナップクローン・データベースのEMCLIプロパティ・ファイル

Name

必須

説明

変数

参照データベース

必須

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE=

参照データベースのタイプ

必須

ソース・データベースのターゲット・タイプ(oracle_databaseまたはrac_database)。

REFERENCE_DATABASE_TYPE=

参照ノード

省略可

プロファイルが作成される参照ノード。RACおよびクラスタ・ターゲットにのみ適用できます。

REF_NODE_SELECTED=

データベース・ゴールド・イメージの作成

省略可

プロファイルの一部としてデータベース・ゴールド・イメージを含みます。

DATABASE_GOLD_IMAGE_TYPE=

GIゴールド・イメージの作成

省略可

プロファイルの一部としてGIゴールド・イメージを含みます。

GI_GOLD_IMAGE_TYPE=

データベース・ゴールド・イメージの作成

省略可

プロファイルの一部としてデータベース・ゴールド・イメージを含みます。

DATA_CONTENT_MODE=

データ・コンテンツのモードの作成

省略可

作成モードは、既存のデータを使用するか、新しいデータを作成するかを決定します。

CREATE_DATA_OPTION=

バックアップに含まれるコンテンツ

省略可

バックアップに含まれるデータ・コンテンツは、メタデータまたはデータです。

DATA_CONTENT=

参照ホスト資格証明

省略可

OS認証に使用される資格証明。

REF_HOST_CREDENTIALS=

データベース資格証明

省略可

データベース関連の操作の実行に使用される資格証明。

REF_DB_CREDENTIALS=

グリッド・インフラストラクチャの資格証明

省略可

グリッド・インフラストラクチャのOS認証に使用される資格証明。

REF_GI_CREDENTIALS=

ルート資格証明

省略可

ホストの権限付き操作の実行に必要なルート資格証明。

REF_HOST_ROOT_CREDENTIALS=

OFAフォーマットへの変換

省略可

OFAフォーマットに変換します。

CONVERT_TO_OFA=

プロファイル名

必須

プロファイル名。

PROFILE_NAME=

プロファイルの説明

省略可

作成されるプロファイルの名前。

PROFILE_DESC=

プロファイルの場所

必須

ソフトウェア・ライブラリ内のプロファイルの場所。

PROFILE_LOCATION=

プロファイルのバージョン

省略可

プロファイルのバージョン。何も指定しない場合、データベース・バージョンが使用されます。

PROFILE_VERSION=

プロファイル・ベンダー

省略可

プロファイルのベンダー。デフォルトは「Oracle」です。

PROFILE_VENDOR=

プロファイル・ノート

省略可

プロファイルの備考。

PROFILE_NOTES=

イメージ・バージョン・フラグの作成

省略可

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

DB_GOLD_IMAGE_CREATE_VERSION_ONLY=

イメージ・バージョン・フラグの作成

省略可

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

GI_GOLD_IMAGE_CREATE_VERSION_ONLY=

GIホーム・ゴールド・イメージID

省略可

ゴールド・イメージのエンティティID。

GI_GOLD_IMAGE_ID=

データベース・ホーム・ゴールド・イメージID

省略可

ゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ID=

データベース・ゴールド・イメージID

省略可

ゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ID=

データベース・ゴールド・イメージ名

省略可

データベース・ゴールド・イメージのエンティティ名。

DB_GOLD_IMAGE_ENTITY_NAME=

グリッド・インフラストラクチャのゴールド・イメージ名

省略可

データベース・ゴールド・イメージのエンティティ名。

GI_GOLD_IMAGE_ENTITY_NAME=

データ・ゴールド・イメージ名

省略可

データ・ゴールド・イメージのエンティティ名。

DATA_GOLD_IMAGE_ENTITY_NAME=

作業ディレクトリ

省略可

作業ディレクトリは、ファイルがステージングされる場所です。

WORKING_DIRECTORY=

記憶域タイプ

省略可

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです。

STORAGE_TYPE_FOR_SOFTWARE=

ストレージ名

省略可

ソフトウェア・ライブラリで構成されるストレージ名。

STORAGE_NAME_FOR_SOFTWARE=

NFSマウント・ポイント

省略可

NFSサーバーがホストにマウントされる場所。

NFS_LOCAL_MOUNT_POINT_FOR_SOFTWARE=

記憶域タイプ

省略可

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです。

STORAGE_TYPE_FOR_DATA=

ストレージ名

省略可

ソフトウェア・ライブラリで構成されるストレージ名。

STORAGE_NAME_FOR_DATA=

NFSマウント・ポイント

省略可

NFSサーバーがホストにマウントされる場所。

NFS_LOCAL_MOUNT_POINT_FOR_DATA=

エンド・ユーザーによって開始されるプロファイルです

省略可

バックアップ・プロセスまたはデータベースの一部としてエンド・ユーザーが開始するプロファイルです。

USER_INITIATED=

使用可能なデータベース・ターゲット

省略可

使用可能なデータベース・ターゲットです。

DB_TARGET_AVAILABLE=

ソース・データベースのプラットフォーム名

省略可

ソース・データベースのプラットフォーム名。たとえば、Linux x86-64、x86-64 (64ビット)上のOracle Solarisなど。

SOURCE_DB_PLATFORM_NAME=

プロファイル実行のスケジュール

省略可

プロファイル実行のスケジュール。

PROFILE_SCHEDULE=

プロファイルの単一リフレッシュ

省略可

プロファイルの単一リフレッシュ。

PROFILE_SINGLE_REFRESH=

プロファイル・パージ・ポリシー・タイプ

省略可

プロファイル・パージ・ポリシー・タイプ。

PROFILE_PURGE_POLICY_TYPE=

プロファイル・パージ・ポリシー値

省略可

プロファイル・パージ・ポリシー値。

PROFILE_PURGE_POLICY_VALUE=

プロファイル・イメージ・バージョン

省略可

プロファイル・イメージ・バージョン。

PROFILE_IMAGE_VERSION=

プロファイルの場所リスト

省略可

プロファイルの場所リスト。

PROFILE_LOC_LIST=

47.6.3.6 スキーマ・データベース

表47-12 スキーマ・データベースのEMCLIプロパティ・ファイル

Name

必須

説明

変数

参照データベース

必須

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE=

参照データベースのタイプ

必須

ソース・データベースのターゲット・タイプ(oracle_databaseまたはrac_database)。

REFERENCE_DATABASE_TYPE=

参照ノード

省略可

プロファイルが作成される参照ノード。RACおよびクラスタ・ターゲットにのみ適用できます。

REF_NODE_SELECTED=

データのバックアップ・メカニズム

省略可

バックアップ・データの作成に使用する必要があるモードを特定するための変数。可能な値は、EXPORT、DBCA_TEMPLATE、RMANおよびTHIN_PROVISIONINGです。

DATA_CONTENT_MODE=EXPORT

バックアップに含まれるコンテンツ

省略可

バックアップに含まれるデータ・コンテンツは、メタデータまたはデータです。可能な値は、METADATA_ONLYおよびMETADATA_AND_DATAです。

DATA_CONTENT=METADATA_AND_DATA

参照ホスト資格証明

必須

OS認証に使用される資格証明。形式は、<資格証明名:所有者>です。指定されない場合は、優先資格証明がNormalHostCredsで確認されます。

REF_HOST_CREDENTIALS=

データベース資格証明

省略可

データベース認証の実行に使用される資格証明。形式は、<資格証明名:所有者>です。指定されない場合は、優先資格証明がSysDbaCredsで確認されます。

REF_DB_CREDENTIALS=

プロファイル名

必須

プロファイルの名前。

PROFILE_NAME=

プロファイルの説明

省略可

作成されるプロファイルの名前。

PROFILE_DESC=

プロファイルの場所

必須

ソフトウェア・ライブラリ内のプロファイルの場所。

PROFILE_LOCATION=

プロファイルのバージョン

省略可

プロファイルのバージョン。何も指定されていない場合は、データベースのバージョンが使用されます。

PROFILE_VERSION=

プロファイル・ベンダー

省略可

プロファイルのベンダー。デフォルトはOracleです。

PROFILE_VENDOR=

プロファイル・ノート

省略可

プロファイルの備考。

PROFILE_NOTES=

データ・ゴールド・イメージ名

必須

データ・ゴールド・イメージのエンティティ名。

DATA_GOLD_IMAGE_ENTITY_NAME=

作業ディレクトリ

省略可

作業ディレクトリは、ファイルがステージングされる場所です。

WORKING_DIRECTORY=

エクスポートするスキーマ

必須

エクスポートの一部として含める必要があるスキーマのリスト。

EXPORT.SCHEMA_INCLUDE_LIST.0=

ダンプ・ディレクトリ

省略可

エクスポートの保存に使用する必要があるディレクトリ・オブジェクトのリスト。形式: directory=dir1,file_name=file1%U.dmp[,max_size=1MB]。

EXPORT.DUMP_DIRECTORY_LIST.0=

ログ・ディレクトリ

省略可

エクスポート中にログ・ファイルが生成されたログ・ディレクトリの場所。

PORT.LOG_FILE_DIRECTORY=

並列度

省略可

並列度は、スレッドの数を示します。たとえば、1、2または3です。

EXPORT.DEGREE_OF_PARALLELISM=

47.6.4 データベース・プロファイルEM CLI動詞

次の表に、データベース・プロファイルに関連する動詞を示します。

表47-13 データベース・プロファイルEM CLI動詞

動詞

説明

形式

emcli create_dbprofile

新しいデータベース・プロファイルを作成します。

オプション:

- -input_file - 作成されるプロファイルのタイプと使用されるオプションについて完全に記述するプロパティ・ファイル。プロパティ・ファイルの値の移入に関するヘルプを参照するには、emcli help describe_dbprofile_inputと入力します。プロパティ・ファイルの詳細は、第47.6.3項「EM CLIプロパティ・ファイルの例」を参照してください。

- -schedule

- frequency: データベース・プロファイルを作成する頻度タイプ。間隔(分単位)、weekly、monthlyまたはyearlyを指定できます。

- start_time: yy-MM-dd HH:mm書式のデータベース・プロファイル・コンポーネントの作成の開始時間を示します。

- end_time: yy-Mm-dd HH:mm書式のデータベース・プロファイル・コンポーネントの作成の繰返しの終了時間を示します。

- repeat: データベース・プロファイルを作成する繰返し率。頻度が間隔の場合、繰返しは分単位です。

- months: データベース・プロファイル・コンポーネントの作成の繰返しが発生するまでの月数。

- days: データベース・プロファイル・コンポーネントの作成の繰返しが発生するまでの日数。

- tz: タイム・ゾーンのID。たとえば、tz:America/New_Yorkです。

- grace_period: データベース・プロファイルの作成を試行する際に許可される最大遅延を定義する期間(分)。ジョブ・システムでは、スケジュールされた時間に猶予期間を加えた期間内に実行を開始できない場合、データベース・プロファイルの作成のスキップが設定されます。デフォルトでは、猶予期間は無期限です。

- -purge_policy - 日数またはスナップショットの数に基づいて収集されたデータをパージします。指定しない場合は、デフォルトでNONEが設定されます。使用可能な値は、DAYSおよびSNAPSHOTです。

- DAYSは、データ・コンポーネントのパージが必要になるまでの日数を指定します。

- SNAPSHOTは、データ・コンポーネントの数を指定します。この値より古いデータがパージされます。

例

emcli create_dbprofile -input_file="data:/tmp/profile.txt" -schedule="frequency:interval;start_time:14-10-05 05:30;end_time:14-10-12 05:23;repeat:30;grace_period:60;tz:America/New_York" -purge_policy=DAYS:2

emcli create_dbprofile

-input_file=data:"絶対ファイル・パス"

[-schedule=

[frequency:interval|weekly|monthly|yearly];

start_time:yy-MM-dd HH:mm;

end_time:yy-MM-dd HH:mm;

[repeat:#m];

[months:#,#,#,...];

[days:#,#,#,...];

[tz:{timezone ID}];

[grace_period:xxx];

]

[-purge_policy=DAYS|SNAPSHOTS: number]

emcli edit_dbprofile

クローニングされたデータベース・プロファイルを更新します。

オプション:

- [-comp_loc] - ソフトウェア・ライブラリ内のデータベース・プロファイル・コンポーネントの場所を示します。

- [-schedule] - クローニングのスケジュールを示します。

- [frequency:interval| daily |weekly|monthly|yearly];

- start_time:yy-MM-dd HH:mm;

- end_time:yy-MM-dd HH:mm;

- [repeat:#m];

- [months:#,#,#,...];

- [days:#,#,#,...];

- [tz:{java timezone ID}];

- [grace_period:xxx];

- [-purge_policy] - パージが行われるまでの期間を示します。

例:

emcli edit_dbprofile
-comp_loc="Database Provisioning Profiles/11.2.0.4.0/linux_x64/Database xyxy.us.example.com Profile100"
-schedule="start_time:14-07-22 03:00;frequency:interval;end_time:14-07-22 23:00;repeat:30"
-purge_policy="DAYS:1"

emcli edit_dbprofile

-comp_loc="ソフトウェア・ライブラリ内のデータベース・プロファイル・コンポーネントの場所"

[-schedule=

[frequency:interval|daily |weekly|monthly|yearly];

start_time:yy-MM-dd HH:mm;

end_time:yy-MM-dd HH:mm;

[repeat:#m];

[months:#,#,#,...];

[days:#,#,#,...];

[tz:{java timezone ID}];

[grace_period:xxx];

[-purge_policy=days| snapshots: number]

emcli delete_dbprofile

データベース・プロファイルを削除します。

オプション:

- comp_loc - ソフトウェア・ライブラリ内のデータベース・プロファイル・コンポーネントの場所を示します。

- [-version] - データベース・プロファイル・コンポーネントのバージョン名を示します。

例:

- emcli delete_dbprofile -comp_loc="Database Provisioning Profiles/11.2.0.4.0/linux_x64/Database xyxy.example.com Profile101"

- emcli delete_dbprofile -comp_loc="Database Provisioning Profiles/11.2.0.4.0/linux_x64/ Database xyxy.example.com Profile101" -version="THIN_PROVISIONING_07_25_2014_03_00_AM"

emcli delete_dbprofile

-comp_loc="ソフトウェア・ライブラリ内のデータベース・プロファイル・コンポーネントの場所"

[-version="データベース・プロファイル・コンポーネントのバージョン名"]

emcli list_dbprofiles

データベース・プロファイルをリストします。

オプション:

- [-details] - データベース・プロファイルの詳細を提供します。

例:

emcli list_dbprofiles -details

emcli list_dbprofiles [-details]

emcli refresh_dbprofile

データベース・プロファイルをリフレッシュします。

オプション:

- -comp_loc - ソフトウェア・ライブラリ内のデータベース・プロファイル・コンポーネントの場所を示します。

例:

emcli refresh_dbprofile -comp_loc="Database Provisioning Profiles/11.2.0.4.0/linux_x64/ Database xyxy.example.com Profile102"

emcli refresh_dbprofile

-comp_loc="ソフトウェア・ライブラリ内のデータベース・プロファイル・コンポーネントの場所"

emcli refresh_database

データベースをリフレッシュします。

オプション:

- -target_name - ターゲット・データベース名を示します。

- -target_type - ターゲット・データベース・タイプを示します。

- -input_file - 入力フィールド値を定義する入力ファイルを示します。

例:

emcli refresh_database -target_name="database" -target_type="oracle_database" -input_file=data:"/tmp/refr.txt"

emcli refresh_database

-target_name="データベース・ターゲット名"

-target_type="データベース・ターゲット・タイプ"

-input_file=data:"file:path"

emcli delete_database

データベースを削除します。

オプション:

- inputFile - データベースの削除に必要なプロパティを含むファイルを示します。詳細は、第47.11項「EM CLI動詞を使用したデータベースの削除」を参照してください。

例:

emcli delete_database -inputFile=/u01/files/delete_clone.props

emli delete_database

-inputFile="クローンの削除に必要なプロパティを含むファイル"

47.6.5 EM CLI動詞を使用したデータベース・プロファイルの作成

この項では、EM CLI動詞を使用して、データベース・プロファイル、RMANバックアップ、RMANイメージ・バックアップまたはスナップショット・バックアップを作成する手順について説明します。

注意:
RMANバックアップ、RMANイメージ・バックアップまたはスナップショット・データベースを作成する手順は、データベース・プロファイルを作成する場合に準拠する手順と同じです。唯一異なるのは、様々な特性のために使用するプロパティ・ファイルです。

図47-1 EM CLI動詞を使用したデータベース・プロファイルの作成

次の手順を使用して、データベース・プロファイルを作成します。

1. プロシージャ定義からテンプレート・プロパティ・ファイルを作成します。
テンプレート・プロパティ・ファイルを作成するには、次の手順に従います。

1. プロシージャのGUIDまたは名前を取得します。次のコマンドを実行してこれらを取得します。

emcli get_procedures
[-type={procedure type}]

Sample command:
emcli get_procedures -type=DBPROV

Sample output:
GUID                  Type    Name                DisplayName                           Version  Owner   Parent Procedure
0A15E9DC285B2EF5E053E87BF00A6701  DBPROV  CLOUD_DEPLOY_SOFTWARE_NAME  Software Life Cycle Management Procedure  14.52    ORACLE
0A15E9DC20712EF5E053E87BF00A6701  DBPROV  CLEANUP_DB_PROC             Cleanup Mass Database                     13.0     ORACLE
0A15E9DC205C2EF5E053E87BF00A6701  DBPROV  DBREPLAYCLIENTDP_NG         Provision Oracle Database Client          14.0     ORACLE
0A15E9DC204E2EF5E053E87BF00A6701  DBPROV  SIHA_SIDB_PROC              Provision Oracle Database                 14.0     ORACLE

2. 次のコマンドに入力値としてGUIDまたは名前を入力し、テンプレート・プロパティ・ファイルを生成します。

emcli describe_procedure_input
[-procedure={procedure GUID}]
[-name={procedure name or procedure configuration}]
[-owner={owner of the procedure or procedure configuration}][-parent_proc={procedure of the procedure configuration. This only applies to describe a procedure configuration with the same name}]

Sample command:
emcli describe_procedure_input -procedure=0A15E9DC204E2EF5E053E87BF00A6701> /tmp/snapprofile.txt

2. プロパティ・ファイルに新しい値を入力します。
エディタを使用してプロパティ・ファイルを編集します。変数に適切な値を入力し、プロパティ・ファイルを保存します。

データベース・プロファイルの様々な特性については、次の場所を参照してください。

- データと構造を含む新しいデータベース・プロファイルを作成するには、表47-14「新しいデータベース・プロファイルを作成するためのサンプル・プロパティ・ファイル」の必須パラメータおよび必要なオプション・パラメータ(DATA_CONTENT=METADATA_AND_DATA)を構成します。

- データのみを含む新しいデータベース・プロファイルを作成するには、表47-14「新しいデータベース・プロファイルを作成するためのサンプル・プロパティ・ファイル」の必須パラメータおよび必要なオプション・パラメータ(DATA_CONTENT=DATA)を構成します。

- RMANバックアップを作成するには、表47-15「完全バックアップ・プロファイルを作成するためのサンプル・プロパティ・ファイル」を参照してください。

- RMANイメージ・バックアップを作成するには、表47-16「シン・バックアップ・プロファイルを作成するためのサンプル・プロパティ・ファイル」を参照してください。

- スナップショット・データベースを作成するには、表47-15「完全バックアップ・プロファイルを作成するためのサンプル・プロパティ・ファイル」の必須パラメータおよびREF_NODE_SELECTED、DATA_CONTENT、REF_HOST_CREDENTIALS、REF_DB_CREDENTIALS、PROFILE_VERSION、PROFILE_VENDORパラメータを構成します。

表47-14 新しいデータベース・プロファイルを作成するためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

REFERENCE_DATABASE

REFERENCE_DATABASE=dbname.xyz.com

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE_TYPE

REFERENCE_DATABASE_TYPE=oracle_database

ソース・データベースのターゲット・タイプ。使用できる値は、oracle_databaseまたはrac_databaseです。

DATA_CONTENT_MODE

DATA_CONTENT_MODE=STORAGE_SNAPSHOT

データベース・プロファイルを発行する必要のあるデータ・モード。使用できる値は、EXPORT、DBCA_TEMPLATE、RMAN、DNFSおよびSTORAGE_SNAPSHOTです。

PROFILE_NAME

PROFILE_NAME=Profile_snap

プロファイル名。

PROFILE_LOCATION

PROFILE_LOCATION=Database Provisioning Profiles/11.2.0.4.0/linux_x64/

ソフトウェア・ライブラリ内のプロファイルの場所。

オプション・パラメータ

REF_NODE_SELECTED

REF_NODE_SELECTED= xxyy.us.example.com

プロファイルが作成される参照ノード。このパラメータは、RACおよびクラスタ・ターゲットにのみ適用できます。

DATABASE_GOLD_IMAGE_TYPE

プロファイルの一部としてデータベース・ゴールド・イメージを含みます。

GI_GOLD_IMAGE_TYPE

プロファイルの一部としてGIゴールド・イメージを含みます。

CREATE_DATA_OPTION

既存のデータを使用するか、新しいデータを作成するかを示します。

DATA_CONTENT

DATA_CONTENT=METADATA_AND_DATA

バックアップに含まれるデータ・コンテンツは、METADATA_AND_DATAまたはDATAです。

REF_HOST_CREDENTIALS

REF_HOST_CREDENTIALS=AE_2COOL:ARA1

OS認証のための資格証明。

REF_DB_CREDENTIALS

REF_DB_CREDENTIALS=SYS_WD:RAH

データベース関連の操作の実行のための資格証明。

REF_GI_CREDENTIALS

グリッド・インフラストラクチャのOS認証のための資格証明。

REF_HOST_ROOT_CREDENTIALS

REF_HOST_ROOT_CREDENTIALS= AE_2OOL:RA1

ホストの権限付き操作の実行に必要なルート資格証明。

CONVERT_TO_OFA

OFAフォーマットに変換します。

PROFILE_DESC

PROFILE_DESC=11204 SnapClone profile 1

プロファイルの説明。

PROFILE_VERSION

プロファイルのバージョン。このパラメータを指定しない場合、データベース・バージョンが使用されます。

PROFILE_VENDOR

プロファイルのベンダー。デフォルトは「Oracle」です。

PROFILE_NOTES

プロファイルの備考。

DB_GOLD_IMAGE_CREATE_VERSION_ONLY

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

GI_GOLD_IMAGE_CREATE_VERSION_ONLY

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

GI_GOLD_IMAGE_ID

GIゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ID

DBゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ENTITY_NAME

データベース・ゴールド・イメージのエンティティ名。

GI_GOLD_IMAGE_ENTITY_NAME

GIゴールド・イメージのエンティティ名。

DATA_GOLD_IMAGE_ENTITY_NAME

データ・ゴールド・イメージのエンティティ名。

WORKING_DIRECTORY

WORKING_DIRECTORY=/tmp

作業ディレクトリは、ファイルがステージングされる場所です。

STORAGE_TYPE_FOR_SOFTWARE

有効な記憶域タイプのリストは、NFS、AGENT、OmsShareです。

STORAGE_NAME_FOR_SOFTWARE

ソフトウェア・ライブラリで構成されるストレージ名。

NFS_LOCAL_MOUNT_POINT_FOR_SOFTWARE

NFSサーバーがホストにマウントされる場所。

STORAGE_TYPE_FOR_DATA

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです。

STORAGE_NAME_FOR_DATA

ソフトウェア・ライブラリで構成されるストレージ名。

NFS_LOCAL_MOUNT_POINT_FOR_DATA

NFSサーバーがホストにマウントされる場所。

USER_INITIATED

エンド・ユーザーによって開始されるプロファイルが、バックアップ・プロセスまたはデータベースの一部であるかどうかを示します。

DB_TARGET_AVAILABLE

データベース・ターゲットが使用可能であるかどうかを示します。

SOURCE_DB_PLATFORM_NAME

ソース・データベースのプラットフォーム名。たとえば、Linux x86-64、x86-64 (64ビット)上のOracle Solarisなど。

PROFILE_SCHEDULE

プロファイル実行のスケジュール。

PROFILE_SINGLE_REFRESH

プロファイルの単一リフレッシュ。

PROFILE_PURGE_POLICY_TYPE

プロファイル・パージ・ポリシーのタイプ。使用できる値は、SNAPSHOTSまたはDAYSです。デフォルト値は「なし」です。

PROFILE_PURGE_POLICY_VALUE

プロファイル・パージ・ポリシーの値。

PROFILE_IMAGE_VERSION

プロファイル・イメージのバージョン。

表47-15 完全バックアップ・プロファイルを作成するためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

REFERENCE_DATABASE

REFERENCE_DATABASE=dbname.xyz.com

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE_TYPE

REFERENCE_DATABASE_TYPE=oracle_database

ソース・データベースのターゲット・タイプ。oracle_databaseまたはrac_databaseを指定できます。

DATA_CONTENT_MODE

DATA_CONTENT_MODE=STORAGE_SNAPSHOT

データベース・プロファイルを発行する必要のあるデータ・モード。値としてEXPORT、DBCA_TEMPLATE、RMAN、DNFSおよびSTORAGE_SNAPSHOTを指定できます

PROFILE_NAME

PROFILE_NAME=Profile_snap

プロファイル名。

PROFILE_LOCATION

PROFILE_LOCATION=Database Provisioning Profiles/11.2.0.4.0/linux_x64/

ソフトウェア・ライブラリ内のプロファイルの場所。

BACKUP_FILE_TAG

BACKUP_FILE_TAG=data_backup_1419417051961

バックアップ・ファイルのタグ。

BACKUP_TYPE

BACKUP_TYPE=OFFLINE

バックアップのタイプ。使用できる値は、OFFLINEまたはONLINEです。デフォルトはOFFLINEです。

BACKUP_FILE_FORMAT

BACKUP_FILE_FORMAT=backup_%U

バックアップ・ファイルの形式。

RMAN_CHANNELS

RMAN_CHANNELS=2

RMANチャネルの数。

RMAN_BACKUP_LOCATION

RMAN_BACKUP_LOCATION=/oradbnas/aime_slc05ntg/sec

RMANバックアップ・ファイルが作成される場所。IS_SAVE_TARGET_PROFILEがYに、DATA_CONTENT_MODEがRMANまたはDNFSに設定されている場合、このパラメータは必須です。

オプション・パラメータ

REF_NODE_SELECTED

REF_NODE_SELECTED= slch.xyz.com

プロファイルが作成される参照ノード。このパラメータは、RACおよびクラスタ・ターゲットにのみ適用できます。

DATABASE_GOLD_IMAGE_TYPE

プロファイルの一部としてデータベース・ゴールド・イメージを含みます。

GI_GOLD_IMAGE_TYPE

プロファイルの一部としてGIゴールド・イメージを含みます。

CREATE_DATA_OPTION

既存のデータを使用するか、新しいデータを作成するかを示します。

DATA_CONTENT

DATA_CONTENT=METADATA_AND_DATA

バックアップに含まれるデータ・コンテンツは、METADATA_AND_DATAまたはDATAです。

REF_HOST_CREDENTIALS

REF_HOST_CREDENTIALS=AE_2COL:RA1

OS認証のための資格証明。

REF_DB_CREDENTIALS

REF_DB_CREDENTIALS=SYS_WL1:RA1

データベース関連の操作の実行のための資格証明。

REF_GI_CREDENTIALS

グリッド・インフラストラクチャのOS認証のための資格証明。

REF_HOST_ROOT_CREDENTIALS

REF_HOST_ROOT_CREDENTIALS= AE_2L:RA1

ホストの権限付き操作の実行に必要なルート資格証明。

CONVERT_TO_OFA

OFAフォーマットに変換します。

PROFILE_DESC

PROFILE_DESC=11204 SnapClone profile 1

プロファイルの説明。

PROFILE_VERSION

プロファイルのバージョン。このパラメータを指定しない場合、データベース・バージョンが使用されます。

PROFILE_VENDOR

プロファイルのベンダー。デフォルトは「Oracle」です。

PROFILE_NOTES

プロファイルの備考。

DB_GOLD_IMAGE_CREATE_VERSION_ONLY

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

GI_GOLD_IMAGE_CREATE_VERSION_ONLY

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

GI_GOLD_IMAGE_ID

GIゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ID

DBゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ENTITY_NAME

データベース・ゴールド・イメージのエンティティ名。

GI_GOLD_IMAGE_ENTITY_NAME

GIゴールド・イメージのエンティティ名。

DATA_GOLD_IMAGE_ENTITY_NAME

データ・ゴールド・イメージのエンティティ名。

WORKING_DIRECTORY

WORKING_DIRECTORY=/tmp

作業ディレクトリは、ファイルがステージングされる場所です。

STORAGE_TYPE_FOR_SOFTWARE

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです。

STORAGE_NAME_FOR_SOFTWARE

ソフトウェア・ライブラリで構成されるストレージ名。

NFS_LOCAL_MOUNT_POINT_FOR_SOFTWARE

NFSサーバーがホストにマウントされる場所。

STORAGE_TYPE_FOR_DATA

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです。

STORAGE_NAME_FOR_DATA

ソフトウェア・ライブラリで構成されるストレージ名。

NFS_LOCAL_MOUNT_POINT_FOR_DATA

NFSサーバーがホストにマウントされる場所。

USER_INITIATED

エンド・ユーザーによって開始されるプロファイルが、バックアップ・プロセスまたはデータベースの一部であるかどうかを示します。

DB_TARGET_AVAILABLE

データベース・ターゲットが使用可能であるかどうかを示します。

SOURCE_DB_PLATFORM_NAME

ソース・データベースのプラットフォーム名。たとえば、Linux x86-64、x86-64 (64ビット)上のOracle Solarisなど。

PROFILE_SCHEDULE

プロファイル実行のスケジュール。

PROFILE_SINGLE_REFRESH

プロファイルの単一リフレッシュ。

PROFILE_PURGE_POLICY_TYPE

プロファイル・パージ・ポリシーのタイプ。使用できる値は、SNAPSHOTSまたはDAYSです。デフォルト値は「なし」です。

PROFILE_PURGE_POLICY_VALUE

プロファイル・パージ・ポリシーの値。

PROFILE_IMAGE_VERSION

プロファイル・イメージのバージョン。

表47-16 シン・バックアップ・プロファイルを作成するためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

REFERENCE_DATABASE

REFERENCE_DATABASE=dbname.example.com

プロファイルが作成されるソース・データベース。

REFERENCE_DATABASE_TYPE

REFERENCE_DATABASE_TYPE=oracle_database

ソース・データベースのターゲット・タイプ。oracle_databaseまたはrac_databaseを指定できます。

DATA_CONTENT_MODE

DATA_CONTENT_MODE=STORAGE_SNAPSHOT

データベース・プロファイルを発行する必要のあるデータ・モード。値としてEXPORT、DBCA_TEMPLATE、RMAN、DNFSおよびSTORAGE_SNAPSHOTを指定できます

PROFILE_NAME

PROFILE_NAME=Profile_snap

プロファイル名。

PROFILE_LOCATION

PROFILE_LOCATION=Database Provisioning Profiles/11.2.0.4.0/linux_x64/

ソフトウェア・ライブラリ内のプロファイルの場所。

DNFS.BACKUP_FILE_TAG

DNFS.BACKUP_FILE_TAG=data_backup_1419417051961

バックアップ・ファイルのタグ。

DNFS.BACKUP_TYPE

DNFS.BACKUP_TYPE=OFFLINE

バックアップのタイプ。使用できる値は、OFFLINEまたはONLINEです。デフォルトはOFFLINEです。

DNFS.BACKUP_FILE_FORMAT

DNFS.BACKUP_FILE_FORMAT=backup_%U

バックアップ・ファイルの形式。

DNFS.BACKUP_LOCATION

DNFS.BACKUP_LOCATION=/oradbnas/aime_slc05ntg/suk

RMANバックアップ・ファイルが作成される場所。IS_SAVE_TARGET_PROFILEがYに、DATA_CONTENT_MODEがRMANまたはDNFSに設定されている場合は必須です。

DNFS.BACKUP_IMAGE_MODE

DNFS.BACKUP_IMAGE_MODE=OfflineImage

バックアップ・イメージ・モード

DNFS.BACKUP_IMAGE_TYPE

DNFS.BACKUP_IMAGE_TYPE=RMANImage

バックアップ・イメージのタイプ。

オプション・パラメータ

REF_NODE_SELECTED

REF_NODE_SELECTED= slnh.us.example.com

プロファイルが作成される参照ノード。このパラメータは、RACおよびクラスタ・ターゲットにのみ適用できます。

DATABASE_GOLD_IMAGE_TYPE

プロファイルの一部としてデータベース・ゴールド・イメージを含みます。

GI_GOLD_IMAGE_TYPE

プロファイルの一部としてGIゴールド・イメージを含みます。

CREATE_DATA_OPTION

既存のデータを使用するか、新しいデータを作成するかを示します。

DATA_CONTENT

DATA_CONTENT=METADATA_AND_DATA

バックアップに含まれるデータ・コンテンツは、METADATA_AND_DATAまたはDATAです。

REF_HOST_CREDENTIALS

REF_HOST_CREDENTIALS=AE_2CL:RA1

OS認証のための資格証明。

REF_DB_CREDENTIALS

REF_DB_CREDENTIALS=SYS_W1:RA1

データベース関連の操作の実行のための資格証明。

REF_GI_CREDENTIALS

グリッド・インフラストラクチャのOS認証のための資格証明。

REF_HOST_ROOT_CREDENTIALS

REF_HOST_ROOT_CREDENTIALS= AE_2CL:RA1

ホストの権限付き操作の実行に必要なルート資格証明。

CONVERT_TO_OFA

OFAフォーマットに変換します。

PROFILE_DESC

PROFILE_DESC=11204 SnapClone profile 1

プロファイルの説明。

PROFILE_VERSION

プロファイルのバージョン。このパラメータを指定しない場合、データベース・バージョンが使用されます。

PROFILE_VENDOR

プロファイルのベンダー。デフォルトは「Oracle」です。

PROFILE_NOTES

プロファイルの備考。

DB_GOLD_IMAGE_CREATE_VERSION_ONLY

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

GI_GOLD_IMAGE_CREATE_VERSION_ONLY

イメージ・バージョンのみを作成する必要があるかどうかを示すフラグ。

GI_GOLD_IMAGE_ID

GIゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ID

DBゴールド・イメージのエンティティID。

DB_GOLD_IMAGE_ENTITY_NAME

データベース・ゴールド・イメージのエンティティ名。

GI_GOLD_IMAGE_ENTITY_NAME

GIゴールド・イメージのエンティティ名。

DATA_GOLD_IMAGE_ENTITY_NAME

データ・ゴールド・イメージのエンティティ名。

WORKING_DIRECTORY

WORKING_DIRECTORY=/tmp

作業ディレクトリは、ファイルがステージングされる場所です。

STORAGE_TYPE_FOR_SOFTWARE

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです。

STORAGE_NAME_FOR_SOFTWARE

ソフトウェア・ライブラリで構成されるストレージ名。

NFS_LOCAL_MOUNT_POINT_FOR_SOFTWARE

NFSサーバーがホストにマウントされる場所。

STORAGE_TYPE_FOR_DATA

有効な記憶域タイプのリストは、NFS、AGENT、OmsSharedです。

STORAGE_NAME_FOR_DATA

ソフトウェア・ライブラリで構成されるストレージ名。

NFS_LOCAL_MOUNT_POINT_FOR_DATA

NFSサーバーがホストにマウントされる場所。

USER_INITIATED

エンド・ユーザーによって開始されるプロファイルが、バックアップ・プロセスまたはデータベースの一部であるかどうかを示します。

DB_TARGET_AVAILABLE

データベース・ターゲットが使用可能であるかどうかを示します。

SOURCE_DB_PLATFORM_NAME

ソース・データベースのプラットフォーム名。たとえば、Linux x86-64、x86-64 (64ビット)上のOracle Solarisなど。

PROFILE_SCHEDULE

プロファイル実行のスケジュール。

PROFILE_SINGLE_REFRESH

プロファイルの単一リフレッシュ。

PROFILE_PURGE_POLICY_TYPE

プロファイル・パージ・ポリシーのタイプ。使用できる値は、SNAPSHOTSまたはDAYSです。デフォルト値は「なし」です。

PROFILE_PURGE_POLICY_VALUE

プロファイル・パージ・ポリシーの値。

PROFILE_IMAGE_VERSION

プロファイル・イメージのバージョン。

USE_EXISTING_BACKUP

既存のバックアップを使用するかどうか。

3. 更新されたプロパティ・ファイルを入力ファイルとして使用し、次のEM CLI動詞を実行してデータベース・プロファイルを作成します。

emcli create_dbprofile
-input_file=data:"file:path"
[-schedule=
[frequency:interval|daily|weekly|monthly|yearly];
start_time:yy-MM-dd HH:mm;
end_time:yy-MM-dd HH:mm;
[repeat:#m];
[months:#,#,#,...];
[days:#,#,#,...];
[tz:{java timezone ID}];
[grace_period:xxx];
]
[-purge_policy=days|snapshots: number]

Samples:
emcli create_dbprofile -input_file=data:"/tmp/snapprofile.txt" -schedule="start_time:14-06-23 01:00;frequency:yearly;end_time:14-05-28 01:00;days:1,3,8,7,10;months:1,3,9,11,1" -purge_policy="SNAPSHOTS:1"

emcli create_dbprofile -input_file=data:"/tmp/snapprofile.txt" -schedule="start_time:14-05-28 01:00;frequency:monthly;end_time:14-05-28 01:00;days:1,3,8,7" -purge_policy="DAYS:1"

emcli create_dbprofile -input_file=data:"/tmp/snapprofile.txt" -schedule="start_time:14-05-28 01:00;frequency:weekly;end_time:14-05-28 01:00;days:1,3,7" -purge_policy="SNAPSHOTS:1"

emcli create_dbprofile -input_file=data:"/tmp/snapprofile.txt" -schedule="start_time:14-05-28 01:00;frequency:daily;end_time:14-05-28 01:00" -purge_policy="DAYS:1" -purge_policy="SNAPSHOTS:1"

emcli create_dbprofile -input_file=data:"/tmp/snapprofile.txt" -schedule="start_time:14-07-22 03:00;frequency:interval;end_time:14-07-22 07:00;repeat:30" -purge_policy="SNAPSHOTS:1"

Sample output:
Create Database Profile deployment procedure has been submitted successfully with the instance name :
'CreateDatabaseProfile_SYSMAN_06_23_2014_01_00_PM' and execution_guid='0AE6096550756B26E0539878B10A6FF5'
You can track the status of profile creation using the following command:
emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

4. 次のEM CLI動詞を実行して、データベース・プロファイル作成のステータスを確認します。

emcli get_instance_status
[-instance={instance guid}]
[-exe=execution guid]
[-xml
[-details]
[-showJobOutput]
[-tailLength={last N characters}]]

Sample:
emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5

Sample Output:
0AE6096550716B26E0539878B10A6FF5, PROFILE, CreateDatabaseProfile_SYSMAN_12_23_2014_23_18_PM, Running

xml形式で各手順の完全なステータスを確認するには、次のコマンドを実行します。

emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

47.6.6 EM CLI動詞を使用したデータベース・プロファイルの編集

この項では、EM CLI動詞を使用して、データベース・プロファイルを編集する手順について説明します。

図47-2 EM CLI動詞を使用したデータベース・プロファイルの編集

次の手順を使用して、データベース・プロファイルを編集します。

1. ソフトウェア・ライブラリでデータベース・プロファイルの場所を特定します。
次のコマンドを実行してデータベース・プロファイルの場所を特定します。

emcli list_dbprofiles
[-details]

Sample command:
emcli list_dbprofiles

Sample output:
Name=Profile_snap,Location=Database Provisioning Profiles/11.2.0.4.0/linux_x64/
Name=Profile_rman,Location=Database Provisioning Profiles/11.2.0.4.0/linux_x64/

2. 取得した場所を使用して、次のコマンドでデータベース・プロファイルを編集します。

emcli edit_dbprofile
-comp_loc="Database Profile component location in software library"
[-schedule=
[frequency:interval| daily |weekly|monthly|yearly];
start_time:yy-MM-dd HH:mm;
end_time:yy-MM-dd HH:mm;
[repeat:#m];
[months:#,#,#,...];
[days:#,#,#,...];
[tz:{java timezone ID}];
[grace_period:xxx];
]
[-purge_policy=days| snapshots: number]

Sample command:
emcli edit_dbprofile -comp_loc="Database Provisioning Profiles/11.2.0.4.0/linux_x64/Profile_snap " -schedule="start_time:14-07-22 03:00;frequency:interval;end_time:14-07-22 23:00;repeat:30" -purge_policy="DAYS:1"

Sample output:
The Create Database Profile deployment procedure with new schedule and purge policy has been submitted successfully with the instance name :
'CreateDatabaseProfile_SYSMAN_07_22_2014_03_00_PM' and execution_guid= '0AE6096550756B26E0539878B10A6FF5'
You can track the status of profile creation using the following command:
emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

3. 次のEM CLI動詞を実行して、データベース・プロファイル編集のステータスを確認します。

emcli get_instance_status
[-instance={instance guid}]
[-exe=execution guid]
[-xml
[-details]
[-showJobOutput]
[-tailLength={last N characters}]]

Sample:
emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5

Sample output:
0AE6096550716B26E0539878B10A6FF5, PROFILE, CreateDatabaseProfile_SYSMAN_07_22_2014_03_00_PM, Running

xml形式で各手順の完全なステータスを確認するには、次のコマンドを実行します。

emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

47.6.7 EM CLI動詞を使用したデータベース・プロファイルの削除

この項では、EM CLI動詞を使用して、データベース・プロファイルを削除する手順について説明します。

図47-3 EM CLI動詞を使用したデータベース・プロファイルの削除

次の手順を使用して、データベース・プロファイルを削除します。

1. ソフトウェア・ライブラリでデータベース・プロファイル・コンポーネントの場所とバージョンを特定します。
次のコマンドを実行してデータベース・プロファイルの場所を特定します。

emcli list_dbprofiles
[-details]

Sample command:
emcli list_dbprofiles

Sample output:
Name=Profile_snap,Location=Database Provisioning Profiles/11.2.0.4.0/linux_x64/,Type=STORAGE_SNAPSHOT,Status=Ready,Description= Database Reference Profile 05-11-2014 12:40 PM from database.mycompany.com
Version: STORAGE SNAPSHOT_05_11_2014_12_40_PM: ,contains=STORAGE_SNAPSHOT(s),removalOverdue=0, sourceDatabaseName=database.mycompany.com.

Name=Profile_rman,Location=Database Provisioning Profiles/11.2.0.4.0/linux_x64/,Type=RMAN,Status=Ready,Description=Database Reference Profile 04-11-2014 12:40 PM from database.mycompany.com
Version : RMAN_04_11_2014_12_40_PM,contains=RMAN(s),removalOverdue=0, sourceDatabaseName=database.mycompany.com.

2. 取得した場所とバージョンを使用して、次のコマンドでデータベース・プロファイルを削除します。

emcli delete_dbprofile
-comp_loc="Database Profile component location in software library"
[-version="Database Profile component version name"]

Sample command:
emcli delete_dbprofile -comp_loc="Database Provisioning Profiles/11.2.0.4.0/linux_x64/Profile_snap"

emcli delete_dbprofile -comp_loc="Database Provisioning Profiles/11.2.0.4.0/linux_x64/ Profile_snap" -version="STORAGE SNAPSHOT__05_11_2014_12_40_PM"

Sample output:
Delete Database Profile deployment procedure has been submitted successfully with the instance name :'DeleteDatabaseProfile_SYSMAN_07_22_2014_03_00_PM' and execution_guid='0AE6096550756B26E0539878B10A6FF5'
You can track the status of profile creation using the following command:
emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

3. 次のEM CLI動詞を実行して、データベース・プロファイル削除のステータスを確認します。

emcli get_instance_status
[-instance={instance guid}]
[-exe=execution guid]
[-xml
[-details]
[-showJobOutput]
[-tailLength={last N characters}]]

Sample:
emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5

Sample output:
0AE6096550716B26E0539878B10A6FF5, PROFILE, DeleteDatabaseProfile_SYSMAN_07_22_2014_03_00_PM, COMPLETED

xml形式で各手順の完全なステータスを確認するには、次のコマンドを実行します。

emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

47.6.8 すべてのデータベース・プロファイルの表示

次のコマンドを実行して、すべてのデータベース・プロファイルとその詳細を表示します。

emcli list_dbprofiles
[-details]

Sample command:
emcli list_dbprofiles

Sample output:
Name=Profile_snap,Location=Database Provisioning Profiles/11.2.0.4.0/linux_x64/,Type=STORAGE_SNAPSHOT,Status=Ready,Description= Database Reference Profile 05-11-2014 12:40 PM from database.mycompany.com
Version: STORAGE SNAPSHOT_05_11_2014_12_40_PM: ,contains=STORAGE_SNAPSHOT(s),removalOverdue=0, sourceDatabaseName=database.mycompany.com.

Name=Profile_rman,Location=Database Provisioning Profiles/11.2.0.4.0/linux_x64/,Type=RMAN,Status=Ready,Description=Database Reference Profile 04-11-2014 12:40 PM from database.mycompany.com
Version : RMAN_04_11_2014_12_40_PM,contains=RMAN(s),removalOverdue=0, sourceDatabaseName=database.mycompany.com.

47.6.9 EM CLI動詞を使用したデータベース・プロファイルのリフレッシュ

この項では、EM CLI動詞を使用して、データベース・プロファイルをリフレッシュする手順について説明します。

図47-4 EM CLI動詞を使用したデータベース・プロファイルのリフレッシュ

次の手順を使用して、データベース・プロファイルをリフレッシュします。

1. ソフトウェア・ライブラリでデータベース・プロファイル・コンポーネントの場所を特定します。
次のコマンドを実行してデータベース・プロファイルの場所を特定します。

emcli list_dbprofiles
[-details]

Sample command:
emcli list_dbprofiles

Sample output:
Name=Profile_snap,Location=Database Provisioning Profiles/11.2.0.4.0/linux_x64/
Name=Profile_rman,Location=Database Provisioning Profiles/11.2.0.4.0/linux_x64/

2. 取得した場所を使用して、次のコマンドでデータベース・プロファイルをリフレッシュします。

emcli refresh_dbprofile
-comp_loc="Database Profile component location in software library"

Sample command:
emcli refresh_dbprofile -comp_loc="Database Provisioning Profiles/11.2.0.4.0/linux_x64/ Profile_snap"

Sample output:
A Refresh Single Profile procedure has been submitted successfully with the instance name :
'RefreshSingleProfile_SYSMAN_07_22_2014_03_00_PM' and execution_guid= '0AE6096550756B26E0539878B10A6FF5'
You can track the status of profile creation using the following command:
emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

3. 次のEM CLI動詞を実行して、データベース・プロファイル・リフレッシュのステータスを確認します。

emcli get_instance_status
[-instance={instance guid}]
[-exe=execution guid]
[-xml
[-details]
[-showJobOutput]
[-tailLength={last N characters}]]

Sample:
emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5

Sample output:
0AE6096550716B26E0539878B10A6FF5, PROFILE, RefreshSingleProfile_SYSMAN_07_22_2014_03_00_PM, Running

xml形式で各手順の完全なステータスを確認するには、次のコマンドを実行します。

emcli get_instance_status -exe=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

47.7 サービス・テンプレートEM CLI動詞

次の表に、サービス・テンプレートのリソースでサポートされる動詞を示します。

.jsonファイルのコンテンツのサンプルは、第47.8項「サービス・テンプレートの実行可能.jsonファイル」を参照してください。

表47-17 サービス・テンプレートEM CLI動詞

動詞

説明

形式

emcli create_service_template

データベース、スキーマまたはプラガブル・データベース・サービス・テンプレートを作成します。

input_fileは、JSONベースのメタデータ・ファイルで、特定のサービス・テンプレートを作成するための構成情報を含んでいる必要があります。

JSONサービス実行可能メタデータ・ファイルのサンプルは、第47.8項「サービス・テンプレートの実行可能.jsonファイル」にあります。

例:

- データベース・サービス・テンプレート -

emcli create_service_template
-name="Database service template"
-service_family="DBAAS"
-service_type="DB"
-pool_target_type="oracle_cloud_zone"
-software_pools="MyPoolOH"
-roles="SSA_USER_ROLE"
-description="Database small instance service template."
-input_file="data:executable.json"

Sample Output:
Service Template "My Service Template" created successfully

- スキーマ・サービス・テンプレート -

emcli create_service_template
-name="Schema service template"
-service_family="DBAAS"
-service_type="SCHEMA"
-pool_target_type="schaas_pool"
-software_pools="MySCHPool"
-roles="SSA_USER_ROLE"
-description="Schema small instance service template."
-input_file="data:executable.json

Sample Output:
Service Template "My Schema Service Template" created successfully

- プラガブル・データベース・サービス・テンプレート -

emcli create_service_template
-name="PDB service template"
-service_family="DBAAS"
-service_type="PDB"
-pool_target_type="pdbaas_pool"
-software_pools="MyPDBPool"
-roles="SSA_USER_ROLE"
-description="PDB small instance service template."
-input_file="data:executable.json"

Sample Output:
Service Template "My PDB Service Template" created successfully.

emcli create_service_template

-name="<サービス・テンプレートの名前>"

-service_family="<サービス・テンプレートの作成対象となるサービス・ファミリ>"

-service_type="<サービス・テンプレートの作成対象となるサービス・タイプ>"

-pool_target_type="サービス・テンプレートに関連付けられるソフトウェア・プールのターゲット・タイプ"

-software_pools="<SwPool1,SwPool2,SwPool3,...>"

[-roles="<SsaRole1,SsaRole2,..>"]

[-description="<サービス・テンプレートの説明>"]

[-input_file="<サービス実行可能ファイルのメタデータ・ファイルの名前>"]

emcli delete_service_template

サービス・テンプレートを削除します。

例:

emcli delete_service_template
-name="Database service template"
-service_family="DBAAS"
Sample Output:
Service Template with name " Database service template " and service family " DBAAS " deleted successfully.

emcli delete_service_template

-name="<サービス・テンプレートの名前>"

-service_family="<サービス・テンプレートの従属先となるサービス・ファミリ>"]

emcli get_service_templates

渡されるサービス・ファミリに基づいて、利用可能なサービス・テンプレートのリストを取得します。

例:

emcli get_service_templates
-service_family="DBAAS"
Sample Output:
Name Service Family                      Description
ServiceTemplate1                         DBAAS ServiceTemplate1Description

emcli get_service_templates

[-service_family="<サービス・テンプレートのフィルタに使用するサービス・ファミリ・フィルタ>"]

47.8 サービス・テンプレートの実行可能.jsonファイル

次のリストは、サービス・テンプレートの実行可能.jsonファイルのサンプルです。

- DBCAベース・サービス・テンプレートの.jsonファイル

- スタンバイDBCAベース・サービス・テンプレートの.jsonファイル

- RMANベースの単一インスタンス・データベース用のサービス・テンプレートの.jsonファイル

- 単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの.jsonファイル

- RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの.jsonファイル

- スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの.jsonファイル

- 単一インスタンス・スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの.jsonファイル

- DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの.jsonファイル

- DNFSベースのデータベース用のサービス・テンプレートの.jsonファイル

- アーカイブが有効なスナップ・クローン単一インスタンス・データベース用のサービス・テンプレートのjsonファイル

- スキーマ・ベース・サービス・テンプレートの.jsonファイル

- プラガブル・データベース用のサービス・テンプレートの.jsonファイル

- 空のプラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの.jsonファイル

- プロファイル・プラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの.jsonファイル

- CloneDBベース・サービス・テンプレートの.jsonファイル

- RMAN複製サービス・テンプレートを使用したフル・クローンの.jsonファイル

- EMCストレージでライブ・クローン・テンプレートを使用したスナップクローン・データベース用のサービス・テンプレートの.jsonファイル

47.8.1 DBCAベース・サービス・テンプレートの.jsonファイル

{
"name": "Create ST for SI Db using DBCA Template - ASM Subh_2",
"description": "Creates Single Instance DB",
"roles": [ "SSA_USER_ROLE" ],
"serviceType": "DB",
"serviceTemplateTypeId": "61",
"rscProvAssocOption": [ "byRscProvInst" ],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [ "137F74D7A8359A60762ED550341A5F47" ],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [ { "name": "PROFILE_COMPONENT_URN", "value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:269BA6C90E6A5000E053C075B10A51A3:0.1" } ],
"configurations": [
{ "name": "REF_ZONE", "value": "Salt Lake City Zone" },
{ "name": "REF_POOL", "value": "SI Databases Pool_Oracle_DB_11g" },
{ "name": "REF_HOST", "value": "xyz.example.com" },
{ "name": "REF_TGT", "value": "xyz.example.com" },
{ "name": "DBCA_TEMPLATE:DB_STORAGE_TYPE", "value": "ASM" },
{ "name": "DBCA_TEMPLATE:REC_STORAGE_TYPE_SAME_AS_DB_FILES", "value": "Y" },
{ "name": "DBCA_TEMPLATE:FLASH_RECOVERY_AREA_SIZE", "value": "4038" },
{ "name": "DBCA_TEMPLATE:DATA_FILE_LOCATION", "value": "DATA" },
{ "name": "DBCA_TEMPLATE:REDO_FILE_LOCATION", "value": "RECO" },
{ "name": "DBCA_TEMPLATE:ARCHIVE_LOG_MODE", "value": "Y" },
{ "name": "DBCA_TEMPLATE:RECOVERY_FILE_LOCATION", "value": "RECO" },
{ "name": "DATABASE_TYPE", "value": "oracle_database" },
{ "name": "COMMON_DOMAIN_NAME", "value": "us.example.com" },
{ "name": "ORACLE.SYSMAN.SSA.PROVISIONING_TYPE", "values": [ "DBCA_TEMPLATE" ] },
{ "name": "ENTITY_TYPE", "value": "USE_PROFILE" },
{ "name": "PROFILE_COMPONENT_URN", "value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:269BA6C90E6A5000E053C075B10A51A3:0.1" },
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY"
},
{ "name": "SID_OPTION", "value": "ssauser" },
{ "name": "SELECT_ORACLE_HOME_OPTION", "value": "SELECT_ORACLE_HOME_AT_RUNTIME"},
{ "name": "COMMON_DB_SYS_PASSWORD", "value": "welcome"},
{ "name": "DB_ADMIN_PASSWORD_SAME", "value": "true" },
{ "name": "INIT_PARAMS", "values": [
"sga_target=1073741824",
"pga_aggregate_target=1073741824"
]
},
{ "name": "LISTENER_PORT", "value": "1521" },
{ "name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:xxxx:false:true",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:Testing:false:true",
"Line of Business:null:false:false"
]
}
]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.2 スタンバイDBCAベース・サービス・テンプレートの.jsonファイル

{
"name":"TestDbTemplate1",
"serviceType":"DB",
"serviceFamily":"DBAAS",
"description":"This is a test database dbca service template 1",
"poolIds":[ "D125A1536E9ADC36CC24EAB058B9E7AC" ],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{ "name":"PROFILE_COMPONENT_URN", "value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:F1EA40D2AE964994E0436051F20AFE32:0.1" },
{ "name":"DATABASE_TYPE","value":"rac_database" },
{ "name":"COMMON_DB_SYSTEM_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_DBSNMP_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_SYS_PASSWORD","value":"welcome" },
{ "name":"DB_ADMIN_PASSWORD_SAME", "value":"true" },
{ "name":"INSTANCE_COUNT","value":"2" },
{ "name":"SID_OPTION", "value":"ssauser  "},
{ "name":"COMMON_DB_SID","value":"mydb1" },
{ "name":"COMMON_DOMAIN_NAME",  "value":"us.example.com" },
{ "name":"LISTENER_PORT", "value":"1521"},
{ "name":"STAGE_LOCATION", "value":"/scratch" },
{ "name":"REF_ZONE", "value":"SLC00ECPQ_ZONE" },
{ "name":"REF_POOL",   "value":"PRIMARY_RAC_POOL" },
{ "name":"REF_HOST", "value":"xyxy.example.com" },
{ "name":"REF_TGT","value":"xxy.example.com" },
{ "name":"ROLE_NAME","value":"ROLE_Oct_31_2014_17_59_PM" },
{ "name":"ROLE_DESC","value":"New database role to be assigned to master account." },
{ "name":"USER_PRIVILEGES","value":"CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY" },
{ "name":"DEFAULT_DATABASE_SIZE","value":"small" },
{ "name":"DATABASE_SIZES","value":"","values":["small","medium"]},
{ "name":"TARGET_PROP_LIST","value":"",
"values":[
"Department:value:false:false",
"Location:null:false:false",
"Comment:null:false:false",
"LifeCycle Status:null:false:false",
"Line of Business:null:false:false",
"Contact:null:false:false"]
},
{ "name":"CUSTOM_TARGET_PROP_LIST","value":"",
"values":[
"Department:value:false:false
]
},
{ "name":"DBCA_TEMPLATE:DB_STORAGE_TYPE",  "value":"ASM" },
{ "name":"DBCA_TEMPLATE:DATA_FILE_LOCATION","value":"DATA" },
{ "name":"DBCA_TEMPLATE:REC_STORAGE_TYPE_SAME_AS_DB_FILES", "value":"Y" },
{ "name":"DBCA_TEMPLATE:ARCHIVE_LOG_MODE", "value":"Y" },
{ "name":"DBCA_TEMPLATE:FLASH_RECOVERY_AREA_SIZE", "value":"2048" },
{ "name":"DBCA_TEMPLATE:RECOVERY_FILE_LOCATION","value":"RECO" },
{ "name":"DBCA_TEMPLATE:REDO_FILE_LOCATION", "value":"RECO"  },
{
"name":"INIT_PARAMS",
"subconfigurations":[
{ "name":"INIT_PARAMS:1", "value":"sga_target=1073741824" },
{ "name":"INIT_PARAMS:2", "value":"pga_aggregate_target=1073741824"  }
]
},
{ "name":"STANDBY_REQUIRED","value":"true" },
{ "name":"STANDBY_REQUIRED_LOCK","value":"false" },
{ "name":"STANDBY_WORK_DIR","value":"/tmp" },
{ "name":"PRIMARY_PROTECTION_MODE","value":"MAXIMIZE AVAILABILITY" },
{ "name":"DBAAS_SSA_STANDBY_CUSTOM_PRE_SCRIPTS_URN","value":"" },
{ "name":"DBAAS_SSA_STANDBY_CUSTOM_POST_SCRIPTS_URN","value":"" },
{ "name":"STANDBY_DB_DETAILS","value":"","values":[
"pool=RAC_11204_Tier_2;databaseSIDPrefix=;databaseType=rac_database;standbyConfigName=Near DR;redoMode=SYNC;realtimeQuery=true;databaseRACInstanceCount=2;databaseDelay=30;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com",
"pool=SI_11204;databaseSIDPrefix=;databaseType=oracle_database;standbyConfigName=Far DR;redoMode=ASYNC;realtimeQuery=false;databaseRACInstanceCount=2;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"]}

]
}
}

47.8.3 RMANベースの単一インスタンス・データベース用のサービス・テンプレートの.jsonファイル

{
"name": "Database Service - RMAN Based with archiving with SI Standby",
"description": "This creates Database Archiving log mode.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"1898CF93BD39C19BF032672271BC4B44"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
}
],
"configurations": [
{
"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_FROM_REQUEST"
},
{
"name": "REF_TGT",
"value": "xyz.example.com"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_ZONE",
"value": "Salt Lake City Zone"
},
{
"name": "zoneTargetName",
"value": "Salt Lake City Zone"
},
{
"name": "REF_POOL",
"value": "Databases Pool"
},
{
"name": "DATABASE_TYPE",
"value": "oracle_database"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "COMMON_DB_SID",
"value": "db"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
},
{
"name": "RMAN.DB_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_SIZE",
"value": "4038"
},
{
"name": "RMAN.USE_ARCHIVING",
"value": "YES"
},
{
"name": "RMAN.DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"
},
{
"name": "RMAN.REDO_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.RECOVERY_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.WORK_DIR_LOC",
"value": "/tmp/work"
},
{
"name": "RMAN.DB_ADMIN_PASSWORD_SAME",
"value": "Y"
},
{
"name": "RMAN.DATABASE_PASSWORDS",
"value": "welcome"
},
{
"name": "RMAN.BACKUP_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "RMAN.USE_OFA",
"value": "N"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "STANDBY_DB_DETAILS",
"values": [
"pool=Near DR Pool;databaseSIDPrefix=;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.4 単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの.jsonファイル

{
"name": "Database Service - RMAN Based with archiving with SI Standby",
"description": "This creates Database Archiving log mode.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"1898CF93BD39C19BF032672271BC4B44"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
}
],
"configurations": [
{
"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_FROM_REQUEST"
},
{
"name": "REF_TGT",
"value": "xyz.example.com"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_ZONE",
"value": "Salt Lake City Zone"
},
{
"name": "zoneTargetName",
"value": "Salt Lake City Zone"
},
{
"name": "REF_POOL",
"value": "Databases Pool"
},
{
"name": "DATABASE_TYPE",
"value": "oracle_database"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "COMMON_DB_SID",
"value": "db"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
},
{
"name": "RMAN.DB_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_SIZE",
"value": "4038"
},
{
"name": "RMAN.USE_ARCHIVING",
"value": "YES"
},
{
"name": "RMAN.DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"
},
{
"name": "RMAN.REDO_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.RECOVERY_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.WORK_DIR_LOC",
"value": "/tmp/work"
},
{
"name": "RMAN.DB_ADMIN_PASSWORD_SAME",
"value": "Y"
},
{
"name": "RMAN.DATABASE_PASSWORDS",
"value": "welcome"
},
{
"name": "RMAN.BACKUP_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "RMAN.USE_OFA",
"value": "N"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "STANDBY_DB_DETAILS",
"values": [
"pool=Near DR Pool;databaseSIDPrefix=;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.5 RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの.jsonファイル

{
"name": "Create Databases on RAC One database",
"description": "Creates Databases on RAC.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"647E8750A1C3835557165B499B269FB3"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"
}
],
"configurations": [
{"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"},
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"},
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name": "REF_TGT",
"value": "abc.example.com"},
{"name": "REF_HOST",
"value": "adc.example.com"},
{"name": "REF_ZONE",
"value": "Salt Lake City Zone"},
{"name": "zoneTargetName",
"value": "Salt Lake City Zone"},
{"name": "REF_POOL",
"value": "RAC Databases Pool"},
{"name": "DATABASE_TYPE",
"value": "rac_database"},
{"name": "IS_RAC_ONE",
"value": "Y"},
{"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"},
{"name": "LISTENER_PORT",
"value": "1521"},
{"name": "PROFILE_VERSION",
"value": "latest"},
{"name": "COMMON_DB_SID",
"value": "db"},
{"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name": "RMAN:DB_STORAGE_TYPE",
"value": "FS"},
{"name": "RMAN:FRA_SIZE",
"value": "4038"},
{"name": "RMAN:USE_ARCHIVING",
"value": "NO"},
{"name": "RMAN:DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"},
{"name": "RMAN:WORK_DIR_LOC",
"value": "/tmp/work"},
{"name": "RMAN:DB_ADMIN_PASSWORD_SAME",
"value": "Y"},
{"name": "RMAN:DATABASE_PASSWORDS",
"value": "welcome"},
{"name": "RMAN:BACKUP_LOCATION",
"value": "/oradbnas/backups/rman/"},
{"name": "RMAN:USE_OFA",
"value": "N"},
{"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"}
]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.6 スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの.jsonファイル

{
"name": "RAC One Database Provisioning with RAC One Standby and SI Standby",
"description": "Creates RAC One Databases with RAC One Standby and SI Standby.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"647E8750A1C3835557165B499B269FB3"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"}
],
"configurations": [
{"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"},
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"},
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name": "REF_TGT",
"value": "adc.example.com"},
{"name": "REF_HOST",
"value": "adc.example.com"},
{"name": "REF_ZONE",
"value": "Salt Lake City Zone"},
{"name": "zoneTargetName",
"value": "Salt Lake City Zone"},
{"name": "REF_POOL",
"value": "RAC Databases Pool"},
{"name": "DATABASE_TYPE",
"value": "rac_database"},
{"name": "IS_RAC_ONE",
"value": "Y"},
{"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"},
{"name": "LISTENER_PORT",
"value": "1521"},
{"name": "PROFILE_VERSION",
"value": "latest"},
{"name": "COMMON_DB_SID",
"value": "db"},
{"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name": "RMAN:DB_STORAGE_TYPE",
"value": "FS"},
{"name": "RMAN:FRA_SIZE",
"value": "4038"},
{"name": "RMAN:USE_ARCHIVING",
"value": "NO"},
{"name": "RMAN:DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"},
{"name": "RMAN:WORK_DIR_LOC",
"value": "/tmp/work"},
{"name": "RMAN:DB_ADMIN_PASSWORD_SAME",
"value": "Y"},
{"name": "RMAN:DATABASE_PASSWORDS",
"value": "welcome"},
{"name": "RMAN:BACKUP_LOCATION",
"value": "/oradbnas/backups/rman/"},,
{"name": "RMAN:USE_OFA",
"value": "N"},
{"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"},
{"name": "STANDBY_REQUIRED",
"value": "true"},
{"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.7 単一インスタンス・スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの.jsonファイル

{
"name" : "Create Databases on RAC with SI  Standby",
"description" : "Creates Databases on RAC.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "647E8750A1C3835557165B499B269FB3" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"},
{"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"}
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name" : "REF_TGT",
"value" : "adc.us.example.com"},
{"name" : "REF_HOST",
"value" : "adc.us.example.com"},
{"name" : "REF_ZONE",
"value" : "Salt Lake City Zone"},
{"name" : "zoneTargetName",
"value" : "Salt Lake City Zone"},
{"name" : "REF_POOL",
"value" : "RAC Databases Pool"},
{"name" : "DATABASE_TYPE",
"value" : "oracle_database"},
{"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"},
{"name" : "LISTENER_PORT",
"value" : "1521"},
{"name" : "PROFILE_VERSION",
"value" : "latest"},
{"name" : "COMMON_DB_SID",
"value" : "db"},
{"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]},
{"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name" : "RMAN:DB_STORAGE_TYPE",
"value" : "FS"},
{"name" : "RMAN:FRA_SIZE",
"value" : "4038"},
{"name" : "RMAN:USE_ARCHIVING",
"value" : "NO"},
{"name" : "RMAN:DATA_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/oradata"},
{"name" : "RMAN:WORK_DIR_LOC",
"value" : "/tmp/work"},
{"name" : "RMAN:DB_ADMIN_PASSWORD_SAME",
"value" : "Y"},
{"name" : "RMAN:DATABASE_PASSWORDS",
"value" : "welcome"},
{"name" : "RMAN:BACKUP_LOCATION",
"value" : "/oradbnas/backups/rman/"},
{"name" : "RMAN:USE_OFA",
"value" : "N"},
{"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"},
{"name":"CUSTOM_PRE_CREATE_SCRIPTS_URN",
"value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},,
{"name":"CUSTOM_POST_CREATE_SCRIPTS_URN",
"value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},,
{"name": "STANDBY_REQUIRED",
"value": "true"},
{"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.8 DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの.jsonファイル

{
"name": "Create RAC Db with Standby using DBCA Template - BofA -ASM",
"description": "Service Template for Non-CDB; 12cR1_2(12.1.0.2); RAC; ASM",
"serviceType": "DB",
"serviceTemplateTypeId": "61",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSAUSERROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"4C5795E605D71F59BAF9F6AD702E25E1"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246E84D11ED13BD0E050F90AE5852BC8:0.1"
}
],
"configurations": [
{
"name": "REF_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_POOL",
"value": "RAC Databases Pool_Oracle_DB_12c"
},
{
"name": "DBCA_TEMPLATE:DB_STORAGE_TYPE",
"value": "ASM"
},
{
"name": "DBCA_TEMPLATE:REC_STORAGE_TYPE_SAME_AS_DB_FILES",
"value": "Y"
},
{
"name": "DBCA_TEMPLATE:ARCHIVE_LOG_MODE",
"value": "N"
},
{
"name": "DBCA_TEMPLATE:FLASH_RECOVERY_AREA_SIZE",
"value": "4038"
},
{
"name": "DBCA_TEMPLATE:DATA_FILE_LOCATION",
"value": "DATA"
},
{
"name": "DBCA_TEMPLATE:REDO_FILE_LOCATION",
"value": "DATA1"
},
{
"name": "DBCA_TEMPLATE:RECOVERY_FILE_LOCATION",
"value": "DATA1"
},
{
"name": "DATABASE_TYPE",
"value": "rac_database"
},
{
"name": "INSTANCE_COUNT",
"value": "2"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "ORACLE.SYSMAN.SSA.PROVISIONING_TYPE",
"values": [
"DBCA_TEMPLATE"
]
},
{
"name": "ENTITY_TYPE",
"value": "USE_PROFILE"
},
{
"name": "REF_TGT",
"value": "xyz.example.com"
},
{
"name": "SID_OPTION",
"value": "prefix"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246E84D11ED13BD0E050F90AE5852BC8:0.1"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY"
},
{
"name": "COMMON_DB_SID",
"value": "RFTDB"
},
{
"name": "INIT_PARAMS",
"subconfigurations": [
"sga_target=1073741824",
"pga_aggregate_target=1073741824"
]
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_AT_RUNTIME"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome1"
},
{
"name": "DB_ADMIN_PASSWORD_SAME",
"value": "true"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "STANDBY_REQUIRED",
"value": "true"
},
{
"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
},
{
"name": "DATABASE_SIZES",
"values": [
"Big",
"Small"
]
},
{
"name": "DEFAULT_DATABASE_SIZE",
"value": "Big"
}
]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.9 DNFSベースのデータベース用のサービス・テンプレートの.jsonファイル

{
"name" : "DB Clones",
"description" : "This clones a database based on NFS.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "1898CF93BD39C19BF032672271BC4B44" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"}
{"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"}
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name" : "REF_TGT",
"value" : "abc.example.com"}
{"name" : "REF_HOST",
"value" : "abc.example.com"}
{"name" : "REF_ZONE",
"value" : "Salt Lake City Zone"}
{"name" : "zoneTargetName",
"value" : "Salt Lake City Zone"}
{"name" : "REF_POOL",
"value" : "Databases Pool"}
{"name" : "DATABASE_TYPE",
"value" : "oracle_database"}
{"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"}
{"name" : "LISTENER_PORT",
"value" : "1521"}
{"name" : "PROFILE_VERSION",
"value" : "latest"}
{"name" : "COMMON_DB_SID",
"value" : "db"}
{"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]}
{"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"}
{"name" : "DNFS.DATA_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/oradata"}
{"name" : "DNFS.REDO_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/fast_recovery_area"}
{"name" : "DNFS.RECOVERY_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/fast_recovery_area"}
{"name" : "DNFS.FRA_SIZE",
"value" : "4038"}
{"name" : "DNFS.USE_ARCHIVING",
"value" : "YES"}
{"name" : "DNFS.WORK_DIR_LOC",
"value" : "/tmp/work"}
{"name" : "DNFS.DB_ADMIN_PASSWORD_SAME",
"value" : "Y"}
{"name" : "DNFS.BACKUP_LOCATION",
"value" : "/scratch/emga/backups/rman_image/"}
{"name" : "DNFS.USE_OFA",
"value" : "N"}
{"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"} ]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.10 アーカイブが有効なスナップ・クローン単一インスタンス・データベース用のサービス・テンプレートのjsonファイル

{
"name" : "Create Snap Database using Snapshots",
"description" : "Creates Databases on SI hosts.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "503073C7912B1C65B66E240C433012A9" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:247BF4B378FF253FE053C075B10A794A:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"
}, {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:247BF4B378FF253FE053C075B10A794A:0.1"
}, {
"name" : "REF_TGT",
"value" : "xyz.example.com"
}, {
"name" : "REF_HOST",
"value" : "xyz.example.com"
}, {
"name" : "REF_ZONE",
"value" : "Single Instances Zone"
}, {
"name" : "zoneTargetName",
"value" : "Single Instances Zone"
}, {
"name" : "REF_POOL",
"value" : "SI Databases Pool - Version 11_2_0_4"
}, {
"name" : "DATABASE_TYPE",
"value" : "oracle_database"
}, {
"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"
}, {
"name" : "LISTENER_PORT",
"value" : "1521"
}, {
"name" : "PROFILE_VERSION",
"value" : "latest"
}, {
"name" : "COMMON_DB_SID",
"value" : "db"
}, {
"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]
}, {
"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
}, {
"name" : "THIN_PROVISIONING:LISTENER_PORT",
"value" : "1522"
}, {
"name" : "THIN_PROVISIONING:REDO_LOG_GROUP_COUNT",
"value" : "2"
}, {
"name" : "THIN_PROVISIONING:TEMP_TABLESPACE_SIZE",
"value" : "520"
}, {
"name" : "THIN_PROVISIONING:USE_ARCHIVING",
"value" : "YES"
}, {
"name" : "THIN_PROVISIONING:MOUNT_POINT_LIST",
"values" : [ "/hkdb" ]
}, {
"name" : "THIN_PROVISIONING:MOUNT_ADDL_SIZE_LIST",
"values" : [ "5.0" ]
}, {
"name" : "THIN_PROVISIONING:REDO_LOG_FILE_TYPE",
"value" : "Same as source"
}, {
"name" : "INIT_PARAMS",
"values" : [ "sga_target=1073741824", "pga_aggregate_target=1073741824" ]
}, {
"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"
} ]
}

注意:
前述のJSON bodyで:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.11 スキーマ・ベース・サービス・テンプレートの.jsonファイル

{
"name":"TestSchaasTemplate3",
"serviceType":"SCHEMA",
"serviceFamily":"DBAAS",
"description":"This is a test schaas service template 1",
"poolIds":[ "9D3187DE6B1115791D71D2827FB98558" ],
"roles":[
{ "name":"SSA_USER_ROLE1" }
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{ "name":"ROLE_NAME", "value":"SampleRole" },
{ "name":"MAX_NUMBER_OF_SCHEMAS","value":"2" },
{ "name":"ENFORCE_STORAGE_CONSTRAINT","value":"NO_LIMIT" },
{ "name":"AUTO_EXTEND_BLOCK_SIZE","value":"1024" },
{ "name":"REF_ZONE","value":"ABC_ZONE" },
{ "name":"REF_POOL","value":"SCH_POOL" },
{ "name":"REF_HOST","value":"abc.mycompany.com" },
{ "name":"REF_DB","value":"simple.us.example.com" },
{ "name":"CREATE_SCHEMA_OPTION","value":"EMPTY_SCHEMAS" },
{ "name":"SCHAAS_CUSTOM_PRE_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{ "name":"SCHAAS_CUSTOM_POST_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{
"name":"REMAP_TABLESPACE_LIST",
"value":"",
"values":["TBSP1","TBSP2","TBSP3"]
},
{
"name":"REMAP_TABLESPACE_INIT_SIZE_LIST",
"value":"",
"values":["TBSP1:0.1","TBSP2:0.2","TBSP3:0.3"]
},
{
"name":"REMAP_TABLESPACE_INCR_SIZE_LIST",
"value":"",
"values":["TBSP1:0.1","TBSP2:0.2","TBSP3:0.3"]
},
{
"name":"REMAP_TABLESPACE_MAX_SIZE_LIST",
"value":"",
"values":["TBSP1:50.0","TBSP2:30","TBSP3:20"]
},

{ "name":"CREATE_SCHEMA_OPTION","value":"EMPTY_SCHEMAS" },
{
"name":"WORKLOADS",
"subconfigurations":[
{
"name":"WORK_LOADS:1",
"subconfigurations":[
{ "name":"name",  "value":"large "  },
{ "name":"description", "value":"large workload" },
{   "name":"default",    "value":"Y" },
{   "name":"CPU",  "value":"6" },
{   "name":"Memory", "value":"4048"    },
{   "name":"Storage", "value":"2024"   }
]
}
]
}
]
}
}

47.8.12 プラガブル・データベース用のサービス・テンプレートの.jsonファイル

{
"name":"TestPDbTemplate1",
"serviceType":"PDB",
"serviceFamily":"DBAAS",
"description":"This is a test pluggable database service template 1",
"poolIds":[ "FF394120842D8C71CC92BE6A4D5A488E" ],
"roles":[
{ "name":"SSA_USER_ROLE1" }
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{
"name":"TABLESPACE_ENCRYPTION_ALGORITHM",
"subconfigurations":[
{  "name":"name", "value":"NONE" }
]
},
{  "name":"MAX_TABLESPACE_ALLOWED", "value":"2" },
{  "name":"PDB_SID_PREFIX", "value":"mypdb" },
{  "name":"ENFORCE_STORAGE_CONSTRAINT", "value":"NO_LIMIT" },
{  "name":"AUTO_EXTEND_BLOCK_SIZE","value":"1024" },
{  "name":"REF_DATA_ZONE", "value":"PDB_Zone" },
{  "name":"REF_DATA_TARGET", "value":"database" },
{  "name":"REF_DATA_TARGET_TYPE", "value":"oracle_database" },
{  "name":"REF_DATA_POOL","value":"PDB_POOL" },
{  "name":"REF_DATA_HOST", "value":"abc.mycompany.com" },
{  "name":"SELECT_TARGET_OPTION", "value":"SELECT_TARGET_FROM_REQUEST" },
{  "name":"CREATE_PDB_OPTION", "value":"EMPTY_PDB" },
{"name":"PDBAAS_CUSTOM_PRE_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{"name":"PDBAAS_CUSTOM_POST_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{  "name":"PRIVILEGES",
"value":"",
"values":["CREATE TYPE","CREATE VIEW","CREATE DIMENSION","CREATE SESSION","CREATE TRIGGER","CREATE OPERATOR","CREATE SYNONYM","CREATE TABLE","CREATE PROCEDURE","CREATE INDEXTYPE","CREATE SEQUENCE"]
},
{  "name":"ROLE_OPTION","value":"CUSTOM_NEW_ROLE" },
{
"name":"INIT_PARAMS",
"subconfigurations":[
{ "name":"INIT_PARAMS:1", "value":"*.cursor_sharing=EXACT" },
{ "name":"INIT_PARAMS:2", "value":"*.open_cursors=200"  }
]
},
{
"name":"WORKLOADS",
"subconfigurations":[
{
"name":"WORK_LOADS:1",
"subconfigurations":[
{ "name":"name", "value":"SmallPdb" },
{ "name":"description", "value":"small workload" },
{  "name":"default", "value":"N" },
{  "name":"CPU", "value":"2" },
{  "name":"Memory", "value":"2048" },
{  "name":"Storage", "value":"1024" },
{  "name":"Sessions", "value":"100" }
]
}
]
}
]
}
}

注意:
前述のJSON bodyで:

- PDBAAS_CUSTOM_PRE_SCRIPTS_URNおよびPDBAAS_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_DATA_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "poolIds"として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_DATA_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_DATA_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_DATA_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_DATA_TARGETは、プール・ターゲットからの参照ターゲットを示します。

- 前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PBDに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.13 空のプラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの.jsonファイル

{
"name": "Create RAC PDBs using empty PDB option",
"description": "Creates PDBs on cluster.",
"serviceType": "PDB",
"serviceTemplateTypeId": "94",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSA_USER_ROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.PDBAAS_POOL",
"values": [
"DFB8F2A53429AF99EF2020C56E11FEE9"
],
"targetType": {
"targetType": "pdbaas_pool",
"targetTypeName": "Pluggable Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "DBDELETE_PRESCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D511C1CFFE053C075B10AEF2D:0.1"
},
{
"name": "DBDELETE_POSTSCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D51201CFFE053C075B10AEF2D:0.1"
}
],
"characteristics": [
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"value": "Development",
"required": true,
"editable": false,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": "Bangalore",
"required": false,
"editable": true,
"visible": true
}
],
"configurations": [
{
"name": "REF_DATA_ZONE",
"value": "Single Instances Zone"
},
{
{
"name":SELECT_TARGET_OPTION"
"value":SELECT_TARGET_FROM_REQUEST"
},
"name": "CUSTOM_ROLE_NAME",
"value": "PDBAAS_NOV_13_2015_16_51_PM"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:null:false:false",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:Development:true:true",
"Comment:This is for testing:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "PDBAAS_CUSTOM_PRE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7B4E34E053C075B10A74AD:0.2"
},
{
"name": "WORKLOADS",
"subvalues": [
{
"name": "Small",
"subvalues": [
{
"name": "name",
"value": "SmallPdb"
},
{
"name": "description",
"value": "small workload"
},
{
"name": "default",
"value": "N"
},
{
"name": "CPU",
"value": "2"
},
{
"name": "Memory",
"value": "2"
},
{
"name": "Storage",
"value": "5"
},
{
"name": "Sessions",
"value": "100"
}
]
}
]
},
{
"name": "PRIVILEGES",
"type": "VECTOR",
"description": "List of privileges of custom new role that will be applied on pluggable database administrator.",
"displayName": "PRIVILEGES",
"required": false,
"secret": false,
"values": [
"CREATE SESSION",
"ALTER SESSION",
"CREATE DIMENSION",
"CREATE INDEXTYPE",
"CREATE ANY OPERATOR",
"CREATE ANY PROCEDURE",
"CREATE ANY SEQUENCE",
"CREATE ANY INDEX",
"CREATE JOB",
"CREATE ANY MATERIALIZED VIEW",
"CREATE ANY TABLE",
"CREATE ANY TRIGGER",
"CREATE ANY TYPE",
"CREATE ANY VIEW",
"CREATE ANY SYNONYM",
"CREATE ANY DIRECTORY",
"SELECT ANY DICTIONARY",
"SELECT ANY TABLE"
]
},
{
"name": "REF_DATA_TARGET_TYPE",
"value": "rac_database"
},
{
"name": "REF_DATA_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_DATA_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_DATA_TARGET",
"value": "cdbfs"
},
{
"name": "REF_DATA_POOL",
"value": "RAC Pluggable DBs"
},
{
"name": "PDBAAS_CUSTOM_POST_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7F4E34E053C075B10A74AD:0.2"
},
{
"name": "SELECT_TARGET_OPTION",
"value": "SELECT_TARGET_AT_RUNTIME"
},
{
"name": "MAX_TABLESPACE_ALLOWED",
"value": "1"
},

{
"name": "ROLE_OPTION",
"value": "CUSTOM_NEW_ROLE"
},
{
"name": "CREATE_PDB_OPTION",
"value": "EMPTY_PDB"
},{
"name": "INIT_PARAMS",
"values": [
"*.cursor_sharing=EXACT",
"*.open_cursors=300"
]
}

]
}

注意:
前述のJSON bodyで:

- PDBAAS_CUSTOM_PRE_SCRIPTS_URNおよびPDBAAS_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_DATA_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "poolIds"として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_DATA_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_DATA_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_DATA_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_DATA_TARGETは、プール・ターゲットからの参照ターゲットを示します。

- 前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PBDに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.14 プロファイル・プラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの.jsonファイル

{
"name": "Create RAC PDBs using Profile PDB option",
"description": "Creates PDBs on cluster.",
"serviceType": "PDB",
"serviceTemplateTypeId": "94",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSA_USER_ROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.PDBAAS_POOL",
"values": [
"DFB8F2A53429AF99EF2020C56E11FEE9"
],
"targetType": {
"targetType": "pdbaas_pool",
"targetTypeName": "Pluggable Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "DBDELETE_PRESCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D511C1CFFE053C075B10AEF2D:0.1"
},
{
"name": "DBDELETE_POSTSCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D51201CFFE053C075B10AEF2D:0.1"
}
],
"characteristics": [
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"displayName": "Contact",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"displayName": "Cost Center",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DOWNTIME_CONTACT",
"displayName": "Downtime Contact",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"displayName": "Lifecycle Status",
"values": [
"Development",
"MissionCritical",
"Production",
"Stage",
"Test"
],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"displayName": "Line of Business",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": [],
"required": false,
"editable": true,
"visible": true
}
],
"configurations": [
{
"name": "REF_DATA_ZONE",
"value": "Single Instances Zone"
},
{
"name":SELECT_TARGET_OPTION"
"value":SELECT_TARGET_FROM_REQUEST"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:null:false:false",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:Development:true:true",
"Comment:This is for testing:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "PDBAAS_CUSTOM_PRE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7B4E34E053C075B10A74AD:0.2"
},
{
"name": "WORKLOADS",
"subvalues": [
{
"name": "Small",
"subvalues": [
{
"name": "name",
"value": "SmallPdb"
},
{
"name": "description",
"value": "small workload"
},
{
"name": "default",
"value": "N"
},
{
"name": "CPU",
"value": "2"
},
{
"name": "Memory",
"value": "2"
},
{
"name": "Storage",
"value": "5"
},
{
"name": "Sessions",
"value": "100"
}
]
}
]
},
{
"name": "ROLE_OPTION",
"value": "CUSTOM_NEW_ROLE"
},
{
"name": "CUSTOM_ROLE_NAME",
"value": "PDBAAS_NOV_13_2015_16_51_PM"
},
{
"name": "CUSTOM_ROLE_DESC",
"value": "New db role to be assigned to pluggable database administrator."
},
{
"name": "PRIVILEGES",
"values": [
"CREATE SESSION",
"ALTER SESSION",
"CREATE DIMENSION",
"CREATE INDEXTYPE",
"CREATE ANY OPERATOR",
"CREATE ANY PROCEDURE",
"CREATE ANY SEQUENCE",
"CREATE ANY INDEX",
"CREATE JOB",
"CREATE ANY MATERIALIZED VIEW",
"CREATE ANY TABLE",
"CREATE ANY TRIGGER",
"CREATE ANY TYPE",
"CREATE ANY VIEW",
"CREATE ANY SYNONYM",
"CREATE ANY DIRECTORY",
"SELECT ANY DICTIONARY",
"SELECT ANY TABLE"
]
},
{
"name": "REF_DATA_TARGET_TYPE",
"value": "rac_database"
},
{
"name": "REF_DATA_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_DATA_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_DATA_TARGET",
"value": "cdbfs"
},
{
"name": "REF_DATA_POOL",
"value": "RAC Pluggable DBs"
},
{
"name": "PDBAAS_CUSTOM_POST_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7F4E34E053C075B10A74AD:0.2"
},
{
"name": "SELECT_TARGET_OPTION",
"value": "SELECT_TARGET_AT_RUNTIME"
},
{
"name": "MAX_TABLESPACE_ALLOWED",
"value": "1"
},
{
"name": "CREATE_PDB_OPTION",
"value": "PDB_FROM_PROFILE"
},
{
"name": "PROFILE_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246C1E85296C29A1E053C075B10A7DFA:0.1"
},
{
"name": "SHARED_STAGE_LOCATION",
"value": "/u04/app/hhkaur/product/12.1.0/dbhome_2/rdbms/xml/schema"
},
{
"name": "TABLESPACE_SIZE",
"values": [
"0.7715",
"0.6152",
"0.0586",
"0.0049"
]
},
{
"name": "INIT_PARAMS",
"values": [
"*.cursor_sharing=EXACT",
"*.open_cursors=300"
]
},
{
"name": "PDB_SID_PREFIX",
"value": "prp"
}
]
}

注意:
前述のJSON bodyで:

- PDBAAS_CUSTOM_PRE_SCRIPTS_URNおよびPDBAAS_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_DATA_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "poolIds"として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。serviceType:DBの下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

- REF_DATA_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_DATA_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_DATA_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_DATA_TARGETは、プール・ターゲットからの参照ターゲットを示します。

- 前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PBDに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

47.8.15 CloneDBベース・サービス・テンプレートの.jsonファイル

{
"type":"CDP",
"configurations":[
{ "name":"PROFILE_COMPONENT_URN", "value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:E9F67B964802DD32E040F20A60514EB5:0.1" },
{ "name":"DATABASE_TYPE","value":"oracle_database" },
{ "name":"COMMON_DB_SYSTEM_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_DBSNMP_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_SYS_PASSWORD","value":"welcome" },
{ "name":"COMMON_DB_SID","value":"norm" },
{ "name":"COMMON_DOMAIN_NAME","value":"us.example.com" },
{ "name":"LISTENER_PORT", "value":"1521"},
{ "name":"STAGE_LOCATION", "value":"/tmp/rman_backup/backup1383140909156"},
{ "name":"REF_ZONE", "value":"SLC01HZK_ZONE" },
{ "name":"SID_OPTION", "value":"ssauser  "},
{ "name":"COMMON_DB_SID","value":"mydb1" },
{ "name":"REF_POOL",   "value":"PRIMARY_DB2" },
{ "name":"REF_HOST", "value":"xyxy.example.com" },
{ "name":"REF_TGT","value":"xxxy.example.com" },
{ "name":"ROLE_NAME","value":"ROLE_Oct_31_2014_17_59_PM" },
{ "name":"ROLE_DESC","value":"New database role to be assigned to master account." },
{ "name":"USER_PRIVILEGES","value":"CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY" },
{ "name":"DEFAULT_DATABASE_SIZE","value":"small" },
{ "name":"DATABASE_SIZES","value":"","values":["small","medium"]},
{ "name":"ENTITY_TYPE","value":"USE_PROFILE"},
{ "name":"PROFILE_VERSION","value":"latest"},
{ "name":"TARGET_PROP_LIST","value":"",
"values":[
"Department:value:false:false",
"Location:null:false:false",
"Comment:null:false:false",
"LifeCycle Status:null:false:false",
"Line of Business:null:false:false",
"Contact:null:false:false"]
},
{ "name":"CUSTOM_TARGET_PROP_LIST","value":"",
"values":[
"Department:value:false:false
]
},
{ "name":"RMAN:DB_STORAGE_TYPE",  "value":"FS" },
{ "name":"RMAN:FRA_STORAGE_TYPE",  "value":"FS" },
{ "name":"RMAN:DATA_FILE_LOCATION","value":"/scratch/app/oracle/oradata" },
{ "name":"RMAN:RECOVERY_FILE_LOCATION","value":"/scratch/app/oracle/fra" },
{ "name":"RMAN:REDO_FILE_LOCATION", "value":"/scratch/app/oracle/fra"  },
{ "name":"RMAN:FRA_SIZE", "value":"5000" },
{ "name":"RMAN:REC_STORAGE_TYPE_SAME_AS_DB_FILES", "value":"Y" },
{ "name":"RMAN:ARCHIVE_LOG_MODE",  "value":"Y" },
{ "name":"RMAN:FLASH_RECOVERY_AREA_SIZE",  "value":"5000" },
{ "name":"CLONE_OR_FULL_DB", "value":"CLONE_DB" },
{ "name":"USER_INITIATED_BACKUP_LOCATION", "value":"/tmp" },
{ "name":"ALLOW_BACKUPS", "value":"true" },
{ "name":"MAX_BACKUPS_ALLOWED", "value":"7" },
{ "name":"STAGE_LOCATION", "value":"/tmp" },
{ "name":"RMAN:USE_ARCHIVING", "value":"Y" },
{
"name":"INIT_PARAMS",
"subconfigurations":[
{ "name":"INIT_PARAMS:1", "value":"sga_target=314572800" },
{ "name":"INIT_PARAMS:2", "value":"pga_aggregate_target=209715200"  },
{ "name":"INIT_PARAMS:3", "value":"*.control_files='/scratch/app/oracle/oradata/simple/control01.ctl','/scratch/app/oracle/fast_recovery_area/simple/control02.ctl'"  },
{ "name":"INIT_PARAMS:4", "value":"*.db_name='simple'"  }
]
}
]
}

47.8.16 RMAN複製サービス・テンプレートを使用したフル・クローンの.jsonファイル

{
"type":"CDP",
"configurations":[
{ "name":"DATABASE_TYPE","value":"oracle_database" },
{ "name":"COMMON_DB_SYSTEM_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_DBSNMP_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_SYS_PASSWORD","value":"welcome" },
{ "name":"COMMON_DB_SID","value":"norm" },
{ "name":"COMMON_DOMAIN_NAME","value":"us.example.com" },
{ "name":"LISTENER_PORT", "value":"1521"},
{ "name":"STAGE_LOCATION", "value":"/tmp/rman_backup/backup1383140909156"},
{ "name":"REF_ZONE", "value":"SLC01HZK_ZONE" },
{ "name":"SID_OPTION", "value":"ssauser" },
{ "name":"COMMON_DB_SID","value":"mydb1" },
{ "name":"REF_POOL",   "value":"PRIMARY_DB2" },
{ "name":"REF_HOST", "value":"xyxy.example.com" },
{ "name":"REF_TGT","value":"xxxy.example.com" },
{ "name":"ROLE_NAME","value":"ROLE_Oct_31_2014_17_59_PM" },
{ "name":"ROLE_DESC","value":"New database role to be assigned to master account." },
{ "name":"USER_PRIVILEGES","value":"CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY" },
{ "name":"DEFAULT_DATABASE_SIZE","value":"small" },
{ "name":"DATABASE_SIZES","value":"","values":["small","medium"]},
{ "name":"LIVE_CLONE_DATABASE_GUID","value":"75D1AA10AE406B671F72A601AA8DC86F"},
{ "name":"ENTITY_TYPE","value":"USE_DATABASE"},
{ "name":"LIVE_CLONE_TYPE","value":"USE_FULLCLONE"},
{ "name":"SRC_HOST_CREDS","value":"CREDNAME:OWNER" },
{ "name":"SRC_DB_CREDS","value":"CREDNAME:OWNER" },
{ "name":"TARGET_PROP_LIST","value":"",
"values":[
"Department:value:false:false",
"Location:null:false:false",
"Comment:null:false:false",
"LifeCycle Status:null:false:false",
"Line of Business:null:false:false",
"Contact:null:false:false"]
},
{ "name":"CUSTOM_TARGET_PROP_LIST","value":"",
"values":[
"Department:value:false:false
]
},
{
"name":"INIT_PARAMS"
"subconfigurations":[
{ "name":"INIT_PARAMS:1", "value":"sga_target=314572800" },
{ "name":"INIT_PARAMS:2", "value":"pga_aggregate_target=209715200"  },
{ "name":"INIT_PARAMS:3", "value":"*.control_files='/scratch/app/oracle/oradata/simple/control01.ctl','/scratch/app/oracle/fast_recovery_area/simple/control02.ctl'"  },
{ "name":"INIT_PARAMS:4", "value":"*.db_name='simple'"  }
]
}
]
}

47.8.17 EMCストレージでライブ・クローン・テンプレートを使用したスナップクローン・データベース用のサービス・テンプレートの.jsonファイル

{
"type":"CDP",
"configurations":[
{ "name":"DATABASE_TYPE","value":"oracle_database" },
{ "name":"COMMON_DB_SYSTEM_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_DBSNMP_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_SYS_PASSWORD","value":"welcome" },
{ "name":"COMMON_DB_SID","value":"norm" },
{ "name":"COMMON_DOMAIN_NAME","value":"us.example.com" },
{ "name":"LISTENER_PORT", "value":"1521"},
{ "name":"STAGE_LOCATION", "value":"/tmp/rman_backup/backup1383140909156"},
{ "name":"REF_ZONE", "value":"SLC01HZK_ZONE" },
{ "name":"SID_OPTION", "value":"ssauser" },
{ "name":"COMMON_DB_SID","value":"mydb1" },
{ "name":"REF_POOL",   "value":"PRIMARY_DB2" },
{ "name":"REF_HOST", "value":"xyxy.example.com" },
{ "name":"REF_TGT","value":"xxxy.example.com" },
{ "name":"ROLE_NAME","value":"ROLE_Oct_31_2014_17_59_PM" },
{ "name":"ROLE_DESC","value":"New database role to be assigned to master account." },
{ "name":"USER_PRIVILEGES","value":"CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY" },
{ "name":"DEFAULT_DATABASE_SIZE","value":"small" },
{ "name":"DATABASE_SIZES","value":"","values":["small","medium"]},
{ "name":"LIVE_CLONE_DATABASE_GUID","value":"75D1AA10AE406B671F72A601AA8DC86F"}
{ "name":"ENTITY_TYPE","value":"USE_DATABASE"},
{ "name":"LIVE_CLONE_TYPE","value":"USE_SNAPCLONE"},
{ "name":"SRC_HOST_CREDS","value":"CREDNAME:OWNER" },
{ "name":"SRC_DB_CREDS","value":"CREDNAME:OWNER" },
{ "name":"TARGET_PROP_LIST","value":"",
"values":[
"Department:value:false:false",
"Location:null:false:false",
"Comment:null:false:false",
"LifeCycle Status:null:false:false",
"Line of Business:null:false:false",
"Contact:null:false:false"]
},
{ "name":"CUSTOM_TARGET_PROP_LIST","value":"",
"values":[
"Department:value:false:false
]
},
{
"name":"INIT_PARAMS",
"subconfigurations":[
{ "name":"INIT_PARAMS:1", "value":"sga_target=314572800" },
{ "name":"INIT_PARAMS:2", "value":"pga_aggregate_target=209715200"  },
{ "name":"INIT_PARAMS:3", "value":"*.control_files='/scratch/app/oracle/oradata/simple/control01.ctl','/scratch/app/oracle/fast_recovery_area/simple/control02.ctl'"  },
{ "name":"INIT_PARAMS:4", "value":"*.db_name='simple'"  }
]
}
]
}

47.9 EM CLI動詞を使用したデータベース・クローンの作成

この項では、EM CLI動詞を使用して、データベース・クローンを作成する手順について説明します。

注意:
テスト・マスター・データベースを作成する手順は、データベース・クローンを作成する場合に準拠する手順と同じです。唯一異なるのは、クローンの作成に使用するプロパティ・ファイル・パラメータです(テスト・マスター・データベースのプロパティ・ファイル・パラメータと比較した場合)。

図47-5 EM CLI動詞を使用したデータベース・クローンの作成

次の手順を使用して、データベース・クローンまたはテスト・マスター・データベースを作成します。

1. プロシージャ定義からテンプレート・プロパティ・ファイルを作成します。
テンプレート・プロパティ・ファイルを作成する場合、2つのアプローチがあります。次に示す方法1または方法2に従います。

- 方法1: Enterprise Manager UIを使用してデータベースのクローンを作成し、そこからプロパティ・ファイルを生成する方法
テンプレート・プロパティ・ファイルを作成するには、次の手順に従います。

1. Enterprise Manger UIを使用してデータベース・クローンを作成します。
クローンの作成時に「デプロイメント・プロシージャ・インスタンス名」を書き留めておきます。

たとえば、デプロイメント・プロシージャ・インスタンス名 = CloneDatabase_SYSMAN_12_24_2014_15_58_PMなどです。

2. 次のコマンドでインスタンス名を使用して、テンプレート・プロパティ・ファイルを生成します。

emcli get_instance_data
[-instance={instance_guid}]
[-exec={execution_guid}]
[-name={execution name}]
[-owner={execution owner}]

Sample:
emcli get_instance_data -name='CloneDatabase_SYSMAN_12_24_2014_15_58_PM' -owner='SYSMAN' > /tmp/create_clone.props

- 方法2: EM CLI動詞を使用してプロパティ・ファイルを生成する方法
EM CLI動詞を使用してテンプレート・プロパティ・ファイルを作成するには、次の手順に従います。

1. プロシージャのGUIDまたは名前を取得します。次のコマンドを実行してこれらを取得します。

emcli get_procedures
[-type={procedure type}]

Sample command:
emcli get_procedures -type=DBConfig

Sample output:
GUID                         Type      Name                        DisplayName             Version  Owner   Parent Procedure
0A15E9DC20772EF5E053E87BF00A6701  DBConfig  db_clone_eb_procedure       db_clone_eb_procedure   2.12     ORACLE
0A15E9DC20A12EF5E053E87BF00A6701  DBConfig  db_config_procedure         DB Snap Clone           2.2      ORACLE
0A15E9DC20422EF5E053E87BF00A6701  DBConfig  config_db_create_procedure  Create Oracle Database  1.5      ORACLE

2. 次のコマンドに入力値としてGUIDまたは名前を入力し、テンプレート・プロパティ・ファイルを生成します。

emcli describe_procedure_input
[-procedure={procedure GUID}]
[-name={procedure name or procedure configuration}]
[-owner={owner of the procedure or procedure configuration}]
[-parent_proc={procedure of the procedure configuration. This only applies to describe a procedure configuration with the same name}]

Sample command:
emcli describe_procedure_input -procedure=0A15E9DC20A12EF5E053E87BF00A6701 > /tmp/create_clone.props

2. プロパティ・ファイルに新しい値を入力します。
エディタを使用してプロパティ・ファイルを編集します。変数に適切な値を入力し、プロパティ・ファイルを保存します。

次の表に、データベース・クローンの作成に使用されるプロパティ・ファイル・パラメータを示します。テスト・マスター・データベースを作成するためのプロパティ・ファイル・パラメータを確認するには、表47-19「テスト・マスター・データベースを作成するためのサンプル・プロパティ・ファイル」を参照してください。

表47-18 データベース・クローンを作成するためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

CLONE_TYPE

CLONE_TYPE=DUPLICATE

クローンのタイプ。有効な値は、DUPLICATE、SNAP、DNFS_PROFILEおよびRMAN_PROFILEです。

SRC_DB_TARGET_NAME

SRC_DB_TARGET_NAME=xxyy.us.example.com

ソース・データベース・ターゲットの名前。

SRC_DB_TARGET_TYPE

SRC_DB_TARGET_TYPE=oracle_database

ソース・データベース・ターゲットのタイプ。有効な値は、oracle_databaseおよびrac_databaseです。

SRC_DB_CRED

SRC_DB_CRED=NC_CRED:SYSCO

<NAME:OWNER>の形式でのソース・データベース資格証明。

SRC_HOST_NORMAL_NAMED_CRED

SRC_HOST_NORMAL_NAMED_CRED=NC_HOST_CRED:SYSCO

<NAME:OWNER>の形式でのソース・ホスト資格証明。

COMMON_GLOBAL_DB_NAME

COMMON_GLOBAL_DB_NAME=clonedb.example.com

クローン・データベースのグローバル・データベース名。

COMMON_DB_SID

COMMON_DB_SID=clonedb

クローン・データベースのSID。

DB_TARGET_NAME

DB_TARGET_NAME=clonedb.xxy.example.com

クローン・データベース・ターゲットの名前。

DATABASE_TYPE

DATABASE_TYPE=dbTypeSI

データベースのタイプを示します。使用できる値は、dbTypeSIおよびdbTypeRACです。

TARGET_HOST_LIST

TARGET_HOST_LIST=desthost.example.com

クローン・データベースが作成される宛先ホストの名前。

ORACLE_HOME_NAME

ORACLE_HOME_NAME=OraDB12Home2_29

宛先Oracleホームの名前。

ORACLE_HOME_LOC

ORACLE_HOME_LOC=/scratch/app/product/11.2.0./dbhome_1

宛先Oracleホームの場所。

ORACLE_BASE_LOC

ORACLE_BASE_LOC=/scratch/app

宛先Oracleベースの場所。

HOST_NORMAL_NAMED_CRED

HOST_NORMAL_NAMED_CRED=NC_HOST_CRED:SYSCO

<NAME:OWNER>の形式での宛先ホスト資格証明。

DB_STORAGE_TYPE

DB_STORAGE_TYPE=FS

データベース・ファイルの記憶域タイプ。有効な値は、FSおよびASMです。

DB_FILE_LOC

DB_FILE_LOC=/scratch/app/oradata

クローン・データベース用のデータベース・ファイルが作成される場所。

FRA_STORAGE_TYPE

FRA_STORAGE_TYPE=FS

高速リカバリ領域の記憶域タイプ。有効な値は、FSおよびASMです。

FLASH_REC_AREA

FLASH_REC_AREA=/scratch/user/app/fra

リカバリ関連ファイル(アーカイブREDOログやRMANバックアップなどの関連ファイル)が作成される場所。

FRA_SIZE

FRA_SIZE=4395

高速リカバリ領域のサイズ。

ARCHIVE_LOG_MODE

ARCHIVE_LOG_MODE=NO

クローン・データベースがARCHIVELOGモードであるかどうか。使用できる値は、YESおよびNOです。

DEST_LISTENER_SELECTION

DEST_LISTENER_SELECTION=DEST_DB_HOME

指定されたリスナーがグリッド・ホーム・リスナーであるかどうかを示します。有効な値は、GRID_INFRAおよびDEST_DB_HOMEです。

LISTENER_PORT

LISTENER_PORT=1526

クローン・データベースが登録されるリスナーのポート。

ENABLE_LIVE_CLONE

ENABLE_LIVE_CLONE=true

ライブ・クローンが有効であるかどうかを示します。使用できる値は、trueおよびfalseです。

DB_ADMIN_PASSWORD_SAME

DB_ADMIN_PASSWORD_SAME=true

SYSTEM、SYSおよびDBSNMPユーザーのパスワードが同じであるかどうかを示します。使用できる値は、trueまたはfalseです。

DATABASE_PASSWORDS

DATABASE_PASSWORDS=right1

SYSTEM、SYSおよびDBSNMPユーザーの共通パスワード。これは、パラメータDB_ADMIN_PASSWORD_SAME=trueの場合にのみ適用できます。

DB_TEMPLATE_STAGE

DB_TEMPLATE_STAGE=/tmp

ソース・ホストから転送されたファイルを格納するために使用される一時ステージング領域。

オプション・パラメータ

CLUSTERNAME

CLUSTERNAME=cluster

宛先クラスタの名前。これは、DATABASE_TYPE= dbTypeRACの場合にのみ適用できます。

RAC_CONFIG_TYPE

RAC_CONFIG_TYPE=ADMIN_MANAGED

宛先クラスタ・データベースのタイプ。これは、DATABASE_TYPE= dbTypeRACの場合にのみ適用できます。有効な値は、ADMIN_MANAGEDです。

RAC_NODE_LIST

RAC_NODE_LIST=node1,node2

クローン・データベースが作成されるRACノードのリスト。これは、DATABASE_TYPE= dbTypeRACの場合にのみ適用できます。

IS_RAC_ONE

IS_RAC_ONE=false

RAC One Nodeであるかどうかを示します。これは、DATABASE_TYPE= dbTypeRACの場合にのみ適用できます

SRC_HOST_NORMAL_PREF_CRED_SET_NAME

SRC_HOST_NORMAL_PREF_CRED_SET_NAME=HostCredsNormal

ソース・データベースの優先資格証明。

ASMSYSPWD

ASMSYSPWD=String1

ソースASMパスワード。これは、ソース・データベースがASM上に存在する場合にのみ適用できます。

HOST_NORMAL_PREF_CRED_SET_NAME

HOST_NORMAL_PREF_CRED_SET_NAME= HostCredsNormal

宛先ホストの優先資格証明。

HOST_PRIV_NAMED_CRED

HOST_PRIV_NAMED_CRED= HOST_PRIV_CRED:SYSCO

宛先ホストのルート資格証明。これは、CLONE_TYPE=SNAPの場合にのみ適用できます。

HOST_PRIV_PREF_CRED_SET_NAME

HOST_PRIV_PREF_CRED_SET_NAME=HostCredsPriv

宛先ホストの優先ルート資格証明。これは、CLONE_TYPE=SNAPの場合にのみ適用できます。

PROFILE_INTERNAL_PATH

バックアップのプロファイル内部パス。これは、プロファイルがクローンに使用される場合にのみ適用できます。

PROFILE_VERSION_URN

バックアップのプロファイル・バージョンURN。これは、プロファイルがクローンに使用される場合にのみ適用できます。

BACKUP_LOCATION_NAME

BACKUP_LOCATION_NAME=/scratch/databkp

データベース・バックアップの場所。これは、ライブ・クローンではない場合に適用できます。

BACKUP_TAG

RMANレガシー・バックアップのデータファイル・タグ。これは、クローンに非プロファイル・ベースのRMANバックアップを使用する場合にのみ適用できます。

CONTROL_FILE_TAG

RMANレガシー・バックアップの制御ファイル・タグ。これは、クローンに非プロファイル・ベースのRMANバックアップを使用する場合にのみ適用できます。

PIT_DATETIME

日時を使用したポイント・イン・タイム・リカバリ。これは、ライブ・クローンではない場合に適用できます。

PIT_SCN

SCNを使用したポイント・イン・タイム・リカバリ。これは、ライブ・クローンではない場合に適用できます。

IS_SAVE_PROFILE

ソース・データベースのスナップショット・プロファイルが作成されることを示します。これは、CLONE_TYPE=SNAPの場合にのみ適用できます。

COMMON_DOMAIN_NAME

COMMON_DOMAIN_NAME=xxy.example.com

クローン・データベースのドメイン。

COMMON_DB_DBSNMP_PASSWORD

COMMON_DB_DBSNMP_PASSWORD=right

クローン・データベースのDBSNMPユーザー・パスワード。これは、パラメータDB_ADMIN_PASSWORD_SAME=falseの場合にのみ適用できます。

COMMON_DB_SYSTEM_PASSWORD

COMMON_DB_SYSTEM_PASSWORD=right

クローン・データベースのSYSTEMユーザー・パスワード。これは、パラメータDB_ADMIN_PASSWORD_SAME=falseの場合にのみ適用できます。

COMMON_DB_SYS_PASSWORD

COMMON_DB_SYS_PASSWORD=right

クローン・データベースのSYSユーザー・パスワード。これは、パラメータDB_ADMIN_PASSWORD_SAME=falseの場合にのみ適用できます。

MOUNT_POINT_PREFIX

MOUNT_POINT_PREFIX=/vol1/prefix

マウント・ポイント接頭辞。このパラメータは、CLONE_TYPE=SNAPの場合にのみ適用できます。

MOUNT_POINT_LIST

MOUNT_POINT_LIST=volname1

ストレージ・ボリューム名。このパラメータは、CLONE_TYPE=SNAPの場合にのみ適用できます。

MOUNT_ADDL_SIZE_LIST

MOUNT_ADDL_SIZE_LIST=2

書込み可能領域。このパラメータは、CLONE_TYPE=SNAPの場合にのみ適用できます。

USE_OFA

USE_OFA=false

データベース記憶域ファイルの場所のカスタマイズにOracle Flexible Architectureを使用するかどうかを示します。有効な値はtrueおよびfalseです。

OFA_TEMP_FILE_LOCATION

OFA_TEMP_FILE_LOCATION=/scratch/user/app/oradata/temp

一時ファイルが作成される場所。このパラメータは、USE_OFA=trueの場合にのみ適用できます。

OFA_REDO_LOG_LOCATION

OFA_REDO_LOG_LOCATION==/scratch/user/app/oradata/rlog

REDOログ・ファイルが作成される場所。このパラメータは、USE_OFA=trueの場合にのみ適用できます。

OFA_CONTROL_FILE_LOCATION

OFA_CONTROL_FILE_LOCATION==/scratch/user/app/control

制御ファイルが作成される場所。このパラメータは、USE_OFA=trueの場合にのみ適用できます。

IS_SAVE_TARGET_PROFILE

IS_SAVE_TARGET_PROFILE=Y

クローン・データベースのプロファイルを作成するかどうかを示します。有効な値は、YおよびNです。

NEW_PROFILE_LOCATION

NEW_PROFILE_LOCATION=Database Provisioning Profiles/12.1.0.1.0/Linuxx86_64

ソフトウェア・ライブラリ内のプロファイルの場所。このパラメータは、IS_SAVE_TARGET_PROFILE=Yの場合にのみ適用できます。

NEW_PROFILE_NAME

NEW_PROFILE_NAME=Clone Profile

作成される新しいDBプロファイルの名前。このパラメータは、IS_SAVE_TARGET_PROFILE=Yの場合にのみ適用できます

PROFILE_DESC

PROFILE_DESC=Database Reference Profile 24-12-2014 04:00 PM from orcl.xyc.example.com Version : 12.1.0.1.0

プロファイルの説明。このパラメータは、IS_SAVE_TARGET_PROFILE=Yの場合にのみ適用できます。

PROFILE_NOTES

PROFILE_NOTES=Host Name: xyz.example.com Database: orcl.xyz.example.com

プロファイルの備考。このパラメータは、IS_SAVE_TARGET_PROFILE=Yの場合にのみ適用できます。

PROFILE_VENDOR

PROFILE_VENDOR=Oracle

プロファイルのベンダー。このパラメータは、IS_SAVE_TARGET_PROFILE=Yの場合にのみ適用できます

PROFILE_VERSION

PROFILE_VERSION=12.1.0.1.0

プロファイルのバージョン。このパラメータは、IS_SAVE_TARGET_PROFILE=Yの場合にのみ適用できます

DATA_CONTENT_MODE

DATA_CONTENT_MODE=RMAN

データベース・プロファイルのデータ・モード。使用できる値は、RMANおよびDNFSです。このパラメータは、IS_SAVE_TARGET_PROFILE=Yの場合にのみ適用できます。

RMAN_BACKUP_LOCATION

RMAN_BACKUP_LOCATION=/scratch/user/app/backup

RMANバックアップ・ファイルが作成される場所。これは、IS_SAVE_TARGET_PROFILE =Yで、DATA_CONTENT_MODEがRMANまたはDNFSの場合にのみ適用できます。

BACKUP_FILE_TAG

BACKUP_FILE_TAG=data_backup_1419417051961

バックアップ・ファイルに関連付けられるタグ。IS_SAVE_TARGET_PROFILEがYに、DATA_CONTENT_MODEがRMANに設定されている場合、このパラメータは必須です。

BACKUP_TYPE

BACKUP_TYPE=OFFLINE

バックアップのタイプ。OFFLINEまたはONLINEを指定できます。デフォルトはOFFLINEです。このパラメータは、IS_SAVE_TARGET_PROFILE =Yの場合にのみ適用できます。

PROFILE_PURGE_POLICY_TYPE

PROFILE_PURGE_POLICY_TYPE=SNAPSHOTS,

プロファイル・パージ・ポリシー・タイプ。使用できる値は、SNAPSHOTSまたはDAYSです。このパラメータは、IS_SAVE_TARGET_PROFILE =Yの場合にのみ適用できます。

PROFILE_PURGE_POLICY_VALUE

PROFILE_PURGE_POLICY_VALUE=1

プロファイル・パージ・ポリシー値。このパラメータは、IS_SAVE_TARGET_PROFILE =Yの場合にのみ適用できます

PROFILE_SCHEDULE

プロファイル作成のスケジュール。

IS_TESTMASTER_DATABASE

IS_TESTMASTER_DATABASE=N

クローン・データベースをテスト・マスター・データベースとして作成するかどうかを示します。使用できる値は、YまたはNです。

ENABLE_DATA_MASK

ENABLE_DATA_MASK=true

データ・マスクを適用する必要があるかどうかを示します。使用できる値は、trueおよびfalseです。

MASKING_DEFINITION_NAME

MASKING_DEFINITION_NAME=MASK_DEF_10

マスキング定義の名前。このパラメータは、ENABLE_DATA_MASK= trueの場合にのみ適用できます。

CUSTOM_PRE_SCRIPTS_URN

ソフトウェア・ライブラリのクローニング前スクリプトのURN。

CUSTOM_POST_SCRIPTS_URN

ソフトウェア・ライブラリのクローニング後スクリプトのURN。

POST_SQL_SCRIPT_URN

ソフトウェア・ライブラリのクローニング後SQLスクリプトのURN。

RUN_AS_USER

RUN_AS_USER =sys

クローニング後SQLスクリプトを実行するユーザーの名前。このパラメータは、POST_SQL_SCRIPT_URNが指定されている場合にのみ適用できます。

RUN_AS_USER_PWD

RUN_AS_USER_PWD =right

クローニング後SQLスクリプトを実行するユーザーのパスワード。このパラメータは、POST_SQL_SCRIPT_URNが指定されている場合にのみ適用できます。

EXECUTION_MODE

EXECUTION_MODE = PROVISIONING

実行のモード。

CONFIGURE_WITH_ORACLE_RESTART

CONFIGURE_WITH_ORACLE_RESTART=N

クローン・データベースをOracle Restartで構成するかどうかを示します。

表47-19 テスト・マスター・データベースを作成するためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

CLONE_TYPE

CLONE_TYPE=DUPLICATE

クローンのタイプ。デフォルト値はDUPLICATEです。

COMMON_DB_DBSNMP_PASSWORD

COMMON_DB_DBSNMP_PASSWORD=come

クローン・データベースでDBSNMPユーザーに設定されるパスワード。

COMMON_DB_SID

COMMON_DB_SID=clonedb

クローン・データベースのSID。

COMMON_DB_SYSTEM_PASSWORD

COMMON_DB_SYSTEM_PASSWORD=sysco

クローン・データベースでSYSTEMユーザーに設定されるパスワード。

COMMON_DB_SYS_PASSWORD

COMMON_DB_SYS_PASSWORD=sysco

クローン・データベースでSYSユーザーに設定されるパスワード。

DATABASE_PASSWORDS

DATABASE_PASSWORDS=Sysco1

クローン・データベースのパスワード。

COMMON_GLOBAL_DB_NAME

COMMON_GLOBAL_DB_NAME=clonedb.xyz.com

グローバル・クローン・データベース名。

DB_ADMIN_PASSWORD_SAME

DB_ADMIN_PASSWORD_SAME=true

SYSTEM、SYSおよびDBSNMPユーザーのパスワードが同じであるかどうか。使用できる値は、trueまたはfalseです。

DEST_LISTENER_SELECTION

DEST_LISTENER_SELECTION=DEST_DB_HOME

宛先のOracleホームの場所。

HOST_NORMAL_NAMED_CRED

HOST_NORMAL_NAMED_CRED=HOST:SYSCO

ホストの資格証明。

IS_TESTMASTER_DATABASE

IS_TESTMASTER_DATABASE=Y

クローン・データベースをテスト・マスター・データベースとして作成するかどうかを示します。使用できる値は、YまたはNです。デフォルト値はNです。

USAGE_MODE

USAGE_MODE = testMaster

クローン・データベースの使用モード。

CLOUD_TARGET

CLOUD_TARGET = true

クラウド・ターゲットが許可されるかどうかを示します。

LISTENER_PORT

LISTENER_PORT=1526

クローン・データベースが登録されるリスナーのポート。

ORACLE_BASE_LOC

ORACLE_BASE_LOC=/scratch/app

Oracleベースの場所。

ORACLE_HOME_LOC

ORACLE_HOME_LOC=/scratch/app/product/11.2.0./dbhome_1

Oracleホームの場所。

EM_USER

EM_USER=sys

EMユーザー名。

EM_PWD

EM_PWD=Sys1

EMパスワード。

SRC_DB_CRED

SRC_DB_CRED=DB:SYSCO

ソース・データベースの資格証明。

SRC_DB_TARGET_NAME

SRC_DB_TARGET_NAME=orcl.xyz.com

ソース・データベース・ターゲットの名前。

SRC_HOST_NORMAL_NAMED_CRED

SRC_HOST_NORMAL_NAMED_CRED=HOST:SYSCO

ホスト・データベースの資格証明。

TARGET_HOST_LIST

TARGET_HOST_LIST=blr22.xyz.com

ターゲット・ホストのリスト。

オプション・パラメータ

ARCHIVE_LOG_MODE

ARCHIVE_LOG_MODE=NO

クローン・データベースがアーカイブ・ログ・モードであるかどうかを示します。デフォルト値は、NOです。

BACKUP_FILE_TAG

BACKUP_FILE_TAG=data_backup_1419417051961

バックアップ・ファイルに関連付けられるタグ。IS_SAVE_TARGET_PROFILEがYに、DATA_CONTENT_MODEがRMANに設定されている場合、このパラメータは必須です。

BACKUP_TYPE

BACKUP_TYPE=OFFLINE

バックアップのタイプ。使用できる値は、OFFLINEまたはONLINEです。デフォルト値はOFFLINEです。

COMMON_DOMAIN_NAME

COMMON_DOMAIN_NAME=xxy.example.com

クローン・データベースのドメイン。

CONFIGURE_WITH_ORACLE_RESTART

CONFIGURE_WITH_ORACLE_RESTART=N

クローン・データベースをOracle Restartで構成するかどうかを示します。デフォルト値はNです。

DATABASE_TYPE

DATABASE_TYPE=dbTypeSI

使用できる値は、単一インスタンス・データベース、RACデータベースおよびRAC One Nodeデータベースです。デフォルト値は、単一インスタンス・データベースです。

DATA_CONTENT_MODE

DATA_CONTENT_MODE=RMAN

データベース・プロファイルを発行する必要のあるデータ・モード。値としてEXPORT、DBCA_TEMPLATE、RMAN、DNFSおよびSTORAGE_SNAPSHOTを指定できます。

DB_FILE_LOC

DB_FILE_LOC=/scratch/app/oradata

データファイル、一時ファイル、REDOログ・ファイルおよび制御ファイルが作成される場所。

DB_STORAGE_TYPE

DB_STORAGE_TYPE=FS

データベースの記憶域タイプ。使用できる値は、ファイル・システム(FS)およびASMです。デフォルト値はFSです。

DB_TARGET_NAME

DB_TARGET_NAME=clonedb.xxy.example.com

クローン・データベース・ターゲットの名前。

DB_TEMPLATE_STAGE

DB_TEMPLATE_STAGE=/scratch/view_storage/emagent/gcagent/em_staging

ソース・ホストから転送されたファイルを格納するために使用されるステージング領域。

ENABLE_LIVE_CLONE

ENABLE_LIVE_CLONE=true

ライブ・クローンが有効であるかどうかを示します。デフォルト値はtrueです。

IS_SAVE_TARGET_PROFILE

IS_SAVE_TARGET_PROFILE=Y

クローン・データベースを使用してDBプロファイルを作成するかどうかを示します。使用できる値は、YまたはNです。デフォルト値はNです。

NEW_PROFILE_LOCATION

NEW_PROFILE_LOCATION=Database Provisioning Profiles/12.1.0.1.0/Linuxx86_64

ソフトウェア・ライブラリ内のプロファイルの場所。IS_SAVE_TARGET_PROFILEがYに設定されている場合、このパラメータは必須です。

NEW_PROFILE_NAME

NEW_PROFILE_NAME=Clone Profile

作成される新しいDBプロファイルの名前。IS_SAVE_TARGET_PROFILEがYに設定されている場合は必須です。

ORACLE_HOME_NAME

ORACLE_HOME_NAME=OraDB12Home2_29_idc.example.com

Oracleホームの名前。

PDB_ADMIN_PASSWORD

プラガブル・データベースの管理パスワード。

PROFILE_DESC

PROFILE_DESC=Database Reference Profile 24-12-2014 04:00 PM from orcl.xyc.example.com Version : 12.1.0.1.0

プロファイルの説明。

PROFILE_NOTES

PROFILE_NOTES=Host Name: xyz.example.com Database: orcl.xyz.example.comData Content: Structure and Data

プロファイルの備考。

PROFILE_VENDOR

PROFILE_VENDOR=Oracle

プロファイルのベンダー。デフォルトは「Oracle」です。

PROFILE_VERSION

PROFILE_VERSION=12.1.0.1.0

プロファイルのバージョン。値を指定しない場合、データベース・バージョンが使用されます。

RMAN_BACKUP_LOCATION

RMAN_BACKUP_LOCATION=/scratch/app/backup

RMANバックアップ・ファイルが作成される場所。IS_SAVE_TARGET_PROFILEがYに、DATA_CONTENT_MODEがRMANまたはDNFSに設定されている場合、このパラメータは必須です。

SRC_DB_TARGET_TYPE

SRC_DB_TARGET_TYPE=oracle_database

ソース・データベースのタイプ。

MASKING_DEFINITION_NAME

MASKING_DEFINITION_NAME=MASK_DEF_10

データベースのクローニング後に適用するマスキング定義の名前。

ENABLE_DATA_MASK

ENABLE_DATA_MASK=true

データ・マスクを有効にするかどうかを示します。デフォルト値はfalseです。

PROFILE_PURGE_POLICY_TYPE

PROFILE_PURGE_POLICY_TYPE=SNAPSHOTS,

プロファイル・パージ・ポリシー・タイプ。使用できる値は、SNAPSHOTSまたはDAYSです。デフォルト値は「なし」です。

PROFILE_PURGE_POLICY_VALUE

PROFILE_PURGE_POLICY_VALUE=1

プロファイル・パージ・ポリシー値。

PROFILE_SCHEDULE

プロファイル実行のスケジュール。

WORKING_DIRECTORY

WORKING_DIRECTORY=/tmp

ファイルがステージングされる場所。

FLASH_REC_AREA

リカバリ関連ファイル(アーカイブREDOログやRMANバックアップなどの関連ファイル)が作成される場所。高速リカバリ領域の記憶域タイプは、データベース・ファイルの場所と同じになります。

FRA_STORAGE_TYPE

データベースの記憶域タイプと同じです。

3. 更新されたプロパティ・ファイルを入力ファイルとして使用し、次のEM CLI動詞を実行してデータベース・クローン(またはテスト・マスター)を作成します。

emcli create_clone
-input_file="File containing properties required for cloning a database"

Sample:
emcli create_clone  -inputFile=/tmp/create_clone.props

Sample output:
Submitting clone database procedure... 0AF491A8D9FE29F2E0539878B10A6333 Deployment procedure submitted successfully

4. 次のEM CLI動詞を実行して、データベース・クローン作成のステータスを確認します。

emcli get_instance_status
[-instance={instance guid}]
[-exe=execution guid]
[-xml]
[-details]
[-showJobOutput]
[-tailLength={last N characters}]]

Sample:
emcli get_instance_status -instance=0AF491A8D9FE29F2E0539878B10A6333

Sample output:
0AF491A8DA0529F2E0539878B10A6333, DBConfig, db_config_procedure 1419435633924, COMPLETED

xml形式で各手順の完全なステータスを確認するには、次のコマンドを実行します。

emcli get_instance_status -instance=0AF491A8D9FE29F2E0539878B10A6333 -xml -details -showJobOutput

47.10 EM CLI動詞を使用したデータベースのリフレッシュ

この項では、EM CLI動詞を使用して、データベースをリフレッシュする手順について説明します。

図47-6 EM CLI動詞を使用したデータベースのリフレッシュ

次の手順を使用して、データベースをリフレッシュします。

1. 次に示すemcli refresh_databaseコマンドを実行して、データベースをリフレッシュします。
EM CLIコマンドでは、入力としてプロパティ・ファイルが必要です。次の表に、プロパティ・ファイルの詳細を示します。

表47-20 データベースをリフレッシュするためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

DB_TEMPLATE_STAGE

DB_TEMPLATE_STAGE=/tmp

ソース・ホストから転送されたファイルを格納するために使用されるステージング領域。

COMMON_DB_SYSTEM_PASSWORD

COMMON_DB_SYSTEM_PASSWORD=come

SYSTEMユーザーに設定されるパスワード。

COMMON_DB_DBSNMP_PASSWORD

COMMON_DB_DBSNMP_PASSWORD=come

DBSNMPユーザーに設定されるパスワード。

COMMON_DB_SYS_PASSWORD

COMMON_DB_SYS_PASSWORD=come

SYSユーザーに設定されるパスワード。

ASMSYSPWD

ASMSYSPWD=come

ASMにログインするためのASM SYSパスワード。このパラメータは、データベース・ファイルがASM上に存在する場合にのみ適用できます。それ以外の場合は必要ありません。

CLONE_TYPE

CLONE_TYPE=RMAN_PROFILE

クローンのタイプ。

オプション・パラメータ

TARGET_TYPE

TARGET_TYPE=rac_database

ターゲットのタイプ。使用できる値は、oracle_databaseまたはrac_databaseです。

ORACLE_HOME

ORACLE_HOME_LOC=/u01/user/app/user/product/11.2.0/dbhome_1

Oracleホームの場所。

SRC_SYS_PWD

SRC_SYS_PWD=Come

ソースSYSパスワード。

SRC_SID

SRC_SID=orcl

ソース・データベースのSID。

TARGET_NAME

ターゲットの名前。

emcli refresh_database
-target_name="database target name"
-target_type="database target type"
-input_file=data:"file:path"
Sample:
emcli refresh_database -target_name="database" -target_type="oracle_database" -input_file=data:"/tmp/refr.txt"

Output:
Refresh Database deployment procedure has been submitted successfully with the instance
name:"RefreshDatabase_SYSMAN_06_23_2014_01_00_PM" and execution_guid='0AE6096550756B26E0539878B10A6FF5'

xml形式でプロシージャのステータスを確認するには、次のコマンドを実行します。

emcli get_instance_status -exec=0AE6096550756B26E0539878B10A6FF5 -xml -details -showJobOutput

2. 次のEM CLI動詞を実行して、データベース・リフレッシュのステータスを確認します。

emcli get_instance_status
[-instance={instance guid}]
[-exe=execution guid]
[-xml]
[-details]
[-showJobOutput]
[-tailLength={last N characters}]]

Sample:
emcli get_instance_status -exe=0AFDFE7D36525B18E0539878B10A39FB

Sample output:
00AFDFE7D36555B18E0539878B10A39FB, DBPROV, RefreshDatabase_SYSMAN_06_23_2014_01_00_PM, COMPLETED

xml形式で各手順の完全なステータスを確認するには、次のコマンドを実行します。

emcli get_instance_status -exe=0AF491A8D9FE29F2E0539878B10A6333 -xml -details -showJobOutput

47.11 EM CLI動詞を使用したデータベースの削除

この項では、EM CLI動詞を使用して、データベースを削除する手順について説明します。

図47-7 EM CLI動詞を使用したデータベースの削除

次の手順を使用して、データベースを削除します。

1. 次に示すemcli delete_databaseコマンドを使用して、データベースを削除します。
EM CLIコマンドでは、入力としてプロパティ・ファイルが必要です。次の表に、プロパティ・ファイルの詳細を示します。

表47-21 データベースを削除するためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

HOST_CREDS

HOST_CREDS=sys:come,

<Credentials name>:<Credentials owner>形式のホストの資格証明。

DB_TARGET_GUID

DB_TARGET_GUID=083B2D3F9B911BD3E0539878B10A3096

ターゲット・データベースのGUID。

mgmt$targetから、Target_GUIDを選択します。この場合、target_name='MyDB.example.com'およびtarget_type='rac_database'です

DATABASE_TYPE

DATABASE_TYPE=dbTypeSI,

データベースのタイプ。

許可される値は、dbTypeSIまたはdbTypeRACのいずれかです。

DB_ORACLE_HOME_LOC

DB_ORACLE_HOME_LOC=/u01/oracle/product/dbhome,

Oracleホームの場所。

DB_TARGET_NAME

DB_TARGET_NAME=m2.xyz.com,

ターゲット・データベースの名前。

DB_SID

DB_SID=clem

データベースのSID。

RACデータベースで指定される値が、DB_TARGET_NAMEに指定された値と同じ場合。

HOST_NAME

HOST_NAME=abc.example.com,

SIデータベースの場合の、ホスト名。

RACデータベースの場合、クラスタ・データベース・ターゲットのホスト名を入力します。それを取得するには、EMリポジトリ問合せ(target_name='MyDB.example.com'およびtarget_type='rac_database'の場合、host_nameをmgmt$targetから選択)を使用します。

ORACLE_BASE

ORACLE_BASE=/u01/app/oracle

Oracleベースの場所。

DBNAME

DBNAME=clem

SIデータベースの場合の、データベース名。

RACデータベースの場合、クラスタ・データベース・ターゲットの'DBName'ターゲット・プロパティを入力します。このプロパティを取得するには、EMリポジトリ問合せ(target_name='MyDB.example.com'およびtarget_type='rac_database' and property_name='DBName'の場合、property_valueをmgmt$target_propertiesから選択)を使用します

オプションのパラメータ

ROOT_CREDS

ROOT_CREDS=ABDCGA45268SDF

特権資格証明のGUID。ターゲット・データベースがボリュームに基づいてマウントされているスナップショットの場合、このパラメータは必須です。

emcli delete_database
-inputFile="File containing properties required for deleting a clone"

Sample:
emcli delete_database -inputFile=/u01/files/delete_clone.props

Output:
Submitting delete database procedure...
0AFDFE7D36525B18E0539878B10A39FB
Deployment procedure submitted successfully

2. 次のEM CLI動詞を実行して、データベース削除のステータスを確認します。

emcli get_instance_status
[-instance={instance guid}]
[-exe=execution guid]
[-xml
[-details]
[-showJobOutput]
[-tailLength={last N characters}]]

Sample:
emcli get_instance_status -instance=0AFDFE7D36525B18E0539878B10A39FB

Output:
0AFDFE7D36555B18E0539878B10A39FB, DBPROV, DB_CLEANUP_PROC 1419457116034, COMPLETED

xml形式で各手順の完全なステータスを確認するには、次のコマンドを実行します。

emcli get_instance_status -instance=0AF491A8D9FE29F2E0539878B10A6333 -xml -details -showJobOutput

47.12 データベース・フリート・メンテナンスEM CLI動詞

次の表に、データベース・フリート・メンテナンスでサポートされる動詞の詳細を示します。

注意:
大カッコ[]で囲まれたEM CLI動詞オプションは省略可能です。

表47-22 データベース・ソフトウェア・メンテナンスEM CLI動詞

動詞

説明

形式

emcli db_software_maintenance -createSoftwareImage

oracleホームで提供されている新規ソフトウェア・イメージを作成します。createSoftwareImage動詞は、データ(.txtファイル)またはgetInputVariableListをコマンド・ラインから受け取ります。

- input_file - 入力ファイルのパス。

- getInputVariableList - 入力ファイルで指定する変数のリストを提供します。

例:

- データ・ファイルの内部で渡すすべてのパラメータのリストを取得するには、次のコマンドを実行します。
emcli db_software_maintenance -createSoftwareImage -getInputVariableList=true

- 新規イメージおよびバージョンを作成するには、次の例を使用します。
emcli createSoftwareImage -input_file="data:"/home/user/input_rac"

input_racファイルの内容は次のとおりです。

- IMAGE_NAME=DbGoldImage

- IMAGE_DESCRIPTION=Gold Image for 11g db

- REF_TARGET_NAME=ORACLE_HOME

- IMAGE_SWLIB_LOC=Oracle Home Provisioning

- Profiles/11.2.0.3.0/linux_x64

- REF_HOST_CREDENTIALS=ZONE_CREDS:TESTSUPERADMIN

- WORKING_DIRECTORY=/tmp

- STORAGE_TYPE_FOR_SWLIB=OmsShared

- STORAGE_NAME_FOR_SWLIB=swlib

- VERSION_NAME=Version1

- 新規バージョンのみ既存のイメージに作成するには、次の例を参照してください。
emcli db_software_maintenance -createSoftwareImage -input_file="data:"/home/user/input_rac"

input_racファイルの内容は次のとおりです。

- IMAGE_ID=01B5F14FD57D7B89E05313B2F00A739F

- REF_TARGET_NAME=ORACLE_HOME

- IMAGE_SWLIB_LOC=Oracle Home Provisioning

- Profiles/11.2.0.3.0/linux_x64

- REF_HOST_CREDENTIALS=ZONE_CREDS:TESTSUPERADMIN

- WORKING_DIRECTORY=/tmp

- STORAGE_TYPE_FOR_SWLIB=OmsShared

- STORAGE_NAME_FOR_SWLIB=swlib

- VERSION_NAME=Version1

- emcli db_software_maintenance
-createSoftwareImage

-getInputVariableList=true

- emcli createSoftwareImage
-input_file="data:"/home/user/input_rac"

emcli db_software_maintenance -createVersion

既存のソフトウェア・ライブラリ・コンポーネントを使用して、既存のイメージに新規バージョンを作成します。

- version_name - バージョンの名前。

- image_id - イメージの名前。

- external_id - バージョンの外部ID。たとえば、ソフトウェア・ライブラリ・ゴールド・イメージのURN。

- status - バージョンのステータス。たとえば、DRAFT、ACTIVE、CURRENTまたはRESTRICTEDです。

例:

emcli db_software_maintenance -createVersion -version_name="Version1" -image_id="01B5F14FD57D7B89E05313B2F00A739F" -external_id="oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_OracleDB:0191172464DD36B6E05313B2F00AB90A:0.1" -status=CURRENT

emclu db_software_maintenance

-createVersion-version_name="Versionx"

-image_id="xxxx"

-external_id="yyyy"

-status="CURRENT"

emcli db_software_maintenance -subscribeTarget

新規ターゲット・サブスクリプションを作成するか、既存のターゲット・サブスクリプションを変更します。

- target_name - ターゲットの名前。

- target_type - ターゲット・タイプ。

- [parent_target_name] - 親ターゲット名。

- [parent_target_type] - 親ターゲット・タイプ。

- image_id - イメージの名前。

例:

emcli db_software_maintenance -subscribeTarget -target_name="POOL NAME" -target_type=oracle_cloud_zone -image_id=FE55AD7AB28974EFE04313B2F00AD4A0

emcli db_software_maintenance

-subscribeTarget -target_name="xxx"

-target_type="yyy"

-image_id=zzz

emcli db_software_maintenance -updateVersionStatus

イメージのバージョンを更新します。

- version_id - バージョンのID。

- status - バージョンのステータス。たとえば、DRAFT、ACTIVE、CURRENTまたはRESTRICTEDです。

例:

emcli db_software_maintenance -updateVersionStatus -version_id=02A635AOD8D904A4E05362F3E40ADFD8 -status=CURRENT

emcli db_software_maintenance

-updateVersionStatus

-version_id="xxx"

-status="CURRENT"

emcli db_software_maintenance -getImageSubscriptions

サブスクライブされたターゲットのリストを返します。

- image_id- イメージの名前。

例:

emcli db_software_maintenance -getImageSubscriptions -image_id="01B5F14FD57D7B89E05313B2F00A739F"

emcli db_software_maintenance

-getImageSubscriptions

-image_id="xxx"

emcli db_software_maintenance -deleteImage

イメージを削除します。

- image_id - 削除するイメージの名前。

- [force] - イメージにサブスクライブされたターゲットがある場合でも強制的に削除します。

例:

emcli db_software_maintenance -deleteImage -image_id="01B5F14FD57D7B89E05313B2F00A739F"

emcli db_software_maintenance

-deleteImage

-image_id="xxxx"

emcli db_software_maintenance -unsubscribeTarget

ターゲットをサブスクライブ解除します。

- target_name - ターゲットの名前。

- target_type - ターゲット・タイプ。

- image_id - イメージの名前。

例:

emcli db_software_maintenance -unsubscribeTarget -target_name="POOL NAME" -target_type=oracle_cloud_zone -image_id=FE55AD7AB28974EFE04313B2F00AD4A0

emcli db_software_maintenance

-unsubscribeTarget

-target_name="xxx"

-target_type=yyyy

-image_id=zzz

emcli db_software_maintenance -searchImage

指定されたフィルタに基づいてイメージを検索します。ワイルドカードには'%'を使用します。

- [name_pattern] - 名前パターンを示します。

- [version_pattern] - バージョン・パターンを示します。

- [description_pattern] - バージョン・パターンを示します。

- [owner] - 所有者名を示します。

- [target_type] - ターゲット・タイプを示します。

- [platform_id] - プラットフォームIDを示します。たとえば、Linux x86_64の場合は226です。

例:

- emcli db_software_maintenance -searchImage -name_pattern="%GI%"

- emcli db_software_maintenance -searchImage -platform_id="226"

emcli db_software_maintenence

-searchImage

-platform_id="xxx"

-[name_pattern= ”name_pattern”]

-[version_pattern= ”version_pattern”]

-[description_pattern= ”description_pattern”]

-[owner= ”owner”]

-[target_type= ”target_type”]

-[platform_id= ”platform_id”]

emcli db_software_maintenance -getTargetSubscriptions

指定されたターゲットのサブスクリプションのリストを返します。

- target_name - ターゲットの名前。

- target_type - ターゲット・タイプ。

- image_type - イメージのタイプ。

例:

emcli db_software_maintenance -getTargetSubscriptions -target_name="POOL NAME" -target_type="oracle_cloud_zone"

emcli db_software_maintenance

-getTargetSubscriptions

-target_name="xxxx"

-target_type="yyyy"

-image_type="zzzz"

emcli db_software_maintenance -getVersions

指定されたイメージのバージョンのリストを返します。

- image_id - イメージの名前。

- [version_status] - バージョンのステータス・フィルタ。

例:

emcli db_software_maintenance -getVersions image_id="01B5F14FD57D7B89E05313B2F00A739F" -version_status=CURRENT

emcli db_software_maintenance

-getVersions

-image_id="xxxx"

-version_status=CURRENT

emcli db_software_maintenance -getImages

システムに存在するイメージのリストを返します。

例:

emcli db_software_maintenance -getImages

emcli db_software_maintenence - getImages

emcli db_software_maintenance -getSubscriptionsForContainer

データベース・プールなどのコンテナ・ターゲットのサブスクリプションを返します。

- image_id - イメージの名前。

- target_name - ターゲットの名前。

- target_type - EM内のターゲット・タイプ。

例:

emcli db_software_maintenance -getSubscriptionsForContainer -target_name="POOL NAME" -target_type=oracle_cloud_zone -image_id=FE55AD7AB28974EFE04313B2F00AD4A0

emcli db_software_maintenance

-getSubscriptionsForContainer

-target_name="xxxx"

-target_type="yyyy"

-image_id="zzzz"

emcli db_software_maintenance -activateSoftware

プールの新規ソフトウェアをアクティブにします。

- pool_name - プールの名前。

- pool_type - プールのタイプ。

- [force] - 新規メンバーを強制的にアクティブにします。

例:

emcli db_cloud_maintenance -activateSoftware -pool_name=POOL -pool_type=oracle_cloud_zone -force=true

emcli db_cloud_maintenance

-activateSoftware

-pool_name=xxxx

-pool_type="yyy"

-force="true"

emcli db_software_maintenance -performOperation

新規クラウド・メンテナンス操作を作成します。

- name= ”name” - 操作の名前。

- description= ”description” - 操作の説明。

- purpose= ”purpose” - メンテナンス・ウィンドウの目的。
指定できる値は、UPDATE_DB、UPDATE_RACDB、UPDATE_GI、DEPLOY_DB_SOFTWARE、DEPLOY_GI_SOFTWARE、DEPLOY_RAC_SOFTWARE、ROLLBACK_DB、ROLLBACK_GI、ROLLBACK_RACDBおよびCLEANUP_SOFTWAREです。

- [start_schedule= ”start_schedule”] - スケジュールを開始します。start_scheduleの入力は、yyyy-MM-dd HH:mm:ssの形式です。たとえば、start_schedule="2013-11-11 12:15:30"などです。デフォルトの開始時刻はimmediateです。

- pool_name= ”pool_name” - プールの名前。

- pool_type= ”pool_type” - プールのタイプ。

- [input_file= ”data:input_file”] - メンテナンス・アクションの入力データ。たとえば、input_file="data:~/input_files/dataなどです。

- [target_type= ”target_type”] - ターゲット・タイプ。デフォルト・ターゲット・タイプは目的に基づいて識別されます。たとえば、目的がDEPLOY_DBの場合、デフォルト・ターゲット・タイプはoracle_homeです。

- [target_list= ”target_list”] - カンマ区切りのターゲット・リスト。
ターゲット・リストは、選択されているターゲット・タイプに基づくエンティティのリストです。たとえば、target_type=rac_database target_list="rac1.example.com,rac2.example.com"などです。デフォルトのtarget_listはpurposeに基づきます。たとえば、purposeがDEPLOY_DBの場合、デフォルト・ターゲット・リストはプールに存在するOracleホームのリストです。

例:

emcli db_cloud_maintenance -performOperation -name="Update RAC Database " -description="Update RAC database Instance" -purpose="UPDATE_RACDB" -start_schedule="start_time:2014/09/01 00:00" -pool_name="POOL NAME" -pool_type=oracle_cloud_zone -target_type=rac_database -target_list="rac1.example.com"

emcli db_cloud_maintenance

-performOperation

-name="update"

-description="Update RAC database Instance"

-purpose="UPDATE_RACDB"

-start_schedule="start_time:2014/09/01 00:00"

-pool_name="xxx"

-pool_type="yyy"

-target_type=rac_database

-target_list="rac1.example.com"

47.13 データベース・リクエスト処理EM CLI動詞

次の表に、データベースのリクエスト処理でサポートされる動詞を示します。

表47-23 強制クリーンアップEM CLI動詞

動詞

説明

形式

cleanup_dbaas_requests

失敗したリクエストをホストおよびEMからクリーンアップします。

プールの失敗したすべてのリクエストのクリーンアップ。オプションで、特定のユーザーの失敗したリクエストをクリーンアップします。

オプション-idsおよび-pool_nameは一緒に使用できません。

- ids - セミコロン(;)で区切られた、クラウド・リクエストのフィルタリングに使用するリクエストID。

- pool_name - リクエストをクリーンアップする必要のあるプールの名前。

- pool_type - プールのタイプ。有効な値は、次のとおりです。

- データベース・プールの場合: database

- スキーマ・プールの場合: schema

- プラガブル・データベース・プールの場合: pluggable_database

- user - リクエスト削除のフィルタリングで使用するユーザー名。

- all - (成功および失敗した)すべてのリクエストがクリーンアップされ、スケジュール済状態のリクエストは取り消され、進行中のリクエストは現状維持されます。このオプションを指定しない場合、失敗したリクエストのみクリーンアップされます。

注意:

ここで説明するクリーンアップ操作は、REST APIを使用しても実行できます。詳細は、第51.7.2.4項「サービス・リクエストのコレクションのクリア」を参照してください。

例:

emcli cleanup_dbaas_requests -ids="10"
emcli cleanup_dbaas_requests -ids="10;11;12"
emcli cleanup_dbaas_requests -pool_name="database_pool" -pool_type="database"
emcli cleanup_dbaas_requests -pool_name="database_pool" -pool_type="database" –all
emcli cleanup_dbaas_requests -pool_name="database_pool" -pool_type="database" -all -user="SSA_USER"

出力例:

Service Template "My Schema Service Template" created successfully

emcli cleanup_dbaas_requests

[-ids="<リクエストid>"]

[-pool_name="<プール名>" ]

[-pool_type="<database|schema|pluggable _database>"]

[-user="<SSAユーザー名>"]

[-all]

47.14 プラガブル・データベースのクローニング

EM CLI動詞のemcli pdb_clone_managementは、既存のプラガブル・データベースの新しいクローンを作成します。

動詞の詳細は次のとおりです。

表47-24 プラガブル・データベース・クローニングEM CLI動詞

動詞

説明

形式

emcli pdb_clone_management

既存のプラガブル・データベースの新しいクローンを作成します。

- -input_file - プラガブル・データベースのクローニングに必要なプロパティを含むファイルの場所。詳細は、表47-25を参照してください。

- [-cloneToOracleCloud] - 宛先コンテナ・データベース(CDB)がOracle Cloud上に存在することを示します。

例:

emcli pdb_clone_management -input_file=data:/u01/files/pdb_clone.props

emcli pdb_clone_management

-input_file

[-cloneToOracleCloud]

次の表で、プラガブル・データベースをクローニングするために入力ファイルとして使用する必要のあるプロパティ・ファイルの必須パラメータおよび値について説明します。プラガブル・データベースのフル・クローンまたはスナップショット・クローンを保持できます。フル・クローンとスナップショット・クローンの詳細は、第47.14.1項「プラガブル・データベースのフル・クローンの方法」と第47.14.2項「プラガブル・データベースのスナップショット・クローンのタイプ」を参照してください。

表47-25 プラガブル・データベースをクローニングするためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

SRC_PDB_TARGET

SRC_PDB_TARGET=cdb_prod_PDB

ソース・プラガブル・データベース(PDB)のEnterprise Manager (EM)ターゲット名。

SRC_HOST_CREDS

SRC_HOST_CREDS=NC_HOST_SHYSYSCO

ソース・ターゲット・ホストの名前付き資格証明。

SRC_CDB_CREDS

SRC_CDB_CREDS=NC_DB_SYS:SYSCO

ソースCDBの名前付き資格証明。

SRC_WORK_DIR

SRC_WORK_DIR=/tmp/source

ファイルが一時的に格納されるソース・ホストの作業ディレクトリ。このパラメータを指定しない場合、エージェント作業ディレクトリが使用されます。

DEST_HOST_CREDS

DEST_HOST_CREDS=NC_SLEO_SSH:SYSCO

宛先ターゲット・ホストの名前付き資格証明。宛先ホストがOracle Cloud上に存在する場合、このパラメータの値は、ホストSSH資格証明である必要があります。

DEST_LOCATION

DEST_LOCATION=/scratch/app/cdb_tm/HR_TM_PDB6

新しいPDBがホストされる宛先のデータファイルの場所。

DEST_CDB_TARGET

DEST_CDB_TARGET=cdb_tm

新しいPDBがクローニングされるCDBのEMターゲット名。

DEST_CDB_TYPE

DEST_CDB_TYPE=oracle_database

宛先CDBのEMターゲット・タイプ。

DEST_CDB_CREDS

DEST_CDB_CREDS=NC_DB_SYS:SYSCO

宛先CDBの名前付き資格証明。

DEST_PDB_NAME

DEST_PDB_NAME=HR_TM_PDB6

新しいPDBの名前。

オプション・パラメータ

SRC_CDB_TARGET

SRC_CDB_TARGET=cdb_prodt_DB

ソースPDBを含むCDBのEMターゲット名。

SRC_CDB_TYPE

ソースPDBを含むCDBのEMターゲット・タイプ。

IS_SNAPSHOT_COPY

IS_SNAPSHOT_COPY=true

クローンがスナップショット・クローンであることを示します。

SRC_HOST

SRC_HOST=xyz.example.com

ソースCDBを含むホストのEMターゲット名。この値を指定しない場合、CDBから導出されます。

DEST_HOST

DEST_HOST=xyz.example.com

宛先CDBを含むホストのEMターゲット名。この値を指定しない場合、CDBから導出されます。

EXISTING_BACKUP

EXISTING_BACKUP=/user1/pdbbackup/app/PROD_PDB_Backup_14297779

ファイル・システム内での既存のバックアップの絶対位置と、新しいPDBのクローニングにそれを使用するかどうかを示します。

EXISTING_BACKUP_METADATA

EXISTING_BACKUP_METADATA=/user1/pdbbackup

バックアップのメタデータ・テンプレートの絶対位置。EXISTING_BACKUPが指定されている場合、このパラメータは必須です。

BACKUP_TYPE

BACKUP_TYPE=OSIMAGE

バックアップ・タイプを示します。使用できる値は、TAR、OSIMAGEおよびRMANです。

既存のバックアップ(EXISTING_BACKUPパラメータ)が指定されている場合、このパラメータは、バックアップのタイプを表します。それ以外の場合、このパラメータは、ジョブ実行時に取得する必要があるバックアップのタイプを表します。EXISTING_BACKUPとBACKUP_TYPEの両方が指定されていない場合、ソースPDBは切断され、新しいクローンを作成するために宛先にコピーされます。データファイルがコピーされると、ソースPDBは再度接続されます。

47.14.1 プラガブル・データベースのフル・クローンの方法

次に、プラガブル・データベースで使用可能なフル・クローンの様々な方法について説明します。これらを実行するプロセスでは、プロパティ・ファイルで特定のパラメータを構成し、同時にemcli pdb_clone_management動詞を使用します。

- オペレーティング・システム(OS)・イメージ・バックアップ(Oracle Cloudでのみサポート対象)
ソースPDBのバックアップを取得して新しいPDBを作成します。BACKUP_TYPEパラメータで、バックアップのタイプを指定する必要があります。EXISTING_BACKUPおよびEXISTING_BACKUP_METADATAパラメータは指定できません。

- 既存のバックアップ(社内PDBおよびOracle Cloud PDBでサポート対象)
ソースPDBの既存のバックアップを使用して新しいPDBを作成します。BACKUP_TYPEパラメータで、バックアップのタイプを指定する必要があります。EXISTING_BACKUPで場所とバックアップ名を指定し、EXISTING_BACKUP_METADATAでバックアップの場所とメタデータ・ファイル名を指定する必要があります。

注意:
宛先PDBとソースPDBが異なるCDBに存在し、どちらのCDBも社内(またはOracle Cloud上)に存在する場合、ソースPDBが読取り/書込みモードであることを確認してください。これが必要な理由は、PDBのクローニングのためにデータベース・リンクが宛先CDBで作成され、データベース・リンクの使用のために一時ユーザーがソースPDBで作成されるためです。ソースPDBに接続する既存のデータベース・リンクが宛先CDBに存在する場合、パラメータEXISTING_DB_LINK_NAMEを使用してプロパティ・ファイルでデータベース・リンク名を指定します。

- 切断/プラグ(Oracle Cloudでのみサポート対象)
ソースPDBを切断し、切断したソースを使用して宛先に新しいPDBを作成し、ソースを再度プラグします。EXISTING_BACKUPおよびBACKUP_TYPEパラメータは、両方とも指定できません。

47.14.2 プラガブル・データベースのスナップショット・クローンのタイプ

次に、社内プラガブル・データベースで使用可能なスナップショット・クローンの様々な方法について説明します。これらを実行するプロセスでは、プロパティ・ファイルで特定のパラメータを構成し、同時にemcli pdb_clone_management動詞を使用します。

注意:
すべてのスナップショット・クローン・タイプで、表47-25の必須パラメータに加え、パラメータIS_SNAPSHOT_COPY=trueをプロパティ・ファイルに追加します。

- Exadata疎クローン・スナップショット
Exadata疎クローン・スナップショットが機能するのは、宛先PDBデータファイルの場所がExadataマシンのASM疎ディスク・グループで、ソースおよび宛先PDBデータファイルが同じASMインスタンスを共有している場合のみです。

DEST_LOCATIONの値を設定し、Exadata疎クローンを作成します。DEST_LOCATIONは、ASMスパース・ディスク・グループの名前にしてください。たとえば、+SPARCEDGです。

- ACFS (ASMクラスタ・ファイル・システム)スナップショット
ACFSスナップショットが機能するのは、ソースおよび宛先PDBデータファイルの場所が共通のACFSファイル・システムである場合のみです。

- CLONEDB初期化パラメータをFALSEに設定
ソースPDBのスナップショット・クローンを作成し、宛先ホストのCLONEDB初期化パラメータをFALSEに設定する場合、ソースPDBファイルの基礎となるファイル・システムは、ストレージ・スナップショットをサポートしている必要があります。そのようなファイル・システムとして、Oracle Automatic Storage Management Cluster File System (Oracle ACFS)およびDirect NFS Client記憶域などがあります。

- CLONEDB初期化パラメータをTRUEに設定
ソースPDBのクローンを作成し、宛先ホストのCLONEDB初期化パラメータをTRUEに設定する場合、ソースPDBファイルの基礎となるファイル・システムは、ローカル・ファイル・システム、ネットワーク・ファイル・システム(NFS)、またはDirect NFSが有効になっているクラスタ・ファイル・システムのいずれでもかまいません。ただし、クローンが存在するかぎり、ソースPDBは読取り専用オープン・モードのままである必要があります。

47.15 テスト・マスター・プラガブル・データベースの作成

EM CLI動詞のemcli pdb_clone_managementは、既存のプラガブル・データベースの新しいクローンを作成します。同じ動詞を使用して、プラガブル・データベースのテスト・マスターを作成します。ただし、動詞で使用するプロパティ・ファイルは異なります。動詞の詳細は、表47-24を参照してください。テスト・マスターの作成に使用するプロパティ・ファイルの詳細は、表47-26を参照してください。

表47-26 プラガブル・データベースのテスト・マスターを作成するためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

テスト・マスターを作成するための必須パラメータ

SRC_PDB_TARGET

SRC_PDB_TARGET=cdb_prod_PDB

ソース・プラガブル・データベース(PDB)のEnterprise Manager (EM)ターゲット名。

SRC_HOST_CREDS

SRC_HOST_CREDS=NC_HOST_SAY:SYSCO

ソース・ターゲット・ホストの名前付き資格証明。

SRC_CDB_CREDS

SRC_CDB_CREDS=NC_DB_SYS:SYSCO

ソースCDBの名前付き資格証明。

SRC_WORK_DIR

SRC_WORK_DIR=/tmp/source

ファイルが一時的に格納されるソース・ホストの作業ディレクトリ。このパラメータを指定しない場合、エージェント作業ディレクトリが使用されます。

DEST_HOST_CREDS

DEST_HOST_CREDS=NC_SLO_SSH:SYSCO

宛先ターゲット・ホストの名前付き資格証明。宛先ホストがOracle Cloud上に存在する場合、このパラメータの値は、ホストSSH資格証明である必要があります。

DEST_LOCATION

DEST_LOCATION=/scratch/app/cdb_tm/HR_TM_PDB6

新しいPDBがホストされる宛先のデータファイルの場所。

DEST_CDB_TARGET

DEST_CDB_TARGET=cdb_tm

新しいPDBがクローニングされるCDBのEMターゲット名。

DEST_CDB_TYPE

DEST_CDB_TYPE=oracle_database

宛先CDBのEMターゲット・タイプ。

DEST_CDB_CREDS

DEST_CDB_CREDS=NC_DB_SYS:SYSCO

宛先CDBの名前付き資格証明。

DEST_PDB_NAME

DEST_PDB_NAME=HR_TM_PDB6

新しいPDBの名前。

IS_CREATE_AS_TESTMASTER

IS_CREATE_AS_TESTMASTER=true

EMでテスト・マスターPDBとしてクローンPDBを設定するフラグ。

Exadata ASMにテスト・マスターを作成するための必須パラメータ(前述のパラメータとともに使用)

ACL_DF_GROUP

ACL_DF_GROUP=oinstall

クローンPDBのExadata ASMディスク・グループのデータ・ファイルに対する権限を付与するグループ名。

ACL_DF_OWNER

ACL_DF_OWNER=oracle

クローンPDBのExadata ASMディスク・グループのデータ・ファイルに対する必要な権限を付与する所有者名。

オプション・パラメータ

MASKING_DEFINITION_NAME

MASKING_DEFINITION_NAME=CRM_Masking_Defn

クローンPDBに適用されるEM内のマスキング定義の名前。

CUSTOM_PRE_SCRIPTS_URN

CUSTOM_PRE_SCRIPTS_URN=oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:14288BACD7BB765FE0533B79B10AA480:0.3

宛先ホストでクローンPDBを作成する前に実行するスクリプトのソフトウェア・ライブラリURN。

CUSTOM_POST_SCRIPTS_URN

CUSTOM_POST_SCRIPTS_URN=oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:14288BACD7C1765FE0533B79B10AA480:0.3

宛先ホストでクローンPDBを作成した後に実行するスクリプトのソフトウェア・ライブラリURN。

POST_SQL_SCRIPT_URN

POST_SQL_SCRIPT_URN=oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_Generic:142899134B2C25E8E0533B79B10A2D54:0.1

クローンPDBを作成した後に宛先CDBで実行するSQLスクリプトのソフトウェア・ライブラリURN。

RUN_AS_USER

RUN_AS_USER=sys

SQL後スクリプトを実行するためのユーザー名。

RUN_AS_USER_PWD

RUN_AS_USER_PWD=gosad

SQL後スクリプトを実行するためのパスワード。

ACL_DF_GROUP_PERM

ACL_DF_GROUP_PERM=read only

クローンPDBのExadata ASMディスク・グループのデータ・ファイルについてグループに付与する権限のレベル。

ACL_DF_OWNER_PERM

ACL_DF_OWNER_PERM=read only

クローンPDBのExadata ASMディスク・グループのデータ・ファイルについて所有者に付与する権限のレベル。

ACL_DF_OTHER_PERM

ACL_DF_OTHER_PERM=read only

クローンPDBのExadata ASMディスク・グループのデータ・ファイルについて他のユーザーに付与する権限のレベル。

SRC_CDB_TARGET

SRC_CDB_TARGET=cdb_prodt_DB

ソースPDBを含むCDBのEMターゲット名。

SRC_CDB_TYPE

ソースPDBを含むCDBのEMターゲット・タイプ。

SRC_HOST

SRC_HOST=xyz.example.com

ソースCDBを含むホストのEMターゲット名。この値を指定しない場合、CDBから導出されます。

DEST_HOST

DEST_HOST=xyz.example.com

宛先CDBを含むホストのEMターゲット名。この値を指定しない場合、CDBから導出されます。

EXISTING_BACKUP

EXISTING_BACKUP=/user1/pdbbackup/app/PROD_PDB_Backup_14297779

ファイル・システム内での既存のバックアップの絶対位置と、新しいPDBのクローニングにそれを使用するかどうかを示します。

EXISTING_BACKUP_METADATA

EXISTING_BACKUP_METADATA=/user1/pdbbackup

バックアップのメタデータ・テンプレートの絶対位置。EXISTING_BACKUPが指定されている場合、このパラメータは必須です。

BACKUP_TYPE

BACKUP_TYPE=OSIMAGE

バックアップ・タイプを示します。使用できる値は、TAR、OSIMAGEおよびRMANです。

既存のバックアップ(EXISTING_BACKUPパラメータ)が指定されている場合、このパラメータは、バックアップのタイプを表します。それ以外の場合、このパラメータは、ジョブ実行時に取得する必要があるバックアップのタイプを表します。EXISTING_BACKUPとBACKUP_TYPEの両方が指定されていない場合、ソースPDBは切断され、新しいクローンを作成するために宛先にコピーされます。データファイルがコピーされると、ソースPDBは再度接続されます。

47.16 データベース間でのデータの転送

データの転送に使用するEM CLI動詞の詳細は、次のとおりです。

表47-27 データ転送EM CLI動詞

動詞

説明

形式

emcli data_transfer

ソース・データベースからターゲット・データベースにデータを転送します。

- -input_file - データの転送に必要なプロパティを含むファイルの場所。詳細は、表47-28を参照してください。

例:

emcli data_transfer -input_file=data:/u01/files/data_transfer.props

emcli data_transfer

-input_file

次の表で、データを転送するために入力ファイルとして使用する必要のあるプロパティ・ファイルの必須パラメータおよび値について説明します。

表47-28 データを転送するためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

SOURCE_LOCATION

SOURCE_LOCATION=/tmp/newp/PDB_Backup_1428003803938

ソース・ホストのデータの場所。

SRC_HOST

SRC_HOST=bl.example.com

データを含むソース・ホスト。

SRC_HOST_CREDS

SRC_HOST_CREDS=NC_HOST_SHY:SYS

データがあるホストの資格証明。ソース・ホストがOracle Cloud上に存在する場合、この値は、ホストSSH資格証明である必要があります。

DEST_HOST

DEST_HOST=slc0.example.com

データをコピーする宛先ホスト。

DEST_HOST_CREDS

DEST_HOST_CREDS=NC_SLO_SSH

データをコピーするホストの資格証明。宛先ホストがOracle Cloud上に存在する場合、この値は、ホストSSH資格証明である必要があります。

DEST_LOCATION

DEST_LOCATION=/scratch/app3/oradata/migda

データをコピーする宛先ホストの場所。

47.17 プラガブル・データベースのデータファイルおよびメタデータのバックアップ

プラガブル・データベースのデータファイルおよびメタデータのバックアップに使用するEM CLI動詞の詳細は、次のとおりです。

表47-29 プラガブル・データベースのデータファイルおよびメタデータのバックアップのためのEM CLI動詞

動詞

説明

形式

emcli pdb_backup

指定されたプラガブル・データベースのデータファイルおよびメタデータのXMLのバックアップを取得します。

- -input_file - PDBのバックアップの取得に必要なプロパティを含むファイルの場所。詳細は、表47-30を参照してください。

例:

emcli pdb_backup -input_file=data:/u01/files/pdb_backup.props

emcli pdb_backup

-input_file

次の表で、プラガブル・データベースのデータファイルおよびメタデータのバックアップのために、入力ファイルとして使用する必要のあるプロパティ・ファイルの必須パラメータおよび値について説明します。

表47-30 プラガブル・データベースのデータファイルおよびメタデータのバックアップのためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

TARGET_HOST_LIST

TARGET_HOST_LIST=xyz.abccorp.com

ターゲット・コンテナ・データベース(CDB)/プラガブル・データベース(PDB)がホストされるホスト。

HOST_NORMAL_NAMED_CRED

HOST_NORMAL_NAMED_CRED=XYZ_CRED:CRED_OWNER

ホスト資格証明。

SRC_CDB_NAMED_CRED

SRC_CDB_NAMED_CRED=CDB1_CRED:CRED_OWNER

ソースCDBのSYSDBA資格証明。

SRC_CDB_TARGET_NAME

SRC_CDB_TARGET_NAME=CDB1

PDBをホストするCDBのターゲット名。

SRC_CDB_TARGET_TYPE

SRC_CDB_TARGET_TYPE=oracle_database

CDBターゲット・タイプ。

SRC_PDB_TARGET_NAME

SRC_PDB_TARGET_NAME=CDB1_PDB1

バックアップが必要なPDBのターゲット名。

BACKUP_LOCATION

BACKUP_LOCATION=/scratch/pdbBackup

バックアップがコピーされるファイル・システムのパス。

WORK_DIR_LOCATION

WORK_DIR_LOCATION=/tmp

ソース・ホストの一時ステージングの場所。

ORACLE_HOME_LOC

ORACLE_HOME_LOC=/scratch/d121hmcasm/product/12.1.0/dbhome_1

CDBのOracleホーム。

47.18 エクスポート・ダンプからデータベースへのデータのインポート

エクスポート・ダンプからデータベースへのデータのインポートに使用するEM CLI動詞の詳細は、次のとおりです。

表47-31 エクスポート・ダンプからデータベースへのデータのインポートのためのEM CLI動詞

動詞

説明

形式

emcli dbimport

エクスポート・ダンプから指定されたデータベース・ターゲットにデータをインポートします。

- -input_file - エクスポート・ダンプからのデータのインポートに必要なプロパティを含むファイルの場所。詳細は、表47-32を参照してください。

例:

emcli dbimport -inputFile=data:/u01/files/dbimport.props

emcli dbimport

-input_file

次の表で、エクスポート・ダンプからデータベースへのデータのインポートのために、入力ファイルとして使用する必要のあるプロパティ・ファイルの必須パラメータおよび値について説明します。

表47-32 エクスポート・ダンプからデータベースにデータをインポートするためのサンプル・プロパティ・ファイル

パラメータ

サンプル値

説明

必須パラメータ

DESTINATION_TARGET

DESTINATION_TARGET=SS_OPC_DB

スキーマがインポートされる宛先PDBターゲット(またはDBターゲット)。

DESTINATION_TARGET_TYPE

DESTINATION_TARGET_TYPE=oracle_database

宛先ターゲット・タイプ。

DATABASE_CREDENTIAL

DATABASE_CREDENTIAL=SYSDBA:SYS

ターゲットのSYSDBA資格証明。

HOST_NAMED_CREDENTIAL

HOST_NAMED_CREDENTIAL=AE_NC:SYS

宛先ターゲットがホストされるホストの資格証明。

PROFILE_LOCATION

PROFILE_LOCATION=Database Provisioning Profiles/12.1.0.1.0/linux_x64/Export Dump of Sample schemas10

エクスポート中に作成されるプロファイルの場所。

REMAP_SCHEMA_LIST.(x)

REMAP_SCHEMA_LIST.0=HR:HR

REMAP_SCHEMA_LIST.1=OE:OE

REMAP_SCHEMA_LIST.2=PM:PM

REMAP_SCHEMA_LIST.3=IX:IX

REMAP_SCHEMA_LIST.4=SH:SH

REMAP_SCHEMA_LIST.5=BI:BI

インポートする必要のあるスキーマのリスト。

REMAP_TABLESPACE_LIST.(x)

REMAP_TABLESPACE_LIST.0=EXAMPLE:MYTBSP1

REMAP_TABLESPACE_LIST.1=USERS:MYTBSP1

REMAP_TABLESPACE_LIST.2=SYSTEM:MYTBSP1

スキーマ・インポート用のスキーマの対応する表領域。

DEGREE_OF_PARALLELISM

DEGREE_OF_PARALLELISM=1

データをパラレルにインポートする必要があるかどうかを示します。

DUMP_FILE_LIST.(x)

DUMP_FILE_LIST.0=/scratch/aime/dumpdir/samplschemas.dmp

宛先ホストのダンプ・ファイルの場所。

IMPORT_LOG_FILE_DIRECTORY

IMPORT_LOG_FILE_DIRECTORY=DATA_PUMP_DIR

ログ・ファイルが格納される場所。これは、データベース内のディレクトリ・オブジェクトです。

FORWARDER_HOST

FORWARDER_HOST=slo.us.example.com

フォワーダ・ホストを示します。

FORWARDER_CRED

FORWARDER_CRED=AIME_NC:SYSMAN

フォワーダ・ホスト資格証明を示します。

WORKING_DIRECTORY

WORKING_DIRECTORY=/tmp

ソース・ホストの一時ステージングの場所。

47.19 EM CLI動詞を使用したREST APIの起動

emcli invoke_wsは、REST APIを起動してREST APIで可能なアクションを実行するために使用されるEM CLI動詞です。ただし、Enterprise Managerコマンドライン・インタフェースを通じて使用します。

表47-33 EM CLI動詞を使用したREST APIの起動

動詞

説明

形式

emcli invoke_ws

この動詞を通じて渡されるREST APIに従って動作するEnterprise Manager Webサービスを起動します。

オプション:

- -wsname - リソースのURIを示します。

- -method - RESTメソッドの指定。

- -payload - json/xml入力ペイロードを示します。

- -accept - ペイロード・タイプ。これらは標準のREST API値です。

- -type - 標準のREST APIレスポンス・タイプ。

- -param - このオプションは、フォーム/問合せパラメータ値を渡すために使用されます。たとえば、-param="name:value"などです。複数のパラメータを指定できます。たとえば、-param="name:value" -param="zip:12345"などです。
パラメータはファイルを通じて提供できます。たとえば、file.txtという名前のテキスト・ファイルにパラメータを指定し、コマンドのオプションとして-param="name:tag" -input_file="tag:file.txt"を指定すると、パラメータnameによって入力ファイルfile.txtから値が導出されます。

- -input_file - このオプションを使用して、payloadまたはparam値をファイルで渡します。

例:

- emcli invoke_ws -wsname=/em/websvcs/restful/emws/core/v0/list/dataservice -method=get -param="name:Administrators"
リスト・リソースを呼び出してすべての管理者を取得します。

- emcli invoke_ws -wsname=/em/websvcs/restful/emws/core/v0/list/dataservice -method=get -param="name:tag" -input_file="tag:file.txt"
リスト・リソースを呼び出してすべての管理者を取得します。nameパラメータはfile.txtから読み取られます。

emcli invoke_ws

-wsname=<WebService Name>

-method=<method name>

[-payload=<Payload>]

[-accept=<accept type>

[-type=response type]

[-param=Query Parameters]

[-input_file=<Input File for payload data>]

file.txtの内容のサンプルは、次のとおりです。

Name:Administrators
Zip:23456

48 Database as a Service管理者REST API

この章では、Database as a Service (DBaaS) REST APIの管理者フローのリソース・モデルとそのレスポンスについて説明します。この章の内容は次のとおりです。

- Database as a Service管理者REST APIのサマリー

- REST APIを使用した新しいDBaaSクラウド設定の作成

- Database as a Service管理者操作REST API

- PaaSゾーン群REST APIおよびPaaSゾーンREST API

- ソフトウェア・プール群REST APIおよびソフトウェア・プールREST API

- データベース・リクエスト設定REST API

- データベース割当て制限REST API

- サービス・テンプレートREST API

48.1 Database as a Service管理者REST APIのサマリー

次の表に、この章で説明するすべてのDBaaS管理者REST APIをまとめています。

表48-1 管理者DBaaS REST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

PaaSゾーン

表48-3

第48.3.1.3.1項

第48.3.1.3.3項

第48.3.1.3.4項

サポート対象外

PaaSゾーン

表48-5

第48.3.1.3.2項

サポート対象外

サポート対象外

第48.3.1.3.5項

ソフトウェア・プール群

表48-12

第48.3.2.3.1項

- データベース・プール - 第48.3.2.3.4項

- スキーマ・プール - 第48.3.2.3.6項;

- プラガブル・データベース・プール - 第48.3.2.3.8項

- データベース・プール - 第48.3.2.3.5項

- スキーマ・プール - 第48.3.2.3.7項

- プラガブル・データベース・プール - 第48.3.2.3.9項

サポート対象外

ソフトウェア・プール

表48-14

- 第48.3.2.3.2項

- 第48.3.2.3.3項

サポート対象外

サポート対象外

第48.3.2.3.10項

DBaaSリクエスト設定

表48-26

第48.3.3.4.1項

第48.3.3.4.2項

サポート対象外

サポート対象外

DBaaS割当て制限

表48-30

第48.3.4.4.1項

第48.3.4.4.2項

第48.3.4.4.3項

第48.3.4.4.4項

サービス・テンプレート群

表48-36

第48.3.5.3.1項

第48.3.5.3項

サポート対象外

サポート対象外

サービス・テンプレート

表 48-38

第48.3.5.3.2項

サポート対象外

サポート対象

第48.3.5.3.17項

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

48.2 REST APIを使用した新しいDBaaSクラウド設定の作成

クラウド管理者は、DBaaS用のクラウド・インフラストラクチャの設定を行います。次の図にDBaaSクラウド設定の手順を示します。

図48-1 新規DBaaSクラウド・リソースの作成

例として、REST APIおよびEM CLI動詞(必要な場合)を使用してDBaaSを作成する段階的なプロセスを表48-2に示します。

注意:
次のプロセスでは、可能なかぎり、REST APIに対する参照を示します。ただし、EM CLI動詞を使用して同じ操作を行うことができます。対応するEM CLI動詞を確認するには、第10章「Database as a Service管理者用のEM CLI動詞」を参照してください。

表48-2 REST APIを使用したDBaaSの作成

手順

操作

1

PaaSインフラストラクチャ・ゾーンを作成します。

第48.3.1.3.3項「PaaSゾーンの作成」を参照してください。

注意: 既存のPaaSゾーンを表示するには、GET操作を行います。第48.3.1.3.1項「PaaSゾーン・リソースの詳細の表示」を参照してください。

2

次のデータベース・プールのいずれかを作成します。

- データベース・プール - 第48.3.2.3.4項「データベース・プールの作成」を参照してください。

- スキーマ・プール - 第48.3.2.3.6項「スキーマ・プールの作成」を参照してください。

- プラガブル・データベース・プール - 第48.3.2.3.8項「プラガブル・データベース・プールの作成」を参照してください。

注意: 既存のデータベース・プールを表示するには、GET操作を行います。第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」を参照してください。

3

ユーザー・ロール用のDBaaSリクエスト設定を作成します。第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照してください。

4

ユーザー・ロール用の割当て制限を作成します。第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照してください。

注意: この手順はオプションです。

5

プロビジョニング用のソース・データベース情報を取得するプロファイルを作成します。第47章「Database as a Service管理者用のEM CLI動詞」を参照してください。

プロファイルは、完全なデータベースまたはアプリケーションを形成する一連の関連するスキーマを表すことができます。

6

選択したデータベース・プールに基づいて、次のいずれかのサービス・テンプレートを作成します。

- データベース・プール - 参照先:

- 第48.3.5.3.3項「DBCAベースのデータベース用のサービス・テンプレートの作成」

- 第48.3.5.3.4項「RMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成」

- 第48.3.5.3.5項「単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成」

- 第48.3.5.3.6項「RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成」

- 第48.3.5.3.7項「スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成」

- 第48.3.5.3.8項「スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの作成」

- 第48.3.5.3.10項「DNFSベースのデータベース用のサービス・テンプレートの作成」

- スキーマ・プール - 第48.3.5.3.13項「スキーマ用のサービス・テンプレートの作成」を参照してください

- プラガブル・データベース・プール - 第48.3.5.3.14項「「プラガブル・データベース用のサービス・テンプレートの作成」を参照してください

これでDBaaSクラウドの設定は管理可能状態になりました。

48.3 Database as a Service管理者操作REST API

この項では、クラウド管理者フロー用のすべてのREST APIについて説明します。この項のREST APIは、次のように分類されています。

- PaaSゾーン群REST APIおよびPaaSゾーンREST API

- ソフトウェア・プール群REST APIおよびソフトウェア・プールREST API

- データベース・リクエスト設定REST API

- データベース割当て制限REST API

- サービス・テンプレートREST API

48.3.1 PaaSゾーン群REST APIおよびPaaSゾーンREST API

この項のREST APIは、PaaSゾーン群REST APIとPaaSゾーンREST APIに分類されます。PaaSゾーンはPaaSインフラストラクチャ・ゾーンを意味しており、一方、PaaSゾーン群は、すべてのアクセス可能な個々のPaaSゾーン・リソースのグループに対するクラウド管理者のビューを意味するコレクション・リソースとなります。

この項の内容は次のとおりです。

- PaaSゾーン群REST API

- PaaSゾーンREST API

- PaaSゾーン群REST APIおよびPaaSゾーンREST APIの例

48.3.1.1 PaaSゾーン群REST API

PaaSゾーン群は、個々のPaaSゾーン・リソースすべてを集合的に表現したものです。PaaSゾーン群のメディア・タイプはapplication/oracle.com.cloud.common.PaaSZones+jsonです。

次の表に、PaaSゾーン群のデータ・モデルを示します。

表48-3 PaaSゾーン群のデータ・モデル

フィールド

タイプ

説明

発生

Name

文字列

このコレクション・リソースの名称が表示されます。

1

タイプ

文字列

このコレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

Count

整数

返される要素の数。

1

Items

コレクション<PaaSZone>

PaaSゾーン・リソースのリストインスタンスが存在しない場合、アイテムは存在しますが空です。

1

totalCount

整数

PaaSゾーン・リソースの総数

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

48.3.1.1.1 PaaSゾーン群に対してサポートされるリクエスト・メソッド

次の表に、PaaSゾーン群リソースでサポートされるすべての操作を示します。

表48-4 PaaSゾーン群に対してサポートされるリクエスト・メソッド

GET

POST

PUT

DELETE

はい

はい

はい

いいえ

48.3.1.2 PaaSゾーンREST API

このリソースは、PaaSインフラストラクチャ・ゾーンを表します。PaaSゾーンのメディア・タイプはapplication/oracle.com.cloud.common.PaaSZone+jsonです。

次の表に、PaaSゾーンのデータ・モデルを示します。

表48-5 PaaSゾーンのデータ・モデル

フィールド

Name

説明

発生

Name

文字列

PaaSゾーンのユーザー用の名前。このフィールドは編集できません。

1

displayName

文字列

PaaSゾーンの名前を表示します。

0..1

guid

文字列

リソースを識別するPaaSゾーンの一意のGUID。

1

description

文字列

PaaSゾーンの簡単な説明。

0..1

targetType

文字列

作成するPaaSゾーンのターゲット・タイプ。

1

メンバー

コレクション<members>

PaaSゾーンのメンバー。これらは、あらかじめEMターゲットとして追加する必要があります。

1

credentials

コレクション<PaaSzone_Credential>

PaaSゾーンに関連付けられた資格証明。

1

placementConstraints

コレクション<EntityValueHolder>

クラウド管理者がリソース使用率の上限を設定できるようにする、PaaSゾーンの配置制約。

0..1

characteristics

コレクション<EntityValueHolder>

PaaSゾーンに関連付けられた特性。

1

canonicalLink

URI

このURIに対してGETを実行すると、PaaSゾーンのクライアント表現がリフレッシュされます。

1

48.3.1.2.1 PaaSゾーンに対してサポートされるリクエスト・メソッド

次の表に、PaaSゾーン・リソースでサポートされるすべての操作を示します。

表48-6 PaaSゾーンに対してサポートされるリクエスト・メソッド

GET

POST

PUT

DELETE

はい

いいえ

いいえ

はい

48.3.1.3 PaaSゾーン群REST APIおよびPaaSゾーンREST APIの例

次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。

- PaaSゾーン群リソースの詳細の表示

- PaaSゾーン・リソースの詳細の表示

- PaaSゾーンの作成

- PaaSゾーンの更新

- PaaSゾーンの削除

48.3.1.3.1 PaaSゾーン群リソースの詳細の表示

問合せパラメータ"type=self_service_zone"を使用してリソース・プロバイダ・リソースに対してGETリクエストを発行すると、そのPaaSゾーン群リソースにすでに存在している個々のPaaSゾーン群すべての詳細が与えられます。

表48-7 PaaSゾーン群リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders?type=self_service_zone

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Resource Providers",
"type": "Resource Provider",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders"
},
"totalResults": 1,
"cfwItems": [
{
"id": "15",
"name": "pzone1",
"type": "self_service_zone",
"guid": "A3CF2D49CFF3F3E664D073303EA51F8E",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/15"
}
},
{
"id": "16",
"name": "Test Zone 2",
"type": "self_service_zone",
"guid": "EF3830C71CC54B50B963376F9217AB95",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/16"
}
},
{
"id": "17",
"name": "test paas zone",
"type": "self_service_zone",
"guid": "5D7548C1B879A51CFD894CEA8D5FB19B",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/17"
}
},
{
"id": "18",
"name": "Test Zone",
"type": "self_service_zone",
"guid": "34405E0876B271E754B1A829BDFD06B9",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/18"
}
}
]
}

48.3.1.3.2 PaaSゾーン・リソースの詳細の表示

PaasZoneリソースに対してGETリクエストを発行して、その詳細を取得できます。PaaSゾーンに対するGETの構成を次に示します。

表48-8 PaaSゾーン群リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "My Test Zone",
"type": "self_service_zone",
"memberTargetType": "host",
"members": [
"example.com"
],
"credentials": [
{ "name": "normal_credential_guid",
"value": "NC_HOST_2015-10-09-095917"}
],
"placementConstraints": [
{"name": "MAX_CPU_UTILIZATION",
"value": [ "80" ] },
{"name": "MAX_MEMORY_ALLOCATION",
"value": [ "80" ]}
],
"memberConstraints": [],
"characteristics": [
{   "name": "ORACLE.SYSMAN.CFW.SELF_SERVICE_ZONE",
"value": [ "34405E0876B271E754B1A829BDFD06B9" ] },
{   "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"value": [] },
{   "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"value": [] },
{   "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"value": [] },
{   "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DOWNTIME_CONTACT",
"value": [] },
{   "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"value": [] },
{   "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"value": [] },
{   "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"value": [] }
],
"canonicalLink": {"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23"}
}

48.3.1.3.3 PaaSゾーンの作成

PaaSゾーンは、PaaSゾーン群コレクション・リソースへのPOSTリクエストにより作成されます。

PaaSゾーン群に対するPOSTの構成を次に示します。

表48-9 PaaSゾーンを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{   "useExistingTarget": false,
"name": "My Test Zone",
"type": "self_service_zone",
"credentials": [
{   "name": "normal_credential_guid",
"value": "MY_ZONE_CREDS0afb3e85-f" }
],
"memberTargetType": "host",
"members": [ "example.com" ],
"placementConstraints": [
{   "name": "MAX_CPU_UTILIZATION",
"value": "90"  }
] }

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "Resource provider with name \"My Test Zone\" and type \"self_service_zone\" created successfully.",
"canonicalLink": {
"href": "https://example.com:44533/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23"
}
}

48.3.1.3.4 PaaSゾーンの更新

ペイロードを含むPUTリクエストにより、既存のPaaSインフラストラクチャ・ゾーンが更新されます。

PaaSゾーン群に対するPUTの構成を次に示します。

表48-10 PaaSゾーンを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{   "memberTargetType": "host",
"credentials": [
{"name": "normal_credential_guid",
"value": "NC_HOST_2015-10-09-095917" }
],
"placementConstraints": [
{"name": "MAX_CPU_UTILIZATION",
"value": [ "92" ] }
] }

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message": "Resource provider with ID \"23\" updated successfully."
}

48.3.1.3.5 PaaSゾーンの削除

PaaSゾーンのURIに対してDELETEリクエストを発行して、PaaSゾーン・インスタンスを削除できます。次に、PaaSゾーンで削除するための構成を示します。

表48-11 PaaSゾーンを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

{
"message": "Resource provider with ID \"23\" deleted successfully."
}

48.3.2 ソフトウェア・プール群REST APIおよびソフトウェア・プールREST API

この項の内容は次のとおりです。

- ソフトウェア・プール群

- ソフトウェア・プール

- ソフトウェア・プールREST APIの例

48.3.2.1 ソフトウェア・プール群

ソフトウェア・プール群とは、アクセス可能な個々のソフトウェア・プール・リソースすべてに対するSSA管理者のビューを表すコレクション・リソースのことです。ソフトウェア・プール群のメディア・タイプはapplication/oracle.com.cloud.commom.SoftwarePools+jsonです。

次の表に、ソフトウェア・プール群のデータ・モデルを示します。

表48-12 ソフトウェア・プール群のデータ・モデル

フィールド

タイプ

説明

発生

Name

文字列

このコレクション・リソースの名称が表示されます。

1

タイプ

文字列

このコレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

Count

整数

返される要素の数。

1

Items

コレクション<PaaSZone>

PaaSゾーン・リソースのリストインスタンスが存在しない場合、アイテムは存在しますが空です。

1

totalCount

整数

PaaSゾーン・リソースの総数

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

48.3.2.1.1 ソフトウェア・プール群に対してサポートされるリクエスト・メソッド

次の表に、ソフトウェア・プール群リソースでサポートされるすべての操作を示します。

表48-13 ソフトウェア・プール群に対してサポートされるリクエスト・メソッド

GET

POST

PUT

DELETE

はい

はい

はい

いいえ

48.3.2.2 ソフトウェア・プール

ソフトウェア・プール・リソースは、PaaSインフラストラクチャ・ゾーン内のリクエストのサービスに使用される同種のサーバーまたはクラスタのコレクションを表します。ソフトウェア・プール内のすべてのメンバーは同じタイプであり、同じPaaSインフラストラクチャ・ゾーンに属している必要があります。ソフトウェア・プールのメディア・タイプはapplication/oracle.com.cloud.common.SoftwarPool+jsonです。

次の表に、ソフトウェア・プールのデータ・モデルを示します。

表48-14 ソフトウェア・プールのデータ・モデル

フィールド

タイプ

説明

発生

Name

文字列

ソフトウェア・プールのユーザー用の名前。

1

ID

文字列

リソースを一意に識別するプールGUID。

1

説明

文字列

ソフトウェア・プールの簡単な説明。

0..1

poolTargetType

文字列

作成するソフトウェア・プールのターゲット・タイプ。例: データベース・プールに対するoracle_cloud_zone、スキーマ・プールに対するschaas_pool、プラガブル・データベース・プールに対するpdbaas_pool。

1

paasZone

文字列

このソフトウェア・プールに関連付けられているPaaSゾーンの名前。

1

メンバー

コレクション<文字列>

PaaSゾーンのメンバー。ホスト・メンバーまたはOracle VMゾーン・メンバーにできます。

1

memberType

文字列

PaaSゾーンのメンバーのターゲット・タイプ。ホスト・メンバーの場合は「host」、Oracle VMゾーン・メンバーの場合は「oracle_vm_zone」にできます。

1

Constraints

コレクション<Entity Value Holder>

ソフトウェア・プールの配置ポリシー制約を使用することにより、セルフ・サービス管理者は、リソース使用率の上限を設定できます。

0..1

フィルタ

コレクション<EntityValueHolder>

設定条件によってソフトウェア・プールへのメンバー・ターゲットの追加を制限する、ソフトウェア・プール上のフィルタ。

1

Properties

コレクション<文字列>

特定のプール・ターゲット・タイプで指定する必要がある追加プロパティ。

1

membersToAdd

コレクション<文字列>

編集時に既存のソフトウェア・プールに追加するターゲット。

0..1

membersToRemove

コレクション<文字列>

編集時に既存のソフトウェア・プールから削除するターゲット。

0..1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

48.3.2.2.1 ソフトウェア・プールに対してサポートされるリクエスト・メソッド

次の表に、ソフトウェア・プールのリソースでサポートされるすべての操作を示します。

表48-15 ソフトウェア・プールに対してサポートされるリクエスト・メソッド

GET

POST

PUT

DELETE

はい

いいえ

いいえ

はい

48.3.2.3 ソフトウェア・プールREST APIの例

次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。

- ソフトウェア・プール群リソースの詳細の表示

- ソフトウェア・プール・リソースの詳細の表示

- ソフトウェア・プール容量の詳細の表示

- データベース・プールの作成

- データベース・プールの更新

- スキーマ・プールの作成

- スキーマ・プールの更新

- プラガブル・データベース・プールの作成

- プラガブル・データベース・プールの更新

- データベース/スキーマ/プラガブル・データベースのプールの削除

48.3.2.3.1 ソフトウェア・プール群リソースの詳細の表示

表48-16 ソフトウェア・プール群リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/ cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Software Pools",
"type": "Software Pool",
"hasMore": false,
"count": 4,
"items": [
{
"name": "SI Databases Zone",
"type": "oracle_cloud_zone",
"id": "EF658526512C5CFEF593EB295D0CFAD5",
"zoneName": "Salt Lake City Zone",
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/EF658526512C5CFEF593EB295D0CFAD5"
},
{
"name": "Pluggable Databases Pool",
"type": "pdbaas_pool",
"id": "9FC634F035161C9260CD943970BAC1C8",
"zoneName": "Salt Lake City Zone",
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/9FC634F035161C9260CD943970BAC1C8"
},
{
"name": "Primary DB Pool",
"type": "oracle_cloud_zone",
"id": "B1E3A8872D1A503DA1F1756CD18207B4",
"zoneName": "Salt Lake City II",
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/B1E3A8872D1A503DA1F1756CD18207B4"
},
{
"name": "Standby DB Pool",
"type": "oracle_cloud_zone",
"id": "A5B6272EC680EFAB1B53842EC4256AAB",
"zoneName": "Salt Lake City II",
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/A5B6272EC680EFAB1B53842EC4256AAB"
}
],
"totalCount": 4,
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools",
"selfLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools"
}

48.3.2.3.2 ソフトウェア・プール・リソースの詳細の表示

ソフトウェア・プールURIに対してGETリクエストを発行して、その詳細を取得できます。

ソフトウェア・プールに対するGETの構成を次に示します。

表48-17 ソフトウェア・プール・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name":"DB_POOL",
"description":"Database Pool of Oracle Homes",
"type":"Database Zone",
"id":"E827809080C16F75E040F20A60511EA2",
"zoneName":"SLC01MDR_ZONE",
"members":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/members",
"numberOfPoolMembers":"1"
},
"constraints":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/constraints",
"numberOfConstraints":"1"
},
"filters":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/filters",
"numberOfFilters":"3"
},
"properties":{
"canonicalLink":https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/properties",
"numberOfPropertiess":"0"
},
"createdOn":"2013-10-07 06:27:17",
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2",
"selfLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2"
}

48.3.2.3.3 ソフトウェア・プール容量の詳細の表示

ソフトウェア・プール容量URIに対してGETリクエストを発行して、その詳細を取得できます。

次の表では、ソフトウェア・プール容量を表示するURIは、/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/C0DE0DEB3A8195A4707704360463060B/capacityです。ただし、これを変更して特定の問合せパラメータを追加し、必要な出力を表示できます。問合せパラメータおよびその説明を、次に示します:

- showUsageSummary: プール・レベルのリソース使用量データが含まれます。値は、"yes"、"y"または"true"で、すべて大文字と小文字は区別されません。この値が指定されない場合、またはリストされた値ではない値が指定された場合、"usageSummary"はレスポンスで使用できません。

- showMemberLevelUsage: プール・メンバー・レベルのリソース使用量データが含まれます。値は、"yes"、"y"または"true"で、すべて大文字と小文字は区別されません。この値が指定されない場合、またはリストされた値ではない値が指定された場合、"memberLevelUsage"はレスポンスで使用できません。

- diskGroups: 記憶域計算のASMディスク名のリストを指定します。値が指定されない場合、記憶域値はレスポンスで使用できません。次で指定するリクエストURIの形式を使用すると、複数の値を指定できます:
diskGroups=<Value1>&diskGroups=<Value2>&...

- cpuMemAveUtilDays: CPUおよびメモリー使用量の計算のために収集されたメトリックを含む日数を示します。値が指定されない場合、デフォルト値は7日間です。

ソフトウェア・プールに対するGETの構成を次に示します。

表48-18 ソフトウェア・プール容量の詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E284FAAA7FBA6A06F7090115A3E07299/capacity?showMemberLevelUsage=y&showUsageSummary=true&diskGroups=RECOC1&diskGroups=DATAC1&cpuMemAveUtilDays=3

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{"name":"DB Pool 1",
"type":"oracle_cloud_zone",
"poolInfo":
{"poolName":"DB Pool 1",
"poolId":"C0DE0DEB3A8195A4707704360463060B",
"poolDescription":"Exadata hosts Oracle Home",
"dbConfiguration":"Cluster Database",
"dbVersion":"12.1.0.2.0",
"paasZone":"zone1"},                                                        "standByPools" :
[{"poolName":"Standby Pool 1",
"poolId":"6AF0F5A23BE120F4EAEC29236853D6B8",
"poolDescription":"Standby Oracle Home",
"dbConfiguration":"Cluster Database",
"dbVersion":"12.1.0.2.0",
"paasZone":"zone2"}],
"usageSummary":
{"numberOfDbs":"2",
"numberOfHosts":"2",
"cores":
{"total":"64",
"allocated":"8",
"available":"56",
"unit":"cores"},
"memory":
{"total":"504",
"allocated":"3.53",
"available":"500.47",
"unit":"GB"},
"storage":
{"total":"29073.24",
"allocated":"12765.99",
"available":"16307.25",
"unit":"GB"}},
"memberLevelUsage":
[{"host":"MyHost1.example.com",
"oracleHomeLocation":"/u01/app/oracle/product/12.1.0.2/dbhome_1",
"numberOfDbs":"1",
"cores":
{"total":"32",
"allocated":"4",
"available":"28",
"unit":"cores"},
"cpuUtilizationPercentage":"12.77",
"memory":
{"total":"251.99",
"allocated":"1.77",
"available":"250.23",
"unit":"GB"},
"memoryUtilizationPercentage":"59.66"},
{"host":"MyHost2.example.com",
"oracleHomeLocation":"/u01/app/oracle/product/12.1.0.2/dbhome_1",
"numberOfDbs":"1",
"cores":
{"total":"32",
"allocated":"4",
"available":"28",
"unit":"cores"},
"cpuUtilizationPercentage":"9.45",
"memory":
{"total":"251.99",
"allocated":"1.77",
"available":"250 .23",
"unit":"GB"},
"memoryUtilizationPercentage":"66.75"}],
"canonicalLink":"https://MyHost.example.com:4900/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/C0DE0DEB3A8195A4707704360463060B/capacity"}

48.3.2.3.4 データベース・プールの作成

データベース・プールを作成するには、ソフトウェア・プール・コレクション・リソースに対しPOST操作を発行します。

ソフトウェア・プール群に対するPOSTの構成を次に示します。

表48-19 データベース・プールを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "DB_POOL",
"poolTargetType": "oracle_cloud_zone",
"description": "Database Pool of Oracle Homes",
"paasZone": "SLC01MDR_ZONE",
"members": [
"OraDb11g_home1_2_slc01mdr"
],
"serviceFamily": "DBAAS",
"serviceType": "DBAAS",
"constraints": {
"items": [
{"name": "MAX_INSTANCES",
"value": "10"}
]
},
"filters": {
"items": [
{"name": "CONFIGURATION",
"value": "oracle_database"},
{"name": "VERSION",
"value": "11.2.0.2.0"},
{"name": "PLATFORM",
"value": "226"}
]
},
"properties": {
"items": [
{"name": "host_credential_guid",
"value": "E84E88308E46A725E040F20A605125DD"},
{"name": "root_credential_guid",
"value": "E84E88308E46A725E040F20A605125DD"},
{"name": "standby_pools",
"value": "DB_POOL1| DB_POOL2"}
]
}
}

注意:

- name: プールの名前を示します。

- poolTargetType: DBaaSプールのターゲット・タイプを示します。oracle_cloud_zoneは、DB OHプールに指定されるターゲット・タイプです。

- paasZone: PaaSインフラストラクチャ・ゾーンの名前を示します。

- members: Oracleホームのターゲット名およびプールのメンバーのカンマ区切りおよび文字列区切りのリストです。

- constraints: プール上の制限を示します。指定できる値は、MAX_INSTANCESです。

- filters: プールのOracleホームのバージョンおよびタイプの定義に適用可能なフィルタを示します。これには、VERSION、CONFIGURATION (oracle_database、rac_database)およびPLATFORM (コードのリストへの参照を指定します。たとえば、Linuxの場合は226)が含まれます。

- properties: ホスト資格証明GUID、ルート資格証明GUIDおよびスタンバイ・プールなどのプールのプロパティを定義するコレクション・リソースを示します。名前付き資格証明GUIDを識別するには、EM CLI動詞emcli list_named_credentialまたはemcli get_named_credentialを使用します。

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"name":"DB_POOL",
"description":"Database Pool of Oracle Homes",
"type":"Database Zone",
"id":"E827809080C16F75E040F20A60511EA2",
"zoneName":"SLC01MDR_ZONE",
"members":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/members",
"numberOfPoolMembers":"1"
},
"constraints":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/constraints",
"numberOfConstraints":"1"
},
"filters":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/filters",
"numberOfFilters":"3"
},
"properties":{
"canonicalLink":https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/properties",
"numberOfPropertiess":"0"
},
"createdOn":"2013-10-07 06:27:17",
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2",
"selfLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2"
}

48.3.2.3.5 データベース・プールの更新

データベース・プールを更新するには、ソフトウェア・プール・コレクション・リソースに対しPUT操作を発行します。

ソフトウェア・プール群に対するPUTの構成を次に示します。

表48-20 データベース・プールを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "DB_POOL",
"poolTargetType": "oracle_cloud_zone",
"description": "Database Pool of Oracle Homes",
"membersToAdd": [
"OraDb11g_home1_2_abc"],
"membersToRemove": [
"OraDb11g_home1_2_abc"],
"constraints":
{"items": [{"name": "MAX_INSTANCES", "value": "8"}]},
"properties":
{"items": [
{"name": "host_credential_guid", "value": "E84E88308E46A725E040F20A605125DD"},
{"name": "root_credential_guid", "value": "E84E88308E46A725E040F20A605125DD"},
{"name": "standby_pools", "value": "DB_POOL"}
]}
}

注意: リクエストの発行中に、プールの一部として少なくともメンバーが1つ残るようにしてください。すべてのメンバーがmembersToRemove属性に追加されると、PUTリクエストが失敗する場合があります。

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
message: "Software Pool  " DB_POOL" updated successfully."
}

48.3.2.3.6 スキーマ・プールの作成

ソフトウェア・プールを作成するには、ソフトウェア・プール・コレクション・リソースに対しPOST操作を発行します。

ソフトウェア・プール群に対するPOSTの構成を次に示します。

表48-21 スキーマ・プールを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "SCHEMA_POOL",
"poolTargetType": "schaas_pool",
"description": "Schema Service Pool",
"paasZone": "SLC01MDR_ZONE",
"members": ["simple.example.com"],
"serviceFamily":"DBAAS",
"serviceType":"SCHEMA",
"constraints":
{
"items": [
{"name": "MAX_SERVICES", "value": "20"},
{"name": "USE_WORKLOAD", "value": "true"},
{"name": "MAX_CPU_USAGE", "value": "90"},
{"name": "MAX_MEMORY_USAGE", "value": "90"},
{"name": "ENFORCE_CPU", "value": "true"}
]
},
"filters":
{
"items": [
{"name": "TARGET_TYPE","value": "oracle_database"},
{"name": "VERSION","value": "11.2.0.2.0"},
{"name": "PLATFORM","value": "226"}
]
}
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Status 201 Created
Content-Type: application/json
{
"name":"SCHEMA_POOL",
"description":"Schema Service Pool",
"type":"Schema Pool",
"id":"2CFF36A9E92AAD533253871374857D8C",
"zoneName":"SLC01MDR_ZONE",
"members":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C/members",
"numberOfPoolMembers":"1"},
"constraints":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C/constraints",
"numberOfConstraints":"5"},
"filters":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C/filters",
"numberOfFilters":"3"},
"properties":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C/properties",
"numberOfPropertiess":"0"},
"createdOn":"2013-10-07 08:13:48",
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C",
"selfLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C"
}

48.3.2.3.7 スキーマ・プールの更新

ソフトウェア・プールを更新するには、ソフトウェア・プール・コレクション・リソースに対しPUT操作を発行します。

ソフトウェア・プール群に対するPUTの構成を次に示します。

表48-22 スキーマ・プールを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "SCHEMA_POOL",
"poolTargetType": "schaas_pool",
"description": "Schema Service Pool",
"membersToAdd": [
"xyxy.example.com"],
"membersToRemove": [
"simple.us.example.com"],
"constraints":
{
"items": [
{"name": "MAX_SERVICES", "value": "10"},
{"name": "USE_WORKLOAD", "value": "false"},
{"name": "MAX_CPU_USAGE", "value": "90"},
{"name": "MAX_MEMORY_USAGE", "value": "90"},
{"name": "ENFORCE_CPU", "value": "false"}
]
},
}

注意: リクエストの発行中に、プールの一部として少なくともメンバーが1つ残るようにしてください。すべてのメンバーがmembersToRemove属性に追加されると、PUTリクエストが失敗する場合があります。

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
message: "Software Pool  "SCHEMA_POOL" updated successfully.
}

48.3.2.3.8 プラガブル・データベース・プールの作成

ソフトウェア・プールを作成するには、ソフトウェア・プール群コレクション・リソースに対してPOST操作を発行します。次に、ソフトウェア・プール群にPOSTするための構成を示します。

表48-23 プラガブル・データベース・プールを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "PDB_POOL",
"poolTargetType": "pdbaas_pool",
"description": "Pluggable Database Pool",
"paasZone": "PDB_ZONE",
"members": ["database"],
"serviceFamily":"DBAAS",
"serviceType":"PDB",
"constraints":
{
"items": [
{"name": "MAX_PDB_SERVICES", "value": "20"},
{"name": "PDBS_USE_WORKLOAD", "value": "true"},
{"name": "MAX_CPU_USAGE_BY_PDBS", "value": "90"},
{"name": "MAX_MEMORY_USAGE_BY_PDBS", "value": "90"},
{"name": "PDBS_ENFORCE_CPU", "value": "true"}
]
},
"filters":
{
"items": [
{"name": "TARGET_TYPE_CDB","value": "oracle_database"},
{"name": "VERSION_CDB","value": "12.1.0.1.0"},
{"name": "PLATFORM_CDB","value": "226"}
]
}
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Status 201 Created
Content-Type: application/json
{
"name":"PDB_POOL",
"description":"Pluggable Database Pool",
"type":"Pdb Pool",
"id":"E82952BD4C94D443E040F20A605114E6",
"zoneName":"PDB_ZONE",
"members":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6/members",
"numberOfPoolMembers":"1"
},
"constraints":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6/constraints",
"numberOfConstraints":"5"
},
"filters":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6/filters",
"numberOfFilters":"3"
},
"properties":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6/properties",
"numberOfPropertiess":"0"},
"createdOn":"2013-10-07 08:29:51",
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6",
"selfLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6"
}

48.3.2.3.9 プラガブル・データベース・プールの更新

ソフトウェア・プールを更新するには、ソフトウェア・プール・コレクション・リソースに対しPUT操作を発行します。

ソフトウェア・プール群に対するPUTの構成を次に示します。

表48-24 プラガブル・データベース・プールを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "PDB_POOL",
"poolTargetType": "pdbaas_pool",
"description": "Pluggable Database Pool",
"membersToAdd": [
"simple.us.example.com"],
"membersToRemove": [
"simple1.us.example.com"],
"constraints":
{
"items": [
{"name": "MAX_PDB_SERVICES", "value": "10"},
{"name": "PDBS_USE_WORKLOAD", "value": "false"},
{"name": "MAX_CPU_USAGE_BY_PDBS", "value": "90"},
{"name": "MAX_MEMORY_USAGE_BY_PDBS", "value": "90"},
{"name": "PDBS_ENFORCE_CPU", "value": "false"}
]
},
}

注意: リクエストの発行中に、プールの一部として少なくともメンバーが1つ残るようにしてください。すべてのメンバーがmembersToRemove属性に追加されると、PUTリクエストが失敗する場合があります。

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
message: "Software Pool  "PDB_POOL" updated successfully."
}

48.3.2.3.10 データベース/スキーマ/プラガブル・データベースのプールの削除

SoftwarePoolインスタンスを削除するには、データベース・プールのURIに対してDELETEリクエストを発行します。ソフトウェア・プールを削除する構成を次に示します。

表48-25 データベース/スキーマ/プラガブル・データベース・プールを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
message: "Software Pool " E827809080C16F75E040F20A60511EA2" deleted successfully."
}

48.3.3 データベース・リクエスト設定REST API

この項では、データベース・リクエスト設定のためのRESTリクエスト/レスポンス相互作用について説明します。

注意:
リクエスト設定REST APIは、Oracle Cloud Applicationプラグイン・バージョン12.1.0.7.0以上でのみサポートされます。

この項では、次のトピックについて説明します。

- データベース・リクエスト設定リソース・モデル

- Dbaasリクエスト設定リソース

- Dbaasリクエスト設定のサポートされる操作

- Dbaasリクエスト設定REST APIの例

48.3.3.1 データベース・リクエスト設定リソース・モデル

クラウドのリソースは、共通サービス・エンティティで編成されており、特定のサービス(データベース・リクエスト設定など)がこれらの共通サービス・エンティティを拡張することでリソースを提供しています。データベース・リクエスト設定は、インスタンスの存在しないクラウド・リソースです。次の各項では、データベース・リクエスト設定REST APIでサポートされるリソースについて説明し、サポートされる操作の例を示します。

48.3.3.2 Dbaasリクエスト設定リソース

Dbaasリクエスト設定はクラウド・リソースを拡張します。サービス・インスタンスに関連するデータベース・リクエスト設定を記述します。Dbaasリクエスト設定のメディア・タイプはapplication/oracle.com.cloud.common.DbaasRequestSettings+jsonです。

次の表に、Dbaasリクエスト設定のデータ・モデルを示します。

表48-26 DBaaSリクエスト設定データ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

テンプレートのユーザー用の名前。

1

description

文字列

テンプレートの簡単な説明

1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

media_type

文字列

サービス・テンプレートのメディア・タイプ。

1

service_family_type

文字列

Dbaas

1

canonicalLink

URI

GETおよびPOSTなどのクラウド相互作用の実行に使用できます。

1

RequestSettings

文字列

現在のデータベース・リクエスト設定。

1

48.3.3.3 Dbaasリクエスト設定のサポートされる操作

次の表に、データベース割当て制限サービス・リソースでサポートされるすべての操作を示します。

表48-27 DBaasリクエスト設定のサポートされる操作

GET

POST

PUT

DELETE

はい

はい

はい

はい

48.3.3.4 Dbaasリクエスト設定REST APIの例

次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。

- Dbaasリクエスト設定リソースの詳細の表示

- データベース・リクエスト設定の作成

48.3.3.4.1 Dbaasリクエスト設定リソースの詳細の表示

次の表に、DBaaSリクエスト設定リソースの詳細を表示するためのREST API構成を示します。

表48-28 DBaaSリクエスト設定リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/cloud/dbaas/requestsettings

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/requestsettings" ,
"name" : "Dbaas Request Settings" ,
"description" : "Dbaas Request settings" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasRequestSettings+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/requestsettings" ,
"Request Settings" :     {
"futureReservationLength" : "No Reservation" ,
"defaultRetirementPeriod" : "No Reservation" ,
"maximumArchiveDuration" : "No Reservation"
}
}

48.3.3.4.2 データベース・リクエスト設定の作成

この項では、クラウド・リソースを使用したリクエスト設定の作成方法について説明します。

DbaasRequestSettingsに対するPOSTの構成を次に示します。

表48-29 DBaaSリクエスト設定を作成するためのPOSTリクエスト構成

機能

説明

URI

em/cloud/dbaas/requestsettings

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbaasRequestSettings+json

Accept: application/oracle.com.cloud.common.DbaasRequestSettings+json

本文

{
"future_reservation_length" : "2 Months",
"maximum_archive_duration" : "10 Weeks",
"default_retirement_period" : "No Reservation"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/requestsettings" ,
"name" : "Dbaas Request Settings" ,
"description" : "Dbaas Request settings" ,
"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"date" : "2013-08-27T09:13:03+0000" ,
"text" : "Request settings have been updated."
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasRequestSettings+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/requestsettings"
}

48.3.4 データベース割当て制限REST API

この項では、割当て制限を設定するためのRESTリクエスト/レスポンス相互作用について説明します。

注意:
割当て制限REST APIは、Oracle Cloud Applicationプラグイン・バージョン12.1.0.7.0以上でのみサポートされます。

この項では、次のトピックについて説明します。

- データベース割当て制限リソース・モデル

- Dbaas割当て制限リソース

- DbaaS割当て制限のサポートされる操作

- データベース割当て制限REST APIの例

48.3.4.1 データベース割当て制限リソース・モデル

クラウドのリソースは、共通サービス・エンティティで編成されており、特定のサービス(データベース割当て制限など)がこれらの共通サービス・エンティティを拡張することでリソースを提供しています。データベース割当て制限は、インスタンスの存在しないクラウド・リソースです。

次の各項では、データベース割当て制限REST APIでサポートされるリソースについて説明し、サポートされる操作の例を示します。

48.3.4.2 Dbaas割当て制限リソース

Dbaas割当て制限はクラウド・リソースを拡張します。すべてのロールに対する割当て制限設定を記述します。Dbaas割当て制限のメディア・タイプはapplication/oracle.com.cloud.common.DbaasQuota+jsonです。

次の表に、Dbaas割当て制限のデータ・モデルを示します。

表48-30 Dbaas割当て制限のデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

テンプレートのユーザー用の名前。

1

description

文字列

テンプレートの簡単な説明

1

resource_state

文字列

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

media_type

文字列

このタイプが表すサービス・テンプレートのメディア・タイプ。

1

service_family_type

文字列

Dbaas

1

canonicalLink

URI

GETおよびPOSTなどのクラウド相互作用の実行に使用できます。

1

databases

文字列

データベース使用状況レポート。

1

schema_services

文字列

スキーマ・サービス使用状況レポート。

1

pluggable_databases

文字列

プラガブル・データベース使用状況レポート。

1

memory

文字列

メモリー使用状況レポート。

1

storage

文字列

記憶域使用状況レポート。

1

割当て

文字列

ロールに対する割当て設定の詳細。

1

48.3.4.3 DbaaS割当て制限のサポートされる操作

次の表に、データベース割当て制限リソースでサポートされるすべての操作を示します。

表48-31 DbaaS割当て制限のサポートされる操作

GET

POST

PUT

DELETE

はい

はい

はい

はい

48.3.4.4 データベース割当て制限REST APIの例

次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。

- DBaas割当て制限リソースの詳細の表示

- ロール用のDBaaS割当て制限の作成

- ロール用のDBaaS割当て制限の更新

- ロール用のDBaaS割当て制限の削除

48.3.4.4.1 DBaas割当て制限リソースの詳細の表示

表48-32 DBaaS割当て制限リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/cloud/dbaas/quota

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/quota" ,
"name" : "Dbaas User Quota" ,
"description" : "User Quota for the user" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasQuota+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/quota" ,
"databases" :     {
"quota" : "Unlimited" ,
"used" : "1" ,
"unit" : "Instance"
} ,
"schema_services" :     {
"quota" : "Unlimited" ,
"used" : "1" ,
"unit" : "Instance"
} ,
"pluggable_databases" :     {
"quota" : "Unlimited" ,
"used" : "1" ,
"unit" : "Instance"
} ,
"memory" :     {
"quota" : "Unlimited" ,
"used" : "0.79" ,
"unit" : "GB"
} ,
"storage" :     {
"quota" : "Unlimited" ,
"used" : "3.38" ,
"unit" : "GB"
} ,
"Quotas" :
[
{
"Role Name" : "DBAAS_ROLE" ,
"Memory(GB)" : "99" ,
"Storage(GB)" : "99" ,
"Number of Database Requests" : "99" ,
"Number of Schema Service Requests" : "99" ,
"Number of Pluggable database Service Requests" : "99"
}
]
}

48.3.4.4.2 ロール用のDBaaS割当て制限の作成

この項では、クラウド・リソースを使用したロールに対する割当ての作成方法および設定方法について説明します。

Dbaas割当て制限のPOSTの構成は次のとおりです。

表48-33 ロール用のDBaaS割当て制限を作成するためのPOSTリクエスト構成

機能

説明

URI

em/cloud/dbaas/quota

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbaasQuota+json

Accept: application/oracle.com.cloud.common.DbaasQuota+json

本文

{
"role_name" : "DBAAS_ROLE",
"databases" : "10",
"schema_services" : "21",
"pluggable_databases" : "22",
"storage" : "99",
"memory" : "99"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/quota" ,
"name" : "Dbaas User Quota" ,
"description" : "User Quota for the user" ,
"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"date" : "2013-08-27T08:58:48+0000" ,
"text" : "Quota for Role DBAAS_ROLE setup successfully."
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasQuota+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/quota"
}

48.3.4.4.3 ロール用のDBaaS割当て制限の更新

この項では、クラウド・リソースを使用してロールにすでに設定されている割当て制限を更新する方法について説明します。DBaas割当て制限に対するPUTの構成を次の表に示します。

表48-34 ロール用のDBaaS割当て制限を更新するためのPUTリクエスト構成

機能

説明

URI

em/cloud/dbaas/quota

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbaasQuota+json

Accept: application/oracle.com.cloud.common.DbaasQuota+json

本文

{
"role_name" : "DBAAS_ROLE",
"databases" : "10",
"schema_services" : "21",
"pluggable_databases" : "22",
"storage" : "99",
"memory" : "99"

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/quota" ,
"name" : "Dbaas User Quota" ,
"description" : "User Quota for the user" ,
"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"date" : "2013-08-27T09:01:56+0000" ,
"text" : "Quota for Role DBAAS_ROLE updated successfully."
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasQuota+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/quota"
}

48.3.4.4.4 ロール用のDBaaS割当て制限の削除

この項では、クラウド・リソースを使用してロールに設定されている割当て制限を削除する方法について説明します。DBaas割当て制限に対する削除の構成を次に示します。

表48-35 ロール用のDBaaS割当て制限を削除するためのDELETEリクエスト構成

機能

説明

URI

em/cloud/dbaas/quota

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbaasQuota+json

Accept: application/oracle.com.cloud.common.DbaasQuota+json

本文

{
"role_name" : "SSA_USER_ROLE"
}

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"uri": "/em/cloud/dbaas/quota",
"name": "Dbaas User Quota",
"description": "User Quota for the user",
"resource_state": {
"state": "READY",
"messages": [
{
"text": "Quota for Role SSA_USER_ROLE deleted successfully.",
"date": "2015-12-08T07:18:08+0000"
}
]
},
"media_type": "application/oracle.com.cloud.common.DbaasQuota+json",
"service_family_type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/quota"
}

48.3.5 サービス・テンプレートREST API

この項の内容は次のとおりです。

- サービス・テンプレート群リソース

- サービス・テンプレート・リソース

- サービス・テンプレート群REST APIおよびサービス・テンプレートREST APIの例

48.3.5.1 サービス・テンプレート群リソース

サービス・テンプレートは、すべてのアクセス可能なサービス・テンプレート・リソースのクラウド管理者ビューを表すコレクション・リソースです。サービス・テンプレート群のメディア・タイプはapplication/oracle.com.cloud.common.ServiceTemplates+jsonです。

次の表では、サービス・テンプレート群のデータ・モデルについて説明します。

表48-36 サービス・テンプレート・データ・モデル

フィールド

タイプ

説明

発生

Name

文字列

このコレクション・リソースの名称が表示されます。

1

タイプ

文字列

このコレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

Count

整数

返される要素の数。

1

Items

コレクション<ServiceTemplate>

このコレクションの要素。

1

totalCount

整数

PaaSゾーン・リソースの総数

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

48.3.5.1.1 サービス・テンプレートでサポートされる操作

次の表に、サービス・テンプレート・リソースでサポートされるすべての操作を示します。

表48-37 サービス・テンプレートでサポートされる操作

GET

POST

PUT

DELETE

はい

はい

いいえ

いいえ

48.3.5.2 サービス・テンプレート・リソース

サービス・テンプレートは、セルフ・サービス・ユーザーがサービス・インスタンスをプロビジョニングするときに使用できる、標準化されたサービスの定義です。サービス・テンプレートのメディア・タイプはapplication/oracle.com.cloud.common.ServiceTemplate+jsonです。

次の表では、サービス・テンプレート・データ・モデルについて説明します。

表48-38 サービス・テンプレート・データ・モデル

フィールド

タイプ

説明

発生

Name

文字列

ServiceTemplateのユーザー用の名前。

1

ID

文字列

リソースを一意に識別するサービス・テンプレートID。

1

説明

文字列

ゾーンの簡単な説明。

0..1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

serviceFamily

文字列

サービス・ファミリ。

1

serviceType

文字列

サービス・タイプ。

1

ロール

コレクション<ロール>

このサービス・テンプレートにアクセスできるSSAロール。

0..1

poolIds

コレクション<文字列>

このサービス・テンプレートに関連付けられたソフトウェア・プールID。

1

createdOn

文字列(日付/時刻)

リソースが作成された日時。

0..1

createdBy

文字列

リソースを作成したユーザー。

1

modifiedOn

文字列(日付/時刻)

リソースが最後に変更された日時。

0..1

rolesToRemove

コレクション<文字列>

PaaSゾーンの編集時に削除するSSAロール。

0..1

48.3.5.2.1 サービス・テンプレートでサポートされる操作

次の表に、サービス・テンプレート・リソースでサポートされるすべての操作を示します。

表48-39 サービス・テンプレートでサポートされる操作

GET

POST

PUT

DELETE

はい

いいえ

はい

はい

48.3.5.3 サービス・テンプレート群REST APIおよびサービス・テンプレートREST APIの例

次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。

- サービス・テンプレート群リソースの詳細の表示

- ServiceTemplateリソースの詳細の表示

- DBCAベースのデータベース用のサービス・テンプレートの作成

- RMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成

- 単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成

- RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成

- スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成

- スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの作成

- DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの作成

- DNFSベースのデータベース用のサービス・テンプレートの作成

- スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートの作成

- スナップ・クローン単一インスタンス・データベース用(アーカイブが無効)のサービス・テンプレートの作成

- スキーマ用のサービス・テンプレートの作成

- プラガブル・データベース用のサービス・テンプレートの作成

- 空のプラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成

- プロファイル・プラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成

- データベース/スキーマ/プラガブル・データベースのサービス・テンプレートの削除

48.3.5.3.1 サービス・テンプレート群リソースの詳細の表示

GETリクエストの構成を次の表に示します。

表48-40 サービス・テンプレート群リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/ cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Service Templates",
"type": "Service Template",
"totalResults": 5,
"cfwItems": [
{
"id": "1",
"name": "Database Creation on Individual Hosts",
"guid": "203D5C842C2C17C3E053C075B10A73E3",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/1"
}
},
{
"id": "21",
"name": "Create Databases on 12_1_0_1_x",
"guid": "204E31F679D421E8E053C075B10A409A",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/21"
}
},
{
"id": "81",
"name": "Create Databases on Clusters - Based on DB Template",
"guid": "2068CDF3C0200D7CE053C075B10A7811",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/81"
}
},
{
"id": "61",
"name": "RMAN ST",
"guid": "205046BB4D38762EE053C075B10AF091",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61"
}
},
{
"id": "41",
"name": "Database Creation on Cluster",
"guid": "204F067E22C12CFDE053C075B10A8A26",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/41"
}
}
],
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates"
}
}

48.3.5.3.2 ServiceTemplateリソースの詳細の表示

ServiceTemplate URIに対してGETリクエストを発行して、その詳細を取得できます。次に、ServiceTemplateにGETするための構成を示します。

表48-41 サービス・テンプレート・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"id": "61",
"guid": "205046BB4D38762EE053C075B10AF091",
"name": "RMAN ST",
"displayName": "RMAN ST",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"createdOn": "2015-09-22T05:32:07Z",
"createdBy": "SYSMAN",
"modifiedOn": "2015-09-22T05:32:07Z",
"owner": "SYSMAN",
"lastModified": "2015-09-22T05:32:07Z",
"payloads": [
{ "name": "SERVICE_TEMPLATE_PROV_SOURCE",
"value": null,
"required": null},
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:204D498A85D42C6AE053C075B10A6B09:0.1",
"required": null},
{"name": "DBDELETE_PRESCRIPT",
"value": null,
"required": null},
{"name": "DBDELETE_POSTSCRIPT",
"value": null,
"required": null}
],
"characteristics": [
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"displayName": "Contact",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"displayName": "Cost Center",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DOWNTIME_CONTACT",
"displayName": "Downtime Contact",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"displayName": "Lifecycle Status",
"values": [
"Development",
"MissionCritical",
"Production",
"Stage",
"Test"
],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"displayName": "Line of Business",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.SSA.PROVISIONING_TYPE",
"displayName": "Provisioning Type",
"values": ["RMAN"],
"required": false,
"editable": false,
"visible": false}
],
"resourceProvider": {
"lookupCharacteristics": [
{
"purposeId": 1,
"characteristics": [
{ "name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"displayName": "oracle.sysman.ssa.oracle_cloud_zone",
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"},
"targets": [
{ "guid": "0CAF930826EDE90D8072E4E3ACA8072A",
"displayName": "RAC Databases Pool _11_2_0_4" }
]
}
]
}
]
},
"configurations": [
{ "name": "ssaUser",
"type": "STRING",
"value": "",
"displayName": "ssaUser",
"required": false,
"secret": false},
{ "name": "STANDBY_WORK_DIR",
"type": "STRING",
"value": "",
"displayName": "STANDBY_WORK_DIR",
"required": false,
"secret": false},
{ "name": "SID_OPTION",
"type": "STRING",
"description": "Database SID Option to be used. values are ssauser/prefix",
"value": "prefix",
"displayName": "Database SID Option",
"required": false,
"secret": false},
{ "name": "PROFILE_VERSION",
"type": "STRING",
"description": "Profile version to use",
"value": "latest",
"displayName": "Profile version",
"required": false,
"secret": false},
{ "name": "DB_TARGET_DISPLAY_NAME",
"type": "STRING",
"value": "",
"displayName": "DB_TARGET_DISPLAY_NAME",
"required": false,
"secret": false},
{ "name": "REF_TGT",
"type": "STRING",
"value": "xxy.example.com",
"displayName": "REF_TGT",
"required": false,
"secret": false},
{ "name": "USER_PRIVILEGES",
"type": "STRING",
"description": "Comma Seperated List of privileges that will be applied on role assigned to the master account.",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY",
"displayName": "User Privileges",
"required": false,
"secret": false},
{ "name": "COMMON_DB_SID",
"type": "STRING",
"description": "Database SID Prefix",
"value": "rmanri",
"displayName": "Database SID Prefix",
"required": false,
"secret": false},
{ "name": "DBAAS_SSA_STANDBY_CUSTOM_PRE_SCRIPTS_URN",
"type": "STRING",
"description": "Urn of the software library component which has the standby custom post sql script",
"value": "",
"displayName": "URN of the standby pre sql custom script",
"required": false,
"secret": false},
{ "name": "DBAAS_SSA_STANDBY_CUSTOM_POST_SCRIPTS_URN",
"type": "STRING",
"description": "Urn of the software library component which has the standby custom post sql script",
"value": "",
"displayName": "URN of the standby post sql custom script",
"required": false,
"secret": false},
{ "name": "ssaTargetName",
"type": "STRING",
"value": "",
"displayName": "ssaTargetName",
"required": false,
"secret": false},
{ "name": "DB_USER_NAMES",
"type": "STRING",
"description": "Database users from source",
"value": "",
"displayName": "Database Users from source",
"required": false,
"secret": false},
{ "name": "ssaTargetType",
"type": "STRING",
"value": "",
"displayName": "ssaTargetType",
"required": false,
"secret": false},
{ "name": "RAC_ONE_SERVICE_NAME",
"type": "STRING",
"description": "The name of service for RAC One Node database.",
"value": "",
"displayName": "RAC One Service Name",
"required": false,
"secret": false},
{ "name": "RUN_AS_USER",
"type": "STRING",
"value": "sys",
"displayName": "RUN_AS_USER",
"required": false,
"secret": false},
{ "name": "NONADMIN_SSA_ACC_DB_USER_NAMES",
"type": "STRING",
"description": "Database users from source",
"value": "OUTLN,ORACLE_OCM,APPQOSSYS,WMSYS,EXFSYS,CTXSYS,XDB,ORDSYS,ORDDATA,ORDPLUGINS,SI_INFORMTN_SCHEMA,MDSYS,OLAPSYS,SYSMAN,APEX_030200,FLOWS_FILES,SCOTT,OWBSYS_AUDIT,OWBSYS",
"displayName": "Database Users from source",
"required": false,
"secret": false},
{ "name": "INIT_PARAMS",
"type": "VECTOR",
"description": "The list of initialization values that are as paramName=paramValue",
"displayName": "INIT_PARAMS",
"required": false,
"secret": false,
"values": [
"*.db_block_size=8192",
"*.audit_trail='db'",
"*.db_name='mdb00008'",
"*.cpu_count=0",
"myracdb1.__sga_target=1275068416",
"*.diagnostic_dest='/u01/app/emga/11.2.0.4'",
"*.control_files='/oradbnas/mdb00008/controlfile/control01.ctl','/oradbnas//mdb00008/controlfile/control02.ctl'",
"*.audit_file_dest='/u01/app/emga/11.2.0.4/admin/mdb00008/adump'",
"*.pga_aggregate_target=423624704",
"*.processes=150",
"*.db_create_file_dest='/oradbnas/mdb00008'",
"*.db_recovery_file_dest='/oradbnas//mdb00008'",
"*.log_archive_format='%t_%s_%r.dbf'",
"*.compatible='11.2.0.4.0'",
"*.db_recovery_file_dest_size=2097152000",
"*.open_cursors=300",
"*.remote_login_passwordfile='exclusive'",
"*.undo_tablespace='UNDOTBS01'",
"*.db_domain=''"
]},
{ "name": "COMMON_DB_DBSNMP_PASSWORD",
"type": "STRING",
"description": "DBSNMP Account password",
"value": "welcome1",
"displayName": "DBSNMP Account password",
"required": false,
"secret": true},
{ "name": "DB_ADMIN_PASSWORD_SAME",
"type": "STRING",
"description": "Use the same passwords for SYS, SYSTEM and DBSNMP account",
"value": "true",
"displayName": "Use the same passwords for SYS, SYSTEM and DBSNMP account",
"required": false,
"secret": false},
{ "name": "DEFAULT_DATABASE_SIZE",
"type": "STRING",
"value": "",
"displayName": "DEFAULT_DATABASE_SIZE",
"required": false,
"secret": false},
{ "name": "DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URN",
"type": "STRING",
"description": "Urn of the software library component which has the custom post sql script",
"value": "",
"displayName": "URN of the pre sql custom script",
"required": false,
"secret": false},
{ "name": "RUN_AS_USER_PWD",
"type": "STRING",
"value": "",
"displayName": "RUN_AS_USER_PWD",
"required": false,
"secret": false},
{ "name": "IS_RAC_ONE",
"type": "STRING",
"description": "Boolean value to show RAC One Target Type, (true/false)",
"value": "N",
"displayName": "RAC One Target Type",
"required": false,
"secret": false},
{ "name": "PROFILE_VERSION_URN",
"type": "STRING",
"description": "Profile Version Selected by user for creating database.",
"value": "",
"displayName": "Profile Version Selected",
"required": false,
"secret": false},
{ "name": "HOSTS_FOR_PLACEMENT",
"type": "STRING",
"description": "Comma separated value of the name of hosts which will be used for the custom placement of the requested database instance. This list of hosts should have their database homes present in the selected zone and pool of the service template.",
"value": "",
"displayName": "Host(s) name to be selected in the DB pool for custom placement",
"required": false,
"secret": false},
{ "name": "PROVISIONING_TYPE",
"type": "STRING",
"value": "",
"displayName": "PROVISIONING_TYPE",
"required": false,
"secret": false},
{ "name": "STANDBY_REQUIRED_LOCK",
"type": "STRING",
"value": "",
"displayName": "STANDBY_REQUIRED_LOCK",
"required": false,
"secret": false},
{ "name": "LOCK_DOMAIN_NAME",
"type": "STRING",
"description": "Accepts Database Domain Name from SSA user",
"value": "false",
"displayName": "Accepts the database Domain Name from SSA user ",
"required": false,
"secret": false},
{ "name": "ROLE_NAME",
"type": "STRING",
"description": "Name of the database role which will assigned to the master account.",
"value": "ROLE_Sep_22_2015_11_01_AM",
"displayName": "Database Role Name",
"required": false,
"secret": false},
{ "name": "STANDBY_DATABASE_MASTER",
"type": "STRING",
"value": "",
"displayName": "STANDBY_DATABASE_MASTER",
"required": false,
"secret": false},
{ "name": "ASM_DSKGRP_PREFIX",
"type": "STRING",
"description": "ASM Diskgroup prefix to be used for all the new diskgroups to be created",
"value": "",
"displayName": "ASM Diskgroup Prefix for all new diskgroups",
"required": false,
"secret": false},
{ "name": "DB_USER_PASSWORDS",
"type": "STRING",
"description": "Passwords for Database users from source",
"displayName": "Passwords for Database Users from source",
"required": false,
"secret": true},
{ "name": "ASM_OPTION",
"type": "STRING",
"description": "ASM Diskgroup Option to be used. values are ssauser/prefix",
"value": "",
"displayName": "ASM Diskgroup Option",
"required": false,
"secret": false},
{ "name": "SELECT_ORACLE_HOME_OPTION",
"type": "STRING",
"description": "Option for selecting the DB Oracle Home that includes runtime selection or user selection. Possible values are SELECT_ORACLE_HOME_AT_RUNTIME or SELECT_ORACLE_HOME_FROM_REQUEST",
"value": "SELECT_ORACLE_HOME_AT_RUNTIME",
"displayName": "Option for selecting the DB Oracle home",
"required": false,
"secret": false},
{ "name": "LISTENER_PORT",
"type": "STRING",
"description": "Listener Port (required only for Single Instance Database)",
"value": "1524",
"displayName": "Listener Port",
"required": false,
"secret": false},
{ "name": "STANDBY_DB_MASTER_DETAILS",
"type": "VECTOR",
"displayName": "STANDBY_DB_MASTER_DETAILS",
"required": false,
"secret": false,
"values": []},
{ "name": "COMMON_DOMAIN_NAME",
"type": "STRING",
"description": "Database Domain Name",
"value": "us.example.com",
"displayName": "Database Domain Name",
"required": false,
"secret": false},
{ "name": "WORKLOADS",
"type": "VECTOR",
"displayName": "WORKLOADS",
"required": false,
"secret": false},
{ "name": "STANDBY_COMMON_DB_SID",
"type": "STRING",
"value": "",
"displayName": "STANDBY_COMMON_DB_SID",
"required": false,
"secret": false},
{ "name": "LIVE_CLONE_DATABASE_GUID",
"type": "STRING",
"description": "Database Guid to be cloned",
"value": "",
"displayName": "Database Guid to be cloned",
"required": false,
"secret": false},
{ "name": "COMMON_DB_SYSTEM_PASSWORD",
"type": "STRING",
"description": "SYSTEM Account password",
"value": "welcome1",
"displayName": "SYSTEM Account password",
"required": false,
"secret": true},
{ "name": "USER_INITIATED_BACKUP_LOCATION",
"type": "STRING",
"value": "",
"displayName": "USER_INITIATED_BACKUP_LOCATION",
"required": false,
"secret": false},
{ "name": "ssaRequestId",
"type": "STRING",
"value": "",
"displayName": "ssaRequestId",
"required": false,
"secret": false},
{ "name": "TARGET_PROP_LIST",
"type": "VECTOR",
"description": "The list of initialization values that are as paramName=paramValue",
"displayName": "TARGET_PROP_LIST",
"required": false,
"secret": false,
"values": [
"Site:null:false:false",
"Contact:null:false:false",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]},
{ "name": "LIVE_CLONE_TYPE",
"type": "STRING",
"description": "Live Clone Type USE_FULLCLONE/USE_SNAPCLONE",
"value": "",
"displayName": "Type of Live Clone",
"required": false,
"secret": false},
{ "name": "REF_HOST",
"type": "STRING",
"value": "xxy.example.com",
"displayName": "REF_HOST",
"required": false,
"secret": false},
{ "name": "CUSTOM_TARGET_PROP_LIST",
"type": "VECTOR",
"description": "The list of initialization values that are as paramName=paramValue",
"displayName": "CUSTOM_TARGET_PROP_LIST",
"required": false,
"secret": false,
"values": []},
{ "name": "STANDBY_LISTENER_PORT",
"type": "STRING",
"value": "",
"displayName": "STANDBY_LISTENER_PORT",
"required": false,
"secret": false},
{ "name": "CLONE_OR_FULL_DB",
"type": "STRING",
"value": "",
"displayName": "CLONE_OR_FULL_DB",
"required": false,
"secret": false},
{ "name": "DATABASE_TYPE",
"type": "STRING",
"description": "Database Type (oracle_database/rac_database)",
"value": "rac_database",
"displayName": "Database Type",
"required": false,
"secret": false},
{ "name": "PROFILE_COMPONENT_URN",
"type": "STRING",
"description": "URN of the Profile component in software library with which the Database will be created",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:204D498A85D42C6AE053C075B10A6B09:0.1",
"displayName": "URN of the Profile Component to be used for Database Creation",
"required": false,
"secret": false},
{ "name": "VALIDATION_SQL",
"type": "STRING",
"description": "Sql script for primary database validation",
"value": "",
"displayName": "Sql script for primary database validation",
"required": false,
"secret": false},
{ "name": "REFRESH_DATABASE",
"type": "STRING",
"value": "",
"displayName": "REFRESH_DATABASE",
"required": false,
"secret": false},
{ "name": "REF_ZONE",
"type": "STRING",
"value": "Salt Lake City Zone",
"displayName": "REF_ZONE",
"required": false,
"secret": false},
{ "name": "STANDBY_DELAY_DATABASE_MASTER",
"type": "STRING",
"value": "",
"displayName": "STANDBY_DELAY_DATABASE_MASTER",
"required": false,
"secret": false},
{ "name": "zoneTargetName",
"type": "STRING",
"value": "",
"displayName": "zoneTargetName",
"required": false,
"secret": false},
{ "name": "PRIMARY_PROTECTION_MODE",
"type": "STRING",
"value": "",
"displayName": "PRIMARY_PROTECTION_MODE",
"required": false,
"secret": false},
{ "name": "INSTANCE_COUNT",
"type": "STRING",
"description": "Number of RAC Database instances required",
"value": "2",
"displayName": "Number of RAC instances",
"required": false,
"secret": false},
{ "name": "USER_PASSWORD",
"type": "STRING",
"description": "User Password to login to the given User Name database account",
"displayName": "User Password",
"required": true,
"secret": true},
{ "name": "MAX_BACKUPS_ALLOWED",
"type": "STRING",
"description": "The number of backups enabled for the Database",
"value": "",
"displayName": "Number of Backups allowed for the Database",
"required": false,
"secret": false},
{ "name": "ENTITY_TYPE",
"type": "STRING",
"description": "Entity TYpe USE_PROFILE/USE_DATABASE",
"value": "USE_PROFILE",
"displayName": "Entity Type",
"required": false,
"secret": false},
{ "name": "DBCREATE_POST_SQL_SCRIPT",
"type": "STRING",
"value": "",
"displayName": "DBCREATE_POST_SQL_SCRIPT",
"required": false,
"secret": false},
{ "name": "DBAAS_SSA_CUSTOM_POST_SCRIPTS_URN",
"type": "STRING",
"description": "Urn of the software library component which has the custom post sql script",
"value": "",
"displayName": "URN of the post sql custom script",
"required": false,
"secret": false},
{ "name": "USER_NAME",
"type": "STRING",
"description": "User Name (cannot be any of Oracle default accounts) used to login to the requested database",
"value": "",
"displayName": "User Name (cannot be any of Oracle default accounts)",
"required": true,
"secret": false},
{ "name": "DATABASE_SIZES",
"type": "VECTOR",
"displayName": "DATABASE_SIZES",
"required": false,
"secret": false,
"values": []},
{ "name": "ALLOW_BACKUPS",
"type": "STRING",
"description": "Should the backup be enabled for the Database",
"value": "",
"displayName": "Enable Backups for the Database",
"required": false,
"secret": false},
{ "name": "zoneTargetType",
"type": "STRING",
"value": "",
"displayName": "zoneTargetType",
"required": false,
"secret": false},
{ "name": "STANDBY_REQUIRED",
"type": "STRING",
"value": "false",
"displayName": "STANDBY_REQUIRED",
"required": false,
"secret": false},
{ "name": "STANDBY_DB_DETAILS",
"type": "VECTOR",
"displayName": "STANDBY_DB_DETAILS",
"required": false,
"secret": false,
"values": []},
{ "name": "COMMON_DB_SYS_PASSWORD",
"type": "STRING",
"description": "SYS Account password",
"value": "welcome1",
"displayName": "SYS Account password",
"required": false,
"secret": true},
{ "name": "REF_POOL",
"type": "STRING",
"value": "RAC Databases Pool _11_2_0_4",
"displayName": "REF_POOL",
"required": false,
"secret": false}
],
"canonicalLink": {"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61"},
"selfLink": {"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61"},
"active": true
}

48.3.5.3.3 DBCAベースのデータベース用のサービス・テンプレートの作成

DBCAベースのデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。

表48-42 DBCAベースのデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "Create ST for SI Db using DBCA Template - ASM Subh_2",
"description": "Creates Single Instance DB",
"roles": [ "SSA_USER_ROLE" ],
"serviceType": "DB",
"serviceTemplateTypeId": "61",
"rscProvAssocOption": [ "byRscProvInst" ],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [ "137F74D7A8359A60762ED550341A5F47" ],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [ { "name": "PROFILE_COMPONENT_URN", "value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:269BA6C90E6A5000E053C075B10A51A3:0.1" } ],
"configurations": [
{ "name": "REF_ZONE", "value": "Salt Lake City Zone" },
{ "name": "REF_POOL", "value": "SI Databases Pool_Oracle_DB_11g" },
{ "name": "REF_HOST", "value": "xyz.example.com" },
{ "name": "REF_TGT", "value": "xyz.example.com" },
{ "name": "DBCA_TEMPLATE:DB_STORAGE_TYPE", "value": "ASM" },
{ "name": "DBCA_TEMPLATE:REC_STORAGE_TYPE_SAME_AS_DB_FILES", "value": "Y" },
{ "name": "DBCA_TEMPLATE:FLASH_RECOVERY_AREA_SIZE", "value": "4038" },
{ "name": "DBCA_TEMPLATE:DATA_FILE_LOCATION", "value": "DATA" },
{ "name": "DBCA_TEMPLATE:REDO_FILE_LOCATION", "value": "RECO" },
{ "name": "DBCA_TEMPLATE:ARCHIVE_LOG_MODE", "value": "Y" },
{ "name": "DBCA_TEMPLATE:RECOVERY_FILE_LOCATION", "value": "RECO" },
{ "name": "DATABASE_TYPE", "value": "oracle_database" },
{ "name": "COMMON_DOMAIN_NAME", "value": "us.example.com" },
{ "name": "ORACLE.SYSMAN.SSA.PROVISIONING_TYPE", "values": [ "DBCA_TEMPLATE" ] },
{ "name": "ENTITY_TYPE", "value": "USE_PROFILE" },
{ "name": "PROFILE_COMPONENT_URN", "value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:269BA6C90E6A5000E053C075B10A51A3:0.1" },
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY"
},
{ "name": "SID_OPTION", "value": "ssauser" },
{ "name": "SELECT_ORACLE_HOME_OPTION", "value": "SELECT_ORACLE_HOME_AT_RUNTIME"},
{ "name": "COMMON_DB_SYS_PASSWORD", "value": "welcome"},
{ "name": "DB_ADMIN_PASSWORD_SAME", "value": "true" },
{ "name": "INIT_PARAMS", "values": [
"sga_target=1073741824",
"pga_aggregate_target=1073741824"
]
},
{ "name": "LISTENER_PORT", "value": "1521" },
{ "name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:xxxx:false:true",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:Testing:false:true",
"Line of Business:null:false:false"
]
}
]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

注意:
前述のREST API bodyで:

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"1C39F32393A709C3E053C075B10AEE15\" created successfully."
}

48.3.5.3.4 RMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成

RMANベースの単一インスタンス・データベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。

表48-43 RMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "Database Service - RMAN Based with archiving",
"description": "This creates Database Archiving log mode.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"1898CF93BD39C19BF032672271BC4B44"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
}
],
"configurations": [
{
"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_FROM_REQUEST"
},
{
"name": "REF_TGT",
"value": "sxy.us.example.com"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_ZONE",
"value": "Salt Lake City Zone"
},
{
"name": "zoneTargetName",
"value": "Salt Lake City Zone"
},
{
"name": "REF_POOL",
"value": "Databases Pool"
},
{
"name": "DATABASE_TYPE",
"value": "oracle_database"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "COMMON_DB_SID",
"value": "db"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
},
{
"name": "RMAN.DB_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_SIZE",
"value": "4038"
},
{
"name": "RMAN.USE_ARCHIVING",
"value": "YES"
},
{
"name": "RMAN.DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"
},
{
"name": "RMAN.REDO_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.RECOVERY_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.WORK_DIR_LOC",
"value": "/tmp/work"
},
{
"name": "RMAN.DB_ADMIN_PASSWORD_SAME",
"value": "Y"
},
{
"name": "RMAN.DATABASE_PASSWORDS",
"value": "welcome"
},
{
"name": "RMAN.BACKUP_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "RMAN.USE_OFA",
"value": "N"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "CUSTOM_PRE_CREATE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"
},
{
"name": "CUSTOM_POST_CREATE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"
}
]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

注意:
前述のREST API bodyで:

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"1C39F32393A709C3E053C075B10AEE15\" created successfully."
}

48.3.5.3.5 単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成

単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。

表48-44 単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "Database Service - RMAN Based with archiving with SI Standby",
"description": "This creates Database Archiving log mode.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"1898CF93BD39C19BF032672271BC4B44"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
}
],
"configurations": [
{
"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_FROM_REQUEST"
},
{
"name": "REF_TGT",
"value": "xyz.example.com"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_ZONE",
"value": "Salt Lake City Zone"
},
{
"name": "zoneTargetName",
"value": "Salt Lake City Zone"
},
{
"name": "REF_POOL",
"value": "Databases Pool"
},
{
"name": "DATABASE_TYPE",
"value": "oracle_database"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "COMMON_DB_SID",
"value": "db"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
},
{
"name": "RMAN.DB_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_SIZE",
"value": "4038"
},
{
"name": "RMAN.USE_ARCHIVING",
"value": "YES"
},
{
"name": "RMAN.DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"
},
{
"name": "RMAN.REDO_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.RECOVERY_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.WORK_DIR_LOC",
"value": "/tmp/work"
},
{
"name": "RMAN.DB_ADMIN_PASSWORD_SAME",
"value": "Y"
},
{
"name": "RMAN.DATABASE_PASSWORDS",
"value": "welcome"
},
{
"name": "RMAN.BACKUP_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "RMAN.USE_OFA",
"value": "N"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "STANDBY_DB_DETAILS",
"values": [
"pool=Near DR Pool;databaseSIDPrefix=;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

注意:
前述のREST API bodyで:

- REF_ZONEは、テンプレートに関連付けられるゾーンの中の参照ゾーンを示します。

- REF_POOLは、テンプレートに関連付けられるプールの中の参照プールを示します。

- REF_HOSTは、プール・ターゲットからの参照ターゲットのホストを示します。

- REF_TGTは、プール・ターゲットからの参照ターゲットを示します。

- SELECT_ORACLE_HOME_OPTIONを使用すると、Oracleホームを、値にSELECT_ORACLE_HOME_AT_RUNTIMEを入力して自動的に選択する、または値にSELECT_ORACLE_HOME_FROM_REQUESTを入力してSSAユーザーにより選択できます。

これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxx\" created successfully."
}

48.3.5.3.6 RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成

RMANベースのRAC One Nodeデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。

表48-45 RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "Create Databases on RAC One database",
"description": "Creates Databases on RAC.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"647E8750A1C3835557165B499B269FB3"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"
}
],
"configurations": [
{"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"},
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"},
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name": "REF_TGT",
"value": "abc.example.com"},
{"name": "REF_HOST",
"value": "adc.example.com"},
{"name": "REF_ZONE",
"value": "Salt Lake City Zone"},
{"name": "zoneTargetName",
"value": "Salt Lake City Zone"},
{"name": "REF_POOL",
"value": "RAC Databases Pool"},
{"name": "DATABASE_TYPE",
"value": "rac_database"},
{"name": "IS_RAC_ONE",
"value": "Y"},
{"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"},
{"name": "LISTENER_PORT",
"value": "1521"},
{"name": "PROFILE_VERSION",
"value": "latest"},
{"name": "COMMON_DB_SID",
"value": "db"},
{"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name": "RMAN:DB_STORAGE_TYPE",
"value": "FS"},
{"name": "RMAN:FRA_SIZE",
"value": "4038"},
{"name": "RMAN:USE_ARCHIVING",
"value": "NO"},
{"name": "RMAN:DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"},
{"name": "RMAN:WORK_DIR_LOC",
"value": "/tmp/work"},
{"name": "RMAN:DB_ADMIN_PASSWORD_SAME",
"value": "Y"},
{"name": "RMAN:DATABASE_PASSWORDS",
"value": "welcome"},
{"name": "RMAN:BACKUP_LOCATION",
"value": "/oradbnas/backups/rman/"},
{"name": "RMAN:USE_OFA",
"value": "N"},
{"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"}
]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxx\" created successfully."
}

48.3.5.3.7 スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成

スタンバイを含むRMANベースのRAC One Nodeデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。

次に示す例には、作成されたスタンバイが2つあります。片方のスタンバイRAC One NodeデータベースはプライマリRAC One Nodeデータベースと同じプールに作成されたNear DR(障害回復)で、もう片方のスタンバイFar DRデータベースは異なるプールに作成されたシングル・インスタンス・データベースです。データ保護のために2つのスタンバイ・データベースが作成される障害回復設定にとって、この設定は不可欠です。次に示すPOST bodyは、1つのスタンバイ・データベース(SIまたはRAC One Node)のみを持つように変更することもできます。

構成は次のとおりです。

表48-46 スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "RAC One Database Provisioning with RAC One Standby and SI Standby",
"description": "Creates RAC One Databases with RAC One Standby and SI Standby.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"647E8750A1C3835557165B499B269FB3"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"}
],
"configurations": [
{"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"},
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"},
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name": "REF_TGT",
"value": "adc.example.com"},
{"name": "REF_HOST",
"value": "adc.example.com"},
{"name": "REF_ZONE",
"value": "Salt Lake City Zone"},
{"name": "zoneTargetName",
"value": "Salt Lake City Zone"},
{"name": "REF_POOL",
"value": "RAC Databases Pool"},
{"name": "DATABASE_TYPE",
"value": "rac_database"},
{"name": "IS_RAC_ONE",
"value": "Y"},
{"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"},
{"name": "LISTENER_PORT",
"value": "1521"},
{"name": "PROFILE_VERSION",
"value": "latest"},
{"name": "COMMON_DB_SID",
"value": "db"},
{"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name": "RMAN:DB_STORAGE_TYPE",
"value": "FS"},
{"name": "RMAN:FRA_SIZE",
"value": "4038"},
{"name": "RMAN:USE_ARCHIVING",
"value": "NO"},
{"name": "RMAN:DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"},
{"name": "RMAN:WORK_DIR_LOC",
"value": "/tmp/work"},
{"name": "RMAN:DB_ADMIN_PASSWORD_SAME",
"value": "Y"},
{"name": "RMAN:DATABASE_PASSWORDS",
"value": "welcome"},
{"name": "RMAN:BACKUP_LOCATION",
"value": "/oradbnas/backups/rman/"},
{"name": "RMAN:USE_OFA",
"value": "N"},
{"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"},
{"name": "STANDBY_REQUIRED",
"value": "true"},
{"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxx\" created successfully."
}

48.3.5.3.8 スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの作成

スタンバイを含むRMANベースのRACデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。

単一インスタンス・スタンバイ・データベースを含むRACデータベースを作成する構成は、RAC One NodeスタンバイのあるRACデータベースの構成に類似しています。別のスタンバイを作成するためのペイロードの唯一の違いは、構成パラメータSTANDBY_DB_DETAILSにより定義されます。

RAC One Nodeスタンバイを含むRACデータベースの作成で使用するSTANDBY_DB_DETAILSパラメータのサンプル値を次に示します:

"pool=Near RAC DR Pool;databaseSIDPrefix=;databaseType=rac_database;isRACOne=Y;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com

一方、単一インスタンス・スタンバイを含むRACデータベースの作成で使用するSTANDBY_DB_DETAILSパラメータのサンプル値を次に示します:

"pool=Near DR Pool;databaseSIDPrefix=;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"

次に示すサンプルのPOST構成は、単一インスタンス・スタンバイを含むRACデータベース用のサービス・テンプレートです。次のサンプルのSTANDBY_DB_DETAILSパラメータに、必要な値を適用します。

表48-47 単一インスタンス・スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name" : "Create Databases on RAC with SI  Standby",
"description" : "Creates Databases on RAC.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "647E8750A1C3835557165B499B269FB3" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"},
{"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"}
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name" : "REF_TGT",
"value" : "adc.us.example.com"},
{"name" : "REF_HOST",
"value" : "adc.us.example.com"},
{"name" : "REF_ZONE",
"value" : "Salt Lake City Zone"},
{"name" : "zoneTargetName",
"value" : "Salt Lake City Zone"},
{"name" : "REF_POOL",
"value" : "RAC Databases Pool"},
{"name" : "DATABASE_TYPE",
"value" : "oracle_database"},
{"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"},
{"name" : "LISTENER_PORT",
"value" : "1521"},
{"name" : "PROFILE_VERSION",
"value" : "latest"},
{"name" : "COMMON_DB_SID",
"value" : "db"},
{"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]},
{"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name" : "RMAN:DB_STORAGE_TYPE",
"value" : "FS"},
{"name" : "RMAN:FRA_SIZE",
"value" : "4038"},
{"name" : "RMAN:USE_ARCHIVING",
"value" : "NO"},
{"name" : "RMAN:DATA_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/oradata"},
{"name" : "RMAN:WORK_DIR_LOC",
"value" : "/tmp/work"},
{"name" : "RMAN:DB_ADMIN_PASSWORD_SAME",
"value" : "Y"},
{"name" : "RMAN:DATABASE_PASSWORDS",
"value" : "welcome"},
{"name" : "RMAN:BACKUP_LOCATION",
"value" : "/oradbnas/backups/rman/"},
{"name" : "RMAN:USE_OFA",
"value" : "N"},
{"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"},
{"name":"CUSTOM_PRE_CREATE_SCRIPTS_URN",
"value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},,
{"name":"CUSTOM_POST_CREATE_SCRIPTS_URN",
"value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},,
{"name": "STANDBY_REQUIRED",
"value": "true"},
{"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxx\" created successfully."
}

48.3.5.3.9 DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの作成

DBCAテンプレートを使用して、スタンバイを含むRACデータベース・サービス・テンプレートを作成するには、ServiceTemplatesコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。

表48-48 DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "Create RAC Db with Standby using DBCA Template - BofA -ASM",
"description": "Service Template for Non-CDB; 12cR1_2(12.1.0.2); RAC; ASM",
"serviceType": "DB",
"serviceTemplateTypeId": "61",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSAUSERROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"4C5795E605D71F59BAF9F6AD702E25E1"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246E84D11ED13BD0E050F90AE5852BC8:0.1"
}
],
"configurations": [
{
"name": "REF_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_POOL",
"value": "RAC Databases Pool_Oracle_DB_12c"
},
{
"name": "DBCA_TEMPLATE:DB_STORAGE_TYPE",
"value": "ASM"
},
{
"name": "DBCA_TEMPLATE:REC_STORAGE_TYPE_SAME_AS_DB_FILES",
"value": "Y"
},
{
"name": "DBCA_TEMPLATE:ARCHIVE_LOG_MODE",
"value": "N"
},
{
"name": "DBCA_TEMPLATE:FLASH_RECOVERY_AREA_SIZE",
"value": "4038"
},
{
"name": "DBCA_TEMPLATE:DATA_FILE_LOCATION",
"value": "DATA"
},
{
"name": "DBCA_TEMPLATE:REDO_FILE_LOCATION",
"value": "DATA1"
},
{
"name": "DBCA_TEMPLATE:RECOVERY_FILE_LOCATION",
"value": "DATA1"
},
{
"name": "DATABASE_TYPE",
"value": "rac_database"
},
{
"name": "INSTANCE_COUNT",
"value": "2"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "ORACLE.SYSMAN.SSA.PROVISIONING_TYPE",
"values": [
"DBCA_TEMPLATE"
]
},
{
"name": "ENTITY_TYPE",
"value": "USE_PROFILE"
},
{
"name": "REF_TGT",
"value": "xyz.example.com"
},
{
"name": "SID_OPTION",
"value": "prefix"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246E84D11ED13BD0E050F90AE5852BC8:0.1"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY"
},
{
"name": "COMMON_DB_SID",
"value": "RFTDB"
},
{
"name": "INIT_PARAMS",
"subconfigurations": [
"sga_target=1073741824",
"pga_aggregate_target=1073741824"
]
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_AT_RUNTIME"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome1"
},
{
"name": "DB_ADMIN_PASSWORD_SAME",
"value": "true"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "STANDBY_REQUIRED",
"value": "true"
},
{
"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
},
{
"name": "DATABASE_SIZES",
"values": [
"Big",
"Small"
]
},
{
"name": "DEFAULT_DATABASE_SIZE",
"value": "Big"
}
]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxxx\" created successfully."
}

48.3.5.3.10 DNFSベースのデータベース用のサービス・テンプレートの作成

DNFSベースのデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。

サンプルのPOSTの構成を次に示します:

表48-49 DNFSベースのデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name" : "DB Clones",
"description" : "This clones a database based on NFS.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "1898CF93BD39C19BF032672271BC4B44" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"}
{"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"}
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name" : "REF_TGT",
"value" : "abc.example.com"}
{"name" : "REF_HOST",
"value" : "abc.example.com"}
{"name" : "REF_ZONE",
"value" : "Salt Lake City Zone"}
{"name" : "zoneTargetName",
"value" : "Salt Lake City Zone"}
{"name" : "REF_POOL",
"value" : "Databases Pool"}
{"name" : "DATABASE_TYPE",
"value" : "oracle_database"}
{"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"}
{"name" : "LISTENER_PORT",
"value" : "1521"}
{"name" : "PROFILE_VERSION",
"value" : "latest"}
{"name" : "COMMON_DB_SID",
"value" : "db"}
{"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]}
{"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"}
{"name" : "DNFS.DATA_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/oradata"}
{"name" : "DNFS.REDO_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/fast_recovery_area"}
{"name" : "DNFS.RECOVERY_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/fast_recovery_area"}
{"name" : "DNFS.FRA_SIZE",
"value" : "4038"}
{"name" : "DNFS.USE_ARCHIVING",
"value" : "YES"}
{"name" : "DNFS.WORK_DIR_LOC",
"value" : "/tmp/work"}
{"name" : "DNFS.DB_ADMIN_PASSWORD_SAME",
"value" : "Y"}
{"name" : "DNFS.BACKUP_LOCATION",
"value" : "/scratch/emga/backups/rman_image/"}
{"name" : "DNFS.USE_OFA",
"value" : "N"}
{"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"} ]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxx\" created successfully."
}

48.3.5.3.11 スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートの作成

スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。

サンプルのPOSTの構成を次に示します:

表48-50 スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name" : "Create Snap Database using Snapshots",
"description" : "Creates Databases on SI hosts.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "503073C7912B1C65B66E240C433012A9" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:247BF4B378FF253FE053C075B10A794A:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"
}, {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:247BF4B378FF253FE053C075B10A794A:0.1"
}, {
"name" : "REF_TGT",
"value" : "xyz.example.com"
}, {
"name" : "REF_HOST",
"value" : "xyz.example.com"
}, {
"name" : "REF_ZONE",
"value" : "Single Instances Zone"
}, {
"name" : "zoneTargetName",
"value" : "Single Instances Zone"
}, {
"name" : "REF_POOL",
"value" : "SI Databases Pool - Version 11_2_0_4"
}, {
"name" : "DATABASE_TYPE",
"value" : "oracle_database"
}, {
"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"
}, {
"name" : "LISTENER_PORT",
"value" : "1521"
}, {
"name" : "PROFILE_VERSION",
"value" : "latest"
}, {
"name" : "COMMON_DB_SID",
"value" : "db"
}, {
"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]
}, {
"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
}, {
"name" : "THIN_PROVISIONING:LISTENER_PORT",
"value" : "1522"
}, {
"name" : "THIN_PROVISIONING:REDO_LOG_GROUP_COUNT",
"value" : "2"
}, {
"name" : "THIN_PROVISIONING:TEMP_TABLESPACE_SIZE",
"value" : "520"
}, {
"name" : "THIN_PROVISIONING:USE_ARCHIVING",
"value" : "YES"
}, {
"name" : "THIN_PROVISIONING:MOUNT_POINT_LIST",
"values" : [ "/hkdb" ]
}, {
"name" : "THIN_PROVISIONING:MOUNT_ADDL_SIZE_LIST",
"values" : [ "5.0" ]
}, {
"name" : "THIN_PROVISIONING:REDO_LOG_FILE_TYPE",
"value" : "Same as source"
}, {
"name" : "INIT_PARAMS",
"values" : [ "sga_target=1073741824", "pga_aggregate_target=1073741824" ]
}, {
"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"
} ]
}

注意:

- DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URNおよびDBAAS_SSA_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "values" ("lookupCharacteristics"の下で)として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxx\" created successfully."
}

48.3.5.3.12 スナップ・クローン単一インスタンス・データベース用(アーカイブが無効)のサービス・テンプレートの作成

スナップ・クローン単一インスタンス・データベース用(アーカイブが無効)のサービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。

アーカイブが有効ではないスナップ・クローンのREST APIの構成値はすべて、THIN_PROVISIONING:USE_ARCHIVINGパラメータを除き、アーカイブが有効なスナップ・クローンのREST APIと同じです。スナップ・クローン単一インスタンス・データベース(アーカイブが無効)用のサービス・テンプレートを作成するには、表48-50「スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートの作成のためのPOSTリクエスト構成」内で示すように、body内の"name" : "THIN_PROVISIONING:USE_ARCHIVING"が"value" : "No"に設定されている必要があります。

48.3.5.3.13 スキーマ用のサービス・テンプレートの作成

スキーマ・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、ServiceTemplatesにPOSTするための構成を示します。

表48-51 スキーマ用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name":"TestSchaasTemplate3",
"serviceType":"SCHEMA",
"serviceFamily":"DBAAS",
"description":"This is a test schaas service template 1",
"poolIds":[ "9D3187DE6B1115791D71D2827FB98558" ],
"roles":[
{ "name":"SSA_USER_ROLE1" }
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{ "name":"ROLE_NAME", "value":"SampleRole" },
{ "name":"MAX_NUMBER_OF_SCHEMAS","value":"2" },
{ "name":"ENFORCE_STORAGE_CONSTRAINT","value":"NO_LIMIT" },
{ "name":"AUTO_EXTEND_BLOCK_SIZE","value":"1024" },
{ "name":"REF_ZONE","value":"ABC_ZONE" },
{ "name":"REF_POOL","value":"SCH_POOL" },
{ "name":"REF_HOST","value":"abc.mycompany.com" },
{ "name":"REF_DB","value":"simple.us.example.com" },
{ "name":"CREATE_SCHEMA_OPTION","value":"EMPTY_SCHEMAS" },
{ "name":"SCHAAS_CUSTOM_PRE_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{ "name":"SCHAAS_CUSTOM_POST_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{
"name":"REMAP_TABLESPACE_LIST",
"value":"",
"values":["TBSP1","TBSP2","TBSP3"]
},
{
"name":"REMAP_TABLESPACE_INIT_SIZE_LIST",
"value":"",
"values":["TBSP1:0.1","TBSP2:0.2","TBSP3:0.3"]
},
{
"name":"REMAP_TABLESPACE_INCR_SIZE_LIST",
"value":"",
"values":["TBSP1:0.1","TBSP2:0.2","TBSP3:0.3"]
},
{
"name":"REMAP_TABLESPACE_MAX_SIZE_LIST",
"value":"",
"values":["TBSP1:50.0","TBSP2:30","TBSP3:20"]
},

{ "name":"CREATE_SCHEMA_OPTION","value":"EMPTY_SCHEMAS" },
{
"name":"WORKLOADS",
"subconfigurations":[
{
"name":"WORK_LOADS:1",
"subconfigurations":[
{ "name":"name",  "value":"large "  },
{ "name":"description", "value":"large workload" },
{   "name":"default",    "value":"Y" },
{   "name":"CPU",  "value":"6" },
{   "name":"Memory", "value":"4048"    },
{   "name":"Storage", "value":"2024"   }
]
}
]
}
]
}
}

注意:

SCHAAS_CUSTOM_PRE_SCRIPTS_URNおよびSCHAAS_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"name": "TestSchaasTemplate3",
"serviceFamily": "DBAAS",
"serviceType": "SCHEMA",
"type": "Service Template",
"description": "This is a test schaas service template 1",
"id": "E87A364660A25B39E040F20A60510FDD",
"pools": [
{
"name": "SCH_POOL",
"id": "9D3187DE6B1115791D71D2827FB98558",
"type": "schaas_pool",
"zone": {
"id": "2F1E72A95EC21F8F666451B5413FF99A",
"name": "ABC_ZONE"
}
}
],
"roles": [
{
"name": "SSA_USER_ROLE1",
"description": null
}
],
"serviceExecutableMeta": {
"type": "CDP",
"configurations": [
{
"id": "targets",
"name": "targets",
"value": ""
},
{
"id": "ssaRequestId",
"name": "ssaRequestId",
"value": ""
},
{
"id": "ssaUser",
"name": "ssaUser",
"value": ""
},
{
"id": "ssaTargetName",
"name": "ssaTargetName",
"value": ""
},
{
"id": "ssaTargetType",
"name": "ssaTargetType",
"value": ""
},
{
"id": "zoneTargetName",
"name": "zoneTargetName",
"value": ""
},
{
"id": "zoneTargetType",
"name": "zoneTargetType",
"value": ""
},
{
"id": "REQUEST_NAME",
"name": "REQUEST_NAME",
"value": ""
},
{
"id": "SERV_TEMPLATE_GUID",
"name": "SERV_TEMPLATE_GUID",
"value": ""
},
{
"id": "CREATE_SCHEMA_OPTION",
"name": "Option for creating user schemas",
"value": "EMPTY_SCHEMAS"
},
{
"id": "MAX_NUMBER_OF_SCHEMAS",
"name": "Maximum number of schemas permissible",
"value": "2"
},
{
"id": "DB_PROFILE_URN",
"name": "Database Profile Component's URN",
"value": ""
},
{
"id": "REMAP_SCHEMA_LIST",
"name": "Schema list",
"value": "",
"values": []
},
{
"id": "MASTER_ACCOUNT",
"name": "Master Account",
"value": ""
},
{
"id": "ROLE_NAME",
"name": "Database Role Name",
"value": "TestSchaasTemplate3_Oct_11_"
},
{
"id": "SCHEMA_PRIVILEGES",
"name": "Schema Privileges",
"value": "",
"values": [
"CREATE TYPE",
"CREATE SEQUENCE",
"CREATE DIMENSION",
"CREATE INDEXTYPE",
"CREATE SESSION",
"CREATE SYNONYM",
"CREATE OPERATOR",
"CREATE VIEW",
"CREATE TABLE",
"CREATE TRIGGER",
"CREATE PROCEDURE"
]
},
{
"id": "ENFORCE_STORAGE_CONSTRAINT",
"name": "Enforces Storage Constraint",
"value": "false"
},
{
"id": "INITIAL_BLOCK_SIZE",
"name": "Initial Storage Size",
"value": ""
},
{
"id": "AUTO_EXTEND_BLOCK_SIZE",
"name": "Auto extend block size",
"value": ""
},
{
"id": "TABLESPACE_ENCRYPTION_ALGORITHM",
"name": "Tablespace Encryption",
"value": ""
},
{
"id": "SHARED_STAGE_LOCATION",
"name": "Staging Location",
"value": ""
},
{
"id": "WORKING_DIRECTORY",
"name": "Working Directory",
"value": ""
},
{
"id": "SCHAAS_CUSTOM_PRE_SCRIPTS_URN",
"name": "Pre-script",
"value": ""
},
{
"id": "SCHAAS_CUSTOM_POST_SCRIPTS_URN",
"name": "Post-script",
"value": ""
},
{
"id": "SCHEMA_PASSWORD_LIST",
"name": "Schema password list",
"value": "",
"values": []
},
{
"id": "CUSTOM_USER_SELECTED_SCRIPT_URN",
"name": "Custom Script URN",
"value": "",
"values": []
},
{
"id": "DBSERVICE_NAME",
"name": "Database Service Name",
"value": ""
}
]
},
"createdOn": null,
"createdBy": null,
"modifiedOn": null,
"modifiedBy": null,
"owner": "SYSMAN",
"etag": null,
"lastModified": null,
"canonicalLink": "https://abc.mycompany.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E87A364660A25B39E040F20A60510FDD",
"selfLink": "https://abc.mycompany.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E87A364660A25B39E040F20A60510FDD"
}

48.3.5.3.14 プラガブル・データベース用のサービス・テンプレートの作成

プラガブル・データベースのサービス・テンプレートを作成するには、ServiceTemplatesコレクション・リソースに対してPOST操作を発行します。次に、ServiceTemplatesにPOSTするための構成を示します。

表48-52 プラガブル・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/ cloudservices/admin/cfw/v1/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name":"TestPDbTemplate1",
"serviceType":"PDB",
"serviceFamily":"DBAAS",
"description":"This is a test pluggable database service template 1",
"poolIds":[ "FF394120842D8C71CC92BE6A4D5A488E" ],
"roles":[
{ "name":"SSA_USER_ROLE1" }
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{
"name":"TABLESPACE_ENCRYPTION_ALGORITHM",
"subconfigurations":[
{  "name":"name", "value":"NONE" }
]
},
{  "name":"MAX_TABLESPACE_ALLOWED", "value":"2" },
{  "name":"PDB_SID_PREFIX", "value":"mypdb" },
{  "name":"ENFORCE_STORAGE_CONSTRAINT", "value":"NO_LIMIT" },
{  "name":"AUTO_EXTEND_BLOCK_SIZE","value":"1024" },
{  "name":"REF_DATA_ZONE", "value":"PDB_Zone" },
{  "name":"REF_DATA_TARGET", "value":"database" },
{  "name":"REF_DATA_TARGET_TYPE", "value":"oracle_database" },
{  "name":"REF_DATA_POOL","value":"PDB_POOL" },
{  "name":"REF_DATA_HOST", "value":"abc.mycompany.com" },
{  "name":"SELECT_TARGET_OPTION", "value":"SELECT_TARGET_FROM_REQUEST" },
{  "name":"CREATE_PDB_OPTION", "value":"EMPTY_PDB" },
{"name":"PDBAAS_CUSTOM_PRE_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{"name":"PDBAAS_CUSTOM_POST_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{  "name":"PRIVILEGES",
"value":"",
"values":["CREATE TYPE","CREATE VIEW","CREATE DIMENSION","CREATE SESSION","CREATE TRIGGER","CREATE OPERATOR","CREATE SYNONYM","CREATE TABLE","CREATE PROCEDURE","CREATE INDEXTYPE","CREATE SEQUENCE"]
},
{  "name":"ROLE_OPTION","value":"CUSTOM_NEW_ROLE" },
{
"name":"INIT_PARAMS",
"subconfigurations":[
{ "name":"INIT_PARAMS:1", "value":"*.cursor_sharing=EXACT" },
{ "name":"INIT_PARAMS:2", "value":"*.open_cursors=200"  }
]
},
{
"name":"WORKLOADS",
"subconfigurations":[
{
"name":"WORK_LOADS:1",
"subconfigurations":[
{ "name":"name", "value":"SmallPdb" },
{ "name":"description", "value":"small workload" },
{  "name":"default", "value":"N" },
{  "name":"CPU", "value":"2" },
{  "name":"Memory", "value":"2048" },
{  "name":"Storage", "value":"1024" },
{  "name":"Sessions", "value":"100" }
]
}
]
}
]
}
}

注意:

- PDBAAS_CUSTOM_PRE_SCRIPTS_URNおよびPDBAAS_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_DATA_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "poolIds"として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

注意:
前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PDBに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。

受け取るレスポンスの例を次に示します。

{
"name":"TestPDbTemplate1",
"serviceFamily":"DBAAS",
"serviceType":"PDB",
"type":"Service Template",
"description":"This is a test pluggable database service template 1",
"id":"E8887DEEE424BEAEE040F20A605118CE",
"pools":[
{
"name":"PDB_POOL",
"id":"FF394120842D8C71CC92BE6A4D5A488E",
"type":"pdbaas_pool",
"zone":{"id":"B60C4DA1398F41BEBC862D5A10A0C713",
"name":"PDB_Zone"}
}
],
"roles":[
{"name":"SSA_USER_ROLE1","description":null}
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{"id":"CREATE_PDB_OPTION","name":"Option for creating Pluggable Database","value":"EMPTY_PDB"},
{"id":"PROFILE_URN","name":"Profile Component's URN","value":""},
{"id":"MAX_TABLESPACE_ALLOWED","name":"Maximum number of Tablespaces","value":"2"},
{"id":"ENFORCE_STORAGE_CONSTRAINT","name":"Enforce Storage Constraint","value":"false"},
{"id":"TABLESPACE_ENCRYPTION_ALGORITHM","name":"Tablespace Encryption","value":"","values":["NONE"]},
{"id":"TABLESPACE_SIZE","name":"Tablespace Size","value":"","values":[]},
{"id":"SHARED_STAGE_LOCATION","name":"Staging Location","value":""},
{"id":"WORKING_DIRECTORY","name":"Working Directory","value":""},
{"id":"PDBAAS_CUSTOM_PRE_SCRIPTS_URN","name":"URN of the pre sql custom script","value":""},
{"id":"PDBAAS_CUSTOM_POST_SCRIPTS_URN","name":"URN of the post sql custom script","value":""},
{"id":"PDB_SID_PREFIX","name":"Pluggable Database SID Prefix","value":"mypdb"},
{"id":"PDB_ADMIN_USER_NAME","name":"Pluggable Database Administrator","value":""},
{"id":"PDB_ADMIN_PASSWORD","name":"Pluggable Administrator Password"},
{"id":"PDB_SERVICE_NAME_PREFIX","name":"Pluggable Database Service Name Prefix","value":""},
{"id":"PDBSERVICE_NAME","name":"Pluggable Database Service Name","value":""},
{"id":"ROLE_OPTION","name":"Role Option Custom New Role/ Existing Roles","value":"CUSTOM_NEW_ROLE"},
{"id":"INIT_PARAMS","name":"Initialization parameter values passed as list","value":"","values":["*.open_cursors=200","*.cursor_sharing=EXACT"]},
{"id":"CUSTOM_ROLE_NAME","name":"Database Role Name","value":"PDBAAS_OCT_12_2013_02_13_AM"},
{"id":"CUSTOM_ROLE_DESC","name":"Database Role Description","value":"New db role to be assigned to pluggable database administrator."},
{"id":"PRIVILEGES","name":"Custom Role Privileges","value":"","values":["CREATE ANY SYNONYM","CREATE ANY OPERATOR","CREATE SESSION","CREATE JOB","CREATE ANY TYPE","CREATE INDEXTYPE","SELECT ANY DICTIONARY","CREATE ANY SEQUENCE","CREATE DIMENSION","CREATE ANY DIRECTORY","CREATE ANY INDEX","CREATE ANY TABLE","CREATE ANY PROCEDURE","ALTER SESSION","CREATE ANY MATERIALIZED VIEW","CREATE ANY TRIGGER","CREATE ANY VIEW"]},
{"id":"ROLES","name":"List of roles selected from reference database","value":"","values":[]}
]
},
"createdOn":null,
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://abc.mycompany.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E8887DEEE424BEAEE040F20A605118CE",
"selfLink":"https://abc.mycompany.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E8887DEEE424BEAEE040F20A605118CE"
}

48.3.5.3.15 空のプラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成

空のプラガブル・データベースを使用して、RACプラガブル・データベース用のサービス・テンプレートを作成するには、ServiceTemplatesコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します:

表48-53 空のプラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "Create RAC PDBs using empty PDB option",
"description": "Creates PDBs on cluster.",
"serviceType": "PDB",
"serviceTemplateTypeId": "94",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSA_USER_ROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.PDBAAS_POOL",
"values": [
"DFB8F2A53429AF99EF2020C56E11FEE9"
],
"targetType": {
"targetType": "pdbaas_pool",
"targetTypeName": "Pluggable Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "DBDELETE_PRESCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D511C1CFFE053C075B10AEF2D:0.1"
},
{
"name": "DBDELETE_POSTSCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D51201CFFE053C075B10AEF2D:0.1"
}
],
"characteristics": [
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"value": "Development",
"required": true,
"editable": false,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": "Bangalore",
"required": false,
"editable": true,
"visible": true
}
],
"configurations": [
{
"name": "REF_DATA_ZONE",
"value": "Single Instances Zone"
},
{
{
"name":SELECT_TARGET_OPTION"
"value":SELECT_TARGET_FROM_REQUEST"
},
"name": "CUSTOM_ROLE_NAME",
"value": "PDBAAS_NOV_13_2015_16_51_PM"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:null:false:false",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:Development:true:true",
"Comment:This is for testing:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "PDBAAS_CUSTOM_PRE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7B4E34E053C075B10A74AD:0.2"
},
{
"name": "WORKLOADS",
"subvalues": [
{
"name": "Small",
"subvalues": [
{
"name": "name",
"value": "SmallPdb"
},
{
"name": "description",
"value": "small workload"
},
{
"name": "default",
"value": "N"
},
{
"name": "CPU",
"value": "2"
},
{
"name": "Memory",
"value": "2"
},
{
"name": "Storage",
"value": "5"
},
{
"name": "Sessions",
"value": "100"
}
]
}
]
},
{
"name": "PRIVILEGES",
"type": "VECTOR",
"description": "List of privileges of custom new role that will be applied on pluggable database administrator.",
"displayName": "PRIVILEGES",
"required": false,
"secret": false,
"values": [
"CREATE SESSION",
"ALTER SESSION",
"CREATE DIMENSION",
"CREATE INDEXTYPE",
"CREATE ANY OPERATOR",
"CREATE ANY PROCEDURE",
"CREATE ANY SEQUENCE",
"CREATE ANY INDEX",
"CREATE JOB",
"CREATE ANY MATERIALIZED VIEW",
"CREATE ANY TABLE",
"CREATE ANY TRIGGER",
"CREATE ANY TYPE",
"CREATE ANY VIEW",
"CREATE ANY SYNONYM",
"CREATE ANY DIRECTORY",
"SELECT ANY DICTIONARY",
"SELECT ANY TABLE"
]
},
{
"name": "REF_DATA_TARGET_TYPE",
"value": "rac_database"
},
{
"name": "REF_DATA_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_DATA_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_DATA_TARGET",
"value": "cdbfs"
},
{
"name": "REF_DATA_POOL",
"value": "RAC Pluggable DBs"
},
{
"name": "PDBAAS_CUSTOM_POST_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7F4E34E053C075B10A74AD:0.2"
},
{
"name": "SELECT_TARGET_OPTION",
"value": "SELECT_TARGET_AT_RUNTIME"
},
{
"name": "MAX_TABLESPACE_ALLOWED",
"value": "1"
},

{
"name": "ROLE_OPTION",
"value": "CUSTOM_NEW_ROLE"
},
{
"name": "CREATE_PDB_OPTION",
"value": "EMPTY_PDB"
},{
"name": "INIT_PARAMS",
"values": [
"*.cursor_sharing=EXACT",
"*.open_cursors=300"
]
}

]
}

注意:

- PDBAAS_CUSTOM_PRE_SCRIPTS_URNおよびPDBAAS_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_DATA_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "poolIds"として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

注意:
前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PBDに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxxx\" created successfully."
}

48.3.5.3.16 プロファイル・プラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成

プロファイル・プラガブル・データベースを使用して、RACプラガブル・データベース用のサービス・テンプレートを作成するには、ServiceTemplatesコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します:

表48-54 プロファイル・プラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "Create RAC PDBs using Profile PDB option",
"description": "Creates PDBs on cluster.",
"serviceType": "PDB",
"serviceTemplateTypeId": "94",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSA_USER_ROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.PDBAAS_POOL",
"values": [
"DFB8F2A53429AF99EF2020C56E11FEE9"
],
"targetType": {
"targetType": "pdbaas_pool",
"targetTypeName": "Pluggable Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "DBDELETE_PRESCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D511C1CFFE053C075B10AEF2D:0.1"
},
{
"name": "DBDELETE_POSTSCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D51201CFFE053C075B10AEF2D:0.1"
}
],
"characteristics": [
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"displayName": "Contact",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"displayName": "Cost Center",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DOWNTIME_CONTACT",
"displayName": "Downtime Contact",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"displayName": "Lifecycle Status",
"values": [
"Development",
"MissionCritical",
"Production",
"Stage",
"Test"
],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"displayName": "Line of Business",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": [],
"required": false,
"editable": true,
"visible": true
}
],
"configurations": [
{
"name": "REF_DATA_ZONE",
"value": "Single Instances Zone"
},
{
"name":SELECT_TARGET_OPTION"
"value":SELECT_TARGET_FROM_REQUEST"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:null:false:false",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:Development:true:true",
"Comment:This is for testing:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "PDBAAS_CUSTOM_PRE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7B4E34E053C075B10A74AD:0.2"
},
{
"name": "WORKLOADS",
"subvalues": [
{
"name": "Small",
"subvalues": [
{
"name": "name",
"value": "SmallPdb"
},
{
"name": "description",
"value": "small workload"
},
{
"name": "default",
"value": "N"
},
{
"name": "CPU",
"value": "2"
},
{
"name": "Memory",
"value": "2"
},
{
"name": "Storage",
"value": "5"
},
{
"name": "Sessions",
"value": "100"
}
]
}
]
},
{
"name": "ROLE_OPTION",
"value": "CUSTOM_NEW_ROLE"
},
{
"name": "CUSTOM_ROLE_NAME",
"value": "PDBAAS_NOV_13_2015_16_51_PM"
},
{
"name": "CUSTOM_ROLE_DESC",
"value": "New db role to be assigned to pluggable database administrator."
},
{
"name": "PRIVILEGES",
"values": [
"CREATE SESSION",
"ALTER SESSION",
"CREATE DIMENSION",
"CREATE INDEXTYPE",
"CREATE ANY OPERATOR",
"CREATE ANY PROCEDURE",
"CREATE ANY SEQUENCE",
"CREATE ANY INDEX",
"CREATE JOB",
"CREATE ANY MATERIALIZED VIEW",
"CREATE ANY TABLE",
"CREATE ANY TRIGGER",
"CREATE ANY TYPE",
"CREATE ANY VIEW",
"CREATE ANY SYNONYM",
"CREATE ANY DIRECTORY",
"SELECT ANY DICTIONARY",
"SELECT ANY TABLE"
]
},
{
"name": "REF_DATA_TARGET_TYPE",
"value": "rac_database"
},
{
"name": "REF_DATA_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_DATA_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_DATA_TARGET",
"value": "cdbfs"
},
{
"name": "REF_DATA_POOL",
"value": "RAC Pluggable DBs"
},
{
"name": "PDBAAS_CUSTOM_POST_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7F4E34E053C075B10A74AD:0.2"
},
{
"name": "SELECT_TARGET_OPTION",
"value": "SELECT_TARGET_AT_RUNTIME"
},
{
"name": "MAX_TABLESPACE_ALLOWED",
"value": "1"
},
{
"name": "CREATE_PDB_OPTION",
"value": "PDB_FROM_PROFILE"
},
{
"name": "PROFILE_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246C1E85296C29A1E053C075B10A7DFA:0.1"
},
{
"name": "SHARED_STAGE_LOCATION",
"value": "/u04/app/hhkaur/product/12.1.0/dbhome_2/rdbms/xml/schema"
},
{
"name": "TABLESPACE_SIZE",
"values": [
"0.7715",
"0.6152",
"0.0586",
"0.0049"
]
},
{
"name": "INIT_PARAMS",
"values": [
"*.cursor_sharing=EXACT",
"*.open_cursors=300"
]
},
{
"name": "PDB_SID_PREFIX",
"value": "prp"
}
]
}

注意:

- PDBAAS_CUSTOM_PRE_SCRIPTS_URNおよびPDBAAS_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、emcli list_swlib_entities -name="<Pre or Post Standby Database Script>" -show_entity_rev_id EM CLIコマンドを実行します。IDは出力の最後に提供されます。たとえば、次に示す出力では、oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1がIDとなります。

Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1

- サービス・テンプレートと関連付けるREF_DATA_ZONEを取得するには、第46.4.1項「クラウド・リソース」で説明するように、GETリクエストを実行します。

- "poolIds"として入力する必要があるソフトウェア・プールのIDを取得するには、第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」で説明するように、GETリクエストを実行します。

- serviceTemplateTypeId値を取得するには、GET操作をURI - em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesで実行し、JSONレスポンス内に"serviceType":"DB"を配置します。"serviceType":"DB"の下でserviceTemplateTypeIdを書き留め、値を上記で示すPOST bodyで使用します。

リクエスト・メソッド

POST

注意:
前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PBDに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。

受け取るレスポンスの例を次に示します。

{
"message": "Service template with ID \"xxxxx\" created successfully."
}

48.3.5.3.17 データベース/スキーマ/プラガブル・データベースのサービス・テンプレートの削除

ServiceTemplateのURIでDELETEリクエストを発行して、ServiceTemplateインスタンスを削除できます。ServiceTemplateの削除の構成を次に示します。

表48-55 データベース/スキーマ/プラガブル・データベース・サービス・テンプレートを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/ cloudservices/admin/cfw/v1/servicetemplates/E87A364660A25B39E040F20A60510FDD

注意: データベース・サービス・テンプレートのURI: em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"message": "Service Template \"E87A364660A25B39E040F20A60510FDD\" deleted successfully."
}

49 Database as a Service SSAユーザーREST API

この章では、SSAユーザー用のDatabase as a Service (DBaaS) REST APIのリソース・モデルとそのレスポンスについて説明します。

SSAユーザー用のREST APIは、データベース・タイプに基づいて分類されます。この章の最初の項で、この章のすべてのREST APIのサマリーを示し、その後の項でデータベース・タイプに基づくREST APIについて説明します。この章に含まれている項は次のとおりです。

- Database as a Service SSAユーザーREST APIのサマリー

- Database as a Service(サービスとしてのデータベース)

- DB Zone

- DBプラットフォーム・テンプレート

- DBプラットフォーム・インスタンス

- Schema as a Service

- スキーマ・プラットフォーム・テンプレート

- スキーマ・プラットフォーム・インスタンス

- Pluggable Database as a Service

- プラガブルDBプラットフォーム・テンプレート

- プラガブルDBプラットフォーム・インスタンス

49.1 Database as a Service SSAユーザーREST APIのサマリー

次の表に、この章で説明するすべてのDBaaS SSAユーザーREST APIをまとめています。

表49-1 DBaaS SSAユーザーREST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

Cloud

該当なし

- 第49.2.3.1項

- 第49.2.3.2項

サポート対象外

サポート対象外

サポート対象外

サービス・ファミリ・タイプ

該当なし

第49.2.3.3項

サポート対象外

サポート対象外

サポート対象外

サービス・インスタンス・タイプ

該当なし

第49.2.3.4項

サポート対象外

サポート対象外

サポート対象外

サービス・リクエスト

該当なし

第49.2.3.5項

サポート対象外

サポート対象外

サポート対象外

データベース・ゾーン

表49-2

第49.2.3.6項

- 第49.2.3.8.1項

- 第49.3.3.2.1項

- 第49.4.3.2.1項

サポート対象外

サポート対象外

データベース・プラットフォーム・テンプレート

表49-3

第49.2.3.7項

第49.2.3.8.2項

サポート対象外

サポート対象外

データベース・プラットフォーム・インスタンス

表49-4

第49.2.3.9項

- 第49.2.3.10項

- 第49.2.3.12項

- 第49.2.3.13項

サポート対象外

第49.2.3.11項

スキーマ・プラットフォーム・テンプレート

表49-30

第49.3.3.1項

第49.3.3.2.2項

サポート対象外

サポート対象外

スキーマ・プラットフォーム・インスタンス

表49-31

第49.3.3.3項

第49.3.3.5項

サポート対象外

第49.3.3.4項

プラガブル・データベース・プラットフォーム・テンプレート

表49-43

第49.4.3.1項

第49.4.3.2.2項

サポート対象外

サポート対象外

プラガブル・データベース・プラットフォーム・インスタンス

表49-44

第49.4.3.3項

第49.4.3.5項

サポート対象外

第49.4.3.4項

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

49.2 Database as a Service

この項では、Database as a Service (DBaaS) REST APIのリソース・モデルおよびRESTリクエスト/レスポンス相互作用について説明します。

この項には次のトピックが含まれます:

- Database as a Serviceのリソース・モデル

- Database as a Serviceリソースのサポートされる操作

- Database as a Service REST APIの例

注意:
DBaaS REST APIは、次のOracle Cloud Applicationプラグイン・バージョンでのみサポートされます。

- パッチ# 16085618適用済の12.1.0.4.0

- 12.1.0.5.0以上

49.2.1 Database as a Serviceのリソース・モデル

クラウドのリソースは、共通サービス・エンティティで編成されており、特定のサービス(Database as a Serviceなど)がこれらの共通サービス・エンティティを拡張することでリソースを提供しています。図49-1はDBaaSリソース・モデルを示しています。

図49-1 Database as a Serviceのリソース・モデル

次の各項では、Database as a Serviceファミリ・タイプでサポートされるリソースについて説明し、サポートされる操作の例を示します。

リソース・モデルは次のとおりです。

- DB Zone

- DBプラットフォーム・テンプレート

- DBプラットフォーム・インスタンス

49.2.1.1 DBゾーン

DBゾーンはapplication/oracle.com.cloud.common.Zoneを拡張します。このリソースは、DBaaSリソースをサポートするPaaSインフラストラクチャ・ゾーンのビューを表します。DBゾーンのメディア・タイプはapplication/oracle.com.cloud.common.DbZone+json、URIの形式は/em/cloud/dbaas/zone/<zone id>です。

次の表に、DBゾーンのデータ・モデルを示します。

表49-2 DBゾーンのデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーに対するゾーン定義のクライアント表現がリフレッシュされます。

1

name

文字列

ゾーンの名前。様々な言語をサポートするUNICODE文字列になります。

1

description

文字列

ゾーンのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

0..1

resource_state

ResourceState

リソースのリソース状態。

1

service_family_type

文字列

このゾーンが関連付けられているサービス・ファミリ・タイプの名前。

この場合、"dbaas"です。

1

テンプレート

コレクション<ServiceTemplate>

このゾーンがサポートする、このゾーンをデプロイ可能なサービス・テンプレートのコレクション。現在、サポートされているタイプは、DBPlatformTemplateのみです。

1

service_instances

コレクション<ServiceInstance>

このゾーンに作成されるサービス・インスタンスのコレクション。

1

media_type

文字列

リソースのメディア・タイプ。

1

type

文字列

デフォルトで”self_service_zone”になるゾーンのタイプ。

1

context_id

文字列

ゾーンのGUID

1

canonicalLink

URI

GETおよびPOSTなどのクラウド相互作用の実行に使用できます。

1

default_db_size_name

文字列

選択されたデフォルトのデータベース・サイズ。

1

db_sizes

List<Object>

使用可能なデータベース・サイズのリスト。

1

49.2.1.2 DBプラットフォーム・テンプレート

DBプラットフォーム・テンプレートはサービス・テンプレートのリソースを拡張します。このリソースは、データベースを作成するために作成されたサービス・テンプレートを表します。データベースは、データベース・テンプレート、RMANバックアップおよびスナップクローンを使用して作成されたプロファイルを使用して作成できます。DBプラットフォーム・テンプレートのインスタンスでService Templateメディア・タイプを受け入れることができます。また、DBプラットフォーム・インスタンス・リソースを認識する事前構成されたデプロイ可能なサービスです。DBプラットフォーム・テンプレートのメディア・タイプはapplication/oracle.com.cloud.common.DbPlatformTemplate+json、URIの形式は/em/cloud/dbaas/dbplatformtemplate/<template id>です。

次の表に、DBプラットフォーム・テンプレートのデータ・モデルを示します。

表49-3 DBプラットフォーム・テンプレート・データ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

テンプレートのユーザー用の名前。

1

description

文字列

テンプレートの簡単な説明

0..1

created

Timestamp

テンプレートが作成または最後に変更された日付と時刻(ISO 8601形式)。

1

zones

コレクション<DbZone>

このサービス・テンプレートが公開されるすべてのゾーンのリスト

1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

service_family_type

文字列

サービス・テンプレートのタイプを表します。たとえば、"dbaas"です。

1

service_instances

コレクション<DBPlatformInstance>

このDBPlatformTemplateに基づいて作成されたすべてのサービス・インスタンス。

1

media_type

文字列

このタイプが表すサービス・テンプレートのメディア・タイプ。

1

db_type

文字列

プロビジョニングされる際のデータベースのタイプ。oracle_databaseおよびrac_databaseの2つの値のいずれかになります。

1

instance_configurable_params

文字列[]

このテンプレートからDbPlatformInstanceをプロビジョニングするのに必要なパラメータのリスト。この場合はユーザー名、パスワード、SIDおよびサービス名。

1

deployment_params

List<Object>

サービス・インスタンスの作成時に必要なパラメータの説明。

1

type

文字列

サービス・テンプレートのタイプ(デフォルトはdbaas)。

1

subtype

文字列

このテンプレートに基づいて作成されるインスタンスのサブ・タイプ。

この場合、値はdbです。

1

node_count

ノード数。SI DBの場合は暗黙的に1、RAC DBタイプの場合は明示的な件数です。

0..1

db_version

文字列

このテンプレートを使用して作成可能なデータベースのバージョン。

0..1

context_id

URI

テンプレートの一意のID。

1

canonicalLink

URI

GETおよびPOSTなどのクラウド相互作用の実行に使用できます。

1

sid_option

文字列

ssaユーザーがDBのリクエスト中にデータベースSIDを指定するためのオプション。このフィールドは、次のいずれかの値を取ります。

- 'ssauser' - SSAユーザーはSIDを指定する必要があります。

- 'prefix' - SSAユーザーはSIDを指定する必要はありません。

1

standby_enabled

文字列

テンプレート内でスタンバイが有効化されているか否かを示します。

1

standbydbs

List<Object>

スタンバイ・データベース構成のリスト。

1

standby_protection_mode

文字列

スタンバイ・データベースの保護モードを示します。

1

db_sizes

List<Object>

使用可能なデータベース・サイズのリスト。

1

default_db_size_name

文字列

選択されたデフォルトのデータベース・サイズ。

1

49.2.1.3 DBプラットフォーム・インスタンス

DBプラットフォーム・インスタンスはサービス・インスタンスのリソースを拡張します。Enterprise Manager Cloud ControlでOracle Databaseインスタンスまたはクラスタ・データベースのターゲットにリンクされます。DBプラットフォーム・インスタンスのメディア・タイプはapplication/oracle.com.cloud.common.DbPlatformInstance+json、URIの形式は/em/cloud/dbaas/dbplatforminstance/byrequest/<request id>です。

次の表に、DBプラットフォーム・インスタンスのデータ・モデルを示します。

表49-4 DBプラットフォーム・インスタンス・データ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

インスタンスのユーザー用の名前。

[POST]

1

destination_zone

ゾーン

インスタンスがデプロイされるゾーン。

[POST]

1

media_type

文字列

GETの実行にクライアントが使用できる追加のメディア・タイプを示します。

1

available_space

浮動小数

このデータベース・インスタンスに使用可能な領域。

0..1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

based_on

DbPlatformTemplate

このインスタンスが公開されるdbプラットフォーム・テンプレート。

1

connect_string

文字列

このデータベース・インスタンスへの接続を確立するために必要な接続文字列。

0..1

created

文字列

作成時間。

1

target_type

文字列

データベースのタイプとして、oracle_databaseは単一インスタンス・データベース、rac_databaseはRACデータベースをそれぞれ示します。

1

status

文字列

データベース・インスタンスのステータス。

1

db_version

文字列

データベースのバージョン。

0..1

last_backup

Timestamp

このデータベースの最後のバックアップが取得された時間。

0..1

load

浮動小数

このインスタンスの現在の平均アクティブ・セッション。

0..1

master_username

文字列

このデータベースのマスター・ユーザーの名前。

1

total_sessions

整数

このデータベースのセッションの合計数。

0..1

total_sga^

浮動小数

このデータベースのSGAの合計数。

0..1

up_time^

整数

このデータベースが起動されてからの合計時間数。

1

context_id

文字列

このインスタンスのリクエストID。

1

canonicalLink

URI

このインスタンスのGETやDELETEなどのクラウド相互作用の実行に使用できます。

1

インスタンス

List<Object>

データベース・インスタンスのすべてのノード・レベルの詳細を表示します(タイプがrac_databaseの場合にのみ存在します)。

0..1

measurable_attributes

List<Object>

測定可能なユニット付きのすべての属性のリスト。

1

total_memory*^

文字列

インスタンス(ノード)によって使用される合計メモリー。

0..1

active_sessions*

浮動小数

このインスタンス(ノード)の現在の平均アクティブ・セッション。

0..1

cpu_utilization*^

パーセンテージ

このインスタンス(ノード)のCPU使用率。

0..1

db_time*^

浮動小数

このインスタンス(ノード)のデータベース時間。

0..1

cpu_count*^

整数

インスタンス(ノード)がデプロイされるホストのCPUコアの数。

0..1

allocated_sessions*

整数

現在割り当てられているセッションの数。

0..1

name*

文字列

ノードの名前(instancesフィールドのリストにフィールドとして存在します)。

0..1

standby_databases

List<Object>

このインスタンス用に構成されたスタンバイ・データベースのリスト。

1

standby_database_configured

文字列

スタンバイ・データベースがこのサービス・インスタンス用に構成されているか否かを示す。

1

注意:

* データベース・インスタンス・タイプがoracle_databaseの場合、前述のフィールドはそのままDBPlatformInstanceデータ・モデルに存在します。タイプがrac_databaseの場合、これらのフィールドは「インスタンス」フィールドの一部として存在し、クラスタ・データベースの各ノードに対して発生します。

^ - これらの属性は、ユニット単位で測定されるため、マップと同じようにname (属性の名前として)、value (属性の値として)およびunits (属性の単位として)の属性を持つJsonオブジェクトとして表されます。そのようなフィールドはそれぞれに、「measurable_attributes」フィールドのリスト要素です。「measurable_attributes」フィールドは、oracle_databaseのインスタンス・レベルおよびrac_databaseの場合にはRACノード・レベルに存在します。

49.2.2 Database as a Serviceリソースのサポートされる操作

次の表に、Database as a Serviceの各種リソースでサポートされるすべての操作を示します。

表49-5 DBaaSリソースのサポートされる操作

リソース

GET

POST

PUT

DELETE

Cloud

はい

いいえ

いいえ

いいえ

サービス・ファミリ・タイプ

はい

いいえ

いいえ

いいえ

DBゾーン

はい

はい

いいえ

いいえ

DBプラットフォーム・テンプレート[サービス・テンプレート]

はい

はい

いいえ

いいえ

DBプラットフォーム・インスタンス[サービス・インスタンス]

はい

はい

いいえ

はい

49.2.3 Database as a Service REST APIの例

次の各項では、Enterprise Manager Cloud Controlとクラウド・アプリケーション・プラグイン12.1.0.4以上との相互作用の例を示します。次の例について説明します。

- すべてのクラウド・リソースの詳細の表示

- 特定のリソース属性の出力のフィルタ処理

- サービス・ファミリ・タイプ・リソースの詳細の表示

- サービス・インスタンス・タイプ・リソースの詳細の表示

- DBゾーンの詳細の表示

- DBプラットフォーム・テンプレート・リソースの詳細の表示

- データベース・インスタンスの作成

- DBゾーンへのリクエスト渡しによるデータベースの作成

- DBプラットフォーム・テンプレートへのリクエスト渡しによるデータベースの作成

- データベース作成の詳細の表示

- データベースの更新

- データベース・インスタンスの削除

- データベース・インスタンスに対するライフサイクル操作

- データベースの停止

- データベースの起動

- データベースのバックアップのスケジュール

- バックアップからのデータベースのリストア

- スタンバイ・データベースの追加

- スタンバイ・データベースの削除

- データベースのリフレッシュ

- スナップ・クローン・データベース・インスタンスに対するライフサイクル操作

- スナップショットの作成

- スナップショット・リストからのリストア

- スナップショットの削除

49.2.3.1 すべてのクラウド・リソースの詳細の表示

最上位の/em/cloudを使用してクラウド・リソースをイントロスペクトします。ここで説明する操作によって、ユーザーがアクセス可能なすべてのリソースがリストされます。

表49-6 すべてのクラウド・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

X-specification-Version: 10001

本文

なし

リクエスト・メソッド

GET

クラウド・リソースのサンプルを次に示します。

{
"uri": "/em/cloud",
"name": "Oracle Cloud by Enterprise Manager",
"description": "This represents the Cloud resource of the Oracle Enterprise Manager Cloud Management solution",
"resource_state": {
"state": "READY"
},
"media_type": "application/oracle.com.cloud.common.Cloud+json",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud",
"zones": {
"media_type": "application/oracle.com.cloud.common.Zone+json",
"total": "4",
"elements": [
{
"uri": "/em/cloud/jaas/zone/9708491651C090AB4B847C2F3CD177DE",
"name": "SLC00ECXY_ZONE",
"media_type": "application/oracle.com.cloud.jaas.Zone+json",
"service_family_type": "jaas",
"type": "jaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/9708491651C090AB4B847C2F3CD177DE"
},
{
"uri": "/em/cloud/jaas/zone/B329742A13BE0D63703BF0C0E4F98FB9",
"name": "SLC01NBV_ZONE",
"media_type": "application/oracle.com.cloud.jaas.Zone+json",
"service_family_type": "jaas",
"type": "jaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/B329742A13BE0D63703BF0C0E4F98FB9"
},
{
"uri": "/em/cloud/dbaas/zone/9708491651C090AB4B847C2F3CD177DE",
"name": "SLC00ECXY_ZONE",
"description": "",
"media_type": "application/oracle.com.cloud.common.DbZone+json",
"service_family_type": "dbaas",
"type": "self_service_zone",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/9708491651C090AB4B847C2F3CD177DE"
},
{
"uri": "/em/cloud/dbaas/zone/B329742A13BE0D63703BF0C0E4F98FB9",
"name": "SLC01NBV_ZONE",
"description": "SLC01NBV_ZONE",
"media_type": "application/oracle.com.cloud.common.DbZone+json",
"service_family_type": "dbaas",
"type": "self_service_zone",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/B329742A13BE0D63703BF0C0E4F98FB9"
}
]
},
"service_templates": {
"media_type": "application/oracle.com.cloud.common.ServiceTemplate+json",
"total": "2",
"elements": [
{
"uri": "/em/cloud/dbaas/dbplatformtemplate/DEC94FE6D49DAA21E040F20A60511D14",
"name": "SLC01NBV_SNAPCLONE_ST",
"description": "",
"media_type": "application/oracle.com.cloud.common.DbPlatformTemplate+json",
"service_family_type": "dbaas",
"type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatformtemplate/DEC94FE6D49DAA21E040F20A60511D14"
},
{
"uri": "/em/cloud/dbaas/dbplatformtemplate/DECCA0E18357F28DE040F20A60514D49",
"name": "SLC00ECXY_DBCA_ST",
"description": "",
"media_type": "application/oracle.com.cloud.common.DbPlatformTemplate+json",
"service_family_type": "dbaas",
"type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatformtemplate/DECCA0E18357F28DE040F20A60514D49"
}
]
},
"service_family_types": {
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"total": "4",
"elements": [
{
"uri": "/em/cloud/service_family_type/jaas",
"name": "jaas",
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"type": "jaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
},
{
"uri": "/em/cloud/service_family_type/dbaas",
"name": "dbaas",
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/dbaas"
},
{
"uri": "/em/cloud/service_family_type/opc",
"name": "opc",
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"type": "opc",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/opc"
},
{
"uri": "/em/cloud/service_family_type/iaas",
"name": "iaas",
"media_type": "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json",
"type": "iaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/iaas"
}
]
},
"service_requests": {
"media_type": "application/oracle.com.cloud.common.Request+json",
"total": "1",
"elements": [
{
"uri": "/em/cloud/request/DEC87CE5B1DA175DE040F20A605150F8",
"name": "SLC01NBV_DBCA_ST - Mon Jun 10 00:20:08 PDT 2013_CREATE_20_25",
"media_type": "application/oracle.com.cloud.common.Request+json",
"status": "SUCCESS",
"lifecycle_type": "CREATE",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/request/DEC87CE5B1DA175DE040F20A605150F8"
}
]
}
}

注意:
許容タイプは指定されていませんが、Webサービスによりクラウド・リソースが"/em/cloud"アドレスとして明確に返されます。このアドレスは、クラウドを返されるデフォルト・リソースとして一意に識別できます。

49.2.3.2 特定のリソース属性の出力のフィルタ処理

次の説明には、ある属性(このケースではサービス・ファミリ・タイプ)を特定するためのクラウド・リソースとの相互作用が示されています。

表49-7 特定のリソース属性をフィルタ処理するためのGETリクエスト構成

機能

説明

URI

em/cloud?service_family_types,name

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Oracle Cloud by Enterprise Manager",
"service_family_types": {
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"total": "4",
"elements": [
{
"uri": "/em/cloud/service_family_type/jaas",
"name": "jaas",
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"type": "jaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
},
{
"uri": "/em/cloud/service_family_type/dbaas",
"name": "dbaas",
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/dbaas"
},
{
"uri": "/em/cloud/service_family_type/opc",
"name": "opc",
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"type": "opc",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/opc"
},
{
"uri": "/em/cloud/service_family_type/iaas",
"name": "iaas",
"media_type": "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json",
"type": "iaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/iaas"
}
]
}
}

選択的属性のみが収集されてクライアントに返されるこの機能は、すべての共通リソースでサポートされます。

49.2.3.3 サービス・ファミリ・タイプ・リソースの詳細の表示

サービス・ファミリ・タイプのリソースに対するGET操作によって、ユーザーがアクセス可能なすべてのDBaaSリソースがリストされます。サービス・ファミリ・タイプのリソースに対するGETの構成を次に示します。

表49-8 サービス・ファミリ・タイプ・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/cloud/service_family_types/dbaas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

X-specification-version: 10001
Content-Type: application/oracle.com.cloud.common.ServiceFamilyType+json; charset=ISO-8859-1
{
"uri": "/em/cloud/service_family_type/dbaas",
"name": "dbaas",
"resource_state": {
"state": "READY"
},
"media_type": "application/oracle.com.cloud.common.ServiceFamilyType+json",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/dbaas",
"type": "dbaas",
"service_templates": {
"media_type": "application/oracle.com.cloud.common.ServiceTemplate+json",
"total": "2",
"elements": [
{
"uri": "/em/cloud/dbaas/dbplatformtemplate/DEC94FE6D49DAA21E040F20A60511D14",
"name": "SLC01NBV_SNAPCLONE_ST",
"description": "",
"media_type": "application/oracle.com.cloud.common.DbPlatformTemplate+json",
"service_family_type": "dbaas",
"type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatformtemplate/DEC94FE6D49DAA21E040F20A60511D14"
},
{
"uri": "/em/cloud/dbaas/dbplatformtemplate/DECCA0E18357F28DE040F20A60514D49",
"name": "SLC00ECXY_DBCA_ST",
"description": "",
"media_type": "application/oracle.com.cloud.common.DbPlatformTemplate+json",
"service_family_type": "dbaas",
"type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatformtemplate/DECCA0E18357F28DE040F20A60514D49"
}
]
},
"zones": {
"media_type": "application/oracle.com.cloud.common.Zone+json",
"total": "2",
"elements": [
{
"uri": "/em/cloud/dbaas/zone/9708491651C090AB4B847C2F3CD177DE",
"name": "SLC00ECXY_ZONE",
"description": "",
"media_type": "application/oracle.com.cloud.common.DbZone+json",
"service_family_type": "dbaas",
"type": "self_service_zone",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/9708491651C090AB4B847C2F3CD177DE"
},
{
"uri": "/em/cloud/dbaas/zone/B329742A13BE0D63703BF0C0E4F98FB9",
"name": "SLC01NBV_ZONE",
"description": "SLC01NBV_ZONE",
"media_type": "application/oracle.com.cloud.common.DbZone+json",
"service_family_type": "dbaas",
"type": "self_service_zone",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/B329742A13BE0D63703BF0C0E4F98FB9"
}
]
},
"instance_types": {
"media_type": "application/oracle.com.cloud.common.InstanceType+json",
"total": "1",
"elements": [
{
"uri": "/em/cloud/instance_type/dbPlatformInstance%40dbaas",
"name": "dbPlatformInstance",
"description": "Db Instance",
"media_type": "application/oracle.com.cloud.common.InstanceType+json",
"instance_media_type": "application/oracle.com.cloud.common.DbPlatformInstance+json",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/instance_type/dbPlatformInstance%40dbaas"
}
]
},
"service_requests": {
"media_type": "application/oracle.com.cloud.common.Request+json",
"total": "1",
"elements": [
{
"uri": "/em/cloud/request/DEC87CE5B1DA175DE040F20A605150F8",
"name": "SLC01NBV_DBCA_ST - Mon Jun 10 00:20:08 PDT 2013_CREATE_20_25",
"media_type": "application/oracle.com.cloud.common.Request+json",
"status": "SUCCESS",
"lifecycle_type": "CREATE",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/request/DEC87CE5B1DA175DE040F20A605150F8"
}
]
}
}

メディア・タイプapplication/oracle.com.cloud.common.ServiceFamilyType+jsonが詳細リソースとして自動的に返されます。

49.2.3.4 サービス・インスタンス・タイプ・リソースの詳細の表示

サービス・インスタンス・タイプのリソースに対するGETリクエストによって、特定のサービス・ファミリ・タイプによって提供されるすべてのサービスがリストされます。

表49-9 サービス・インスタンス・タイプ・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/cloud/instance_type/dbPlatformInstance%40dbaas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/instance_type/dbPlatformInstance%40dbaas" ,
"name" : "dbPlatformInstance" ,
"description" : "Db Instance" ,
"media_type" : "application/oracle.com.cloud.common.InstanceType+json" ,
"instance_media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" , ,
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/instance_type/dbPlatformInstance%40dbaas"
}

49.2.3.5 サービス・リクエスト・リソースの詳細の表示

サービス・リクエスト・リソース上のGETリクエストは、サービス・リクエストの詳細をリストします。

表49-10 サービス・リクエスト・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/<request_id>

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"id": "21",
"name": "Request a RAC One Database_CREATE_43_47#21",
"status": "SUCCESS",
"serviceType": "DB",
"serviceFamily": "DBAAS",
"actionName": "Create Database",
"startDate": "2015-07-21T17:13:47Z",
"createdOn": "2015-07-21T17:13:47Z",
"createdBy": "SYSMAN",
"owner": "SYSMAN",
"canonicalLink":
{
"href": "https://blr.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/21"
},
"description": "Create Database for "Request a RAC One Database".",
"executionLogs": "https://blr.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/21/logs"
}

49.2.3.6 DBゾーンの詳細の表示

ゾーンに対するGETリクエストによって、ゾーン内で利用可能なすべてのリソースがリストされます。DBゾーンのリソース構成を次に示します。

表49-11 DBゾーンの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/cloud/dbaas/zone/82CF1C28FA20A183C99D138FF8065F19

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/zone/B49F86387B81DAED9A3D672D722CF29D" ,
"name" : "RAC SSAZONE" ,
"description" : "SSA Zone with RAC Nodes" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "B49F86387B81DAED9A3D672D722CF29D" ,
"media_type" : "application/oracle.com.cloud.common.DbZone+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/B49F86387B81DAED9A3D672D722CF29D" ,
"type" : "self_service_zone" ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/1" ,
"name" : "db000000.mycompany.com" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/1" ,
"type" : "rac_database"
}
]
} ,
"templates" :     {
"media_type" : "application/oracle.com.cloud.common.DbPlatformTemplate+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/dbaas/dbplatformtemplate/DE039DAC33FFEA6FE040E80A687848A6" ,
"name" : "12101_RACFileSystem_ServiceTemplate" ,
"description" : "12101 RAC FileSystem Service Template" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformTemplate+json" ,
"service_family_type" : "dbaas" ,
"type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatformtemplate/DE039DAC33FFEA6FE040E80A687848A6"
}
]
}
}

49.2.3.7 DBプラットフォーム・テンプレート・リソースの詳細の表示

DBプラットフォーム・テンプレートのリソースに対するGETリクエストによって、DBサービス・テンプレートの詳細が得られます。

前の例で示したように、リソース・タイプを明確に指定するために、表示したコレクションのすべての要素にmedia_typeが属性として付けられています。

表49-12 DBプラットフォーム・テンプレート・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/cloud/dbaas/dbplatformtemplate/CC3BBB665A6BC6FFE040F00AEF252456

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatformtemplate/F985CAE9AB916591E043A4BBF00A235D" ,
"name" : "Platinum - Star Hotel Application on 2-node RAC Database with Multiple Standbys" ,
"description" : "Provisions Star Hotel Application on 2-node 11.2.0.4 RAC Database with RAC & SI Standbys" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformTemplate+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatformtemplate/F985CAE9AB916591E043A4BBF00A235D" ,
"type" : "dbaas" ,
"created" : "2014-05-16T13:57:22+0000" ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.common.DbZone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/dbaas/zone/F985A268D9175B9FE043A4BBF00A3573" ,
"name" : "Salt Lake City DC" ,
"description" : "" ,
"context_id" : "F985A268D9175B9FE043A4BBF00A3573" ,
"media_type" : "application/oracle.com.cloud.common.DbZone+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/F985A268D9175B9FE043A4BBF00A3573" ,
"type" : "self_service_zone"
"clusters_for_placement" :
[
{
"clusterName" : "cluster1" ,
"hostsInCluster" :
[
"abc.mycompany.com" ,
"def.mycompany.com" ,
"ghi.mycompany.com"
]
} ,
{
"clusterName" : "cluster2" ,
"hostsInCluster" :
[
"xyz.mycompany.com" ,
"pqr.mycompany.com"
]
}
]
}
]
} ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/1" ,
"name" : "xxyy.example.com" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/1" ,
"target_type" : "rac_database"
}
]
} ,
"deployment_params" :
[
{
"name" : "username" ,
"description" : "Master account Username" ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "false"
} ,
{
"name" : "password" ,
"description" : "Password for the Master account" ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "true"
} ,
{
"name" : "database_sid" ,
"description" : "Database SID. Required only if sid_option is ssauser." ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "false"
} ,
{
"name" : "service_name" ,
"description" : "Database Service Name" ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "false"
} ,
{
"name" : "database_host_name" ,
"description" : "Name of the host(s) to be chosen for creating the database instance. For RAC database instance, multiple host names can be provided as comma separated values." ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "standbydbs" ,
"description" : "List of the standby databases. Required only if standby database is enabled and required" ,
"type" : "LIST" ,
"defaultValue" :
[
{
"name" : "standbydb_name" ,
"description" : "Name of the standby database, specified in the standbydbs list" ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "false"
} ,
{
"name" : "standbydb_sid" ,
"description" : "SID of the standby database" ,
"type" : "STRING" ,
"require" : "true" ,
"sensitive" : "false"
}
] ,
"require" : "false" ,
"sensitive" : "false"
}
{
"name" : "db_size_name" ,
"description" : "DB Size name to be associated with the request" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
] ,
"subtype" : "db" ,
"db_type" : "rac_database" ,
"node_count" : "2" ,
"sid_option" : "ssauser" ,
"standbydbs" :
[
{
"standbydb_name" : "Near DR" ,
"standbydb_type" : "rac_database"
} ,
{
"standbydb_name" : "Far DR" ,
"standbydb_type" : "oracle_database"
}
] ,
"standby_enabled" : "true" ,
"placement_option" : "SELECT_ORACLE_HOME_FROM_REQUEST" ,
"standby_protection_mode" : "MAXIMIZE AVAILABILITY" ,
"instance_configurable_params" :     {
"username" : "" ,
"password" : "" ,
"database_sid" : "" ,
"service_name" : ""
}
}
"db_sizes" :
[
{
"name" : "Large" ,
"description" : "Large size database" ,
"attributes" :
[
{
"name" : "CPU" ,
"value" : "0" ,
"units" : "cores"
} ,
{
"name" : "Memory" ,
"value" : "8" ,
"units" : "GB"
} ,
{
"name" : "Storage" ,
"value" : "500" ,
"units" : "GB"
}
]
} ,
{
"name" : "Medium" ,
"description" : "Medium size database" ,
"attributes" :
[
{
"name" : "CPU" ,
"value" : "4" ,
"units" : "cores"
} ,
{
"name" : "Memory" ,
"value" : "6" ,
"units" : "GB"
} ,
{
"name" : "Storage" ,
"value" : "100" ,
"units" : "GB"
}
]
} ,
{
"name" : "Small" ,
"description" : "Small size database" ,
"attributes" :
[
{
"name" : "CPU" ,
"value" : "2" ,
"units" : "cores"
} ,
{
"name" : "Memory" ,
"value" : "4" ,
"units" : "GB"
} ,
{
"name" : "Storage" ,
"value" : "50" ,
"units" : "GB"
}
]
}
] ,
"default_db_size_name" : "Small" ,
}

注意:
前述のサンプル出力では、単一インスタンス・データベースで構成されたサービス・テンプレート上のGETは、clusters_for_placementのかわりに、hosts_for_placementパラメータを表示します。

49.2.3.8 データベース・インスタンスの作成

この項では、クラウド・リソースを使用してサービス・インスタンスを作成する方法について説明します。DBはサービス・ファミリ・タイプdbaasのサービス・インスタンスであるため、データベースを作成する同じファミリ・タイプのゾーンを指定する必要があります。データベースの作成には、次の2つの方法があります。

1. データベースが存在するDBゾーンに対してPOSTリクエストを発行。

2. データベースがベースとするDBプラットフォーム・テンプレートに対してPOSTリクエストを発行。

POSTで送信した本文の属性を書き留めます。パターンは、他のサーバー・インスタンスの作成と同じです。意図が明確であるため、DBゾーンにPOSTするときにzone属性は不要です。同様に、DBプラットフォーム・テンプレートにPOSTするときにbased_on属性は不要です。

データベースを作成する2つの方法については、この後の項で説明しています。

- DBゾーンへのリクエスト渡しによるデータベースの作成

- DBプラットフォーム・テンプレートへのリクエスト渡しによるデータベースの作成

49.2.3.8.1 DBゾーンへのリクエスト渡しによるデータベースの作成

Dbゾーンに対してPOSTを実行する構成を次に示します。

表49-13 DBゾーンへのリクエスト渡しによってデータベースを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/zone/82CF1C28FA20A183C99D138FF8065F19

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"based_on": "/em/cloud/dbaas/dbplatformtemplate/CC3BBB665A6BC6FFE040F00AEF252456",
"name": "<Request name>",
"description": "<Request Description>",
"start_date": "2013-08-02T14:20:00ZAsia/Calcutta",
"end_date": "2013-08-02T17:20:00ZAsia/Calcutta",
"standby_required" : "true",
"params":
{
"username": "Master Account username for the DB",
"password": "Password for the Master Account on the DB" ,
"database_sid" : "Database SID" ,
"service_name" : "Name of the additional service to be created",
"db_size_name": "Medium",
"standbydbs":
[
{
"standbydb_name":"STBY2",
"standbydb_sid":"stio62"
}
]
"database_profile_version": "RMAN_06_27_2014_14_18_PM"
}
}

リクエスト・メソッド

POST

注意:
前述のbodyで、start_dateはデータベースを作成するリクエストがスケジューリングされた時刻、タイムゾーンおよび日付を示し、end_dateはデータベースが削除されるときを示します。これらのパラメータはオプションです。

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/21" ,
"name" : "Test_create_intance" ,
"resource_state" :     {
"state" : "INITIATED"
"messages" :
[
{
"date" : "2014-11-25T09:52:49+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"text" : "Delete Request ID is : 22"
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"status" : "SCHEDULED"
}

49.2.3.8.2 DBプラットフォーム・テンプレートへのリクエスト渡しによるデータベースの作成

DbPlatformTemplateに対してPOSTを実行する構成を次に示します。

表49-14 DBプラットフォーム・テンプレートへのリクエスト渡しによってデータベースを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatformtemplate/CC3BBB665A6BC6FFE040F00AEF252456

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"zone": "/em/cloud/dbaas/zone/82CF1C28FA20A183C99D138FF8065F19",
"name": "<Request name>",
"description": "<Request Description>",
"standby_required" : "true",
"params":
{
"username": "Master Account username for the DB",
"password": "Password for the Master Account on the DB",
"database_sid" : "Database SID" ,
"service_name" : "Name of the additional service to be created",
"database_host_name": "abc.mycompany.com,def.mycompany.com"
" db_size_name": "Medium",
"standbydbs":
[
{
"standbydb_name":"STBY2",
"standbydb_sid":"stio62"
}
]
"database_profile_version": "RMAN_06_27_2014_14_18_PM"
}
}

リクエスト・メソッド

POST

注意:

- サービス・テンプレートがカスタム配置に構成されている場合、database_host_nameパラメータは必須です。

- database_host_nameパラメータの値は、同じゾーンに存在するホストです。

- SIデータベースでは、1つのホスト名のみを指定します。RACデータベースでは、ホストの数を、指定された同じゾーンにある単一クラスタ内のnode_countと同じ数に指定する必要があります。

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"name" : "Test_create_intance" ,
"resource_state" :     {
"state" : "INITIATED"
} ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/23" ,
"status" : "SCHEDULED"
}

前述のレスポンスは、前のバージョンと同じです。ゾーンが指定されていない場合、WebサービスはDBをデプロイする場所を特定できません。

49.2.3.9 データベース作成の詳細の表示

データベース作成のためにPOSTが実行されると、戻りURIによって特定されるリソースに対するGET操作を実行してステータスを追跡できます。

表49-15 データベース作成の詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "/em/cloud/dbaas/dbplatforminstance/byrequest/22",
"name": "Test_create_intance_CREATE_55_42",
"description": "Create Database for test.",
"resource_state":
{
"state": "CREATING"
},
"context_id": "22",
"media_type": "application/oracle.com.cloud.common.DbPlatformInstance+json",
"status": "IN_PROGRESS",
"created": "2013-06-07 23:09:04" ,
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/22"
}

resource_state属性はCREATING状態であり、データベースが作成中であることを示しています。データベースの作成後にGET操作が実行されると、次のようにレスポンスにはデータベース・リソースがREADY状態であることが示されます。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"name" : "db000000.mycompany.com" ,
"resource_state" :     {
"state" : "READY"
"messages" :
[
{
"date" : "2014-11-25T09:52:49+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"text" : "Delete Request ID is : 22"
}
]
} ,
"context_id" : "22" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"status" : "RUNNING" ,
"created" : "2013-08-03 02:23:04" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E300FBE134EAB347E040F10A58535F16" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=cluster_name)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=db000000.mycompany.com)))" ,
"target_type" : "rac_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/B49F86387B81DAED9A3D672D722CF29D" ,
"total_sessions" : "165" ,
"last_backup" : "null" ,
"master_username" : "InstanceUser1" ,
"db_version" : "12.1.0.1.0" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "4778.555" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "699.813" ,
"units" : "MB"
}
] ,
"instances" :
[
{
"name" : "db000000. mycompany.com_db0000001" ,
"average_active_sessions" : ".031" ,
"allocated_sessions" : "70" ,
"measurable_attributes" :
[
{
"name" : "cpu_utilization" ,
"value" : "0.199" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "2723.867" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "3.103" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "6" ,
"units" : "Cores"
}
]
} ,
{
"name" : "db000000. mycompany.com_db0000002" ,
"average_active_sessions" : ".007" ,
"allocated_sessions" : "69" ,
"measurable_attributes" :
[
{
"name" : "cpu_utilization" ,
"value" : "0.049" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "2705.378" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : ".663" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "6" ,
"units" : "Cores"
}
]
},
"standby_databases" :
[
{
"Target Name" : "xyxy.example.com" ,
"Target Type" : "oracle_database" ,
"Open Mode" : "MOUNTED"
} ,
{
"Target Name" : "xxxy.example.com" ,
"Target Type" : "rac_database" ,
"Open Mode" : "READ ONLY"
}
] ,
"standby_database_configured" : "true"
]
}

単一インスタンス・データベース(タイプ:oracle_database)の場合の出力を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/81" ,
"name" : "sidb0001.host1.mycompany.com" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "81" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/81" ,
"status" : "RUNNING" ,
"created" : "2013-08-05 18:06:52" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E33736E8238CE06BE040F20A54666216" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST= host1.mycompany.com)(PORT=1521)))(CONNECT_DATA=(SID=sidb0001)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/E33720BF45C45E24E040F20A54666214" ,
"total_sessions" : "43" ,
"last_backup" : "null" ,
"master_username" : "InstanceUser1" ,
"db_version" : "11.2.0.1.0" ,
"average_active_sessions" : ".118" ,
"allocated_sessions" : "42" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "982.063" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "11.206" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "533.485" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "11.822" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "1" ,
"units" : "Cores"
}
],
"standby_databases" :
[
{
"Target Name" : "xyxy.example.com" ,
"Target Type" : "oracle_database" ,
"Open Mode" : "MOUNTED"
}
] ,
"standby_database_configured" : "true"
}

49.2.3.10 データベースの更新

データベースは、即時に更新することも、後で更新するようスケジュールすることもできます。後で更新するようスケジュールする場合は、バックアップをスケジュール実行する日時を指定します。日時はYYYY-MM-DDTHH:MM:SSZFullTimeZonenameの形式にする必要があります。たとえば、PST時間でスケジュールするには、次のように入力します。

"2013-08-27T12:34:45ZAmerica/Los_Angeles"

ただし、タイムゾーンの指定はオプションです。タイム・ゾーンを指定しない場合は、次の例に示すように日時を指定します。

"2013-08-27T12:34:45Z"

データベースを即時に更新するには、REST APIのペイロードでupdate_scheduleフィールドを空白のままにする必要があります。表49-17「データベースを即時に更新するためのPOSTリクエスト構成」を参照してください。

表49-16 データベース更新をスケジュールするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/21

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+jsonAccept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "UPDATE_DATABASE",
"update_schedule" : "2013-08-27T12:34:45ZAsia/Calcutta"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/1" ,
"name" : "xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/21" ,
"date" : "2014-11-25T09:52:49+0000" ,
"text" : "Successfully submitted UPDATE_DATABASE operation on service instance. Request id - 21."
}
]
} ,
"context_id" : "1" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/1" ,
"status" : "RUNNING" ,
"created" : "2014-11-25 13:41:04.0" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/08AAF405CD4B42E7E0535978B10ADF9F" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=xxxy.example)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=dbca1s.us.example.com)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/715C91005BF1195AA6BFBC70654415E7" ,
"total_sessions" : "52" ,
"last_backup" : "null" ,
"master_username" : "ssauser1" ,
"db_version" : "11.2.0.3.0" ,
"average_active_sessions" : ".003" ,
"allocated_sessions" : "42" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "2" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "509.703" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "118.25" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "0.171" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "668.698" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : ".278" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
] ,
"standby_databases" :
[  ] ,
"standby_database_configured" : "false"
}

データベースを即時に更新するには、次の表に示すようにREST API構成を発行します。

表49-17 データベースを即時に更新するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/21

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+jsonAccept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "UPDATE_DATABASE",
"update_schedule" : ""
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/1" ,
"name" : "db000000.us.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"date" : "2014-11-25T09:56:50+0000" ,
"text" : "Successfully submitted UPDATE_DATABASE operation on service instance. Request id - 22."
}
]
} ,
"context_id" : "1" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/1" ,
"status" : "RUNNING" ,
"created" : "2014-11-25 13:41:04.0" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/08AAF405CD4B42E7E0535978B10ADF9F" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=slc00dpu.us.example.com)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=dbca1s.us.example.com)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/715C91005BF1195AA6BFBC70654415E7" ,
"total_sessions" : "56" ,
"last_backup" : "null" ,
"master_username" : "ssauser1" ,
"db_version" : "11.2.0.3.0" ,
"average_active_sessions" : ".001" ,
"allocated_sessions" : "44" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "2" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "509.703" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "118.25" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "0.092" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "674.077" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : ".105" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
] ,
"standby_databases" :
[  ] ,
"standby_database_configured" : "false"
}

49.2.3.11 データベース・インスタンスの削除

リソースのURIに対するDELETE操作を実行すると、DBサービス・インスタンスの削除ができます。DELETE操作に対する構成値を次に示します。

表49-18 データベース・インスタンスを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"name" : "db000000.mycompany.com" ,
"resource_state" :     {
"state" : "DESTROYING" ,
"messages" :
[
{
"text" : "Submit 'DELETE' operation on 'application/oracle.com.cloud.common.DbPlatformInstance+json' 'db000000.mycompany.com'.  The process has job id '41'" ,
"date" : "2013-06-07T23:16:20+0000"
}
]
} ,
"context_id" : "22" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/22" ,
"type" : "rac_database"
}

数分後、データベースURIに対するGET操作の結果として次の相互作用が生じます。

表49-19 データベース作成の詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

Webサービスは次の応答内容を返します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/23" ,
"name" : "sidb0001.host1.mycompany.com" ,
"resource_state" :     {
"state" : "DESTROYING"
} ,
"context_id" : "23" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/23" ,
"status" : "RUNNING" ,
"created" : "2013-06-09 07:56:57" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/DEB2BDE2F773E356E040E50AD2E56BE9" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1.mycompany.com)(PORT=1521)))(CONNECT_DATA=(SID=sidb0001)))" ,
"type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/DEB2E2920C20D2E1E040E50AD2E56BEF" ,
"up_time" : "0" ,
"load" : "0.156456056384199" ,
"total_sessions" : "46" ,
"total_sga" : "398.203125" ,
"available_space" : "0.19097900390625" ,
"last_backup" : "null" ,
"master_username" : "InstanceUser1" ,
"db_version" : "11.2.0.1.0" ,
"active_sessions" : ".156" ,
"cpu_utilization" : "5.35" ,
"db_time" : "15.646" ,
"cpu_count" : "1" ,
"allocated_sessions" : "39" ,
"total_memory" : "524.384 MB"
}

データベースが削除されると、データベースのstatusはDELETEDを示します。

49.2.3.12 データベース・インスタンスに対するライフサイクル操作

リソースのURIに対するPOSTリクエストを発行して、データベースに対する操作を実行できます。

POSTリクエストを使用して、次の操作を実行できます。

- データベースの停止

- データベースの起動

- データベースのバックアップのスケジュール

- バックアップからのデータベースのリストア

- スタンバイ・データベースの追加

- スタンバイ・データベースの削除

- データベースのリフレッシュ

49.2.3.12.1 データベースの停止

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-20 データベースを停止するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "SHUTDOWN"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:12:30+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/127" ,
"text" : "Successfully submitted SHUTDOWN operation on service instance. Request id - 127."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "62" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : ".01" ,
"allocated_sessions" : "50" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "19" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "0.506" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "604.652" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "1.041" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

49.2.3.12.2 データベースの起動

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-21 データベースを起動するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "STARTUP"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:16:52+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/128" ,
"text" : "Successfully submitted STARTUP operation on service instance. Request id - 128."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "STOPPED" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "null" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "null" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "null" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "null" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "null" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "null" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "null" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "null" ,
"units" : "Cores"
}
]
}

49.2.3.12.3 データベースのバックアップのスケジュール

データベースのバックアップをスケジュールする場合、ユーザーはバックアップをスケジュール実行する日時を指定する必要があります。これは、YYYY-MM-DDTHH:MM:SSZFullTimeZonename形式である必要があります。

たとえば、太平洋標準時刻(PST)でスケジュールするには、2013-08-27T12:34:45ZAmerica/Los_Angelesと入力します。タイムゾーンの部分はオプションです。タイムゾーンを指定しない場合には、2013-08-27T12:34:45Zと入力します。

バックアップをスケジュールするPOSTリクエストが発行済の場合、バックアップをスケジュールするそれ以降のPOSTリクエストは、最後のPOSTリクエストに従ってバックアップ時間をスケジュールします。

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-22 データベースのバックアップをスケジュールするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "BACKUP",
"backup_schedule" : "2013-08-27T12:34:45ZAsia/Calcutta"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/129" ,
"text" : "Successfully submitted BACKUP operation on service instance. Request id - 129."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=xyxy.example.com)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

バックアップが完了した後、GET操作によって次のレスポンスが得られます。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=slc01lxj.us.example.com)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "64" ,
"last_backup" : "2013-08-27 07:24:04.0" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : ".027" ,
"allocated_sessions" : "50" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "0.496" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "578.12" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "2.736" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
] ,
"RMAN_backup_list" :
[
{
"Key" : "1" ,
"Tag" : "ORA$OEM_LEVEL_0" ,
"Completed Time" : "Aug 27, 2013 12:24:02 AM" ,
"Contents" : "SPFILE,CONTROLFILE" ,
"Status" : "AVAILABLE"
}
]
}

49.2.3.12.4 バックアップからのデータベースのリストア

バックアップからデータベースをリストアする場合、ユーザーはデータベースをリストアする日時を指定する必要があります。指定する時刻は、YYYY-MM-DDTHH:MM:SSZFullTimeZonename形式である必要があります。

たとえば、太平洋標準時刻(PST)でスケジュールするには、2013-08-27T12:34:45ZAmerica/Los_Angelesと入力します。タイムゾーンはオプションです。タイムゾーンを指定しない場合には、2013-08-27T12:34:45Zと入力します。

リストア時刻は利用可能なバックアップによって異なります。GETリクエストの出力のRMAN_backup_listセクションを参照してください。

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-23 バックアップからデータベースをリストアするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "RESTORE",
"restore_date" : "2013-08-27T12:34:45Z"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/129" ,
"text" : "Successfully submitted RESTORE operation on service instance. Request id - 130."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

49.2.3.12.5 スタンバイ・データベースの追加

スタンバイ・データベースを追加するには、サービス・テンプレートで構成されているスタンバイ・データベースを入力します。サービス・テンプレートのSIDオプションが「リクエスト時にユーザーにより指定」として設定されている場合は、SID値を指定します。

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-24 スタンバイ・データベースを追加するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "ADD_STANDBY",
"standbydbs":
[
{
"standbydb_name":"STBY1",
"standbydb_sid":"stiq41"
}
]
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.abc.mycompany.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/129" ,
"text" : "Successfully submitted ADD_STANDBY operation on service instance. Request id - 130."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

49.2.3.12.6 スタンバイ・データベースの削除

スタンバイ・データベースを削除するには、作成されるスタンバイ・データベースを入力します。

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-25 スタンバイ・データベースを追加するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "DELETE_STANDBY",
"standbydbs":
[
{
"standbydb_name":"xyxy.example.com",
"standbydb_type":"oracle_database"
}
]
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.abc.mycompany.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/129" ,
"text" : "Successfully submitted DELETE_STANDBY operation on service instance. Request id - 130."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

49.2.3.12.7 データベースのリフレッシュ

データベースは、プロファイル・バージョンの名前を指定することでプロファイルの新規バージョンにリフレッシュできます。

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-26 スタンバイ・データベースを追加するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "REFRESH_DATABASE",
"database_profile_version": "RMAN_06_27_2014_13_18_PM"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.abc.mycompany.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/129" ,
"text" : "Successfully submitted REFRESH_DATABASE operation on service instance. Request id - 130."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

49.2.3.13 スナップ・クローン・データベース・インスタンスに対するライフサイクル操作

リソースのURIに対するPOSTリクエストを発行して、データベースに対する操作を実行できます。POSTリクエストを使用して、次の操作を実行できます。

- スナップショットの作成

- スナップショット・リストからのリストア

- スナップショットの削除

49.2.3.13.1 スナップショットの作成

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-27 スナップショットを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "CREATE_PROFILE",
"snapshot_name" : "test_API_export",
"snapshot_desc" : "testing export option from APIs"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/129" ,
"text" : "Successfully submitted CREATE_PROFILE operation on service instance. Request id - 130."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

スナップショットが作成されると、GET操作のレスポンスによって次の結果が得られます。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/143" ,
"text" : "Successfully submitted CREATE_PROFILE operation on service instance. Request id - 143."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
"snapclone_profile_list" :
[
{
"Name" : "test_API_export" ,
"Description" : "testing export option from APIs" ,
"URN" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:E4E9E7EE230BF965E040F20A60517256:0.1" ,
"Submission Guid" : "DD269BBA774E0159E040F20A60513010" ,
"Creation Date" : "Mon Aug 20 05:54:03 PDT 2013" ,
"Status" : "Ready"
}
]
}

49.2.3.13.2 スナップショット・リストからのリストア

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-28 スナップショット・リストからリストアするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : "RESTORE_PROFILE",
"snapshot_urn" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:DECAD7B3145E6808E040F20A605130A2:0.1"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/144" ,
"text" : "Successfully submitted RESTORE_PROFILE operation on service instance. Request id - 144."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

49.2.3.13.3 スナップショットの削除

DbPlatformInstanceに対するPOSTの構成を次に示します。

表49-29 スナップショット・リストからリストアするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/dbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"operation" : " DELETE_PROFILE",
"snapshot_urn" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:DECAD7B3145E6808E040F20A605130A2:0.1"   }

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"name" : "dbc00000.xyxy.example.com" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:17:56+0000" ,
"uri" : "/em/cloud/dbaas/dbplatforminstance/byrequest/148" ,
"text" : "Successfully submitted DELETE_PROFILE operation on service instance. Request id - 148."
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/dbplatforminstance/byrequest/101" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 05:09:13" ,
"based_on" : "/em/cloud/dbaas/dbplatformtemplate/E4D9626BC260F517E040F20A605152CD" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SID=dbc00000)))" ,
"target_type" : "oracle_database" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"total_sessions" : "0" ,
"last_backup" : "null" ,
"master_username" : "test" ,
"db_version" : "11.2.0.2.0" ,
"average_active_sessions" : "null" ,
"allocated_sessions" : "46" ,
"measurable_attributes" :
[
{
"name" : "up_time" ,
"value" : "0" ,
"units" : "Hours"
} ,
{
"name" : "total_sga" ,
"value" : "398.203" ,
"units" : "MB"
} ,
{
"name" : "available_space" ,
"value" : "537.172" ,
"units" : "MB"
} ,
{
"name" : "cpu_utilization" ,
"value" : "null" ,
"units" : "%"
} ,
{
"name" : "total_memory" ,
"value" : "575.043" ,
"units" : "MB"
} ,
{
"name" : "db_time" ,
"value" : "null" ,
"units" : "CentiSeconds Per Second"
} ,
{
"name" : "cpu_count" ,
"value" : "2" ,
"units" : "Cores"
}
]
}

49.3 Schema as a Service

この項では、Schema as a Service (SchaaS) REST APIのリソース・モデルおよびRESTリクエスト/レスポンス相互作用について説明します。

注意:
SchaaS REST APIは、Oracle Cloud Applicationプラグイン・バージョン12.1.0.6.0以上でのみサポートされます

この項には次のトピックが含まれます:

- Schema as a Serviceのリソース・モデル

- Schema as a Serviceリソースのサポートされる操作

- Schema as a Service REST APIの例

49.3.1 Schema as a Serviceのリソース・モデル

クラウドのリソースは、共通サービス・エンティティで編成されており、特定のサービス(Schema as a Serviceなど)がこれらの共通サービス・エンティティを拡張することでリソースを提供しています。次の図は、SchaaSのリソース・モデルを示しています。

図49-2 Schema as a Serviceのリソース・モデル

次の各項では、Schema as a Service REST APIでサポートされるリソースについて説明し、サポートされる操作の例を示します。Schema as a Serviceでは、第49.2.1項「Database as a Serviceのリソース・モデル」で説明したものと同じクラウド、サービス・ファミリおよびDBゾーン・リソースを使用します。

次のリソース・モデルについて説明します。

- スキーマ・プラットフォーム・テンプレート

- スキーマ・プラットフォーム・インスタンス

49.3.1.1 スキーマ・プラットフォーム・テンプレート

スキーマ・プラットフォーム・テンプレートはサービス・テンプレートのリソースを拡張します。スキーマ・サービス作成のために作成されたサービス・テンプレートを表します。これは、プロファイル・ベースのスキーマ(データを持つスキーマ)を使用してスキーマ・サービスを作成するためのテンプレート、または空のスキーマを含むスキーマ・サービスを作成するためのテンプレートになる場合があります。

スキーマ・プラットフォーム・テンプレートのインスタンスでService Templateメディア・タイプを受け入れることができます。また、スキーマ・プラットフォーム・インスタンス・リソースを認識する事前構成されたデプロイ可能なサービスです。スキーマ・プラットフォーム・テンプレートのメディア・タイプはapplication/oracle.com.cloud.common.SchemaPlatformTemplate、URIの形式は/em/cloud/dbaas/schemaplatformtemplate/<template id>です。

次の表に、スキーマ・プラットフォーム・テンプレートのデータ・モデルを示します。

表49-30 スキーマ・プラットフォーム・テンプレート・データ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

テンプレートのユーザー用の名前。

1

description

文字列

テンプレートの簡単な説明。

0..1

created

Timestamp

テンプレートが作成または最後に変更された日付と時刻(ISO 8601形式)。

1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

zones

コレクション<DbZone>

このテンプレート用に構成されたすべてのゾーンのリスト。

0..1

service_instances

コレクション<SchemaPlatformInstance>

このSchemaPlatformTemplateに基づいて作成されたすべてのサービス・インスタンス。

0..1

media_type

文字列

このタイプが表すサービス・テンプレートのメディア・タイプ。

1

params

オブジェクト

このテンプレートからスキーマ・プラットフォーム・インスタンスをプロビジョニングするのに必要なパラメータのリスト。

1

deployment_params

List<Object>

サービス・インスタンスの作成時に必要なパラメータの説明。

1

type

文字列

サービス・テンプレートのタイプ(デフォルトはdbaas)。

1

subtype

文字列

このテンプレートに基づいて作成されるインスタンスのサブ・タイプ。

この場合、値はschemaになります。

1

template_type

文字列

テンプレートの作成方法に基づいたこのテンプレートのタイプ。EMPTY_SCHEMASまたはSCHEMAS_FROM_PROFILEの2つの値を持つ場合があります。

1

max_number_of_schemas

整数

単一のインスタンス・リクエストで作成できるスキーマの最大数。このフィールドは、template_typeがEMPTY_SCHEMASの場合にのみ存在します。

0..1

workloads

List<Object>

このテンプレートに定義されたすべてのワークロードを示し、それらのそれぞれの属性を示します。

0..1

canonicalLink

URI

GETおよびPOSTなどのクラウド相互作用の実行に使用できます。

1

tablespace_list

List<Object>

スキーマ内の表領域のリスト。

1

49.3.1.2 スキーマ・プラットフォーム・インスタンス

スキーマ・プラットフォーム・インスタンスはサービス・インスタンスのリソースを拡張します。Enterprise Manager Cloud ControlのOracle Databaseサービスのターゲットにリンクされます。スキーマ・プラットフォーム・インスタンスのメディア・タイプはapplication/oracle.com.cloud.common.SchemaPlatformInstance、URIは/em/cloud/dbaas/schemaplatforminstance/byrequest/<request id>です。

次の表に、スキーマ・プラットフォーム・インスタンスのデータ・モデルを示します。

表49-31 スキーマ・プラットフォーム・インスタンス・データ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

データベース・サービスに指定されるユーザー用の名前。[POST]

1

destination_zone

ゾーン

データベース・サービスがデプロイされるゾーン。

[POST]

1

created

Timestamp

テンプレートが作成または最後に変更された日付と時刻(ISO 8601形式)。

1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

based_on

SchemaPlatformTemplate

このデータベース・サービスが公開されるスキーマ・プラットフォーム・テンプレート。

1

media_type

文字列

GETの実行にクライアントが使用できる追加のメディア・タイプを示します。

1

canonicalLink

URI

GETおよびPOSTなどのクラウド相互作用の実行に使用できます。

1

type

文字列

データベース・サービスのタイプ。デフォルト値はoracle_dbsvcです。

1

connect_string

文字列

このデータベース・サービスへの接続を確立するために必要な接続文字列。

0..1

status

文字列

データベース・サービスのステータス。

1

db_version

文字列

このサービスが実行されるデータベースのバージョン。

0..1

context_id

文字列

このデータベース・サービスのリクエストID。

1

49.3.2 Schema as a Serviceリソースのサポートされる操作

次の表に、Schema as a Serviceの各種リソースでサポートされるすべての操作を示します。

表49-32 サポートされる操作

リソース

操作(GET、POST、PUTおよびDELETE)

POST

PUT

DELETE

Cloud

はい

いいえ

いいえ

いいえ

サービス・ファミリ・タイプ

はい

いいえ

いいえ

いいえ

DBゾーン

はい

はい

いいえ

いいえ

スキーマ・プラットフォーム・テンプレート[サービス・テンプレート]

はい

はい

いいえ

いいえ

スキーマ・プラットフォーム・インスタンス[サービス・インスタンス]

はい

はい

いいえ

はい

49.3.3 Schema as a Service REST APIの例

次の各項では、Enterprise Manager Cloud Controlとクラウド・アプリケーション・プラグイン12.1.0.6以上との相互作用の例を示します。クラウドのGET、dbaasファミリ・タイプのGETおよびDbゾーンのGETの例は、Dbaas REST APIの項で説明します。次の例について説明します。

- スキーマ・プラットフォーム・テンプレート・リソースの詳細の表示

- スキーマ・サービスの作成

- DBゾーンへのリクエスト渡しによるスキーマの作成

- スキーマ・プラットフォーム・テンプレートへのリクエスト渡しによるスキーマの作成

- スキーマ・サービス作成の詳細の表示

- スキーマ・サービスの削除

- スキーマ・サービスに対するライフサイクル操作

- スキーマのエクスポート

- エクスポートされたスキーマ・ダンプからのスキーマのリストア

- エクスポートされたスキーマ・ダンプの削除

- スキーマのパスワードの変更

49.3.3.1 スキーマ・プラットフォーム・テンプレート・リソースの詳細の表示

スキーマ・プラットフォーム・テンプレートのリソースに対するGETリクエストによって、リソースの詳細が得られます。

表49-33 スキーマ・プラットフォーム・テンプレート・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatformtemplate/DE3F8D882F132F45E040F00AAA2330C5

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"max_number_of_schemas" : "" ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformTemplate+json" ,
"resource_state" :     {
"state" : "READY"
} ,
"tablespace_list" :
[
"DUMPTBSP1" ,
"DUMPTBSP2"
] ,
"params" :     {
"schema" :
[
{
"username" : "" ,
"password" : "" ,
"original_name" : "SCHEMA_USER_1"
} ,
{
"username" : "" ,
"password" : "" ,
"original_name" : "SCHEMA_USER_2"
}
] ,
"service_name_prefix" : "" ,
"workload_name" : "" ,
"tablespaces" :
[
{
"old_tablespace_name" : "DUMPTBSP1" ,
"new_tablespace_name" : ""
} ,
{
"old_tablespace_name" : "DUMPTBSP2" ,
"new_tablespace_name" : ""
}
]
} ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatformtemplate/FADFFB8A434244F1E043797EF00A63AE" ,
"template_type" : "SCHEMAS_FROM_PROFILE" ,
"type" : "dbaas" ,
"zones" :     {
"total" : "1" ,
"media_type" : "application/oracle.com.cloud.common.DbZone+json" ,
"elements" :
[
{
"media_type" : "application/oracle.com.cloud.common.DbZone+json" ,
"context_id" : "2348838861AFF7BC02912C402605D49F" ,
"description" : "SSA Zone with SI Nodes" ,
"service_family_type" : "dbaas" ,
"name" : "SI SSAZONE" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/2348838861AFF7BC02912C402605D49F" ,
"type" : "self_service_zone" ,
"uri" : "/em/cloud/dbaas/zone/2348838861AFF7BC02912C402605D49F"
}
]
} ,
"uri" : "/em/cloud/dbaas/schemaplatformtemplate/FADFFB8A434244F1E043797EF00A63AE" ,
"service_instances" :     {
"total" : "1" ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"elements" :
[
{
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"name" : "SIFSDifftbspc" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/1" ,
"target_type" : "oracle_dbsvc" ,
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/1"
}
]
} ,
"created" : "2014-06-02T19:38:04+0000" ,
"description" : "11204 SIDB FileSystem Schema Service Template - Import Schema - Different TableSpace for Each Schema" ,
"name" : "11204_SIFS_SCHEMATEMPLATE_IMPORTSCHEMA_DIFFTBSPC" ,
"subtype" : "schema" ,
"workloads" :
[
{
"description" : "LARGE" ,
"name" : "LARGE" ,
"attributes" :
[
{
"name" : "CPU" ,
"value" : "1" ,
"units" : "cores"
} ,
{
"name" : "Memory" ,
"value" : "1" ,
"units" : "GB"
} ,
{
"name" : "Storage" ,
"value" : "10" ,
"units" : "GB"
}
]
} ,
{
"description" : "MEDIUM" ,
"name" : "MEDIUM" ,
"attributes" :
[
{
"name" : "CPU" ,
"value" : "0.5" ,
"units" : "cores"
} ,
{
"name" : "Memory" ,
"value" : "0.5" ,
"units" : "GB"
} ,
{
"name" : "Storage" ,
"value" : "5" ,
"units" : "GB"
}
]
} ,
{
"description" : "SMALL" ,
"name" : "SMALL" ,
"attributes" :
[
{
"name" : "CPU" ,
"value" : "0.3" ,
"units" : "cores"
} ,
{
"name" : "Memory" ,
"value" : "0.3" ,
"units" : "GB"
} ,
{
"name" : "Storage" ,
"value" : "3" ,
"units" : "GB"
}
]
}
] ,
"schema_list" :
[
"SCHEMA_USER_1" ,
"SCHEMA_USER_2"
] ,
"deployment_params" :
[
{
"description" : "Master account schema. Not Required for the SCHEMAS_FROM_PROFILE Schema templates" ,
"name" : "masterAccount" ,
"require" : "false" ,
"type" : "STRING" ,
"sensitive" : "false"
} ,
{
"description" : "Prefix for the service name instances" ,
"name" : "service_name_prefix" ,
"require" : "true" ,
"type" : "STRING" ,
"sensitive" : "false"
} ,
{
"description" : "WorkLoad name to be associated with the request" ,
"name" : "workload_name" ,
"require" : "true" ,
"type" : "STRING" ,
"sensitive" : "false"
} ,
{
"description" : "Common password for all schema users." ,
"name" : "common_password" ,
"require" : "false" ,
"type" : "STRING" ,
"sensitive" : "true"
} ,
{
"description" : "List of schema to be created" ,
"name" : "schema" ,
"require" : "true" ,
"defaultValue" :
[
{
"description" : "New schema name" ,
"name" : "username" ,
"require" : "true" ,
"type" : "STRING" ,
"sensitive" : "false"
} ,
{
"description" : "Original schema name. Required only for the SCHEMAS_FROM_PROFILE Schema templates" ,
"name" : "original_name" ,
"require" : "false" ,
"type" : "STRING" ,
"sensitive" : "false"
} ,
{
"description" : "Password for the schema. Required only if common_password is not specified." ,
"name" : "password" ,
"require" : "false" ,
"type" : "STRING" ,
"sensitive" : "true"
}
] ,
"type" : "LIST" ,
"sensitive" : "false"
} ,
{
"description" : "List of tablespaces remap. Required only for the SCHEMAS_FROM_PROFILE Schema templates." ,
"name" : "tablespaces" ,
"require" : "false" ,
"defaultValue" :
[
{
"description" : "New tablespace name." ,
"name" : "new_tablespace_name" ,
"require" : "true" ,
"type" : "STRING" ,
"sensitive" : "false"
} ,
{
"description" : "Original tablespace name." ,
"name" : "old_tablespace_name" ,
"require" : "true" ,
"type" : "STRING" ,
"sensitive" : "false"
}
] ,
"type" : "LIST" ,
"sensitive" : "false"
}
]
}

49.3.3.2 スキーマ・サービスの作成

この項では、クラウド・リソースを使用したデータベース・サービスの作成方法について説明します。データベース・サービスはサービス・ファミリ・タイプdbaasのサービス・インスタンスでもあるため、データベース・サービスを作成する同じファミリ・タイプのゾーンを指定する必要があります。データベース・サービスの作成には、次の2つの方法があります。

- DBサービスが作成されるDBゾーンに対してPOSTリクエストを発行。

- データベース・サービスがベースとするスキーマ・プラットフォーム・テンプレートのリソースに対してPOSTリクエストを発行。

POSTで送信した本文の属性を書き留めます。パターンは、他のサーバー・インスタンスの作成と同じです。意図が明確であるため、DbゾーンにPOST操作を行うときにzone属性は不要です。同様に、SchemaPlatformTemplateにPOST操作を行うときにbased_on属性は不要です。

この項では、次の操作について説明します。

- DBゾーンへのリクエスト渡しによるスキーマの作成

- スキーマ・プラットフォーム・テンプレートへのリクエスト渡しによるスキーマの作成

49.3.3.2.1 DBゾーンへのリクエスト渡しによるスキーマの作成

Dbゾーンに対してPOSTを実行する構成を次に示します。

表49-34 DBゾーンへのリクエスト渡しによってスキーマを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/zone/82CF1C28FA20A183C99D138FF8065F19

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.SchemaPlatformInstance+json

Accept: application/oracle.com.cloud.common.SchemaPlatformInstance+json

複数のスキーマに対するプロファイル・ベースのスキーマ・テンプレートの本文

{
"name" : "TestService0" ,
"start_date": "2013-08-02T14:20:00ZAsia/Calcutta",
"end_date": "2013-08-02T17:20:00ZAsia/Calcutta",
"params" :     {
"schema" :
[
{
"username" : "Schema_User11_01" ,
"password" : "Schema_User1" ,
"tablespace_name" : "tbsp01"
} ,
{
"username" : "Schema_User11_02" ,
"password" : "Schema_User1" ,
"tablespace_name" : "tbsp02"
} ,
{
"username" : "Schema_User11_03" ,
"password" : "Schema_User1" ,
"tablespace_name" : "tbsp03"
} ,
{
"username" : "Schema_User11_04" ,
"password" : "Schema_User1" ,
"tablespace_name" : "tbsp04"
}
] ,
"workload_name" : "default_workload" ,
"service_name" : "TestService0" ,
"masterAccount" : "Schema_User11_01"
} ,
"based_on" : "/em/cloud/dbaas/schemaplatformtemplate/DE3F8D882F132F45E040F00AAA2330C5"
}

単一のスキーマに対するプロファイル・ベースのスキーマ・テンプレートの本文

{
"name" : "TestService0" ,
"start_date": "2013-08-02T14:20:00ZAsia/Calcutta",
"end_date": "2013-08-02T17:20:00ZAsia/Calcutta",
"params" :     {
"schema" :
[
{
"username" : "Schema_User11_01" ,
"password" : "Schema_User1" ,
"tablespace_name" : "tbsp01"
} ,
"workload_name" : "default_workload" ,
"service_name" : "TestService0" ,
"masterAccount" : "Schema_User11_01"
} ,
"based_on" : "/em/cloud/dbaas/schemaplatformtemplate/DE3F8D882F132F45E040F00AAA2330C5"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/22" ,
"name" : "TestRequest" ,
"resource_state" :     {
"state" : "INITIATED"
"messages" :
[
{
"date" : "2014-11-25T09:52:49+0000" ,
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/22" ,
"text" : "Delete Request ID is : 22"
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/22" ,
"status" : "SCHEDULED"
}

49.3.3.2.2 スキーマ・プラットフォーム・テンプレートへのリクエスト渡しによるスキーマの作成

スキーマ・プラットフォーム・テンプレートに対してPOSTを実行する構成を次に示します。

表49-35 スキーマ・プラットフォーム・テンプレートへのリクエスト渡しによってスキーマを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatformtemplate/CC3BBB665A6BC6FFE040F00AEF252456

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.SchemaPlatformInstance+json

Accept: application/oracle.com.cloud.common.SchemaPlatformInstance+json

本文

{
"based_on" : "/em/cloud/dbaas/schemaplatformtemplate/FADFFB8A434244F1E043797EF00A63AE" ,
"name" : "Test Service" ,
"params" :     {
"schema" :
[
{
"username" : "Schaas_API_User_1" ,
"original_name" : "SCHEMA_USER_1" ,
"password" : "sunset1"
} ,
{
"username" : "Schaas_API_User_2" ,
"original_name" : "SCHEMA_USER_2" ,
"password" : "sunset1"
}
] ,
"workload_name" : "SMALL" ,
"service_name" : "TestService" ,
"masterAccount" : "Schema_User11_01",
"tablespaces" :
[
{
"old_tablespace_name" : "DUMPTBSP2" ,
"new_tablespace_name" : "tablespace2"
} ,
{
"old_tablespace_name" : "DUMPTBSP1" ,
"new_tablespace_name" : "tablespace1"
}
]
}
"zone":"/em/cloud/dbaas/zone/9A71CBEABCA367D0D425697DC39B3AF9
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/23" ,
"name" : "TestRequest" ,
"resource_state" :     {
"state" : "INITIATED"
} ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/23" ,
"status" : "SCHEDULED"
}

前述のレスポンスは、前のバージョンと同じです。ゾーンが指定されていない場合、Webサービスはデータベース・サービスをデプロイする場所を特定できません。

49.3.3.3 スキーマ・サービス作成の詳細の表示

POST操作を実行してデータベース・サービスが作成されると、戻りURIによって特定されるリソースを得るGET操作を実行してステータスを追跡できます。

表49-36 スキーマ・サービス作成の詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatforminstance/byrequest/22

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.SchemaPlatformInstance+json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "/em/cloud/dbaas/schemaplatforminstance/byrequest/22",
"name": "TestRequest_CREATE_55_42",
"description": "Create Service for test.",
"resource_state":
{
"state": "CREATING"
},
"context_id": "22",
"media_type": "application/oracle.com.cloud.common.SchemaPlatformInstance+json",
"status": "IN_PROGRESS",
"created": "2013-06-07 23:09:04" ,
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/22"
}

resource_state属性はCREATINGであり、データベース・サービスが作成中であることを示しています。データベース・サービスが作成されると、GET操作の戻り値には、次のようにデータベース・サービス・リソースがREADY状態であることが示されます。

{
"uri": "/em/cloud/dbaas/schemaplatforminstance/byrequest/22",
"name": "Service_1_35E576F22E97E",
"resource_state": {
"state": "READY"
"messages" :
[
{
"date" : "2014-11-25T09:52:49+0000" ,
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/22" ,
"text" : "Delete Request ID is : 22"
}
]
},
"context_id": "22",
"media_type": "application/oracle.com.cloud.common.SchemaPlatformInstance+json",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/22",
"status": "RUNNING",
"created": "2013-06-10 02:45:32",
"based_on": "/em/cloud/dbaas/schemaplatformtemplate/DECA1100F797EF10E040F00AFBB123E7",
"target_type": "oracle_dbsvc",
"connect_string": "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=abc.mycompany.com)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=Service_1_35E576F22E97E.mycompany.com)))",
"destination_zone": "/em/cloud/dbaas/zone/34C1FC23A7503E1CC9C490C9670635F9",
"db_version": "11.2.0.3.0"
}

49.3.3.4 スキーマ・サービスの削除

リソースのURIに対してDELETEリクエストを発行して、データベース・サービスを削除できます。DELETEリクエストに対する構成を次に示します。

表49-37 スキーマ・サービスを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatforminstance/byrequest/22

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.SchemaPlatformInstance+json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/22" ,
"name" : "Service_1_35E576F22E97E" ,
"resource_state" :     {
"state" : "DESTROYING" ,
"messages" :
[
{
"text" : "Submit 'DELETE' operation on 'application/oracle.com.cloud.common.SchemaPlatformInstance+json' 'Service_1_35E576F22E97E'.  The process has job id '41'" ,
"date" : "2013-06-07T23:16:20+0000"
}
]
} ,
"context_id" : "22" ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance +json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/22" ,
"type" : "oracle_dbsvc"
}

一定期間後、データベース・サービスURIでのGETリクエストにより、次の相互作用が生成されます。

表49-38 スキーマ・サービスのステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatforminstance/byrequest/22

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "/em/cloud/dbaas/schemaplatforminstance/byrequest/22",
"name": "Service_1_35E576F22E97E",
"resource_state": {
"state": "DESTROYING"
},
"context_id": "2",
"media_type": "application/oracle.com.cloud.common.SchemaPlatformInstance+json",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/2",
"status": "RUNNING",
"created": "2013-06-10 02:45:32",
"based_on": "/em/cloud/dbaas/schemaplatformtemplate/DECA1100F797EF10E040F00AFBB123E7",
"type": "oracle_dbsvc",
"connect_string": "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1.mycompany.com)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=Service_1_35E576F22E97E.mycompany.com)))",
"destination_zone": "/em/cloud/dbaas/zone/34C1FC23A7503E1CC9C490C9670635F9",
"db_version": "11.2.0.3.0"
}

スキーマ・サービスが削除されると、データベース・サービスのステータスはDELETEDになります。

49.3.3.5 スキーマ・サービスに対するライフサイクル操作

リソースのURIに対してPOSTリクエストを発行して、スキーマ・サービスに対する操作を実行できます。

POSTリクエストを使用して、次のライフサイクル操作を実行できます。

- スキーマのエクスポート

- エクスポートされたスキーマ・ダンプからのスキーマのリストア

- エクスポートされたスキーマ・ダンプの削除

- スキーマのパスワードの変更

49.3.3.5.1 スキーマのエクスポート

スキーマをエクスポートする場合、ユーザーはオプションで、エクスポートを実行する日時を指定できます。日時は、YYYY-MM-DDTHH:MM:SSZFullTimeZonename形式である必要があります。

たとえば、太平洋標準時刻(PST)でスケジュールするには、2013-08-27T12:34:45ZAmerica/Los_Angelesと入力します。

ただし、タイムゾーンはオプションです。タイムゾーンを指定しない場合には、2013-08-27T12:34:45Zと入力します。

SchemaPlatformInstanceに対するPOSTの構成を次に示します。

表49-39 スキーマをエクスポートするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.SchemaPlatformInstance +json

Accept: application/oracle.com.cloud.common.SchemaPlatformInstance+json

本文

{
"operation" : "EXPORT",
"profile_name" : "test_API_export",
"profile_desc" : "testing export option from APIs",
"export_schedule" : "2013-07-31T02:10:45ZAsia/Calcutta   "
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"name" : "Service_8E958EC718B11" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:34:43+0000" ,
"text" : "Successfully submitted EXPORT operation on schema instance. Request id - 130." ,
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/130"
}
]
} ,
"context_id" : "123" ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"target_type" : "oracle_dbsvc"
}

エクスポート操作の完了後にスキーマ・サービスに対してGET操作を実行すると、次の結果が生成されます。

{
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"name" : "Service_8E958EC718B11" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "123" ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 23:49:30" ,
"based_on" : "/em/cloud/dbaas/schemaplatformtemplate/E4D9626BC252F517E040F20A605152CD" ,
"target_type" : "oracle_dbsvc" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=Service_8E958EC718B11.us.example.com)))" ,
"destination_zone" : "/em/cloud/dbaas/zone/675B859C36772FB7856771B1D57F79F8" ,
"schema_list" :
[
{
"service_name_prefix" : "" ,
"workload_name" : "" ,
"schema" :
[
{
"username" : "" ,
"original_name" : "schema200" ,
"password" : ""
}
]
}
] ,
"db_version" : "11.2.0.2.0" ,
"export_dump_list" :
[
{
"name" : "test_API_export" ,
"description" : "testing export option from APIs" ,
"URN" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:E4E9E7EE230BF965E040F20A60517256:0.1" ,
"status" : "Ready"
}
]
}

49.3.3.5.2 エクスポートされたスキーマ・ダンプからのスキーマのリストア

ダンプ・アクティビティからのリストア・スキーマは、利用可能なエクスポート・ダンプによって異なります。ダンプのURNを表示するには、GETリクエストの出力のexport_dump_listセクションを参照してください。

SchemaPlatformInstanceに対するPOSTの構成を次に示します。

表49-40 エクスポートされたスキーマ・ダンプからスキーマをリストアするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.SchemaPlatformInstance +json

Accept: application/oracle.com.cloud.common.SchemaPlatformInstance+json

本文

{
"operation" : "IMPORT",
"profile_urn" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:DECB2AAA09CCD711E040F20A60514F92:0.1"
}

リクエスト・メソッド

POST

前述の相互作用によるレスポンスのサンプルを次に示します。

{
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"name" : "Service_8E958EC718B11" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:34:43+0000" ,
"text" : "Successfully submitted IMPORT operation on schema instance. Request id - 132." ,
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/132"
}
]
} ,
"context_id" : "123" ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"target_type" : "oracle_dbsvc"
}

49.3.3.5.3 エクスポートされたスキーマ・ダンプの削除

エクスポートされたダンプの削除は、利用可能なエクスポート・ダンプによって異なります。ダンプのURNを表示するには、GETリクエストの出力のexport_dump_listセクションを参照してください。

SchemaPlatformInstanceに対するPOSTの構成を次に示します。

表49-41 エクスポートされたスキーマ・ダンプを削除するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.SchemaPlatformInstance +json

Accept: application/oracle.com.cloud.common.SchemaPlatformInstance+json

本文

{
"operation" : "DELETE_EXPORT",
"profile_urn" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:DECB2AAA09CCD711E040F20A60514F92:0.1"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"name" : "Service_8E958EC718B11" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:34:43+0000" ,
"text" : "Successfully submitted DELETE_EXPORT operation on schema instance. Request id - 135." ,
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/135"
}
]
} ,
"context_id" : "123" ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"target_type" : "oracle_dbsvc"
}

49.3.3.5.4 スキーマのパスワードの変更

SchemaPlatformInstanceに対するPOSTの構成を次に示します。

表49-42 スキーマ・パスワードを変更するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/schemaplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.SchemaPlatformInstance +json

Accept: application/oracle.com.cloud.common.SchemaPlatformInstance+json

本文

{
"operation" : "CHANGE_PWD",
"schema_name" : "schema1",
"new_password" : "welcome"
}

リクエスト・メソッド

POST

前述の相互作用によるレスポンスのサンプルを次に示します。

{
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"name" : "Service_8E958EC718B11" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:34:43+0000" ,
"text" : "Successfully submitted CHANGE_PWD operation on schema instance. Request id - 136." ,
"uri" : "/em/cloud/dbaas/schemaplatforminstance/byrequest/136"
}
]
} ,
"context_id" : "123" ,
"media_type" : "application/oracle.com.cloud.common.SchemaPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/schemaplatforminstance/byrequest/123" ,
"target_type" : "oracle_dbsvc"
}

49.4 Pluggable Database as a Service

この項では、Pluggable Database as a Service (PdbaaS) REST APIのリソース・モデルおよびRESTリクエスト/レスポンス相互作用について説明します。

注意:
PdbaaS REST APIは、Oracle Cloud Applicationプラグイン・バージョン12.1.0.7.0以上でのみサポートされます。

- Pluggable Database as a Serviceのリソース・モデル

- プラガブル・データベース・リソースに対してサポートされる操作

- Pluggable Database as a Service REST APIの例

49.4.1 Pluggable Database as a Serviceのリソース・モデル

クラウドのリソースは、共通サービス・エンティティで編成されており、特定のサービス(Pluggable Database as a Serviceなど)がこれらの共通サービス・エンティティを拡張することでリソースを提供しています。次の図は、PdbaaSのリソース・モデルを示しています。

図49-3 Pluggable Database as a Serviceのリソース・モデル

次の各項では、Pluggable Database as a Service REST APIでサポートされるリソースについて説明し、サポートされる操作の例を示します。Pluggable Database as a Serviceでは、第49.2.1項「Database as a Serviceのリソース・モデル」で説明したものと同じクラウド、サービス・ファミリおよびDBゾーン・リソースを使用します。

この項では、次のリソース・モデルについて説明します。

- プラガブルDBプラットフォーム・テンプレート

- プラガブルDBプラットフォーム・インスタンス

49.4.1.1 プラガブルDBプラットフォーム・テンプレート

プラガブルDbプラットフォーム・テンプレートはサービス・テンプレートのリソースを拡張します。プラガブル・データベース作成のために作成されたサービス・テンプレートを表します。これはプロファイル・ベースのプラガブル・データベース(データを持つpdb)を使用してプラガブル・データベースを作成するためのテンプレート、または空のプラガブル・データベースを作成するためのテンプレートになる場合があります。プラガブルDbプラットフォーム・テンプレートのインスタンスでServiceTemplateメディア・タイプを受け入れることができます。また、プラガブルDbプラットフォーム・インスタンス・リソースを認識する事前構成されたデプロイ可能なサービスです。プラガブルDBプラットフォーム・テンプレートのメディア・タイプはapplication/oracle.com.cloud.common.PluggableDbPlatformTemplate+json、URIの形式は/em/cloud/dbaas/pluggabledbplatformtemplate/<template id>です。

次の表に、スキーマ・プラットフォーム・テンプレートのデータ・モデルを示します。

表49-43 プラガブルDBプラットフォーム・テンプレート・データ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

テンプレートのユーザー用の名前。

1

description

文字列

テンプレートの簡単な説明。

0..1

created

Timestamp

テンプレートが作成または最後に変更された日付と時刻(ISO 8601形式)。

1

zones

コレクション<DbZone>

このテンプレート用に構成されたすべてのゾーンのリスト。

0..1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

service_instances

コレクション<SchemaPlatformInstance>

このSchemaPlatformTemplateに基づいて作成されたすべてのサービス・インスタンス。

0..1

media_type

文字列

このタイプが表すサービス・テンプレートのメディア・タイプ。

1

params

オブジェクト

このテンプレートからスキーマ・プラットフォーム・インスタンスをプロビジョニングするのに必要なパラメータのリスト。

1

deployment_params

List<Object>

サービス・インスタンスの作成時に必要なパラメータの説明。

1

type

文字列

サービス・テンプレートのタイプ(デフォルトはdbaas)。

1

subtype

文字列

このテンプレートに基づいて作成されるインスタンスのサブ・タイプ。

この場合、値はschemaになります。

1

template_type

文字列

テンプレートの作成方法に基づいたこのテンプレートのタイプ。EMPTY_SCHEMASまたはSCHEMAS_FROM_PROFILEの2つの値を持つ場合があります。

1

workloads

List<Object>

このテンプレートに定義されたすべてのワークロードを示し、それらのそれぞれの属性を示します。

0..1

canonicalLink

URI

GETおよびPOSTなどのクラウド相互作用の実行に使用できます。

1

number_of_tablespaces

文字列

表領域の数。

1

49.4.1.2 プラガブルDBプラットフォーム・インスタンス

プラガブルDbプラットフォーム・インスタンスはサービス・インスタンスのリソースを拡張します。Enterprise Manager Cloud Controlのプラガブル・データベース・ターゲットにリンクされています。プラガブルDBプラットフォーム・インスタンスのメディア・タイプはapplication/oracle.com.cloud.common.PluggableDbPlatformInstance+json、URIの形式は/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/<request id>です。

次の表に、スキーマ・プラットフォーム・インスタンスのデータ・モデルを示します。

表49-44 プラガブルDBプラットフォーム・インスタンス・データ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

プラガブル・データベースに指定されるユーザー用の名前。

1

destination_zone

ゾーン

プラガブル・データベースがデプロイされるゾーン。

1

media_type

文字列

GETの実行にクライアントが使用できる追加のメディア・タイプを示します。

1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

based_on

PluggableDbPlatformTemplate

このデータベース・サービスが公開されるプラガブルdbプラットフォーム・テンプレート。

1

connect_string

文字列

このデータベース・サービスへの接続を確立するために必要な接続文字列。

0..1

created

Timestamp

テンプレートが作成または最後に変更された日付と時刻(ISO 8601形式)。

1

target_type

文字列

このサービス・インスタンスのターゲット・タイプ。デフォルト値は、oracle_pdb。

1

status

文字列

プラガブル・データベースのステータス。

1

db_version

文字列

プラガブルdbが動作しているデータベースのバージョン。

0..1

context_id

文字列

このプラガブル・データベースのリクエストID。

1

canonicalLink

URI

GETおよびDELETEなどのクラウド相互作用の実行に使用できます。

1

49.4.2 プラガブル・データベース・リソースに対してサポートされる操作

次の表に、Pluggable Database as Serviceの各種リソースでサポートされるすべての操作を示します。

表49-45 サポートされる操作

リソース

GET

POST

PUT

DELETE

Cloud

はい

いいえ

いいえ

いいえ

サービス・ファミリ・タイプ

はい

いいえ

いいえ

いいえ

DBゾーン

はい

はい

いいえ

いいえ

PluggableDbプラットフォーム・テンプレート[サービス・テンプレート]

はい

はい

いいえ

いいえ

PluggableDbプラットフォーム・インスタンス[サービス・インスタンス]

はい

はい

いいえ

はい

49.4.3 Pluggable Database as a Service REST APIの例

次の各項では、Enterprise Manager Cloud Controlとクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。クラウドのGET、dbaasファミリ・タイプのGETおよびDbゾーンのGETの例は、Dbaas REST APIの項で説明します。次の例について説明します。

- プラガブルDbプラットフォーム・テンプレート・リソースの詳細の表示

- プラガブル・データベースの作成

- DBゾーンへのリクエスト渡しによるプラガブル・データベースの作成

- プラガブルDBプラットフォーム・テンプレートへのリクエスト渡しによるプラガブル・データベースの作成

- プラガブル・データベース作成の詳細の表示

- プラガブル・データベース・インスタンスの削除

- プラガブル・データベース・インスタンスに対するライフサイクル操作

- プラガブル・データベースの停止

- プラガブル・データベースの起動

- プラガブル・データベースに対するバックアップのスケジュール

- バックアップからのプラガブル・データベースのリストア

49.4.3.1 プラガブルDbプラットフォーム・テンプレート・リソースの詳細の表示

プラガブルDbプラットフォーム・テンプレートに対するGETリクエストによって、プラガブルDBサービス・テンプレートの詳細が得られます。

表49-46 プラガブルDBプラットフォーム・テンプレート・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatformtemplate/E32F474628FCCE5AE040E50ACA84603A

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "/em/cloud/dbaas/pluggabledbplatformtemplate/E32F474628FCCE5AE040E50ACA84603A",
"name": "Sample PDB template",
"description": "Sample PDB template",
"resource_state": {
"state": "READY"
},
"media_type": "application/oracle.com.cloud.common.PluggableDbPlatformTemplate+json",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatformtemplate/E32F474628FCCE5AE040E50ACA84603A",
"type": "dbaas",
"created": "2013-08-05T07:34:10+0000",
"zones": {
"media_type": "application/oracle.com.cloud.common.DbZone+json",
"total": "1",
"elements": [
{
"uri": "/em/cloud/dbaas/zone/76663B316DCB26E6836822224C7881E3",
"name": "Ssa_zone1",
"description": "Ssa_zone1",
"context_id": "76663B316DCB26E6836822224C7881E3",
"media_type": "application/oracle.com.cloud.common.DbZone+json",
"service_family_type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/76663B316DCB26E6836822224C7881E3",
"type": "self_service_zone"
"target_nodes_for_placement":
[              "xyz.mycompany.com"            ]
}
]
},
"service_instances": {
"media_type": "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json",
"total": "1",
"elements": [
{
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"name" : "database_MYPDB_000" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7" ,
"target_type" : "oracle_pdb" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7"
}
]
},
"number_of_tablespaces" : "1" ,
"deployment_params": [
{
"description" : "Name of the additional service created as part of the pdb service request" ,
"name" : "service_name" ,
"require" : "true" ,
"type" : "STRING" ,
"sensitive" : "false"
} ,
{
"name": "workload_name",
"description": "WorkLoad name to be associated with the request",
"type": "STRING",
"require": "true",
"sensitive": "false"
},
{
"name": "username",
"description": "Pluggable database admin username",
"type": "STRING",
"require": "true",
"sensitive": "false"
},
{
"name": "password",
"description": "Pluggable database admin user password",
"type": "STRING",
"require": "true",
"sensitive": "true"
},
{
"name" : "target_nodes_for_placement" ,
"description" : "List of available Container Database(s) to be chosen for creating the Pluggable database instance." ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"description" : "Name of Pluggable database" ,
"name" : "pdb_name" ,
"require" : "true" ,
"type" : "STRING" ,
"sensitive" : "false"
} ,
{
"description" : "List of tablespace names. Required only for EMPTY_PDB templates" ,
"name" : "tablespaces" ,
"require" : "false" ,
"type" : "LIST" ,
"sensitive" : "false"
},
{
"name": "target_name",
"description": "Target cdb name to be chosen for installing the pdb",
"type": "STRING",
"require": "false",
"sensitive": "true"
},
],
"subtype": "pdb",
"template_type": "PDB_FROM_PROFILE",
"workloads": [
{
"name": "wl1",
"description": "null",
"attributes": [
{
"name": "CPU",
"value": "1",
"units": "cores"
},
{
"name": "Memory",
"value": "1",
"units": "GB"
},
{
"name": "Storage",
"value": "1",
"units": "GB"
}
]
}
],
"params": {
"workload_name": "",
"placement_option" : "SELECT_TARGET_FROM_REQUEST" ,
"username": "",
"password": "",
"pdb_name" : "" ,
"service_name" : "" ,
"tablespaces" :
[      ]
}
}

49.4.3.2 プラガブル・データベースの作成

この項では、クラウド・リソースを使用したプラガブル・データベースの作成方法について説明します。

プラガブル・データベースはサービス・ファミリ・タイプdbaasのサービス・インスタンスでもあるため、プラガブル・データベースを作成する同じファミリ・タイプのゾーンを指定する必要があります。プラガブル・データベースを作成するには、2つの方法を利用できます。

- DBゾーンへのリクエスト渡しによるプラガブル・データベースの作成

- プラガブルDBプラットフォーム・テンプレートへのリクエスト渡しによるプラガブル・データベースの作成

POSTで送信した本文の属性を書き留めます。パターンは、他のサーバー・インスタンスの作成と同じです。意図が明確であるため、DbゾーンにPOSTするときにzone属性は不要です。同様に、PluggableDbPlatformTemplateにPOSTするときにbased_on属性は不要です。

49.4.3.2.1 DBゾーンへのリクエスト渡しによるプラガブル・データベースの作成

次に、DbゾーンにPOSTするための構成を示します。

表49-47 DBゾーンへのリクエスト渡しによってプラガブル・データベースを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/zone/82CF1C28FA20A183C99D138FF8065F19

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

Accept: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

本文

{
"based_on" : "/em/cloud/dbaas/pluggabledbplatformtemplate/FADF7229EB960330E043E176F00ADE61" ,
"name" : "Test Service" ,
"start_date": "2013-08-02T14:20:00ZAsia/Calcutta",
"end_date": "2013-08-02T17:20:00ZAsia/Calcutta",
"params" :     {
"username" : "Pdbaas_API_User" ,
"pdb_name" : "pdb_lrgemg880" ,
"workload_name" : "Small" ,
"service_name" : "TestService" ,
"password" : "welcome1" ,
"tablespaces" :
[
"tbsp1"
]
"target_name " : "test_cdb"
}
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri": "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/31",
"name": "Test Service",
"resource_state": {
"state": "INITIATED"
"messages" :
[
{
"date" : "2014-11-25T09:52:49+0000" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/22",
"text" : "Delete Request ID is : 22"
}
]
},
"media_type": "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/31",
"status": "SCHEDULED"
}

49.4.3.2.2 プラガブルDBプラットフォーム・テンプレートへのリクエスト渡しによるプラガブル・データベースの作成

次に、PluggableDbPlatformTemplateにPOSTするための構成を示します。

表49-48 プラガブルDBプラットフォーム・テンプレートへのリクエスト渡しによってプラガブル・データベースを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatformtemplate/CC3BBB665A6BC6FFE040F00AEF252456

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

Accept: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

本文

{
"zone": "/em/cloud/dbaas/zone/E125CDA8B810BB2F8ECE9867AFC25903",
"name" : "Request for an Empty PDB BA",
"end_date": "2015-11-20T17:20:00ZAsia/Calcutta",
"params" :     {
"username" : "TestUser",
"password" : "welcome1",
"workload_name": "SmallPdb",
"pdb_name" : "BoAPDB",
"service_name" : "BoAPDB_Service" ,
"tablespaces" : [ "pdb_tbs1", "pdb_tbs2" ] },
"instance_target_properties": [
{ "name": "Department", "value": "Development" },
{ "name": "Comment", "value": "BofA testing" }
]
}

リクエスト・メソッド

POST

注意:
PDBサービス・テンプレート内で、カスタム配置オプション(SELECT_TARGET_OPTION)が"SELECT_TARGET_FROM_REQUEST"に設定されている場合、target_nameプロパティは必須プロパティです。また、指定されたCDB名が、選択されたゾーンで使用できる必要があります。

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/122" ,
"name" : "Request for an Empty PDB BofA" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/123" ,
"text" : "Delete Request ID is : 123" ,
"date" : "2015-11-19T10:41:38+0000"
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/122" ,
"status" : "SCHEDULED"
}

49.4.3.3 プラガブル・データベース作成の詳細の表示

プラガブルDBプラットフォーム・インスタンスに対するGETリクエストによって、リソースのステータスなどの情報が得られます。

表49-49 プラガブル・データベース作成の詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/31

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/31",
"name": "Test Service_CREATE_11_53",
"description": "Create Database for \"Test Service\".",
"resource_state":
{
"state": "CREATING"
},
"context_id": "31",
"media_type": "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json",
"status": "IN_PROGRESS",
"created": "2013-06-07 23:09:04" ,
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/31"
}

resource_state属性はCREATING状態であり、プラガブル・データベースが作成中であることを示しています。プラガブル・データベースが作成されると、GET操作の戻り値には、次のようにプラガブル・データベース・リソースがREADY状態であることが示されます。

{
"destination_zone" : "/em/cloud/dbaas/zone/9A71CBEABCA367D0D425697DC39B3AF9" ,
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"db_version" : "12.1.0.1.0" ,
"resource_state" :     {
"state" : "READY"
"messages" :
[
{
"date" : "2014-11-25T09:52:49+0000" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/22",
"text" : "Delete Request ID is : 22"
}
]
} ,
"status" : "RUNNING" ,
"based_on" : "/em/cloud/dbaas/pluggabledbplatformtemplate/E33799E249513428E040F50A994210F5" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/31" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=MYPDB_000)(INSTANCE_NAME=t105kfv)(UR=A)(SERVER=DEDICATED)))" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/31" ,
"context_id" : "31" ,
"created" : "2013-08-05 17:30:30" ,
"name" : "database_MYPDB_000" ,
"target_type" : "oracle_pdb"
}

49.4.3.4 プラガブル・データベース・インスタンスの削除

リソースのURIでDELETEリクエストを発行して、プラガブル・データベースを削除できます。たとえば、次のようなDELETEリクエストを発行できます。

表49-50 プラガブル・データベース・インスタンスを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"context_id" : "7" ,
"resource_state" :     {
"state" : "DESTROYING" ,
"messages" :
[
{
"text" : "Submit 'DELETE' operation on 'application/oracle.com.cloud.common.PluggableDbPlatformInstance+json' 'database_MYPDB_000'.  The process has job id '24'" ,
"date" : "2013-08-05T17:35:56+0000"
}
]
} ,
"name" : "database_MYPDB_000" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7" ,
"target_type" : "oracle_pdb" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7"
}

一定期間後、データベース・サービスURIでのGETリクエストにより、次の相互作用が生成されます。

表49-51 DELETEリクエストのステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/22

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"destination_zone" : "/em/cloud/dbaas/zone/9A71CBEABCA367D0D425697DC39B3AF9" ,
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"db_version" : "12.1.0.1.0" ,
"resource_state" :     {
"state" : "READY"
} ,
"status" : "DESTROYING" ,
"based_on" : "/em/cloud/dbaas/pluggabledbplatformtemplate/E33799E249513428E040F50A994210F5" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=MYPDB_000)(INSTANCE_NAME=t105kfv)(UR=A)(SERVER=DEDICATED)))" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7" ,
"context_id" : "7" ,
"created" : "2013-08-05 17:30:30" ,
"name" : "database_MYPDB_000" ,
"target_type" : "oracle_pdb"
}

プラガブル・データベース・インスタンスを削除すると、プラガブル・データベースのステータスはDELETEDになります。

49.4.3.5 プラガブル・データベース・インスタンスに対するライフサイクル操作

リソースのURIでPOSTリクエストを発行して、プラガブル・データベースに対する操作を実行できます。

POSTリクエストを使用して、次のタスクを実行できます。

- プラガブル・データベースの停止

- プラガブル・データベースの起動

- プラガブル・データベースに対するバックアップのスケジュール

- バックアップからのプラガブル・データベースのリストア

49.4.3.5.1 プラガブル・データベースの停止

次に、PluggableDbPlatformInstanceに対してPOSTするための構成を示します。

表49-52 プラガブル・データベースを停止するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

Accept: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

本文

{
"operation" : "SHUTDOWN"
}

リクエスト・メソッド

POST

前述の相互作用から返されるレスポンスのサンプルを次に示します。

{
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/81" ,
"name" : "database_PDBSERVICE_000" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T06:56:25+0000" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/124" ,
"text" : "Successfully submitted SHUTDOWN operation on service instance. Request id - 124."
}
]
} ,
"context_id" : "81" ,
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/81" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 04:19:14" ,
"based_on" : "/em/cloud/dbaas/pluggabledbplatformtemplate/E49AA1BAC2DBA0ECE040F20A60517942" ,
"target_type" : "oracle_pdb" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST= host1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=PDB_000)(INSTANCE_NAME=tbugt)(UR=A)(SERVER=DEDICATED)))" ,
"destination_zone" : "/em/cloud/dbaas/zone/0129A72DB32D4199B59ABFA64085EAB3" ,
"db_version" : "12.1.0.1.0"
}

49.4.3.5.2 プラガブル・データベースの起動

表49-53 プラガブル・データベースを停止するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

Accept: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

本文

{
"operation" : "STARTUP"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/81" ,
"name" : "database_PDBSERVICE_000" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T06:58:58+0000" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/125" ,
"text" : "Successfully submitted STARTUP operation on service instance. Request id - 125."
}
]
} ,
"context_id" : "81" ,
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/81" ,
"status" : "STOPPED" ,
"created" : "2013-08-26 04:19:14" ,
"based_on" : "/em/cloud/dbaas/pluggabledbplatformtemplate/E49AA1BAC2DBA0ECE040F20A60517942" ,
"target_type" : "oracle_pdb" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST= host1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=PDB_000)(INSTANCE_NAME=tbugt)(UR=A)(SERVER=DEDICATED)))" ,
"destination_zone" : "/em/cloud/dbaas/zone/0129A72DB32D4199B59ABFA64085EAB3" ,
"db_version" : "12.1.0.1.0"
}

49.4.3.5.3 プラガブル・データベースに対するバックアップのスケジュール

次に、PluggableDbPlatformInstanceに対してPOSTするための構成を示します。

バックアップをスケジュールする場合、ユーザーはバックアップをスケジュール実行する日時を指定する必要があります。日時は、YYYY-MM-DDTHH:MM:SSZFullTimeZonenameの形式で指定する必要があります。

たとえば、太平洋標準時刻(PST)でスケジュールするには、2013-08-27T12:34:45ZAmerica/Los_Angelesと指定します。

ただし、タイムゾーン部分はオプションです。タイムゾーンを指定せずに、2013-08-27T12:34:45Zの形式で指定することもできます。

表49-54 プラガブル・データベースのバックアップをスケジュールするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

Accept: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

本文

{
"operation" : "BACKUP",
"backup_schedule" : "2013-08-27T12:34:45ZAsia/Calcutta"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/81" ,
"name" : "database_PDBSERVICE_000" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:01:15+0000" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/126" ,
"text" : "Successfully submitted BACKUP operation on service instance. Request id - 126."
}
]
} ,
"context_id" : "81" ,
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/81" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 04:19:14" ,
"based_on" : "/em/cloud/dbaas/pluggabledbplatformtemplate/E49AA1BAC2DBA0ECE040F20A60517942" ,
"target_type" : "oracle_pdb" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=PDB_000)(INSTANCE_NAME=tbugt)(UR=A)(SERVER=DEDICATED)))" ,
"destination_zone" : "/em/cloud/dbaas/zone/0129A72DB32D4199B59ABFA64085EAB3" ,
"db_version" : "12.1.0.1.0"
"RMAN_backup_list" :
[
{
"Key" : "1" ,
"Tag" : "ORA$OEM_LEVEL_0" ,
"Completed Time" : "Aug 27, 2013 12:24:02 AM" ,
"Contents" : "SPFILE,CONTROLFILE" ,
"Status" : "AVAILABLE"
}
]
}

49.4.3.5.4 バックアップからのプラガブル・データベースのリストア

次に、PluggableDbPlatformInstanceに対してPOSTするための構成を示します。

バックアップからリストアする場合、ユーザーはデータベースをリストアする時点を指定する必要があります。日時は、YYYY-MM-DDTHH:MM:SSZFullTimeZonenameの形式で指定する必要があります。

たとえば、太平洋標準時刻(PST)でスケジュールするには、2013-08-27T12:34:45ZAmerica/Los_Angelesと指定します。

ただし、タイムゾーン部分はオプションです。タイムゾーンを指定せずに、2013-08-27T12:34:45Zの形式で指定することもできます。

リストアできる時点は、利用可能なバックアップによって異なります。GETリクエストのRMAN_backup_listセクションを参照してください。

表49-55 バックアップからプラガブル・データベースをリストアするためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/7

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

Accept: application/oracle.com.cloud.common.PluggableDbPlatformInstance+json

本文

{
"operation" : "RESTORE",
"restore_date" : "2013-08-27T12:34:45Z"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/81" ,
"name" : "database_PDBSERVICE_000" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2013-08-27T07:01:15+0000" ,
"uri" : "/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/146" ,
"text" : "Successfully submitted RESTORE operation on service instance. Request id - 146."
}
]
} ,
"context_id" : "81" ,
"media_type" : "application/oracle.com.cloud.common.PluggableDbPlatformInstance+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/pluggabledbplatforminstance/byrequest/81" ,
"status" : "RUNNING" ,
"created" : "2013-08-26 04:20:14" ,
"based_on" : "/em/cloud/dbaas/pluggabledbplatformtemplate/E49AA1BAC2DBA0ECE040F20A60517942" ,
"target_type" : "oracle_pdb" ,
"connect_string" : "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=PDB_000)(INSTANCE_NAME=tbugt)(UR=A)(SERVER=DEDICATED)))" ,
"destination_zone" : "/em/cloud/dbaas/zone/0129A72DB32D4199B59ABFA64085EAB3" ,
"db_version" : "12.1.0.1.0"
}

50 DBaaS REST APIおよびEM CLI動詞ベースのユースケース

この章では、このリリースでサポートされる様々なDBaaSユースケースの手順について説明します。次のセクションがあります。

- REST APIおよびEM CLI動詞でのDBaaSの開始

- REST APIおよびEM CLI動詞でのデータベース・テンプレートを使用したデータベースの作成

- REST APIおよびEM CLI動詞での空のスキーマおよびプロファイルに基づくスキーマの作成

- REST APIおよびEM CLI動詞での空のPDBおよびプロファイルに基づくPDBの作成

- あるデータベースから別のデータベースへのデータの移行/転送

- REST APIおよびEM CLI動詞でのスナップ・クローンを使用したデータベースの作成

- REST APIおよびEM CLI動詞でのRMANを使用したフル・データベース・クローンの作成

- REST APIを使用したカスタム・データベース配置オプションの構成

- Database as a Serviceのサービス・カタログ

50.1 REST APIおよびEM CLI動詞でのDBaaSの開始

次の図に、Enterprise Manager DBaaSの様々な形態の概要を示します。

図50-1 DBaaSユースケース

この表では、このリリースでサポートされているDBaaSユースケースをリストし、これらのユースケースの実行に使用できる様々な方法(EMCLIおよびREST API)をリストします。

表50-1 DBaaSユースケース

サービス・タイプ

サービス提供

参照

新規

データベース・テンプレートを使用したデータベースの作成。

第50.2項「REST APIおよびEM CLI動詞でのデータベース・テンプレートを使用したデータベースの作成」

新規

スキーマ:

- 空のスキーマの作成

- プロファイルに基づくスキーマの作成

第50.3項「REST APIおよびEM CLI動詞での空のスキーマおよびプロファイルに基づくスキーマの作成」

新規

プラガブル・データベース:

- 空のプラガブル・データベースの作成

- プロファイルに基づくプラガブル・データベースの作成

第50.4項「REST APIおよびEM CLI動詞での空のPDBおよびプロファイルに基づくPDBの作成」

あるデータベースから別のデータベースへのデータの移行または転送。

第50.5項「あるデータベースから別のデータベースへのデータの移行/転送」

スナップ・クローン

- ソフトウェア・ソリューション:

- Sun ZFS

- CloneDB

- ハードウェア・ソリューション:

- ZFSファイル・システム

- NetApp

- EMC

第50.6項「REST APIおよびEM CLI動詞でのスナップ・クローンを使用したデータベースの作成」

クローン

フル・クローン:

- RMANバックアップを使用したデータベースのクローニング

- RMAN複製を使用したデータベースのクローニング

第50.7項「REST APIおよびEM CLI動詞でのRMANを使用したフル・データベース・クローンの作成」

新規DBaaS設定

複数データセンターDBaaS設定

第50.9.1項「複数データセンターDBaaS設定」

50.2 REST APIおよびEM CLI動詞でのデータベース・テンプレートを使用したデータベースの作成

DBCAテンプレートでは、構造およびデータのタイプと、構造のみのタイプの両方がサポートされます。このデータベース・プロビジョニング・プロファイルは、Enterprise Managerに登録された本番データベースまたはソース・データベースから作成されます。構造およびデータのタイプと、構造のみのタイプの両方がサポートされます。このオプションは、作成されるデータベース・サイズが10 GB未満の場合に推奨されます。

次の表に、データベース・テンプレート・ベースのプロファイルを使用したデータベースの作成に必要なタスクのリストを示します。

データベース・テンプレート・ベースのプロファイルを使用して、単一インスタンスおよびクラスタ・データベースを作成できます。

注意:
次の表では、手順でREST APIを使用できない場合はEM CLI動詞が提供され、EM CLI動詞を使用できない場合はREST APIが提供されています。

表50-2 REST APIおよびEM CLI動詞でのデータベース・テンプレートを使用したデータベースの作成

手順

作業

REST API

EM CLI動詞

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

第12.1項「はじめに」を参照してください。

2

リソース・プロバイダを作成します。

- 1つ以上のPaaSインフラストラクチャ・ゾーンを作成します。

- 1つ以上のデータベース・プールを作成します。

関連項目:

- 第48.3.1.3.3項「PaaSゾーンの作成」

- 第48.3.2.3.4項「データベース・プールの作成」

関連項目:

- 第47.1項「PaaSゾーンEM CLI動詞」

- 第47.2項「ソフトウェア・プールEM CLI動詞」

6

DBCAテンプレート・ベースのデータベース・プロビジョニング・プロファイルを作成します。

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

4

リクエスト設定を作成します。

第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照

第47.4項「データベース・リクエスト設定EM CLI動詞」を参照

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照

第47.3項「データベース割当て制限EM CLI動詞」を参照

7

作成したプロファイルに基づくサービス・テンプレートを作成します。

第48.3.5.3項「サービス・テンプレート群REST APIおよびサービス・テンプレートREST APIの例」を参照してください

第47.7項「サービス・テンプレートEM CLI動詞」を参照

8

チャージバック・サービスを構成します。

第56.1項「UIと同等のチャージバック操作の実行」を参照

第56.1項「UIと同等のチャージバック操作の実行」を参照

9

データベースのデプロイ時に、作成した(データベース・テンプレート・ベースのプロファイルに関連付けられた)サービス・テンプレートを選択します。

第49.2.3.8項「データベース・インスタンスの作成」を参照

第49.2.3.8項「データベース・インスタンスの作成」を参照

50.2.1 REST APIおよびEM CLI動詞でのスタンバイ・データベースの作成

Data Guard構成は、1つのプライマリ・データベースと1つ以上のスタンバイ・データベースで構成されます。Data Guard構成内のデータベースはOracle Netで接続され、地理的に散在していてもかまいません。データベースが相互に通信できる場合、データベースの位置に関する制限はありません。

Oracle Data Guardは、企業データの高可用性、データ保護および障害時リカバリを保証します。1つ以上のスタンバイ・データベースを作成、維持、管理、監視して、本番のOracleデータベースが障害やデータ破損に耐えられるようにするための包括的なサービス・セットが用意されています。Oracle Data Guardでは、これらのスタンバイ・データベースを本番データベースのコピーとしてメンテナンスします。計画停止または計画外停止により、本番データベースが使用できなくなった場合、Oracle Data Guardはいずれかのスタンバイ・データベースを本番ロールに切り替えることで、停止に伴う停止時間を最小化できます。

本番データベース(プライマリ・データベースとも呼ばれる)は、単一インスタンスのOracleデータベースまたはOracle Real Application Clusters (RAC)データベースのいずれかにすることができます。スタンバイ・データベースは、トランザクション全体で一貫性を持つ、プライマリ・データベースのコピーです。プライマリ・データベースのバックアップ・コピーを使用することで、1つ以上のスタンバイ・データベースを作成し、それをData Guard構成に組み込むことができます。EM_SSA_ADMINISTRATORロールを持つユーザーは、Enterprise Manager Database as a Serviceを使用して、RACスタンバイ・データベースの単一インスタンスを含むDBaaSクラウドを設定できます。

注意:
次の表では、手順でREST APIを使用できない場合はEM CLI動詞が提供され、EM CLI動詞を使用できない場合はREST APIが提供されています。

表50-3 REST APIおよびEM CLI動詞でのスタンバイ・データベースの作成

手順

作業

REST API

EM CLI動詞

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

第12.1項「はじめに」を参照してください。

2

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。

第48.3.1.3.3項「PaaSゾーンの作成」を参照

第47.1項「PaaSゾーンEM CLI動詞」を参照

3

スタンバイ・データベースをプロビジョニングするためのデータベース・プールを定義します。

第48.3.2.3.4項「データベース・プールの作成」を参照してください。

第47.2項「ソフトウェア・プールEM CLI動詞」を参照

4

リクエスト設定を構成します。

第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照

第47.4項「データベース・リクエスト設定EM CLI動詞」を参照

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照

第47.3項「データベース割当て制限EM CLI動詞」を参照

6

次のいずれかのタイプのプロファイルを作成します。

- DBCAテンプレート・ベースのデータベース・プロビジョニング・プロファイル。

- RMANバックアップ・ベースのデータベース・プロビジョニング・プロファイル。

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

7

作成したプロファイルに基づくサービス・テンプレートを作成します。

第48.3.5.3項「サービス・テンプレート群REST APIおよびサービス・テンプレートREST APIの例」を参照してください

第47.7項「サービス・テンプレートEM CLI動詞」を参照

8

チャージバック・サービスを構成します。

第56.1項「UIと同等のチャージバック操作の実行」を参照

第56.1項「UIと同等のチャージバック操作の実行」を参照

9

データベースのデプロイ時に、作成した(DBCAテンプレート・ベースのプロファイルに関連付けられた)サービス・テンプレートを選択します。また、データベースのリクエスト時にスタンバイ・データベースの情報を指定することもできます。

第49.2.3.8項「データベース・インスタンスの作成」を参照

第49.2.3.8項「データベース・インスタンスの作成」を参照

50.3 REST APIおよびEM CLI動詞での空のスキーマおよびプロファイルに基づくスキーマの作成

データベース・プロビジョニング・プロファイルのデータ・コンテンツは、エクスポート・ダンプからコンパイルされます。スキーマ・オブジェクト(構造のみ)またはスキーマおよびデータ(構造およびデータ)のエクスポートを選択できます。

次の表に、空のスキーマの作成またはプロファイルに基づくスキーマの作成に必要なタスクのリストを示します。

注意:
次の表では、手順でREST APIを使用できない場合はEM CLI動詞が提供され、EM CLI動詞を使用できない場合はREST APIが提供されています。

表50-4 REST APIおよびEM CLI動詞でのスキーマの作成

手順

作業

REST API

EM CLI動詞

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

第12.1項「はじめに」を参照してください。

2

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。

第48.3.1.3.3項「PaaSゾーンの作成」を参照

第47.1項「PaaSゾーンEM CLI動詞」を参照

3

Schema as a Serviceのデータベース・プールを定義します。

第48.3.2.3.6項「スキーマ・プールの作成」を参照

第47.2項「ソフトウェア・プールEM CLI動詞」を参照

4

リクエスト設定を構成します。

第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照

第47.4項「データベース・リクエスト設定EM CLI動詞」を参照

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照

第47.3項「データベース割当て制限EM CLI動詞」を参照

6

データベース・プロビジョニング・プロファイルを作成します。この手順はオプションで、プロファイルからスキーマをインポートする場合に必要です。

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

7

次のものに基づくサービス・テンプレートを作成します。

- ユーザー定義スキーマ: この場合、サービス・テンプレートは空のスキーマで作成されます。

- プロファイルからのスキーマ: この場合、データベース・プロビジョニング・プロファイルからスキーマをインポートできます。eBusinessアプリケーションなどのデータを使用したアプリケーションに対してこのオプションを選択できます。

第48.3.5.3.13項「スキーマ用のサービス・テンプレートの作成」を参照してください

第47.7項「サービス・テンプレートEM CLI動詞」を参照

8

チャージバック・サービスを構成します。

第56.1項「UIと同等のチャージバック操作の実行」を参照

第56.1項「UIと同等のチャージバック操作の実行」を参照

9

サービス・テンプレートに基づくスキーマを作成します。

第49.3.3.2項「スキーマ・サービスの作成」を参照

第49.3.3.2項「スキーマ・サービスの作成」を参照

50.4 REST APIおよびEM CLI動詞での空のPDBおよびプロファイルに基づくPDBの作成

Oracle Databaseには、Oracle Netクライアントに個別のデータベースとして表示される、スキーマ、スキーマ・オブジェクトおよび非スキーマ・オブジェクトのポータブル・コレクションを含めることができます。この自己完結型コレクションは、プラガブル・データベース(PDB)と呼ばれます。マルチテナントのコンテナ・データベース(CDB)は、1つ以上のPDBを含むデータベースです。Oracle Database 12c リリース1 (12.1)以上のバージョンでは、1つのCDB内に多数のPDBを作成できます。

注意:
次の表では、手順でREST APIを使用できない場合はEM CLI動詞が提供され、EM CLI動詞を使用できない場合はREST APIが提供されています。

表50-5 REST APIおよびEM CLI動詞でのプラガブル・データベースの作成

手順

作業

REST API

EM CLI動詞

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

第12.1項「はじめに」を参照してください。

2

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。

第48.3.1.3.3項「PaaSゾーンの作成」を参照

第47.1項「PaaSゾーンEM CLI動詞」を参照

3

PDB as a Service用のデータベース・プールを作成します。

第48.3.2.3.8項「プラガブル・データベース・プールの作成」を参照

第47.2項「ソフトウェア・プールEM CLI動詞」を参照

4

リクエスト設定を構成します。

第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照

第47.4項「データベース・リクエスト設定EM CLI動詞」を参照

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照

第47.3項「データベース割当て制限EM CLI動詞」を参照

6

データベース・プロビジョニング・プロファイルを作成します。この手順は、空のプラガブル・データベースを作成する場合はオプションで、必須ではありません。

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

7

サービス・テンプレートを作成します。サービス・テンプレートは、次を含むことができます。

- 空のプラガブル・データベース: この場合、サービス・テンプレートは空のスキーマで作成されます。

- プロファイルのプラガブル・データベース: この場合は、データベース・プロビジョニング・プロファイルからスキーマをインポートできます。eBusinessアプリケーションなどのデータを使用したアプリケーションに対してこのオプションを選択できます。

Section 48.3.5.3.14項「プラガブル・データベース用のサービス・テンプレートの作成」を参照してください

第47.7項「サービス・テンプレートEM CLI動詞」を参照

8

チャージバック・サービスを構成します。

第56.1項「UIと同等のチャージバック操作の実行」を参照

第56.1項「UIと同等のチャージバック操作の実行」を参照

9

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第49.4.3.2項「プラガブル・データベース・プールの作成」を参照

第49.4.3.2項「プラガブル・データベース・プールの作成」を参照

50.5 あるデータベースから別のデータベースへのデータの移行/転送

EM CLI動詞を使用してあるデータベースから別のデータベースへデータを移行するには、次の手順に従います。

1. EM CLI動詞emcli describe_dbprofile_input -data_mode=EXPORTを入力します。出力により、プロファイル作成のすべての入力変数が提供されます。

注意:
エクスポートはデータベースでのみサポートされますが、インポートはデータベースとPDBの両方でサポートされます。つまり、ソースは常にデータベースである必要がありますが、宛先はデータベースまたはPDBのいずれかになります。

2. 入力変数を使用して、すべての変数の値を含むプロパティ・ファイルを作成します。

3. データベース・プロファイルを作成してソース・データベースからデータをエクスポートします。これを行うには、動詞emcli create_dbprofile - input_file=data:<properties file name along with path>を入力します。

注意:
前の手順で作成したプロパティ・ファイルをこの動詞に使用します。

動詞の詳細は、第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください。

4. データを転送する動詞emcli data_transfer -input_file=data:/u01/files/data_trans.propsを入力します。
動詞とプロパティ・ファイルの詳細は、第47.16項「データベース間でのデータの転送」を参照してください。

5. 宛先データベースにデータをインポートする動詞emcli dbimport -input_file=data:/u01/files/dbimport.propsを入力します。
動詞とプロパティ・ファイルの詳細は、第47.18項「エクスポート・ダンプからデータベースへのデータのインポート」を参照してください。

50.6 REST APIおよびEM CLI動詞でのスナップ・クローンを使用したデータベースの作成

スナップ・クローンは、セルフ・サービス・アプリケーション(SSA)方式で巨大データベースの高速で領域節約型のクローンを作成する方法です。テストや開発のために本番データベースのクローンが頻繁に必要となりますが、データベースが巨大な場合には特に、クローンの作成は困難で時間のかかる作業となります。

Enterprise Managerではこの問題への対処としてスナップ・クローンが提供されていますので、一部のストレージ・システムで利用可能なコピー・オン・ライト・テクノロジを使用して本番データベースからシン・クローンを作成できます。これは、クローンが最初はわずかな領域(数テラバイトのデータベースのシン・クローンに対して約2GBの書込み可能領域)を占有し、挿入、更新および削除が行われるにつれて大きくなることを意味します。Enterprise Managerでは、スナップ・クローンに次の2つのソリューションが提供されています。

- ハードウェア・ソリューション: NetApps、Oracle Sun ZFSストレージ・アプライアンス、EMC VMAXおよびVNXがサポートされるベンダー固有のハードウェア・ソリューション。

- ソフトウェア・ソリューション: すべてのNASストレージ・デバイスおよびSANストレージ・デバイスがサポートされるストレージ非依存型のソフトウェア・ソリューション。このソリューションは、ZFSファイル・システムおよびCloneDB機能を使用してサポートされています。

スナップ・クローンの主な機能は次のとおりです。

- セルフ・サービス駆動型のアプローチ: セルフ・サービス・ユーザーは、必要に応じて非定型ベースでデータベースをクローニングできます。

- 迅速なクローニング: データベースは、数日や数週間ではなく数分のうちにクローニングできます。

- 領域の効率性: この機能によって、ユーザーは、ストレージ・フットプリントを大幅に削減できます。

50.6.1 REST APIおよびEM CLI動詞でのプロファイルを使用したスナップ・クローンの作成

この表では、スナップショットまたはRMANイメージ・プロファイルを使用したスナップ・クローンの作成に必要な手順を示します。

注意:
次の表では、手順でREST APIを使用できない場合はEM CLI動詞が提供され、EM CLI動詞を使用できない場合はREST APIが提供されています。

表50-6 REST APIおよびEM CLI動詞でのプロファイルを使用したスナップ・クローン・データベースの作成

手順

作業

REST API

EM CLI動詞

1

スナップ・クローンを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

第12.1項「はじめに」を参照してください。

2

ストレージ・サーバーを登録します。

- NetAppおよびSun ZFSストレージ・サーバー

- Solarisファイル・システム(ZFS)

- EMCストレージ・サーバー

- 第12.7.4.1項「NetAppまたはSun ZFSストレージ・サーバーの登録」

- 第12.7.4.2項「Solaris File System (ZFS)ストレージ・サーバーの登録」

- 第12.7.4.3項「EMCストレージ・サーバーの登録」

- 第12.7.4.1項「NetAppまたはSun ZFSストレージ・サーバーの登録」

- 第12.7.4.2項「Solaris File System (ZFS)ストレージ・サーバーの登録」

- 第12.7.4.3項「EMCストレージ・サーバーの登録」

3

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。

第48.3.1.3.3項「PaaSゾーンの作成」を参照

第47.1項「PaaSゾーンEM CLI動詞」を参照

4

データベース・プールを作成します。

第48.3.2.3.4項「データベース・プールの作成」を参照してください。

第47.2項「ソフトウェア・プールEM CLI動詞」を参照

5

リクエスト設定を構成します。

第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照

第47.4項「データベース・リクエスト設定EM CLI動詞」を参照

6

各セルフ・サービス・ユーザーの割当て制限を定義します。

第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照

第47.3項「データベース割当て制限EM CLI動詞」を参照

7

テスト・マスター・データベースを設定してスナップ・クローンを有効化します。

第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください

第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください

8

使用しているスナップ・クローン・ソリューションに応じて、次の手順のいずれかを実行する必要があります。

- ハードウェア・ソリューション: スナップ・クローンに基づいたプロファイルを作成します。

- ソフトウェア・ソリューション: RMANイメージ・プロファイルを作成します。

スナップ・クローンを使用したデータベース・プロビジョニング・プロファイルを作成します。

- ハードウェア・ソリューション: 第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

- ソフトウェア・ソリューション: 第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

- ハードウェア・ソリューション: 第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

- ソフトウェア・ソリューション: 第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

9

作成したプロファイルに基づくサービス・テンプレートを作成します。

- ハードウェア・ソリューション: 第20.4.9項「スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

- ソフトウェア・ソリューション: 第48.3.5.3項「サービス・テンプレート群REST APIおよびサービス・テンプレートREST APIの例」を参照してください

- ハードウェア・ソリューション: 第20.4.9項「スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

- ソフトウェア・ソリューション: 第47.7項「サービス・テンプレートEM CLI動詞」を参照

10

チャージバック・サービスを構成します(この手順はオプションです)。

第56.1項「UIと同等のチャージバック操作の実行」を参照

第56.1項「UIと同等のチャージバック操作の実行」を参照

11

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第49.2.3.8項「データベース・インスタンスの作成」を参照

第49.2.3.8項「データベース・インスタンスの作成」を参照

50.6.2 REST APIおよびEM CLI動詞でのライブ・データベースを使用したスナップ・クローンの作成

この表では、ライブ・スタンバイ・データベースを使用したスナップ・クローンの作成に必要な手順を示します。

注意:
次の表では、手順でREST APIを使用できない場合はEM CLI動詞が提供され、EM CLI動詞を使用できない場合はREST APIが提供されています。

表50-7 REST APIおよびEM CLI動詞でのライブ・データベースを使用したスナップ・クローンの作成

手順

作業

REST API

EM CLI動詞

1

スナップ・クローンを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

第12.1項「はじめに」を参照してください。

2

ストレージ・サーバーを登録します。

- NetAppおよびSun ZFSストレージ・サーバー

- Solarisファイル・システム(ZFS)

- EMCストレージ・サーバー

関連項目:

- 第12.7.4.1項「NetAppまたはSun ZFSストレージ・サーバーの登録」

- 第12.7.4.2項「Solaris File System (ZFS)ストレージ・サーバーの登録」

- 第12.7.4.3項「EMCストレージ・サーバーの登録」

関連項目:

- 第12.7.4.1項「NetAppまたはSun ZFSストレージ・サーバーの登録」

- 第12.7.4.2項「Solaris File System (ZFS)ストレージ・サーバーの登録」

- 第12.7.4.3項「EMCストレージ・サーバーの登録」

3

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。

第48.3.1.3.3項「PaaSゾーンの作成」を参照

第47.1項「PaaSゾーンEM CLI動詞」を参照

4

データベース・プールを作成します。

第48.3.2.3.4項「データベース・プールの作成」を参照してください。

第47.2項「ソフトウェア・プールEM CLI動詞」を参照

5

リクエスト設定を構成します。

第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照

第47.4項「データベース・リクエスト設定EM CLI動詞」を参照

6

各セルフ・サービス・ユーザーの割当て制限を定義します。

第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照

第47.3項「データベース割当て制限EM CLI動詞」を参照

7

ライブ・スタンバイ・データベースを使用してテスト・マスター・データベースを設定します。

第20.4.6項「テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用」を参照してください

第20.4.6項「テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用」を参照してください

9

サービス・テンプレートを作成します。

第48.3.5.3項「サービス・テンプレート群REST APIおよびサービス・テンプレートREST APIの例」を参照してください

第47.7項「サービス・テンプレートEM CLI動詞」を参照

10

チャージバック・サービスを構成します(この手順はオプションです)。

第56.1項「UIと同等のチャージバック操作の実行」を参照

第56.1項「UIと同等のチャージバック操作の実行」を参照

11

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第49.2.3.8項「データベース・インスタンスの作成」を参照

第49.2.3.8項「データベース・インスタンスの作成」を参照

50.6.3 連続同期

連続同期設定には、本番データベースと、ファイラ上(NASストレージ)にあるスタンバイ・データベースが含まれます。スタンバイ・データベースは、プライマリから連続/ライブ・データを取得します。

連続同期データベース設定を設定するには、次の手順に従います。

表50-8 EM CLI動詞を使用した連続同期設定の作成

手順

作業

EM CLI動詞

1

既存のスタンバイ・データベースを追加します。現在、このタスクは、UI画面を通じてのみ実行できます。

該当なし

2

スタンバイ・データベースから新規テスト・マスターを作成します。

第47.6.5項「EM CLI動詞を使用したデータベース・プロファイルの作成」

3

クローンを作成します。

第47.9項「EM CLI動詞を使用したデータベース・クローンの作成」

4

クローンをテスト・マスターとして昇格させます。

現在、このタスクはUI画面を介してのみ実行できます。

該当なし

50.7 REST APIおよびEM CLI動詞でのRMANを使用したフル・データベース・クローンの作成

RMANを使用したフル・データベースのクローニングには2つの方法があります。これらを次に示します。

- RMANバックアップを使用したフル・データベース・クローンの作成

- RMAN複製を使用したフル・データベース・クローンの作成(ライブ・クローニング)

- 不連続同期

50.7.1 RMANバックアップを使用したフル・データベース・クローンの作成

RMAN (Recovery Manager)によって作成されたデータベース・バックアップは、イメージ・コピーまたはバックアップ・セットとして格納されます。これらのバックアップを使用してプロファイルを作成し、それらのプロファイルを使用してフル・データベース・クローンを作成できます。

注意:
次の表では、手順でREST APIを使用できない場合はEM CLI動詞が提供され、EM CLI動詞を使用できない場合はREST APIが提供されています。

表50-9 REST APIおよびEM CLI動詞でのRMANバックアップ・プロファイルを使用したデータベースのクローニング

手順

作業

REST API

EM CLI動詞

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

第12.1項「はじめに」を参照してください。

2

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。

第48.3.1.3.3項「PaaSゾーンの作成」を参照

第47.1項「PaaSゾーンEM CLI動詞」を参照

3

データベース・プールを作成します。

第48.3.2.3.4項「データベース・プールの作成」を参照してください。

第47.2項「ソフトウェア・プールEM CLI動詞」を参照

4

リクエスト設定を構成します。

第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照

第47.4項「データベース・リクエスト設定EM CLI動詞」を参照

5

各セルフ・サービス・ユーザーの割当て制限を定義します。

第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照

第47.3項「データベース割当て制限EM CLI動詞」を参照

6

次のデータベース・プロビジョニング・プロファイルのいずれかを作成します。

- RMANバックアップ

- 既存のRMANバックアップ

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

第47.6.2項「EM CLIを使用したプロビジョニング・プロファイルの作成」を参照してください

7

テスト・マスター・データベースを設定します。

第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください

第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください

8

作成したプロファイルに基づくサービス・テンプレートを作成します。

第48.3.5.3.11項「スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートの作成」を参照してください

第47.7項「サービス・テンプレートEM CLI動詞」を参照

9

チャージバック・サービスを構成します。

第56.1項「UIと同等のチャージバック操作の実行」を参照

第56.1項「UIと同等のチャージバック操作の実行」を参照

10

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第49.2.3.8項「データベース・インスタンスの作成」を参照

第49.2.3.8項「データベース・インスタンスの作成」を参照

50.7.2 RMAN複製を使用したフル・データベース・クローンの作成(ライブ・クローニング)

RMAN (Recovery Manager)によって作成されたデータベース・バックアップは、イメージ・コピーまたはバックアップ・セットとして格納されます。これらのバックアップを使用してプロファイルを作成し、それらのプロファイルを使用してフル・データベース・クローンを作成できます。

注意:
次の表では、手順でREST APIを使用できない場合はEM CLI動詞が提供され、EM CLI動詞を使用できない場合はREST APIが提供されています。

表50-10 REST APIおよびEM CLI動詞でのRMANバックアップを使用したフル・データベース・クローンの作成

手順

作業

REST API

EM CLI動詞

1

DBaaSを有効にする「はじめに」の項の手順に従います。

第12.1項「はじめに」を参照してください。

第12.1項「はじめに」を参照してください。

2

1つ以上のPaaSインフラストラクチャ・ゾーンを設定します。

第48.3.1.3.3項「PaaSゾーンの作成」を参照

第47.1項「PaaSゾーンEM CLI動詞」を参照

3

データベース・プールを作成します。

第48.3.2.3.4項「データベース・プールの作成」を参照してください。

第47.2項「ソフトウェア・プールEM CLI動詞」を参照

4

ライブ・スタンバイ・データベースを使用してテスト・マスターを作成します。

第20.4.6項「テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用」を参照してください

第20.4.6項「テスト・マスターとしてのフィジカル・スタンバイ・データベースの使用」を参照してください

5

リクエスト設定を構成します。

第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照

第47.4項「データベース・リクエスト設定EM CLI動詞」を参照

6

各セルフ・サービス・ユーザーの割当て制限を定義します。

第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照

第47.3項「データベース割当て制限EM CLI動詞」を参照

7

テスト・マスターに基づいてサービス・テンプレートを作成します。

第48.3.5.3.9項「DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの作成」を参照してください

第47.7項「サービス・テンプレートEM CLI動詞」を参照

8

チャージバック・サービスを構成します。

第56.1項「UIと同等のチャージバック操作の実行」を参照

第56.1項「UIと同等のチャージバック操作の実行」を参照

9

データベースのデプロイ時に、作成したサービス・テンプレートを選択します。

第49.2.3.8項「データベース・インスタンスの作成」を参照

第49.2.3.8項「データベース・インスタンスの作成」を参照

50.7.3 不連続同期

不連続同期設定には、直接クローニング操作に使用できない本番データベースが含まれます(そのため、スタンバイ・データベースは含まれません)。管理者は、本番データベースで定期的なバックアップをスケジュールし、そのバックアップを使用してテスト・マスター・データベースを作成します。

不連続同期データベース設定を設定するには、次の手順に従います。

表50-11 EM CLI動詞を使用した不連続同期設定の作成

手順

作業

EM CLI動詞

1

テスト・マスター・データベースを作成します。

第47.9項「EM CLI動詞を使用したデータベース・クローンの作成」

2

完全バックアップを作成します。

第47.6.5項「EM CLI動詞を使用したデータベース・プロファイルの作成」

3

シン・バックアップを作成します。

第47.6.5項「EM CLI動詞を使用したデータベース・プロファイルの作成」

4

クローンを作成します。

第47.9項「EM CLI動詞を使用したデータベース・クローンの作成」

5

テスト・マスターまたはクローンをリフレッシュします。

第47.10項「EM CLI動詞を使用したデータベースのリフレッシュ」

50.8 REST APIを使用したカスタム・データベース配置オプションの構成

この項では、REST APIを使用したカスタム・データベース配置機能について説明します。詳細は、次の項を参照してください。

- REST APIを使用したデータベース用のカスタム・データベース配置オプション

- REST APIを使用したプラガブル・データベース用のカスタム・データベース配置オプション

50.8.1 REST APIを使用したデータベース用のカスタム・データベース配置オプション

カスタム・データベース配置オプションを使用すると、SSAユーザーは、どのホストにデータベース・インスタンスを作成するかを選択するオプションを持ちます。このオプションは、サービス・テンプレートの作成中に、SSA管理者がサービス・テンプレート内で有効にする必要があります。サービス・テンプレートのJSON body内のSELECT_ORACLE_HOME_OPTIONパラメータは、SSAユーザーが、データベース・インスタンスに対してリクエスト発行中にホストを選択するオプションを持つかどうかを定義します。SELECT_ORACLE_HOME_OPTIONが、値"SELECT_ORACLE_HOME_FROM_REQUEST"を使用して設定された場合、SSAユーザーは、データベースのリクエスト発行中にデータベース・ホストを選択するオプションを持ちます。パラメータが定義されていない、パラメータの値が設定されていない、または値が"SELECT_ORACLE_HOME_AT_RUNTIME"に設定された場合、SSAユーザーは、データベース・ホストを選択するオプションを持たず、データベース・インスタンスは、リクエスト実行中に配置アルゴリズムを使用して選択されたホスト上に作成されます。

オプションがサービス・テンプレートで設定されると、SSAユーザーはGET操作をサービス・テンプレートURIで実行し、使用できるホストを表示できます。"hosts_for_placement"パラメータ(SIデータベースの場合)、および"clusters_for_placement"と"hostsInCluster"パラメータ(RACデータベースの場合)により、SSAユーザーで使用できるホストの詳細が指定されます。次に、SSAユーザーは、データベース・インスタンスのリクエスト発行に対するPOST操作内で"database_host_name"パラメータに、データベース配置のためのホスト名を定義する必要があります。

"database_host_name"パラメータは、カスタム配置オプションがサービス・テンプレートで設定された場合、必須パラメータです。database_host_nameリクエスト・パラメータの複数値は、カンマで区切られた値で指定されることに注意してください。RACデータベース・リクエストでは、このパラメータで指定されるホストの数は、サービス・テンプレートで構成されるノードの数に一致する必要があり、指定されたホストはすべて同一のクラスタに所属し、選択されたゾーンに存在する必要があります。

50.8.2 REST APIを使用したプラガブル・データベース用のカスタム・データベース配置オプション

カスタム・データベース配置オプションを使用すると、SSAユーザーは、どのコンテナ・データベース(CDB)にプラガブル・データベース(PDB)・インスタンスを作成するかを選択するオプションを持ちます。このオプションは、サービス・テンプレートの作成中に、SSA管理者がサービス・テンプレート内で有効にする必要があります。

PDBサービス・テンプレートのJSON body内のSELECT_TARGET_OPTIONパラメータは、SSAユーザーが、データベース・インスタンスに対してリクエスト発行中にホストを選択するオプションを持つかどうかを定義します。SELECT_ORACLE_HOME_OPTIONが、値"SELECT_TARGET_FROM_REQUEST"を使用して設定された場合、SSAユーザーは、データベースのリクエスト発行中にCDBを選択するオプションを持ちます。パラメータが定義されていない、パラメータの値が設定されていない、または値が"SELECT_TARGET_AT_RUNTIME"に設定された場合、SSAユーザーは、CDBを選択するオプションを持たず、PDBインスタンスは、リクエスト実行中に配置アルゴリズムを使用して選択されたCDB上に作成されます。

オプションがPDBサービス・テンプレートで設定されると、SSAユーザーはGET操作をサービス・テンプレートURIで実行し、使用できるCDBを表示できます。"target_nodes_for_placement"パラメータは、SSAユーザーが使用できるCDBの詳細を指定します。次に、SSAユーザーは、PDBインスタンスのリクエスト発行に対するPOST操作内で"target_name"パラメータに、PDB配置のためのCDBターゲット名を定義する必要があります。

"target_name"パラメータは、カスタム配置オプションがサービス・テンプレートで設定された場合、必須パラメータです。このパラメータで指定するCDBターゲット名は、選択されたゾーンに存在する必要があります。

50.9 Database as a Serviceのサービス・カタログ

サービス・カタログは、オンデマンドのセルフ・サービス・プロビジョニング用に選択されたコンシューマが使用可能な事前承認済のデータベース構成のコレクションです。一貫性と自動化を施行し、データベース管理オーバーヘッドの削減に役立ちます。

サービス・カタログの提供内容は次のとおりです。

- ITの俊敏性を実現するセルフサービス・プロビジョニング

- 標準化とコンプライアンスを実現するエンタープライズ全体のサービス・カタログ

- 時間とストレージ領域を節約するスナップ・クローンを使用したデータベース・クローニング

- サービス・ガバナンスを保証する測定、チャージバックおよび割当て制限

- サービス・レベルを保証するパフォーマンスおよびライフサイクル管理

- 運用コストを低減するパッチ適用、アップグレードおよび構成自動化

サービス・カタログの詳細は、https://apex.oracle.com/pls/apex/f?p=44785:24:0::::P24_CONTENT_ID,P24_PREV_PAGE:9590,1にあるビデオを参照してください。

次の項では、サンプルの複数データセンターDBaaSを設定するために必要なREST APIについて説明します。

50.9.1 複数データセンターDBaaS設定

複数データセンターDBaaS設定は、データの安全性、リカバリおよびバックアップに関連するすべての側面が最高レベルとみなされる複数のデータ・センターがあるエンタープライズのDBaaS構成で可能な最高の構造です。

図50-2 複数データセンターDBaaS設定

複数データセンターDBaaS設定では、プライマリRACソフトウェア・プールと2つのスタンバイ・ソフトウェア・プールを作成する必要があります。2つのソフトウェア・プールのうち、近い方の障害時リカバリ(DR)プールはRACソフトウェア・プールで、もう1つの遠い方のDRは単一インスタンス・ソフトウェア・プールです。ソフトウェア・プールを作成した後で、ソフトウェア・プールの関係を確立するサービス・テンプレートが作成されます。この設定が複数データセンターDBaaS設定としてSSAユーザーに提供されます。

この項では、次のトピックについて説明します。

- 複数データセンターDBaaS設定を作成する管理者の手順

- 複数データセンターDBaaS設定を使用するためのSSAユーザーREST APIリクエスト

50.9.1.1 複数データセンターDBaaS設定を作成する管理者の手順

この項では、REST APIを使用して複数データセンターDBaaSを設定する手順について説明します。REST APIと同等のEM CLI動詞では、次の手順のREST APIごとにemcli invoke_wsコマンドを実行します。emcli invoke_wsコマンドの詳細は、第47章「Database as a Service管理者用のEM CLI動詞」を参照してください。

複数データセンターDBaaSを設定するには、次の手順に従います。

1. 単一インスタンス・ソフトウェア・プールを持つデータ・センターのPaaSゾーンを作成します(遠くのDR)。
PaaSゾーンを作成するには、次に示すREST APIリクエストを発行します。

表50-12 PaaSゾーンを作成するためのリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name":"DATACENTER_2",
"description":"This is a TestZone",
"credential":"NCAIME",
"memberType":"host",
"members":[
"www.example.com"
],
"constraint":[
{
"name":"MAX_CPU_UTILIZATION",
"value":"85"
},
{
"name":"MAX_MEMORY_ALLOCATION",
"value":"95"
}
],
"roles":[
"SSACOREROLE1",
"SSACOREROLE2"
],

}

リクエスト・メソッド

POST

2. DATACENTER_2にスタンバイ単一インスタンス・ソフトウェア・プールを作成します。
スタンバイ単一インスタンス・ソフトウェア・プールを作成するには、次に示すREST APIリクエストを発行します。

表50-13 スタンバイ単一インスタンス・ソフトウェア・プールを作成するための構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "DB_POOL2",
"poolTargetType": "oracle_cloud_zone",
"description": "Database Pool of Oracle Homes",
"paasZone": "DATACENTER_2",
"members": ["OraDb11g_home1_2_example.com"],
"serviceFamily":"DBAAS",
"serviceType":"DBAAS",
"constraints": {"items": [{"name": "MAX_INSTANCES", "value": "10"}]},
"filters":
{"items": [
{"name": "CONFIGURATION","value": "oracle_database"},
{"name": "VERSION","value": "11.2.0.4.0"},
{"name": "PLATFORM","value": "226"}
]
} ,
"properties":
{"items": [
{"name": "host_credential_guid", "value": "FF7A82CE961672E6E0437850B10ABF4E"}
]
}
}

リクエスト・メソッド

POST

3. プライマリ・データベースおよびスタンバイRACデータベースを持つデータ・センターのPaaSゾーンを作成します(近くのDR)。
PaaSゾーンを作成するには、次に示すREST APIリクエストを発行します。

表50-14 PaaSゾーンを作成するためのリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name":"DATACENTER_1",
"description":"This is a TestZone",
"credential":"NCAIME",
"memberType":"host",
"members":[
"www.example.com"
],
"constraint":[
{
"name":"MAX_CPU_UTILIZATION",
"value":"85"
},
{
"name":"MAX_MEMORY_ALLOCATION",
"value":"95"
}
],
"roles":[
"SSACOREROLE1",
"SSACOREROLE2"
],

}

リクエスト・メソッド

POST

4. DATACENTER_1にスタンバイRACソフトウェア・プールを作成します。
スタンバイRACソフトウェア・プールを作成するには、次に示すREST APIリクエストを発行します。

表50-15 スタンバイRACソフトウェア・プールを作成するための構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/s

oftwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "DB_POOL3",
"poolTargetType": "oracle_cloud_zone",
"description": "Database Pool of Oracle Homes",
"paasZone": "DATACENTER_1",
"members": ["OraDb11g_home2_11_www.example.com","OraDb11g_home2_11_www.example.com"],
"serviceFamily":"DBAAS",
"serviceType":"DBAAS",
"constraints": {"items": [{"name": "MAX_INSTANCES", "value": "10"}]},
"filters":
{"items": [
{"name": "CONFIGURATION","value": "rac_database"},
{"name": "VERSION","value": "11.2.0.4.0"},
{"name": "PLATFORM","value": "226"}
]
} ,
"properties":
{"items": [
{"name": "host_credential_guid", "value": "FF7A82CE961672E6E0437850B10ABF4E"}
]
}
}

リクエスト・メソッド

POST

5. DATACENTER_1にプライマリRACソフトウェア・プールを作成します。
プライマリRACソフトウェア・プールを作成するには、次に示すREST APIリクエストを発行します。

表50-16 プライマリRACソフトウェア・プールを作成するための構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "DB_POOL1",
"poolTargetType": "oracle_cloud_zone",
"description": "Database Pool of Oracle Homes",
"paasZone": "DATACENTER_1",
"members": ["OraDb11g_home1_2_www.example.com","OraDb11g_home1_2_www.example.com"],
"serviceFamily":"DBAAS",
"serviceType":"DBAAS",
"constraints": {"items": [{"name": "MAX_INSTANCES", "value": "10"}]},
"filters":
{"items": [
{"name": "CONFIGURATION","value": "rac_database"},
{"name": "VERSION","value": "11.2.0.4.0"},
{"name": "PLATFORM","value": "226"}
]
} ,
"properties":
{"items": [
{"name": "host_credential_guid", "value": "FF7A82CE961672E6E0437850B10ABF4E"},
{"name": "standby_pools", "value": "DB_POOL2|DB_POOL3"}
]
}
}

リクエスト・メソッド

POST

6. ユーザー・ロール用のDBaaSリクエスト設定を作成します。
DBaaSリクエスト設定を作成するには、次に示すREST APIリクエストを発行します。

表50-17 DBaaSリクエスト設定を作成するための構成

機能

説明

URI

/em/cloud/dbaas/requestsetttings

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

Accept: application/oracle.com.cloud.common.DbaasRequestSettings+json

本文

{
"future_reservation_length" : "2 Months",
"maximum_archive_duration" : "10 Weeks",
"default_retirement_period" : "No Reservation"
}

リクエスト・メソッド

POST

7. ユーザー・ロール用の割当て制限を作成します。
割当て制限を作成するには、次に示すREST APIリクエストを発行します。

表50-18 割当て制限を作成するための構成

機能

説明

URI

/em/cloud/dbaas/quota

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

Accept: application/oracle.com.cloud.common.DbaasRequestSettings+json

本文

{
"role_name" : "DBAAS_ROLE",
"databases" : "10",
"schema_services" : "21",
"pluggable_databases" : "22",
"storage" : "99",
"memory" : "99"
}

リクエスト・メソッド

POST

8. プロビジョニング用のソース・データベース情報を取得するプロファイルを作成します。第47章「Database as a Service管理者用のEM CLI動詞」を参照してください。

9. データベース・サービス・テンプレートの作成。
データベース・サービス・テンプレートを作成するには、次に示すREST APIリクエストを発行します。

表50-19 データベース・サービス・テンプレートを作成するための構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name":"TestDbTemplate1",
"serviceType":"DB",
"serviceFamily":"DBAAS",
"description":"This is a test database standby service template 1",
"poolIds":[ "00829096124B0CC3E0537850B10A9E88" ],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{ "name":"PROFILE_COMPONENT_URN", "value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:0008FDF6A8BD706BE0537850B10A5E7A:0.1" },
{ "name":"DATABASE_TYPE","value":"rac_database" },
{ "name":"COMMON_DB_SYSTEM_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_DBSNMP_PASSWORD", "value":"welcome" },
{ "name":"COMMON_DB_SYS_PASSWORD","value":"welcome" },
{ "name":"DB_ADMIN_PASSWORD_SAME", "value":"true" },
{ "name":"INSTANCE_COUNT","value":"2" },
{ "name":"SID_OPTION", "value":"ssauser  "},
{ "name":"COMMON_DB_SID","value":"mydb1" },
{ "name":"COMMON_DOMAIN_NAME",  "value":"www.example.com" },
{ "name":"LISTENER_PORT", "value":"1521"},
{ "name":"STAGE_LOCATION", "value":"/scratch" },
{ "name":"REF_ZONE", "value":"DATACENTER_1" },
{ "name":"REF_POOL",   "value":"DB_POOL1" },
{ "name":"REF_HOST", "value":"www.example.com" },
{ "name":"REF_TGT","value":"www.example.com" },
{ "name":"DBCA_TEMPLATE:DB_STORAGE_TYPE",  "value":"ASM" },
{ "name":"DBCA_TEMPLATE:DATA_FILE_LOCATION","value":"DATA" },
{ "name":"DBCA_TEMPLATE:REC_STORAGE_TYPE_SAME_AS_DB_FILES", "value":"Y" },
{ "name":"DBCA_TEMPLATE:ARCHIVE_LOG_MODE", "value":"Y" },
{ "name":"DBCA_TEMPLATE:FLASH_RECOVERY_AREA_SIZE", "value":"5000" },
{ "name":"DBCA_TEMPLATE:RECOVERY_FILE_LOCATION","value":"RECO" },
{ "name":"DBCA_TEMPLATE:REDO_FILE_LOCATION", "value":"RECO"  },
{
"name":"INIT_PARAMS",
"subconfigurations":[
{ "name":"INIT_PARAMS:1", "value":"sga_target=1073741824" },
{ "name":"INIT_PARAMS:2", "value":"pga_aggregate_target=1073741824"  }
]
},
{ "name":"STANDBY_REQUIRED","value":"true" },
{ "name":"STANDBY_REQUIRED_LOCK","value":"false" },
{ "name":"STANDBY_WORK_DIR","value":"/tmp" },
{ "name":"PRIMARY_PROTECTION_MODE","value":"MAXIMIZE AVAILABILITY" },
{ "name":"DBAAS_SSA_STANDBY_CUSTOM_PRE_SCRIPTS_URN","value":"" },
{ "name":"DBAAS_SSA_STANDBY_CUSTOM_POST_SCRIPTS_URN","value":"" },
{ "name":"STANDBY_DB_DETAILS","value":"","values":[
"pool=DB_POOL3;databaseSIDPrefix=;databaseType=rac_database;standbyConfigName=Near DR;redoMode=SYNC;realtimeQuery=true;databaseRACInstanceCount=2;databaseDelay=30;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com",
"pool=DB_POOL2;databaseSIDPrefix=;databaseType=oracle_database;standbyConfigName=Far DR;redoMode=ASYNC;realtimeQuery=false;databaseRACInstanceCount=2;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"]}

]
}
}

リクエスト・メソッド

POST

これでプラチナDBaaS設定を管理できるようになりました。

50.9.1.2 複数データセンターDBaaS設定を使用するためのSSAユーザーREST APIリクエスト

近くと遠くのDRを含む複数データセンターDBaaS設定をリクエストするには、次に示すREST APIリクエストを発行します。

表50-20 2つのスタンバイ・データベースを含むデータベースを作成するための構成

機能

説明

URI

/em/cloud/dbaas/zone/82CF1C28FA20A183C99D13

8FF8065F19

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.DbPlatformInstance+json

Accept: application/oracle.com.cloud.common.DbPlatformInstance+json

本文

{
"based_on": "/em/cloud/dbaas/dbplatformtemplate/CC3BBB665A6BC6FFE040F00AEF252456",
"name": "Platinum1",
"description": "Create Database with 1 Standby RAC database & 1 Standby SI database",
"start_date": "2014-08-13T14:20:00ZAsia/Calcutta",
"end_date": "2014-08-13T17:20:00ZAsia/Calcutta",
"params":
{
"username": "Master Account username for the DB",
"password": "Master Account Password for the  DB",
"database_sid" : "platinum1" ,
"service_name" : "Name of the additional service to be created",
"standbydbs":
[
{
"standbydb_name":"Near DR",
"standbydb_sid":"NR1"
},
{
"standbydb_name":"Far DR",
"standbydb_sid":"FR1"
}
]
}
}

リクエスト・メソッド

POST

51 SSA管理REST API

この章では、SSA管理機能のためのクラウドREST APIおよびサービス・テンプレートREST APIの詳細について説明します。この章では、PaasZone管理およびSoftwarePool管理のREST APIに加えて、REST APIカタログ、REST API出力およびメタデータのフェッチに使用するその他のREST APIと、リソースの展開について説明します。

この章ではまた、Enterprise Manager Self Serviceアプリケーションの管理ユーザーによるPaaSインフラストラクチャ・ゾーン操作、ソフトウェア・プール操作およびサービス・テンプレート操作に使用可能な、Enterprise Managerコマンドライン・インタフェース(EMCLI)動詞の詳細も説明します。EMCLIにより、各種オペレーティング・システムのテキスト・ベースのコンソール(シェルおよびコマンド・ウィンドウ)からEnterprise Manager Cloud Control機能にアクセスできます。

注意:
SSAプラグイン・リリース12.1.0.9では、v2フレームワークと呼ばれる新しいフレームワークがREST APIに導入されています。新しいフレームワークは異なるアプローチと署名から構成されるため、REST APIは以前のフレームワークと比較した場合にも異なります。以前のフレームワーク(v1)は非推奨になり、ユーザーはv2 REST APIおよびEM CLI動詞への移行を推奨されます。
v2に固有のEM CLI動詞は、同等のREST APIがないアクションに制限されています。v2フレームワークのすべてのREST APIについて、emcli invoke_wsの形式の同等のEM CLI動詞が存在します。詳細は、第51.18.2章「V2のSSA操作用のEM CLI動詞」を参照してください。

v2では、セルフ・サービス・ポータル・アプリケーションのREST APIは一般にSSAユーザーによって使用されます。これらのREST APIは、一般に.../ssa/...の形式です。たとえば、/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/などです。管理機能のREST API (.../admin/...形式)は、ゾーンやテンプレートの作成など、一般にクラウドまたはSSAの管理者によって実行されるSSAポータル設定を構成するREST APIです。この章では、管理REST APIについて説明します。

この章の内容は、次のとおりです。

- V2のSSA管理REST APIのサマリー

- V1のSSA管理REST APIのサマリー

- V1およびV2のカタログAPI

- V2のリソース・プロバイダ

- リソース・プロバイダ - V2のコレクション・リソース

- リソース・プロバイダ - V2の単一リソース

- サービス・テンプレート群 - V2のコレクション・リソース

- V2のサービス・タイプ

- V2のサービス・リクエスト

- V2のサービス・インスタンス

- V2のリクエスト設定

- V2のVMアダプタ

- V1のSSA管理リソース

- V1のPaasZones

- V1のPaasZone

- V1のSoftwarePools

- V1のSoftwarePool

- V1のコンポジット・リソース属性

- V1のValueDescriptor

- V1のValueEntity

- V1のEntityValueHolder

- V1のPoolEntityCapacity

- V1のResourceTypeCapacity

- V1のサービス・テンプレート管理

- V1のサービス・テンプレート

- V1のサービス・テンプレート

- V1のServiceTemplateUpdate

- V1のServiceExecutableMetaEntity

- V1のテンプレート構成パラメータ

- V1のPayloadDescriptor

- V1のServiceTemplateメタデータ

- V1のPayloadMetaData

- V1のServiceTemplateメタデータ

- セルフ・サービス・アプリケーション用のEM CLI動詞

- V2のSSA操作用のEM CLI動詞

- V1のSSA操作用のEM CLI動詞

51.1 V2のSSA管理REST APIのサマリー

次の表に、v2フレームワークについてこの章で説明するすべてのユーザー・プリファレンスおよびリクエスト・スケジュールREST APIをまとめています。

表51-1 V2のSSA管理REST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

カタログAPI

表51-3

- 第51.3.1.1項

- 第51.3.1.3項

- 第51.3.1.5項

- 第51.3.1.6項

サポート対象外

サポート対象外

サポート対象外

リソース・プロバイダ

表51-10

- 第51.4.4.1項

- 第51.4.4.2項

- 第51.4.4.8項

- 第51.4.4.9項

- 第51.4.4.10項

- 第51.4.4.11項

- 第51.4.4.14項

- 第51.4.4.15項

- 第51.4.4.3項

- 第51.4.4.4項

- 第51.4.4.5項

- 第51.4.4.6項

- 第51.4.4.7項

- 第51.4.4.16項

- 第51.4.4.18項

第51.4.4.12項

- 第51.4.4.13項

- 第51.4.4.17項

サービス・テンプレート

表51-36

- 第51.5.2.1項

- 第51.5.2.2項

- 第51.5.2.3項

- 第51.5.2.4項

- 第51.5.2.5項

- 第51.5.2.8項

- 第51.5.2.9項

第51.5.2.6項

第51.5.2.7項

第51.5.2.10項

サービス・タイプ

表51-57

第51.6.1.1項

該当なし

該当なし

該当なし

サービス・リクエスト

表51-59

- 第51.7.2.1項

- 第51.7.2.2項

サポート対象外

第51.7.2.3項

- 第51.7.2.5項

- 第51.7.2.6項

サービス・インスタンス

表51-67

- 第51.8.2.1項

- 第51.8.2.2項

サポート対象外

- 第51.8.2.3項

- 第51.8.2.4項

- 第51.8.2.5項

- 第51.8.2.6項

- 第51.8.2.7項

- 第51.8.2.8項

サポート対象外

リクエスト設定

表51-77

- 第51.9.3.1項

- 第51.9.3.3項

- 第51.9.3.5項

- 第51.9.3.8項

- 第51.9.3.10項

- 第51.9.3.12項

- 第51.9.3.15項

- 第51.9.3.17項

- 第51.9.3.19項

- 第51.9.3.4項

- 第51.9.3.11項

- 第51.9.3.18項

- 第51.9.3.2項

- 第51.9.3.6項

- 第51.9.3.9項

- 第51.9.3.13項

- 第51.9.3.16項

- 第51.9.3.20項

- 第51.9.3.7項

- 第51.9.3.14項

- 第51.9.3.21項

VMアダプタ

表51-100

- 第51.10.3.1項

- 第51.10.3.2項

- 第51.10.3.3項

第51.10.3.4項

サポート対象外

サポート対象外

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

51.2 V1のSSA管理REST APIのサマリー

次の表に、v2フレームワークについてこの章で説明するすべてのユーザー・プリファレンスおよびリクエスト・スケジュールREST APIをまとめています。

表51-2 V1のSSA管理REST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

カタログAPI

表51-3

- 第51.3.1.2項

- 第51.3.1.4項

サポート対象外

サポート対象外

サポート対象外

APIエントリ・ポイント・リソース

表51-106

第51.11.1項

サポート対象外

サポート対象外

サポート対象外

PaaSゾーン群

表51-108

- 第51.12.1.1項

- 第51.12.1.2項

サポート対象外

サポート対象外

サポート対象外

PaaSゾーン

表51-112

- 第51.13.1.4項

- 第51.13.1.5項

第51.13.1.1項

第51.13.1.2項

第51.13.1.3項

ソフトウェア・プール群

表51-119

- 第51.14.1.1項

- 第51.14.1.2項

サポート対象外

サポート対象外

サポート対象外

ソフトウェア・プール

表51-123

- 第51.15.1.4項

- 第51.15.1.5項

第51.15.1.1項

第51.15.1.2項

第51.15.1.3項

ソフトウェア・プール・メタデータ

表51-129

第51.15.2.1項

サポート対象外

サポート対象外

サポート対象外

ソフトウェア・プール・フィルタ・ターゲット

表51-131

第51.15.3.1項

サポート対象外

サポート対象外

サポート対象外

ソフトウェア・プール容量

表51-133

第51.15.4.1項

サポート対象外

サポート対象外

サポート対象外

コンポジット・リソース属性

第51.16項

サポート対象外

サポート対象外

サポート対象外

サポート対象外

サービス・テンプレート

第51.17.1項

第51.17.10.5項

第51.17.10.6項

サポート対象外

サポート対象外

サービス・テンプレート

第51.17.2項

第51.17.10.4項

第51.17.10.1項

第51.17.10.2項

第51.17.10.3項

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

51.3 V1およびV2のカタログAPI

カタログAPIは、cfwプラグインに存在するすべてのREST APIの概要を示します。これらすべては、各REST APIに関する説明と情報を含むGET REST APIです。

REST APIは、v1 REST APIとv2 REST APIに大きく分類されています。v1 REST APIは、既存のv1カタログREST APIを意味します。v2 REST APIは、SSAユーザーREST APIと管理者REST APIの両方の概要のサマリーを提供します。

表51-3 Cfw APIカタログ・コレクション・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

このコレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

count

整数

返される要素の数。

1

items

コレクション<CfwRestAPICatalog>

Cfw APIカタログ・リソースのリスト。インスタンスが存在しない場合、itemsフィールドは空になります。

1

totalResults

整数

Cfw APIカタログ・リソースの総数。

1

canonicalLink

URI

このURIに対してGETリクエストを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

51.3.1 CFW APIカタログREST APIの例

この項では、Cfw APIカタログ・リソースのREST APIについて説明します。この項では、次の操作について説明します。

- V1およびV2の上位レベルのカタログAPIの表示

- V1カタログAPIの表示

- V2カタログAPIの表示

- SSAポータルのV1カタログAPIの表示

- V2カタログ・ユーザーAPIの表示

- V2カタログ管理APIの表示

51.3.1.1 V1およびV2の上位レベルのカタログAPIの表示

上位レベル・カタログAPIを表示するためのGETリクエスト構成を次に示します。

表51-4 上位レベル・カタログAPIを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/cfw/API

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
"items":[
{
"href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/cfw/API/v1",
"description":"API Summary for version V1"
},
{
"href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/cfw/API/v2",
"description":"API Summary for version V2"
}
],
"totalResults":2
}

51.3.1.2 V1カタログAPIの表示

v1カタログAPIを表示するためのGETリクエスト構成を次に示します。

表51-5 V1カタログAPIを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/cfw/API/v1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
"items":[
{
"href":"cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/API",
"description":"APIs for Self Service Application for version V1",
"type":"SSA"
},
{
"href":"cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/API",
"description":"APIs for Administrative functions for version V1",
"type":"Admin"
}
],
"goBack":"cloudcompany.com/em/websvcs/restful/extws/cloudservices/cfw/API",
"totalResults":2
}

51.3.1.3 V2カタログAPIの表示

v2カタログAPIを表示するためのGETリクエスト構成を次に示します。

表51-6 V2カタログAPIを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/API/v2

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
"items":[{
"href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/API",
"description":"APIs for Self Service Application for version V2",
"type":"SSA"
},
{
"href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/API",
"description":"APIs for administrative functions for version V2",
"type":"Admin"
} ],
"goBack":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/cfw/API",
"totalResults":2
}

51.3.1.4 SSAポータルのV1カタログAPIの表示

SSAポータルのv1カタログAPIを表示するためのGETリクエスト構成を次に示します。

表51-7 SSAポータルのV1カタログAPIを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/API/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
"v1":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1",
"serviceRequests":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1
/servicerequests",
"userPreferences":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1
/mypreferences"
}
}

51.3.1.5 V2カタログ・ユーザーAPIの表示

v2エンドポイントは、エンティティに応じてグループ化されるv2側ユーザーREST APIのさらに調整された概要を提供します。たとえば、REST APIに関連するすべてのサービス・インスタンスは、entity=serviceinstancesに対してまとめてリストされます。

変数入力を持つREST APIは、属性”templated”と中カッコでマークされます。

v2カタログ・ユーザーAPIを表示するためのGETリクエスト構成を次に示します。

表51-8 V2カタログ・ユーザーAPIを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/user/ssa/v2/API

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"items": [
{
"totalResults": 5,
"resource": "services",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services",
"method": "GET",
"description": "Get all the service offerings"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services",
"method": "POST",
"description": "Create a service"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}",
"method": "GET",
"templated": true,
"description": "Get details of a service"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for a service"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}/metrics",
"method": "PUT",
"templated": true,
"description": "Get the metrics for a service"
}
]
},
{
"totalResults": 11,
"resource": "userpreferences",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences",
"method": "GET"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general",
"method": "GET",
"description": "Get the general user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general/metadata",
"method": "GET",
"description": "Get the metadata for general user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services",
"method": "GET",
"description": "Get the service user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}",
"method": "GET",
"templated": true,
"description": "Get the user preferences for a service family"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for user preference at family level"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}",
"method": "GET",
"templated": true,
"description": "Get the user preferences for a service type"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for user preference at service type level"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general",
"method": "PUT",
"description": "Update general user preference"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{service-family}",
"method": "PUT",
"templated": true,
"description": "Update family level user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}",
"method": "PUT",
"templated": true,
"description": "Update service type level user preferences"
}
]
},
{
"totalResults": 4,
"resource": "servicerequests",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests",
"method": "GET",
"description": "Get service requests"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "PUT",
"templated": true,
"description": "Reschedule the request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "GET",
"templated": true,
"description": "Get the details of request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "DELETE",
"templated": true,
"description": "Delete the request"
}
]
},
{
"totalResults": 5,
"resource": "serviceinstances",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances",
"method": "GET",
"description": "Get the service instances"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}",
"method": "GET",
"templated": true,
"description": "Get details of a service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions",
"method": "GET",
"templated": true,
"description": "Get actions for a service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions/{action-id}",
"method": "GET",
"templated": true,
"description": "Get metadata details of action"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions/{action-id}",
"method": "PUT",
"templated": true,
"description": "Perform the action on the service instance"
}
]
}
],
"goBack": "https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/API",
"totalResults": 4
}

51.3.1.6 V2カタログ管理APIの表示

v2エンドポイントは、エンティティに応じてグループ化されるv2側管理REST APIのさらに調整された概要を提供します。たとえば、REST APIに関連するすべてのサービス・インスタンスは、entity=serviceinstancesに対してまとめてリストされます。

変数入力を持つREST APIは、属性”templated”と中カッコでマークされます。

v2カタログ管理APIを表示するためのGETリクエスト構成を次に示します。

表51-9 V2カタログ管理APIを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/API

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"items": [
{
"totalResults": 6,
"resource": "resourceproviders",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resource
providers",
"method": "GET",
"description": "Get all the resource providers"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resource
providers",
"method": "POST",
"description": "Create/Add a resource provider"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resource
providers/{id}",
"method": "GET",
"templated": true,
"description": "Get details of a resource provider"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resource
providers/{id}",
"method": "DELETE",
"templated": true,
"description": "Delete/Remove a resource provider"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resource
providers/{id}",
"method": "PUT",
"templated": true,
"description": "Edit a resource provider"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resource
providers/{id}/metrics",
"method": "GET",
"templated": true,
"description": "Get metrics for a resource provider"
}
]
},
{
"totalResults": 3,
"resource": "servicetemplates",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicet
emplates",
"method": "GET",
"description": "Get all service templates"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicet
emplates",
"method": "POST",
"description": "Create a service template"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicet
emplates/{id}",
"method": "PUT",
"templated": true,
"description": "Edit a service template"
}
]
},
{
"totalResults": 4,
"resource": "settings",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/settings
/general",
"method": "GET",
"description": "Get all general settings"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/settings
/general",
"method": "PUT",
"description": "Update general settings"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/settings
/service/{service-type}",
"method": "GET",
"templated": true,
"description": "Get all settings for a service type"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/settings
/service/{service-type}",
"method": "PUT",
"templated": true,
"description": "Update settings for a service type"
}
]
},
{
"totalResults": 5,
"resource": "instancesizes",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/instance
sizes",
"method": "GET",
"description": "Get all instance sizes"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/instance
sizes/service/{service-type}",
"method": "GET",
"templated": true,
"description": "Get all instance sizes for a service type"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/instance
sizes/service/{service-type}/metadata",
"method": "GET",
"templated": true,
"description": "Get metada for instance sizes for a service type"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/instance
sizes/service/{service-type}/{instance-name}",
"method": "GET",
"templated": true,
"description": "Get details of an instance size"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/instance
sizes/service/{service-type}/{instance-name}",
"method": "PUT",
"templated": true
}
]
},
{
"totalResults": 5,
"resource": "servicerequests",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicer
equests",
"method": "GET",
"description": "Get all requests"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicer
equests/{id}",
"method": "PUT",
"templated": true,
"description": "Reschedule a request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicer
equests/{id}",
"method": "GET",
"templated": true,
"description": "Get details of a request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicer
equests/{id}",
"method": "DELETE",
"templated": true,
"description": "Delete a request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicer
equests",
"method": "DELETE",
"description": "Delete bulk requests"
}
]
},
{
"totalResults": 12,
"resource": "serviceinstances",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances",
"method": "GET",
"description": "Get all service instances"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/{id}",
"method": "GET",
"templated": true,
"description": "Get details of a service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/{id}/actions",
"method": "GET",
"templated": true,
"description": "Get all the actions on a service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/{id}/actions/{action-id}",
"method": "GET",
"templated": true,
"description": "Get the details of action"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/{id}/actions/{action-id}",
"method": "PUT",
"templated": true,
"description": "Perform the action on the service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/{id}/start",
"method": "PUT",
"templated": true,
"description": "Start the service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/{id}/stop",
"method": "PUT",
"templated": true,
"description": "Stop the service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/{id}/delete",
"method": "PUT",
"templated": true,
"description": "Delete the service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances",
"method": "DELETE",
"description": "Delete service instances"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/start",
"method": "PUT",
"description": "Start multiple service instances"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/stop",
"method": "PUT",
"description": "Stop multiple service instances"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicei
nstances/delete",
"method": "PUT",
"description": "Delete multiple service instances"
}
]
}
],
"goBack": "https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/API",
"totalResults": 6
}

51.4 V2のリソース・プロバイダ

リソース・プロバイダは、管理を簡単にするためのリソース・グループを提供します。

リソース・プロバイダは、サービス・タイプのサービス・インスタンスのプロビジョニングに必要なリソースのタイプを表す、コンポジット・ターゲットです。たとえば、データベース・サービス・タイプはそのリソース・プロバイダにoracle_homeターゲットを必要とし、スキーマ・サービス・タイプはそのリソース・プロバイダにoracle_databaseおよびoracle_racターゲットを必要とします。

51.4.1 リソース・プロバイダ - V2のコレクション・リソース

リソース・プロバイダは、すべてのアクセス可能なリソース・プロバイダ・リソースのクラウド管理者ビューを表すコレクション・リソースです。次の表では、リソース・プロバイダ・データ・モデルについて説明します。

表51-10 リソース・プロバイダ・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

このコレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

count

整数

返される要素の数。

1

items

コレクション<ResourceProvider>

リソース・プロバイダ・リソースのリスト。インスタンスが存在しない場合、itemsフィールドは空になります。

1

totalCount

整数

リソース・プロバイダ・リソースの総数。

1

canonicalLink

URI

このURIに対してGETリクエストを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

51.4.2 リソース・プロバイダ - V2の単一リソース

リソース・プロバイダ・クラウド・リソースは、リソース・プロバイダのインスタンスを表します。次の表では、リソース・プロバイダ・データ・モデルについて説明します。

表51-11 リソース・プロバイダ・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

リソース・プロバイダに指定された判読可能な名前。このフィールドは編集できません。

1

displayName

文字列

リソース・プロバイダの表示名。

0..1

guid

文字列

リソースを識別するリソース・プロバイダの一意のGUID。

1

description

文字列

リソースの短い説明。

0..1

targetType

文字列

作成するリソース・プロバイダのターゲット・タイプ。例: サンプルのxaasリソース・プロバイダの場合は”cfw_samplexaas_rsrc_provider”。

1

メンバー

リソース・プロバイダのメンバー。これらは、あらかじめEMターゲットとして追加する必要があります。

1

資格証明

コレクション<ResourceProviderCredential>

リソース・プロバイダに関連付けられている資格証明。

1

placementConstraints

コレクション<EntityValueHolder>

クラウド管理者がリソース使用率の上限を設定できるようにする、リソース・プロバイダの配置制約。

0..1

characteristics

コレクション<EntityValueHolder>

リソース・プロバイダに関連付けられている特性。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

51.4.3 リソース・プロバイダ・リソースでサポートされるメソッド

次の表に、リソース・プロバイダの単一リソースでサポートされるメソッドを示します。

表51-12 リソース・プロバイダでサポートされるメソッド

リクエスト・メソッド

正規のリンク

説明

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リソース・プロバイダのリストを返します。

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/types

リソース・プロバイダ・タイプを返します。

POST

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リソース・プロバイダのインスタンスを作成します。

POST

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/filteredtargets

フィルタを適用したターゲットを返します。

表51-13「フィルタ処理されたターゲット・リクエスト・データ・モデル」および表51-14「フィルタ処理されたターゲット・レスポンス・データ・モデル」を参照してください。

GET

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/types/{resourceprovidertype}

リソース・プロバイダ・タイプ・メタデータを返します。

表51-15「リソース・プロバイダ・メタデータ・データ・モデル」を参照してください。

GET

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}

指定されたリソース・プロバイダの詳細を返します。

表51-16「資格証明データ・モデル」および表51-17「CFW単純値エンティティ・データ・モデル」を参照してください。

PUT

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}

指定されたリソース・プロバイダを更新します。

DELETE

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}

指定されたリソース・プロバイダを削除します。

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceprovderid}/configuration

リソース・プロバイダの保存済構成を返します。

GET

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}/metrics

指定されたリソース・プロバイダのメトリックを返します。

POST

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}/members

リソースをプロビジョニングします。

DELETE

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}/members

リソースをプロビジョニング解除します。

POST

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}/members/metadata

リソースのプロビジョニングに必要なプロビジョニング・メタデータを返します。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/filteredtargetsに対するPOSTリクエストでサポートされる、フィルタ処理されたターゲット・リクエスト・データ・モデルを示します。

表51-13 フィルタ処理されたターゲット・リクエスト・データ・モデル

フィールド

タイプ

説明

出現回数

type

文字列

リソース・プロバイダのタイプ。

1

membertargetType

文字列

メンバーのターゲット・タイプ。

0..1

parentResourceProviderId

文字列

親リソース・プロバイダのタイプ。

0..1

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/filteredtargetsに対するPOSTリクエストでサポートされる、フィルタ処理されたターゲット・レスポンス・データ・モデルを示します。

表51-14 フィルタ処理されたターゲット・レスポンス・データ・モデル

フィールド

タイプ

説明

membertargetType

文字列

メンバーのターゲット・タイプ。

リスト<文字列>

文字列

ターゲットのリスト。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/types/{resourceprovidertype}に対するGETリクエストでサポートされるリソース・プロバイダ・メタデータ・データ・モデルを示します。

表51-15 リソース・プロバイダ・メタデータ・データ・モデル

フィールド

タイプ

説明

type

文字列

リソース・プロバイダのタイプ。

memberTargetTypes

リスト<文字列>

メンバー・ターゲット・タイプのリスト。

parentResourceProviderType

文字列

親リソース・プロバイダ・タイプ。

isInfrastructureProvider

Boolean

インフラストラクチャ・プロバイダが存在するかどうか。

placementPolicyName

文字列

配置ポリシーを示します。

資格証明

List<Credential>

資格証明を示します。

placementConstraints

List<CfwSimpleValueEntity>

配置制約を示します。

characteristics

List<CfwSimpleValueEntity>

特性を示します。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}に対するGETリクエストでサポートされる資格証明データ・モデルを示します。

表51-16 資格証明データ・モデル

フィールド

タイプ

説明

name

文字列

資格証明の名前。

value

文字列

資格証明のタイプ。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}に対するGETリクエストでサポートされるCFW単純値エンティティ・データ・モデルを示します。

表51-17 CFW単純値エンティティ・データ・モデル

フィールド

タイプ

説明

name

文字列

名前。

value

リスト<文字列>

文字列のリスト。

51.4.4 リソース・プロバイダREST APIの例

この項では、リソース・プロバイダに対する操作について説明します。この項では、次の操作について説明します。

- すべてのリソース・プロバイダの表示

- リソース・プロバイダのすべてのタイプの表示

- リソース・プロバイダの作成

- PaaSインフラストラクチャ・ゾーン・リソース・プロバイダの作成

- データベース・スキーマ・プールの作成

- アダプタ・インスタンスの作成

- リソース・プロバイダ・ターゲットのフィルタ処理

- リソース・プロバイダ・タイプ・メタデータの表示

- PaaSインフラストラクチャ・ゾーンを作成するためのメタデータの表示

- スキーマ・プールを作成するためのメタデータの表示

- リソース・プロバイダの詳細の表示

- リソース・プロバイダの更新

- リソース・プロバイダの削除

- リソース・プロバイダの構成の表示

- リソース・プロバイダのメトリックの表示

- サンプル・アダプタを使用したリソースのプロビジョニング

- リソースのプロビジョニング解除

- リソース・プロバイダのプロビジョニングに必要なメタデータの表示

51.4.4.1 すべてのリソース・プロバイダの表示

すべてのリソース・プロバイダを表示するには、GET操作を発行します。

表51-18 すべてのリソース・プロバイダを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Resource Providers",
"type": "Resource Provider",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/"
},
"cfwItems": [
{
"id": "1",
"name": "MyPaasZone",
"type": "self_service_zone",
"guid": "AC3D1D12E0A0AB1B28C377ED691E9E98",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/1"
}
},
{
"id": "2",
"name": "MyXaasProvider",
"type": "cfw_samplexaas_rsrc_provider",
"guid": "20CC7F446482F477BED8336489852A4B",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/2"
}
},
{
"id": "3",
"name": "MyXaasPool",
"type": "cfw_samplexaas_rsrc_pool",
"guid": "FEF39B5F2A0C518283F7A5E781EE8C8B",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/3"
}
},
{
"id": "4",
"name": "MyWebLogicProvider",
"type": "mwaas_zone",
"guid": "425AA08582AD7AE95D52C24662867315",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/4"
}
},
{
"id": "21",
"name": "MySchemaPool",
"type": "schaas_pool",
"guid": "446AD900E64F525149A3B1D79E0037AC",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/21"
}
}
],
"totalResults": 5
}

51.4.4.2 リソース・プロバイダのすべてのタイプの表示

リソース・プロバイダのすべてのタイプを表示するには、GET操作を発行します。

表51-19 リソース・プロバイダのすべてのタイプを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/types

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "Resource Provider Types",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s"
},
"cfwItems" : [ {
"type" : "cfw_samplexaas_rsrc_pool",
"displayName" : "CFW XaaS Test Rsrc Pool",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s/cfw_samplexaas_rsrc_pool"
}
}, {
"type" : "cfw_samplexaas_rsrc_provider",
"displayName" : "CFW XaaS Test Rsrc Provider",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s/cfw_samplexaas_rsrc_provider"
}
}, {
"type" : "cfw_samplexaas_rsrcprov_no_member",
"displayName" : "CFW XaaS Test Rsrc With No Member",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s/cfw_samplexaas_rsrcprov_no_member"
}
}, {
"type" : "mwaas_zone",
"displayName" : "Middleware Pool",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s/mwaas_zone"
}
}, {
"type" : "oracle_cloud_zone",
"displayName" : "Database Pool",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s/oracle_cloud_zone"
}
}, {
"type" : "oracle_nimbula_site",
"displayName" : "Oracle Nimbula Site",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
5.6 67
s/oracle_nimbula_site"
}
}, {
"type" : "pdbaas_pool",
"displayName" : "Pluggable Database Pool",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s/pdbaas_pool"
}
}, {
"type" : "schaas_pool",
"displayName" : "Schema Pool",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s/schaas_pool"
}
}, {
"type" : "self_service_zone",
"displayName" : "PaaS Infrastructure Zone",
"canonicalLink" : {
"href" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/type
s/self_service_zone"
}
} ],
"totalResults" : 0
}

51.4.4.3 リソース・プロバイダの作成

次の表に、リソース・プロバイダを作成するためのPOST構成を示します。

表51-20 リソース・プロバイダを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "My Xaas Provider_200",
"characteristics": [
{
"name": "example.sysman.cfw.samplexaas.storagetype",
"value": [
"file",
"db"
]
}
],
"memberTargetType": "cfw_samplexaas_rsrc",
"members": [
"Sample7"
],
"placementConstraints": [
{
"name": "NUMBER_OF_SERVICE_INSTANCES",
"value": "20"
}
],
"type": "cfw_samplexaas_rsrc_provider",
"useExistingTarget": false,
"memberConstraints": [
{
"name": "ORACLE.SYSMAN.CFW.LOCATION",
"values": [
"us-east"
]
},
{
"name": "ORACLE.SYSMAN.SAMPLEXAAS.STORAGETYPE",
"values": [
"file"
]
}
]
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "Resource Provider with name \"My Xaas Provider_200\" and type
\"cfw_samplexaas_rsrc_provider\" created successfully.",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/24"
}
}

51.4.4.4 PaaSインフラストラクチャ・ゾーン・リソース・プロバイダの作成

次の表に、PaaSインフラストラクチャ・ゾーン・リソース・プロバイダを作成するためのPOST構成を示します。

表51-21 PaaSインフラストラクチャ・ゾーン・リソース・プロバイダを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{ "useExistingTarget" :false,
"name" :"MyPaasZone02",
"type" :"self_service_zone",
"memberTargetType" :"host",
"members": [ "myhost1.idc.oracle.com" ],
"credentials": [ { "name": "normal_credential_guid", "value": "VGSINGH" } ],
"placementConstraints": [ { "name": "MAX_CPU_UTILIZATION",
"value": [ "80" ] }, { "name": "MAX_MEMORY_ALLOCATION",
"value": [ "80" ] } ], "memberConstraints": [] }

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{ "message" : "ResourceProvider with name \"MyPaasZone02\" and type \"self_service_zone\" created successfully.",
"canonicalLink" : { "href" : "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/41" }}

51.4.4.5 データベース・スキーマ・プールの作成

次の表に、データベース・スキーマ・プールを作成するためのPOST構成を示します。

表51-22 データベース・スキーマ・プールを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{ "name" : "MyDBSchemaPool",
"useExistingTarget" : false,
"type" : "schaas_pool",
"description" : "MyDatabaseSchemaPool",
"memberTargetType" : "oracle_database",
"members" : [ "Oemrep_Database" ],
"parentResourceProviderId" : "1",
"credentials" : [ { "name" : "host_credential_guid", "value" : "VGSINGH" } ],
"placementConstraints" :
[ { "name" : "MAX_SERVICES", "value" : [ "100" ] }, { "name" : "MAX_CPU_USAGE", "value" : [ "0" ] },
{ "name" : "MAX_MEMORY_USAGE", "value" : [ "0" ] }, { "name" : "USE_WORKLOAD", "value" : [ "false" ] },
{ "name" : "ENFORCE_CPU", "value" : [ "false" ] } ],
"memberConstraints" : [ { "name" : "ORACLE.SYSMAN.SSA.CONFIGURATION", "value" : [ "oracle_database" ] },
{ "name" : "ORACLE.SYSMAN.CFW.PLATFORM", "value" : [ "226" ] },
{ "name" : "ORACLE.SYSMAN.CFW.VERSION", "value" : [ "11.2.0.3.0" ] } ],
"characteristics" : [ { "name" : "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT", "value" : [ "admin@cloudcompany.com" ] },
{ "name" : "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER", "value" : [ "GTB" ] },
{ "name" : "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT", "value" : [ "ST" ] },
{ "name" : "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS", "value" : [ "Development" ] },
{ "name" : "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS", "value" : [ "LOB" ] },
{ "name" : "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION", "value" : [ "EAST" ] },
{ "name" : "ORACLE.SYSMAN.CFW.ORCL_GTP_SITE", "value" : [ "LOCAL" ] } ]}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{ "message" : "ResourceProvider with name \"MyDBSchemaPool\" and type \"schaas_pool\" created successfully.",
"canonicalLink" : { "href" : "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/61" }}

51.4.4.6 アダプタ・インスタンスの作成

次の表に、サンプル・アダプタ・インスタンスを作成するためのPOST構成を示します。

表51-23 アダプタ・インスタンスを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{ name" : "MySmplVMAdapter_0409123048",
"type" : "iaas_adapter",
"placementConstraints" : [ { "name" : "MAX_VM_INSTANCES", "value" : "10" } ],
"vmadapter" : { "name" : "SAMPLEADAPTER", "paaszone" : "MyPaasZone", "connection" : { "endpoints" : [ { "purpose" : "login_url", "url" : "/login_url/example", "username" : "ssa_user", "password" : "ssa_passwd", "domain" : "domain", "custom" : [ { "name" : "CloudType", "value" : "CloudTypeVal" }, { "name" : "custom_param1", "value" : "custom_param1Val" } ] } ],
"virtualizationContainers" : [ { "name" : "Zone" } ] }, "useproxies" : [ "testnm" ], "stagingservers" : { "location" : "script/location", "credentialGuid" : "25D30ADD427484310DBC8CF6211A383B" } }}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{ "message" : "ResourceProvider with name \"MySmplVMAdapter_0409123047\" and type \"iaas_adapter\" created successfully.",
"canonicalLink" : { "href" : "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/63" }}

51.4.4.7 リソース・プロバイダ・ターゲットのフィルタ処理

システム内のリソース・プロバイダ・ターゲットをフィルタ処理するには、リソース・プロバイダ・コレクション・リソースに対してPOST操作を発行します。

表51-24 リソース・プロバイダ・ターゲットをフィルタ処理するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/filteredtargets

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"type": "self_service_zone",
"memberTargetType": "cfw_samplexaas_rsrc"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/filt
eredtargets"
},
"targets": [
"Sample10",
"Sample1",
"Sample3",
"Sample2",
"Sample5",
"Sample4",
"Sample7",
"Sample6",
"Sample9",
"Sample8"
],
"memberTargetType": "cfw_samplexaas_rsrc"
}

51.4.4.8 リソース・プロバイダ・タイプ・メタデータの表示

リソース・プロバイダ・タイプ・メタデータを表示するには、GET操作を発行します。

表51-25 リソース・プロバイダ・タイプ・メタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/types/{resourceprovidertype}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"type" : "mwaas_zone",
"memberTargetTypes" : [ "host" ],
"parentResourceProviderType" : "self_service_zone",
"placementPolicyName" : "First_Pick",
"placementConstraints" : [ {
"name" : "MAX_INSTANCES",
"displayName" : "Maximum Number of WebLogic Servers (per host)",
"description" : "Maximum Number of WebLogic Servers (per host)",
"valueType" : "INTEGER",
"operator" : "eq"
} ],
"characteristics" : [ {
"name" : "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.BASEINSTALLDIR",
"displayName" : "Middleware Home Base Directory",
"description" : "All Oracle Homes would be created from this Base Install Directory.",
"isComposite" : false,
"possibleValues" : [ ],
"isMandatory" : false,
"isUnique" : false
}, {
"name" : "EXAMPLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"displayName" : "Contact",
"description" : null,
"isComposite" : false,
"possibleValues" : [ ],
"isMandatory" : false,
"isUnique" : true
}, {
"name" : "EXAMPLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"displayName" : "Cost Center",
"description" : null,
"isComposite" : false,
"possibleValues" : [ ],
"isMandatory" : false,
"isUnique" : true
}, {
"name" : "EXAMPLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName" : "Department",
"description" : null,
"isComposite" : false,
"possibleValues" : [ ],
"isMandatory" : false,
"isUnique" : true
}, {
"name" : "EXAMPLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"displayName" : "Lifecycle Status",
"description" : null,
"isComposite" : false,
"possibleValues" : [ "Development", "MissionCritical", "Production", "Stage", "Test" ],
5.15 76
"isMandatory" : false,
"isUnique" : true
}, {
"name" : "EXAMPLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"displayName" : "Line of Business",
"description" : null,
"isComposite" : false,
"possibleValues" : [ ],
"isMandatory" : false,
"isUnique" : true
}, {
"name" : "EXAMPLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName" : "Location",
"description" : null,
"isComposite" : false,
"possibleValues" : [ ],
"isMandatory" : false,
"isUnique" : true
}, {
"name" : "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.ASHAREDHOME",
"displayName" : "Shared Oracle Home",
"description" : "When set to Yes, all Hosts in this MW Pool would use this Shared Home even if
other Oracle Homes present on these Hosts. Otherwise, Oracle Home on each Host will be used.",
"isComposite" : false,
"possibleValues" : [ "0", "1" ],
"isMandatory" : false,
"isUnique" : false
}, {
"name" : "EXAMPLE.SYSMAN.EMAS.MWAAS_ZONE",
"displayName" : "oracle.sysman.emas.mwaas_zone",
"description" : null,
"isComposite" : false,
"possibleValues" : [ ],
"isMandatory" : true,
"isUnique" : true
} ],
"memberConstraints" : [ {
"name" : "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.PLATFORM",
"displayName" : "Operating System and Platform",
"description" : null,
"isComposite" : false,
"possibleValues" : [ "197", "59", "212", "209", "46", "226", "912", "208", "233", "23", "267" ]
} ]
}

51.4.4.9 PaaSインフラストラクチャ・ゾーンを作成するためのメタデータの表示

PaaSインフラストラクチャ・ゾーンを作成するためのメタデータを表示するには、GET操作を発行します。

表51-26 PaaSインフラストラクチャ・ゾーン作成用のメタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/self_service_zone

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{ "type": "self_service_zone",
"memberTargetTypes": [ "host" ],
"placementConstraints": [
{ "name": "MAX_MEMORY_ALLOCATION",
"displayName": "MaximumMemoryAllocation(%)",
"description": "MaximumMemoryAllocation constraint per host in a paas infrastructure zone",
"valueType": "INTEGER",
"operator": "eq" },
{ "name": "MAX_CPU_UTILIZATION",
"displayName": "MaximumCPUUtilization(%)",
"description": "MaximumCPU utilization(%) constraint for a physical resource
provider",
"valueType": "INTEGER",
"operator": "eq" } ],
"characteristics": [ { "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"displayName": "Contact",
"description": null,
"isComposite": false,
"possibleValues": [],
"isUnique": true,
"isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"displayName": "CostCenter",
"description": null,
"isComposite": false,
"possibleValues": [],
"isUnique": true,
"isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"description": null,
"isComposite": false,
"possibleValues": [],
"isUnique": true,
"isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"displayName": "LifecycleStatus",
"description": null,
"isComposite": false,
"possibleValues": [ "Development", "MissionCritical",
"Production", "Stage", "Test" ],
"isUnique": true,
"isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"displayName": "Line ofBusiness",
"description": null,
"isComposite": false,
"possibleValues": [],
"isUnique": true,
"isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"description": null,
"isComposite": false,
"possibleValues": [],
"isUnique": true,
"isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_SITE",
"displayName": "Site",
"description": null,
"isComposite": false,
"possibleValues": [],
"isUnique": true,
"isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.SELF_SERVICE_ZONE",
"displayName": "oracle.sysman.cfw.self_service_zone",
"description": null,
"isComposite": false,
"possibleValues": [],
"isUnique": true,
"isMandatory": true } ],
"credentials": [ { "name": "normal_credential_guid",
"displayName": "Host credentials",
"description": "HostCredentials to be used for provisioning in thisPaaSInfrastructureZone.The credentials provided should be of global credential type (valid across the members in the zone) and owned by the current user",
"authenticatingTargetType":
"host", "isMandatory": true } ],
"memberConstraints": []}

51.4.4.10 スキーマ・プールを作成するためのメタデータの表示

スキーマ・プールを作成するためのメタデータを表示するには、GET操作を発行します。

表51-27 スキーマ・プール作成用のメタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/schaas_pool

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{ "type": "schaas_pool",
"memberTargetTypes": [ "oracle_database", "rac_database" ],
"parentResourceProviderType": "self_service_zone",
"placementPolicyName": "First_Pick",
"placementConstraints": [ { "name": "ENFORCE_CPU", "displayName": "EnableResourceManager forCPU", "description": "Whether to enable resource manager which can be used to createConsumerGroups.", "valueType": "BOOLEAN", "operator": "eq" },
{ "name": "MAX_CPU_USAGE", "displayName": "MaximumCPU allocation (%)", "description": "Defines the maximum limit of theCPU permissible for each database, beyond which a service request can not be placed.", "valueType": "INTEGER", "operator": "eq" },
{ "name": "USE_WORKLOAD", "displayName": "Associate workload with the request", "description": "Whether to associate workload with the request which represents the expectedCPU, memory and storage requirements for each service.", "valueType": "BOOLEAN", "operator": "eq" },
{ "name": "MAX_SERVICES", "displayName": "MaximumNumber of database services", "description": "Maximum number of services per database.", "valueType": "INTEGER", "operator": "eq" },
{ "name": "MAX_MEMORY_USAGE", "displayName": "Maximum memory allocation (%)", "description": "Memory represents the summation ofSystemGlobalArea (SGA) allocated for each database.", "valueType": "INTEGER", "operator": "eq" } ],
"characteristics": [ { "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT", "displayName": "Contact", "description": null, "isComposite": false, "possibleValues": [], "isUnique": true, "isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER", "displayName": "CostCenter", "description": null, "isComposite": false, "possibleValues": [], "isUnique": true, "isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT", "displayName": "Department", "description": null, "isComposite": false, "possibleValues": [], "isUnique": true, "isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS", "displayName": "LifecycleStatus", "description": null, "isComposite": false, "possibleValues": [ "Development", "MissionCritical", "Production", "Stage", "Test" ], "isUnique": true, "isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS", "displayName": "Line ofBusiness", "description": null, "isComposite": false, "possibleValues": [], "isUnique": true, "isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION", "displayName": "Location", "description": null, "isComposite": false, "possibleValues": [], "isUnique": true, "isMandatory": false },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_SITE", "displayName": "Site", "description": null, "isComposite": false, "possibleValues": [], "isUnique": true, "isMandatory": false },
{ "name": "ORACLE.SYSMAN.SSA.SCHAAS_POOL", "displayName": "oracle.sysman.ssa.schaas_pool", "description": null, "isComposite": false, "possibleValues": [], "isUnique": true, "isMandatory": true } ],
"credentials": [ { "name": "gi_credential_guid", "displayName": "GridInfrastructureCredentials", "description": "GridInfrastructure credentials are optional.", "authenticatingTargetType": "host", "isMandatory": false },
{ "name": "database_credential_guid", "displayName": "DatabaseCredentials", "description": "The database credentials that will be used for performing database operations like schema creation.The database credentials requireSYSDBA privileges.", "authenticatingTargetType": "oracle_database", "isMandatory": false },
{ "name": "host_credential_guid", "displayName": "HostCredentials", "description": "Host credentials to be specified that will be used to perform instance creation operations.", "authenticatingTargetType": "host", "isMandatory": true } ],
"memberConstraints": [ { "name": "ORACLE.SYSMAN.SSA.CONFIGURATION", "displayName": "DatabaseConfiguration", "description": "DatabaseConfiguration of the resource provider member.", "isComposite": false, "possibleValues": [ "rac_database", "oracle_database" ] },
{ "name": "ORACLE.SYSMAN.CFW.PLATFORM", "displayName": "Platform", "description": "Platform", "isComposite": false, "possibleValues": [ "197", "59", "212", "209", "46", "226", "912", "208", "233", "23", "267" ] },
{ "name": "ORACLE.SYSMAN.CFW.VERSION", "displayName": "Version", "description": "Version", "isComposite": false, "possibleValues": [ "10.2.0.1.0", "10.2.0.2.0", "10.2.0.3.0", "10.2.0.4.0", "10.2.0.5.0", "11.1.0.6.0", "11.1.0.7.0", "11.2.0.1.0", "11.2.0.2.0", "11.2.0.3.0", "11.2.0.4.0", "12.1.0.1.0", "12.1.0.2.0" ] } ]}

51.4.4.11 リソース・プロバイダの詳細の表示

リソース・プロバイダの詳細を表示するには、GET操作を発行します。

表51-28 リソース・プロバイダの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "My Xaas Provider_001",
"type": "cfw_samplexaas_rsrc_provider",
"memberTargetType": "cfw_samplexaas_rsrc",
"members": [
"Sample2"
],
"credentials": [],
"placementConstraints": [
{
"name": "NUMBER_OF_SERVICE_INSTANCES",
"value": [
"20"
]
},
{
"name": "TEST_CONSTRAINT_WITH_STRING_VALUE",
"value": [
"\"string_value\""
]
}
],
"memberConstraints": [],
"characteristics": [
{
"name": "ORACLE.SYSMAN.SXAAS.CFW_SAMPLEXAAS_RSRC_PROVIDER",
"value": [
"C277DA7F0CB329507172B4C44E0A6DF9"
]
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/22"
}
}

51.4.4.12 リソース・プロバイダの更新

システム内のリソース・プロバイダの既存のインスタンスを更新するには、リソース・プロバイダ・リソースに対してPUT操作を発行します。

表51-29 リソース・プロバイダを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"placementConstraints": [{"name": " NUMBER_OF_SERVICE_INSTANCES ", "value":
"70"}],
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message: "Resource Provider with ID "121" updated successfully."
}

51.4.4.13 リソース・プロバイダの削除

DELETEリクエスト構成を次の表に示します。

表51-30 リソース・プロバイダを削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status 200 OK
{
"message":"Resource Provider with ID \"21\" deleted successfully.”
}

51.4.4.14 リソース・プロバイダの構成の表示

リソース・プロバイダの構成を表示するためのGETリクエスト構成を次に示します。

表51-31 リソース・プロバイダの構成を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/4/configurations

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"hosts" : {
"configurations" : [ {
"name" : "vm_networks",
"type" : "VECTOR",
"description" : "Network.",
"displayName" : "vm_networks",
"values" : [ ],
"required" : false,
"secret" : false
}, {
"name" : "platform",
"type" : "STRING",
"value" : "",
"displayName" : "platform",
"required" : false,
"secret" : false
}, {
"name" : "hostPrefix",
"type" : "STRING",
"description" : "Host Name Prefix.",
"value" : "rest_",
"displayName" : "Host Name Prefix",
"required" : false,
"secret" : false
}, {
"name" : "postInstallScript",
"type" : "STRING",
"value" : "",
"displayName" : "postInstallScript",
"required" : false,
"secret" : false
}, {
"name" : "cluster_storages",
"type" : "VECTOR",
"description" : "Cluster Storage.",
"displayName" : "cluster_storages",
"values" : [ ],
"required" : false,
"secret" : false
}, {
"name" : "agent_base",
"type" : "STRING",
"description" : "Agent Install Base Directory Location",
"value" : "bsl",
"displayName" : "Installation Base Directory",
"required" : false,
"secret" : false
}, {
"name" : "cluster_networks",
"type" : "VECTOR",
"description" : "Cluster Network",
"displayName" : "cluster_networks",
"values" : [ ],
"required" : false,
"secret" : false
}, {
"name" : "resourceProviderId",
"type" : "STRING",
"value" : "1",
"displayName" : "resourceProviderId",
"required" : false,
"secret" : false
}, {
"name" : "postInstallScriptOnOMS",
"type" : "STRING",
"value" : "",
"displayName" : "postInstallScriptOnOMS",
"required" : false,
"secret" : false
}, {
"name" : "agent_install_creds",
"type" : "STRING",
"description" : "Agent Port",
"value" : "15513B9C0C6E4EB9E053CE74B10A171B",
"displayName" : "Named Credential",
"required" : false,
"secret" : false
}, {
"name" : "priv_delegation_setting",
"type" : "STRING",
"value" : "/usr/bin/sudo -u %RUNAS% %COMMAND%",
"displayName" : "priv_delegation_setting",
"required" : false,
"secret" : false
}, {
"name" : "vm_instance_sizes",
"type" : "VECTOR",
"description" : "Instance Size.",
"displayName" : "vm_instance_sizes",
"values" : [ "EXTRA_LARGE" ],
"required" : false,
"secret" : false
}, {
"name" : "agent_port",
"type" : "STRING",
"description" : "Agent Port",
"value" : "3872",
"displayName" : "Port",
"required" : false,
"secret" : false
}, {
"name" : "preInstallScript",
"type" : "STRING",
"value" : "",
"displayName" : "preInstallScript",
"required" : false,
"secret" : false
}, {
"name" : "custom_params",
"type" : "VECTOR",
"description" : "Custom parameters for VM configuration.",
"displayName" : "custom_params",
"values" : [ ],
"required" : false,
"secret" : false
}, {
"name" : "vm_server_templates",
"type" : "VECTOR",
"description" : "Server Template.",
"displayName" : "vm_server_templates",
"values" : [ "paas-tmpl" ],
"required" : false,
"secret" : false
}, {
"name" : "preInstallScriptOnOMS",
"type" : "STRING",
"value" : "",
"displayName" : "preInstallScriptOnOMS",
"required" : false,
"secret" : false
}, {
"name" : "numberOfHost",
"type" : "STRING",
"description" : "Number Of Host",
"value" : "3",
"displayName" : "Number Of Host",
"required" : false,
"secret" : false
}, {
"name" : "vm_storages",
"type" : "VECTOR",
"description" : "Storage.",
"displayName" : "vm_storages",
"values" : [ ],
"required" : false,
"secret" : false
}, {
"name" : "runPreInstallScriptAsRoot",
"type" : "STRING",
"value" : "",
"displayName" : "runPreInstallScriptAsRoot",
"required" : false,
"secret" : false
}, {
"name" : "runPostInstallScriptAsRoot",
"type" : "STRING",
"value" : "",
"displayName" : "runPostInstallScriptAsRoot",
"required" : false,
"secret" : false
} ]
},
"swprovisioning" : {
"configurations" : [ {
"name" : "resourceProviderId",
"type" : "STRING",
"value" : "1",
"displayName" : "resourceProviderId",
"required" : false,
"secret" : false
} ]
}
}

51.4.4.15 リソース・プロバイダのメトリックの表示

リソース・プロバイダのメトリックを表示するためのGETリクエスト構成を次に示します。

表51-32 リソース・プロバイダのメトリックを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/21/metrics

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
count: "0"
hasMore: "false"
limit: "0"
offset: "0"
totalResults: "0"
metricColumns: [6]
0: {
name: "services"
}-
1: {
name: "sample"
}-
2: {
name: "memory"
}-
3: {
name: "storageStatus"
}-
4: {
name: "cpu"
}-
5: {
name: "storage"
}-
}

51.4.4.16 サンプル・アダプタを使用したリソースのプロビジョニング

次の表に、リソースをプロビジョニングするためのPOST構成を示します。

表51-33 サンプル・アダプタを使用してリソースをプロビジョニングするためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}/members

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{ "saveOnly" : false,
"setDefault" : true,
"hosts" : { "templateGuid" : "13462942A66F0B2DE053CE74B10AFCC2",
"configurations" : [ { "name" : "hostPrefix", "value" : "rest_" },
{ "name" : "numberOfHost", "value" : "5" },
{ "name" : "agent_install_creds", "value" : "131EFD3114423E7AE053CE74B10A5A76" },
{ "name" : "agent_base", "value" : "bsl" },
{ "name" : "priv_delegation_setting", "value" : "/usr/bin/sudo -u %RUNAS% %COMMAND%" },
{ "name" : "agent_port", "value" : "3872" },
{ "name" : "priv_delegation_setting_template_name", "value" : "" },
{ "name" : "network_purpose_vm", "subvalues" : [ { "name" : "Public", "value" : "192.168.1.0/24" } ] },
{ "name" : "storage_purpose_cluster", "subvalues" : [ { "name" : "Shared", "value" : "smisko_0" } ] },
{ "name" : "storage_purpose_vm", "subvalues" : [ { "name" : "Dedicated", "value" : "smisko_0" } ] },
{ "name" : "network_purpose_cluster", "subvalues" : [ { "name" : "ClusterPrivate", "value" : "192.168.1.0/24" },
{ "name" : "ClusterPublic", "value" : "192.168.1.0/24" } ] },
{ "name" : "vm_instance_sizes", "values" : [ "EXTRA_LARGE" ] },
{ "name" : "vm_server_templates", "values" : [ "paas-tmpl" ] } ] },
"swprovisioning" : { "configurations" : [ { "name" : "param01", "value" : "param_01_val" }, { "name" : "param01", "value" : "param_02_val" } ] }}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{ "status" : "SCHEDULED", "details" : "134821EBDA7472BFE053CE74B10A11B8"}

51.4.4.17 リソースのプロビジョニング解除

リソースをプロビジョニング解除するためのDELETEリクエスト構成を次に示します。

表51-34 リソースをプロビジョニング解除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/{resourceproviderid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{"members":["rest_-bf51c965-fff0-400c-a982-2c71b2afb150","rest_-13ce4c70-e1b4-4bd9-8b43-6952d619e674"]}

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{ "details": "133C8EC6EAC86122E053CE74B10A4DEF", "status": "SCHEDULED"}

51.4.4.18 リソース・プロバイダのプロビジョニングに必要なメタデータの表示

リソース・プロバイダのプロビジョニングに必要なメタデータを表示するためのPOSTリクエスト構成を次に示します。

表51-35 リソース・プロバイダのプロビジョニングに必要なメタデータを表示するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/4/members/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{ "hosts" : { "templateGuid" : "1552104D74F47F29E053CE74B10A08D9" }}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"hosts" : {
"templateGuid" : "1552104D74F47F29E053CE74B10A08D9",
"configurations" : [ {
"name" : "platform",
"type" : "STRING",
"value" : "",
"displayName" : "platform",
"required" : false,
"secret" : false
}, {
"name" : "hostPrefix",
"type" : "STRING",
"description" : "Host Name Prefix.",
"value" : "MySmplAdptr0505013358",
"displayName" : "Host Name Prefix",
"required" : false,
"secret" : false
}, {
"name" : "network_purpose_vm",
"type" : "VECTOR",
"description" : "Purpose Network Instance",
"displayName" : "network_purpose_vm",
"required" : false,
"secret" : false,
"possibleValues" : [ {
"value" : "192.168.1.0/25",
"displayName" : "192.168.1.0/25"
}, {
"value" : "192.168.1.0/24",
"displayName" : "192.168.1.0/24"
}, {
"value" : "192.168.1.0/26",
"displayName" : "192.168.1.0/26"
}, {
"value" : "192.168.1.0/27",
"displayName" : "192.168.1.0/27"
} ],
"subvalues" : [ {
"name" : "Public",
"type" : "STRING",
"displayName" : "Public",
"required" : true,
"secret" : false
} ]
}, {
"name" : "postInstallScript",
"type" : "STRING",
"value" : "",
"displayName" : "postInstallScript",
"required" : false,
"secret" : false
}, {
"name" : "storage_purpose_cluster",
"type" : "VECTOR",
"description" : "Purpose Storage Cluster",
"displayName" : "storage_purpose_cluster",
"required" : false,
"secret" : false,
"possibleValues" : [ {
"value" : "smisko_3",
"displayName" : "smisko_3"
}, {
"value" : "smisko_2",
"displayName" : "smisko_2"
}, {
"value" : "smisko_1",
"displayName" : "smisko_1"
}, {
"value" : "smisko_0",
"displayName" : "smisko_0"
} ],
"subvalues" : [ ]
}, {
"name" : "network_purpose_cluster",
"type" : "VECTOR",
"description" : "Purpose Network Cluster",
"displayName" : "network_purpose_cluster",
"required" : false,
"secret" : false,
"possibleValues" : [ {
"value" : "192.168.1.0/25",
"displayName" : "192.168.1.0/25"
}, {
"value" : "192.168.1.0/24",
"displayName" : "192.168.1.0/24"
}, {
"value" : "192.168.1.0/26",
"displayName" : "192.168.1.0/26"
}, {
"value" : "192.168.1.0/27",
"displayName" : "192.168.1.0/27"
} ],
"subvalues" : [ ]
}, {
"name" : "agent_base",
"type" : "STRING",
"description" : "Agent Install Base Directory Location",
"value" : "/scratch/oracle/",
"displayName" : "Installation Base Directory",
"required" : false,
"secret" : false
}, {
"name" : "resourceProviderId",
"type" : "STRING",
"value" : "1",
"displayName" : "resourceProviderId",
"required" : false,
"secret" : false
}, {
"name" : "postInstallScriptOnOMS",
"type" : "STRING",
"value" : "",
"displayName" : "postInstallScriptOnOMS",
"required" : false,
"secret" : false
}, {
"name" : "agent_install_creds",
"type" : "STRING",
"description" : "Agent Port",
"value" : "15513B9C0C6E4EB9E053CE74B10A171B",
"displayName" : "Named Credential",
"required" : false,
"secret" : false
}, {
"name" : "storage_purpose_vm",
"type" : "VECTOR",
"description" : "Purpose Storage Instance",
"displayName" : "storage_purpose_vm",
"required" : false,
"secret" : false,
"possibleValues" : [ {
"value" : "smisko_3",
"displayName" : "smisko_3"
}, {
"value" : "smisko_2",
"displayName" : "smisko_2"
}, {
"value" : "smisko_1",
"displayName" : "smisko_1"
}, {
"value" : "smisko_0",
"displayName" : "smisko_0"
} ],
"subvalues" : [ {
"name" : "Dedicated",
"type" : "STRING",
"displayName" : "Dedicated",
"required" : true,
"secret" : false
} ]
}, {
"name" : "priv_delegation_setting",
"type" : "STRING",
"value" : "/usr/bin/sudo -u %RUNAS% %COMMAND%",
"displayName" : "priv_delegation_setting",
"required" : false,
"secret" : false
}, {
"name" : "vm_instance_sizes",
"type" : "VECTOR",
"description" : "Instance Size.",
"displayName" : "vm_instance_sizes",
"values" : [ "EXTRA_LARGE", "TINY", "SMALL" ],
"required" : false,
"secret" : false,
"possibleValues" : [ {
"value" : "TINY",
"displayName" : "TINY"
}, {
"value" : "EXTRA_LARGE",
"displayName" : "EXTRA_LARGE"
}, {
"value" : "SMALL",
"displayName" : "SMALL"
} ]
}, {
"name" : "agent_port",
"type" : "STRING",
"description" : "Agent Port",
"value" : "3872",
"displayName" : "Port",
"required" : false,
"secret" : false
}, {
"name" : "preInstallScript",
"type" : "STRING",
"value" : "",
"displayName" : "preInstallScript",
"required" : false,
"secret" : false
}, {
"name" : "vm_server_templates",
"type" : "VECTOR",
"description" : "Server Template.",
"displayName" : "vm_server_templates",
"values" : [ "paas-tmpl", "paas-tmpl2" ],
"required" : false,
"secret" : false,
"possibleValues" : [ {
"value" : "paas-tmpl",
"displayName" : "paas-tmpl"
}, {
"value" : "paas-tmpl2",
"displayName" : "paas-tmpl2"
} ]
}, {
"name" : "preInstallScriptOnOMS",
"type" : "STRING",
"value" : "",
"displayName" : "preInstallScriptOnOMS",
"required" : false,
"secret" : false
}, {
"name" : "numberOfHost",
"type" : "STRING",
"description" : "Number Of Host",
"value" : "",
"displayName" : "Number Of Host",
"required" : false,
"secret" : false
}, {
"name" : "runPreInstallScriptAsRoot",
"type" : "STRING",
"value" : "",
"displayName" : "runPreInstallScriptAsRoot",
"required" : false,
"secret" : false
}, {
"name" : "runPostInstallScriptAsRoot",
"type" : "STRING",
"value" : "",
"displayName" : "runPostInstallScriptAsRoot",
"required" : false,
"secret" : false
} ]
},
"swprovisioning" : {
"configurations" : [ ]
}
}

51.5 サービス・テンプレート群 - V2のコレクション・リソース

サービス・テンプレートは、すべてのアクセス可能なサービス・テンプレート・リソースのSSA管理者ビューを表すコレクション・リソースです。次の表では、サービス・テンプレート・データ・モデルについて説明します。

表51-36 サービス・テンプレート群コレクション・リソース・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

コレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプを示します。

0..1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

count

整数

返される要素の数。

1

items

コレクション<ServiceTemplate>

サービス・テンプレート・リソースのリスト。インスタンスが存在しない場合、itemsフィールドは空になります。

1

totalCount

整数

サービス・テンプレート・リソースの合計数。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

51.5.1 サポートされている操作

次の表に、サービス・テンプレート群に対してサポートされる操作を示します。

表51-37 サービス・テンプレートでサポートされるメソッド

リクエスト・メソッド

正規のリンク

説明

GET

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

サービス・テンプレート群のリストを返します。

GET

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypes

サービス・テンプレート・タイプを返します。

表51-38「SRVCテンプレート・タイプ・データ・モデル」を参照してください。

POST

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadata

サービス・テンプレートの作成に必要なメタデータを返します。

関連項目:

- 表51-39「SRVCテンプレート・メタデータ・リクエスト・データ・モデル」

- 表51-40「SRVCテンプレート・メタデータ・レスポンス・データ・モデル」

- 表51-41「ペイロード・データ・モデル」

- 表51-42「特性データ・モデル」

- 表51-43「ターゲット・タイプ・データ・モデル」

POST

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/resourceproviders

サービス・テンプレートの作成に必要なリソース・プロバイダ特性を返します。

表51-44「SrvcTemplateRscPrvdrRequestデータ・モデル」および表51-45「SrvcTemplateRscPrvdrレスポンス・データ・モデル」を参照してください。

POST

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/configurations

サービス・テンプレートの作成に必要な構成を返します。

表51-46「SrvcTemplateConfigRequestデータ・モデル」を参照してください。

POST

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

サービス・テンプレートを作成します。

PUT

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/{servicetemplateid}

サービス・テンプレートを更新します。

GET

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/{servicetemplateid}

指定されたサービス・テンプレートの詳細を返します。

GET

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/{servicetemplateid}/configurations

指定されたサービス・テンプレートの構成詳細を返します。

DELETE

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/{servicetemplateid}

指定されたサービス・テンプレートを削除します。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypesに対するGETリクエストでサポートされるSRVCテンプレート・タイプ・データ・モデルを示します。

表51-38 SRVCテンプレート・タイプ・データ・モデル

フィールド

タイプ

説明

serviceTemplateTypeId

文字列

サービス・テンプレート・タイプのID。

serviceType

文字列

サービス・タイプの名前。

name

文字列

サービス・テンプレート・タイプの名前。

displayName

文字列

サービス・テンプレート・タイプの表示名

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadataに対するPOSTリクエストでサポートされるSRVCテンプレート・メタデータ・リクエスト・データ・モデルを示します。

表51-39 SRVCテンプレート・メタデータ・リクエスト・データ・モデル

フィールド

タイプ

説明

発生

serviceTemplateTypeId

文字列

サービス・テンプレート・タイプのID。

1

serviceType

文字列

サービス・タイプの名前。

1

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadataに対するPOSTリクエストでサポートされるSRVCテンプレート・メタデータ・レスポンス・データ・モデルを示します。

表51-40 SRVCテンプレート・メタデータ・レスポンス・データ・モデル

フィールド

タイプ

説明

serviceTemplateTypeId

文字列

サービス・テンプレート・タイプのID。

rscProvAssocOption

リスト<文字列>

リソース・プロバイダ・アソシエーション。

payloads

List<Payload>

サービス・テンプレートのペイロード。

selectedExecutableName

CfwValueDescriptor

サービス・テンプレート・タイプ詳細。

characteristics

List<Characteristic>

サービス・テンプレートの特性のリスト。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadataに対するPOSTリクエストでサポートされるペイロード・データ・モデルを示します。

表51-41 ペイロード・データ・モデル

フィールド

タイプ

説明

name

文字列

ペイロードの名前。

value

リスト<文字列>

値リスト。

required

Boolean

必須かどうか。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadataに対するPOSTリクエストでサポートされる特性データ・モデルを示します。

表51-42 特性データ・モデル

フィールド

タイプ

説明

name

文字列

特性の名前。

displayName

文字列

特性の表示名。

values

リスト<文字列>

値リスト。

required

Boolean

必須かどうか。

editable

Boolean

編集可能かどうか。

visible

Boolean

表示可能かどうか。

targetType

TargetType

特性がTarget Characteristicsの場合、このフィールドにはターゲット・タイプの詳細が含まれます。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadataに対するPOSTリクエストでサポートされるターゲット・タイプ・データ・モデルを示します。

表51-43 ターゲット・タイプ・データ・モデル

フィールド

タイプ

説明

targetType

文字列

ターゲット・タイプ。

targetTypeName

文字列

ターゲット・タイプの名前。

parentTargetType

文字列

親ターゲット・タイプ。

parentTargetTypeName

文字列

親ターゲット・タイプの名前。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/resourceprovidersに対するPOSTリクエストでサポートされるSrvcTemplateRscPrvdrRequestデータ・モデルを示します。

表51-44 SrvcTemplateRscPrvdrRequestデータ・モデル

フィールド

タイプ

説明

発生

serviceTemplateTypeId

文字列

サービス・テンプレート・タイプのID。

1

serviceType

文字列

サービス・タイプの名前。

1

rscProvAssocOption

リスト<文字列>

リソース・プロバイダ・アソシエーション。

1

payloads

List<Payload>>

サービス・テンプレートのペイロード。

0..1

characteristics

List<Characteristic>>

サービス・テンプレートの特性。

0..1

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/resourceprovidersに対するPOSTリクエストでサポートされるSrvcTemplateRscPrvdrレスポンス・データ・モデルを示します。

表51-45 SrvcTemplateRscPrvdrレスポンス・データ・モデル

フィールド

タイプ

説明

lookupCharacteristics

List<SrvcTemplatePurpose>

目的特性のリスト。

次の表に、v2フレームワークのURI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/configurationsに対するPOSTリクエストでサポートされるSrvcTemplateConfigRequestデータ・モデルを示します。

表51-46 SrvcTemplateConfigRequestデータ・モデル

フィールド

タイプ

説明

発生

serviceTemplateTypeId

文字列

サービス・テンプレート・タイプのID。

1

serviceType

文字列

サービス・タイプの名前。

1

rscProvAssocOption

リスト<文字列>

リソース・プロバイダ・アソシエーション。

1

payloads

List<Payload>>

サービス・テンプレートのペイロード。

0..1

characteristics

List<Characteristic>>

サービス・テンプレートの特性。

0..1

resourceProvider

SrvcTemplateRscprvdr

リソース・プロバイダ。

1

51.5.2 V2のサービス・テンプレートREST APIの例

この項では、サービス・テンプレート・リソースでサポートされるREST API操作について説明します。次の操作について説明します。

- すべてのサービス・テンプレートの表示

- すべてのサービス・テンプレート・タイプの表示

- サービス・テンプレートの作成に必要なメタデータの表示

- サービス・テンプレートの作成に必要なリソース・プロバイダ特性の表示

- サービス・テンプレートの作成に必要な構成の表示

- サービス・テンプレートの作成

- サービス・テンプレートの更新

- 特定のサービス・テンプレートの詳細の表示

- 特定のサービス・テンプレートの構成詳細の表示

- サービス・テンプレートの削除

51.5.2.1 すべてのサービス・テンプレートの表示

すべてのサービス・テンプレートを表示するには、GET操作を発行します。

表51-47 すべてのサービス・テンプレートを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Service Templates",
"type": "Service Template",
"totalResults": 3,
"cfwItems": [
{
"id": "1",
"name": "Orchestration",
"guid": "06F28ABA2E0178CBE053CE74B10AAC2D",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/1"
},
"description": "Create a set of Oracle VM instances with customized configuration for multitier
applications"
},
{
"id": "2",
"name": "Simple Orchestration",
"guid": "06F28ABA2E0478CBE053CE74B10AAC2D",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/2"
},
"description": "Create one or more Oracle VM instances with default configuration and minimum
inputs"
},
{
"id": "3",
"name": "VM Instance",
"guid": "06F28ABA2E0778CBE053CE74B10AAC2D",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/3"
},
"description": "Create an Oracle VM Instance"
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/"
}
}

51.5.2.2 すべてのサービス・テンプレート・タイプの表示

すべてのサービス・テンプレート・タイプを表示するには、GET操作を発行します。

表51-48 すべてのサービス・テンプレート・タイプを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypes

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

[
{
"name": "SCHEMA",
"displayName": "SchaaS Create Executable",
"serviceType": "SCHEMA",
"serviceTemplateTypeId": "61"
},
{
"name": "MW_SOAAAS_CREATE_INSTANCE",
"displayName": "SOAaaS Orchestration",
"serviceType": "SOA_SERVICE",
"serviceTemplateTypeId": "24"
},
{
"name": "MW_WLAAS_EXECUTABLE_CREATE",
"displayName": "WebLogic Service - Physical",
"serviceType": "WLAAS",
"serviceTemplateTypeId": "28"
},
{
"name": "MW_OSBAAS_CREATE_INSTANCE",
"displayName": "OSBaaS Orchestration",
"serviceType": "OSB_SERVICE",
"serviceTemplateTypeId": "21"
},
{
"name": "DB",
"displayName": "DbaaS Create Executable",
"serviceType": "DB",
"serviceTemplateTypeId": "41"
},
{
"name": "PDB",
"displayName": "PdbaaS Create Executable",
"serviceType": "PDB",
"serviceTemplateTypeId": "54"
},
{
"name": "ORACLE_NIMBULA_CREATE_SIMPLE_ORCHESTRATION_EXECUTABLE",
"displayName": "Simple Orchestration Custom Service Template",
"serviceType": "ORACLE_NIMBULA_ORCHESTRATION_SERVICE",
"serviceTemplateTypeId": "3"
},
{
"name": "ORACLE_NIMBULA_CREATE_ORCHESTRATION_EXECUTABLE",
"displayName": "Orchestration Custom Service Template",
"serviceType": "ORACLE_NIMBULA_ORCHESTRATION_SERVICE",
"serviceTemplateTypeId": "1"
},
{
"name": "ORACLE_NIMBULA_CREATE_VIRTUAL_MACHINE_EXECUTABLE",
"displayName": "ORACLE_NIMBULA_CREATE_VIRTUAL_MACHINE_EXECUTABLE",
"serviceType": "ORACLE_NIMBULA_VIRTUAL_MACHINE_SERVICE",
"serviceTemplateTypeId": "11"
}
]

51.5.2.3 サービス・テンプレートの作成に必要なメタデータの表示

サービス・テンプレートの作成に必要なメタデータを表示するには、POST操作を発行します。

表51-49 サービス・テンプレートの作成に必要なメタデータを表示するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"serviceType": "WLAAS",
"serviceTemplateTypeId": "28"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"serviceType": "WLAAS",
"serviceTemplateTypeId": "28",
"rscProvAssocOption": [
"byRscLookupChars"
],
"selectedExecutableName": {
"name": "MW_WLAAS_EXECUTABLE_CREATE",
"type": "STRING",
"value": "MwaaS_Setup_Domain_Deploy_App",
"defaultValue": "MwaaS_Setup_Domain_Deploy_App",
"required": true,
"secret": false
},
"payloads": [
{
"name": "DEFAULT_PAYLOAD",
"value": "<user_input>",
"required": true
}
],
"characteristics": [
{
"name": "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.ENABLEHA",
"displayName": "Distribute WebLogic Servers on Available Hosts?",
"values": [
"No",
"Yes"
],
"required": false,
"visible": true,
"editable": true
},
{
"name": "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.ENABLELBR",
"displayName": "Enable Load Balancer?",
"values": [
"No",
"Yes"
],
"required": false,
"visible": true,
"editable": true
},
{
"name": "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.EXPOSEADMINURLS",
"displayName": "Expose WebLogic Admin Console and Fusion Middleware Control to SSA
User?",
"values": [
"No",
"Yes"
],
"required": false,
"visible": true,
"editable": true
}
]
}

51.5.2.4 サービス・テンプレートの作成に必要なリソース・プロバイダ特性の表示

サービス・テンプレートの作成に必要なリソース・プロバイダ特性を表示するには、POST操作を発行します。

表51-50 サービス・テンプレートの作成に必要なリソース・プロバイダ特性を表示するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"serviceType": "WLAAS",
"serviceTemplateTypeId": "28",
"rscProvAssocOption": [
"byRscLookupChars"
],
"payloads": [
{
"name": "DEFAULT_PAYLOAD",
"value": "test"
}
],
"characteristics": [
{
"name": "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.ENABLEHA",
"value":"Yes"
},
{
"name": "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.ENABLELBR",
"value":"Yes"
},
{
"name": "EXAMPLE.SYSMAN.EMAS.MWC.WLAAS.EXPOSEADMINURLS",
"value": "Yes"
}
]
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "EXAMPLE.SYSMAN.EMAS.MWAAS_ZONE",
"displayName": "example.sysman.emas.mwaas_zone",
"targetType": {
"targetType": "mwaas_zone",
"parentTargetType": "self_service_zone",
"targetTypeName": "Middleware Pool",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
}

51.5.2.5 サービス・テンプレートの作成に必要な構成の表示

サービス・テンプレートの作成に必要な構成を表示するには、POST操作を発行します。

表51-51 サービス・テンプレートの作成に必要な構成を表示するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/configurations

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"serviceType": "WLAAS",
"serviceTemplateTypeId": "28",
"rscProvAssocOption": [
"byRscLookupChars"
],
"payloads": [
{
"name": "DEFAULT_PAYLOAD",
"value": "test"
}
],
"characteristics": [
{
"name": "ORACLE.SYSMAN.EMAS.MWC.WLAAS.ENABLEHA",
"value": "Yes"
},
{
"name": "ORACLE.SYSMAN.EMAS.MWC.WLAAS.ENABLELBR",
"value": "Yes"
},
{
"name": "ORACLE.SYSMAN.EMAS.MWC.WLAAS.EXPOSEADMINURLS",
"value": "Yes"
}
],
"resourceprovider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.EMAS.MWAAS_ZONE",
"value": "425AA08582AD7AE95D52C24662867315"
}
],
"purposeId": 1
}
]
}
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

[
{
"name": "agentInstallUserPwd",
"type": "STRING",
"description": "Agent Install User Password to override",
"required": false,
"secret": true
},
{
"name": "hostForResourceProvisioningScript",
"type": "STRING",
"description": "Resource management script will be executed on this host.",
"required": false,
"secret": false
},
{
"name": "portRangeStart",
"type": "STRING",
"description": "Lower Bound for choosing Free Ports",
"required": false,
"secret": false
},
{
"name": "wlsUserPassword",
"type": "STRING",
"description": "Password for the WebLogic Server",
"required": false,
"secret": true
},
{
"name": "rootPwd",
"type": "STRING",
"description": "Root Password to override",
"required": false,
"secret": true
},
{
"name": "wlsUserName",
"type": "STRING",
"description": "Username for the WebLogic Server",
"required": false,
"secret": false
},
{
"name": "wlsUserPassword2",
"type": "STRING",
"description": "Re-enter Password for the WebLogic Server",
"required": false,
"secret": true
},
{
"name": "namedHostCredForVirtualFlow",
"type": "STRING",
"description": "Enter name of the host credential to use for provisioning operations",
"required": false,
"secret": false
},
{
"name": "startupArguments",
"type": "STRING",
"description": "Enter memory and java arguments to start the server. Example: -Xms1280m -
Xmx1280m -XX:PermSize=128m -XX:MaxPermSize=256m -
Dweblogic.security.SSL.ignoreHostnameVerification=true",
"required": false,
"secret": false
},
{
"name": "namedCredforHostList",
"type": "STRING",
"description": "This will be used for the above hosts",
"required": false,
"secret": false
},
{
"name": "serviceName",
"type": "STRING",
"description": "Service Instance Name",
"required": true,
"secret": true
},
{
"name": "cpuUsagePerInstance",
"type": "STRING",
"description": "CPU required by each additional instance in percentage",
"required": false,
"secret": false
},
{
"name": "portRangeEnd",
"type": "STRING",
"description": "Upper Bound for choosing Free Ports",
"required": false,
"secret": false
},
{
"name": "memoryUsagePerInstance",
"type": "STRING",
"description": "Memory required by each additional instance in GB",
"required": false,
"secret": false
},
{
"name": "hostListForScripts",
"type": "STRING",
"description": "Use ',' to separate multiple target hosts",
"required": false,
"secret": false
},
{
"name": "topology",
"type": "STRING",
"description": "For physical provisioning it is auto populated based on the profile
selected. For virtual provisioning it is defaulted to 'Single Cluster'. Please change based on the
actual topology of the assembly. ",
"required": false,
"secret": false
},
{
"name": "namedCredforRsrcProvHost",
"type": "STRING",
"description": "Enter the EM Named Credentials to be used for the above host in the \"Host
for Executing Resource Management Script\" field.",
"required": false,
"secret": false
},
{
"name": "isScriptExecuteOnAdminServer",
"type": "STRING",
"description": "Choose 'Yes' to execute scripts on Admin Server host besides the hosts
entered above",
"required": false,
"secret": false
}
]

51.5.2.6 サービス・テンプレートの作成

サービス・テンプレートを作成するには、POST操作を発行します。

表51-52 サービス・テンプレートを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "SampleXaas Template",
"description": "Xaas template",
"serviceType": "CFW_SAMPLEXAAS_SERVICE",
"serviceTemplateTypeId": "82",
"rscProvAssocOption": [
"byRscLookupChars"
],
"roles": [
"SSA01",
"SSA02",
"SSA03",
"SSA04",
"SSA05"
],
"characteristics": [
{
"name": "ORACLE.SYSMAN.SAMPLEXAAS.SAMPLEINSTANCETYPE",
"values": [
"Cfw_Xaas_DB_Service"
]
},
{
"name": "ORACLE.SYSMAN.SAMPLEXAAS.STORAGE_OP_BW",
"values": [
"10"
]
}
],
"resourceproviders": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SAMPLEXAAS.STORAGETYPE",
"displayName": "storage_type",
"value": "db"
}
],
"purposeId": 1
}
]
},
"configurations": [
{
"name": "service_instance_name",
"value": "xaas_inst_name"
},
{
"name": "service_type",
"value": "CFW_SAMPLEXAAS_SERVICE"
},
{
4.22 48
"name": "service_param2",
"value": "p2"
},
{
"name": "service_param1",
"value": "p1"
},
{
"name": "storage_type",
"value": "file"
}
]
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Status 200 OK
{"message": "Service template with id \"0780653DF4C64F83E053CE74B10ABD91\" created successfully."
}

51.5.2.7 サービス・テンプレートの更新

サービス・テンプレートを更新するには、PUT操作を発行します。

表51-53 サービス・テンプレートを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/{servicetemplateid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"displayName": "updatedDisplayName",
"description": "updated via API",
"rolesToAdd": [
"SSA04",
"SSA05",
"SSA06",
],
"rolesToRemove": [
"SSA01",
"SSA02",
"SSA03",
],
"configurations": [
{
"name": "service_instance_name",
"value": "inst_name_${tstmp}"
},
{
"name": "service_type",
"value": "CFW_SAMPLEXAAS_SERVICE"
},
{
"name": "service_param2",
"value": "sp2_up"
},
{
"name": "service_param1",
"value": "sp1_up"
},
{
"name": "storage_type",
"value": "file_up"
}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
{
"message": " Service template with id "1" updated successfully.”
}

51.5.2.8 特定のサービス・テンプレートの詳細の表示

特定のサービス・テンプレートの詳細を表示するには、GET操作を発行します。

表51-54 特定のサービス・テンプレートの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/{servicetemplateid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"id": "63",
"guid": "0780653DF4C94F83E053CE74B10ABD91",
"name": "SampleXaas Template",
"displayName": "SampleXaas Template",
"description": "Xaas template",
"serviceType": "CFW_SAMPLEXAAS_SERVICE",
"serviceTemplateTypeId": "82",
"createdOn": "2014-11-10T16:52:18Z",
"createdBy": "SYSMAN",
"modifiedOn": "2014-11-10T16:52:18Z",
"owner": "SYSMAN",
"lastModified": "2014-11-10T16:52:18Z",
"characteristics": [
{
"name": "EXAMPLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"displayName": "Contact",
"values": [],
"required": false,
"visible": false,
"editable": true
},
{
"name": "EXAMPLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"displayName": "Cost Center",
"values": [],
"required": false,
"visible": false,
"editable": true
},
{
"name": "EXAMPLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"values": [],
"required": false,
"visible": false,
"editable": true
},
{
"name": "EXAMPLE.SYSMAN.SAMPLEXAAS.SAMPLEINSTANCETYPE",
"displayName": "Instance Type",
"values": [
"Cfw_Xaas_DB_Service"
],
"required": true,
"visible": true,
"editable": false
},
{
"name": "EXAMPLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"displayName": "Lifecycle Status",
"values": [
"Development",
"MissionCritical",
"Production",
"Stage",
"Test"
],
"required": false,
"visible": false,
"editable": true
},
{
"name": "EXAMPLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"displayName": "Line of Business",
"values": [],
"required": false,
"visible": false,
"editable": true
},
{
"name": "EXAMPLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": [],
"required": false,
"visible": false,
"editable": true
},
{
"name": "EXAMPLE.SYSMAN.SAMPLEXAAS.STORAGE_OP_BW",
"displayName": "Operation Bandwidth",
"values": [
"10"
],
"required": false,
"visible": true,
"editable": true
}
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "EXAMPLE.SYSMAN.SAMPLEXAAS.STORAGETYPE",
"displayName": "storage_type",
"values": [
"db"
]
}
],
"purposeId": 1
}
]
},
"configurations": [
{
"name": "service_instance_name",
"type": "STRING",
"description": "Specify Instance Name",
"value": "xaas_inst_name",
"required": true,
"secret": false
},
{
"name": "service_type",
"type": "STRING",
"description": "Specify Service type",
"value": "CFW_SAMPLEXAAS_SERVICE",
"required": true,
"secret": false
},
{
"name": "service_param2",
"type": "STRING",
"description": "Service param 2",
"value": "p2",
"required": false,
"secret": false
},
{
"name": "service_param1",
"type": "STRING",
"description": "Service param 1",
"value": "p1",
"required": false,
"secret": false
},
{
"name": "storage_type",
"type": "STRING",
"description": "Specify Storage type",
"value": "file",
"required": true,
"secret": false
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/63"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/63"
}
}

51.5.2.9 特定のサービス・テンプレートの構成詳細の表示

特定のサービス・テンプレートの構成詳細を表示するには、GET操作を発行します。

表51-55 特定のサービス・テンプレートの構成詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/{servicetemplateid}/configurations

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

[
{
"name": "service_instance_name",
"type": "STRING",
"description": "Specify Instance Name",
"value": "xaas_inst_name",
"required": true,
"secret": false
},
{
"name": "service_type",
"type": "STRING",
"description": "Specify Service type",
"value": "CFW_SAMPLEXAAS_SERVICE",
"required": true,
"secret": false
},
{
"name": "service_param2",
"type": "STRING",
"description": "Service param 2",
"value": "p2",
"required": false,
"secret": false
},
{
"name": "service_param1",
"type": "STRING",
"description": "Service param 1",
"value": "p1",
"required": false,
"secret": false
},
{
"name": "WorkLoads",
"type": "VECTOR",
"description": "WorkLoad Values",
"required": false,
"secret": false,
"subvalues": [
{
"name": "Small",
"type": "VECTOR",
"description": "Configuration Values for Small WorkLoad",
"required": false,
"secret": false,
"subvalues": [
{
"name": "DEPL_SIZE_IS_DEFAULT_KEY",
"type": "STRING",
"value": "Y",
"required": false,
"secret": false
},
{
"name": "CPU",
"type": "STRING",
"value": "60",
"required": false,
"secret": false
},
{
"name": "MEMORY",
"type": "STRING",
"value": "4048",
"required": false,
"secret": false
},
{
"name": "STORAGE",
"type": "STRING",
"value": "500",
"required": false,
"secret": false
},
{
"name": "XAAS_TEST",
"type": "STRING",
"value": "NONE",
"required": false,
"secret": false
}
]
},
{
"name": "Medium",
"type": "VECTOR",
"description": "Configuration Values for Medium WorkLoad",
"required": false,
"secret": false,
"subvalues": [
{
"name": "DEPL_SIZE_IS_DEFAULT_KEY",
"type": "STRING",
"value": "N",
"required": false,
"secret": false
},
{
"name": "CPU",
"type": "STRING",
"value": "80",
"required": false,
"secret": false
},
{
"name": "MEMORY",
"type": "STRING",
"value": "8088",
"required": false,
"secret": false
},
{
"name": "STORAGE",
"type": "STRING",
"value": "750",
"required": false,
"secret": false
}
]
},
{
"name": "Large",
"type": "VECTOR",
"description": "Configuration Values for Large WorkLoad",
"required": false,
"secret": false,
"subvalues": [
{
"name": "DEPL_SIZE_IS_DEFAULT_KEY",
"type": "STRING",
"value": "Y",
"required": false,
"secret": false
},
{
"name": "CPU",
"type": "STRING",
"value": "60",
"required": false,
"secret": false
},
{
"name": "MEMORY",
"type": "STRING",
"value": "40448",
"required": false,
"secret": false
},
{
"name": "STORAGE",
"type": "STRING",
"value": "500",
"required": false,
"secret": false
}
]
}
]
},
{
"name": "storage_type",
"type": "STRING",
"description": "Specify Storage type",
"value": "file",
"required": true,
"secret": false
}
]

51.5.2.10 サービス・テンプレートの削除

DELETEリクエスト構成を次の表に示します。

表51-56 サービス・テンプレートを削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/{servicetemplateid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"message": "Service template with id \"62\" deleted successfully."
}

51.5.3 V2でのサービス・テンプレートの作成

この項では、REST APIを使用してサービス・テンプレートを作成する手順を示します。

次の手順に従って、サービス・テンプレートを作成します。

1. サービス・テンプレート・タイプを識別します。
URI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypes/に対してGET操作を実行します。第51.5.2.2項「すべてのサービス・テンプレート・タイプの表示」を参照してください。

GET操作は、管理者が使用可能なサービス・テンプレート・タイプのリストを返します。必要なサービス・テンプレートのserviceTypeおよびserviceTemplateTypeIdフィールドをメモします。

2. 選択したサービス・テンプレート・タイプのメタデータを取得します。
前の手順のserviceTypeおよびserviceTemplateTypeIdフィールドを使用して、URI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadataに対してPOST操作を実行します。第51.5.2.3項「サービス・テンプレートの作成に必要なメタデータの表示」を参照してください。

POST操作は、サービス・テンプレート特性およびペイロードに関する情報を含むレスポンスを返します。これらのフィールドをメモします。次の手順で値を設定する必要があります。

3. 選択したサービス・テンプレート・タイプのリソース・プロバイダ特性を取得します。
メタデータ・フィールドの値を提供することで、URI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/resourceprovidersに対してPOST操作を実行します。第51.5.2.4項「サービス・テンプレートの作成に必要なリソース・プロバイダ特性の表示」を参照してください。

POST操作はresourceProvider検索特性を含むレスポンスを返します。詳細をメモします。

4. 選択したサービス・テンプレート・タイプの構成詳細を取得します。
これまでに収集したすべてのフィールドの値とともにペイロードを提供することで、URI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/configurationsに対してPOST操作を実行します。第51.5.2.5項「サービス・テンプレートの作成に必要な構成の表示」を参照してください。

POST操作は、サービス・テンプレートの構成のリストを含むレスポンスを返します。詳細をメモします。

5. サービス・テンプレートを作成します。
これまでに収集したすべてのフィールドの値とともにペイロードを提供することで、URI - /em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplatesに対してPOST操作を実行します。第51.5.2.6項「サービス・テンプレートの作成」を参照してください。

POST操作は、構成された値でサービス・テンプレートを作成します。

51.6 V2のサービス・タイプ

この項では、v2フレームワークのサービス・タイプについて説明します。

表51-57 サービス・タイプ・リソース・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

コレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプ。

1

totalResults

整数

アイテムの総数。

1

cfwItems

List<ServiceType>

サービス・タイプのリスト。

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

51.6.1 V2のサービス・タイプREST APIの例

この項では、サービス・タイプ・リソースのREST APIについて説明します。

51.6.1.1 サービス・タイプの詳細の表示

サービス・タイプ・リソースの詳細を表示するためのGETリクエスト構成。

表51-58 サービス・タイプの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetypes

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Service Types",
"type": "Service Types Collection",
"totalResults": 3,
"cfwItems": [
{
"name": "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"displayName": "Cfw Sample RemoteServer XaaS",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service"
]
},
{
"name": "CFW_SAMPLEXAAS_SERVICE",
"displayName": "Cfw Sample XaaS",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service",
"cfw_xaas_storage_service"
]
},
{
"name": "CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM",
"displayName": "Cfw Sample XaaS - Other Service",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service_for_nomem"
]
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetypes"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetypes"
}
}

51.7 V2のサービス・リクエスト

この項では、v2フレームワークのサービス・リクエストについて説明します。

表51-59 リクエスト・コレクション・リソース・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

コレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

count

整数

返される要素の数。

1

cfwItems

コレクション<リクエスト>

リクエスト・リソースのリスト。リクエストが存在しない場合、アイテムは空です。

1

totalResults

整数

リクエストの合計数。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

51.7.1 サポートされている操作

次の表に、サービス・リクエスト・リソースでサポートされる操作を示します。

表51-60 サービス・リクエストに対してサポートされるメソッド

リクエスト・メソッド

正規のリンク

説明

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests

すべてのサービス・リクエストのリストを返します。

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests/{servicerequestis}

指定されたサービス・リクエストの詳細を返します。

PUT

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests/{servicerequestid}

指定されたサービス・リクエストを再スケジュールします。

PUT

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests

リクエストのコレクションをクリアします。

DELETE

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests/{servicerequestid}

指定されたサービス・リクエストを取り消します。

DELETE

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests

サービス・リクエストのリストを削除します。

51.7.2 V2のサービス・リクエストREST APIの例

この項では、サービス・リクエスト・リソースのREST APIについて説明します。次の操作について説明します。

- すべてのサービス・リクエストの詳細の表示

- サービス・リクエストの詳細の表示

- サービス・リクエストの再スケジュール

- サービス・リクエストのコレクションのクリア

- サービス・リクエストの取消し

- サービス・リクエストのリストの削除

51.7.2.1 すべてのサービス・リクエストの詳細の表示

すべてのサービス・リクエストの詳細を表示するには、GET操作を発行します。

表51-61 すべてのサービス・リクエストの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
name: "Service Requests"
type: "Service Request"
hasMore: false
count: 1
cfwItems: [
{
name: "Request1_21-Dec-13 17:37:34"
id: 27
startDate: "2013-12-22T01:37:34'Z'PDT"
status: "SCHEDULED"
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicereques
ts/27"
} ]
totalCount: 1
canonicalLink: {
href:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicereques
ts"
}
selfLink: {
ref:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicereques
ts"
}}

51.7.2.2 サービス・リクエストの詳細の表示

サービス・リクエストの詳細を表示するには、GET操作を発行します。

表51-62 サービス・リクエストの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests/27

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
id: "27"
name: "Request1_21-Dec-13 17:37:34"
startDate: "2013-12-22T01:37:34'Z'PDT"
status: "SUCCESS"
serviceFamily:"CFW_SAMPLEXAAS_SERVICEFAMILY"
canonicalLink:
{
href:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicereques
ts/27"
}
}

51.7.2.3 サービス・リクエストの再スケジュール

サービス・リクエストを再スケジュールするには、PUT操作を発行します。

表51-63 サービス・リクエストを再スケジュールするためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests/27

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"startDate":"2014-01-19T08:06:39ZPDT"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
{
"message": "Request 27 rescheduled successfully"
}

51.7.2.4 サービス・リクエストのコレクションのクリア

サービス・リクエストのコレクションをクリアするには、PUT操作を発行します。

表51-64 サービス・リクエストのコレクションをクリアするためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"action": "cleanup",
"ids": [
"22,23"
]
}

リクエスト・メソッド

PUT

51.7.2.5 サービス・リクエストの取消し

サービス・リクエストを取り消すには、DELETE操作を発行します。

表51-65 サービス・リクエストを取り消すためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests/27

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status 200 OK
{
"message": "Request 27 cancelled successfully"
}

51.7.2.6 サービス・リクエストのリストの削除

サービス・リクエストのリストをクリアするには、DELETE操作を発行します。

表51-66 サービス・リクエストをクリアするためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicerequests

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"ids": [
"2",
"4"
]
}

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"message": "[\"Request 32 deleted successfully\",\"Request 31 deleted successfully\",\"Request
30 deleted successfully\"]"
}

51.8 V2のサービス・インスタンス

サービス・インスタンスは、すべてのアクセス可能なサービス・インスタンスのユーザーのビューを表すコレクション・リソースです。

次の表に、サービス・インスタンス・データ・モデルを示します。

表51-67 サービス・インスタンス・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

コレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

count

整数

返される要素の数。

1

cfwItems

コレクション<ServiceInstances>

サービス・インスタンス・リソースのリスト。サービス・インスタンスが存在しない場合、アイテムは空です。

1

totalResults

整数

サービス・インスタンスの合計数。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

51.8.1 サポートされている操作

次の表に、サービス・インスタンス・リソースでサポートされる操作を示します。

表51-68 サービス・インスタンスに対してサポートされるメソッド

リクエスト・メソッド

正規のリンク

説明

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances

すべてのサービス・インスタンスを返します。

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/{serviceinstanceid}

指定されたサービス・インスタンスの詳細を返します。

PUT

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/{instanceguid}/start

指定されたサービス・インスタンスを起動します。

PUT

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/{instanceguid}/stop

指定されたサービス・インスタンスを停止します。

PUT

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/{instanceguid}/delete

指定されたサービス・インスタンスを削除します。

PUT

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/start

サービス・インスタンスのリストを開始します。

PUT

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/stop

サービス・インスタンスのリストを停止します。

PUT

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/delete

サービス・インスタンスのリストを削除します。

51.8.2 V2のサービス・インスタンスREST APIの例

この項では、サービス・インスタンス・リソースのREST APIについて説明します。次の操作について説明します。

- すべてのサービス・インスタンスの詳細の表示

- サービス・インスタンスの詳細の表示

- サービス・インスタンスの起動

- サービス・インスタンスの停止

- サービス・インスタンスの削除

- サービス・インスタンスのリストの開始

- サービス・インスタンスのリストの停止

- サービス・インスタンスのリストの削除

51.8.2.1 すべてのサービス・インスタンスの詳細の表示

すべてのサービス・インスタンスの詳細を表示するには、GET操作を発行します。

表51-69 すべてのサービス・インスタンスの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
selfLink:
{
href: "em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances"
}
CfwItems: [1]
0: {
guid: "92EB43C3F773F3DF3973C1005C54DC43"
status: "SUCCESS"
serviceType: "CFW_SAMPLEXAAS_SERVICE"
serviceFamily: "CFW_SAMPLEXAAS_SERVICEFAMILY"
name: "dfgdfddd"
canonicalLink: {
href:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servic
einstances/92EB43C3F773F3DF3973C1005C54DC43"
rel: "Canonical"
templated: false
}
hasMore: false
totalResults: 9
}

51.8.2.2 サービス・インスタンスの詳細の表示

サービス・インスタンスの詳細を表示するには、GET操作を発行します。

表51-70 サービス・インスタンスの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/92EB43C3F773F3DF3973C1005C54DC43

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
guid: "92EB43C3F773F3DF3973C1005C54DC43"
serviceType: "CFW_SAMPLEXAAS_SERVICE"
serviceFamily: "CFW_SAMPLEXAAS_SERVICEFAMILY"
name: "dfgdfddd"
canonicalLink: {
href:
"em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/92EB43C3F773
F3DF3973C1005C54DC43"
}
}

51.8.2.3 サービス・インスタンスの起動

サービス・インスタンスを起動するには、PUT操作を発行します。

表51-71 サービス・インスタンスを起動するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/{instanceguid}/start

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

[
"Request submitted with Request ID : 43"
]

51.8.2.4 サービス・インスタンスの停止

サービス・インスタンスを停止するには、PUT操作を発行します。

表51-72 サービス・インスタンスを停止するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/{instanceguid}/stop

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

[
"Request submitted with Request ID : 44"
]

51.8.2.5 サービス・インスタンスの削除

サービス・インスタンスを削除するには、PUT操作を発行します。

表51-73 サービス・インスタンスを削除するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/{instanceguid}/delete

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

[
"Request submitted with Request ID : 45"
]

51.8.2.6 サービス・インスタンスのリストの開始

サービス・インスタンスのリストを開始するには、PUT操作を発行します。

表51-74 サービス・インスタンスのリストを開始するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/start

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"ids": [
"20E46B615DC70027F76A86FEDAC06D17",
"8EAF6A882337F154A1B6D890AF00999B",
"637B0CE930E36BE5EFFF306BE3E57EFA"
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

[
"Request submitted with Request ID : 34",
"Request submitted with Request ID : 35",
"Request submitted with Request ID : 36"
]

51.8.2.7 サービス・インスタンスのリストの停止

サービス・インスタンスのリストを停止するには、PUT操作を発行します。

表51-75 サービス・インスタンスのリストを停止するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/stop

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"ids": [
"20E46B615DC70027F76A86FEDAC06D17",
"8EAF6A882337F154A1B6D890AF00999B",
"637B0CE930E36BE5EFFF306BE3E57EFA"
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

[
"Request submitted with Request ID : 37",
"Request submitted with Request ID : 38",
"Request submitted with Request ID : 39"
]

51.8.2.8 サービス・インスタンスのリストの削除

サービス・インスタンスのリストを削除するには、PUT操作を発行します。

表51-76 サービス・インスタンスを削除するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/serviceinstances/delete

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"ids": [
"20E46B615DC70027F76A86FEDAC06D17",
"8EAF6A882337F154A1B6D890AF00999B",
"637B0CE930E36BE5EFFF306BE3E57EFA"
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

[
"Request submitted with Request ID : 40",
"Request submitted with Request ID : 41",
"Request submitted with Request ID : 42"
]

51.9 V2のリクエスト設定

設定はSSA管理者によって適用され、リクエスト処理に使用できます。設定は、次のカテゴリに分類されます。

- グローバル設定 - これらは、すべてのサービス・タイプに対して適用できる一般設定です。

- サービス・ファミリ設定 - これらの設定は、サービス・ファミリに固有です。

- サービス・タイプ設定 - これらの設定は、サービス・タイプに固有です。

51.9.1 リクエスト設定データ・モデル

次の表に、リクエスト設定データ・モデルを示します。

表51-77 リクエスト設定データ・モデル

フィールド

タイプ

説明

発生

requestSettings

RequestSettings

すべてのサービス・タイプに対して適用できるリクエスト設定。

1

swLibDefaultLocation

文字列

ソフトウェア・ライブラリのデフォルトの場所。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

51.9.2 リクエスト設定コンポジット属性データ・モデル

次の表に、リクエスト設定コンポジット属性データ・モデルを示します。

表51-78 リクエスト設定コンポジット属性データ・モデル

フィールド

タイプ

説明

発生

futureReservationPolicy

RequestPolicy

セルフ・サービス・ユーザーがあらかじめリクエストをスケジュールできる日数。

1

requestDurationPolicy

RequestPolicy

セルフ・サービス・ユーザーがサービス・インスタンスを保持できる最長期間(日数)。

1

RequestArchivePolicy

RequestPolicy

セルフ・サービスの作成リクエストが、「完了済」となった後、リポジトリからパージされるまでの期間(日数)。

1

51.9.3 V2のリクエスト設定REST APIの例

この項では、リクエスト設定リソースのREST APIについて説明します。次の操作について説明します。

- グローバル・リクエスト設定の詳細の表示

- グローバル・リクエスト設定の更新

- ロールのコレクションのグローバル・リクエスト設定の詳細の表示

- ロールのグローバル・リクエスト設定の作成

- 特定のロールのグローバル・リクエスト設定の詳細の表示

- 特定のロールのグローバル・リクエスト設定の更新

- 特定のロールのグローバル・リクエスト設定の削除

- サービス・ファミリのリクエスト設定の詳細の表示

- サービス・ファミリのリクエスト設定の更新

- ロール別のサービス・ファミリ設定の詳細の表示

- ロールのサービス・ファミリ設定の作成

- 特定のロールのサービス・ファミリ・リクエスト設定の詳細の表示

- 特定のロールのサービス・ファミリ・リクエスト設定の更新

- 特定のロールのサービス・ファミリ・リクエスト設定の削除

- サービス・タイプのリクエスト設定の詳細の表示

- サービス・タイプのリクエスト設定の更新

- ロール別のサービス・タイプ設定の詳細の表示

- ロールのサービス・タイプ設定の作成

- 特定のロールのサービス・タイプ・リクエスト設定の詳細の表示

- 特定のロールのサービス・タイプ・リクエスト設定の更新

- 特定のロールのサービス・タイプ・リクエスト設定の削除

51.9.3.1 グローバル・リクエスト設定の詳細の表示

グローバル・リクエスト設定リソースの詳細を表示するには、GET操作を発行します。

表51-79 グローバル・リクエスト設定リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/global

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"requestSettings": [
{
"description": "This setting controls how far a user can make a request",
"displayName": "Future Reservation Length",
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "No Restriction"
},
{
"description": "This setting controls the maximum duration for which a user can make a
request",
"displayName": "Request duration Length",
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "No Restriction"
},
{
"description": "This setting controls the maximum duration after which archived requests
will be automatically deleted by the system",
"displayName": "Request Archive Retention Length",
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "No Restriction"
},
{
"description": "Sharing enabled/disabled",
"name": "SERVICE_INSTANCE_USER_SHARE_ALLOWED",
"value": "false"
},
{
"description": "Sharing enabled/disabled",
"name": "SERVICE_INSTANCE_ROLE_SHARE_ALLOWED",
"value": "false"
}
]
}

51.9.3.2 グローバル・リクエスト設定の更新

グローバル・リクエスト設定リソースを更新するには、PUT操作を発行します。

表51-80 グローバル・リクエスト設定リソースを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/global

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Weeks",
"value": "4"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message": "\"Global\" settings updated successfully."
}

51.9.3.3 ロールのコレクションのグローバル・リクエスト設定の詳細の表示

ロールのコレクションのグローバル・リクエスト設定の詳細を表示するには、GET操作を発行します。

表51-81 ロールのコレクションに対するグローバル・リクエスト設定の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/global/roles

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"items": [
{
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/
global/roles/SSA01",
"name": "SSA01"
},
{
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/
global/roles/SSA05",
"name": "SSA05"
}
],
"totalResults": 2
}

51.9.3.4 ロールのグローバル・リクエスト設定の作成

ロールのグローバル・リクエスト設定を作成するには、POST操作を発行します。

表51-82 ロールのグローバル・リクエスト設定を作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/global/roles

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"SERVICE_INSTANCE_USER_SHARE_ALLOWED": {
"value": "true"
},
"requestSettings": [
{
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Weeks",
"value": "4"
},
{
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Hours",
"value": "23"
},
{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Days",
"value": "21"
}
],
"role": "TVMCFW_R1"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "\"Global role \" settings created successfully."
}

51.9.3.5 特定のロールのグローバル・リクエスト設定の詳細の表示

特定のロールのグローバル・リクエスト設定の詳細を表示するには、GET操作を発行します。

表51-83 特定のロールに対するグローバル・リクエスト設定の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/global/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"requestSettings": [
{
"description": "This setting controls how far a user can make a request",
"displayName": "Future Reservation Length",
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R1",
"unitOfMeasurement": "Days",
"value": "21"
},
{
"description": "This setting controls the maximum duration for which a user can make a
request",
"displayName": "Request duration Length",
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R1",
"unitOfMeasurement": "Weeks",
"value": "4"
},
{
"description": "This setting controls the maximum duration after which archived requests
will be automatically deleted by the system",
"displayName": "Request Archive Retention Length",
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R1",
"unitOfMeasurement": "Hours",
"value": "23"
},
{
"description": "Sharing enabled/disabled",
"name": "SERVICE_INSTANCE_USER_SHARE_ALLOWED",
"value": "true"
},
{
"description": "Sharing enabled/disabled",
"name": "SERVICE_INSTANCE_ROLE_SHARE_ALLOWED",
"value": "true"
}
]
}

51.9.3.6 特定のロールのグローバル・リクエスト設定の更新

特定のロールのグローバル・リクエスト設定を更新するには、PUT操作を発行します。

表51-84 特定のロールに対するグローバル・リクエスト設定を更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/global/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Years",
"value": "75"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message": "\"Global role \" settings updated successfully."
}

51.9.3.7 特定のロールのグローバル・リクエスト設定の削除

特定のロールのグローバル・リクエスト設定を削除するには、DELETE操作を発行します。

表51-85 特定のロールに対するグローバル・リクエスト設定を削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/global/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"message": "\"Global role \" settings deleted successfully."
}

51.9.3.8 サービス・ファミリのリクエスト設定の詳細の表示

サービス・ファミリのリクエスト設定の詳細を表示するには、GET操作を発行します。

表51-86 サービス・ファミリに対するリクエスト設定の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicefamily/{servicefamily}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"requestSettings": [
{
"description": "This setting controls how far a user can make a request",
"displayName": "Future Reservation Length",
"family": "cfw_samplexaas_servicefamily",
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Days",
"value": "25"
},
{
"description": "This setting controls if there is a restriction on the maximum duration
for which requests can be made",
"displayName": "Request Duration Restricted",
"family": "cfw_samplexaas_servicefamily",
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "No Restriction"
},
{
"description": "This setting controls if there is a restriction on the maximum duration
after which archived requests will be automatically deleted by the system",
"displayName": "Request Archive Retention Restricted",
"family": "cfw_samplexaas_servicefamily",
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "No Restriction"
},
{
"displayName": "Service Instance Sharing With Users Restricted",
"family": "cfw_samplexaas_servicefamily",
"name": "SERVICE_INSTANCE_USER_SHARE_ALLOWED",
"value": "false"
},
{
"displayName": "Service Instance Sharing With Roles Restricted",
"family": "cfw_samplexaas_servicefamily",
"name": "SERVICE_INSTANCE_ROLE_SHARE_ALLOWED",
"value": "false"
}
]
}

51.9.3.9 サービス・ファミリのリクエスト設定の更新

サービス・ファミリのリクエスト設定を更新するには、PUT操作を発行します。

表51-87 サービス・ファミリに対するリクエスト設定を更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicefamily/{servicefamily}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Weeks",
"value": "4"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message": "\"Family \" settings updated successfully."
}

51.9.3.10 ロール別のサービス・ファミリ設定の詳細の表示

ロール別のサービス・ファミリ設定の詳細を表示するには、GET操作を発行します。

表51-88 ロール別のサービス・ファミリ設定の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicefamily/{servicefamily}/roles

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"items": [
{
"href":
"https://xx.idc.example.com:34518/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/r
equestsettings/servicefamily/cfw_samplexaas_servicefamily/roles/TVMCFW_R2",
"name": "TVMCFW_R2"
}
],
"totalResults": 1
}

51.9.3.11 ロールのサービス・ファミリ設定の作成

ロールのサービス・ファミリ設定を作成するには、POST操作を発行します。

表51-89 ロールのサービス・ファミリ設定を作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicefamily/{servicefamily}/roles

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"SERVICE_INSTANCE_USER_SHARE_ALLOWED": {
"value": "true"
},
"requestSettings": [
{
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Weeks",
"value": "14"
},
{
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Hours",
"value": "123"
},
{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Days",
"value": "121"
}
],
"role": "TVMCFW_R2"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "\"Family role \" settings created successfully."
}

51.9.3.12 特定のロールのサービス・ファミリ・リクエスト設定の詳細の表示

特定のロールのサービス・ファミリ・リクエスト設定の詳細を表示するには、GET操作を発行します。

表51-90 特定のロールに対するサービス・ファミリ・リクエスト設定の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicefamily/{servicefamily}/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"requestSettings": [
{
"description": "This setting controls how far a user can make a request",
"displayName": "Future Reservation Length",
"family": "cfw_samplexaas_servicefamily",
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R2",
"unitOfMeasurement": "Days",
"value": "121"
},
{
"description": "This setting controls the maximum duration for which a user can make a
request",
"displayName": "Request duration Length",
"family": "cfw_samplexaas_servicefamily",
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R2",
"unitOfMeasurement": "Weeks",
"value": "14"
},
{
"description": "This setting controls the maximum duration after which archived requests
will be automatically deleted by the system",
"displayName": "Request Archive Retention Length",
"family": "cfw_samplexaas_servicefamily",
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R2",
"unitOfMeasurement": "Hours",
"value": "123"
},
{
"description": "Sharing enabled/disabled",
"name": "SERVICE_INSTANCE_USER_SHARE_ALLOWED",
"value": "false"
},
{
"description": "Sharing enabled/disabled",
"name": "SERVICE_INSTANCE_ROLE_SHARE_ALLOWED",
"value": "false"
}
]
}

51.9.3.13 特定のロールのサービス・ファミリ・リクエスト設定の更新

特定のロールのサービス・ファミリ・リクエスト設定を更新するには、PUT操作を発行します。

表51-91 特定のロールに対するサービス・ファミリ・リクエスト設定を更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicefamily/{servicefamily}/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Years",
"value": "75"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message": "\"Family role\" settings updated successfully."
}

51.9.3.14 特定のロールのサービス・ファミリ・リクエスト設定の削除

特定のロールのサービス・ファミリ・リクエスト設定を削除するには、DELETE操作を発行します。

表51-92 特定のロールに対するサービス・ファミリ・リクエスト設定を削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicefamily/{servicefamily}/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"message": "\"Family role \" settings deleted successfully."
}

51.9.3.15 サービス・タイプのリクエスト設定の詳細の表示

サービス・タイプのリクエスト設定の詳細を表示するには、GET操作を発行します。

表51-93 サービス・タイプに対するリクエスト設定の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicetype/{servicetype}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"requestSettings": [
{
"description": "This setting controls if there is a restriction on how far a user can
make a request",
"displayName": "Future Reservation Restricted",
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "No Restriction",
"serviceType": "cfw_samplexaas_service"
},
{
"description": "This setting controls if there is a restriction on the maximum duration
for which requests can be made",
"displayName": "Request Duration Restricted",
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "No Restriction",
"serviceType": "cfw_samplexaas_service"
},
{
"description": "This setting controls if there is a restriction on the maximum duration
after which archived requests will be automatically deleted by the system",
"displayName": "Request Archive Retention Restricted",
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "No Restriction",
"serviceType": "cfw_samplexaas_service"
},
{
"displayName": "Service Instance Sharing With Users Restricted",
"name": "SERVICE_INSTANCE_USER_SHARE_ALLOWED",
"serviceType": "cfw_samplexaas_service",
"value": "false"
},
{
"displayName": "Service Instance Sharing With Roles Restricted",
"name": "SERVICE_INSTANCE_ROLE_SHARE_ALLOWED",
"serviceType": "cfw_samplexaas_service",
"value": "false"
}
]
}

51.9.3.16 サービス・タイプのリクエスト設定の更新

サービス・タイプのリクエスト設定を更新するには、PUT操作を発行します。

表51-94 サービス・タイプに対するリクエスト設定を更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicetype/{servicetype}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Weeks",
"value": "4"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message": "\"Servicetype \" settings updated successfully."
}

51.9.3.17 ロール別のサービス・タイプ設定の詳細の表示

ロール別のサービス・タイプ設定の詳細を表示するには、GET操作を発行します。

表51-95 ロール別のサービス・タイプ設定の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicetype/{servicetype}/roles

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"items": [
{
"href":
"https://xx.idc.example.com:34518/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/r
equestsettings/servicetype/cfw_samplexaas_service/roles/TVMCFW_R3",
"name": "TVMCFW_R3"
}
],
"totalResults": 1
}

51.9.3.18 ロールのサービス・タイプ設定の作成

ロールのサービス・タイプ設定を作成するには、POST操作を発行します。

表51-96 ロールのサービス・タイプ設定を作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicetype/{servicetype}/roles

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"SERVICE_INSTANCE_USER_SHARE_ALLOWED": {
"value": "true"
},
"requestSettings": [
{
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Weeks",
"value": "14"
},
{
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Hours",
"value": "123"
},
{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Days",
"value": "121"
}
],
"role": "TVMCFW_R3"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"message": "\"Servicetype role \" settings created successfully."
}

51.9.3.19 特定のロールのサービス・タイプ・リクエスト設定の詳細の表示

特定のロールのサービス・タイプ・リクエスト設定の詳細を表示するには、GET操作を発行します。

表51-97 特定のロールに対するサービス・タイプ・リクエスト設定の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicetype/{servicetype}/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"requestSettings": [
{
"description": "This setting controls how far a user can make a request",
"displayName": "Future Reservation Length",
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R3",
"serviceType": "cfw_samplexaas_service",
"unitOfMeasurement": "Days",
"value": "121"
},
{
"description": "This setting controls the maximum duration for which a user can make a
request",
"displayName": "Request duration Length",
"name": "REQUEST_DURATION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R3",
"serviceType": "cfw_samplexaas_service",
"unitOfMeasurement": "Weeks",
"value": "14"
},
{
"description": "This setting controls the maximum duration after which archived requests
will be automatically deleted by the system",
"displayName": "Request Archive Retention Length",
"name": "REQUEST_ARCHIVE_RETENTION_LENGTH",
"restrictionPolicy": "Restricted",
"role": "TVMCFW_R3",
"serviceType": "cfw_samplexaas_service",
"unitOfMeasurement": "Hours",
"value": "123"
},
{
"description": "Sharing enabled/disabled",
"name": "SERVICE_INSTANCE_USER_SHARE_ALLOWED",
"value": "false"
},
{
"description": "Sharing enabled/disabled",
"name": "SERVICE_INSTANCE_ROLE_SHARE_ALLOWED",
"value": "false"
}
]
}

51.9.3.20 特定のロールのサービス・タイプ・リクエスト設定の更新

特定のロールのサービス・タイプ・リクエスト設定を更新するには、PUT操作を発行します。

表51-98 特定のロールに対するサービス・タイプ・リクエスト設定を更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicetype/{servicetype}/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "FUTURE_RESERVATION_LENGTH",
"restrictionPolicy": "Restricted",
"unitOfMeasurement": "Years",
"value": "75"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message": "\"Servicetype role \" settings updated successfully."
}

51.9.3.21 特定のロールのサービス・タイプ・リクエスト設定の削除

特定のロールのサービス・タイプ・リクエスト設定を削除するには、DELETE操作を発行します。

表51-99 特定のロールに対するサービス・タイプ・リクエスト設定を削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/setup/requestsettings/servicetype/{servicetype}/roles/{role}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"message": "\"Servicetype role \" settings deleted successfully."
}

51.10 V2のVMアダプタ

この項では、VMアダプタREST APIについて説明します。

51.10.1 VMアダプタ・データ・モデル

次の表に、VMアダプタ・データ・モデルを示します。

表51-100 VMアダプタ・データ・モデル

フィールド

タイプ

説明

name

文字列

リソースの名前。

type

文字列

リソースのタイプ。

totalResults

整数

合計結果。

items

List<VMAdapter>

VMアダプタのリスト

canonicalLink

CfwLink

このURIに対してGETリクエストを実行すると、このリソースのクライアント表現がリフレッシュされます。

selfLink

CfwLink

これを含む要素と同等のリソースを参照します。

51.10.2 サポートされている操作

次の表に、VMアダプタ・リソースでサポートされる操作を示します。

表51-101 VMアダプタでサポートされるメソッド

リクエスト・メソッド

正規のリンク

説明

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters

すべての登録済VMアダプタを返します。

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters/{name}

登録済VMアダプタの詳細を返します。

GET

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters/stagingservers

ステージング・サーバーを返します。

POST

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters/stagingservers

ステージング・サーバーを作成します。

51.10.3 V2のVMアダプタREST APIの例

この項では、VMアダプタ・リソースのREST APIについて説明します。次の操作について説明します。

- すべての登録済VMアダプタの詳細の表示

- 特定の登録済VMアダプタの詳細の表示

- ステージング・サーバーの詳細の表示

- ステージング・サーバーの作成

51.10.3.1 すべての登録済VMアダプタの詳細の表示

すべての登録済VMアダプタの詳細を表示するには、GET操作を発行します。

表51-102 すべての登録済VMアダプタの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{ "name":"VMAdapters",
"type":"VMAdaptersCollection",
"totalResults":1,
"items":[ { "id":"1",
"name":"SAMPLEADAPTER",
"displayName":"SampleAdapter",
"description":"SampleStand alone adapter",
"instances":{ "count":0, "href":"https://cloudcompany.com/em/websvcs/restful//extws/cloudservices/admin/cfw/v2/resourceproviders/?propertyname=adaptertype&propertyvalue=SAMPLEADAPTER" },
"canonicalLink":{ "href":"https://cloudcompany.com/em/websvcs/restful//extws/cloudservices/admin/cfw/v2/vmadapters/SAMPLEADAPTER" } } ],
"canonicalLink":{ "href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters/" }}

51.10.3.2 特定の登録済VMアダプタの詳細の表示

登録済VMアダプタの詳細を表示するには、GET操作を発行します。

表51-103 特定の登録済VMアダプタの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters/{name}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{ "name": "SAMPLEADAPTER",
"connection": { "endpoints": [ { "purpose": "login_url", "custom": [ { "name": "CloudType", "type": "STRING", "description": "CoudType, e.g. openstack, ec2, etc", "displayName": "CoudType", "required": false, "secret": false },
{ "name": "custom_param1", "type": "STRING", "description": "Custom parameter", "displayName": "Custom parameter", "required": false, "secret": false } ] } ], "virtualizationContainers": [ { "name": "Zone" } ] }, "proxies": [ {} ]}

51.10.3.3 ステージング・サーバーの詳細の表示

ステージング・サーバーの詳細を表示するには、GET操作を発行します。

表51-104 ステージング・サーバーの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters/stagingservers

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{ "name" : "StagingServers", "totalResults" : 1, "items" : [ { "location" : "script/location", "targetName" : "blr2223141.idc.oracle.com",
"targetGuid" : "5BC2376B484BC065B6661458DAF1F56D", "credentialGuid" : "25D30ADD427484310DBC8CF6211A383B" } ],
"canonicalLink" : { "href" : "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters/stagingservers" }}

51.10.3.4 ステージング・サーバーの作成

ステージング・サーバーを作成するには、POST操作を発行します。

表51-105 ステージング・サーバーを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/vmadapters/stagingservers

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{ "targetName" : "blr2223141.idc.oracle.com",
"location" : "script/location",
"credentialGuid" : "25D30ADD427484310DBC8CF6211A383B"}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{ "message" : "StagingServer created successfully."}

51.11 V1のSSA管理リソース

クラウドREST APIは次のように分類できます。

- コレクション・リソース

- V1のPaasZones

- V1のSoftwarePools

- V1のサービス・テンプレート管理

- 単一リソース

- V1のPaasZone

- V1のSoftwarePool

- V1のサービス・テンプレート管理

すべての単一リソースには、独自の属性とサポートされるメソッドがありますが、一般的に、すべての単一リソースには、次の表で説明する、いくつかの共通属性があります。

表51-106 単一リソースの共通リソース属性

フィールド

タイプ

サポートされるメソッド

説明

発生

name

文字列

Any

リソース名。

1

type

文字列

Any

リソース・タイプ。

1

description

文字列

Any

説明

0..1

id

文字列

GET

リソース識別子。

0..1

createdOn

タイムスタンプ

GET

リソースが作成された日付と時刻(W3C形式)。

0..1

createdBy

文字列

GET

リソースを作成したユーザー。

0..1

modifiedOn

タイムスタンプ

GET

リソースが最後に変更された日付と時刻(W3C形式)。

0..1

ModifiedBy

日付

GET

リソースを最後に変更したユーザー。

0..1

owner

文字列

GET

リソースを所有するユーザー。

0..1

etag

文字列

GET

HTTPエンティティ・タグの値。

0..1

lastModified

文字列

GET

HTTP Last-Modifiedの値。

0..1

canonicalLink

URI

GET

優先リソース・バージョン。

1

selfLink

URI

GET

これを含む要素と同等のリソースを参照します。

1

各項目の意味は次のとおりです。

- サポートされるメソッド: この属性が有効なメソッド・タイプ。

- サポートされるメソッド・タイプ、Any: GET、PUTまたはPOSTメソッドが使用でき、DELETEは使用できないことを意味します。

- 発生: 0..1は、オプションのパラメータであることを示します。1は、このパラメータが必須であることを意味します。

51.11.1 REST APIエントリ・ポイント・リソースの詳細の表示

次の表に、REST APIリソースの詳細を表示するためのGET構成を示します。

表51-107 REST APIリソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/API

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
v1:
{
canonicalLink:
"https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1"
paasZones: "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones"
softwarePools: "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools"
}
}

51.12 V1のPaasZones

PaasZonesは、すべてのアクセス可能なPaasZoneリソースのクラウド管理者ビューを表すコレクション・リソースです。次の表では、PaaSZones [application/oracle.com.cloud.common.PaaSZones+json]のデータ・モデルについて説明します。

表51-108 PaasZonesデータ・モデル

フィールド

タイプ

説明

発生

name

文字列

このコレクション・リソースの名前を表示します。

1

type

文字列

このコレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があることを示します。

1

count

整数

返される要素の数。

1

items

コレクション<PaasZone>

Paasゾーン・リソースのリスト。

インスタンスがない場合、itemsは空で表示されます。

1

totalCount

整数

Paasゾーン・リソースの合計数。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

次の表では、PaaSZonesでサポートされるメソッドについて説明します。

表51-109 PaasZonesでサポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

URI

説明

GET

該当せず

該当せず

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/

PaasZonesコレクション・リソースの詳細を返します。

GET/metadata

該当せず

該当せず

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/metadata

PaasZoneメタデータを返します。

PUT

該当せず

PaasZone (Jsonペイロード)

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/

PaasZoneリソースを更新します。

POST

該当せず

PaasZone (Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/paaszones/

PaasZoneリソースを作成します。

51.12.1 PaasZones REST APIの例

次の項に、PaasZones REST API操作の例を示します。EMCLIコマンドを使用して、様々な操作(作成、更新、削除操作など)を実行することもでき、これらのコマンドについては、第51.18.2項「V2のSSA操作用のEM CLI動詞」で説明されています。

この項では、次の操作について説明します。

- PaaSゾーン群メタデータの表示

- PaaSゾーン群のリスト

51.12.1.1 PaaSゾーン群メタデータの表示

次の表に、メタデータを表示するためのGET構成を示します。

表51-110 メタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/passzones/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
"constraints" : [ {
"name" : "MAX_CPU_UTILIZATION",
"description" : "Maximum CPU Utilization (%)",
"value" : "80"
}, {
"name" : "MAX_MEMORY_ALLOCATION",
"description" : "Maximum Memory Allocation (%)",
"value" : "80"
} ],
"memberTargetTypes" : [ "oracle_vm_zone", "host" ],
"message" : "When creating Paas Infrastructure zone: (1) member_type should be set to one of the values shown in member target types. All Zone members have to be of the same type. (2) Please change the value of the constraints as required."
}

51.12.1.2 PaaSゾーン群のリスト

次の表に、PaaSゾーン群をリストするためのGET構成を示します。

表51-111 PaaSゾーン群を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/passzones/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
"name" : "Paas Zones",
"type" : "Paas Infrastructure Zone",
"hasMore" : false,
"count" : 4,
"items" : [ {
"name" : "pzone1",
"id" : "A3CF2D49CFF3F3E664D073303EA51F8E",
"type" : "self_service_zone",
"canonicalLink" :
"https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/A3CF2D49CFF3F3E664D073303EA51F8E"
}, {
"name" : "Test Zone 2",
"id" : "EF3830C71CC54B50B963376F9217AB95",
"type" : "self_service_zone",
"description" : "with MAX_CPU_UTILIZATION ",
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/EF3830C71CC54B50B963376F9217AB95"
}, {
"name" : "test paas zone",
"id" : "5D7548C1B879A51CFD894CEA8D5FB19B",
"type" : "self_service_zone",
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/5D7548C1B879A51CFD894CEA8D5FB19B"
}, {
"name" : "Test Zone",
"id" : "CACBB07A674F280DF84FC4CBFA76DFA7",
"type" : "self_service_zone",
"description" : "with MAX_CPU_UTILIZATION ",
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/CACBB07A674F280DF84FC4CBFA76DFA7"
} ],
"totalCount" : 4,
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones",
"selfLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones"
}

51.13 V1のPaasZone

このリソースは、PaaSインフラストラクチャ・ゾーンを表します。次の表では、PaaSZone [application/oracle.com.cloud.common.PaaSZone+json]のデータ・モデルについて説明します。

表51-112 PaaSZoneデータ・モデル

フィールド

タイプ

サポートされるメソッド

説明

発生

name

文字列

Any

PaaSゾーンのユーザー用の名前。

これは編集できません。

1

id

文字列

GET

ゾーンID。GETメソッドに、この要素の値を含めます。

1

description

文字列

Any

ゾーンの簡単な説明。

0..1

credential

文字列

Any

このPaaSインフラストラクチャ・ゾーンでプロビジョニングに使用するグローバル名前付き資格証明。

1

members

コレクション<文字列>

GET

POST

PaaSゾーンのメンバー。ホスト・メンバーまたはOracle VMゾーン・メンバーにできます。

1

memberType

文字列

GET

POST

PaaSゾーンのメンバーのターゲット・タイプ。ホスト・メンバーの場合は「host」、Oracle VMゾーン・メンバーの場合は「oracle_vm_zone」にできます。

1

constraints

コレクション<EntityValueHolder>

Any

配置ポリシー制約を使用すると、クラウド管理者はどのホストにも最大しきい値を設定できます。

詳細は、ゾーン・メタデータREST APIを参照してください。

0..1

ロール

コレクション<文字列>

GET

POST

このPaaSインフラストラクチャ・ゾーンにアクセス可能なSSAロール。

0..1

pools

コレクション<SoftwarePool>

GET

このPaaSゾーンに関連付けられたソフトウェア・プール。

0..1

membersToAdd

コレクション<文字列>

PUT

編集時に既存のPaaSゾーンに追加するホスト・ターゲットまたはOracle VMゾーン・ターゲット。

0..1

membersToRemove

コレクション<文字列>

PUT

編集時に既存のPaaSゾーンから削除するホスト・ターゲットまたはOracle VMゾーン・ターゲット。

0..1

rolesToAdd

コレクション<文字列>

PUT

PaaSゾーンの編集時に追加するSSAロール。

0..1

rolesToRemove

コレクション<文字列>

PUT

PaaSゾーンの編集時に削除するSSAロール。

0..1

各項目の意味は次のとおりです。

- サポートされるメソッド: 値「Any」は、GET、POSTまたはPUTを意味します。
「サポートされるメソッド」列の値によっては、リクエスト・ペイロードで関連の属性を指定する必要があるか、または操作の完了後にレスポンス・ペイロードで有効になります。

たとえば、PUT操作を実行する場合、name、description、credential、membersToAdd、membersToRemove、constraints、rolesToAddおよびrolesToRemove属性をリクエスト・ペイロードで指定できます。

- PaasZoneのメンバー・タイプがoracle_vm_zoneの場合、constraints属性は定義しません。

- メンバー・タイプが「ホスト」の場合、MAX_CPU_UTILIZATIONおよびMAX_MEMORY_ALLOCATIONの2つ配置制約がPaasゾーンでサポートされます。これらを指定しない場合、デフォルト値は、80パーセントになります。

次の表では、PaaSZoneリソースでサポートされるメソッドについて説明します。

表51-113 PaaSZoneリソースでサポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

レスポンス・ペイロード

URI

説明

GET

このオプションの問合せパラメータで使用可能な値は次のとおりです。

- constraints

- pools

- members

- ロール

該当せず

PaasZone (Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/paaszones/{zoneId}

PaaSインフラストラクチャ・ゾーンの詳細を取得します。

DELETE

該当せず

該当せず

ステータス・メッセージ(Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/paaszones/{zoneId}

PaaSインフラストラクチャ・ゾーンを削除します。

51.13.1 PaaSゾーンREST APIの例

次の項に、PaasゾーンREST API操作の例を示します。EMCLIコマンドを使用して、PaaSゾーンに対する様々な操作(作成、更新、削除など)を実行することもでき、これらのコマンドについては、第51.18.2項「V2のSSA操作用のEM CLI動詞」で説明されています。

この項では、次の操作について説明します。

- PaaSゾーンの作成

- PaaSゾーンの更新

- PaaSゾーンの削除

- PaasZoneの詳細の表示

- PaasZoneからの展開形式の表示

51.13.1.1 PaaSゾーンの作成

次の表に、PaaSゾーンを作成するためのPOST構成を示します。

表51-114 PaaSゾーンを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/passzones/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name":"My Test Zone",
"description":"This is a TestZone",
"credential":"NCAIME",
"memberType":"host",
"members":[
"slc05gvt.us.example.com"
],
"constraints":[
{
"name":"MAX_CPU_UTILIZATION",
"value":"85"
},
{
"name":"MAX_MEMORY_ALLOCATION",
"value":"95"
}
],
"roles":[
"SSACOREROLE1",
"SSACOREROLE2"
],

}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Status 201 Created
Content-Type: application/json
{
"name" : "My Test Zone",
"description" : "This is a TestZone",
"type" : "PaaS Infrastructure Zone",
"id" : "DDBFEFDAD2AE6490E040F00AA37D4C67",
"credential" : "NCAIME",
"members" : {
"canonicalLink" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67/members",
"memberType" : "host",
"numberOfHostMembers" : "1"
},
"constraints" : {
"canonicalLink" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67/constraints",
"numberOfConstraints" : "2"
},
"roles" : {
"canonicalLink" :
"https://cloudcompany.com.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67/roles",
"numberOfUserRoles" : "2"
},
"pools" : {
"canonicalLink" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67/pools",
"numberOfSoftwarePools" : "0"
},
"createdOn" : "2013-05-27 20:57:18",
"createdBy" : null,
"modifiedOn" : null,
"modifiedBy" : null,
"owner" : "SYSMAN",
"etag" : null,
"lastModified" : null,
"canonicalLink" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67",
"selfLink" :
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67"
}

51.13.1.2 PaaSゾーンの更新

次の表に、PaaSゾーンを更新するためのPUT構成を示します。

表51-115 PaaSゾーンを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/passzones/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name":"My Test Zone",
"credential":"NCAIME2",
"description":"Description_01",
"membersToAdd":[
"somehost.com",
"someotherhost.com"
],
"membersToRemove":[
"removehost.com",
"removeotherhost2.com"
]
,
"rolesToAdd":[
"ROLE_1",
"ROLE_2"
],
"rolesToRemove":[
"ROLE_1_1",
"ROLE_2_1"
],
"constraints":[
{
"name":"MAX_MEMORY_ALLOCATION",
"value":"80"
},
{
"name":"MAX_CPU_UTILIZATION",
"value":"80"
}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
"message" : "PaaS Infrastructure Zone "My Test Zone" updated successfully."
}

51.13.1.3 PaaSゾーンの削除

次の表に、PaaSゾーンを削除するためのDELETE構成を示します。

表51-116 PaaSゾーンを削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/passzones/DDBFEFDAD2AE6490E040F00AA37D4C67

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
"message" : "PaaS Infrastructure Zone  "DDBFEFDAD2AE6490E040F00AA37D4C67" deleted    successfully."
}

注意:
PaaSインフラストラクチャ・ゾーンは、関連付けられているソフトウェア・プールがある場合、削除できません。

51.13.1.4 PaasZoneの詳細の表示

次の表に、PaaSゾーンの詳細を表示するためのGET構成を示します。

表51-117 PaaSゾーンの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/passzones/A3CF2D49CFF3F3E664D073303EA51F8E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
"name" : "pzone1",
"description" : "This zone contains Host members",
"type" : "PaaS Infrastructure Zone",
"id" : "A3CF2D49CFF3F3E664D073303EA51F8E",
"credential" : "SXAASJUNITHOSTCRED",
"members" : {
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/A3CF2D49CFF3F3E664D073303EA51F8E/members",
"memberType" : "host",
"numberOfHostMembers" : "2"
},
"constraints" : {
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/A3CF2D49CFF3F3E664D073303EA51F8E/constraints",
"numberOfConstraints" : "2"
},
"roles" : {
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/A3CF2D49CFF3F3E664D073303EA51F8E/roles",
"numberOfUserRoles" : "1"
},
"pools" : {
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/A3CF2D49CFF3F3E664D073303EA51F8E/pools",
"numberOfSoftwarePools" : "0"
},
"createdOn" : "2013-05-22 01:50:30",
"createdBy" : null,
"modifiedOn" : null,
"modifiedBy" : null,
"owner" : "SYSMAN",
"etag" : null,
"lastModified" : null,
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/A3CF2D49CFF3F3E664D073303EA51F8E",
"selfLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/A3CF2D49CFF3F3E664D073303EA51F8E"
}

51.13.1.5 PaasZoneからの展開形式の表示

Getリクエストは、問合せパラメータの展開をサポートしています。この問合せパラメータに基づき、PaasZoneの関連属性が展開されます。

次の問合せパラメータがサポートされています。

- members

- role

- constraints

- pools

次の表に、PaaSゾーンの展開されたビューに対するGET構成を示します。

表51-118 PaaSゾーンの展開されたビューに対するGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/passzones/{zone_id}/?expands=<param_name>

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "My Test Zone",
"description" : "Description_02",
"type" : "PaaS Infrastructure Zone",
"id" : "DDBFEFDAD2AE6490E040F00AA37D4C67",
"credential" : "C",
"members" : {
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67/members",
"memberType" : "host",
"numberOfHostMembers" : "1"
},
"constraints" : {
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67/constraints",
"items" : [ {
"name" : "MAX_MEMORY_ALLOCATION",
"value" : "25"
}, {
"name" : "MAX_CPU_UTILIZATION",
"value" : "25"
} ]
},
"roles" : {
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67/roles",
"numberOfUserRoles" : "0"
},
"pools" : {
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67/pools",
"numberOfSoftwarePools" : "0"
},
"createdOn" : "2013-05-27 20:57:18",
"createdBy" : null,
"modifiedOn" : null,
"modifiedBy" : null,
"owner" : "SYSMAN",
"etag" : null,
"lastModified" : null,
"canonicalLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67",
"selfLink" : "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/paaszones/DDBFEFDAD2AE6490E040F00AA37D4C67"
}

51.14 V1のSoftwarePools

SoftwarePoolsは、すべてのアクセス可能なSoftwarePoolリソースのSSA管理者ビューを表すコレクション・リソースです。次の表では、SoftwarePools [application/oracle.com.cloud.common.SoftwarePools+json]のデータ・モデルについて説明します。

表51-119 SoftwarePoolsデータ・モデル

フィールド

タイプ

説明

発生

name

文字列

このコレクション・リソースの名前を表示します。

1

type

文字列

このコレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があることを示します。

1

count

整数

返される要素の数。

1

items

コレクション<SoftwarePools>

このコレクションの要素。

1

totalCount

整数

このコレクションの要素の合計数。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

次の表では、SoftwarePoolsリソースでサポートされるメソッドについて説明します。

表51-120 SoftwarePoolsリソースでサポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

URI

説明

GET

zonename pooltype

該当せず

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/

既存のソフトウェア・プールのコレクションを返します。

PUT

該当せず

SoftwarePool (Jsonペイロード)

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/

既存のソフトウェア・プールのリソースを更新します。

POST

該当せず

SoftwarePool (Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/softwarepools/

ソフトウェア・プールを作成します。

51.14.1 ソフトウェア・プール群REST APIの例

次の項に、SoftwarePools REST API操作の例を示します。EMCLIコマンドを使用して、ソフトウェア・プール群に対する様々な操作(作成、更新、削除など)を実行することもでき、これらのコマンドについては、第51.18.2項「V2のSSA操作用のEM CLI動詞」で説明されています。

この項では、次の操作について説明します。

- ソフトウェア・プール群の詳細の表示

- 検索問合せパラメータに基づくフィルタリング出力

51.14.1.1 ソフトウェア・プール群の詳細の表示

次の表に、ソフトウェア・プール群の詳細を表示するためのGET構成を示します。

表51-121 ソフトウェア・プール群の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
name: "Software Pools"
type: "Software Pool"
hasMore: false
count: 2
items: [2]
0:  {
name: "IT_MW_Pool_2"
type: "mwaas_zone"
id: "E284FAAA7FBA6A06F7090115A3E07299"
zoneName: "IT_MW_Zone1"
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E284FAAA7FBA6A06F7090115A3E07299"
description: "Middleware Pool of Oracle Homes of Version 10.3.5.0"
}-
1:  {
name: "IT_MW_Pool1"
type: "mwaas_zone"
id: "DD73A46E9E3C9866E040F00AE5235A7F"
zoneName: "IT_MW_Zone1"
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/DD73A46E9E3C9866E040F00AE5235A7F"
description: "Middleware Pool of Oracle Homes"
}-
-
totalCount: 2
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/"
selfLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/"
}

51.14.1.2 検索問合せパラメータに基づくフィルタリング出力

ソフトウェア・プールの検索は、次の項目について、次の問合せパラメータによりサポートされます。

- zonename

- pooltype

一度に、単一または複数の検索パラメータを指定できます。「%」文字を使用するワイルド・カード検索もサポートされます。

次の表に、ソフトウェア・プール群をフィルタするためのGET構成を示します。

表51-122 ソフトウェア・プール群をフィルタするためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools?zonename=IT_MW%&pooltype=mwaas_zone

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
name: "Software Pools"
type: "Software Pool"
hasMore: false
count: 1
items: [1]
0:   {
name: "IT_MW_Pool1"
type: "mwaas_zone"
id: "DD73A46E9E3C9866E040F00AE5235A7F"
zoneName: "IT_MW_Zone1"
canonicalLink:
"https://cloudcompany/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/DD73A46E9E3C9866E040F00AE5235A7F"
description: "Middleware Pool of Oracle Homes"
}

totalCount:1
canonicalLink:
"https:// cloudcompany/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/"
selfLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/"
}

51.15 V1のSoftwarePool

SoftwarePoolリソースは、PaaSインフラストラクチャ・ゾーン内のリクエストのサービスに使用される同種のサーバーまたはクラスタのコレクションを表します。ソフトウェア・プール内のすべてのメンバーが、同一のタイプで、同一のPaaSインフラストラクチャ・ゾーンに属している必要があります。

また、同種性を維持するために、各メンバーは、ソフトウェア・プールへのメンバーの追加を制限する一連のフィルタ基準を満たす必要があります。次の表では、SoftwarePool [application/oracle.com.cloud.common.SoftwarePool+json]のデータ・モデルについて説明します。

表51-123 SoftwarePoolデータ・モデル

フィールド

タイプ

サポートされるメソッド

説明

発生

name

文字列

Any

ソフトウェア・プールのユーザー用の名前。

これは編集できません。

1

id

文字列

GET

リソースを一意に識別するプールGUID。

1

description

文字列

Any

サービス・テンプレートの簡単な説明。

0..1

poolTargetType

文字列

Any

作成するソフトウェア・プールのターゲット・タイプ。たとえば、ミドルウェア・プールの場合は"mwaas_zone"、データベース・プールの場合は"oracle_cloud_zone"、スキーマ・プールの場合は"schaas_pool"。

1

paasZone

文字列

GET

POST

このソフトウェア・プールに関連付けられているPaaSゾーンの名前。

1

members

コレクション<文字列>

GET

POST

PaaSゾーンのメンバー。ホスト・メンバーまたはOracle VMゾーン・メンバーにできます。

1

constraints

コレクション<EntityValueHolder>

Any

セルフ・サービス管理者がリソース使用率の上限を設定できるようにする、ソフトウェア・プールの配置制約。

0..1

filters

コレクション< EntityValueHolder >

GET

POST

設定条件によってソフトウェア・プールへのメンバー・ターゲットの追加を制限する、ソフトウェア・プール上のフィルタ。

1

properties

コレクション< EntityValueHolder >

Any

特定のプール・ターゲット・タイプで指定する必要がある追加プロパティ。

1

membersToAdd

コレクション<文字列>

PUT

編集時に既存のソフトウェア・プールに追加するターゲット。

0..1

membersToRemove

コレクション<文字列>

PUT

編集時に既存のソフトウェア・プールから削除するターゲット。

0..1

canonicalLink

URI

GET

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

注意:
サポートされるメソッドの値「Any」は、GET、POSTまたはPUTを意味します。

次の表では、ソフトウェア・プールのリソースでサポートされるメソッドについて説明します。

表51-124 ソフトウェア・プールのリソースでサポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

レスポンス・ペイロード

URI

説明

GET

param-name : expandsparam-value : members/ filters/ constraints/all

特定の属性を展開して、そのデータを表示します。

「all」ですべての属性が展開されます。

該当せず

SoftwarePool (Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/softwarepool/{poolId}

ソフトウェア・プール詳細を取得します。

DELETE

該当せず

該当せず

ステータス・メッセージ(Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/softwarepool/{poolId}

ソフトウェア・プールを削除します。

51.15.1 SoftwarePool REST APIの例

次の項に、SoftwarePool REST API操作の例を示します。EMCLIコマンドを使用して、ソフトウェア・プールに対する様々な操作(作成、更新、削除操作など)を実行することもでき、これらのコマンドについては、第51.18.2項「V2のSSA操作用のEM CLI動詞」で説明されています。

この項では、次の操作について説明します。

- ソフトウェア・プールの作成

- ソフトウェア・プールの更新

- ソフトウェア・プールの削除

- ソフトウェア・プールの詳細の表示

- 問合せパラメータの展開

51.15.1.1 ソフトウェア・プールの作成

ソフトウェア・プールを作成するには、ソフトウェア・プール・コレクション・リソースに対しPOST操作を発行します。

次の表に、ソフトウェア・プールを作成するためのPOST構成を示します。

表51-125 ソフトウェア・プールを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "IT_MW_Pool1",
"poolTargetType": "mwaas_zone",
"description": "Middleware Pool of Oracle Homes",
"paasZone": "IT_MW_Zone1",
"members": ["WebLogicServer10_3_6_0_slc01afx_6775","WebLogicServer10_3_6_0_adc2201439_4731"],
"constraints":
{"items": [{"name": "MAX_INSTANCES", "value": "10"}]},
"filters":
{"items": [{"name": "VERSION","value": "10.3.6.0"}]}
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Status 201 Created
Content-Type: application/json
{
name: "IT_MW_Pool1"
description: "Middleware Pool of Oracle Homes"
type: "Middleware Pool"
id: "687FE169ED3556CED38D11DC9BDD5CCD"
zoneName: "IT_MW_Zone1"
members: {
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/members"
numberOfPoolMembers: "2"
}-
constraints: {
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/constraints"
numberOfConstraints: "1"
}-
filters: {
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/filters"
numberOfFilters: "1"
}-
properties: {
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/properties"
numberOfPropertiess: "0"
}-
createdOn: "2013-05-24 00:26:42"
createdBy: null
modifiedOn: null
modifiedBy: null
owner: "CLOUD_ADMIN1"
etag: null
lastModified: null
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD"
selfLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD"
}

51.15.1.2 ソフトウェア・プールの更新

次の表に、ソフトウェア・プールを更新するためのPUT構成を示します。

表51-126 ソフトウェア・プールを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name": "IT_MW_Pool1",
"poolTargetType": "mwaas_zone",
"description": "Middleware Pool of Oracle Homes Updated",
"membersToAdd": ["WebLogicServer10_3_6_0_slc01afx_6776","WebLogicServer10_3_6_0_adc2201439_4732"],
"constraints":
{"items": [{"name": "MAX_INSTANCES", "value": "10"}]},
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
message: "Software Pool  " IT_MW_Pool1" updated successfully."
}

51.15.1.3 ソフトウェア・プールの削除

次の表に、ソフトウェア・プールを削除するためのDELETE構成を示します。

表51-127 ソフトウェア・プールを削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
message: "Software Pool "687FE169ED3556CED38D11DC9BDD5CCD" deleted successfully."
}

注意:
ソフトウェア・プールは、そのプールに関連付けられているサービス・テンプレートがある場合、削除できません。

51.15.1.4 ソフトウェア・プールの詳細の表示

次の表に、ソフトウェア・プールの詳細を表示するためのGET構成を示します。

表51-128 ソフトウェア・プールの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
name: "IT_MW_Pool1"
description: "Middleware Pool of Oracle Homes"
type: "Middleware Pool"
id: "687FE169ED3556CED38D11DC9BDD5CCD"
zoneName: "IT_MW_Zone1"
members: {
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/members"
numberOfPoolMembers: "2"
}-
constraints: {
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/constraints"
numberOfConstraints: "1"
}-
filters: {
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/filters"
numberOfFilters: "1"
}-
properties: {
canonicalLink: https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/properties"
numberOfPropertiess: "0"
}-
createdOn: "2013-05-24 00:26:42"
createdBy: null
modifiedOn: null
modifiedBy: null
owner: "CLOUD_ADMIN1"
etag: null
lastModified: null
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD"
selfLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD"
}

51.15.1.5 問合せパラメータの展開

SoftwarePoolリソースに対するGET操作では、次のリンク・リソース属性を展開する展開問合せパラメータがサポートされます。

- members: メンバー属性を展開して、このソフトウェア・プールのすべてのメンバーを表示します。

- filters: フィルタ属性を展開して、このソフトウェア・プールのメンバーのフィルタ基準を表示します。

- constraints: 制約属性を展開して、このソフトウェア・プールに関連付けられた配置制約を表示します。

- all : ソフトウェア・プール詳細が返される際、ソフトウェア・プールのすべての属性が展開されます。

URIの書式は、次のとおりです。

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/{poolid}/?expands=<paramname>

例:

https://hostname/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD?expands=members

問合せパラメータを指定しない場合、ソフトウェア・プール詳細データは属性を展開せずにユーザーに返されます。

51.15.2 V1のSoftwarePoolMetadata

ソフトウェア・プールの作成時に必要なすべてのソフトウェア・プール・ターゲット・タイプのメタデータ情報を示します。次の表では、SoftwarePoolMetadata [application/oracle.com.cloud.common.SoftwarePools+json]のデータ・モデルについて説明します。

表51-129 SoftwarePoolMetadataデータ・モデル

フィールド

タイプ

説明

発生

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

poolType

文字列

ソフトウェア・プールのターゲット・タイプ。

1

poolTypeDisplayName

文字列

ソフトウェア・プールのターゲット・タイプの名前を示します。

0..1

poolTypeDescription

文字列

ソフトウェア・プールのターゲット・タイプの説明。

0..1

serviceFamily

文字列

このプール・タイプが属するサービス・ファミリを表します。

1

serviceType

文字列

このプール・タイプが属するサービス・タイプを表します。

1

constraints

コレクション<ValueDescriptor>

このプール・タイプに使用可能な配置制約に関するメタデータ情報を表します。

0..1

filters

コレクション< ValueDescriptor >

このプール・タイプに使用可能なフィルタ(メンバー制約)に関するメタデータ情報を表します。

0..1

SupportedPoolMetadataリソースのGETメソッドには次の特性があります。

- レスポンス・ペイロード:
SoftwarePoolMetadata (Jsonペイロード)

- URI:
em/websvcs/restful//extws/cloudservices/admin/cfw/v1/softwarepools/metadata

- 説明:
サービス・タイプ、サービス・ファミリ、使用可能な制約および使用可能なフィルタなど、すべてのソフトウェア・プール・タイプのメタデータ情報を取得します。

51.15.2.1 ソフトウェア・プール・メタデータREST APIの取得例

SoftwarePoolMetadata URIを取得するためにGETリクエストが発行され、このURIは、その後、すべてのソフトウェア・プール・タイプのメタデータ情報を取得するために使用されます。EMCLIコマンドを使用して、ソフトウェア・プール情報を取得することもでき、これらのコマンドについては、第51.18.2項「V2のSSA操作用のEM CLI動詞」で説明されています。

次の表に、ソフトウェア・プール群のメタデータを表示するためのGET構成を示します。

表51-130 ソフトウェア・プール群のメタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json

{
softwarePoolsMetadata:
{
items: [1]
0:
{
poolType: "mwaas_zone"
poolTypeDisplayName: "Middleware Pool"
poolTypeDescription: "Middleware Pool is a set of homogeneous Middleware Oracle Homes."
serviceFamily: "MWAAS"
serviceType: "PhysicalWLS"
constraints:
{
items: [1]
0:
{
name: "MAX_INSTANCES"
description: "Maximum Number of Java Servers (per host)"
defaultValue: "1"
isRequiredValue: true
}
}
filters:
{
items: [1]
0:
{
name: "VERSION"
description: "Version"
defaultValue: "10.3.5.0"
isRequiredValue: true
possibleValues: [7]
0:
{value: "12.1.1.0"
description: "12.1.1.0"}
1:
{
value: "10.3.6.0"
description: "10.3.6.0"
}
2:
{
value: "10.3.5.0"
description: "10.3.5.0"
}
3:
{
value: "10.3.4.0"
description: "10.3.4.0"
}
4:
{
value: "10.3.3.0"
description: "10.3.3.0"
}
5:
{
value: "10.3.2.0"
description: "10.3.2.0"
}
6:
{
value: "10.3.1.0"
description: "10.3.1.0"
}
}
}
}
}
canonicalLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/metadata"
}

51.15.3 V1のSoftwarePoolFilteredTargets

指定されたフィルタ基準に基づき、指定されたPaaSインフラストラクチャ・ゾーン内の有効なターゲットを表示します。これは、SoftwarePoolリソースへのPOST操作では使用できません。次の表では、SoftwarePoolFilteredTargets [application/oracle.com.cloud.common.SoftwarePoolFilteredTargets+json]のデータ・モデルについて説明します。

表51-131 SoftwarePoolFilteredTargetsデータ・モデル

フィールド

タイプ

説明

発生

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

targetType

文字列

ソフトウェア・プールのターゲット・タイプ。例: ミドルウェア・プールの場合は"mwaas_zone"、データベース・プールの場合は"oracle_cloud_zone"、スキーマ・プールの場合は"schaas_pool"。プール・ターゲット・タイプで使用可能なフィルタを取得する場合は、SoftwarePoolsMetadataリソースを参照してください。[POST]

1

paasZone

文字列

フィルタ基準を表すPaaSゾーンの名前。

[POST]

1

targets

マップ<文字列, リスト<文字列>>

フィルタ基準適用後のフィルタ処理済ターゲット。

1

filters

コレクション<フィルタ>

フィルタ処理済ターゲットを取得するために適用する必要があるフィルタ基準。プール・ターゲット・タイプで使用可能なフィルタを取得する場合は、SoftwarePoolsMetadataリソースを参照してください。[POST]

1

フィルタ処理済ターゲットは、次の条件を満たします。

- 指定されたPaaSインフラストラクチャ・ゾーンの一部です。

- 渡されたフィルタ基準を満たしています。

- 他のソフトウェア・プールに属していません。

SupportedPoolFilteredTargetsリソースのPOSTメソッドには次の特性があります。

- リクエスト・ペイロード:
SoftwarePoolFilteredTargets (Jsonペイロード)

- レスポンス・ペイロード
SoftwarePoolFilteredTargets (Jsonペイロード)

- URI:
em/websvcs/restful//extws/cloudservices/admin/cfw/v1/softwarepools/filteredtargets

- 説明:
サービス・タイプ、サービス・ファミリ、使用可能な制約および使用可能なフィルタなど、すべてのソフトウェア・プール・タイプのメタデータ情報を取得します。

51.15.3.1 使用可能なフィルタ処理済ターゲット取得 - REST APIの例

指定したPaasゾーンおよびフィルタに基づいてフィルタ処理済ターゲットをフェッチするには、SoftwarePoolFilteredTargetsリソースに対しPOST操作を発行します。EMCLIコマンドを使用して、フィルタ処理済ターゲット情報を取得することもでき、これらのコマンドについては、第51.18.2項「V2のSSA操作用のEM CLI動詞」で説明されています。

次の表に、ソフトウェア・プール群のフィルタ処理済ターゲットを表示するためのPOST構成を示します。

表51-132 ソフトウェア・プール群のメタデータを表示するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: applicaiton/json

本文

{
"targetType": "mwaas_zone",
"paasZone": "IT_MW_Zone1",
"filters": {"items": [{"name": "VERSION", "value": "10.3.6.0"}]}
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Status 201 Created
Content-Type: application/json

{
targets: {
oracle_home: [2]
0:  "WebLogicServer10_3_6_0_slc01afx_6775"
1:  "WebLogicServer10_3_6_0_adc2201439_4731"
}
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/filteredtargets"
}

51.15.4 V1のSoftwarePoolCapacity

このリソースは、プール・エンティティのCPU使用率、メモリー割当て、インスタンス数などの、ソフトウェア・プール容量の詳細を取得します。次の表では、SoftwarePoolCapacity [application/oracle.com.cloud.common.SoftwarePoolCapacity+json]のデータ・モデルについて説明します。

表51-133 SoftwarePoolCapacityデータ・モデル

フィールド

タイプ

説明

発生

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

name

文字列

ソフトウェア・プールの名前。

[POST]

1

type

文字列

ソフトウェア・プールのターゲット・タイプ。例: ミドルウェア・プールの場合は"mwaas_zone"、データベース・プールの場合は"oracle_cloud_zone"、スキーマ・プールの場合は"schaas_pool"。

1

capacity

コレクション<フィルタ>

フィルタ処理済ターゲットを取得するために適用する必要があるフィルタ基準。プール・ターゲット・タイプで使用可能なフィルタを取得する場合は、SoftwarePoolsMetadataリソースを参照してください。[POST]

1

SupportedPoolCapacityリソースのGETメソッドには次の特性があります。

- レスポンス・ペイロード
SoftwarePoolCapacity (Jsonペイロード)

- URI:
em/websvcs/restful//extws/cloudservices/admin/cfw/v1/softwarepools/{poolId}/capacity

- 説明:
ソフトウェア・プール容量の詳細を取得します。

51.15.4.1 ソフトウェア・プール容量の取得

ソフトウェア・プール容量の詳細を取得するには、SoftwarePoolCapacityリソースに対しGETを発行します。EMCLIコマンドを使用して、ソフトウェア・プール容量情報を取得することもでき、これらのコマンドについては、第51.18.2項「V2のSSA操作用のEM CLI動詞」で説明されています。

次の表に、ソフトウェア・プール容量を表示するためのGET構成を示します。

表51-134 ソフトウェア・プール容量を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/687FE169ED3556CED38D11DC9BDD5CCD/capacity

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{
name: "mySchemaPool"
type: "schaas_pool"
capacity: {
items: [1]
0:  {
entityName: "Oemrep_Database"
entityType: "oracle_database"
entityCapacity: {
items: [4]
0:  {
resourceType: "Storage Utilization"
resourceUsed: "64.74"
resourceThreshold: "100.0"
resourceUnit: "%"
}-
1:  {
resourceType: "CPU Utilization"
resourceUsed: "0.0"
resourceThreshold: "0.0"
resourceUnit: "%"
}-
2:  {
resourceType: "Memory Utilization"
resourceUsed: "0.0"
resourceThreshold: "0.0"
resourceUnit: "%"
}-
3:  {
resourceType: "Instances"
resourceUsed: "0"
resourceThreshold: "100"
}-
-
}-
}-
-
}-
canonicalLink:
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2E7C9C632B18C3FEB4FEA5A614E51BE7/capacity"
}

51.16 V1のコンポジット・リソース属性

この仕様のいくつかのリソース・エンティティには、次のコンポジット・リソース属性が含まれています。

- V1のValueDescriptor

- V1のValueEntity

- V1のEntityValueHolder

- V1のPoolEntityCapacity

- V1のResourceTypeCapacity

51.16.1 V1のValueDescriptor

関連付けられたオブジェクトに設定可能な値のタイプに関するメタデータを説明します。次の表で、このデータ・モデルについて説明します。

表51-135 ValueDescriptorデータ・モデル

フィールド

タイプ

説明

発生

name

文字列

記述するデータの名前

1

description

文字列

記述するデータの説明

1

defaultValue

文字列

記述するデータのデフォルト値

1

isRequiredValue

Boolean

値が必要な場合はTRUE

1

possibleValues

コレクション<ValueEntity>

記述するデータの有効な値のリスト(オプション)

0..1

51.16.2 V1のValueEntity

値(文字列表現)およびその説明(キャプション)を表します。次の表で、このデータ・モデルについて説明します。

表51-136 ValueEntityデータ・モデル

フィールド

タイプ

説明

発生

value

文字列

エンティティの実際値の文字列表現

1

description

文字列

エンティティを説明するエンティティのキャプション

0..1

51.16.3 V1のEntityValueHolder

名前、値および説明を持つ単一のエントリを表します。次の表で、このデータ・モデルについて説明します。

表51-137 EntityValueHolderデータ・モデル

フィールド

タイプ

説明

発生

name

文字列

エンティティの名前

1

value

文字列

エンティティの実際値の文字列表現

1

description

文字列

エンティティを説明するエンティティのキャプション

0..1

51.16.4 V1のPoolEntityCapacity

ソフトウェア・プールの個別のエンティティの容量の詳細を表します。次の表で、このデータ・モデルについて説明します。

表51-138 PoolEntityCapacityデータ・モデル

フィールド

タイプ

説明

発生

entityName

文字列

エンティティの名前

1

entityType

文字列

エンティティのターゲット・タイプ

1

entityCapacity

コレクション<ResourceTypeCapacity>

記憶域使用率、CPU使用率など、特定のリソース・タイプの容量の詳細のコレクション

1

51.16.5 V1のResourceTypeCapacity

記憶域使用率、CPU使用率など、特定のリソース・タイプの容量の詳細を表します。次の表で、このデータ・モデルについて説明します。

表51-139 ResourceTypeCapacityデータ・モデル

フィールド

タイプ

説明

発生

resourceType

文字列

記憶域使用率などのリソースのタイプ

1

resourceUsed

文字列

使用済リソースの文字列表現

1

resourceThreshold

文字列

リソースしきい値の文字列表現

0..1

resourceUnit

文字列

リソースの使用率を測定する単位の文字列表現

0..1

51.17 V1のサービス・テンプレート管理

この項では、サービス・テンプレートを管理するために使用できるリソースおよびREST APIについて説明します。

51.17.1 V1のサービス・テンプレート群

サービス・テンプレート群は、すべてのアクセス可能なサービス・テンプレート・リソースのクラウド管理者ビューを表すコレクション・リソースです。次の表では、サービス・テンプレート・データ・モデルについて説明します。

表51-140 サービス・テンプレート・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

このコレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプ。

1

hasMore

Boolean

このコレクション・リソースに他の要素があるかどうかを示します。

1

count

整数

コレクション・リソースの要素数。

1

items

コレクション<integer>

サービス・テンプレート・リソースのリスト。サービス・テンプレートが存在しない場合、このフィールドは空白になります。

1

totalCount

整数

サービス・テンプレート・リソースの合計数。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

51.17.1.1 ServiceTemplatesリソースでサポートされるメソッド

次の表では、ServiceTemplatesリソースでサポートされるメソッドについて説明します。

表51-141 ServiceTemplatesリソースでサポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

URI

説明

GET

該当せず

該当せず

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/

すべてのサービス・タイプのサービス・テンプレート・コレクション・リソースの詳細を返します。

POST

該当せず

サービス・テンプレート(Jsonペイロード)

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/

サービス・テンプレートのインスタンスを作成します。

51.17.1.2 ServiceTemplates REST APIの例

ServiceTemplates REST API操作の例を次に示します。

サービス・テンプレートのリスト

すべてのサービス・テンプレートをリストするには、ServiceTemplatesリソースに対してGETリクエストを発行します。

次の表に、ソフトウェア・プール容量を表示するためのGET構成を示します。

表51-142 すべてのサービス・テンプレート群を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
{

"name":"Service Templates",
"type":"Service Template",
"hasMore":false,
"items":[
{
"id":"E821074692058B5DE040F00AA37D75AB",
"name":"ST_DB_SCH_01",
"serviceFamily":"DBAAS",
"description":"Database Schema Service Template",
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws
/cloudservices/admin/cfw/v1/servicetemplates/E821074692058B5DE040F00AA37D75AB"
}
],
"totalCount":1,
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws
/cloudservices/admin/cfw/v1/servicetemplates"
}

51.17.2 V1のサービス・テンプレート

サービス・テンプレートは、セルフ・サービス・ユーザーがサービス・インスタンスをプロビジョニングするときに使用できる、標準化されたサービスの定義です。次の表では、サービス・テンプレートについて説明します。

表51-143 ServiceTemplateデータ・モデル

フィールド

タイプ

サポートされるメソッド

説明

発生

name

文字列

Any

サービス・テンプレートのユーザー用の名前。このフィールドは編集できません。

1

serviceFamily

文字列

Any

サービス・ファミリ。

1

serviceType

文字列

Any

サービス・タイプ

1

id

文字列

GET

サービス・テンプレートID。GETメソッドは、この要素用の値を含みます。

1

description

文字列

Any

サービス・テンプレートの簡単な説明。

0..1

ロール

コレクション<ロール>

GET

POST

テンプレートにアクセスできるSSAロール。

0..1

poolIds

コレクション<文字列>

POST

このテンプレートに関連付けられたソフトウェア・プールID。

1

serviceExecutableMeta

ServiceExecutableMetaDataEntity

Any

サービス・テンプレートで使用されるサービス実行可能ファイル。

0..1

createdOn

文字列(日付/時刻)

GET

リソースが作成された日付と時刻。

0..1

createdBy

文字列

GET

リソースを作成したユーザー。

1

modifiedOn

文字列(日付/時刻)

GET

リソースが変更された日付と時刻。

0..1

modifiedBy

文字列

GET

リソースを変更したユーザー。

1

owner

文字列

GET

リソースを所有するユーザー。

1

etag

文字列

GET

HTTPエンティティ値のタグ。

0..1

lastModified

文字列

GET

HTTPの最後に変更された値

0..1

canonicalLink

URI

GET

優先リソース・バージョン。

1

ここで、

- サポートされるメソッド:

- この属性を利用できるメソッド・タイプを示します。

- メソッド・タイプAnyは、このリソースをGET、PUTまたはPOSTメソッドで使用できることを示します。

- 発生: 0..1は、オプションのパラメータであることを示します。1は、このパラメータが必須であることを意味します。

51.17.2.1 ServiceTemplateリソースでサポートされるメソッド

次の表では、servicetemplatesリソースでサポートされるメソッドについて説明します。

表51-144 ServiceTemplateリソースでサポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

レスポンス・ペイロード

URI

説明

GET

該当せず

サービス・テンプレート(Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/servicetemplates/{serviceFamily}/{template id}

サービス・テンプレートの詳細を取得します。

DELETE

該当せず

該当せず

ステータス・メッセージ(Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/servicetemplates/<serviceFamily>/{template id}

サービス・テンプレートを削除します。

PUT

該当せず

サービス・テンプレート(Jsonペイロード)

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/<serviceFamily>/{template id}

サービス・テンプレート・リソースを更新します。

51.17.3 V1のServiceTemplateUpdate

次の表で、ServiceTemplateUpdateデータ・モデルについて説明します。

表51-145 ServiceTemplateUpdateデータ・モデル

フィールド

タイプ

サポートされるメソッド

説明

発生

description

文字列

PUT

サービス・テンプレートの簡単な説明。

0..1

rolesAdded

コレクション<ロール>

PUT

このサービス・テンプレートにアクセスできる、追加するSSAロール。

0..1

rolesRemoved

コレクション<ロール>

PUT

このサービス・テンプレートにアクセスできる、削除するSSAロール。

0..1

poolsIdsAdded

コレクション<文字列>

PUT

既存のテンプレートの編集時に追加されるソフトウェア・プールID。

0..1

poolsIdsRemoved

コレクション<文字列>

PUT

既存のテンプレートの編集時に削除されるソフトウェア・プールID。

0..1

executableEntity

ServiceExecutableMetaDataEntity

PUT

サービス・テンプレートで使用されるサービス実行可能ファイル。

0..1

51.17.4 V1のServiceExecutableMetaEntity

次の表で、ServiceExecutableMetaEntityデータ・モデルについて説明します。

表51-146 ServiceExecutableMetaDataEntity

フィールド

タイプ

説明

name

文字列

実際の実行可能ファイルをEnterprise Managerに保存するために使用される実行可能ファイルの名前。ジョブ、構成済デプロイメント・プロシージャ、デプロイメント・プロシージャまたはプロファイルの名前です。このフィールドは編集できません。

type

文字列

これには次のものがあります。

- Job

- DP

- CDP

- Profile

serviceFamily

文字列

サービス・ファミリ。

serviceType

文字列

サービス・タイプ

configurations

コレクション<TemplateConfigParam>

実行可能パラメータ

payloads

コレクション<PayloadDescriptor>

ペイロード記述子のコレクション。

51.17.5 V1のテンプレート構成パラメータ

次の表で、TemplateConfigParamデータ・モデルについて説明します。

表51-147 構成パラメータ

フィールド

タイプ

説明

id

文字列

構成パラメータのID。

name

文字列

構成パラメータの名前

value

文字列

構成パラメータの値。

values

コレクション<文字列>

構成パラメータの値のリスト。

description

文字列

構成パラメータの説明。

required

boolean

パラメータが必須かどうかを示すブール。

secret

boolean

パラメータが秘密かどうかを示すブール。

subconfigurations

コレクション<TemplateConfigParam>

設定可能な値のセット。

51.17.6 V1のPayloadDescriptor

次の表で、PayloadDescriptorデータ・モデルについて説明します。

表51-148 PaylodDescriptorデータ・モデル

フィールド

タイプ

説明

name

文字列

ペイロード・エンティティの名前。

id

文字列

ペイロード・エンティティのID。

51.17.7 V1のServiceTemplateメタデータ

ServiceTemplateメタデータは、サービス・テンプレート・インスタンスを作成するために必要なJSONペイロードを生成するために使用します。次の表で、ServiceTemplateメタデータ・データ・モデルについて説明します。

表51-149 ServiceTemplateメタデータ・データ・モデル

フィールド

タイプ

説明

serviceFamily

文字列

サービス・ファミリの名前。

serviceType

文字列

サービス・タイプの名前。

type

文字列

次のいずれかです。

JOB

DP

CDP

PROFILE

description

文字列

説明

payload

Boolean

ペイロードが予想される場合はtrueです。

payloads

コレクション<PayloadMetaData>

パラメータが必須かどうかを示すブール。

51.17.8 V1のPayloadMetaData

次の表で、PayloadMetadataについて説明します。

表51-150 PayloadMetaData

フィールド

タイプ

説明

id

文字列

ペイロードID。

name

文字列

ペイロードの名前

defaultValue

文字列

デフォルト値。

51.17.9 V1のServiceTemplateメタデータ

次の表では、ServiceTemplateMetaDataでサポートされるメソッドについて説明します。

表51-151 ServiceTemplateMetaDataでサポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

レスポンス・ペイロード

URI

説明

GET

該当せず

コレクション<ServiceTemplateMetaData> (Jsonペイロード)

em/websvcs/restful//extws/cloudservices/admin/cfw/v1/servicetemplates/{serviceFamily}/executable/metadata

CDPやDPなどの特定のサービス・ファミリおよびサービス・タイプのメタデータを取得します。

POST

サービス・テンプレート・メタデータ(Jsonペイロード)

ServiceExecutableMetaEntity (Jsonペイロード)

em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/metadata

POSTされたサービス・ファミリおよびサービス・タイプの構成を取得します。

51.17.10 ServiceTemplates REST APIの例

この項では、ServiceTemplates REST API操作の例を示します。

- サービス・テンプレートの作成

- サービス・テンプレートの更新

- サービス・テンプレートの削除

- サービス・テンプレートの詳細の表示

- サービス・テンプレートのメタデータの表示

- サービス・テンプレートの構成値の作成

51.17.10.1 サービス・テンプレートの作成

次の表に、サービス・テンプレートを作成するためのPOST構成を示します。

表51-152 サービス・テンプレートを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{

"name":"TestSchaasTemplate3",
"serviceType":"SCHEMA",
"serviceFamily":"DBAAS",
"description":"This is a test schaas service template 1",
"poolIds":[
"FC129EEFFD67CD948B3147D2BAE0BA89"
],

"roles":[
{
"name":"SSA01"
}
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{

"name":"ROLE_NAME", "value":"SampleRole"
},
{
"name":"MAX_NUMBER_OF_SCHEMAS","value":"2"
},
{
"name":"ENFORCE_STORAGE_CONSTRAINT","value":"NO_LIMIT"
},
{
"name":"AUTO_EXTEND_BLOCK_SIZE","value":"1024"
},
{
"name":"REF_ZONE","value":"blr zone"
},
{
"name":"REF_POOL","value":"schpool"
},
{
"name":"REF_HOST","value":"mycompanyhost.com"
},
{
"name":"REF_DB","value":"Database"
},
{
"name":"CREATE_SCHEMA_OPTION","value":"EMPTY_SCHEMAS"
},
{
"name":"WORKLOADS",
"subconfigurations":[
{
"name":"WORK_LOADS:1",
"subconfigurations":[
{
"name":"name",
"value":"Small"
},
{
"name":"description",
"value":"small workload"
},
{
"name":"default",
"value":"Y"
},
{
"name":"CPU",
"value":"2"
},
{
"name":"Memory",
"value":"2048"
},
{
"name":"Storage",
"value":"1024"
}
]
},
{
"name":"WORK_LOADS:2",
"subconfigurations":[
{
"name":"name",
"value":"large "
},
{
"name":"description",
"value":"large workload"
},
{
"name":"default",
"value":"Y"
},
{
"name":"CPU",
"value":"6"
},
{
"name":"Memory",
"value":"4048"
},
{
"name":"Storage",
"value":"2024"
}
]
}
]
}
]
}
}

リクエスト・メソッド

POST

51.17.10.2 サービス・テンプレートの更新

次の表に、サービス・テンプレートを更新するためのPUT構成を示します。

表51-153 サービス・テンプレートを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"description":"Service Template",
"rolesAdded":[
{
"name": "SSA02"
}
],
"rolesRemoved":[
{
"name": "SSA01"
}
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{
"name":"REF_ZONE",
"value":"blr zone"
},
{
"name":"REF_POOL",
"value":"schpool"
},
{
"name":"REF_HOST",
"value":"mycompanyhost.com"
}
]
}
}

リクエスト・メソッド

PUT

51.17.10.3 サービス・テンプレートの削除

次の表に、サービス・テンプレートを削除するためのDELETE構成を示します。

表51-154 サービス・テンプレートを削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/687FE169ED3556CED38D11DC9BDD5CCD

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

51.17.10.4 サービス・テンプレートの詳細の表示

次の表に、サービス・テンプレートの詳細を表示するためのGET構成を示します。

表51-155 サービス・テンプレートを削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/687FE169ED3556CED38D11DC9BDD5CCD

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK

Content-Type: application/json
{
"name" : "ST_DB_SCH_01",
"serviceFamily" : "DBAAS",
"serviceType" : "SCHEMA",
"type" : "Service Template",
"description" : "Database Schema Service Template",
"id" : "E821074692058B5DE040F00AA37D75AB",
"pools" : [ {
"name" : "SP_DB_SCH_01",
"id" : "EBECE6B8F0144BEFAB2F1991B4AFCC65",
"type" : "schaas_pool",
"zone" : {
"id" : "E82022FF954B98CFE040F00AA37D447B",
"name" : "PZ01"
}
} ],
"serviceExecutableMeta" : {
"type" : "CDP",
"configurations" : [ {
"id" : "targets",
"name" : "targets",
"value" : ""
}, {
"id" : "ssaRequestId",
"name" : "ssaRequestId",
"value" : ""
}, {
"id" : "ssaUser",
"name" : "ssaUser",
"value" : ""
}, {
"id" : "ssaTargetName",
"name" : "ssaTargetName",
"value" : ""
}, {
"id" : "ssaTargetType",
"name" : "ssaTargetType",
"value" : ""
}, {
"id" : "zoneTargetName",
"name" : "zoneTargetName",
"value" : ""
}, {
"id" : "zoneTargetType",
"name" : "zoneTargetType",
"value" : ""
}, {
"id" : "REQUEST_NAME",
"name" : "REQUEST_NAME",
"value" : ""
}, {
"id" : "SERV_TEMPLATE_GUID",
"name" : "SERV_TEMPLATE_GUID",
"value" : ""
}, {
"id" : "CREATE_SCHEMA_OPTION",
"name" : "Option for creating user schemas",
"value" : "EMPTY_SCHEMAS"
}, {
"id" : "MAX_NUMBER_OF_SCHEMAS",
"name" : "Maximum number of schemas permissible",
"value" : "4"
}, {
"id" : "DB_PROFILE_URN",
"name" : "Database Profile Component's URN",
"value" : ""
}, {
"id" : "REMAP_SCHEMA_LIST",
"name" : "Schema list.",
"value" : "",
"values" : [ ]
}, {
"id" : "MASTER_ACCOUNT",
"name" : "Master Account",
"value" : ""
}, {
"id" : "ROLE_NAME",
"name" : "Database Role Name",
"value" : "ST_DB_SCH_01_Oct_06_2013_22"
}, {
"id" : "SCHEMA_PRIVILEGES",
"name" : "Schema Privileges",
"value" : "",
"values" : [ "CREATE TABLE", "CREATE SEQUENCE", "CREATE OPERATOR", "CREATE DIMENSION", "CREATE VIEW", "CREATE INDEXTYPE", "CREATE TYPE", "CREATE TRIGGER", "CREATE SESSION", "CREATE SYNONYM", "CREATE PROCEDURE" ]
}, {
"id" : "ENFORCE_STORAGE_CONSTRAINT",
"name" : "Enforces Storage Constraint",
"value" : "false"
}, {
"id" : "INITIAL_BLOCK_SIZE",
"name" : "Initial Storage Size",
"value" : ""
}, {
"id" : "AUTO_EXTEND_BLOCK_SIZE",
"name" : "Auto extend block size",
"value" : ""
}, {
"id" : "TABLESPACE_ENCRYPTION_ALGORITHM",
"name" : "Tablespace Encryption",
"value" : ""
}, {
"id" : "SHARED_STAGE_LOCATION",
"name" : "Staging Location",
"value" : ""
}, {
"id" : "WORKING_DIRECTORY",
"name" : "Working Directory",
"value" : ""
}, {
"id" : "SCHAAS_CUSTOM_PRE_SCRIPTS_URN",
"name" : "Pre-script",
"value" : ""
}, {
"id" : "SCHAAS_CUSTOM_POST_SCRIPTS_URN",
"name" : "Post-script",
"value" : ""
}, {
"id" : "SCHEMA_PASSWORD_LIST",
"name" : "Schema password list",
"value" : "",
"values" : [ ]
}, {
"id" : "CUSTOM_USER_SELECTED_SCRIPT_URN",
"name" : "Custom Script URN",
"value" : "",
"values" : [ ]
}, {
"id" : "DBSERVICE_NAME",
"name" : "Database Service Name",
"value" : ""
} ]
},
"createdOn" : null,
"createdBy" : null,
"modifiedOn" : null,
"modifiedBy" : null,
"owner" : "SYSMAN",
"etag" : null,
"lastModified" : null,
"canonicalLink" : "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E821074692058B5DE040F00AA37D75AB",
"selfLink" : "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E821074692058B5DE040F00AA37D75AB"
}

51.17.10.5 サービス・テンプレートのメタデータの表示

次の表に、サービス・テンプレートのメタデータを表示するためのGET構成を示します。

表51-156 サービス・テンプレートのメタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/metadata/DBAAS/DB

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
Content-Type: application/json
"metadata" : {
"serviceFamily:DBAAS" : {
"serviceType:DB" : {
"options" : [ {
"serviceFamily" : "DBAAS",
"serviceType" : "DB",
"type" : "CDP",
"description" : "Create a Service Template based on Configured Deployment Procedure.",
"name" : "<user_input>",
"payload" : false
}, {
"serviceFamily" : "DBAAS",
"serviceType" : "DB",
"type" : "CDP",
"description" : "Create a Service Template based on Configured Deployment Procedure and its Payload.",
"name" : "<user_input>",
"payload" : true,
"payloads" : [ {
"id" : "DBDELETE_PRESCRIPT",
"defaultValue" : "DBDELETE_PRESCRIPT",
"name" : "<user_input>"
} ]
}, {
"serviceFamily" : "DBAAS",
"serviceType" : "DB",
"type" : "DP",
"description" : "Create a Service Template based on Deployment Procedure.",
"name" : "<user_input>",
"payload" : false
}, {
"serviceFamily" : "DBAAS",
"serviceType" : "DB",
"type" : "DP",
"description" : "Create a Service Template based on Deployment Procedure and its Payload.",
"name" : "<user_input>",
"payload" : true,
"payloads" : [ {
"id" : "DBDELETE_PRESCRIPT",
"defaultValue" : "DBDELETE_PRESCRIPT",
"name" : "<user_input>"
} ]
} ]
}
,
"message" : "This gives the metadata information of the different types of service templates that can be created, the executable options supported and the allowed configuration parameters.",
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/metadata/DBAAS/DB"
}
}
}

51.17.10.6 サービス・テンプレートの構成値の作成

サービス・テンプレートの作成に必要な構成値を取得するには、メタデータに対してPOST操作を実行します。

表51-157 サービス・テンプレートの構成値を作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/metadata/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"type":"CDP",
"serviceFamily":"MWAAS",
"serviceType":"PhysicalWLS",
"name":"Provision Middleware_SYSMAN_Jul-18-2013 00-52AM"
}

リクエスト・メソッド

POST

注意:

- このペイロードは、メタデータのGETコールを介して取得します。

- ユーザーは<user_input>に適宜入力して、ServiceExecutableMetaDataEntityをレスポンスとして取得します。

- ユーザーは、値を適宜設定した自分のcreateペイロードでこのServiceExecutableMetaDataEntityを使用して、サービス・テンプレート・メタデータを作成します。

受け取るレスポンスの例を次に示します。

{
"configurations" : [ {
"description" : "Username for the WebLogic Server",
"id" : "wlsUserName",
"name" : "WebLogic Username *",
"required" : "false",
"secret" : "false"
}, {
"description" : "Password for the WebLogic Server",
"id" : "wlsUserPassword",
"name" : "WebLogic Password *",
"required" : "false",
"secret" : "true"
}, {
"description" : "Re-enter Password for the WebLogic Server",
"id" : "wlsUserPassword2",
"name" : "Re-enter WebLogic Password *",
"required" : "false",
"secret" : "true"
}, {
"description" : "Enter 1 for single cluster, 0 for no cluster. For physical provisioning it is auto populated based on the profile selected.  For virtual provisioning it is defaulted to 1.  Please change based on the actual topology of the assembly. ",
"id" : "topology",
"name" : "Topology *",
"required" : "false",
"secret" : "false"
}, {
"description" : "Enter 1 for 'Yes', 0 for 'No'",
"id" : "exposeAdminURLs",
"name" : "Expose WebLogic and FMW Console URLs to SSA User",
"required" : "false",
"secret" : "false"
}, {
"description" : "Enter 1 to enable, 0 to disable Load Balancer",
"id" : "enableLoadBalancer",
"name" : "Enable Load Balancer",
"required" : "false",
"secret" : "false"
}, {
"description" : "Use ',' to separate multiple target hosts",
"id" : "hostListForScripts",
"name" : "Hosts for Executing Scripts",
"required" : "false",
"secret" : "false"
}, {
"description" : "This will be used for the above hosts",
"id" : "namedCredforHostList",
"name" : "Named Credential for execution of scripts",
"required" : "false",
"secret" : "false"
}, {
"description" : "To execute scripts on Admin Server besides the hosts entered above, enter 1 for 'Yes', 0 for 'No'",
"id" : "isScriptExecuteOnAdminServer",
"name" : "Execution of Scripts on Admin Server Host",
"required" : "false",
"secret" : "false"
}, {
"description" : "Lower Bound for choosing Free Ports",
"id" : "portRangeStart",
"name" : "Port Range Start",
"required" : "false",
"secret" : "false"
}, {
"description" : "Upper Bound for choosing Free Ports",
"id" : "portRangeEnd",
"name" : "Port Range End",
"required" : "false",
"secret" : "false"
}, {
"description" : "Memory required by each additonal instance in GB",
"id" : "memoryUsagePerInstance",
"name" : "Expected Memory Consumption (For Use By Placement Logic)",
"required" : "false",
"secret" : "false"
}, {
"description" : "CPU required by each additonal instance in percemtage",
"id" : "cpuUsagePerInstance",
"name" : "Expected CPU Utilization (For Use By Placement Logic)",
"required" : "false",
"secret" : "false"
}, {
"description" : "Enter memory and java arguments to start the server. Example: -Xms1280m -Xmx1280m -XX:PermSize=128m -XX:MaxPermSize=256m -Dweblogic.security.SSL.ignoreHostnameVerification=true (Physical Only)",
"id" : "startupArguments",
"name" : "Managed Server Startup Arguments",
"required" : "false",
"secret" : "false"
}, {
"description" : "Enter 1 for distributing Java Servers uniformly on available hosts for high availability or 0 for placing maximum number of Java Servers possible on a host first before provisioning on other available host (Physical Only)",
"id" : "requireHighAvailability",
"name" : "Distribute Java Servers on Available Hosts",
"required" : "false",
"secret" : "false"
}, {
"description" : "Root Password to override (Virtual Only)",
"id" : "rootPwd",
"name" : "Root Password",
"required" : "false",
"secret" : "true"
}, {
"description" : "Agent Install User Password to override (Virtual Only)",
"id" : "agentInstallUserPwd",
"name" : "Agent Install User Password",
"required" : "false",
"secret" : "true"
}, {
"description" : "Enter name of the host credential to use for provisioning operations (Virtual Only)",
"id" : "namedHostCredForVirtualFlow",
"name" : "Host credential name for virtual flow",
"required" : "false",
"secret" : "false"
} ],
"name" : "Provision Middleware_SYSMAN_Oct-02-2013 10-31AM",
"serviceFamily" : "MWAAS",
"serviceType" : "PhysicalWLS",
"type" : "CDP"

51.18 セルフ・サービス・アプリケーション用のEM CLI動詞

Enterprise Managerコマンドライン・インタフェース(EM CLI)では、様々なオペレーティング・システムのテキストベースのコンソール(シェルおよびコマンド・ウィンドウ)からEnterprise Manager Cloud Control機能にアクセスできます。管理者は、SQL*Plus、OSシェル、Perl、Tclなどのカスタム・スクリプトを使用してEnterprise Manager機能をコールできるため、Enterprise Managerの機能と企業のビジネス・プロセスを容易に統合することができます。

この項では、Enterprise Managerセルフ・サービス・アプリケーション(SSA)の管理ユーザー用のEM CLI動詞に関する詳細について説明します。

51.18.1 はじめに

新しいフレームワークがリリース12.1.0.9に導入され、新しいEM CLI動詞が導入されました。以前のバージョンのフレームワークに関連付けられたEM CLI動詞は非推奨になり、ユーザーはサポートされるEM CLI動詞への移行を推奨されます。非推奨バージョンのEM CLI動詞はv1としてリストされ、サポートされるEM CLI動詞はv2としてリストされています。

- V2のSSA操作用のEM CLI動詞

- V1のSSA操作用のEM CLI動詞

PaaSインフラストラクチャ・ゾーンのEM CLI操作はすべて、EM_CLOUD_ADMINISTRATORロールを持つユーザーのみ使用できます。また、ソフトウェア・プールの操作は、EM_SSA_ADMINISTRATORロールを持つユーザーのみ実行できます。EM CLI動詞は、セキュリティ・コンテキストからユーザー情報を取得し、これらの操作を実行する権限を持つユーザーのみを検証します。

51.18.2 V2のSSA操作用のEM CLI動詞

次の表に、サポートされる動詞(v2)の詳細を示します。これらの動詞は、SSA管理者ユーザーのみ使用可能であり、EM_SSA_ USERロールでは使用できません。

表51-158 V2でサポートされるEM CLI動詞

動詞

説明

形式

emcli invoke_ws

Enterprise Manager Webサービスを起動します。

オプション:

- -wsname - リソースのURIを示します。

- -method - RESTメソッドのタイプ。

- -payload - json/xml入力ペイロードを示します。

- -accept - ペイロード・タイプ。これらは標準のJersey値です。

- -type - 標準のJerseyレスポンス・タイプ。

- -param - このオプションを使用して、フォーム/問合せパラメータ値を渡します。たとえば、-param="name:value"などです。複数のパラメータを指定できます。たとえば、-param="name:value" -param="zip:12345"などです。
パラメータはファイルを通じて提供できます。ファイルから読み取るには、-param="name:tag" -input_file="tag:file.txt"のように指定します。この例では、nameパラメータはファイルfile.txtから読み取られます。

- -input_file - このオプションを使用して、payloadまたはparam値をファイルで渡します。

例:

- emcli invoke_ws -wsname=/em/websvcs/restful/emws/core/v0/list/dataservice -method=get -param="name:Administrators"
リスト・リソースを呼び出してすべての管理者を取得します。

- emcli invoke_ws -wsname=/em/websvcs/restful/emws/core/v0/list/dataservice -method=get -param="name:tag" -input_file="tag:file.txt"
リスト・リソースを呼び出してすべての管理者を取得します。nameパラメータはfile.txtから読み取られます。

emcli invoke_ws

-wsname=<WebService Name>

-method=<method name>

[-payload=<Payload>]

[-accept=<accept type>

[-type=response type]

[-param=Query Parameters]

[-input_file=<Input File for payload data>]

emcli invoke_ws -method="post" -wsname="/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/" -type="application/json" -accept="application/json" -payload= 'xxxxxx'

提供されているペイロードで新規PaaSインフラストラクチャ・ゾーンを作成します。

例:

emcli invoke_ws -method="post" -wsname="/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/" -type="application/json" -accept="application/json" -payload='{"useExistingTarget":false, "name":"CLI_ZONE", "type":"self_service_zone", "credentials": [ {"name":"normal_credential_guid", "value": "AKM"} ], "memberTargetType": "host", "members": ["myhost2.idc.example.com"], "placementConstraints": [{"name":"MAX_CPU_UTILIZATION","value":["75"]}, {"name":"MAX_MEMORY_ALLOCATION","value":["75"]}], "characteristics": [ {"name":"EXAMPLE.SYSMAN.CFW.ORCL_GTP_CONTACT","value":["123456789"]}, {"name":"EXAMPLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER","value":["IDC.NOIDA"]}, {"name":"EXAMPLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT","value":["CFW"]}, {"name":"EXAMPLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS","value":["Test"]}, {"name":"EXAMPLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS","value":["ST"]}, {"name":"EXAMPLE.SYSMAN.CFW.ORCL_GTP_LOCATION","value":["IDC"]} ], "roles": ["SSA_USER"]}'

上記と同じです。

emcli get_targets

ターゲットのステータスおよびアラート情報を取得します。

オプション:

- -targets=name:type - 名前またはタイプは、完全な値または"%"を使用したパターン一致で指定できます。また、名前はオプションなので、タイプのみを指定できます。

- -limit_rows="取得するターゲットの最大数" - 指定されていない場合、デフォルトは2000行です。

- -config_search="構成検索UI名" - 検索UI名は、構成検索の表示名である必要があります。

- -alerts - 各ターゲットのクリティカルおよび警告アラートの数を表示します。

- -noheader - 列見出しのない表形式の出力を表示します。

- -unmanaged - 管理対象外ターゲットを表示します(ステータスまたはアラート情報なし)。

- -properties - 管理対象外ターゲットとプロパティを表示します。

- -separator_properties="separator_properties" - separator_propertiesを使用して管理対象外ターゲットのプロパティを表示します。

- -subseparator_properties="subseparator_properties" - subseparator_propertiesを使用して管理対象外ターゲットのプロパティを表示します。

- -script - このオプションは、-format="name:script"と同じです。

- -format - 書式指定(デフォルトは-format="name:pretty")。

- -format="name:pretty"は、出力表を読取り可能な形式で出力しますが、スクリプトによる解析は意図していません。

- -format="name:script" データベースの列セパレータをタブに設定し、デフォルトの行セパレータを改行に設定します。列および行セパレータ文字列を指定して、これらのデフォルトを変更できます。

- -format="name:csv"は、列セパレータをカンマに、行セパレータを改行に設定します。

例:

- emcli get_targets
最大2000のターゲットを表示します。クリティカル列と警告列は表示されません。

- emcli get_targets -limit_rows=20
最大20のターゲットを表示します。クリティカル列と警告列は表示されません。

- emcli get_targets -alerts
最大2000のターゲットを表示します。クリティカル列と警告列が表示されます。

- emcli get_targets -targets="oracle_database"
すべての"oracle_database"ターゲットを表示します。

- emcli get_targets -targets="%oracle%"
タイプに文字列"oracle"を含むすべてのターゲットを表示します。

- emcli get_targets -targets="database%:%oracle%"
名前が"database"で開始し、タイプに"oracle"が含まれるすべてのターゲットを表示します。

- emcli get_targets -targets="database3:oracle_database" -alerts
"database3"という名前のOracleデータベースに関するステータスおよびアラート情報を表示します。

- emcli get_targets -config_search="Search File Systems on Hosts" -targets="oracle%:host" -alerts
"Search File Systems on Hosts"という構成検索からの結果のターゲット、および名前が"oracle"で開始しタイプが"host"であるターゲットのステータスおよびアラート情報を表示します。

- emcli get_targets -targets="host" -unmanaged
管理対象外ホスト・ターゲットの名前とタイプの情報を表示します。

- emcli get_targets -unmanaged -properties -separator_properties=, -subseparator_properties==
指定されたセパレータを使用して管理対象外ホスト・ターゲットの名前、タイプおよびプロパティを表示します。デフォルトでは、separator_propertiesは「;」、subseparator_propertiesは「:」です。

emcli get_targets

[-targets="[name1:]type1;[name2:]type2;..."]

[-alerts]

[-noheader]

[-script | -format=

[name:<pretty|script|csv>];

[column_separator:"column_sep_string"];

[row_separator:"row_sep_string"];

]

[-limit_rows="取得するターゲットの最大数。"]

[-config_search="構成検索UI名"]

[-unmanaged]

[-properties]

[-separator_properties="properties_sep_string"]

[-subseparator_properties="properties_subsep_string"]

cancel_cloud_service_requests

クラウド・サービス・リクエストを取り消します。userまたはnamesオプションを指定する必要があります。両方同時に使用することはできません。

- user: 削除リクエストをフィルタするために使用するユーザー名。

- family: クラウド・リクエストをフィルタするために使用するサービス・ファミリ名。

- ids: クラウド・リクエストをフィルタするために使用する、セミコロン(";")で区切られたリクエストIDのリスト。スケジュールされたリクエストのみ取り消すことができます。

例

emcli cancel_cloud_service_requests -user="user1"

指定されたユーザーが所有者であるすべてのスケジュール済クラウド・リクエストを取り消します。

emcli cancel_cloud_service_requests -user="user1" -family="family1"

"user1"によって所有され、サービス・ファミリが"family1"であるすべてのスケジュール済クラウド・リクエストを取り消します。

emcli cancel_cloud_service_requests -user="user1" -ids="1;2"

"user1"によって所有され、IDが"1"および"2"であるすべてのスケジュール済クラウド・リクエストを取り消します。

emcli cancel_cloud_service_requests -user="username" [-family="family"] [-ids="id1;id2..."]

delete_cloud_service_instances

指定されたフィルタに基づいてクラウド・サービス・インスタンスを削除します。このオプションによって、インスタンスの削除時にセルフ・サービス・ユーザーによって所有されているすべてのオブジェクトがクリーンアップされます。

- user: 削除するサービス・インスタンスをフィルタするために使用するユーザー名。

- family: 削除するサービス・インスタンスをフィルタするために使用するサービス・ファミリ名。

- type: 削除するサービス・インスタンスをフィルタするために使用するサービス・タイプ。

例:

emcli delete_cloud_service_instances -user="user1"

指定されたユーザーが所有者であるすべてのクラウド・インスタンスを削除します。

emcli delete_cloud_service_instances -user="user1" -family="family1"

"user1"によって所有され、所属するサービス・ファミリが"family1"であるすべてのクラウド・インスタンスを削除します。

emcli delete_cloud_service_instances -user="user1" -type="type1"

"user1"によって所有され、所属するサービス・タイプが"type"であるすべてのクラウド・インスタンスを削除します。

emcli delete_cloud_service_instances -user="user1" -family="family1" -type="type1"

"user1"によって所有され、所属するサービス・ファミリが"family1"で、サービス・タイプが"type1"であるすべてのクラウド・インスタンスを削除します。

emcli delete_cloud_service_instances -user="username" [-family="family"] [-type="type"]

delete_cloud_user_objects

クラウド・サービス・インスタンスおよびリクエストを含むクラウド・ユーザー・オブジェクトを削除します。

- user: ユーザー・オブジェクトをフィルタするために使用するユーザー名。

- purge: 完了したリクエストをパージします。デフォルトはfalseです。

- force: 処理中のリクエストの取消しを試行します。ジョブ・ステータスによっては、一部のリソースで手動クリーンアップが必要です。このオプションは、一度開始すると操作を停止したり元に戻すことはできないため、慎重に使用してください。

注意: サービス・インスタンスの実行中にpurgeオプションを使用する場合、リクエストが完全に完了するのを待機してから、再度purgeオプションを使用する必要があります。

例:

emcli delete_cloud_user_objects -user="user1"

"user1"が所有者であるすべてのクラウド・オブジェクトを削除します。すべてのスケジュール済リクエストが取り消されます。

emcli delete_cloud_user_objects -user="user1" -purge

"user1"が所有者であるすべてのクラウド・オブジェクトを削除します。すべてのスケジュール済リクエストが取り消されます。すべての完了済リクエストがパージされます。

emcli delete_cloud_user_objects -user="user1" -force

"user1"が所有者であるすべてのクラウド・オブジェクトを削除します。すべてのスケジュール済リクエストが取り消されます。すべての処理中のリクエストが中断されます。

emcli delete_cloud_user_objects -user="username" [-purge] [-force]

get_cloud_service_instances

クラウド・サービス・インスタンスのリストを取得します。オプションが指定されない場合、すべてのインスタンスが出力されます。

- user: サービス・インスタンスをフィルタするために使用するユーザー名。

- family: サービス・インスタンスをフィルタするために使用するサービス・ファミリ名。

- type: サービス・インスタンスをフィルタするために使用するサービス・ファミリ・タイプ。

例:

emcli get_cloud_service_instances

すべてのクラウド・インスタンスを表示します。

emcli get_cloud_service_instances -user="user1"

"user1"が所有者であるすべてのクラウド・インスタンスを表示します。

emcli get_cloud_service_instances -family="family1"

所属するサービス・ファミリが"family1"であるすべてのクラウド・インスタンスを表示します。

emcli get_cloud_service_instances -type="type1"

所属するサービス・タイプが"type1"であるすべてのクラウド・インスタンスを表示します。

emcli get_cloud_service_instances [-user="username"] [-family="family"] [-type="type"]

get_cloud_service_requests

クラウド・リクエストのリストを取得します。フィルタが適用されない場合、すべてのリクエストが出力されます。両方のオプションを同時に使用することはできません。

- user: クラウド・リクエストをフィルタするために使用するユーザー名。

- family: クラウド・リクエストをフィルタするために使用するサービス・ファミリ名。

- ids: クラウド・リクエストをフィルタするために使用する、セミコロンで区切られたリクエストIDのリスト。

例:

emcli get_cloud_service_requests

すべてのクラウド・リクエストを表示します。

emcli get_cloud_service_requests -user="user1"

"user1"によって作成されたすべてのクラウド・リクエストを表示します。

emcli get_cloud_service_requests -family="family1"

所属するサービス・ファミリが"family1"であるすべてのクラウド・リクエストを表示します。

emcli get_cloud_service_requests -ids="1;2"

リクエストIDが"1"および"2"であるすべてのクラウドを表示します。

emcli get_cloud_service_requests [-user="username"] [-family="family"] [-ids="id1;id2..."]

get_cloud_user_objects

クラウド・サービス・インスタンスおよびリクエストを含むクラウド・ユーザー・オブジェクトのリストを取得します。ユーザー・オプションが使用されない場合、すべてのオブジェクトが出力されます。

- user: ユーザー・オブジェクトをフィルタするために使用するユーザー名。

例:

emcli get_cloud_user_objects

すべてのクラウド・オブジェクト、クラウド・インスタンス、リクエストおよび他のオブジェクトを表示します。

emcli get_cloud_user_objects -user="user1"

"user1"が所有者であるクラウド・オブジェクト、クラウド・インスタンス、リクエストおよび他のオブジェクトを表示します。

emcli get_cloud_user_objects [-user="username"]

51.18.3 V1のSSA操作用のEM CLI動詞

次の表に、非推奨の動詞(v1)の詳細を示します。ユーザーは、これらの動詞の使用の回避を推奨されます。これらの動詞は、SSA管理者ユーザーのみ使用可能であり、EM_SSA_ USERロールでは使用できません。

表51-159 V1のEM CLI動詞

動詞

説明

形式

create_paas_zone

PaaSインフラストラクチャ・ゾーンを作成します。

- name: 作成するPaaSインフラストラクチャ・ゾーンの名前

- credential: このPaaSインフラストラクチャ・ゾーンでプロビジョニングに使用するグローバル名前付き資格証明。

- hosts: このPaasインフラストラクチャ・ゾーンのメンバーとして追加するホスト・ターゲットのカンマ区切りのリスト。PaaSインフラストラクチャ・ゾーンには、メンバーとしてホストまたはOracle VMゾーンのいずれかを含めることができます。

- ovm_zones: このPaasインフラストラクチャ・ゾーンのメンバーとして追加するOracle VMゾーン・ターゲットのカンマ区切りのリスト。

- roles: このPaaSインフラストラクチャ・ゾーンにアクセスできるSSAロールのカンマ区切りのリスト。

- description: PaaSインフラストラクチャ・ゾーンの説明。

- cpu_utilization: 配置ポリシー制約を使用すると、クラウド管理者はどのホストにも最大しきい値を設定できます。入力値は、1から100の間にする必要があります。指定しない場合、デフォルト値は、80パーセントになります。Oracle VMゾーン・ターゲットをメンバーとして追加する場合、パラメータは必要ありません。

- memory_utilization: PaaSインフラストラクチャ・ゾーンの別の配置ポリシー制約。入力値は、1から100の間にする必要があります。指定しない場合、デフォルト値は、80パーセントになります。Oracle VMゾーン・ターゲットをメンバーとして追加する場合、パラメータは必要ありません。

例:

emcli  create_paas_zone
-name=MyPaaSZone
-credential=ABCDEF
-hosts=slc03qtn.us.example.com
-roles="SSA_USER_ROLE1,SSA_USER_ROLE2"
-description="Test PaaS zone"
-cpu_utilization=40
-memory_utilization=70

出力例:

PaaS Infrastructure Zone "MyPaaSZone" created successfully.

emcli create_paas_zone-name=<Name of PaaS Zone>

-credential=<Global Named Credential>

[-hosts=<Host1,Host2,Host3...>]

[-ovm_zones=<OVMZone1,OVMZone2,OVMZone3...>]

[-roles=<SsaRole1,SsaRole2,..>]

[-description=<Description of PaaS Zone>]

[-cpu_utilization=<Value between 1 and 100>]

[-memory_utilization=<Value between 1 and 100>]

update_paas_zone

PaaSインフラストラクチャ・ゾーンを更新します。

- name: 既存のPaaSインフラストラクチャ・ゾーンの名前。

- credential: 更新するグローバル名前付き資格証明。

- add_hosts: このPaasインフラストラクチャ・ゾーンのメンバーとして追加するホスト・ターゲットのカンマ区切りのリスト。追加するホストは、他の既存のPaaSゾーンにまだ追加されていない必要があります。

- remove_hosts: このPaasインフラストラクチャ・ゾーンのメンバーとして削除するホスト・ターゲットのカンマ区切りのリスト。

- add_ovm_zones: このPaasインフラストラクチャ・ゾーンのメンバーとして追加するOracle VMゾーン・ターゲットのカンマ区切りのリスト。追加するOracle VMゾーンは、他の既存のPaaSゾーンにまだ追加されていない必要があります。

- remove_ovm_zones: このPaasインフラストラクチャ・ゾーンのメンバーとして削除するOracle VMゾーン・ターゲットのカンマ区切りのリスト。

- add_roles: このPaaSインフラストラクチャ・ゾーンにアクセスできる、追加するSSAロールのカンマ区切りのリスト。

- remove_roles: このPaaSインフラストラクチャ・ゾーンから削除するSSAロールのカンマ区切りのリスト。

- description: PaaSインフラストラクチャ・ゾーンの更新後の説明。

- cpu_utilization: 配置ポリシー制約を使用すると、クラウド管理者はどのホストにも最大しきい値を設定できます。入力値は、1から100の間にする必要があります。

- memory_utilization: PaaSインフラストラクチャ・ゾーンの別の配置ポリシー制約。入力値は、1から100の間にする必要があります。

emcli update_paas_zone-name=<Name of PaaS Zone>

[-description=<Description of PaaS Zone>]

[-credential=<Global Named Credential>]

[-add_hosts=<Host1,Host2,Host3...>]

[-remove_hosts=<Host4,Host5...>]

[-add_ovm_zones=<OVMZone1,OVMZone2,OVMZone3...>]

[-remove_ovm_zones=<OVMZone4,OVMZone5...>]

[-add_roles=<SsaRole1,SsaRole2,..>]

[-remove_roles=<SsaRole3,SsaRole4,..>]

[-cpu_utilization=<Value between 1 and 100>]

[-memory_utilization=<Value between 1 and 100>]

delete_paas_zone

PaaSインフラストラクチャ・ゾーンを削除します。PaaSインフラストラクチャ・ゾーンは、関連付けられている既存のソフトウェア・プールがある場合、削除できません。

name: 削除する既存のPaaSインフラストラクチャ・ゾーンの名前。

emcli delete_paas_zone -name=<Name of PaaS Zone>

get_paas_zone_detail

PaaSインフラストラクチャ・ゾーンの詳細を取得します。

name: 名前、説明、名前付き資格証明、ホストの数、ロール、最大メモリー割当て(%)、最大CPU使用率(%)など、既存のPaaSインフラストラクチャ・ゾーンの詳細。

emcli get_paas_zone_detail -name=<Name of PaaS Zone>

create_pool

ソフトウェア・プールを作成します。

- name: 作成するソフトウェア・プールの名前

- target_type: 作成するソフトウェア・プールのターゲット・タイプ。

- paas_zone: ソフトウェア・プールを作成するPaaSインフラストラクチャ・ゾーンの名前。

- members: ソフトウェア・プールのメンバーとして追加するターゲットのカンマ区切りのリスト。

- description: ソフトウェア・プールの説明。

- placement_constraints: セルフ・サービス管理者がリソース使用率の上限を設定できるようにする配置制約のカンマ区切りのキー値ペア。これにより、リソース使用量の観点からソフトウェア・プールのメンバーを保護できます。プール・ターゲット・タイプの配置制約を取得する場合は、get_pool_allowed_placement_constraints動詞を参照してください。

- member_constraints: 設定条件によってソフトウェア・プールへのメンバー・ターゲットの追加を制限するカンマ区切りのキー値ペア。プール・ターゲット・タイプの使用可能なメンバー制約およびその可能な値を取得する場合は、get_pool_allowed_member_constraints動詞を参照してください。

- properties: ソフトウェア・プール・ターゲット・タイプに基づいて指定する必要がある追加のプロパティに対するカンマ区切りのキー値ペア。

例:

emcli  create_pool
-name=MyDbPool
-target_type=oracle_cloud_zone
-paas_zone=MyPaaSZone
-members=OraDb11g_home1_1_slc03qtn
-description="Test Database Pool"
-member_constraints="CONFIGURATION=oracle_database,VERSION=11.2.0.3.0,PLATFORM=226"
-placement_constraints="MAX_INSTANCES=7"
-properties="host_credential_guid=DBA449B8967AAF77E040F00A73B11F55,
root_credential_guid=DBA449B8967AAF77E040F00A73B11F55"

出力例:

Software Pool "MyDbPool" created successfully.

注意:

- この動詞は、DBプールに対して使用されます。スキーマ・プールのtarget_typeは、schaas_poolです。

- この動詞はプロパティを必須としていませんが(SSAフレームワークが所有しているため)、プロパティは必須であり、ない場合、プールは機能しません。

- スキーマ・プールの有効なプロパティ名は次のとおりです。host_credential_guid、database_credential_guidおよびgi_credential_guid。

emcli create_pool -name=<Name of Software Pool>

-target_type=<Target type of Software Pool>

-paas_zone=<PaaS Infrastructure Zone of Software Pool>

-members=<Member1, Member2...>

[-description=<Description of Software Pool>]

[-placement_constraints=<constraint1=value1, constraint2=value2...>]

[-member_constraints=<constraint1=value1, constraint2=value2>]

[-properties=<property1=value1, property2=value2>]

update_pool

ソフトウェア・プールを更新します。

- name: 既存のソフトウェア・プールの名前。

- target_type: 既存のソフトウェア・プールのターゲット・タイプ。例: ミドルウェア・プールの場合は"mwaas_zone"、データベース・プールの場合は"oracle_cloud_zone"、スキーマ・プールの場合は"schaas_pool"。

- description: ソフトウェア・プールの説明。

- add_members: ソフトウェア・プールのメンバーとして追加するターゲットのカンマ区切りのリスト。追加するターゲットは、ソフトウェア・プールのメンバー制約を満たす必要があります。

- remove_members: ソフトウェア・プールから削除するメンバー・ターゲット。

- placement_constraints: セルフ・サービス管理者がリソース使用率の上限を設定できるようにする配置制約のカンマ区切りのキー値ペア。これにより、リソース使用量の観点からソフトウェア・プールのメンバーを保護できます。

- properties: ソフトウェア・プール・ターゲット・タイプに基づいて更新する必要があるプロパティに対するカンマ区切りのキー値ペア。

emcli update_pool -name=<Name of Software Pool>

-target_type=<Target type of Software Pool>

[-description=<Description of Software Pool>]

[-add_members=<Member1, Member2...>]

[-remove_members=<Member4, Member5...>]

[-placement_constraints=<constraint1=value1,constraint2=value2...>]

[-properties=<property1=value1, property2=value2>]

delete_pool

ソフトウェア・プールを削除します。ソフトウェア・プールは、関連付けられている既存のサービス・テンプレートがある場合、削除できません。

- name: 既存のソフトウェア・プールの名前。

- target: ソフトウェア・プールのターゲット・タイプ。

emcli delete_pool -name=<Name of Software Pool>

-target_type=<Target type of Software Pool>

get_pool_detail

名前、ターゲット・タイプ、説明、PaaSインフラストラクチャ・ゾーン、メンバーの数、配置制約、メンバー制約など、ソフトウェア・プールの詳細を取得します。

- name: ソフトウェア・プールの名前。

- target: ソフトウェア・プールのターゲット・タイプ

emcli get_pool_detail -name=<Name of Software Pool>

-target_type=mwaas_zone

get_pool_capacity

プール・エンティティのホスト当たりのCPU使用率、メモリー割当て、インスタンス数などの、ソフトウェア・プール容量の詳細を取得します。

- name: ソフトウェア・プールの名前。

- target_type: ソフトウェア・プールのターゲット・タイプ。

例:

emcli  get_pool_capacity
-name=MyDbPool
-target_type=oracle_cloud_zone

出力例:

Details of Software Pool "MyDbPool" :
Capacity information for Software Pool "MyDbPool" :
Capacity information for Entity "slc03qtn.us.example.com" of type "host" :
Storage Utilization : 29.0 : 100.0
CPU Utilization : 2.96 : 40.0
Memory Utilization : 27.68 : 70.0
Instances : 2 : 7

emcli get_pool_capacity -name=<Name of Software Pool> -target_type=<Target type of Software Pool>

get_pool_allowed_placement_constraints

指定されたプール・ターゲット・タイプの配置制約のリストを取得します。

target_type: ソフトウェア・プールのターゲット・タイプ。

例:

emcli  get_pool_allowed_placement_constraints
-target_type=oracle_cloud_zone

出力例:

Name                   Description
MAX_INSTANCES   Maximum Number of Instances

emcli get_pool_allowed_placement_constraints -target_type=<mwaas_zone>

get_pool_filtered_targets

渡された基準に基づき、ソフトウェア・プールの作成に使用可能なフィルタ処理済ターゲットを取得します。

- target_type: ソフトウェア・プールのターゲット・タイプ。

- paas_zone - フィルタ処理済ターゲットの取得先であるPaaSインフラストラクチャ・ゾーンの名前。

- member_constraints: 設定条件によってソフトウェア・プールへのメンバー・ターゲットの追加を制限するカンマ区切りのキー値ペア。

例:

emcli  get_pool_filtered_targets
-target_type=oracle_cloud_zone
-paas_zone=MyPaaSZone
-member_constraints="CONFIGURATION=oracle_database,VERSION=11.2.0.3.0,PLATFORM=226"

出力例:

Target Type        Target Name
oracle_home            OraDb11g_home1

emcli get_pool_filtered_targets -target_type=<Target type of Software Pool> -paas_zone=<PaaS Infrastructure Zone of Software Pool> -member_constraints=<constraint1=value1, constraint2=value2>

get_pool_allowed_member_constraints

ソフトウェア・プールを作成するために許容されるソフトウェア・プール・メンバー制約値のリストを取得します。

target_type: ソフトウェア・プールのターゲット・タイプ。

例:

emcli  get_pool_allowed_member_constraints
-target_type=oracle_cloud_zone

emcli get_pool_allowed_member_constraints -target_type=<Target type of Software Pool>

get_named_credential

DBaaSプールおよびSchaaSプールの作成に使用する資格証明情報を取得します。

- cred_name - 資格証明名。

- cred_owner - 資格証明の所有者。

例:

emcli  get_named_credential
-cred_name=ABCDEF
-cred_owner=ORACLE

出力例:

Output:
Credential Name:test12
Credential Owner:ORACLE
Credential Type:HostCreds
Credential Target Type:host
Credential Username:test123
Credential Scope:global
Credential Guid:DBA449B8967AAF77E040F00A73B11F55
Credential Stripe:TARGETS
Credential Columns:
HostPassword=******
HostUserName=test12

52 SSAポータル管理REST API

この章では、リクエスト・スケジュールおよびユーザー・プリファレンス管理のためのREST APIについて説明します。

注意:
SSAプラグイン・リリース12.1.0.9では、v2フレームワークと呼ばれる新しいフレームワークがREST APIに導入されています。新しいフレームワークは異なるアプローチと署名から構成されるため、REST APIは以前のフレームワークと比較した場合にも異なります。以前のフレームワーク(v1)は非推奨になり、ユーザーはv2 REST APIおよびEM CLI動詞への移行を推奨されます。

v2では、セルフ・サービス・ポータル・アプリケーションのREST APIは一般にSSAユーザーによって使用されます。これらのREST APIは、一般に.../ssa/...の形式です。たとえば、/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/などです。管理機能のREST API (.../admin/...形式)は、ゾーンやテンプレートの作成など、一般にクラウドまたはSSAの管理者によって実行されるSSAポータル設定を構成するREST APIです。この章では、SSAユーザーREST APIについて説明します。

この章の項は次のとおりです。最初の2つの項では、この章で説明するすべてのv2およびv1 REST APIのサマリーを示し、その後の項では、ユーザー・プリファレンス・リソースとリクエスト・スケジュール・リソースの詳細やそれらのREST APIについて説明します。

- V2のSSAユーザーREST APIのサマリー

- V1のユーザーREST APIのサマリー

- V2の共通RESTエンティティ

- V2のCfwリソース

- V2のCfwリンク

- V2のCfw値記述子

- カタログAPI

- V2のサービス・タイプ

- V2のサービス

- V2のサービス・コレクション

- V2のサービス提供

- V2のリクエスト・メタデータ

- V1およびV2のサービス・リクエストREST API

- V2のサービス・リクエスト・リソース

- サービス・リクエスト・コレクション - V1のコレクション・リソース

- V1およびV2のサービス・リクエストREST API例

- V2のサービス・インスタンス

- V2の割当て制限使用量

- V2のユーザー・プリファレンス

- V1のユーザー・プリファレンス

- V1のマイ・プリファレンス

- V1の正規のリンク

- V1の一般プリファレンス

- V1のコンポジット・リソース属性

- V1のRequestEntityデータ・モデル

- V1のInstanceExpiryEntityデータ・モデル

- V1のQuotaEntityデータ・モデル

- 一般プリファレンスに対してサポートされるメソッド(V1の場合)

- V1のサービス固有のユーザー・プリファレンス

- V1のサービス・プリファレンス

- マイ・プリファレンスに対してサポートされるメソッド(V1の場合)

- V1のServicePreferenceMetadataデータ・モデル

- V1のコンポジット・リソース属性

- V1のサービス・プリファレンスREST APIの例

- V1のマイ・データベース・プリファレンスREST APIの例

- V1のマイ・ミドルウェア・プリファレンスREST APIの例

- V1のマイ・テスト・プリファレンス

52.1 V2のSSAユーザーREST APIのサマリー

次の表に、v2フレームワークについてこの章で説明するすべてのユーザー・プリファレンスおよびリクエスト・スケジュールREST APIをまとめています。

表52-1 V2のユーザー・プリファレンスおよびリクエスト・スケジュールREST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

共通RESTエンティティ

第52.3項

該当なし

サポート対象外

サポート対象外

サポート対象外

カタログ

該当なし

- 第52.4.2.1項

- 第52.4.2.2項

- 第52.4.2.3項

サポート対象外

サポート対象外

サポート対象外

サービス・タイプ

該当なし

第52.5.1.1項

サポート対象外

サポート対象外

サポート対象外

サービス・コレクション

表52-11

第52.6.5.1項

第52.6.5.4項

サポート対象外

サポート対象外

サービス提供

表52-12

第52.6.5.2項

サポート対象外

サポート対象外

サポート対象外

リクエスト・メタデータ

表52-13

第52.6.5.3項

サポート対象外

サポート対象外

サポート対象外

サービス・リクエスト

表52-19

- 第52.7.4.1項

- 第52.7.4.2項

- 第52.7.4.3項

- 第52.7.4.4項

サポート対象外

サポート対象外

サポート対象外

サービス・リクエスト

該当なし

- 第52.7.4.5項

- 第52.7.4.8項

- 第52.7.4.9項

サポート対象外

第52.7.4.7項

第52.7.4.6項

サービス・インスタンス

表52-38

- 第52.8.2.1項

- 第52.8.2.2項

- 第52.8.2.3項

- 第52.8.2.5項

- 第52.8.2.4項

- 第52.8.2.6項

サポート対象外

第52.8.2.7項

サポート対象外

割当て制限使用量

該当なし

- 第52.9.2.1項

- 第52.9.2.2項

サポート対象外

サポート対象外

サポート対象外

ユーザー・プリファレンス

該当なし

第52.10.2.1項

サポート対象外

サポート対象外

サポート対象外

一般ユーザー・プリファレンス

該当なし

- 第52.10.2.2項

- 第52.10.2.3項

サポート対象外

第52.10.2.4項

サポート対象外

サービス・ユーザー・プリファレンス

該当なし

第52.10.2.5項

サポート対象外

サポート対象外

サポート対象外

サービス・ファミリ・ユーザー・プリファレンス

該当なし

- 第52.10.2.6項

- 第52.10.2.7項

サポート対象外

第52.10.2.8項

サポート対象外

サービス・タイプ・ユーザー・プリファレンス

該当なし

- 第52.10.2.9項

- 第52.10.2.10項

サポート対象外

第52.10.2.11項

サポート対象外

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

52.2 V1のユーザーREST APIのサマリー

次の表に、v1フレームワークについてこの章で説明するすべてのユーザー・プリファレンスおよびリクエスト・スケジュールREST APIをまとめています。

表52-2 V1のユーザー・プリファレンスおよびリクエスト・スケジュールREST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

一般プリファレンス

表52-66

第52.13.1項

サポート対象外

第52.13.2項

サポート対象外

サービス・プリファレンス

表52-73

第52.14.5.1項

サポート対象外

サポート対象

サポート対象外

データベース・プリファレンス

該当なし

- 第52.14.6.1項

- 第52.14.6.4項

サポート対象外

- 第52.14.6.2項

- 第52.14.6.3項

サポート対象外

ミドルウェア・プリファレンス

該当なし

- 第52.14.7.1項

- 第52.14.7.4項

サポート対象外

- 第52.14.7.2項

- 第52.14.7.3項

サポート対象外

プリファレンスのテスト

該当なし

第52.14.8.1項

サポート対象外

第52.14.8.2項

サポート対象外

サービス・リクエスト・コレクション

表52-20

第52.7.4.1項

サポート対象外

サポート対象外

サポート対象外

サービス・リクエスト・エンティティ

表52-21

- 第52.7.4.10項

- 第52.7.4.11項

サポート対象外

- 第52.7.4.7項

- 第52.7.4.12項

第52.7.4.13項

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

52.3 V2の共通RESTエンティティ

この項では、クラウド・フレームワーク・リソースへの共通RESTエンティティについて説明します。これらのエンティティは新しいクラウド・フレームワーク(CFW) v2に固有です。

52.3.1 V2のCfwリソース

Cfwリソースは、クラウド・フレームワーク・リソースのベース・クラスです。このリソース・フィールドは、すべての単一リソースに共通です。

表52-3 Cfwリソース・データ・モデル

フィールド

タイプ

説明

description

文字列

リソースの説明。

createdOn

文字列

作成日。

createdBy

文字列

作成者の詳細。

modifiedOn

文字列

最終変更日。

modifiedBy

文字列

変更者の詳細。

owner

文字列

リソースの所有者を示します。

e-Tag

文字列

Etagを示します。

lastModified

文字列

最終変更の詳細。

canonicalLink

Cfwリンク

リソースの共通リンクを示します。

52.3.2 V2のCfwリンク

Cfwリンクは、リソースへのリンクのベース・クラスです。

表52-4 Cfwリンク・データ・モデル

フィールド

タイプ

説明

href

文字列

URIまたはURIテンプレートを示します。値がURIテンプレートの場合は、templatedプロパティをtrueにする必要があります。

templated

Boolean

hrefがURIテンプレートの場合はTrueで、それ以外の場合はfalseです。デフォルト値はfalseです。

rel

文字列

コンシューマが実際のリンク詳細を取得するために(typeプロパティに加えて)セカンダリ・キーとして検索できるリンク・リレーションの名前を示します(hrefやprofileなど)。

profile

文字列

ターゲット・リソースを遅延させるときに期待されるリソースを説明するJsonスキーマを示します。

method

文字列

リンクのターゲットをリクエストする方法。

mediaType

文字列

リンク・ターゲットの説明。

52.3.3 V2のCfw値記述子

Cfw値記述子は、動的データを定義します。

表52-5 Cfw値記述子データ・モデル

フィールド

タイプ

説明

id

文字列

IDを示します。

name

文字列

名前を示します。

value

文字列

値を示します。

defaultValue

文字列

デフォルト値を示します。

description

文字列

説明を提供します。

displayName

文字列

表示名を提供します。

required

Boolean

必須かどうかを示します。

secret

Boolean

秘密かどうかを示します。

type

文字列

タイプを示します。

unitOfmeasurement

文字列

単位を示します。

values

List

値リストを提供します。

subvalues

List<CfwValueDescriptor>

サブ値のリストを提供します。

subtype

文字列

値内の要素のタイプを提供します。

52.4 カタログAPI

この項では、SSAユーザーのカタログAPIについて説明します。

52.4.1 サポートされている操作

次の表に、カタログAPIでサポートされる操作を示します。

表52-6 カタログAPIでサポートされる操作

メソッド

URI

説明

GET

/em/websvcs/restful/extws/cloudservices/cfw/API

使用可能なREST APIカタログへのリンクを返します。

GET

/em/websvcs/restful/extws/cloudservices/cfw/API/v2

ユーザー・タイプ別のREST APIカタログへのリンクを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/API

ユーザーREST APIカタログを返します。

52.4.2 V2のREST APIカタログの例

この項には、カタログAPIの例が記載されています。次のREST API例について説明します。

- 使用可能なREST APIカタログの詳細の表示

- ユーザー・タイプ別のAPIカタログの詳細の表示

- ユーザーAPIカタログの詳細の表示

52.4.2.1 使用可能なREST APIカタログの詳細の表示

次の表に、使用可能なREST APIカタログの詳細を表示するためのGET構成を示します。

表52-7 使用可能なREST APIカタログの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/cfw/API

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"items": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/cfw/API/v1",
"description": "API Summary for version V1"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/cfw/API/v2",
"description": "API Summary for version V2"
}
],
"totalResults": 2
}

52.4.2.2 ユーザー・タイプ別のAPIカタログの詳細の表示

次の表に、ユーザー・タイプ別のREST APIカタログの詳細を表示するためのGET構成を示します。

表52-8 ユーザー・タイプ別のREST APIカタログの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/cfw/API/v2

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"items": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/API",
"description": "APIs for Self Service Application for version V2",
"type": "SSA"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/API",
"description": "APIs for administrative functions for version V2",
"type": "Admin"
}
],
"goBack":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/cfw/API",
"totalResults": 2
}

52.4.2.3 ユーザーAPIカタログの詳細の表示

次の表に、ユーザーAPIカタログの詳細を表示するためのGET構成を示します。

表52-9 ユーザーAPIカタログの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/API

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"items": [
{
"totalResults": 5,
"resource": "services",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services",
"method": "GET",
"description": "Get all the service offerings"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services",
"method": "POST",
"description": "Create a service"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}",
"method": "GET",
"templated": true,
"description": "Get details of a service"
},
{
"href":
"https://bxx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for a service"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}/metrics",
"method": "PUT",
"templated": true,
"description": "Get the metrics for a service"
}
]
},
{
"totalResults": 11,
"resource": "userpreferences",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences",
"method": "GET"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general",
"method": "GET",
"description": "Get the general user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general/metadata",
"method": "GET",
"description": "Get the metadata for general user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services",
"method": "GET",
"description": "Get the service user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}",
"method": "GET",
"templated": true,
"description": "Get the user preferences for a service family"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for user preference at family level"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}",
"method": "GET",
"templated": true,
"description": "Get the user preferences for a service type"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for user preference at service type level"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general",
"method": "PUT",
"description": "Update general user preference"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}",
"method": "PUT",
"templated": true,
"description": "Update family level user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}",
"method": "PUT",
"templated": true,
"description": "Update service type level user preferences"
}
]
},
{
"totalResults": 4,
"resource": "servicerequests",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests",
"method": "GET",
"description": "Get service requests"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "PUT",
"templated": true,
"description": "Reschedule the request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "GET",
"templated": true,
"description": "Get the details of request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "DELETE",
"templated": true,
"description": "Delete the request"
}
]
},
{
"totalResults": 5,
"resource": "serviceinstances",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances",
"method": "GET",
"description": "Get the service instances"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}",
"method": "GET",
"templated": true,
"description": "Get details of a service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions",
"method": "GET",
"templated": true,
"description": "Get actions for a service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions/{action-id}",
"method": "GET",
"templated": true,
"description": "Get metadata details of action"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions/{action-id}",
"method": "PUT",
"templated": true,
"description": "Perform the action on the service instance"
}
]
}
],
"goBack": "https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/API",
"totalResults": 4
}

52.5 V2のサービス・タイプ

この項では、サービス・タイプREST APIについて説明します。

52.5.1 V2のサービス・タイプREST APIの例

SSAユーザーのサービス・タイプREST APIは次のとおりです。

GETリクエストで問合せパラメータservicefamilyをオプションで使用し、特定のサービス・ファミリ・タイプ用に出力をフィルタできます。

52.5.1.1 サービス・タイプの詳細の表示

次の表に、サービス・タイプの詳細を表示するためのGET構成を示します。

表52-10 サービス・タイプの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicetypes

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Service Types",
"type": "Service Types Collection",
"totalResults": 3,
"cfwItems": [
{
"name": "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"displayName": "Cfw Sample RemoteServer XaaS",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service"
]
},
{
"name": "CFW_SAMPLEXAAS_SERVICE",
"displayName": "Cfw Sample XaaS",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service",
"cfw_xaas_storage_service"
]
},
{
"name": "CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM",
"displayName": "Cfw Sample XaaS - Other Service",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service_for_nomem"
]
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicetypes"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicetypes"
}
}

52.6 V2のサービス

サービス・リソースは、サービス・コレクション・リソース、サービス提供リソースおよびリクエスト・メタデータ・リソースで定義されます。これらのリソースについて次に説明します。

この項では、次の項目について説明します。

- V2のサービス・コレクション

- V2のサービス提供

- V2のリクエスト・メタデータ

- V2のサービスでサポートされる操作

- V2のサービスREST APIの例

- V2を使用したサービス・インスタンスの作成

52.6.1 V2のサービス・コレクション

サービス・コレクション・リソースは、oracle.sysman.cfw.cloudAPI.common.CfwCollectionリソースの拡張です。

表52-11 サービス・コレクション・データ・モデル

フィールド

タイプ

説明

name

文字列

コレクションの名前です。値は"Services"です。

type

文字列

コレクションのタイプ。値は"Services"です。

totalResults

整数

アイテムの総数。

cfwItems

List<ServiceOffering>

ServiceOfferingのリストを提供します。

canonicalLink

Cfwリンク

共通リンクを示します。

selfLink

Cfwリンク

セルフ・リンクを示します。

52.6.2 V2のサービス提供

サービス提供リソースは、oracle.sysman.cfw.cloudAPI.common.CfwResourceリソースの拡張です。サービス提供リソースは、ユーザーがサービス・インスタンスのプロビジョニングに使用できる、ユーザーが使用可能なサービス提供をカプセル化します。

表52-12 サービス提供データ・モデル

フィールド

タイプ

説明

id

文字列

サービス提供のIDを示します。

name

文字列

サービス提供の名前。

displayName

文字列

サービス提供の表示名。

guid

文字列

サービス提供のGUID。

serviceType

文字列

サービス・タイプを示します。

serviceFamily

文字列

サービス・ファミリを示します。

description

文字列

サービス提供の説明。

modifiedOn

文字列

変更の日付を示します。

lastModified

文字列

最終変更の日付を示します。

meta

文字列

サービス提供のメタ詳細。

canonicalLink

Cfwリンク

共通リンクを示します。

selfLink

Cfwリンク

セルフ・リンクを示します。

52.6.3 V2のリクエスト・メタデータ

リクエスト・メタデータ・リソースは、oracle.sysman.cfw.cloudAPI.common.CfwResourceの拡張です。リクエスト・メタデータは、サービス・インスタンスの作成に必要なデータをカプセル化します。返されるこのレスポンスは、ユーザーによって適切な値が入力され、サービス・インスタンスの作成に必要な"POST"ペイロードの場合と同様に使用されます。

表52-13 リクエスト・メタデータ・データ・モデル

フィールド

タイプ

説明

instanceName

文字列

サービス・インスタンスの名前。

schedule

スケジュール・エンティティ

リクエストのスケジュール。

configurations

List<CfwValueDescriptor>

構成のリストを提供します。

characteristics

List<Characteristic>

特性のリストを提供します。

52.6.4 V2のサービスでサポートされる操作

次の表に、サービス・リソースでサポートされる操作を示します。

表52-14 サービス・リソースでサポートされる操作

メソッド

URI

説明

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services

サービス提供のリストを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{serviceguid}

サービス提供の詳細を返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{serviceguid}/metadata

サービス提供メタデータの詳細を返します。

POST

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services

サービス・インスタンスの作成のためのリクエストを

発行します。

52.6.5 V2のサービスREST APIの例

この項では、サービス・リソースの一部であるREST APIを示します。次のREST APIタスクについて説明します。

- サービス・リソースの詳細の表示

- サービス提供リソースの詳細の表示

- リクエスト・メタデータの詳細の表示

- サービス・インスタンスの作成

52.6.5.1 サービス・リソースの詳細の表示

次の表に、サービス・リソースの詳細を表示するためのGET構成を示します。

表52-15 サービス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Services",
"type": "Service",
"totalResults": 4,
"cfwItems": [
{
"id": "1",
"name": "ORACLE_NIMBULA_ORCHESTRATION_TEMPLATE",
"displayName": "Orchestration",
"guid": "04FA3C08D3F3398AE053CE74B10A52F3",
"serviceType": "ORACLE_NIMBULA_ORCHESTRATION_SERVICE",
"serviceFamily": "NIMBULA_INFRASTRUCTURE",
"description": "Create a set of Oracle VM instances with customized configuration for
multi-tier applications",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servies/04FA3C08D3F3398AE053CE74B10A52F3/metadata",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FA3C08D3F3398AE053CE74B10A52F3"
}
},
{
"id": "2",
"name": "ORACLE_NIMBULA_SIMPLE_ORCHESTRATION_TEMPLATE",
"displayName": "Simple Orchestration",
"guid": "04FA3C08D3F6398AE053CE74B10A52F3",
"serviceType": "ORACLE_NIMBULA_ORCHESTRATION_SERVICE",
"serviceFamily": "NIMBULA_INFRASTRUCTURE",
"description": "Create one or more Oracle VM instances with default configuration and minimum inputs",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FA3C08D3F6398AE053CE74B10A52F3/metadata",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FA3C08D3F6398AE053CE74B10A52F3"
}
},
{
"id": "44",
"name": "MY DB Schema",
"displayName": "MY DB Schema",
"guid": "04FBAB67376E77D1E053CE74B10A9AA8",
"serviceType": "SCHEMA",
"serviceFamily": "DBAAS",
"description": "My DB Schema",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376E77D1E053CE74B10A9AA8/metadata",
"canonicalLink": {
2.3 9
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376E77D1E053CE74B10A9AA8"
}
},
{
"id": "41",
"name": "My WebLogic Template",
"displayName": "My WebLogic Template",
"guid": "04FB7EEED9A03798E053CE74B10A753D",
"serviceType": "WLAAS",
"serviceFamily": "MIDDLEWARE_CFW",
"description": "My Web Logic Template",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FB7EEED9A03798E053CE74B10A753D/metadata",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FB7EEED9A03798E053CE74B10A753D"
}
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/"
}
}

52.6.5.2 サービス提供リソースの詳細の表示

次の表に、サービス提供リソースの詳細を表示するためのGET構成を示します。

表52-16 サービス提供リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{serviceguid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"id": "42",
"name": "My Xaas Remote Server",
"displayName": "My Xaas Remote Server",
"guid": "04FBAB67376677D1E053CE74B10A9AA8",
"serviceType": "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"description": "My Xaas Remote Server",
"createdOn": "2014-10-09T10:13:34Z",
"modifiedOn": "2014-10-09T10:13:34Z",
"lastModified": "2014-10-09T10:13:34Z",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376677D
1E053CE74B10A9AA8/metadata",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376677D
1E053CE74B10A9AA8"
}
}

52.6.5.3 リクエスト・メタデータの詳細の表示

次の表に、リクエスト・メタデータの詳細を表示するためのGET構成を示します。

表52-17 リクエスト・メタデータの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{serviceguid}/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"characteristics": [
{
"displayName": "Self Service Zone",
"name": "ORACLE.SYSMAN.SXAAS.CFW_SAMPLEXAAS_RSRC_POOL",
"possibleValues": [
{
"name": "my_paaszone",
"value": "1C3A932A9089BBEC27A63EF389C7DF24"
}
]
}
],
"configurations": [
{
"name": "temp_param2",
"type": "STRING",
"value": "",
"required": false,
"secret": false
},
{
"name": "USER_NAME",
"type": "STRING",
"description": "User Name (cannot be any of Oracle default accounts) used to login to the requested database",
"value": "",
"required": false,
"secret": false
},
{
"name": "temp_param1",
"type": "STRING",
"value": "",
"required": false,
"secret": false
},
{
"name": "USER_PASSWORD",
"type": "STRING",
"description": "User Password to login to the given User Name database account",
"required": false,
"secret": true
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376677D1E053CE74B10A9AA8/metadata"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376677D1E053CE74B10A9AA8/metadata"
},
"instanceName": "<user-input>"
}

52.6.5.4 サービス・インスタンスの作成

次の表に、サービス・インスタンスを作成するためのPOST構成を示します。

表52-18 サービス・インスタンスを作成するためのPOSTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"name":"Xaas RemoteServer Request",
"offeringId":"04FBAB67376677D1E053CE74B10A9AA8",
"instanceName":"Xaas RemoteServer",
"schedule": {
"scheduleStartTime":"2015-01-12T16:48:10ZAmerica/Los_Angeles",
"scheduleEndTime":"2015-31-12T16:48:10ZAmerica/Los_Angeles"
},
"characteristics": [
{
"name":"ORACLE.SYSMAN.SXAAS.CFW_SAMPLEXAAS_RSRC_POOL",
"value":"1C3A932A9089BBEC27A63EF389C7DF24"
}
],
"configurations": [
{
"name":"temp_param2",
"value":"val2"
},
{
"name":"USER_NAME",
"value":"user"
},
{
"name": "temp_param1",
"value":"val1"
},
{
"name": "USER_PASSWORD",
"value":"passwords"
}
]
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"requests":[
{
"id":"16",
"actionName":"CREATE",
"canonicalLink":{
"href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/1
6"
}
},
{
"id":"17",
"actionName":"DELETE",
"canonicalLink":{
"href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/1
7"
}
}
]
}

52.6.6 V2を使用したサービス・インスタンスの作成

この項では、REST APIを使用してサービス・インスタンスを作成する手順を示します。

次の手順に従って、サービス・インスタンスを作成します。

1. URI - em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/に対してGET操作を実行します。第52.6.5.1項「サービス・リソースの詳細の表示」を参照してください。
GET操作はすべてのサービス提供を返します。必要なサービス提供に注意してください。

2. 前の手順のサービス提供IDを使用して、URI - em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{serviceofferingid}/metadataに対してPOST操作を実行します。第52.6.5.3項「リクエスト・メタデータの詳細の表示」を参照してください。
GET操作はサービス提供のメタデータを返します。メタデータ・フィールドをメモします。

3. メタデータ・フィールドの値を提供することで、URI - em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/に対してPOST操作を実行します。第52.6.5.4項「サービス・インスタンスの作成」を参照してください。
POSTは、サービス・インスタンスの作成のリクエストを生成します。リクエスト・ペイロードでは、次のフィールドに値が設定されていることが期待されます。

- offeringId - サービス・インスタンスを識別するための一意ID。

- name - サービス・インスタンスの名前。

- schedule - これはオプションのフィールドであり、scheduleStartTimeとscheduleEndTimeの2つのサブフィールドを持ちます。後で使用するようにインスタンスをスケジュールするには、scheduleStartTime値を指定します。また、サービス・インスタンスの失効または終了時刻を設定するには、scheduleEndTimeを設定します。

- instanceName - このフィールドは、選択したサービス提供に依存し、必須の場合と必須でない場合があります。

- configurations - このフィールドは、選択したサービス提供に依存し、必須の場合と必須でない場合があります。

- characteristics - このフィールドは、選択したサービス提供に依存し、必須の場合と必須でない場合があります。

52.7 V1およびV2のサービス・リクエストREST API

EM_SSA_USERロールを持つユーザーは、スケジュール済状態のリクエストを再スケジュールまたは取り消すことができます。

すべてのREST APIは、トップ・レベルURI /extws/cloudservices/ssa/cfw/v1/から利用できます。

52.7.1 V2のサービス・リクエスト・リソース

サービス・リクエスト・リソースは、oracle.sysman.cfw.cloudAPI.pojo.request.RequestSummaryの拡張です。リクエストにより、SSAユーザーはタスクを即時に開始するか、後で実行できます。

表52-19 V2のサービス・リクエスト・データ・モデル

フィールド

タイプ

説明

requestType

文字列

リクエストのタイプ。

serviceFamily

文字列

サービス・ファミリの名前。

serviceType

文字列

サービス・タイプの名前。

startDate

文字列

リクエストの開始日。

endDate

文字列

リクエストの終了日。

lastModifiedDate

文字列

リクエストの最終変更日。

timeZone

文字列

リクエストのタイム・ゾーン。

displayName

文字列

リクエストの表示名。

actionName

文字列

リクエスト・アクションの名前。

description

文字列

リクエストの説明。

submissionDate

文字列

リクエストの発行日。

submittedBy

文字列

リクエストを発行したユーザーの名前。

executionLogs

文字列

実行ログ。

status

リクエスト・ステータス

リクエストのステータス。

52.7.2 サービス・リクエスト・コレクション - V1のコレクション・リソース

サービス・リクエスト・コレクションは、すべてのアクセス可能なサービス・リクエスト・リソースのクラウド管理者ビューを表すコレクション・リソースです。次の表では、v1のサービス・リクエスト・コレクション・データ・モデルについて説明します。

表52-20 V1のサービス・リクエスト・コレクション・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

このコレクション・リソースの名前を表示します。

1

type

文字列

このコレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があることを示します。

1

count

整数

返される要素の数。

1

items

コレクション<ServiceRequestEntity>

ServiceRequestEntityリソースのリスト。リクエストが存在しない場合、アイテムは存在しますが空です。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

表52-21 V1のサービス・リクエスト・エンティティ・データ・モデル

フィールド

タイプ

説明

発生

id

文字列

ServiceRequestのRequestId。

1

beginDate

文字列

更新結果となる新しいスケジュールを文字列表現したタイムスタンプ。たとえば、2013-10-02T16:14:41ZPSTの形式で指定します。

1

status

文字列

サービス・リクエストのステータス。

1

name

文字列

サービス・リクエストの名前。

1

serviceFamily

文字列

リクエスト・タイプのサービス・ファミリ。

1

lastUpdatedTime

文字列

最後に変更した時点のタイムスタンプを、指定した形式で表現した文字列値。

1

lifeCycle

文字列

リクエストのライフ・サイクル。

1

selfLink

文字列

このURIにするGETは、このリソースのクライアント表現を表します。

1

canonicalLink

文字列

このURIにするGETは、このリソースのクライアント表現を表します。

1

52.7.3 サービス・リクエストに対してサポートされる操作

次の表に、サービス・リクエスト・リソースでサポートされる操作を示します。

表52-22 サービス・リクエストに対してサポートされるメソッド

リクエスト・メソッド

V2の正規のリンク

V1の正規のリンク

説明

GET

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/

すべてのサービス・リクエストのリストを提供します。

2つの問合せパラメータ・タイプとv1のステータスがあります。v2の場合、問合せパラメータは表52-23「V2のサービス・リクエストの問合せパラメータ」を参照してください。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/<request-id>

サービス・リクエストIDの詳細を提供します。

PUT

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/<request-id>

指定されたリクエストを別のスケジュールに再スケジュールします。スケジュールのbeginDateは、ペイロードで指定されます。

DELETE

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/<service-request-id>

指定されたサービス・リクエストを取り消します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}/logs

該当なし

サービス・リクエスト・ログを提供します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}/logs?stepid={stepid}

該当なし

リクエスト実行ステップ・ログを返します。

次の表に、v2フレームワークのサービス・リクエスト・リソースに対するGETリクエストでサポートされる問合せパラメータを示します。

表52-23 V2のサービス・リクエストの問合せパラメータ

パラメータ

入力

説明

必須

servicetype

サービス・タイプの名前

サービス・タイプ固有の情報を返します。

オプション

status

サービス・リクエストのステータス

ステータス固有の情報を返します。有効な値は、次のとおりです。

- CANCELLED

- CLEANUP_ERROR

- CLEANUP_FAILED

- CLEANUP_SCHEDULED

- CLEANED

- CLEANING_UP

- EXECUTION_ERROR

- INCOMPLETE

- IN_PROGRESS

- NO_QUOTA_ERROR

- NO_RESOURCE_ERROR

- PARTIAL_SUCCEEDED

- ENDED

- ERROR_ENDING

- ENDING

- EXECUTING

- SAVED

- SCHEDULED

- SCHEDULING

- ERROR_SCHEDULING

- SUCCESS

オプション

expanded

Boolean、trueまたはfalse

trueの場合、RequestCollectionはリクエストcfwItemsのリストを返し、それ以外の場合はリクエストのステータスに基づくサマリーを返します。

使用可能な値は、trueおよびfalseです。trueまたはfalse以外の値は無視され、falseとして扱われます。

オプション

servicefamily

サービス・ファミリの名前

サービス・ファミリ固有の情報を返します。

オプション

52.7.4 V1およびV2のサービス・リクエストREST API例

この項では、いくつかのREST APIのシナリオ例をすべてリストします。この項では、次の操作について説明します。

V2:

- V1およびV2でのサービス・リクエストのトップ・レベル・ビューの取得

- V2でのStatus=SUCCESSのサービス・リクエスト・リソースの問合せ

- V2でのExpanded=trueおよびExpanded=falseのサービス・リクエスト・リソースの問合せ

- V2でのstatus=SUCCESS&expanded=falseおよびstatus=SUCCESS&expanded=trueのサービス・リクエスト・リソースの問合せ

- V2でのサービス・リクエストの詳細の表示

- V2でのサービス・リクエストの削除

- V1およびV2でのスケジュール済状態にあるサービス・リクエストの再スケジュール

- V2でのサービス・リクエストのログの表示

- V2でのサービス・リクエストのログの問合せ

V1:

- V1での特定のサービス・ファミリにおけるサービス・リクエストのトップ・レベル・ビューの取得

- V1での特定のステータスにおけるサービス・リクエストのトップ・レベル・ビューの取得

- V1での取消済状態(またはスケジュール済以外の状態)にあるサービス・リクエストの再スケジュール

- V1でのスケジュール済状態にあるサービス・リクエストの削除

- V1での取消済状態(またはスケジュール済以外の状態)にあるサービス・リクエストの削除

52.7.4.1 V1およびV2でのサービス・リクエストのトップ・レベル・ビューの取得

表52-24 V1およびV2でサービス・リクエスト・リソースの詳細を表示するためのGETリクエスト構成

機能

V1に対する仕様

V2に対する仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

なし

リクエスト・メソッド

GET

GET

v2で受け取るレスポンスのサンプルを次に示します。

{
"name": "Request summary grouped by status",
"totalResults": 17,
"requestSummary": [
{
"status": "NO_QUOTA_ERROR",
"count": 1,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=NO_QUOTA_ERROR&expanded=true"
},
{
"status": "EXECUTION_ERROR",
"count": 1,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=EXECUTION_ERROR&expanded=true"
},
{
"status": "SUCCESS",
"count": 5,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=SUCCESS&expanded=true"
},
{
"status": "CLEANUP_FAILED",
"count": 1,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=CLEANUP_FAILED&expanded=true"
},
{
"status": "SCHEDULED",
"count": 9,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=SCHEDULED&expanded=true"
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests"
}
}

v1で受け取るレスポンスのサンプルを次に示します。

{
"name": "Service Requests",
"type": "Service Request","count": 2,
"items": [
{
"id": "2",
"name": "future_Create Sample XaaS Service#2",
"beginDate": "2015-02-14T08:37:18Z India Standard Time",
"status": "SCHEDULED",
"selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2",
"canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY"
},
{
"id": "1",
"name": "eadeweqqw_Create Sample XaaS Service#1",
"beginDate": "2015-02-10T07:49:24Z India Standard Time",
"status": "EXECUTION_ERROR",
"selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1",
"canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY"
}
],
"selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequest?status=ALL",
"canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/"
}

52.7.4.2 V2でのStatus=SUCCESSのサービス・リクエスト・リソースの問合せ

次の表に、サービス・リクエスト・リソースを問い合せるためのGET構成を示します。

表52-25 V2でStatus=SUCCESSのサービス・リクエストを問い合せるためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=SUCCESS

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "Request summary grouped by status",
"totalResults" : 5,
"requestSummary" : [ {
"status" : "SUCCESS",
"count" : 3,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=true"
}, {
"status" : "SCHEDULED",
"count" : 2,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SCHEDULED&expanded=true"
} ],
"canonicalLink" : {
"href" :
3.4 22
-
-
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS"
}
}

52.7.4.3 V2でのExpanded=trueおよびExpanded=falseのサービス・リクエスト・リソースの問合せ

次の表に、expanded=trueのサービス・リクエスト・リソースを問い合せるためのGET構成を示します。問合せ変更がURIで行われるexpanded=falseも同様のアプローチに従います。

表52-26 V2でExpanded=trueのサービス・リクエストを問い合せるためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?expanded=true

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

expanded=trueで受け取るレスポンスのサンプルを次に示します。

{
"name" : "Service Requests",
"type" : "Service Request",
"totalResults" : 5,
"cfwItems" : [ {
"id" : "5",
"name" : "Rst_rpc_14-09-11 09.52.58_11-Sep-14 21:53:06.663",
"startDate" : "2014-09-11T16:23:06Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/5"
},
"displayName" : "Rst_rpc_14-09-11 09.52.58_11-Sep-14 21:53:06.663"
}, {
"id" : "4",
"name" : "Remove Sample XaaS Service_Xaas_Storage__11-Sep-14 21:52:58.553",
"startDate" : "2017-07-12T23:48:10Z",
"status" : "SCHEDULED",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/4"
},
"displayName" : "Remove Sample XaaS Service_Xaas_Storage__11-Sep-14 21:52:58.553"
}, {
"id" : "3",
"name" : "Rst_en_14-09-11 09.52.58_11-Sep-14 21:52:58.363",
"startDate" : "2014-09-11T16:22:58Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/3"
},
"displayName" : "Rst_en_14-09-11 09.52.58_11-Sep-14 21:52:58.363"
}, {
"id" : "2",
"name" : "Rst_st_en_14-09-11 09.52.58_11-Sep-14 21:52:54.187",
"startDate" : "2015-01-13T00:48:10Z",
"status" : "SCHEDULED",
"canonicalLink" : {
"href" :
3.5 23
-
-
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/2"
},
"displayName" : "Rst_st_en_14-09-11 09.52.58_11-Sep-14 21:52:54.187"
}, {
"id" : "1",
"name" : "Rst_14-09-11 09.52.58_11-Sep-14 21:52:49.360",
"startDate" : "2014-09-11T16:22:49Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/1"
},
"displayName" : "Rst_14-09-11 09.52.58_11-Sep-14 21:52:49.360"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?expanded=true"
}
}

expanded=falseで受け取るレスポンスのサンプルを次に示します。

{
"name" : "Request summary grouped by status",
"totalResults" : 5,
"requestSummary" : [ {
"status" : "SUCCESS",
"count" : 3,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=true"
}, {
"status" : "SCHEDULED",
"count" : 2,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=SCHEDULED&expanded=true"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?expanded=false"

52.7.4.4 V2でのstatus=SUCCESS&expanded=falseおよびstatus=SUCCESS&expanded=trueのサービス・リクエスト・リソースの問合せ

次の表に、status=SUCCESS&expanded=falseのサービス・リクエスト・リソースを問い合せるためのGET構成を示します。問合せ変更がURIで行われるstatus=SUCCESS&expanded=trueも同様のアプローチに従います。

表52-27 V2でstatus=SUCCESS&expanded=falseのサービス・リクエストを問い合せるためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=SUCCESS&expanded=false

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

status=SUCCESS&expanded=falseで受け取るレスポンスのサンプルを次に示します。

{
"name" : "Request summary grouped by status",
"totalResults" : 5,
"requestSummary" : [ {
"status" : "SUCCESS",
"count" : 3,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=true"
}, {
"status" : "SCHEDULED",
"count" : 2,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SCHEDULED&expanded=true"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=false"
}
}

status=SUCCESS&expanded=trueで受け取るレスポンスのサンプルを次に示します。

{
"name" : "Service Requests",
"type" : "Service Request",
"totalResults" : 3,
"cfwItems" : [ {
"id" : "5",
"name" : "Rst_rpc_14-09-11 09.52.58_11-Sep-14 21:53:06.663",
"startDate" : "2014-09-11T16:23:06Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
3.7 "https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere 25
quests/5"
},
"displayName" : "Rst_rpc_14-09-11 09.52.58_11-Sep-14 21:53:06.663"
}, {
"id" : "3",
"name" : "Rst_en_14-09-11 09.52.58_11-Sep-14 21:52:58.363",
"startDate" : "2014-09-11T16:22:58Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/3"
},
"displayName" : "Rst_en_14-09-11 09.52.58_11-Sep-14 21:52:58.363"
}, {
"id" : "1",
"name" : "Rst_14-09-11 09.52.58_11-Sep-14 21:52:49.360",
"startDate" : "2014-09-11T16:22:49Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/1"
},
"displayName" : "Rst_14-09-11 09.52.58_11-Sep-14 21:52:49.360"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=true"
}
}

52.7.4.5 V2でのサービス・リクエストの詳細の表示

サービス・リクエストの詳細を表示するためのGETリクエスト構成を次に示します。

表52-28 V2でサービス・リクエストの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"id": "44",
"name": "dp_2b022961-c#44",
"status": "SUCCESS",
"serviceType": "CFW_SAMPLEXAAS_SERVICE",
"serviceFamily": "Sample Services",
"actionName": "Create Sample XaaS Service",
"startDate": "2014-10-15T09:29:23Z",
"createdOn": "2014-10-15T09:29:23Z",
"createdBy": "SYSMAN",
"owner": "SYSMAN",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/44"
},
"executionLogs":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/44/logs"
}

52.7.4.6 V2でのサービス・リクエストの削除

サービス・リクエストを削除するためのDELETEリクエスト構成を次に示します。

表52-29 V2でサービス・リクエストを削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

{
"message" : "[\"Request 31 deleted successfully\"]"
}

52.7.4.7 V1およびV2でのスケジュール済状態にあるサービス・リクエストの再スケジュール

次の表にPUTリクエスト構成を示します。

表52-30 V1およびV2状態にあるサービス・リクエストを再スケジュールするためのPUTリクエスト構成

機能

V1に対する仕様

V2に対する仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"beginDate": "2013-10-02T16:14:41ZPST"
}

{"startDate":"2015-08-12T16:48:10ZAmerica/Los_Angeles"}

リクエスト・メソッド

PUT

PUT

v2で受け取るレスポンスのサンプルを次に示します。

{
"message" : "Request 2 rescheduled successfully."
}

v1で受け取るレスポンスのサンプルを次に示します。

Status 200 OK
{
message: "Service request 2 rescheduled successfully."
}

52.7.4.8 V2でのサービス・リクエストのログの表示

次の表に、サービス・リクエスト・ログを表示するためのGETリクエスト構成を示します。

表52-31 V2でサービス・リクエストのログを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}/logs

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"submittedOn" : "2014-09-12T07:20:38Z",
"steps" : [ {
"stepName" : "CfwRequestInitCommand",
"stepId" : "CfwRequestInitCommand",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestInitCommand"
}, {
"stepName" : "CfwRequestPreProcessCommand",
"stepId" : "CfwRequestPreProcessCommand",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestPreProcessCommand"
}, {
"stepName" : "CfwRequestJobInvokerCommand",
"stepId" : "CfwRequestJobInvokerCommand",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestJobInvokerCommand"
}, {
"stepId" : "",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid="
}, {
"stepName" : "CfwRequestPostProcessCommand",
"stepId" : "CfwRequestPostProcessCommand",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestPostProcessCommand"
} ],
"id" : "21"
}

52.7.4.9 V2でのサービス・リクエストのログの問合せ

次の表に、サービス・リクエスト・ログを問い合せるためのGETリクエスト構成を示します。

表52-32 V2でサービス・リクエストのログを問い合せるためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/{requestid}/logs?stepid=CfwRequestPreProcessCommand

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"id" : "21",
"stepName" : "CfwRequestPreProcessCommand",
"stepId" : "CfwRequestPreProcessCommand",
"data" : "INFO:Request Pre-processing in progress.\nINFO:Preparing the inputs for Request Action:
Create Sample XaaS Service\nINFO:Performing placment checks to identify the appropriate Service-
Provider.\nINFO:Placement checks executed successfully.\nINFO:Request pre-processing successfully
executed.",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestPreProcessCommand"
}
}

52.7.4.10 V1での特定のサービス・ファミリにおけるサービス・リクエストのトップ・レベル・ビューの取得

次の表にGETリクエスト構成を示します。

表52-33 V1で特定のサービス・ファミリにおけるサービス・リクエストの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests?type=mwaas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK
{
name: "Service Requests"
type: "Service Request"
count: 2
items: [2]
0:
{
id: "2"
name: "request2_14153ee61c5_Create_20130925_123353"
beginDate: "2013-09-25T12:48:50ZAsia/Calcutta"
status: "Scheduled"
lifeCycle: "Create Service Instance"
selfLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2"
canonicalLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2"
serviceFamily: "MWAAS"
}

1:
{
id: "1"
name: "request1_14153ea0bb6_Create_20130925_122909"
beginDate: "2013-09-25T12:44:03ZAsia/Calcutta"
status: "Cancelled"
lifeCycle: "Create Service Instance"
selfLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1"
canonicalLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1"
serviceFamily: "MWAAS"
}

selfLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests?status=ALL"
canonicalLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests"
}

52.7.4.11 V1での特定のステータスにおけるサービス・リクエストのトップ・レベル・ビューの取得

次の表にGETリクエスト構成を示します。

表52-34 V1で特定のステータスであるサービス・リクエストの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/?status=SCHEDULED

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Service Requests",
"type": "Service Request",
"count": 1,
"items": [
{
"id": "2",
"name": "future_Create Sample XaaS Service#2",
"beginDate": "2015-02-14T08:37:18Z India Standard Time",
"status": "SCHEDULED",
"selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2",
"canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY"
}
],
"selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequest?status=SCHEDULED",
"canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/"
}

52.7.4.12 V1での取消済状態(またはスケジュール済以外の状態)にあるサービス・リクエストの再スケジュール

次の表にPUTリクエスト構成を示します。

表52-35 v1で取消済状態にあるサービス・リクエストを再スケジュールするためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"beginDate": "2013-10-02T16:14:41ZPST"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status : 400 Bad request {errorMessages: "Error occured while rescheduling. Verify that schedule is not in past and status is scheduled."}

52.7.4.13 V1でのスケジュール済状態にあるサービス・リクエストの削除

次の表にDELETEリクエスト構成を示します。

表52-36 V1でスケジュール済サービス・リクエストを取り消すためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message: "Service request 1 cancelled successfully."
}

52.7.4.14 V1での取消済状態(またはスケジュール済以外の状態)にあるサービス・リクエストの削除

次の表にDELETEリクエスト構成を示します。

表52-37 V1で取消済状態にあるサービス・リクエストを削除するためのDELETEリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status : 400 Bad request{errorMessages: "Error occured while cancelling. Only request with status SCHEDULED is cancellable."}

52.8 V2のサービス・インスタンス

サービス・インスタンス・リソースは、サービス・インスタンスとアクション・エンティティから構成されます。サービス・インスタンス・リソースのデータ・モデルとその関連エンティティを次に示します。

表52-38 V2のサービス・インスタンス・データ・モデル

フィールド

タイプ

説明

guid

文字列

サービス・インスタンスのGUID

serviceFamily

文字列

サービス・ファミリの名前。

serviceType

文字列

サービス・タイプの名前。

status

文字列

サービス・インスタンスのステータス。

displayname

文字列

サービス・インスタンスの表示名。

targetType

文字列

サービス・インスタンスのターゲット・タイプ。

表52-39 V2のアクション・データ・モデル

フィールド

タイプ

説明

発生

offeringId

文字列

サービスのGUID。

1

name

文字列

リクエストの名前。

1

instanceName

文字列

サービス・インスタンスの名前。

0..1

schedule

ScheduleEntity

リクエストのスケジュール。

0..1

configurations

List<CfwValueDescriptor>

構成。

0..1

characteristics

List<Characteristic>

特性のリスト。

0..1

サポートされるリクエスト・パラメータとその説明を次の表に示します。

52.8.1 V2でサービス・インスタンスに対してサポートされるメソッド

次の表に、サービス・インスタンス・リソースでサポートされるメソッドの詳細を示します。

表52-40 サービス・インスタンス・リソースに対してサポートされるメソッド

リクエスト・メソッド

URI

説明

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/

サービス・インスタンス・コレクションの詳細を返します。

問合せパラメータは、表52-41「V2のサービス・インスタンスの問合せパラメータ」を参照してください。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}

指定されたサービス・インスタンスの詳細を返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/actions

指定されたサービス・インスタンスで使用可能なアクションを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/attributes

指定されたサービス・インスタンスの属性を返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/actions/{actionid}

指定されたサービス・インスタンスに対してアクションを実行するために必要なアクションの詳細とアクションの入力を返します。

PUT

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/

特定のサービス・インスタンスに関するアクションを実行します。

次の表に、v2フレームワークのサービス・インスタンス・リソースに対するGETリクエストでサポートされる問合せパラメータを示します。

表52-41 V2のサービス・インスタンスの問合せパラメータ

パラメータ

入力

説明

必須

servicetype

サービス・タイプの名前。

サービス・タイプ固有の情報を返します。

オプション

status

サービス・インスタンスのステータス。

ステータス固有の情報を返します。有効な値は、次のとおりです。

- PENDING_CREATION: サービス・インスタンスを作成するリクエストが後日実行するようにスケジュールされ、関連するサービス・インスタンスの作成がスケジュールされていることを示します。

- PROCESSING_CREATION: サービス・インスタンスを作成するリクエストが実行中で、作成プロセスが進行していることを示します。

- ERROR_CREATION: サービス・インスタンスを作成するリクエストがエラーのために失敗したことを示します。

- STATUS_DOWN: サービス・インスタンスが現在停止していることを示します。

- STATUS_UP: サービス・インスタンスが起動して正常に実行中であることを示します。

- STATUS_METRIC_ERROR: サービス・インスタンスの特定のデータの収集中に、サービス・インスタンスを監視するシステム(EM/OMS)に問題が発生したことを示します。

- STATUS_AGENT_DOWN: サービス・インスタンスを監視するエージェントが停止していることを示します。そのため、サービス・インスタンスの監視データをアップロードできません。

- STATUS_UNREACHABLE: システムがサービス・インスタンスの可用性ステータスを取得できないことを示します。

- STATUS_BLACKOUT: 管理者がアップグレード/パッチのためのサービス・インスタンスをブラックアウトしていることを示します。アップグレードは、通常、サービスをホストするマシンに適用されます。

- STATUS_PENDING: システムによるサービス・インスタンスの可用性ステータスの収集プロセスが進行していることを示します。

オプション

expanded

Boolean、trueまたはfalse。

ServiceInstanceCollectionには、trueの場合はcfwItemsが含まれ、falseの場合はserviceInstanceSummaryが含まれます。

オプション

52.8.2 V2のサービス・インスタンスREST APIの例

この項では、サービス・インスタンス・リソースのREST APIの例を示します。この項では、次の操作について説明します。

- V2のサービス・インスタンス・リソースの詳細の表示

- V2のサービス・インスタンス・リソースの問合せ

- V2でのサービス・インスタンスの詳細の表示

- V2でのサービス・インスタンスの属性の詳細の表示

- V2でのサービス・インスタンスに対して使用可能なアクションの詳細の表示

- V2でサービス・インスタンスに対してアクションを実行するために必要なアクションの入力の詳細の表示

- V2でのサービス・インスタンスに対するアクションの実行

52.8.2.1 V2のサービス・インスタンス・リソースの詳細の表示

次の表にGETリクエスト構成を示します。

表52-42 V2でサービス・インスタンス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "Service Instances Summary",
"totalResults" : 7,
"serviceInstanceSummary" : [ {
"status" : "STATUS_UP",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?status=STATUS_UP&expanded=true",
"count" : 3
}, {
"status" : "PENDING_CREATION",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?status=PENDING_CREATION&expanded=true",
"count" : 4
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances"
}
}

52.8.2.2 V2のサービス・インスタンス・リソースの問合せ

次の表に、次のパラメータに基づいてサービス・インスタンス・リソースを問い合せるためのGETリクエスト構成を示します。

- expanded=true

- expanded=false

- status=STATUS_UP

- servicetype=CFW_SAMPLEXAAS_SERVICE

- expanded=true,status=STATUS_UP

- expanded=false,status=STATUS_UP,servicetype=CFW_SAMPLEXAAS_SERVICE

表52-43 V2でサービス・インスタンス・リソースを問い合せるためのGETリクエスト構成

機能

仕様

expanded=trueのURI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?expanded=true

expanded=falseのURI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?expanded=false

status=STATUS_UPのURI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?status=STATUS_UP

servicetype=CFW_SAMPLEXAAS_SERVICEのURI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?servicetype=CFW_SAMPLEXAAS_SERVICE

expanded=true&status=STATUS_UPのURI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?expanded=true&status=STATUS_UP

expanded=false,status=STATUS_UP,servicetype=CFW_SAMPLEXAAS_SERVICEのURI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?expanded=fal

se&status=STATUS_UP&servicetype=CFW_SAMPLEXAAS_SERVICE

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

expanded=falseで受け取るレスポンスのサンプルを次に示します。

{
"name" : "Service Instances Summary",
"totalResults" : 7,
"serviceInstanceSummary" : [ {
"status" : "STATUS_UP",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances?status=STATUS_UP&expanded=true",
"count" : 3
}, {
"status" : "PENDING_CREATION",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances?status=PENDING_CREATION&expanded=true",
"count" : 4
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances?expanded=false"
}
}

52.8.2.3 V2でのサービス・インスタンスの詳細の表示

次の表にGETリクエスト構成を示します。

表52-44 V2でサービス・インスタンスの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "test",
"targetName" : "test",
"guid" : "CCA88E9507D4A9E2214935F956D83150",
"serviceType" : "CFW_SAMPLEXAAS_SERVICE",
"serviceFamily" : "CFW_SAMPLEXAAS_SERVICEFAMILY",
"status" : "STATUS_UP",
"targetType" : "Cfw_Xaas_DB_Service",
"createdOn" : "2014-11-15T00:00:00ZAsia/Calcutta",
"createdBy" : "SYSMAN",
"owner" : "SYSMAN",
"attributes" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances/CCA88E9507D4A9E2214935F956D83150/attributes"
},
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances/CCA88E9507D4A9E2214935F956D83150"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances/CCA88E9507D4A9E2214935F956D83150"
}
}

52.8.2.4 V2でのサービス・インスタンスの属性の詳細の表示

次の表にGETリクエスト構成を示します。

表52-45 V2でサービス・インスタンスの属性の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/attributes

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"serviceInstanceGuid" : "CCA88E9507D4A9E2214935F956D83150",
"attributes" : [ {
"name" : "xaasServiceName",
"type" : "STRING",
"value" : "test"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/CCA88E9507D4A9E2214935F956D83150/attributes"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/CCA88E9507D4A9E2214935F956D83150/attributes"
}
}

52.8.2.5 V2でのサービス・インスタンスに対して使用可能なアクションの詳細の表示

次の表にGETリクエスト構成を示します。

表52-46 V2でサービス・インスタンスで使用可能なアクションの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/actions

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"totalResults" : 6,
"selfLink" : {
"href" :
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/2A2BD0D7C40F7C2814FA6788704E313
A/actions"
},
"cfwItems" : [ {
"name" : "DELETE",
"id" : "82",
"displayName" : "Remove Sample XaaS Service",
"description" : "Removing my Sample XaaS service"
}, {
"name" : "START",
"id" : "84",
"displayName" : "Start Service",
"description" : "Starts this service"
}, {
"name" : "STOP",
"id" : "85",
"displayName" : "Stop Service",
"description" : "Stops this service"
}, {
"name" : "CLEANUP",
"id" : "86",
"displayName" : "Cleanup Sample XaaS Failed Request",
"description" : "Cleanup Sample Xaas Failed Request"
}, {
"name" : "SYNCSTARTSERVICE",
"id" : "87",
"displayName" : "Sync Start Service",
"description" : "Synchronous Action to Start Sample Service"
}, {
"name" : "SYNCSTOPSERVICE",
"id" : "88",
"displayName" : "Sync Stop Service",
"description" : "Synchronous Action to Stop Sample Service"
} ],
"name" : "Actions",
"type" : "Action",
"canonicalLink" : {
"href" :
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/2A2BD0D7C40F7C2814FA6788704E313
A/actions"
}
}

52.8.2.6 V2でサービス・インスタンスに対してアクションを実行するために必要なアクションの入力の詳細の表示

次の表にGETリクエスト構成を示します。

表52-47 V2でサービス・インスタンスに対してアクションを実行するために必要なアクションの入力の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/actions/{actionid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "START",
"id" : "94",
"displayName" : "START",
"actionInputs" : [ {
"name" : "WorkLoads",
"type" : "VECTOR",
"description" : "WorkLoad Values",
"required" : false,
"secret" : false,
"subvalues" : [ {
"name" : "Small",
"type" : "VECTOR",
"description" : "Configuration Values for Small WorkLoad",
"required" : false,
"secret" : false,
"subvalues" : [ {
"name" : "DEPL_SIZE_IS_DEFAULT_KEY",
"value" : "Y",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "CPU",
"value" : "60",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "MEMORY",
"value" : "4048",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "STORAGE",
"value" : "500",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "XAAS_TEST",
"value" : "NONE",
"type" : "STRING",
"required" : false,
"secret" : false
} ]
}, {
"name" : "Medium",
"type" : "VECTOR",
"description" : "Configuration Values for Medium WorkLoad",
"required" : false,
"secret" : false,
"subvalues" : [ {
"name" : "DEPL_SIZE_IS_DEFAULT_KEY",
"value" : "N",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "CPU",
"value" : "80",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "MEMORY",
"value" : "8088",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "STORAGE",
"value" : "750",
"type" : "STRING",
"required" : false,
"secret" : false
} ]
}, {
"name" : "Large",
"type" : "VECTOR",
"description" : "Configuration Values for Large WorkLoad",
"required" : false,
"secret" : false,
"subvalues" : [ {
"name" : "DEPL_SIZE_IS_DEFAULT_KEY",
"value" : "Y",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "CPU",
"value" : "60",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "MEMORY",
"value" : "40448",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "STORAGE",
"value" : "500",
"type" : "STRING",
"required" : false,
"secret" : false
} ]
} ]
} ],
"description" : "Starts this service"
}

52.8.2.7 V2でのサービス・インスタンスに対するアクションの実行

次の表にPUTリクエスト構成を示します。

表52-48 V2でサービス・インスタンスに対してアクションを実行するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"actionId":94,
"configurations":[
{
"name":"domainName",
"type":"STRING",
"description":"Domain Name",
"required":true,
"value":"/mwaas_rest_9_SSA_USER1/rest_9_SSA_USER1"
},
{
"name":"applicationName",
"type":"STRING",
"description":"Application Name",
"required":true,
"value":"test1"
}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests": [
{
"id": "4",
"actionName": "STOP",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/4"
}
}
]
}

52.8.3 V2でのサービス・インスタンスに対するアクションの実行

この項では、REST APIを使用してサービス・インスタンスに対してアクションを実行する手順を示します。

次の手順に従って、サービス・インスタンスに対してアクションを実行します。

1. URI - em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/actionsに対してGET操作を実行します。第52.8.2.5項「V2でのサービス・インスタンスに対して使用可能なアクションの詳細の表示」を参照してください。
GET操作は、指定したサービス・インスタンスに対してユーザーが実行できるサポートされるすべてのアクションを返します。各アクションの「アクション名」、「アクションID」、「表示名」および「説明」が提供されます。必要なアクションIDをメモします。

2. 前の手順のアクションIDを使用して、URI - /em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}/actions/{actionid}に対してGET操作を実行します。第52.8.2.6項「V2でサービス・インスタンスに対してアクションを実行するために必要なアクションの入力の詳細の表示」を参照してください。
GET操作は、すべてのアクション詳細とアクションの入力を返します。一部のアクションは、アクションの完了にアクションの入力を必要とします。アクションの入力は、インスタンスに対するアクションの実行中にユーザーが提供するデータまたは入力を取得します。アクションの入力をメモします。

3. 前の手順のアクションの入力を使用して、URI - /em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/{instanceid}に対してPUT操作を実行します。第52.8.2.7項「V2でのサービス・インスタンスに対するアクションの実行」を参照してください。
PUT操作は、サービス・インスタンスに対してアクションを実行します。アクションを実行するには、ペイロードのconfigurationsとして適切なアクション入力値を提供します。

52.9 V2の割当て制限使用量

この項では、SSAユーザーの割当て制限使用量REST APIについて説明します。

52.9.1 V2の割当て制限使用量でサポートされる操作

次の表に、割当て制限使用量でサポートされる操作を示します。

表52-49 割当て制限使用量でサポートされるメソッド

リクエスト・メソッド

URI

説明

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage

割当て制限使用量へのリンクを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/{servicefamily}

サービス・ファミリ別の割当て制限使用量を返します。

52.9.2 V2の割当て制限使用量REST APIの例

この項では、割当て制限使用量のREST APIの例を示します。次の例について説明します。

- 割当て制限使用量の詳細の表示

- サービス・ファミリ別の割当て制限使用量の詳細の表示

52.9.2.1 割当て制限使用量の詳細の表示

次の表にGETリクエスト構成を示します。

表52-50 割当て制限使用量の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/"
},
"usages": [
{
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/CFW_SAMPLEXAAS_SERVICEFAMILY"
}
},
{
"serviceFamily": "NIMBULA_INFRASTRUCTURE",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/NIMBULA_INFRASTRUCTURE"
}
},
{
"serviceFamily": "DBAAS",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/DBAAS"
}
},
{
"serviceFamily": "MIDDLEWARE_CFW",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/MIDDLEWARE_CFW"
}
}
],
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/"
}
}

52.9.2.2 サービス・ファミリ別の割当て制限使用量の詳細の表示

次の表にGETリクエスト構成を示します。

表52-51 サービス・ファミリ別に割当て制限使用量の詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/{servicefamily}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name": "Usages",
"type": "Usages Collection",
"totalResults": 4,
"cfwItems": [
{
"id": "sampleActionOpen",
"name": "Storage",
"type": "Others",
"allowed": "10.0",
"used": "3.0",
"unit": "GB"
},
{
"name": "Cfw Sample XaaS - Other Service",
"type": "Service Instances",
"serviceType": "CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM",
"used": "0"
},
{
"name": "Cfw Sample XaaS",
"type": "Service Instances",
"serviceType": "CFW_SAMPLEXAAS_SERVICE",
"used": "0"
},
{
"name": "Cfw Sample RemoteServer XaaS",
"type": "Service Instances",
"serviceType": "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"used": "0"
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/CFW_SAMPLEXAAS_SERVICEFAMILY"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/CFW_SAMPLEXAAS_SERVICEFAMILY"
}
}

52.10 V2のユーザー・プリファレンス

この項では、v2フレームワークのユーザー・プリファレンス・リソースについて説明します。

52.10.1 V2のユーザー・プリファレンス・リソースでサポートされるリクエスト・メソッド

次の表に、ユーザー・プリファレンス・リソースでサポートされるリクエスト・メソッドを示します。

表52-52 V2のユーザー・プリファレンス・リソースでサポートされるリクエスト・メソッド

リクエスト・メソッド

URI

説明

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/

一般プリファレンスおよびサービス固有のプリファレンスのトップ・レベル・ビューを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general

一般ユーザー・プリファレンスを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general/metadata

一般ユーザー・プリファレンスのメタデータを返します。

PUT

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general

ユーザーの一般プリファレンスを更新します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services

サービス・プリファレンスのトップ・レベル・ビューを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}

サービス・ファミリ・ユーザー・プリファレンスを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}/metadata

指定されたサービス・ファミリ・プリファレンスのメタデータを返します。

PUT

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}

サービス・ファミリ・ユーザー・プリファレンスを更新します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}/{servicetype}

サービス・タイプ・ユーザー・プリファレンスを返します。

GET

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}/{servicetype}/metadata

指定されたサービス・タイプ・プリファレンスのメタデータを返します。

PUT

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}/{servicetype}

ユーザーのサービス・ファミリ・プリファレンスを更新します。

52.10.2 V2のユーザー・プリファレンスREST APIの例

この項では、次のREST APIについて説明します。この項では、次の操作について説明します。

- V2のユーザー・プリファレンス・リソースの詳細の表示

- V2の一般ユーザー・プリファレンス・リソースの詳細の表示

- V2の一般ユーザー・プリファレンス・リソースのメタデータの表示

- V2の一般ユーザー・プリファレンスの更新

- V2のサービス・ユーザー・プリファレンス・リソースの詳細の表示

- V2のサービス・ファミリ・ユーザー・プリファレンス・リソースの詳細の表示

- V2のサービス・ファミリ・ユーザー・プリファレンスのメタデータの表示

- V2のサービス・ファミリ・ユーザー・プリファレンスの更新

- V2のサービス・タイプ・ユーザー・プリファレンス・リソースの詳細の表示

- V2のサービス・タイプ・ユーザー・プリファレンスのメタデータの表示

- V2のサービス・タイプ・ユーザー・プリファレンスの更新

52.10.2.1 V2のユーザー・プリファレンス・リソースの詳細の表示

次の表にGETリクエスト構成を示します。

表52-53 V2でユーザー・プリファレンス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"generalPreferences" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general",
"servicePreferences" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services",
"canonicalLink" : {
"href" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences"
}
}

52.10.2.2 V2の一般ユーザー・プリファレンス・リソースの詳細の表示

次の表にGETリクエスト構成を示します。

表52-54 V2で一般ユーザー・プリファレンス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "General Preference",
"type" : "General User Preferences",
"preferences" : [ {
"name" : "USER_LOCALE",
"value" : "en",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "English",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"type" : "VECTOR",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "This allows the user to receive notifications for different statuses of the request.",
"required" : false,
"secret" : false
}, {
"name" : "NOTIFICATION_DAYS_1",
"value" : "0",
"type" : "INTEGER",
"defaultValue" : "0",
"description" : "Number of days before the first notification is sent to the user before the expiry date of the service instance.",
"required" : false,
"secret" : false
}, {
"name" : "NOTIFICATION_DAYS_2",
"value" : "0",
"type" : "INTEGER",
"defaultValue" : "0",
"description" : "Number of days before the second notification is sent to the user before the expiry date of the service instance.",
"required" : false,
"secret" : false
}, {
"name" : "DEFAULT_SERVICE",
"value" : "MWAAS",
"type" : "STRING",
"defaultValue" : "IAAS",
"description" : "This will be used as your default service after successful login to Self Service Portal.",
"required" : false,
"secret" : false
}, {
"name" : "EMAIL",
"type" : "VECTOR",
"description" : "This is the default Email address for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "QUOTA_THRESHOLD",
"value" : "0.0",
"type" : "FLOAT",
"defaultValue" : "0.0",
"description" : "Notifications will be sent to users when resources exceed the defined quota percentage.",
"required" : false,
"secret" : false
}, {
"name" : "QUOTA_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "Receive quota related notification when the quota reaches the specified threshold.",
"required" : false,
"secret" : false
}, {
"name" : "INSTANCE_EXPIRY_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "Enables user to receive notifications for Service Instances that are due to expire based on the notification period.",
"required" : false,
"secret" : false
} ],
"meta" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general/metadata",
"canonicalLink" : {
"href" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general"
}
}

52.10.2.3 V2の一般ユーザー・プリファレンス・リソースのメタデータの表示

次の表にGETリクエスト構成を示します。

表52-55 V2で一般ユーザー・プリファレンス・リソースのメタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "General Preference",
"type" : "General User Preferences",
"preferences" : [ {
"name" : "USER_LOCALE",
"value" : "en",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "English",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false,
"possibleValues" : [ {
"name" : "USER_LOCALE",
"value" : "es_ES",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Spanish",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "ja",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Japanese",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "fr",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "French",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "ko",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Korean",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "de",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "German",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "zh_TW",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Traditional Chinese",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "zh_CN",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Simplified Chinese",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "en",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "English",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "pt_BR",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Brazilian Portuguese",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
} ]
}, {
"name" : "REQUEST_STATUS",
"type" : "VECTOR",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false,
"possibleValues" : [ {
"name" : "REQUEST_STATUS",
"value" : "PARTIAL_SUCCEEDED",
"type" : "VECTOR",
"displayName" : "Partially Succeeded",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "ERROR",
"type" : "VECTOR",
"displayName" : "Error",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "CANCELLED",
"type" : "VECTOR",
"displayName" : "Cancelled",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "EXECUTING",
"type" : "VECTOR",
"displayName" : "Running",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "SUCCESS",
"type" : "VECTOR",
"displayName" : "Success",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "SCHEDULED",
"type" : "VECTOR",
"displayName" : "Scheduled",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
} ]
}, {
"name" : "REQUEST_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "This allows the user to receive notifications for different statuses of the request.",
"required" : false,
"secret" : false
}, {
"name" : "NOTIFICATION_DAYS_1",
"value" : "0",
"type" : "INTEGER",
"defaultValue" : "0",
"description" : "Number of days before the first notification is sent to the user before the expiry date of the service instance.",
"required" : false,
"secret" : false
}, {
"name" : "NOTIFICATION_DAYS_2",
"value" : "0",
"type" : "INTEGER",
"defaultValue" : "0",
"description" : "Number of days before the second notification is sent to the user before the expiry date of the service instance.",
"required" : false,
"secret" : false
}, {
"name" : "DEFAULT_SERVICE",
"value" : "MWAAS",
"type" : "STRING",
"defaultValue" : "IAAS",
"description" : "This will be used as your default service after successful login to Self Service Portal.",
"required" : false,
"secret" : false
}, {
"name" : "EMAIL",
"type" : "VECTOR",
"description" : "This is the default Email address for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "QUOTA_THRESHOLD",
"value" : "0.0",
"type" : "FLOAT",
"defaultValue" : "0.0",
"description" : "Notifications will be sent to users when resources exceed the defined quota percentage.",
"required" : false,
"secret" : false
}, {
"name" : "QUOTA_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "Receive quota related notification when the quota reaches the specified threshold.",
"required" : false,
"secret" : false
}, {
"name" : "INSTANCE_EXPIRY_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "Enables user to receive notifications for Service Instances that are due to expire based on the notification period.",
"required" : false,
"secret" : false
} ],
"canonicalLink" : {
"href" :
"https://xxx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general/metadata"
}
}

52.10.2.4 V2の一般ユーザー・プリファレンスの更新

次の表にPUTリクエスト構成を示します。

表52-56 V2で一般ユーザー・プリファレンスを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"preferences":[
{
"value":"MWAAS",
"name":"DEFAULT_SERVICE"
},
{
"value":"false",
"name":"REQUEST_NOTIFICATION"
}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message" : "General preferences updated successfully."
}

52.10.2.5 V2のサービス・ユーザー・プリファレンス・リソースの詳細の表示

次の表にGETリクエスト構成を示します。

表52-57 V2でサービス・ユーザー・プリファレンス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"preferences" : [ {
"name" : "MIDDLEWARE_CFW",
"type" : "Service Family User Preferences",
"required" : false,
"secret" : false,
"meta" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/MIDDLEWARE_CFW/metadata",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/MIDDLEWARE_CFW"
}
}, {
"name" : "NIMBULA_INFRASTRUCTURE",
"type" : "Service Family User Preferences",
"required" : false,
"secret" : false,
"meta" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/NIMBULA_INFRASTRUCTURE/metadata",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/NIMBULA_INFRASTRUCTURE"
}
}, {
"name" : "DBAAS",
"type" : "Service Family User Preferences",
"required" : false,
"secret" : false,
"meta" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/DBAAS/metadata",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/DBAAS"
}
}, {
"name" : "CFW_SAMPLEXAAS_SERVICEFAMILY",
"type" : "Service Family User Preferences",
"required" : false,
"secret" : false,
"meta" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY"
}
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services"
}
}

52.10.2.6 V2のサービス・ファミリ・ユーザー・プリファレンス・リソースの詳細の表示

次の表にGETリクエスト構成を示します。

表52-58 V2でサービス・ファミリ・ユーザー・プリファレンス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

52.10.2.7 V2のサービス・ファミリ・ユーザー・プリファレンスのメタデータの表示

次の表にGETリクエスト構成を示します。

表52-59 V2でサービス・ファミリ・ユーザー・プリファレンスのメタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "CFW_SAMPLEXAAS_SERVICEFAMILY",
"type" : "Service Type User Preferences",
"preferences" : [ {
"name" : "SAMPLE_PREFERENCE_1",
"value" : "test",
"type" : "STRING",
"defaultValue" : "Sample Value 1",
"description" : "Type of the Supported Files",
"required" : false,
"secret" : false
} ],
"subPreferences" : [ {
"name" : "CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM",
"type" : "Service Type User Preferences",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata/CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM"
}
}, {
"name" : "CFW_SAMPLEXAAS_SERVICE",
"type" : "Service Type User Preferences",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata/CFW_SAMPLEXAAS_SERVICE"
}
}, {
"name" : "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"type" : "Service Type User Preferences",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata/CFW_SAMPLEXAAS_REMOTESERVER_SERVICE"
}
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata"
}
}

52.10.2.8 V2のサービス・ファミリ・ユーザー・プリファレンスの更新

次の表にPUTリクエスト構成を示します。

表52-60 V2でサービス・ファミリ・ユーザー・プリファレンスを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"preferences":[
{
"value":"test",
"name":"SAMPLE_PREFERENCE_1"
}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message" : "User service preferences updated successfully."
}

52.10.2.9 V2のサービス・タイプ・ユーザー・プリファレンス・リソースの詳細の表示

次の表にGETリクエスト構成を示します。

表52-61 V2でサービス・タイプ・ユーザー・プリファレンス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}/{servicetype}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "CFW_SAMPLEXAAS_SERVICE",
"type" : "Service Type User Preferences",
"preferences" : [ {
"name" : "SAMPLE_PREFERENCE_1",
"value" : "UPD_ST_Rest_14-09-06 11.59.34",
"type" : "STRING",
"defaultValue" : "Sample Value 1",
"description" : "Type of the Supported Files",
"required" : false,
"secret" : false
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/CFW_SAMPLEXAAS_SERVICE"
}
}

52.10.2.10 V2のサービス・タイプ・ユーザー・プリファレンスのメタデータの表示

次の表にGETリクエスト構成を示します。

表52-62 V2でサービス・タイプ・ユーザー・プリファレンスのメタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}/{servicetype}/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name" : "CFW_SAMPLEXAAS_SERVICE",
"type" : "Service Type User Preferences",
"preferences" : [ {
"name" : "SAMPLE_PREFERENCE_1",
"value" : "test",
"type" : "STRING",
"defaultValue" : "Sample Value 1",
"description" : "Type of the Supported Files",
"required" : false,
"secret" : false
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/CFW_SAMPLEXAAS_SERVICE/metadata"
}
}

52.10.2.11 V2のサービス・タイプ・ユーザー・プリファレンスの更新

次の表にPUTリクエスト構成を示します。

表52-63 V2でサービス・タイプ・ユーザー・プリファレンスを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/{servicefamily}/{servicetype}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"preferences":[
{
"value":"UPD_ST_Rest_14-09-07 12.03.39",
"name":"SAMPLE_PREFERENCE_1"
}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"message" : "User service preferences updated successfully."
}

52.11 V1のユーザー・プリファレンス

EM_SSA_USERロールを持つSSAユーザーは、Cloud REST APIを使用して、一般およびサービス固有の両方のユーザー・プリファレンスを設定できます。

52.11.1 V1のマイ・プリファレンス

これはトップ・レベルのリソースで、次のプリファレンスを取得するために使用されます。

- 一般プリファレンス

- サービス・プリファレンス: このプリファレンスには、マイ・データベース・プリファレンス、マイ・ミドルウェア・プリファレンスおよびマイ・テスト・プリファレンスがあります。

52.11.2 V1の正規のリンク

ユーザー・プリファレンスのURI (正規のリンク)は、em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/です。このURIに対するGETリクエストによって、一般的なプリファレンスとサービス固有プリファレンスのトップ・レベル・ビューが得られます。次の表に、このURIに対するGETリクエスト構成を示します。

表52-64 正規のリンク

メソッド

問合せパラメータ

リクエスト・ペイロード

URI

説明

GET

該当せず

該当せず

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/

一般プリファレンスおよびサービス固有のプリファレンスのトップ・レベル・ビューを提供します。

表52-65 マイ・プリファレンス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"servicePreferences":"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services",
"canonicalLink":"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/"

52.11.3 V1の一般プリファレンス

すべてのサービス・タイプに対して適用できる、一般的なユーザー・プリファレンスを表します。

表52-66 一般プリファレンス・データ・モデル

フィールド

タイプ

説明

発生

emailAddress

文字列

クラウド通知を受信するためのデフォルトの電子メール・アドレスです。

0..1

locale

文字列

クラウド通知を受信するためのデフォルトのロケールです。デフォルトのロケールは英語です。サポートされる値は次のとおりです。

- en (英語)

- es_ES (スペイン語)

- zh_CN (簡体字中国語)

- zh_TW (繁体字中国語)

- ja (日本語)

- ko (韓国語)

- fr (フランス語)

- pt_BR (ブラジル・ポルトガル語)

- de (ドイツ語)

0..1

request

RequestEntity

リクエスト通知の値。

0..1

instanceExpiry

InstanceExpiryEntity

インスタンス期限切れ通知の値。

0..1

割当て制限

QuotaEntity

インスタンス期限切れ通知の値。

0...1

quotaThreshold

整数

通知は、リソースが定義済の割当て率を超えると、ユーザーに送信されます。

0..1

defaultServiceType

文字列

セルフ・サービス・ポータルに正常にログインしたときのデフォルトのサービスです。指定しない場合、これがサーバーのデフォルトになります。サポートされるサービス・タイプの値には、IAAS (サーバー)、DBAAS (データベース)、MWAAS (ミドルウェア)、TAAS (テスト)などがあります。

0..1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

52.12 V1のコンポジット・リソース属性

この項では、次のコンポジット・リソース属性データ・モデルについて説明します。

- RequestEntity

- InstanceExpiryEntity

- QuotaEntity

52.12.1 V1のRequestEntityデータ・モデル

次の表では、RequestEntityデータ・モデルについて説明します。

表52-67 RequestEntityデータ・モデル

フィールド

タイプ

説明

発生

requestNotifications

boolean

リクエストの様々なステータス通知をユーザーが受信できるようにします。

0..1

requestStatus

リスト<文字列>

通知が有効となっているリクエスト・ステータスのリスト。サポートされるリクエスト・ステータス値は次のとおりです。

- 不完全

- スケジュール中

- スケジュール・エラー

- スケジュール済

- 取消済

- 割当て制限が不十分です

- ゾーンに十分なリソースがありません

- 処理中

- 実行エラー

- 部分的に成功

- 成功

- 実行中

- すべて

52.12.2 V1のInstanceExpiryEntityデータ・モデル

次の表では、InstanceExpiryEntityデータ・モデルについて説明します。

表52-68 InstanceExpiryEntityデータ・モデル

フィールド

タイプ

説明

発生

instanceExpiryNotifications

boolean

通知期間に基づき期限切れとなるようにスケジュールされているサービス・インスタンスの通知をユーザーが受信できるようにします。

0..1

daysBeforeFirstNotification

整数

サービス・インスタンスの期限切れの日付前に、最初の通知がユーザーに送信されるまでの日数。

0..1

daysBeforeSecondNotification

整数

サービス・インスタンスの期限切れの日付前に、2回目の通知がユーザーに送信されるまでの日数。

0..1

52.12.3 V1のQuotaEntityデータ・モデル

次の表では、QuotaEntityデータ・モデルについて説明します。

表52-69 QuotaEntityデータ・モデル

フィールド

タイプ

説明

発生

quotaNotifications

boolean

指定されたしきい値に割当てが到達したときに割当て関連の通知を受信します。

0..1

qutoaThreshold

整数

通知は、リソースが定義済の割当て率を超えると、ユーザーに送信されます。

0..1

52.13 一般プリファレンスに対してサポートされるメソッド(V1の場合)

次の表では、サポートされるメソッドについて説明します。

表52-70 サポートされるメソッド

メソッド

問合せパラメータ

リクエスト・ペイロード

URI

説明

GET

該当せず

該当せず

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/general

SSAユーザー用の一般プリファレンスを提供します。

PUT

該当せず

GeneralPreferences

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/general

SSAユーザー用の一般プリファレンスを更新します。

52.13.1 SSAユーザーの一般プリファレンスの詳細の表示

次の表は、SSAユーザーの一般リファレンスを確認するためのGETリクエスト構成を示します。

表52-71 SSAユーザーの一般プリファレンスの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/general/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"emailAddress": "john.smith@cloudcompany.com",
"locale": "English",
"request": {
"requestNotifications": true,
"requestStatus": ["SUCCESS","INCOMPLETE"]
}
"instanceExpiry": {
"instanceExpiryNotifications": true,
"daysBeforeFirstNotification": 10,
"daysBeforeSecondNotification": 5
},
"quota": {
"quotaNotifications": true,
"quotaThreshold": 80.0
},
"defaultServiceType": "Servers",
"canonicalLink":
"em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/general"
}

52.13.2 SSAユーザーの一般プリファレンスの更新

次の表は、SSAユーザーの一般リファレンスを更新するためのPUTリクエスト構成を示します。

表52-72 SSAユーザーの一般プリファレンスを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/general/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文(1つのフィールドの更新)

{
"emailAddress": "john.smith@cloudcompany.com",
"locale": "en",
"defaultServiceType": "IAAS",
}

本文(すべてのフィールドの更新)

{
"emailAddress": "john.smith@cloudcompany.com",
"locale": "en",
"request": {
"requestNotifications": true,
"requestStatus": ["SCHEDULED","INCOMPLETE"]
},
"instanceExpiry": {
"instanceExpiryNotifications": true,
"daysBeforeFirstNotification": 10,
"daysBeforeSecondNotification": 5
},
"quota": {
"quotaNotifications": true,
"quotaThreshold": 80
},
"defaultServiceType": "IAAS"
}

本文(通知フィールドの更新)

{
"request": {
"requestNotifications": true,
"requestStatus": ["SCHEDULED","INCOMPLETE"]
}
}

本文(期限切れ通知フィールドの更新)

{
"instanceExpiry": {
"instanceExpiryNotifications": true,
"daysBeforeFirstNotification": 10,
"daysBeforeSecondNotification": 5
}
}

本文(割当て制限通知フィールドの更新)

{
"quota": {
"quotaNotifications": true,
"quotaThreshold": 80
}
}

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK {      message:  "General Preferences updated successfully." }

52.14 V1のサービス固有のユーザー・プリファレンス

この項の内容は次のとおりです。

52.14.1 V1のサービス・プリファレンス

サービス・プリファレンス・リソースは、サービス・ファミリごとのSSAユーザーのユーザー・プリファレンスを表します。

表52-73 ServicePreferencesデータ・モデル

フィールド

タイプ

説明

発生

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

servicePreferences

コレクション<EntityValueHolder>

特定のサービス・ファミリにおけるSSAユーザーのユーザー・プリファレンス。

1

52.14.2 マイ・プリファレンスに対してサポートされるメソッド(V1の場合)

表52-74 サポートされるメソッド(II)

メソッド

問合せパラメータ

リクエスト・ペイロード

URI

説明

GET

該当せず

該当せず

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services

すべてのサービス・ファミリにおけるサービス・プリファレンスのトップ・レベル・ビューを提供します。

GET

該当せず

該当せず

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/ services/<servicefamily>

特定のサービス・ファミリにおけるSSAユーザーのユーザー・プリファレンスを提供します。

PUT

該当せず

ServicePreferences

em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/ services/< servicefamily >

特定のサービス・ファミリにおけるSSAユーザーのユーザー・プリファレンスを更新します。

52.14.3 V1のServicePreferenceMetadataデータ・モデル

特定のサービス・ファミリに関連するユーザー・プリファレンス・メタデータのセットをフェッチします。このデータ・モデルを使用することにより、ユーザーは、各サービス・ファミリで利用可能なユーザー・プリファレンスおよびそれぞれの値を識別できます。

表52-75 ServicePreferenceMetaDataデータ・モデル

フィールド

タイプ

説明

発生

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

servicePreferencesMeta

コレクション<ValueDescriptor>

特定のサービス・タイプに関連するユーザー・プリファレンス・メタデータのセット。

0..1

52.14.4 V1のコンポジット・リソース属性

この仕様のいくつかのリソース・エンティティには、次のコンポジット・リソース属性が含まれています。

52.14.4.1 V1のValueEntityデータ・モデル

値(文字列表現)およびその説明(キャプション)を表します。次の表で、このデータ・モデルについて説明します。

表52-76 ValueEntityデータ・モデル

フィールド

タイプ

説明

発生

value

文字列

エンティティの実際値の文字列表現

1

description

文字列

エンティティを説明するエンティティのキャプション

0..1

52.14.4.2 V1のEntityValueHolderデータ・モデル

名前、値および説明を持つ単一のエントリを表します。次の表で、このデータ・モデルについて説明します。

表52-77 EntityValueHolderデータ・モデル

フィールド

タイプ

説明

発生

name

文字列

エンティティの名前。

1

value

文字列

エンティティの実際値の文字列表現

1

description

文字列

エンティティを説明するエンティティのキャプション

0..1

52.14.4.3 V1のValueDescriptorデータ・モデル

関連付けられたオブジェクトに設定可能な値のタイプに関するメタデータを説明します。次の表で、このデータ・モデルについて説明します。

表52-78 ValueDescriptorデータ・モデル

フィールド

タイプ

説明

発生

name

文字列

記述するデータの名前

1

displayName

文字列

記述するデータの表示名

0..1

description

文字列

参照するデータの説明

0..1

currentValue

文字列

記述するデータの現在の値

0..1

isRequiredAttribute

boolean

データの値が必要な場合はtrue

0..1

possibleValues

コレクション<ValueEntity>

記述するデータの有効な値のリスト(オプション)

0..1

description

文字列

参照するデータの説明

0..1

52.14.5 V1のサービス・プリファレンスREST APIの例

この項では、サービス・プリファレンス・リソースのREST APIの例について説明します。

52.14.5.1 サービス・プリファレンス・リソースの詳細の表示

次の表に、すべてのサービス・ファミリにおけるサービス・プリファレンスのトップ・レベル・ビューを取得するためのGETリクエスト構成を示します。

表52-79 サービス・プリファレンス・リソースの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK

{
DBAAS: {
displayName: "My Database Preferences"
description: "User preferences for Database services"
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas"
}
MWAAS: {
displayName: "My Middleware Preferences"
description: "User preferences for Middleware services"
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/mwaas"
}
TAAS: {
displayName: "My Tests Preferences"
description: "User preferences for Testing as a Service (TaaS)"
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/taas"
}
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services"
}

52.14.6 V1のマイ・データベース・プリファレンスREST APIの例

この項では、データベース・サービスのプリファレンスを指定するマイ・データベース・プリファレンス・リソースのREST APIの例について説明します。

52.14.6.1 DBaaSユーザー・プリファレンス・メタデータの詳細の表示

次の表にGETリクエスト構成を示します。

表52-80 DBaaSユーザー・プリファレンス・メタデータの詳細を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK

{
servicePreferencesMetadata: {
items:
{
name: "defaultPaasZone"
displayName: "Default PaaS Infrastructure Zone"
description: "Default PaaS Infrastructure Zone"
currentValue: ""
isRequiredAttribute: false
possibleValues:
{
value: "dbaas_west_coast_zone"
}
}
}
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas/
metadata"
}

52.14.6.2 DBaaSユーザー・プリファレンスの更新

次の表にPUTリクエスト構成を示します。

表52-81 DBaaSユーザー・プリファレンスを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"servicePreferences":
{
"items":[
{
"name": "defaultPaasZone",
"value": "dbaas_west_coast_zone"
}
]
}
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK

{
message: Service Preferences updated successfully."
}

52.14.6.3 空白のDBaaSユーザー・プリファレンス設定の設定

次の表にPUTリクエスト構成を示します。

表52-82 空白のDBaaSユーザー・プリファレンス設定を設定するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"servicePreferences":
{
"items":[
{
"name": "defaultPaasZone",
"value": ""
}
]
}
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK

{
message: Service Preferences updated successfully."
}

52.14.6.4 DBaaSユーザー・プリファレンスの表示

次の表にGETリクエスト構成を示します。

表52-83 DBaaSユーザー・プリファレンス設定を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK

{
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas"
servicePreferences: {
items: {
name: "defaultPaasZone"
value: "dbaas_west_coast_zone"
}
}
}\

52.14.7 V1のマイ・ミドルウェア・プリファレンスREST APIの例

この項では、ミドルウェア・サービスのユーザー・プリファレンスREST APIの例を示します。

52.14.7.1 MWaaSユーザー・プリファレンス・メタデータの表示

次の表にGETリクエスト構成を示します。

表52-84 MWaaSユーザー・プリファレンス・メタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/mwaas/metadata/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK

{
servicePreferencesMetadata: {
items:
{
name: "defaultPaasZone"
displayName: "Default PaaS Infrastructure Zone"
description: "Default PaaS Infrastructure Zone"
currentValue: ""
isRequiredAttribute: false
possibleValues:
{
value: "mwaas_east_coast_zone"
}
}
}
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/mwaas/
metadata"
}

52.14.7.2 MWaaSユーザー・プリファレンスの更新

次の表にPUTリクエスト構成を示します。

表52-85 MWaaSユーザー・プリファレンスを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/mwaas/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"servicePreferences":
{
"items":[
{
"name": "defaultPaasZone",
"value": "mwaas_east_coast_zone"
}
]
}
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK

{
message: Service Preferences updated successfully."
}

52.14.7.3 空白のMWaaSユーザー・プリファレンス設定の設定

次の表にPUTリクエスト構成を示します。

表52-86 空白のMWaaSユーザー・プリファレンス設定を設定するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/mwaas/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

{
"servicePreferences":
{
"items":[
{
"name": "defaultPaasZone",
"value": ""
}
]
}
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK

{
message: Service Preferences updated successfully."
}

52.14.7.4 MWaaSユーザー・プリファレンス設定の表示

次の表にGETリクエスト構成を示します。

表52-87 MWaaSユーザー・プリファレンス設定を表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/mwaas/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK

{
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/mwaas"
servicePreferences: {
items: {
name: "defaultPaasZone"
value: "mwaas_west_coast_zone"
}
}
}

52.14.8 V1のマイ・テスト・プリファレンス

この項では、Testing as a Service (TaaS)のユーザー・プリファレンスREST APIの例を詳しく説明します。

52.14.8.1 TaaSユーザー・プリファレンス・メタデータの表示

次の表にGETリクエスト構成を示します。

表52-88 TaaSユーザー・プリファレンス・メタデータを表示するためのGETリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/taas/metadata

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

Status 200 OK

{
servicePreferencesMetadata: {
items:
{
name: "defaultInstanceRootPassword"
displayName: "Default Instance Root Password"
description: "The password that will be set as default root password to new
environment and test driver instance."
currentValue: ""
isRequiredAttribute: false
}
}
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/taas/m
etadata"
}

52.14.8.2 TaaSユーザー・プリファレンスの更新

次の表にPUTリクエスト構成を示します。

表52-89 TaaSユーザー・プリファレンスを更新するためのPUTリクエスト構成

機能

仕様

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/taas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"servicePreferences":
{
"items":[
{
"name": "defaultInstanceRootPassword",
"value": "AQPY8bgHk"
}
]
}
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message:  "Service Preferences updated successfully."
}

53 WebLogic as a Service REST API

この章では、WebLogic as a Service (WLaaS) REST APIのリソース・モデルとそのレスポンスについて説明します。WLaaSのゾーンでサポートされるアプリケーション・コンポーネントのフィルタ処理やテンプレートについても説明します。

注意:
プラグイン・リリース12.1.0.9では、v2フレームワークと呼ばれる新しいフレームワークがREST APIに導入されています。新しいフレームワークは異なるアプローチと署名から構成されるため、REST APIは以前のフレームワークと比較した場合にも異なります。以前のフレームワーク(v1)は非推奨になり、ユーザーはv2 REST APIへの移行を推奨されます。

この章の内容は次のとおりです。最初の2つの項でこの章のすべてのREST APIのサマリーを示し、その後の項でリソースの詳細や関連するREST APIについて説明します。

- V2のWebLogic as a Service REST APIのサマリー

- V1のWebLogic as a Service REST APIのサマリー

- V2のリソース・プロバイダ - PaaSインフラストラクチャ・ゾーンとミドルウェア・プール

- V2の割当て制限

- V2のサービス・テンプレート

- V2のロード・バランサ構成群

- V2のユーザー操作REST APIの例

- V1のWebLogic as a Serviceのリソース・モデル

- クラウド

- JaaSサービス・ファミリ・タイプ

- ゾーン

- JavaPlatformTemplate

- Javaプラットフォーム・インスタンス

- アプリケーション・インスタンス・デプロイメント

- DataSource

- アプリケーション・インスタンス・コンポーネント

- V1のアプリケーション・コンポーネントのフィルタ処理

- V1のロード・バランサ構成

- V1の割当て制限

- V1のサービス・テンプレート

- V1のユーザー操作REST APIの例

- EMCLIによる管理操作のサポート

53.1 V2のWebLogic as a Service REST APIのサマリー

次の表に、この章で説明するすべてのv2 WLaaS REST APIをまとめています。

表53-1 V2のWLaaS REST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

リソース・プロバイダ - PaaSインフラストラクチャ・ゾーン

表53-3

第53.3.1.1項

第53.3.1.2項

第53.3.1.4項

第53.3.1.6項

リソース・プロバイダ - ミドルウェア・プール

表53-3

第53.3.1.1項

第53.3.1.3項

第53.3.1.5項

第53.3.1.6項

割当て制限

表53-10

第53.4.1.1項

第53.4.1.2項

第53.4.1.3項

第53.4.1.4項

サービス・テンプレート群

表53-15

- 第53.5.1.1項

- 第53.5.1.2項

サポート対象外

サポート対象外

第53.5.1.3項

ロード・バランサの構成

表53-19

- 第53.6.2.1項

- 第53.6.2.2項

第53.6.2.3項

第53.6.2.4項

第53.6.2.5項

サービス・インスタンス

表53-26

- 第53.8.2項

- 第53.8.3項

- 第53.8.5項

第53.8.4項

- 第53.8.6項

- 第53.8.7項

- 第53.8.8項

- 第53.8.9項

第53.8.10項

アプリケーション

該当なし

- 第53.8.17項

- 第53.8.18項

サポート対象外

- 第53.8.12項

- 第53.8.13項

- 第53.8.14項

- 第53.8.15項

- 第53.8.16項

サポート対象外

データ・ソース

該当なし

サポート対象外

サポート対象外

- 第53.8.21項

- 第53.8.22項

- 第53.8.23項

- 第53.8.24項

- 第53.8.25項

サポート対象外

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

53.2 V1のWebLogic as a Service REST APIのサマリー

次の表に、この章で説明するすべてのv1 WLaaS REST APIをまとめています。

表53-2 V1のWLaaS REST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

Cloud

表53-52

第53.9.1.1項

サポート対象外

サポート対象外

サポート対象外

Jaasサービス・ファミリ・タイプ

表53-54

第53.9.2.1項

第53.9.2.2項

サポート対象外

サポート対象外

ゾーン

表53-56

第53.9.3.1項

サポート対象外

サポート対象外

サポート対象外

Javaプラットフォーム・テンプレート

表53-58

第53.9.4.1項

第53.9.4.2項

サポート対象外

サポート対象外

Javaプラットフォーム・インスタンス

表53-62

第53.9.5.1項

- 第53.9.5.4項

- 第53.9.5.6項

第53.9.5.8項

第53.9.5.2項

アプリケーション・インスタンス・デプロイメント

表53-71

第53.9.6.1項

第53.9.5.4項

第53.9.6.4項

第53.9.6.2項

データ・ソース

表53-76

第53.9.7.1項

第53.9.5.6項

第53.9.7.4項

第53.9.7.2項

アプリケーション・インスタンス・コンポーネント

アプリケーション・インスタンス・コンポーネントのデータ・モデル

第53.9.8.1項

サポート対象外

サポート対象外

第53.9.8.2項

サービス・テンプレート検索

該当なし

第53.10.1項

該当なし

該当なし

該当なし

ゾーン検索

該当なし

第53.10.2項

該当なし

該当なし

該当なし

ロード・バランサの構成

該当なし

- 第53.11.1.1項

- 第53.11.1.2項

第53.11.1.4項

第53.11.1.3項

サポート対象外

割当て制限

該当なし

第53.12.1.1項

第53.12.1.2項

第53.12.1.3項

第53.12.1.4項

サービス・テンプレート群

該当なし

サポート対象外

第53.13.1項

サポート対象外

サポート対象外

サービス・インスタンス

該当なし

サポート対象外

第53.14.5項

- 第53.14.1項

- 第53.14.2項

- 第53.14.4項(第53.14.3項も参照)

サポート対象外

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

53.3 V2のリソース・プロバイダ - PaaSインフラストラクチャ・ゾーンとミドルウェア・プール

リソース・プロバイダは、すべてのアクセス可能なリソース・プロバイダ・リソースのクラウド管理者ビューを表すコレクション・リソースです。WLaaS構造では、PaaSインフラストラクチャ・ゾーンとミドルウェア・プールはリソース・プロバイダ・リソースです。次の表では、リソース・プロバイダ・データ・モデルについて説明します。

表53-3 リソース・プロバイダ・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

このコレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプ。

1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

count

整数

返される要素の数。

1

items

コレクション<ResourceProvider>

リソース・プロバイダ・リソースのリスト。インスタンスが存在しない場合、itemsフィールドは空になります。

1

totalCount

整数

リソース・プロバイダ・リソースの総数。

1

canonicalLink

URI

このURIに対してGETリクエストを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

53.3.1 リソース・プロバイダ - PaaSインフラストラクチャ・ゾーンとミドルウェア・プールREST APIの例

この項では、PaaSインフラストラクチャ・ゾーンとミドルウェア・プールのREST APIの例を示します。

この項では、次のREST APIについて説明します。

- すべてのリソース・プロバイダの詳細の表示

- PaaSインフラストラクチャ・ゾーンの作成

- ミドルウェア・プールの作成

- PaaSインフラストラクチャ・ゾーンの更新

- ミドルウェア・プールの更新

- リソース・プロバイダの削除(PaaSインフラストラクチャ・ゾーンまたはミドルウェア・プール)

53.3.1.1 すべてのリソース・プロバイダの詳細の表示

次の表に、表現を返すリソース・プロバイダURIに対するGET操作の例を示します。

表53-4 リソース・プロバイダの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

53.3.1.2 PaaSインフラストラクチャ・ゾーンの作成

次の表に、PaaSインフラストラクチャ・ゾーンを作成するためのリソース・プロバイダURIに対するPOST操作の例を示します。

表53-5 PaaSインフラストラクチャ・ゾーンを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"useExistingTarget" : false,
"name": "WlaaS_Zone1","type": "self_service_zone",
"credentials": [ {"name":"normal_credential_guid", method","value": "AIME_CLOUD_CRED"}],
"memberTargetType": "host",
"members":["xyxy.example.com","xxxy.example.com"],
"placementConstraints":[{"name":"MAX_CPU_UTILIZATION","value":["80"]},{"name":"MAX_MEMORY_ALLOCATION","value":["80"]}],
"characteristics":[{"name":"ORACLE.SYSMAN.CFW.SELF_SERVICE_ZONE","value":["70F61D030338B79AFEC42E008AF6F6B7"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT","value":["123456789"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER","value":["IDC.LEX"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT","value":["FMW"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS","value":["Test"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS","value":["ST"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION","value":["IDC"]}],
"roles":["MWAS_SSA_USER_ROLE1"]
}

リクエスト・メソッド

POST

53.3.1.3 ミドルウェア・プールの作成

次の表に、ミドルウェア・プールを作成するためのリソース・プロバイダURIに対するPOST操作の例を示します。

表53-6 ミドルウェア・プールを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"useExistingTarget":"false",
"name":"WlaaS_Pool1","type":"mwaas_zone","description":"This is a Windows Pool for WLAAS testing",
"memberTargetType":"host",
"members":["xyxy.example.com","xxxy.example.com"],
"parentResourceProviderId":"1",
"placementConstraints":[{"name":"MAX_INSTANCES","value":"10"}],
"memberConstraints":[{"name":"ORACLE.SYSMAN.EMAS.MWC.WLAAS.PLATFORM","value":"226"}],
"characteristics":[{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER","value":"IDC"}]
}

リクエスト・メソッド

POST

53.3.1.4 PaaSインフラストラクチャ・ゾーンの更新

次の表に、PaaSインフラストラクチャ・ゾーンを更新するためのPUT操作の例を示します。

表53-7 PaaSインフラストラクチャ・ゾーンを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"description":"This is description frpm the REST PUT method",
"placementConstraints":[{"name":"MAX_CPU_UTILIZATION","value":["90"]},
{"name":"MAX_MEMORY_ALLOCATION","value":["90"]}
]
}

リクエスト・メソッド

PUT

53.3.1.5 ミドルウェア・プールの更新

次の表に、ミドルウェア・プールを更新するためのPUT操作の例を示します。

表53-8 ミドルウェア・プールを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/2

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"placementConstraints":[{"name":"NUMBER_OF_INSTANCES","value":["15"]}]
}

リクエスト・メソッド

PUT

53.3.1.6 リソース・プロバイダの削除(PaaSインフラストラクチャ・ゾーンまたはミドルウェア・プール)

次の表に、PaaSインフラストラクチャ・ゾーンまたはミドルウェア・プールを削除するためのDELETE操作の例を示します。

表53-9 PaaSインフラストラクチャ・ゾーンを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

53.4 V2の割当て制限

次の表に、割当て制限リソースのデータ・モデルを示します。

表53-10 V2の割当て制限データ・モデル

フィールド

タイプ

説明

発生

name

文字列

割当て制限の表示名。

1

description

文字列

割当て制限リソースの説明。

1

quotas

コレクション<割当て制限アイテム>

割当て制限のリスト。割当て制限が存在しない場合、quotas制限フィールドは空になります。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

53.4.1 割当て制限REST APIの例

この項では、割当て制限リソースのREST APIをリストします。

この項では、次のREST APIについて説明します。

- 割当て制限設定の詳細の表示

- SSAユーザー・ロールの割当て制限の作成

- SSAユーザー・ロールの割当て制限の更新

- SSAユーザー・ロールの割当て制限の削除

53.4.1.1 割当て制限設定の詳細の表示

次の表に、表現を返す割当て制限URIに対するGET操作の例を示します。この操作は、MWaaSのすべてのSSAユーザー・ロールの割当て制限設定を返します。

表53-11 割当て制限設定の詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Middleware Cloud Quotas"
description: "Middleware Cloud Quotas per SSA User Role"
quotas: [1]
0:  {
roleName: "SSA_USER_ROLE"
memory: "4"
javaServersCount: "10"
}-
-
selfLink: "https://slc06ekg.us.example.com:5416/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas"
}

53.4.1.2 SSAユーザー・ロールの割当て制限の作成

次の表に、SSAユーザー・ロールの割当て制限を作成するための割当て制限URIに対するPOST操作の例を示します。

表53-12 SSAユーザー・ロールの割当て制限設定を作成するためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"roleName": "SSA_ROLE"
"memory": "5"
"javaServersCount": "10"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message: "Quota has been created."
statusUri: "https://slc03sey.us.example.com:11040/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas"
}

53.4.1.3 SSAユーザー・ロールの割当て制限の更新

次の表に、SSAユーザー・ロールの割当て制限を更新するためのPUT操作の例を示します。

表53-13 SSAユーザー・ロールの割当て制限設定を更新するためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"roleName": "SSA_ROLE"
"memory": "10"
"javaServersCount": "5"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message: "Quota has been updated."
statusUri: "https://xxyy.us.example.com:11040/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas"
}

53.4.1.4 SSAユーザー・ロールの割当て制限の削除

次の表に、SSAユーザー・ロールの割当て制限を削除するためのDELETE操作の例を示します。

表53-14 SSAユーザー・ロールの割当て制限を削除するためのDELETEリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"roleName": "SSA_ROLE"
}

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message: "Quota has been deleted."
}

53.5 V2のサービス・テンプレート

サービス・テンプレートは、すべてのアクセス可能なサービス・テンプレート・リソースのSSA管理者ビューを表すコレクション・リソースです。次の表では、サービス・テンプレート・データ・モデルについて説明します。

表53-15 サービス・テンプレート・コレクション・リソース・データ・モデル

フィールド

タイプ

説明

発生

name

文字列

コレクション・リソースの名前を表示します。

1

type

文字列

コレクション・リソースのタイプを示します。

0..1

hasMore

Boolean

コレクションに他の要素があるかどうかを示します。

1

count

整数

返される要素の数。

1

items

コレクション<ServiceTemplate>

サービス・テンプレート・リソースのリスト。インスタンスが存在しない場合、itemsフィールドは空になります。

1

totalCount

整数

サービス・テンプレート・リソースの合計数。

1

canonicalLink

URI

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

53.5.1 サービス・テンプレートREST APIの例

この項では、v2のサービス・テンプレートのREST APIをリストします。

この項では、次のREST APIについて説明します。

- すべてのサービス・テンプレートの詳細の表示

- 特定のサービス・テンプレートの詳細の表示

- サービス・テンプレートの削除

53.5.1.1 すべてのサービス・テンプレートの詳細の表示

次の表に、表現を返すサービス・テンプレートURIに対するGET操作の例を示します。

表53-16 すべてのサービス・テンプレートの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

53.5.1.2 特定のサービス・テンプレートの詳細の表示

次の表に、表現を返す特定のサービス・テンプレートURIに対するGET操作の例を示します。

表53-17 特定のサービス・テンプレートの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/21

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

53.5.1.3 サービス・テンプレートの削除

次の表に、サービス・テンプレートを削除するためのDELETE操作の例を示します。

表53-18 サービス・テンプレートを削除するためのDELETEリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/21

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

53.6 V2のロード・バランサ構成群

ロード・バランサ構成群は、コレクション・リソースです。次の表に、ロード・バランサ構成群コレクション・リソースのデータ・モデルを示します。

表53-19 V2のロード・バランサ構成群データ・モデル

フィールド

タイプ

説明

発生

name

文字列

ロード・バランサ構成群の名前を表示します。

1

description

文字列

ロード・バランサ構成群リソースの説明。

1

lbrconfigs

コレクション<Lbrconfigアイテム>

ロード・バランサ構成群のリスト。ロード・バランサ構成群が存在しない場合、lbrconfigsフィールドは空になります。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

53.6.1 V2のロード・バランサ構成

ロード・バランサ構成は、単一リソースです。次の表に、ロード・バランサ構成単一リソースのデータ・モデルを示します。

表53-20 V2のロード・バランサ構成データ・モデル

フィールド

タイプ

説明

発生

name

文字列

ロード・バランサ構成の名前を表示します。

1

description

文字列

ロード・バランサ構成リソースの説明。

1

type

文字列

ロード・バランサのタイプを示します。Oracle Traffic Director (OTD)、Oracle Https Server(OHS)またはサード・パーティです。

1

id

整数

ロード・バランサの構成IDを示します。IDが一意かどうか。

1

owner

文字列

ロード・バランサ構成の所有者。

1

host

文字列

ロード・バランサ・ホスト。ロード・バランサ・ホストは、あらかじめEMターゲットとして追加する必要があります。

1

credential

文字列

ロード・バランサ・ホストに関連付けられている資格証明。

1

agentTargetName

文字列

エージェント・ターゲット名を示します。

1

instanceHome

文字列

ロード・バランサ・インスタンス・ホームの場所。

1

poolTargets

コレクション<プールGUID>

ロード・バランサ(リソース・プロバイダ)に関連付けられているミドルウェア・プールのGUIDのリスト。

1

properties

コレクション<文字列>

ロード・バランサ構成のすべてのプロパティのリスト。

1

selfLink

URI

これを含む要素と同等のリソースを参照します。

1

53.6.2 ロード・バランサ構成REST APIの例

この項では、v2のロード・バランサ構成のREST APIの詳細を示します。

この項では、次のREST APIについて説明します。

- すべてのロード・バランサ構成の表示

- 特定のロード・バランサ構成の詳細の表示

- ロード・バランサ構成の作成

- ロード・バランサ構成の更新

- ロード・バランサ構成の削除

53.6.2.1 すべてのロード・バランサ構成の表示

次の表に、すべてのロード・バランサ構成を表示するためのGET操作の例を示します。

表53-21 すべてのロード・バランサ構成の詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Load Balancer Configurations"
description: "Load Balancer Configurations available    "
selfLink: "https://xyxy.example.com:5416/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs"
lbrconfigs: [1]
0:  {
name: "ohs_1"
type: "OHS"
id: 1000
selfLink: "https://xyxy.example.com:5416/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs/1000"
}-
-
}

53.6.2.2 特定のロード・バランサ構成の詳細の表示

次の表に、特定のロード・バランサ構成を表示するためのGET操作の例を示します。

表53-22 特定のロード・バランサ構成の詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs/1000

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "ohs_1"
description: null
type: "OHS"
id: 1000
owner: "SSA_ADMIN1"
host: "xyxy.example.com"
credential: "Insufficient Priviege"
agentTargetName: "xxxy.example.com:1838"
instanceHome: "/scratch/PS5_OHS/instance_home"
poolTargets: [1]
0:  "10729BD1A3B12FA254232EE4F84CB71B"
-
properties: {
OHS_ROUTING_HTTP_PORT: "80"
HTTP_PORT_RANGE: "8000-9000"
OHS_ROUTING_PROTOCOL: "HTTP"
COMPONENT_NAME: "ohs1"
}-
selfLink: "https://xyxy.example.com:5416/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs/1000"
}

53.6.2.3 ロード・バランサ構成の作成

次の表に、ロード・バランサ構成を作成するためのPOST操作の例を示します。

表53-23 ロード・バランサ構成を作成するためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"name": "lbr1",
"description": "desc by rest",
"type": "OHS",
"host": "xyxy.example.com",
"agentTargetName": "xyxy.example.com:1838",
"credential": "NC_HOST_2014-08-13-015648",
"instanceHome": "/scratch/PS5_OHS/instance_home",
"properties":{ "items":
[
{"name":"HTTP_PORT_RANGE", "value":"8000-9000"},
{"name":"OHS_ROUTING_PROTOCOL", "value": "HTTP"},
{"name":"COMPONENT_NAME", "value": "ohs1"}
]
},
"poolTargets": [ "002E15567E25ED53EA2EC76BADE76B08" ]
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message: "Load Balancer Configuration has been created with ID: 1000"
statusUri: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs/1000"
}

53.6.2.4 ロード・バランサ構成の更新

次の表に、ロード・バランサ構成を更新するためのPUT操作の例を示します。

表53-24 ロード・バランサ構成を更新するためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"name": "lbr1",
"description": "desc by rest",
"type": "OHS",
"id": 1004,
"host": "xyxy.example.com",
"agentTargetName": "xyxy.example.com:1838",
"credential": "NC_HOST_2014-08-13-015648",
"instanceHome": "/scratch/PS5_OHS/instance_home",
"properties":{ "items":
[
{"name":"HTTP_PORT_RANGE", "value":"8001-9001"},
{"name":"OHS_ROUTING_PROTOCOL", "value": "HTTP"},
{ "name":"COMPONENT_NAME", "value": "ohs1"}
]
},
"poolTargets": [ "002E15567E25ED53EA2EC76BADE76B08" ]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message: "Load Balancer Configuration has been updated."
statusUri: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs"
}

53.6.2.5 ロード・バランサ構成の削除

次の表に、ロード・バランサ構成を削除するためのDELETE操作の例を示します。

表53-25 ロード・バランサ構成を削除するためのDELETEリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs/1000

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

Status 200 OK
{
message: "Load Balancer Configuration has been deleted."
}

53.7 V2のサービス・インスタンス・アクション

サービス・インスタンス・アクション・リソースはSSAユーザー・リソースです。次の表に、このリソースのデータ・モデルを示します。

表53-26 V2のサービス・インスタンス・アクション・データ・モデル

フィールド

タイプ

説明

発生

id

文字列

実行したアクションのリクエストID。

1

actionName

文字列

アクションの名前。

1

canonicalLink

文字列

このURIに対してGETリクエストを実行すると、このリソースのクライアント表現がリフレッシュされます。

1

53.8 V2のユーザー操作REST APIの例

この項では、次のREST API例について説明します。

- すべてのサービス・テンプレートの詳細の表示

- すべてのサービス・インスタンスの詳細の表示

- UPステータスのすべてのサービス・インスタンスの表示

- サービス・インスタンス・リクエストの作成

- 特定のサービス・インスタンスで可能なすべてのアクションの詳細の表示

- サービス・インスタンスのスケール・アップ

- サービス・インスタンスのスケール・ダウン

- サービス・インスタンスの停止

- サービス・インスタンスの起動

- サービス・インスタンスの削除

- ソフトウェア・ライブラリからのJava EEアプリケーション・コンポーネントの詳細の表示

- アプリケーションのデプロイ

- アプリケーションの再デプロイ

- アプリケーションのアンデプロイ

- アプリケーションの停止

- アプリケーションの起動

- ドメインにデプロイされたすべてのアプリケーションの詳細の表示

- アプリケーションURLの表示

- ドメインにデプロイされたライブラリの詳細の表示

- WebLogicコンソールURLの表示

- データソースの作成

- データ・ソースの編集

- データソースの削除

- すべてのデータソースの詳細の表示

- データソースのテスト

53.8.1 すべてのサービス・テンプレートの詳細の表示

次の表に、すべてのサービス・テンプレートを表示するためのGET操作の例を示します。

表53-27 すべてのサービス・テンプレートの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Services"
type: "Service"
totalResults: 1
cfwItems: [1]
0:  {
id: "1"
name: "PS4_LowHeapTemplate"
displayName: "PS4_LowHeapTemplate"
guid: "089D4C0EA3EB1E41E0532B54F20A7740"
serviceType: "WLAAS"
serviceFamily: "MIDDLEWARE_CFW"
description: "This is a service template using the profile"
meta:  "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/089D4C0EA3EB1E41E0532B54F20A7740/metadata"
canonicalLink: {
href:       "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/0  89D4C0EA3EB1E41E0532B54F20A7740"
}-
}-
-
canonicalLink: {
href: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/"
}-
selfLink: {
href: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/"
}-
}

53.8.2 すべてのサービス・インスタンスの詳細の表示

次の表に、すべてのサービス・インスタンスを表示するためのGET操作の例を示します。

表53-28 すべてのサービス・インスタンスの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Service Instances Summary"
totalResults: 1
serviceInstanceSummary: [1]
0:  {
status: "STATUS_UP"
href: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/?expanded=true&status=STATUS_UP"
count: 1
}-
-
canonicalLink: {
href: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances"
}-
selfLink: {
href: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances"
}-
}

53.8.3 UPステータスのすべてのサービス・インスタンスの表示

次の表に、UPステータスのすべてのサービス・インスタンスを表示するためのGET操作の例を示します。

表53-29 UPステータスのすべてのサービス・インスタンスを表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/?expanded=true&status=STATUS_UP

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Service Instances"
type: "Service Instance"
totalResults: 0
cfwItems: [0]
canonicalLink: {
href: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/?expanded=true&status=STATUS_UP"
}-
selfLink: {
href: "https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/?expanded=true&status=STATUS_UP"
}-
}

53.8.4 サービス・インスタンス・リクエストの作成

次の表に、サービス・インスタンスをリクエストするためのPOST操作の例を示します。

表53-30 サービス・インスタンス・リクエストを作成するためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"offeringId":"0731632460E41A38E0539D8DF50A9D13",
"name":"rest_inst01","instanceName":"rest_inst01",
"configurations": [{"name": "serviceName","value": "rest_inst01"},
{"name":"initialNumberOfManagedServers","value": "1"},
{"name": "wlsNewPassword","value": "extra3"},
{"name": "wlsNewUserName","value":"control1"}]
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"1","actionName":"CREATE",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloud       services/ssa/cfw/v2/servicerequests/1"}
}
]
}

53.8.5 特定のサービス・インスタンスで可能なすべてのアクションの詳細の表示

次の表に、特定のサービス・インスタンスで実行できるすべてのアクションの詳細を表示するためのGET操作の例を示します。

表53-31 特定のサービス・インスタンスで可能なすべてのアクションの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E/actions

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name":"Actions","type":"Action","totalResults":13,
"cfwItems":[
{"id":"10","name":"DELETE","displayName":"Delete","description":"Deletes WebLogic Service instance."},
{"id":"11","name":"START","displayName":"Start Instance","description":"Starts the WebLogic Service instance."},
{"id":"12","name":"STOP","displayName":"Stop Instance","description":"Stops the WebLogic Service instance."},
{"id":"13","name":"SCALE_UP","displayName":"Scale Up","description":"Scale up WebLogic Service instance."},
{"id":"14","name":"SCALE_DOWN","displayName":"Scale Down","description":"Scale down WebLogic Service instance."},
{"id":"15","name":"CREATEDATASOURCE","displayName":"Create Data Source","description":"Request for creating a Data source."},
{"id":"16","name":"EDITDATASOURCE","displayName":"Edit Data Source","description":"Request for editing a JDBC Data source."},
{"id":"17","name":"DELETEDATASOURCE","displayName":"Delete Data Source","description":"Request for deleting a JDBC Data source."},
{"id":"18","name":"DEPLOY_APP","displayName":"Deploy Application","description":"Deploy application from service."},
{"id":"19","name":"REDEPLOY_APP","displayName":"Redeploy Application","description":"Redeploy application from service."},
{"id":"20","name":"UNDEPLOY_APP","displayName":"Undeploy Application","description":"Undeploy application from service."},
{"id":"21","name":"STARTAPPLICATION","displayName":"Start Application","description":"Request for Starting a J2EE Application"},
{"id":"22","name":"STOPAPPLICATION","displayName":"Stop Application","description":"Request for Stopping a J2EE Application"}],
"canonicalLink":{"href":"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/7B7027E1E89427C6B3E8B9BE494AD9E8/actions"},
"selfLink":{"href":"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/7B7027E1E89427C6B3E8B9BE494AD9E8/actions"}
}

53.8.6 サービス・インスタンスのスケール・アップ

次の表に、サービス・インスタンスをスケール・アップするためのPUT操作の例を示します。

表53-32 サービス・インスタンスをスケール・アップするためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId":33,
"configurations": [{"name": "numberOfServers","value": "1"}]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"27",
"actionName":"SCALE_UP",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/27"}
}]
}

53.8.7 サービス・インスタンスのスケール・ダウン

次の表に、サービス・インスタンスをスケール・ダウンするためのPUT操作の例を示します。

表53-33 サービス・インスタンスをスケール・ダウンするためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId":34,
"configurations": [{"name": "numberOfServers","value": "1"}]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"28",
"actionName":" SCALE_DOWN",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/28"}
}]
}

53.8.8 サービス・インスタンスの停止

次の表に、サービス・インスタンスを停止するためのPUT操作の例を示します。

表53-34 サービス・インスタンスを停止するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId":32}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"29",
"actionName":" STOP",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/29"}
}]
}

53.8.9 サービス・インスタンスの起動

次の表に、サービス・インスタンスを起動するためのPUT操作の例を示します。

表53-35 サービス・インスタンスを起動するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId":31}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"30",
"actionName":" START ",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/30"}
}]
}

53.8.10 サービス・インスタンスの削除

次の表に、サービス・インスタンスを削除するためのPUT操作の例を示します。

表53-36 サービス・インスタンスを削除するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId":30}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"40",
"actionName":" DELETE",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/40"}
}]
}

53.8.11 ソフトウェア・ライブラリからのJava EEアプリケーション・コンポーネントの詳細の表示

次の表に、ソフトウェア・ライブラリからのJava EEアプリケーション・コンポーネントの詳細を表示するためのGET操作の例を示します。

表53-37 ソフトウェア・ライブラリからのJava EEアプリケーション・コンポーネントの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/wlaas/v2/javaeeappcomponents

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"name":"Java EE Application Components uploaded in My Library ",
"selfLink":"https://xyxy.example.com:443/em/websvcs/restful/extws/cloudservices/ssa/wlaas/v2/javaeeappcomponents",
"appUrns":[{"type":"Java EE Application","description":null,"status":"Ready","appName":"Riddles","creator":"MWAS_SSA_USER1","revision":"0.1", "maturity":"Untested","createdTime":"2014-10-28 01:42:22.0",
"appUrn":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_JavaEEApplication:06783833EA2545ECE0537492F20AAD84:0.1"},
{"type":"Java EE Application","description":null,"status":"Ready","appName":"riddles_1413283657449",
"creator":"MWAS_SSA_USER1","revision":"0.1","maturity":"Untested","createdTime":"2014-10-14 10:47:37.0",
"appUrn":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_JavaEEApplication:055ED28CCB3F3E9BE0537492F20A5827:0.1"}
]
}

53.8.12 アプリケーションのデプロイ

次の表に、アプリケーションをデプロイするためのPUT操作の例を示します。

表53-38 アプリケーションをデプロイするためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId": 38,
"configurations":
[{"name": "applicationName","value": "Riddles_app"},
{"name": "isSharedLibrary","value": "false"},
{"name":"applicationUrn","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_JavaEEApplication:077E2D85D70E60D0E0539D8DF50A19F1:0.1"}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"31",
"actionName":" DEPLOY_APP",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/31"}
}]
}

53.8.13 アプリケーションの再デプロイ

次の表に、アプリケーションを再デプロイするためのPUT操作の例を示します。

表53-39 アプリケーションを再デプロイするためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId": 39,
"configurations":
[{"name": "applicationName","value": "Riddles_app"},
{"name": "isSharedLibrary","value": "false"},
{"name": "applicationUrn","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_JavaEEApplication:06783833EA2545ECE0537492F20AAD84:0.1"}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"32",
"actionName":" REDEPLOY_APP ",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/32"}
}]
}

53.8.14 アプリケーションのアンデプロイ

次の表に、アプリケーションをアンデプロイするためのPUT操作の例を示します。

表53-40 アプリケーションをアンデプロイするためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId": 40,
"configurations":
[{"name": "applicationName","value": "Riddles_app"}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"33",
"actionName":" UNDEPLOY_APP",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/33"}
}]
}

53.8.15 アプリケーションの停止

次の表に、アプリケーションを停止するためのPUT操作の例を示します。

表53-41 アプリケーションを停止するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId": 41,
"configurations":
[{"name": "applicationName","value": "Riddles_app"},
{"name": "moduleType","value": "ear"}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"34",
"actionName":" STOPAPPLICATION",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/34"}
}]
}

53.8.16 アプリケーションの起動

次の表に、アプリケーションを起動するためのPUT操作の例を示します。

表53-42 アプリケーションを起動するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId": 42,
"configurations":
[{"name": "applicationName","value": "Riddles_app"},
{"name": "moduleType","value": "ear"}
]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"35",
"actionName":" STARTAPPLICATION",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/35"}
}]
}

53.8.17 ドメインにデプロイされたすべてのアプリケーションの詳細の表示

次の表に、ドメインにデプロイされたすべてのアプリケーションの詳細を表示するためのGET操作の例を示します。

表53-43 ドメインにデプロイされたすべてのアプリケーションの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E/applications

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Applications "
description: "Applications deployed in the domain"
selfLink: "https://xyxy.example.com:5416/em/websvcs/restful/extws/cloudservices/ssa/wlaas/v2/serviceinstances/0148F63816763D1C34900CBDCB86C3DB/applications"
apps: [1]
0:  {
appName: "/mwaas_slc06ekg__1_149e5639b55_SSA_USER1/slc06ekg__1_149e5639b55_SSA_USER1/Cluster_1/app1"
moduleType: "war"
appDisplayName: "app1"
}-
}

53.8.18 アプリケーションURLの表示

次の表に、アプリケーションのURLを表示するためのPUT操作の例を示します。

表53-44 アプリケーションのURLの詳細を表示するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E/applications

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{ "appDisplayName": "app1"}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
name: "Application URLs"
description: "Applications URLs for deployed Application"
appName: "app1"
selfLink: "https://xyxy.example.com:5416/em/websvcs/restful/extws/cloudservices/ssa/wlaas/v2/serviceinstances/0148F63816763D1C34900CBDCB86C3DB/applications"
apps: [1]
0:  {
httpsurl: "http://xyxy.example.com:18536/Calendar"
httpsUrl: "https://xyxy.example.com:13241/Calendar"
}
}

53.8.19 ドメインにデプロイされたライブラリの詳細の表示

次の表に、ドメインにデプロイされたすべてのライブラリの詳細を表示するためのGET操作の例を示します。

表53-45 ドメインにデプロイされたすべてのライブラリの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E/libraries

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Libraries"
description: "Libraries deployed in the domain"
selfLink: "https://xyxy.example.com:5416/em/websvcs/restful/extws/cloudservices/ssa/wlaas/v2/serviceinstances/0148F63816763D1C34900CBDCB86C3DB/libraries"
libs: [18]
0:  {
libName: "oracle.adf.desktopintegration.model"
libDisplayName: "oracle.adf.desktopintegration.model(1.0,11.1.1.2.0)"
}-
1:  {
libName: "adf.oracle.domain.webapp"
libDisplayName: "adf.oracle.domain.webapp(1.0,11.1.1.2.0)"
}-
2:  {
libName: "oracle.adf.desktopintegration"
libDisplayName: "oracle.adf.desktopintegration(1.0,11.1.1.2.0)"
}-
3:  {
libName: "ohw-uix"
libDisplayName: "ohw-uix(5,5.0)"
}-
4:  {
libName: "oracle.wsm.seedpolicies"
libDisplayName: "oracle.wsm.seedpolicies(11.1.1,11.1.1)"
}-
5:  {
libName: "adf.oracle.domain"
libDisplayName: "adf.oracle.domain(1.0,11.1.1.2.0)"
}-
6:  {
libName: "oracle.pwdgen"
libDisplayName: "oracle.pwdgen(11.1.1,11.1.1.2.0)"
}-
7:  {
libName: "oracle.jrf.system.filter"
libDisplayName: "oracle.jrf.system.filter"
}-
8:  {
libName: "oracle.dconfig-infra"
libDisplayName: "oracle.dconfig-infra(11,11.1.1.1.0)"
}-
9:  {
libName: "orai18n-adf"
libDisplayName: "orai18n-adf(11,11.1.1.1.0)"
}-
10:  {
libName: "ohw-rcf"
libDisplayName: "ohw-rcf(5,5.0)"
}-
11:  {
libName: "jsf"
libDisplayName: "jsf(1.2,1.2.9.0)"
}-
12:  {
libName: "adf.oracle.businesseditor"
libDisplayName: "adf.oracle.businesseditor(1.0,11.1.1.2.0)"
}-
13:  {
libName: "oracle.jsp.next"
libDisplayName: "oracle.jsp.next(11.1.1,11.1.1)"
}-
14:  {
libName: "oracle.adf.management"
libDisplayName: "oracle.adf.management(1.0,11.1.1.2.0)"
}-
15:  {
libName: "UIX"
libDisplayName: "UIX(11,11.1.1.1.0)"
}-
16:  {
libName: "jstl"
libDisplayName: "jstl(1.2,1.2.0.1)"
}-
17:  {
libName: "oracle.adf.dconfigbeans"
libDisplayName: "oracle.adf.dconfigbeans(1.0,11.1.1.2.0)"
}-
}

53.8.20 WebLogicコンソールURLの表示

次の表に、WebLogicコンソールURLを表示するためのGET操作の例を示します。

表53-46 WebLogicコンソールURLを表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E/weblogicconsoleurls

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

53.8.21 データ・ソースの作成

次の表に、データソースを作成するためのPUT操作の例を示します。

表53-47 データソースを作成するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId": 35,
"configurations": [{"name": "dsName","value": "Test_DS1"},
{"name": "jndiName","value": "DS_1"},
{"name": "driverClass","value": "oracle.jdbc.OracleDriver"},
{"name": "jdbcUrl","value": "jdbc:oracle:thin:@xyxy.example.com:13914:db2430"},
{"name": "dbUserName","value": "sysman"},
{"name": "dbPassword","value": "Welcome1"}]}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"36",
"actionName":" CREATEDATASOURCE",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/36"}
}]
}

53.8.22 データ・ソースの編集

次の表に、データソースを編集するためのPUT操作の例を示します。

表53-48 データソースを編集するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId": 36,
"configurations": [{"name": "dsName","value": "Test_DS1"},
{"name": "jndiName","value": "DS_1_edit"},
{"name": "driverClass","value": "oracle.jdbc.OracleDriver"},
{"name": "jdbcUrl","value": "jdbc:oracle:thin:@xyxy.example.com:13914:db2430"},
{"name": "dbUserName","value": "sysman"},
{"name": "dbPassword","value": "Welcome1"}]}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"37",
"actionName":" EDITDATASOURCE",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/37"}
}]
}

53.8.23 データソースの削除

次の表に、データソースを削除するためのPUT操作の例を示します。

表53-49 データソースを削除するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{"actionId": 37,
"configurations": [{"name": "dsName","value": "Test_DS1"}]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"38",
"actionName":" DELETEDATASOURCE",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/38"}
}]
}

53.8.24 すべてのデータソースの詳細の表示

次の表に、すべてのデータソースの詳細を表示するためのGET操作の例を示します。

表53-50 すべてのデータソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/wlaas/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E/datasources

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Data Sources"
description: "Data Sources in the domain"
selfLink: "https://xyxy.example.com:5416/em/websvcs/restful/extws/cloudservices/ssa/wlaas/v2/serviceinstances/0148F63816763D1C34900CBDCB86C3DB/datasources"
datasources: [1]
0:  {
jndiName: [1]
0:  "ds_1"
-
driverClass: null
dbUrl: "jdbc:oracle:thin:@xyxy.example.com:15044:sekg3"
dsName: "ds_1"
driverKey: "oracle.jdbc.OracleDriver"
}-
-
}

53.8.25 データソースのテスト

次の表に、データソースをテストするためのPUT操作の例を示します。

表53-51 データソースをテストするためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/wlaas/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E/datasources

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{  "dsName": "ds_1" }

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
message: "Test Connection succeeded for data source "
statusUri: "https://xyxy.example.com:5416/em/websvcs/restful//extws/cloudservices/ssa/wlaas/v2/serviceinstances"
}

53.9 V1のWebLogic as a Serviceのリソース・モデル

次の各項では、Java as a Serviceファミリ・タイプでサポートされるリソース・モデルについて説明し、サポートされる操作の例を示します。次のリソース・モデルについて説明します。

- クラウド

- JaaSサービス・ファミリ・タイプ

- ゾーン

- JavaPlatformTemplate

- Javaプラットフォーム・インスタンス

- アプリケーション・インスタンス・デプロイメント

- DataSource

- アプリケーション・インスタンス・コンポーネント

- サービス・テンプレートのフィルタ処理

- ゾーンのフィルタ処理

次の図は、WebLogic as a Serviceのリソース・モデルを示しています。

図53-1 WLaaSのリソース・モデル

53.9.1 クラウド

次の表では、クラウド[application/oracle.com.cloud.common.Cloud+json]のデータ・モデルについて説明します。

表53-52 クラウド・リソースのデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

ユーザー用の名前。様々な言語をサポートするUNICODE文字列です。

1

description

文字列

簡単な説明。様々な言語をサポートするUNICODE文字列です。

0...1

service_template

コレクション<ServiceTemplates>

ユーザーがアクセス可能なサービス・テンプレートのリスト。

0..1

zones

コレクション<Zone>

クラウドでサポートされる、ユーザーがアクセス可能なゾーンのリスト。

0..1

service_family_type

コレクション<ServiceFamilyType>

クラウドでサポートされるサービス・ファミリ・タイプのリスト。

0..1

resource_state

ResourceState

実行中のオンラインのクラウドの状態はREADYです。このフィールドが返されない場合、クライアントはクラウドがREADYであると想定できます。返されたフィールドの状態がREADYでない場合、クライアントはクラウドへのその後の相互作用の実行可能性を想定できません。

0..1

media_type

文字列

このメディア・タイプのペイロード形式の値。例: application/oracle.com.cloud.common.Cloud+json。

1

canonicalLink

文字列

この正規化されたまたは正規のURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

53.9.1.1 クラウド・リソースの詳細の表示

次に、表現を返すクラウドURIに対するGET操作の例を示します。

リクエストの例:

表53-53 クラウド・リソースを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.Cloud+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例:

{
"uri" : "/em/cloud" ,
"name" : "Oracle Cloud by Enterprise Manager" ,
"description" : "This represents the Cloud resource of the Oracle Enterprise Manager Cloud Management solution" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.common.Cloud+json" ,
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0
/ssa/em/cloud" ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.common.Zone+json" ,
"total" : "3" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51"
} ,
{
"uri" : "/em/cloud/dbaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"description" : "Zone for Physical Pool" ,
"media_type" : "application/oracle.com.cloud.common.DbZone+json" ,
"type" : "self_service_zone"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51"
} ,
{
"uri" : "/em/cloud/opc/opczone" ,
"name" : "OPC Zone" ,
"media_type" : "application/oracle.com.cloud.opc.OpcZone+json" ,
"service_family_type" : "opc" ,
"type" : "opc"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/opc"
}
]
} ,
"service_templates" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" ,
"total" : "5" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
"name" : "PS4_LowHeapTemplate" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA"
} ,
{
"uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03030FAE80F6B58E040F20AD1812FE2%3A0.1" ,
"name" : " rtriddappjul18_Deploy_20120718_051319824" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03030FAE80F6B58E040F20AD1812FE2%3A0.1"
} ,
{
"uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03517A824EBFCF9E040F20AD1811CD9%3A0.1" ,
"name" : "FileUploadFromCode" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03517A824EBFCF9E040F20AD1811CD9%3A0.1"
} ,
{
"uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03EFA365D58A674E040F20AD18134AE%3A0.1" ,
"name" : "Test_1354864500315" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03EFA365D58A674E040F20AD18134AE%3A0.1"
} ,
{
"uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD1103FE5F6877372E040F20AD1814215%3A0.1" ,
"name" : "RiddleApp" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD1103FE5F6877372E040F20AD1814215%3A0.1"
}
]
} ,
"service_family_types" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"total" : "4" ,
"elements" :
[
{
"uri" : "/em/cloud/service_family_type/jaas" ,
"name" : "jaas" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "jaas"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
} ,
{
"uri" : "/em/cloud/service_family_type/dbaas" ,
"name" : "dbaas" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "dbaas"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/dbaas"
} ,
{
"uri" : "/em/cloud/service_family_type/opc" ,
"name" : "opc" ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"type" : "opc"
canonicalLink: "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/opc"
} ,
{
"uri" : "/em/cloud/service_family_type/iaas" ,
"name" : "iaas" ,
"media_type" : "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json" ,
"type" : "iaas"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/iaas"
}
]
} ,
"service_requests" :     {
"media_type" : "application/oracle.com.cloud.common.Request+json" ,
"total" : "0" ,
"elements" :
[      ]
}
}

53.9.2 JaaSサービス・ファミリ・タイプ

JaaSサービス・ファミリ・タイプは、WebLogic as a Service (WLaaS)によって提供されるサービスのカテゴリです。次の表では、Jaas ServiceFamilyType [application/oracle.com.cloud.common.ServiceFamilyType+json]のデータ・モデルについて説明します。

表53-54 JaaSサービス・ファミリ・タイプのデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーに対するJaas ServiceFamilyType定義のクライアント表現がリフレッシュされます。

1

name

文字列

Jaasサービス・ファミリ・タイプの名前。

1

description

文字列

サービス・ファミリ・タイプのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

1

resource_state

ResourceState

リソースのリソース状態。

0..1

media_type

文字列

リソースのメディア・タイプ。

1

service_templates

コレクション<ServiceTemplate>

このサービス・ファミリ・タイプのサービス・テンプレートのコレクション。

0..1

zones

コレクション<Zone>

このサービス・ファミリ・タイプのサービス・インスタンスをサポートするゾーンのコレクション。

0..1

instance_types

コレクション<Instance Type>

このサービス・ファミリ・タイプによってサポートされるインスタンス・タイプのコレクション。

0..1

canonicalLink

文字列

この正規化されたまたは正規のURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

53.9.2.1 JaaSサービス・ファミリ・タイプ・リソースの詳細の表示

次に、JaaSサービス・ファミリ・タイプURIにGET操作を実行してその表現を返す例を示します。

リクエストの例:

表53-55 JaaSサービス・ファミリ・タイプ・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/service_family_type/jaas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.ServiceFamilyType+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例:

{
"uri" : "/em/cloud/service_family_type/jaas" ,
"name" : "jaas" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas" ,
"type" : "jaas" ,
"service_templates" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
"name" : "PS4_LowHeapTemplate" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA"
}
]
}
"zones" :     {
"media_type" : "application/oracle.com.cloud.common.Zone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas" ,
"type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51"
}
]
} ,
"instance_types" :     {
"media_type" : "application/oracle.com.cloud.common.InstanceType+json" ,
"total" : "0" ,
"elements" :
[      ]
} ,
"service_requests" :     {
"total" : "0" ,
"elements" :
[      ]
}
}

53.9.2.2 Jaasサービス・ファミリ・タイプ・リソースへのPOSTリクエスト渡しによるアプリケーション・インスタンス・コンポーネントの作成

JaaSに対しポスト・リクエストを使用して、ApplicationInstanceComponentを作成できます。現在これはJavaプログラムを使用して実行されています。次にサンプル・プログラムを示します。

注意:
<<>>には、適切な値のヒントを示しています。

import java.io.File;
import java.io.FileInputStream;
import java.io.PrintWriter;
import java.io.StringWriter;

import java.util.ArrayList;
import java.util.List;
import java.util.Properties;

import oracle.sysman.emInternalSDK.ssa.cloudapi.client.EMRestService;

public class FileUpload {
static public void main(String[] args)
throws Exception {
String emUser = <<JAAS_USER_NAME>>;
String emPassword = <<password>>";
String emHost = <<host_machine_name/ip>>;
String emPort = <<port>>;
String emLocation = "https://"+emHost+":"+emPort;
String applicationLocation = <<application_location>>;
String deployPlanLocation = <<deploy_plan_location>>;
File f = new File(applicationLocation+"deploy_app.ear");          StringWriter sw = new StringWriter();
PrintWriter pw =new PrintWriter(sw);
pw.println("{");
String fileName = "MyApplication"+emUser+"_"+System.currentTimeMillis();
pw.println("\"name\":"+"\""+fileName+"\",");
pw.println("\"description\":\"Riddles App\",");
pw.println("\"originate\":\"STREAMING\",");
pw.println("\"files\":[");
pw.println("{");
//pw.println("\"path\":\"swlib_internal_path\",");
pw.println("\"file_archive_path\":\"swlib_internal_path\",");
pw.println("\"content_type\":\"application/octet-stream\",");
pw.println("\"source\":\""+f.getName()+"\"");
pw.println("}");
pw.println("]");
pw.print("}");
pw.flush();
pw.close();
String content = sw.toString();
System.out.println("CONTENT:\n"+content+"\n");
//String content = "{\n\"name\":\"STOPPED\"\n}";
List<EMRestService.MultipartItem> items = new ArrayList<EMRestService.MultipartItem>();
EMRestService.MultipartItem item1, item2, item3, item4, item5;
item1 = new EMRestService.MultipartItem("item1", false);
item1.setContentType("multipart/form-data");
item1.setContent(content);
items.add(item1);
item2 = new EMRestService.MultipartItem("item2", true);
item2.setFileAlias(f.getName());
item2.setFile(f);
items.add(item2);
File deploymentPlanFile = new File(applicationLocation+"deployment_plan.xml");
item3 = new EMRestService.MultipartItem("item3", true);
item3.setFileAlias(deploymentPlanFile.getName());
item3.setFile(deploymentPlanFile);
items.add(item3);
File preDeployFile = new File(deployPlanLocation+" predeploy_script.py");
item4 = new EMRestService.MultipartItem("item4", true);
item4.setFileAlias(preDeployFile.getName());
item4.setFile(preDeployFile);
items.add(item4);
File postDeployFile = new File(deployPlanLocation+" postdeploy_script.py");
item5 = new EMRestService.MultipartItem("item5", true);
item5.setFileAlias(postDeployFile.getName());
item5.setFile(postDeployFile);
items.add(item5);

String uri = emLocation+"/em";
EMRestService ers = new EMRestService(uri, emUser, emPassword.getBytes());
ers.setReadTimeout(600*1000);
Object o = ers.webserviceMultipart(EMRestService.Method.POST, uri+"/cloud/service_family_type/jaas", "application/oracle.com.cloud.jaas.ApplicationInstanceComponent", items);
System.out.println(o);
}
}

53.9.3 Zone

次の表では、ゾーン[application/oracle.com.cloud.common.Zone+json]のデータ・モデルについて説明します。

表53-56 ゾーンのデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーに対するゾーン定義のクライアント表現がリフレッシュされます。

1

name

文字列

ゾーンの名前。

1

description

文字列

ゾーンのユーザー用の説明。様々な言語をサポートするUNICODE文字列です。

0...1

context_id

文字列

ゾーンの内部参照を示すIDです

1

service_instances

コレクション<ServiceInstance>

このゾーン内にあるサービス・インスタンスのコレクション。

0..1

service_family_type

文字列

このゾーンが関連付けられているサービス・ファミリ・タイプの名前。各ゾーンはサービス・ファミリ・タイプのコンテキストに当てはめられます。

0..1

resource_state

ResourceState

リソースのリソース状態。

0..1

media_type

文字列

リソースのメディア・タイプ。

1

canonicalLink

文字列

この正規化されたまたは正規のURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

53.9.3.1 ゾーン・リソースの詳細の表示

次に、表現を返すゾーンURIに対するGET操作の例を示します。

リクエストの例:

表53-57 ゾーンの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.Zone+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例:

{
"uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"description" : "Zone for Physical Pool" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas" ,
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/ A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42" ,
"name" : "MyServer-1" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"status" : "RUNNING"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42"
}
]
}
}

53.9.4 JavaPlatformTemplate

JavaPlatformTemplateは、CloudServiceTemplate SDKクラスを拡張します。JavaPlatformTemplateのインスタンスでServiceTemplateメディア・タイプを受け入れることができます。また、JavaPlatformInstanceリソースを認識する事前構成されたデプロイ可能なエンティティです。

次の表では、JavaPlatformTemplate [application/oracle.com.cloud.jaas.JavaPlatformTemplate+json]のデータ・モデルについて説明します。

表53-58 JavaPlatformTemplateデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

テンプレートのユーザー用の名前。

1

description

文字列

テンプレートの簡単な説明。

0...1

created

Timestamp

テンプレートが作成または最後に変更された日付と時刻(ISO 8601形式)。

1

zones

コレクション<Zone>

このテンプレート用に構成されたすべてのゾーンのリスト。

1

service_family_type

文字列

サービス・テンプレートのタイプを表します("jaas"など)。

1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

service_instances

コレクション

<JavaPlatformInstance>

このJavaPlatformTemplateに基づいて作成されたすべてのサービス・インスタンス。

0…1

media_type

文字列

このタイプが表すサービス・テンプレートのメディア・タイプ。

1

default_instance_media_type

文字列

リクエストのデフォルト・メディア・タイプ。値は"application/oracle.com.cloud.jaas.JavaPlatformInstance+json"です。

1

context_id

文字列

サービス・テンプレートの内部参照を示すIDです。

1

canonicalLink

文字列

この正規化されたまたは正規のURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

53.9.4.1 Javaプラットフォーム・テンプレート・リソースの詳細の表示

次に、表現を返すJavaPlatformTemplate URIに対するGET操作の例を示します。

リクエストの例:

表53-59 Javaプラットフォーム・テンプレート・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.JavaPlatformTemplate+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例:

{
"uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
"name" : "PS4_LowHeapTemplate" ,
"description" : "This is a service template using the CDP CDP_PS4_lowHeap_MWProfile" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "D016AADD465462ACE040F20AD18167BA" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA" ,
"created" : "2012-12-04 23:16:10.0" ,
"default_instance_media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.common.Zone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
}
]
} ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42" ,
"name" : "MyServer-1" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"status" : "RUNNING"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42"
}
]
}
}

53.9.4.2 Javaプラットフォーム・テンプレートへのPOSTリクエスト渡しによるJavaプラットフォーム・インスタンスの作成

次に、次のように指定して"空"のJavaPlatformInstanceを作成するJavaPlatformTemplate URIに対するPOSTの例を示します。

- "name"属性: JavaPlatformInstanceの名前

- "zone"属性: 宛先ゾーンURI

リクエストの例:

表53-60 Javaプラットフォーム・インスタンスを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.JavaPlatformTemplate+json

Content-Type: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

本文

{
"name" : "rtjul17",
"zone" : "/em/cloud/jaas/zone/C355810A6"
}

リクエスト・メソッド

POST

レスポンスの例(操作の進行中):

{
"uri" : "/em/cloud/jaas/javaplatforminstancerequest/1" ,
"name" : "rtjul17_Create_20120717_045804697" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"text" : "null" ,
"date" : "2012-07-17T09:16:13+0000"
}
]
} ,
"context_id": "1",
"media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"service_family_type": "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstancerequest/1" ,
"status": "SCHEDULED"
"created" : "2013-05-09T07:06:57+0000"
}

レスポンスの例(インスタンスの作成後):

{
"uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
"name" : "PS4_LowHeapTemplate" ,
"description" : "This is a service template using the CDP CDP_PS4_lowHeap_MWProfile" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "D016AADD465462ACE040F20AD18167BA" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA" ,
"created" : "2012-12-04 23:16:10.0" ,
"default_instance_media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.common.Zone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
}
]
} ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42" ,
"name" : "MyServer-1" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"status" : "RUNNING"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42"
}
]
}
}

53.9.4.3 Javaプラットフォーム・リクエスト・リソースの詳細の表示

次に、JavaPlatformリクエストURLに対するGET操作の例を示します。

リクエストの例:

表53-61 Javaプラットフォーム・リクエストのステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatforminstancerequest/1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例(操作の進行中):

{
"uri" : "/em/cloud/jaas/javaplatforminstancerequest/1" ,
"name" : "rtjul17_Create_20120717_045804697" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"text" : "null" ,
"date" : "2012-07-17T09:16:13+0000"
}
]
} ,
"context_id": "1",
"media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"service_family_type": "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstancerequest/1" ,"status": "SCHEDULED
"created" : "2013-05-09T07:06:57+0000"
}

レスポンスの例(インスタンスの作成後):

{
"uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
"name" : "PS4_LowHeapTemplate" ,
"description" : "This is a service template using the CDP CDP_PS4_lowHeap_MWProfile" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "D016AADD465462ACE040F20AD18167BA" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA" ,
"created" : "2012-12-04 23:16:10.0" ,
"default_instance_media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.common.Zone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
}
]
} ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42" ,
"name" : "MyServer-1" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"status" : "RUNNING"
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42"
}
]
}
}

53.9.5 Javaプラットフォーム・インスタンス

JavaPlatformInstanceは、クラウドのフレームワーク・リソース・モデルのServiceInstanceを拡張します。Enterprise ManagerでOracle Composite Applicationターゲットにリンクされます。

次の表では、JavaPlatformInstance [application/oracle.com.cloud.jaas.JavaPlatformInstance+json]のデータ・モデルについて説明します。

表53-62 JavaPlatformInstanceデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

インスタンスのユーザー用の名前。

[POST]

1

zone

ゾーン(uri、name、media_type)

インスタンスがデプロイされるゾーン。

[POST]

1

media_type

文字列

GETの実行にクライアントが使用できる追加のメディア・タイプを示します。

1

application_instance_deployments

コレクション<ApplicationInstanceDeployment>

JavaPlatformInstanceにデプロイされたすべてのApplicationInstanceDeploymentsのリストです。

0…1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

based_on

JavaPlatformTemplate

このインスタンスを作成する基となったJavaPlatformTemplate。

1

jdbc_drivers

文字列[]

このインスタンスでのデータソースの作成に使用できるJDBCドライバのリスト。

0…1

data_sources

コレクション<DataSource>

このインスタンス用に構成されたすべてのデータソースのリストです。

0…1

status

文字列

基礎となるWeblogicクラスタのステータスを示します

値は次のとおりです

STOPPED、RUNNING、UNREACHABLE、UNKNOWN

0…1

server_count

文字列

JavaPlatformInstanceのWeblogicクラスタ内のJavaサーバーの数

[PUT]

1

service_family_type

文字列

サービス・インスタンスのタイプを表します("jaas"など)。

1

context_id

文字列

サービス・テンプレートの内部参照を示すIDです

1

canonicalLink

文字列

この正規化されたまたは正規のURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

53.9.5.1 Javaプラットフォーム・インスタンス・リソースの詳細の表示

次に、表現を返すJavaPlatformInstance URIに対するGET操作の例を示します。

リクエストの例:

表53-63 Javaプラットフォーム・インスタンス・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatforminstance/960A4A8244145EC7949303B4ECD650D0

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例:

{
"uri" : "/em/cloud/jaas/javaplatforminstance/960A4A8244145EC7949303B4ECD650D0" ,
"name" : "jb__sd_platform_12_24_2012_13_38_28" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "960A4A8244145EC7949303B4ECD650D0" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/960A4A8244145EC7949303B4ECD650D0" ,
"status" : "RUNNING" ,
"zone" :     {
"uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"context_id" : "A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/ A1B44A4EBCC4563125D9D0A3AAE4FD51" ,      "type" : "jaas"
} ,
"based_on" :     {
"uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
"name" : "PS4_LowHeapTemplate" ,
"context_id" : "D016AADD465462ACE040F20AD18167BA" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
"service_family_type" : "jaas"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA "
} ,
"data_sources" :     {
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"total" : "0" ,
"elements" :
[      ]
} ,
"jdbc_drivers" :
[
"com.ddtek.jdbc.oracle.OracleDriver" ,
"oracle.jdbc.xa.client.OracleXADataSource" ,
"oracle.jdbc.OracleDriver" ,
"com.ddtek.jdbcx.oracle.OracleDataSource"
] ,
"server_count" : "1" ,
"application_instance_deployments" :     {
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"total" : "0" ,
"elements" :
[      ]
}
}

53.9.5.2 Javaプラットフォーム・インスタンスへのDELETEリクエスト渡しによるサービス・インスタンスの削除

次に、サービス・インスタンスをリタイヤさせるJavaPlatformInstance URIに対するDELETE操作の例を示します。

リクエストの例:

表53-64 Javaプラットフォーム・インスタンスを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatforminstance/960A4A8244145EC7949303B4ECD650D0

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

本文

なし

リクエスト・メソッド

DELETE

レスポンスの例:

{
"uri" : "/em/cloud/jaas/javaplatforminstancerequest/121" ,
"name" : "rtjul17_Delete_20120719_035504227" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"text" : "null" ,
"date" : "2012-07-19T09:16:13+0000"
}
]
} ,
"context_id": "121",
"media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"service_family_type": "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstancerequest/121" ,
"status": "SCHEDULED"
"created" : "2013-05-09T09:08:38+0000"
}

53.9.5.3 DELETEリクエストのステータスの表示

リクエストの例:

表53-65 Delete操作のステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatforminstancerequest/121

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例(操作の進行中):

{
"uri" : "/em/cloud/jaas/javaplatforminstancerequest/121" ,
"name" : "rtjul17_Delete_20120719_035504227" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"text" : "null" ,
"date" : "2012-07-19T09:16:13+0000"
}
]
} ,
"context_id": "121",
"media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"service_family_type": "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstancerequest/121" ,
"status": "SCHEDULED"
"created" : "2013-05-09T09:08:38+0000"
}

レスポンスの例(操作の完了時):

statusフィールドは、リソースが削除されていることを示します。

53.9.5.4 Javaプラットフォーム・インスタンスへのPOSTリクエスト渡しによるアプリケーション・インスタンス・デプロイメントの作成

次に、ApplicationInstanceDeploymentをデプロイするJavaPlatformInstance URIに対するPOST操作の例を示します。

- "name"属性: ApplicationInstanceDeploymentの名前

- "application_instance_component"属性: ApplicationInstanceComponent URI

リクエストの例:

表53-66 アプリケーション・インスタンス・デプロイメント・リソースを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json

Content-Type: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json

本文

{
"name" : "rtriddappjul18",
"application_instance_component" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC414FFB7A0912357E040F10A716015F9%3A0.1"
}

リクエスト・メソッド

POST

レスポンスの例:

{
"uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/ rtriddappjul18@131" ,
"name" : " rtriddappjul18_Deploy_20120718_051319824" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-18T12:13:28+0000" ,
"text" : "null"
}
]
} ,
"context_id" : "rtriddappjul18@131" ,
"media_type" :             "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/ rtriddappjul18@131" ,
"status" : "SCHEDULED"
}

53.9.5.5 アプリケーション・インスタンス・デプロイメント作成リクエストのステータスの表示

次に、アプリケーション・インスタンスを作成するPOSTによって返されるアプリケーション・インスタンス・デプロイメント・リクエストのGETの例を示します。

リクエストの例:

表53-67 アプリケーション・インスタンス・デプロイメント作成のステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappju118@131

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例(操作の進行中)

{
"uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/ rtriddappjul18@131" ,
"name" : " rtriddappjul18_Deploy_20120718_051319824" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-18T12:13:28+0000" ,
"text" : "null"
}
]
} ,
"context_id" : "rtriddappjul18@131" ,
"media_type" :          "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"service_family_type" : "jaas" ,
"status" : "SCHEDULED"
}

レスポンスの例(操作の完了時)

{
"uri" : "/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3" ,
"name" : "rtriddappjul19" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "9D8868C9632E3" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"service_family_type" : "jaas" ,
"status" : "RUNNING" ,
"http_application_invocation_url" :     {
"ms_3" : "http://example.com:32463/RiddlesWeb" ,
"ms_4" : "http://example.com:40298/RiddlesWeb"
} ,
"https_application_invocation_url" :     {
"ms_3" : "https://example.com:3550/RiddlesWeb" ,
"ms_4" : "https://example.com:41467/RiddlesWeb"
} ,
"contained_in" :     {
"uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C" ,
"name" : "rtjul17" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"status" : "RUNNING"
}
}

53.9.5.6 Javaプラットフォーム・インスタンス・リソースへのPOSTリクエスト渡しによるデータソースの作成

次に、JavaPlatformInstanceでDataSourceを作成するJavaPlatformInstance URIに対するPOST操作の例を示します

- "name"属性: DataSourceの名前

- "jndi_name"属性: JNDI名

- "jdbc_driver"属性: JDBCドライバ

- "database_connect_string"属性: データベース接続文字列

- "database_type"属性: データベース・タイプ

- ユーザー名およびパスワード

リクエストの例:

表53-68 Javaプラットフォーム・インスタンスでデータソースを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.DataSource+json

Content-Type: application/oracle.com.cloud.jaas.DataSource+json

本文

{
"name" : "tarunDS_wthParamchanges" ,
"jndi_name" : ["jndi_1Paramchanges"] ,
"jdbc_driver" : "oracle.jdbc.OracleDriver" ,
"database_connect_string" :   "jdbc:oracle:thin:sysman/sysman@example.com:15044:test2" ,
"database_type" : "Oracle" ,
"username": "sysman",
"password": "sysman"
}

リクエスト・メソッド

POST

レスポンスの例:

{
"uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul23@181" ,
"name" : "rtrepodsjul23_CreateDS_20120722_112705396" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T06:27:06+0000" ,
"text" : "null"
}
]
},
"context_id" : "rtrepodsjul23@181" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul23@181" ,
"status" : "SCHEDULED"
}

53.9.5.7 データソース作成リクエストのステータスの表示

次に、データソースを作成するPOSTによって返されるデータソース・リクエストのGETの例を示します。

リクエストの例:

表53-69 データソース作成のステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/datasourcerequest/rtrepodsju123@181

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例(操作の進行中):

{
"uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul23@181" ,
"name" : "rtrepodsjul23_CreateDS_20120722_112705396" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T06:27:06+0000" ,
"text" : "null"
}
]
},
"context_id" : "rtrepodsjul23@181" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul23@181" ,
"status" : "SCHEDULED"
}

レスポンスの例(操作の完了時):

{
"uri" : "/em/cloud/jaas/datasource/ rtrepodsjul18@CF4339D922C" ,
"name" : "rtrepodsjul18" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : " rtrepodsjul18@CF4339D922C" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C " ,
"jndi_name" :
[
"jndi_1"
] ,
"jdbc_driver" : "oracle.jdbc.OracleDriver" ,
"username" : "sysam",
"database_connect_string" : "jdbc:oracle:thin:sysman/sysman@example.com:15044:sjuly14" ,
"contained_in" :     {
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"context_id" : "CF4339D922C51" ,
"name" : "rtjul17" ,
"uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C51"
}

}

53.9.5.8 サービス・インスタンスのスケール・アップ/スケール・ダウン

次に、サービス・インスタンスをスケール・アップまたはスケール・ダウンするJavaPlatformInstance URIに対するPUT操作の例を示します。"server_count"属性には、最終サーバー数が格納されます。スケール・アップ・リクエストまたはスケール・ダウン・リクエストは、現在のサーバー数が最終サーバー数より多いか少ないかに応じて送信されます。

リクエストの例:

表53-70 サービス・インスタンスをスケール・アップ/スケール・ダウンするためのPUTリクエスト構成

機能

説明

URI

/em/cloud/jaas/javaplatforminstance/CF4339D922C5

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

Content-type: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

本文

{
"server_count" : "3"
}

リクエスト・メソッド

PUT

レスポンスの例:

{
"uri" : "/em/cloud/jaas/javaplatforminstancerequest/211" ,
"name" : "rtjul17_Scaleup_20120719_045804697" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"text" : "null" ,
"date" : "2012-07-19T09:16:13+0000"
}
]
} ,
"context_id": "211",
"media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"service_family_type": "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ javaplatforminstancerequest/211" ,
"status": "SCHEDULED"
"created" : "2013-05-09T11:46:27+0000"
}

53.9.6 アプリケーション・インスタンス・デプロイメント

JavaPlatformInstanceでのアプリケーション・インスタンスのデプロイメントを表します。

次の表では、ApplicationInstanceDeployment [application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json]のデータ・モデルについて説明します。

表53-71 アプリケーション・インスタンス・デプロイメントのデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

インスタンスのユーザー用の名前。

[POST]

1

application_instance_component

ApplicationInstanceComponent

(uri、name、version)

このインスタンスのデプロイ時に使用されたソフトウェア・ライブラリ内のApplicationInstanceComponent。

[POST]

1

http_application_invocation_url

マップ<文字列,文字列>

デプロイされたアプリケーションのサーバー名とHTTP URLのマップ。インスタンスの作成後に移入されます。

0…1

https_application_invocation_url

マップ<文字列,文字列>

デプロイされたアプリケーションのサーバー名とHTTPS URLのマップ。インスタンスの作成後に移入されます。

0…1

contained_in

JavaPlatformInstance

(uri、name)

アプリケーションがデプロイされるJavaPlatformInstance。

1

deployment_plan

文字列

XML形式で規定された、このデプロイメントのベンダー固有の構成パラメータ。

[POST]

0…1

status

文字列

ApplicationInstanceDeploymentのステータスを示します。

値は次のとおりです

STOPPED、RUNNING、UNREACHABLE、UNKNOWN

[PUT]

0…1

metrics

コレクション<メトリック>

このサービス・インスタンスに関連するメトリック(uri、name、type current_value)のリスト。

0…1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

service_family_type

文字列

ApplicationInstanceDeploymentのタイプを表します("jaas"など)。

1

media_type

文字列

GETの実行にクライアントが使用できる追加のメディア・タイプを示します。

1

context_id

文字列

アプリケーション・デプロイメントの内部参照を示すIDです。

1

canonicalLink

文字列

この正規化されたまたは正規のURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

53.9.6.1 アプリケーション・インスタンス・デプロイメント・リソースの詳細の表示

次に、表現を返すApplicationInstanceDeployment URIに対するGET操作の例を示します。

リクエストの例:

表53-72 アプリケーション・インスタンス・デプロイメントの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.ApplicaitonInstanceDeployment+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例:

HTTP/1.1 200 OK
Content-Type: application/oracle.com.cloud.jaas. ApplicationInstanceDeployment+json
Content-Location: /em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3
Cache-Control: public
Content-Length: nnn
{
"uri" : "/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3" ,
"name" : "rtriddappjul19" ,
"resource_state" :     {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3" ,
"status" : "RUNNING" ,
"http_application_invocation_url" :     {
"ms_3" : "http://example.com:32463/RiddlesWeb" ,
"ms_4" : "http://example.com:40298/RiddlesWeb"
} ,
"https_application_invocation_url" :     {
"ms_3" : "https://example.com:3550/RiddlesWeb" ,
"ms_4" : "https://example.com:41467/RiddlesWeb"
} ,
"contained_in" :     {
"uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C" ,
"name" : "rtjul17" ,
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"status" : "RUNNING"
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/ CF4339D922C "
}
}

53.9.6.2 アプリケーション・インスタンス・デプロイメントの削除

次に、アプリケーション・インスタンス・デプロイメントURIに対するサンプルのDELETE操作を示します。これによって、アプリケーションがJavaプラットフォーム・インスタンスからアンデプロイされます。

リクエストの例:

表53-73 アプリケーション・インスタンス・デプロイメントを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.ApplicaitonInstanceDeployment+json

本文

なし

リクエスト・メソッド

DELETE

レスポンスの例:

HTTP/1.1 200 OK
Content-Type: application/oracle.com.cloud.jaas. ApplicationInstanceDeployment+json
Content-Location: /em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184
Cache-Control: public
Content-Length: nnn
{
"uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184" ,
"name" : "rtriddappjul19_Undeploy_20120723_011757881" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T08:18:01+0000" ,
"text" : "null"
}
]
} ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"service_family_type" : "jaas" ,
canonicalLink: "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184" ,
"status" : "SCHEDULED"
}

53.9.6.3 アプリケーション・インスタンス・デプロイメント削除リクエストのステータスの表示

次に、アプリケーション・インスタンス・デプロイメント・リクエストに対するGET操作の例を示します。

リクエストの例:

表53-74 アプリケーション・インスタンス・デプロイメント削除のステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappju119@184

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.ApplicaitonInstanceDeployment+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例(操作の進行中):

{
"uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184" ,
"name" : "rtriddappjul19_Undeploy_20120723_011757881" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T08:18:01+0000" ,
"text" : "null"
}
]
} ,
"context_id" : "rtriddappjul19@184" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"service_family_type" : "jaas" ,
canonicalLink: "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184" ,
"status" : "SCHEDULED"
}

レスポンスの例(操作の完了時):

statusフィールドは、リソースが削除されていることを示します。

53.9.6.4 アプリケーション・インスタンス・デプロイメントの起動、停止および再デプロイ

次に、インスタンスを起動または停止する、アプリケーション・インスタンス・デプロイメントURIに対するサンプルのPUT操作を示します。

- STOPPEDからRUNNING
status属性を値= "START"にします。

- RUNNINGからSTOPPED
status属性を値= "STOP"にします。

- REDEPLOY
status属性を値="REDEPLOY"にし、"application_instance_component"属性にApplicationInstanceComponent URIを指定します。

リクエストの例: 起動/停止

表53-75 アプリケーション・インスタンス・デプロイメントのステータスを開始/停止するためのPUTリクエスト構成

機能

説明

URI

/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.ApplicaitonInstanceDeployment+json

Content-type: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json

本文

{
"status" : "STOP"
}

リクエスト・メソッド

PUT

レスポンスの例:

HTTP/1.1 200 OK
Content-Type: application/oracle.com.cloud.jaas. ApplicationInstanceDeployment+json
Content-Location: /em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@182
Cache-Control: public
Content-Length: nnn
{
"uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@182" ,
"name" : "rtriddappjul19_Stop_20120723_123327380" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T07:33:27+0000" ,
"text" : "null"
}
]
} ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@182" ,
"status" : "SCHEDULED"
}

リクエストの例: 再デプロイ

PUT /em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3
Host: cloudcompany.com
Authorization: Basic xxxxxxx
Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json
Content-type: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json
{
"status" : "STOP" ,
"application_instance_component" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC414FFB7A0912357E040F10A716015F9%3A0.1"
}

レスポンスの例:

{
"uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@183" ,
"name" : "rtriddappjul19_Undeploy_20120723_123327380" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T07:33:27+0000" ,
"text" : "null"
}
]
} ,
"context_id" : "rtriddappjul19@183" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@183" ,
"status" : "SCHEDULED"
}

53.9.7 DataSource

DataSourceリソース・モデルの特性は次のとおりです。

次の表では、DataSource [application/oracle.com.cloud.jaas.DataSource+json]のデータ・モデルについて説明します。

表53-76 DataSourceデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

データソースのユーザー用の名前。

[POST][PUT]

1

jndi_name

文字列[]

このデータソースのバインド先のJNDIパス。アプリケーションは、接続を予約する際、この名前でJNDIツリー上のデータ・ソースをルックアップします。

[POST][PUT]

1

database_type

文字列

データソースが表すデータベースのDBMS。

[POST]

0…1

jdbc_driver

文字列

データベースへの接続に使用されるデータベース・ドライバ。

[POST]

1

contained_in

JavaPlatformInstance

(uri、name)

データソースが存在するJavaPlatformInstance。

1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

database_connect_string

文字列

データソースを作成するために指定できるデータベースの接続文字列。

[POST][PUT]

0…1

service_family_type

文字列

データソースのタイプを表します("jaas"など)。

1

media_type

文字列

GETの実行にクライアントが使用できる追加のメディア・タイプを示します。

1

username

文字列

DB接続のユーザー名。

1

password

文字列

DB接続のパスワード。

1

context_id

文字列

データソースの内部参照を示すIDです。

1

canonicalLink

文字列

この正規化されたまたは正規のURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

53.9.7.1 データソース・リソースの詳細の表示

次に、表現を返すDataSource URIに対するGET操作の例を示します。

リクエストの例:

表53-77 データソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.DataSource+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例:

{
"uri" : "/em/cloud/jaas/datasource/ rtrepodsjul18@CF4339D922C" ,
"name" : "rtrepodsjul18" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : " rtrepodsjul18@CF4339D922C" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C " ,
"jndi_name" :
[
"jndi_1"
] ,
"jdbc_driver" : "oracle.jdbc.OracleDriver" ,
"username" : "sysam",
"database_connect_string" : "jdbc:oracle:thin:sysman/sysman@example.com:15044:sjuly14" ,
"contained_in" :     {
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"context_id" : "CF4339D922C51" ,
"name" : "rtjul17" ,
"uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C51"
}

}

53.9.7.2 データソースの削除

次に、JavaPlatformInstanceから削除するDataSource URIに対するDELETE操作の例を示します。

リクエストの例:

表53-78 データソースを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.DataSource+json

本文

なし

リクエスト・メソッド

DELETE

レスポンスの例:

HTTP/1.1 200 OK
Content-Type: application/oracle.com.cloud.jaas.DataSource+json
Content-Location: /em/cloud/jaas/datasourcerequest/rtrepodsjul18@201
Cache-Control: public
Content-Length: nnn
{
"uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul18@201" ,
"name" : "rtrepodsjul18_DeleteDS_20120723_024836692" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T09:48:37+0000" ,
"text" : "null"
}
]
} ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul18@201" ,
"status" : "SCHEDULED"
}

53.9.7.3 データソース削除リクエストのステータスの表示

次に、DataSourceリクエストに対するGET操作の例を示します。

リクエストの例:

表53-79 データソース削除のステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/datasourcerequest/rtrepodsjul18@201

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.DataSource+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例(操作の進行中):

{
"uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul18@201" ,
"name" : "rtrepodsjul18_DeleteDS_20120723_024836692" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T09:48:37+0000" ,
"text" : "null"
}
]
} ,
"context_id" : "rtrepodsjul18@201" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul18@201" ,
"status" : "SCHEDULED"
}

レスポンスの例(操作の完了時):

statusフィールドは、リソースが削除されていることを示します。

53.9.7.4 データソースの更新

次に、DataSourceを更新してJNDI名を追加/削除し、データベース接続文字列を編集するDataSource URIに対するPUT操作の例を示します。また、TESTデータ・ソースのリクエストの例も示します。

リクエストの例:

表53-80 データソースを更新するためのPUTリクエスト構成

機能

説明

URI

/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.DataSource+json

Content-type: application/oracle.com.cloud.jaas.DataSource+json

本文

{
"jndi_name" : ["jndi_2"],
"database_connect_string" :    "jdbc:oracle:thin:sysman/sysman@example.com:15044:sep25cc" ,
"username" : "sysman",
"password" : "sysman"
}

リクエスト・メソッド

PUT

レスポンスの例:

{
"uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul18@CF4339D922C" ,
"name" : "rtrepodsjul18_UpdateDS_20121216_062909975" ,
"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"date" : "2012-12-16T14:29:16+0000" ,
"text" : "null"
}
]
} ,
"context_id" : "rtrepodsjul18@681" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasourcerequest/rtrepodsjul18@191" ,
"status" : "SCHEDULED"
}

TESTデータソースに対するリクエストの例:

表53-81 データソースをテストするためのPUTリクエスト構成

機能

説明

URI

/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.DataSource+json

Content-type: application/oracle.com.cloud.jaas.DataSource+json

本文

{
"status" : "TEST"
}

リクエスト・メソッド

PUT

レスポンスの例

{
"uri" : "/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C" ,
"name" : "rtrepodsjul18" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : " rtrepodsjul18@CF4339D922C" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C " ,
"jndi_name" :
[
"jndi_1"
] ,
"jdbc_driver" : "oracle.jdbc.OracleDriver" ,
"username" : "sysam",
"database_connect_string" : "jdbc:oracle:thin:sysman/sysman@example.com:15044:sjuly14" ,
"contained_in" :     {
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"context_id" : "CF4339D922C51" ,
"name" : "rtjul17" ,
"uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C51"
}
}

53.9.7.5 データソース・リクエストのステータスの表示

次に、データソース・リクエストのGETの例を示します。

リクエストの例:

表53-82 データソースのステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/datasourcerequest/rtrepodsjul18@201

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.DataSource+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例(操作の進行中):

{
"uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul18@201" ,
"name" : "rtrepodsjul18_DeleteDS_20120723_024836692" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"date" : "2012-07-23T09:48:37+0000" ,
"text" : "null"
}
]
} ,
"context_id" : "rtrepodsjul18@201" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul18@201" ,
"status" : "SCHEDULED"
}

レスポンスの例(操作の完了時):

{
"uri" : "/em/cloud/jaas/datasource/ rtrepodsjul18@CF4339D922C" ,
"name" : "rtrepodsjul18" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : " rtrepodsjul18@CF4339D922C" ,
"media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C " ,
"jndi_name" :
[
"jndi_1"
] ,
"jdbc_driver" : "oracle.jdbc.OracleDriver" ,
"username" : "sysam",
"database_connect_string" : "jdbc:oracle:thin:sysman/sysman@example.us.com:15044:sjuly14" ,
"contained_in" :     {
"media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"context_id" : "CF4339D922C51" ,
"name" : "rtjul17" ,
"uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C51"
}

}

53.9.8 アプリケーション・インスタンス・コンポーネント

ソフトウェア・ライブラリ内のアプリケーション・コンポーネントを表します。Jaasサービス・タイプにPOSTすると作成できます。

次の表では、ApplicationInstanceComponent [application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json]のデータ・モデルについて説明します。

表53-83 アプリケーション・インスタンス・コンポーネントのデータ・モデル

フィールド

タイプ

説明

発生

uri

URI

このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

name

文字列

インスタンスのユーザー用の名前。

[POST]

1

creator

文字列

ソフトウェア・ライブラリ内のApplicationInstanceComponentの作成者。

1

created

Timestamp

インスタンスが作成された日付と時刻(ISO 8601形式)。

1

version

文字列

ソフトウェア・ライブラリ内のApplicationInstanceComponentのバージョン。

[POST]

1

resource_state

ResourceState

リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。

1

context_id

文字列

ApplicationInstanceComponentの内部参照を示すIDです。

1

service_family_type

文字列

ApplicationInstanceComponentのタイプを表します("jaas"など)。

1

media_type

文字列

GETの実行にクライアントが使用できる追加のメディア・タイプを示します。

1

status

文字列

ソフトウェア・ライブラリ内のApplicationInstanceComponentのステータス。

1

maturity

文字列

ソフトウェア・ライブラリ内のApplicationInstanceComponentの成熟度。

1

componenttype

文字列

ApplicationInstanceComponentのコンポーネント・タイプ(Java EEアプリケーションなど)。

1

canonicalLink

文字列

この正規化されたまたは正規のURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。

1

53.9.8.1 アプリケーション・インスタンス・コンポーネント・リソースの詳細の表示

次に、表現を返すApplicationInstanceComponent URIに対するGET操作の例を示します。

リクエストの例:

表53-84 アプリケーション・インスタンス・コンポーネントの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json

本文

なし

リクエスト・メソッド

GET

レスポンスの例:

HTTP/1.1 200 OK
Content-Type: application/oracle.com.cloud.jaas. ApplicationInstanceComponent+json
Content-Location: /em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1
Cache-Control: public
Content-Length: nnn
{
"uri" :   "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1" ,
"name" : "Riddles" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_JavaEEApplication:C514D5CF9FC00CD7E040F10A716020D0:0.1" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
"service_family_type" : "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1" ,
"created" : "2012-07-17 22:31:33.0" ,
"version" : "0.1" ,
"creator" : "SSA_USER_1" ,
"componenttype" : "Java EE Application" ,
"status" : "Ready" ,
"maturity" : "Untested"
}

53.9.8.2 アプリケーション・インスタンス・コンポーネントの削除

次に、ApplicationInstanceComponent URIに対するDELETE操作の例を示します。

リクエストの例:

表53-85 アプリケーション・インスタンス・コンポーネントを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json

本文

なし

リクエスト・メソッド

DELETE

レスポンスの例:

{
"uri" :   "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1" ,
"resource_state" :     {
"state" : "DESTROYED"
} ,
"context_id" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_JavaEEApplication:C514D5CF9FC00CD7E040F10A716020D0:0.1" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1"
}

53.10 V1のアプリケーション・コンポーネントのフィルタ処理

アプリケーション・コンポーネントのフィルタ処理は、JaaSのゾーン、テンプレートおよびアプリケーション・コンポーネントでサポートされます。

53.10.1 サービス・テンプレートのフィルタ処理

サポートされるフィルタ処理の属性は、name、service_template_type、ownerおよびmedia_typeです。次に、サービス・テンプレート検索に対するリクエストおよびレスポンスの例を示します。

リクエストの例

表53-86 サービス・テンプレートをフィルタ処理するためのGETリクエスト構成

機能

説明

URI

/em/cloud?filters=

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.ServiceTemplateFinds+json

本文

{
"filters":{"name":"RiddleApp"}
}

リクエスト・メソッド

GET

レスポンスの例

{
"uri" : "/em/cloud/finds/service_template/bWVkaWFfdHlwZSUyNTNEYXBwbGljYXRpb24lMjUyRm9yYWNsZS5jb20uY2xvdWQuY29tbW9uLlNl%0AcnZpY2VUZW1wbGF0ZSUyRm5hbWUlMjUzRFJpZGRsZUFwcA%3D%3D" ,
"name" : "Service Template Finds" ,
"media_type" : "application/oracle.com.cloud.common.ServiceTemplateFinds+json" ,
"description" : "This is a Resource Finds for 'Service Template Finds' with media type 'application/oracle.com.cloud.common.ServiceTemplateFinds+json'" ,
"resource_state" :     {
"state" : "READY"
} ,
"filters" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
"name" : "RiddleApp"
} ,
"finds" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD1103FE5F6877372E040F20AD1814215%3A0.1" ,
"name" : "RiddleApp" ,
"media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
"service_family_type" : "jaas"
}
]
}
}

53.10.2 ゾーンのフィルタ処理

サポートされるフィルタ処理の属性は、name、owner、service_family_typeおよびmedia_typeです。

ゾーンのフィルタ処理の例

表53-87 ゾーンをフィルタ処理するためのGETリクエスト構成

機能

説明

URI

/em/cloud?filters=

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Accept: application/oracle.com.cloud.common.ZoneFinds+json

本文

{
"filters":{"name":"Zone1"}
}

リクエスト・メソッド

GET

レスポンスの例

{
"uri" : "/em/cloud/finds/zone/bWVkaWFfdHlwZSUyNTNEYXBwbGljYXRpb24lMjUyRm9yYWNsZS5jb20uY2xvdWQuY29tbW9uLlpv%0AbmUlMkZuYW1lJTI1M0Rab25lMQ%3D%3D" ,
"name" : "Zone Finds" ,
"media_type" : "application/oracle.com.cloud.common.ZoneFinds+json" ,
"description" : "This is a Resource Finds for 'Zone Finds' with media type 'application/oracle.com.cloud.common.ZoneFinds+json'" ,
"resource_state" :     {
"state" : "READY"
} ,
"filters" :     {
"media_type" : "application/oracle.com.cloud.common.Zone" ,
"name" : "Zone1"
} ,
"finds" :     {
"media_type" : "*/*" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
"name" : "Zone1" ,
"media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
"service_family_type" : "jaas"
}
]
}
}

53.11 V1のロード・バランサ構成

次の表では、ロード・バランサの構成について説明します。

表53-88 ロード・バランサの構成

メソッド

リクエスト・ペイロード

URI

説明

GET

該当せず

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs

ロード・バランサのID、名前およびセルフ・リンクを含むすべてのロード・バランサ構成を返します。

GET

該当せず

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs/{lbr id}

特定のロード・バランサ構成に関するすべての詳細を返します。

POST

LBR構成アイテム(Jsonペイロード)

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs

新しいロード・バランサ構成を作成します。

PUT

LBR構成アイテム(Jsonペイロード)

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs

ロード・バランサ構成を編集します。

DELETE

該当せず

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs/{lbr id}

指定されたロード・バランサIDを持つロード・バランサを削除します。

53.11.1 ロード・バランサ構成REST APIの例

この項では、ロード・バランサ構成に関連するREST APIの例について説明します。

53.11.1.1 ロード・バランサ構成リソースの詳細の表示

次の表にGETリクエスト構成を示します。

表53-89 ロード・バランサ構成リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Load Balancer Configurations"
description: "Load Balancer Configurations available"
selfLink: " /em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs"
lbrconfigs: [2]
0:  {
name: "lbr1"
type: "OHS"
id: 1001
selfLink: ”/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs/1001"
}
1:  {
name: "lbr2"
type: "OTD"
id: 1002
selfLink: "
/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs/1002"
}
}

53.11.1.2 指定されたロード・バランサ構成の詳細の表示

次の表に、ロード・バランサ構成の詳細を表示するためのGETリクエスト構成を示します。

表53-90 指定されたロード・バランサ構成の詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs/1001

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "lbr1"
description: "Real ohs lbr"
type: "OHS"
id: 1001
owner: "SYSMAN"
host: "example.com"
credential: "HOST_CREDS"
agentTargetName: "example.com:11852"
instanceHome: "/scratch/PS5_OHS/instance_home"
poolTargets:  [1]
0:  "10729BD1A3B12FA254232EE4F84CB71B"
planTargets:   [0]
properties:
{
OHS_ROUTING_HTTP_PORT: "7777"
OHS_ROUTING_PROTOCOL: "HTTP"
COMPONENT_NAME: "ohs1"
}
selfLink: "/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs/1001"
}

53.11.1.3 ロード・バランサ構成の編集

次の表に、ロード・バランサ構成を編集するためのPUTリクエスト構成を示します。

表53-91 ロード・バランサ構成を編集するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"name": "lbr2",
"description": "desc by rest",
"type": "OTD",
"id": 1002,
"host": "xyxy.example.com",
"agentTargetName": "xyxy.example:11852",
"credential": "USER_CREDS",
"instanceHome": "as",
"properties":{ "items":
[
{"name":"SNMP_PORT", "value":"11161"},
{"name":"CERT_NAME", "value": "sdfsdf"},
{"name":"OTD_INSTANCENODES", "value": "sd"},
{"name":"HTTP_PORT", "value": "80"},
{"name":"CONFIG_NAME", "value": "config1"},
{"name":"VIRTUAL_SERVER_NAME", "value": "dfsdfs"},
{"name":"HTTPS_PORT", "value": "443"},
{"name":"ROUTING_PROTOCOL", "value": "HTTP_HTTPS"}
]
} ,
"poolTargets": [ "10729BD1A3B12FA25432EE4F84CB71B" ]
}

リクエスト・メソッド

PUT

53.11.1.4 ロード・バランサ構成の追加

次の表に、ロード・バランサ構成を追加するためのPOSTリクエスト構成を示します。

表53-92 ロード・バランサ構成を編集するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/lbrconfigs

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"name": "lbr1",
"description": "desc by rest",
"type": "OHS",
"host": "abc.us.example.com",
"agentTargetName": "abc.us.example.com:11852",
"credential": "USER_CREDS",
"instanceHome": "instHome",
"properties":{ "items":
[
{"name":"OHS_ROUTING_HTTP_PORT", "value":"80"},
{"name":"OHS_ROUTING_PROTOCOL", "value": "HTTP"},
{"name":"COMPONENT_NAME", "value": "compName"}
]
},
"poolTargets": [ "10729BD1A33B12FA254232EE4F84CB71B" ]
}

リクエスト・メソッド

POST

53.12 V1の割当て制限

次の表では、割当て制限の構成について説明します。

表53-93 割当て制限の構成

メソッド

リクエスト・ペイロード

URI

説明

GET

該当せず

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas

MWaaSのすべてのSSAユーザー・ロールの割当て制限設定を返します。

POST

割当て制限アイテム(Jsonペイロード)

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas

SSAユーザー・ロールの割当て制限を作成します。

PUT

割当て制限アイテム(Jsonペイロード)

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas

SSAユーザー・ロールの割当て制限を編集します。

DELETE

割当て制限アイテム(Jsonペイロード)

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas

SSAユーザー・ロールの割当て制限を削除します。

53.12.1 割当て制限REST APIの例

この項では、割当て制限REST APIの例について説明します。

53.12.1.1 すべてのSSAユーザー・ロールに対する割当て制限設定の詳細の表示

次の表にGETリクエスト構成を示します。

表53-94 すべてのSSAユーザー・ロールに対する割当て制限設定の詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{"name":"Middleware Cloud Quotas","description":"Middleware Cloud Quotas per SSA
User Role","quotas":[{"roleName":"SSA_DEMO_ROLE", "memory":"10","javaServersCount":"10"}],"selfLink":"https://example.com
:5416/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas"}

53.12.1.2 SSAユーザー・ロールの割当て制限設定の作成

次の表にPOSTリクエスト構成を示します。

表53-95 SSAユーザー・ロールの割当て制限設定を作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"roleName": "SSA_ROLE"
"memory": "5"
"javaServersCount": "10"
}

リクエスト・メソッド

POST

53.12.1.3 SSAユーザー・ロールの割当て制限設定の編集

次の表にPUTリクエスト構成を示します。

表53-96 SSAユーザー・ロールの割当て制限設定を編集するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"roleName": "SSA_ROLE"
"memory": "10"
"javaServersCount": "5"
}

リクエスト・メソッド

PUT

53.12.1.4 SSAユーザー・ロールの割当て制限設定の削除

次の表にDELETEリクエスト構成を示します。

表53-97 SSAユーザー・ロールの割当て制限設定を削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/quotas

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"roleName": "SSA_ROLE"
}

リクエスト・メソッド

DELETE

53.13 V1のサービス・テンプレート

作成リクエストでは、CDPベースのテンプレートおよびプロファイルがサポートされます。

注意:
ミドルウェア仮想テンプレート管理は、このリリースではサポートされません。

53.13.1 サービス・テンプレートの作成

次の表にPOSTリクエスト構成を示します。

表53-98 サービス・テンプレートを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful//extws/cloudservices/admin/cfw/v1/servicetemplates

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"name": "restTemplate",
"serviceFamily": "MWAAS",
"serviceType": "PhysicalWLS",
"description": " CDP based template created through REST",
"poolIds":[ "10729BD1A3B12FA254232EE4F84CB71B" ],
"roles":[{ "name":"SSA_USER_ROLE1" } ],
"serviceExecutableMeta": {
"type": "CDP",
"name": "CDP1",
"configurations":[
{"id": "wlsUserName","value": "weblogic"},
{"id": "wlsUserPassword","value": "welcome1"},
{"id": "wlsUserPassword2","value": "welcome1"},
{"id": "topology","value": "1"},
{"id": "exposeAdminURLs","value": "0"},
{"id": "enableLoadBalancer","value": "0"},
{"id": "hostListForScripts","value": ""},
{"id": "namedCredforHostList","value": ""},
{"id": "isScriptExecuteOnAdminServer","value": ""},
{"id": "portRangeStart","value": "1024"},
{"id": "portRangeEnd","value": "65000"},
{"id": "memoryUsagePerInstance","value": "0.25"},
{"id": "cpuUsagePerInstance","value": "10"},
{"id": "startupArguments","value": ""},
{"id": "requireHighAvailability","value": "1"},
{"id": "rootPwd","value": ""},
{"id": "agentInstallUserPwd","value": ""},
{"id": "namedHostCredForVirtualFlow","value": ""}  ]
}
}

リクエスト・メソッド

POST

53.14 V1のユーザー操作REST APIの例

この項では、次の操作について説明します。

- サービス・インスタンスの起動および停止

- サービス・インスタンスの再スケジュール

- ソフトウェア・ライブラリ内のJava EEアプリケーション・コンポーネントの詳細の表示

- ライブラリとしてのアプリケーションのデプロイ

- スケジュールのサポートのためのユーザー操作

53.14.1 サービス・インスタンスの起動および停止

次の表に、サービス・インスタンスを停止するREST APIを示します。

表53-99 サービス・インスタンスを起動/停止するためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/mwaas/v1/serviceinstances/{instance_id}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"STOP"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
message: "Stop service instance request has been submitted. Request ID = 122"
statusUri:
"https://example.com:5416/em/websvcs/restful/extws/cloudservices/ssa/cf
w/v1/servicerequests"
}

サービス・インスタンスの起動はこの例と似ています。本文の"operation":"STOP"のかわりに"operation":"START"と指定する以外は、ここに示したREST APIのすべての機能をそのまま使用します。

53.14.2 サービス・インスタンスの再スケジュール

次の表では、サービス・インスタンスの再スケジュールの構成について説明します。次のREST APIは、スケジュール日付に基づいてサービス・インスタンスを再スケジュールします。

表53-100 サービス・インスタンスを再スケジュールするためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/serviceinstances/{instance_id}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"RESCHEDULE"
, "reschedule":"2013-12-20T02:10:45ZAsia/Calcutta"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
message: "Reschedule request has been submitted. Request ID = 124 "
statusUri:
"https://example.com:5416/em/websvcs/restful/extws/cloudservices/ssa/cf
w/v1/servicerequests"
}

53.14.3 ソフトウェア・ライブラリ内のJava EEアプリケーション・コンポーネントの詳細の表示

次の表では、Java EEアプリケーション・コンポーネントの構成について説明します。次のREST APIは、ソフトウェア・ライブラリにアップロードされているすべてのJava EEアプリケーション・コンポーネントを返します。

表53-101 サービス・インスタンスを再スケジュールするためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/javaeeappcomponets

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Java EE Application Components uploaded in My Library "
selfLink:
"https://example.com:5416/em/websvcs/restful/extws/cloudservices/ssa/mw
aas/v1/javaeeappcomponets"
appUrns: [1]
0:  {
type: "Java EE Application"
description: null
status: "Ready"
appName: "Calendar"
creator: "SSA_USER1"
revision: "0.1"
maturity: "Untested"
createdTime: "2013-12-12 04:19:17.0"
appUrn: "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB
_JavaEEApplication:ED561AB14BA02907E043AB53F20AC335:0.1"
}

53.14.4 ライブラリとしてのアプリケーションのデプロイ

この項では、ライブラリとしてのアプリケーションをデプロイ、再デプロイおよびアンデプロイするREST APIを説明します。

表53-102 ライブラリとしてのアプリケーションのデプロイでサポートされるリクエスト・メソッド

メソッド

リクエスト・ペイロード

URI

説明

PUT

インスタンス・アイテム

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/serviceinstances/{Instance_Guid}

ライブラリとしてアプリケーションをデプロイします。

PUT

インスタンス・アイテム

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/serviceinstances/{Instance_Guid}

デプロイ済のアプリケーションを再デプロイします。

PUT

インスタンス・アイテム

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/serviceinstances/{Instance_Guid}

ライブラリをアンデプロイします。

53.14.4.1 ライブラリとしてのアプリケーションのデプロイ

次の表に、ライブラリとしてアプリケーションをデプロイするためのPUTリクエスト構成を示します。

表53-103 ライブラリとしてアプリケーションをデプロイするためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/mwaas/v1/serviceinstances/{instance_id}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"DEPLOYLIB"
, "appName":"testLib” ,

"appUrn":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB
_JavaEEApplication:ED561AB14BA02907E043AB53F20AC335:0.1"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
message: "Deploy Library request has been submitted. Request ID = 125 "
statusUri:
"https://example.com:5416/em/websvcs/restful/extws/cloudservices/ssa/
cfw/v1/servicerequests"
}

53.14.4.2 ライブラリとしてのアプリケーションの再デプロイ

次の表に、ライブラリとしてアプリケーションを再デプロイするためのPUTリクエスト構成を示します。

表53-104 ライブラリとしてアプリケーションを再デプロイするためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/mwaas/v1/serviceinstances/{instance_id}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"REDEPLOYLIB"
, "appName":"testLib” ,
"appUrn":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB
_JavaEEApplication:ED561AB14BA02907E043AB53F20AC335:0.1"
}

リクエスト・メソッド

PUT

53.14.4.3 ライブラリとしてのアプリケーションのアンデプロイ

次の表に、ライブラリとしてのアプリケーションをアンデプロイするためのPUTリクエスト構成を示します。

表53-105 ライブラリとしてのアプリケーションをアンデプロイするためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/mwaas/v1/serviceinstances/{instance_id}

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"UNDEPLOYLIB"
, "appName":"testLib”
}

リクエスト・メソッド

PUT

53.14.5 スケジュールのサポートのためのユーザー操作

この項では、サービス・インスタンスのPOST操作のREST APIについて説明します。

表53-106 Java EEアプリケーション・コンポーネントのPOSTリクエストの説明

メソッド

リクエスト・ペイロード

URI

説明

POST

インスタンス・アイテム

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/serviceinstances

サービス・インスタンス作成のためのリクエストを発行します。

POST

インスタンス・アイテム

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/serviceinstances

リクエストをスケール・アップします。

POST

インスタンス・アイテム

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/serviceinstances

リクエストをスケール・ダウンします。

POST

インスタンス・アイテム

/em/websvcs/restful/extws/cloudservices/admin/mwaas/v1/serviceinstances

サービス・インスタンスを削除します。

53.14.5.1 サービス・インスタンスの作成

次の表に、サービス・インスタンスを作成するためのPOSTリクエスト構成を示します。

表53-107 サービス・インスタンスを作成するためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/mwaas/v1/serviceinstances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"REQUEST_INSTANCE"
, "stGuid":"ED638689D4483CA4E043AB53F20A98C1"
,"serviceName":"instanceName"
,"zoneName":"paas_zone"
,"schedule":"2013-11-23T02:10:45ZAsia/Calcutta"
}

リクエスト・メソッド

POST

53.14.5.2 サービス・インスタンスのスケール・アップ

次の表に、サービス・インスタンスをスケール・アップするためのPOSTリクエスト構成を示します。

表53-108 サービス・インスタンスをスケール・アップするためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/mwaas/v1/serviceinstances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"SCALEUP"
,"serviceName":" instanceName"
, "numberOfServer":1
,"schedule":"2013-11-23T02:10:45ZAsia/Calcutta"
}

リクエスト・メソッド

POST

注意:
すぐに実行する場合は、本文のスケジュール・オブジェクトを空にする必要があります。

53.14.5.3 サービス・インスタンスのスケール・ダウン

次の表に、サービス・インスタンスをスケール・ダウンするためのPOSTリクエスト構成を示します。

表53-109 サービス・インスタンスをスケール・ダウンするためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/mwaas/v1/serviceinstances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"SCALEDOWN"
,"serviceName":"testInstance20_142768fdfff"
, "numberOfServer":1
,"schedule":""
}

リクエスト・メソッド

POST

注意:
実行をスケジュールする場合は、本文のスケジュール・オブジェクトで日付、時間およびゾーンを指定する必要があります。

53.14.5.4 サービス・インスタンスの削除

次の表に、サービス・インスタンスを削除するためのPOSTリクエスト構成を示します。

表53-110 サービス・インスタンスを削除するためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/mwaas/v1/serviceinstances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

{
"operation":"DELETE_INSTANCE"
,"serviceName":" instanceName"
, "zoneName":"paas_zone"
, "schedule":""
}

リクエスト・メソッド

POST

53.15 EMCLIによる管理操作のサポート

この項には、EM CLIコマンドの複数のサンプルと使用方法が含まれます。詳細は、Enterprise Managerコマンドライン・リファレンス・ガイドを参照してください。

表53-111 一般WLaaS EM CLI動詞

動詞

説明

形式

emcli invoke_ws

Enterprise Manager Webサービスを起動します。

オプション:

- -wsname - リソースのURIを示します。

- -method - RESTメソッドのタイプ。

- -payload - json/xml入力ペイロードを示します。

- -accept - ペイロード・タイプ。これらは標準のJersey値です。

- -type - 標準のJerseyレスポンス・タイプ。

- -param - このオプションを使用して、フォーム/問合せパラメータ値を渡します。たとえば、-param="name:value"などです。複数のパラメータを指定できます。たとえば、-param="name:value" -param="zip:12345"などです。
パラメータはファイルを通じて提供できます。ファイルから読み取るには、-param="name:tag" -input_file="tag:file.txt"のように指定します。この例では、nameパラメータはファイルfile.txtから読み取られます。

- -input_file - このオプションを使用して、payloadまたはparam値をファイルで渡します。

例:

- emcli invoke_ws -wsname=/em/websvcs/restful/emws/core/v0/list/dataservice -method=get -param="name:Administrators"
リスト・リソースを呼び出してすべての管理者を取得します。

- emcli invoke_ws -wsname=/em/websvcs/restful/emws/core/v0/list/dataservice -method=get -param="name:tag" -input_file="tag:file.txt"
リスト・リソースを呼び出してすべての管理者を取得します。nameパラメータはfile.txtから読み取られます。

emcli invoke_ws

-wsname=<WebService Name>

-method=<method name>

[-payload=<Payload>]

[-accept=<accept type>

[-type=response type]

[-param=Query Parameters]

[-input_file=<Input File for payload data>]

emcli get_targets

ターゲットのステータスおよびアラート情報を取得します。

オプション:

- -targets=name:type - 名前またはタイプは、完全な値または"%"を使用したパターン一致で指定できます。また、名前はオプションなので、タイプのみを指定できます。

- -limit_rows="取得するターゲットの最大数" - 指定されていない場合、デフォルトは2000行です。

- -config_search="構成検索UI名" - 検索UI名は、構成検索の表示名である必要があります。

- -alerts - 各ターゲットのクリティカルおよび警告アラートの数を表示します。

- -noheader - 列見出しのない表形式の出力を表示します。

- -unmanaged - 管理対象外ターゲットを表示します(ステータスまたはアラート情報なし)。

- -properties - 管理対象外ターゲットとプロパティを表示します。

- -separator_properties="separator_properties" - separator_propertiesを使用して管理対象外ターゲットのプロパティを表示します。

- -subseparator_properties="subseparator_properties" - subseparator_propertiesを使用して管理対象外ターゲットのプロパティを表示します。

- -script - このオプションは、-format="name:script"と同じです。

- -format - 書式指定(デフォルトは-format="name:pretty")。

- -format="name:pretty"は、出力表を読取り可能な形式で出力しますが、スクリプトによる解析は意図していません。

- -format="name:script" データベースの列セパレータをタブに設定し、デフォルトの行セパレータを改行に設定します。列および行セパレータ文字列を指定して、これらのデフォルトを変更できます。

- -format="name:csv"は、列セパレータをカンマに、行セパレータを改行に設定します。

例:

- emcli get_targets
最大2000のターゲットを表示します。クリティカル列と警告列は表示されません。

- emcli get_targets -limit_rows=20
最大20のターゲットを表示します。クリティカル列と警告列は表示されません。

- emcli get_targets -alerts
最大2000のターゲットを表示します。クリティカル列と警告列が表示されます。

- emcli get_targets -targets="oracle_database"
すべての"oracle_database"ターゲットを表示します。

- emcli get_targets -targets="%oracle%"
タイプに文字列"oracle"を含むすべてのターゲットを表示します。

- emcli get_targets -targets="database%:%oracle%"
名前が"database"で開始し、タイプに"oracle"が含まれるすべてのターゲットを表示します。

- emcli get_targets -targets="database3:oracle_database" -alerts
"database3"という名前のOracleデータベースに関するステータスおよびアラート情報を表示します。

- emcli get_targets -config_search="Search File Systems on Hosts" -targets="oracle%:host" -alerts
"Search File Systems on Hosts"という構成検索からの結果のターゲット、および名前が"oracle"で開始しタイプが"host"であるターゲットのステータスおよびアラート情報を表示します。

- emcli get_targets -targets="host" -unmanaged
管理対象外ホスト・ターゲットの名前とタイプの情報を表示します。

- emcli get_targets -unmanaged -properties -separator_properties=, -subseparator_properties==
指定されたセパレータを使用して管理対象外ホスト・ターゲットの名前、タイプおよびプロパティを表示します。デフォルトでは、separator_propertiesは「;」、subseparator_propertiesは「:」です。

emcli get_targets

[-targets="[name1:]type1;[name2:]type2;..."]

[-alerts]

[-noheader]

[-script | -format=

[name:<pretty|script|csv>];

[column_separator:"column_sep_string"];

[row_separator:"row_sep_string"];

]

[-limit_rows="取得するターゲットの最大数。"]

[-config_search="構成検索UI名"]

[-unmanaged]

[-properties]

[-separator_properties="properties_sep_string"]

[-subseparator_properties="properties_subsep_string"]

54 SOAaaSおよびOSBaaS API

この章では、SOA as a Service (SOAaS) APIおよびOSB as a Service (OSBaaS) APIのリソース・モデルと、それらのレスポンスについて説明します。

この章では、特に次の内容を説明します。

- PaaSインフラストラクチャ・ゾーンとミドルウェア・プール

- 割当て制限

- サービス・テンプレート

- ロード・バランサの構成

- SSAユーザー操作APIの例

54.1 PaaSインフラストラクチャ・ゾーンとミドルウェア・プール

この項では、PaaSインフラストラクチャ・ゾーンとミドルウェア・プールのAPIをリストします。

- すべてのリソース・プロバイダの詳細の表示

- SOA/OSBドメインのPaaSインフラストラクチャ・ゾーンの作成

- SOA/OSBのミドルウェア・プールの作成

- PaaSインフラストラクチャ・ゾーンの更新

- ミドルウェア・プールの更新

- リソース・プロバイダの削除(PaaSインフラストラクチャ・ゾーンまたはミドルウェア・プール)

54.1.1 すべてのリソース・プロバイダの詳細の表示

次の表に、表現を返すリソース・プロバイダURIに対するGET操作の例を示します。

表54-1 リソース・プロバイダの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

なし

リクエスト・メソッド

GET

54.1.2 SOA/OSBドメインのPaaSインフラストラクチャ・ゾーンの作成

次の表に、PaaSインフラストラクチャ・ゾーンを作成するためのリソース・プロバイダURIに対するPOST操作の例を示します。

表54-2 PaaSインフラストラクチャ・ゾーンを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{
"useExistingTarget" : false,
"name": "WlaaS_Zone1","type": "self_service_zone",
"credentials": [ {"name":"normal_credential_guid","description":"This is description frpm the REST      method","value": "AIME_CLOUD_CRED"}],
"memberTargetType": "host",
"members":["slc05tgu.example.com","slc02pog.example.com"],
"placementConstraints":[{"name":"MAX_CPU_UTILIZATION","value":["80"]},{"name":"MAX_MEMORY_ALLOCATION","value":["80"]}],
"characteristics":[{"name":"ORACLE.SYSMAN.CFW.SELF_SERVICE_ZONE","value":["70F61D030338B79AFEC42E008AF6F6B7"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT","value":["123456789"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER","value":["IDC.LEX"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT","value":["FMW"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS","value":["Test"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS","value":["ST"]},
{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION","value":["IDC"]}],
"roles":["MWAS_SSA_USER_ROLE1"]
}

リクエスト・メソッド

POST

54.1.3 SOA/OSBのミドルウェア・プールの作成

次の表に、ミドルウェア・プールを作成するためのリソース・プロバイダURIに対するPOST操作の例を示します。

表54-3 ミドルウェア・プールを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{"useExistingTarget":"false",
"name":"WlaaS_Pool1","type":"mwaas_zone","description":"This is a Windows Pool for WLAAS testing",
"memberTargetType":"host",
"members":["slc05tgu.example.com","slc02pog.example.com"],
"parentResourceProviderId":"1",
"placementConstraints":[{"name":"MAX_INSTANCES","value":"10"}],
"memberConstraints":[{"name":"ORACLE.SYSMAN.EMAS.MWC.WLAAS.PLATFORM","value":"226"}],
"characteristics":[{"name":"ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER","value":"IDC"}]
}

リクエスト・メソッド

POST

54.1.4 PaaSインフラストラクチャ・ゾーンの更新

次の表に、PaaSインフラストラクチャ・ゾーンを更新するためのPUT操作の例を示します。

表54-4 PaaSインフラストラクチャ・ゾーンを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/1

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{"description":"This is description from the REST PUT method",
"placementConstraints":[{"name":"MAX_CPU_UTILIZATION","value":["90"]},
{"name":"MAX_MEMORY_ALLOCATION","value":["90"]}
]
}

リクエスト・メソッド

PUT

54.1.5 ミドルウェア・プールの更新

次の表に、ミドルウェア・プールを更新するためのPUT操作の例を示します。

表54-5 ミドルウェア・プールを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/2

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{
"placementConstraints":[{"name":"NUMBER_OF_INSTANCES","value":["15"]}]
}

リクエスト・メソッド

PUT

54.1.6 リソース・プロバイダの削除(PaaSインフラストラクチャ・ゾーンまたはミドルウェア・プール)

次の表に、PaaSインフラストラクチャ・ゾーンまたはミドルウェア・プールを削除するためのDELETE操作の例を示します。

表54-6 PaaSインフラストラクチャ・ゾーンを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/1

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

なし

リクエスト・メソッド

DELETE

54.2 割当て制限

この項では、割当て制限のSOA/OSB APIをリストします。

- 割当て制限設定の詳細の表示

- SSAユーザー・ロールの割当て制限の作成

- SSAユーザー・ロールの割当て制限の更新

- SSAユーザー・ロールの割当て制限の削除

54.2.1 割当て制限設定の詳細の表示

次の表に、表現を返す割当て制限URIに対するGET操作の例を示します。この操作は、MWaaSのすべてのSSAユーザー・ロールの割当て制限設定を返します。

表54-7 割当て制限設定の詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
name: "Middleware Cloud Quotas"
description: "Middleware Cloud Quotas per SSA User Role"
quotas: [1]
0:  {
roleName: "SSA_USER_ROLE"
memory: "4"
javaServersCount: "10"
}-
-
selfLink: "https://slc06ekg.us.example.com:5416/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas"
}

54.2.2 SSAユーザー・ロールの割当て制限の作成

次の表に、SSAユーザー・ロールの割当て制限を作成するための割当て制限URIに対するPOST操作の例を示します。

表54-8 SSAユーザー・ロールの割当て制限設定を作成するためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{
"roleName": "SSA_ROLE"
"memory": "5"
"javaServersCount": "10"
}

リクエスト・メソッド

POST

54.2.3 SSAユーザー・ロールの割当て制限の更新

次の表に、SSAユーザー・ロールの割当て制限を更新するためのPUT操作の例を示します。

表54-9 SSAユーザー・ロールの割当て制限設定を更新するためのPUTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{
"roleName": "SSA_ROLE"
"memory": "10"
"javaServersCount": "5"
}

リクエスト・メソッド

PUT

54.2.4 SSAユーザー・ロールの割当て制限の削除

次の表に、SSAユーザー・ロールの割当て制限を削除するためのDELETE操作の例を示します。

表54-10 SSAユーザー・ロールの割当て制限を削除するためのDELETEリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/quotas

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{
"roleName": "SSA_ROLE"
}

リクエスト・メソッド

DELETE

54.3 サービス・テンプレート

この項では、サービス・テンプレートのAPIをリストします。

- すべてのサービス・テンプレートの詳細の表示

- 特定のサービス・テンプレートの詳細の表示

- サービス・テンプレートの削除

- サービス・テンプレートの作成

54.3.1 すべてのサービス・テンプレートの詳細の表示

次の表に、表現を返すサービス・テンプレートURIに対するGET操作の例を示します。

表54-11 すべてのサービス・テンプレートの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

なし

リクエスト・メソッド

GET

54.3.2 特定のサービス・テンプレートの詳細の表示

次の表に、表現を返す特定のサービス・テンプレートURIに対するGET操作の例を示します。

表54-12 特定のサービス・テンプレートの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/21/

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

なし

リクエスト・メソッド

GET

54.3.3 サービス・テンプレートの削除

次の表に、サービス・テンプレートを削除するためのDELETE操作の例を示します。

表54-13 サービス・テンプレートを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/21

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

なし

リクエスト・メソッド

DELETE

54.3.4 サービス・テンプレートの作成

次の表に、SOA/OSBサービス・テンプレートを作成するためのPOSTリクエスト構成をリストします。

54.3.4.1 サービス・テンプレート・タイプの表示

次の表に、表現を返すサービス・テンプレート・タイプURIに対するGET操作の例を示します。

表54-14 サービス・テンプレート・タイプの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/templatetypes/

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

なし

リクエスト・メソッド

GET

54.3.4.2 サービス・テンプレート・メタデータ詳細の取得

次に、サービス・テンプレート・メタデータ情報を更新するためのサービス・テンプレートURIに対するPOST操作の例を示します。

表54-15 サービス・テンプレート・メタデータ詳細を取得するためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/metadata

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{
"serviceType":"OSB_SERVICE",
"serviceTemplateTypeId":"21"
}

リクエスト・メソッド

POST

54.3.4.3 リソース・プロバイダの特性の取得

次に、リソース・プロバイダを作成するためのサービス・テンプレートURIに対するPOST操作の例を示します。

表54-16 リソース・プロバイダの特性を取得するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/resourceProviders

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{
"serviceType": "OSB_SERVICE",
"serviceTemplateTypeId": "21",
"rscProvAssocOption": [
"byRscLookupChars"
],
"selectedExecutableName": {
"name": "MW_OSBAAS_CREATE_INSTANCE",
"type": "STRING",
"value": "SOAaaSOuterDP",
"defaultValue": "SOAaaSOuterDP",
"required": true,
"secret": false
},
"payloads": [
{
"name": "Profile for OSB",
"value": "<user_input>",
"required": true
}
],
"characteristics": []
}

リクエスト・メソッド

POST

54.3.4.4 サービス・テンプレート構成の作成

次に、サービス・テンプレート構成を作成するためのサービス・テンプレートURIに対するPOST操作の例を示します。

表54-17 リソース・プロバイダを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/configurations

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

Payload: Use  b,c responses.
{
"serviceType":"OSB_SERVICE",
"serviceTemplateTypeId":"21",
"rscProvAssocOption":["byRscLookupChars"],
"payloads":[
{
"name":"Profile for OSB",
"value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_FMWBundle:0792B0CF52D06888E053AC75B10A17C8:0.1"
}
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.EMAS.MWAAS_ZONE",
"values":["C5E76791838043BC71F5D6B70886F13B"]
}
],
"purposeId": 1
}
]
}
}

リクエスト・メソッド

POST

54.3.4.5 これらのレスポンスを使用したサービス・テンプレートの作成

次に、受信したレスポンスを使用してサービス・テンプレートを作成するためのサービス・テンプレートURIに対するPOST操作の例を示します。

表54-18 リソース・プロバイダを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

{
"name": "OSB_ST1",
"displayName": "OSB_ST1",
"serviceType": "OSB_SERVICE",
"serviceTemplateTypeId": "21",
"rscProvAssocOption":["byRscProvInst"],
"roles": [
"SSA_USER1"
],
"payloads": [
{
"name": "Profile for OSB",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_FMWBundle:0792B0CF52D06888E053AC75B10A17C8:0.1",
"required": null
}
],
"selectedExecutableName":
[
{
"name": "MW_OSBAAS_CREATE_INSTANCE",
"value": "SOAaaSOuterDP"
}

],

"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.EMAS.MWAAS_ZONE",
"values":["C5E76791838043BC71F5D6B70886F13B"]
}
],
"purposeId": 1
}
]
},
"configurations": [
{
"name": "postScriptForInstanceCreation",
"type": "SWLIB",
"description": "Script that is invoked after service instance creation",
"required": false,
"secret": false,
"value":"<URN of Script>"

},
{
"name": "portRangeStart",
"type": "STRING",
"description": "Port Range Start",
"value": "1024",
"required": true,
"secret": false
},

{
"name": "preScriptForInstanceCreation",
"type": "SWLIB",
"description": "Script that is invoked before service instance creation",
"required": false,
"secret": false,
"value":"<URN of Script>"
},
{
"name": "destinationFmwBase",
"type": "STRING",
"description": "Middleware Base Location",
"value": "/scratch/osb_mid1",
"required": true,
"secret": false
},
{
"name": "workDir",
"type": "STRING",
"description": "Work Directory",
"value": "$MIDDLEWARE_HOME/work",
"required": true,
"secret": false
},
{
"name": "wlsUserName",
"type": "STRING",
"description": "Weblogic Admin UserName",
"value": "weblogic",
"required": true,
"secret": false
},
{
"name": "startupArguments",
"type": "STRING",
"description": "Server Startup Arguments",
"value" : "",
"required": true,
"secret": false
},
{
"name": "namedCredforHostList",
"type": "STRING",
"description": "Enter the EM Named Credentials to be used for the above hosts in the 'Host for Executing Scripts' field",
"required": false,
"secret": false,
"value":"CredName:CredOwner"
},
{
"name": "destinationAdminServerPassword",
"type": "STRING",
"description": "Password for the WebLogic Server",
"value" : "welcome1"
"required": true,
"secret": true
},

{
"name": "computedCpuUsagePerServer",
"type": "STRING",
"description": "Avg CPU Usage",
"value": "1.0",
"required": true,
"secret": false
},
{
"name": "portRangeEnd",
"type": "STRING",
"description": "Port Range End",
"value": "65535",
"required": true,
"secret": false
},
{
"name": "jdkHome",
"type": "STRING",
"description": "Jdk Home",
"value": "/usr/local/packages/jdk6",
"required": true,
"secret": false
},
{
"name": "computedMemoryUsagePerServer",
"type": "STRING",
"description": "Max Heap",
"value": "0.45",
"required": true,
"secret": false
},
{
"name": "enableLoadBalancer",
"type": "STRING",
"description": "Is LBR",
"value": "0",
"required": true,
"secret": false
},
{
"name": "preScriptForInstanceDeletion",
"type": "SWLIB",
"description": "Script that is invoked before service instance deletion",
"required": false,
"secret": false
},
{
"name": "isScriptExecuteOnManagedServers",
"type": "STRING",
"description": "Is Script Executable On Managed Server Hosts",
"value": "0",
"required": true,
"secret": false
},

{
"name": "hostListForScripts",
"type": "STRING",
"description": "Use ',' to separate multiple target hosts",
"required": false,
"secret": false,
"value":"host1,host2"
},
{
"name": "postScriptForInstanceDeletion",
"type": "SWLIB",
"description": "Script that is invoked after service instance deletion",
"required": false,
"secret": false
},
{
"name": "isScriptExecuteOnAdminServer",
"type": "STRING",
"description": "Is Script Executable On Admin Server",
"value": "0",
"required": true,
"secret": false
},
{
"name": "destinationDomainHome",
"type": "STRING",
"description": "Domain Home",
"value": "$MIDDLEWARE_HOME/domains",
"required": true,
"secret": false
}
]
}

リクエスト・メソッド

POST

54.4 ロード・バランサの構成

この項では、ロード・バランサ構成に関連するAPIの例について説明します。

- すべてのロード・バランサ構成リソースの詳細の表示

- 指定されたロード・バランサ構成の詳細の表示

- ロード・バランサ構成の作成

- ロード・バランサ構成の編集

- ロード・バランサ構成の削除

54.4.1 すべてのロード・バランサ構成リソースの詳細の表示

次の表にGETリクエスト構成を示します。

表54-19 ロード・バランサ構成リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs

リクエスト・ヘッダー

本文

なし

リクエスト・メソッド

GET

54.4.2 指定されたロード・バランサ構成の詳細の表示

次の表に、指定されたロード・バランサ構成の詳細を表示するためのGETリクエスト構成をリストします。

表54-20 指定されたロード・バランサ構成の詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs/{lbrId}

リクエスト・ヘッダー

なし

本文

なし

リクエスト・メソッド

GET

54.4.3 ロード・バランサ構成の作成

次に、ロード・バランサ構成を作成するためのロード・バランサURIに対するPOST操作の例を示します。

表54-21 ロード・バランサ・プロバイダを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs

リクエスト・ヘッダー

Authorization :Basic c3lzbWFuOnN5c21hbg==

本文

{
"name": "lbr1",
"description": "desc by rest",
"type": "OHS",
"host": "slc06ekg.example.com",
"agentTargetName": "slc06ekg.example.com:1838",
"credential": "NC_HOST_2014-11-06-070337",
"instanceHome": "/scratch/PS5_OHS/instance_home",
"properties":{ "items":
[
{"name":"HTTP_PORT_RANGE", "value":"8000-9000"},
{"name":"OHS_ROUTING_PROTOCOL", "value": "HTTP"},
{"name":"COMPONENT_NAME", "value": "ohs1"}
]
},
"poolTargets": [ "0FC6D3F6A9FB2456422C1094DA5D14A9" ]
}

リクエスト・メソッド

POST

54.4.4 ロード・バランサ構成の編集

次の表に、ロード・バランサ構成を編集するためのPUTリクエスト構成を示します。

表54-22 ロード・バランサ構成を編集するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs

リクエスト・ヘッダー

Authorization :Basic c3lzbWFuOnN5c21hbg==

本文

{
"name": "lbr1",
"description": "desc by rest",
"type": "OHS",
"id":1004,
"host": "slc06ekg.example.com",
"agentTargetName": "slc06ekg.example.com:1838",
"credential": "NC_HOST_2014-11-06-070337",
"instanceHome": "/scratch/PS5_OHS/instance_home",
"properties":{ "items":
[
{"name":"HTTP_PORT_RANGE", "value":"8000-9000"},
{"name":"OHS_ROUTING_PROTOCOL", "value": "HTTP"},
{"name":"COMPONENT_NAME", "value": "ohs1"}
]
},
"poolTargets": [ "0FC6D3F6A9FB2456422C1094DA5D14A9" ]
}

リクエスト・メソッド

PUT

54.4.5 ロード・バランサ構成の削除

次の表に、ロード・バランサ構成を削除するためのPOSTリクエスト構成を示します。

表54-23 ロード・バランサ構成を削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/admin/wlaas/v2/lbrconfigs/{lbrId}

リクエスト・ヘッダー

なし

本文

なし

リクエスト・メソッド

DELETE

54.5 SSAユーザー操作APIの例

この項では、次のAPI例について説明します。

- すべてのサービス・テンプレートの詳細の表示

- すべてのサービス・インスタンスの詳細の表示

- UPステータスのすべてのサービス・インスタンスの表示

- サービス提供メタデータの表示

- サービス・インスタンス・リクエストの作成

- サービス・インスタンスのすべてのアクションIDの表示

- サービス・インスタンスの停止

- サービス・インスタンスの起動

- サービス・インスタンスの削除

- サービス・インスタンスのスケール・アップ

54.5.1 すべてのサービス・テンプレートの詳細の表示

次の表に、すべてのサービス・テンプレートを表示するためのGET操作の例を示します。

表54-24 すべてのサービス・テンプレートの詳細を表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/

リクエスト・ヘッダー

Authorization: Basic c3lzbWFuOnN5c21hbg==

本文

なし

リクエスト・メソッド

GET

54.5.2 すべてのサービス・インスタンスの詳細の表示

次の表に、すべてのサービス・インスタンスを表示するためのGET操作の例を示します。

表54-25 すべてのサービス・インスタンスの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances

リクエスト・ヘッダー

なし

本文

なし

リクエスト・メソッド

GET

54.5.3 UPステータスのすべてのサービス・インスタンスの表示

次の表に、UPステータスのすべてのサービス・インスタンスを表示するためのGET操作の例を示します。

表54-26 UPステータスのすべてのサービス・インスタンスを表示するためのGETリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/?expanded=true&status=STATUS_UP

リクエスト・ヘッダー

なし

本文

なし

リクエスト・メソッド

GET

54.5.4 サービス提供メタデータの表示

次の表に、サービス提供メタデータを表示するためのGET操作の例を示します。

表54-27 UPステータスのすべてのサービス・インスタンスを表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{offering_id}/metadata

リクエスト・ヘッダー

なし

本文

なし

リクエスト・メソッド

GET

54.5.5 サービス・インスタンス・リクエストの作成

次の表に、サービス・インスタンスをリクエストするためのPOST操作の例を示します。

表54-28 サービス・インスタンス・リクエストを作成するためのPOSTリクエスト構成

機能

説明

URI

em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services

リクエスト・ヘッダー

Authorization: Basic c3NhX3VzZXIxOndlbGNvbWUx

本文

{
"offeringId":"080C47B7F8EA20ECE053AC75B10A50E3",
"name":"rest_inst01","instanceName":"rest_inst01",
"characteristics": [
{
"name": "ORACLE.SYSMAN.EMAS.MWAAS_ZONE",
"value": "98EB4ECCB01F91E40AA45708112E3920"

]
}
],
"configurations": [
{
"name": "wlsNewPassword",
"type": "STRING",
"description": "New Admin password",
"required": true,
"secret": true,
"value" : "password"
},
{
"name": "destinationDBTargetName",
"type": "STRING",
"description": "SOA Database Service Instance Name",
"required": true,
"secret": false,
"value":"SOADB"
},
{
"name": "soaTokens",
"type": "VECTOR",
"description": "SOA Tokens",
"values": [
"port=80",
"host=www.aol.com"
],
"required": false,
"secret": false
},
{
"name": "destinationDBTargetType",
"type": "STRING",
"description": "SOA Database Service Instance Target Type",
"required": true,
"secret": false,
"value":" oracle_database"
},
{
"name": "destinationSchemaPassword",
"type": "STRING",
"description": "SOA Database Schema Password",
"required": true,
"secret": true,
"value":"DBPassword"
},

{
"name": "startupArguments",
"type": "STRING",
"description": "Server Startup Arguments",
"value": "",
"required": true,
"secret": false
},
{
"name": "wlsNewUserName",
"type": "STRING",
"description": "New Admin User Name",
"required": true,
"secret": false,
"value":"weblogic_user"
}
]
}

リクエスト・メソッド

POST

54.5.6 サービス・インスタンスのすべてのアクションIDの表示

次の表に、アクションIDに基づいてサービス・インスタンスに対するアクションを実行するためのGET操作の例を示します。

表54-29 アクションIDに基づいてサービス・インスタンスに対するアクションを実行するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E/actions

リクエスト・ヘッダー

なし

本文

なし

リクエスト・メソッド

GET

54.5.7 サービス・インスタンスの停止

次の表に、サービス・インスタンスを停止するためのPUT操作の例を示します。

表54-30 サービス・インスタンスを停止するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: Basic c3NhX3VzZXIxOndlbGNvbWUx

本文

{"actionId":32}

リクエスト・メソッド

PUT

54.5.8 サービス・インスタンスの起動

次の表に、サービス・インスタンスを起動するためのPUT操作の例を示します。

表54-31 サービス・インスタンスを起動するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

Authorization: Basic c3NhX3VzZXIxOndlbGNvbWUx

本文

{"actionId":31}

リクエスト・メソッド

PUT

54.5.9 サービス・インスタンスの削除

次の表に、サービス・インスタンスを削除するためのPUT操作の例を示します。

表54-32 サービス・インスタンスを削除するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

なし

本文

{"actionId":30}

リクエスト・メソッド

PUT

54.5.10 サービス・インスタンスのスケール・アップ

次の表に、サービス・インスタンスをスケール・アップするためのPUT操作の例を示します。

表54-33 サービス・インスタンスをスケール・アップするためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/21324EF5A81B4D8ECA7F835A209B857E

リクエスト・ヘッダー

なし

本文

{"actionId":29,
"configurations": [{"name": "numberOfServers","value": "2"}]
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"requests":[{"id":"621",
"actionName":"SCALE_UP",
"canonicalLink":{"href":"https://xyxy.example.com:11040/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/621"}
}]
}

55 ラピッドスタート・クラウド設定

この章では、ラピッドスタート・クラウド設定キットについて説明します。内容は次のとおりです。

- はじめに

- キットのインストール

- キットの内容

- 前提条件

- ラピッドスタート・キットにより作成されるアーティファクト

- ラピッド・キットのモード

- クラウド設定入力: 簡易モード

- クラウド設定入力: 拡張モード

- コマンドライン・インタフェース

- ラピッドスタート・キットのサンプル実行

55.1 概要

DBaaSクラウドを設定するには、いくつかの手順を実行する必要があります。設定を完了するには、CLOUD_ADMINISTRATORロールを持つユーザーが、多数のウィザードを実行し、何度もクリックを行う必要があります。この作業では、DBaaSが使用できるようになるまでに、多くの労力と時間を必要とします。

ラピッドスタート・キットを使用すると、単一のコマンド・ソリューションでDatabase as a Service (DBaaS)およびPluggable Database as a Service (PDBaaS)用のクラウドを設定できます。1つのコマンドで、ロール、管理者、資格証明、データベース・プロファイル、PaaSインフラストラクチャ・ゾーン、データベース・プールおよびサービス・テンプレートなどのすべてのクラウド・アーティファクトを作成できます。ラピッドスタート・キットの実行が正常に終了したら、データベースおよびPDBをプロビジョニングするためのリクエストを作成できます。

ラピッドスタート・キットでは、複数のゾーン、プールおよびサービス・テンプレートを含む複雑なトポロジを作成できます。スタンバイ・データベースもサポートされています。

55.2 キットのインストール

ラピッドスタート・キットは、Oracle Cloud Application 12.1.0.8.0に同梱されて出荷されます。このキットは、Oracle Cloud Application 12.1.0.8.0がプラグイン・ホーム・ディレクトリにインストールされているOracle Management Serverホストで利用できます。ラピッドスタート・キットは、Oracle Management Server (OMS)がインストールされているホストから、またはEnterprise Managerコマンドライン・インタフェース(EMCLI)を介してOracle Management Serverホストにアクセスできる他の任意のホストから使用できます。

55.2.1 OMSホスト

ラピッドスタート・キットは、OMSがインストールされているホストから直接使用できます。キットを個別にインストールする必要はありません。このキットへは、次のディレクトリからアクセスできます。

EM_BASE/oracle/MW/plugins/oracle.sysman.ssa.oms.plugin_12.1.0.8.0/dbaas/setup

55.2.2 他のホスト

このキットは、他の任意のホストからも使用できます。キットを他の任意のマシンにインストールするには、設定ディレクトリをターゲット・マシンの希望する場所にコピーします。

55.3 キットの内容

ラピッドスタート・キットには、次のファイルが含まれています。

- クラウド設定スクリプト:
dbaas/setup/exadata_cloud_setup.py

dbaas/setup/database_cloud_setup.py

これらのスクリプトには、1つのコマンドでクラウド設定を行うためのコードが含まれます。このスクリプトは、入力ファイルまたは構成ファイルで定義されているクラウド・アーティファクトを使用します。

- クラウド境界XML:
dbaas/setup/config/cloud_boundary.xml

dbaas/setup/config/cloud_custom_boundary.xml

クラウド境界は、クラウド・トポロジを定義します。これには、ゾーンおよびプールに加え、ホスト名、Oracleホームの場所またはコンテナ・データベースの名前が含まれます。cloud_boundary.xmlファイルは、1つのゾーンおよびプールを持つExadataマシンで単純なクラウド設定をするためにテンプレートとして使用できます。cloud_custom_boundary.xmlは、複数のゾーンおよびプールを持つマシンのセットで高度なクラウド設定をするために使用できます。

- Database as a Service入力XML:
dbaas/setup/config/dbaas_cloud_input.xml dbaas/setup/config/dbaas_cloud_custom_input.xml

Database as a Service用のクラウド設定は、入力ファイルとしてdbaas_cloud_input.xmlを使用します。このスクリプトは、この構成ファイルを読み込み、ファイルに定義されているようにクラウド・アーティファクトを設定します。Exadataマシンでの単純なクラウド設定は、dbaas_cloud_input.xmlテンプレート・ファイルに定義されますが、高度なクラウド設定ではdbaas_cloud_custom_input.xmlを使用する必要があります。

- Pluggable Database as a Service入力XML:
dbaas/setup/config/pdbaas_cloud_input.xml

dbaas/setup/config/pdbaas_cloud_custom_input.xml

Pluggable Database as a Service用のクラウド設定は、入力ファイルとしてpdbaas_cloud_input.xmlを使用します。このスクリプトは、この構成ファイルを読み込み、ファイルに定義されているようにクラウド・アーティファクトを設定します。Exadataマシンでの単純なクラウド設定は、pdbaas_cloud_input.xmlテンプレート・ファイルに定義されますが、高度なクラウド設定ではpdbaas_cloud_custom_input.xmlを使用する必要があります。

55.4 前提条件

ラピッドスタート・キットを実行するには、特定の前提条件を満たす必要があります。これには、「サポートされているプラグイン」にリストされている適切なプラグイン・バージョンでOMSを設定することが含まれます。クラウド設定は、データベース・インスタンスまたはOracleホームがインストールされているReal Application Clustersマシンで実行できます。前提条件については、次の項で説明します。

55.4.1 Oracle Management Server

- Oracle Management Serverには、Oracle Cloud Application 12.1.0.8がデプロイされている必要があります。

- ソフトウェア・ライブラリが構成されている必要があります。

55.4.2 EMCLI設定

スクリプト・オプションを備えたEMCLIを、キットの実行元となるホストに設定する必要があります。ホストにEMCLIを設定するには、次の手順に従います。

1. URL https://<omshost>:<omsport>/em/public_lib_download/emcli/kit/emcliadvancedkit.jarを使用して、emcliadvancedkit.jarをOMSからダウンロードします。

2. JAVA_HOME環境変数を設定し、PATHに含まれていることを確認します。Java 1.6.0_43以降を実行している必要があります。たとえば、次のようになります。

- setenv JAVA_HOME /usr/local/packages/j2sdk

- setenv PATH $JAVA_HOME/bin:$PATH

3. スクリプト・オプションを備えたEMCLIは、OMSが動作しているマシンまたはネットワーク上の任意のマシン(emcliadvancedkit.jarをそのマシンにダウンロードする必要あり)のディレクトリにインストールできます。
java -jar emcliadvancedkit.jar client -install_dir=<emcli client dir>

4. sync動詞を使用して特定のOMS向けにクライアントを設定する方法の説明については、EMCLIホーム(EMCLIをインストールしたディレクトリ)からemcli help syncを実行します。

5. 「設定」メニュー、「コマンドライン・インタフェース」の順に移動します。EMCLIを設定する方法の詳細は、Enterprise Managerコマンドライン・ツールのダウンロード・ページを参照してください。

55.4.3 インフラストラクチャの設定

クラウド設定用にインフラストラクチャを準備するには、Real Application Clusterマシンが利用可能で、必須のデータベースおよびOracleホームがそのマシン上で設定されている必要があります。ターゲットがOracle Management Serverで検出されている必要があります。次の項では、PDbaaSおよびDBaaSを設定するための要件を説明します。

55.4.3.1 Pluggable Database as a Service

Real Application Clusterマシンが利用でき、そのマシン上で12.1.0.1のコンテナ・データベース・バージョンが動作している必要があります。Real Application Clusterのすべてのホストに、管理エージェントがインストールされている必要があります。ガイド付き検出プロセスを使用して、次のターゲットを検出する必要があります。

- Oracleクラスタ

- Cluster ASM

- Oracle RACデータベース

- Oracle Databaseリスナー

55.4.3.1.1 Database as a Service

Oracleホームのバージョン12.1.0.1または11.2.0.3がインストールされているReal Application Clusterが利用できる必要があります。Real Application Clusterのすべてのホストに、管理エージェントがインストールされている必要があります。ガイド付き検出プロセスを使用して、次のターゲットを検出する必要があります。

- Oracleクラスタ

- Cluster ASM

- Oracle RACデータベース

- データベース・インスタンス

- Oracle Databaseリスナー

55.5 ラピッドスタート・キットにより作成されるアーティファクト

ラピッドスタート・キットは、クラウド入力ファイルを使用して、クラウド・エンティティを作成します。クラウド入力ファイルは、エンティティのリストおよび各エンティティの入力値を定義します。入力ファイルの詳細は、第55.3項「キットの内容」を参照してください。この項では、クラウド設定の一環として作成されるクラウド・アーティファクトについて説明します。

クラウド・スクリプトを実行すると、次の処理が実行されます。

1. 次のロールが作成されます。

表55-1 作成されるユーザー・ロール

ロール

関連付けられたシステム・ロール

SSA_USER_ROLE

EM_SSA_USER

2. 次のユーザーが作成されます。

表55-2 作成されるユーザー

Administrator / User

関連付けられたロール

CLOUD_ADMIN

EM_CLOUD_ADMINISTRATOR

SSA_ADMIN

EM_SSA_ADMINISTRATOR

SSA_USER1

EM_SSA_USER1

SSA_USER2

EM_SSA_USER2

SSA_USER3

EM_SSA_USER3

3. ラピッドスタート・キットでは、即時利用可能な資格証明の作成はサポートされません。クラウドの設定時にキットから入力を求められたら、次の資格証明を手動で作成する必要があります。

表55-3 手動で作成する資格証明

資格証明

説明

HOST_CRED

ホストのユーザー名およびパスワードを含むホスト資格証明

HOST_CRED_ROOT

ルート・アクセス権限を持つホスト資格証明

DB_CRED

データベース・アクセス資格証明

GI_CRED

グリッド・インフラストラクチャ所有者ユーザー

注意:
名前付き資格証明の作成は限定付きでサポートされています。テンプレートXMLでは、資格証明セクションはコメント化されています。資格証明セクションを非コメント化して、名前付き資格証明の作成を有効化します。

4. 割当て制限が、SSA_USER_ROLEに対して設定されます。

5. PaaSインフラストラクチャ・ゾーンが作成され、Oracleクラスタの一部であるホストがゾーンのメンバーとして追加されます。

6. データベース・プロビジョニング・プロファイル。ラピッドスタート・キットは、クラウド設定の一環として次のデータベース・プロファイルを作成できます。

- DBCAテンプレート

- データを含むDBCAテンプレート

- RMANイメージを使用するプロファイル

- 全体エクスポート・データベースを含むスキーマ・プロファイル

- スナップショット・データベース・プロファイル

7. EM_SSA_ADMINロールを持つユーザーが、次のものを作成します。

- DBaaSプール: DBaaSプールは、選択したゾーンの一部であるホストのOracleホームを含みます。DBaaSプールは、Database as a Service用に使用されます。

- PDBaaSプール: 選択したゾーンの一部であるホストのコンテナ・データベース・インスタンスを含みます。PDBaaSプールは、Pluggable Database as a Service用に使用されます。

8. EM_SSA_ADMINロールを持つユーザーが、次のものを作成します。

- デフォルトのデータベース・サービス・テンプレート: このサービス・テンプレートは、データベースに対するリクエストを発行するために使用できます。

- デフォルトのプラガブル・データベース・サービス・テンプレート: このサービス・テンプレートは、プラガブル・データベースに対するリクエストを発行するために使用できます。

- データベース・プロファイルを使用するサービス・テンプレート。

55.6 ラピッド・キットのモード

ラピッドスタート・キットでは、次の2つのモードがサポートされます。

- 簡易モード(Exadataのみ)

- 拡張モード(Exadataおよび非Exadata)

55.6.1 簡易モード(Exadataのみ)

簡易モードでは、ラピッドスタート・キットは、指定されたExadataマシンに単一のゾーンおよびプールを作成します。簡易モードの参照テンプレートは、次のとおりです。

pdbaas_cloud_input.xml

dbaas_cloud_input.xml

cloud_boundary.xml

55.6.2 拡張モード(Exadataおよび非Exadata)

拡張モードでは、ラピッドスタート・キットは、ホストのセットに複数のゾーンおよびプールを作成するために使用できます。拡張モードの参照テンプレートは、次のとおりです。

pdbaas_cloud_custom_input.xml

dbaas_cloud_custom_input.xml

cloud_custom_boundary.xml

55.7 クラウド設定入力: 簡易モード

クラウド設定では、RAC環境およびクラウド・アーティファクトに固有の多くのユーザー入力を必要とします。ラピッドスタート・キットには、クラウド入力を定義する2つの構成ファイルがあります。次のクラウド入力ファイルが、構成ディレクトリの下にあります。

- cloud_boundary.xml: クラウド・トポロジを定義します。

- dbaas_cloud_input.xml: Database as a Service用のクラウド・アーティファクトおよび入力値を定義します。

- pdbaas_cloud_input.xml: Pluggable Database as a Service用のクラウド・アーティファクトおよび入力値を定義します。

クラウド入力ファイルを確認し、アーティファクトを第55.5項「ラピッドスタート・キットにより作成されるアーティファクト」で定義されているアーティファクトにマップします。cloudadmin="True"とマーク付けされているユーザーはPaaSゾーンを作成するクラウド管理者として使用され、ssaadmin="True"とマーク付けされているユーザーはデータベース・プールを作成するために使用されます。キットで使用されるすべてのパスワードは、welcome1です。

注意: 簡易モードを使用してクラウドを作成できるのは、Exadataマシンのみです。Exadata以外の設定は、「クラウド設定入力: 拡張モード」を参照してください。

55.7.1 Pluggable Database as a Service: 簡易モード

pdbaas_cloud_input.xmlに環境固有の値はありません。Pluggable Database as a Serviceは、即時実行可能な入力xmlを変更することなく実行できます。

55.7.2 Database as a Service: 簡易モード

Database as a serviceには、環境固有の値がわずかですがあります。ユーザーは、使用するReal Application Clusterに適合するようにそれらを設定する必要があります。

表55-4 環境詳細の入力ガイドライン

XML入力

編集ガイドライン

プール・フィルタ:

<platform>226</platform>

<version>12.1.0.1.0</version>

プラットフォーム値をReal Application Clusterマシン・プラットフォームのARU IDに編集します。Linux x86-64には226、Solaris x86には267、Solaris Sparc 64.には23を使用します。

データベース・バージョンを、Real Application Clusterマシンにインストールされているデータベースの正しい値に編集します。

サービス・テンプレート:<REDO_FILE_LOCATION>RECOSLC16</REDO_FILE_LOCATION>

<RECOVERY_FILE_LOCATION>RECOSLC16</RECOVERY_FILE_LOCATION><DATA_FILE_LOCATION>DATASLC16</DATA_FILE_LOCATION>

クラウド設定では、ASMとファイル・システムを使用するReal Application Clusterがサポートされます。ASMとファイル・システムの共有場所におけるREDOファイル、リカバリ・ファイルおよびデータ・ファイルで使用するディスク・グループ名を指定します。

<COMMON_DB_SYSTEM_PASSWORD>welcome1</COMMON_DB_SYSTEM_PASSWORD> <COMMON_DB_DBSNMP_PASSWORD>welcome1</COMMON_DB_DBSNMP_PASSWORD> <COMMON_DB_SYS_PASSWORD>welcome1</COMMON_DB_SYS_PASSWORD>

system、dbsnmpおよびsysアカウントのパスワードを指定します。

55.7.3 入力カスタマイズ: 簡易モード

ラピッド設定キットは、入力値の論理カスタマイズをサポートします。顧客は、即時実行可能な入力ファイルのコピーを作成できます。入力値を論理的にカスタマイズし、修正したファイルをラピッド設定キットに渡します。

例: ユーザーはロール名をSSA_USER_ROLEからSSA_QA_ROLEに変更することを希望します。変更は次のように行います。

元のxmlタグ:

<role name="SSA_USER_ROLE" description="SSA User role">
<systemRoles>
<systemRole>EM_SSA_USER</systemRole>
</systemRoles>
<users></users>
</role>

変更後のタグ:

<role name="SSA_QA_ROLE" description="SSA QA role">
<systemRoles>
<systemRole>EM_SSA_USER</systemRole>
</systemRoles>
<users></users>
</role>

ユーザーは前述のロール名が使用されている場所を調査して、適宜変更する必要があります。ロール名の変更により、次のユーザー・タグは、

<user>
<userName>SSA_USER1</userName>
<passWord>welcome1</passWord>
<!-- system roles or above created role -->
<systemRole>SSA_QA_ROLE</systemRole>
</user>

新しいロール名を使用するように変更する必要があります。

<user>
<userName>SSA_USER1</userName>
<passWord>welcome1</passWord>
<!-- system roles or above created role -->
<systemRole> SSA_USER_ROLE</systemRole>
</user>

ユーザーは、入力XMLで定義されているロールの名前および説明、ユーザー、資格証明名、プール名およびサービス・テンプレートの名前とプロパティを変更できます。たとえば、顧客は作業負荷をカスタマイズして、環境をPDBaaS用に適合させることができます。ユーザーは、データベースSID名およびドメイン名を次のようにカスタマイズできます。dbaas_cloud_input.xmlで、次のタグを

<DB_SID_PREFIX>dbsid</DB_SID_PREFIX>
<COMMON_DOMAIN_NAME>mycompany.com</COMMON_DOMAIN_NAME>

次のとおりに変更します。

<DB_SID_PREFIX>dbsid</DB_SID_PREFIX>
<COMMON_DOMAIN_NAME>company.com</COMMON_DOMAIN_NAME>

同様に、DbaaSのinitパラメータをsga_targetおよびpga_aggregate_target用に変更できます(これを行うには、それらの値をdbaas_cloud_input.xmlで編集します)。

55.8 クラウド設定入力: 拡張モード

拡張モードは、カスタマイズされたクラウド・トポロジを使用してホストのセットでクラウドを設定する場合に役立ちます。ラピッドスタート・キットには、クラウド入力を定義する3つの構成テンプレート・ファイルがあります。次のクラウド入力ファイルが、構成ディレクトリの下にあります。

- cloud_custom_boundary.xml: クラウド・トポロジを定義します。

- dbaas_cloud_custom_input.xml: Database as a Service用のクラウド・アーティファクトおよび入力値を定義します。

- pdbaas_cloud_custom_input.xml: Pluggable Database as a Service用のクラウド・アーティファクトおよび入力値を定義します。

クラウド入力ファイルを確認し、アーティファクトを第55.5項「ラピッドスタート・キットにより作成されるアーティファクト」で定義されているアーティファクトにマップします。cloudadmin="True"とマーク付けされているユーザーはPaaSゾーンを作成するクラウド管理者として使用され、ssaadmin="True"とマーク付けされているユーザーはデータベース・プールを作成するために使用されます。キットで使用されるすべてのパスワードは、welcome1です。

55.8.1 カスタム・ユーザーの作成

カスタム・ユーザーを作成するには、cloud_input.xmlファイルで次のタグを編集して新しいユーザー名のロールを追加します。cloudadmin="True"とマーク付けされているユーザーはPaaSゾーンを作成するクラウド管理者として使用され、ssaadmin="True"とマーク付けされているユーザーはデータベース・プールを作成するために使用されます。

<user cloudadmin="True">
<userName>CLOUD_ADMIN</userName>
<!-- If password is empty, default password welcome1 will be used -->
<passWord></passWord>
<!-- system roles or above created custom role name -->
<systemRole>EM_CLOUD_ADMINISTRATOR</systemRole>
</user>

注意:

- ssaadmin="True"を指定して、1人のユーザーをセルフ・サービス管理者として設定できます。

- cloudamin="True"を指定して、1人のユーザーをクラウド管理者として設定できます。

55.8.2 Pluggable Database as a Service: 拡張モード

Pluggable Database as a Serviceの入力ファイルを準備するには、次の入力カスタマイズが必要です。

- cloud_custom_boundary.xmlテンプレート・ファイルのコピーを作成します。

- コピーを編集してゾーンおよびプールを定義します。クラウド・トポロジに基づいて、複数のプールを持つ1つ以上のゾーンを作成できます。

表55-5 プールとゾーンを作成するためのXML編集ガイドライン

XML入力

編集ガイドライン

<dbinstance>

<dbName></dbName>

</dbinstance>

pdbaaspoolタグのプール定義ごとにコンテナ・データベースのインスタンス名を指定します。

プール・フィルタ:

<dbType>rac_database</dbType>

<version>12.1.0.1.0</version>

データベース・バージョンとデータベース・タイプを編集して、プールで使用されるデータベースのタイプとバージョンにします。クラスタ・データベースでは、タイプをrac_databaseと指定し、単一インスタンス・データベースでは、タイプをoracle_databaseと指定します。

<zone>DBaaS Zone</zone>

プールが属するゾーンの名前を指定します。

pdbaas_cloud_custom_input.xmlテンプレート・ファイルのコピーを作成します。既存のプロファイルを使用するか、ラピッドスタート・キットで参照ターゲットを使用して新しいデータベース・プロファイルを作成できます。既存のプロファイルを使用するには、profilesタグを削除します。テンプレートには、異なるタイプのプロファイルのサンプル・タグが含まれます。XMLを編集して、設定に必要ないプロファイルを削除します。ラピッドスタート・キットを使用して、クラウド設定の一環としてデータベース・プロファイルを作成するために、次の詳細を指定します。

表55-6 データベース・プロファイルを作成するためのXML編集ガイドライン

XML

編集ガイド・ライン

<REFERENCE_DATABASE>skd</REFERENCE_DATABASE>

<REF_NODE_SELECTED>abc1.example.com</REF_NODE_SELECTED>

Enterprise Managerによる参照データベースのターゲット名を入力します。

参照ノード名を入力します。

<REFERENCE_DATABASE_TYPE>rac_database</REFERENCE_DATABASE_TYPE>

oracle_database (単一インスタンス・データベース用)やrac_database (RACデータベース用)などのデータベース・タイプを指定します。

<DB_VERSION>11.2.0.4.0</DB_VERSION>

参照データベースのRDBMSバージョンを指定します。例: 11.2.0.4.0、12.1.0.1.0など。

<PROFILE_PLATORM>linux_x86_64</PROFILE_PLATORM>

参照データベースのプラットフォームを指定します。

プロファイルは、デフォルトで次の場所に作成されます。

Database Provisioning Profiles/ <PROFILE_VERSION>/<PROFILE_PLATORM>

<REF_GI_CREDENTIALS>ORACLE_NORMAL:SSA_ADMIN</REF_GI_CREDENTIALS>

<REF_DB_CREDENTIALS>DB_CRED_NORMAL:SSA_ADMIN</REF_DB_CREDENTIALS>

<REF_HOST_CREDENTIALS>ORACLE_NORMAL:SSA_ADMIN</REF_HOST_CREDENTIALS>

<CRED_NAME>:<CRED_OWNER_USER>という形式でグリッド資格証明、参照データベース資格証明およびホスト資格証明の名前を入力します。

ダンプ・ディレクトリ<dumpdir>DATA_PUMP_DIR</dumpdir>

ダンプ・ファイルとエクスポート・ログに使用するダンプ・ディレクトリを入力します。

<PROFILE_NAME>RAC dbm01 Profile</PROFILE_NAME>

<PROFILE_DESC>Database provisioning profile</PROFILE_DESC>

プロファイル名と説明を入力します。

プロファイルを使用するサービス・テンプレートでのこのプロファイル名を入力します。

プラガブル・データベース・サービス・テンプレートを作成するために、次の詳細を指定します。

表55-7 プラガブル・データベース・サービス・テンプレートのXML編集ガイドライン

XML入力

編集ガイド・ライン

<zone>

<zoneName></zoneName>

<poolName></poolName>

</zone>

このサービス・テンプレートの一部となるゾーンおよびプールを指定します。

<PROFILE_COMPONENT_NAME></PROFILE_COMPONENT_NAME>

このサービス・テンプレートで使用されるデータベース・プロファイル名を入力します。このタグが空の場合、空のプラガブル・データベースが作成されます。

<DUMP_FILE_SHARED_LOCATION></DUMP_FILE_SHARED_LOCATION>

ダンプ・ファイルがコピーされる共有場所を指定します。これは、プロファイルの作成時に使用される共有場所に設定します。

<customScripts>

<beforecreateserviceinstance></beforecreateserviceinstance>

<aftercreateserviceinstance></aftercreateserviceinstance>

サービス・インスタンスを作成する前後に実行されるカスタム・スクリプト・ソフトウェア・ライブラリのディレクティブ名を指定します。データベースの前処理および後処理スクリプトを参照してください。

<beforedeleteserviceinstance></beforedeleteserviceinstance>

<afterdeleteserviceinstance></afterdeleteserviceinstance>

</customScripts>

サービス・インスタンスを削除する前後に実行されるカスタム・スクリプト・ソフトウェア・ライブラリのディレクティブを指定します。

55.8.3 Database as a Service: 拡張モード

Pluggable Database as a Serviceの入力ファイルを準備するには、次の入力カスタマイズが必要です。

- cloud_custom_boundary.xmlテンプレート・ファイルのコピーを作成します。

- コピーを編集してゾーンおよびプールを定義します。クラウド・トポロジに基づいて、複数のプールを持つ1つ以上のゾーンを作成できます。

表55-8 ゾーンとプールを定義するためのXML編集ガイドライン

XML入力

編集ガイド・ライン

<dbHome>

<hostName>host1.example.com</hostName> <oracleHomeLocation>/u01/app/oracle/product/11.2.0.4.0/dbhome_1</oracleHomeLocation>

</dbHome>

このデータベース・プールの一部となるこれらのホスト上に存在するOracleホームを指定します。

Oracleホームの場所のフルパスを指定します。

複数の<dbHome>タグを指定できます。

プール・フィルタ:

<dbType>rac_database</dbType>

<version>12.1.0.1.0</version>

データベース・バージョンとデータベース・タイプを編集して、プールで使用されるデータベースのタイプとバージョンにします。

<zone>DBaaS Zone</zone>

プールが属するゾーンの名前を指定します。

<standbyPool></standbyPool>

このプールのスタンバイ・プール名を指定します。

pdbaas_cloud_custom_input.xmlテンプレート・ファイルのコピーを作成します。既存のプロファイルを使用するか、ラピッドスタート・キットで参照ターゲットを使用して新しいデータベース・プロファイルを作成できます。

ラピッドスタート・キットを使用して次のプロファイルを作成できます。

- DBCAテンプレートを使用するデータベース・プロファイル

- データを含むDBCAテンプレートを使用するデータベース・プロファイル

- スナップショット・データベース・プロファイル

ラピッド・キットを使用して、クラウド設定の一環としてデータベース・プロファイルを作成するために、次の詳細を指定します。

表55-9 データベース・プロファイルを作成するためのXML編集ガイドライン

XML入力

編集ガイド・ライン

参照データベースの詳細:

<REFERENCE_DATABASE>refdb</REFERENCE_DATABASE>

<REF_NODE_SELECTED>abc1.example.com</REF_NODE_SELECTED>

<REFERENCE_DATABASE_TYPE>oracle_database</REFERENCE_DATABASE_TYPE>

<DB_VERSION>11.2.0.4.0</DB_VERSION>

<PROFILE_PLATORM>linux_x86_64</PROFILE_PLATORM>

プロファイルを作成するために使用する参照データベースの次の詳細を指定します。

Enterprise Managerによる参照データベースのターゲット名。

プロファイル作成操作に使用する参照ホスト。

参照データベースのタイプ。例: oracle_database (単一インスタンス・データベース用)およびrac_database (RACデータベース用)。

プロファイルのバージョン。

プロファイルのプラットフォーム。

<data>False</data>

プロファイルには、「構造およびデータ」または「構造のみ」を含めることができます。データを含めるにはTrueを選択します。RMANの場合、データは恒にTrueです。

<snapshot>True</snapshot>

Set to &rsquor;True' for Snapshot profile.

スナップショットのオプションを有効化する前に次の内容を確認します。

- ストレージ・アプライアンスがEnterprise Managerに登録されている。

- 参照として使用するデータベースに対してスナップ・クローン・オプションが有効化されている。

- プロファイル所有者ユーザー(SSA_ADMIN)がストレージにアクセスできる。

- ストレージの監視に使用するストレージ資格証明およびエージェント資格証明が、SSA_ADMINユーザーに対する表示権限を持っている。

注意: 権限を設定するには、次の手順に従います。

1. Enterprise Managerコンソールで、「設定」をクリックします。

2. 「セキュリティ」をクリックし、「名前付き資格証明」を選択します。

3. 資格証明を選択して「アクセスの管理」をクリックします。

4. 「権限の追加」をクリックします。

5. SSA_ADMINユーザーを選択し、「選択」をクリックします。

6. 「保存」をクリックします。

RMANイメージ・プロファイルの入力:<rman>

<enable>True</enable>

<rmanImage>True</rmanImage>

<RMANImageMode>ONLINE</RMANImageMode>

<BackupLocation>/u01/sk</BackupLocation>

<BackupFileTag>feb201402221143</BackupFileTag>

</rman>

有効化フラグをFalseに設定します。

rmanImageフラグをTrueに設定します。

バックアップの場所とバックアップ・タグを指定して、バックアップ・ファイルの場所を識別します。

注意: プロファイルがrmanバックアップを使用して作成されていない場合には、rmanタグは表示されません。

Credentials:<REF_GI_CREDENTIALS>ORACLE_NORMAL:SSA_ADMIN</REF_GI_CREDENTIALS>

<REF_DB_CREDENTIALS>DB_CRED_NORMAL:SSA_ADMIN</REF_DB_CREDENTIALS>

<REF_HOST_CREDENTIALS>ORACLE_NORMAL:SSA_ADMIN</REF_HOST_CREDENTIALS>

次の形式でグリッド資格証明、参照データベース資格証明およびホスト資格証明の名前を入力します。

<CRED_NAME>:<CRED_OWNER_USER>

<PROFILE_NAME>RAC dbm01 Profile</PROFILE_NAME>

<PROFILE_DESC>Database provisioning profile</PROFILE_DESC>

プロファイル名と説明を入力します。

プロファイルを使用するサービス・テンプレートでのこのプロファイル名を入力します。

入力XMLを編集して単一または複数のサービス・テンプレートを作成します。ラピッドスタート・キットを使用して次のサービス・テンプレートを作成できます。

- DBCAテンプレート・プロファイルを使用したサービス・テンプレート

- DBCAテンプレートとデータ・プロファイルを使用したサービス・テンプレート

- スナップショット・データベース・プロファイルを使用したサービス・テンプレート

データベース・サービス・テンプレートを作成するために、次の詳細を指定します。

表55-10 データベース・サービス・テンプレートを作成するためのXML編集ガイドライン

XML入力

編集ガイド・ライン

<zone>

<zoneName></zoneName>

<poolName></poolName>

</zone>

このサービス・テンプレートの一部となるゾーンおよびプールを指定します。

<PROFILE_COMPONENT_NAME></PROFILE_COMPONENT_NAME>

このサービス・テンプレートで使用されるデータベース・プロファイル名を入力します。このタグが空の場合、空のプラガブル・データベースが作成されます。

<COMMON_DB_SYSTEM_PASSWORD></COMMON_DB_SYSTEM_PASSWORD>

<COMMON_DB_DBSNMP_PASSWORD></COMMON_DB_DBSNMP_PASSWORD>

<COMMON_DB_SYS_PASSWORD></COMMON_DB_SYS_PASSWORD>

system、dbsnmpおよびsysユーザーのパスワードを指定します。

<LISTENER_PORT>1521</LISTENER_PORT>

リスナー・ポートを指定します。

<PROFILE_TYPE _USED></PROFILE_TYPE _USED>

値のスナップショットを使用して、スナップショット・データベース・プロファイルを使用したサービス・テンプレートを作成します。

RMANプロファイルがすでに存在し、バックアップの場所がサービス・テンプレートで更新される必要があります。

DBCAプロファイルを使用するサービス・テンプレートを作成するには、パラメータを空のままにします。

<DUMP_FILE_SHARED_LOCATION></DUMP_FILE_SHARED_LOCATION>

記憶域の場所:

<DB_STORAGE_TYPE>ASM</DB_STORAGE_TYPE>

<DATA_FILE_LOCATION>DA</DATA_FILE_LOCATION>

<RECOVERY_FILE_LOCATION>RE</RECOVERY_FILE_LOCATION>

<REDO_FILE_LOCATION>RE</REDO_FILE_LOCATION>

ASMの場合はディスク・グループ名を、FSの場合はファイルの場所を入力します。データ・ファイル、リカバリ・ファイルおよびREDOファイルの場合はファイルの場所を入力します。

ASMの場合、ディスク・グループ名を入力します。

FSの場合、共有記憶域の場所を入力します。

DA、REは、データ・ファイルおよびREDOファイルのディスク・グループ名です。

スタンバイ・データベース:<standbydatabases>

<STANDBY_REQUIRED>False</STANDBY_REQUIRED>

<STANDBY_WORK_DIR>/tmp</STANDBY_WORK_DIR>

<standbydatabase>

<standbyName>Standby1</standbyName>

<databaseType></databaseType> <numberofNodes>2</numberofNodes>

<StandbyDatabaseSIDPrefix>sta1</StandbyDatabaseSIDPrefix>

<STANDBY_DOMAIN_NAME>mycompany.com</STANDBY_DOMAIN_NAME>

<protectionMode>MAX_PERFORMANCE</protectionMode>

<standbyPoolName></standbyPoolName>

</standbydatabase>

</standbydatabases>

12.1.0.4.0以上では、サービス・テンプレートをスタンバイ・データベースで作成できます。

スタンバイ・データベースの詳細を指定します。

- スタンバイ・データベースが必要な場合、これをTrueに設定します。

- スタンバイは、CLONE_OR_FULL_DB=CLONE_DBではサポートされません。

- スタンバイ・データベース用の作業ディレクトリを指定します。

- スタンバイ構成名を指定します。

- スタンバイ・データベースのタイプとして、rac_databaseまたはoracle_databaseを指定できます。

- スタンバイ・データベースのノードの数。

- スタンバイ・データベースのデータベースSID接頭辞。

- データベース・スタンバイ・ドメイン名を指定します。

- スタンバイ・データベースでサポートされる保護モードは、MAX_PROTECTION、MAX_AVAILABILITYおよびMAX_PERFORMANCEです。

- スタンバイ・データベースを作成するために使用する必要のあるプール名を指定します。

注意: スタンバイ・データベースが不要である場合には、このタグは削除またはコメント化が可能です。

<storages>

<storage> <mountPointPrefix>/oracle1</mountPointPrefix>

<space>10</space> <!-- GB -->

</storage>

<storage> <mountPointPrefix>/oracle2</mountPointPrefix>

<space>11</space> <!-- GB -->

</storage>

</storages>

ストレージ・ボリュームの名称およびサイズを指定します。このストレージ・ボリュームの名称は、このボリュームのクローンがマウントされる自動生成されたマウント・ポイントに接頭辞として追加されます。マウント・ポイントの接頭辞が/oracleであるとすると、ソース・パスmountに対するマウント・ポイントは/oracle_my_zzz/mountとなります。

このタグはスナップショットに対して必要なものであり、それ以外のサービス・テンプレートでは削除またはコメント化できます。

<customScripts> <beforecreateserviceinstance></beforecreateserviceinstance> <aftercreateserviceinstance></aftercreateserviceinstance>

サービス・インスタンスを作成する前後に実行されるカスタム・スクリプト・ソフトウェア・ライブラリのディレクティブ名を指定します。データベースの前処理および後処理スクリプトを参照してください。

<beforedeleteserviceinstance></beforedeleteserviceinstance> <afterdeleteserviceinstance></afterdeleteserviceinstance>

</customScripts>

サービス・インスタンスを削除する前後に実行されるカスタム・スクリプト・ソフトウェア・ライブラリのディレクティブを指定します。

スクリプトを何も実行しない場合は、このタグを空白にしておきます。

55.9 コマンドライン・インタフェース

この項では、ラピッドスタート・キットを使用してクラウドを設定するための手順を説明します。クラウド設定スクリプトを実行する前に、すべてのターゲットがEnterprise Managerで検出されていることを確認します。

55.9.1 使用方法

-helpオプションを指定すると、サポートされるすべてのオプションが表示されます。

Usage: emcli @database_cloud_setup.py [-exadata_target_name=<EM system target name>] [-dbaas|-pdbaas] [-cloud_boundary=<file name>] [-cloud_input=<file name>]

-pdbaas:This flag is used to setup Cloud for Pluggable Database as a Service.
-dbaas:This flag is used to setup Cloud for Database as service.
-cloud_input=<path to custom cloud input xml> [ Optional]
Cloud input XML defines Enterprise Manager entities created as part of Cloud Setup.
Default file config/dbaas_cloud_input.xml will be used for database setup
Default file config/pdbaas_cloud_input.xml will be used for pluggable database setup.
Use dbaas_cloud_custom_input.xml or pdbaas_cloud_custom_input.xml to perform an advanced cloud setup.
-cloud_boundary=<path to custom cloud boundary xml> [ Optional]
Cloud boundary XML defines scope for Zones, Pools and the Cloud Hosts.
Default file config/cloud_boundary.xml will be used.
Use cloud_custom_boundary.xml to perform an advanced cloud setup.
-exadata_target_name
Pass Exadata Machine Target Name from Enterprise Manager when setup is running from non-Exadata machine and cloud is set on Exadata machine. This will perform simple cloud setup.
-help: Displays Cloud Setup help
For example:
Setup Cloud on a Cluster Machine or a set of standalone hosts:
Run the script on a cluster node or any standalone Machine:
emcli @database_cloud_setup.py -pdbaas : Sets up Cloud for PDBaaS using list of container databases given in cloud_boundary.xml
emcli @database_cloud_setup.py -dbaas : Sets up Cloud for DBaaS using given list of hosts and oracle home given in cloud_boundary.xml
emcli @database_cloud_setup.py -pdbaas -cloud_input=<Full path to Input XML> : Override the default cloud input xml.
emcli @database_cloud_setup.py -pdbaas -cloud_input=<Full path to Input XML> -cloud_boundary=<Full path to Input XML> : Override the default cloud input and cloud boundary xmls

55.9.2 Database as a Service (DBaaS)

次のコマンドを使用して、DBaaSを設定できます。

ORACLE_HOME/bin/emcli @database_cloud_setup.py –pdbaas -cloud_input=<Full path to cloud input xml> -cloud_boundary=<Full path to cloud boundary xml>

ここで、-dbaasフラグは、これがDatabase as a Serviceを設定するために使用されることを示します。

スクリプトはホストのリストおよびOracleホームの場所を取得します。ラピッドスタート・キットの要求に従って、次の値を入力します。

表55-11 ユーザー入力の詳細

ユーザー入力

説明

Enterprise Managerのホスト名

ホスト名

Enterprise Managerのポート番号

セキュア・ポートのポート番号。

Enterprise Managerユーザー名

管理権限を持つユーザー(sysman)の名前を入力します。

Enterprise Managerユーザーのパスワード

sysmanユーザーのパスワードを入力します。

CLOUD_ADMINユーザーのパスワード

このユーザーはキットにより作成されます。デフォルトのパスワードはwelcome1です。

資格証明の検証

キットから入力を求められたら資格証明を作成します。

クラウド・アーティファクトのいずれかがすでにEnterprise Managerに存在する場合、ラピッド設定キットはメッセージを表示し、それを作成または変更しません。クラウド設定スクリプトは、障害が発生した場合でも、問題を修正した後に何回でも実行できます。キットは新しいアーティファクトを作成し、すでに存在するアーティファクトに関するメッセージを表示します。

55.9.3 Pluggable Database as a Service (PDBaaS)

次のコマンドを使用して、PDBaaSを設定できます。

ORACLE_HOME/bin/emcli @database_cloud_setup.py –pdbaas –exadata_target_name=<Exadata target name from EM>

ORACLE_HOME/bin/emcli @database_cloud_setup.py –pdbaas -cloud_input=<Full path to cloud input xml> -cloud_boundary=<Full path to cloud boundary xml>

ここで、

- -pdbaasフラグは、これがPluggable Database as a Serviceを設定することを示します。

ラピッド設定キットの要求に従って、次の値を入力します。

表55-12 ユーザー入力の詳細

ユーザー入力

説明

Enterprise Managerのホスト名

ホスト名

Enterprise Managerのポート番号

セキュア・ポートのポート番号。

Enterprise Managerユーザー名

管理権限を持つユーザー(sysman)の名前を入力します。

Enterprise Managerユーザーのパスワード

sysmanユーザーのパスワードを入力します。

CLOUD_ADMINユーザーのパスワード

このユーザーはキットにより作成されます。デフォルトのパスワードはwelcome1です。

資格証明の検証

キットから入力を求められたら資格証明を作成します。

クラウド・アーティファクトのいずれかがすでにEnterprise Managerに存在する場合、ラピッド設定キットはメッセージを表示し、それを作成または変更しません。クラウド設定スクリプトは、障害が発生した場合でも、問題を修正した後に何回でも実行できます。キットは新しいアーティファクトを作成し、すでに存在するアーティファクトに関するメッセージを表示します。

55.9.4 クラウド設定の保護

ラピッド設定キットは、クラウド設定の一環として管理者を作成します。キットを使用することで、ユーザーはクラウド設定を保護できるので、認可されたユーザーのみが選択した機能にアクセスできます。ユーザーがクラウド設定の保護を選択すると、キットにより作成されるユーザーのパスワードは、自動で期限切れとなります。Enterprise Managerでは、各ユーザーは最初のログイン時にパスワードを再設定できます。

55.9.4.1 デフォルト・パスワードの期限切れ

ラピッドスタート・キットは、確認を要求し、入力xmlの指定されているすべてのユーザーのパスワードを期限切れにします。

55.9.5 新しいパスワードの設定

管理者は、ユーザーを作成するごとにEnterprise Managerにログインする必要があります。Enterprise Managerは、最初のログイン時に新しいパスワードを設定するように要求します。

注意: ラピッド・キットによりパスワードが期限切れとなった後にキットを再実行する必要がある場合、ラピッド・キットを実行する前にCLOUD_ADMINユーザーおよびSSA_ADMINユーザー用に新しいパスワードを設定し、再実行時にパスワード入力が要求された場合には、新しいパスワードを入力する必要があります。

55.10 ラピッドスタート・キットのサンプル実行

この項では、Pluggable Database as a Serviceのサンプル実行を説明します。

<emcli_path>/emcli @database_cloud_setup.py -pdbaas -cloud_boundary=/u01/cloudsetup/config/boundary_bp.xml -cloud_input=/u01/cloudsetup/config/pdb_input_bp.xml
==================================================================================Cloud Setup Tool
==================================================================================
Log in to Enterprise Manager:
==============================
emcli executable was not found in PATH
Enterprise Manager URL found from emcli setup:
Enter Enterprise Manager Host Name: omshost.example.com
Enter Enterprise Manager Port Number. Hit enter if using portless URL: 7802
Enter Enterprise Manager Super Administrator User Name [sysman]:

Connecting to Enterprise Manager 'https://omshost.example.com:7802/em'...
Login as 'sysman'...
Enter password :  ********
Login successful

Cloud Boundary XML: '/u01/cloudsetup/config/boundary_bp.xml'

Cloud Setup Inputs:
Cloud Input XML: '/u01/cloudsetup/config/pdb_input_bp.xml'

Fetching system information from Enterprise Manager...
Setting up Pluggable Database as a Service (PDBaaS)...
List of Container Databases for pool creation: dbmcdb

+--------------------------------+------------------------------------------------
|              Node              |                Oracle Home Location                |
+--------------------------------+------------------------------------------------
| host1.example.com       | /u01/app/oracle/product/12.1.0.1/dbhome_1          |
+--------------------------------+------------------------------------------------
| host2.example.com       | /u01/app/oracle/product/12.1.0.1/dbhome_1          |
+--------------------------------+------------------------------------------------

Press Enter to continue:
Creating Roles...
Creating Role "SSA_USER_ROLE"...
Role "SSA_USER_ROLE" already exists

Creating Users...
Creating User "SSA_ADMIN"...
User "SSA_ADMIN" already exists

Creating User "CLOUD_ADMIN"...
User "CLOUD_ADMIN" already exists

Creating User "SSA_USER1"...
User "SSA_USER1" already exists

Creating User "SSA_USER2"...
User "SSA_USER2" already exists

Creating User "SSA_USER3"...
User "SSA_USER3" already exists
Following named credentials should be pre-created in Enterprise Manager for this cloud setup:
HOST_CRED_SLCC:CLOUD_ADMIN
HOST_CRED_SLCC:SSA_ADMIN
GI_CRED_SLCC:SSA_ADMIN
DB_CRED:SSA_ADMIN
Named Credentials used in Rapid kit should be created manually and given the required grants. Have you created above listed credentials? (yes/no) [yes]:
User confirmed credential creation.

Connecting to Enterprise Manager &rsquor;https://omshost.example.com:7802/em '...
Login as 'CLOUD_ADMIN'...
Enter password :  ********
Login successful

Creating Quotas...
Creating Quota for Role: SSA_USER_ROLE
Updating Quota for Role: SSA_USER_ROLE
Quota for Role "SSA_USER_ROLE" updated successfully.

Creating zone "PDBaaS Zone"...
PaaS Infrastructure Zone "PDBaaS Zone" created successfully.

Connecting to Enterprise Manager 'https://xyxy.example.com:7802/em'...
Login as 'SSA_ADMIN'...
Enter password :  ********
Login successful

Creating pool "PDBaaS Pool"...
Software Pool "PDBaaS Pool" created successfully.
Creating Profiles...
Profiles will be created in 'serial' mode

Creating Pluggable Database Service Template...
Creating PdbaaS Service Template...
Service Template "Default Pluggable Database Service template" created successfully.
Securing Cloud setup...
Do you want to expire passwords for the users created by setup?(yes/no) [yes]: no
User opted to not expire the passwords.
Cloud Setup Summary:

+--------------------------------+------------------------------------------+-----
|       Type              |      Cloud Entity            |              Status                  |
+--------------------------------+------------------------------------------+-----
| Role                           | SSA_USER_ROLE                  | Already exists                           |
+--------------------------------+------------------------------------------+-----
| User                           | SSA_ADMIN                      | Already exists                           |
+--------------------------------+------------------------------------------+-----
| User                           | CLOUD_ADMIN                   | Already exists                           |
+--------------------------------+------------------------------------------+-----
| User                           | SSA_USER1                      | Already exists                           |
+--------------------------------+------------------------------------------+-----
| User                           | SSA_USER2                      | Already exists                           |
+--------------------------------+------------------------------------------+-----
| User                            | SSA_USER3                     | Already exists                           |
+--------------------------------+------------------------------------------+-----
| PaaS Infrastructure Zone | PDBaaS Zone               | Created                                  |
+--------------------------------+------------------------------------------+-----
| Software Pool                 | PDBaaS Pool              | Created                                  |
+--------------------------------+------------------------------------------+-----
| PDB Service Template        | Default Pluggable Database Service  | Created template                                     |                                          |
+--------------------------------+------------------------------------------+-----

Cloud setup completed successfully for Pluggable Database as a Service (PDBaaS)
Log in to Oracle Management Server url &rsquor;https://omshost.example.com:7802/em' to submit the request for Pluggable Database.

56 EMCLI動詞によるチャージバックとメータリング

この章では、チャージバックとメータリングに使用するEMCLI動詞について説明し、動詞名、説明、パラメータ、構文の詳細を示します。動詞の出力およびコマンドの例も示します。この章の内容は次のとおりです。

- UIと同等のチャージバック操作の実行

- カスタム・チャージ・アイテムの使用

- カスタム・チャージ・アイテム動詞の使用例

- 汎用エンティティ・タイプの作成

- Enterprise Managerからのメータリング・データの取得

56.1 UIと同等のチャージバック操作の実行

この項では、チャージバック・ユーザー・インタフェース内で実行できるものと同じ操作を実行できるEMCLI動詞について説明します。

56.1.1 list_chargeback_entity_types

チャージバックでサポートされるすべてのエンティティ・タイプをリストします。オプションで、すべてのエンティティ・タイプとその個々の使用モードか、または特定のエンティティ・タイプでサポートされるすべての使用モードをリストできます。

構文

list_chargeback_entity_types
-[usage_mode]
-[entity_type="eType"]

パラメータ

- usage_mode: (オプション)各エンティティ・タイプの適用可能なすべての使用モードを表示します。

- entity_type: (オプション)指定されたエンティティ・タイプの適用可能なすべての使用モードを表示します。

例

list_chargeback_entity_types

Entity Type        Entity Type Display Name
oracle_database    Database Instance
host               Host

list_chargeback_entity_types -usage_mode

Entity Type        Entity Type Display Name        Usage Mode
oracle_database    Database Instance               dbMetered
oracle_database    Database Instance               dbByService
oracle_database    Database Instance               cdbBypdb

host               Host                            hostMetered

list_chargeback_entity_types -entity type="oracle database"

Entity Type        Entity Type Display Name        Usage Mode
oracle_database    Database Instance               dbMetered
oracle_database    Database Instance               dbByService
oracle_database    Database Instance               cdbBypdb

56.1.2 list_chargeback_entities

チャージバックに追加されたすべてのエンティティ(チャージとメータリングが計算される任意のタイプのすべてのエンティティ)をリストします。

構文

list_chargeback_entities

例

出力は表形式で、追加されたエンティティごとに次の情報が表示されます。

表56-1 出力の例

列名

列値

エンティティ名

acme_db

エンティティGUID

xrdbyy

エンティティ・タイプ

oracle_database

作成日

2014-01-01 00.00.00.0

親エンティティ名

親なし

親エンティティ・タイプ

適用なし

コスト・センター名

cc1

チャージ・プラン名

cp1

56.1.3 add_chargeback_entity

特定のエンティティ・タイプのエンティティ・インスタンスを、指定された使用モードでチャージバックに追加します。

構文

add_chargeback_entity
-entity_name="eName"
-entity_type="eType"
-usage_mode="uMode"

パラメータ

- entity_name: チャージバックに追加する、Enterprise Managerによって現在監視されているエンティティ・インスタンスを名前で指定します。

- entity_type: 追加するインスタンスのエンティティ・タイプを指定します。

- usage_mode: 使用モード(エンティティ・インスタンスを測定する方法)を指定します。使用可能な使用モードを表示するには、list_chargeback_entity_types動詞と-entity typeオプションを組み合せて使用します。

例

add_chargeback_entity -entity_name="db1" -entity_type="oracle_database" -usage_mode="dbMetered"

データベース・インスタンスによって測定されるエンティティdb1をチャージバックに追加します。

56.1.4 remove_chargeback_entity

チャージバックから特定のエンティティ・タイプのエンティティ・インスタンスを削除します(指定された使用モードのエンティティに対するチャージバック・アクティビティを終了します)。

構文

remove_chargeback_entity
-entity_name="eName"
-entity_type="eType"
-[entity_guid="entity guid"]

パラメータ

- entity_name: チャージバックから削除するエンティティ・インスタンスを名前で指定します。

- entity_type: 削除するインスタンスのエンティティ・タイプを指定します。

- entity_guid: (オプション)エンティティを内部的に認識するグローバル一意識別子を指定します。同じ名前で同じタイプの複数のエンティティが存在する場合、コマンド出力によって、GUIDを含む追加の詳細付きでそれらすべてのエンティティがリストされます。今度は他のパラメータのかわりにentity_guidを使用してコマンドを再実行すると、目的のエンティティを正しく識別できます。

例

remove_chargeback_entity -entity_name="db1" -entity_type="oracle_database"

チャージバックからOracle Databaseエンティティdb1を削除します。

56.1.5 list_charge_plans

チャージバックで現在使用中のすべてのチャージ・プランをリストします。オプションで、将来使用される予定のチャージ・プランをリストします。また、オプションで、エンティティ・タイプまたはチャージ・プランの詳細によって現在または将来のプランをリストできます。

構文

list_charge_plans
[-[entity_type="entity type" -[ all]]
-[charge_plan="charge plan name" -[all]]
-[ all]]

パラメータ

- entity_type: 指定されたエンティティ・タイプのすべてのアクティブなチャージ・プランをリストします。

- charge_plan: 特定のチャージ・プランの詳細をリストします。

- all: チャージバックのアクティブおよび将来のすべてのチャージ・プラン、指定されたエンティティ・タイプのチャージ・プラン、または指定されたチャージ・プランのアクティブおよび将来のすべてのバージョンの詳細をリストします。

例

出力は表形式で、指定したパラメータに応じて次の情報が表示されます。

表56-2 出力の例

列名

列値

チャージ・プラン名

cp1

エンティティ・タイプ

host

説明

ホスト定額プラン

開始日

2014-01-01 00.00.00.0

終了日

2014-02-01 00.00.00.0

56.1.6 assign_charge_plan

指定されたチャージ・プランを特定のタイプのエンティティに割り当てます。

構文

assign_charge_plan
-entity_name="eName"
-entity_type="eType"
-plan_name="pName"
-[entity_guid="entity guid"]

パラメータ

- entity_name: プランを割り当てるエンティティを指定します。

- entity_type: 名前付きエンティティのエンティティ・タイプを指定します。チャージ・プランは、エンティティ・タイプ固有です。

- plan_name: エンティティに割り当てる既存のチャージ・プランの名前を指定します。

- entity_guid: (オプション)エンティティを内部的に認識するグローバル一意識別子を指定します。同じ名前で同じタイプの複数のエンティティが存在する場合、コマンド出力によって、GUIDを含む追加の詳細付きでそれらすべてのエンティティがリストされます。今度は他のパラメータのかわりにentity_guidを使用してコマンドを再実行すると、目的のエンティティを正しく識別できます。

例

assign_charge_plan -entity_name="db1" -entity_type="oracle_database" -plan_name="plan1"

エンティティ・タイプがOracle Databaseのデータベース・インスタンスdb1にチャージ・プランplan1を割り当てます。

56.1.7 unassign_charge_plan

指定されたエンティティからチャージ・プランの割当てを削除します。

構文

unassign_charge_plan
-entity_name="eName"
-entity_type="eType"
-[entity_guid="entity guid"]

パラメータ

- entity_name: プランの割当てを削除するエンティティを指定します。

- entity_type: 名前付きエンティティのエンティティ・タイプを指定します。

- entity_guid: (オプション)エンティティを内部的に認識するグローバル一意識別子を指定します。同じ名前で同じタイプの複数のエンティティが存在する場合、コマンド出力によって、GUIDを含む追加の詳細付きでそれらすべてのエンティティがリストされます。今度は他のパラメータのかわりにentity_guidを使用してコマンドを再実行すると、目的のエンティティを正しく識別できます。

例

unassign_charge_plan -entity_name="db1" -entity_type="oracle_database" -plan_name="plan1"

エンティティ・タイプがOracle Databaseのデータベース・インスタンスdb1からチャージ・プランの割当てを削除します。

56.1.8 list_cost_centers

チャージバックに認識されているすべてのコスト・センターまたは様々な階層表示のコスト・センターをリストします。

構文

list_cost_centers
-[[cost_center_name="cName"]
-[parent]
-[children]
-[top]
-[leaf]]

パラメータ

- cost_center_name: 他のオプションを指定できる特定のコスト・センターを指定します。

- parent: 指定されたコスト・センターの親のコスト・センターを表示します。

- children: 指定されたコスト・センターのすべての子のコスト・センターをリストします。

- top: 指定されたコスト・センターの祖先のコスト・センターを表示します。

- 指定されたコスト・センターのリーフ・ノードのコスト・センターを表示します。

例

list_cost_centers

Cost Center Name          Parent Node          Number
cc1                                       [2,4,0,0]
cc11                      cc1             [2,2,0,0]
cc12                      cc1             [0,0,0,0]
cc111                     cc11            [0,0,0,0]
cc112                     cc11            [0,0,0,0]

数字列は、左から右に向かって、直近の子のコスト・センターの数、子のコスト・センター合計、直接ユーザーの数、ユーザー合計を表します。

前述の例を基本として、list_cost_centers動詞のオプションでは次のように表示されます。

list_cost_centers -cost_center_name="cc11" -parent

Parent Node
cc1

list_cost_centers -cost_center_name="cc1" -children

Children Nodes
cc11
cc12

list_cost_centers -cost_center_name="cc111" -top

Hierarchy
[cc1]----->[cc11]----->[cc111]

list_cost_centers -cost_center_name="cc1" -leaf

Leaf Nodes
cc111
cc112
cc12

56.1.9 assign_cost_center

指定されたコスト・センターを特定のタイプのエンティティに割り当てます。

構文

assign_cost_center
-entity_name="eName"
-entity_type="eType"
-cost_center_name="cName"
-[entity_guid="entity guid"]

パラメータ

- entity_name: コスト・センターを割り当てるエンティティを指定します。

- entity_type: 名前付きエンティティのエンティティ・タイプを指定します。

- cost_center_name: エンティティに割り当てる既存のコスト・センターの名前を指定します。

- entity_guid: (オプション)エンティティを内部的に認識するグローバル一意識別子を指定します。同じ名前で同じタイプの複数のエンティティが存在する場合、コマンド出力によって、GUIDを含む追加の詳細付きでそれらすべてのエンティティがリストされます。今度は他のパラメータのかわりにentity_guidを使用してコマンドを再実行すると、目的のエンティティを正しく識別できます。

例

assign_cost_center_plan -entity_name="db1" -entity_type="oracle_database" -cost_center_name="cc1"

エンティティ・タイプがOracle Databaseのデータベース・インスタンスdb1にコスト・センターcc1を割り当てます。

56.1.10 unassign_charge_plan

指定されたエンティティからコスト・センターの割当てを削除します。

構文

unassign_cost_center
-entity_name="eName"
-entity_type="eType"
-[entity_guid="entity guid"]

パラメータ

- entity_name: コスト・センターの割当てを削除するエンティティを指定します。

- entity_type: 名前付きエンティティのエンティティ・タイプを指定します。

- entity_guid: (オプション)エンティティを内部的に認識するグローバル一意識別子を指定します。同じ名前で同じタイプの複数のエンティティが存在する場合、コマンド出力によって、GUIDを含む追加の詳細付きでそれらすべてのエンティティがリストされます。今度は他のパラメータのかわりにentity_guidを使用してコマンドを再実行すると、目的のエンティティを正しく識別できます。

例

unassign_cost_center -entity_name="db1" -entity_type="oracle_database" -plan_name="plan1"

エンティティ・タイプがOracle Databaseのデータベース・インスタンスdb1からコスト・センターの割当てを削除します。

56.2 カスタム・チャージ・アイテムの使用

次の各項では、サンプル・コマンドをその説明および例とともに示します。これらの動詞は、次の状況で使用されます。

- 測定/チャージは、定義したメトリック拡張/カスタム構成に基づいて行います。カスタム・チャージ・アイテムは、即時利用可能なメトリックおよびターゲット・プロパティにも使用できます。チャージバックは、キー列を持たないメトリック拡張のみをサポートすることに注意してください。

- これらのカスタム・チャージ・アイテムをチャージバックで作成すると、プラグインとともに同梱されている既存のチャージ・アイテム(CPU使用率など)のように、カスタム・アイテムについて測定またはチャージできます。これらの動詞にアクセスするには、EM_CBA_ADMINロールが必要なことに注意してください。

56.2.1 list_charge_item_candidates

チャージバックに登録できるアイテムをリストします。

構文

emcli list_charge_item_candidates
-target_type=<target type>
-source_data_type=<metric|config|property>
-target_name=<target name>
-config_name=<config name>
-config_data_source=<target name>
-all

パラメータ

- target_type: (必須)ターゲット・タイプの名前。サポートされるターゲット・タイプには、oracle_database、oracle_vm_guest、host、oracle_pdbおよびweblogic_j2eeserverが含まれます。

- source_data_type: 有効な値はmetric、configおよびpropertyです。

- target_name: 指定すると、指定されたターゲットのみを対象にメータリングおよびチャージ・データが取得されます。有効なターゲット名を指定しなかった場合、または指定したターゲットが所定の日付範囲で有効になっていない場合、データは生成されません。このパラメータが指定されていない場合、指定したターゲット・タイプのすべてのターゲットが含められます。

- config_name: source_data_type=configの場合に必須です。

- config_data_source: 構成のデータソース。source_data_type=configの場合に必須です。

- all: ターゲット・タイプの即時利用可能なメトリックを含め、すべてのアイテムを表示します。このオプションを指定しないと、ユーザー定義のメトリック拡張および構成拡張のみが表示されます。

例

emcli list_charge_item_candidates -target_type="oracle_database" -source_data_type="metric"

emcli list_charge_item_candidates -target_type="oracle_database" -source_data_type="config" -target_name="myDatabase" -config_name="myCustomCCS" -config_data_source="ccsfile"

56.2.2 create_charge_item

チャージバックのチャージ・アイテムを作成します。

構文

emcli create_charge_item -input_file="property_file:<full path of property file>"

パラメータ

オプション[-input_file]は、アイテム・プロパティを含むファイルのフルパスです。ファイルには、次のプロパティを定義できます。

- target_type: (必須)ターゲット・タイプを指定します。サポートされるターゲット・タイプには、oracle_database、oracle_vm_guest、host、oracle_pdbおよびweblogic_j2eeserverが含まれます。

- source_data_type: (必須)ソースのデータ型を指定します。有効な値はmetric、configおよびpropertyです。

- item_name: (必須)アイテムの名前を指定します。

- metric_group: list_item_candidatesにリストされるメトリック・グループ名。source_data_type=metricの場合、必須プロパティです。

- metric_column: list_item_candidatesにリストされるメトリック列名。source_data_type=metricの場合、必須プロパティ。

- config_view: list_item_candidatesにリストされる構成ビュー名。source_data_type=configの場合、必須プロパティ。

- config_key: list_item_candidatesにリストされる構成キー名。source_data_type=configの場合、必須プロパティ。

- config_column: list_item_candidatesにリストされる構成列名。source_data_type=configの場合、必須プロパティ。

- config_data_source: 構成メトリックのデータソース。source_data_type=configの場合、必須プロパティ。

- property: list_item_candidatesにリストされるプロパティ名。source_data_type=propertyの場合、必須プロパティ。

- item_displayname: (必須)アイテムの表示名。

- unit: 単位の表示名。

- aggregation_type: このアイテムに使用する集計のタイプ。data type=numberの場合にのみ適用されます。有効な値はsumおよびavgです。デフォルト値はavgです。

- is_config_condition: アイテムがチャージ・プランで条件付きで使用されるかどうか。有効な値は0、1です。デフォルト値は0です。

- item_category: アイテムのカテゴリ。デフォルト値はinstanceです。有効な値はcpu、memory、networkおよびinstanceです。

- data_type: データ型。デフォルト値はnumberです。有効な値はstringおよびnumberです。

例

emcli create_charge_item -input_file="property_file:/home/user/property_file"
Contents of /home/user/property_file:
target_type=host
source_data_type=metric
item_name=total_proc
metric_group=Load
metric_column=noOfProcs
item_displayname=Total Processes
unit=process
aggregation_type=avg
item_category=instance
data_type=number

emcli create_charge_item -input_file="property_file:/home/user/property_file"
Contents of /home/user/property_file:
target_type=oracle_database
source_data_type=config
item_name=custom_config
config_view=myCustomCCS
config_key=region
config_column=country
config_data_source=regionList.txt
item_display_name=Region of Instance
item_category=instance
data_type=string

56.2.3 delete_charge_item

チャージバックからカスタム・チャージ・アイテムを削除します。

構文

emcli delete_charge_item  -target_type=<target type> -item_name=<Item name>

パラメータ

- target_type: (必須)カスタム・チャージ・アイテムに関連付けられているターゲット・タイプを指定します。このリリースでサポートされるターゲット・タイプには、oracle_database、oracle_vm_guest、host、oracle_pdbおよびweblogic_j2eeserverが含まれます。

- item_name: (必須)削除するカスタム・チャージ・アイテムの名前。

例

emcli delete_charge_item -target_type="oracle_database" -item_name="SampleMetricExtension"

emcli delete_charge_item -target_type="host" -item_name="SampleCustomConfig"

56.3 カスタム・チャージ・アイテム動詞の使用例

次の各項では、カスタム構成用のカスタム・チャージ・アイテム動詞を正しく使用した場合のエンド・ツー・エンドの例を紹介しています。

56.3.1 メトリック拡張(PGA)

この例では、PGA Memoryという名前のメトリック列を持つメトリック拡張のPGAが、PGAサイズを収集するデータベース・インスタンス・ターゲットに対して作成されます。

図56-1 PGAメモリー

1. EMCLIにログインし、チャージバックEMCLI動詞list_charge_item_candidatesを使用して、チャージバックに登録できるアイテムをリストします。

図56-2 list_charge_item_candidates

2. プロパティ・ファイルprop_fileを作成し、PGA Memoryメトリック列のカスタム・チャージ・アイテムを生成します。
このメトリックに対してaggregation_typeをavgに設定し、チャージ・レートはサンプル数に応じた平均値を基準とします。

図56-3 aggregation_typeの設定

3. create_charge_item EMCLI動詞を使用して、チャージバックのカスタム・アイテムを作成します。

図56-4 カスタム・アイテムの作成

4. カスタム・チャージ・アイテムが作成されると、チャージ・プラン・ページに新しいカスタム・アイテムが表示されます。即時利用可能なチャージ・アイテムに対するレート設定と同様に、カスタム・アイテムに対するレートも設定できます。

図56-5 計画の作成: Custom Plan

aggregation_typeがavgに設定されているため、チャージ・レートは期間に関連します(たとえば、一定期間のGBごと)。

図56-6 確認

56.3.2 メトリック拡張(Application A Orders)

Orders Processedというメトリック列を持つメトリック拡張Application A Ordersが、データベース・インスタンス・ターゲットに対して作成されます。このメトリックは、Application Aにより処理されたオーダー数を収集します。

図56-7 メトリック拡張

1. EMCLIにログインし、チャージバックEMCLI動詞list_charge_item_candidatesを使用して、チャージバックに登録できるアイテムをリストします。

図56-8 list_charge_item_candidates

2. プロパティ・ファイルprop_file2を作成し、Orders Processedメトリック列のカスタム・チャージ・アイテムを生成します。
このメトリックに対してaggregation_typeをsumに設定し、チャージ・レートは処理されたオーダーの合計数を基準とします。

図56-9 集計タイプの設定

3. create_charge_item EMCLI動詞を使用して、チャージバックのカスタム・アイテムを作成します。

図56-10 create-charge_item

4. カスタム・チャージ・アイテムが作成されると、チャージ・プラン・ページに新しいカスタム・アイテムが表示されます。即時利用可能なチャージ・アイテムに対するレート設定と同様に、カスタム・アイテムに対するレートも設定できます。

図56-11 レートの設定: Custom Plan

aggregation_typeがsumに設定されているため、チャージ・レートは期間に依存せず、Orders Processedの合計値に依存します。

図56-12 確認

5. データベース・ターゲットをチャージバックに追加して、Custom Planを割り当てます。

図56-13 コスト・センターおよびチャージ・プランの割当て

6. 日次のETL実行後に、新しいカスタム・アイテムに対するチャージ/使用状況が計算されます。カスタム・アイテムのチャージ/使用状況は、チャージバックのレポート・ページで確認できます。

図56-14 詳細

56.3.3 構成拡張

Config Extensionsという名前の構成拡張が、データベース・インスタンス・ターゲットに対して作成されます。これは、次に示すように、高可用性表領域の数と、各高可用性表領域の名前を収集します。この例では、高可用性表領域の値は、新規カスタム・チャージ・アイテムの基準として使用されます。

図56-15 構成拡張

1. EMCLIにログインし、チャージバックEMCLI動詞list_charge_item_candidatesを使用して、チャージバックに登録できる構成アイテムをリストします。config_nameは、UIに表示される構成拡張の名前(この場合は、Config Extensions)であることに注意してください。同様にconfig_data_sourceは、UIに表示される構成列の名前であることに注意してください(この場合tmp/dbconfig.xml)。

図56-16 list_charge_item_candidates

2. プロパティ・ファイルprop_file1を作成し、Number of High Available Tablespacesメトリック列のカスタム・チャージ・アイテムを生成します。
config_key値は、前述のlist_charge_item_candidates動詞の出力内のCustom Config Key列の出力が元になることに注意してください。同様に、config_viewの値は、前述のCustom Config Nameの値となります。

図56-17 Number of High Available Tablespaces

3. create_charge_item EMCLI動詞を使用して、チャージバックのカスタム・アイテムを作成します。

図56-18 create_charge_item

4. カスタム・チャージ・アイテムが作成されると、チャージ・プラン・ページに新しいカスタム・アイテムが表示されます。通常の即時利用可能なチャージ・アイテムに対するレート設定と同様に、カスタム・アイテムに対するレートも設定できます。

図56-19 レートの設定: New Plan

図56-20 確認

5. データベース・ターゲットをチャージバックに追加して、「New Plan」を割り当てます。

図56-21 New Plan

6. 日次のETL実行後に、新しいカスタム・アイテムに対するチャージ/使用状況が計算されます。カスタム・アイテムのチャージ/使用状況は、チャージバックのレポート・ページで確認できます。

56.4 汎用エンティティ・タイプの作成

Enterprise Managerではほぼ無制限の数のターゲット・タイプがサポートされます。即時利用可能なチャージバック・サポートがあるのは比較的少数です。ただし、現在のチャージバック・サポートがないEnterprise Managerターゲット・タイプのカスタム・エンティティ・タイプを作成できます。Enterprise Managerターゲット・タイプに対して1対1対応のカスタム・エンティティ・タイプがあります。

EM CLI動詞emcli add_custom_cb_entity_typeを使用して、既存のターゲット・タイプに関してカスタム・エンティティ・タイプを識別します。

構文

add_custom_cb_entity_type -target_type=target_type

ここで、target_typeは、現在のチャージバック・サポートがない既知のEnterprise Managerターゲット・タイプです(Oracle Apacheなど)。

カスタム・エンティティ・タイプの作成後、第56.2項で説明されているプロセスに従って、新しいエンティティ・タイプに適切なチャージ・アイテムをカスタマイズします。

チャージ・アイテムのプロパティ

たとえば、次のようなプロパティが含まれるproperties_oracle_apacheという名前の入力プロパティ・ファイルに基づいてカスタム・チャージ・アイテムを作成できます。

target_type=oracle_apache
source_data_type=metric
item_name=active_sessions
metric_group=ohs_server
metric_column=sessions.active
item_displayname=Active Sessions
unit=sessions
aggregation_type=avg
item_category=instance
data_type=number

カスタム・チャージ・アイテムは、アクティブ・セッションの平均数に基づきます。

実装

次の手順を実行します。

1. アクティブ・セッションのカスタマイズされたチャージ・アイテムを含むOracle Apacheエンティティ・タイプのチャージ・プランを作成します。

2. 任意のエンティティ・タイプの場合と同様に、アプリケーションの追加ウィザードを使用してチャージバックにOracle Apacheエンティティ・タイプを追加します。Oracle Apacheエンティティ・タイプは、「ターゲット・セレクタ」ダイアログで使用できます。

3. 手順1で作成したチャージ・プランをOracle Apacheエンティティ・タイプに割り当てます。

4. オプション。Oracle Apacheエンティティ・タイプにコスト・センターを割り当てます。

5. レポート機能を使用して、Oracle Apacheエンティティ・タイプに関連するメータリングおよびチャージ・データを表示します。

56.5 Enterprise Managerからのメータリング・データの取得

チャージバックREST APIを使用すると、Enterprise ManagerとBilling and Revenue Managementシステム(Oracle BRMを含む)を統合できます。また、柔軟なチャージバック・メカニズムも可能になります。次に、いくつか例を示します。

- 小規模、中規模、大規模構成の様々なレート計画を持つ請求システムと統合する。

- 柔軟な期間に対してチャージバックを計算する。ある月の15日から翌月の15日までを計算する場合などです。

- Enterprise Managerでキャプチャされないその他の属性に基づいてチャージバックを合理化する。

- 使用状況に基づいてチャージバックを調整または切り上げる。たとえば、1日未満の使用であっても、全日に対するチャージが計算されます。

56.5.1 get_metering_data

指定されたパラメータに対する使用状況(およびオプションのチャージ)の情報を含む各行を持つカンマ区切り出力の形式でチャージバック・メータリング・データを取得します。

構文

emcli get_metering_data
[-start_date=<start date in mmddyyyy> [-end_date=<end_date in mmddyyyy>]]
[ -target_type=<target type> [-target_name= <target name> ] ]
[ -cost_center=<cost center name> ]
[ -charge]

パラメータ

この動詞のパラメータはすべてオプションです。

- start_date: 真夜中に開始するデータ取得をフィルタするため、mmddyyyという書式で開始日を指定します。デフォルトは、現在のレポート・サイクルの開始日です。

- end_date: 真夜中に終了するデータ取得をフィルタするため、mmddyyyという書式で終了日を指定します。デフォルトは、現在のレポート・サイクルの終了日です。

- target_type: 指定された日付範囲内で指定されたタイプのターゲットがチャージバックで構成されている場合、データ取得をフィルタするためにターゲット・タイプを指定します。デフォルトでは、指定された日付範囲内でチャージバックで構成されているすべてのターゲット・タイプのすべてのターゲットを対象とするデータを取得します。

- target_name: 指定されたターゲット・タイプの指定されたターゲットのみを対象にメータリングおよびチャージ・データを取得します。ターゲット名が無効であるか、指定された日付範囲で構成されていない場合、データ取得は発生しません。デフォルトでは、指定されたターゲット・タイプのすべてのターゲットを対象とするデータを取得します。

- cost_center: チャージバックの「コスト・センター」タブに表示されるコスト・センター名を指定します。指定された日付範囲の時点でコスト・センター名が有効な場合、適切なメータリングおよびチャージ・データを取得します。デフォルト値はログイン・ユーザーです。すべてのコスト・センターのメータリングおよびチャージ・データを取得するには、(引用符で囲って) "All Users"と指定します。チャージバックでは各ユーザーはコンシューマ(コスト・センター)でもあります。ログイン・ユーザーの権限によって、異なるターゲットで取得されるメータリングおよびチャージ・データが決定されます。

- charge_: メータリングおよびチャージ・データの両方を取得します。デフォルトでは、メータリング・データのみを取得します。

注意:
チャージバックでターゲット情報を表示するのに必要な権限は、次のとおりです。

- VIEW_CAT_TARGET: 特定のターゲット(アクティブまたは非アクティブ)の情報を表示できます。

- VIEW_ANY_CAT_TARGET: すべてのチャージバック・ターゲット(アクティブまたは非アクティブ)の情報を表示できます。

56.5.2 データ取得の出力

このget_metering_data動詞によって生成される出力は、次のとおりです。

- CONSUMER_NAME: コスト・センターの名前。

- TARGET_TYPE: ターゲットのタイプ。

- TARGET_NAME: ターゲットの名前。

- ITEM_TYPE: アイテムまたはメトリックのタイプ。指定できる値: config、fixed、metric、propertyおよびusage。

- CATEGORY_NAME: 指定できる値: cpu、memory、storage、activity、instance、network、serviceおよびsoftware。

- ENTITY_NAME: 共有エンティティの名前(チャージバックにおいて、ターゲットが共有モードで使用可能になっている場合に有効です)。

- ITEM_DISPLAY_NAME: アイテムまたはメトリックの表示名(英語)。注意: 翻訳サポートは現在利用できません。

- VALUE_AVERAGE: 特定の日付のメトリックの平均値(数値メトリックで有効)。

- STRING_VALUE: メトリック・データの値(文字列ベース・メトリックで有効)。

- DATA_TYPE: メトリックのデータ型。stringまたはnumberを指定できます。

- UNIT: メトリック・データの単位(reqやGBなど)。

- COLLECTION_DATE: データがEnterprise Managerのメトリックまたは構成表から収集される日付。

- PLAN_NAME: 特定のターゲットに関連付けられているチャージ・プラン名。

- CHARGE: 特定日付におけるターゲットの特定メトリックのチャージ値。

- DEFINED_RATE: ターゲットに関連付けられているチャージ・プランで定義されたチャージ・レート。

- RATE_TYPE: レートのタイプ。指定できる値: 値なし(空白)、Flat、configおよびusage。

- RATE_FACTOR: 関連する拡張チャージ・プランで定義されているユニバーサル・メトリックの調整レート。

- CHARGE_RATE_UNIT: メトリックまたはアイテムに対応する単位。チャージ・プランで特定レートについて定義されています。たとえば、CPU使用率(%)またはサービス当たりのCPU使用率(%)というアイテムまたはメトリックの場合、値は"CPU"になります。基本チャージというメトリックまたはアイテムの場合、値は"インスタンス"、'ユーザー・リクエスト'というメトリックの場合、値は"req"になります。チャージプランで定義されたレートが1日当たり$1/MBの場合、この列の値は"MB"になります。

- CHARGE_TIME_UNIT: 特定レートについてチャージ・プランで定義された時間単位(hourly(毎時)、daily(毎日)、weekly(毎週)、monthly(毎月)、yearly(毎年)など)。たとえば、チャージ・プランで定義されたレートが1日当たり$1/MBの場合、この列の値はdailyになります。

例: サンプル出力

"CONSUMER_NAME","TARGET_TYPE","TARGET_NAME","ITEM_TYPE","CATEGORY_NAME","ENTITY_NAME","ITEM_DISPLAY_NAME","STRING_VALUE","PLAN_NAME","COLLECTION_DATE","CHARGE","VALUE_AVERAGE","DEFINED_RATE","RATE_TYPE","RATE_FACTOR","CHARGE_RATE_UNIT","CHARGE_TIME_UNIT","NORMALIZE_RATE","ADJUST_RATE","DATA_TYPE","UNIT"

"linbo","oracle_vm_guest","mySite/myWls/AdminServer:agent_push","fixed","instance"," ","Base Charge","","zone_plan",15-OCT-11 00:00:00,72,1,"3","flat",1,"instance","hourly",1,1,"number",""
"linbo","oracle_vm_guest","mySite/myWls/AdminServer:agent_push","fixed","instance"," ","Base Charge","","zone_plan",16-OCT-11 00:00:00,72,1,"3","flat",1,"instance","hourly",1,1,"number",""
"linbo","oracle_vm_guest","mySite/myWls/AdminServer:agent_push","fixed","instance"," ","Base Charge","","zone_plan",17-OCT-11 00:00:00,72,1,"3","flat",1,"instance","hourly",1,1,"number",""
"linbo","oracle_vm_guest","mySite/myWls/AdminServer:agent_push","fixed","instance"," ","Base Charge","","zone_plan",18-OCT-11 00:00:00,72,1,"3","flat",1,"instance","hourly",1,1,"number",""
"linbo","oracle_vm_guest","mySite/myWls/Cluster-0_vm0:assembly1","fixed","instance"," ","Base Charge","","zone_plan",15-OCT-11 00:00:00,72,1,"3","flat",1,"instance","hourly",1,1,"number","

56.5.3 get_metering_dataの例

動詞の使用方法の例は、次のとおりです。

- emcli get_metering_data: ログイン・ユーザーの現在のレポート・サイクルの、すべてのターゲット(チャージバックでアクティブまたは有効な)のメータリング情報を返します。

- emcli get_metering_data -charge: ログイン・ユーザーの現在のレポート・サイクルの、すべてのターゲット(チャージバックでアクティブまたは有効な)のメータリングおよびチャージ情報を返します。

- emcli get_metering_data -start_date=01202011-cost_center=ORG1: ORG1コスト・センターの2011年1月20日から月末までの、すべてのターゲット(チャージバックでアクティブまたは有効な)のメータリング情報を返します。

- emcli get_metering_data -start_date=01152011 -end_date=02152011 -target_type=oracle_database: 2011年1月15日から2011年2月15日までの、ログイン・ユーザーが所有するすべてのOracle DBターゲット(チャージバックでアクティブまたは有効な)のメータリング情報を返します。

- emcli get_metering_data -target_type=host target_name=my_host -cost_center=organization1: organization1" cost-centerの現在のレポート・サイクルの、"my_host"ターゲット(タイプhost)のメータリングおよびチャージ情報を返します。

- emcli get_metering_data -cost_center="All Users": すべてのコスト・センターの現在のレポート・サイクルの、すべてのターゲット(チャージバックでアクティブまたは有効な)のメータリングおよびチャージ情報を返します。

- cba_admin_user (チャージバック管理者)としてログインして、次のコマンドを入力します。

- emcli get_metering_data: cba_admin_userの現在のレポート・サイクルの、すべてのターゲット(チャージバックでアクティブまたは有効な)のメータリング情報を返します。

- emcli get_metering_data -cost_center=ssa_user1: 現在のレポート・サイクルの、コスト・センターでssa_user1が所有するすべてのターゲット(チャージバックでアクティブまたは有効な)のメータリング情報を返します。

- コスト・センター、ターゲット・タイプ/ターゲット名に指定された値が間違っている場合、データは生成されません。たとえば、次のコマンドではデータは生成されません。

- emcli get_metering_data -target_type=unknown

- emcli get_metering_data -target_type=oracle_database -target_name=unknown_target
注意: Enterprise Managerでunknown_targetという名前のターゲットは構成されていません。

57 ブループリントの概要

この章では、Oracle Private Cloudのクラウド・ブループリント(この章ではブループリントと呼びます)の概要、使用方法および独自のブループリントの作成方法について説明します。内容は次のとおりです。

- ブループリントの概要

- ブループリントの使用

- Enterprise Manager Cloudの概念

- ブループリントの概念

- ブループリントのデプロイ

- ブループリントのデプロイメント処理

- ブループリントの例

- 結び

57.1 ブループリントの概要

ブループリントは、必要な相互に関連するクラウド・リソースのセットを記述するために使用します。建築で使用するブループリントと同様に、このブループリントでは、リソースの構築方法ではなく、リソースを相互に動作させるための構成方法など、必要な事項が記述されます。たとえば、ブループリントでは、コンポーネントを作成する順序は記述されません。これは、ブループリントの編成ロジックによって、リソース間の依存関係に基づいて決定されます。

例として、Weblogic Serverインスタンス、アプリケーション、データベースなどの相互作用するクラウド・リソースのセットを作成するとします。そのためには、まずデータベースおよびWeblogic Serverインスタンスを作成してアプリケーションをデプロイし、Weblogic Serverでデータベースへの接続に使用されるJEEデータソースを作成する必要があります。

これらの操作はすべて、Enterprise Managerのセルフ・サービス・ポータルから手動で実行できます。WebLogic Serverおよびデータベースの作成をリクエストして、両方の作成が完了するのを待機します。作成リクエストのステータスを定期的にチェックします。WebLogic Serverが作成された後、アプリケーションをデプロイできます。WebLogic Serverとデータベースの両方が作成された後、JEEデータソースを作成できます。

または、このプロセスを自動化するために、4つのクラウド・リソースを記述するブループリントを使用できます。これを行うには、ブループリントのインスタンス化をリクエストし、ブループリントで必要な入力パラメータ値を指定します。ブループリントは、リソースの作成を開始し、必要なリソースが作成されるとすぐに依存リソースが自動的に作成されるように作成プロセスを監視します。

この章の残りの部分では、既存のブループリントのデプロイ方法や独自のブループリントの記述方法など、ブループリントの概念について説明します。ブループリントの詳細は、第58章「クラウド・ブループリントおよびブループリントのリファレンス」でも参照できます。

57.2 ブループリントの使用

ブループリントは、サービス・インスタンスの作成を自動化するのに使用できます。EM_SSA_USERは、次のような様々な理由でブループリントを使用できます。

- 複数のサービス・インスタンスおよび関連クラウド・リソースから構成される1つのアプリケーションを作成するため。

- このようなインスタンスのセットを複数回作成するため。

- 他のEM_SSA_USERSのためにインスタンスの作成を容易にするため。

- インスタンスのセットを作成するのに必要な、手動でやり取りする手順を省くため

- 他のユーザーが確認したり変更できるテキスト表現を作成するため。

要するに、ブループリントを使用すると、サービス・インスタンスのセットの作成を自動化できます。

たとえば、企業の品質保証チームは、Webアプリケーションのテストに必要なリソースを割り当てたり、解放する必要があります。Enterprise Manager Cloud Self Serviceアプリケーションを使用してサービス・インスタンスを手動で作成するかわりに、このタスクの実行にブループリントを使用できます。1人のユーザーがブループリントを作成し、これにより、すべてのQAエンジニアはブループリントを呼び出して数個の入力パラメータ値を入力するだけで済み、この作業の後、リソースが作成されます。各ユーザーは、ブループリント・プロセッサにより表示される各リソースの作成ステータスを確認できます。

簡素化および一貫性の課題への、ブループリントを使用した対処について、別の例で説明します。あるITショップには、8つの入力パラメータを受け入れる1つのサービス・テンプレートがあります。特定のユーザー・グループについて、それらの8つのパラメータのうち6つに同じ値のセットを使用する必要があります。単純なブループリントでは、2つのパラメータを受け入れ、テンプレートを使用して他の6つパラメータを矛盾なく定義してインスタンスを作成します。

57.3 Enterprise Manager Cloudの概念

この項で説明する概念は、Enterprise Manager Cloudの概念です。これらはブループリントの一部として導入されるのではなく、ブループリントによって使用される概念です。これらの概念はブループリントの基本となっているため、ここで要約します。

- OracleクラウドAPI: OracleクラウドAPI (第45章「クラウドAPIの概要」を参照)は、IaaS、MWaaSおよびDBaaSのコンシューマに対して、Oracleのソリューション・スタックに基づいたRESTfulプログラミング・インタフェースを定義します。ブループリント・プロセッサでは、ブループリントによって指定された内容に基づいて、クラウド・リソースを作成する場合に、OracleクラウドAPIを使用します。

- Oracleクラウド・リソース・モデル: Oracleクラウド・リソース・モデル(第46章「クラウドのリソース・モデル」を参照)には、OracleクラウドAPIを経由して操作できるリソースのタイプについて詳細に記述されており、かつ、各タイプについて、その属性と、リソース・タイプのインスタンスに対して実行できる操作の両方について、詳細に記述されています。

- クラウド・リソースのタイプと属性: クラウド・リソース・モデルは、uri (それぞれのURI)やresource_status (READYやCREATINGなどの値を持つ)など、すべてのクラウド・リソースに共通な属性セットを指定します。このモデルは、一連のクラウド・リソース・タイプとその属性も定義します。次のリソース・タイプについては、このマニュアルで後述します。

- DbPlatformInstance: テンプレートを使用してデータベース・プラットフォーム・インスタンスが作成されます。これには、zone (DBaaSインスタンスの場所)やparams (ユーザー名とパスワードを指定)などの属性があります。

- JavaPlatformInstance: テンプレートを使用して、JEEサーバー・インスタンスも作成されます。DbPlatformInstanceと同様に、JavaPlatformInstanceにはzoneなどの属性があります。MWaaS固有の属性の例として、application_instance_deploymentsをあげることができ、これは、インスタンスにデプロイされるすべてアプリケーションを特定します。

- ApplicationInstanceDeployment: JavaPlatformInstanceへのアプリケーション・デプロイメントを表すリソース・タイプです。

- Datasource: JavaPlatformInstanceのデータソースを表すリソース・タイプです。これはJavaPlatformInstance内に含まれ、DatabaseInstanceを参照します。

- リソースの包含: クラウド・リソースは他のリソースを含めることができます。たとえば、JavaPlatformInstanceのDatasourceは、JavaPlatformInstanceに含まれ、テンプレートにはそのテンプレートを使用して作成されたすべてのサービス・インスタンスが含まれます。
作成するすべてのリソースは、親クラウド・リソースに含まれます。ブループリント内の各リソース定義の一環として、リソースのコンテナを特定します。

57.4 ブループリントの概念

一般的に、1つのブループリントで、作成する1つ以上のクラウド・リソースを記述します。ユーザーは、ブループリントによって記述されたリソースを作成するために、ブループリントをデプロイし、そのときに、ブループリントによって使用されるすべての入力パラメータ値を指定します。各リソースを作成するために、ブループリントによって属性値が指定されますが、これらの属性値は、ハードコーディングされるか、ブループリントの入力パラメータから提供されるか、または他のリソースから収集されます。すべてのリソースをインスタンス化するときに、ブループリント・システムによって、リソースの依存関係が判別され、ブループリントで記述されているインスタンスを正しく作成するために必要な、リソースの作成または構成(またはその両方)の順序が、これを使用して決定されます。

- 入力パラメータ: ブループリントでは、入力パラメータを定義できます。各パラメータ定義では、名前、データ型およびデフォルト値などのオプション仕様を指定します。ブループリントをデプロイするユーザーは、デフォルト値を持たないすべてのパラメータの値を指定する必要があります。

- リソース: ブループリントのリソースにより、クラウド・リソースの構成方法が定義されます。リソースによって、一連の属性および新規に作成されたリソースが含まれる親クラウド・リソースが指定されます。ブループリント内の各リソースには、ブループリント内で一意の名前を付ける必要があります。

- 出力: 出力が指定されると、ブループリントのデプロイメントの完了時に、指定された値が表示されます。出力パラメータを使用して、JEEアプリケーション・デプロイメントのURLをエンド・ユーザーに通知するなどの目的で、デプロイメント時に派生した情報を表示できます。

- 固有関数: ブループリント言語には、事前定義済の一連の関数(後で説明)が含まれます。

- 名前付きリテラル: プログラミングの便宜上、ブループリントにはDataセクションを含めることができます。これは、一般的にリテラル値のシンボリック名を指定するために使用されます。

- 依存関係: ブループリントのデプロイメントは、可能な場合は複数のリソースを同時に作成して行われますが、他のリソースに依存するリソースは、依存先のリソースが作成されるまで作成できません。このような依存関係は暗黙的な場合が多いですが、ブループリントの処理により依存関係が特定され、全体的な手順が編成されます。

57.5 ブループリントのデプロイ

前提条件:

- ブループリント・ファイルがあること。

- ブループリント・プロセッサ・ソフトウェアがインストールされていること。

ブループリント・ファイルは、作成者がブループリント言語を使用して必要なものを記述しているテキスト・ファイルです。ブループリント・プロセッサを実行してブループリントをデプロイします。たとえば、Windowsでは次のようなコマンドを使用します。

bp_processor.py myfile.yml -u myname –c https://myhost/em/cloud

この例では、–uオプションでEnterprise ManagerユーザーIDを指定します。ここでパスワードを指定しないと、ブループリント・ファイルの実行時に要求されます。–cオプションは、クラウドURLの指定に使用します。コマンドライン・オプションは、この他にも多数あります。サポートされるオプションの説明を表示するには、次のように入力します

bp_processor.py deploy -h

57.6 ブループリントのデプロイメント処理

ブループリントをデプロイする場合、実行時ロジックで入力パラメータを処理し、リソースの作成を編成します。可能な場合は、これを並列して実行します。また、進捗を監視して、ユーザーに逐次通知します。表示される出力は、ブループリントおよび環境によって異なります。次の例では、Weblogic Server、アプリケーション、データベースおよびJEEデータソースをデプロイするブループリントを使用しています。このブループリントの実行による出力から、ブループリント処理の手順がわかります。

C:\Users\myname\Dropbox\Code\blueprints>bp_processor.py xyzApp.yml -c
https://... -g deployment_report
...
Cloud user id: ssa_user1
Password:

上で入力したコマンドでは、クラウドURL (-cオプションを使用)およびオプションのデプロイメント・レポートの格納先ディレクトリ(-gオプションを使用)を指定しています。その後、処理の続行を求められたのに従い、資格証明を入力しました。

Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:                https://...
User:                     ssa_user1
Blueprint file:           xyzApp.yml
Timeout:                  90 minutes, 0 seconds
Refresh frequency:        15 seconds
Inputs:
Pause points:             (none)
Debug logging:            False
Instance name:            default_instance_name
Graphical report dir:     deployment_report
Versions:
Blueprint processor:   12.1.0.5, 10-Oct-2012
Cloud protocol:        10001

14:24:59  INFO: Connecting to cloud: https://....

注意: 対応しているオプションを指定していないため、起動サマリーのほとんどの情報には使用されているデフォルト値が反映されています。

使用しているブループリントで入力パラメータを定義しているため、値の指定を要求されます。

Input Parameter Value Entry
---------------------------
Zone to use for db (Zone1):
Password to use for db (welcome1):

この例では、[Enter]を押してゾーンZone1のデフォルト値を受け入れた後、パスワードを入力しました。

必要な情報をすべて指定すると、ブループリント・プロセッサによってリソースの作成および進捗の監視が開始されます。これは、"縦タイムライン"で表されるため、進捗を確認できます。作成される各リソースは、1つの列で表されます。各リソースの状態遷移が発生するにつれて、縦タイムラインの対応する列に表されます。

最初に、すべての可能な状態のリストが短縮形とともに出力されます。状態には、処理フェーズおよび各フェーズの結果が反映されます。

14:25:03  INFO:
14:25:03  INFO: Resource State Timeline
14:25:03  INFO: -----------------------
14:25:03  INFO:   State Key:
14:25:03  INFO:      e : Evaluating
14:25:03  INFO:      ep: Evaluation pending. (See right side for pendee)
14:25:03  INFO:      es: Evaluation succeeded, creation requested
14:25:03  INFO:      EF: Evaluation failed
14:25:03  INFO:      c : Creating
14:25:03  INFO:      CF: Creation failed
14:25:03  INFO:      CS: Creation succeeded. State = READY
14:25:03  INFO:

リソース定義を処理する最初のステップは、リソースを記述する定義の式を評価することです(状態キー: e)。場合によっては、表を遅延させる必要があります(状態キー: ep)。すべての評価が完了すると、作成リクエストが作成され(状態キー: c)、そのリソースの処理は正常に完了します(状態キー: CS)。状態キーが出力された後に、リソース作成タイムラインが表示されます。

14:25:03  INFO:              MyApp
14:25:03  INFO:             /
14:25:03  INFO:            /    MyDB
14:25:03  INFO:           /    /
14:25:03  INFO:          /    /    MyDS
14:25:03  INFO:         /    /    /
14:25:03  INFO:        /    /    /    MyWebServer
14:25:03  INFO:       /    /    /    /
14:25:03  INFO:   ---------------------
14:25:03  INFO:   |    |    |    | e  |
14:25:04  INFO:   |    |    |    | es |
14:25:10  INFO:   |    |    |    | c  |
14:25:10  INFO:   |    | e  |    | .  |
14:25:12  INFO:   |    | es |    | .  |
14:25:17  INFO:   |    | c  |    | .  |
14:25:17  INFO:   |    | .  | e  | .  |
14:25:17  INFO:   |    | .  | ep | .  | Awaiting creation of MyWebServer
14:25:17  INFO:   | e  | .  |    | .  |
14:25:17  INFO:   | ep | .  |    | .  | Awaiting creation of MyWebServer
14:25:33  INFO:   |    | .  |    | .  |
14:25:50  INFO:   |    | .  |    | .  |
.....
14:41:18  INFO:   |    | .  |    | .  |
14:41:33  INFO:   |    | .  |    | CS |
14:41:33  INFO:   |    | .  |    |====|
14:41:44  INFO:   |    | .  | ep |    | Awaiting creation of MyDB
14:41:57  INFO:   | es | .  |    |    |
14:42:00  INFO:   | c  | .  |    |    |
14:42:17  INFO:   | .  | .  |    |    |
....
14:44:44  INFO:   | .  | .  |    |    |
14:45:16  INFO:   | CS | .  |    |    |
14:45:16  INFO:   |====| .  |    |    |
14:45:32  INFO:   |    | .  |    |    |
14:45:47  INFO:   |    | .  |    |    |
14:54:17  INFO:   |    | .  |    |    |
14:54:17  INFO:   |    | CS |    |    |
14:54:17  INFO:   |    |====|    |    |
14:54:18  INFO:   |    |    | es |    |
14:54:19  INFO:   |    |    | c  |    |
14:54:33  INFO:   |    |    | CS |    |
14:54:33  INFO:   |    |    |====|    |
14:54:33  INFO:   ---------------------
14:54:33  INFO:
14:54:33  INFO:

タイムラインが縦に表示され、4つリソースはMyApp、MyDB、MyDS、およびMyWebServerであることがわかります。

MyWebServerリソース定義が最初に評価されます(状態キー: e)。この評価に成功すると、作成プロセスが開始されます(状態キー: c)。並行して、MyDBリソースが評価され、作成プロセスが起動されます。次に、MyDSリソースが評価され、ブループリント・プロセッサによってMyWebServerリソースが作成されるまで評価を完了できないと判断されます。同じプロセスがMyAppリソースにも当てはまります。MyDBおよびMyWebServerリソースが正常に作成されると(状態キー: CS)、MyAppおよびMyDSリソースの作成プロセスを続行できます。

次に、このブループリント例の出力セクションが処理されます。

14:54:33  INFO: Output Processing
14:54:33  INFO: -----------------
14:54:33  INFO:
14:54:33  INFO: Output values specified: 1
14:54:49  INFO:    Value of URL: {u'ms_1': u'http://...}
14:54:49  INFO:

前述の例では、ブループリントで"URL"という1つの出力値を指定し、値はhttps://…で表されています。

すべてのリソースが正常に作成されると、ブループリント・プロセッサによって結果が要約されます。これには、リクエストされた各リソースの処理サマリーの他、各リソースおよび実行全体の時間情報が含まれます。

14:54:49  INFO: Blueprint Processing Summary
14:54:49  INFO: ----------------------------
14:54:49  INFO:
14:54:49  INFO: Resource State Summary:
14:54:49  INFO:    MyWebServer: READY
14:54:49  INFO:      URI: /em/cloud/jaas/javaplatforminstancerequest/163
14:54:49  INFO:      Cloud resource state: READY
14:54:49  INFO:      Timing info:
14:54:49  INFO:        Creation start:     14:25:04
14:54:49  INFO:        Creation end:       14:41:33
14:54:49  INFO:        Duration:           16 minutes, 29.6 seconds
14:54:49  INFO:    MyDB: READY
14:54:49  INFO:      URI: /em/cloud/dbaas/dbplatforminstance/byrequest/164
14:54:49  INFO:      Cloud resource state: READY
14:54:49  INFO:      Timing info:
14:54:49  INFO:        Creation start:     14:25:12
14:54:49  INFO:        Creation end:       14:54:17
14:54:49  INFO:        Duration:           29 minutes, 5.7 seconds
14:54:49  INFO:    MyDS: READY
14:54:49  INFO:      URI: /em/cloud/jaas/datasourcerequest/QA_app_DS@201
14:54:49  INFO:      Cloud resource state: READY
14:54:49  INFO:      Timing info:
14:54:49  INFO:        Creation start:     14:54:18
14:54:49  INFO:        Creation end:       14:54:33
14:54:49  INFO:        Duration:           0 minutes, 15.3 seconds
14:54:49  INFO:    MyApp: READY
14:54:49  INFO:      URI:
/em/cloud/jaas/applicationinstancedeploymentrequest/myApp@181
14:54:49  INFO:       Cloud resource state: READY
14:54:49  INFO:       Timing info:
14:54:49  INFO:         Creation start:     14:41:57
14:54:49  INFO:         Creation end:       14:45:16
14:54:49  INFO:         Duration:           3 minutes, 18.9 seconds
14:54:49  INFO:
14:54:49  INFO: Timing Summary (seconds):
14:54:49  INFO:    Client-side CPU time: 0 minutes, 6.474 seconds
14:54:49  INFO:    Elapsed time:
14:54:49  INFO:       Processing time:    29 minutes, 58.0 seconds
14:54:49  INFO:       Paused time:        0 minutes, 1.9 seconds
14:54:49  INFO:       Total elapsed time: 29 minutes, 59.9 seconds
14:54:49  INFO:
14:54:49  INFO: Graphical Report Generation
14:54:49  INFO: -------------------------------
14:54:49  INFO:
14:55:37  INFO: Graphical report generated: deployment_report/bp_report.html

C:\Users\myname\Dropbox\Code\blueprints>

57.7 ブループリントの例

この項では、より複雑なブループリントの例を順を追って示すことによって、ブループリント概念の使用および構文について説明します。ブループリントを作成する計画がない場合は、この項をスキップできます。

57.7.1 ブループリントの構造と基本

クラウド・ブループリントでは、一連の必要なクラウド・リソースを指定し、テキスト・ファイルによってこれらのリソースを表現します。ブループリントでは、判読が簡単なデータ構造テキストの標準であるYAMLを使用しています。

YAMLは、XMLやJSONと同様に、標準的な表記法です。JSONと同様に、YAMLは、リスト、ディクショナリおよびネストによる情報の表現に使用されます。これらの概念は、すべてのブループリント・セマンティックを取り込むのに十分です。

57.7.1.1 単純なブループリント

ブループリントは、複数のセクションを含んだドキュメントと考えることができます。最も単純で実用的なブループリントでは、Resourcesセクションと1つのリソースのみを指定します。この例では、リソースはテンプレートにより定義されるデータベースです。

Resources
MyDB:
Type: application/oracle.com.cloud.common.DbPlatformInstance+json
Container: ...  (refers to db template)
Properties: ... (provides properties of db)

前述のブループリントでは、MyDBという名前のブループリント・リソースを定義しています。Typeエントリでは、クラウド・リソース・モデルAPIで定義されている、データベースのメディア・タイプを指定しています。Containerエントリでは、新規に作成されたオブジェクトが含まれる親クラウド・リソースを定義しています。(第46章「クラウドのリソース・モデル」でも説明していますが、すべてのクラウド・リソースはこれらのリソースを既存のコンテナに追加することで作成されます)。これはデータベース・サービス・インスタンスであるため、サービスを作成するために使用されるデータベース・テンプレートを介して作成されます。コンテナの指定方法については後述するため、ここでは省略形を使用しています。同様に、このテンプレートで必要とされるデータは、後述するPropertiesエントリで指定されます。次に、Inputsセクションを追加します。

Inputs:
DbZone:
Type: String
DefaultValue: Zone1
Prompt: Zone to use for db
DbPassword:
Type: String
DefaultValue: welcome1
Prompt: Password to use for db
Sensitive: True
Resources:
MyDB:
Container: ...
Properties: ...

ユーザーがこのブループリントのデプロイメントをリクエストするときは、DbZoneパラメータの値を指定するか、ブループリントで指定されているデフォルト(Zone1)を使用します。ユーザーが指定した入力パラメータ値は、ブループリントの他の部分でも使用でき、特に、リソースの作成に必要な属性値を提供するために使用できます。詳細については後述します。

57.7.1.2 単純なリソース: データベース・サービス・インスタンス

ブループリントでは、作成するクラウド・リソースを記述するために、ブループリント・リソースを使用します。各ブループリント・リソースについて、クラウド・リソース・モデルで必要とされる情報が提供されます。

次のブループリントでは、データベース・サービス・インスタンスを作成するための単一のリソースを指定しています。

MyDB:
Type: application/oracle.com.cloud.common.DbPlatformInstance+json
Container: ...
Properties:
zone: ...
name: jbName
params:
username: app_user
password: change_me

ブループリント内の各リソース定義では、名前、リソースの追加先コンテナおよび作成対象の特性を指定するために使用するプロパティが指定されています。この場合は、次のようになります。

- ブループリント・リソース定義の名前はMyDBです。この名前は、ブループリント全体で使用され、たとえば、ブループリントをデプロイしているユーザーに各リソースの進捗を通知する場合に使用されます。より複雑な場合においては、この名前はブループリント内の他の場所で参照できます。

- Containerエントリでは、新規リソースの追加先となるコンテナのURIが指定されています。データベース・サービス・インスタンスを作成するには、必要なデータベースの種類に対応するサービス・テンプレートを特定します。(この方法は、固有関数のトピックについて説明するときに示します。)

- Propertiesエントリでは、リソースの作成に必要な値が指定されています。この場合、モデルにはzone、nameおよびparamsプロパティの指定が必要です。これらは、インスタンスを作成するゾーン、名前および選択されたテンプレートで必要な名前/値のペアを指定します。

57.7.1.3 固有関数

データに基づいて動作するために、ブループリントでは、固有関数の使用がサポートされています。f_で始まる名前のすべての関数は、引数のリストを使用して呼び出されます。前述の例を引き続き使用すると、2つの固有関数を使用して、必要なコンテナおよび必要なゾーンのURIを返します。

Resources:
MyDB:
Type: application/oracle.com.cloud.common.DbPlatformInstance+json
Container:
f_getTemplateURI:
- Small Database Service Template_automation_VIMAL_si
- dbaas
Properties:
zone:
f_getZoneURI: ...
name: jbName
params:
username: app_user
password: ...

示されているとおり、f_getTemplateURI関数では、テンプレートの名前とサービス・タイプの2つの引数を使用します。現在サポートされているサービス・タイプは、dbaas、jaasおよびiaas (Database-、Java-、およびInfrastructure-as-a-Service)です。f_getZoneURIはf_getTemplateURIと類似していますが、対象はゾーンです。その他の固有関数については後で説明します。関数の完全セットは、第58章「クラウド・ブループリントおよびブループリントのリファレンス」で説明しています。

57.7.1.4 パラメータを使用する単純なリソース

前述のブループリントの例に対して、ここで2つのパラメータを追加して使用します。このようにすることによって、ブループリントをデプロイするユーザーは、使用するゾーンとパスワードを指定できます。

Inputs:
DbZone:
Type: String
DefaultValue: Zone1
Prompt: Zone to use for db
DbPassword:
Type: String
DefaultValue: welcome1
Prompt: Password to use for db
Sensitive: True
Resources:
MyDB:
Type: application/oracle.com.cloud.common.DbPlatformInstance+json
Container:
f_getTemplateURI:
- Simple DB Template
- dbaas
Properties:
zone:
f_getZoneURI:
- f_path:
- "Inputs.DbZone.Value"
- dbaas
params:
username: app_user
password:
f_path:
- 'Inputs.Password.Value'

Inputsセクションでは、2つの入力パラメータを定義し、パラメータの値は、f_path固有関数を経由してアクセスされます。f_path関数は、パス式の評価に使用され、ブループリント内の任意のデータや、アクセス権がある任意のクラウド・リソース・データにアクセスします。この例では、パス式はネストされた属性にアクセスするために単にドット演算子を使用しており、初めにブループリントのInputs属性(Inputsセクション)にアクセスし、その中からUserId属性にアクセスし、その中からValue属性にアクセスしています。

57.7.1.5 Dataセクション(名前付きリテラル)

ブループリントによって複数のデータベースが作成され、ユーザーにユーザー名とパスワードの入力を要求しないようにするとします。さらに、後でパスワードを変更しやすいようにブループリントをコーディングします。手続き型言語では、意図を文書化するために名前付きリテラルを使用し、コードの先頭でこれを変更できるようにします。ブループリント内では、Dataセクションを使用してこれを実現しています。

Data:
QADBCreds:
user: sysman
password: sysman
Resources:
MyDB1:
Type: application/oracle.com.cloud.common.DbPlatformInstance+json
Container:
f_getTemplateURI:
- Small Database Service Template_automation_VIMAL_si
- dbaas
Properties:
zone:
f_getZoneURI:
- f_path:
- "Inputs.DbZone.Value"
- dbaas
params:
username:
f_path:
- ”Data.QADBCreds.user”
password:
f_path:
- ”Data.QADBCreds.password”
name: jbName

MyDB2:
Container:
...

前述の例では、Dataセクションが、前に示したInputsと同じ方法で、path関数を経由してトラバースできるYAML構造になっていることがわかります。

57.7.2 すべてを集約: 複数の独立リソース

次のより複雑な例では、これを使用したデータベースおよびアプリケーションの作成方法を示します。これを行うには、ブループリントで次の4つのクラウド・リソースを指定します。

- データベース・サービス・インスタンス

- Javaサービス・インスタンス

- Javaサービス・インスタンスのデータソース

- Javaサービス・インスタンスのアプリケーション

新しい構成メンバーは下記で強調表示されています。

Inputs:
DbZone:
Type: String
DefaultValue: Zone1
Prompt: Zone to use for db
DbPassword:
Type: String
DefaultValue: welcome1
Prompt: Password to use for db
Sensitive: True
Macros:
# Return a name with unique (date-time) suffix
# The one argument is a 'name' string
f_myDescriptiveName:
- 1
- f_concat:
- arg_1
- '_'
- f_path:
- f_path:
- 'Info.time_suffix'
Resources:
MyDB:
Type: application/oracle.com.cloud.common.DbPlatformInstance+json
Container:
f_getTemplateURI:
- Small Database Service Template_automation_VIMAL_si
- dbaas
Properties:
zone:
f_getZoneURI:
- f_path:
- "Inputs.DbZone.Value"
- dbaas
params:
username: app_user
password:
f_path:
- "Inputs.DbPassword.Value"
name: jbName
MyWebServer:
Container:
f_getTemplateURI:
- PS4_LowHeapTemplate
- jaas
Properties:
name:
f_myDescriptiveName:
- jb_pf
zone:
f_getZoneURI:
- Zone1
- jaas
MyDS:
Type: application/oracle.com.cloud.jaas.DataSource
Container:
f_getResourceURI:
- MyWebServer
Properties:
name: QA_app_DS
jndi_name:
- jndi_1
- jndi_2
jdbc_driver: oracle.jdbc.OracleDriver
database_type: Oracle
database_connect_string:
f_concat:
- 'jdbc:oracle:thin:@'
- f_getResourceAttr:
- MyDB
- connect_string
username: app_user
password:
f_path:
- "Inputs.DbPassword.Value"
MyApp:
Type: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment
Container:
f_getResourceURI:
- MyWebServer
Properties:
application_instance_component:
f_getAppCompURI:
- jbcomponent
- SSA_USER1
-
name: myApp
Outputs:
URL:
Description: URL of the deployed app
Value:
f_getResourceAttr:
- MyApp
- http_application_invocation_url

57.7.2.1 マクロ・セクション

繰り返し実行する構成メンバーの順序がある場合、マクロ展開を使用してブループリントの可読性を改善できます。マクロを使用すると、ロジックをカプセル化することも可能であり、たとえば、1つの場所でロジックを変更して、それを参照するすべてのコードに影響を及ぼすことができます。このブループリントの例では、f_myDescriptiveNameというマクロを定義しています。このマクロでは1つの文字列パラメータを使用し、_ (アンダースコア)と現在時刻の文字列表現を付加します。

57.7.2.2 作成されたリソースの属性(依存関係)

この例では、主要な新機能として、作成されたリソースの属性を参照できることを示しています。たとえば、データソースのクラウド・リソース・モデルでは、その値がデータソースの作成に必要なdatabase_connect_string属性が定義されます。この文字列の内容はデータベースが作成されるまで取得できないため、ブループリントの作成者はこの内容を事前に知ることができないことは明らかです。かわりに、ブループリントの作成者は、固有関数を使用して新しく作成されたデータベースの必要なプロパティを参照します。(各DatabasePlatformInstanceは、connect_stringプロパティを公開します。)これを行うために、データソースでは、f_getResourceAttr固有関数を経由して、JDBCConnectStringの値を指定します。

MyDS:
...
Properties:
...
database_connect_string:
f_concat:
- 'jdbc:oracle:thin:@'
- f_getResourceAttr:
- MyDB
- connect_string

この場合、f_getResourceAttr関数は、MyDBリソースが作成されるのを待機し、MyDBリソースのconnect_stringプロパティの値を返します。同様に、データソースの作成を完了するためには、最初に作成されたJavaPlatformInstanceにこのデータソースを追加する必要があるため、JavaPlatformInstanceのURIを参照する必要があります。

MyDS:
...
Container:
f_getResourceURI:
- MyWebServer

この場合、f_getResourceURI関数は、MyWebServerリソースが作成されるのを待って、そのURIを返します。(データソースをMyWebServerに追加するのに加え、ApplicationInstanceDeploymentも追加する必要があるため、両方に同じ手法が使用されます。)

注意: f_path関数を使用しても同じ効果を実現できますが、f_getResourceAttrでは、リソースの作成が成功し、そのステータスがREADYになるのを待って、その属性の取得を試みます。

一般的には、ブループリントのリソースは別のリソースを参照でき、ブループリントの編成はこのような依存関係を構成し、可能な場合はリソースが並行して作成されます。

57.7.3 ブループリント処理の視覚的表現

ブループリント・プロセッサは、ブループリントのグラフィック表示が含まれるHTMLレポートも生成できます。これは、ブループリントの全体構造とブループリント・エンティティの関係を理解するのに役立ちます。また、レポートには、ブループリントのデプロイ結果を含めることができます。

次のサンプル・レポートは、第57.6項「ブループリントのデプロイメント処理」で説明したブループリントの例に対するものです。レポートの最初の部分に、実行のサマリーが表示されます。

図57-1 ブループリント・レポートのタイトル

次のグラフィック表示では、2つのタイプの矢印が使用されています。1つは、包含を表します。たとえば、WebLogic Server内へのデータソースの包含などです。もう1つは、ブループリントの要素間でデータがどのように使用されるかを表します。ブループリント・デプロイメントが成功すると、すべてのリソースのステータスはREADY(緑)になり、リソースをクリックできます。これは、別のレポート・セクションにリンクしており、作成時の属性の値を確認できます。

図57-2 ブループリントのグラフィック表示

この後に、グラフィック表記規則を説明する凡例が表示されます。

図57-3 ブループリントの凡例

最後に、作成された各リソースのサマリーが表示されます。(グラフィック表示のリソース定義をクリックすると、選択したリソースのリソース・サマリーが直接表示されます。)

図57-4 ブループリントによって作成されたクラウド・リソース - I

図57-5 ブループリントによって作成されたクラウド・リソース - II

57.8 結び

これで、クラウド・ブループリントの紹介は終わりです。次の機能を含む多くの機能は、第58章「クラウド・ブループリントおよびブループリントのリファレンス」でのみ説明しています。

- ブループリント・マクロ。クラウドおよびブループリントの参照用パス式。ブレークポイントの設定およびブループリントのデバッグ。ヒント、アドバイスおよびよくある質問。

58 クラウド・ブループリントおよびブループリントのリファレンス

この章は、Oracle Enterprise Manager Cloudのブループリント処理機能のリファレンスとして機能します。概念を示し、ブループリント・プロセッサのインストールや実行方法、およびブループリント言語のドキュメント作成方法について説明します。また、ブループリント・デバッガの使用方法、エラーが診断された場合の対処方法、よくある質問など、ブループリント・プロセッサの使用に役立つ項が含まれています。このドキュメントを読む前に、第57章「ブループリントの概要」を読む必要があります。

注意:
ここをクリックすると、クラウド・ブループリントを使用してクラウド・リソースの作成を自動化する方法について、視覚的デモンストレーションを参照できます。

内容は次のとおりです。

- ブループリント・プロセッサのインストール

- グラフィカル・サマリー・レポートのオプション・コンポーネント

- ブループリント・プロセッサの実行

- ブループリントの処理フェーズ

- 言語仕様

- ブループリントの内容の概要

- エラーの処理

- シミュレーション・モード

- ブループリント・プロセッサを使用したデバッグ

- アドバイスとヒント

58.1 ブループリント・プロセッサのインストール

ブループリント・プロセッサのインストールは、次の2つの手順で構成されています。

- Python 2.7をインストールします(存在しない場合)。

- ブループリント・プロセッサのファイルをインストールします。

-gオプションを使用してブループリントのグラフィカル表示を生成するには、第58.2項「グラフィカル・サマリー・レポートのオプション・コンポーネント」で説明されている追加のソフトウェアのインストールが必要です。

LinuxおよびWindows上のブループリント・プロセッサの詳細なインストール方法を以降に示します。

注意:
スケジュールの制約により、このバージョンのブループリント・プロセッサはローカライズされておらず、英語でのみ提供されています。

58.1.1 Linux (Oracle Linux)

Oracle Linuxにブループリント・プロセッサをインストールする場合、次の手順が必要です。

- Pythonのインストール

- Zipファイルからのブループリント・プロセッサのインストール

- インストールのテスト

58.1.1.1 Pythonのインストール

- バージョン2.7以降(3.xは除く)のPythonをダウンロードします。たとえば、http://www.python.org/ftp/python/2.7.3/Python-2.7.3.tgzを使用します。

- 次のコマンドを入力するなどして、これを解凍します。
tar xzf Python-2.7.3.tgz

cd Python-2.7.3

- 次のコマンドを実行します。
./configure --prefix=$HOME

make

make install

注意: 構成手順の実行中に、使用しているプラットフォームで作成できなかった一部のモジュールに関する警告を含む出力が表示される場合がありますが、これらのモジュールは通常は不要であり、不足していてもブループリント・プロセッサの使用に悪影響を与えることはありません。

Python build finished, but the necessary bits to build these modules were not found:

bsddb185           dl                 imageop
sunaudiodev

必要な部分を特定するには、setup.pyのdetect_modules()を調べてモジュール名を特定します。

Failed to build these modules:
sqlite3

- Pythonインタプリタがhome binディレクトリにインストールされます。これをテストします。$HOME/bin/python2.7

- 次のようなPythonバナーが表示されます。

Python 2.7.3 (default, May 25 2012, 11:33:27)
[GCC 4.1.2 20080704 (Red Hat 4.1.2-50)] on linux2
Type "help", "copyright", "credits" or "license" for more information.

58.1.1.2 Zipファイルからのブループリント・プロセッサのインストール

- ブループリント配布ファイルを任意のディレクトリ(例: bp_installation)に解凍します。

- ブループリント・プロセッサを実行するには、次を実行する必要があります。
bp_installationなどのディレクトリに移動します。

次のコマンドを実行します: python bp_processor.py <filename> <options>

58.1.1.3 インストールのテスト

- ブループリント・プロセッサ・ファイルが含まれているディレクトリに移動します。

- 次のコマンドを入力して、ブループリント・プロセッサを実行できることを確認します(この場合、ヘルプ・テキストのみが表示されます)。
$HOME/bin/python2.7 bp_processor.py helloWorld.yml -h

- 次のようなヘルプ・テキストが表示されます。
使用方法:

bp_processor.py [options] BlueprintFileName

例:

bp_processor.py myfile.yml -i "name:Joe" -i "count:2" -u jabauer -c https://...

オプション:

-h, --help         show this help message and exit
-c CLOUD_URI, --cloud_uri=CLOUD_URI.
Ex: https://myhost:4473/em/cloud
-u USER, --user=USER  user id
-p PASSWORD, --password=PASSWORD
password If not provided, you'll be prompted.
-t TIMEOUT, --timeout=TIMEOUT
timeout (seconds)
-i INPUT_VALUE, --input_value=INPUT_VALUE
<param name>:<param value> e.g. -i "name:Joe Blogs"
-r REFRESH_FREQUENCY, --refresh_frequency=REFRESH_FREQUENCY
# of seconds between dots in timeline. Zero: no dots
-n INSTANCE_NAME, --instance_name=INSTANCE_NAME
name of blueprint instance to create
-d, --debug              more logging, including http traffic
-E, --pause_error        Drop into debugger if error occurs
-I, --pause_input        Pause before processing Input section
-R, --pause_resource     Pause before processing Resource section
-O, --pause_output       Pause before processing Output section
-T, --pause_terminate
Pause before termination, but after output processing
or error
-g GRAPHIC_RESULTS, --graphic_results=GRAPHIC_RESULTS
Directory for deployed blueprint graphical report
-G GRAPHIC_BLUEPRINT, --graphic_blueprint=GRAPHIC_BLUEPRINT
Directory for undeployed blueprint graphical report

- 次のコマンドを入力して、クラウド環境へ接続することなくブループリントの実行をシミュレーションします。
$HOME/bin/python2.7 bp_processor.py helloWorld.yml

次のように表示されます。

[jabauer@zzzzzzzz blueprints]$ $HOME/bin/python2.7 bp_processor.py helloWorld.yml

Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:          sim
User:               None
Blueprint file:     helloWorld.yml
Timeout:            90 minutes, 0 seconds
Ellipses frequency: 15 seconds
Inputs:
Pause points:       (none)
Debug logging:      False
Instance name:      default_instance_name

17:10:31 WARNING: No Resources specified in blueprint.  Nothing will be
created

17:10:31 INFO: Output Processing
17:10:31 INFO: -----------------
17:10:31 INFO:
17:10:31 INFO: Output values specified: 1
17:10:31 INFO:    Value of MyMsg: Hello World
17:10:31 INFO:
17:10:31 INFO: Blueprint Processing Summary
17:10:31 INFO: ----------------------------
17:10:31 INFO:
17:10:31 INFO: Timing Summary (seconds):
17:10:31 INFO:    Client-side CPU time: 0.218
17:10:31 INFO:    Elapsed time:
17:10:31 INFO:       Processing time:    0.0
17:10:31 INFO:       Paused time:        0.0
17:10:31 INFO:       Total elapsed time: 0.0

58.1.2 ウィンドウ

Windowsにブループリント・プロセッサをインストールする場合、次の手順が必要です。

- Pythonのインストール

- Zipファイルからのブループリント・プロセッサのインストール

- インストールのテスト

58.1.2.1 Pythonのインストール

- http://www.python.org/download/releases/2.7.3にアクセスします。Pythonをインストールするためのいくつかのオプションが表示されます。

- MSIインストーラをダウンロードします。これを実行します。インストーラが提示するデフォルトをそのまま使用します。

- Pythonがインストールされたディレクトリをメモします。通常は次のディレクトリにインストールされます。
;c:\python27

- Pythonディレクトリをパスに追加して、コマンドラインから実行できるようにします。

- Windows XP

- 「スタート」→「マイ コンピューター」→「プロパティ」

- 「詳細設定」タブを選択します。

- 「環境変数」をクリックします。

- 現在のユーザーのパスを更新できますが、十分な権限がある場合はシステムのパスも更新できます。後者は、すべてのユーザーがPythonを実行できるようにするために必要です。

- 次を、パス文字列の終わりに追加します。
;c:\python27

- Windows 7 (Windows Vista)

- 「スタート」メニューから「マイ コンピューター」を選択し、次に「プロパティ」を選択します。

- 左側の「システムの詳細設定」タブを選択します。

- 「環境変数」をクリックします。

- 現在のユーザーのパスを更新できますが、十分な権限がある場合はシステムのパスも更新できます。後者は、すべてのユーザーがPythonを実行できるようにするために必要です。

- 次を、パス文字列の終わりに追加します。
;c:\python27

- 必要に応じて「OK」をクリックします(たとえば、2つのダイアログ・ボックス)。

- Pythonのインストールをテストします。

- 新しいコマンド・ウィンドウを開きます。(新しい環境変数値は、以前に開いたコマンド・ウィンドウには表示されません。)

- pythonと入力します。

- Pythonインタプリタが起動します。

- exit()と入力します。

58.1.2.2 Zipファイルからのブループリント・プロセッサのインストール

- ブループリント配布ファイルを任意のディレクトリ(例: bp_installation)に解凍します。

- ブループリント・プロセッサを実行するには、次を実行します。

- bp_installationディレクトリに移動します。

- 次のコマンドを実行します: python bp_processor.py <filename> <options>

- または、bp_processor.py <filename> <options>を使用します。

58.1.2.3 インストールのテスト

- ブループリント・プロセッサ・ファイルが含まれているディレクトリに移動します。

- 次のコマンドを入力して、ブループリント・プロセッサを実行できることを確認します(この場合、ヘルプ・テキストのみが表示されます)。
python bp_processor.py helloWorld.yml -h

- 次のコマンドを入力して、クラウド環境へ接続することなくブループリントの実行をシミュレーションします。
python bp_processor.py helloWorld.yml

- 出力値がHello Worldとなり、次のように表示されます。
C:\...>python bp_processor.py interactiveTests\helloWorld.yml

Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:          sim
User:               None
Blueprint file:     helloWorld.yml
Timeout:            90 minutes, 0 seconds
Ellipses frequency: 15 seconds
Inputs:
Pause points:       (none)
Debug logging:      False
Instance name:      default_instance_name

17:10:31 WARNING: No Resources specified in blueprint.  Nothing will be created

17:10:31 INFO: Output Processing
17:10:31 INFO: -----------------
17:10:31 INFO:
17:10:31 INFO: Output values specified: 1
17:10:31 INFO:    Value of MyMsg: Hello World
17:10:31 INFO:
17:10:31 INFO: Blueprint Processing Summary
17:10:31 INFO: ----------------------------
17:10:31 INFO:
17:10:31 INFO: Timing Summary (seconds):
17:10:31 INFO:    Client-side CPU time: 0.218
17:10:31 INFO:    Elapsed time:
17:10:31 INFO:       Processing time:    0.0
17:10:31 INFO:       Paused time:        0.0
17:10:31 INFO:       Total elapsed time: 0.0

58.2 グラフィカル・サマリー・レポートのオプション・コンポーネント

ブループリント・プロセッサは、ブループリントのグラフィック表示が含まれるサマリー・レポートを生成できます。(このようなレポートを生成するには、–gまたは–Gオプションを使用します。)これらのオプションでレポートが生成されるためには、次のサード・パーティ・ソフトウェアがインストールされている必要があります。

- GraphVizのインストール: GraphVizをインストールするには、http://www.graphviz.orgを参照してください。使用しているプラットフォーム向けのソフトウェアをダウンロードして、指示に従います。

- pydotのインストール: pydotをインストールするには、http://code.google.com/p/pydot/を参照してください。ソフトウェアをダウンロードします(zipまたはtarファイル)。ブループリント・プロセッサは、pydotバージョン1.0.28を使用してテストされました。
pydotは、セットアップツールを使用してインストールできます。たとえば、sudo easy_install pydotです。

zip/tarファイル内のsetup.pyスクリプトも使用できます。このファイルの解凍先ディレクトリから、スクリプトpython setup.py installを実行します。

58.3 ブループリント・プロセッサの実行

ブループリントをデプロイするには、ブループリント・プロセッサを実行して、ブループリント・ファイルの名前と必要なコマンド・オプションを指定します。コマンドオプションの完全セットを表示するには、コマンドの–hオプションを使用します。

使用方法:

bp_processor.py [options] BlueprintFileName

例:

bp_processor.py myfile.yml -i "name:Joe" -i "count:2" -u jabauer -c https://...

オプション:

-h, --help        show this help message and exit
-c CLOUD_URI, --cloud_uri=CLOUD_URI.
Ex: https://myhost:4473/em/cloud
-u USER, --user=USER  user id
-p PASSWORD, --password=PASSWORD
password If not provided, you'll be prompted.
-t TIMEOUT, --timeout=TIMEOUT
timeout (seconds)
-i INPUT_VALUE, --input_value=INPUT_VALUE
<param name>:<param value> e.g. -i "name:Joe Blogs"
-r REFRESH_FREQUENCY, --refresh_frequency=REFRESH_FREQUENCY
# of seconds between dots in timeline. Zero: no dots
-n INSTANCE_NAME, --instance_name=INSTANCE_NAME
name of blueprint instance to create
-d, --debug              more logging, including http traffic
-E, --pause_error        Drop into debugger if error occurs
-I, --pause_input        Pause before processing Input section
-R, --pause_resource     Pause before processing Resource section
-O, --pause_output       Pause before processing Output section
-T, --pause_terminate
Pause before termination, but after output processing
or error
-g GRAPHIC_RESULTS, --graphic_results=GRAPHIC_RESULTS
Directory for deployed blueprint graphical report
-G GRAPHIC_BLUEPRINT, --graphic_blueprint=GRAPHIC_BLUEPRINT
Directory for undeployed blueprint graphical report

自明ではないオプションについて、次に説明します。

- Input_value: 各入力パラメータについて、–iまたは–input_valueの文字列を<param name>:<value>の形式で指定します。各入力パラメータを引用符で囲って指定する必要があります(例: -i "name:Joe Blogs")。複数の入力パラメータを指定するには、- iコマンドライン・オプションを複数回使用します。たとえば、次のように指定します。bp_processor.py _processor.py myfile.yml -i "DbZone:Zone1" -i "DbPassword:myPw"7

- ブループリントで定義された入力パラメータがコマンドラインで指定されていない場合、次のように入力を求められます。
pause_*: 入力/リソース/出力処理フェーズが開始される前に一時停止します(ブループリント・デバッガに入ります)。

pause_errorの場合、エラーが発生したときにデバッガに入ります。pause_terminateの場合、ブループリント・プロセッサが終了する前にデバッガに入ります。デバッガ・コマンドの使用方法は、第58.9項「ブループリント・プロセッサを使用したデバッグ」で説明されています。CLOUD_URIが指定されていない場合、ブループリントの処理がシミュレーションされます。詳細は、第58.8項「シミュレーション・モード」を参照してください。

- Timeout: ブループリントの処理を強制終了するまでの経過秒数。(プロセッサがPOSTリクエストなどのクラウド・リクエストの完了を待機している場合、そのリクエストの完了時に終了します。)

58.4 ブループリントの処理フェーズ

ブループリントの処理は、複数のフェーズで行われます。各フェーズの説明は、次の実行に役立ちます。

- ブループリントの評価方法およびリソースの作成方法を理解します。

- フェーズの移行時に一時停止ポイントを設定します。(これは、第58.9.2項「一時停止ポイント」で説明されているとおり、クラウドの参照およびデバッグに役立ちます)。

- 指定されたクラウド・リソースに接続します。

- 処理を監視します。作成に成功した場合、別のリソースで作成のブロックが解除されます。作成に失敗した場合、リソース作成フェーズが終了します。

各フェーズは次のとおりです。

- 初期化: ブループリントを解析します。

- 入力処理: ブループリントで入力パラメータが定義され、その一部がコマンドラインで指定されていない場合、ユーザーはパラメータ値の入力を求められます。

- リソース作成: ブループリントで定義されている各リソースについて、他の未作成リソースとの依存関係がないかどうかを検証し、作成を開始します。

- 出力処理: すべての出力値を評価および表示します。(エラーによりリソース作成フェーズが終了した場合、一部の出力値は表示されない場合があります。)

各フェーズの詳細な説明を以降に示します。

58.4.1 初期化

ブループリント・ファイルの読取りと解析が行われ、指定されたクラウド・リソースへの接続が行われます。解析されたブループリントの内容は、メモリーに取り込まれて拡張されます。Cloudという名前のメンバーが追加されます。この値は、第46章「クラウドのリソース・モデル」に記載されているクラウド・リソースです。環境情報を提供するInfoという名前の別のメンバーも追加されます。その値は、処理の開始時間を表すtimeと文字列「13:02:45」のペアなどの、名前/値ペアのセットです。オラクル社から提供されるマクロがブループリントのMacrosセクションにロードされます(名前がブループリントで定義されたマクロと競合する場合を除く)。

58.4.2 入力パラメータの評価

次に、入力パラメータの処理が行われ、入力パラメータが設定されます。ブループリントで指定されているが、コマンドラインでまだ入力されていないパラメータがあれば、入力を求められます。各入力パラメータの値は、ブループリント内の入力パラメータの、Value属性に格納されます。値には次のパス式を使用してアクセスできます。Inputs.<parameterName>.Value(詳細は、第58.6.7.1項「評価固有関数」を参照してください。)

58.4.3 リソースの作成

Resourcesセクションを処理するために、各リソースは並行して効果的に処理されます。各リソースについて、次が行われます。初めに、Containerセクション用に指定された式が評価されます。正常に完了した後、識別されたクラウド・リソースがREADY状態である場合、リソースのPropertiesサブセクションのすべての式が評価されます。(リソースのPropertiesまたはContainerセクションの評価を完了できず、待機する必要がある場合は、リソースがマークされて、ブループリント・プロセッサは別のリソースの処理に進みます。定期的にこのリソースおよびその他のマークされたリソースの評価が再試行されます。)リソース定義のすべての評価が完了したら、Propertiesセクションから派生したドキュメントを使用してクラウド・リソースの作成がリクエストされます(つまり、コンテナURIにPOSTされます)。成功した場合、新規に作成されたクラウド・リソースのURIが、ブループリントのリソース定義の_uri属性に格納されます。この時点で、そのURIは作成されたリソースを表します。次に、ブループリント・プロセッサは作成中のリソースをポーリングして、そのステータスを追跡します。リソースは、CREATING状態から最終的に成功または失敗の状態に移行します。失敗状態に移行した場合、ブループリント・プロセッサは状況を診断して終了します。作成が成功して、リソースがREADY状態に入った場合、他のリソース定義の評価を続行できるようになります。コマンドラインで指定されているタイムアウト値を超過した場合、ブループリント・プロセッサは終了します。作成が開始されたすべてのクラウド・リソースは、成功または失敗する前の一定期間、作成中の状態が維持される場合があります。タイムアウトの他に、式の評価時のエラーや、作成リクエストのレスポンスなどでクラウドから返されるエラー・コードなど、他の失敗が発生する場合があります。このようなすべての場合に、ブループリント・プロセッサは状況を診断して終了します。

58.4.4 Outputs

すべてのリソースが正常に評価された後、出力セクションが処理され、このときにそれぞれの名前付き出力式が評価され、その値が出力されます。ブループリントおよび何が作成されたかを示すグラフィック・レポートが生成され(リクエストされた場合)、ブループリント処理のサマリーがユーザーに表示されます。

58.5 言語仕様

ブループリントは、作成される一連のクラウド・リソースを表したテキスト・ファイルです。このテキストは、YAML形式またはJSON形式です。YAMLとJSONは、いずれもリストおよび名前/値ペアのデータ構造を表す表記法で、ネストが可能です。ブループリントはこのような構造になっています。(簡潔な説明は、[YAML]および[JSON]を参照してください。)ブループリントにはJSONまたはYAML表記法を使用できますが、YAMLの使用をお薦めします。YAMLを使用すると、より簡潔で可読性に優れたブループリントを記述できます。YAMLでは、コメントを含めるなど、JSONにはない便利な機能が提供されます。このような理由から、以降の例ではYAMLの使用を選択しています。(付加的な情報ですが、YAMLにはJSON表記法を含めることができます。つまり、YAMLはJSONの上位セットです。)

58.6 ブループリントの内容の概要

ブループリントには、トップ・レベルで、次のいずれかの名前/値ペアが含まれている場合があり、これらは、ブループリント・セクション・タイプとして表示できます。

- Inputs

- Data

- Macros

- リソース

- 出力

ブループリント内の表示順序は重要ではありません。その他のセクションは使用できず、各セクションは1回のみ出現可能です。ブループリントには厳密に必須のセクションはありませんが、ブループリントを使用してクラウド・リソースを作成する目的では、少なくともリソース定義を含むResourcesセクションを含める必要があります。1つのセクションは、ブループリント内で1回のみ出現可能です。

58.6.1 Inputsセクション

Inputsセクションは、入力パラメータの記述に使用されます。各パラメータは一意の名前と次の属性を持ちます。

- Type: StringまたはNumber。Numberが指定された場合、入力値は数値である必要があります。(デフォルト: String。)

- Prompt: ユーザーに入力を求める際に使用する文字列。(デフォルト: パラメータの名前。)

- DefaultValue: ユーザーが入力要求に対して[Enter]を押して応答した場合に使用される値。(デフォルト: ""。)

- Order: 値を入力する順序。指定されていない場合、順序は不定です。

- Sensitive: TrueまたはFalse。Trueの場合、ユーザーがインタラクティブに入力した内容は画面に表示されません。(デフォルト: False。)

- Value: ユーザーが入力した値(またはデフォルト値)を使用して、実行時に設定されます。

入力パラメータの処理は、コマンドラインで指定されたこれらの入力値を使用して開始されます。指定されていない値については、ユーザーは入力を要求されます。

58.6.1.1 例1

Inputs:
UserId:
DefaultValue: qa_user
Prompt: User id
Order: 1
Password:
Sensitive: True
Order: 2
...

このブループリント・スニペットでは、作成者は2つの入力パラメータを定義しています。どちらもタイプはStringです。デフォルトのユーザーIDが指定されていますが、ユーザーはパスワードを入力する必要があります。両方ともコマンドラインで指定されていない場合、Orderを使用することでUserIdが初めにリクエストされます。

58.6.1.2 例2

次の相互作用の場合

C:\work>bp_processor.py test2.yml -c https://... -u jon -p myPW -t 665

Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:                https://xyxy.example.com:15430/em/cloud
User:                     ssa_user1
Blueprint file:           xyzApp.yml
Timeout:                  90 minutes, 0 seconds
Refresh frequency:        15 seconds
Inputs:
Pause points:             Inputs
Debug logging:            False
Instance name:            default_instance_name
Graphical report dir:     deployment_report
Versions:
Blueprint processor:   12.1.0.5, 10-Oct-2012
Cloud protocol:        10001

16:19:18 INFO: Connecting to cloud: https://...
User id (qa_user):
Password:
...

ユーザーはコマンドラインの一部として入力パラメータを指定していないため、2つの値の入力が要求されます。ユーザーは、ユーザーIDに対して[Enter]を押して、デフォルトのqa_userをそのまま使用しています。また、ユーザーはパスワードを入力しましたが、その内容は画面に表示されていません。

58.6.1.3 例3

次の相互作用はほとんど同じですが、ユーザーIDがコマンドラインで指定されている点が異なります。

C:\work>bp_processor.py test2.yml -c https://... -u jon -p myPW -t 665 -i "UserId:joe"

Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:                https://xyxy.example.com:15430/em/cloud
User:                     ssa_user1
Blueprint file:           xyzApp.yml
Timeout:                  90 minutes, 0 seconds
Refresh frequency:        15 seconds
Inputs:
Pause points:             Inputs
Debug logging:            False
Instance name:            default_instance_name
Graphical report dir:     deployment_report
Versions:
Blueprint processor:   12.1.0.5, 10-Oct-2012
Cloud protocol:        10001

16:19:18 INFO: Connecting to cloud: https://...
16:19:19 WARNING: No Resources specified in blueprint.  Nothing will be created
16:19:19 INFO: Creating blueprint instance named default_instance_name
Password:
...

この場合、ユーザーはパスワードの入力のみを求められます。別の例が第58.6.7.1.4項「例3: クラウド検索を使用したデフォルトの入力パラメータ」であげられており、ここでは固有関数を使用してデフォルト値の実行時検索を行っています。

58.6.2 Resourcesセクション

Resourcesセクションは、作成するクラウド・リソースの記述に使用されます。各リソースの記述は、一意の名前と次の属性を持ちます。

- Container: 親クラウド・リソースのURI。

- Type: クラウド・リソース・モデルで定義されているリソースのメディア・タイプ(第46章「クラウドのリソース・モデル」を参照)。(指定されたContainerがServiceTemplateのサブタイプであるリソースの場合、この値はオプションであり、ServiceTemplateのデフォルト・タイプであるとみなされます。)

- Properties: クラウドのリソース・モデルごとに求められる値の指定に使用される一連の名前/値ペア。

作成するリソースごとに、指定する必要があるタイプ、親およびプロパティを把握して、その特性を指定する必要があります。詳細は、第46章「クラウドのリソース・モデル」を参照してください。

たとえば、JavaPlatformInstanceでは、次を指定する必要があります。

- JavaPlatformTemplateのURIで表すコンテナ・リソース。(ニーズに最も適合するインスタンスを作成するテンプレートを選択します。)

- クラウドのリソース・モデルで必要なプロパティ。JavaPlatformInstanceで必要なプロパティは次のとおりです。

- Name

- Zone (ゾーンのURI)

例

ブループリントでは、JavaPlatformInstanceのリソース記述は次のようになります。

MyJavaServer1:
Container:
f_getTemplateURI:
- Small WLS
- jaas
Properties:
name: Foo
zone:
f_getZoneURI:
- Zone1
- jaas

前述の例ではTypeが指定されていませんが、これは、コンテナがServiceTemplateのサブタイプである場合、オプションであるためです。メディア・タイプを明示的に指定した場合は、次の記述となります。

MyJavaServer1:
Type: application/oracle.com.cloud.jaas.JavaPlatformInstance
Container:
...

この例では、固有関数f_getTemplateURIおよびf_getZoneURIを使用して、必要なURIを検索しています。リソース定義では、第58.6.7項「固有関数」で説明されている様々な関数にアクセスできます。リソース定義では、第58.6.5項「Macrosセクション」で説明されているユーザー定義マクロも使用できます。

58.6.3 Outputsセクション

Outputsセクションは、ブループリントの一連の出力の記述に使用されます。このリリースでは、出力は、正常なデプロイメントの最後に表示される情報を指定するためにブループリント作成者が使用します。たとえば、ブループリント作成者はJavaPlatformInstanceにデプロイされたアプリケーションのURLを表示する出力を定義する場合があります。各出力の記述には一意の名前とValueという必須の属性が1つあります。この属性は、通常はブループリントをインスタンス化するユーザーが注目する値を導出するブループリント式を指定します。(各出力定義に対して、Description属性を含めることもできます。)

例

次のOutputsセクションでは、表示する1つの出力を指定しています。

Outputs:
Application_URL:
Description: URL of the deployed app
Value:
f_getResourceAttr:
- MyApp
- http_application_invocation_url

この例では、出力定義にf_getResourceAttr固有関数を使用して、新規作成されたApplicationInstanceDeploymentのhttp_application_invocation_url属性を取得します。(この属性の詳細は、第46章「クラウドのリソース・モデル」を参照してください。)

58.6.4 Dataセクション

Dataセクションには任意のYAMLテキストが含まれます。このセクションで定義されたデータは、固有関数よるアクセスが可能で、ブループリントのデプロイメントに際して様々な方法で使用されます。たとえば、ブループリント作成者は、名前付きリテラルの概念を使用してブループリントの可読性および管理性を向上させることができます。ブループリント作成者は、解読できないURIなどの長いリテラル値のかわりに、説明的で簡潔な名前を使用できます。また、ブループリントで使用される値の変更の必要性を予測することもでき、この場合、値はDataセクションで1回指定して、ブループリント全体で参照されるようにすることができます。

例

次のブループリントの抜粋は、データソース・リソース定義で後で参照される長いJDBC接続文字列である、db_conn_strという名前のアイテムを含むDataセクションを示しています。

Data:
db_conn_str: 'jdbc:oracle:thin:sysman/sysman@hostname.zzz.com:15044:smay16'
Resources:
...
MyDatasource:
Type: application/oracle.com.cloud.jaas.DataSource
...
Properties:
name: jbTest
jdbc_driver: oracle.jdbc.OracleDriver
database_type: Oracle
database_connect_string:
f_path:
- Data.db_conn_str
...

58.6.5 Macrosセクション

ブループリントで使用される表記は冗長になる場合があります。繰り返し実行する構成メンバーの順序がある場合、マクロ展開を使用してブループリントの可読性を改善できます。Macrosを使用すると、ロジックのカプセル化も可能になり、セクション内の1箇所の変更をドキュメント全体に反映できます。Macrosセクションは、ブループリント内の別の場所から呼び出されて展開されるマクロの定義に使用します。マクロの呼出しは、関数の呼出しが可能な場所であればどこでも可能で、実際に表記は同一であり、呼び出されるのが固有関数であるかマクロであるかは判別できません。(このように、マクロを使用して固有関数を上書きできます。また、一部のオラクル社提供の固有関数はマクロとして実装されています。)

各マクロ定義は一意の名前を持ち、この定義により次の2つの値が指定されます。

- 使用される引数の数。

- マクロ展開のテキスト表現。

マクロが呼び出されると、そのテキスト表現がかわりに実行されます。テキスト表現でarg_<integer>の値が指定されている場合、その引数の値がかわりに使用されます。

例

次のブループリント(若干現実的ではありませんが)について考えます。

Macros:
# Return a string that describes a resource being created
# The one argument is a 'name' string
f_myDescriptiveName:
- 1
- f_concat:
- "Resource "
- arg_1
- " created for blueprint instance "
- f_path:
- "Info.instance_name"
- " on "
- f_path:
- "Info.date"
Resources:
MyJavaServer:
Container:
f_getTemplateURI:
- Small WLS
- jaas
Properties:
name:
f_myDescriptiveName:
- MyFirstJavaServer
zone:
f_getZoneURI:
- Zone1
- jaas
Outputs:
NameOfServer:
Value:
f_path:
- "Resources.MyJavaServer.Properties.name"

Macrosセクションでは、f_myDescriptiveNameという1つのマクロが定義されおり、このマクロは1つの文字列引数を持ち、説明的な情報を付加することでより長い文字列を構成します。このマクロは、MyJavaServerリソース定義の一部として呼び出されます。これはMyFirstJavaServerという値を使用して呼び出され、nameプロパティ値がResource MyFirstJavaServer created for blueprint instance myQAInstance on 5/9/2012であるリソースが作成されます。

Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:                https://...
User:                     sysman
...
13:32:22 INFO:
13:32:22 INFO: Output values specified: 1
13:32:22 INFO:    Value of NameOfServer: Resource MyFirstJavaServer created for
blueprint instance myQAInstance on 5/9/2012
...

58.6.6 式

ブループリントは、式を使用してデプロイ時に値を計算します。多くの場合、式は単純なリテラル文字列値で、user_name属性(値はapp_user)などが相当します。その他の場合、値はユーザー定義マクロ(第58.6.5項「Macrosセクション」を参照)および固有関数(第58.6.7項「固有関数」を参照)により導かれます。

2つの固有関数f_pathおよびf_evalが、次の2つのタイプの式文字列を評価するために提供されています。

- パス式

- eval (またはブループリント)式

これらの式タイプについて、以降で説明します。これらは、f_pathおよびf_evalのコールに使用できるだけではなく、ブループリント・デバッガでも使用できます。

58.6.6.1 パス式

パス式は、JSONPath [JSONpath]およびXPath式と類似しており、ブループリントやクラウドからの値の抽出や、他のリソースにリンクするURIのトラバースに使用されます。パス式評価の開始点は、通常はインメモリーのブループリントです。これには、ブループリントのすべての情報に加え次の属性が含まれていることを再確認してください。

- Cloud: 第46章「クラウドのリソース・モデル」で定義されているクラウド・リソースであり、クラウド全体を表す属性およびその他のすべての(アクセス権を持つ)クラウド・リソースへのトラバースを可能にする属性を持ちます。

- Info: 実行時に参照する情報が含まれるセクションで、ブループリントの処理が開始されたときに指定されたインスタンス名、現在の日付などの情報、およびその他のブループリント・プロセッサにより計算された値(エンド・ユーザーが指定した入力パラメータや、リソースが作成されたときのそのリソースのURIなど)が含まれます。

これらのすべての情報には、パス式を使用してアクセスできます。この項の以降では、構文およびセマンティックの概要を示し、例をあげて説明します。前述の項でも説明しましたが、f_path固有関数はパス式を評価する1つの手段を提供します。後続の例では、別のメカニズムであるブループリント・デバッガを使用しています(詳細は第58.9項「ブループリント・プロセッサを使用したデバッグ」を参照)。後で説明しますが、これを使用してブループリントの実行時データの内容を調査できるだけでなく、クラウドの内容も調査できます。以降の説明では、<doc>は演算子が機能するYAMLデータ構造を指します。

次の例について説明します。Cloud.zones.elements[0]

実行時のブループリントのCloud属性値が最初の<doc>です。.zonesのドット演算子がその<doc>に適用され、新しい<doc>が生成され、その値は最初の<doc>のzones属性の値となります。多くの例をあげて、演算子の使用方法を示します。

58.6.6.2 演算子の概要

- ドット演算子(メンバーを指定): <doc>.<name>:前述の例で説明されているように、ドット演算子はドキュメントから値を選択します。<doc>に<name>という属性が存在する場合、<name>の値が返されます。それ以外の場合、式の評価は失敗します。

- 角カッコ(リストの索引付け): <doc>[<integer>]: <doc>が値のリストである場合、<integer>番目の要素の値が返されます。それ以外の場合、式の評価は失敗します。索引付けはゼロが基点です(最初の要素は<doc>[0]と指定されます)。

- ドル記号(リテラル文字列接頭辞): <doc> $ <string>: 文字列リテラルを使用してパス式を開始するには、$接頭辞を使用します。次に例を示します。
$"/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ->

前述の例では、特定リソースのURIが既知であり、矢印演算子を使用してその内容を表示します。

この構文は、パス式の開始部分でのみ有用ですが、全体のパス表記と一貫性を保つために、$演算子はパス式の任意の場所に配置できます。その他のパス式演算子は、左側の<doc>で動作します。$演算子は、単に左側の値を右側のリテラル文字列で置き換えます。

つまり、$演算子はリテラル文字列値を返します。右側のオペランドがリテラル文字列ではない場合、式の評価は失敗します。

- 矢印(URIトラバース): <doc> ->: <doc>がURIである場合、識別されたリソースにトラバースして、そのドキュメントを返します。つまり、<doc>で指定されたURI上でGETを実行します。<doc>がURIではない場合や、GETが失敗した場合、式の評価は失敗します。
たとえば、次のパス式があるとします。

Cloud.zones.elements[0].uri->

矢印演算子の左側の式は、ゾーンのURIを返します。矢印演算子は、ゾーンへのトラバースに使用され、URI上でGETを実行して内容を表示します。

context_id: A1B44A4EBCC4563125D9D0A3AAE4FD51
description: Zone for Physical Pool
media_type: application/oracle.com.cloud.jaas.Zone+json
name: Zone1
resource_state:
state: READY
service_family_type: jaas
service_instances:
elements: []
media_type: application/oracle.com.cloud.common.ServiceInstance+json
total: '0'
uri: /em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51

ほとんどの場合、トラバース演算子だけで十分ですが、トラバース修飾子の指定も可能です。具体的には、メディア・タイプやリクエスト・パラメータを指定できます。これらはオプションであり、角カッコで囲みます。複数の修飾子をカンマで区切って指定できます。メディア・タイプを指定するには、文字列を使用します(一重引用符または二重引用符で囲む)。

- リクエスト・パラメータを指定するための次の2つのスタイルがあります。

- Identifier

- Identifier = quotedValue

全体では、トラバース修飾子には次の3つの種類があります。

- quotedValue:
メディア・タイプ

- Identifier:
値を持たないリクエスト・パラメータ

- Identifier = quotedValue
値を持つリクエスト・パラメータ

たとえば、次のパス式はURIをトラバースし、3つの修飾子(メディア・タイプおよび2つのリクエスト・パラメータ)を指定しています。

Cloud.uri->
["application/oracle.com.cloud.common.ServiceTemplateFinds+json", filters='{"filters": {"service_family_type":"jaas"}', name]

最初のパラメータは、第46章「クラウドのリソース・モデル」で説明されているクラウドによるフィルタ/問合せ処理のリクエストに使用するメディア・タイプです。残りの2つは、第46章「クラウドのリソース・モデル」で説明されているリクエスト・パラメータです。2番目はfiltersという名前で、実行するフィルタ処理を指定する値を持ちます(JSON文字列として表現)。最後はnameという名前で、値は持ちません。これは、name属性を返すことを指定しています。

58.6.6.3 例: Infoのすべての値の表示

前述のように、Infoセクションには、ブループリントの構成に役立つ環境情報が含まれています。この例は、現在Infoセクションで利用可能な値を表示する方法を示しています。一意の名前を構成するために使用可能な値を見つけるとします。ブループリント・プロセッサを実行して、デバッグ・モードに入ります。(このことは、コマンドライン上で-Iを指定することによって実行できます。)

C:\Users\jabauer\Dropbox\Code\blueprints>bp_processor.py helloWorld.yml

-c https://xyxy.example.com:15430/em/cloud -u sysman -p sysman -I ...

Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:                https://xyxy.example.com:15430/em/cloud
User:                     sysman
Blueprint file:           helloWorld.yml
...

...Pause point, prior to Input processing...
For command info, enter (h)elp

Paused: Info
date: 1/11/2013
date_suffix: '1_11_2013'
instance_name: default_instance_name
time: '16:47:7'
time_suffix: '16_47_7'
uuid: 81dcaf6895fa4fb881e82d1c16ef7025

ここで、Infoセクションに6個の値が格納されていることがわかります。uuidという名前の値は、一意の16進文字列です。time_suffixは十分に一意であり、より可読性が高いため、これを使用すると役立つ場合があります。このドキュメントの記述時点からブループリント・プロセッサの出荷までの間に、より多くの値が追加される可能性があるため、この手法を使用して、使用しているバージョンで利用可能な値を確認できます。

58.6.6.4 例: ブループリント値の表示

次で始まるブループリントがあるとします。

Inputs:
DbPassword:
Type: String
DefaultValue: welcome1
Prompt: Password to use for db
Sensitive: True

ブループリント・プロセッサを実行し、-RIなどのコマンドライン・オプションを指定して、InputsおよびResourcesセクションの処理の前に一時停止するとします。

...Pause point, prior to Input processing...
For command info, enter (h)elp

Paused: Inputs.DbPassword
DefaultValue: welcome1
Prompt: Password to use for db
Sensitive: true
Type: String

前述の最初の一時停止ポイントで、式Inputs.DbPasswordを入力して、ブループリントで指定した属性があることを確認します。これには、DefaultValue、PromptおよびSensitiveが含まれています。入力処理がまだ実行されていないため、Valueという名前の属性は含まれていなことに注意してください。

Paused: c
...continuing...

Input Parameter Value Entry
---------------------------
Password to use for db (welcome1):

...Pause point, prior to processing Resources section...
For command info, enter (h)elp

Paused: Inputs.DbPassword.Value
welcome1

Paused: Inputs.DbPassword
DefaultValue: welcome1
Prompt: Password to use for db
Sensitive: true
Type: String
Value: welcome1

次に、cを入力して続行し、パスワードの入力が求められます。パスワードを入力しますが、Sensitiveを指定しているため、その内容は画面に表示されません。次に2番目(Resourcesセクションを処理する前)の一時停止ポイントに到達します。Inputs.DbPassword.Valueと入力してパスワードの値を確認し、次にInputs.DbPasswordと入力して、DbPassword入力パラメータのすべての属性の値を確認します。

58.6.6.5 例: クラウドの参照

パス式により、クラウド内のリソースの内容およびその属性を表示する簡単な方法も提供されます。その理由は、ブループリント処理の最初で、クラウド・リソース(第46章「クラウドのリソース・モデル」で定義)が読み取られ、インメモリーのブループリント構造に配置されるためです。パス式をCloudから開始することによって、Cloudリソースの属性を参照でき、URIを介してアクセス権を持つ他の任意のリソースに移動できます。

初めに、接続しているクラウドのdescriptionを表示します。

Paused: Cloud.description
This represents the Cloud resource of the Oracle Enterprise Manager Cloud Management solution
Paused

ここで、クラウドのzones属性など、より有用な情報を表示します。

Paused: Cloud.zones
elements:
- media_type: application/oracle.com.cloud.jaas.Zone+json
name: Zone1
service_family_type: jaas
uri: /em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51
- description: Zone for Physical Pool
media_type: application/oracle.com.cloud.common.DbZone+json
name: Zone1  type: self_service_zone
uri: /em/cloud/dbaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51
- media_type: application/oracle.com.cloud.opc.OpcZone+json
name: OPC Zone
service_family_type: opc
type: opc
uri: /em/cloud/opc/opczone
media_type: application/oracle.com.cloud.common.Zone+json
total: '3'

ここで、zones属性には、elements、media_typeおよびtotalの3つの属性が含まれていることがわかります。これらの意味は、第46章「クラウドのリソース・モデル」で説明されています。

リストされている最初のzoneに注目するために、角カッコ(リストの索引付け)構文を使用します。

Paused: Cloud.zones.elements[0]
media_type: application/oracle.com.cloud.jaas.Zone+json
name: Zone1
service_family_type: jaas
uri: /em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51

別のドット演算子を追加して、uri属性に注目するようにさらに詳細に指定できます。

Paused: Cloud.zones.elements[0].uri
/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51

URI参照先のリソースを表示するために、矢印(トラバース)演算子を追加します。

Paused: Cloud.zones.elements[0].uri->
context_id: A1B44A4EBCC4563125D9D0A3AAE4FD51
description: Zone for Physical Pool
media_type: application/oracle.com.cloud.jaas.Zone+json
name: Zone1
resource_state:
state: READY
service_family_type: jaas
service_instances:
elements: []
media_type: application/oracle.com.cloud.common.ServiceInstance+json
total: '0'
uri: /em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51

期待どおり、パス式を追加し続けることができ、たとえばマルチホップ式を記述して、次の例のように複数のURIをトラバースできます。

Paused: Cloud.service_templates.elements[0].uri->zones.elements[0].name
Zone1

Paused: Cloud.service_templates.elements[0].uri->zones.elements[0].uri->
context_id: A1B44A4EBCC4563125D9D0A3AAE4FD51
description: Zone for Physical Pool
media_type: application/oracle.com.cloud.jaas.Zone+json
name: Zone1
resource_state:
state: READY
service_family_type: jaas
service_instances:
elements: []
media_type: application/oracle.com.cloud.common.ServiceInstance+json
total: '0'
uri: /em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51

Paused:

前述の例では、Cloudのservice_templates属性を使用して、最初のサービス・テンプレートを特定しています。次に、そのURIをトラバースしてテンプレートに到達し、そのサポートされているzoneのリストから最初のzoneを特定します。次に、そのURIをトラバースしてzoneの完全な定義に到達します。多くの場合、トラバース演算子だけで十分ですが、URIに対してデフォルトのメディア・タイプが定義されていない場合、第46章「クラウドのリソース・モデル」で指定されている、取得するメディア・タイプの指定が必要となる場合があります。次の例では、必須ではないものの、メディア・タイプを指定しています。

Paused: Cloud.service_templates.elements[0].uri->
["application/oracle.com.cloud.jaas.JavaPlatformTemplate"]

context_id: D2520A0CFFE348BCE040F20A4C1B2D8F
created: '2013-01-02 09:35:52.0'
default_instance_media_type:
application/oracle.com.cloud.jaas.JavaPlatformInstance+json
...

同様に、トラバース修飾子構文を使用して、第46章「クラウドのリソース・モデル」で定義されているリクエスト・パラメータを指定できます。たとえば、次のようになります。

Paused: Cloud.service_templates.elements[0].uri->[created, resource_state]
created: '2013-01-02 09:35:52.0'
resource_state:
state: READY

58.6.6.6 eval式またはブループリント式

eval (またはブループリント)式とは、ブループリントに含めることができる任意の式です。

例: 単純な固有関数評価

eval式は、eまたはevalコマンドを使用して、デバッガ内で評価されます。コマンドの入力後、式を構成する行を入力して、続いて空白行を入力します。f_concat固有関数を使用した実験を行うとします。

Paused: e
Eval: f_concat:
Eval:  - xxx
Eval:  - yyy
Eval:
xxxyyy
Paused:

f_concatのコール(3行)を入力すると、空白行を使用して式を終了させた後に値が出力されます。

次に別のコールをネストします。

Paused: e
Eval: f_concat:
Eval:  - xxx
Eval:  - f_path:
Eval:    - 'Inputs.DbPassword.Value'
Eval:  - yyy
Eval:
xxxmySecretyyy
Paused:

これは、ブループリントのスニペットで実験する方法を提供しています。

例: 検索固有関数

この例で、ブループリント内でf_getTemplateURIを使用して、テンプレートURIを検索するとします。

Resources:
MyDB:
Container:
f_getTemplateURI:
- Small DB
- dbaas

誤ったURIが返されていると考えられる場合、次のようにチェックできます。

Paused: e
Eval:       f_getTemplateURI:
Eval:         - template1
Eval:         - jaas
Eval:
/em/cloud/jaas/javaplatformtemplate/BFAB458D36BDA87EE040E50A038F6D45
Paused:

これは、入力した引数を使用したf_getTemplateURIにより返されたURIの値を示しています。

58.6.7 固有関数

固有関数は、必要な情報を計算するため、または返すためにブループリントで使用できる関数です。たとえば、f_concat関数は、その文字列引数の連結を返し、f_getZoneURI関数は、ゾーンのURIを検索して返します。固有関数は、通常はResourcesおよびOutputsセクションの一部として必要な値を提供するために使用しますが、リテラル値が許容されている任意の場所への配置が可能です。たとえば、固有関数を使用して、入力パラメータで使用するDefaultValueを導出できます。

この項では、現在使用可能な固有関数について説明します。

58.6.7.1 評価固有関数

次の2つの固有関数は、様々なタイプの式の評価に使用し、1つの値を返します。

58.6.7.1.1 f_path(pathExpr)

pathExpr文字列をブループリント・ドキュメントに適用して、指定した値を返します。

パラメータ

- pathExpr: 例: member.subMember…
トラバースしてドキュメントから情報を抽出する方法を示すパス式。第58.6.6.1項「パス式」を参照してください。

58.6.7.1.2 例: Dataセクションの値

ブループリントのDataセクションで定義されているリテラル値を使用してリソースのプロパティ値を指定するには、次のようにします。

...
params:
MasterUser:
f_deref:
- "Data.QADBCreds.user"
...

58.6.7.1.3 例2: Inputsセクションの値

入力パラメータ値のみを使用して前述の操作と同じ操作を行うには、次のようにします。

...
params:
MasterUser:
f_deref:
- "Inputs.my_param.value"
...

58.6.7.1.4 例3: クラウド検索によるデフォルトの入力パラメータ値

固有関数は、Resourcesセクション以外のセクションにも配置できます。たとえば、このブループリントは、Inputsセクションでのf_pathの使用を示しています。

Inputs:
JavaSvcZone:
DefaultValue:
f_path:
- 'Cloud.zones.elements[0].name'
Type: String
Prompt: Enter the name of a jaas zone
...

ブループリント作成者は、ここで不定のデフォルト・ゾーン名を提供しようとしており、パス式はクラウドのzones属性の最初のゾーンを選択しています。デフォルト値(プロンプトで表示)は、実行時に計算されます。

Input Parameter Value Entry
---------------------------
Enter the name of a jaas zone (east_coast_zone):

58.6.7.1.5 f_eval(blueprintExpr)

blueprintExprを評価して、指定された値を返します。ブループリント式の詳細は、第58.6.6.6項「eval式またはブループリント式」を参照してください。

パラメータ

blueprintExpr: ブループリント内で出現する場合と同じ、評価対象のYAMLテキスト

58.6.7.1.6 例(現実的でない)

f_eval固有関数は、ブループリント・プロセッサにより内部的に使用されますが、その使用が必要な場合はほとんどありません。(ブループリント式を直接使用します。)この関数を使用する1つの理由は、その値がYAML文字列形式のブループリント式である変数が存在する場合があるためです。

Data:
demoOfYamlMultilineText: |
This is a multi-
line text string which is
carefully indented. :-)
myBlueprintExpressionText: |
f_concat:
- 'Mister '
- 'Mxyzptlk'
Outputs:
demoOfYamlMultilineText:
Value:
f_path:
- 'Data.demoOfYamlMultilineText'
myBlueprintExpressionText:
Value:
f_path:
- 'Data.myBlueprintExpressionText'
useOfEvalonExpressionText:
Value:
f_eval:
- f_path:
- 'Data.myBlueprintExpressionText'

これは、次の出力となります。

18:49:58 INFO: Output Processing
18:49:58 INFO: -----------------
18:49:58 INFO:
18:49:58 INFO: Output values specified: 3
18:49:58 INFO:    Value of demoOfYamlMultilineText: This is a multi-
line text string which is
carefully indented. :-)
18:49:58 INFO:    Value of myBlueprintExpressionText: f_concat:
- 'Mister '
- 'Mxyzptlk'
18:49:58 INFO:    Value of useOfEvalonExpressionText: Mister Mxyzptlk

58.6.7.2 リソース・アクセス固有関数

次の固有関数は、リソースの属性にアクセスするために使用します。これらの動作の一部として、f_pathとは異なり、リソースがREADY状態であることが確認され、必要な場合は待機します。

58.6.7.2.1 f_getResourceAttr(bpResName, pathExpr)

クラウド・リソースの状態がREADYになった後に、その属性を取得します。

パラメータ

- bpResName: リソース名(ブループリントで指定)

- pathExpr: f_derefで使用されている場合と同じセマンティックで、bpResNameにより識別されたクラウド・リソースのドキュメントに対してのみ使用します。

- 戻り値: リソースが作成され、そのresource_stateがREADYになった場合の、リソースのpathExprの評価結果。

例1

MWプラットフォームにアプリケーションを追加するために、アプリケーション・リソースはこのContainer句を使用できます。

Container:
f_getResourceAttr:
- myJavaPlatform
- uri

例2

MWプラットフォームが作成されたゾーンの名前にアクセスするために、次のように記述できます。

f_getResourceAttr:
- myPlatform
- zone.name

58.6.7.2.2 f_getResourceURI(bpResName)

ブループリントで定義されたリソースのURIを取得します。これは、f_getResourceAttrの使用の簡略表現であり、指定される属性はuriです。

パラメータ

- bpResName: ブループリント・リソース定義で使用されている名前。

- 戻り値: URI

例

ブループリント内のいずれかの場所で作成されたJavaPlatformInstanceリソースに含めるデータソース・リソースを定義するには、次のようにします。

MyDatasource:
Type: Datasource
Container:
f_getResourceURI:
- MyJavaServer

58.6.7.3 検索固有関数

次の固有関数は、テンプレート、ゾーンまたはアプリケーション・コンポーネントを検索して、そのURIを返します。

58.6.7.3.1 f_getTemplateURI(name, type)

名前およびタイプに基づいて、テンプレートのURIを取得します。

パラメータ

- name: テンプレートの名前

- type: サービス・タイプ名。現在使用可能な値は、iaas、jaasおよびdbaasです。

- 戻り値: URI

例

テンプレートsimpleDbを使用してデータベースを作成するためのブループリント・リソースは、次のように記述されます。

Container:
f_getTemplateURI:
- simpleDb
- dbaas

58.6.7.3.2 f_getZoneURI(name, type)

名前およびタイプに基づいて、ゾーンのURIを取得します。

パラメータ

- name: ゾーンの名前

- type: サービス・タイプ名。現在使用可能な値は、iaas、jaasおよびdbaasです。

- 戻り値: URI

例

ゾーンEMEA_db_zoneのURIを取得するには、次のようにします。

f_getZoneURI:
- EMEA_db_zone
- dbaas

58.6.7.3.3 f_getAppCompURI(name, owner, version) …

名前、所有者およびバージョンに基づいて、アプリケーション・コンポーネントのURIを取得します。

パラメータ

- name: アプリケーション・コンポーネント名

- owner: アプリケーション・コンポーネントの所有者

- version: アプリケーション・コンポーネントのバージョン。空白の場合、最新のバージョンが使用されます。

- 戻り値: URI

例

SSA_USER1が所有する最新バージョンのアプリケーション・コンポーネントjbcomponentのURIを取得するには、次のようにします。

f_getAppCompURI:
- jbcomponent
- SSA_USER1
-

3番目の引数は必須であることに注意してください。

58.6.7.4 デバッグ固有関数

次の固有関数は、ブレークポイントまたは出力ポイントの作成に使用します。

58.6.7.4.1

f_break(expression, [breakpointMessage])

ブループリントの評価を一時停止して、オプションのメッセージを出力し、ブループリント・デバッガに入ります。

パラメータ

- expression: 任意のブループリント式

- breakpointMessage: この固有関数が呼び出され、デバッガに入る前に出力されるメッセージ。

- 戻り値: 式の値。これは、continueコマンドが入力されたときに計算されます。

注意: ブレークポイントを使用してブループリントのデバッグを支援する方法の例や詳細は、第58.9項「ブループリント・プロセッサを使用したデバッグ」を参照してください。

58.6.7.4.2 f_print(expression, [printpointMessage])

式の値を表示する行を出力します。ブループリントの評価を一時停止して、オプションのメッセージを出力し、ブループリント・デバッガに入ります。

パラメータ

- expression: 任意のブループリント式

- printpointMessage: この固有関数が呼び出され、デバッガに入る直前に出力されるメッセージ。

- 戻り値: 式の値。

注意: 行は次のように出力されます。

>>> Printpoint [<printpoint message>]:

Value = <expression>

ブレークポイントを使用してブループリントのデバッグを支援する方法の例や詳細は、第58.9項「ブループリント・プロセッサを使用したデバッグ」を参照してください。

58.6.7.5 その他の固有関数

f_concat(string1, … stringN):

文字列引数を連結して返します。

パラメータ

string*: その他の文字列引数と連結する文字列

例

JavaPlatformInstanceの記述をCreated by blueprint FOO on <current date>に設定するには、次のようにします。

Resources:
MyJavaServer:
...
Properties:
description:
f_concat:
- "Created by blueprint FOO on "
- f_path:
- "Info.date"
...

58.7 エラーの処理

この項では、発生する可能性がある様々なタイプのエラーについて説明し、問題の解釈や解決の方法について説明します。

58.7.1 YAML構文エラー

YAMLパーサーにより検出されたすべての構文エラーは、パーサーにより診断されます。次のコード・スニペットについて考えてみます。

# Example of YAML syntax error
Data:
userId: Lex
password: changeMe
...

前述の例では、YAMLパーサーはインデント・エラーを検出し、次のように診断します。

18:55:59 ERROR: Error loading blueprint YAML:
while parsing a block mapping
in "<string>", line 2, column 1:
Data:
^
expected <block end>, but found '<block mapping start>'
in "<string>", line 4, column 3:
password: changeMe
^

通常、診断の後半のexpected部分が最も役立ちます。この場合、エラーがトークンpasswordで検出されたことを通知し、期待される内容と検出された内容が示されます。回避すべきよくあるエラーの1つは、YAMLファイル内でのタブの使用です。YAMLでは、タブ文字は使用できません。

58.7.2 プロトコル・バージョンの不一致

次のように診断されます。

Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:              http://xyxy.example.com:4473/em
User:                   sysman
Blueprint file:         examples/evalintrinsic.yml
Timeout:                90 minutes, 0 seconds
Refresh frequency:      15 seconds
Inputs:
Pause points:           Inputs, Termination
Debug logging:          False
Instance name:          default_instance_name
Versions:
Blueprint processor: 12.1.0.4 May 25
Cloud protocol:      10001

19:05:06 INFO: Connecting to cloud: http://xyxy.example.com:4473/em
19:05:07 ERROR: Cloud protocol version mismatch.  Expected 10001.  Found None.

診断の太字部分は、ブループリント・プロセッサはサイトに接続できるが、期待されるレスポンスを得られなかったことを示しています。具体的には、サイトはHTTPレスポンスの一部としてのx-specification-version値を返しませんでした。これは、クラウドURIを誤って指定した場合に発生します。たとえば、前述の例では、URIが次の形式になっていません。

https://host:port/em/cloud

よくあるミスの1つが、/cloudの欠落です。また、httpではなくhttpsを使用することも忘れないでください。診断が、期待されるものより低いプロトコルのバージョンが検出されたことを示している場合、使用しているブループリント・プロセッサのバージョンは、より新しいバージョンのEnterprise Managerを必要としている可能性があること示しています。

58.7.3 式評価エラー

ブループリント処理の一環として、式を評価しようとしてエラーが発生する場合があります。次にエラーの例を示します。

- 固有関数に渡しているパラメータの数が正しくない

- 存在しない固有関数を参照している

- 存在しないクラウド・リソース(ゾーンやテンプレートなど)を参照している

式評価のエラーが発生した場合、問題が診断されて式が表示されます。たとえば、次のブループリント(現実的ではありませんが)について考えます。

Outputs:
ExampleValue:
Value:
f_concat:
- MyApp

例を簡潔にするために、ブループリントにはOutputsセクションと、f_concatのコールである1つの式のみが含まれています。f_concatには少なくとも2つのパラメータが必要であるが、1つのみ指定されていることに注意してください。このブループリントに対してブループリント・プロセッサを実行すると、次が表示されます。

15:26:25  INFO: Output Processing
15:26:25  INFO: -----------------
15:26:25  INFO:
15:26:25  INFO: Output values specified: 1
15:26:25 ERROR:    Value of ExampleValue: Expression could not be evaluated.
Error is...
15:26:25 ERROR: Function/macro concat requires parameter count between 2 and 99,
not 1
15:26:25 ERROR: Expression being evaluated at the time:
15:26:25 ERROR:    {'f_concat': ['MyApp']}
15:26:25  INFO:

ブループリント・プロセッサは、エラーの発生時にExampleErrorの値を出力しようとします。診断の表示後に、エラー発生時に評価された式が表示されます(JSON表記法を使用)。式は、通常はネストされており、サブ式内でエラーが発生する可能性があります。この場合、診断には式スタックが含まれ、エラーが発生した特定の式に加え、外側のコンテキストも確認できます。たとえば、次のブループリント(現実的ではありませんが)について考えます。

Outputs:
ExampleValue:
Value:
f_concat:
- aaa
- bbb
- f_concat:
- ccc

この式ではf_concatを2回使用していることに注意してください。外側は正しく使用されていますが、内側の使用に誤りがあります。このブループリントに対してブループリント・プロセッサを実行すると、次が表示されます。

15:42:50  INFO: Output Processing
15:42:50  INFO: -----------------
15:42:50  INFO:
15:42:50  INFO: Output values specified: 1
15:42:50 ERROR:    Value of ExampleValue: Expression could not be evaluated.
Error is...
15:42:50 ERROR: Function/macro concat requires parameter count between 2 and 99,
not 1
15:42:50 ERROR: Expression evaluation stack follows (with failed expression at
bottom) ...
15:42:50 ERROR: -----
15:42:50 ERROR: |   Expr: {'f_concat': ['aaa', 'bbb', {'f_concat': ['ccc']}]}
15:42:50 ERROR: |   Expr: {'f_concat': ['ccc']}
15:42:50 ERROR: -----
15:42:50  INFO:

式評価スタックでは、上部に外側の式が表示され、下部に誤りがある式が表示されています。このスタックのレベルは2つのみですが、一般的には多くのレベルがあり、各レベルの評価が表示されます。(次の例は、複数レベルの式評価スタックを示しています。)マクロの評価時には、その定義が展開され、この展開が式評価スタックに表示されます。たとえば、次のブループリント(現実的ではありませんが)について考えます。

Outputs:
ExampleValue:
Value:
f_getZoneURI:
- myZone
- jaas

この場合、式はf_getZoneURIのコールであり、ゾーンmyZoneが存在しないことがエラーになっています。このブループリントに対してブループリント・プロセッサを実行すると、次が表示されます。

15:57:17  INFO: Output Processing
15:57:17  INFO: -----------------
15:57:17  INFO:
15:57:17  INFO: Output values specified: 1
15:57:18 ERROR:    Value of ExampleValue: Expression could not be evaluated.
Error is...
15:57:18 ERROR: Name not found: myZone
15:57:18 ERROR: find_one for predicate {'f_EQ': [{'f_pathc': ['name']}, 'myZone']}
failed
15:57:18 ERROR: Expression evaluation stack follows (with failed expression at
bottom) ...
15:57:18 ERROR: -----
15:57:18 ERROR: |   Expr: {'f_getZoneURI': ['myZone', 'jaas']}
15:57:18 ERROR: |   Expr: {'f_pathc': [{'f_findByName': [{'f_pathc': [{'
f_findByName': [{'f_path': ['Cloud.service_family_types.elements']}, 'jaas']},
'.uri-.zones.elements']}, 'myZone']}, '.uri']}
15:57:18 ERROR: |   Expr: {'f_findByName': [{'f_pathc': [{'f_findByName': [{'
f_path': ['Cloud.service_family_types.elements']}, 'jaas']},
'.uri->.zones.elements']}, 'myZone']}
15:57:18 ERROR: |   Expr: {'f_findOne': [{'f_pathc': [{'f_findByName': [{'f_path':
['Cloud.service_family_types.elements']}, 'jaas']}, '.uri->.zones.elements']},
{'f_EQ': [{'f_pathc': ['name']}, 'myZone']}, {'f_concat': ['Name not found: ',
'myZone']}]}
15:57:18 ERROR: -----
15:57:18  INFO:

エラーが検出されると、診断にName not found: myZoneと表示されます。この場合は、明白なエラーであるため、さらに読み進める必要はありません。

ただし、式評価スタックでマクロの展開や複数レベルでネストされた式がどのように示されるかを説明するために、引き続きこの例を順を追って検討します。スタックの1行目には、外側の式が示されていますが、これは、ブループリントでValueの式として指定されたものです。f_getZoneURI固有関数はマクロとして実装されているため、式評価スタックの2行目にはマクロの展開後の式が表示されています。(これは長いため、行の折り返しが必要です。)

3行目には、エラー発生時に評価された2行目のサブセットが表示され、4行目にはf_findByNameマクロが展開された後の同じ式が示されています。

注意:
固有関数マクロではいくつかの内部関数が使用されているため、f_pathcなどの名前が表示されています。

58.7.4 クラウド・リソース作成エラー

前述の例では、リソース作成の失敗は、リクエストが受け入れられてから、一定時間の経過後に検出されています。場合によっては、作成リクエストがただちに失敗することがあります。リソース作成の試行時にエラーが発生した場合、リソース、エラー・コードおよびいくつかの診断テキストが特定された診断が表示されます。 次の例では、MyJavaPfという名前のリソース作成の試行が、HTTPコード500で失敗しています。さらに読み進めると、"cannot process request for …"、"Unable to start the Instance deployment"および"stack_trace_cause" : "java.lang.IllegalArgumentException: Unable to service executable from service template…"などの診断テキストを確認できます。

14:43:37 INFO:          MyJavaPf
14:43:37 INFO:         /
14:43:37 INFO:        /    MyDatasource
14:43:37 INFO:       /    /
14:43:37 INFO:   -----------
14:43:37 INFO:   | e  |    |
14:43:38 INFO:   | es |    |
14:43:42 ERROR: Failure creating resource MyJavaPf: 500
{
"messages" :
[
{
"date" : "2012-05-22T18:43:42+0000" ,
"text" : "cannot process request for
oracle.sysman.emInternalSDK.ssa.cloudapi.ResourceInteraction@767d6a37 on
/em/cloud/jaas/
javaplatformtemplate/C086733BCCF2A4F3E040F10A716049A8" ,
"hint" : " Unable to start the Instance deployment" ,
"stack_trace_cause" : "java.lang.IllegalArgumentException: Unable to
service executable from service template : C086733BCCF2A
4F3E040F10A716049A8\n\tat
oracle.sysman.ssa.mwaas.model.util.remoteop.DPSubmissionHelper.
_createRequestMWaasSetup(DPSubmissionHelper.
java:359)\n\tat oracle.sysman.ssa.mwaas.model.util.remoteop.DPSubmissionHelper.
_submitMWaasSetupServiceRequest(DPSubmissionHelper.
java:616)\n\tat
oracle.sysman.ssa.mwaas.model.util.remoteop.DPSubmissionHelper.submitMWaasSetupSe
rviceRequest(DPSubmissionHelper.
java:712)\n\tat
oracle.sysman.ssa.cloudapi.jaas.JavaPlatformInstance.GenerateJavaPlatformInstance
(JavaPlatformInstance.java:369)\n\tat
oracle.sysman.ssa.cloudapi.jaas.JavaPlatformTemplate.processRequest(JavaPlatformTemplate.java:128)\n\tat oracle.sysman.ssa.cloudapi.jaas.J
aasServiceProvider.processRequest(JaasServiceProvider.java:520)\n\tat
oracle.sysman.emInternalSDK.ssa.cloudapi.EMCloudServlet.perform
(EMCloudServlet.java:226)\n\tat
oracle.sysman.emInternalSDK.ssa.cloudapi.EMCloudServlet.performPost
(EMCloudServlet.j" ,
"stack_trace" :
"oracle.sysman.emInternalSDK.ssa.cloudapi.CloudServiceException:  Unable to start
the Instance deployment\n\t
at
oracle.sysman.ssa.cloudapi.jaas.JavaPlatformInstance.GenerateJavaPlatformInstance
(JavaPlatformInstance.java:373)\n\tat oracle.sysm
an.ssa.cloudapi.jaas.JavaPlatformTemplate.processRequest(JavaPlatformTemplate.
java:128)\n\tat oracle.sysman.ssa.cloudapi.jaas.JaasSer
viceProvider.processRequest(JaasServiceProvider.java:520)\n\tat
oracle.sysman.emInternalSDK.ssa.cloudapi.EMCloudServlet.
perform(EMCloudServlet.java:226)\n\tat
oracle.sysman.emInternalSDK.ssa.cloudapi.EMCloudServlet.performPost
EMCloudServlet.java:363)\n\tat oracle.
sysman.emInternalSDK.ssa.cloudapi.rest.AbstractRestServlet.doPost(AbstractRestServ
let.java:134)\n\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:727)\n\tat
javax.servlet.http.HttpServlet.service(HttpServlet.java:820)\n\tat
weblogic.servlet.internal.
StubSecurityHelper$ServletServiceAction.run(StubSecurityHelper.java:227)\n\tat
weblogic.servlet.internal.StubSecurityHe"
}
]
}

14:43:42 INFO:   | CF |    |
14:43:42 INFO:   -----------
14:43:42 INFO:
14:43:42 ERROR: Create of resource MyJavaPf failed

この例では、HTTPコードは500です。5で始まるすべてのコードは、クラウド・サーバーで予期しない例外が発生したことを示しています。これは、環境の問題またはサーバー・ソフトウェアのバグが原因と考えられます。5xxコードはサーバー・エラーを示しているため、セルフ・サービスの管理者に連絡する必要があります。その他に、4xxエラー・コードが表示される場合があり、これはクライアントでエラーが発生している可能性があるときに返されます。このような場合、hintおよびmessage情報をチェックして、問題の発生箇所に関する手掛かりを得ると、発生したエラーを修正できる可能性があります。ブループリント・プロセッサは、受信した診断情報をリスト表示しますが、セキュリティ上の理由から、クラウド・サーバーは問題を診断するための十分な情報を提供しない場合があります。この場合、セルフ・サービスの管理者に連絡すると、管理者はそれを受けて、クラウド・リクエストのログ・ファイルを確認して問題を診断できます。

58.8 シミュレーション・モード

ブループリント・プロセッサのシミュレーション・モードは、ブループリントの作成やテストを支援するために使用されます。このモードでは、通常はクラウド・サーバーに送信されるリクエストがシミュレーションされ、サーバーから返される結果もシミュレーションされます。その他の点では、ブループリントの処理ロジックは変わりません。ブループリント・プロセッサをこのモードで実行するには、クラウドURIを指定しないようにします(つまり、コマンドラインで-cオプションを使用しません)。

シミュレーション・モードの利点の1つは、ブループリントを実行してバリエーションを試す速度にあります。ブループリントの通常の実行では、クラウド・リクエストが必要ですが、この処理にかなりの時間を要する場合があります。シミュレーション・モードのデフォルト動作は、各リソースの作成リクエストに2秒を費やしてから成功します。もう1つの利点は、様々な可能性をテストできることです。リソースごとに、シミュレーションされる処理時間を指定し、リクエストが成功するか失敗するかも指定できます。所定のリソースでこれを実行するには、リソースの定義時にSimulation属性を使用します。たとえば、次のようになります。

MyJavaServer1:
Container:
f_getTemplateURI:
- Small WLS
- jaas
Properties:
destination_zone:
f_getZoneURI:
- MyZone
- jaas
params:
user: app_user
password: pw_you_should_change
Simulation:
delay: 3
result: f

前述の例では、MyJavaServer1の作成は3秒後に失敗します。

58.9 ブループリント・プロセッサを使用したデバッグ

ブループリントをデプロイして完了するためのブループリント・プロセッサの実行に加え、ブループリントをデバッグするために使用できるメカニズムがあります。これらは、他のアプリケーションのデバッグに使用していたメカニズムと同種のものであり、print文やデバッガを使用したアプリケーションで使用される値のインタラクティブな表示などがあります。実行の特定のポイントでデバッガに入るために、次の2つのメカニズムのいずれかを使用できます。単純な方法では、処理フェーズ間で実行の一時停止を引き起こすコマンドライン・オプションを使用しますが、通常はこれで十分です。これらは一時停止ポイントと呼ばれ、後述します。もう1つの方法は、特定のリソースのプロパティの式評価の直前など、具体的なポイントで中断できるようにすることです。これを行うには、ブループリントを編集してブレークポイントを含めます。一時停止ポイントまたはブレークポイントのいずれかに達すると、制御がデバッガに移されます。デバッガでは、様々なコマンドを入力して、ブループリントの内容や接続先クラウドの内容を表示します。

58.9.1 中間結果の出力

ブループリント処理の本質は、式を評価することと、必要なすべての式を評価した後にリソースを作成することです。式評価の任意のポイントでいくつかの中間結果を表示して、値が期待どおりであることを確認できます。これを行うには、固有関数f_printを使用します。

ブループリント内の式が出現する任意のポイントで、これを出力のコール内でネストします。2番目のテキスト・メッセージ引数を含めることもできます。出力時には、テキスト・メッセージと式の値が出力されます。

例 この(現実的でない)例では、f_getTemplateURIのコールに使用するテンプレート名にアクセスするために、参照表の使用をどのように計画するかを示しています。

Data:
MyTemplates:
- {name: DbTemplate, type: dbaas}
- {name: MWTemplate, type: jaas}
...
Resources:
MyDB:
Container:
f_getTemplateURI:
- f_path:
- 'Data.MyTemplates[0].name'
- dbaas
Properties:
...

コードが意図したとおりに動作していないため、名前をf_ getTemplateURIに渡す前の中間結果が表示されるようにするとします。次のように、f_printのコール内に式をラップします。

Data:
MyTemplates:
- {name: DbTemplate, type: dbaas}
- {name: MWTemplate, type: jaas}
...
Resources:
MyDB:
Container:
f_getTemplateURI:
- f_print:
- f_path:
- 'Data.MyTemplates[0].name'
- dbaas
Properties:
...

At runtime, the value of the expression is printed:16:52:05  INFO:
16:52:05  INFO: Resource State Timeline
16:52:05  INFO: -----------------------
...
16:52:05  INFO:
16:52:05  INFO:        MyDB
16:52:05  INFO:       /
16:52:05  INFO:   ------
16:52:05  INFO:   | e  |
>>> Print-point:
Value = DbTemplate
...

出力ポイント・メッセージを指定することもでき、このことは、ブループリント内に複数の出力ポイントがある場合に便利です。

Data:
MyTemplates:
- {name: DbTemplate, type: dbaas}
- {name: MWTemplate, type: jaas}
...
Resources:
MyDB:
Container:
f_getTemplateURI:
- f_print:
- f_path:
- 'Data.MyTemplates[0].name'
- My printpoint for template name
- dbaas
Properties:
...

実行時に、式の値が次のように出力されます。

16:52:05  INFO:
16:52:05  INFO: Resource State Timeline
16:52:05  INFO: -----------------------
...
16:52:05  INFO:
16:52:05  INFO:        MyDB
16:52:05  INFO:       /
16:52:05  INFO:   ------
16:52:05  INFO:   | e  |
>>> Print-point: My printpoint for template name
Value = DbTemplate
...

58.9.2 一時停止ポイント

一時停止ポイントの使用は、デバッガに入るポイントを指定する最も簡単な方法です。これらは、第58.3項「ブループリント・プロセッサの実行」で説明されているコマンドライン・オプションを使用して指定します。次のすべてのポイントで、ブループリント・プロセッサが一時停止してデバッガに入るように指定できます。

- Inputセクションの評価および入力パラメータの入力要求の前

- Resourcesセクションの評価前

- Outputセクションの評価前

- 終了前、ただし出力処理後または処理を終了させるエラーの検出後

- エラーが発生した場合、終了の直前

デバッガに入ったら、後述の第58.9.4項「デバッガ・コマンド」で説明されているコマンドを使用できます。ブループリントの実行を続行するには、continueコマンドを実行します。

Example1

サーバーのクラウド・リソースを参照するとします。–Iオプションを指定すると、ブループリント処理が試行される前にデバッガに入ります。

例2

-E (または—error_debug)オプションを指定すると、エラーの発生時にデバッガに入るため、多くの場合便利です。(それ以外の場合、実行は単純に終了します。)

58.9.3 ブレークポイント

ブレークポイントは、第58.6.7.4項「デバッグ固有関数」で説明されているf_breakpoint固有関数を使用して定義されます。評価中にf_breakpointが呼び出された場合は、オプションのテキスト文字列パラメータ値が出力され、デバッガに入ります。

58.9.4 デバッガ・コマンド

デバッガに入ると、Pausedプロンプトが表示されます。このプロンプトで、helpやhなど、数種類のコマンドを使用できます。たとえば、次のようになります。

Paused: h
Commands are...
p[ath] <path expression>: evaluate path expr
e[val]:                   read & evaluate blueprint expression
c[ontinue]:               continue blueprint instantiation
x[it]:                    exit blueprint processor
h[elp]:                   (this command)
If first token isn't a command, the line is treated as a path expression
Paused:

58.9.4.1 pathコマンド

pathコマンドは、前述の第58.6.6.1項「パス式」で説明されている任意のパス式の評価に使用します。(その他のデバッガ・コマンドとは異なり、pまたはpathキーワードは不要です。)

例: ブループリント内の値の表示

入力パラメータの値など、ブループリント内の値を表示できます。

C:\bp> bp_processor.py -c https://...:15430/em/cloud -u sysman -p sysman -R
xyzApp.yml ...Blueprint Processor - Invocation Summary
----------------------------------------
Cloud URI:                https://xyxy.example.com:15430/em/cloud
User:                     sysman
Blueprint file:           xyzApp.yml
Timeout:                  90 minutes, 0 seconds
Refresh frequency:        15 seconds
Inputs:
Pause points:             Resources
Debug logging:            False
Instance name:            default_instance_name
Graphical report dir:
Versions:
Blueprint processor:   12.1.0.5, 10-Oct-2012
Cloud protocol:        10001

18:28:14  INFO: Connecting to cloud: https://xyxy.example.com:15430/em/cloud

Input Parameter Value Entry
---------------------------
Zone to use for db (Zone1):
Password to use for db (welcome1):

...Pause point, prior to processing Resources section...
For command info, enter (h)elp

Paused: path Inputs
DbPassword:
DefaultValue: welcome1
Prompt: Password to use for db
Sensitive: true
Type: String
Value: mySecret
DbZone:
DefaultValue: Zone1
Prompt: Zone to use for db
Type: String
Value: Zone1

Paused: Inputs.DbPassword.Value
mySecret

Paused:

前述の例では、単純なテスト用ブループリントで2つの入力パラメータ、DbZoneとDbPasswordが指定されています。

- 入力を要求されたら、[Enter]を押して最初のパラメータのデフォルトをそのまま使用します。2番目については、自分のパスワードを入力します。

- コマンドライン・オプションには-Rが含まれていることに注意してください(このコマンドは、ブループリント・プロセッサがブループリントのResourcesセクションの評価前に一時停止するように指示します)。Pausedプロンプトが表示され、pathコマンドおよびパス式Inputsを入力します。ブループリントのInputsセクションの値、つまり2つの入力パラメータとその値が出力されます。値には、ブループリントで指定されているものと、現在の実行時の値の両方が含まれています(この場合はZone1とmySecret)。

- 次に、パス式のみを入力します。コマンドが明示的に入力されていない場合、pathコマンドが想定されます。

58.9.4.2 continueコマンド

continueコマンドは、ブループリント処理の再開に使用します。例

前述の例を続けて使用します。

Paused: Inputs.MyNum
{Sensitive: true, Type: Number, Value: '123'}

Paused: continue

58.9.4.3 exitコマンド

exitコマンドは、ブループリント・プロセッサを終了します。

58.9.4.4 evalコマンド

evalコマンドは、ブループリントに含めることができる任意の式の評価に使用します。

例

ブループリントのデバッグを行っており、名前によるテンプレートの検索時に失敗している可能性があるとします。evalコマンドを使用して、ブループリント内に出現する式を評価できます。初めに、対象の式をブループリントに表示されているとおりに実行してみます。

Paused: e
Eval: f_getTemplateURI:
Eval:   - JaaS Template
Eval:   - jaas
Eval:
18:05:01 ERROR: Name not found: JaaS Template
Expression evaluation stack follows (with failed expression & diagnostic at
bottom) ...
-----
|   Expr: {'f_getTemplateURI': ['JaaS Template', 'jaas']}
|   Expr: {'f_path': [{'f_findByName': [{'f_path': [{'f_findByName': [{'f_path':
['Cloud.service_types.elements']}, 'jaas']}, '.uri->
.service_templates.elements']}, 'JaaS Template']}, '.uri']}
|   Expr: {'f_findByName': [{'f_path': [{'f_findByName': [{'f_path':
['Cloud.service_types.elements']}, 'jaas']}, '.uri->.service
_templates.elements']}, 'JaaS Template']}
|   Expr: {'f_findOne': [{'f_path': [{'f_findByName': [{'f_path': ['Cloud.service
_types.elements']}, 'jaas']}, '.uri->.service_
templates.elements']}, {'f_EQ': [{'f_path': ['name']}, 'JaaS Template']},
{'f_concat': ['Name not found: ', 'JaaS Template']}]}
| End of stack for error message: Name not found: JaaS Template
-----
Paused:

前述の例では、初めにevalまたはeコマンドを入力します。次に、式を入力します。YAMLでは常にインデントが重要であることに注意してください。ブループリントを処理したときに得られた診断と同じ診断が表示されますが、ここでは他の値を使用して実験できます。最終的に、テンプレートはその名前に2つのスペースを使用して作成されたことがわかりました。その名前で試してみます。正しく動作して、式評価の結果(この場合はURI)が表示されます。

Paused: e
Eval: f_getTemplateURI:
Eval:   - JaaS  Template
Eval:   - jaas
Eval:
/em/cloud/jaas/javaplatformtemplate/C086733BCCF2A4F3E040F10A716049A8
Paused:

58.10 アドバイスとヒント

この項では、ブループリントを使用するときに役立ついくつかのアドバイスやヒントを示します。

58.10.1 YAMLの編集: Notepad ++の例

YAMLドキュメントではインデントを使用して包含セマンティックを表します。これは、エディタまたは編集オプションの選択に影響を与えます。たとえば、YAMLではタブを使用できないため、自動タブ挿入の原因となるすべてのエディタ・オプションを無効にする必要があります。たとえば、Notepad++ (http://notepad-plus-plus.org)を使用するとします。スペースで置換する設定を、「環境設定」→「言語メニュー/タブ設定」から行います。Notepad++がさらに優れている点は、ファイルの接尾辞が.ymlである場合、YAMLに適切なオプションが自動的に設定されることです。たとえば、YAML構文に基づいて、テキストが色付けされます。.ymlを使用しない場合は、手動で言語をYAMLに設定できます。(「設定」→「環境設定」→「言語メニュー」→…)

58.10.2 YAML重複と名前/値ペア

YAMLでは、同じレベルの名前/値ペアで一意の名前を使用する必要があります。重複した場合、先に出現している方が上書きされます。たとえば、次の2つのブループリントは同等です。

Data:
Password: doNotChangeMe
UserId: QA_user
Password: changeMe
Resources:
...

Data:
UserId: QA_user
Password: changeMe
Resources
...

58.10.3 明示的な依存関係

ブループリントで2つのリソース、XとYを定義するとします。Xの作成がYの正常な作成に依存している場合、2つの間には通常はデータの依存関係が生じます。ただし、これに該当しない場合、リソースXの定義の任意の場所に次のような式を含めることができます。

f_getResourceAttr:
- ResourceY
- uri

58.10.4 ヒント: -Tオプションの使用

ブループリントを作成およびテストするときは、-Tコマンドライン・オプションの使用をお薦めします。これは、ブループリント・プロセッサに、いかなる理由であっても終了する前にデバッガに入るように指示します。予期しない結果が生じた場合、それが明白なエラーであっても、単なる予期しない出力であっても、デバッガを使用して調査できます。

58.10.5 ヘルプ・フォーラム

その他の疑問がある場合、それらをhttps://forums.oracle.com/forums/forum.jspa?forumID=220に投稿してください。

59 Infrastructure as a Service REST API

この章では、Infrastructure as a Service (IaaS) REST APIのリソース・モデルとそのレスポンスについて説明します。次の項が含まれます。最初の項でこの章のすべてのREST APIのサマリーを示し、その後の項でIaaSリソース・モデルやその他の詳細を説明します。

- Infrastructure as a Service REST APIのサマリー

- Infrastructure as a Serviceのリソース・モデル

- Infrastructure as a Serviceの変更

- IaaSゾーン[application/oracle.com.cloud.iaas.Zone]

- AssemblyInstance[application/oracle.com.cloud.common.AssemblyInstance+json]

- スケーラビリティ・グループ[application/oracle.com.cloud.common.ScalabilityGroup+json]

- VM [application/oracle.com.cloud.common.VM+json]

- VNet [application/oracle.com.cloud.common.VNet+json]

- NetworkInterface [application/oracle.com.cloud.common.NetworkInterface+json]

- VMTemplate [application/oracle.com.cloud.common.VMTemplate+json]

- AssemblyTemplate [application/oracle.com.cloud.common.AssemblyTemplate+json]

- IaasServiceFamilyType [application/oracle.com.cloud.iaas.IaasServiceFamilyType+json]

- Iaas割当て定義[application/oracle.com.cloud.iaas.Quota+json]

- Infrastructure as a Service REST APIの例

- バージョン1000のサポート

59.1 Infrastructure as a Service REST APIのサマリー

次の表に、この章で説明するすべてのIaaS REST APIをまとめています。

表59-1 IaaS REST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

サービス・インスタンス - VM

表59-6

第59.3.1.2項

第59.3.1.1項

第59.3.2項

第59.3.3項

サービス・インスタンス - アセンブリ・インスタンス

表59-4

第59.3.1.3項

第59.3.1.3項

サポート対象

サポート対象

バージョン10000のサポート

該当なし

第59.4項

サポート対象

サポート対象

サポート対象

サービス・テンプレート

- 表59-9

- 表59-10

表59-37

表59-37

サポート対象

サポート対象

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

59.2 Infrastructure as a Serviceのリソース・モデル

Infrastructure as a Serviceでは、ITコンポーネントの基礎を形成する計算、ネットワークおよび記憶域のリソースをサポートします。IaaSリソース・モデルでは、これらのリソースの共通クラウド相互作用がサポートされます。次の図に、上位レベルのリソース関係およびそれらと共通リソースとの関連を示します。

図59-1 IaaSのリソース・モデル

次に、IaaSファミリ・タイプでサポートされるリソース・モデルについて説明します。

59.2.1 Infrastructure as a Serviceの変更

次に、Infrastructure as a Serviceのリソースに対する高度な更新を示します。

表59-2 Cloud Service Portal 12.1.0.5

概要

説明

ServiceTemplateFindsでのVMTemplateおよびAssemblyTemplateのサポート

Infrastructure as a serviceは、VMTemplateおよびAssemblyTemplateリソースのフィルタリングおよび検索を実装します。

VMのクローニングのサポート

VMリソースを別のVMから直接作成できます。

テンプレートとしてのVMの保存のサポート

VMTemplateリソースをVMリソースから作成できます。

インフラストラクチャ割当てのサポート

Infrastructure as a serviceリソースの割当て情報と割当て制限使用量を提供します。

59.2.2 IaaSゾーン[application/oracle.com.cloud.iaas.Zone]

application/oracle.com.cloud.common.Zoneを拡張します。このリソースは、IaaSリソースをサポートするIaaSゾーンのビューを表します。

表59-3 IaaSゾーンのデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、このユーザーに対するゾーン定義のクライアント表現がリフレッシュされます。

1

12.1.0.4

name

文字列

ゾーンの名前。様々な言語をサポートするUNICODE文字列になります

1

12.1.0.4

description

文字列

ゾーンのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

リソースのメディア・タイプ。application/oracle.com.cloud.iaas.Zone

0..1

12.1.0.4

resource_state

ResourceState

リソースのリソース状態。

0..1

12.1.0.4

service_family_type

文字列

このゾーンが関連付けられているサービス・ファミリ・タイプの名前。

この場合、iaasです。

0..1

12.1.0.4

service_templates

コレクション<ServiceTemplate>

このゾーンがサポートする、このゾーンをデプロイ可能なサービス・テンプレートのコレクション。現在、VMTemplateとAssemblyTemplateがメンバーのタイプです。

0..1

12.1.0.4

service_instances

コレクション<ServiceInstance>

このゾーン内にあるサービス・インスタンスのコレクション。

0..1

12.1.0.4

vnets

コレクション<VNet>

このゾーンに関連付けられている仮想ネットワークのコレクション。

0..1

12.1.0.4

backends

コレクション<Physical Net>

このゾーンに関連付けられているユーザーが使用できる物理ネットワーク。

0..1

12.1.0.6

media_type

文字列

リソースのメディア・タイプ。application/oracle.com.cloud.iaas.Zone

1

12.1.0.4

59.2.3 AssemblyInstance[application/oracle.com.cloud.common.AssemblyInstance+json]

application/oracle.com.cloud.common.ServiceInstanceを拡張します。

AssemblyInstanceは、アセンブリ・テンプレートのデプロイ・リクエストからのリソースの論理グループです。AssemblyInstanceのリソースのライフサイクルは、アセンブリ・インスタンスを介して一元的に管理できます。

注意:
アセンブリ・タイプのサービス・テンプレートはAssemblyInstanceにデプロイされます。

次の表で、AssemblyInstanceデータ・モデルについて説明します。

表59-4 AssemblyInstanceデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、アセンブリ・インスタンス定義のクライアント表現がリフレッシュされます。

1

12.1.0.2

name

文字列

ユーザーによって指定されたアセンブリ・インスタンスの名前。様々な言語をサポートするUNICODE文字列です。

1

12.1.0.2

description

文字列

ユーザーによって指定されたアセンブリ・インスタンスのユーザー用の説明。様々な言語をサポートするUNICODE文字列です。

0..1

12.1.0.2

based_on

URI

AssemblyInstanceが基にしているサービス・テンプレートのURI。

0..1

12.1.0.2

scalability_groups

コレクション<ScalabilityGroup>

このアセンブリ・インスタンスに含まれているスケーラビリティ・グループのリスト。

0..1

12.1.0.2

servers

コレクション<VM>

このアセンブリ・インスタンスに直接含まれているVMのリスト。

0..1

12.1.0.2

status

文字列

アセンブリ・インスタンスのステータスを示します。このフィールドには、サービス・プロバイダが実装するセマンティックが含まれます。たとえば、サービス・プロバイダはONLINEステータスを実装して、すべてのエンティティが再帰的にONLINEステータスであることを示します。または、サービス・プロバイダはONLINEステータスを実装して、重要なエンティティがONLINEステータスであることを示します。

0..1

12.1.0.2

resource_state

ResourceState

リソース状態がREADYの場合、アセンブリ・インスタンスの他のフィールドのGETに対する有効性が保証される必要があります。

そうでない場合、クライアントはフィールドの有効性を想定できません。

1

12.1.0.1

created

Timestamp

アセンブリ・インスタンスが作成された日付と時刻(ISO 8601形式)。

0..1

12.1.0.2

expiry

Timestamp

アセンブリ・インスタンスの期限が切れる日付と時刻(ISO 8601形式)。指定されない場合、アセンブリ・インスタンスは失効しません。

0..1

12.1.0.2

params

{}

このデプロイメントのベンダー固有の構成パラメータ。

0..1

12.1.0.2

deployment_plan

文字列

このAssemblyInstanceが基にしている対応するAssemblyTemplateからXML形式で規定された、このデプロイメントのベンダー固有の構成パラメータ。これがPOSTリクエストで指定されている場合、この属性のコンテンツが処理され、AssemblyInstanceをデプロイするためのパラメータが置き換えられます。

0..1

12.1.0.2

media_type

文字列

リソースのメディア・タイプ。

1

12.1.0.4

59.2.4 スケーラビリティ・グループ[application/oracle.com.cloud.common.ScalabilityGroup+json]

application/oracle.com.cloud.common.ServiceInstanceを拡張します。

スケーラビリティ・グループは、サーバーおよび対応する仮想ネットワークのコレクションです。スケーラビリティ・グループには、同種エンティティのコレクションが含まれます。クラウド・サービス・プロバイダは同じであることのセマンティックを強制する必要があります。同種のスケーラビリティ・グループのプロバイダによって、スケーラビリティ・グループのscale_outやscale_inなどの操作がサポートされます。

次の表で、ScalabilityGroupデータ・モデルについて説明します。

表59-5 ScalabilityGroupデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、スケーラビリティ・グループ定義のクライアント表現がリフレッシュされます。

1

12.1.0.2

name

文字列

ユーザーによって指定されたスケーラビリティ・グループの名前。様々な言語をサポートするUNICODE文字列です。

1

12.1.0.2

description

文字列

ユーザーによって指定されたスケーラビリティ・グループのユーザー用の説明。様々な言語をサポートするUNICODE文字列です。

0..1

12.1.0.2

nodes

コレクション<URI>

このスケーラビリティ・グループを構成するエンティティを表すURIのリスト。

1

12.1.0.2

count

整数

スケーラビリティ・グループ内にあるノードの数。

1

12.1.0.2

status

文字列

スケーラビリティ・グループのステータスを示します。このフィールドには、サービス・プロバイダが実装するベンダー依存セマンティックが含まれます。たとえば、サービス・プロバイダはONLINEステータスを実装して、すべてのエンティティが再帰的にONLINEステータスであることを示します。または、サービス・プロバイダはONLINEステータスを実装して、少なくとも1つのエンティティがONLINEステータスであることを示します。

0..1

12.1.0.2

resource_state

ResourceState

リソース状態がREADYの場合のみ、スケーラビリティ・グループの他のフィールドの有効性が保証されます。

それ以外の場合、クライアントはフィールドの有効性を想定できません。

1

12.1.0.2

created

Timestamp

スケーラビリティ・グループが作成された日付と時刻(ISO 8601形式)。

1

12.1.0.2

max

符号付き整数

このスケーラビリティ・グループが保持できる最大ノード数。指定されない場合、クライアントは無制限であると想定する必要があります(これは、値「-1」で指定されます)。

0..1

12.1.0.2

min

整数

機能スケーラビリティ・グループとみなされるためにこのスケーラビリティ・グループが保持する必要のある最小ノード数。指定されない場合、クライアントは1であると想定する必要があります。

0..1

12.1.0.2

homogenous

Boolean

スケーラビリティ・グループに同種エンティティが含まれる場合はTRUE、それ以外の場合はFALSE。

1

12.1.0.2

59.2.5 VM [application/oracle.com.cloud.common.VM+json]

application/oracle.com.cloud.common.ServiceInstanceを拡張します。

VMは、完全なOSスタックの実行をサポートする完全なシステム・プラットフォームを提供する計算コンテナです。次の表で、VMデータ・モデルについて説明します。

表59-6 VMデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、VM定義のクライアント表現がリフレッシュされます。

1

12.1.0.1

name

文字列

ユーザーによって指定された、またはプラットフォームで生成されたVMの名前。

1

12.1.0.1

description

文字列

ユーザーによって指定されたまたはプラットフォームで生成された、サーバーのユーザー用の説明。様々な言語をサポートするUNICODE文字列です。

0..1

12.1.0.1

status

文字列

このサーバーの現在の実行ステータス。サービス・プロバイダはこのフィールドの有効な値を上書きして、ステータス操作を実装できます。

1

12.1.0.1

based_on

URI

このサーバーが基にしているサービス・テンプレートのURI。

0..1

12.1.0.1

hostname

文字列

サーバーの修飾ホスト名(使用可能な場合)。

0..1

12.1.0.2

cpu

[Number,Number]

CPUの数値サイズ指定で、最初の数値はCPUコア数、2番目の数値はコア当たりのCPU速度(MHz)を示します。

1

12.1.0.1

memory

Number

RAMの数値サイズ指定(Mバイト)。

1

12.1.0.1

disks

{String,Number}[]

ローカル・ディスクの名前とサイズ(GB)。

0..1

12.1.0.2

interfaces

コレクション<NetworkInterface>

このサーバーに関連付けられているネットワーク・インタフェース。

1

12.1.0.2

params

{ }

このサーバーのベンダー固有の構成パラメータ。

0..1

12.1.0.1

resource_state

ResourceState

リソース状態がREADYの場合のみ、サーバーの他のフィールドの有効性が保証されます。

そうでない場合、クライアントはフィールドの有効性を想定できません。

1

12.1.0.1

created

Timestamp

サーバーが作成された日付と時刻(ISO 8601形式)。

1

12.1.0.1

type

文字列

この計算コンテナを表すサーバーのタイプ(PHYSICAL、VIRTUAL)。

1

12.1.0.1

os

文字列

サーバーのOS情報(必要な場合)。

0..1

12.1.0.1

media_type

文字列

リソースのメディア・タイプ。

1

12.1.0.4

saved_templates

コレクション<VMTemplate>

このVMリソースに基づいて作成されたVMTemplateのコレクション。

0..1

12.1.0.5

VMデータ・モデルのステータス・フィールドには、VMの実行ステータスを含める必要があります。サーバー・プロバイダは、少なくとも次の有効な値を実装する必要があります。

- STOPPED

- STOPPING

- STARTING

- STARTED

- SUSPENDED

- SUSPENDING

- RESUMING

- RESTARTING

- DELETED

59.2.6 VNet [application/oracle.com.cloud.common.VNet+json]

VNetは、ネットワーク・アドレス、ルーティング・ルール、セキュリティ制約、アクセス制限を提供するサービスです。

次の表で、VNetデータ・モデルについて説明します。

表59-7 VNetデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、VNet定義のクライアント表現がリフレッシュされます。

1

12.1.0.2

name

文字列

ユーザーによって指定された、またはプラットフォームで生成されたVNetの名前。様々な言語をサポートするUNICODE文字列です。

1

12.1.0.2

description

文字列

ユーザーによって指定されたまたはプラットフォームで生成された、VNetのユーザー用の説明。様々な言語をサポートするUNICODE文字列です。

0..1

12.1.0.2

created

Timestamp

VNetが作成された日付と時刻(ISO 8601形式)。

1

12.1.0.2

interfaces

コレクション<NetworkInterface>

VNetに含まれるNetworkInterfaceリソースのリスト。

0..1

12.1.0.2

59.2.7 NetworkInterface [application/oracle.com.cloud.common.NetworkInterface+json]

ネットワーク・インタフェースのインスタンスは、ネットワークのエンドポイントによって識別され、基礎となるネットワーク・インフラストラクチャで解釈可能な完全なアドレスで構成されます。

次の表で、NetworkInterfaceデータ・モデルについて説明します。

表59-8 NetworkInterfaceデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、NetworkInterface定義のクライアント表現がリフレッシュされます。

1

12.1.0.2

name

文字列

ユーザーによって指定された、またはプラットフォームで生成されたNetworkInterfaceの名前。様々な言語をサポートするUNICODE文字列です。

1

12.1.0.2

description

文字列

ユーザーによって指定されたまたはプラットフォームで生成された、NetworkInterfaceのユーザー用の説明。様々な言語をサポートするUNICODE文字列です。

0..1

12.1.0.2

address

文字列

このインタフェースのアドレス。IPベース・プロトコルの場合、ピリオド付きの表記規則のIPv4またはIPv6アドレスとして指定されます。

1

12.1.0.2

resource_state

ResourceState

リソース状態がREADYの場合のみ、NetworkInterfaceの他のフィールドの有効性が保証されます。そうでない場合、クライアントはフィールドの有効性を想定できません。

0..1

12.1.0.2

mac

文字列

ネットワーク・インタフェースのMACアドレス(必要な場合)。

0..1

12.1.0.2

59.2.8 VMTemplate [application/oracle.com.cloud.common.VMTemplate+json]

application/oracle.com.cloud.common.ServiceTemplateを拡張します。

VMTemplateはServiceTemplateのクラスです。VMTemplateのインスタンスでServiceTemplateメディア・タイプを受け入れることができます。VMTemplateは、VMリソースを認識する事前構成されたデプロイ可能なエンティティです。次の表で、VMTemplateデータ・モデルについて説明します。

表59-9 VMTemplateデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、このユーザーに対するVMTemplate定義のクライアント表現がリフレッシュされます。

1

12.1.0.1

name

文字列

VMTemplateのユーザー用の名前。

1

12.1.0.1

description

文字列

ServiceTemplateの簡単な説明。様々な言語をサポートするUNICODE文字列になります。

0..1

12.1.0.1

type

文字列

VMテンプレートのタイプを示す文字列。

値は「テンプレート」です。

1

12.1.0.1

created

Timestamp

VMTemplateが作成された日付と時刻(ISO 8601形式)。

1

12.1.0.1

service_family_type

文字列

このサービス・テンプレートを分類するサービス・ファミリ・タイプの名前。

値は「iaas」です。

0..1

12.1.0.4

default_instance_media_type

文字列

このテンプレートを使用して作成できるサービス・インスタンスのデフォルト・メディア・タイプ。

値は「application/oracle.com.cloud.common.VM」です。

0..1

12.1.0.4

resource_state

ResourceState

READY状態のサービス・テンプレートのみデプロイできます。

0..1

12.1.0.1

deployment_params

デプロイメント・パラメータのリスト

デプロイメント・パラメータのデータ構造のリストが含まれ、このテンプレートを使用してサービス・インスタンスのデプロイ時に指定できるパラメータを示します。

0..1

12.1.0.4

zones

ゾーンのリスト

このサービス・テンプレートを使用してサービス・インスタンスを作成できるゾーン・リソースのリストが含まれます。

0..1

12.1.0.2

service_instances

コレクション<?>

このテンプレートで作成されるサービス・インスタンスのリストが含まれます。

0..1

12.1.0.4

59.2.9 AssemblyTemplate [application/oracle.com.cloud.common.AssemblyTemplate+json]

application/oracle.com.cloud.common.ServiceTemplate+jsonを拡張します。

AssemblyTemplateはServiceTemplateのクラスです。AssemblyTemplateのインスタンスでServiceTemplateメディア・タイプを受け入れることができます。

AssemblyTemplateは、相互接続された複数のリソースを含むAssemblyInstanceリソースを認識するデプロイ可能なエンティティです。次の表で、AssemblyTemplateデータ・モデルについて説明します。

表59-10 AssemblyTemplateデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、このユーザーに対するAssemblyTemplate定義のクライアント表現がリフレッシュされます。

1

12.1.0.2

name

文字列

AssemblyTemplateのユーザー用の名前。

1

12.1.0.2

description

文字列

AssemblyTemplateの簡単な説明。様々な言語をサポートするUNICODE文字列になります。

0..1

12.1.0.2

type

文字列

アセンブリ・テンプレートのタイプを示す文字列。

値は「アセンブリ」です。

1

12.1.0.2

created

Timestamp

AssemblyTemplateが作成された日付と時刻(ISO 8601形式)。

1

12.1.0.2

service_family_type

文字列

このサービス・テンプレートを分類するサービス・ファミリ・タイプの名前。

値は「iaas」です。

0..1

12.1.0.4

default_instance_media_type

文字列

このテンプレートを使用して作成できるサービス・インスタンスのデフォルト・メディア・タイプ。

値は「application/oracle.com.cloud.common.AssemblyInstance」です。

0..1

12.1.0.4

resource_state

ResourceState

READY状態のサービス・テンプレートのみデプロイできます。

0..1

12.1.0.1

deployment_params

デプロイメント・パラメータのリスト

デプロイメント・パラメータのデータ構造のリストが含まれ、このテンプレートを使用してサービス・インスタンスのデプロイ時に指定できるパラメータを示します。

0..1

12.1.0.4

zones

ゾーンのリスト

このサービス・テンプレートを使用してサービス・インスタンスを作成できるゾーン・リソースのリストが含まれます。

0..1

12.1.0.2

service_instances

コレクション<?>

このテンプレートで作成されるサービス・インスタンスのリストが含まれます。

0..1

12.1.0.4

definition

文字列

アセンブリ・テンプレートの定義が含まれます。これは、アセンブリ・テンプレートを表すOVF xmlメタデータです。

0..1

12.1.0.1

ovfdescriptor

文字列

definitionと同じです。

0..1

12.1.0.1

deploy_plans

デプロイ・プランのリスト

アセンブリ・インスタンスに関連付けられているデプロイ・プランのリストが含まれます。デプロイ・プランは、事前入力された構成メタデータです。

0..1

12.1.0.2

次の表に、デプロイ・プランの構造を示します。

表59-11 デプロイ・プランの構造

フィールド

タイプ

説明

発生

name

文字列

デプロイ・プランの名前。

1

description

文字列

デプロイ・プランの説明。

0..1

xml

文字列

デプロイ・プランXML。

1

59.2.10 IaasServiceFamilyType [application/oracle.com.cloud.iaas.IaasServiceFamilyType+json]

application/oracle.com.cloud.common.ServiceFamilyType+jsonを拡張します。

インフラストラクチャ・サービス・ファミリ・タイプでは、共通サービス・ファミリ・タイプ属性とインフラストラクチャ固有の属性について記述します。次の表に、IaaSファミリ・タイプ・データ・モデルを示します。

表59-12 AssemblyTemplateデータ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、このユーザーに対するServiceFamilyType定義のクライアント表現がリフレッシュされます。

1

12.1.0.4

name

文字列

ServiceFamilyTypeのユーザー用の名前。

1

12.1.0.4

description

文字列

サービス・ファミリ・タイプのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。

0..1

12.1.0.4

resource_state

ResourceState

リソースのリソース状態。

0..1

12.1.0.4

media_type

文字列

リソースのメディア・タイプ。

1

12.1.0.4

service_templates

コレクション<ServiceTemplate>

このサービス・ファミリ・タイプのサービス・テンプレートのコレクション。

0..1

12.1.0.4

zones

コレクション<Zone>

このサービス・ファミリ・タイプのサービス・インスタンスをサポートするゾーンのコレクション。

0..1

12.1.0.4

instance_types

コレクション<InstanceType>

このサービス・ファミリ・タイプによってサポートされるインスタンス・タイプのコレクション。

0..1

12.1.0.4

quota_usages

コレクション<QuotaUsage>

認証済ユーザーのパースペクティブ・ファミリ・タイプの割当て制限使用量のコレクション。

0..1

12.1.0.5

quota_def

Jsonオブジェクト

ファミリ・タイプ固有の割当て制限メタデータ情報で、いくつかの権限情報が含まれることがあります。

このオブジェクトの構造は、パースペクティブ・ファミリ・タイプ・リソース・モデルで文書化されます。

0..1

12.1.0.5

instance_options

VMサイズ・オプションのリスト

認証済ユーザーに使用できるVMサイズ・オプションのリスト。

0..1

12.1.0.4

次の表に、VMサイズ・オプションの構造を示します。

表59-13 VMサイズ・オプションの構造

フィールド

タイプ

説明

発生

サポート開始リリース

name

文字列

VMサイズの名前。これは、VMリソース作成のパラメータとして使用される場合があります。

1

12.1.0.4

id

文字列

VMサイズのID。

1

12.1.0.4

cpu

Number

CPUの容量。

1

12.1.0.4

memory

Number

メモリーの容量(MB)。

1

12.1.0.4

local_storage

Number

ローカル記憶域の容量(GB)。

1

12.1.0.4

IaaSは、次の割当て制限使用量をサポートします。

表59-14 IaaSの割当て制限使用量

割当て

説明

サポート開始リリース

CPU

CPUの数(離散的単位)

12.1.0.5

RAM

メモリー・サイズ(MB)

12.1.0.5

ローカル記憶域

サーバーに対してローカルな記憶域の容量(GB)。

12.1.0.5

追加の記憶域

サーバーに対して外部の記憶域の容量(GB)。

12.1.0.5

SWLIB記憶域

Enterprise Managerソフトウェア・ライブラリの記憶域の容量。

12.1.0.5

サーバー

サーバーの数(離散的単位)。

12.1.0.5

IaaS割当て定義については、メディア・タイプapplication/oracle.com.cloud.iaas.Quotaで説明されています。

59.2.11 Iaas割当て定義[application/oracle.com.cloud.iaas.Quota+json]

このリソースでは、Iaas割当ての定義を記述します。次の表に、IaaS割当て定義データ・モデルを示します。

表59-15 IaaS割当て定義データ・モデル

フィールド

タイプ

説明

発生

サポート開始リリース

uri

URI

このURIに対してGETを実行すると、このユーザーに対するIaas割当て定義のクライアント表現がリフレッシュされます。

1

12.1.0.5

allowedSaveAsTemplate

Boolean

認証済ユーザーがVMをテンプレートとして保存する権限を持つかどうかを示します。

1

12.1.0.5

allowedSaveToSwlib

Boolean

認証済ユーザーがEnterprise Managerソフトウェア・ライブラリにエンティティを保存する権限を持つかどうかを示します。

1

12.1.0.5

allowedSaveToSwlibOnExpiry

Boolean

VMの期限が切れる際に、認証済ユーザーがEnterprise Managerソフトウェア・ライブラリにVMをテンプレートとして保存する権限を持つかどうかを示します。

1

12.1.0.5

resourceQuotas

コレクション<ResourceQuota>

認証済ユーザーに定義されたリソースの割当て。

1

12.1.0.5

次に、リソース割当ての構造を示します。

表59-16 リソース割当ての構造

フィールド

タイプ

説明

発生

サポート開始リリース

name

文字列

リソースの名前。

1

12.1.0.5

description

文字列

リソースの説明。

0..1

12.1.0.5

maxAllowed

Number

認証済リソースが割り当てられるユニットの最大数。この値が負であるか、または定義されていない場合、ユーザーが使用できる容量は制限されません。

0..1

12.1.0.5

unit

文字列

リソースの測定単位。

1

12.1.0.5

59.3 Infrastructure as a Service REST APIの例

次の各項では、IaaS REST APIでサポートされる様々な操作の例を示します。

- サービス・インスタンスの作成

- VMの作成

- VMを配置するIaaSゾーンにPOST

- VMのベースになるVMテンプレートにPOST

- VM作成ステータスの詳細の表示

- アセンブリ・インスタンスの作成

- VMサービス・インスタンスの更新

- VMステータスの変更

- VMサイズの変更

- VMディスクの追加

- サービス・インスタンスの削除

- サービス・インスタンスのリスト

- サービス・テンプレートの検索

59.3.1 サービス・インスタンスの作成

この項では、クラウド・リソースを使用してサービス・インスタンスを作成する方法について説明します。

59.3.1.1 VMの作成

VMはサービス・ファミリ・タイプ"iaas"のサービス・インスタンスであるため、VMを作成する同じファミリ・タイプのゾーンを指定する必要があります。VMを作成する方法は2つあります。

1. VMを配置するIaaSゾーンにPOST

2. VMのベースになるVMテンプレートにPOST

POSTで送信した本文の属性を書き留めます。パターンは、他のサーバー・インスタンスの作成と同じです。意図が明確であるため、"zone"ゾーンにPOSTするときに"zone"属性は不要です。同様に、VMTemplateにPOSTするときに"based_on"属性は不要です。

59.3.1.1.1 VMを配置するIaaSゾーンにPOST

次に、IaasゾーンにPOSTするための構成を示します。

表59-17 IaaSゾーンへのリクエスト渡しによってVMを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"based_on":"/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1",
"cpu" : [2,0],
"memory" : "512",
"params":{
"server_prefix":"ZONEPOST",
"vnc_password":"welcome1",
"root_password":"welcome1"
}
}

リクエスト・メソッド

POST

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

前述の相互作用から返されるレスポンスのサンプルを次に示します。

{
"uri" : "/em/cloud/iaas/server/byrequest/102" ,
"name" : "VDOSI VM Creation 1345392541850" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"text" : "The Request with ID '102' is scheduled with Job Id 'C79997609390CB9BE040578CDA817D96'" ,
"date" : "2012-08-19T16:09:02+0000"
}
]
} ,
"context_id" : "102" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"service_family_type" : "iaas" ,
"created" : "2012-08-19T16:09:02+0000"
}

59.3.1.1.2 VMのベースになるVMテンプレートにPOST

次に、VMTemplateにPOSTするための構成を示します。

表59-18 VMテンプレートへのリクエスト渡しによってVMを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"zone":"/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D",  "cpu" : [2,0],  "memory" : "512",  "params":{    "server_prefix":"STPOST",    "vnc_password":"welcome1",    "root_password":"welcome1"  }}

リクエスト・メソッド

POST

サポート開始リリース

12.1.0.4 Cloud Service Portalプラグイン

前述の相互作用から返されるレスポンスのサンプルを次に示します。

{
"uri" : "/em/cloud/iaas/server/byrequest/101" ,
"name" : "VDOSI VM Creation 1345391921407" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"text" : "The Request with ID '101' is scheduled with Job Id 'C7999760937CCB9BE040578CDA817D96'" ,
"date" : "2012-08-19T15:58:47+0000"
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"service_family_type" : "iaas" ,
"created" : "2012-08-19T15:58:42+0000"
}

このレスポンスは、前のバージョンと同じです。

ゾーンが指定されていない場合、WebサービスはVMをデプロイする場所を特定できません。次の相互作用はそのような状況を示しています。

表59-19 ゾーンを指定せずVMテンプレートへのリクエスト渡しによってVMを作成するためのPOSTリクエスト構成

機能

説明

URL

https://example.com/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"cpu" : [2,0],
"memory" : "512",
"params":{
"server_prefix":"STPOST",
"vnc_password":"welcome1",
"root_password":"welcome1"
}
}

リクエスト・メソッド

POST

次に、Webサービスからのレスポンスを示します。

{
"messages" :
[
{
"hint" : "'zone' attribute needs to be specified to complete 'POST' request for 'application/oracle.com.cloud.common.VM' resource" ,
"stack_trace" : "oracle.sysman.emInternalSDK.ssa.cloudapi.rest.RestServletException: 'zone' attribute needs to be specified to complete 'POST' request for 'application/oracle.com.cloud.common.VM' resource\n\tat oracle.sysman.ssa.cloudapi.iaas.VMRequest.GenerateVMFromDeployment(VMRequest.java:149)\n\tat oracle.sysman.ssa.cloudapi.iaas.VMTemplate.processRequest(VMTemplate.java:93)\n\tat oracle.sysman.ssa.cloudapi.iaas.IaasServiceProvider.processRequest(IaasServiceProvider.java:582)\n\tat oracle.sysman.emInternalSDK.ssa.cloudapi.EMCloudServlet.perform(EMCloudServlet.java:236)\n\tat oracle.sysman.emInternalSDK.ssa.cloudapi.EMCloudServlet.performPost(EMCloudServlet.java:385)\n\tat oracle.sysman.emInternalSDK.ssa.cloudapi.rest.AbstractRestServlet.doPost(AbstractRestServlet.java:137)\n\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:727)\n\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:820)\n\tat weblogic.servlet.internal.StubSecurityHelper$ServletServiceAction.run(StubSecurityHelper.java:227)\n\tat webl" ,
"text" : "Did not successfully execute 'POST' resource operation on 'application/oracle.com.cloud.common.Cloud' identified by '/em/cloud/iaas/servicetemplate/vm/oracle:defaultService:em:provisioning:1:cmp:Virtualization:Template:C76CEB5563EA5E13E040578CDA817FAF:0.1'" ,
"date" : "2012-08-19T16:02:51+0000"
}
]
}

59.3.1.2 VM作成ステータスの詳細の表示

VMを作成するためにPOSTリクエストを渡した後で、戻りURIによって特定されるリソースに対してGETリクエストを発行し、VM作成ステータスを追跡することができます。VM作成の詳細を表示するためのサンプルのGETリクエスト構成は、次の表を参照してください。

表59-20 VM作成ステータスの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/byrequest/101

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/iaas/server/byrequest/101" ,
"name" : "VDOSI VM Creation 1345391921407" ,
"resource_state" :     {
"state" : "CREATING" ,
"messages" :
[
{
"text" : "The Request with ID '101' is being processed, and has Job Id 'C7999760937CCB9BE040578CDA817D96'" ,
"date" : "2012-08-19T16:14:11+0000"
}
]
} ,
"context_id" : "101" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"service_family_type" : "iaas" ,
"created" : "2012-08-19T15:58:42+0000"
}

resource_state属性はCREATING状態であり、VMがまだ作成中であることを示しています。VMが作成されると、次に示すように、同じGETは"READY"状態のVMリソースを返します。

{
"uri" : "/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095" ,
"name" : "STPOST" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "C5CA59AF9386975E8AEA45B0F040F095" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"metrics" :     {
"media_type" : "application/oracle.com.cloud.common.Metric+json" ,
"total" : "4" ,
"elements" :
[
{
"uri" : "/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3AC5CA59AF9386975E8AEA45B0F040F095" ,
"name" : "CPU_Utilization" ,
"media_type" : "application/oracle.com.cloud.common.Metric+json" ,
"type" : "NUMBER" ,
"current_value" : "" ,
"current_time" : "2012-08-19T16:17:02+0000"
} ,
{
"uri" : "/em/cloud/metric/iaas%3Avm%3ATotal_Network_Throughput%3AC5CA59AF9386975E8AEA45B0F040F095" ,
"name" : "Total_Network_Throughput" ,
"media_type" : "application/oracle.com.cloud.common.Metric+json" ,
"type" : "NUMBER" ,
"current_value" : "" ,
"current_time" : "2012-08-19T16:17:02+0000"
} ,
{
"uri" : "/em/cloud/metric/iaas%3Avm%3ATotal_Disk_Throughput%3AC5CA59AF9386975E8AEA45B0F040F095" ,
"name" : "Total_Disk_Throughput" ,
"media_type" : "application/oracle.com.cloud.common.Metric+json" ,
"type" : "NUMBER" ,
"current_value" : "" ,
"current_time" : "2012-08-19T16:17:02+0000"
} ,
{
"uri" : "/em/cloud/metric/iaas%3Avm%3AFilesystem_Total_Used%3AC5CA59AF9386975E8AEA45B0F040F095" ,
"name" : "Filesystem_Total_Used" ,
"media_type" : "application/oracle.com.cloud.common.Metric+json" ,
"type" : "NUMBER" ,
"current_value" : "" ,
"current_time" : "2012-08-19T16:17:02+0000"
}
]
} ,
"service_family_type" : "iaas" ,
"status" : "STARTED" ,
"created" : "2012-08-19T16:15:21+0000" ,
"hostname" : "dadvfm0052.xyxy.example.com" ,
"cpu" :
[
"2" ,
"0"
] ,
"memory" : "512" ,
"disks" :
[
[
"default_disk" ,
"10240"
] ,
[
"7e8a5d25-7995-40c9-9b16-9274cc2d64f3.img (2)" ,
"6918"
] ,
[
"fcaf377c-ed3e-4823-a9b3-6b4d2289e215.img (2)" ,
"192"
] ,
[
"f5dba62c-eb49-40c6-af0b-06187b2b9856.img (2)" ,
"5120"
]
] ,
"interfaces" :     {
"media_type" : "application/oracle.com.cloud.common.NetworkInterface+json" ,
"total" : "1" ,
"elements" :
[
{
"name" : "cloud_network" ,
"address" : "10.229.136.185" ,
"mac" : "00:21:f6:5f:73:33"
}
]
} ,
"os" : "None" ,
"type" : "VIRTUAL"
}

59.3.1.3 アセンブリ・インスタンスの作成

VMの作成と同様に、アセンブリ・インスタンスの作成でもゾーンとAssemblyTemplateの両方にPOSTできます。

アセンブリ・インスタンス・リソースの詳細を表示するGETリクエスト構成を次に示します。

表59-21 アセンブリ・インスタンス・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

サポート開始リリース

12.1.0.4 Cloud Service Portalプラグイン

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1" ,
"name" : "sidb_assembly" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C75E88B04D7FEDEDE040578CDA810E49:0.1" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly" ,
"created" : "2012-08-16T11:02:38+0000" ,
"default_instance_media_type" : "application/oracle.com.cloud.common.AssemblyInstance+json" ,
"zones" :     {
"media_type" : "application/oracle.com.cloud.iaas.Zone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" ,
"name" : "cloud_zone" ,
"media_type" : "application/oracle.com.cloud.iaas.Zone+json" ,
"service_family_type" : "iaas" ,
"type" : "VM_ZONE"
}
]
} ,
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "0" ,
"elements" :
[      ]
} ,
"deployment_params" :
[
{
"name" : "zone" ,
"description" : "'zone' attribute is the URI of the zone that the 'application/oracle.com.cloud.common.AssemblyInstance' resource is to be created in" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "based_on" ,
"description" : "'based_on' attribute is the URI of the service template or format String of the originated source which the deployed 'application/oracle.com.cloud.common.AssemblyInstance' resource is to be followed" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
} ,
{
"name" : "deployment_plan" ,
"description" : "'deployment_plan' attribute describes the configuration of which the deployed 'application/oracle.com.cloud.common.AssemblyInstance' resource is to be used in the XML deployment plan format" ,
"type" : "STRING" ,
"require" : "false" ,
"sensitive" : "false"
}
] ,
"directory" : "COMP_Components" ,
"updated" : "2012-08-16T11:02:38+0000" ,
"creator" : "DMBHAT1" ,
"last_modified_by" : "DMBHAT1" ,
"componenttype" : "Virtualization" ,
"oracle_owned" : "false" ,
"deploy_plans" :
[
{
"name" : "cloud_zone" ,
"description" : "Default Assembly Deployment Plan for Service Template 'sidb_assembly' on Zone 'cloud_zone'" ,
"context_id" : "D73AF0D42C8459E11419862797D1F37D" ,
"xml" : "<?xml version=\"1.0\" encoding=\"UTF-8\"
standalone=\"yes\"?>\n<ns2:ConfigurationData
xmlns:ns2=\"http://www.oracle.com/sysman/vt/RequestConfigData\">\n
<AssemblyDeployment assemblyInstanceName=\"DEFAULT_PLEASE_CHANGE\">\n
<SourceBinary type=\"TYPE_SWLIB\"
name=\"oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C75E88B04D7FEDEDE040578CDA810E49:0.1\"/>\n
<DeploymentTarget type=\"oracle_vm_zone\"
name=\"D73AF0D42C8459E11419862797D1F37D\"/>\n
<AcceptedAllEULAs>false</AcceptedAllEULAs>\n
<InstallEMAgent>false</InstallEMAgent>\n
<DisableCleanup>false</DisableCleanup>\n
<EMAgentConfig installUserPassword=\"  \" installUserName=\"oracle\"/>\n
<AssemblyNetworkConfig>\n
<AssemblyNetwork name=\"network-1\"/>\n
</AssemblyNetworkConfig>\n
<VirtualSystemCollectionConfig id=\"sidbasmA_linuxx64_11203psu1\">\n
<ProductConfiguration>\n
<Product>\n
<Properties/>\n
<EMAgent>false</EMAgent>\n<
/Product>\n
</ProductConfiguration>\n
<VirtualSystemConfig agentPushInstallationEnabled=\"true\"agentInstallationType=\"Push Agent Installation\" vmInstance=\"true\" targetName=\"sidbasmA_linuxx64_11203psu1/sidbasm:%assembly_instance_name%\" id=\"sidbasmA_linuxx64_11203psu1/sidbasm\">\n
<ProductConfiguration>\n
<Product>\n
<Properties>\n
<Property id=\"ocm.runConfiguration\">\n<Name>ocm.runConfiguration</Name>\n<Required>false</Required>\n<Value>false</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"ocm.metalinkCsiRegistration.CSI\">\n<Name>ocm.metalinkCsiRegistration.CSI</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n
<Property id=\"ocm.metalinkCsiRegistration.metalinkId\">\n<Name>ocm.metalinkCsiRegistration.metalinkId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n<
Property id=\"ocm.proxyPassword\">\n<Name>ocm.proxyPassword</Name>\n<Required>false</Required>\n<Value>  </Value>\n<Secret>true</Secret>\n
</Property>\n  <Property id=\"ocm.metalinkCsiRegistration.countryCode\">\n<Name>ocm.metalinkCsiRegistration.countryCode</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_7|size-units\">\n<Name>system-fileset|db_asm_disk_7|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_1|size-units\">\n<Name>system-fileset|db_asm_disk_1|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_3|size-units\">\n<Name>system-fileset|db_asm_disk_3|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_0|size\">\n<Name>system-fileset|db_asm_disk_0|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_1|size\">\n<Name>system-fileset|db_asm_disk_1|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"asm-password\">\n<Name>asm-password</Name>\n<Required>true</Required>\n<Value>  </Value>\n<Secret>true</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_7|size\">\n<Name>system-fileset|db_asm_disk_7|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"ocm.metalinkEmailRegistration.metalinkEmailId\">\n<Name>ocm.metalinkEmailRegistration.metalinkEmailId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"input|listener-1|global-db-name\">\n<Name>input|listener-1|global-db-name</Name>\n<Required>false</Required>\n<Value>orcl.us.example.com</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_4|size-units\">\n<Name>system-fileset|db_asm_disk_4|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"ocm.proxyHost\">\n<Name>ocm.proxyHost</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"ocm.repeaterURI\">\n<Name>ocm.repeaterURI</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_2|size-units\">\n<Name>system-fileset|db_asm_disk_2|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"input|listener-1|port\">\n<Name>input|listener-1|port</Name>\n<Required>false</Required>\n<Value>1521</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"ocm.anonymousEmailRegistration.emailId\">\n<Name>ocm.anonymousEmailRegistration.emailId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"db-account-password\">\n<Name>db-account-password</Name>\n<Required>true</Required>\n<Value>  </Value>\n<Secret>true</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_3|size\">\n<Name>system-fileset|db_asm_disk_3|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_2|size\">\n<Name>system-fileset|db_asm_disk_2|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"ocm.proxyPort\">\n<Name>ocm.proxyPort</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"ocm.proxyUsername\">\n<Name>ocm.proxyUsername</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_6|size\">\n<Name>system-fileset|db_asm_disk_6|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_5|size\">\n<Name>system-fileset|db_asm_disk_5|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_4|size\">\n<Name>system-fileset|db_asm_disk_4|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"ocm.metalinkEmailRegistration.metalinkPassword\">\n<Name>ocm.metalinkEmailRegistration.metalinkPassword</Name>\n<Required>false</Required>\n<Value>  </Value>\n<Secret>true</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_6|size-units\">\n<Name>system-fileset|db_asm_disk_6|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_5|size-units\">\n<Name>system-fileset|db_asm_disk_5|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n                            <Property id=\"system-fileset|db_asm_disk_0|size-units\">\n<Name>system-fileset|db_asm_disk_0|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
</Properties>\n <EMAgent>false</EMAgent>\n
</Product>\n                </ProductConfiguration>\n                <HardwareConfiguration>\n
<Memory>2048</Memory>\n
<VCPUs>1</VCPUs>\n
<HaEnabled>false</HaEnabled>\n
<StartAfterCreation>true</StartAfterCreation>\n
<CPUSchedulingPriority>50</CPUSchedulingPriority>\n
<CPUCap>100</CPUCap>\n                    <LocalDisks>\n
<disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_System\">\n
<Size>5122</Size>\n
<Mode>Read-Write</Mode>\n
<CreatedByVmSize>false</CreatedByVmSize>\n
</disk>\n                        <disk fromDefinition=\"true\" name=\"AB\">\n
<Size>0</Size>\n                            <Mode>Read-Write</Mode>\n
<CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n
<disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-asm_base\">\n
<Size>502</Size>\n                            <Mode>Read-Write</Mode>\n
<CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n
<disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-asm_home\">\n
<Size>10307</Size>\n                            <Mode>Read-Write</Mode>\n
<CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n
<disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-db_base\">\n
<Size>502</Size>\n                            <Mode>Read-Write</Mode>\n
<CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n
<disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-db_home\">\n
<Size>9068</Size>\n                            <Mode>Read-Write</Mode>\n
<CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n
</LocalDisks>\n                    <SharedDisks>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_0\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_1\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_2\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_3\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_4\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_5\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_6\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_7\"/>\n
</SharedDisks>\n                    <Nics>\n
<NetworkInterface fromDefinition=\"true\" name=\"eth0\">\n
<IPAssignmentMode>Dhcp</IPAssignmentMode>\n
<QoS>Any_Network_QoS_Type</QoS>\n
<AssemblyNetwork name=\"network-1\"/>\n
</NetworkInterface>\n                    </Nics>\n
<RootPassword>  </RootPassword>\n
<LogLocation>/assemblybuilder/logs</LogLocation>\n
<VmSize>Custom</VmSize>\n
<NetworkConfigurationTimeout>60</NetworkConfigurationTimeout>\n
<ProductConfigurationTimeout>60</ProductConfigurationTimeout>\n
</HardwareConfiguration>\n            </VirtualSystemConfig>\n
</VirtualSystemCollectionConfig>\n
</AssemblyDeployment>\n</ns2:ConfigurationData>\n"
} ,
{
"uri" : "/em/cloud/iaas/servicetemplate/deploymentplan/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ADeployment+Plan%3AC7790791F0831736E040578CDA815673%3A0.1" ,
"name" : "sidb_deployplan" ,
"media_type" : "application/oracle.com.cloud.iaas.DeploymentPlan+json" ,
"type" : "Deployment Plan"
}
]
}

"deploy_plans"属性には、このサービス・テンプレートのユーザーがアクセス可能な、各ゾーンのデフォルトのデプロイ・プランと事前構成されたデプロイ・プランの両方が含まれます。アセンブリ・インスタンスを作成するには、デプロイ・プランを使用する必要があります。

"params"で指定された構成がプライマリ構成です。デプロイ・プランを使用して、詳細な製品構成およびリソース構成を示すこともできます。"<Required>true</Required>"の製品構成も、製品構成値を取得するために更新する必要があります。

次の表に、アセンブリ・インスタンスを作成するPOSTリクエストの例を示します。

表59-22 アセンブリ・インスタンスを作成するためのPOSTリクエスト構成

機能

説明

URL

/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.AssemblyInstance+json

本文

{
"zone":"/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D",
"params":{
"vnc_password":"welcome1",
"root_password":"welcome1",
"assembly_instance_name": "AITEST"
},
"deployment_plan":"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<ns2:ConfigurationData xmlns:ns2\"http://www.oracle.com/sysman/vt/RequestConfigData\">\n
<AssemblyDeployment assemblyInstanceName=\"DEFAULT_PLEASE_CHANGE\">\n
<SourceBinary type=\"TYPE_SWLIB\" name=\"oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C75E88B04D7FEDEDE040578CDA810E49:0.1\"/>\n       <DeploymentTarget type=\"oracle_vm_zone\" name=\"D73AF0D42C8459E11419862797D1F37D\"/>\n
<AcceptedAllEULAs>false</AcceptedAllEULAs>\n
<InstallEMAgent>false</InstallEMAgent>\n
<DisableCleanup>false</DisableCleanup>\n
<EMAgentConfig installUserPassword=\"  \" installUserName=\"oracle\"/>\n
<AssemblyNetworkConfig>\n
<AssemblyNetwork name=\"network-1\"/>\n
</AssemblyNetworkConfig>\n
<VirtualSystemCollectionConfig id=\"sidbasmA_linuxx64_11203psu1\">\n
<ProductConfiguration>\n
<Product>\n
<Properties/>\n
<EMAgent>false</EMAgent>\n
</Product>\n
</ProductConfiguration>\n
<VirtualSystemConfig agentPushInstallationEnabled=\"true\" agentInstallationType=\"Push Agent Installation\" vmInstance=\"true\" targetName=\"sidbasmA_linuxx64_11203psu1/sidbasm:%assembly_instance_name%\" id=\"sidbasmA_linuxx64_11203psu1/sidbasm\">\n
<ProductConfiguration>\n
<Product>\n
<Properties>\n
<Property id=\"ocm.runConfiguration\">\n<Name>ocm.runConfiguration</Name>\n<Required>false</Required>\n<Value>false</Value>\n<Secret>false</Secret>\n         </Property>\n
<Property id=\"ocm.metalinkCsiRegistration.CSI\">\n<Name>ocm.metalinkCsiRegistration.CSI</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"ocm.metalinkCsiRegistration.metalinkId\">\n<Name>ocm.metalinkCsiRegistration.metalinkId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"ocm.proxyPassword\">\n<Name>ocm.proxyPassword</Name>\n<Required>false</Required>\n<Value>
</Value>\n<Secret>true</Secret>\n
</Property>\n
<Property id=\"ocm.metalinkCsiRegistration.countryCode\">\n<Name>ocm.metalinkCsiRegistration.countryCode</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_7|size-units\">\n<Name>system-fileset|db_asm_disk_7|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_1|size-units\">\n<Name>system-fileset|db_asm_disk_1|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_3|size-units\">\n<Name>system-fileset|db_asm_disk_3|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_0|size\">\n<Name>system-fileset|db_asm_disk_0|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_1|size\">\n<Name>system-fileset|db_asm_disk_1|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"asm-password\">\n<Name>asm-password</Name>\n<Required>true</Required>\n<Value>welcome1</Value>\n<Secret>true</Secret>\n                        </Property>\n
<Property id=\"system-fileset|db_asm_disk_7|size\">\n<Name>system-fileset|db_asm_disk_7|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"ocm.metalinkEmailRegistration.metalinkEmailId\">\n<Name>ocm.metalinkEmailRegistration.metalinkEmailId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"input|listener-1|global-db-name\">\n<Name>input|listener-1|global-db-name</Name>\n<Required>false</Required>\n<Value>orcl.us.example.com</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_4|size-units\">\n<Name>system-fileset|db_asm_disk_4|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"ocm.proxyHost\">\n<Name>ocm.proxyHost</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n
<Property id=\"ocm.repeaterURI\">\n<Name>ocm.repeaterURI</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                        </Property>\n
<Property id=\"system-fileset|db_asm_disk_2|size-units\">\n<Name>system-fileset|db_asm_disk_2|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"input|listener-1|port\">\n<Name>input|listener-1|port</Name>\n<Required>false</Required>\n<Value>1521</Value>\n<Secret>false</Secret>\n        </Property>\n
<Property id=\"ocm.anonymousEmailRegistration.emailId\">\n<Name>ocm.anonymousEmailRegistration.emailId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"db-account-password\">\n<Name>db-account-password</Name>\n<Required>true</Required>\n<Value>welcome1</Value>\n<Secret>true</Secret>\n          </Property>\n
<Property id=\"system-fileset|db_asm_disk_3|size\">\n<Name>system-fileset|db_asm_disk_3|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_2|size\">\n<Name>system-fileset|db_asm_disk_2|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"ocm.proxyPort\">\n<Name>ocm.proxyPort</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n
<Property id=\"ocm.proxyUsername\">\n<Name>ocm.proxyUsername</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                    </Property>\n
<Property id=\"system-fileset|db_asm_disk_6|size\">\n<Name>system-fileset|db_asm_disk_6|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_5|size\">\n<Name>system-fileset|db_asm_disk_5|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_4|size\">\n<Name>system-fileset|db_asm_disk_4|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"ocm.metalinkEmailRegistration.metalinkPassword\">\n<Name>ocm.metalinkEmailRegistration.metalinkPassword</Name>\n<Required>false</Required>\n<Value>
</Value>\n<Secret>true</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_6|size-units\">\n<Name>system-fileset|db_asm_disk_6|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_5|size-units\">\n<Name>system-fileset|db_asm_disk_5|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
<Property id=\"system-fileset|db_asm_disk_0|size-units\">\n<Name>system-fileset|db_asm_disk_0|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n
</Property>\n
</Properties>\n
<EMAgent>false</EMAgent>\n
</Product>\n
</ProductConfiguration>\n
<HardwareConfiguration>\n
<Memory>2048</Memory>\n
<VCPUs>1</VCPUs>\n
<HaEnabled>false</HaEnabled>\n
<StartAfterCreation>true</StartAfterCreation>\n
<CPUSchedulingPriority>50</CPUSchedulingPriority>\n
<CPUCap>100</CPUCap>\n
<LocalDisks>\n
<disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_System\">\n
<Size>5122</Size>\n
<Mode>Read-Write</Mode>\n
<CreatedByVmSize>false</CreatedByVmSize>\n
</disk>\n
<disk fromDefinition=\"true\" name=\"AB\">\n <Size>0</Size>\n
<Mode>Read-Write</Mode>\n <CreatedByVmSize>false</CreatedByVmSize>\n
</disk>\n <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-asm_base\">\n <Size>502</Size>\n
<Mode>Read-Write</Mode>\n <CreatedByVmSize>false</CreatedByVmSize>\n
</disk>\n <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-asm_home\">\n <Size>10307</Size>\n
<Mode>Read-Write</Mode>\n <CreatedByVmSize>false</CreatedByVmSize>\n
</disk>\n <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-db_base\">\n <Size>502</Size>\n
<Mode>Read-Write</Mode>\n <CreatedByVmSize>false</CreatedByVmSize>\n
</disk>\n <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-db_home\">\n <Size>9068</Size>\n
<Mode>Read-Write</Mode>\n <CreatedByVmSize>false</CreatedByVmSize>\n
</disk>\n </LocalDisks>\n
<SharedDisks>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_0\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_1\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_2\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_3\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_4\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_5\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_6\"/>\n
<SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_7\"/>\n
</SharedDisks>\n
<Nics>\n
<NetworkInterface fromDefinition=\"true\" name=\"eth0\">\n
<IPAssignmentMode>Dhcp</IPAssignmentMode>\n
<QoS>Any_Network_QoS_Type</QoS>\n
<AssemblyNetwork name=\"network-1\"/>\n
</NetworkInterface>\n
</Nics>\n
<RootPassword>
</RootPassword>\n
<LogLocation>/assemblybuilder/logs</LogLocation>\n
<VmSize>Custom</VmSize>\n
<NetworkConfigurationTimeout>60</NetworkConfigurationTimeout>\n
<ProductConfigurationTimeout>60</ProductConfigurationTimeout>\n
</HardwareConfiguration>\n
</VirtualSystemConfig>\n
</VirtualSystemCollectionConfig>\n
</AssemblyDeployment>\n</ns2:ConfigurationData>\n"
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/iaas/assemblyrequest/223" ,
"name" : "VDOSI Assembly Creation 1345575147280" ,
"resource_state" :     {
"state" : "INITIATED" ,
"messages" :
[
{
"text" : "The Request with ID '223' is scheduled with Job Id 'C7CB0EBE83C22D70E040578CDA812E66'" ,
"date" : "2012-08-21T18:52:31+0000"
}
]
} ,
"context_id" : "223" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyInstance+json" ,
"service_family_type" : "iaas" ,
"status" : "SCHEDULED" ,
"created" : "2012-08-21T18:52:28+0000"
}

アセンブリ・インスタンス作成のステータスを追跡するには、戻りURIに対してGETリクエストを発行します。詳細は次の表を参照してください。

表59-23 アセンブリ・インスタンス作成ステータスの詳細を表示するためのGETリクエスト構成

機能

説明

URL

/em/cloud/iaas/assemblyrequest/223

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

サポート開始リリース

12.1.0.4 Cloud Service Portalプラグイン

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/iaas/assemblyrequest/223" ,
"name" : "VDOSI Assembly Creation 1345575147280" ,
"resource_state" :     {
"state" : "CREATING" ,
"messages" :
[
{
"text" : "The Request with ID '223' is being processed, and has Job Id 'C7CB0EBE83C22D70E040578CDA812E66'" ,
"date" : "2012-08-21T18:54:25+0000"
}
]
} ,
"context_id" : "223" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyInstance+json" ,
"service_family_type" : "iaas" ,
"status" : "EXECUTING" ,
"created" : "2012-08-21T18:52:28+0000"
}

ステータスは、プロセスが実行中であることを示しています。アセンブリ・インスタンスが正常に作成されると、次のようなレスポンスを受け取ります。

{
"uri" : "/em/cloud/iaas/assembly/C0AACCD8234BBAFBA7AF6CD3865B1FD3" ,
"name" : "AITEST" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "223" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyInstance+json" ,
"service_family_type" : "iaas" ,
"based_on" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1" ,
"reference" :     {
"ovf:id" : "sidbasmA_linuxx64_11203psu1"
} ,
"scalability_groups" :     {
"media_type" : "application/oracle.com.cloud.common.ScalabilityGroup+json" ,
"total" : "0" ,
"elements" :
[      ]
} ,
"servers" :     {
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/server/vm/B28680F24303A42D6909FFC0F79F306C" ,
"name" : "sidbasmA_linuxx64_11203psu1/sidbasm:DEPPLAN_1345575147280" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"status" : "STARTED"
}
]
} ,
"deployment_plan" : "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<ns2:ConfigurationData xmlns:ns2=\"http://www.oracle.com/sysman/vt/RequestConfigData\">\n    <AssemblyDeployment assemblyInstanceName=\"AITEST\">\n        <SourceBinary type=\"TYPE_SWLIB\" name=\"oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C75E88B04D7FEDEDE040578CDA810E49:0.1\"/>\n        <DeploymentTarget type=\"oracle_vm_zone\" name=\"D73AF0D42C8459E11419862797D1F37D\"/>\n        <AcceptedAllEULAs>false</AcceptedAllEULAs>\n        <InstallEMAgent>false</InstallEMAgent>\n        <DisableCleanup>false</DisableCleanup>\n        <EMAgentConfig installUserPassword=\"  \" installUserName=\"oracle\"/>\n        <AssemblyNetworkConfig>\n            <AssemblyNetwork name=\"network-1\"/>\n        </AssemblyNetworkConfig>\n        <VirtualSystemCollectionConfig id=\"sidbasmA_linuxx64_11203psu1\">\n            <ProductConfiguration>\n                <Product>\n                    <Properties/>\n                    <EMAgent>false</EMAgent>\n                </Product>\n            </ProductConfiguration>\n            <VirtualSystemConfig agentPushInstallationEnabled=\"true\" agentInstallationType=\"Push Agent Installation\" vmInstance=\"true\" targetName=\"sidbasmA_linuxx64_11203psu1/sidbasm:%assembly_instance_name%\" id=\"sidbasmA_linuxx64_11203psu1/sidbasm\">\n                <ProductConfiguration>\n                    <Product>\n                        <Properties>\n                            <Property id=\"ocm.runConfiguration\">\n<Name>ocm.runConfiguration</Name>\n<Required>false</Required>\n<Value>false</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.metalinkCsiRegistration.CSI\">\n<Name>ocm.metalinkCsiRegistration.CSI</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.metalinkCsiRegistration.metalinkId\">\n<Name>ocm.metalinkCsiRegistration.metalinkId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.proxyPassword\">\n<Name>ocm.proxyPassword</Name>\n<Required>false</Required>\n<Value>  </Value>\n<Secret>true</Secret>\n                            </Property>\n                            <Property id=\"ocm.metalinkCsiRegistration.countryCode\">\n<Name>ocm.metalinkCsiRegistration.countryCode</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_7|size-units\">\n<Name>system-fileset|db_asm_disk_7|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_1|size-units\">\n<Name>system-fileset|db_asm_disk_1|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_3|size-units\">\n<Name>system-fileset|db_asm_disk_3|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_0|size\">\n<Name>system-fileset|db_asm_disk_0|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_1|size\">\n<Name>system-fileset|db_asm_disk_1|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"asm-password\">\n<Name>asm-password</Name>\n<Required>true</Required>\n<Value>  </Value>\n<ValueGuid>C7CC61AC07DC6E58E040578CDA8145F9</ValueGuid>\n<Secret>true</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_7|size\">\n<Name>system-fileset|db_asm_disk_7|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.metalinkEmailRegistration.metalinkEmailId\">\n<Name>ocm.metalinkEmailRegistration.metalinkEmailId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"input|listener-1|global-db-name\">\n<Name>input|listener-1|global-db-name</Name>\n<Required>false</Required>\n<Value>orcl.us.example.com</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_4|size-units\">\n<Name>system-fileset|db_asm_disk_4|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.proxyHost\">\n<Name>ocm.proxyHost</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.repeaterURI\">\n<Name>ocm.repeaterURI</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_2|size-units\">\n<Name>system-fileset|db_asm_disk_2|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"input|listener-1|port\">\n<Name>input|listener-1|port</Name>\n<Required>false</Required>\n<Value>1521</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.anonymousEmailRegistration.emailId\">\n<Name>ocm.anonymousEmailRegistration.emailId</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"db-account-password\">\n<Name>db-account-password</Name>\n<Required>true</Required>\n<Value>  </Value>\n<ValueGuid>C7CC61AC07DF6E58E040578CDA8145F9</ValueGuid>\n<Secret>true</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_3|size\">\n<Name>system-fileset|db_asm_disk_3|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_2|size\">\n<Name>system-fileset|db_asm_disk_2|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.proxyPort\">\n<Name>ocm.proxyPort</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.proxyUsername\">\n<Name>ocm.proxyUsername</Name>\n<Required>false</Required>\n<Value></Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_6|size\">\n<Name>system-fileset|db_asm_disk_6|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_5|size\">\n<Name>system-fileset|db_asm_disk_5|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_4|size\">\n<Name>system-fileset|db_asm_disk_4|size</Name>\n<Required>false</Required>\n<Value>2836</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"ocm.metalinkEmailRegistration.metalinkPassword\">\n<Name>ocm.metalinkEmailRegistration.metalinkPassword</Name>\n<Required>false</Required>\n<Value> </Value>\n<Secret>true</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_6|size-units\">\n<Name>system-fileset|db_asm_disk_6|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_5|size-units\">\n<Name>system-fileset|db_asm_disk_5|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n                            </Property>\n                            <Property id=\"system-fileset|db_asm_disk_0|size-units\">\n<Name>system-fileset|db_asm_disk_0|size-units</Name>\n<Required>false</Required>\n<Value>MB</Value>\n<Secret>false</Secret>\n                            </Property>\n                        </Properties>\n                        <EMAgent>false</EMAgent>\n                    </Product>\n                </ProductConfiguration>\n                <HardwareConfiguration>\n                    <Memory>2048</Memory>\n                    <VCPUs>1</VCPUs>\n                    <HaEnabled>false</HaEnabled>\n                    <StartAfterCreation>true</StartAfterCreation>\n                    <CPUSchedulingPriority>50</CPUSchedulingPriority>\n                    <CPUCap>100</CPUCap>\n                    <LocalDisks>\n                        <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_System\">\n                            <Size>5122</Size>\n
<Mode>Read-Write</Mode>\n                            <CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n                        <disk fromDefinition=\"true\" name=\"AB\">\n                            <Size>0</Size>\n                            <Mode>Read-Write</Mode>\n                            <CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n                        <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-asm_base\">\n                            <Size>502</Size>\n                            <Mode>Read-Write</Mode>\n                            <CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n                        <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-asm_home\">\n                            <Size>10307</Size>\n                            <Mode>Read-Write</Mode>\n                            <CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n                        <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-db_base\">\n                            <Size>502</Size>\n                            <Mode>Read-Write</Mode>\n                            <CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n                        <disk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_sys-db_home\">\n                            <Size>9068</Size>\n                            <Mode>Read-Write</Mode>\n                            <CreatedByVmSize>false</CreatedByVmSize>\n                        </disk>\n                    </LocalDisks>\n                    <SharedDisks>\n                        <SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_0\"/>\n                        <SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_1\"/>\n                        <SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_2\"/>\n                        <SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_3\"/>\n                        <SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_4\"/>\n                        <SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_5\"/>\n                        <SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_6\"/>\n                        <SharedDisk fromDefinition=\"true\" name=\"2xZNMmSH5oZYW_db_asm_disk_7\"/>\n                    </SharedDisks>\n                    <Nics>\n                        <NetworkInterface fromDefinition=\"true\" name=\"eth0\">\n                            <IPAssignmentMode>Dhcp</IPAssignmentMode>\n                            <QoS>Any_Network_QoS_Type</QoS>\n                            <AssemblyNetwork name=\"network-1\"/>\n                        </NetworkInterface>\n                    </Nics>\n                    <RootPassword>  </RootPassword>\n                    <RootPasswordGuid>C7CC61AC07D96E58E040578CDA8145F9</RootPasswordGuid>\n                    <LogLocation>/assemblybuilder/logs</LogLocation>\n                    <VmSize>Custom</VmSize>\n                    <NetworkConfigurationTimeout>60</NetworkConfigurationTimeout>\n                    <ProductConfigurationTimeout>60</ProductConfigurationTimeout>\n                </HardwareConfiguration>\n            </VirtualSystemConfig>\n        </VirtualSystemCollectionConfig>\n    </AssemblyDeployment>\n</ns2:ConfigurationData>\n"
}

59.3.2 VMサービス・インスタンスの更新

サービス・インスタンスは、サイズ変更、ステータスの更新またはリソースの追加を行うことができます。

VMリソースは、次の変更をサポートしています。

- ステータスを更新できます(例: STARTEDからSTOPPED、またはSTOPPEDからSTARTED)。第59.3.2.1項「VMステータスの変更」を参照してください。

- cpuおよびメモリーを更新できます(たとえば、VMのサイズを変更するため)。第59.3.2.2項「VMサイズの変更」を参照してください。

注意:
12.1.0.4 Cloud Self Service Portalリリースでは、cpuやメモリーを変更する前にVMを停止する必要はありません。

- その他のリソース(VMディスクなど)を追加できます。第59.3.2.3項「VMディスクの追加」を参照してください。

- 10000バージョンのVMリソースでサポートされている更新はすべて、リソースの10001バージョンでもサポートされます。

59.3.2.1 VMステータスの変更

次に、VMのステータスのGETを示します。

表59-24 VMの現行ステータスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/byrequest/101?status,uri

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095" ,
"status" : "STARTED"
}

ステータスを更新するには、リソースuriにPUTメソッドを使用します。"uri"属性は、リソースを直接参照する属性です。

表59-25 VMを停止するためのPUTリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"status" : "STOPPED"
}

リクエスト・メソッド

PUT

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

Webサービス・レスポンスにより、200レスポンス・コードと現在のVM属性が表示されます。

VMのステータスを確認するには、次のGETリクエストをVMに対して発行します。

表59-26 VMのステータス変更を確認するためのGETリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/byrequest/101?status,uri

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

Webサービスにより、次が返されます。

{
"uri" : "/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095" ,
"status" : "STOPPED"
}

PUT一時ステータス値を送信しようとすると、次のようになります。

表59-27 一時ステータス値を試行するためのPUTリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"status" : "STOPPING"
}

リクエスト・メソッド

PUT

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

次に、Webサービス・レスポンスを示します。

{
"messages" :
[
{
"date" : "2012-08-19T17:22:04+0000" ,
"stack_trace" : "oracle.sysman.emInternalSDK.ssa.cloudapi.rest.RestServletException: Status 'STOPPING' specified by the PUT request is transient, and is not a valid status\n\tat oracle.sysman.ssa.cloudapi.iaas.VM.processVMStatusChange(VM.java:331)\n\tat oracle.sysman.ssa.cloudapi.iaas.VM.processVMChanges(VM.java:253)\n\tat oracle.sysman.ssa.cloudapi.iaas.VM.processRequest(VM.java:227)\n\tat oracle.sysman.ssa.cloudapi.iaas.IaasServiceProvider.processRequest(IaasServiceProvider.java:582)\n\tat oracle.sysman.emInternalSDK.ssa.cloudapi.EMCloudServlet.perform(EMCloudServlet.java:236)\n\tat oracle.sysman.emInternalSDK.ssa.cloudapi.EMCloudServlet.performPut(EMCloudServlet.java:351)\n\tat oracle.sysman.emInternalSDK.ssa.cloudapi.rest.AbstractRestServlet.doPut(AbstractRestServlet.java:163)\n\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:730)\n\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:820)\n\tat weblogic.servlet.internal.StubSecurityHelper$ServletServiceAction.run(StubSecurityHelper.java:227)\n\tat we" ,
"hint" : "Status 'STOPPING' specified by the PUT request is transient, and is not a valid status" ,
"text" : "Did not successfully execute 'PUT' resource operation on 'application/oracle.com.cloud.common.Cloud' identified by '/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095'"
}
]
}

既存のステータスをVMに送信しようとすると、次の相互作用が生成されます。

表59-28 VMステータスを現行ステータスに変更するためのPUTリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095?resource_state

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"status" : "STOPPED"
}

リクエスト・メソッド

PUT

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

Webサービスは次の応答内容を返します。

{
"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"date" : "2012-08-19T17:23:49+0000" ,
"text" : "Current Virtual Machine Status 'STOPPED' is the same as the requested status. Status change is not needed"
}
]
}
}

サービス・インスタンスを変更する際、やり取りするメッセージはresource_state属性でカプセル化されます。たとえば、VMを再びSTARTするには、次のPUTリクエストを発行します。

表59-29 VMを起動するためのPUTリクエスト構成

機能

説明

URL

https://example.com/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095?resource_state

ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"status" : "STARTED"
}

メソッド

PUT

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

Webサービスのレスポンスは次のとおりです。

{
"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"date" : "2012-08-19T17:25:29+0000" ,
"text" : "'START' resource operation on 'application/oracle.com.cloud.common.VM' identified by 'C5CA59AF9386975E8AEA45B0F040F095' is successfully submitted with reference 'C7A2713B9A4D29C1E040578CDA817561'"
}
]
}
}

59.3.2.2 VMサイズの変更

VMのCPUやメモリーを調整して、容量を増減することができます。たとえば、VMのCPUを1 vCPUに調整してメモリーを512から1024に増やすために、次のPUTリクエストを発行できます。

表59-30 VMのサイズを変更するためのPUTリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095?resource_state

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"cpu":[1,0],  "memory":"1024"
}

リクエスト・メソッド

PUT

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

受け取るレスポンスの例を次に示します。

{
"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"text" : "'PUT' resource operation on 'application/oracle.com.cloud.common.VM' identified by 'C5CA59AF9386975E8AEA45B0F040F095' is successfully submitted with reference '106'" ,
"date" : "2012-08-20T01:15:28+0000"
}
]
}
}

一定期間後、GETリクエストを介してVMリソースに新しい容量が反映されます。

表59-31 VMの現行サイズを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095?resource_state,cpu,memory,status

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"resource_state" :     {
"state" : "READY"
} ,
"status" : "STARTED" ,
"cpu" :
[
"1" ,
"0"
] ,
"memory" : "1024"
}

59.3.2.3 VMディスクの追加

追加ディスクをVMリソースに追加できます。たとえば、2つの追加ディスクを追加する場合、次のPUTリクエストを発行できます。

表59-32 VMディスクを追加するためのPUTリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095?resource_state

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.VM+json

本文

{
"disks": [
["additional_1", "5120"],
["additional_2", "10240"]
]
}

パラメータ/制約

disks属性のエントリが新しい場合、新しいディスクが追加されます。disks属性のエントリがすでに存在する場合、新しいディスクは無視されます。

リクエスト・メソッド

PUT

サポート開始リリース

12.1.0.5 Cloud Service Portalプラグイン

受け取るレスポンスの例を次に示します。

"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"text" : "'PUT' resource operation on 'application/oracle.com.cloud.common.VM' identified by ' C5CA59AF9386975E8AEA45B0F040F095' is successfully submitted with reference '2'" ,
"date" : "2013-02-26T19:53:15+0000"
}
]
}
}

一定期間後、GETリクエストを使用してVMリソースに新しいディスクが反映されます。

表59-33 VMリソースへの新しいディスクの追加を確認するためのGETリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095?resource_state,disks

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

Webサービス・レスポンスのサンプルを次に示します。

{
"resource_state" :     {
"state" : "READY"
} ,
"disks" :
[
[
"system.img (2)" ,
"1400"
] ,
[
"default_disk" ,
"10240"
] ,
[
"additional_1" ,
"5120"
] ,
[
"additional_2" ,
"10240"
]
]
}

59.3.3 サービス・インスタンスの削除

リソースのURIでDELETEリクエストを発行して、サービス・インスタンスを削除できます。たとえば、次のようなDELETEリクエストを発行できます。

表59-34 サービス・インスタンスを削除するためのDeleteリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

DELETE

サポート開始リリース

12.1.0.1 Cloud Service Portalプラグイン

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095" ,
"resource_state" :     {
"state" : "READY" ,
"messages" :
[
{
"text" : "'DELETE' resource operation on 'application/oracle.com.cloud.common.VM' identified by 'C5CA59AF9386975E8AEA45B0F040F095' is successfully submitted with reference 'C7A83335CB63DA7BE040578CDA814DDC'" ,
"date" : "2012-08-20T01:24:38+0000"
}
]
} ,
"context_id" : "C5CA59AF9386975E8AEA45B0F040F095" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"service_family_type" : "iaas"
}

一定期間後、VM URIでのGETリクエストにより、次の相互作用が生成されます。

表59-35 VMのステータスを確認するためのGETリクエスト構成

機能

説明

URI

/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

Webサービスから返されるレスポンスのサンプルを次に示します。

{
"uri" : "/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095" ,
"resource_state" :     {
"state" : "READY"
} ,
"context_id" : "C5CA59AF9386975E8AEA45B0F040F095" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"service_family_type" : "iaas" ,
"status" : "DELETED"
}

VMのステータスが"DELETED"値であることに注意してください。

59.3.4 サービス・インスタンスのリスト

リソース・モデルにはサービス・インスタンスへの様々な参照があり、すべてリソースそのものに関連しています。たとえば、ゾーン・リソースのservice_instancesはそのゾーンにある要素をリストしますが、ServiceTemplateリソースのservice_instancesはそのサービス・テンプレートに基づく要素をリストします。

たとえば、次の例ではゾーン内のサービス・インスタンスをリストします。

表59-36 ゾーンのサービス・インスタンスを表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D?service_instances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

リクエスト・メソッド

GET

サポート開始リリース

12.1.0.4 Cloud Service Portalプラグイン

次のレスポンスを受け取ります。

{
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "2" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/server/vm/523CAE80A305928C9C5BE8A67A4181FD" ,
"name" : "ZONEPOST" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"status" : "STARTED"
} ,
{
"uri" : "/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095" ,
"name" : "STPOST" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"status" : "STARTED"
}
]
}
}

同様に、サービス・テンプレートのサービス・インスタンスをリストできます。

表59-37 サービス・テンプレートのサービス・インスタンスを表示するためのGETリクエスト構成

機能

説明

URL

/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1?service_instances

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

サポート開始リリース

12.1.0.4 Cloud Service Portalプラグイン

受け取るレスポンスの例を次に示します。

{
"service_instances" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
"total" : "2" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/server/vm/C5CA59AF9386975E8AEA45B0F040F095" ,
"name" : "STPOST" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"status" : "STARTED"
} ,
{
"uri" : "/em/cloud/iaas/server/vm/523CAE80A305928C9C5BE8A67A4181FD" ,
"name" : "ZONEPOST" ,
"media_type" : "application/oracle.com.cloud.common.VM+json" ,
"status" : "STARTED"
}
]
}
}

59.3.5 サービス・テンプレートの検索

クラウドを介したサービス・テンプレートの検索は、ServiceTemplateFindsリソースを構築することによって実行できます。ServiceTemplateFindsは、指定された条件を満たす要素を含むレポートに対して同じ意味を持ちます。

たとえば、次では、OELという名前のサービス・テンプレートが返されます。

表59-38 サービス・テンプレートをフィルタ処理するためのPOSTリクエスト構成

機能

説明

URI

/em/cloud

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.ServiceTemplateFinds+jsonAccept : application/oracle.com.cloud.common.ServiceTemplateFinds+json

本文

{
"filters":{
"name":"OEL"
}
}

リクエスト・メソッド

POST

サポート開始リリース

12.1.0.5 Cloud Service Portalプラグイン

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/finds/service_template/bWVkaWFfdHlwZSUyNTNEYXBwbGljYXRpb24lMjUyRm9yYWNsZS5jb20uY2xvdWQuY29tbW9uLlNl%0AcnZpY2VUZW1wbGF0ZSUyRm5hbWUlMjUzRE9FTA%3D%3D" ,
"name" : "Service Template Finds" ,
"media_type" : "application/oracle.com.cloud.common.ServiceTemplateFinds+json" ,
"description" : "This is a Resource Finds for 'Service Template Finds' with media type 'application/oracle.com.cloud.common.ServiceTemplateFinds+json'" ,
"resource_state" :     {
"state" : "READY"
} ,
"filters" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
"name" : "OEL"
} ,
"finds" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AD6A66B2DCAEAE177E040F20AB0527449%3A0.1" ,
"name" : "OEL4.0 For Testing" ,
"media_type" : "application/oracle.com.cloud.common.VMTemplate+json" ,
"type" : "Template"
}
]
}
}

現在、filtersでサポートされる属性は次のとおりです。

表59-39 フィルタ

属性

説明

開始

media_type

検索する特定のサービス・テンプレート・メディア。これは、メディア・タイプの完全一致になります。

12.1.0.5 Cloud Service Portalプラグイン(IaaSサービス・ファミリ・タイプのみ)

name

名前に指定文字列が含まれる場合、サービス・テンプレートが返されます(大文字と小文字は区別されないため、前述の例でOELとoelは同じ結果を返します)。

12.1.0.5 Cloud Service Portalプラグイン(IaaSサービス・ファミリ・タイプのみ)

指定された属性はシステムでは認識されず、無視されます。たとえば、次では、DUMMYという名前のサービス・テンプレートが返されます。

表59-40 認識されない属性のPOSTリクエスト構成

機能

説明

URI

/em/cloud

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Content-Type: application/oracle.com.cloud.common.ServiceTemplateFinds+jsonAccept : application/oracle.com.cloud.common.ServiceTemplateFinds+json

本文

{
"filters":{
"name":"DUMMY"
}
}

リクエスト・メソッド

POST

サポート開始リリース

12.1.0.5 Cloud Service Portalプラグイン

受け取るレスポンスを次に示します。

{
"uri" : "/em/cloud/finds/service_template/bWVkaWFfdHlwZSUyNTNEYXBwbGljYXRpb24lMjUyRm9yYWNsZS5jb20uY2xvdWQuY29tbW9uLlNl%0AcnZpY2VUZW1wbGF0ZSUyRm5hbWUlMjUzRERVTU1Z" ,
"name" : "Service Template Finds" ,
"media_type" : "application/oracle.com.cloud.common.ServiceTemplateFinds+json" ,
"description" : "This is a Resource Finds for 'Service Template Finds' with media type 'application/oracle.com.cloud.common.ServiceTemplateFinds+json'" ,
"resource_state" :     {
"state" : "READY"
} ,
"filters" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
"name" : "DUMMY"
} ,
"finds" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
"total" : "0" ,
"elements" :
[      ]
}
}

名前の一部にDUMMYを含むサービス・テンプレートがないため、サービス・テンプレートは返されません。

リソースServiceTemplateFindsが作成されると、そのURIを使用して、GETリクエストを発行することによって同じ問合せを実行できます。条件も満たしている新しいテンプレートが追加されると、テンプレートが同様に返されます。

たとえば、DUMMYの例のURIを使用します。今回は、名前にDUMMYが含まれるサービス・テンプレートが作成されます。

表59-41 設定済POSTフィルタのURIを使用してサービス・テンプレートをフィルタ処理するためのGETリクエスト構成

機能

説明

URI

/em/cloud/finds/service_template/bWVkaWFfdHlwZSUyNTNEYXBwbGljYXRpb24lMjUyRm9yYWNsZS5jb20uY2xvdWQuY29tbW9uLlNl%0AcnZpY2VUZW1wbGF0ZSUyRm5hbWUlMjUzRERVTU1Z

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=

本文

なし

リクエスト・メソッド

GET

サポート開始リリース

12.1.0.5 Cloud Service Portalプラグイン

サービス・テンプレートが管理者によって作成および発行された後の、GETリクエストのレスポンスは次のとおりです。

{
"uri" : "/em/cloud/finds/service_template/bWVkaWFfdHlwZSUyNTNEYXBwbGljYXRpb24lMjUyRm9yYWNsZS5jb20uY2xvdWQuY29tbW9uLlNl%0AcnZpY2VUZW1wbGF0ZSUyRm5hbWUlMjUzRERVTU1Z" ,
"name" : "Service Template Finds" ,
"media_type" : "application/oracle.com.cloud.common.ServiceTemplateFinds+json" ,
"description" : "This is a Resource Finds for 'Service Template Finds' with media type 'application/oracle.com.cloud.common.ServiceTemplateFinds+json'" ,
"resource_state" :     {
"state" : "READY"
} ,
"filters" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
"name" : "DUMMY"
} ,
"finds" :     {
"media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AD6A7D3D84B605D11E040F20AB0524E1C%3A0.1" ,
"name" : "Dummy OEL Assembly" ,
"media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" ,
"type" : "Assembly"
}
]
}
}

59.4 バージョン1000のサポート

前に示した文書のとおり、この12.1.0.4 Cloud Service Portalプラグインでは仕様バージョン10000がサポートされます。起動するには、Enterprise Managerで次のHTTPリクエストを発行します。

表59-42 バージョン10000のクラウド・リソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=X-Specification-Version: 10000Accept: application/oracle.com.cloud.common.Cloud+json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud" ,
"name" : "Infrastructure Cloud" ,
"description" : "Infrastructure Cloud with Self Service Portal and Virtualization Managements" , "service_templates" :     {
"uri" : "/em/cloud/collection/servicetemplates" ,
"type" : "application/oracle.com.cloud.common.ServiceTemplate+json" ,
"total" : "7" ,
"elements" :
[
{
"uri" : "/em/cloud/servicetemplate/oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C75E88B04D7FEDEDE040578CDA810E49:0.1" ,
"name" : "sidb_assembly" ,
"type" : "Assembly" ,
"version" : "0.1"
} ,
{
"uri" : "/em/cloud/servicetemplate/oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C769B1F361529309E040578CDA813D57:0.1" ,
"name" : "wls_assembly" ,
"type" : "Assembly" ,
"version" : "0.1"
} ,
{
"uri" : "/em/cloud/servicetemplate/oracle:defaultService:em:provisioning:1:cmp:Virtualization:Template:C76CEB5563EA5E13E040578CDA817FAF:0.1" ,
"name" : "template_sanity" ,
"type" : "Template" ,
"version" : "0.1"
} ,
{
"uri" : "/em/cloud/servicetemplate/oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C76F733BC7A41AF7E040578CDA812CDC:0.1" ,
"name" : "fmw_venkat" ,
"type" : "Assembly" ,
"version" : "0.1"
} ,
{
"uri" : "/em/cloud/servicetemplate/oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C76C144A4A245B62E040578CDA8163B9:0.1" ,
"name" : "fmw_abby" ,
"type" : "Assembly" ,
"version" : "0.1"
} ,
{
"uri" : "/em/cloud/servicetemplate/oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C77122B0A916D95CE040578CDA814854:0.1" ,
"name" : "sidbasmA_abby" ,
"type" : "Assembly" ,
"version" : "0.1"
} ,
{
"uri" : "/em/cloud/servicetemplate/oracle:defaultService:em:provisioning:1:cmp:Virtualization:Assembly:C76C8792DE2A0937E040578CDA81795E:0.1" ,
"name" : "WLS_abby" ,
"type" : "Assembly" ,
"version" : "0.1"
}
]
} ,
"zones" :     {
"uri" : "/em/cloud/collection/zones" ,
"type" : "application/oracle.com.cloud.common.Zone+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/zone/D73AF0D42C8459E11419862797D1F37D" ,
"name" : "cloud_zone" ,
"type" : "oracle_vm_zone"
}
]
} ,
"vdcs" :     {
"uri" : "/em/cloud/collection/vdcs" ,
"type" : "application/oracle.com.cloud.common.VDC+json" ,
"total" : "1" ,
"elements" :
[
{
"uri" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"name" : "Oracle Enterprise Manager Virtual Data Center on Zone  cloud_zone"
}
]
} ,
"instance_options" :     {
"uri" : "/em/cloud/collection/instanceoptions" ,
"type" : "application/oracle.com.cloud.common.InstanceOption+json" ,
"total" : "3" ,
"elements" :
[
{
"uri" : "/em/cloud/instanceoption/virtual_machine_size/2" ,
"name" : "Medium" ,
"type" : "virtual_machine_size" ,
"memory" : "8192" ,
"cpu" : "4" ,
"local_storage" : "512000"
} ,
{
"uri" : "/em/cloud/instanceoption/virtual_machine_size/3" ,
"name" : "Large" ,
"type" : "virtual_machine_size" ,
"memory" : "15360" ,
"cpu" : "8" ,
"local_storage" : "1024000"
} ,
{
"uri" : "/em/cloud/instanceoption/virtual_machine_size/1" ,
"name" : "Small" ,
"type" : "virtual_machine_size" ,
"memory" : "4096" ,
"cpu" : "2" ,
"local_storage" : "256000"
}
]
} ,
"resource_state" :     {
"state" : "READY"
}
}

同様に、VDCのリソース・リストを返す場合は、次を発行できます(10000バージョン・リソースを使用する場合は、X-specification-versionがヘッダーに含まれている必要があります)。

表59-43 VDCリソースの詳細を表示するためのGETリクエスト構成

機能

説明

URI

/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D

リクエスト・ヘッダー

Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=X-Specification-Version: 10000Accept: application/oracle.com.cloud.common.VDC+json

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"name" : "Oracle Enterprise Manager Virtual Data Center on Zone  cloud_zone" ,
"description" : "Virtual Data Center is a logical grouping of virtualized assets in a particular zone" ,
"scalability_groups" :     {
"uri" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D?scalability_groups" ,
"type" : "application/oracle.com.cloud.common.ScalabilityGroup+json" ,
"total" : "0" ,
"elements" :
[      ]
} ,
"servers" :     {
"uri" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D?servers" ,
"type" : "application/oracle.com.cloud.common.Server+json" ,
"total" : "0" ,
"elements" :
[      ]
} ,
"vnets" :     {
"uri" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D?vnets" ,
"type" : "application/oracle.com.cloud.common.VNet+json" ,
"total" : "3" ,
"elements" :
[
{
"uri" : "/em/cloud/vnet/D73AF0D42C8459E11419862797D1F37D/oracle:defaultService:em:provisioning:1:netConfig:C76CEADBBBE6B23FE040578CDA817FB1" ,
"name" : "venkat_profile" ,
"id" : "oracle:defaultService:em:provisioning:1:netConfig:C76CEADBBBE6B23FE040578CDA817FB1"
} ,
{
"uri" : "/em/cloud/vnet/D73AF0D42C8459E11419862797D1F37D/oracle:defaultService:em:provisioning:1:netConfig:C77076C8FDEC6BD7E040578CDA813B2B" ,
"name" : "nwprofile_abby" ,
"id" : "oracle:defaultService:em:provisioning:1:netConfig:C77076C8FDEC6BD7E040578CDA813B2B"
} ,
{
"uri" : "/em/cloud/vnet/D73AF0D42C8459E11419862797D1F37D/oracle:defaultService:em:provisioning:1:netConfig:C76F741AFD7EB760E040578CDA812CD8" ,
"name" : "bmp_profile" ,
"id" : "oracle:defaultService:em:provisioning:1:netConfig:C76F741AFD7EB760E040578CDA812CD8"
}
]
} ,
"zone" : "/em/cloud/zone/D73AF0D42C8459E11419862797D1F37D" ,
"resource_state" :     {
"state" : "READY"
} ,
"assembly_instances" :     {
"uri" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D?assemblies" ,
"type" : "application/oracle.com.cloud.common.AssemblyInstance+json" ,
"total" : "11" ,
"elements" :
[
{
"uri" : "/em/cloud/assembly/byrequest/64" ,
"name" : "WLS_abby" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "FD4F3945CDD6BD6EEEFFAB064735ECDD"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/81" ,
"name" : "WLS_abby_0" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "79006B5C36F6ED90FC82EB58BB9580F2"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/82" ,
"name" : "fmw_abby" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "C7852B2D7740F4FAE040578CDA811EF3"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/26" ,
"name" : "latest_attempt_wls_withagent_dinesh" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "4DE0D2D8C81D0C09E665484BA9DBE668"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/61" ,
"name" : "sidb_assembly" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "235D95A93ABA2B50AFF5486540F48690"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/62" ,
"name" : "sidb_assembly_0" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "BFA65EC9A5FB97AD2B971EE8FB5E91AC"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/27" ,
"name" : "venkat_fmw" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "3DBE707B981DEDA5380ED6DBD8BF399C"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/23" ,
"name" : "venkat_nw_profile" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "05C1F96EE6FBD049BFE1D57AA89CB0D0"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/1" ,
"name" : "venkat_sidb" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "3A5C3917D18E276BDC7D08949F1851D1"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/22" ,
"name" : "wls_dinesh_32bit_agent" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "896B27C0963AF3B5C5C69D62614D63ED"
} ,
{
"uri" : "/em/cloud/assembly/byrequest/21" ,
"name" : "wls_vt_dinesh" ,
"contained_in" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D" ,
"guid" : "E54B51C4FCFF6C56AE393C3B1EEA8464"
}
]
} ,
"dbplatform_instances" :     {
"uri" : "/em/cloud/vdc/default/D73AF0D42C8459E11419862797D1F37D?dbplatform_instances" ,
"type" : "application/oracle.com.cloud.common.DbPlatformInstance+json" ,
"total" : "0" ,
"elements" :
[      ]
}
}

X-Specification-Versionヘッダーを指定しなかった場合、次のようなレスポンスを受け取ります。

{
"messages" :
[
{
"text" : "Media Type 'application/oracle.com.cloud.common.VDC' specified in the request cannot be supported by the Cloud Resource. Cloud Resource supports Media Type 'application/oracle.com.cloud.common.Cloud+json'" ,
"date" : "2012-08-19T15:17:08+0000"
}
]
}

注意:
10000バージョンではインフラストラクチャ・サービス・リソースのみがサポートされます。サポートされる機能は、前のバージョンと同じです。

60 Testing as a Service REST API

この章では、Testing as a Service (TaaS) REST APIのリソース・モデルおよびRESTリクエスト/レスポンス相互作用について説明します。

この章の項は次のとおりです。最初の項でこの章のすべてのREST APIのサマリーを示し、その後の項では、TaaSの概要、TaaSリソース・モデルおよびREST APIの例について説明します。

- Testing as a Service REST APIのサマリー

- Testing as a Service REST APIの概要

- Testing as a Serviceのリソース・モデル

- アプリケーション・リソース

- TestDriverTypeリソース

- TestDriverリソース

- QuotaUsageリソース

- TestAsset

- OltScenario

- CustomParameters

- OFTAssetScriptリソース

- OftAssetScriptCsvDatabanks

- OftPlaybackSettingsリソース

- OftDatabaseDatabanks

- TestEnvironment

- テスト

- 試行

- メトリック

- MetricValue

- OltSession

- OltCounter

- OltCounterValue

- OftTrialAssetExecution

- TestDriverInstance

- TestEnvironmentInstanceリソース

- 操作

- TestType

- ターゲット

- OltAgent

- Testing as a Service REST APIの例

60.1 Testing as a Service REST APIのサマリー

次の表に、この章で説明するすべてのTaaS REST APIをまとめています。

表60-1 TaaS REST APIのサマリー

リソース

データ・モデル

GET

POST

PUT

DELETE

アプリケーション・リソース

表60-2

- 第60.4.1項

- 第60.4.2項

サポート対象外

サポート対象外

サポート対象外

テスト・ドライバ・タイプ

表60-4

第60.4.9項

サポート対象外

サポート対象外

サポート対象外

テスト・ドライバ

表60-6

- 第60.4.7項

- 第60.4.9項

サポート対象外

サポート対象外

サポート対象外

割当て制限使用量

表60-9

サポート対象

サポート対象外

サポート対象外

サポート対象外

テスト・アセット

表60-11

- 第60.4.3項

- 第60.4.4項

サポート対象外

サポート対象外

サポート対象外

OLTシナリオ

表60-16

サポート対象

サポート対象外

サポート対象外

サポート対象外

カスタム・パラメータ

表60-19

サポート対象

サポート対象外

サポート対象外

サポート対象外

OFTアセット・スクリプト

表60-22

サポート対象

サポート対象外

サポート対象外

サポート対象外

OFTアセット・スクリプトCSVデータバンク

表60-26

サポート対象

サポート対象外

サポート対象外

サポート対象外

OFT再生設定

表60-29

サポート対象

サポート対象外

サポート対象外

サポート対象外

OFTデータベース・データバンク

表60-31

サポート対象

サポート対象外

サポート対象外

サポート対象外

テスト環境

表60-34

- 第60.4.5項

- 第60.4.6項

サポート対象外

サポート対象外

サポート対象外

テスト

表60-36

- 第60.4.19項

- 第60.4.20項

第60.4.21項

第60.4.22項

第60.4.23項

試行

表60-40

- 第60.4.24項

- 第60.4.25項

第60.4.26項

第60.4.27項

第60.4.28項

Metric

表60-47

サポート対象

サポート対象外

サポート対象外

サポート対象外

メトリック値

表60-49

サポート対象

サポート対象外

サポート対象外

サポート対象外

OLTセッション

表60-51

サポート対象

サポート対象外

サポート対象外

サポート対象外

OLTカウンタ

表60-53

サポート対象

サポート対象外

サポート対象外

サポート対象外

OLTカウンタ値

表60-55

サポート対象

サポート対象外

サポート対象外

サポート対象外

OFT試行アセット実行

表60-57

サポート対象

サポート対象外

サポート対象外

サポート対象外

テスト・ドライバ・インスタンス

表60-64

- 第60.4.15項

- 第60.4.16項

第60.4.17項

サポート対象外

第60.4.18項

テスト環境インスタンス

表60-66

- 第60.4.10項

- 第60.4.11項

- 第60.4.12項

- 第60.4.13項

サポート対象外

第60.4.14項

操作

表60-68

サポート対象

サポート対象

サポート対象外

サポート対象外

テスト・タイプ

表60-71

サポート対象

サポート対象外

サポート対象外

サポート対象外

ターゲット

表60-73

サポート対象

サポート対象外

サポート対象外

サポート対象外

OLTエージェント

表60-75

サポート対象

サポート対象外

サポート対象外

サポート対象外

注意:
この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。

60.2 Testing as a Service REST APIの概要

TaaS REST APIを使用することにより、次のことが行えます。

- TaaSユーザー・インタフェースにアクセスせずにTaaSアプリケーションとの相互作用。

- スクリプト形式でのTaaS機能の実行。

- 既存のアプリケーションおよびシステムとTaaSの容易な統合。

TaaS REST APIはRESTful (Representational State Transfer) Webサービスを使用して実装されています。クラウドREST APIに関する説明はすべて第45章「クラウドAPIの概要」に記載されています。

60.2.1 Testing as a Service REST APIの使用方法

次のダイアグラムは、テスト実施者がTesting as a Serviceを使用する方法を示しています。

図60-1 クラウドのエンド・ユーザーのテスト・アクティビティ

TaaS REST APIを使用して実行できるタスクと操作をいくつか示します。

- テスト
テストをリスト/表示/作成/更新/削除し、テストに属するすべての試行をリストします。

- 割当て制限と使用量
ユーザーの全体的な割当て制限使用量を確認します。

- 試行
試行ホームページで、1つの試行およびその操作/詳細に関する複数試行を表示/作成/更新/削除します。

- テスト・アセット/テスト環境
TaaSユーザーに公開されているテスト・アセットおよびテスト環境をリスト/表示します。

- テスト・ドライバ/環境インスタンス
テスト・ドライバおよびテスト環境のインスタンスをリスト/表示/作成/更新/削除/起動/停止します。

60.2.2 TaaSでのリソース・モデルの使用方法

Testing as a Serviceを使用する目的は、テストを作成し、テストを使用して試行を実行することです。図60-2に、テストおよび試行を定義するために使用されるリソースを示します。

簡単に説明すると、次のようになります。

1. テスト・ドライバ・タイプは、テスト・アセットを定義するときに使用されます。

2. テスト・アセット、テスト環境、ターゲットおよびテスト・ドライバは、テストを定義するときに使用されます。

3. テスト、テスト環境インスタンスおよびテスト・ドライバ・インスタンスは、試行を定義するときに使用されます。

図60-2に、これらのリソースおよびそれらの関連を示します。

図60-2 TaaSリソース関連ダイアグラム

60.3 Testing as a Serviceのリソース・モデル

ほとんどのリソースには、context_idおよびuriなど、共通の属性があります。context_idは識別子で、GUIDまたはデータベース表内の対応するエンティティの一意なIDで表すことができます。

メソッドGET/POST/PUT/DELETE (読込み/作成/更新/削除メソッドに対応)は、標準のHTTPメソッドです。一般的に、GETは検索/問合せ、POSTは作成、PUTは更新およびDELETEは削除/消去を意味します。たとえば、フィールドに「[POST]必須」のマークがある場合、(POSTメソッドを使用して)リソースを作成するときに、このフィールドを提供する必要があります。

利用可能なリソースを次に示します。

- アプリケーション・リソース

- TestDriverTypeリソース

- TestDriverリソース

- QuotaUsageリソース

- TestAsset

- OltScenario

- CustomParameters

- OFTAssetScriptリソース

- OftAssetScriptCsvDatabanks

- OftPlaybackSettingsリソース

- OftDatabaseDatabanks

- TestEnvironment

- テスト

- 試行

- メトリック

- MetricValue

- OltSession

- OltCounter

- OltCounterValue

- OftTrialAssetExecution

- TestDriverInstance

- TestEnvironmentInstanceリソース

- 操作

- TestType

- ターゲット

- OltAgent

60.3.1 アプリケーション・リソース

アプリケーション・タイプは、テスト・アセットおよびテスト環境を作成する際にテスト設計者によって使用されます。アプリケーション・タイプは、テスト関連のアクティビティを編成するために使用されるメタデータです。

次の表では、アプリケーション・リソース・モデルについて説明します。

表60-2 アプリケーション・リソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

アプリケーション名

contextId(id)

Long

アプリケーションのコンテキストID

次の表に、アプリケーション・リソースでサポートされるメソッドを示します。

表60-3 アプリケーション・リソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (contextIdなしのGET)

アプリケーションのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/applications

GET

指定したIDのアプリケーションを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/applications/1

60.3.2 TestDriverTypeリソース

TestDriverType (テスト・ドライバ・タイプ)リソースは、テスト・ドライバのタイプを定義します。

表60-4 TestDriverTypeリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

カスタム・テスト・ドライバ・タイプの名前

contextId(id)

Long

テスト・ドライバ・タイプのコンテキストID

testTypeUri

文字列

テスト・タイプ(Oracle Load Testing、Oracle Functional TestingまたはCustom)のURI

testTypeName

文字列

テスト・タイプの名前

次の表に、TestDriverTypeリソースでサポートされるメソッドを示します。

表60-5 TestDriverTypeリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idなしのGET)

テスト・ドライバ・タイプのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types

GET

指定したIDのテスト・ドライバ・タイプを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1

60.3.3 TestDriverリソース

TestDriver (テスト・ドライバ)リソースは、デプロイ・プランに基づいてテスト・システムに対してテストまたはワークロードを生成するためにEnterprise Managerで使用するソフトウェアのパッケージです。

表60-6 TestDriverリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

テスト・ドライバの名前

testDriverTypeUri

文字列

このテスト・ドライバに設定されているテスト・ドライバ・タイプのURI

testDriverTypeName

文字列

テスト・ドライバのテスト・ドライバ・タイプの名前

version

文字列

テスト・ドライバのバージョン

description

文字列

テスト・ドライバの説明

contextId(guid)

文字列

テスト・ドライバのコンテキストID

resultsStorage

文字列

Oracle Functional Testingテスト・ドライバの結果記憶域タイプ

resultFileSystem

OftRfsEntity

resultsStorage属性の値がrfsの場合、Oracle Functional Testingテスト・ドライバの詳細な結果ファイル・システム情報

表60-7 TestDriverリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idなしのGET)

テスト・ドライバのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers

GET

指定したGUIDのテスト・ドライバを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/C0D0F1A8F11A2EA1E040E50A42BB70CF

OftRfsEntityサブタイプ

OftRfsEntity (Oracle Functional Testing RFSエンティティ)サブタイプは、エンド・ユーザーにファイル記憶域サービスと、オプションで、格納されているファイルへのHTTPプロトコル経由のアクセスを提供するNFS (ネットワーク・ファイル・システム)です。

表60-8 OftRfsEntityサブタイプ

フィールド

タイプ

説明

name

文字列

結果ファイル・システムの名前

exportPath

文字列

結果ファイル・システムのエクスポート・パス

httpAccessUrl

文字列

結果ファイル・システムにアクセスするためのHTTP URL

60.3.4 QuotaUsageリソース

QuotaUsage (割当て制限使用量)リソースは、特定のロール単位でテスト実施者に割り当てられている容量使用量を表します。このリソースには、ゲストVM (仮想マシン)の数、CPUの数、メモリー (GB)、記憶域サイズ(GB)およびVU (仮想ユーザー)が含まれます。

表60-9 QuotaUsageリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

maxNumberOfGuestVM

Long

ロールに割り当てることが許可されるゲスト仮想マシンの最大数

maxNumberOfCpu

Long

ロールに割り当てることが許可されるCPUの最大数

maxMemory

Double

ロールに割り当てることが許可されるメモリーの最大量

maxStorageSize

Double

ロールに割り当てることが許可される記憶域の最大量

maxNumberOfVU

Long

ロールに割り当てることが許可される仮想ユーザーの最大数

numberOfCpu

Long

使用済のCPUの数

numberOfGuestVM

Long

使用済のゲスト仮想マシンの数

memory

Double

メモリーの量

storageSize

Double

使用済の記憶域の量

numberOfVU

Long

使用済の仮想ユーザーの数

次の表に、QuotaUsageリソースでサポートされるメソッドを示します。

表60-10 QuotaUsageリソースでサポートされるメソッド

メソッド

説明

サンプルURI

GET

現在のユーザーの割当て制限と使用量を返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/quota_usage/user_quota_usage

60.3.5 TestAsset

テスト・アセットとは、テスト環境に対して実行可能なテスト・アーティファクト(シナリオ、スクリプト、テスト)の集まりです。テスト・アセットは、テスト環境に対してワークロードを再現するために実行する必要があるアクションを定義します。

表60-11 テスト・アセット・リソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

テスト・アセットの名前。

testDriverTypeUri

文字列

テスト・アセットのテスト・ドライバ・タイプのURI。(Oracle Functional Testing、Oracle Load Testingまたはカスタム・テスト・ドライバ)

testDriverTypeName

文字列

テスト・アセットのテスト・ドライバ・タイプの名前(Oracle Functional Testing、Oracle Load Testingまたはカスタム・テスト・ドライバ)。

applicationUri

文字列

このテスト・アセットに関連付けられているアプリケーションのURI。

applicationName

文字列

このテスト・アセットに関連付けられているアプリケーションの名前。

tags

文字列

テスト・アセットのタグ。タグは、アセットに割り当てられているキーワードです。タグはテスト・アセットを記述する場合に役立ち、参照または検索処理でテスト・アセットを再び見付けられるようにします。

lastModified

文字列(ISO 8601日付)

テスト・アセットが最後に更新された日時。

owner

文字列

所有者のユーザー名。

contextId(guid)

文字列

テスト・アセットのコンテキストID。

oltTestAssetSettings

OltTestAssetSettings

Oracle Load Testingテスト・アセット固有のテスト・アセット設定。

oftTestAssetSettings

OftTestAssetSettings

Oracle Functional Testingテスト・アセット固有のテスト・アセット設定。

customTestAssetSettings

CustomTestAssetSettings

カスタム・テスト・アセット固有のテスト・アセット設定。

次の表に、TestAssetリソースでサポートされるメソッドを示します。

表60-12 TestAssetリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idなしのGET)

現在のユーザーに公開されているテスト・アセットのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets

GET

指定したGUIDのテスト・アセットの属性を返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/C0D0F1A8F11A2EA1E040E50A42BB70CF

OltTestAssetSettingsサブタイプ

OltTestAssetSettingsサブタイプを使用して、Oracle Load Testingテスト・アセット固有のテスト設定を指定します。

表60-13 OltTestAssetSettingsサブタイプ

フィールド

タイプ

説明

vuCountEditable

Boolean

スクリプトVU数が編集可能かどうかを示します。

rampupSettingEditable

Boolean

増加が編集可能かどうかを示します。

endConditionEditable

Boolean

終了条件が編集可能かどうかを示します。

oltScenarioFileDownloadUri

文字列

Oracle Load Testingテスト・シナリオ・ファイルのダウンロード場所のURI。

oltScenarioUri

文字列

Oracle Load Testingシナリオ詳細のURI。

OftTestAssetSettingsサブタイプ

OftTestAssetSettingsサブタイプを使用して、Oracle Functional Testingテスト・アセット固有のテスト設定を指定します。

表60-14 OftTestAssetSettingsサブタイプ

フィールド

タイプ

説明

scriptDetailsUri

文字列

Oracle Functional Testingスクリプト詳細のURI

scriptFileUri

文字列

Oracle Functional TestingスクリプトzipファイルのダウンロードURLを示すために使用されるURI

CustomTestAssetSettingsサブタイプ

CustomTestAssetSettingsサブタイプを使用して、Oracleカスタム・テスト・アセット固有のテスト設定を指定します。

表60-15 CustomTestAssetSettingsサブタイプ

フィールド

タイプ

説明

scriptFileDownloadUri

文字列

Customスクリプト・ファイルのダウンロード場所のURI

customParametersUri

文字列

カスタム・パラメータのURI

60.3.6 OltScenario

OltScenario (Oracle Load Testing (OLT)シナリオ)は、Oracle Load Testingテスト・アセットの詳細なシナリオ情報を表します。

表60-16 OltScenarioリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

testAssetContextId

文字列

テスト・アセットのコンテキストID。

testAssetUri

Strong

テスト・アセットのURI。

hardwareEstimationAvailable

Boolean

このシナリオでハードウェア見積りが利用できるかどうかを示します。

ramupDescription

文字列

テスト・アセットのデフォルトの増加設定の説明。

endConditionDescription

文字列

テスト・アセットのデフォルトの終了条件の説明。

scriptVuCounts

OltScript

シナリオのスクリプトVU数。

次の表に、OltScenarioリソースでサポートされるメソッドを示します。

表60-17 OltScenarioリソースでサポートされるメソッド

メソッド

説明

サンプルURI

GET

Oracle Load Testingシナリオを返します。

em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DFF34956DD08E27AE040F50A351D3DB5/olt_scenario

OltScriptサブタイプ

OltScriptサブタイプを使用して、Oracle Load Testingスクリプトを識別します。

表60-18 OltScriptサブタイプ

フィールド

タイプ

説明

name

文字列

スクリプトの名前

vuCount

整数

仮想ユーザーの数

60.3.7 CustomParameters

カスタム・パラメータは、カスタム・テスト・アセットまたはカスタム試行のカスタム・パラメータ設定のコレクションです。

表60-19 CustomParametersリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

parameters

CustomParameterのリスト

カスタム・パラメータのリスト

次の表に、CustomParametersリソースでサポートされるメソッドを示します。

表60-20 CustomParameterリソースでサポートされるメソッド

メソッド

説明

サンプルURI

GET

カスタム・パラメータを返します。

- カスタム・テスト・アセットから:

em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DFF34956DD08E27AE040F50A351D3DB5/custom_parameters

- Custom試行から:

em/websvcs/restful/extws/cloudservices/taas/v1/trials/E06DE62ACC497B71E040F50A351D66D0/custom_parameters

CustomParameterサブタイプ

CustomParameterサブタイプは、カスタム・テスト・アセットまたはカスタム試行で使用されます。各CustomParameterは、カスタム定義のパラメータを表します。

表60-21 CustomParameterサブタイプ

フィールド

タイプ

説明

name

文字列

パラメータの名前

value

文字列

パラメータの値

defaultValue

文字列

パラメータのデフォルト値

configurable

Boolean

パラメータが構成可能かどうか

60.3.8 OFTAssetScriptリソース

OFTAssetScript (Oracle Functional Testingアセット・スクリプト)は、Oracle Functional Testingテスト・アセットのスクリプト(zip形式)の詳細データを表します。より詳細なデータ(利用できる場合)のURI。たとえば、OpenScriptスクリプト情報、データバンク、再生設定がこのリソースから取得されます。

表60-22 OFTAssetScriptリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

testAssetContextId

文字列

テスト・アセットのコンテキストID

testAssetUri

文字列

テスト・アセットのURI

scripts

OftScriptEntityのリスト

このアセット・スクリプトzipファイル内の各OpenScriptスクリプトの詳細なデータのリスト

urlsInsideScripts

文字列のリスト

このOracle Functional Testingアセット・スクリプトzipファイルのOpenScriptスクリプト内のURLのリスト

csvDatabanksUri

文字列

カンマ区切り値(CSV)データバンクを表すリソースのURI

playbackSettingsUri

文字列

再生設定を表すリソースのURI

dbDatabanksUri

文字列

データベース・データバンクを表すリソースのURI

次の表に、OFTAssetScriptリソースでサポートされるメソッドを示します。

表60-23 OFTAssetScriptリソースでサポートされるメソッド

メソッド

説明

サンプルURI

GET

指定したアセットGUIDのOracle Functional Testingテスト・アセット・スクリプトを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/E3F48FC047CCE9E5E040F50A2D1E128E/oft_script_details

OftScriptEntityサブタイプ

OftScriptEntityサブタイプを使用して、Oracle Functional Testingスクリプト・エンティティ固有の詳細を指定します。

表60-24 OftScriptEntityサブタイプ

フィールド

タイプ

説明

name

文字列

OpenScriptスクリプトの名前。

type

文字列

OpenScriptスクリプトのタイプ。

version

文字列

OpenScriptスクリプトのバージョン。

encrypted

Boolean

スクリプトが暗号化されているかどうかを示します。

modules

OftScriptModuleEntityのリスト

このOpenScriptスクリプトで定義および使用されているモジュール。

OftScriptModuleEntityサブタイプ

OftScriptModuleEntityサブタイプを使用して、Oracle Functional Testingスクリプト・モジュール・エンティティ固有の詳細を指定します。

表60-25 OftScriptModuleEntityサブタイプ

フィールド

タイプ

説明

name

文字列

OpenScriptモジュールの名前

60.3.9 OftAssetScriptCsvDatabanks

OftAssetScriptCsvDatabanks (Oracle Functional Testingアセット・スクリプト・カンマ区切り値データバンク)リソースは、CSVデータバンクのリストを表します。OFTアセット・スクリプトCSVデータバンク・リソースは、型CsvDatabankCollectionを使用して表されます。

データバンクを使用して無制限のサイズの入力データを保持し、Webアプリケーションに自動的に提供することができます。

表60-26 OftAssetScriptCsvDatabanksリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

testAssetContextId

文字列

テスト・アセットのコンテキストID。

testAssetUri

文字列

テスト・アセットのURI

scriptDetails

文字列

アセット・スクリプト詳細のURI

csvDatabanks

OftAssetCsvDatabankEntityのリスト

Oracle Functional Testingアセット・スクリプト内のすべてのCSVデータバンクの詳細なデータのリスト

次の表に、OftAssetScriptCsvDatabanksリソースでサポートされるメソッドを示します。

表60-27 OftAssetScriptCsvDatabanksリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idなしのGET)

指定したテスト・アセット・スクリプトのCSVデータバンクのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/E3F48FC047CCE9E5E040F50A2D1E128E/oft_script_details/csv_data_banks

CsvDatabankサブタイプ

CsvDatabankサブタイプを使用して、Oracle Functional Testingアセット・スクリプト・リソース固有の詳細を指定します。

表60-28 CsvDatabankサブタイプ

フィールド

タイプ

説明

name

文字列

CSVデータバンクの名前

contents

文字列

カンマ区切り値(CSV)データバンク内の内容

60.3.10 OftPlaybackSettingsリソース

OftPlaybackSettings (Oracle Functional Testing再生設定)リソースは、スクリプトのすべての再生設定構成を表します。

表60-29 OftPlaybackSettingsリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

testAssetContextId

文字列

テスト・アセットのコンテキストID

TestAssetUri

文字列

テスト・アセットのURI

scriptDetailsUri

Script

アセット・スクリプト詳細のURI

values

文字列

アセット・スクリプトの再生設定構成の内容

次の表に、OftPlaybackSettingsリソースでサポートされるメソッドを示します。

表60-30 OftPlaybackSettingリソースでサポートされるメソッド

メソッド

説明

サンプルURI

GET

特定のOracle Functional Testingアセット・スクリプトの再生設定を返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/E3F48FC047CCE9E5E040F50A2D1E128E/oft_script_details/playback_settings

60.3.11 OftDatabaseDatabanks

OftDatabaseDatabanks (Oracle Functional Testingデータベース・データバンク)リソースは、指定したOracle Functional Testingテスト・アセットのデータベース・データバンクのリストを表します。OftDatabaseDatabanksは、型DbDatabankCollectionを使用して表されます。

データバンクを使用して無制限のサイズの入力データを保持し、Webアプリケーションに自動的に提供することができます。

表60-31 OftDatabaseDatabanksリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

testAssetContextId

文字列

テスト・アセットのコンテキストID

testAssetUri

文字列

テスト・アセットのURI

scriptDetailsUri

文字列

アセット・スクリプト詳細のURI

databaseDatabanks

OftScriptDbDatabankEntityのリスト

Oracle Functional Testingアセット・スクリプト内のすべてのデータベース・データバンクの詳細なデータのリスト

次の表に、OftDatabaseDatabanksリソースでサポートされるメソッドを示します。

表60-32 OftDatabaseDatabanksリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (IDパラメータなしのGET)

指定したテスト・アセット・スクリプトのデータベース・データバンクのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/E3F708CCD6CAC1E6E040F50A2D1E4ADE/oft_script_details/db_data_banks

OftScriptDbDatabankEntityサブタイプ

OftScriptDbDatabankEntityサブタイプを使用して、Oracle Functional Testingスクリプト・データベース・データバンク・エンティティ・リソース固有の詳細を指定します。

表60-33 OftScriptDbDatabankEntityサブタイプ

フィールド

タイプ

説明

alias

文字列

データベース・データバンクの別名

driver

文字列

データベース・データバンクのドライバ

connectUrl

文字列

データベース・データバンクの接続URL

userName

文字列

データベース・データバンクのユーザー名

sql

文字列

データベース・データバンク内で定義されたSQL文字列

60.3.12 TestEnvironment

TestEnvironmentは、アプリケーション・スタック全体を表すリソースのコレクションです。

表60-34 TestEnvironmentリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

テスト環境の名前

applicationUri

文字列

このテスト環境のアプリケーションのURI

applicationName

文字列

このテスト環境のアプリケーションの名前

tags

文字列

テスト環境のタグ

owner

文字列

このテスト環境の所有者のユーザー名

description

文字列

テスト環境の説明

lastModified

文字列(ISO 8601日付)

テスト環境の最終変更日付

contextId

文字列

テスト環境のコンテキストID (GUID)

次の表に、TestEnvironmentリソースでサポートされるメソッドを示します。

表60-35 TestEnvironmentリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (IDパラメータなしのGET)

現在のユーザーに公開されているテスト環境のリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments

GET

指定したGUIDのテスト環境を返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/C0D0F1A8F11A2EA1E040E50A42BB70CF

60.3.13 テスト

注意: テストは試行リソースの親リソースです。

テスト実施者はこのリソースを使用して、テスト・アセットおよびテスト環境からテストを作成して、テスト・アクティビティを実行します。テスト実施者は、テスト管理者が割り当てたテスト・アセットおよびテスト環境を使用して、テストを作成します。

表60-36 テスト・リソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

テストの名前。POSTメソッドを使用する場合、名前が必須です。PUTメソッドを使用する場合、名前はオプションです。

testDriverTypeUri

文字列

テスト・ドライバ・タイプのURI。

testDriverTypeName

文字列

テスト・ドライバ・タイプの名前。

description

文字列

テストの説明。POSTおよびPUTではオプション。

testAssets

AssetInTestEntityのリスト

このテストのテスト・アセットのリスト。Oracle Load Testingテストまたはカスタム・テストの場合、1つのアセットが使用されます。Oracle Functional Testingテストでは、1つ以上のテスト・アセットを定義できます。POSTおよびPUTで必須です。

testEnvironmentUri

文字列

このテストのテスト環境のURI。

testEnvironmentName

文字列

このテストのテスト環境の名前。

useEnvironmentLibrary

Boolean

関連付けられているテスト環境がマイ・ライブラリからである場合、trueを返します。関連付けられているテスト環境が既存のEnterprise Managerターゲットである場合、falseを返します。

systemTargetUri

文字列

関連付けられているテスト環境がマイ・ライブラリからである場合、trueを返します。関連付けられているテスト環境が既存のEnterprise Managerターゲットである場合、falseを返します。

testDriverUri

文字列

このテストのテスト・ドライバのURI。

testDriverName

文字列

このテストのテスト・ドライバの名前。

replaceUrls

ReplaceUrlのリスト

このテスト・アセットの置換URLのリスト。Oracle Functional Testingテストの場合のみ、複数(2つ以上)の置換URLがサポートされます。POSTおよびPUTではオプションです。NULLの場合は、デフォルトの設定が使用されます。

trialsUri

文字列

このテストのすべての試行のURI。

contextId(guid)

文字列

テストのGUID。

testEnvironmentContextId

文字列

テスト環境のGUID。POSTおよびPUTではオプション。

systemTargetContextId

文字列

Enterprise ManagerターゲットのGUID。POSTおよびPUTではオプション。

testDriverContextId

文字列

テスト・ドライバのGUID。POSTおよびPUTではオプション。

次の表に、テスト・リソースでサポートされるメソッドを示します。

表60-37 テスト・リソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idなしのGET)

現在のユーザーのテストのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/tests

GET

context_idとして指定されたGUIDのテストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/tests/C0D0F1A8F11A2EA1E040E50A42BB70CF

POST

新しいテストを作成します。リクエスト内でcontext_idはNULLである必要があります。新しく作成したテストのURIを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/tests/

PUT

テストの属性を更新します。

/em/websvcs/restful/extws/cloudservices/taas/v1/tests/C0D0F1A8F11A2EA1E040E50A42BB70CF

DELETE

テストを削除します。

/em/websvcs/restful/extws/cloudservices/taas/v1/tests/C0D0F1A8F11A2EA1E040E50A42BB70CF

AssetInTestEntityサブタイプ

AssetInTestEntityサブタイプを使用して、テスト・リソースで使用されるテスト・アセット固有の詳細を指定します。

表60-38 AssetInTestEntityサブタイプ

フィールド

タイプ

説明

testAssetContextId

文字列

テスト・アセット・リソースのコンテキストID

testAssetUri

文字列

テスト環境のGUID。POSTおよびPUTではオプション。

testAssetName

文字列

テスト・アセットの名前。

ReplaceUrlサブタイプ

テスト・アセット内の記録されたスクリプトを置換するURLを表します。試行を実行しているときには、指定したセグメントを使用して起動しているURLは、URLリクエストが送信される前に、指定された文字列により置換されます。

表60-39 ReplaceUrlサブタイプ

フィールド

タイプ

説明

originalUrl

文字列

テスト・アセットのスクリプトで記録された元のURL。このフィールドは、POSTおよびPUTメソッドではオプションです。

newUrl

文字列

元のURLを置換する新しいURL。このフィールドは、POSTおよびPUTメソッドではオプションです。

replaceType

文字列

KEEP_SAME、FROM_APPLIANCE、SPECIFIEDのいずれかの値。KEEP_SAME: 新しいURLは無視されます。FROM_APPLIANCE: 新しいURLは、テスト環境アプライアンスから設定されます。SPECIFIED: 元のURLは、ユーザーにより提供される新しいURLにより置換されます。

60.3.14 試行

注意: 試行はテストの子リソースです。

テスト実施者は、作成済のテスト・インスタンスから試行を作成し、実行します。テスト実施者は、テスト・アセットおよびテスト環境に基づいて試行を実行し、進行中の試行を監視して、完了した試行の結果を分析します。

表60-40 試行リソース・モデルのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

試行の名前。POSTで必須、PUTでオプション。

testUri

文字列

関連付けられているテストのURI。

testName

文字列

関連付けられているテストの名前。

testContextId

文字列

テストのコンテキストID。POSTおよびPUTで必須。

testEnvironmentInstanceContextId

文字列

テスト環境インスタンスのコンテキストID。テスト環境がそのテストにより選択されており、testEnvironmentInstanceNameおよびtestEnvironmentInstancePasswordが指定されていない場合、POSTおよびPUTで必須。

testEnvironmentInstanceUri

文字列

関連付けられているテスト環境インスタンスのURI。

testEnvironmentInstanceName

文字列

関連付けられているテスト環境インスタンスの名前。テスト環境がそのテストにより選択されており、testEnvironmentInstanceContextIdが指定されていない場合、POSTおよびPUTで必須。

testEnvironmentInstancePassword

文字列

作成する新規環境インスタンスのパスワード。テスト環境がそのテストにより選択されており、testEnvironmentInstanceContextIdが指定されていない場合、POSTおよびPUTで必須。

testEnvironmentInstanceStopDelaySeconds

Long

試行が完了してから、テスト環境インスタンスが停止するまでの遅延時間(秒単位)。POSTおよびPUTではオプション。

testEnvironmentInstanceDeleteDelaySeconds

Long

試行が完了してから、テスト環境インスタンスが削除されるまでの遅延時間(秒単位)。POSTおよびPUTではオプション。testEnvironmentInstanceContextIdが指定されている場合は無視されます。

testDriverInstanceContextId

文字列

テスト・ドライバ・インスタンスのコンテキストID。testDriverInstanceNameおよびtestDriverInstancePasswordが指定されていない場合、POSTおよびPUTで必須。

testDriverInstanceUri

文字列

テスト・ドライバ・インスタンスのURI。

testDriverInstanceName

文字列

テスト・ドライバ・インスタンスの名前。testDriverInstanceContextIdが指定されていない場合、POSTおよびPUTで必須。

testDriverInstancePassword

文字列

作成する新規テスト・ドライバ・インスタンスのパスワード。testDriverInstanceContextIdが指定されていない場合、POSTおよびPUTで必須。

testDriverInstanceStopDelaySeconds

Long

試行が完了してから、テスト・ドライバ・インスタンスが停止するまでの遅延時間(秒単位)。POSTおよびPUTではオプション。

testDriverInstanceDeleteDelaySeconds

Long

試行が完了してから、テスト・ドライバ・インスタンスが削除されるまでの遅延時間(秒単位)。POSTおよびPUTではオプション。testDriverInstanceContextIdが指定されている場合は無視されます。

description

文字列

試行の説明。POSTおよびPUTではオプション。

owner

文字列

この試行のユーザーのユーザー名。

status

文字列

この試行のステータス。

startTime

文字列(ISO 8601日時)

この試行のスケジュールされている開始時刻。POSTおよびPUTではオプション。

endTime

文字列(ISO 8601日時)

この試行の終了時刻。

testingExistedSystem

Boolean

テストが、既存のターゲット・システムをテストしているとして定義されているかどうかを示します。

executionLog

文字列

試行の実行ログ。

metricsUri

文字列

試行により収集されるEnterprise ManagerメトリックのURI。

awrDownloadUri

文字列

試行により生成されるAWRレポート・ダウンロード場所のURI。

operationsUri

文字列

試行で利用できる操作のURI。

contextId(guid)

文字列

試行のGUID。

oltTrialSettings

文字列

Oracle Load Testing固有の試行設定。POSTおよびPUTではオプション。NULLの場合は、テスト・アセットからのデフォルト設定が使用されます。

customTrialSettings

文字列

Custom固有の試行設定。POSTおよびPUTではオプション。NULLの場合は、テスト・アセットからのデフォルト設定が使用されます。

oftAssetExecutions

文字列

Oracle Functional Testing固有の試行アセット実行構成および結果データ。POSTおよびPUTではオプション。NULLの場合は、テスト・アセットからのデフォルト設定が使用されます。

次の表に、試行リソースでサポートされるメソッドを示します。

表60-41 試行リソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

現在のユーザーにより所有されているテストの試行のリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/trials

GET

指定したcontext_id (GUID)の試行を返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/trials/C0D0F1A8F11A2EA1E040E50A42BB70CE

POST

新しい試行を作成します。

/em/websvcs/restful/extws/cloudservices/taas/v1/trials

PUT

指定したcontext_idの試行を更新します。

/em/websvcs/restful/extws/cloudservices/taas/v1/trials/C0D0F1A8F11A2EA1E040E50A42BB70CE

DELETE

指定したcontext_idの試行を削除します。

/em/websvcs/restful/extws/cloudservices/taas/v1/trials/C0D0F1A8F11A2EA1E040E50A42BB70CE

OltTrialSettingsサブタイプ

OltTrialSettingsサブタイプを使用して、Oracle Load Testing試行固有の試行設定を指定します。

表60-42 Oracle Load Testingの試行設定サブタイプ

フィールド

タイプ

説明

oltSessionName

文字列

Oracle Load Testingセッションの名前。

oltSessionUri

文字列

Oracle Load Testingセッション・リソースのURI。

rampup

OltRampup

Oracle Load Testing増加設定。POSTおよびPUTではオプション。NULLの場合は、テスト・アセットからのデフォルト設定が使用されます。

endCondition

OltEndCondition

Oracle Load Testing試行終了条件設定。POSTおよびPUTではオプション。NULLの場合は、テスト・アセットからのデフォルト設定が使用されます。

scriptVuCounts

OltScript

スクリプトVU数設定。詳細は、OltTestAssetSettingsのOltScriptの説明を参照してください。POSTおよびPUTではオプション。NULLの場合は、テスト・アセットからのデフォルト設定が使用されます。

numberOfAgentDeployments

Long

エージェント・デプロイメントの数。

OltRampupサブタイプ

OltRampupサブタイプを使用して、Oracle Load Testing試行で使用される増加設定固有の詳細を指定します。OltRampupは、OLT試行が仮想ユーザーの実行を開始する割合を表します。

表60-43 OltRampupサブタイプ

フィールド

タイプ

説明

rampupOption

整数

増加設定オプション。値は、1、2、3、4のいずれかです。

1. X秒ごとにXユーザー

2. X反復ごとにXユーザー

3. X秒ごとにXパーセント

4. X反復ごとにXパーセント

user

整数

ユーザー数。rampupOptionの値が1または2の場合は、POSTおよびPUTで必須。

percent

Double

パーセント数。rampupOptionの値が3または4の場合は、POSTおよびPUTで必須。

percent - After設定に基づいて一度に開始する仮想ユーザーの割合を指定します。

After every - 指定された数または割合の仮想ユーザーが実行を開始する頻度を指定します。After everyには、secondsとiterationsのオプションがあります。

seconds

Long

秒数。rampupOptionの値が1または3の場合は、POSTおよびPUTで必須。

iterations

Long

反復数。rampupOptionの値が2または4の場合は、POSTおよびPUTで必須。

OltEndCondition Subtype

OltEndConditionサブタイプを使用して、Oracle Load Testing試行で使用される固有の終了条件を指定します。

表60-44 OltEndConditionサブタイプ

フィールド

タイプ

説明

endConditionOption

整数

終了条件オプション。1または2のいずれかの値。1の場合、X秒後に終了、2の場合X反復後に終了。

afterSeconds

Long

秒数。endConditionOptionの値が1の場合は、POSTおよびPUTで必須。

afterIterations

Long

反復数。endConditionOptionの値が2の場合は、POSTおよびPUTで必須。

CustomTrialSettingsサブタイプ

CustomTrial Settingsサブタイプを使用して、試行リソースで使用される固有のCustom試行設定を指定します。

表60-45 CustomTrialSettingsサブタイプ

フィールド

タイプ

説明

resultAvailable

Boolean

カスタム結果が利用できるかどうかを示します。これは読取り専用フィールドです。

resultStatus

文字列

カスタム結果のステータス。値は、RESULT_PASSED、RESULT_FAILED、RESULT_PASSED_WITH_WARNのいずれかです。

resultDownloadUri

文字列

結果ファイル・ダウンロード場所のURI。

customParametersUri

文字列

カスタム・パラメータのURI。

parameters

CustomParameterのリスト

カスタム試行のカスタム・パラメータ設定。CutomTestAssetSettingsのCustomParameter定義の説明を参照してください。POSTおよびPUTではオプション。NULLの場合は、テスト・アセットからのデフォルト設定が使用されます。

OftAssetExecutionCollectionサブタイプ

OftAssetExecutionCollectionサブタイプを使用して、試行リソースで使用される固有のOracle Functional Testingアセット実行コレクション設定を指定します。

表60-46 OftAssetExecutionCollectionサブタイプ

フィールド

タイプ

説明

trialContextId

文字列

試行のコンテキストID

trialUri

文字列

試行のURI

totalAssets

整数

この試行のアセットの合計数

passedAssets

整数

この試行で合格したアセットの数

failedAssets

整数

この試行で失敗したアセットの数

warningAssets

整数

この試行で警告の発生したアセットの数

notExecutedAssets

整数

この試行で実行されなかったアセットの数

assetExecutions

OftTrialAssetExecutionのリスト

この試行のすべてのアセット・スクリプトの実行および再生を表す実行のリスト

60.3.15 メトリック

試行により監視されるEnterprise Managerターゲット・メトリック。

表60-47 メトリック・リソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

contextId(trial_metric_id)

文字列

メトリックの試行メトリックID

trialContextId

Long

試行が参照するコンテキストID

trialUri

文字列

試行のURI

metricName

文字列

メトリックの名前

metricValuesUri

文字列

MetricValuesのURI

次の表に、メトリック・リソースでサポートされるメソッドを示します。

表60-48 メトリック・リソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

メトリックのリストを返します。

em/websvcs/restful/extws/cloudservices/taas/v1/trials/E0306FAA6635149DE040F50A351D0350/metrics

GET

メトリックを返します。

em/websvcs/restful/extws/cloudservices/taas/v1/metrics/1085

60.3.16 MetricValue

注意: Enterprise Managerメトリック値。

特定のタイム・スタンプでのメトリックの値。

表60-49 MetricValueリソースのデータ・モデル

フィールド

タイプ

説明

metricContextId

文字列

メトリックの試行メトリックID

metricUri

文字列

メトリックのURI

metricName

文字列

メトリックの名前

metricValue

Double

メトリック値の数

collectionDate

文字列(ISO 8601日付)

メトリック値が収集された日時の値

次の表に、MetricValueリソースでサポートされるメソッドを示します。

表60-50 MetricValueリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

メトリック値のリストを返します。

em/websvcs/restful/extws/cloudservices/taas/v1/metrics/1085/metric_values

60.3.17 OltSession

注意: Oracle Load Testing試行のみに適用できます。

Oracle Load Testing試行に関係付けられるOltSession (Oracle Load Testingセッション)。

表60-51 OltSessionリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

このエンティティのURI

contextId(olt session run id)

文字列

Oracle Load Testingセッションのセッション実行ID

trialUri

文字列

試行のURI

trialContextId

文字列

試行の内容

oltCountersUri

文字列

Oracle Load TestingカウンタのURI

sessionName

文字列

Oracle Load Testingセッションの名前。

startTime

文字列(ISO 8601日付)

セッションの開始時刻

finishTime

文字列(ISO 8601日付)

セッションの終了時刻

次の表に、OltSessionリソースでサポートされるメソッドを示します。

表60-52 OltSessionリソースでサポートされるメソッド

メソッド

説明

サンプルURI

GET

Oracle Load Testingセッションを返します。

em/websvcs/restful/extws/cloudservices/taas/v1/trials/E082496BD7336A9EE040F50A351D4F28/olt_session

60.3.18 OltCounter

注意: Oracle Load Testing試行のみに適用できます。

Oracle Load Testing試行により監視されるOltCounter (Oracle Load Testingカウンタ)。

表60-53 OltCounterリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

このエンティティのURI

oltSessionContextId

文字列

カウンタのID

oltSessionUri

文字列

Oracle Load TestingセッションのURI

counterName

文字列

カウンタの名前(たとえば、ヒット/秒、VU数、トランザクション/秒)

objectName

文字列

カウンタのスクリプト・オブジェクト名

instanceName

文字列

カウンタのステップ・インスタンス名(例: {Run: MedRecAppScript}.{[2] Oracle WebLogic Server - Medical Record Sample Application})

niceName

文字列

カウンタのユーザーフレンドリな表示名

oltCounterValuesUri

文字列

OltCounterValuesのURI

次の表に、OltCounterリソースでサポートされるメソッドを示します。

表60-54 OltCounterリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

Oracle Load Testingカウンタのリストを返します。

em/websvcs/restful/extws/cloudservices/taas/v1/olt_sessions/81/olt_counters

GET

Oracle Load Testingカウンタを返します。

em/websvcs/restful/extws/cloudservices/taas/v1/olt_counters/81/1671

60.3.19 OltCounterValue

特定のタイム・スタンプでのOracle Load Testingカウンタの値。

表60-55 OltCounterValueリソースのデータ・モデル

フィールド

タイプ

説明

oltSessionUri

文字列

Oracle Load TestingセッションのURI

oltCounterUri

文字列

Oracle Load TestingカウンタのURI

counterValue

Double

カウンタの値

couterTime

文字列(ISO 8601日付)

カウンタ値が収集された時刻

次の表に、OltCounterValueリソースでサポートされるメソッドを示します。

表60-56 OltCounterValueリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

Oracle Load Testingカウンタのリストを返します。

em/websvcs/restful/extws/cloudservices/taas/v1/olt_counters/81/1671/olt_counter_values

60.3.20 OftTrialAssetExecution

このリソースは、Oracle Functional Testingテスト・アセット・スクリプト実行(再生)の詳細(構成および結果)を表します。

表60-57 OftTrialAssetExecutionリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

contextId

文字列

Oracle Functional Testing試行アセット実行のコンテキストID

trialContextId

文字列

Oracle Functional Testing試行のコンテキストID

trialUri

文字列

Oracle Functional Testing試行のURI

assetContextId

文字列

アセットのコンテキストID

assetUri

文字列

アセットのURI

configuration

AssetConfigurationEntity

Oracle Functional Testing試行アセット実行の構成

executionResult

AssetResultEntity

Oracle Functional Testing試行アセット実行の結果

次の表に、OftTrialAssetExecutionリソースでサポートされるメソッドを示します。

表60-58 OftTrialAssetExecutionリソースでサポートされるメソッド

メソッド

説明

サンプルURI

GET

指定した試行および実行コンテキストIDのOracle Functional Testing試行実行のデータを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/trials
/E3F85B2946C890BAE040F50A2D1E2D1B/executions
/E3F85B2946C990BAE040F50A2D1E2D1B

AssetConfigurationEntityサブタイプ

AssetConfigurationEntityサブタイプを使用して、Oracle Functional Testing試行アセット実行リソースで使用される固有のアセット構成エンティティ設定を指定します。

表60-59 AssetConfigurationEntityサブタイプ

フィールド

タイプ

説明

runAlways

Boolean

以前のエラーを考慮することなく、実行を常に実施するかどうかを構成します。

continueOnWarning

Boolean

以前のエラーを考慮することなく、実行を常に実施するかどうかを構成します。

continueOnError

Boolean

以前の実行でエラーが発生した場合でも、実行を引き続き実施するかどうかを構成します。

playbackSettings

PlaybackSettingEntityのリスト

再生設定構成のリスト。

csvDatabanks

CsvDatabankEntityのリスト

CSVデータバンク構成のリスト。

databaseDatabanks

DbDatabankEntityのリスト

データベース・データバンク構成のリスト。

playbackSettingsUri

文字列

変更済の再生設定構成にアクセスするためのURI。

csvDatabanksUri

文字列

変更済のCSVデータバンク構成にアクセスするためのURI。

dbDatabanksUri

文字列

変更済のデータベース・データバンク構成にアクセスするためのURI。

PlaybackSettingEntityサブタイプ

PlaybackSettingEntityサブタイプを使用して、Oracle Functional Testing試行アセット実行リソースで使用される固有の再生エンティティ設定を指定します。

表60-60 PlaybackSettingEntityサブタイプ

フィールド

タイプ

説明

name

文字列

再生設定フィールドの名前

value

文字列

再生設定フィールドの値

CsvDatabankEntityサブタイプ

CsvDatabankEntityサブタイプを使用して、Oracle Functional Testing試行アセット実行リソースで使用される固有のカンマ区切りデータバンク・エンティティ設定を指定します。

表60-61 CSVデータバンク・エンティティ・サブタイプ

フィールド

タイプ

説明

name

文字列

CSVデータバンクの名前

contents

文字列

CSVデータバンクの内容

DbDatabankEntityサブタイプ

DbDatabankEntityサブタイプを使用して、Oracle Functional Testing試行アセット実行リソースで使用されるデータベース・データバンク・エンティティ設定を指定します。

表60-62 データベース・データバンク・エンティティ・サブタイプ

フィールド

タイプ

説明

alias

文字列

データベース・データバンクの別名

driver

文字列

データベース・データバンクのドライバ

connectUrl

文字列

データベース・データバンクの接続URL

userName

文字列

データベース・データバンクのユーザー名

password

文字列

データベース・データバンクのパスワード(GETメソッドでは利用不可)

sql

文字列

データベース・データバンク内で定義されたSQL文字列

AssetResultEntityサブタイプ

AssetResultEntityサブタイプを使用して、Oracle Functional Testing試行アセット実行リソースで使用される固有のアセット結果エンティティ設定を指定します。

表60-63 アセット結果エンティティ・サブタイプ

フィールド

タイプ

説明

trialContextId

文字列

試行のコンテキストID

assetContextId

文字列

アセットのコンテキストID

executionResultUri

文字列

試行アセット実行結果のURI

overallResult

文字列

実行の全体的な結果

status

文字列

アセット結果のステータス

iterations

整数

アセット・スクリプト実行の合計反復数

totalUserDefinedTests

整数

ユーザー定義済テストの総数

passedUserDefinedTests

整数

合格したユーザー定義済テストの数

failedUserDefinedTests

整数

失敗したユーザー定義済テストの数

warningUserDefinedTests

整数

警告の発生したユーザー定義済テストの数

totalScriptActions

整数

スクリプト・アクションの総数

passedScriptActions

整数

合格したスクリプト・アクションの数

failedScriptActions

整数

失敗したスクリプト・アクションの数

warningScriptActions

整数

警告の発生したスクリプト・アクションの数

totalSteps

整数

ステップの総数

execOrder

整数

Oracle Functional Testing試行のすべてのアセット実行内でのこの実行の順序

uniqueName

文字列

アセット実行の一意な名前

scriptName

文字列

スクリプトの名前。

resultStorage

文字列

アセット実行の結果記憶域(ローカルまたはrfs)

zipResultUri

文字列

実行結果zipへのURI

rfsLocation

文字列

rfs上に格納されたアセット実行の場所

stepDetailsUri

文字列

実行のステップ詳細へのURI

60.3.21 TestDriverInstance

テスト・ドライバのインスタンス。

表60-64 TestDriverInstanceリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

テスト・ドライバ・インスタンスの名前。POSTで必須

status

文字列

テスト・ドライバ・インスタンスのステータス

testDriverUri

文字列

インスタンスのテスト・ドライバのURI

testDriverContextId

文字列

テスト・ドライバのID。POSTで必須

testDriverName

文字列

インスタンスのテスト・ドライバの名前

owner

文字列

テスト・ドライバ・インスタンスの所有者

creationDate

文字列(ISO 8601日付)

テスト・ドライバ・インスタンスの作成日

contextId(id)

Long

テスト・ドライバ・インスタンスのコンテキストID

testDriverInstancePassword

文字列

新規テスト・ドライバ・インスタンスのパスワード(POSTで必須)

scheduledStartTime

文字列(ISO 8601日付)

新規インスタンスのスケジュールされている開始時刻。POSTでオプション

scheduledDeleteTime

文字列(ISO 8601日付)

新規インスタンスのスケジュールされている削除時刻(POSTでオプション)

operationsUri

文字列

すべての利用できる操作のURI

次の表に、TestDriverInstanceリソースでサポートされるメソッドを示します。

表60-65 テスト・ドライバ・インスタンス・リソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

すべてのテスト・ドライバ・インスタンスをリストします。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_driver_instances

GET

指定したコンテキストIDのテスト・ドライバ・インスタンスのデータを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_driver_instances/C0D0F1A8F11A2EA1E040E50A42BB70CF

POST

テスト・ドライバ・インスタンスを作成します。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_driver_instances

DELETE

指定したコンテキストIDのテスト・ドライバ・インスタンスを削除します。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_driver_instances/C0D0F1A8F11A2EA1E040E50A42BB70CF

60.3.22 TestEnvironmentInstanceリソース

テスト環境のインスタンス。

表60-66 TestEnvironmentInstanceリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

テスト環境インスタンスの名前(POSTで必須)

status

文字列

テスト環境インスタンスのステータス

testEnvironmentContextId

文字列

テスト環境のコンテキストID (POSTで必須)

testEnvironmentUri

文字列

このインスタンスのテスト環境のURI

testEnvironmentName

文字列

このインスタンスのテスト環境の名前

owner

文字列

テスト環境インスタンスの所有者

creationDate

文字列(ISO 8601日付)

インスタンスの作成日

contextId

Long

テスト環境インスタンスのID

testEnvironmentInstancePassword

文字列

新規テスト・ドライバ・インスタンスのパスワード(POSTで必須)

scheduledStartTime

文字列(ISO 8601日付)

新規インスタンスのスケジュールされている開始時刻。POSTでオプション

scheduledDeleteTime

文字列(ISO 8601日付)

新規インスタンスのスケジュールされている削除時刻(POSTでオプション)

operationsUri

文字列

利用できる操作のURI

次の表に、TestEnvironmentInstanceリソースでサポートされるメソッドを示します。

表60-67 テスト環境インスタンス・リソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

すべてのテスト環境インスタンスをリストします。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_environment_instances

GET

指定したコンテキストIDのテスト環境インスタンスのデータを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_environment_instances
/C0D0F1A8F11A2EA1E040E50A42BB70CF

POST

テスト環境インスタンスを作成します。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_environment_instances

DELETE

指定したコンテキストIDのテスト環境インスタンスを削除します。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_environment_instances
/C0D0F1A8F11A2EA1E040E50A42BB70CF

60.3.23 操作

操作は、たとえばTestEnvironmentInstance/TestDriverInstance/試行などのリソースで許可される1つの操作を表します。

テスト環境インスタンスでサポートされる操作は、start、stop、restartです。

テスト・ドライバ・インスタンスでサポートされる操作は、start、stop、restart、add_agents、remove_agent、acquire_agentです。

試行でサポートされる操作は、stopです。

表60-68 操作リソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

操作のURI

name

文字列

操作の名前

method

文字列

操作のメソッド(POST)

parameters

OperationParameterのリスト

メソッドのパラメータ

次の表に、操作リソースでサポートされるメソッドを示します。

表60-69 操作リソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

テスト環境インスタンスおよびテスト・ドライバ・インスタンスのすべての操作をリストします。

/em/websvcs/restful/extws/cloudservices/taas/v1
/test_environment_instances/C0D0F1A8F11A2EA1E040E50A42BB70CF
/operations

POST

インスタンス上で操作を実行します。

1./em/websvcs/restful/extws/cloudservices/taas/v1
/test_environment_instances/C0D0F1A8F11A2EA1E040E50A42BB70CF
/operations/start
2./em/websvcs/restful/extws/cloudservices/taas/v1
/test_environment_instances/C0D0F1A8F11A2EA1E040E50A42BB70CF
/operations/stop
3./em/websvcs/restful/extws/cloudservices/taas/v1
/test_driver_instances/C0D0F1A8F11A2EA1E040E50A42BB70CF
/operations/add_agents
Parameter:number of agent want to add.
4./em/websvcs/restful/extws/cloudservices/taas/v1
/test_driver_instances/C0D0F1A8F11A2EA1E040E50A42BB70CF
/operations/remove_agent
Parameters:context id of agent.
5./em/websvcs/restful/extws/cloudservices/taas/v1/tests
/C0D0F1A8F11A2EA1E040E50A42BB70CF/trials
/C0D0F1A8F11A2EA1E040E50A42BB70CE/operations/stop
6./em/websvcs/restful/extws/cloudservices/taas/v1
/test_driver_instances/C0D0F1A8F11A2EA1E040E50A42BB70CF
/operations/acquire_agent
Parameters:context id of agent.

OperationParameterサブタイプ

OperationParameterサブタイプを使用して、操作リソースで使用される固有の操作パラメータ設定を指定します。

表60-70 OperationParameterサブタイプ

フィールド

タイプ

説明

name

文字列

パラメータの名前

value

文字列

パラメータ値。

defaultValue

文字列

デフォルトのパラメータ値。

isRequiredValue

Boolean

パラメータが必須かどうかを示します。

possibleValues

文字列のリスト

パラメータの可能な値。

description

文字列

パラメータの説明。

60.3.24 TestType

テストのタイプ。

表60-71 TestTypeリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

name

文字列

テスト・タイプの名前

contextId(id)

Long

テスト・タイプのID

次の表に、TestTypeリソースでサポートされるメソッドを示します。

表60-72 テスト・タイプ・リソース・モデルでサポートされるメソッド

メソッド

説明

サンプルURI

LIST (context_idパラメータなしのGET)

すべてのテスト・タイプをリストします。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_types

GET

テスト・タイプを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_types/1

60.3.25 ターゲット

Enterprise Managerターゲット

表60-73 ターゲット・リソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

リソースのURI

contextId

文字列

ターゲットのGUID

targetName

文字列

ターゲットの名前

targetType

文字列

ターゲットのタイプ

status

整数

ターゲットのステータス

statusDisplay

文字列

ターゲットの表示ステータス(たとえば、アップ、ダウンなど)

hostName

文字列

ターゲットの存在するホストの名前

次の表に、ターゲット・リソースでサポートされるメソッドを示します。

表60-74 ターゲット・リソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST

ターゲットのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/targets

GET

ターゲットを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/targets
/C0D0F1A8F11A2EA1E040E50A42BB70CF

60.3.26 OltAgent

OltAgent (Oracle Load Testingエージェント)は、Oracle Load Testing試行を実行するために使用できるエージェント・マシンを表します。

表60-75 OltAgentリソースのデータ・モデル

フィールド

タイプ

説明

uri

文字列

OLTエージェントのURI

contextId

文字列

OLTエージェントのGUID

hostName

文字列

OLTエージェントの名前

status

文字列

OLTエージェントのステータス

ip

文字列

OLTエージェントのIPアドレス

port

文字列

OLTエージェントのエージェント・サービスのポート

version

文字列

OLTエージェントのバージョン

cpu

文字列

OLTエージェントのCPU数

memory

文字列

OLTエージェントのメモリー(MB単位)

storage

文字列

OLTエージェントの記憶域(MB単位)

次の表に、OltAgentリソースでサポートされるメソッドを示します。

表60-76 OltAgentリソースでサポートされるメソッド

メソッド

説明

サンプルURI

LIST

OLTエージェントのリストを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances
/C0D0F1A8F11A2EA1E040E50A42BB70CF
/OltAgents

GET

エージェントを返します。

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances
/C0D0F1A8F11A2EA1E040E50A42BB70CF
/OltAgents/C0D0F1A8F11A2EA1E040E50A42BB70CF

60.4 Testing as a Service REST APIの例

次に、TaaS REST APIの使用例を示します。

- すべてのアプリケーションの詳細の表示

- コンテキストID指定によるアプリケーションの問合せ

- すべてのテスト・アセットの詳細の表示

- コンテキストID指定によるテスト・アセットの問合せ

- すべてのテスト環境の詳細の表示

- コンテキストID指定によるテスト環境の問合せ

- すべてのテスト・ドライバの詳細の表示

- コンテキストID指定によるテスト・ドライバの問合せ

- コンテキストID指定によるテスト・ドライバ・タイプの問合せ

- すべてのテスト環境インスタンスの詳細の表示

- コンテキストID指定によるテスト環境インスタンスの問合せ

- テスト環境インスタンスの作成

- テスト環境インスタンスおよびテスト・ドライバ・インスタンス上での操作の実行

- 停止したテスト環境インスタンスの削除

- すべてのテスト・ドライバ・インスタンスの詳細の表示

- コンテキストID指定によるテスト・ドライバ・インスタンスの問合せ

- テスト・ドライバ・インスタンスの作成

- 停止したテスト・ドライバ・インスタンスの削除

- すべてのテストの詳細の表示

- コンテキストID指定によるテストの問合せ

- テストの作成

- テストの削除

- すべての試行の詳細の表示

- コンテキストID指定による試行の問合せ

- 新しい試行の作成

- 試行の更新

- 試行の削除

60.4.1 すべてのアプリケーションの詳細の表示

次の表にGETリクエスト構成を示します。

表60-77 すべてのアプリケーションをリスト表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/applications

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/applications",
"items": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/applications/1",
"contextId": "1",
"name": "medrec"
}
}

60.4.2 コンテキストID指定によるアプリケーションの問合せ

次の表にGETリクエスト構成を示します。

表60-78 コンテキストID指定によってアプリケーションを問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/applications/1

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/applications/1", "contextId": "1",
"name": "medrec"
}

60.4.3 すべてのテスト・アセットの詳細の表示

次の表にGETリクエスト構成を示します。

表60-79 すべてのテスト・アセットをリスト表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets", "items": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492", "contextId": "DCBDEA617F62EC63E040F20AA0512492",
"name": "Asset001",
"testDriverTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "testDriverTypeName": "OLT",
"applicationUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/applications/1", "applicationName": "medrec",
"lastModified": "1368603913000",
"owner": "TAASUSER1",
"vuCountEditable": "true",
"rampupSettingEditable": "true",
"endConditionEditable": "true"
}
}

60.4.4 コンテキストID指定によるテスト・アセットの問合せ

次の表にGETリクエスト構成を示します。

表60-80 コンテキストID指定によってテスト・アセットを問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492", "contextId": "DCBDEA617F62EC63E040F20AA0512492",
"name": "Asset001",
"testDriverTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "testDriverTypeName": "OLT",
"applicationUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/applications/1", "applicationName": "medrec",
"lastModified": "1368603913000",
"owner": "TAASUSER1",
"oltScenario": {
"scripts": {
"name": "MedRec1Script",
"vuCount": "1"
},
"rampupOptionIndex": "3",
"rampupOptionLabel": "X Percent every Y Seconds",
"rampupUserOrPercent": "10.0",
"rampupSecondOrIteration": "10.0",
"endCondition": "As defined in the scenario: After each user plays 2 Iterations"
},
"vuCountEditable": "true",
"rampupSettingEditable": "true",
"endConditionEditable": "true"
}

60.4.5 すべてのテスト環境の詳細の表示

次の表にGETリクエスト構成を示します。

表60-81 すべてのテスト環境を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments", "items": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "contextId": "DCBDF6F2FFC90069E040F20AA051215F",
"name": "MedrecEnv",
"applicationUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/applications/1", "applicationName": "medrec",
"owner": "TAASUSER1",
"lastModified": "1368604061000"
}
}

60.4.6 コンテキストID指定によるテスト環境の問合せ

次の表にGETリクエスト構成を示します。

表60-82 コンテキストID指定によってテスト環境を問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "contextId": "DCBDF6F2FFC90069E040F20AA051215F",
"name": "MedrecEnv",
"applicationUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/applications/1", "applicationName": "medrec",
"owner": "TAASUSER1",
"lastModified": "1368604061000"
}

60.4.7 すべてのテスト・ドライバの詳細の表示

次の表にGETリクエスト構成を示します。

表60-83 すべてのテスト・ドライバをリスト表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers", "items": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "contextId": "DCBD49A045FFD35BE040F20AA05150F5",
"name": "Default OLT",
"testDriverTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "testDriverTypeName": "OLT"
}
}

60.4.8 コンテキストID指定によるテスト・ドライバの問合せ

次の表にGETリクエスト構成を示します。

表60-84 コンテキストID指定によってテスト・ドライバを問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "contextId": "DCBD49A045FFD35BE040F20AA05150F5",
"name": "Default OLT",
"testDriverTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "testDriverTypeName": "OLT"
}

60.4.9 コンテキストID指定によるテスト・ドライバ・タイプの問合せ

次の表にGETリクエスト構成を示します。

表60-85 コンテキストID指定によってテスト・ドライバ・タイプを問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "contextId": "1",
"name": "OLT",
"testTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_types/1", "testTypeName": "OLT"
}

60.4.10 すべてのテスト環境インスタンスの詳細の表示

次の表にGETリクエスト構成を示します。

表60-86 すべてのテスト環境インスタンスを表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances", "items": [
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1", "contextId": "1",
"name": "Medrec_11",
"status": "Ready",
"testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv",
"owner": "TAASUSER1",
"creationDate": "1368604209000",
"operations": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1/operations",\\\\ "items": [
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1/operations/stop",\\\\ "contextId": "stop",
"method": "POST"
},
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1/operations/restart", "contextId": "restart",
"method": "POST"
}
]
}
}
]
}

60.4.11 コンテキストID指定によるテスト環境インスタンスの問合せ

次の表にGETリクエスト構成を示します。

表60-87 コンテキストID指定によってテスト環境インスタンスを問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1", "contextId": "1",
"name": "Medrec_11",
"status": "Ready",
"testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv",
"owner": "TAASUSER1",
"creationDate": "1368604209000",
"operations": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1/operations", "items": [
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1/operations/stop", "contextId": "stop",
"method": "POST"
},
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1/operations/restart", "contextId": "restart",
"method": "POST"
}
]
}
}

60.4.12 テスト環境インスタンスの作成

次の表にPOSTリクエスト構成を示します。

表60-88 テスト環境インスタンスを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances

本文

{
"name": "testEnvInst1",
"testEnvironmentContextId": "DCBDF6F2FFC90069E040F20AA051215F",
"testEnvironmentInstancePassword": "Oracle123"
"scheduledStartTime": null,
"scheduledDeleteTime": null

}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Method: POST

URI: https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances

Request:

Response:
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/41", "contextId": "41",
"name": "testEnvInst1",
"status": "Scheduled",
"testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv",
"owner": "TAASUSER1",
"creationDate": "1368772865392",
"operations": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/41/operations" }
}

60.4.13 テスト環境インスタンスおよびテスト・ドライバ・インスタンス上での操作の実行

注意:
実行可能な操作は、テスト環境インスタンスのステータスにより異なります。操作は、start、stopおよびrestartです。

次の表にPOSTリクエスト構成を示します。

表60-89 テスト環境インスタンスおよびテスト・ドライバ・インスタンス上で操作を実行するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1/operations/stop

本文

なし

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

Operation request has been submitted.

60.4.14 停止したテスト環境インスタンスの削除

次の表にDELETEリクエスト構成を示します。

表60-90 停止したテスト環境インスタンスを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/21

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

TestEnvironmentInstanceEntity has been deleted.Context Id:21

60.4.15 すべてのテスト・ドライバ・インスタンスの詳細の表示

次の表にGETリクエスト構成を示します。

表60-91 すべてのテスト・ドライバ・インスタンスを表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{ "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances", "items": { "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1", "contextId": "1", "name": "ManualTDInst", "status": "Ready", "testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT", "owner": "TAASUSER1", "creationDate": "1368576000000", "operations": { "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1/operations", "items": [ { "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1/operations/stop", "contextId": "stop", "method": "POST" }, { "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1/operations/restart", "contextId": "restart", "method": "POST" } ] } } }

60.4.16 コンテキストID指定によるテスト・ドライバ・インスタンスの問合せ

次の表にGETリクエスト構成を示します。

表60-92 コンテキストID指定によってテスト・ドライバ・インスタンスを問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1", "contextId": "1",
"name": "ManualTDInst",
"status": "Ready",
"testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT",
"owner": "TAASUSER1",
"creationDate": "1368576000000",
"operations": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1/operations", "items": [
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1/operations/stop", "contextId": "stop",
"method": "POST"
},
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1/operations/restart", "contextId": "restart",
"method": "POST"
}
]
}
}

60.4.17 テスト・ドライバ・インスタンスの作成

次の表にPOSTリクエスト構成を示します。

表60-93 テスト・ドライバ・インスタンスを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1

本文

{
"name": "testDriverInst1",
"testDriverContextId": "DCBD49A045FFD35BE040F20AA05150F5",
"testDriverInstancePassword": "Oracle123"
"scheduledStartTime": null,
"scheduledDeleteTime": null
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/25", "contextId": "25",
"name": "testDrvInst1",
"status": "NotAvailable",
"testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers", "owner": "TAASUSER1",
"creationDate": "1368774079487",
"operations": {
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/25/operations" }
}

60.4.18 停止したテスト・ドライバ・インスタンスの削除

次の表にDELETEリクエスト構成を示します。

表60-94 停止したテスト・ドライバ・インスタンスを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/25

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

TestDriverInstanceEntity has been deleted. Context Id:25

60.4.19 すべてのテストの詳細の表示

次の表にGETリクエスト構成を示します。

表60-95 すべてのテストを表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/tests

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests", "items": [
{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC", "contextId": "DCC7AC5803CF97B2E040F20AA05152EC",
"name": "Test1",
"testDriverTypeContextId": "1",

"testDriverTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "testDriverTypeName": "OFT",
"testAssets": {
"testAssetContextId": "DCBDEA617F62EC63E040F20AA0512492",
"testAssetUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492",
"testAssetName": "Asset001"
},
"testEnvironmentContextId": "DCBDF6F2FFC90069E040F20AA051215F",
"testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F",\\ "testEnvironmentName": "MedrecEnv",
"useEnvironmentLibrary": "false"
"testDriverContextId": "DCBD49A045FFD35BE040F20AA05150F5",
"testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT",
"mappingUrls": "xx.example.com:7011|FROM_APPLIANCE|MedRec/MedRec1/MedRecServer",
"trialsUri"://slc03rgd:5416/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC/trials"

}
]
}

60.4.20 コンテキストID指定によるテストの問合せ

次の表にGETリクエスト構成を示します。

表60-96 コンテキストID指定によってテストを問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC", "contextId": "DCC7AC5803CF97B2E040F20AA05152EC",
"name": "Test1",
"testDriverTypeContextId": "1",
"testDriverTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "testDriverTypeName": "OLT",
"testAssets": {
"testAssetContextId": "DCBDEA617F62EC63E040F20AA0512492",
"testAssetUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492",
"testAssetName": "Asset001"
},
"testEnvironmentContextId": "DCBDF6F2FFC90069E040F20AA051215F",
"testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv",
"useEnvironmentLibrary": "false",
"testDriverContextId": "DCBD49A045FFD35BE040F20AA05150F5",
"testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT",
"replaceUrls": {
"originalUrl": "testserver2.us.example.com",
"newUrl": "MedRec/MedRec1/MedRecServer",
"replaceType": "FROM_APPLIANCE"
},
"trialsUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC/trials" }

60.4.21 テストの作成

次の表にPOSTリクエスト構成を示します。

表60-97 テストを作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/tests

本文

{
"name": "Test100",
"testAssets": {
"testAssetContextId": "DCBDEA617F62EC63E040F20AA0512492"
},
"testEnvironmentContextId": "DCBDF6F2FFC90069E040F20AA051215F",
"testDriverContextId" : "DCBD49A045FFD35BE040F20AA05150F5",
"replaceUrls": {
"originalUrl": "testserver2.us.example.com",
"replaceType": "FROM_APPLIANCE"
}
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCE58A1CBF8B0D06E040F20AA0511AB5", "contextId": "DCE58A1CBF8B0D06E040F20AA0511AB5",
"name": "Test100",
"testDriverTypeContextId": "1",
"testDriverTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "testDriverTypeName": "OLT",
"testAssets": {
"testAssetContextId": "DCBDEA617F62EC63E040F20AA0512492",
"testAssetUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492",
"testAssetName": "Asset001"
},
"testEnvironmentContextId": "DCBDF6F2FFC90069E040F20AA051215F",
"testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv",
"useEnvironmentLibrary": "false",
"testDriverContextId": "DCBD49A045FFD35BE040F20AA05150F5",
"testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT",
"replaceUrls": {
"originalUrl": "testserver2.us.example.com",
"replaceType": "FROM_APPLIANCE"
},
"trialsUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCE58A1CBF8B0D06E040F20AA0511AB5/trials" }

60.4.22 テストの更新

次の表にPUTリクエスト構成を示します。

表60-98 テストを更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCE58A1CBF8B0D06E040F20AA0511AB5

本文

{
"name": "Test101",
"testAssets":{
"testAssetContextId": "DCBDEA617F62EC63E040F20AA0512492",
},
"testEnvironmentContextId": "DCBDF6F2FFC90069E040F20AA051215F",
"testDriverContextId" : "DCBD49A045FFD35BE040F20AA05150F5"
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{
"uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCE58A1CBF8B0D06E040F20AA0511AB5", "contextId": "DCE58A1CBF8B0D06E040F20AA0511AB5",
"name": "Test101",
"testDriverTypeContextId": "1",
"testDriverTypeUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_types/1", "testDriverTypeName": "OLT",
"testAssets":{
"testAssetContextId": "DCBDEA617F62EC63E040F20AA0512492",
"testAssetUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492", "testAssetName": "Asset001"
},
"testEnvironmentContextId": "DCBDF6F2FFC90069E040F20AA051215F",
"testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv",
"useEnvironmentLibrary": "false",
"testDriverContextId": "DCBD49A045FFD35BE040F20AA05150F5",
"testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT",
"replaceUrls": {
"originalUrl":"burepv14.us.example.com:7011",
"replaceType":"FROM_APPLIANCE",
"newUrl":"MedRec/MedRec1/MedRecServer"
},
"trialsUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCE58A1CBF8B0D06E040F20AA0511AB5/trials" }

60.4.23 テストの削除

次の表にDELETEリクエスト構成を示します。

表60-99 テストを削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCE58A1CBF8B0D06E040F20AA0511AB5

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

TestEntity has been deleted. Context Id:DCE58A1CBF8B0D06E040F20AA0511AB5

60.4.24 すべての試行の詳細の表示

次の表にGETリクエスト構成を示します。

表60-100 すべての試行を表示するためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/trials

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{ "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/trials", "items": [ { "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/trials/DCC75B3C889F0463E040F20AA0514349", "contextId": "DCC75B3C889F0463E040F20AA0514349", "name": "Trial1", "owner": "TAASUSER1", "status": "ERROR_SUBMITTING", "startTime": "1368671518000", "testUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC", "testName": "Test1", "testContextId": "DCC7AC5803CF97B2E040F20AA05152EC", "testAssetUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492", "testAssetName": "Asset001", "testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv", "testEnvironmentInstanceUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1", "testEnvironmentInstanceName": "MedrecEnv", "testEnvironmentInstanceContextId": "1", "testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT", "testDriverInstanceUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1", "testDriverInstanceContextId": "1", "testDriverInstanceName": "ManualTDInst", "oltTrialSettings": { "scriptVuCounts": { "name": "MedRec1Script", "value": "1" }, "rampupOptionIndex": "3", "rampupOptionLabel": "X Percent every Y Seconds", "rampupUserOrPercent": "0.1", "rampupSecondOrIteration": "5.0" } } ] }

60.4.25 コンテキストID指定による試行の問合せ

次の表にGETリクエスト構成を示します。

表60-101 コンテキストID指定によって試行を問い合せるためのGETリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/trials/DCC75B3C889F0463E040F20AA0514349

本文

なし

リクエスト・メソッド

GET

受け取るレスポンスの例を次に示します。

{ "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/trials/DCC75B3C889F0463E040F20AA0514349", "contextId": "DCC75B3C889F0463E040F20AA0514349", "name": "Trial1", "owner": "TAASUSER1", "status": "ERROR_SUBMITTING", "startTime": "1368671518000", "testUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC", "testName": "Test1", "testContextId": "DCC7AC5803CF97B2E040F20AA05152EC", "testAssetUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492", "testAssetName": "Asset001", "testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv", "testEnvironmentInstanceUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1", "testEnvironmentInstanceName": "MedrecEnv", "testEnvironmentInstanceContextId": "1", "testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT", "testDriverInstanceUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1", "testDriverInstanceContextId": "1", "testDriverInstanceName": "ManualTDInst", "oltTrialSettings": { "scriptVuCounts": { "name": "MedRec1Script", "value": "1" }, "rampupOptionIndex": "3", "rampupOptionLabel": "X Percent every Y Seconds", "rampupUserOrPercent": "0.1", "rampupSecondOrIteration": "5.0" } }

60.4.26 新しい試行の作成

次の表にPOSTリクエスト構成を示します。

表60-102 試行を作成するためのPOSTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/trials

本文

{ "name": "APITrial1",
"testContextId": "DCC7AC5803CF97B2E040F20AA05152EC",
"testEnvironmentInstanceContextId": "1",
"testDriverInstanceContextId": "1",
"startTime": null,
"oltTrialSettings":
{ "scriptVuCounts":
{ "name": "MedRec1Script", "value": "3" },
"rampupOptionIndex": "3",
"rampupUserOrPercent": "0.1",
"rampupSecondOrIteration": "5.0" }
}

リクエスト・メソッド

POST

受け取るレスポンスの例を次に示します。

{ "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/trials/DCE58A1CBF8D0D06E040F20AA0511AB5", "contextId": "DCE58A1CBF8D0D06E040F20AA0511AB5", "name": "APITrial1", "owner": "TAASUSER1", "status": "SCHEDULED", "startTime": "1368800849000", "testUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC", "testName": "Test1", "testContextId": "DCC7AC5803CF97B2E040F20AA05152EC", "testAssetUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492", "testAssetName": "Asset001", "testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv", "testEnvironmentInstanceUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1", "testEnvironmentInstanceName": "MedrecEnv", "testEnvironmentInstanceContextId": "1", "testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT", "testDriverInstanceUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1", "testDriverInstanceContextId": "1", "testDriverInstanceName": "ManualTDInst", "oltTrialSettings": { "scriptVuCounts": { "name": "MedRec1Script", "value": "3" }, "rampupOptionIndex": "3", "rampupOptionLabel": "X Percent every Y Seconds", "rampupUserOrPercent": "0.1", "rampupSecondOrIteration": "5.0" } }

60.4.27 試行の更新

注意:
これは、試行が「スケジュール済」ステータスの場合のみ適用できます。

次の表にPUTリクエスト構成を示します。

表60-103 試行を更新するためのPUTリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/trials/DCE58A1CBF8D0D06E040F20AA0511AB5

本文

{ "name": "NewTrialName",
"testContextId": "DCC7AC5803CF97B2E040F20AA05152EC",
"testEnvironmentInstanceContextId": "1",
"testDriverInstanceContextId": "1",
"startTime":1398800849000,
"oltTrialSettings":
{ "scriptVuCounts":
{ "name": "MedRec1Script", "value": "3" },
"rampupOptionIndex": "3",
"rampupUserOrPercent": "0.1",
"rampupSecondOrIteration": "5.0" }
}

リクエスト・メソッド

PUT

受け取るレスポンスの例を次に示します。

{ "uri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/trials/DCE58A1CBF8D0D06E040F20AA0511AB5", "contextId": "DCE58A1CBF8D0D06E040F20AA0511AB5", "name": "NewTrialName", "owner": "TAASUSER1", "status": "SCHEDULED", "startTime": "1398800849000", "testUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/tests/DCC7AC5803CF97B2E040F20AA05152EC", "testName": "Test1", "testContextId": "DCC7AC5803CF97B2E040F20AA05152EC","testAssetContextId": "DCBDEA617F62EC63E040F20AA0512492", "testAssetUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_assets/DCBDEA617F62EC63E040F20AA0512492", "testAssetName": "Asset001", "testEnvironmentUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environments/DCBDF6F2FFC90069E040F20AA051215F", "testEnvironmentName": "MedrecEnv", "testEnvironmentInstanceUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_environment_instances/1", "testEnvironmentInstanceName": "MedrecEnv", "testEnvironmentInstanceContextId": "1", "testDriverUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_drivers/DCBD49A045FFD35BE040F20AA05150F5", "testDriverName": "Default OLT", "testDriverInstanceUri": "https://example.com/em/websvcs/restful/extws/cloudservices/taas/v1/test_driver_instances/1", "testDriverInstanceContextId": "1", "testDriverInstanceName": "ManualTDInst", "oltTrialSettings": { "scriptVuCounts": { "name": "MedRec1Script", "value": "3" }, "rampupOptionIndex": "3", "rampupOptionLabel": "X Percent every Y Seconds", "rampupUserOrPercent": "0.1", "rampupSecondOrIteration": "5.0" } }

60.4.28 試行の削除

次の表にDELETEリクエスト構成を示します。

表60-104 試行を削除するためのDELETEリクエスト構成

機能

説明

URI

/em/websvcs/restful/extws/cloudservices/taas/v1/trials/DCE5F68EEF937640E040F20AA0514029

本文

なし

リクエスト・メソッド

DELETE

受け取るレスポンスの例を次に示します。

TrialEntity has been deleted. Context Id:DCE5F68EEF937640E040F20AA0514029

第XVII部

付録

この部は、次の付録で構成されています。

- 付録A「ユースケース: テスト・データのリフレッシュ」

A ユースケース: テスト・データのリフレッシュ

この付録では、本番データが更新されるたびに、アプリケーションの開発者とテスト実施者がEnterprise Managerを使用して、セキュアでストレージ効率のよいデータベースのクローンを迅速かつ簡単にオンデマンドでプロビジョニングする方法を示します。

この付録には、次のセクションがあります。

- テスト・データのリフレッシュにおける課題

- Enterprise Managerソリューション

- テスト・マスター・データベースの作成

- テスト・マスター・データベースのデータをマスクおよびサブセット化します

- データベース・クローンのオンデマンド作成

- シナリオ例の実装

- テスト・データの進行中リフレッシュ

A.1 テスト・データのリフレッシュにおける課題

通常、IT環境では、アプリケーションの開発とテストのために本番データの複数のコピーが必要となります。ただし、本番データのクローン全体のプロビジョニングは時間のかかるプロセスであり、データベース管理者、システム管理者およびストレージ管理者の間での調整が必要となるばかりではなく、大きなストレージ容量も必要となります。

アプリケーションの開発者またはテスト実施者がデータベースのクローンを必要とする場合、一般的には承認サイクルを経る必要があり、その後に煩雑で時間のかかるクローニング・プロセスを開始しますが、これには数日かかることもあります。クローンは複数のユーザーおよびアプリケーションで共有されますが、複数ユーザーによる共有が増える結果としてパフォーマンスが低下します。このような環境において、本番データベースへの変更を反映するためのテスト・データのリフレッシュは、通常は固定したスケジュールで行われ、必要な頻度では実施されないことがあります。その結果として、ともすれば、開発者およびテスト実施者が最新データを使用してテストすることの徹底が難しくなります。

A.2 Enterprise Managerソリューション

これ以降の項では、Enterprise Managerの機能を活用した、前述の課題に対するソリューションを提供します。その目標は、本番データベースの更新によって必要となった際にはいつでも、開発者およびテスト実施者がセキュアでサイズを減らした本番データベースのコピーをオンデマンドでプロビジョニング可能とすることです。

このソリューションでは、エンタープライズのDatabase as a Service (DBaaS)クラウド機能が有効化されていることが必要なことに注意してください。DBaaSを有効化する手順は、第12章「DBaaSクラウドの有効化」を参照してください。

このシナリオ例の基本フローを次の図に示します。

図A-1 Enterprise Managerソリューション

A.3 テスト・マスター・データベースの作成

このシナリオでは、アプリケーションのテストに使用する本番データベースのコピーである、テスト・マスター・データベースが管理者レベルのロールで作成されることを想定しています。Oracleにはテスト・マスター・データベースを作成するための様々なオプションが提供されていますが、このシナリオでは、管理者がRMANバックアップおよびRMANリストアの操作を使用して本番データベースのバックアップを作成し、それをテスト・マスターとしてリストアすることを想定しています。

RMANバックアップを使用して、定期的に予定された頻度で別々に、本番データベースの最新データでテスト・マスター・データベースをリフレッシュすることが期待されています。

A.4 テスト・マスター・データベースのマスクおよびサブセット

本番データをテストに利用可能とするためには、機密性があると特定されたデータは、テスト・マスター・データベース上でマスキング(またはスクランブル)される必要があります。理想的には、データ・サブセッティングも併用して、テストに必要なデータのみが含まれるようにデータベースのサイズを縮小する必要があります。

たとえば、ある企業が人事管理アプリケーションを開発中であり、従業員の社会保障と給与のデータを使用したテストを必要としているとしましょう。この機密データにはマスキングやスクランブルをかけることが可能ですし、それと同時に、従業員の所在地のような外部データは実際のテストに必要なデータ・サブセットから除外することもできます。

Oracleのインラインのマスキングおよびサブセッティングの機能を使用すると、すべて同じタスク・フローの中で、機密データをマスキングすると同時にデータベースのサイズを縮小することが可能です。これによって、機密性のある本番データを保護したうえで、大きなマスキング済本番データベースをテストのために格納するハードウェアのコストを大きく引き下げるという2つの目的がかなえられます。

A.5 データベース・クローンのオンデマンド作成

テスト・マスターの作成およびリフレッシュと、テストに使用するデータの保護とサブセッティングを行うプロセスの後には、アプリケーションの開発者およびテスト実施者(DBaaS用語ではセルフ・サービス・ユーザーとも呼ばれます)は、Database as a Serviceの主要なユーザー・インタフェースであるEnterprise Managerのセルフ・サービス・ポータルを使用して、テスト・マスター・データベースのクローンを迅速かつ簡単に作成できます。

この機能は、スナップ・クローン(Database as a Serviceによって提供され、Oracle Databaseの全機能を有するコピーを最小限のストレージ要件で作成可能にする機能)を通じて有効になります。スナップ・クローンでは、ストレージ要件を最小限としたうえで、ユーザーはテラバイト級のデータを含むテスト・マスターのクローンを、何時間もかけずにわずか数分で作成できます。

A.6 シナリオ例の実装

この項では、前項に概要を示したテスト・データ・リフレッシュ・ソリューションの実装に必要なタスクの概要を説明します。

A.6.1 Enterprise Managerでのロールの割当てと作成

ロール: スーパー管理者

ロールは、Enterprise Manager内でシステムおよびオブジェクトの権限を管理するために使用されます。ロールは、管理者とセルフ・サービス・ユーザーのどちらにも割り当てられる必要があります。

A.6.1.1 管理者ロールの管理者への割当て

このシナリオの中で様々なDBaaS設定タスクを行うユーザーに、次の管理者ロールを割り当てます。これらのロールは、Enterprise Manager内で即時提供されます。

- EM_SSA_ADMINISTRATOR: このロールを持つユーザーは、クローンを作成するセルフ・サービス・ユーザーの割当て制限と制約を定義できます。

- EM_STORAGE_ADMINISTRATOR: このロールのユーザーは、スナップ・クローンの使用に必要なストレージ・ハードウェアを登録する権限を持ちます。

このタスクを完了する手順は、第3.3項「ロールの定義およびユーザーの割当て」を参照してください。

A.6.1.2 セルフ・サービス・ユーザーへのカスタム・ロールの作成

テスト・マスター・データベースのクローンを作成するためにセルフ・サービス・ポータルを使用するユーザーには、カスタムのセルフ・サービス・ユーザーを作成する必要があります。通常、アプリケーション開発者や機能テスト実施者など、テストに必要な様々な機能グループのそれぞれに対してロールを作成します。

すべてのロールは、Enterprise Managerとともに提供されるEM_SSA_USERロールに基づきます。

このタスクを完了する手順は、第3.3.1項「セルフ・サービス・アプリケーション管理者およびユーザーのカスタム・ロールの作成」を参照してください。

A.6.1.3 セルフ・サービス・ユーザーの作成

各種のロールを作成した後に、クローンを作成する個々のテスト実施者または開発者に対してそれぞれセルフ・サービス・ユーザー・アカウントを作成します。各ユーザーは、前述のタスクで定義されたカスタム・ロールのいずれかに割り当てられます。

このタスクを完了する手順は、第3.3.2項「ユーザーの作成およびロールの割当て」を参照してください。

A.6.2 本番データベースのバックアップの作成

ロール: DBA

Oracle RMANバックアップ操作を使用して本番データベースのバックアップを作成します。このバックアップは、その後、クローンを作成するテスト・マスター・データベースの作成のためにリストアされます。

テスト・マスター・データベースの作成にはいくつかのオプションが利用可能ですが、作成されるバックアップ・データベースのマスキングとサブセッティングが可能であることからRMANのバックアップおよびリストアが使用されます。

データベースのバックアップを作成する手順は、次のドキュメントを参照してください。

http://www.oracle.com/pls/topic/lookup?ctx=em121&id=EMLCM93231

A.6.3 マスキングおよびサブセッティング用データの準備

ロール: DBAおよびセキュリティ・アナリスト

マスキングおよびサブセッティング用データの準備のため、次の手順を完了する必要があります。

A.6.3.1 マスキング方法およびサブセッティング方法の計画

開始する前に、保護の必要があるデータ、テストに必要なデータ、およびマスキングとサブセッティングを最適に実装する方法を決定します。

- マスキングが必要な機密データを特定します。

- 機密データを含む表および列の位置を特定します。Oracle Enterprise Managerのデータ検出およびモデリング機能を使用すると、パターン検索条件によってこのようなデータを簡単に検出できます。

- どのマスキング・アルゴリズムが企業のニーズに合致しているかを決定します。機密データベースの一般的な形式のマスキング用としてOracleが提供する書式を使用できるか、それともカスタム書式を作成する必要があるかを決定します。

- どの表が不要で除外可能であるなど、データをサブセッティングする最適な方法を決定します。

A.6.3.2 アプリケーション・データ・モデル(ADM)の作成

データ・サブセッティングとデータ・マスキングは、どちらもアプリケーション・データ・モデル(ADM)に依存します。ADMは、アプリケーション内部の参照関係や機密列などのアプリケーション・メタデータ情報を取得および格納するEnterprise Manager内のナレッジ・ベースです。

ADMを作成する手順は、次のドキュメントを参照してください。

http://www.oracle.com/pls/topic/lookup?ctx=em121&id=RATUG4045

A.6.3.3 マスキング定義の作成

Enterprise Managerのユーザー・インタフェースを使用してデータ・マスキング定義を作成し、機密列にマスキング形式を適用します。Oracleには、そのまま使用することも必要に応じて変更することも可能な、マスキング形式の多彩なライブラリが提供されています。カスタムのマスキング形式を作成することもできます。

このタスクを完了する手順は、次のドキュメントを参照してください。

http://www.oracle.com/pls/topic/lookup?ctx=em121&id=RATUG04000

A.6.4 ストレージ・サーバーの構成

Role: ストレージ管理者

スナップ・クローン機能には、作成されるデータベースのクローン用として適切なストレージが必要となります。ネイティブで提供されるストレージのサポートに加えて、Oracleでは、Oracle Sun ZFSファイル・システムを使用したスナップ・クローンに対するソフトウェア手法もサポートされています。

このシナリオでは、Oracle Sun ZFSファイル・システム・ストレージの利用を想定しています。基本フローは、まずZFSファイル・システムを構成し、次にストレージをEnterprise Managerに登録するというものです。最初の手順として、ZFSストレージ・サーバーに対してストレージの取得および割当てを行う必要があることに注意してください。

主な手順は次のとおりです。

- Enterprise Managerからストレージを管理できるユーザーを構成または作成します。

- ストレージ・ボリュームをホストするために使用するZFSプールを構成し、そのプールに対する権限を付与します。

- そのZFSプールに対する割当て制限を行い、ユーザーに権限を割り当てます。

- ユーザー名、プロトコル、ストレージ資格証明を指定して、ZFSファイル・システムをEnterprise Managerに登録します。

- ストレージ・ボリュームを作成します

このタスクを完了する手順は、第12.7.3.1項「ストレージ・サーバーの構成」を参照してください。

A.6.5 ストレージ・ボリューム上のテスト・マスター・データベースの作成

テスト・マスター・データベースは、スナップ・クローンのコピーが作成されるストレージ・ボリューム上に作成される必要があります。テスト・マスターは、前のポイント・イン・タイムで取得され、特定の間隔でリフレッシュされるスナップショットまたはRMANバックアップ・プロファイルから作成できます。

このタスクを完了する手順は、第20.5.6項「個別に同期されたテスト・マスターの作成」を参照してください。

A.6.6 テスト・マスター・データベースを有効化してスナップ・クローンを使用

テスト・マスター・データベースが作成されると、スナップ・クローンに有効化される必要があります。

- Enterprise Managerでストレージ登録ページに戻ります。

- テスト・マスター・データベースの構成がリフレッシュされると、ターゲットが自動的に検出されてストレージ登録ページ上に表示されます。テスト・マスター・データベースを選択し、ページ上部の「スナップ・クローンの有効化」オプションを選択します。
これでテスト・マスター・データベースのスナップ・クローンに対する準備が整いました。詳細は、第20.4.7項「スナップ・クローンのテスト・マスターの有効化」を参照してください

A.6.7 テスト・データのマスキングとサブセッティング

Role: セルフ・サービス管理者

テスト・マスターの準備が整うと、定義されたルールに従ってデータのマスキングとサブセッティングが可能となります。

本番データベースに変更が発生した場合には、テスト・マスター・データベースをリフレッシュする必要があります。本番データベースに変更を反映するには、マスキングとサブセッティングの規則の再検討が必要となる可能性があります。その場合には、新しいサブセット定義をテスト・マスター・データベースに適用できます。

A.6.7.1 サブセット定義の作成

Enterprise Managerユーザー・インタフェースを介してサブセット定義を作成することにより、データのマスキングとサブセッティングは同時に実行可能です。基本フローは次のとおりです。

- テスト・マスターをソース・データベースとして選択します。

- サブセットに含めるデータをフィルタする表ルールを定義します。領域見積りアクションを実行して、データベースのサイズがどれだけ削減されているか測定します。これは、ルールを微調整してデータベース・サブセットのサイズを変更する反復プロセスとなることがあります。

- 第A.6.3.3項「マスキング定義の作成」で作成したマスキング定義を参考にします。

- オプションとして、列ルールを使用して追加の列をマスキングしますが、通常、これはCLOB列やBLOB列などの垂直列となります。これはサブセットのサイズの削減にも役立ちます。

このタスクを完了する手順は、次のドキュメントを参照してください。

http://www.oracle.com/pls/topic/lookup?ctx=em121&id=RATUG4053

A.6.7.2 サブセット・スクリプトの保存と実行

サブセット定義が作成されたら、それをテスト・マスター・データベースに適用します。主な手順は次のとおりです。

- サブセット定義をZIPアーカイブとして保存します。

- そのアーカイブをテスト・マスター・データベース・ホスト上で抽出します。

- テスト・マスター・データベースに対してサブセット・スクリプトを実行して、データのマスキングおよびサブセッティングを適用します。

このタスクを完了する手順は、次のドキュメントを参照してください。

http://www.oracle.com/pls/topic/lookup?ctx=em121&id=RATUG4214

A.6.8 データベース・クラウド・セルフ・サービス・ポータルの構成

Role: セルフ・サービス管理者

ストレージの構成とテスト・マスター・データベースの設定が行われた後に、セルフ・サービス・ユーザーがテスト・マスター・クローンの作成に使用するセルフ・サービス・ポータルを構成する必要があります。

最初の手順は、Platform as a Service (PaaS)インフラストラクチャの作成です。PaaSゾーンには、クローンが作成されるターゲット(データベース・ホスト)のセット、およびこれらのターゲットにアクセス可能である(ロールに基づく)ユーザーに対する配置ポリシー制約が定義されます。たとえば、(APP_DEVロールを割り当てられた)開発者のグループにPaaSゾーンを作成して特定ホストのセットへのアクセス権を付与し、テスト実施者のグループには別のPaaSゾーンを作成して異なるホストのセットへのアクセス権を付与することもできます。

各ゾーン内のホストは、オペレーティング・システムおよび各ホストにインストールされたOracle Databaseのタイプおよびバージョンによって、プールへとグループ分けされます。たとえば、あるプールはLinux上でシングル・インスタンスのOracle Databaseリリース12.1.01で構成されたすべてのホストのために作成し、別のプールをSolaris上のOracle RAC用として作成するようなことが可能です。

ユーザーがスナップ・クローン機能を使用してテスト・マスター・データベースのクローンを作成できるようにするには、テスト・マスター・データベースのプロビジョニング・プロファイルを作成する必要があります。ユーザーによって作成されるクローンはこのプロファイルをベースとします。

最後に、前述の構成をカプセル化するために、スナップ・クローン・サービス・テンプレートが作成されます。セルフ・サービス・ユーザーがクローンを作成する際には、クローンが作成されるホストおよびデータベースを定義しているこのテンプレートが選択されます。

A.6.8.1 PaaSインフラストラクチャ・ゾーンの作成

テスト・マスターのクローンがデプロイされるホストが含まれるPaaSインフラストラクチャを作成します。

- ゾーンに1つ以上のデータベース・ホスト・ターゲットを追加します。

- それぞれのホストに配置ポリシー制約を指定します。

- このゾーンにアクセス可能なセルフ・サービス・ユーザー・ロールを選択します。

このタスクを完了する手順は、第11.2.2.1項「PaaSインフラストラクチャ・ゾーンの作成」を参照してください。

A.6.8.2 データベース・プールの作成

PaaSインフラストラクチャ・ゾーンの中で、各データベース・タイプに対して1つずつとなるように、1つ以上のデータベース・プールを作成します。

- スナップ・クローンに必要なホスト資格証明を指定します。

- データベース・プールが作成されるPaaSインフラストラクチャ・ゾーンを選択します。

- データベースがデプロイされる構成(シングル・インスタンスまたはクラスタ)、プラットフォームおよびバージョンを指定します。

- プール内の各ホストで実行可能なデータベース・インスタンスの数を指定します。

このタスクを完了する手順は、第11.2.2.2.1項「データベース・プールの作成」を参照してください。

A.6.8.3 リクエスト設定の構成

リクエストできる時間、その期間などを指定して、データベースのリクエスト設定を構成します。リクエスト設定を構成するには、次の内容を指定する必要があります。

- 将来の予約の長さ

- アーカイブの最大保存期間

- デフォルト・リタイア期間

このタスクを完了する手順は、第11.2.3項「リクエスト設定の構成」を参照してください。

A.6.8.4 ユーザー割当て制限の設定

割当て制限は、各セルフ・サービス・ユーザーが使用可能なDBaaSリソースの量を制御します。割当て制限を行うには次の手順を実行します。

- 割当て制限を行うセルフ・サービス・ユーザー・ロールを選択します。

- セルフ・サービス・ユーザーによって作成されたすべてのデータベースに割当て可能な、メモリーおよびストレージの総容量を指定します。

- ユーザーがリクエスト可能なデータベースの数を指定します。

このタスクを完了する手順は、第11.2.4項「割当て制限の設定」を参照してください。

A.6.8.5 スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成

テスト・マスター・データベースに対するプロビジョニング・プロファイルを作成します。次の手順で作成されるサービス・テンプレートがこのプロファイルを使用します。

- プロファイルを作成するデータベースとして、テスト・マスター・データベースを選択します。第A.6.6項「テスト・マスター・データベースを有効化してスナップ・クローンを使用」で説明されているように、データベースでスナップ・クローンが有効である必要があります。

- データベースへのアクセスが必要となる名前付き資格証明を指定します。

- プロファイルに対して一意な名前(「スナップ・クローン・プロファイル」など)を入力します。

このタスクを完了する手順は、第20.4.8項「スナップショットを使用したデータベース・プロビジョニング・プロファイルの作成」を参照してください。

A.6.8.6 サービス・テンプレートの作成

最後に、テスト実施者および開発者がテスト・マスター・データベースのクローンの作成に使用するサービス・テンプレートを作成します。

- 前の手順で作成したスナップ・クローン・プロファイルをテンプレートのベースとなるプロファイルとして選択します。

- データベース・タイプ(シングル・インスタンスまたはRAC)、データベースSIDおよびドメイン名など、データベース定義の詳細を指定します。

- PaaSインフラストラクチャ・ゾーンおよびデータベース・プールを選択します。このサービス・テンプレートを使用して作成されるデータベースのクローンは、このプールにデプロイされます。ホスト・ターゲットは「参照ホスト」フィールドに移入されています。

- データベースのクローンが使用するストレージ・ボリュームを構成します。デプロイされるデータベースの新しいマウント・ポイントに対する接頭辞およびブロックの変更に必要となる領域の量を指定します。

- クローンされたデータベース上にセルフ・サービス・ユーザーが取得可能なスナップショットの数を指定します。

- スナップショット・ポリシーおよびクローンのシステム・スキーマに対する資格証明を指定します。

- 新しいデータベースの操作に影響する可能性のある初期化パラメータを構成します。

- このサービス・テンプレートにアクセス可能なセルフ・サービス・ユーザー・ロールを選択します。

このタスクを完了する手順は、第20.4.9項「スナップ・クローン・プロファイルを使用したサービス・テンプレートの作成」を参照してください。

A.6.9 テストで使用するデータベース・クローンのオンデマンド作成

Role: セルフ・サービス・ユーザー

この時点で、Enterprise Manager Cloud Controlが提供するデータベース・クラウド・セルフ・サービス・ポータルのインタフェースは、テスト実施者および開発者が必要なときにはいつでも、テスト・マスター・データベースのクローンの作成に使用可能となっています。セルフ・サービス・ユーザーが従う必須の手順は次のものです。

- テスト・マスター・サービス・テンプレートを使用テンプレートとして選択します。

- クローンがデプロイされるPaaSインフラストラクチャ・ゾーンを選択します。

このタスクを完了する手順は、第22.2項「データベースのリクエスト」を参照してください。

A.7 テスト・データの進行中リフレッシュ

テスト・データのリフレッシュをサポートするインフラストラクチャが設定されると、本番データに施された更新を反映するために、データの定期的リフレッシュの計画を導入する必要があります。データのリフレッシュが必要となるたびに次の手順を繰り返す必要があります。

- 最新の本番データを取得するには、テスト・マスター・データベースをリフレッシュする必要があります。このタスクを完了する手順は、第20.5.10項「テスト・マスター・データベースのリフレッシュ」を参照してください。

- テスト・マスターをリフレッシュした後、スナップショット・ベースのデータベース・プロビジョニング・プロファイルの新しいリビジョンを作成する必要があります。このタスクを完了する手順は、第20.5.11項「スナップショット・プロファイルのリフレッシュ」を参照してください。

- セルフ・サービス・ユーザーは、スナップショット・ベースのデータベース・プロビジョニング・プロファイルの新しいリビジョンを使用してこのデータベース・インスタンスをリフレッシュし、最新の本番データを反映できます。第22.3項「データベースのリフレッシュ」を参照してください。

索引
A B C D E F G H I J L M N O P Q R S T U V W Y Z

A

アカウント

vDC, 34.3.3

OVMイベントの確認, 5.18 ポリシーのアクティブ化および非アクティブ化, 6.6 コンテンツの追加, 34.2.1 追加

ホストをPaaSインフラストラクチャへ, 11.2.1

ミドルウェア・プールをチャージバック・アプリケーションへ, 25.7

Oracle VM Manager, 図, 5.3

ターゲットの追加

チャージバック, 43.2.6

管理ダッシュボード

データベースのリフレッシュ, 20.3.8

管理グループ機能, 2.2.5 管理操作, 記憶域リポジトリでの実行, 5.10.1 API

エラー・レスポンス・メッセージ, 45.4.9

Testing as a Service, 60

アプリケーション・ホームページ, 表示, 28.7 アプリケーション・リソース・モデル, 60.3.1 アセンブリ, クラウドの設定, 5.12 アセンブリ

バイナリ・ファイルの前提条件, 9.8.3.1.1

コンポーネント, 作成, 9.8.3.1.1, 41.3

定義, 9.8.3.1.1, 9.8.4

デプロイ, 9.8.4

インスタンス, 定義, 9.8.4

アセンブリ・デプロイメント

デプロイメント構成, 図, 9.8.4

インスタンスの詳細, 図, 9.8.4

ネットワークとエージェント, 図, 9.8.4

確認ページ, 図, 9.8.4

アセンブリ・インスタンス

パブリック・ネットワークおよびプライベート・ネットワークの指定, 9.8.4

アセンブリ・ネットワーク, 定義, 9.8.4 AssemblyInstance, 定義, 59.2.3 割当て

ユーザー, 3.3

仮想ドライブ, .isoファイル, 5.12

認証

プロトコル, 3.4

スキーム, 3.4

自動ストレージ管理(ASM), 15.1.5

B

BI Publisher

チャージバックとの統合, 43.3.3

統合プランナとの統合, 44.2.6.1, 44.2.6.2

ブループリント

概要, 57.1

デプロイ, 57.5

グラフィカル表現, 57.7.3

使用, 57.2

ビジネス階層

チャージバック

ビジネス階層, 43.1.2.3

LDAPサーバーからインポート, 43.2.5.4

C

Cache-Control, 45.4.5

チャージ・プラン

ターゲットへの割当て, 43.2.8

チャージ傾向

チャージバック, 43.3.1

チャージバック, 43.1.2.2

ターゲットの追加, 43.2.6

アプリケーション, ミドルウェア・プールへの追加, 25.7

ターゲットへのチャージ・プランの割当て, 43.2.8

ターゲットへのコスト・センターの割当て, 43.2.7

BI Publisher, 43.3.3

構成, 25.7

通貨, 43.2.3

詳細, 表示, 8.6

レポート生成, 43.3.3

セルフ・サービス・アプリケーション, 43.2.2

設定, 42.2.9

ユニバーサル・メトリック, 43.1.2.2

ユニバーサル・レートの調整, 43.2.4.3

使用状況とチャージの傾向, 43.3.1

使用状況のメータリング

チャージバック, 43.1.2

チャージ・プラン・メトリック

構成ベース, 43.2.1

クローニング

ゲスト仮想マシン, 9.7.5

クラウド

API

共通の動作, 45.4

計算, 45 パフォーマンス・ポリシーの定義, 6.4 定義, 2.3.3 インフラストラクチャ, 5.1 プラグインのインストール, 3.2 管理

迅速なデプロイメント, 2.1

プロビジョニング, 2.1

サービスのクオリティ, 2.1

リソースの伸縮性, 2.1

Oracle Management AgentおよびCloud Control, 11.2.1 ポリシー

定義, 6.1

監視, 6.2

ポリシー・グループ, 6.8

タイプ, 6.1

表示, 6.2

ターゲットの表示, 6.3, 6.3

リソースのデータ・モデル, 46.3 クラウド・コンピューティング

チャージバック

クラウド・コンピューティング, 43.1.1

Cloud Control

管理エージェント, 11.2.1

「クラウド・ポリシー」のホーム・ページ, 図, 6.2 クラウド・セルフ・サービス・ポータルのホームページ, 8.1 クラウド・サービス・ファミリ, 11.1

ミドルウェア, 13.1

クラスタ・データベース・ホーム・ページの表示

QoSステータス, 22.8

表示, 22.8

ターゲットをグループに照合して管理性を向上, 2.2.5 共通の動作, クラウドAPI, 45.4 共通リソース属性, API, 45.4.7 構成

チャージバック, 25.7

ゲスト仮想マシン, 9.7.6

同じOracleホームから実行中のリスナー, 12.6

SIHA Oracleホームから実行中のリスナー, 12.6

権限委任設定, 3.5

リクエスト設定, 25.4

セルフ・サービス・ログイン・ページ, 3.6.1

セルフ・サービス・ポータル, 7.1

サーバー・ロード・バランサ(SLB), 3.6.3

ソフトウェア・ライブラリ・ユーザー, 5.16.3

ストレージ・サーバー, 12.7.3.1

VLANグループ, 5.7.2, 5.7.3

YUMリポジトリ, 5.17.1

管理エージェントへの接続, 12.7.4.1 統合プランナ

使用, 44.2

統合制約, 44.1.2 統合プランナ

概要, 44.1

統合プランナ

BI Publisher, 44.2.6.1, 44.2.6.2

統合プランナ, Enterprise Manager, 2.2.1 統合プロジェクト

作成, 44.2.1

定義, 44.1.1

統合シナリオ

カスタム, 44.2.2

定義, 44.1.1

評価, 44.2.2, 44.2.4

事前構成済, 44.2.1.5

契約上のサービス・レベル合意(SLA), 2.2.5 コスト・センター

ターゲットへの割当て, 43.2.7

チャージバック

コスト・センター, 43.1.2.3

作成, 43.2.5.3 新しい試行の作成TaaS API例, 60.4.26 テスト環境インスタンスの作成TaaS API例, 60.4.12 テストの作成TaaS API例, 60.4.21 資格証明の作成, 34.2.1 データ・ソースの作成ページ, 図, 28.3.3 1つのテスト・ドライバ・インスタンスの作成TaaS API例, 60.4.17 パフォーマンス・ポリシーの作成ページ, 図, 6.4 スケジュール・ポリシーの作成ページ, 図, 6.5 記憶域リポジトリの作成ポップアップ, 図, 5.10 テンプレートの作成: ファイルのアップロード・ページ, 9.8.3.1.2 テスト・マスターの作成

ライブ・スタンバイ・データベース, 20.4.6

仮想ディスクの作成: ファイルのアップロード・ページ, 9.8.3.1.4 ゾーンの作成ページ, 5.15 作成

アセンブリ・コンポーネント, 9.8.3.1.1

自動DRSおよびDPMポリシー, 6.9.1

カスタムのSSAユーザー・ロール, 3.3.1.2, 3.3.1.3

Schema as a Service用のデータベース・プール, 16.2.1

デプロイメント・プラン, 41.4

ゲスト仮想マシン, 9.7.1

ISOコンポーネント, 9.8.3.1.3

ミドルウェア・ホーム, 13.3.2

ミドルウェア・プール, 25.2, 26.4.1

複数の仮想LAN (VLAN), 5.7.2, 5.7.3

名前付き資格証明, 12.2

ネットワーク・プロファイル, 5.8

ネットワーク, ポートおよびVLANインタフェースの構成ページ, 5.7.4

ネットワーク, 前提条件, 5.7.4

PaaSインフラストラクチャ・ゾーン, 11.2.2.1, 11.2.2.1

PaaSインフラストラクチャのPaaSプール, 11.2.2.2

プロビジョニング・プロファイル, 13.3.1

PXEブート可能なゲスト仮想マシン, 9.8.7

リポジトリのエクスポート, 前提条件, 5.12.1

サービス・テンプレート, 25.6

Schema as a Service用のサービス・テンプレート, 16.6, 16.7

DBCAテンプレート・プロファイルを使用したサービス・テンプレート, 15.1.5

RMANバックアップ・プロファイルを使用したサービス・テンプレート, 19.1.5, 19.2.1, 20.4.13, 20.6.2

記憶域リポジトリ, 5.10

ストレージ・サーバー, 図, 5.9

テンプレート・コンポーネント, 9.8.3.1.2

テスト管理者, 41.2

ユーザー, 3.3.2

仮想ディスク・コンポーネント, 9.8.3.1.4

仮想マシン, 9.8.4

仮想サーバー・プール, 5.14

仮想IPアドレス, 5.14

仮想サーバー・プール, 5.14 VLANグループ, 5.7.2, 5.7.3 ゾーン, 5.15, 9.4.2 ゾーン, 図, 5.15 コスト・センターの作成, 43.2.5.3 ユニバーサル・チャージ・プランの作成, 43.2.4.2 拡張チャージ・プランを作成する, 43.2.4.3 資格証明

管理エージェント, 12.7.4.1

OMS要件用の設定, 9.8.3.1.1

プロビジョニング用の設定, 12.2

タイプ, 12.2

暗号化ユニット, 34.2.6.2.2 通貨

チャージバック, 43.2.3

カスタムのSSAユーザー・ロール, 作成, 3.3.1.2, 3.3.1.3 カスタマイズされた

ログイン後のページ, 図, 3.6.1

SSAログイン・ページ, 図, 3.6.1

カスタマイズ

ストレージ・エージェント・プロキシ, 12.7.3.2

CustomParametersリソース・モデル, 60.3.7

D

データ・ライフサイクル管理, 18.1

データ共有, 43.3.5

データソース

編集, 28.3.3.1

データベース

コンテナ・データベース, 12.5

作成

Schema as a Service用のプール, 16.2.1

Schema as a Service用のサービス・テンプレート, 16.6, 16.7

デプロイ, 12.4 プラガブル・データベース, 17.6, 17.7

ホーム, 22.9

サービス・テンプレート, 17.6, 17.7

プロビジョニング

RMANバックアップの使用, 19.1, 50.7.1, 50.7.2

プラガブル・データベースのプロビジョニング, 17.1, 50.4 プロビジョニング・プロファイル

DBCAテンプレートを使用した作成, 15.1.2

既存のRMANバックアップを使用した作成, 19.1.2.2, 20.6.1

エクスポート・スキーマ・オブジェクトを使用した作成, 16.3, 17.3

RMANバックアップを使用した作成, 19.1.2.1

スナップショットを使用した作成, 20.4.8

セルフ・サービス・ポータル, 22.1 サービス, 定義, 22.5 開始, 22.6 停止, 22.6 セルフ・サービス・ポータルを使用, 22.1 データベース

プラガブル・データベース

プール, 17.2.1

Database as a Service (DBaaS)

サービス・モデル, 2.3.1

データベース・インスタンス・ホーム・ページ, 表示, 22.6 データベース・プール・ホーム・ページ, 表示, 29.8 データベース・プロビジョニング・プロファイル, 2.3.4 データベース・セルフ・サービス・ポータル, 22.1, 22.1, 22.1 データベース・サービス・ホーム・ページ, 表示, 22.5 データベース・ソフトウェア・メンテナンス, 23.1

ゴールド・イメージの作成, 23.2

新規イメージ・バージョンの作成, 23.5.1

イメージのデプロイ, 23.4

イメージへのサブスクライブ, 23.3

データベースの更新, 23.4.3

ワークフロー, 23.1

Database-as-a-Service (DBaaS)クラウド, 2.2.2 データベース・ソフトウェア

プロビジョニング, 12.3

DBaaSユースケース, 14.1, 50.1 DBCAテンプレート・プロファイル, 使用してサービス・テンプレートを作成, 15.1.5 デフォルトSDK, オーバーライド, 12.7.3.2 定義

パフォーマンス・ポリシー, 6.4

ポリシー・グループ, 6.8

割当て制限, 25.5

リクエスト・パージ・ポリシー, 5.16.5

ロール

EM_CLOUD_ADMINISTRATOR, 3.3

EM_SSA_ADMINISTRATOR, 3.3

EM_SSA_USER, 3.3

スケジュール・ベースのポリシー, 6.5 ストレージQoS, 5.16 停止したテスト・ドライバ・インスタンスの削除TaaS API例, 60.4.18 停止したテスト環境インスタンスの削除TaaS API例, 60.4.14 テストの削除TaaS API例, 60.4.23 試行の削除TaaS API例, 60.4.28 削除

デプロイ済アプリケーション, 28.3.1.2

PaaSインフラストラクチャ・ゾーン, 11.2.2.1.2

ゾーン, 9.4.3, 9.4.4, 9.7.8, 9.7.9

アプリケーションのデプロイ・ページ, 図, 28.3.1 デプロイ

アセンブリ, 9.8.4

データベース, 12.4

ISOイメージ, 9.8.6

事前構成されたJava EEアプリケーション, 28.3.1

テンプレート, 9.8.5

仮想マシン

インフラストラクチャ要件, 9.8.3

プロビジョニング, 9.8.2

デプロイメント

情報

表示, 42.4.13

プラン, 作成, 41.4 デプロイ・プラン

Oracle VM Server for SPARC, 34.2.6.4

検出

Oracle VM Manager, 5.3.4

Oracle VM Server, 5.5

仮想サーバー, 図, 5.5

個別同期されたテスト・マスター

スナップ・クローンの作成, 20.5

分散電源管理(Distributed Power Management: DPM)ポリシー, 6.9 DRSおよびDPMポリシー, 自動化されたポリシーの作成, 6.9.1 動的プライベート・ネットワーク, 34.3.2 リソースの動的スケジューリング(Dynamic Resource Scheduling: DRS)ポリシー, 6.9

E

編集

データ・ソース, 28.3.3.1

既存のMWaaSサービス・テンプレート, 25.6

ゲスト仮想マシン, 9.7.6

PaaSインフラストラクチャ・ゾーン, 11.2.2.1.1

ストレージ上限, 12.7.6.1

仮想サーバー, 9.6.2

仮想サーバー・プール, 5.14.1

ゾーン, 9.4.2

EM_INFRASTRUCTURE_ADMIN権限, 3.1.2 EM_SSA_ADMINISTRATOR, データベース・ソフトウェアのプロビジョニング, 12.3 EM CLI, 設定, 3.1.3 メトリック収集の有効化

共有データベース用, 43.2.6.1

Enterprise Manager

インシデント管理システム, 2.2.5

Enterprise Manager統合プランナ, 2.2.1 Enterprise Managerストア, 入手可能な機能的な更新, 3.1 エンタープライズ・ユーザー・セキュリティベースの認証, 3.4 エンタープライズ・ユーザー・セキュリティ(EUS), 3.4 エラー・レスポンス・メッセージ, API, 45.4.9 テスト環境インスタンスおよびテスト・ドライバ・インスタンス上での操作の実行TaaS API例, 60.4.13 拡張チャージ・プラン

チャージバック

拡張チャージ・プラン, 43.1.2.2

作成, 43.2.4.3 更新, 43.2.4.6

F

迅速なデプロイメント, 可能, 2.1

ファイル・システム, 図, 5.9

フル・クローン, 19.1

RMANバックアップ, 19.1

RMAN複製, 19.2

フル・クローン, 18.2

RMANバックアップ, 19.1

G

一般的な権限, 付与, 3.3.3.1

レポートの生成

チャージバック, 43.3.3

コンテキストID指定による1つのテスト・アセットの取得TaaS API例, 60.4.4 コンテキストID指定による1つのテストの取得TaaS API例, 60.4.20 コンテキストID指定による1つのテスト・ドライバの取得TaaS API例, 60.4.8 コンテキストID指定による1つのテスト・ドライバ・インスタンスの取得TaaS API例, 60.4.16 コンテキストID指定による1つのテスト環境の取得TaaS API例, 60.4.6 コンテキストID指定による1つのテスト環境インスタンスの取得TaaS API例, 60.4.11 コンテキストID指定による1つの試行の取得TaaS API例, 60.4.25 コンテキストID指定によるテスト・ドライバ・タイプの取得TaaS API例, 60.4.9 付与

一般的な権限, 3.3.3.1

プロビジョニング用の権限, 3.3.3.4

ロール, 3.3.3.3

ターゲット権限, 3.3.3.2

ゲスト仮想マシン

クローニング, 9.7.5

作成, 9.7.1

定義, 9.7.2

デプロイ, 9.8

デプロイメント・オプション, 9.8.2

編集, 9.7.6

高可用性の有効化, 9.8.4

インフラストラクチャ要件, 9.8.3

インスタンス

リソース構成パラメータの変更, 9.8.4

作成の前提条件, 9.7.1 Oracle VMテンプレートを使用したプロビジョニング, 9.8.5 OVAを使用したプロビジョニング, 9.8.4 再起動, 9.7.4.2 物理CPUの使用可能量の制限, 9.8.4 テンプレートとして保存, 9.7.7 物理CPUへのアクセスの優先度の指定, 9.8.4 開始, 9.7.4 停止, 9.7.4 ゲスト仮想マシンのホームページ, 9.7.2

H

HTTPステータス・コード, 45.4.6

ハイパーバイザ, 9.6.1

I

アイコン

コンテンツの追加, 34.2.1

インシデント管理システム, 2.2.5 Infrastructure as a Service (IaaS)

サービス・モデル, 2.3.1

Infrastructure as a Service (IaaS)

設定と使用, 4.2

インフラストラクチャ・クラウド・ホーム・ページ

図, 5.3, 9.1

表示, 9.1

Infrastructure-as-a-Service (IaaS)クラウド, 2.2.2 インストール

管理対象外サーバー上の管理エージェント, 11.2.1

Oracle Management Agentを管理対象外ホストに, 11.2.1

プラグイン, 3.2

同期テスト・マスター

スナップ・クローンの作成, 20.4

Intelligent Platform Management Interface (IPMI), 9.6.2 ISOコンポーネント, 作成, 9.8.3.1.3 ISOのデプロイ・ページ, 図, 9.8.6

J

Java EEコンポーネント, ソフトウェア・ライブラリへのアップロード, 28.6

JavaScript Object Notation, 45.4.3

L

LDAPサーバー

ビジネス階層のインポート, 43.2.5.4

すべてのアプリケーションのリストTaaS API例, 60.4.1 すべてのテスト・アセットのリストTaaS API例, 60.4.3 すべてのテスト・ドライバのリストTaaS API例, 60.4.7 すべてのテスト環境インスタンスのリストTaaS API例, 60.4.10, 60.4.15 すべてのテスト環境のリストTaaS API例, 60.4.5 すべてのテストのリストTaaS API例, 60.4.19 すべての試行のリストTaaS API例, 60.4.24 論理

プール, 2.3.2

ゾーン, 2.3.2

M

マシン・サイズ, 設定, 5.16.2

仮想サーバーのメンテナンス, 9.6.5

メンテナンス・モード, 仮想サーバー, 9.6.5

MANAGE_SELF_UPDATE権限, 3.1.2

管理エージェント資格証明, 12.7.4.1

管理

ストレージのアクセス権限, 12.7.6.2

ストレージ割当て, 12.7.6.1

ストレージ・サーバー, 補足情報, 12.7.2

仮想化ターゲット

OVMマネージャのホームページ, 9.2

ゾーン, 9.4.1 最大送信単位のサイズ, 設定, 5.7.2, 5.7.3 メータリングおよびチャージバック機能, 2.2.6 Metricリソース・モデル, 60.3.15 MetricValueリソース・モデル, 60.3.16 Microsoft Active Directoryベースの認証, 3.4 ミドルウェア

ミドルウェア・ホームの作成, 13.3.2

as a Service (MWaaS)有効化, 13.3, 26.1

ミドルウェア・プール・ホーム・ページの表示, 29.11

Middleware as a Service (MWaaS)

有効化, 13.3, 26.1

サービス・モデル, 2.3.1

設定と使用, 4.5

ミドルウェア・プール

作成, 25.2, 26.4.1

定義, 2.3.4, 25.2, 26.4.1

詳細情報の取得, 29.11

ミドルウェア・プール・ホーム・ページ, 表示, 29.11 ミドルウェア・プロビジョニング・プロファイル, 2.3.4 ミドルウェア・セルフ・サービス・ポータル, 図, 28.1 ミドルウェア・サービスのホームページ

図, 28.3

用途, 28.3

表示, 28.3

ミドルウェア・サービス

ミドルウェア・セルフ・サービス・ポータル, 28.1

Middleware-as-a-Service (MWaaS)クラウド, 2.2.2 ゲスト仮想マシンの構成の変更, 9.7.6 クラウド・ポリシーの監視, 6.2 MTUフィールド, 設定, 5.7.2, 5.7.3 MWaaSアプリケーションのホームページ, 図, 28.7 MWaaSセルフ・サービス・ポータル

設定, 25.1, 27.1

表示, 28.1

MWaaSサービス・テンプレート, 編集, 25.6 My Oracle Support, クラウド管理機能, 2.2.5

N

名前付き資格証明, 作成, 12.2

NetAppハードウェア・ライセンス, 12.7.3.1

NetAppストレージ・サーバー, 設定, 12.7.3.1

ネットワーク・ブータブル(PXEブート)仮想マシン, 9.8.7

ネットワーク・プロファイル

DNSサーバー, 5.8

ドメイン名, 5.8

ゲートウェイ, 5.8

ネットマスク, 5.8

設定, 5.8

IPアドレスの指定, 5.8

ネットワーク・プロファイル・ページ, 図, 5.8 ネットワーク・ロール

クラスタ・ハートビート, 5.7.4

ライブ・マイグレーション, 5.7.4

サーバー管理, 5.7.4

ストレージ, 5.7.4

仮想マシン, 5.7.4

ネットワーク・タイプ, 設定, 5.16.1 NetworkInterface, 59.2.7 ネットワーク, 設定, 5.7 NVRAMRC価, 34.2.6.2.4

O

OFTAssetScriptリソース・モデル, 60.3.8

OftAssetScriptCsvDatabanksリソース・モデル, 60.3.9

OftDatabaseDatabanksリソース・モデル, 60.3.11

OftPlaybackSettingsリソース・モデル, 60.3.10

OftTrialAssetExecutionリソース・モデル, 60.3.20

OltAgentリソース・モデル, 60.3.26

OltCounterリソース・モデル, 60.3.18

OltCounterValueリソース・モデル, 60.3.19

OltScenarioリソース・モデル, 60.3.6

OltSessionリソース・モデル, 60.3.17

OMS

エージェント・ファイル・システム, 9.8.3.1.3

位置, 9.8.3.1.4

資格証明の設定, 9.8.3.1.1 OMS共有ファイル・システムの場所, 9.8.3.1.3, 9.8.3.1.4 Operationリソース・モデル, 60.3.23 Oracle Access Manager (OAM) SSO, 3.4 Oracle Cloud

論理プール, 2.3.2

論理ゾーン, 2.3.2

Oracle Cloud Compute構成, 44.1 Oracle Internet Directory (OID)ベースの認証, 3.4 Oracleリスナー, データベース・ホストに設定, 12.6 Oracle Management Service (OMS), SSAリクエストのルーティング, 3.6.3 Oracle Solaris 11ソフトウェア更新ライブラリ

コンテンツの追加, 34.2.1

Oracle VM Manager

登録, 5.3, 5.3

Oracle VMネットワーク, 5.7

仮想ローカル・エリア・ネットワーク(VLAN)グループ, 5.7.2, 5.7.3

Oracle VM Server

仮想サーバー・プールの作成, 5.14

検出, 5.5

ファイル・システム, 5.9

パッチの適用, 5.17

ストレージ・サーバー, 設定, 5.9

仮想サーバー, 5.5

仮想サーバー・プール, 5.14

仮想化ソフトウェア(ハイパーバイザ), 5.5

Oracle VM Server for SPARC

デプロイメント・プラン, 34.2.6.4

要件, 34.2.6.2.1, 34.2.6.2.2, 34.2.6.2.3

サーバー・プール, 34.2.6.4

オーバーライド

デフォルトSDK, 12.7.3.2

サード・パーティ・サーバー・コンポーネント, 12.7.3.2

OVMイベント, 確認, 5.18 OVMマネージャ

ホームページ, 9.2

ホームページ, 図, 9.2

OVMマネージャ・ターゲット, 同期, 5.4 OVMマネージャ, リスト, 9.3

P

PaaSインフラストラクチャ

ホストの追加, 11.2.1

PaaSプールの作成, 11.2.2.2

PaaSプール, 図, 11.2.2.2

PaaSインフラストラクチャ・ゾーン, 2.3.4

作成, 11.2.2.1

ミドルウェア・ホームの作成, 13.3.2

データベース・プール・ホーム・ページ, 29.8

削除, 11.2.2.1.2

編集, 11.2.2.1.1

ミドルウェア・プール, 25.2, 26.4.1

図, 11.2.2.1

前提条件, 11.2.2.1

親リポジトリ, 34.2.1 パッチ適用, Oracle VM server, 5.17 パフォーマンス・ポリシー

定義, 6.4

Platform as a Service (PaaS)

サービス・モデル, 2.3.1

設定

使用, 4.3

プラグイン

定義, 3.2

インストール, 3.2

ポリシー

アクティブ化および非アクティブ化, 6.6

グループの定義, 6.8

分散電源管理(Distributed Power Management: DPM), 6.9

リソースの動的スケジューリング(Dynamic Resource Scheduling: DRS), 6.9

スケジュール・ベース, 6.5

表示, 8.8

ポリシー・グループ

定義, 6.7

定義, 6.7

例, 6.8.2

PowerBroker, 3.5 Preboot Execution Environment(PXE), 9.8.7 プリファレンス, 表示, 8.9 前提条件

アセンブリ・バイナリ・ファイル, 9.8.3.1.1

YUMリポジトリの構成, 5.17.1

ゾーンの作成, 5.15, 5.15

アセンブリ・コンポーネントの作成, 9.8.3.1.1

データベース・プロビジョニング・プロファイルの作成, 20.4.8

ミドルウェア・ホームの作成, 13.3.2

ネットワークの作成, 5.7.4

PaaSインフラストラクチャ・ゾーンの作成, 11.2.2.1

PXEブート可能なゲスト仮想マシンの作成, 9.8.7

リポジトリのエクスポートの作成, 5.12.1

ゲスト仮想マシンのプロビジョニング, 9.8.6

ISOイメージを使用したゲスト仮想マシンのプロビジョニング, 9.8.6

テンプレートを使用したゲスト仮想マシンのプロビジョニング, 9.8.5

ゲスト仮想マシンのプロビジョニング, 9.8.3

ストレージ・サーバーの登録, 12.7.3

セルフ・サービス・ポータル, 7.1

自己更新機能, 3.1

Testing as a Service, 42.1

仮想サーバー・プール, 5.14

提示されたサーバー・ページ, 図, 5.11 プライベート・ネットワーク, 34.3.4.2

動的, 34.3.2

静的, 34.3.2

プライベートvNet, 34.3.2

作成, 34.3.4.2

権限委任設定, 構成, 3.5 権限委任ツール, sudoおよびPowerBroker, 3.5 権限

ロール, 付与, 3.3.3

EM_INFRASTRUCTURE_ADMIN, 3.1.2

プロビジョニング, 付与, 3.3.3.4

MANAGE_SELF_UPDATE, 3.1.2

ストレージのアクセスの管理, 12.7.6.2

NetAppハードウェア・ユーザー, 12.7.3.1

アクセス権, 12.7.3.1

VIEW_SELF_UPDATE, 3.1.2

Oracleデータベースのプロビジョニング・デプロイメント・プロシージャ, 12.4 プロビジョニング

資格証明, 設定, 12.2

PaaSインフラストラクチャ・ゾーン内のデータベース・インスタンス, 29.8

データベース・ソフトウェア, 12.3

RMANバックアップを使用したデータベース, 19.1, 50.7.1, 50.7.2

ゲスト仮想マシン

ISOイメージの使用, 9.8.6

ISOイメージを使用したゲスト仮想マシン, 9.8.6 OVAを使用したゲスト仮想マシン, 9.8.4 テンプレートを使用したゲスト仮想マシン

前提条件, 9.8.5

ゲスト仮想マシン, 9.8.2 プロファイル, 作成, 13.3.1 仮想化システム, 9.8.1 PXEブート可能なゲスト仮想マシン, 作成, 9.8.7

Q

QoS

優先度クラス, 9.8.4

設定, 5.16

クラスタ・データベース・ホーム・ページのステータス, 22.8

サービスのクオリティ, 向上, 2.1 コンテキストID指定による1つのアプリケーションの問合せTaaS API例, 60.4.2 割当て制限

定義, 11.2.4, 25.5

サンプル検証ログ, 11.2.4

設定, 11.2.4, 25.5

QuotaUsage Resourceリソース・モデル, 60.3.4

R

事前構成されたJava EEアプリケーションの再デプロイ, 28.3.1

SSAリクエストのリダイレクト, 3.6.3

仮想サーバーの再検出, 5.6

テスト・マスターのリフレッシュ, 20.5.10

登録

Oracle VM Manager, 5.3

ストレージ・サーバー

補足情報, 12.7.2

概要, 12.7.1

前提条件, 12.7.3

リポジトリベースの認証, 3.4 Representational State Transfer API, 45 リクエスト・パージ・ポリシー, 定義, 5.16.5 リクエスト設定

構成, 25.4

リクエスト

サーバーの予約, 8.2

サーバー・リソース, 8.1

リソース属性, API, 45.4.7 リソースの伸縮性, 提供, 2.1 リソース・モデル

TaaS API, 60.3

TaaSで使用, 60.2.2

リソース・プロバイダ, 11.2.2 ゲスト仮想マシンの再起動, 9.7.4.2 RESTARTING, VMデータ・モデル, 59.2.5 RESTful API, 45.1 RESTful API, 45.4 RESUMING, VMデータ・モデル, 59.2.5 RMAN

フル・クローン, 50.7.1, 50.7.2

RMANバックアップ・プロファイル, 使用してサービス・テンプレートを作成, 19.1.5, 19.2.1, 20.4.13, 20.6.2 ロール

定義, 3.3

定義, 3.3

EM_CLOUD_ADMINISTRATOR, 3.3, 11.2.1

EM_SSA_ADMINISTRATOR, 3.3

データベース・ソフトウェアのプロビジョニング, 12.3

EM_SSA_USER, 3.3 付与, 3.3.3.3 ロールと権限, 付与, 3.3.3

S

サンプルの割当て制限検証ログ, 11.2.4

保存

ゲスト仮想マシン, 9.7.7

スケーラビリティ・グループ, 59.2.4 スケジュール・ベースのポリシー, 6.5

例, 6.8.1

スキーマ

サービスとして, データベース・プールの作成, 16.2.1

サービスとして, サービス・テンプレートの作成, 16.6, 16.7

1つ以上定義, 29.9

リクエスト, 22.2.1

スキーマ・プール・ホーム・ページ, 表示, 29.9 スキーマ・サービス・テンプレート, 選択, 22.2.1 セキュリティ, エンタープライズ・ユーザー・セキュリティ(EUS), 3.4 セルフ・サービス

データベース・ポータル, 22.1

ログイン・ページ, 構成, 3.6.1

セルフ・サービス・アプリケーション

チャージバック, 43.2.2

セルフ・サービス・ポータル, 7.1

チャージバック, 図, 7.1

構成, 7.1

ロールとその他のエンティティのマッピングの定義, 7.1

テンプレートまたはアセンブリのセットの定義, 7.1

ホームページ, 図, 8.1

マシン・サイズ, 7.1

前提条件, 7.1

用途, 3.3, 7.1, 8.1

サーバーのリクエストまたは予約, 8.2

サーバー・リソースのリクエスト, 8.1

チャージバック・プランの設定, 7.1

記憶域の表示, 8.5

自己更新

アセンブリとテンプレートのダウンロード, 5.13

前提条件, 3.1

自己更新コンソール・ページ, 図, 5.13 セルフ・サービス・ユーザー, ITスタッフの手を借りずにサービスにアクセス, 2.4.2 サーバー・データ・モデル, 59.2.5 サーバー・ロード・バランサ(SLB), 構成, 3.6.3 サーバー・プール, 定義, 2.3.3 サーバー・プール

Oracle VM Server for SPARC, 34.2.6.4

サーバー, リクエストまたは予約, 8.2 サービス・インスタンス, 事前定義済のJava EEアプリケーションのデプロイ, 28.3.1 サービス・テンプレート, 2.3.4, 46.3.2

作成

スタンバイ・データベース, 15.2.2

作成, 25.6 DBCAテンプレート・プロファイルを使用した作成, 15.1.5 RMANバックアップ・プロファイルを使用した作成, 19.1.5, 19.2.1, 20.4.13, 20.6.2 スナップ・クローン・プロファイルを使用した作成, 20.4.9 定義, 25.6 MWaaSの編集, 25.6 設定

OMSの資格証明, 9.8.3.1.1

最大送信単位のサイズ, 5.7.2, 5.7.3

MTUフィールド, 5.7.2, 5.7.3

設定, 7.1

IaaSの使用, 4.2

MWaaSの使用, 4.5

TaaSの使用, 4.6

セルフ・サービス・ポータルのチャージバック・プラン, 7.1

チャージバック・サービス, 42.2.9

データベース・ゾーン・ホストのリスナー, 12.6

マシン・サイズ, 5.16.2

MWaaSセルフ・サービス・ポータル, 25.1, 27.1

NetAppストレージ・サーバー, 12.7.3.1

ネットワーク・プロファイル, 5.8

ネットワーク, 5.7

ネットワーク・プロファイル, 5.7.4

ネットワーク・タイプ, 5.7.4

プロビジョニング資格証明, 12.2 QoS, 5.16 ネットワークのQoS, 5.16.1 割当て制限, 11.2.4, 25.5 セルフ・サービス・ポータル, 7.1 ストレージ・サーバー, 5.9 Sun ZFSストレージ・サーバー, 12.7.3.1 Testing as a Service, 41 仮想化インフラストラクチャ, 5.1 仮想化システム, 5.1 PaaSの設定と使用, 4.3 共有データベース

メトリック収集の有効化, 43.2.6.1

共有リソース

チャージバック

共有リソース, 43.1.1

チャージバック・データの共有, 43.3.5 スナップ・クローン

サービス・テンプレートの作成, 20.4.9

スナップ・クローン

説明, 20.1

スナップ・クローン, 18.2 ソフトウェア・ライブラリ

仮想化コンポーネントの作成, 9.8.3.1

記憶域の場所からのファイルのアップロード, 9.8.3.1.3

Java EEコンポーネントのアップロード, 28.6

ユーザー, 構成, 5.16.3

ソフトウェア・プール, 定義, 2.3.4 SSAリクエスト, リダイレクト, 3.6.3 SSAユーザー・ポータル・ページ, 図, 2.4.2 SSAユーザー・ロール, カスタム・ロールの作成, 3.3.1.2, 3.3.1.3 SSOベースの認証, 3.4 スタンバイ・データベース

データベース・プール, 15.2.1

プライマリ・データベース・プール, 15.2.1.1

STARTED, VMデータ・モデル, 59.2.5 開始

データベース, 22.6

ゲスト仮想マシン, 9.7.4

仮想サーバー, 9.6.4

STARTING, VMデータ・モデル, 59.2.5 静的プライベート・ネットワーク, 34.3.2 STOPPED, VMデータ・モデル, 59.2.5 停止

データベース, 22.6

ゲスト仮想マシン, 9.7.4

仮想サーバー, 9.6.4

STOPPING, VMデータ・モデル, 59.2.5 ストレージ・エージェント・プロキシ, カスタマイズ, 12.7.3.2 ストレージ割当て, 管理, 12.7.6.1 ストレージ上限

定義, 12.7.6.1

編集, 12.7.6.1

ストレージ・エンティティ, 定義, 2.3.3 ストレージ・プール, 定義, 2.3.3 ストレージQoS, 定義, 5.16 ストレージのサービスのクオリティ(QoS), 設定, 5.16 記憶域リポジトリ

アセンブリ, 図, 5.12

作成, 5.10

ISO, 5.12

Oracle仮想アセンブリ, 5.12

Oracle VMテンプレート, 5.12

管理操作の実行, 5.10.1

サーバー・プールに提示, 5.11

仮想ディスク, 5.12

仮想ディスク, 図, 5.12

VMファイル, 5.12

VMテンプレート, 図, 5.12

記憶域リポジトリ・ページ, 図, 5.10 ストレージ・サーバー・ページ, 図, 5.9 ストレージ・サーバー

構成, 12.7.3.1

登録解除, 12.7.5.2

管理, 12.7.6

アクセス権限の管理, 12.7.6.2

登録, 12.7.4.1, 12.7.4.2, 12.7.4.3

ストレージ・アレイのタイプの選択, 5.9

同期, 12.7.5.1

ストレージ・ベンダーSDK, アップロード, 12.7.3.2 Sudo, 3.5 Sun ZFS

ハードウェア・ライセンス, 12.7.3.1

ストレージ・サーバー, 設定, 12.7.3.1

スーパー管理者ロール, 実行するタスク, 4.2 SUSPENDED, VMデータ・モデル, 59.2.5 SUSPENDING, VMデータ・モデル, 59.2.5 OVMマネージャ・ターゲットの同期, 5.4

T

ターゲット権限, 付与, 3.3.3.2

ターゲット・リソース・モデル, 60.3.25

ターゲットのリソース使用量

チャージバック

ターゲットのリソース使用量, 43.3.2

テンプレート・コンポーネント

作成, 9.8.3.1.2

仮想化タイプ, 9.8.3.1.2

テンプレート・デプロイメント - デプロイメント構成ページ, 9.8.5 テンプレートのデプロイ, ターゲットとソースの選択, 9.8.5 テンプレート

デプロイ, 9.8.5

ゲスト仮想マシンのプロビジョニング, 9.8.5

テスト

アクティビティおよび使用状況情報, 42.4.12

管理者, 40.1.1

作成, 41.2

タスク, 42.2

アセット, 42.2.8

作成, 42.3, 42.3.1

確認, 42.4.1

デザイナ, 40.1.2 環境, 42.2.8

作成, 42.3, 42.3.5

使用, 42.4

確認, 42.4.1

共有, 42.4.11 テスト実施者, 40.1.3 試行

結果の比較, 42.4.10

作成および実行, 42.4.6

監視, 42.4.9

Testリソース・モデル, 60.3.13 TestAssetリソース・モデル, 60.3.5 TestDriverリソース・モデル, 60.3.3 TestDriverInstanceリソース・モデル, 60.3.21 TestDriverTypeリソース・モデル, 60.3.2 TestEnvironmentリソース・モデル, 60.3.12 TestEnvironmentInstanceリソース・モデル, 60.3.22 テスト

ホーム・ページ, 42.4.14

設定

アプリケーション, 42.2.1

カスタム・テスト・ドライバ・タイプ, 42.2.5

Oracle Load Testingテスト・ドライバ, 42.2.3

割当て制限, 42.2.6

Testing as a Service

概要, 40

前提条件, 42.1

設定と使用, 4.6

Testing as a Service (TaaS)

API, 60

TestTypeリソース・モデル, 60.3.24 サード・パーティ・ライセンス, 取得, 12.7.3.2 サード・パーティ・サーバー・コンポーネント, オーバーライド, 12.7.3.2 層デプロイメント構成 - その他, 図, 9.8.4 層デプロイメント構成: 製品の構成, 図, 9.8.4 ゾーンのトポロジ, 5.15 トランスポート・プロトコル, 45.4.1 試行, 60.3.14

U

アプリケーションのアンデプロイ, 28.3.1.2

ユニバーサル・チャージ・プラン

チャージバック

ユニバーサル・チャージ・プラン, 43.1.2.2

作成, 43.2.4.2 テストの更新TaaS API例, 60.4.22 試行の更新TaaS API例, 60.4.27 入手可能な更新, Enterprise Managerストア, 3.1 拡張チャージ・プランを更新する, 43.2.4.6 アップグレード

仮想サーバー, 5.17.2, 9.6.3

ソフトウェア・ライブラリへのアップロード・ページ, 図, 28.6 アップロード

Java EEコンポーネントをソフトウェア・ライブラリへ, 28.6

ストレージ・ベンダーSDK, 12.7.3.2

URI空間, 45.4.2 使用状況の傾向

チャージバック, 43.3.1

使用状況ベース, 43.2.1 ユーザー

割当て, 3.3

作成, 3.3.2

V

vDC

アカウント, 34.3.3

vServerタイプ

作成, 34.3.4.1

vServer, 34.3.4 VIEW_SELF_UPDATE権限, 3.1.2 表示

アプリケーションのホーム・ページ, 28.7

チャージバックの詳細, 8.6

クラウド・ポリシー, 6.2

ターゲットのクラウド・ポリシー, 6.3

クラスタ・データベースの「ホーム」ページ, 22.8

データベース・インスタンスのホームページ, 22.6

データベース・プール・ホーム・ページ, 29.8

データベース・サービス・ホーム・ページ, 22.5

インフラストラクチャ・クラウド・ホーム・ページ, 9.1

MWaaSセルフ・サービス・ポータル, 28.1

OVMマネージャ・ホーム・ページ, 9.2

ポリシー, 8.8

プリファレンス, 8.9

スキーマ・プール・ホーム・ページ, 29.9

記憶域, セルフ・サービス・ポータル, 8.5

ゾーンのホームページ, 9.4.1

仮想

ディスク・コンポーネント, 作成, 9.8.3.1.4

マシンのプロビジョニング, 9.8.2

仮想データセンター, 「vDC」を参照, 34.1 仮想ドライブ, .isoファイルを使用して割当て, 5.12 仮想マシン

作成, 9.8.4

アセンブリ・コンポーネントの作成, 9.8.3.1.1

ゲスト・マシンの編集, 9.7.6

仮想マシン, 34.3.2, 34.3.4 仮想ネットワーク・インタフェース・カード・マネージャ, 5.7.1 仮想ネットワーク・インタフェース(VNIC), 5.7.1 仮想サーバー

定義, 9.6.1

編集, 9.6.2

メンテナンス, 9.6.5

Oracle VM Server, 5.5

再検出, 5.6

開始, 9.6.4

停止, 9.6.4

アップグレード, 5.17.2, 9.6.3

仮想サーバーのホーム・ページ

図, 9.6.1

表示, 9.6.1

仮想サーバー・プール・ホーム・ページ, 図, 9.5 仮想サーバー・プール・ホーム・ページ, 表示, 9.5 仮想サーバー・プール

作成または編集, 5.14

定義, 9.5

編集, 5.14.1

前提条件, 5.14

ゾーン, 作成, 5.15

仮想化

インフラストラクチャ, 5.1

インフラストラクチャ, 設定, 5.1

ターゲットの管理, 9.2

ソフトウェア(ハイパーバイザ), 5.5

ターゲット, メンバーの表示, 9.3

タイプ, テンプレート・コンポーネント, 9.8.3.1.2

仮想ターゲット, メンバーの管理, 9.3 仮想化システム

プロビジョニング, 9.8.1

設定, 5.1

VLANグループ

構成, 5.7.2, 5.7.3

作成, 5.7.2, 5.7.3

VNet, 定義, 59.2.6 vServerタイプ, 34.3.4.1 vServer

vDC, 34.3.4

W

WebLogicドメインのプロビジョニング・プロファイル

定義, 13.3.1.1

Y

YUMリポジトリ

構成, 5.17.1

仮想サーバーのアップグレード, 9.6.3

Z

ゾーンのホームページ, 9.4.1

図, 9.4.1

ゾーン

サーバー・プール, 2.3.3

ゾーンの作成ページ, 5.15

作成, 5.15, 9.4.2

定義, 5.15

定義, 2.3.3, 46.3.3

削除, 9.4.3, 9.4.3, 9.4.4, 9.4.4, 9.7.8, 9.7.8, 9.7.9, 9.7.9

編集, 9.4.2

管理, 9.4.1

作成の前提条件, 5.15

トポロジ, 5.15

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2016, Oracle and/or its affiliates.All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

アルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のアルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが非公開の試作版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティについて

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。