Oracle® Virtual Assembly Builder

ユーザーズ・ガイド

11g リリース1 (11.1.1.6)

B66713-02(原本部品番号:E22514-03)

2012年9月

Oracle Virtual Assembly Builderユーザーズ・ガイド, 11g リリース1 (11.1.1.6)

B66713-02

Copyright © 2011, 2012 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およびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

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

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

目次

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

はじめに

- 対象読者

- このリリースの新機能

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

- 関連ドキュメント

- 表記規則

1 概要

- 1.1 Oracle Virtual Assembly Builderの概要

- 1.1.1 仮想化について

- 1.1.2 ミドルウェアの仮想化の課題

- 1.1.3 Oracle Virtual Assembly Builderについて

- 1.1.4 ソフトウェア・アプライアンス

- 1.1.5 ソフトウェア・アセンブリ

- 1.1.6 Oracle Virtual Assembly Builderの役割

- 1.1.7 Oracle Virtual Assembly Builderの使用方法

- 1.1.7.1 イントロスペクション

- 1.1.7.2 構成

- 1.1.7.3 準備

- 1.1.7.4 デプロイ

- 1.2 Oracle Virtual Assembly Builderの理解

- 1.2.1 製品コンポーネント

- 1.2.2 アプライアンスとアセンブリ

- 1.2.3 イントロスペクション

- 1.2.4 外部アプライアンス

- 1.2.5 汎用アプライアンス

- 1.2.6 カタログ

- 1.2.7 外部リソース

- 1.2.8 ファイル・セットの取得

- 1.2.8.1 アセンブリ・アーカイブ

- 1.2.8.2 ファイル・セットと共有ファイル・セット

- 1.2.8.3 ネットワーク

- 1.2.9 アセンブリ・テンプレート

- 1.2.10 デプロイメント・プラン

- 1.2.11 デプロイヤの概念の理解

- 1.2.11.1 ターゲット

- 1.2.11.2 アセンブリ・インスタンス

- 1.2.11.3 アプライアンス・インスタンス

- 1.2.12 デプロイメント・ライフ・サイクル

2 アーキテクチャ

- 2.1 主要コンポーネント

- 2.1.1 Oracle Virtual Assembly Builder Studio

- 2.1.1.1 カタログの概要

- 2.1.2 デプロイヤ

- 2.1.2.1 Webアプリケーション

- 2.1.2.2 「デプロイメント」ナビゲータ

- 2.2 設定のシナリオ

- 2.2.1 デプロイヤのみインストールするシナリオ

- 2.2.2 Studioのみインストールするシナリオ

- 2.2.3 Studioと同じ場所に配置されるデプロイヤ

- 2.2.4 Studioとのリモート・デプロイヤ

- 2.3 デプロイメント・プラットフォーム

- 2.3.1 Oracle VM x86へのデプロイ

- 2.3.2 Oracle Exalogicへのデプロイ

3 セキュリティ

- 3.1 リソース

- 3.2 デプロイヤで採用されるセキュリティ・モデル

- 3.2.1 ターゲット認可

- 3.2.2 アセンブリ・アーカイブ認可

- 3.2.2.1 addAssemblyUsersコマンドによる追加ユーザーの作成

- 3.2.2.2 アセンブリ・インスタンス

- 3.2.2.3 アセンブリ・リソース

- 3.2.3 デプロイヤの認証および認可モデルの有効化

- 3.3 ロールとグループ

- 3.3.1 Application Adminグループ

- 3.3.2 Cloud Adminsグループ

- 3.3.3 Cloud Adminロール

- 3.3.4 Application Adminロール

4 アプライアンスおよびアセンブリの構造

- 4.1 アプライアンス構造

- 4.1.1 アプライアンス構成

- 4.1.2 アプライアンス・バイナリ

- 4.1.3 オペレーティング・システム

- 4.2 アセンブリ構造

- 4.3 Oracle VM 3.0へのデプロイメントにおける新しい概念

- 4.3.1 用語

- 4.3.2 ネットワーク・インタフェース(NIC)の構成

- 4.3.3 共有ファイル・セット

- 4.3.4 ゼロカウント・アプライアンス

- 4.3.5 アンチアフィニティ

5 Oracle Virtual Assembly Builderの使用

- 5.1 Oracle Virtual Assembly Builderのインタフェース

- 5.1.1 Oracle Virtual Assembly Builder Studioへのアクセス

- 5.1.2 abctlコマンドライン・ツールへのアクセス

- 5.1.3 ログへのアクセス

- 5.1.4 インタフェースの相違

- 5.1.5 ネーミング規則

- 5.1.5.1 名前の競合

- 5.1.6 シンボリック・リンク

- 5.2 標準的なワークフロー

- 5.3 アセンブリの作成に関連する操作

- 5.3.1 参照システムのイントロスペクション

- 5.3.1.1 サポート対象外のマウントされたNFSファイル・システム

- 5.3.1.2 カスタム再構成スクリプト

- 5.3.1.3 カスタム・アプライアンス・プロパティ

- 5.3.1.4 Oracle Virtual Assembly Builder Studioを使用したイントロスペクション

- 5.3.1.5 追加アプライアンスのイントロスペクション

- 5.3.1.6 abctlを使用したイントロスペクション

- 5.3.2 アプライアンスまたはアセンブリのファイル・セットの取得

- 5.3.2.1 Oracle Virtual Assembly Builder Studioを使用したファイル・セットの取得

- 5.3.2.2 確認

- 5.3.2.3 abctlを使用したファイル・セットの取得

- 5.3.3 アプライアンスまたはアセンブリのテンプレートの作成

- 5.3.3.1 テンプレートの格納

- 5.3.3.2 ターゲット・プラットフォームの選択

- 5.3.3.3 Oracle Virtual Assembly Builder Studioを使用したテンプレートの作成

- 5.3.3.4 Oracle Virtual Assembly Builder Studioを使用したアセンブリ・アーカイブの作成

- 5.3.3.5 abctlを使用したテンプレートの作成

- 5.3.3.6 abctlを使用したアセンブリ・アーカイブの作成

- 5.3.4 Oracle Virtual Assembly Builder Studioを使用したアセンブリの編集

- 5.3.4.1 接続の作成

- 5.3.4.2 プロパティ・インスペクタ

- 5.3.4.3 構造ペイン

- 5.3.4.4 Oracle HTTP Server/Oracle Web CacheおよびOracle WebLogic Serverが含まれるアセンブリの編集

- 5.3.4.5 Oracle HTTP ServerとOracle WebLogic Server間のアプリケーション・ルーティング

- 5.3.4.6 アセンブリ内でのVnetの作成

- 5.3.4.7 アプライアンス内でのネットワーク・インタフェースの作成

- 5.3.4.8 ネットワーク・インタフェースへのアプライアンス入力のバインド

- 5.3.4.9 Vnetへのネットワーク・インタフェースのバインド

- 5.3.4.10 アプライアンス出力からの外部リソースの作成

- 5.3.5 abctlを使用したアセンブリの編集

- 5.4 デプロイメントに関連する操作

- 5.4.1 ターゲットの構成

- 5.4.1.1 接続URL

- 5.4.1.2 接続の資格証明

- 5.4.1.3 例

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

- 5.4.2.1 Oracle Virtual Assembly Builder Studioを使用したデプロイメント・プランの作成

- 5.4.3 デプロイメント・プランの編集

- 5.4.3.1 新しいデプロイメント・プランの編集

- 5.4.3.2 既存のデプロイメント・プランの編集

- 5.4.3.3 必須ビュー

- 5.4.3.4 デプロイメント・プラン・エディタでのアイテムの選択

- 5.4.3.5 構造ペインでのアイテムの選択

- 5.4.3.6 プロパティ値のオーバーライド

- 5.4.3.7 オーバーライド値の削除

- 5.4.3.8 統合プロパティ

- 5.4.3.9 デプロイメント・プランの検証

- 5.4.3.10 デプロイメント・プランの保存

- 5.4.4 ターゲットへのアセンブリ・アーカイブの登録

- 5.4.4.1 Oracle Virtual Assembly Builderを使用した登録

- 5.4.4.2 abctlを使用した登録

- 5.4.5アセンブリ・インスタンスのデプロイ

- 5.4.5.1 アプライアンスの"ターゲット"件数をゼロに設定する機能(ゼロカウント・アプライアンス)

- 5.4.5.2 Virtual Assembly Builder Studioを使用したデプロイメント

- 5.4.5.3 abctlを使用したデプロイメント

- 5.4.6 アセンブリ・インスタンスの停止

- 5.4.6.1 Oracle Virtual Assembly Builder Studioによるアセンブリ・インスタンスの停止

- 5.4.6.2 abctlによるアセンブリ・インスタンスの停止

- 5.4.7 アセンブリ・インスタンスの開始

- 5.4.7.1 Oracle Virtual Assembly Builder Studioによるアセンブリ・インスタンスの開始

- 5.4.7.2 abctlによるアセンブリ・インスタンスの開始

- 5.4.8 アセンブリ・インスタンスの再開

- 5.4.8.1 Oracle Virtual Assembly Builder Studioによるアセンブリ・インスタンスの再開

- 5.4.8.2 abctlによるアセンブリ・インスタンスの再開

- 5.4.9 アプライアンスのスケーリング

- 5.4.9.1 Oracle Virtual Assembly Builder Studioによるアプライアンスのスケーリング

- 5.4.9.2 scaleコマンドで使用するためのscalingGroupIdの取得

- 5.4.9.3 abctlによるアセンブリ・インスタンス内のアプライアンスのスケーリング

- 5.4.10 アセンブリ・インスタンスのアンデプロイ

- 5.4.10.1 Oracle Virtual Assembly Builder Studioによるデプロイメントのアンデプロイ

- 5.4.10.2 abctlによるアセンブリ・インスタンスのアンデプロイ

- 5.4.11 ターゲットからのアセンブリ・アーカイブの登録解除

- 5.4.11.1 Oracle Virtual Assembly Builder Studioによるアセンブリ・アーカイブの登録解除

- 5.4.11.2 abctlによるアセンブリ・アーカイブの登録解除

- 5.4.11.3 redeployAssemblyInstance

- 5.4.11.4 deleteAssemblyInstance

- 5.4.12 デプロイヤ・リポジトリへのアセンブリ・アーカイブのアップロード

- 5.4.13 デプロイヤ・リポジトリからのアセンブリ・アーカイブの削除

- 5.4.14 エクスポート操作

- 5.4.14.1 カタログからのアプライアンスまたはアセンブリのエクスポート

- 5.4.14.2 カタログへのアプライアンスまたはアセンブリのインポート

- 5.4.14.3 アセンブリ・アーカイブのエクスポート(コピー)

- 5.4.14.4 カタログへのアセンブリ・アーカイブのインポート

- 5.4.15 EMソフトウェア・ライブラリとのやり取り

- 5.4.15.1 Enterprise Managerソフトウェア・ライブラリへの接続の構成

- 5.4.15.2 アセンブリのアップロード

- 5.4.15.3 Enterprise Managerソフトウェア・ライブラリのアセンブリ・アーカイブの記述

- 5.4.15.4 Enterprise Managerソフトウェア・ライブラリからのアセンブリ・アーカイブの削除

- 5.4.15.5 Oracle Virtual Assembly Builderカタログへのアセンブリのダウンロード

A コマンドライン・リファレンス

- A.1 コマンド

- A.1.1 addAssemblyUsers

- A.1.1.1 シノプシス

- A.1.1.2 説明

- A.1.1.3 オプション

- A.1.1.4 例

- A.1.2 addTargetUser

- A.1.2.1 シノプシス

- A.1.2.2 説明

- A.1.2.3 オプション

- A.1.2.4 例

- A.1.3 addToAssembly

- A.1.3.1 シノプシス

- A.1.3.2 説明

- A.1.3.3 オプション

- A.1.3.4 例

- A.1.4 captureFileSets

- A.1.4.1 シノプシス

- A.1.4.2 説明

- A.1.4.3 オプション

- A.1.4.4 例

- A.1.5 connectEndpoints

- A.1.5.1 シノプシス

- A.1.5.2 説明

- A.1.5.3 オプション

- A.1.5.4 例

- A.1.6 createAssembly

- A.1.6.1 シノプシス

- A.1.6.2 説明

- A.1.6.3 オプション

- A.1.6.4 例

- A.1.7 createAssemblyArchive

- A.1.7.1 シノプシス

- A.1.7.2 説明

- A.1.7.3 オプション

- A.1.7.4 例

- A.1.8 createAssemblyInstance

- A.1.8.1 シノプシス

- A.1.8.2 説明

- A.1.8.3 オプション

- A.1.8.4 例

- A.1.9 createDeployerConnection

- A.1.9.1 シノプシス

- A.1.9.2 説明

- A.1.9.3 オプション

- A.1.9.4 例

- A.1.10 createEMConnection

- A.1.10.1 シノプシス

- A.1.10.2 説明

- A.1.10.3 オプション

- A.1.10.4 例

- A.1.11 createExternalResources

- A.1.11.1 シノプシス

- A.1.11.2 説明

- A.1.11.3 オプション

- A.1.11.4 例

- A.1.12 createTags

- A.1.12.1 シノプシス

- A.1.12.2 説明

- A.1.12.3 オプション

- A.1.12.4 例

- A.1.13 createTarget

- A.1.13.1 シノプシス

- A.1.13.2 説明

- A.1.13.3 Oracle VM構成

- A.1.13.4 オプション

- A.1.13.5 例

- A.1.14 createTemplate

- A.1.14.1 シノプシス

- A.1.14.2 説明

- A.1.14.3 オプション

- A.1.14.4 例

- A.1.15 delete

- A.1.15.1 シノプシス

- A.1.15.2 説明

- A.1.15.3 オプション

- A.1.15.4 例

- A.1.16 deleteAssemblyArchive

- A.1.16.1 シノプシス

- A.1.16.2 説明

- A.1.16.3 オプション

- A.1.16.4 例

- A.1.17 deleteAssemblyInstance

- A.1.17.1 シノプシス

- A.1.17.2 説明

- A.1.17.3 オプション

- A.1.17.4 例

- A.1.18 deleteDeployerConnection

- A.1.18.1 シノプシス

- A.1.18.2 説明

- A.1.18.3 オプション

- A.1.18.4 例

- A.1.19 deleteEMConnection

- A.1.19.1 シノプシス

- A.1.19.2 説明

- A.1.19.3 オプション

- A.1.19.4 例

- A.1.20 deleteEMAssemblyArchive

- A.1.20.1 シノプシス

- A.1.20.2 説明

- A.1.20.3 オプション

- A.1.20.4 例

- A.1.21 deleteFailedAssemblyInstances

- A.1.21.1 シノプシス

- A.1.21.2 説明

- A.1.21.3 オプション

- A.1.21.4 例

- A.1.22 deleteRequests

- A.1.22.1 シノプシス

- A.1.22.2 説明

- A.1.22.3 オプション

- A.1.22.4 例

- A.1.23 deleteTags

- A.1.23.1 シノプシス

- A.1.23.2 説明

- A.1.23.3 オプション

- A.1.23.4 例

- A.1.24 deleteTarget

- A.1.24.1 シノプシス

- A.1.24.2 説明

- A.1.24.3 オプション

- A.1.24.4 例

- A.1.25 deployAssemblyInstance

- A.1.25.1 シノプシス

- A.1.25.2 説明

- A.1.25.3 オプション

- A.1.25.4 例

- A.1.26 describeApplianceInstances

- A.1.26.1 シノプシス

- A.1.26.2 説明

- A.1.26.3 オプション

- A.1.26.4 例

- A.1.27 describeAssemblyArchives

- A.1.27.1 シノプシス

- A.1.27.2 説明

- A.1.27.3 オプション

- A.1.27.4 例

- A.1.28 describeAssemblyInstances

- A.1.28.1 シノプシス

- A.1.28.2 説明

- A.1.28.3 オプション

- A.1.28.4 例

- A.1.29 describeAssemblyUsers

- A.1.29.1 シノプシス

- A.1.29.2 説明

- A.1.29.3 オプション

- A.1.29.4 例

- A.1.30 describeCatalog

- A.1.30.1 シノプシス

- A.1.30.2 説明

- A.1.30.3 オプション

- A.1.30.4 例

- A.1.31 describeDeployer

- A.1.31.1 シノプシス

- A.1.31.2 説明

- A.1.31.3 オプション

- A.1.31.4 例

- A.1.32 describeDeployerConnections

- A.1.32.1 シノプシス

- A.1.32.2 説明

- A.1.32.3 オプション

- A.1.32.4 例

- A.1.33 describeDeploymentPlans

- A.1.33.1 シノプシス

- A.1.33.2 説明

- A.1.33.3 オプション

- A.1.33.4 例

- A.1.34 describeEMAssemblyArchives

- A.1.34.1 シノプシス

- A.1.34.2 説明

- A.1.34.3 オプション

- A.1.34.4 例

- A.1.35 describeEMConnection

- A.1.35.1 シノプシス

- A.1.35.2 説明

- A.1.35.3 オプション

- A.1.35.4 例

- A.1.36 describeEndpoints

- A.1.36.1 シノプシス

- A.1.36.2 説明

- A.1.36.3 オプション

- A.1.36.4 例

- A.1.37 describeRegistrations

- A.1.37.1 シノプシス

- A.1.37.2 説明

- A.1.37.3 オプション

- A.1.37.4 例

- A.1.38 describeRequests

- A.1.38.1 シノプシス

- A.1.38.2 説明

- A.1.38.3 オプション

- A.1.38.4 例

- A.1.39 describeScalingGroups

- A.1.39.1 シノプシス

- A.1.39.2 説明

- A.1.39.3 オプション

- A.1.39.4 例

- A.1.40 describeTags

- A.1.40.1 シノプシス

- A.1.40.2 説明

- A.1.40.3 オプション

- A.1.40.4 例

- A.1.41 describeTargetConfigurations

- A.1.41.1 シノプシス

- A.1.41.2 説明

- A.1.41.3 オプション

- A.1.41.4 例

- A.1.42 describeTargetNames

- A.1.42.1 シノプシス

- A.1.42.2 説明

- A.1.42.3 オプション

- A.1.42.4 例

- A.1.43 describeTargetUsers

- A.1.43.1 シノプシス

- A.1.43.2 説明

- A.1.43.3 オプション

- A.1.43.4 例

- A.1.44 describeTargets

- A.1.44.1 シノプシス

- A.1.44.2 説明

- A.1.44.3 オプション

- A.1.44.4 例

- A.1.45 describeUserTargets

- A.1.45.1 シノプシス

- A.1.45.2 説明

- A.1.45.3 オプション

- A.1.45.4 例

- A.1.46 describeVnets

- A.1.46.1 シノプシス

- A.1.46.2 説明

- A.1.46.3 オプション

- A.1.46.4 例

- A.1.47 downloadAssemblyArchive

- A.1.47.1 シノプシス

- A.1.47.2 説明

- A.1.47.3 オプション

- A.1.47.4 例

- A.1.48 downloadAssemblyMetadata

- A.1.48.1 シノプシス

- A.1.48.2 説明

- A.1.48.3 オプション

- A.1.48.4 例

- A.1.49 downloadEMAssemblyArchive

- A.1.49.1 シノプシス

- A.1.49.2 説明

- A.1.49.3 オプション

- A.1.49.4 例

- A.1.50 export

- A.1.50.1 シノプシス

- A.1.50.2 説明

- A.1.50.3 オプション

- A.1.50.4 例

- A.1.51 getDefaultTarget

- A.1.51.1 シノプシス

- A.1.51.2 説明

- A.1.51.3 オプション

- A.1.51.4 例

- A.1.52 getTargetType

- A.1.52.1 シノプシス

- A.1.52.2 説明

- A.1.52.3 オプション

- A.1.52.4 例

- A.1.53 help

- A.1.53.1 シノプシス

- A.1.53.2 説明

- A.1.53.3 オプション

- A.1.53.4 例

- A.1.54 import

- A.1.54.1 シノプシス

- A.1.54.2 説明

- A.1.54.3 オプション

- A.1.54.4 例

- A.1.55 importExternalTemplate

- A.1.55.1 シノプシス

- A.1.55.2 説明

- A.1.55.3 オプション

- A.1.55.4 例

- A.1.56 introspectCoherenceWeb

- A.1.56.1 シノプシス

- A.1.56.2 説明

- A.1.56.3 オプション

- A.1.56.4 例

- A.1.57 introspectForms

- A.1.57.1 シノプシス

- A.1.57.2 説明

- A.1.57.3 オプション

- A.1.57.4 例

- A.1.58 introspectGenericProd

- A.1.58.1 シノプシス

- A.1.58.2 説明

- A.1.58.3 オプション

- A.1.58.4 例

- A.1.59 introspectOHS

- A.1.59.1 シノプシス

- A.1.59.2 説明

- A.1.59.3 オプション

- A.1.59.4 例

- A.1.60 introspectOTD

- A.1.60.1 シノプシス

- A.1.60.2 説明

- A.1.60.3 オプション

- A.1.60.4 例

- A.1.61 introspectRACDB

- A.1.61.1 シノプシス

- A.1.61.2 説明

- A.1.61.3 オプション

- A.1.61.4 例

- A.1.62 introspectReports

- A.1.62.1 シノプシス

- A.1.62.2 説明

- A.1.62.3 オプション

- A.1.62.4 例

- A.1.63 introspectSIDB

- A.1.63.1 シノプシス

- A.1.63.2 説明

- A.1.63.3 オプション

- A.1.63.4 例

- A.1.64 introspectSOA

- A.1.64.1 シノプシス

- A.1.64.2 説明

- A.1.64.3 オプション

- A.1.64.4 例

- A.1.65 introspectTuxedo

- A.1.65.1 シノプシス

- A.1.65.2 説明

- A.1.65.3 オプション

- A.1.65.4 例

- A.1.66 introspectWebCache

- A.1.66.1 シノプシス

- A.1.66.2 説明

- A.1.66.3 オプション

- A.1.66.4 例

- A.1.67 introspectWLS

- A.1.67.1 シノプシス

- A.1.67.2 説明

- A.1.67.3 拡張機能

- A.1.67.4 CoherenceWeb拡張機能の記述

- A.1.67.5 SOACoherence拡張機能の記述

- A.1.67.6 SOA拡張機能の記述

- A.1.67.7 オプション

- A.1.67.8 例

- A.1.68 redeployAssemblyInstance

- A.1.68.1 シノプシス

- A.1.68.2 説明

- A.1.68.3 オプション

- A.1.68.4 例

- A.1.69 registerAssemblyArchive

- A.1.69.1 シノプシス

- A.1.69.2 説明

- A.1.69.3 オプション

- A.1.69.4 例

- A.1.70 removeAssemblyUsers

- A.1.70.1 シノプシス

- A.1.70.2 説明

- A.1.70.3 オプション

- A.1.70.4 例

- A.1.71 removeTargetUsers

- A.1.71.1 シノプシス

- A.1.71.2 説明

- A.1.71.3 オプション

- A.1.71.4 例

- A.1.72 restartAssemblyInstance

- A.1.72.1 シノプシス

- A.1.72.2 説明

- A.1.72.3 オプション

- A.1.72.4 例

- A.1.73 scale

- A.1.73.1 シノプシス

- A.1.73.2 説明

- A.1.73.3 オプション

- A.1.73.4 例

- A.1.74 setDefaultTarget

- A.1.74.1 シノプシス

- A.1.74.2 説明

- A.1.74.3 オプション

- A.1.74.4 例

- A.1.75 startAssemblyInstance

- A.1.75.1 シノプシス

- A.1.75.2 説明

- A.1.75.3 オプション

- A.1.75.4 例

- A.1.76 stopAssemblyInstance

- A.1.76.1 シノプシス

- A.1.76.2 説明

- A.1.76.3 オプション

- A.1.76.4 例

- A.1.77 undeployAssemblyInstance

- A.1.77.1 シノプシス

- A.1.77.2 説明

- A.1.77.3 オプション

- A.1.77.4 例

- A.1.78 unregisterAssemblyArchive

- A.1.78.1 シノプシス

- A.1.78.2 説明

- A.1.78.3 オプション

- A.1.78.4 例

- A.1.79 updateAssemblyArchive

- A.1.79.1 シノプシス

- A.1.79.2 説明

- A.1.79.3 オプション

- A.1.79.4 例

- A.1.80 updateTarget

- A.1.80.1 シノプシス

- A.1.80.2 説明

- A.1.80.3 オプション

- A.1.80.4 例

- A.1.81 uploadAssemblyArchive

- A.1.81.1 シノプシス

- A.1.81.2 説明

- A.1.81.3 オプション

- A.1.81.4 例

- A.1.82 uploadAssemblyResources

- A.1.82.1 シノプシス

- A.1.82.2 説明

- A.1.82.3 オプション

- A.1.82.4 例

- A.1.83 uploadEMAssemblyArchive

- A.1.83.1 シノプシス

- A.1.83.2 説明

- A.1.83.3 オプション

- A.1.83.4 例

- A.1.84 version

- A.1.84.1 シノプシス

- A.1.84.2 説明

- A.1.84.3 例

- A.2 ヘルプ

- A.2.1 シノプシス

- A.2.2 説明

- A.2.3 オプション

- A.2.4 例

- A.2.4.1 引数なし

- A.2.4.2 コマンドのカテゴリに関するhelpの指定

- A.2.4.3 -commandパラメータを指定したhelp

- A.2.4.4 -commandパラメータおよび-usageフラグを指定したhelp

B Oracle Virtual Assembly Builderのイントロスペクション・プラグイン

- B.1 Oracle WebLogic Serverプラグイン

- B.1.1 サポートされるバージョン

- B.1.2 Oracle WebLogic Serverのイントロスペクション・パラメータ

- B.1.3 参照システムの前提条件

- B.1.4 要件

- B.1.4.1 Oracle WebLogic Serverドメインの要件

- B.1.4.2 Oracle WebLogic Serverのリモート・イントロスペクション用に指定するリモート・ユーザーの要件

- B.1.4.3 SSL証明書とホスト名検証の要件

- B.1.4.4 Webサービスにアクセスしてアプライアンスを更新するための要件

- B.1.4.5 個々のサーバーでテンプレートを作成しない要件

- B.1.4.6 管理対象サーバーが実行されていないときに管理URLを指定するための要件

- B.1.5 結果のアーティファクト・タイプ

- B.1.6 接続

- B.1.7 接続プロパティ

- B.1.8 Oracle WebLogic Serverアプライアンスのプロパティ

- B.1.8.1 アセンブリレベルのシステム・プロパティ

- B.1.8.2 管理サーバーおよび管理対象サーバーのアプライアンスに共通するプロパティ

- B.1.8.3 管理サーバー・アプライアンスのプロパティ

- B.1.9 プラグインの拡張機能

- B.1.10 サポートされるテンプレート・タイプ

- B.2 Oracle Coherence*Web拡張機能

- B.2.1 サポートされるバージョン

- B.2.2 Oracle Coherence*Webのイントロスペクション・パラメータ

- B.2.3 参照システムの前提条件

- B.2.4 要件

- B.2.4.1 デプロイメント・モデルの要件

- B.2.4.2 カスタム・クラスタ構成ファイルを手動更新するための要件

- B.2.5 結果のアーティファクト・タイプ

- B.2.6 接続

- B.2.7 接続

- B.2.8 Oracle Coherence*Webアプライアンスのプロパティ

- B.2.9 サポートされるテンプレート・タイプ

- B.3 Oracle Forms and Reportsの拡張機能

- B.3.1 サポートされるバージョン

- B.3.2 イントロスペクション・パラメータ

- B.3.3 参照システムの前提条件

- B.3.3.1 パートナ・アプリケーション登録ユーティリティの追加(別のノードのWeb層)

- B.3.4 要件

- B.3.4.1 管理対象サーバーの要件

- B.3.4.2 サポートされているトポロジ

- B.3.4.3 サポートされていないトポロジ

- B.3.4.4 デプロイされたアセンブリのスケール・アウトをサポートするための要件

- B.3.4.5 Oracle HTTP Server to Reportsクラスタ構成要件

- B.3.4.6 tnsnames.ora

- B.3.5 結果のアーティファクト・タイプ

- B.3.6 接続

- B.3.6.1 Oracle HTTP ServerアプライアンスからForms and Reports WLSアプライアンスへの接続

- B.3.6.2 Forms and Reports WLSアプライアンスからOracle Internet Directory外部リソースへの接続

- B.3.6.3 ReportsアプライアンスからOracle Databaseへの接続

- B.3.7 接続プロパティ

- B.3.8 Oracle Forms and Reportsアプライアンスのプロパティ

- B.4 Oracle Service Busのサポート

- B.4.1 サポートされるバージョン

- B.4.2 Oracle Service Busのイントロスペクション・パラメータ

- B.4.3 参照システムの前提条件

- B.4.4 要件

- B.4.4.1 サポートされるドメイン

- B.4.4.2 構成アーカイブの要件

- B.4.4.3 参照ドメインからのOSBアーティファクトのエクスポートおよび必要に応じた削除

- B.4.4.4 ドメイン・ディレクトリからのテンプレート・ファイルの削除

- B.4.4.5 アセンブリ・デプロイ後の要件

- B.4.5 結果のアーティファクト・タイプ

- B.4.6 接続

- B.4.7 接続プロパティ

- B.4.8 Oracle Service Busアプライアンスのプロパティ

- B.4.9 サポートされるテンプレート・タイプ

- B.5 Oracle SOAプラグイン

- B.5.1 サポートされるバージョン

- B.5.2 Oracle SOAサービス・エンジン構成

- B.5.3 Oracle SOAアプリケーション構成

- B.5.3.1 構成プランのユーザー・プロパティ

- B.5.3.2 外部参照

- B.5.4 参照システムの前提条件

- B.5.5 結果のアーティファクト・タイプ

- B.5.6 接続

- B.5.7 接続プロパティ

- B.5.8 Oracle SOAアプライアンスのプロパティ

- B.5.9 プラグインの拡張機能

- B.5.10 サポートされるテンプレート・タイプ

- B.6 Oracle HTTP Serverイントロスペクタのプラグイン

- B.6.1 サポートされるバージョン

- B.6.2 Oracle HTTP Serverのイントロスペクション・パラメータ

- B.6.3 参照システムの前提条件

- B.6.4 結果のアーティファクト・タイプ

- B.6.5 要件

- B.6.6 接続

- B.6.7 接続プロパティ

- B.6.7.1 Oracle Access Manager管理サーバー

- B.6.8 Oracle HTTP Serverアプライアンスのプロパティ

- B.6.9 プラグインの拡張機能

- B.6.10 サポートされるテンプレート・タイプ

- B.7 Oracle Web Cacheプラグイン

- B.7.1 サポートされるバージョン

- B.7.2 Oracle Web Cacheのイントロスペクション・パラメータ

- B.7.3 参照システムの前提条件

- B.7.4 要件

- B.7.4.1 仮想ホスト・マップ・プロパティを更新するための要件

- B.7.5 結果のアーティファクト・タイプ

- B.7.6 接続

- B.7.7 接続プロパティ

- B.7.8 Oracle Web Cacheアプライアンスのプロパティ

- B.7.9 プラグインの拡張機能

- B.7.10 サポートされるテンプレート・タイプ

- B.8 Oracle Database (SIDB)プラグイン

- B.8.1 サポートされるバージョン

- B.8.2 Oracle Databaseのイントロスペクション・パラメータ

- B.8.3 Oracle Databaseのイントロスペクション・パスワード・パラメータ

- B.8.4 参照システムの前提条件

- B.8.5 要件

- B.8.6 結果のアーティファクト・タイプ

- B.8.7 接続

- B.8.8 接続プロパティ

- B.8.9 Oracle Databaseアプライアンスのプロパティ

- B.8.10 プラグインの拡張機能

- B.8.11 サポートされるテンプレート・タイプ

- B.9 Oracle RAC Database (RACDB)プラグイン

- B.9.1 サポートされるバージョン

- B.9.2 Oracle RAC Databaseのイントロスペクション・パラメータ

- B.9.3 Oracle RAC Databaseのイントロスペクション・パスワード・パラメータ

- B.9.4 参照システムの前提条件

- B.9.5 要件

- B.9.6 結果のアーティファクト・タイプ

- B.9.7 接続

- B.9.8 接続プロパティ

- B.9.9 Oracle Databaseアプライアンスのプロパティ

- B.9.10 プラグインの拡張機能

- B.9.11 サポートされるテンプレート・タイプ

- B.10 Oracle Traffic Directorプラグイン

- B.10.1 サポートされるバージョン

- B.10.2 Oracle Traffic Directorのイントロスペクション・パラメータ

- B.10.3 参照システムの前提条件

- B.10.4 結果のアーティファクト・タイプ

- B.10.5 接続

- B.10.5.1 管理サーバー・アプライアンスのエンドポイントの接続

- B.10.5.2 インスタンス・アプライアンスのエンドポイントの接続

- B.10.6 Oracle Traffic Directorアプライアンス・プロパティ

- B.10.6.1 管理サーバー・アプライアンスの編集可能なプロパティ

- B.10.6.2 インスタンス・アプライアンスの編集可能なプロパティ

- B.10.7 サポートされるテンプレート・タイプ

- B.10.8 デプロイ後のタスク

- B.11 Oracle Tuxedoプラグイン

- B.11.1 サポートされるバージョン

- B.11.2 Oracle Tuxedoのイントロスペクション・パラメータ

- B.11.3 参照システムの前提条件

- B.11.4 要件

- B.11.4.1 ベース・イメージの要件

- B.11.4.2 MicrofocusまたはCOBOL ITを必要とするART CICS/Batchアプリケーション

- B.11.4.3 スケーリングに関する要件

- B.11.5 結果のアーティファクト・タイプ

- B.11.5.1 単一マシンのOracle Tuxedoドメイン

- B.11.5.2 複数マシンのOracle Tuxedoドメイン

- B.11.6 接続

- B.11.6.1 複数マシン接続

- B.11.6.2 その他の入力および出力

- B.11.7 接続プロパティ

- B.11.8 Oracle Tuxedoアプライアンスのプロパティ

- B.11.9 プラグインの拡張機能

- B.11.10 サポートされるテンプレート・タイプ

- B.12 汎用アプライアンス・プラグイン

- B.12.1 要件

- B.12.1.1 ファイル・セットの指定

- B.12.1.2 rootとしてのスクリプトの起動

- B.12.2 結果のアーティファクト・タイプ

- B.12.3 汎用アプライアンス・プラグインのイントロスペクション・パラメータ

- B.12.4 プロパティ・ファイル

- B.12.4.1 スクリプト・ルート・ディレクトリ

- B.12.5 接続

- B.12.6 プラグインの拡張機能

- B.12.7 サポートされるテンプレート・タイプ

C Oracle Virtual Assembly Builderコンポーネントの共通プロパティ

- C.1 共通プロパティ

- C.2 システム・プロパティ

- C.3 外部リソース・プロパティ

- C.3.1 共通プロパティ

- C.3.2 foreignJMSプロパティ

- C.3.3 jmsBridgeDestinationプロパティ

- C.3.4 LDAPプロパティ

- C.3.5 Oracle JDBC以外のプロパティ

- C.3.6 JDBCプロパティ

- C.4 デプロイヤ・プロパティ

D トラブルシューティング

- D.1 一般的な問題

- D.1.1 別のクライアントが稼働していることを示すエラー

- D.1.2 phone homeのタイムアウト

- D.1.3 既存のアセンブリ・アーカイブ(OVAファイル)によるアセンブリの変更の妨害

- D.2 イントロスペクションおよびファイル・セット取得の失敗

- D.2.1 VMのイントロスペクション

- D.2.2 リモート操作の失敗

- D.2.2.1 リモート・マシンでipv6を実行中に発生する接続不可エラー

- D.2.2.2 パスワード入力後のリモート操作のハング

- D.2.2.3 ファイル権限の問題

- D.2.2.4 リモート接続の失敗

- D.2.2.5 リモート・ファイル・セット取得の失敗

- D.3 テンプレート作成の失敗

- D.3.1 不十分なループ・デバイス数

- D.4 デプロイヤ通信の失敗

- D.4.1 無効なデプロイヤ・レスポンスが返される

- D.4.2 デプロイヤからの401/403エラー

- D.5 登録の失敗

- D.6 デプロイメントの失敗

- D.6.1 VMが作成されない

- D.6.2 VMが作成されたが実行されない

- D.6.3 VMが作成および実行されたがpingできない

- D.6.3.1 pingできない実行中のVMへのアクセス方法

- D.6.3.2 ネットワーク構成の失敗のトリアージ

- D.6.3.3 VMが作成および起動されpingできる

- D.7 ログの場所と説明

- D.7.1 Studioログ

- D.7.2 デプロイヤ・ログ

- D.7.3 Oracle VMログ

- D.7.4 VMインスタンスのログ

E サード・パーティ・ライセンス

- E.1 Java Secure Channel (JSCH) for SSH2

- E.2 JViews Diagrammer

- E.3 Velocity Engine

- E.3.1 Apache License Version 2.0

- E.4 Commons Compress

- E.4.1 Apache License Version 2.0

- E.5 JSON in Java

索引

はじめに

このドキュメントでは、Oracle Virtual Assembly Builderの概念、トポロジおよび構成について説明します。ここでは、次のトピックについて説明します。

- 対象読者

- このリリースの新機能

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

- 関連ドキュメント

- 表記規則

対象読者

このドキュメントは、組織でOracle Virtual Assembly Builderを使用するシステム管理者を対象としています。

このリリースの新機能

このリリースのOracle Virtual Assembly Builderには、次の新機能または製品拡張機能があります。

- スタンドアロンのOracle Virtual Assembly Builder Deployerの導入。Oracle Virtual Assembly Builder Deployerは、Oracle Virtual Assembly Builder Studioによって作成されるアセンブリ・アーカイブのリポジトリを保守するWebアプリケーションです。Oracle Virtual Assembly Builder Deployerでは、Oracle VMなどの仮想化されたシステムにこれらのアセンブリ・アーカイブを登録するための操作と、アセンブリ・アーカイブによって定義されるソフトウェア・システムのデプロイメントを編成するための操作を提供します。

- Oracle Virtual Assembly Builder Deployerには、Oracle Exalogicを活用するカスタム・アプリケーションの作成で使用するためのWebサービスAPIが組み込まれています。WebサービスAPIでは、アセンブリ・アーカイブのアップロード、仮想化システムへのアセンブリ・アーカイブの登録、およびアセンブリ・アーカイブに定義されるシステムのアセンブリ・インスタンスの管理のための操作を提供します。『Oracle Virtual Assembly Builder開発者ガイド』を参照してください。

- abctlコマンドライン・インタフェースも組み込まれています。このインタフェースは、同じWebサービスAPIの最上部に構築され、同じ操作をすべて提供します。

- Oracle Virtual Assembly Builder Deployerでは、すべてのアセンブリ操作が認証および認可されるロール・ベースのアクセス制御を提供します。

- Oracle Virtual Assembly Builderでは、次のソフトウェアへのアセンブリのデプロイメントがサポートされるようになりました。

- Oracle VM 3.0および

- Oracle Exalogic

- オープン仮想化アーカイブ(OVA)としてのアセンブリ・アーカイブのサポート。アセンブリ・アーカイブには、1つ以上のVMイメージと、VMイメージがどのように相互に関連付けられているかを記述したメタデータ・ファイル(OVF)が格納されます。

- 複数のネットワーク・インタフェースのサポート: アプライアンスでは、複数のネットワーク・インタフェースを定義したり、入力エンドポイントを選択して特定のネットワーク・インタフェースなどにバインドしたりできるようになりました。

- 複数の仮想ネットワーク(Vnet)のサポート: 1つのアセンブリに複数の仮想ネットワーク(Vnet)を定義したり、アプライアンスのネットワーク・インタフェースを異なるVnetにバインドしたりできるようになりました。

- 共有ストレージのサポート: アプライアンスのファイル・セットは共有またはローカルとして構成できます。基礎となるデプロイメント・プラットフォームでサポートされる場合、アセンブリ内の個々のアプライアンスで共有されるようにそのファイル・セットを指定できます。デプロイメント・プラットフォームの共有ストレージ・デバイスには、共有ファイル・セットのコンテンツをアセンブリ・デプロイメントの一部として移入できます。

- 拡張されたファイル所有権のサポート: アプライアンス内では、ファイル所有権の権限(オペレーティング・システム・ユーザーおよびグループ)を各ファイル・セット・レベルで定義できるようになりました。

- ゼロカウント・アプライアンス: 初めにアプライアンス・インスタンスがゼロのアセンブリ内のアプライアンスをデプロイする機能。アプライアンス・インスタンスがゼロのため、そのアプライアンスに対してVMインスタンスは作成されません。後続のスケーリング操作では、アセンブリ構成の一部であるのに初めにインスタンス数がゼロで"デプロイされた"アプライアンスに、アプライアンス・インスタンスを追加できます。

- カスタム・アプライアンス・プロパティ: カスタム・プロパティをアプライアンスに追加する機能。このカスタム・プロパティは、アセンブリの編集中にアプライアンスの事前定義されたプロパティとともに、またデプロイメント・プランの一部として編集できます。この機能により、アプライアンス内のOracle製品とともにデプロイされるカスタム製品またはコンポーネントを構成、操作できます。

- アンチアフィニティのサポート: デプロイメント・ターゲットの異なる物理ホストにわたって、特定のアプライアンスの複数のインスタンスを配置するための要件を指定できます。

- Oracle Virtual Assembly Builderでは、次の追加製品のイントロスペクションおよびデプロイメントがサポートされるようになりました。

- Oracle SOA: 既存のSOA WebLogic Serverデプロイメントを調べ、SOAドメイン内のすべての構成とともに、MDS内のコンテナ構成およびデプロイされたコンポジットを取得します。

- Oracle Service Bus: Oracle Service BusがOracle SOAありで、またはOracle SOAなしで構成されているOracle WebLogic Serverドメインを調べ、取得します。

- Oracle Tuxedo: 単一または複数マシンのOracle Tuxedoドメインと、そのドメインが(アドオンも含め)存在するOracleホーム・ディレクトリを調べ、取得します。

- Oracle Traffic Director: Oracle Traffic Directorインスタンスの実行時の動作を決定する一連の構成可能な要素(メタデータ)を調べ、取得します。

- Oracle RAC Database: Oracle ClusterwareおよびOracle RAC Databaseのコンポーネントを調べ、そのメタデータを取得します。

- 汎用アプライアンス: 不透明なスタンドアロンの自己完結型製品またはアプリケーションをOracle Virtual Assembly Builderでは組込みサポートされていないアプライアンスとして作成およびデプロイする機能。

- 外部アプライアンス: Oracle Virtual Assembly Builder以外で作成され、Oracle VM 3.0のデプロイメントと互換性がある仮想マシン・テンプレートは、Oracle Virtual Assembly Builderカタログに外部アプライアンスとしてインポートできます。インポートすると、外部アプライアンスは、アセンブリの一部として編集、追加およびデプロイできます。

- 修正され、さらに合理化された、IDEルック・アンド・フィールを持つOracle Virtual Assembly Builder Studioグラフィック・ユーザー・インタフェース。これには、アセンブリ、アプライアンスおよびデプロイメントのコンテンツを表示する構造ペイン、「デプロイメント」ナビゲータ、切り離された「デプロイメント・プラン」ナビゲータの他、登録およびデプロイメントに対するドラッグ・アンド・ドロップのサポートが含まれます。

- Oracle Enterprise Manager 12cとの統合: Oracle Virtual Assembly Builder Studioでは、Oracle Enterprise Managerソフトウェア・ライブラリに対するアセンブリ・アーカイブの参照、アップロードおよびダウンロードがサポートされます。

- 柔軟なインストール・オプション: 必要な機能のインストールおよび構成が可能になります。Oracle Virtual Assembly Builder Studioのみ、Oracle Virtual Assembly Builder Deployerのみ、あるいはその両方を選択して、同じマシンまたは異なるマシンにインストールおよび構成できます。

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

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

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 (聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、ドキュメント・セットに含まれる次のドキュメントを参照してください。

- 『Oracle Virtual Assembly Builderインストレーション・ガイド』

- 『Oracle Virtual Assembly Builder開発者ガイド』

- 『Oracle Virtual Assembly Builderリリース・ノート』

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 概要

この章では、Oracle Virtual Assembly Builderの主要な概念およびコンポーネントについて説明します。内容は次のとおりです。

- 1.1項「Oracle Virtual Assembly Builderの概要」

- 1.2項「Oracle Virtual Assembly Builderの理解」

1.1 Oracle Virtual Assembly Builderの概要

増加する運用コスト、非効率的なハードウェア使用、急速に拡大するデータ・センターにより、何年もの間、仮想化は最も有力なITテクノロジとなっていました。デスクトップおよびサーバー環境の仮想化は、ハードウェアの使用率を上げ、必要なハードウェアの全体数を減らすことで、運用コストを下げるという最終的な約束を果たすまで発展してきました。

仮想化によって数多くの問題が解決されている一方、複数の層およびコンポーネントで構成されている複雑なアプリケーションのデプロイおよび管理はいまだに難しいことです。さらに、仮想化は急速に商品化され、注目は現在、アプリケーションを直接仮想化して仮想化にかかわる次の段階の利益を得ることに移っています。

1.1.1 仮想化について

仮想化とは、オペレーティング・システムおよびアプリケーションからCPU、メモリー、ストレージ、ネットワーク・インタフェースなどのハードウェア・リソースを抽象化するプロセスです。ハードウェアでは、仮想化ソフトウェア(ハイパーバイザなど)が稼働します。これにより、複数のオペレーティング・システムをインストールして、それぞれ固有のセキュアな物理環境で、同時に実行したり単独で実行したりできます。

仮想化の目標は、完全な環境のデプロイメントをより速く、簡単に、効率的にすることです。仮想化の機能を統合して、完全なスタックのデプロイメントおよび管理を容易にする必要があります。仮想化によって、スタック全体がデプロイ、管理およびサポートしやすくなるようにする必要があります。

図1-1 仮想化

1.1.2 ミドルウェアの仮想化の課題

仮想化された環境でのアプリケーションの開発およびデプロイメントには、テスト、ステージング、本番などの一連の運用段階があります。ソフトウェア・コンポーネントの集合の一貫性および正確性を保証する機能が既存の仮想化インフラストラクチャにはほとんどないため、これらの段階の間を遷移することが難しいことがあります。P2V (物理から仮想)またはV2V (仮想から仮想)の遷移を実現することは単純に、元のデプロイメントの仮想イメージを作成し、次にターゲット環境で作成した仮想イメージをインスタンス化するように見えます。Oracle VMを使用すると、このようなソリューションを実装できます。

仮想化ソリューションを手作りすることには、様々な落とし穴があります。ネットワーク接続の詳細は、デプロイメント環境で変わることがありますが、このような変更を実行したり、追跡する自動メカニズムは存在しません。イメージは、デプロイメント環境の特定の詳細に固有の場合があります。イメージの急増は、スプロール化を招き、オペレーティング・システム・レイヤーおよびアプリケーション・レイヤーでそれぞれのイメージにパッチを適用する必要があるため、メンテナンスのオーバーヘッドが発生します。このような落とし穴は、予期しないコストを生み出します。

1.1.3 Oracle Virtual Assembly Builderについて

Oracle Virtual Assembly Builderは、インストールされたOracleコンポーネントを仮想化して変更した後、ユーザー独自の環境にデプロイするためのツールです。Oracle Virtual Assembly Builderを使用して、ソフトウェア・アプライアンスと呼ばれるアーティファクト内の既存のソフトウェア・コンポーネントの構成を取得します。その後、アプライアンスをグループ化して、その関係をソフトウェア・アセンブリと呼ばれるアーティファクトに定義できます。アセンブリは、完全な複数層アプリケーション・トポロジを記述するブループリントを提供します。

Oracle Virtual Assembly Builderにより、アセンブリ内のアプライアンス間の論理的な結び付きを、アセンブリ編集と呼ばれるプロセスで再構成できるようになります。目的のアセンブリ構成がアーカイブされている場合は、Oracle Virtual Assembly Builderを使用してデプロイメント用のアセンブリを準備し、環境にデプロイします。コンポーネントおよびプロセスについては、後述します。

図1-2 Oracle Virtual Assembly Builder

1.1.4 ソフトウェア・アプライアンス

ソフトウェア・アプライアンス(アプライアンス)は、単一のソフトウェア・コンポーネントとそのローカル実行環境を表します。

1.1.5 ソフトウェア・アセンブリ

ソフトウェア・アセンブリ(アセンブリ)は、デプロイ時に連携するように自動的に構成される、相互に関連付けられたソフトウェア・アプライアンスの集まりです。アセンブリは、最小限のユーザー入力により、ハードウェア・リソースのプールにデプロイされます。

アセンブリは、単なる相互に接続されたアプライアンスの集合であると同時に、本番環境で便利なように次のような一連の機能を提供する必要があります。

- アプライアンスおよび外部システムの構成を可能にする機能

- 簡単にカスタマイズできるメタデータ形式で構成を具体化する機能

- 相互依存性を反映するようにアプライアンスの開始順序を定義する機能(オプション)

- 既存の管理インフラストラクチャに組み入れる管理ドメインを提供し、メタデータ定義、デプロイメント、監視および診断を可能にする機能

アプライアンスで構成されている他に、アセンブリには外部システムへの参照を含めることができます。これは、アセンブリには含めることができないデータベース、サーバーまたはセキュリティ・プロバイダなどのインフラストラクチャを表すのに必要です。

要約すると、デプロイメント用に事前作成アセンブリを作成できるという考えは非常に強力で、運用コストや複雑度を低減する利点が数多くあります。これには次のものがあります。

- 複雑度を増すことなくアセンブリの変化を考慮に入れても、作成中のアセンブリを簡単にレプリケートできます。

- アセンブリが開発環境、テスト環境および本番環境を移動するときの、構成エラーのリスクを低減します。

- レプリケートされた環境により、複数のアプリケーション・インフラストラクチャにわたる高レベルの標準化および一貫性の保持が容易になり、ベスト・プラクティスを簡単に実装できるようになります。

- 新しいインフラストラクチャおよびアプリケーションのデプロイメント時間を短縮します。

1.1.6 Oracle Virtual Assembly Builderの役割

これらの利点を実現するために、アセンブリをアプライアンスで構成する単純な方法が必要です。特に必要なものは、アプライアンスの構成の他、具体化されたシステムや他の大規模なアプライアンスベースの非仮想システム(データベース、アイデンティティ管理サーバーなど)のエンドポイント・マッピングを可能にするツールです。

Oracle Virtual Assembly Builderには、直観的な仮想環境、コマンドライン・インタフェース、サポートされているインフラストラクチャが組み込まれています。Oracle Virtual Assembly Builderを使用すると、管理者は、潜在的に複雑なアプリケーション構造やインフラストラクチャを構成するコンポーネントおよびシステムすべてを含む完全なアセンブリを構築およびデプロイできるようになります。

Oracle Virtual Assembly Builderには次の機能があります。

- 既存のアプライアンスおよびアセンブリのカタログをブラウズする機能。既存のインフラストラクチャを簡単に再利用できるようになります。

- アセンブリ・エディタ。既存のアプライアンスおよび外部システムに基づいて新しいアセンブリの宣言構成が可能になります。

- ドラッグアンドドロップを使用したアプライアンス間の接続を変更する機能

- プロパティ・インスペクタ。アプライアンスおよびアセンブリの編集可能なプロパティが表示されます。

- 完全な構成のテンプレート化された定義を作成する機能。デプロイメントが簡単になります。

- 仮想化された複数層アプリケーションを仮想化されたリソースのプールに単一ステップでデプロイする機能

図1-3 仮想化された複数層アプリケーション

1.1.7 Oracle Virtual Assembly Builderの使用方法

アセンブリの作成およびデプロイメントは、4ステップの単純明快なプロセスです。最初に、イントロスペクト・フェーズで、アセンブリ内のアプライアンスを構成するすべてのコンポーネントについて、既存のデプロイメントから必要なメタデータおよび構成情報が取得されます。構成フェーズで、アプライアンスと外部リソース間の関係が確立されます。準備フェーズで、特定の仮想化プラットフォームに関連するアセンブリに必要なデプロイメント・アーティファクト(つまり、仮想イメージ)が作成されます。最後に、デプロイ・フェーズで、アセンブリが環境にデプロイされます。

1.1.7.1 イントロスペクト

イントロスペクト・フェーズでは、個々のソフトウェア・コンポーネントの構成メタデータを取得するか、複数の分散コンポーネントのメタデータをまとめて取得します。ターゲット・コンポーネントは、複数の分散システム上にローカルまたはリモートに存在できます。システムは物理でも仮想でもかまいません。

1.1.7.2 構成

構成フェーズでは、次のことを実行します。

- ナビゲート可能なカタログに保持されているアプライアンスを使用して複雑なアセンブリを作成するために、コンポーネントを視覚的にドラッグアンドドロップします。

- プロトコルの互換性を自動的にチェックする接続ツールを使用して、アプライアンス間で関係および接続を確立します。

- アプライアンスからアセンブリ内に含まれない外部リソース(データベース、セキュリティ・プロバイダ、メッセージングなど)への接続を作成します。

1.1.7.3 準備

準備フェーズでは、次のことを実行します。

- カスタマイズされたOracle Enterprise Linuxオペレーティング・システムのディストリビューションおよび構成可能なメタデータを使用してブート可能な仮想マシン・ディスク・イメージを作成し、ソフトウェア・コンポーネントのデプロイ時のカスタマイズを可能にします。

1.1.7.4 デプロイ

デプロイ・フェーズでは、次のことを実行します。

- 仮想マシン・マネージャとの認証された直接接続を確立することによって、仮想化された環境で使用可能なターゲットを検出します。

- アセンブリ内のアプライアンスの基本構成プロパティをオーバーライドするアセンブリのカスタマイズされたデプロイメント構成を作成します。

- デプロイメント固有のカスタマイズによって遅延バインド・アプライアンスに自動的に対応します。

- すべてのアプライアンス・ディスク・イメージのステージングと、ターゲットへのアセンブリ全体のデプロイを単一ステップで実行します。

- アセンブリの初期デプロイ後にアプライアンス・インスタンスをスケーリングし、新たにデプロイされたインスタンスを既存のアセンブリに自動的に接続します。

1.2 Oracle Virtual Assembly Builderの理解

Oracle Virtual Assembly Builderでは、Oracle Fusion MiddlewareおよびOracle Databaseの特定のソフトウェア・コンポーネント・セットの現状を環境から取得し、アセンブリおよびアプライアンスとして表し、環境へのデプロイメントを可能にします。Oracle Virtual Assembly Builderにはコンポーネントを管理する機能が組み込まれておらず、コンポーネントに同梱されている管理ツールのかわりにはなりません。

Oracle Virtual Assembly Builderは、アセンブリのデプロイ先となる仮想環境を提供しません。Oracle Virtual Assembly Builderでサポートされるターゲット環境のいずれかを使用してデプロイメント環境を設定する必要があります。サポートされるデプロイメント環境の詳細は、『Oracle Virtual Assembly Builderインストレーション・ガイド』を参照してください。

1.2.1 製品コンポーネント

Oracle Virtual Assembly Builderは、次の2つの主要製品コンポーネントで構成されます。

- Oracle Virtual Assembly Builder Studioには、アセンブリ作成の最初の3つのフェーズ、つまりイントロスペクト・フェーズ、構成フェーズおよび準備フェーズを実行する機能があります。Oracle Virtual Assembly Builder Studioにより、アセンブリの作成および編集、アセンブリ・アーカイブの作成、テンプレートとOracle Virtual Assembly Builder Deployerからのデプロイメントをサポートするデプロイメント・プランの作成ができます。

- Oracle Virtual Assembly Builder Deployerは、Oracle Virtual Assembly Builder Studioによって作成されるアセンブリ・アーカイブのリポジトリを保守するJ2EEアプリケーションです。デプロイヤでは、Oracle VMなどの仮想化されたシステムにこれらのアセンブリ・アーカイブを登録するための操作と、アセンブリ・アーカイブによって定義されるソフトウェア・システムのデプロイメントを編成するための操作を提供します。
Oracle Virtual Assembly Builder Deployerへのインタフェースは、アセンブリ・アーカイブのアップロード、仮想化システムへのアセンブリ・アーカイブの登録、およびアセンブリ・アーカイブに定義されるシステムのアセンブリ・インスタンスの管理のための操作を提供するWebサービスです。Webサービスの詳細は、『Oracle Virtual Assembly Builder開発者ガイド』を参照してください。

1.2.2 アプライアンスとアセンブリ

最小アプライアンスは、元のコンポーネントの状態を記述するメタデータ(名前と値のペア)と、デプロイ時に構成を再作成できるようにするコンポーネント固有の一連のファイルで構成されます。Oracle Virtual Assembly Builderを使用して環境にデプロイメント用のアセンブリを準備するとき、追加の構成情報が作成され、メタデータとともに格納されます。

アプライアンス・メタデータには、コンポーネントの論理入力および論理出力それぞれの記述が含まれます。これらの入力および出力をまとめてエンドポイントと呼びます。入力エンドポイントの例として、Oracle HTTP ServerコンポーネントのHTTP入力があります。出力エンドポイントの例として、同じOracle HTTP Serverコンポーネントのmod_wl_ohs出力があります。

エンドポイントを記述するメタデータには、プロトコル、ポート番号、URLなどが含まれます。Oracle Virtual Assembly Builderでは、コンポーネントの取得後かつデプロイ前に接続を更新できるように、各エンドポイントについて十分な情報を取得します。この機能により、Oracle Virtual Assembly Builderではデプロイメント環境内でアプライアンスが適切に接続することを保証します。

アプライアンスは、アセンブリにグループ化されます。アセンブリは、アプライアンスの論理コンテナであり、アプライアンス間の結び付きです。Oracle Virtual Assembly Builderを使用してアセンブリを作成し、アプライアンスおよび他のアセンブリを移入します(アセンブリには、他のアセンブリを含めることができます)。

ソフトウェア・コンポーネントを環境からOracle Virtual Assembly Builderアプライアンスとして取得するプロセスは、イントロスペクションから始まります。

1.2.3 イントロスペクション

イントロスペクションは、ソフトウェア・コンポーネントまたは関連コンポーネントのグループに対して(アプライアンスまたはアセンブリを作成するために)実行される操作です。イントロスペクション時に、Oracle Virtual Assembly Builderでは、コンポーネントのXML記述を作成し、コンポーネント固有の構成ファイル・セットを取得します。この情報は、イントロスペクション時にコンポーネントの構成のスナップショットを形成します。イントロスペクション・アーキテクチャはプラグイン・ベースで、サポートされるコンポーネント・タイプごとにプラグインがあります。使用可能なプラグインの詳細は、付録B「Oracle Virtual Assembly Builderのイントロスペクション・プラグイン」を参照してください。

ほとんどの場合、コンポーネントのイントロスペクションの結果はアプライアンスです。ただし、Oracle Virtual Assembly Builderを使用してOracle WebLogic Serverドメインのイントロスペクトする場合、イントロスペクタのプラグインはアセンブリを生成します。生成されたアセンブリには、ドメインの管理サーバーを表すアプライアンスと、ドメインの各管理対象サーバーを表す他のアプライアンスが含まれます。

Oracle Virtual Assembly Builderでは、ローカル・ホスト上のコンポーネントまたはネットワークアクセス可能なリモート・ホストにあるコンポーネントをイントロスペクトできます。Oracle Virtual Assembly Builderでは、業界標準のSSHプロトコルを使用して、イントロスペクション・エンジンをリモート・ホストに転送し、イントロスペクション結果を返します。

イントロスペクションがローカルでもリモートでも、結果はカタログにローカルに格納されます。

1.2.4 外部アプライアンス

外部アプライアンスは、Oracle Virtual Assembly Builder以外のツールを使用して作成され、Oracle Virtual Assembly Builderインストールにインポートする仮想マシン・テンプレートです。インポートされると、外部アプライアンスは、イントロスペクション・メタデータの欠落によって生じる特定の制限を受けますが、すべてのOracle Virtual Assembly Builder操作に関与します。外部アプライアンスは、他のアプライアンスと同様に、アセンブリの一部として編集、追加およびデプロイできます。現時点で、外部アプライアンスとしてインポートできるのは、Oracle仮想マシンのみです。

abctl importExternalTemplateコマンドを使用して、アセンブリ・テンプレート(Oracle Virtual Assembly Builder以外で作成)を外部アプライアンスとしてカタログで取得します。このコマンドの使用方法の詳細は、付録A「コマンドライン・リファレンス」を参照してください。

1.2.5 汎用アプライアンス

"GenericProd"というアプライアンス・タイプを使用して構築されるアプライアンスです。このようなタイプのアプライアンスでは、構成または製品の場所を取得するのに製品固有のロジックを使用しません。かわりに、単純なアプライアンスを作成し、一連のユーザー指定プロパティ、パスおよび製品を構成するスクリプトを一般的な方法で追加します。また、デプロイ時に製品を構成および起動するのにも製品固有のロジックを使用しません。かわりに、作成時に渡されたスクリプト・セットをデプロイ時に実行して必要な操作を実行します。

これにより、ユーザーは不透明なスタンドアロンの自己完結型製品またはアプリケーションをOracle Virtual Assembly Builderでは組込みサポートされていないアプライアンスとして作成およびデプロイできます。

1.2.6 カタログ

アセンブリおよびアプライアンスは、ディスク上のカタログと呼ばれる領域で表されます。アセンブリおよびアプライアンスのメタデータは、カタログ・ルート・ディレクトリのメタデータ・サブフォルダ内のネストしたディレクトリに格納されます。デプロイメントに必要な追加のアーティファクトは、Oracle Virtual Assembly Builderによって定義された他のサブディレクトリに格納されます。ディスク上のアーティファクトによっては非常に大規模である場合があるため、カタログでは共有モデルをアプライアンスおよびアセンブリの一部のアーティファクトに使用します。

カタログに対する操作に使用できるのは、Oracle Virtual Assembly Builderが提供するツールのみです。Oracle Virtual Assembly Builderメタデータ・ファイルを手動で編集することはサポートされていません。

1.2.7 外部リソース

アセンブリの定義時に、外部にあるサーバーへの参照を作成することが必要な場合があります。たとえば、IT環境に、データベース、アイデンティティ管理、多くの関連のない仮想デプロイメントによって共有される他のサーバーを組み込むことができます。このようなシステムを特定のアセンブリに内に含めることは望ましくない、または不可能であることがあります。このため、Oracle Virtual Assembly Builderを使用すると、環境に存在してアプライアンスとしてデプロイされないサーバー・リソースを表す外部コンポーネントを定義できます。それらを外部リソースとして表すことで、アセンブリ内の参照元アプライアンスがデプロイ時に正しく構成されることを保証し、仮想環境へのデプロイ後にネットワーク構成を手動で修正する必要がなくなります。

1.2.8 ファイル・セットの取得

イントロスペクション・プロセスでは、コンポーネントの状態を取得し、実際のコンポーネント・インストールのメタデータ記述を生成します。イントロスペクションでは、実行可能ファイル、共有ライブラリまたはコンポーネントの他のバイナリを取得しません。かわりに、デプロイメント環境の同じコンポーネント・インストールを再作成するために取得する必要がある1つ以上のファイル・システム階層を指定するファイル・セット定義を生成します。デフォルトでは、イントロスペクションの完了後に、Oracle Virtual Assembly Builderではメタデータで記述された実際のインストールのコピーを自動的に取得します。このステップは、ファイル・セットの取得と呼ばれます。

デフォルトでは、使用するコマンドライン・インタフェースがOracle Virtual Assembly Builder StudioであろうとOracle Virtual Assembly Builderであろうと、イントロスペクションとファイル・セットの取得は一緒に行われます。オプションで、これらのステップを別々に実行することができます。

1.2.8.1 アセンブリ・アーカイブ

Oracle Virtual Assembly Builder Studioによって作成されたアセンブリ・アーカイブには、互いに連携してアプリケーションを形成する複数の関連ソフトウェア・スタックで構成されるソフトウェア・システムに関する情報が含まれます。この仕組みはアセンブリと呼ばれます。アセンブリ・アーカイブには、仮想化された環境でアセンブリのインスタンスをインスタンス化するのに使用されるアセンブリおよびアセンブリ・テンプレートに関するメタデータが含まれます。

1.2.8.2 ファイル・セットと共有ファイル・セット

ファイル・セットは共有またはローカルとして構成できます。基礎となるインフラストラクチャ・プラットフォームでサポートされる場合、アセンブリ内の個々のアプライアンスで共有されるようにそのファイル・セットを指定できます。

1.2.8.3 ネットワーク

アセンブリ・アーカイブは、それが表すアプリケーションの論理ネットワーク・セットを定義します。また、アプライアンスごとに、アセンブリ・アーカイブは1つ以上のネットワーク・インタフェースを定義します。各ネットワーク・インタフェースはアーカイブのネットワークの1つに関連付けられ、アセンブリ・アーカイブはアセンブリのネットワーク接続要件をすべて表すことができるようになります。

デプロイメント・プランは、アセンブリ・アーカイブで宣言された各論理ネットワークに使用されるように、仮想環境のネットワークを指定します。このモデルでは、構成およびパブリック・ネットワークとプライベート・ネットワークの両方へのバインディングがサポートされます(プライベートは、アセンブリ内の2つのアプライアンス間に存在するように定義され、デプロイされたアプリケーション・トポロジにアクセスするためのパブリック・ネットワークの一部として表面にはでません)。

デプロイヤでは、1つ以上のVnetを作成し、仮想化システムの基礎となるインタフェースを使用して作成した仮想マシンにアタッチします。これらのVnetはハイパーバイザ・レベルのVnetであり、仮想マシン・レベルのVnetではありません。仮想化システムでサポートされる場合、デプロイヤでは、これらのVnetを関連付けるプライベート・ネットワークを動的に作成することもできます。

1.2.9 アセンブリ・テンプレート

アセンブリ・テンプレートは、仮想ディスク・イメージ・セットで、新しい仮想マシン・インスタンスの作成および開始に使用できます。テンプレートは、アセンブリ内のアプライアンスごとに作成され、ゲスト・オペレーティング・システム、アプライアンスのファイル・セットおよびメタデータ、サポートするOracle Virtual Assembly Builderインフラストラクチャで構成されます。テンプレートは、仮想化された環境に登録することで、その環境で使用可能になります。登録時、仮想マシン・インスタンスをテンプレートに基づいて作成できます。

Oracle Virtual Assembly Builderでは、仮想マシンのゲスト・オペレーティング・システムとしてOracle Enterprise Linuxがサポートされます。

1.2.10 デプロイメント・プラン

デプロイメント・プランは、デプロイ前にアセンブリをカスタマイズするのに使用します。デプロイメント・プランを作成し、そのプランでデフォルトのアセンブリおよびアプライアンス・プロパティをカスタマイズして、ネットワーク構成などのデプロイメント固有の情報を提供することができます。場合によっては、成功したデプロイメントを続行するために特定のプロパティ(静的IPアドレス、パスワード・プロパティなど)をカスタマイズする必要があります。

1.2.11 デプロイヤの概念の理解

この項では、デプロイヤの概念について説明します。

1.2.11.1 ターゲット

仮想化システムではそれぞれに異なる方法でリソースを編成し、リソースの参照およびアクセスのために異なる情報を必要とします。異なるシステム間で共通の操作性を提供するために、Oracle Virtual Assembly Builder Deployerでは、ターゲットの概念を定義しています。ターゲットは、管理インタフェース(このドキュメントで後で定義)を使用して構成され、仮想化されたシステムのリソースまたはリソース・プールの参照に使用されます。ターゲットごとに指定された構成情報は、ターゲットが含まれる仮想化システムに固有です。

Oracle Virtual Assembly Builder Deployerでは、Oracle VMおよびOracle Exalogicがサポートされます。Oracle Exalogicは、単一ターゲットで事前定義されています。

1.2.11.2 アセンブリ・インスタンス

アセンブリ・インスタンスは、特定のターゲット仮想環境に対するアセンブリ・アーカイブのデプロイ可能なインスタンスです。

1.2.11.3 アプライアンス・インスタンス

アプライアンス・インスタンスは、ターゲット仮想環境で実行されている、または作成された(あるいはその両方)アプライアンスのインスタンスです。

アセンブリ・インスタンスのデプロイ後、各アプライアンスのターゲット数のアプライアンス・インスタンスが開始されます。各アプライアンスの初期ターゲット数は、デプロイメント・プランで指定されます。アセンブリ・インスタンスのデプロイ後に、新しいターゲットを動的に指定できます。

1.2.12 デプロイメント・ライフ・サイクル

アセンブリ・インスタンスは、デプロイ可能なアーティファクトです。アセンブリ、デプロイメント・プランのいずれかおよびデプロイ先とする必要があるターゲットを選択して、アセンブリ・インスタンスを作成する必要があります。CreateAssemblyInstanceを使用すると、アセンブリ・インスタンスを作成できます。

デプロイ時、デプロイするアセンブリ・インスタンスを選択します。

アセンブリ・インスタンスのデプロイメントでは、様々なフェーズを遷移します(図1-4)。フェーズには、ステージング済、デプロイ済および失敗があります。各状態では、オペレーションの一部を使用できます。たとえば、アセンブリ・インスタンスのデプロイ時に、アプライアンス・インスタンスを開始および終了できます。また、そのデプロイされたアセンブリ・インスタンスに関連付けられたアプライアンス・インスタンス数を増減できます。Oracle Virtual Assembly Builderでは、デプロイされたアプリケーションの状態を監視しません。アセンブリがデプロイまたはステージングされたかどうかと、デプロイメント関連の操作が成功したか失敗したかを通知するのみです。

図1-4 デプロイメント・ライフ・サイクル

次に、アセンブリ・インスタンスの各フェーズのサマリーを示します。

- デプロイ済: アセンブリ・インスタンスをデプロイし、操作が正常に完了すると、「デプロイ済」状態になります。「デプロイ済」アセンブリ・インスタンスに対して実行できる操作は、次のとおりです。

- StopAssemblyInstance: この操作は、アセンブリ・インスタンスの実行中のアプライアンス・インスタンスをすべて停止します。アセンブリ・インスタンスは、この操作の完了後に「ステージング済」フェーズに遷移します。後で再開できるように、アプライアンス・インスタンスは仮想化された環境に残ります。

- UndeployAssemblyInstance: この操作は、アプライアンス・インスタンスをすべて停止し、環境から削除します。この操作の完了後、再度デプロイできるように、アセンブリ・インスタンスはシステム内に維持されます。

- RestartAssemblyInstance: この操作は、アセンブリ・インスタンスの実行中のアプライアンス・インスタンスをすべて再開します。アセンブリ・インスタンスは、「ステージング済」に遷移してから、「デプロイ済」に戻ります。

- RedeployAssemblyInstance: この操作は、アセンブリ・インスタンスを再デプロイします。この操作の一環として、すべてのアプライアンス・インスタンスが停止し、ターゲット環境から削除されます。新しいアプライアンス・インスタンスが作成および開始されます。

- スケール: アセンブリ・インスタンス内のスケーリング・グループをスケーリングします。スケーリングを実行し、アセンブリ・インスタンスでスケーリング・グループをスケール・アップまたはスケール・ダウンできます。スケーリング・グループ用に実行できるアプライアンス・インスタンスの数は、構成されたインスタンスの上限と下限の間である必要があります。デプロイメントでは、「デプロイ済」状態のままです。

- 失敗: デプロイ操作またはアンデプロイ操作で失敗すると、アセンブリ・インスタンスはこのフェーズになります。デプロイメント操作は、リソース不足など様々な理由で失敗します。失敗したデプロイメントに対して実行できる操作は、次のとおりです。

- DeleteAssemblyInstance: この操作は、必要なクリーンアップを実行します(アプライアンス・インスタンスの停止および削除など)。この操作の完了後、アセンブリ・インスタンスは存在しなくなります。

- ステージング済: アセンブリ・インスタンスを停止すると、このフェーズになります。このフェーズでは、すべてのアプライアンス・インスタンスが停止されます。このフェーズから実行できる操作は、次のとおりです。

- StartAssemblyInstance: この操作は、停止されたアプライアンス・インスタンスをすべて開始します。この操作の完了後、アセンブリ・インスタンスは「デプロイ済」状態に戻ります。

- UndeployAssemblyInstance: この操作は、仮想化された環境から停止されたアプライアンス・インスタンスをすべて削除します。この操作の完了後、再度デプロイできるように、アセンブリ・インスタンスは維持されます。

2 アーキテクチャ

この章では、Oracle Virtual Assembly Builderのアーキテクチャについて説明します。内容は次のとおりです。

- 2.1項「主要コンポーネント」

- 2.2項「設定のシナリオ」

- 2.3項「デプロイメント・プラットフォーム」

2.1 主要コンポーネント

この項では、Oracle Virtual Assembly Builderの主要コンポーネントについて説明します。

2.1.1 Oracle Virtual Assembly Builder Studio

Oracle Virtual Assembly Builder Studioは、ユーザーがアセンブリを作成できるようにするコンポーネントで、インタフェースとしてOracle Virtual Assembly Builder Studio GUIとabctlコマンドライン・インタフェースの2つがあります。

Oracle Virtual Assembly Builder Studioおよびabctlは、図2-2に示すように、Oracle Virtual Assembly Builder DeployerとWebクライアントとしてやり取りします。Oracle Virtual Assembly Builder Studioには、Oracle Virtual Assembly Builder Studioからデプロイメントを開始したり、デプロイメントでOracle Virtual Assembly Builder Deployerを利用したりできるデプロイヤ・ユーザー・インタフェースが用意されています。

2.1.1.1 カタログの概要

Oracle Virtual Assembly Builder Studioカタログには、イントロスペクションの結果であるアプライアンスおよびアセンブリのメタデータ定義が含まれます。これらのアプライアンスおよびアセンブリの取得されたファイル・セット、仮想マシン・テンプレートおよびデプロイメント・プランもカタログに格納されます。

図2-1に、Oracle Virtual Assembly Builder Studioとカタログとの関係およびデプロイヤとEnterprise Grid Controlソフトウェア・ライブラリとの関係を示します。

図2-1 Oracle Virtual Assembly Builder Studioとデプロイヤ

2.1.2 デプロイヤ

Oracle Virtual Assembly Builder Deployerは、Oracle Virtual Assembly Builder Studioによって作成されたアセンブリ・アーカイブを保守するJ2EEアプリケーションで、Oracle VMなどの仮想化されたシステムにアセンブリ・アーカイブを登録するための操作と、アセンブリ・アーカイブによって定義されるソフトウェア・システムのデプロイメントを編成するための操作を提供します。

Oracle Virtual Assembly Builder Studioによって作成されたアセンブリ・アーカイブには、互いに連携してアプリケーションを形成する複数の関連ソフトウェア・スタックで構成されるソフトウェア・システムに関する情報が含まれます。この仕組みはアセンブリと呼ばれます。アセンブリ・アーカイブには、仮想化された環境でアセンブリのインスタンスをインスタンス化するのに使用されるアセンブリおよび仮想マシン・テンプレートに関するメタデータが含まれます。

デプロイヤは、Oracle WebLogic Server管理サーバーのOracle WebLogic Serverサーブレット・コンテナ内で稼働します。図2-2に、Oracle Virtual Assembly Builder Deployerの最上位コンポーネントを示します。

図2-2 デプロイヤのアーキテクチャ

2.1.2.1 Webアプリケーション

Oracle Virtual Assembly Builder Deployerへのインタフェースは、アセンブリ・アーカイブのアップロード、仮想化システムへのアセンブリ・アーカイブの登録、およびアセンブリ・アーカイブに定義されるシステムのデプロイメント・インスタンスの管理のための操作を提供するWebサービスです。

Webサービスに対する操作は、HTTPリクエストをOracle Virtual Assembly Builder Deployerのコンテキスト・パスにポストすることによって実行されます。リクエストには、アクションを定義するリクエスト・パラメータに続いて、操作の引数を定義するゼロ以上のリクエスト・パラメータが含まれます。レスポンスは通常、実行される操作に関連するXML文書です。ただし、アセンブリ・アーカイブ、デプロイメント・プラン、メタデータ・ファイルなどのアーティファクトがデプロイヤからクライアントにダウンロードされる場合を除きます。サンプルのリクエストおよびレスポンスは、『Oracle Virtual Assembly Builder開発者ガイド』を参照してください。

操作によっては、非同期アクションを定義できます。

2.1.2.2 「デプロイメント」ナビゲータ

デプロイヤの「デプロイメント」ナビゲータは、特殊なWebクライアントであるOracle Virtual Assembly Builder Studioの機能です。このナビゲータには、Webクライアントからデプロイヤにアップロードされたアセンブリ・アーカイブおよびデプロイメント・プランが表示されます。Oracle Virtual Assembly Builder Studioを使用してアセンブリ・アーカイブおよびデプロイメント・プランを作成しますが、デプロイヤが保持するリポジトリは、Oracle Virtual Assembly Builder Studioカタログとは別個のものです。デプロイヤのランタイム状態は、障害時にデプロイヤ・インスタンスをリカバリできるようにディスク上に維持されます(デプロイヤ・プロセスは終了します)。

Oracle VMの場合、デプロイヤは1つ以上の仮想化システムとやり取りし、これらのシステムへのアセンブリ・アーカイブのデプロイメントを編成します。Oracle Exalogicの場合、デプロイヤは事前構成済のターゲットを1つ保持し、そのシステムへのアセンブリ・アーカイブのデプロイメントを編成します。

2.1.2.2.1 アセンブリ・アーカイブのバージョニング

デプロイヤのリポジトリにより、同時に複数のバージョンのアセンブリ・アーカイブをリポジトリで保持できるようになります。アセンブリ・アーカイブをアップロードすると、デプロイヤはバージョン番号を割り当てます。同じ名前の別のアセンブリ・アーカイブをアップロードすると、次のバージョンが取得されます。

操作(registerAssemblyArchive、describeAssemblyArchivesなど)でバージョン番号を指定しないと、最新のバージョンが使用されます。

2.2 設定のシナリオ

この項では、Oracle Virtual Assembly Builderを設定できる様々な方法について説明します。

2.2.1 デプロイヤのみインストールするシナリオ

Oracle Virtual Assembly Builder Studioなしで、Oracle Virtual Assembly Builder Deployerを単独で設定できます。このインストール・シナリオでは、デプロイメント・ターゲットの構成、デプロイヤへのアセンブリ・アーカイブのアップロード、アセンブリ・インスタンスの作成、アセンブリ・インスタンスのデプロイ、アンデプロイ、起動、停止、およびアプライアンス・インスタンスのスケーリングが可能になります。

この構成には、次のインタフェースが含まれます。

- PaaS操作を実行するには、WebサービスAPIを使用できます。

- PaaS操作または管理操作のWebサービスAPIとやり取りするには、abctlを使用できます。

- デプロイヤで管理操作を実行するには、WebサービスAPIを使用できます。

2.2.2 Studioのみインストールするシナリオ

Oracle Virtual Assembly Builder Deployerなしで、Oracle Virtual Assembly Builder Studioを単独で設定できます。このインストール・シナリオでは、アプライアンスとアセンブリの作成、アプライアンス・テンプレートとアセンブリ・アーカイブの作成、およびデプロイメント・プランの作成が可能になります。

この構成には、次のインタフェースが含まれます。

- Oracle Virtual Assembly Builder Studioグラフィカル・ユーザー・インタフェース

- abctl CLI (アセンブリを作成およびデプロイするための全機能)

注意:

このシナリオは、追加インストールなしのOracle Exalogicには適用されません。

2.2.3 Studioと同じ場所に配置されるデプロイヤ

同じマシンのOracle Virtual Assembly Builder Studioと同じ場所に配置されるOracle Virtual Assembly Builder Deployerを異なるプロセスで設定できます。この構成には、Oracle Virtual Assembly Builder DeployerとOracle Virtual Assembly Builder Studioの前述のインタフェースが含まれており、「デプロイヤのみインストールするシナリオ」で説明した全操作と、「Studioのみインストールするシナリオ」で説明した全操作の実行が可能になります。

2.2.4 Studioとのリモート・デプロイヤ

Oracle Virtual Assembly Builder Deployerとリモートでやり取りするように、Oracle Virtual Assembly Builder Studioを設定できます。Oracle Virtual Assembly Builder Studioは、Oracle VMデプロイヤとOracle Exalogic内で実行されているデプロイヤの両方とリモートでやり取りできます。Oracle Virtual Assembly Builder Studioのグラフィック・ユーザー・インタフェースとabctlコマンドライン・インタフェースの両方を使用して、いずれのデプロイヤともインタフェースをとることができます。

この構成には、Oracle Virtual Assembly Builder DeployerとOracle Virtual Assembly Builder Studioの前述のインタフェースが含まれており、「デプロイヤのみインストールするシナリオ」で説明した全操作と、「Studioのみインストールするシナリオ」で説明した全操作の実行が可能になります。

2.3 デプロイメント・プラットフォーム

Oracle Virtual Assembly Builderアセンブリ・アーカイブは、Oracle VMまたはOracle Exalogicのプラットフォームにデプロイできます。

2.3.1 Oracle VM x86へのデプロイ

Oracle VM 3.0.3以上にデプロイできます。

2.3.2 Oracle Exalogicへのデプロイ

Oracle Exalogicは、Oracle Virtual Assembly Builderのターゲット・プラットフォームです。Oracle Virtual Assembly Builder Deployerは、Oracle Exalogicランタイムの一部として実行されるように、構成およびプロビジョニングされます。

3 セキュリティ

この章では、Oracle Virtual Assembly Builderのセキュリティについて説明します。内容は次のとおりです。

- 3.1項「リソース」

- 3.2項「デプロイヤで採用されるセキュリティ・モデル」

- 3.3項「ロールとグループ」

3.1 リソース

表3-1で説明するリソースは保護されます。

表3-1 リソース

リソース

保護の方法

ターゲット

Oracle VMの場合、ターゲットは、Cloud Adminによって作成されます。Oracle Exalogicの場合、インストール時に1つのターゲットが暗黙的に構成され、インストール後に新しいターゲットは作成できません。

Oracle VMの場合、Cloud AdminがApplication Adminにターゲットを使用するための権限を付与します。Oracle Exalogicの場合、どのCloud Adminも構成済ターゲットを使用できますが、固有の資格証明情報を仮想化システムに指定する必要があります。

この違いの理由は、Oracle VMでは、Cloud AdminがOracle VM Managerに共有資格証明を指定するためです。Oracle Exalogicの場合、暗黙的に構成された1つのターゲットにのみターゲットURLが含まれます。

Cloud Adminのみがターゲットの構成情報を表示できます。

資格証明(パスワードおよび鍵)

暗号化

デプロイヤのアセンブリ・アーカイブ

「所有者」概念によって保護されます。詳細は、3.2.2項「アセンブリ・アーカイブ認可」を参照してください。

デプロイヤのアセンブリ・インスタンスとデプロイメント・プラン

「所有者」概念によって保護されます。詳細は、3.2.2項「アセンブリ・アーカイブ認可」を参照してください。

3.2 デプロイヤで採用されるセキュリティ・モデル

Oracle Virtual Assembly Builder Deployerは、Oracle WebLogic Serverコンテナ内で実行されるアプリケーションとして構築されており、Oracle WebLogic Serverによって提供されるセキュリティ・インフラストラクチャを利用します。Oracle WebLogic Serverは、デフォルトでは組込みLDAPオーセンティケータで構成されていますが、外部企業LDAPを指すようにOracle WebLogic Serverを再構成できます。デプロイヤは、Cloud AdminとApplication Adminの2つのグループの一方、または両方に属するOracle WebLogic Serverユーザーに依存します。

Cloud AdminとApplication Adminのグループおよびロールの作成の詳細は、3.3項「ロールとグループ」を参照してください。

これらのグループでユーザーを保有すると、ユーザーをマップしてデプロイヤで必要なロール(Cloud AdminまたはApplication Admin)を保有することができます。デプロイヤのアクセス制御では、ユーザーがこれらのグループの一方または両方に属している必要があります。abctlを使用してデプロイヤへの接続を設定するときに、これらのグループの一方または両方に追加されているOracle Weblogic Serverユーザーのユーザー名およびパスワードを指定する必要があります。

Oracle Virtual Assembly Builder Studioまたはabctlのいずれかを使用してユーザーがデプロイヤ操作を試行すると、ユーザーは接続情報を使用して認証されます。認証されると、ユーザーのリクエストはWLSサーブレット・コンテナ内で実行されているデプロイヤのサーブレットに移動します。サーブレットでは、これらのロールのいずれかにユーザーが属することをチェックし、追加チェック(ユーザーが指定ターゲットへのアクセスを許可されているかどうか、ユーザーが指定アセンブリ・アーカイブへのアクセスを許可されているかどうかなど)を実行します。

Oracle Virtual Assembly Builder Deployerではアクセス・チェックにOracle WebLogic Server機能を使用しますが、Oracle Virtual Assembly Builder Deployerにはそのアイデンティティの管理に関するLDAP情報を表示できません。このような状況により、Oracle Virtual Assembly Builder構成がまだ所定の場所にあるそのユーザー名を参照している間に、Oracle WebLogic Serverからユーザーを削除する可能性があります。

注意:

Oracle Virtual Assembly Builderリクエストが前述の認証およびアクセス・チェックを越えて移動してしまうと、ユーザー情報がWebLogic Server認証ストアから削除されても、リクエストは完了するまで続行します。

3.2.1 ターゲット認可

Oracle VMの場合、ターゲットの作成、ターゲットの構成情報の表示などの機能を実行できるのはCloud Adminのみです。Oracle VMの場合、Cloud AdminがApplication Adminにターゲットを使用するための権限を付与します。

Oracle Exalogicの場合、どのCloud Adminも構成済ターゲットを使用できますが、固有の資格証明情報を仮想化システムに指定する必要があります。Oracle VMでは、Cloud AdminがOracle VM Managerに共有資格証明を提供します。

注意:

Oracle WebLogic Server認証ストアからユーザーを削除する場合、以前に追加したすべてのターゲットからそのユーザーを削除して(describeUserTargetsおよびremoveTargetUsers)、デプロイヤからそのユーザーに関するキャッシュ済情報をすべて削除する必要があります。

デプロイヤのターゲットからユーザーを削除すると、デプロイヤからそのユーザーに関するキャッシュ済情報がすべて削除されます。これにより、キャッシュ済情報があるユーザーがOracle WebLogic Serverから削除され、同じ名前の別のユーザーがOracle WebLogic Serverに追加され、新しいユーザーが前のユーザーのデプロイヤ内のキャッシュ済情報をすべて継承するという状況が回避されます。

3.2.2 アセンブリ・アーカイブ認可

ユーザーがアセンブリ・アーカイブにアクセスしようとすると、デプロイヤがチェックを実行します。アクセス権を付与されるのは次のユーザーです。

- OVAB_ADMINロールを持つユーザー。

- アセンブリ・アーカイブの所有者。アセンブリ・アーカイブを最初にアップロードするユーザーが所有者になります。

3.2.2.1 addAssemblyUsersコマンドによる追加ユーザーの作成

addAssemblyUsersコマンドを使用して、追加ユーザーを認可してアクセス・リストに追加できます。この操作を実行できるのは、OVAB_ADMINロールを持つユーザーか、アセンブリ・アーカイブの所有者のみです。

アセンブリ・アーカイブの所有者であるApplication Adminのみが、アセンブリ・ユーザーの追加/削除/説明を行ったり、アセンブリを削除したり、アセンブリ・アーカイブを更新することで、これを管理できます。アセンブリ・アクセス・リストにあるユーザーは、アセンブリ・インスタンスを表示、ダウンロード、登録、作成することでアセンブリを使用できます(ターゲットへのアクセス権もあると想定した場合)。

3.2.2.2 アセンブリ・インスタンス

アセンブリ・インスタンスを作成したユーザーがその所有者です。Cloud Admins以外でアセンブリ・インスタンスを管理および使用できるのは、アセンブリ・インスタンスの所有者のみです。

3.2.2.3 アセンブリ・リソース

uploadAssemblyResourcesコマンドはセキュリティ・ポリシーによって制御されます。リソース・ファイルにはスクリプトが含まれる場合と含まれない場合があります。リスース・ファイルにスクリプトが含まれていない場合は、アセンブリ・アクセス・リスト上のユーザーがコマンドを実行できます。リソース・ファイルにスクリプトが含まれている場合は、悪意のある攻撃を防止するために、コマンドを実行できるのはCloud Adminユーザーのみになります。

リソース・ファイルにスクリプトが含まれる場合、サポートされるライフサイクル名は、pre-deploy、post-deploy、deployer-pre-app-config、deployer-post-app-config、deployer-pre-vm-start、deployer-post-vm-start、deployer-pre-vm-stop、deployer-post-vm-stop、pre-undeploy、post-undeployになります。対応するスクリプト・フォルダ名を作成できます。

3.2.3 デプロイヤの認証および認可モデルの有効化

デプロイヤの認証および認可モデルを有効にするには、次の手順を実行します。

1. システム管理者は、LDAPでユーザーを定義し、Cloud AdminまたはApplication Adminロールをそれらのユーザーに割り当てます。これらのロールは、指定されたユーザーが実行できる事柄を制御します。このステップは、Oracle WebLogic Server管理コンソールを使用して実行します。
Webサービスに対して残りの操作を実行します。Webサービス・コールにはOracle Virtual Assembly Builderユーザー資格証明が必要です。コールする必要があるデプロイヤWebサービス操作は、次のとおりです。

2. createTarget - この操作は、Cloud Adminによってのみ実行できますが、接続情報と、バックエンド・タイプに応じてバックエンドのユーザー資格証明を定義します。Oracle VMの場合はここで資格証明を指定しますが、Oracle Exalogicの場合は個々のユーザーがaddTargetUserステップで各自の資格証明を指定します。

3. addTargetUser - バックエンド・システムのセキュリティ・モデルにおける相違のため、バックエンド・タイプに応じて、これはCloud AdminコールまたはApplication Adminコールになります。

- Oracle VMターゲットの場合、この操作はCloud Adminによってのみ実行でき、プールにアクセスできるユーザーの制御に使用されます。Cloud Adminによって指定される資格証明は一般ユーザーから保護する必要があるため、これはCloud Admin操作です。

- Oracle Exalogicターゲットの場合、これはユーザー操作で、ユーザー資格証明の指定に使用されます(この場合、バックエンドで資格証明をチェックするため、Cloud Adminは特定のアクセス権を付与する必要がありません)。ユーザーの資格証明はCloud Adminを含め他のユーザーから保護する必要があるため、これはApplication Admin操作です。

4. uploadAssemblyArchive - これは、アセンブリ・アーカイブをOracle Virtual Assembly Builder Deployerにアップロードするのに使用されるCloud Adminコールです(admin以外のユーザーはアセンブリ・アーカイブをアップロードできません)。

セキュリティの構成に関する手順は、第5.4.1項「ターゲットの構成」を参照してください。

3.3 ロールとグループ

Oracle Virtual Assembly Builderでは、セキュリティ・ロールおよびグループを定義します。組込みLDAPの場合は、製品インストーラがロールおよびグループを設定します。ユーザーはOracle WebLogic Serveコンソールからユーザーを作成してグループに追加します。

次のプロセスに従ってロールおよびグループを作成します。

1. 外部LDAP用にOracle WebLogic Serverを構成するには、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』の手順を使用します。

2. LDAPサーバーで「Cloud Admins」と「Application Admins」のグループを作成します。

3. LDAPサーバーで定義したユーザーをこれらのグループに追加します。

4. ロール式Grp(GroupName|GroupName|GroupName)を使用して、グループをセキュリティ・ロールに入れます。
Oracle WebLogic Serverにおけるロールの計算および付与のプロセスは、ロール・マッピングと呼ばれます。アクセス決定は、サブジェクトがWebLogicリソースに対して特定の操作を実行する権限を持っているかどうかを判別する認可プロバイダのコンポーネントです。(『Oracle Fusion Middleware Oracle WebLogic Serverセキュリティ・プロバイダの開発』のアクセス決定に関する項を参照してください)。

3.3.1 Application Adminグループ

LDAPでApplication Adminsグループ帯域外を作成します。

LDAPでApplication Adminユーザー帯域外を作成します。このグループのメンバーをApplication Adminグループに含めます。

3.3.2 Cloud Adminsグループ

LDAPでCloud Adminsグループ帯域外を作成します。

LDAPでCloud Adminユーザー帯域外を作成します。Cloud Adminsグループにユーザーを含めます。これにより、Cloud Adminロールがログイン時に割り当てられます。

3.3.3 Cloud Adminロール

web.xmlのauth-constraintとweblogic.xmlのCloud Adminロールに対するCloud Adminsグループのsecurity-role-assignmentごとに、Cloud Adminロールを作成します。

3.3.4 Application Adminロール

web.xmlのauth-constraintとweblogic.xmlのApplication Adminロールに対するApplication Adminsグループのsecurity-role-assignmentごとに、Application Adminロールを作成します。

4 アプライアンスおよびアセンブリの構造

この章では、Oracle Virtual Assembly Builderのアプライアンスおよびアセンブリの構造について説明します。内容は次のとおりです。

- 4.1項「アプライアンス構造」

- 4.3項「Oracle VM 3.0へのデプロイメントにおける新しい概念」

4.1 アプライアンス構造

アプライアンスは、1つのコンポーネントの1つのインスタンスを実行するためのすべてのソフトウェアを含んだ自己完結型仮想ディスク・イメージ・セットです。アプライアンスには、アプライアンス構成、アプライアンス・バイナリおよびオペレーティング・システムが含まれます(図4-1)。

図4-1 アプライアンス構造

4.1.1 アプライアンス構成

アプライアンス構成は、アプライアンスのイントロスペクション時に取得され、イントロスペクション・プロパティ、システム・プロパティ、ユーザー・プロパティ、ファイル・セットと、カスタマイズされたスクリプトおよびプロパティ・ファイル(オプション)が含まれます。

4.1.2 アプライアンス・バイナリ

アプライアンス・バイナリは、アプライアンスに含まれるソフトウェア・バイナリです。これらには、コンテナ・バイナリと製品バイナリの他、構成済カスタム・アプリケーション・バイナリがあります。

4.1.3 オペレーティング・システム

アプライアンスには、Oracle Enterprise Linuxテンプレートに基づいて、特定の要件に合せてカスタマイズされたオペレーティング・システム・ベース・イメージが指定されます。Oracle Virtual Assembly Builderでは、サンプルのベース・イメージをいくつか公開しています。

4.2 アセンブリ構造

アプライアンスをグループ化して、その関係をソフトウェア・アセンブリと呼ばれるアーティファクトに定義できます。アセンブリは、完全な複数層アプリケーション・トポロジを記述するブループリントを提供します。

アセンブリには、アプライアンスの他に、アセンブリには含めることができないデータベース、サーバーまたはセキュリティ・プロバイダなどのインフラストラクチャを表す外部システムへの参照が含まれます。

4.3 Oracle VM 3.0へのデプロイメントにおける新しい概念

この項では、Oracle VM 3.0デプロイメントのために導入された構造について説明します。

- 4.3.2項「ネットワーク・インタフェース(NIC)の構成」

- 4.3.3項「共有ファイル・セット」

- 4.3.4項「ゼロカウント・アプライアンス」

- 4.3.5項「アンチアフィニティ」

4.3.1 用語

次に、用語の定義をアルファベット順で示します。

- アンチアフィニティ: ターゲットの異なる物理ホストにわたって、特定のアプライアンスの複数のインスタンスを配置すること。複数の物理マシンにわたってインスタンスを均等に分散します。

- NIC: ネットワーク・インタフェース。1つのNICが接続できるVnetは、1つのみです。

- 共有ファイル・セット: アセンブリ内の個々のアプライアンスで共有されるファイル・セット。

- Vnet: 仮想ネットワーク。1つ以上のNICまたはvNICがVnetに接続します。

- vNIC: 仮想ネットワーク・インタフェース。1つのvNICが接続できるVnetは、1つのみです。

- ゼロカウント・アプライアンス: 初めにアプライアンス・インスタンスがゼロでデプロイされるアプライアンス。

4.3.2 ネットワーク・インタフェース(NIC)の構成

新しいアセンブリを作成すると、そのアセンブリに対してVnetが1つ自動的に作成され、そのVnetに接続する1つ以上のネットワーク・インタフェースまたは仮想ネットワーク・インタフェースで構成できます。そのVnetはデフォルトの仮想ネットワークになります。Vnetは追加作成できます。また、作成したVnetを削除できます。アセンブリの編集時に、ネットワーク・インタフェースをVnetにバインドできます。

4.3.3 共有ファイル・セット

基礎となるインフラストラクチャ・プラットフォームでサポートされる場合、アセンブリ内の個々のアプライアンスで共有されるようにそのファイル・セットを指定できます。

4.3.4 ゼロカウント・アプライアンス

初めにアプライアンス・インスタンスがゼロのアプライアンスをデプロイできます。しかし、後続のスケーリング操作では、アセンブリ構成の一部であるのに初めにインスタンス数がゼロで"デプロイされた"アプライアンスに、アプライアンス・インスタンスを追加できます。アセンブリ内の他のアプライアンスが参照しないアプライアンスのみ、インスタンス数をゼロにできます。つまり、他のアプライアンスはそのアプライアンスに依存しません。またはその入力に接続しません。

4.3.5 アンチアフィニティ

ターゲットの異なる物理ホストにわたって、特定のアプライアンスの複数のインスタンスを配置するための要件を指定できます。

アプライアンスのインスタンスを分散する物理マシンの最小数を指定できます。デプロイヤによって必ずインスタンスは均等に分散されます。たとえば、物理マシンの最小数を2と指定し、4つのインスタンスがある場合、物理マシンが3つ以上のインスタンスを持つことはありません。また、最小要件を満たすのに十分な物理マシンがない場合、アプライアンスの新しいインスタンスを要求するデプロイメント操作またはスケーリング操作は拒否されます。

5 Oracle Virtual Assembly Builderの使用

この章では、Oracle Virtual Assembly Builderの使用方法について説明します。内容は次のとおりです。

- 5.1項「Oracle Virtual Assembly Builderのインタフェース」

- 5.2項「標準的なワークフロー」

- 5.3項「アセンブリの作成に関連する操作」

- 5.4項「デプロイメントに関連する操作」

5.1 Oracle Virtual Assembly Builderのインタフェース

Oracle Virtual Assembly Builderには、製品のどの部分をインストールしたかに応じて、次のユーザー・インタフェースが用意されています。

- Oracle Virtual Assembly Builder Studioをインストールした場合、次のインタフェースがサポートされます。

- Oracle Virtual Assembly Builder Studioグラフィカル・ユーザー・インタフェース

- abctl (コマンドライン・ツール)。

- Oracle Virtual Assembly Builder Studioおよびabctlは、Oracle Virtual Assembly Builder DeployerとWebクライアントとしてやり取りします。適切に構成されたOracle Virtual Assembly Builder Studio環境では、グラフィカル・ユーザー・インタフェースまたはabctlのいずれかを使用し、Oracle Virtual Assembly Builder Deployerへの構成された接続を介してデプロイを実行できます。

- Oracle Virtual Assembly Builder Deployerをインストールした場合、次のインタフェースがサポートされます。

- abctl (コマンドライン・ツール)。

- Oracle Virtual Assembly Builder Deployer WebサービスとのインタフェースをとるためのWebサービスAPI (『Oracle Virtual Assembly開発者ガイド』を参照)。

Oracle Virtual Assembly Builder Deployerのみがインストールされている場合、一部のコマンドにのみアクセスできます。Oracle Virtual Assembly Builder Studioがインストールされている場合、またはOracle Virtual Assembly Builder StudioおよびOracle Virtual Assembly Builder Deployerがインストールされている場合、すべてのコマンドにアクセスできます。付録A「コマンドライン・リファレンス」を参照してください。

注意:

Oracle Virtual Assembly Builder Studioインタフェースまたはabctlインタフェースの2つのセッションを同時に起動することはできません。

5.1.1 Oracle Virtual Assembly Builder Studioへのアクセス

Oracle Virtual Assembly Builder Studioは、次のコマンドを実行して起動します。

$AB_INSTANCE/bin/abstudio.sh

注意:

インストールの詳細は、『Oracle Virtual Assembly Builderインストレーション・ガイド』を参照してください。

図5-1に、Oracle Virtual Assembly Builder Studioを示します。

図5-1 Oracle Virtual Assembly Builder Studio

5.1.2 abctlコマンドライン・ツールへのアクセス

abctlコマンドライン・ツールは、次のコマンドを実行して起動します。

$AB_INSTANCE/bin/abctl

5.1.3 ログへのアクセス

ログ・ファイルは、$AB_INSTANCE/logs/assemblybuilder.logに格納されます。

ログ・ファイルには手動でアクセスします。そうしないと、Oracle Virtual Assembly Builder Studioの「メッセージ」ウィンドウにメッセージが表示されます。

5.1.4 インタフェースの相違

Oracle Virtual Assembly Builder Studioインタフェースとabctlインタフェースは互いに補完しますが、まったく同じ機能ではありません。主な相違点は次のとおりです。

- 「デプロイヤのみ」モードで実行している場合は、abctlインタフェースのみサポートされます。

- Oracle Virtual Assembly Builder Studioにのみ、編集機能があります。つまり、abctlでは次の操作がサポートされていません。

- ファイル・セット定義の管理: ファイル・セット定義の作成、更新および削除

- ターゲット接続の管理: 既存のターゲット接続の作成、削除または編集

- プロパティ値の編集

- デプロイメント・プランの作成または編集

- Oracle Virtual Assembly Builder Studioでは、複数の参照システムのイントロスペクトし、結果を新しいアセンブリまたは既存のアセンブリに入れることができます。abctlでは、参照システムを1つずつイントロスペクトし、その後アセンブリに追加する必要があります。

- abctlにのみ、Oracle VM 3.0環境へのターゲット接続を作成する機能があります。Oracle Virtual Assembly Builder Studioには、接続ウィザードがありません。
また、デプロイヤ接続は、abctlを使用してのみ作成できます。

- 外部仮想マシン・テンプレートは、abctlを使用してのみ外部アプライアンスとしてカタログにインポートできます。

これらの相違点の詳細は、5.3項「アセンブリの作成に関連する操作」を参照してください。

5.1.5 ネーミング規則

ユーザー指定の名前は、次の規則に従う必要があります。

- 名前はアルファベット文字で始める必要があります。

- 名前に使用できるのは、英数字、アンダースコア(_)またはハイフン(-)のみです。

- 名前の長さは4から40文字までにする必要があります。

5.1.5.1 名前の競合

同じ名前のアプライアンスまたはアセンブリがすでに存在するカタログにアプライアンスまたはアセンブリをインポートすると、カタログ内のアプライアンスまたはアセンブリ間で名前の競合が発生する可能性があります。既存のアプライアンスまたはアセンブリを上書きする場合は、forceオプションを使用できます。

5.1.6 シンボリック・リンク

symlinkは、Oracle Virtual Assembly Builderではサポートされておらず、イントロスペクション、ファイル・セットの取得およびデプロイ時にエラーとなる可能性があります。Linux参照システムでは、symlinkを使用しないでください。

5.2 標準的なワークフロー

通常、次の方法でOracle Virtual Assembly Builderを使用します。

- アセンブリおよびアプライアンスを作成します。

- 参照システムをイントロスペクトし、アセンブリ内のアプライアンスを構成するすべてのコンポーネントについて必要なメタデータおよび構成情報を取得します。

- アセンブリおよびアプライアンスを編集し、アプライアンスと外部リソース間の関係を構成します。

- アセンブリ内でネットワークを作成します。

- アプライアンス内でネットワーク・インタフェースを作成します。

- アプライアンス入力をネットワーク・インタフェースに、ネットワーク・インタフェースをネットワークにバインドします。

- アプライアンス出力から外部リソースを作成します。

- アセンブリに必要なデプロイメント・アーティファクトを準備します。

- カスタマイズされたOracle Enterprise Linuxオペレーティング・システムのディストリビューションおよび構成可能なメタデータを使用してブート可能な仮想マシン・ディスク・イメージを作成し、ソフトウェア・コンポーネントのデプロイ時のカスタマイズを可能にします。

- デプロイ: アセンブリを環境にデプロイします。

- セキュリティを構成します。Oracle VMまたはOracle Exalogicのバックエンド・エンドポイントへの接続を定義し、デプロイメント・ターゲットをバックエンドに追加します。

- デプロイメント・プランを作成および編集します。

- アセンブリ・アーカイブをターゲットに登録します。

- アセンブリ・インスタンスをデプロイします。

- 他のライフサイクル操作をアセンブリ・インスタンスに対して実行します。

5.3 アセンブリの作成に関連する操作

この項では、Oracle Virtual Assembly Builder Studioまたはabctlコマンドライン・ユーティリティを使用してアセンブリの作成に関連する操作を実行する方法について説明します。

- 5.3.1項「参照システムのイントロスペクション」

- 5.3.2項「アプライアンスまたはアセンブリのファイル・セットの取得」

- 5.3.3項「アプライアンスまたはアセンブリのテンプレートの作成」

- 5.3.4項「Oracle Virtual Assembly Builder Studioを使用したアセンブリの編集」

5.3.1 参照システムのイントロスペクション

イントロスペクション操作により、アプライアンスとアセンブリ(Oracle Virtual Assembly Builder Studioを使用して操作を実行し、アセンブリを作成した場合)がカタログに作成されます。

イントロスペクション時、アプライアンスおよびアセンブリのメタデータは$AB_INSTANCE/catalog/metadataディレクトリに作成されます。一意のID (取得IDまたはcidと呼びます)がアプライアンスまたはアセンブリごとに生成され、メタデータに格納されます。さらに、ファイル・セット定義がカタログの共有領域に作成されます。

注意:

イントロスペクションとファイル・セットの取得の間に、参照システムの構成またはコンテンツを変更すると、望ましくない結果となる可能性があるため、変更しないでください。たとえば、参照システムをある日にイントロスペクトし、後日"同じ"参照システムでファイル・セットを取得することはサポートされません。

イントロスペクションを成功させるために、一部のイントロスペクション・プラグインには参照システムの実行状態について特定の要件があります。表5-1に、Oracle Virtual Assembly Builderでサポートされる製品の前提条件を示します。

表5-1 イントロスペクション・プラグインの要件

イントロスペクション対象の製品

実行状態の前提条件

Oracle WebLogic Server

管理サーバーが起動し、実行状態である(管理状態ではない)こと。管理対象サーバーは起動していても、停止していてもかまいません。

Oracle Coherence*Web

管理サーバーが起動し、実行状態である(管理状態ではない)こと。管理対象サーバーは起動していても、停止していてもかまいません。

Oracle Forms*Web

管理サーバーが起動し、実行状態である(管理状態ではない)こと。管理対象サーバーは起動していても、停止していてもかまいません。

Oracle SOA for WebLogic Server

管理サーバーが起動し、実行状態である(管理状態ではない)こと。管理対象サーバーは起動していても、停止していてもかまいません。

Oracle HTTP Server (OHS)

要件なし。Oracle HTTP Serverは起動していても、停止していてもかまいません。

Oracle Web Cache

要件なし。Oracle Web Cacheは起動していても、停止していてもかまいません。

Oracle RDBMS (DB)

イントロスペクション・フェーズでは、データベースは起動していても、停止していてもかまいません。

Oracle RACDB

イントロスペクション・フェーズでは、データベースは起動していても、停止していてもかまいません。

Oracle Reports

管理サーバーが起動し、実行状態である(管理状態ではない)こと。管理対象サーバーは起動していても、停止していてもかまいません。

Oracle Traffic Director

イントロスペクション・フェーズでは、Oracle Traffic Directorアプリケーションは起動していても、停止していてもかまいません。

Oracle Tuxedo

イントロスペクション・フェーズでは、Tuxedoアプリケーションは起動していても、停止していてもかまいません。

5.3.1.1 サポート対象外のマウントされたNFSファイル・システム

Oracle Virtual Assemblyでは、マウントされたNFSファイル・システムを使用した参照システムのイントロスペクションまたはデプロイメントをサポートしていません。

5.3.1.2 カスタム再構成スクリプト

カスタム再構成スクリプトを使用すると、アプライアンスのデプロイメントの一環として仮想マシンで実行されるカスタム・スクリプトをアプライアンスに追加できます。この機能により、アプライアンス内のOracle製品とともにデプロイされるカスタム製品またはアプライアンスを構成、操作できます。

この機能を使用するには、シェル・スクリプトを参照システムの一般的に知られている場所に配置して、そのシステムのイントロスペクション時に取得されるようにします。取得されたスクリプトは、対応する操作がデプロイされたOracle製品に対して実行されるときに、VMで実行されます。

注意:

この機能は、Oracle Virtual Assembly Builderカタログに外部アプライアンスとしてインポートされた外部仮想マシン・テンプレートに対してはサポートされません。

5.3.1.2.1 カスタム・スクリプト・ディレクトリ

カスタム・スクリプトは、/ovab/scripts.d/という名前の一般的に知られているルート・カスタム・スクリプト・ディレクトリ下にある一連のサブディレクトリに入れます。このディレクトリは、一般的に知られている名前(rc0.d/、rc1.d/、rc2.d/、...)の一連のサブディレクトリが含まれるLinuxの/etc/rc.d/ルート・ディレクトリに似ています。/etc/rc.d/と同様、各サブディレクトリには、適宜実行される1つまたは複数のスクリプトのセットが格納されます。/ovab/scripts.d/ディレクトリ内には、次のサブディレクトリを作成できます。

- pre-config.d/

- post-config.d/

- pre-start.d/

- post-start.d/

- pre-stop.d/

- post-stop.d/

注意:

不要なカスタム・スクリプト・ディレクトリを作成する必要はありません。

これらのディレクトリは、VMで実行される3つのアクション、つまり構成、起動および停止に対応します。"pre-"で始まるディレクトリに格納されたカスタム・スクリプトは、対応するアクションがデプロイされたOracle製品に対して実行される前に実行され、"post-"で始まるディレクトリに格納されたカスタム・スクリプトは、その後に実行されます。

"構成"アクションは、VMが完全に起動した後、最初のデプロイ時に1回のみ実行されます。"開始"アクションは、"構成"アクション後、Oracle Virtual Assembly Builderから起動されたアセンブリ開始操作の一環としてデプロイされたOracle製品を起動するときに、実行されます。"停止"アクションは、Oracle Virtual Assembly Builderから起動されたアセンブリ停止操作の一環としてデプロイされたOracle製品を停止するときに、実行されます。

イントロスペクションの最後に、Oracle Virtual Assembly Builderでは、カスタム・スクリプト・ディレクトリが参照システムに存在するかどうかをチェックし、見つかったスクリプトをアプライアンスに追加します。

例5-1に、ルート・カスタム・スクリプト・ディレクトリを示します。

例5-1 ルート・カスタム・スクリプト・ディレクトリ

/ovab/scripts.d/
pre-config.d/
00configthis.sh
01configthat.sh
post-config.d/
00configotherthing.sh
pre-start.d/
00startthisfirst.sh
01startthatsecond.sh
post-start.d/
00startotherthinglast.sh
...

スクリプトは、イントロスペクション時に残りのアプライアンス・メタデータとともにアプライアンス・テンプレートに自動的に追加されます。

5.3.1.2.2 スクリプトの実行

Oracle Virtual Assembly Builderでは、次のようにしてスクリプトを実行します。

- すべてのスクリプトは、Oracle Virtual Assembly Builderによってデプロイ時にrootとして起動されます。カスタム・スクリプトが、必要に応じて別のユーザーへの切替えを行います。

- スクリプトは、一度に1つずつ辞書式順序で実行されます。

- カスタム・スクリプトは、タイムリに完了する必要があります。実行中のアクションは、すべての必要なカスタム・スクリプトが実行され、デプロイされたOracle製品に対してもそのアクションが実行された後にのみ完了できます。

- スクリプトに引数は渡されません。

- カスタム・スクリプトの終了ステータスは無視されます。

- スクリプトが起動されると、各起動の詳細がVMの/assemblybuilder/logs/ディレクトリにある"command.out"という名前のファイルに記録されます。各スクリプトの出力は、スクリプトによって別の場所にリダイレクトされないかぎり、/assemblybuilder/logs/ディレクトリの別個のファイルに送信されます。各スクリプトが実行されると、各ファイルの名前が"command.out"に記録されます。

5.3.1.3 カスタム・アプライアンス・プロパティ

この機能を使用すると、イントロスペクションで参照システムの1つ以上のプロパティ・ファイルからプロパティを取得し、結果のアプライアンスまたはアセンブリにユーザー・プロパティとして追加できるため、これらのプロパティを編集できます。

デプロイ時、ユーザーによる変更を含む元のプロパティ・セットは、これらのプロパティに基づいてカスタム処理を実行するためにユーザーが指定するスクリプトで使用可能になります。

5.3.1.3.1 プロパティ・ディレクトリ

デハイドレーション時にプロパティ・ファイルが自動的に取得されるようにするには、プロパティ・ファイルを次の一般的に知られているディレクトリに入れる必要があります。

/ovab/scripts.d/properties/

このディレクトリは、取得される基礎となる製品と同じマシンに存在する必要があります。このディレクトリ内では、プロパティ・ファイルは次のネーミング方式に準拠する必要があります。

<filename>.userprops

<filename>には、コロン(:)を含めることはできません。この文字はプロパティ名の生成でデリミタとして機能するためです。

プロパティ・ディレクトリ内の前述のネーミング方式に準拠しないファイルは、追加のユーザー・プロパティを生成するために読み取られず、アプライアンスとともに盲目的に転送されます。これにより、内部プロパティや、再構成時にユーザー・プロパティの処理に役立つ他の情報を含む追加ファイルを指定できるようになります。

5.3.1.3.2 プロパティ・ファイル

プロパティ・ファイルはゼロ以上の行で構成され、各行はプロパティ宣言、コメントまたは空白行である必要があります。さらに正式には、プロパティ・ファイルは次の構文に準拠する必要があります。

property-file   = *line
line            = prop-decl | comment | blank-line
prop-decl       = name "=" value NL
comment         = *WS "#" *CHAR NL
blank-line      = *WS NL
name            = <any character in "a".."z", "A".."Z", "0".."9", "_", "-", ".">
value           = *XATTRCHAR
XATTRCHAR       = <any CHAR, escaped as necessary for XML element attribute interpretation>
CHAR            = <any character, excluding CTL (and NL), but including WS>
CTL             = <any control character (octets 0 -31) and DEL (127)>
NL              = <platform dependent line termination sequence>
WS              = <white space character>

前述の構文規則に準拠していないプロパティ・ファイルはエラーとなり、アプライアンスは作成されません。

プロパティ宣言は、1行で記述する必要があります。行を"\"で終わると、行は継続されません。

すべてのプロパティは、アプライアンス・メタデータで"required"のマークが付けられます。値が割り当てられていない("="の後に何もない)プロパティ宣言は、アプライアンス・メタデータでnullに設定されるため、デプロイ前にそのプロパティに値を割り当てる必要があります。

プロパティ宣言では、"="の左側のどこにも空白を指定することができません。"="の右側の空白は、目的の値の一部であると見なされ、維持されます。

コメントおよび空白行は、デハイドレーション時に維持され、リハイドレーション時にファイルが再生成されたときに再作成されます。

5.3.1.3.3 プロパティ名

プロパティ・ディレクトリ内の各*.userpropsファイルが読み取られ、アプライアンス・ユーザー・プロパティが各ファイルのプロパティごとに生成されます。プロパティ名は、プロパティがカスタムプロパティであり、特定のプロパティ・ファイルに属することを指定するため、次のように接頭辞を追加して変更されます。

custom:<filename>:<propname>

<filename>部は、接尾辞".userprops"を削除したプロパティ・ファイル名からきています。<propname>部は、プロパティ・ファイルで見つかったプロパティ名から変更なしで直接コピーされます。

編集時、プロパティ名全体が表示されます。再構成時に、プロパティ・ファイルが再作成されるときに接頭辞"custom:<filename>:"は削除され、プロパティ・ファイルに表示されません(つまり、ファイルで見つかった元のプロパティ名は再作成されたファイルで維持されます)。

5.3.1.3.4 プロパティ値

前述の「プロパティ・ファイル」の項で示したように、プロパティ値は、XML要素属性の要件に準拠する必要があります。プロパティ値で必要な文字のエスケープは、プロパティ・ファイルを作成するときにユーザーが行います。

5.3.1.3.5 デプロイ時

再構成時、アプライアンス内のユーザー・プロパティを横断して、接頭辞"custom:<filename>:"を持つすべてのプロパティが、指定されたfilename(接尾辞".userprops"を追加)のプロパティ・ファイルに追加されます。

元のプロパティ・ファイル内でのプロパティおよびコメントの順序は、再生成されたプロパティ・ファイルで維持されます。

生成されたプロパティ・ファイルはすべて同じディレクトリに格納されます。そのディレクトリへのフルパスは、すべての再構成スクリプトに次の名前の環境変数として渡されます。

$AB_CUSTOMPROPS_DIR

5.3.1.4 Oracle Virtual Assembly Builder Studioを使用したイントロスペクション

アセンブリの作成ダイアログを使用すると、新しいアセンブリを作成して名前を付け、イントロスペクトするアプライアンスを選択し、そのアプライアンスにイントロスペクタで必要な値を指定することができます。このダイアログにアクセスするには、「ファイル」 > 「新規」 > 「アセンブリ」を選択します。

「アセンブリの名前付け」ペイン(図5-2)で、次のフィールドに情報を入力します。

- アセンブリ名: 新しいアセンブリの名前

- デフォルトVnet名: Vnetのデフォルト名

- 説明: 省略可。テキストの説明を入力します。

- 空のアセンブリ: 空のアセンブリの作成を選択します。アプライアンスまたはこのアセンブリのプロパティを定義するかわりに、終了を選択します。

- 上書き: 同じ名前のアプライアンスまたはアセンブリがすでに存在し、登録されていない場合、上書きできます。

図5-2 「アセンブリの作成」ウィザード: アセンブリの名前付け

「次へ」をクリックして、イントロスペクション用のアプライアンスをアセンブリに定義します。

「イントロスペクトするコンポーネントの選択」ウィンドウ(図5-3)で、1つ以上のアプライアンスを新しいアセンブリに定義できます。

図5-3 「アセンブリの作成」ウィザード: アプライアンスの選択

「+」アイコン(図5-4)をクリックして、アプライアンスをアセンブリに追加します。

図5-4 新しいアセンブリへのアプライアンスの定義

イントロスペクションでサポートされるアプライアンスのリストが表示されます。

- 一般製品

- Oracle Coherence*Web (WLSの別名)

- Oracle HTTP Server

- Oracle Database

- Oracle Forms*Web

- Oracle RAC Database

- Oracle Reports

- Oracle SOA (WLSの別名)

- Oracle Web Cache

- Oracle WebLogic Server

- Oracle Traffic Director

- Oracle Tuxedo

アプライアンスに名前を付け、ローカル・ホストまたはリモート・ホストと作業ディレクトリ(リモート・イントロスペクション時に、構成ファイルをキャッシュ目的でローカルにコピーするために使用されるディレクトリ)を指定できます。

リモート・ホストを指定した場合、接続と認証パラメータを定義する必要があります。

「実行ユーザー」フィールドに、操作の実行前と同様の、sudoを実行するリモート・マシンのユーザーの名前を入力できます。たとえば、「ユーザー名」にbob、「実行ユーザー」にjillと指定してログインすると、イントロスペクション・プロセスはbobではなくjillとして実行されます。その場合、bobはjillに対するsudo操作を実行する必要があります。

リモート・ホストのパラメータを定義した後に、「接続のテスト」を選択し、指定した資格証明を使用してリモート・ホストへのSSH接続を確立できることを検証します。

「リモート・クリーン・アップ」を選択すると、リモート作業ディレクトリにコピーされたアーティファクトをイントロスペクションの完了後に削除できます。

注意:

データベース・インストール所有者のアカウントでデータベース・マシンにログインできない場合、データーベースのリモート・イントロスペクションを実行できません。リモート・イントロスペクションが必要な場合は、リモート・アクセス用のアカウントを有効にする必要があります。

5.3.1.4.1 拡張機能の表示

「拡張機能」ボタンをクリックして、選択したタイプについて含まれている拡張機能のリストを表示します(自動的に実行されます)。

図5-5 アプライアンスの拡張機能の表示

5.3.1.4.2 認証

「パスワード」を選択してパスワードを入力するか、「秘密鍵」を選択して、パスワードを指定するのではなく使用するSSH鍵を参照します。「秘密鍵」を選択した場合は、「参照」ボタンを選択し、ローカル・マシン上の秘密SSH鍵ファイルの場所までナビゲートします。秘密鍵ファイルを使用すると、Oracle Virtual Assembly Builderでパスワードを扱う必要がなくなるため、より高いセキュリティを実現できます。

5.3.1.4.3 プロパティの構成

「プロパティの構成」ウィンドウ(図5-6)で、前のウィンドウでイントロスペクション用に含めたアプライアンスのイントロスペクション・プロパティを設定できます。必須のプロパティはプロパティ名の隣のアスタリスクで示されます。

図5-6 「アセンブリの作成」ウィザード: プロパティの構成

プロパティの値を編集するには、「アプライアンス」ペインからアプライアンスを選択し、イントロスペクションのプロパティ・ペインからプロパティを選択します。プロパティの値を入力します。イントロスペクション・プロパティの詳細は、付録B「Oracle Virtual Assembly Builderのイントロスペクション・プラグイン」を参照してください。

5.3.1.4.4 ファイル・セットの取得

「ファイル・セットの取得」チェック・ボックスはデフォルトで選択されています。このオプションでは、イントロスペクション時に作成されたファイル・セット定義で指定された参照システムからファイルを取得します。ファイルは、カタログの共有領域に格納される1つ以上のzip (または他のRAW)ファイルにアーカイブされます。このチェック・ボックスの選択解除は、ファイル・セットをカスタマイズする予定のため、イントロスペクション時にファイル・セットを取得しない場合にのみ行います。

5.3.1.4.5 イントロスペクション用のアプライアンスのサマリー

すべてのアプライアンスについてすべての必須プロパティの値を設定したら、「次へ」(サマリーを参照する場合)または「終了」(サマリーを表示せずにイントロスペクションを開始する場合)をクリックします。

「サマリー」ウィンドウ(図5-7)には、イントロスペクション用に選択したアプライアンス、そのホストおよび入力されたイントロスペクション・プロパティの論理ツリー・ビューが表示されます。

図5-7 「アセンブリの作成」ウィザード: サマリー

終了をクリックして、イントロスペクションを開始します。確認用のボックスが表示され、操作には多くの時間とリソースが必要になることが通知されます。「OK」を選択して確定すると、イントロスペクションが開始されます。

イントロスペクションの進捗は、カタログ・ナビゲータで確認できます。Oracle Virtual Assembly Builder Studioでイントロスペクションが実行されているアプライアンスのノードが表示されます。イントロスペクションが失敗した場合、Oracle Virtual Assembly Builder Studioにそのアプライアンスのログへのリンクが表示されます。付録D「トラブルシューティング」も参照してください。

5.3.1.5 追加アプライアンスのイントロスペクション

イントロスペクション・ウィザードは、新しいアセンブリまたは既存のアセンブリに1つのアプライアンスを追加できるスタンドアロン・インタフェースです。アクセスするには、「ファイル」 > 「新規」 > 「アプライアンス・イントロスペクション」を選択します。

「アプライアンスの名前付け」ウィンドウで、コンポーネントに名前を付け、既存の親アセンブリの子として作成するか、スタンドアロン・コンポーネントとして作成するかを決定します。次の情報を入力します。

- アプライアンス名: アプライアンスに名前を付けます。任意の文字列を使用できます。名前は4から40文字で、先頭文字には数字以外の文字を使用する必要があり、スペースと特殊文字は使用できません(アンダースコアは使用できます)。アセンブリ名とアプライアンス名はローカライズできません。

- 上書き: 最上位でイントロスペクションを実行する場合、このボックスを選択すると最上位アセンブリまたはアプライアンス・オブジェクトを上書きできます(未登録の場合)。既存のアセンブリのイントロスペクションを実行する場合、このチェック・ボックスを選択すると、アセンブリおよびそのアセンブリ内のアプライアンスのみ上書きされます。

- 親アセンブリ: (省略可)ドロップダウン・リストから親アセンブリを選択するか、「<選択なし>」を選択し、カタログの最上位に新規アプライアンスを配置します。

- 説明: 説明を入力します(省略可)。

「次へ」をクリックします。

「ホストの識別」ウィンドウで、次の情報を入力し、イントロスペクトするアプライアンスが実行されているホストを特定します。

- リモート・ホストまたはローカル・ホスト: リモート・ホストまたはローカル・ホストを選択します。
「リモート・ホスト」を選択した場合は、次の情報を構成します。

- ホスト名: イントロスペクトするホストの名前を入力します。

- ポート: このホストのSSH用のポート番号を入力します。デフォルトのポート番号は22です。

- ユーザー名: リモート・ホストにログインするSSHユーザーのユーザー名を入力します。このユーザーには、イントロスペクションが実行される構成へのアクセス権が必要です。

- 認証: 「パスワード」を選択してパスワードを入力するか、「秘密鍵」を選択して、パスワードを指定するのではなく使用するSSH鍵を参照します。「秘密鍵」を選択した場合は、「参照」ボタンを選択し、ローカル・マシン上の秘密SSH鍵ファイルの場所までナビゲートします。秘密鍵ファイルを使用すると、Oracle Virtual Assembly Builderでパスワードを扱う必要がなくなるため、より高いセキュリティを実現できます。

- 実行ユーザー: 操作の実行前と同様の、sudoを実行するリモート・マシンのユーザーの名前を入力します。

- リモート作業ディレクトリ: イントロスペクションに必要なファイルをOracle Virtual Assembly Builderがステージングする、リモート・ホスト上のディレクトリへのパスを入力します。このファイルは再利用されることがあります。

- リモート・クリーン・アップ: リモート作業ディレクトリにコピーされたアーティファクトをイントロスペクションの完了後に削除する場合に、このチェック・ボックスを選択します。

注意:

データベース・インストール所有者のアカウントでデータベース・マシンにログインできない場合、データーベースのリモート・イントロスペクションを実行できません。リモート・イントロスペクションが必要な場合は、リモート・アクセス用のアカウントを有効にする必要があります。

「アプライアンス・タイプの選択」ウィンドウで、次の情報を入力し、イントロスペクトするアプライアンスのタイプを特定します。

- タイプ: 「タイプ」ドロップダウン・メニューからイントロスペクトするアプライアンスのタイプを選択します。

選択したアプライアンスのタイプに応じて、異なるセットのプロパティが表示されます。プロパティのセルを選択し、プロパティ値を入力して、アプライアンスのプロパティを設定します。必須のプロパティはアスタリスクで示されます。

5.3.1.5.1 拡張機能の表示

「拡張機能」ボタンをクリックして、選択したタイプについて含まれている拡張機能のリストを表示します(自動的に実行されます)。

5.3.1.5.2 イントロスペクション時のファイル・セットの取得

「ファイル・セットの取得」チェック・ボックスはデフォルトで選択されています。このオプションでは、イントロスペクションから生成されたファイル・セット定義を取得し、ファイル・セットを1つ以上のzip (または他のRAW)ファイルにアーカイブして、結果のファイルをカタログの共有領域に格納します。このチェック・ボックスの選択解除は、ファイル・セットをカスタマイズする予定のため、イントロスペクション時にファイル・セットを取得しない場合にのみ行います。

「終了」をクリックします。

5.3.1.6 abctlを使用したイントロスペクション

abctlには、ローカルとリモートの両方のイントロスペクション機能があります。リモート・イントロスペクションの場合、Oracle Virtual Assembly Builderホストにはサブジェクト・マシンへのSSHアクセスが必要です。

-nameフラグはオプションです。

次に2つの例を示します。

例5-2 Oracle HTTP Serverのリモート・イントロスペクション

$ ./abctl introspectOHS -oracleInstance /path/to/oi –componentName ohs1 –name myOHS -remoteHost myReferenceSystemHost –remoteUser abdemo

例5-3 Oracle WebLogic Serverのローカル・イントロスペクション

$ ./abctl introspectWLS -wlsHome /path/to/wls/wlserver_10.3 -domainRoot /path/to/user_projects/domains/basic_domain -adminUser weblogic -name myWLS

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.3.2 アプライアンスまたはアセンブリのファイル・セットの取得

ファイル・セットの取得では、イントロスペクションから生成されたファイル・セット定義を取得し、これらのファイル・セットを1つ以上のzip (または他のRAW)ファイルにアーカイブして、結果のファイルをカタログの共有領域に格納します。

取得を成功させるために、一部のプラグインには参照システムの実行状態について特定の要件があります。表5-2に、Oracle Virtual Assembly Builderでサポートされる製品の前提条件を示します。

表5-2 取得プラグインの要件

イントロスペクション対象の製品

実行状態の前提条件

Oracle WebLogic Server

要件なし。Oracle WebLogic Serverは起動していても、停止していてもかまいません。

Oracle Coherence*Web

要件なし。Oracle WebLogic Serverは起動していても、停止していてもかまいません。

Oracle HTTP Server (OHS)

要件なし。Oracle HTTP Serverは起動していても、停止していてもかまいません。

Oracle Web Cache

要件なし。Oracle Web Cacheは起動していても、停止していてもかまいません。

Oracle RDBMS (DB)

Oracle Virtual Assembly Builder Studioとabctlのいずれの場合も、ファイル・セットの取得がイントロスペクションの一環として実行される場合、データベースは停止している必要があります。

abctlの場合、ファイル・セットの取得フェーズ(abctl captureFileSetsコマンド)では、データベースは停止している必要があります。

Oracle Virtual Assembly Builder Studioの場合、テンプレートの作成フェーズでは、データベースは停止している必要があります。

Oracle Tuxedo

要件なし。Oracle Tuxedoは起動していても、停止していてもかまいません。

5.3.2.1 Oracle Virtual Assembly Builder Studioを使用したファイル・セットの取得

ファイル・セットの取得操作は、「テンプレートの作成」ウィザードで使用できます。このウィザードの詳細は、5.3.3項「アプライアンスまたはアセンブリのテンプレートの作成」を参照してください。

ローカルおよび共有ファイル・セットの構成

「ファイル・セット定義の構成」ウィンドウで、アプライアンスのローカルおよび共有ファイル・セットを構成します(図5-8)。表示されるファイル・セットは、イントロスペクタのプラグインによって構成されます(この時点では読取り専用)。

ファイル・セットを追加できます。たとえば、Oracle HTTP ServerにDocumentRootパスがあるときに、このファイル・セットを取得する場合があります。新しいファイル・セットには、「編集可能」と「共有可能」のマークが付けられます。

ファイル・セットの詳細

ファイル・セットについて次のパラメータを構成します。

- 名前: ファイル・セットの名前を入力します。

- ルート・ディレクトリ:ルート・ディレクトリを入力します。

- OS所有者およびOSグループ: 各ファイル・セットに、OS所有者とOSグループを指定できます。製品では、ベース・イメージに所有者またはグループ(あるいは、その両方)が定義されているという保証はありません。デプロイ時、指定した所有者とグループを使用してファイル・セットが展開されます。所有者とグループのデフォルトは"oracle"です。

- 除外: 各ファイル・セットに、取得しない、ルート・ディレクトリ下の場所を複数指定できます。この場所は、ルート・ディレクトリを基準とします。除外に指定できるパターンは、次のとおりです。

- リテラル・パス。例: foo/bar

- 後続のファイル名またはディレクトリ名の中に*。例:

- foo/bar/*

- foo/bar/*.log

- foo/bar/tmp.*

foo/barとfoo/bar/*の違いは、foo/barはbarを除外する一方、foo/bar/*はfoo/bar下のすべてを除外しますが、foo/bar自体は除外しません。

注意:

ベース・イメージには、所有者およびグループが定義されている必要があります。

ファイル・セットの取得

ファイル・セット定義を取得することができるディレクトリをこのファイル・セット内に作成します。ファイル・セット定義は、ファイル・セットを作成するための一連の手順です。ファイル・システム・タイプで許可されている場合は、ローカルとリモートの両方のファイル・セットを取得できます。「ファイルシステム・タイプ」を参照してください。

共有ファイル・セット

「編集可能」は、ファイル・セットの詳細を変更できるファイル・セットを示します。「共有可能」は、共有ファイル・セットに対して変更できるローカル・ファイル・セットを示します。また、「ローカライズ可能」は、ローカル・ファイル・セットに対して変更できる共有ファイル・セットを示します。

各ファイル・セットを共有またはローカルとして構成できます。シャトル・ボタンを使用すると、ある方向またはその逆方向にファイル・セットを移行できます。共有の場合、ファイル・セットの取得を決定してもしなくてもかまいません。場合によっては、ローカルから共有、あるいはその逆にファイル・セットを移行できません。これは、初期ファイル・セットを作成したイントロスペクタのプラグインによって定義され、Oracle Assembly Builder Studioではその設定に従います。

また、共有ファイル・セットにはマウント・オプションを指定できます。これは、デプロイメント・プランの編集時にプロパティ・インスペクタ・ビューでのみ発生します。

図5-8 ローカルおよび共有ファイル・セット

ファイルシステム・タイプ

指定したファイル・セットの空き領域サイズを指定できます(図5-9)。各ファイル・セットに空き領域を定義できます。この値はファイル・セットごとに設定されます。ローカル・ファイル・セットの場合、ファイル・セットを取得しないことを選択し、VM上に空き領域を作成することもできます。

ファイル・システム・タイプを選択します。ローカル・ファイル・セットの場合は、次を選択できます。

- Linux

- ファイル・セットを取得できます。

- 空き領域を定義できます。

「共有ファイル・セット」の場合は、次を選択できます。

- NFS

- ファイル・セットを取得できます。

- 空き領域を定義できません。

- RAW

- ファイル・セットを取得できません。

- 空き領域を定義できます。

- Linux

- ファイル・セットを取得できます。

- 空き領域を定義できます。

ファイル・セットの空き領域の定義

指定したファイル・セットの空き領域を定義します。空き領域の単位として、「メガバイト」、「ギガバイト」または「パーセント」を選択し、値を入力します。

空き領域の単位を「パーセント」として定義できるのは、ファイル・セットが取得される場合のみです。RAWファイル・システム・タイプでは、ファイル・セットを取得できないため、「パーセント」を使用できません。

図5-9 ファイル・セットの空き領域の定義

5.3.2.2 確認

確認ウィンドウで、決定したファイル・セットの取得を確認できます。確認後、「終了」をクリックします。

進捗メッセージは、メッセージ・ログ・ウィンドウにポストされます。「テンプレートの作成」タブを選択して「アセンブリ・ステータスの概要」を開いて確認すると、進捗が発生していることを確認できます。

5.3.2.3 abctlを使用したファイル・セットの取得

abctlのintrospect*コマンドは現在、デフォルトではイントロスペクションの最後にファイル・セットを取得します。これは、captureFileSetsコマンドによってファイル・セットを個別に取得することを許可するフラグでオーバーライドできます。

abctlには、ローカルとリモートの両方のファイル・セット取得機能があります。リモート・ファイル・セット取得の場合、Oracle Virtual Assembly Builderホストにはサブジェクト・マシンへのSSHアクセスが必要です。

次に2つの例を示します。

例5-4 Oracle HTTP Serverのリモート・ファイル・セット取得

$ ./abctl captureFileSets –name myOHS -remoteHost myReferenceSystemHost –remoteUser abdemo

例5-5 Oracle WebLogic Serverのローカル・ファイル・セット取得

$ ./abctl captureFileSets -name myWLS -force

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細がコマンドのサンプル出力とともに記載されています。

5.3.3 アプライアンスまたはアセンブリのテンプレートの作成

テンプレート作成では、仮想化されたプラットフォームにデプロイする準備ができた仮想マシン・テンプレートを生成します。Oracle Virtual Assembly Builderでは、Oracle VMが唯一サポートされるプラットフォームです。Oracle Virtual Assembly Builderでは、すべてのアプライアンスに対してOracle Enterprise LinuxゲストOSがサポートされます。

テンプレートを作成するには、オペレーティング・システムを含むシステム・ベース・イメージを指定する必要があります。サンプル・システム・ベース・イメージがニーズを満たさない場合は、独自のシステム・ベース・イメージを作成できます。

Oracle Virtual Assembly Builderには、Oracle Enterprise Linuxテンプレートのサンプル・システム・ベース・イメージが用意されています。Oracle Enterprise Linuxテンプレートの作成時、Oracle Virtual Assembly BuilderではOracle VMのmodifyjeosツールを透過的に起動して仮想マシン・テンプレートを作成します。このツールを使用すると、ベース・イメージを変更またはカスタマイズできます(たとえば、ディスク領域をベース・イメージに追加したり、特定のRPMを指定できます)。カスタム・システム・ベース・イメージの作成方法の詳細は、『Oracle Virtual Assembly Builderインストレーション・ガイド』のシステム・ベース・イメージに関する項を参照してください。

5.3.3.1 テンプレートの格納

テンプレートは、Oracle Virtual Assembly Builderインスタンスのカタログ・ディレクトリに格納されます。テンプレート作成は、Oracle VMのmodifyjeosがインストールされているOracle Virtual Assembly Builderホストで実行する必要があります。

注意:

ベース・イメージは、$AB_INSTANCEまたは$ORACLE_HOMEに格納されます。ベース・イメージ検出の優先順位は、次のとおりです。

- -baseImageフラグによって指定される場所

- $AB_INSTANCE/templates/baseImage/OVM/OEL

- $ORACLE_HOME/templates/baseImage/OVM/OEL

5.3.3.2 ターゲット・プラットフォームの選択

Oracle VMまたはOracle Exalogicのいずれかのターゲット・プラットフォームを選択できます。Oracle Exalogicを選択した場合、Oracle Exalogicプラットフォームと互換性のある(適切なRPMがインストールされている)ベース・イメージを選択する必要があります。また、ウィザードを使用してOracle Exalogicのベース・イメージを検証することもできます。

5.3.3.3 Oracle Virtual Assembly Builder Studioを使用したテンプレートの作成

この操作により、アセンブリ・ノード・コンテキスト・メニューから「テンプレートの作成」を選択するか、「カタログ」 > 「テンプレートの作成」を選択して、アセンブリのテンプレートを作成できます。

「イメージの場所の指定」ウィンドウ(図4-x)では、次のようにしてターゲット・プラットフォームを選択し、ベース・イメージを構成します。

- Oracle VMまたはOracle Exalogicのいずれかのターゲット・プラットフォームを選択します。「Exalogic」を選択した場合、Oracle Exalogicプラットフォームと互換性のある(適切なRPMがインストールされている)ベース・イメージを選択する必要があります。この値は、個々のアプライアンス・テンプレートとアセンブリ・アーカイブの両方に対する意味があります。アプライアンスにはOracle ExalogicとOracle VMの両方のテンプレートが同時に存在する場合があります。しかし、アセンブリ・アーカイブはどのような場合でも1つのみ存在できます。

- 参照アイコンを選択し、ベース・イメージまでナビゲートし選択して、ベース・イメージの場所を指定します。ベース・イメージをデフォルトの場所のいずれかに配置しておく場合は、このフィールドをそのままにしておくことができます。

- OSのルート・パスワードとVNCパスワードを入力します。

Oracle Exalogicターゲット・プラットフォームを選択した場合は、「ExaLogicイメージの検証」をクリックして、Oracle Exalogicプラットフォーム用に適切なRPMがベース・イメージにインストールされているかどうかを確認します。

図5-10 「テンプレートの作成」ウィザード: イメージの場所の指定

「次へ」をクリックして続行します。

注意:

テンプレートの作成ウィザードでのファイル・セットの取得の詳細は、5.3.2項「アプライアンスまたはアセンブリのファイル・セットの取得」を参照してください。

「サマリー」ウィンドウには、「終了」をクリックした後に作成されるすべてのテンプレートがリストされます。テンプレートの作成にしばらく時間がかかる可能性があることを示す警告も表示されます。

5.3.3.3.1 テンプレートの再作成

アセンブリ・アプライアンスにテンプレートがすでに作成されている場合は、テンプレートを再作成できます。「コンポーネント・テンプレート再作成の確認」ウィンドウでは、すでに作成されている関連テンプレートがあるアプライアンスを確認します。「再作成」ボックスに選択すると、再作成の必要があるものを選択できます。

図5-11 アプライアンス・テンプレートの再作成

「次へ」をクリックします。

コンポーネント・ファイル・セット定義の確認ウィンドウでは、既存のファイル・セットを使用するか(使用可能な場合)、ファイルがあるホストを指定するかを選択します。

図5-12 アプライアンス・ファイル・セット定義の確認

「次へ」をクリックしてから、「終了」をクリックしてテンプレートを再作成します。

進捗メッセージは、メッセージ・ログ・ウィンドウにポストされます。「テンプレートの作成」タブを選択して「アセンブリ・ステータスの概要」を開いて確認すると、進捗が発生していることを確認できます。

5.3.3.4 Oracle Virtual Assembly Builder Studioを使用したアセンブリ・アーカイブの作成

非原子性アセンブリのコンテキストで、テンプレートの作成ウィザードを起動すると、指定したアセンブリのアセンブリ・アーカイブを作成できます。さらに、アセンブリ・アーカイブの圧縮を選択できます。

アセンブリ・アーカイブが正常に完了すると、アセンブリはロックされます。この時点でアセンブリは変更不能になり、変更する場合はアセンブリ・アーカイブを明示的に削除する必要があります。

構造ペインでアセンブリ・アーカイブを選択して、[Delete]キーを押すか右クリックして「削除」を選択すると、アセンブリ・アーカイブを明示的に削除できます。

5.3.3.5 abctlを使用したテンプレートの作成

例5-6から例5-7は、createTemplateコマンドの例です。

例5-6 Oracle WLSのOracle VMゲストOSテンプレートの作成

$ ./abctl createTemplate -name myWLS -platform OVM

例5-7 OHSのOracle VMゲストOSテンプレートの作成

$ ./abctl createTemplate -name myOhs -platform OVM -baseImage /private/baseImage/OVM/OEL/System.img

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.3.3.6 abctlを使用したアセンブリ・アーカイブの作成

abctlを使用して、指定された最上位レベル・アセンブリのアセンブリ・アーカイブを作成できます。このコマンドは、最上位アセンブリに対してのみ呼び出すことができます。また、アセンブリ内のすべてのサブアプライアンスは、createTemplateコマンドを使用してすでにテンプレート化されている必要があります。

-platformオプションを使用して、プラットフォームをOracle VMまたはOracle Exalogicと指定します。

例5-8は、createAssemblyArchiveコマンドの例です。

例5-8 アセンブリ・アーカイブの作成

$ ./abctl createAssemblyArchive -name myWlsAssembly -platform OVM -nocompress

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.3.4 Oracle Virtual Assembly Builder Studioを使用したアセンブリの編集

この項では、Oracle Virtual Assembly Builder Studioを使用したアセンブリの編集方法について説明します。

アセンブリの作成後に、デプロイして接続を作成したり、オプションで他の変更を加えたりできるようにするには、アセンブリの編集が必要な場合があります。

5.3.4.1 接続の作成

接続構成の管理には、出力への入力の接続、入力および出力のプロパティ値(JDBC接続文字列など)の設定または変更、アセンブリのデプロイメントの一環としてデプロイされないコンポーネントに接続する出力の外部リソース・アプライアンスの作成があります。

一般に接続の定義は、出力を入力に接続し、必要に応じて入力および出力のプロパティを設定または変更することを意味します。"入力への出力の接続"ステップは、アプライアンスの出力を別のアプライアンスの入力に接続するか、アプライアンスの出力を外部リソース・アプライアンスの入力に接続することで達成できます。

値を必要とするすべての入力または出力プロパティには値を設定する必要があります。また、デプロイ時に設置する環境に応じて、他のすべてのプロパティを設定または変更することが必要な場合があります。

例:

- Webサーバー・ポート転送の構成: myohsで出力を選択し、mywlsアセンブリの管理対象サーバー入力との間に矢印を描いて、この2つのを接続します。

- 各JDBC接続のJDBC接続文字列の指定: Oracle WebLogic ServerアセンブリのJDBC出力を選択して開きます。
JDBC接続の場合、外部リソースを作成するか、データベースをイントロスペクトした後、Oracle WebLogic ServerのJDBC出力と外部リソースまたはイントロスペクトされたデータベース・アプライアンスの間に接続を作成します。

JDBC接続ごとに異なる記述をします。その記述を使用して、それぞれがどのJDBCデータベース・スキーマに接続するかを把握します。JDBCエントリごとに、original-urlを調べ、hostnameおよびglobal-db-nameをmydbにコピーします。

たとえば、jdbc:oracle:thin:@machine999.example.com:1521/orclでは、hostnameはmachine999.example.com、portは1521、global-db-nameはorclです。

また、global-db-nameおよびportを外部データベース・リソース入力のプロパティとして、hostをデータベース・アプライアンス自体のプロパティとして指定します。

portは、外部データベース・リソース入力のプロパティです。hostnameは、外部データベース・リソース自体に属する唯一のプロパティです。

注意:

アプライアンス固有の接続情報の詳細は、付録B「Oracle Virtual Assembly Builderのイントロスペクション・プラグイン」を参照してください。

5.3.4.2 プロパティ・インスペクタ

参照システムからの値が適切な場合、プロパティを変更する必要がないこともあります。必要な場合は、プロパティ・インスペクタを使用して変更します。

プロパティ・インスペクタ(図5-13)には、プロパティ値が表示されます。必要に応じて、プロパティを設定します。

図5-13 プロパティ・インスペクタ

5.3.4.3 構造ペイン

カタログ・ノードを選択すると必ず、構造ペインにデータが移入されます。アセンブリを選択すると、構造ペインには、すべてのアプライアンスの他にそのアプライアンスの入力、出力およびネットワーク・インタフェースを含め、そのアセンブリの構造が表示されます。構造ペインでアイテムを選択すると、その特定の選択にスコープ指定されたプロパティがプロパティ・インスペクタに移入されます。

図5-14 構造ペイン

5.3.4.4 Oracle HTTP Server/Oracle Web CacheおよびOracle WebLogic Serverが含まれるアセンブリの編集

Oracle HTTP Server/Oracle Web Cachのデプロイメントの一環として、Oracle HTTP Server/Oracle Web CacheおよびOracle WebLogic Serverが含まれるアセンブリをEnterprise Managerとともにデプロイした場合、Oracle WebLogic ServerでホストされるEnterprise Managerアプリケーションにそのアプライアンスを登録するために"opmnctl registerInstance"がコールされます。この操作を有効にして正常に完了するには、アセンブリの編集時に次の手順を実行する必要があります。

1. Oracle HTTP Server/Oracle Web CacheのEMRegistrationとOracle WebLogic Serverの間に接続を定義します。

2. プロパティ・インスペクタを使用して、Oracle HTTP Server/Oracle Web Cacheの依存関係をOracle WebLogic Serverに設定します。この操作を実行するには、「一般」セクションで「依存」ドロップダウン・メニューを選択します。
この構成を行わないと、管理サーバーが起動していないためEnterprise Manager登録は失敗します。

3. Oracle WebLogic Server管理サーバーがSSL接続のみ受け入れるように構成されていないことを確認します。"opmnctl registerInstance"では、Oracle WebLogic ServerへのSSL接続はサポートされていません。

5.3.4.5 Oracle HTTP ServerとOracle WebLogic Server間のアプリケーション・ルーティング

Oracle HTTP Server構成ファイルmod_wl_ohs.confでOracle HTTP ServerとOracle WebLogic Server間のアプリケーション・ルーティングを定義する場合、エディタでOracle HTTP ServerをOracle WebLogic Serverに接続する必要があります。

5.3.4.6 アセンブリ内でのVnetの作成

アセンブリが作成されると、そのアセンブリに対してデフォルトVnetが作成されます。デフォルトVnetの名前および説明は、アセンブリの作成時に変更できます。アセンブリが作成されると、デフォルトで作成されたものとは異なるVnetを追加作成することもできます。

新しいVnetを作成するには、アセンブリを右クリックして「新規」 > 「Vnet」を選択するか、アセンブリを選択して構造ペインで「Vnet」フォルダを右クリックし、コンテキスト・メニューから「新規Vnet」を選択します(図5-15)。新しいVnetの名前および説明を入力します。

図5-15 Vnetの作成

5.3.4.7 アプライアンス内でのネットワーク・インタフェースの作成

アセンブリの編集中、物理または仮想ネットワーク・インタフェースを作成できます。物理インタフェースは、vServerのOSスタックの観点からは物理的ですが、OSがvServerで実行されているため、物理インタフェースは実際には仮想ネットワーク・インタフェースです。したがって、これは別の仮想ネットワーク・インタフェースの上部にある仮想ネットワーク・インタフェースを意味します。インタフェースを作成する手順は、次のとおりです。

- アセンブリ・エディタでアプライアンスを右クリックして「ネットワーク・インタフェースの追加」を選択するか、アセンブリ・ナビゲータでアセンブリを選択してアプライアンスまたはアプライアンス下の「ネットワーク・インタフェース」フォルダを右クリックし、「ネットワーク・インタフェースの追加」を選択して、物理ネットワーク・インタフェースを作成します。

- 物理ネットワーク・インタフェースを右クリックし、「ネットワーク・インタフェースの追加」を選択して、仮想ネットワーク・インタフェースを作成します。新しいインタフェースの名前および説明を要求されます。プロパティ・インスペクタを使用して他のプロパティを設定します。結果は、物理ネットワーク・インタフェースの子として構造ペインに表示されます。仮想ネットワーク・インタフェースは、VLANの概念をモデル化するために存在します。

5.3.4.8 ネットワーク・インタフェースへのアプライアンス入力のバインド

アプライアンスの入力を構成するときには、その入力がデータを受信(またはリスニング)するネットワーク・インタフェースとポートを指定する必要があります。特定のネットワーク・インタフェースを選択して、入力がそのネットワーク・インタフェースから受信する入力のみをリスニングするようにするか、INADDR_ANYを選択して、入力がそのアプライアンスに対して構成された任意のネットワーク・インタフェースから受信する入力をリスニングするようにすることができます。INADDR_ANYがデフォルトです。

デフォルト・インタフェースをアプライアンスに設定するには、構造ペインでインタフェースを右クリックし、コンテキスト・メニューから「デフォルトに設定」を選択します。デフォルトは、仮想インタフェースまたは物理インタフェースのいずれかです。仮想インタフェースは、アセンブリ・エディタに表示されないことに注意してください。構造ペインでのみ選択できます。

5.3.4.9 Vnetへのネットワーク・インタフェースのバインド

アセンブリおよびアプライアンスには、Vnetおよびネットワーク・インタフェースがあります。各ネットワーク・インタフェースがバインドできるVnetは1つのみです。デプロイメント・プランは、Vnetおよびネットワーク・インタフェースを、デプロイメント環境に存在する物理ネットワークおよびIPアドレスと関連付けるために使用します。

バインディングは、プロパティ・インスペクタを使用して別のVnet (別のものが存在する場合)に変更できます。各論理ネットワークは、デプロイ時にデプロイメント・プランを使用して解決する必要があります(つまり、各ネットワークはデプロイメント・プランにプロパティを保持します)。

5.3.4.10 アプライアンス出力からの外部リソースの作成

外部リソースを作成するには、アセンブリ・エディタで接続されていないアプライアンス出力を右クリックし、「外部リソース」を選択します。

5.3.5 abctlを使用したアセンブリの編集

この項では、abctlを使用して実行できるアセンブリ編集操作について説明します。

空の最上位アセンブリの作成

createAssemblyコマンドを使用して、空の最上位アセンブリを作成します。例5-9に、createAssemblyコマンドを示します。

例5-9 createAssemblyコマンド

$ ./abctl help –command createAssembly
$ ./abctl createAssembly -name myAssembly -defaultNetwork intranet

最上位アセンブリへのアプライアンス(またはWLSアセンブリ)の追加

addToAssemblyコマンドを使用して、アプライアンスを最上位アセンブリに追加します。例5-10に、addToAssemblyコマンドを示します。

例5-10 addToAssemblyコマンド

$ ./abctl help –command addToAssembly
$ ./abctl addToAssembly -name myAppliance -into myAssembly

入力への出力の接続

connectEndpointsコマンドを使用して、出力と入力の間に新しい接続を作成します。出力および入力のプロトコルは一致する必要があります。また、出力および入力の所有者は同じアセンブリに属する必要があります。例5-11に、connectEndpointsコマンドを示します。

例5-11 connectEndpointsコマンド

$ ./abctl help –command connectEndpoints
$ ./abctl connectEndpoints -from mySite/myOhs -fromOutput output1 -to mySite/myWls -toInput default

5.4 デプロイメントに関連する操作

この項では、Oracle Virtual Assembly Builder Studioまたはabctlコマンドライン・ユーティリティを使用してデプロイメントに関連する操作を実行する方法について説明します。

- 第5.4.1項「ターゲットの構成」

- 第5.4.2項「デプロイメント・プランの作成」

- 5.4.4項「ターゲットへのアセンブリ・アーカイブの登録」

- 5.4.5項「アセンブリ・インスタンスのデプロイ」

- 5.4.6項「アセンブリ・インスタンスの停止」

- 5.4.7項「アセンブリ・インスタンスの開始」

- 5.4.9項「アプライアンスのスケーリング」

- 5.4.10項「アセンブリ・インスタンスのアンデプロイ」

- 5.4.11項「ターゲットからのアセンブリ・アーカイブの登録解除」

- 5.4.12項「デプロイヤ・リポジトリへのアセンブリ・アーカイブのアップロード」

- 5.4.13項「デプロイヤ・リポジトリからのアセンブリ・アーカイブの削除」

- 第5.4.14項「エクスポート操作」

- 5.4.15項「EMソフトウェア・ライブラリとのやり取り」

5.4.1 ターゲットの構成

この項では、Oracle VMまたはOracle Exalogicのバックエンド・エンドポイントへの接続を定義し、必要に応じて資格証明を指定して、デプロイメント・ターゲットをバックエンドに追加する方法について説明します。

5.4.1.1 接続URL

HTTPプロトコルのかわりにTCPを使用してOracle VM 3のターゲット接続を構成することをお薦めします。

TCPを使用して構成するには、"tcp://their-ovm-host:54321"形式のURLを指定します。

5.4.1.2 接続の資格証明

接続の資格証明を構成する手順は、次のとおりです。

1. Oracle VMの場合、abctlのcreateTargetコマンドを使用してターゲットを作成します。
この操作は、Cloud Adminによってのみ実行できますが、接続情報と、バックエンド・タイプに応じてバックエンドのユーザー資格証明を定義します。Oracle VMの場合、ここで資格証明を指定します。

Oracle Exalogicの場合、1つのターゲットが事前構成されるため、createTargetコマンドを実行しません。個々のユーザーがaddTargetUserステップで各自の資格証明を指定します。

2. addTargetUser abctlコマンドを使用して、ユーザーをターゲットに追加します。
バックエンド・システムのセキュリティ・モデルにおける相違により、バックエンド・タイプに応じて、これはCloud AdminコールまたはApplication Adminコールになります。

- Oracle VMターゲットの場合、この操作はCloud Adminによってのみ実行でき、プールにアクセスできるユーザーの制御に使用されます。Cloud Adminによって指定される資格証明は一般ユーザーから保護する必要があるため、これはCloud Admin操作です。

- Oracle Exalogicターゲットの場合、これはApplication Admin操作で、Application Admin資格証明の指定に使用されます(この場合、バックエンドで資格証明をチェックするため、Cloud Adminは特定のアクセス権を付与する必要がありません)。ユーザーの資格証明はCloud Adminを含め他のユーザーから保護する必要があるため、これはApplication Admin操作です。

5.4.1.3 例

例5-12に、Oracle VMのターゲットを作成する方法を示します。

例5-12 Oracle VMのターゲットの作成

./abctl createTarget -name slcTarget_tcp -type ovm -properties ovm.poolName=ab_ovm_30_stand_alone_pool ovm.vmOperationTimeout=3600 ovm.vmmversion=3.0 ovm.user=admin ovm.pwd ovm.url=tcp://example.oracle.com:54321 -connectionName localDeployer

例5-13に、Oracle VMのターゲットにユーザーを追加する方法を示します。

例5-13 Oracle VMのターゲットへのユーザーの追加

./abctl addTargetUser -user Username -target Targetname

例5-14に、Oracle Exalogicのターゲットにユーザーを追加する方法を示します。-propertiesオプションには、ユーザーの資格証明をプロパティ=値のペアとして指定します。

例5-14 Oracle Exalogicのターゲットへのユーザーの追加

./abctl addTargetUser -user Username -target Targetname -properties String...

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

デプロイメント・プランにより、アセンブリのメタデータに定義されたプロパティ値をオーバーライドできるようになります。アセンブリのデプロイ時に、プランが適用されます。最上位アセンブリのみデプロイメント・プランを保持できます。

5.4.2.1 Oracle Virtual Assembly Builder Studioを使用したデプロイメント・プランの作成

デプロイメント・プランを作成する手順は、次のとおりです。

1. 「デプロイメント・プラン」ナビゲータで、アセンブリを右クリックし、「新規デプロイメント・プラン」を選択します。
「デプロイメント・プランの作成」ウィザードが表示されます(図5-16)。

図5-16 デプロイメント・プランの作成

2. デプロイメント・プランの名前を入力します。

3. 「アセンブリ」ドロップダウン・メニューから関連付けられたアセンブリを選択します。

4. 「OK」をクリックします。デプロイメント・プラン・エディタが開きます。

5.4.3 デプロイメント・プランの編集

デプロイメント・プラン・エディタには、アセンブリの読取り専用ビューが表示されます。このビューは、概要として役立ちます。また、プロパティ値をオーバーライドできるようにアイテムを選択するのに便利です。

5.4.3.1 新しいデプロイメント・プランの編集

新しいデプロイメント・プランを作成すると、デプロイメント・プラン・エディタが自動的に開きます。

5.4.3.2 既存のデプロイメント・プランの編集

既存のデプロイメント・プランを編集する手順は、次のとおりです。

1. 「デプロイメント・プラン」ナビゲータで、プランを右クリックし、「開く」を選択します。
あるいは、「デプロイメント・プラン」ナビゲータでプランのアイコンを右クリックします。

5.4.3.3 必須ビュー

デプロイメント・プランの編集では、構造ペインとプロパティ・インスペクタの両方を使用します。どちらのビューも表示されていることを確認してください。

1. 構造ペインを開くには、「ビュー」 > 「構造」を選択します。

2. プロパティ・インスペクタを開くには、「表示」 > 「プロパティ・インスペクタ」を選択します。

5.4.3.4 デプロイメント・プラン・エディタでのアイテムの選択

アプライアンス、入力、出力または他のアイテムのプロパティをオーバーライドするには、まず該当するアイテムを選択します。

デプロイメント・プラン・エディタでアイテムを選択するには、そのアイテムをクリックします。

5.4.3.5 構造ペインでのアイテムの選択

データが移入されると、構造ペインにはプランの他の詳細が表示されます。

構造ペインにデータを移入する手順は、次のとおりです。

1. 「デプロイメント・プラン」ナビゲータで、該当するプランを選択します。
構造ペインにアセンブリ構造が移入されます。移入された構造ペインでアイテムを選択するには、そのアイテムをクリックします。

デプロイメント・プラン・エディタでアイテムを選択しても、構造ペインに移入されます。

5.4.3.6 プロパティ値のオーバーライド

選択したアイテムのプロパティは、プロパティ・インスペクタに表示されます。

値をオーバーライドする手順は、次のとおりです。

1. プロパティ・インスペクタで、フィールドに新しい値を入力します。
青の箇条書きがオーバーライドされた値の横に表示されます。

5.4.3.7 オーバーライド値の削除

オーバーライドを削除する手順は、次のとおりです。

1. プロパティ・インスペクタで、プロパティ値の右側にある下向き矢印(山形)をクリックします。

2. ポップアップ・メニューから、リセットを選択します。
リセット・メニュー項目に表示される値は常に、アセンブリ・メタデータに指定された元の値です。オーバーライドが削除されます。

5.4.3.8 統合プロパティ

アプライアンスのスケーラビリティ・プロパティをオーバーライドできます。オーバーライドすると、アセンブリのデプロイ時に存在する可能性があるアプライアンス・インスタンスの数が変わることがあります。このような潜在的アプライアンス・インスタンスにはそれぞれ、ホスト名、IPアドレス、MACアドレスおよびネットマスク・プロパティを含め、独自のネットワーク設定が必要です。プロパティ・インスペクタには、適切な数のインスタンス固有のネットワーク・プロパティが表示されます。スケーラビリティ値を変更すると、プロパティ・インスペクタでは、ネットワーク・プロパティの数が潜在的アプライアンス・インスタンスの数と一致するように自動的に調整されます。

5.4.3.8.1 アプライアンス・プロパティ

アプライアンスのネットワーク・プロパティを表示する手順は、次のとおりです。

1. 構造ペインまたはデプロイメント・プラン・エディタで、アプライアンスをクリックして選択します。

2. プロパティ・インスペクタで、「ネットワーク」カテゴリをクリックして開きます。

default-gateway、dns-domainsおよびdns-serversの各プロパティ値は、アプライアンスのすべてのネットワーク・インタフェースがDHCPを使用するように構成されていないかぎり、必須です。これらの値は、アプライアンスのすべてのインスタンスで共有されます。

hostname.0プロパティは必須です。アプライアンスがスケーラブルである場合、プロパティ・インスペクタには適切な数のプロパティ(hostname.0、hostname.1など)が表示されます。値はすべて必須です。

5.4.3.8.2 ネットワーク・インタフェース・プロパティ

ネットワーク・インタフェースのデプロイメント・プラン・プロパティを表示するには、デプロイメント・プラン・エディタでネットワーク・インタフェースをクリックするか、構造ペインで「ネットワーク・インタフェース」フォルダを展開してフォルダ内のネットワーク・インタフェースをクリックします。

インタフェースのusedhcpプロパティをtrueに設定すると、これらのネットワーク・プロパティがデプロイメント・ターゲット環境で自動的に構成されるようにアサートします。usedhcpがtrueのとき、プロパティ・インスペクタには他のネットワーク・インタフェース・プロパティのすでに設定された値が表示されますが、これらのプロパティの値は変更できません。

usedhcpがfalseの場合、ip_address.0、mac_address.0およびnetmaskの各プロパティは必須です。アプライアンスがスケーラブルである場合、プロパティ・インスペクタには適切な数のアドレス・プロパティ(ip_address.0、ip_address.1、...、mac_address.0、mac_address.1、...)が表示されます。値はすべて必須です。

5.4.3.8.3 Vnetプロパティ

Vnetは、デプロイメント・プラン・エディタには表示されないため、エディタで選択することはできません。Vnetのデプロイメント・プラン・プロパティを表示するには、構造ペインで「Vnet」フォルダを展開し、Vnetを選択します。

is_privateプロパティは、デプロイされたアセンブリ内部で使用するためにネットワークが高パフォーマンス・ネットワークとして自動的に構成されることを指定します。デプロイメント・ターゲット環境が高パフォーマンスのプライベート・ネットワークに必要なプラットフォームをサポートをしない場合、この値はfalseにする必要があります。Oracle Virtual Machineバージョン3.0に直接デプロイする場合は、この値をfalseに設定します。

network_nameプロパティは、デプロイメント・ターゲット環境で定義されるネットワークの名前を指定します。このプロパティは必須です。

デプロイメント・ターゲット環境によっては、ネットワーク名が一意であることが必要でない場合があります。ネットワーク名が一意でない場合、オプションのnetwork_idプロパティを使用して、デプロイメント・ターゲット環境で定義されるネットワークを一意に指定できます。is_privateプロパティがtrueの場合、このプロパティの値は無視されます。

5.4.3.9 デプロイメント・プランの検証

デプロイメント・プランを検証する手順は、次のとおりです。

1. 「デプロイメント・プラン」ナビゲータで、プランを右クリックし、「検証」を選択します。
検証の結果は、ダイアログ・ボックスに表示されます。

5.4.3.10 デプロイメント・プランの保存

デプロイメント・プランが変更されていると、「デプロイメント・プラン」ナビゲータとデプロイメント・プラン・エディタのタブの両方に名前がイタリック・フォントで表示されます。

デプロイメント・プランを保存する手順は、次のとおりです。

1. 「ファイル」 > 「保存」を選択します。

「ファイル」 > 「保存」メニュー項目が有効になっていない場合、デプロイメント・プランが選択されていない可能性があります。「デプロイメント・プラン」ナビゲータでプランを選択し、「ファイル」 > 「保存」を選択します。

1つのアセンブリに対して複数のデプロイメント・プランを作成、編集および保存できます。デプロイ時に、デプロイメントに対してプランを1つ選択します。このように、1つのアセンブリが複数のデプロイメントの基準として機能でき、各デプロイメントは固有のネットワークと他のプロパティ設定を保持します。

5.4.4 ターゲットへのアセンブリ・アーカイブの登録

Oracle Virtual Assembly Builder Deployerにアセンブリ・アーカイブをアップロードすると、アセンブリ・アーカイブを特定のターゲットに登録できます。

5.4.4.1 Oracle Virtual Assembly Builderを使用した登録

登録は、次の2つのいずれかの方法で実行します。

- 「デプロイメント」ナビゲータの「使用可能なアセンブリ」で、特定のアセンブリ・アーカイブ・バージョンを右クリックし、「登録」を選択します。

- 特定のアセンブリ・アーカイブ・バージョンを目的のターゲットにドラッグ・アンド・ドロップします。「デプロイメント」ナビゲータの「使用可能なアセンブリ」でアセンブリ・アーカイブを選択し、「デプロイメント・ターゲット」のターゲットにドロップします。

どちらの方法でも登録が開始します。ターゲット・ノードがアセンブリ・アーカイブ・バージョンを表す新しい子で更新されます。ターゲット・ノードには読込み中のアイコンが表示され、登録が完了すると、標準のアセンブリ・アーカイブのアイコンに切り替わります。メッセージ・フィードバックが登録の進捗としてメッセージ・ログ・ウィンドウに表示されます。登録が失敗すると、ノードは非表示になり、失敗を説明するポップアップ・メニューが表示されます。

登録解除するには、登録されたノードを右クリックし、「登録解除」を選択します。ノードは、登録解除が完了すると削除されます。進捗メッセージはメッセージ・ログに出力されます。失敗時には、ダイアログが表示されます。

5.4.4.2 abctlを使用した登録

registerAssemblyArchiveコマンドを使用して、アセンブリのテンプレートを登録解除します。例5-15に、unregisterAssemblyArchiveコマンドを示します。

例5-15 unregisterAssemblyArchiveコマンド

$ ./abctl help –command registerAssemblyArchive
$ ./abctl registerAssemblyArchive -connectionName MyDeployerConnection -name TheAssembly -version 1

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.5 アセンブリ・インスタンスのデプロイ

この項では、Oracle Virtual Assembly Builder Studioまたはabctlを使用してアセンブリ・インスタンスをデプロイする方法について説明します。

アセンブリ・インスタンスをデプロイすると、アセンブリのアプライアンス・インスタンスが作成および開始されます。さらに、アプライアンス・インスタンス内のアプリケーションも起動します。アセンブリ・インスタンスのデプロイメントは、長時間実行される操作になる可能性があります。数分かかる場合があります。アセンブリ・インスタンスをデプロイするのにかかる時間は、作成および起動する必要があるVMの数によって変わります。

5.4.5.1 アプライアンスの"ターゲット"件数をゼロに設定する機能(ゼロカウント・アプライアンス)

初めにアプライアンス・インスタンスがゼロのアセンブリをデプロイできます。しかし、後続のスケーリング操作では、アセンブリ構成の一部であるのに初めにインスタンス数がゼロで"デプロイされた"アプライアンスに、アプライアンス・インスタンスを追加できます。

5.4.5.2 Virtual Assembly Builder Studioを使用したデプロイメント

アセンブリ・アーカイブが特定のターゲットに登録されると、そのアセンブリ・アーカイブを1回以上デプロイできます。

1. 「デプロイメント」ナビゲータを開くには、「表示」 > 「デプロイメント」を選択します。
「デプロイメント」ナビゲータの「デプロイメント・ターゲット」ペインで、ターゲットを展開し、デプロイできるアセンブリ・アーカイブのリストを表示できます。

2. アセンブリ・アーカイブを右クリックし、「デプロイ」を選択します。
アセンブリ・インスタンスは、「デプロイメント・プラン」ナビゲータからデプロイメント・プランをドラッグして、登録されたアセンブリ・アーカイブの上にドロップしても起動できます。

3. アセンブリ・アーカイブのデプロイ・ウィンドウで次の情報を入力します。

- デプロイメント・プラン: デプロイメント・プランを選択します。ダイアログでは、ドロップダウン・リストに、デプロイするアセンブリの名前と一致するデプロイメント・プランを移入します。プランが存在しない場合は、デプロイする前にプランを作成する必要があります。

- Vnetマッピング: デプロイメント・プランのVnetマッピングを確認(場合によっては修正)します。デプロイメント・プランの作成時点ではアセンブリのデプロイ先を認識できないため、Oracle Virtual Assembly BuilderはターゲットVnetの名前を検証できません。
アセンブリに定義されたVnetごとに1行が表示されます。Vnetの論理名(アセンブリに定義されているとおり)がラベルとして表示され、対応するドロップダウンにはデプロイメント・ターゲットによって定義されているVnetが表示されます。デプロイメント・プランからの値をユーザーに示す目的で、デプロイメント・プランからの値は、たとえそのプランが無効な場合でもドロップダウン・リストに表示されます。デプロイメント・プランからの値(マッピング)は、アスタリスク(*)接尾辞付きです。

現在のマッピングが無効の場合、値に赤のエラー枠線が表示され、「デプロイ」ボタンが無効になります。デプロイメント・プランに無効なマッピングが含まれている場合、アセンブリはデプロイできません。Vnetマッピングに加えられた変更は、アセンブリ・インスタンスの開始前にデプロイメント・プランに保存されます。

4. 「デプロイ」をクリックして、デプロイメント・プランを新しいマッピングで更新し、アセンブリ・インスタンスを開始します。
デプロイメント・オプションを確認すると、アセンブリ・インスタンスが開始します。新しい子ノードが登録済ノード下に作成され、進捗を示します。新しい子ノードの名前はデプロイメントIDです。アセンブリ・インスタンスが最終状態になるまで読込み中のアイコンが表示されます。

ネットワークが初期化されると、アプライアンスを展開して、そのアプライアンス用に起動された各仮想マシンのIPアドレスを表示できます。

緑のアイコンは成功を示します。アセンブリ・インスタンスの開始が失敗した場合は、赤のアイコンが失敗を示します。進捗メッセージは、メッセージ・ログ・ウィンドウに表示されます。

5.4.5.3 abctlを使用したデプロイメント

例5-16に示すようにcreateAssemblyInstanceコマンドを使用して、アセンブリ・インスタンスを作成します。createAssemblyInstanceコマンドは、deployAssemblyInstanceコマンドに必要なassemblyInstanceIdを返します。

例5-16 createAssemblyInstanceコマンド

$ ./abctl help –command createAssemblyInstance
$ ./abctl createAssemblyInstance -deploymentPlan c:/zeroAppliancesSite_plan.xml -name SMALLOVA -version 1 -c cloudAdmin
Plan upload File Size: 700
Assembly Instance Id: gdc4_29x5_SMALLOVA_1
Assembly instance has been created.

アセンブリ・インスタンスを作成すると、例5-17に示すようにdeployAssemblyInstanceコマンドを使用してアセンブリ・インスタンスをデプロイできます。

例5-17 deployAssemblyInstanceコマンド(完了を待機しない場合)

$ ./abctl help –command deployAssemblyInstance
$ ./abctl deployAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdminRequest ID: 1d1599a0-434b-426a-ab29-7c6230b5fa33Request to deploy assembly instance has been submitted to deployer.

deployAssemblyInstanceコマンドは、非同期操作です。このコマンドは、デプロイ・リクエストを開始して、リクエストIDを返します。リクエストのステータスは、describeRequests操作を使用して問い合せることができます。操作が完了するまで待機する場合、-waitForComplete -pollTime 30のように追加パラメータを指定して、待機することもできます。

例5-18 deployAssemblyInstanceコマンド(完了を待機する場合)

$ ./abctl help –command deployAssemblyInstance
$ ./abctl deployAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdmin -waitForComplete -pollTime 30Request ID: 1d1599a0-434b-426a-ab29-7c6230b5fa33Request to deploy assembly instance has been submitted to deployer.

例5-19に示すようにdescribeAssemblyInstancesコマンドを使用して、現在のデプロイメントをリストできます。

例5-19 describeAssemblyInstancesコマンド

$ ./abctl help –command describeAssemblyInstances
$ ./abctl describeAssemblyInstances -c cloudAdmin---------------------------------------------------------------------------------- Name     | Version | State      | Assembly Instance Id | Target  | Appliances---------------------------------------------------------------------------------- SMALLOVA | 3       | Undeployed | c1Lm-GyML_SMALLOVA_3 | LOCBOX1 | c1Lm-GyML_SMALLOVA_3:zeroAppliancesSite/myWls/Server_3Assembly Instances have been described.$

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.6 アセンブリ・インスタンスの停止

この項では、Oracle Virtual Assembly Builder Studioまたはabctlを使用してアセンブリ・インスタンスを停止する方法について説明します。

アセンブリ・インスタンスを停止すると、VMとVM内で実行されているアプリケーションが停止します。停止状態のVMは、コンテキストを保持します。停止したVMは、VMを作成する必要がないため、元のデプロイメントよりもずっと短時間で再起動できます。

5.4.6.1 Oracle Virtual Assembly Builder Studioによるアセンブリ・インスタンスの停止

「デプロイメント」ナビゲータの「デプロイメント・ターゲット」ペインで、アセンブリ・インスタンスを開始、停止、デプロイまたはアンデプロイできます。アセンブリ・インスタンスを停止するには、停止する必要があるアセンブリ・インスタンスを選択し、「停止」をクリックします。

5.4.6.2 abctlによるアセンブリ・インスタンスの停止

stopAssemblyInstanceコマンドを使用して、アセンブリ・インスタンスを停止します。アセンブリ・インスタンスは、assemblyInstanceIdによって参照されます。describeAssemblyInstancesコマンドを使用して、アセンブリ・インスタンスのリストを取得できます。例5-20および例5-21に、stopAssemblyInstanceコマンドを示します。

例5-20 stopAssemblyInstanceコマンド(完了を待機しない場合)

$ ./abctl help –command stopAssemblyInstance
$ ./abctl stopAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdminRequest ID: 8486522b-8a5e-4348-bdf1-a7d55fccf848Request for stop has been submitted to deployer.

例5-21 stopAssemblyInstanceコマンド(完了を待機する場合)

$ ./abctl help –command stopAssemblyInstance
$ ./abctl stopAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdmin -waitForComplete -pollTime 30Request ID: 8486522b-8a5e-4348-bdf1-a7d55fccf848Request for stop has been submitted to deployer.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.7 アセンブリ・インスタンスの開始

この項では、Oracle Virtual Assembly Builder Studioまたはabctlを使用してアセンブリ・インスタンスを開始する方法について説明します。

5.4.7.1 Oracle Virtual Assembly Builder Studioによるアセンブリ・インスタンスの開始

「デプロイメント」ナビゲータの「デプロイメント・ターゲット」ペインで、アセンブリ・インスタンスを開始、停止、デプロイまたはアンデプロイできます。アセンブリ・インスタンスを開始するには、アセンブリ・インスタンスを選択し、「開始」をクリックします。

5.4.7.2 abctlによるアセンブリ・インスタンスの開始

startAssemblyInstanceコマンドを使用してデプロイメントを開始します。アセンブリ・インスタンスは、assemblyInstanceIdによって参照されます。describeAssemblyInstancesコマンドを使用して、デプロイメントのリストを取得できます。例5-22および例5-23に、startAssemblyInstanceコマンドを示します。

例5-22 アセンブリ・インスタンスの開始(完了を待機しない場合)

$ ./abctl help –command startAssemblyInstance
$ ./abctl startAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdminRequest ID: 1936dff2-f8a7-4407-83f8-08521bb48fefRequest for start has been submitted to deployer.

例5-23 アセンブリ・インスタンスの開始(完了を待機する場合)

$ ./abctl help –command startAssemblyInstance
$ ./abctl startAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdmin -waitForComplete -pollTime 30Request ID: 1936dff2-f8a7-4407-83f8-08521bb48fefRequest for start has been submitted to deployer.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.8 アセンブリ・インスタンスの再開

この項では、Oracle Virtual Assembly Builder Studioまたはabctlを使用してアセンブリ・インスタンスを再開する方法について説明します。

停止されていたアセンブリ・インスタンスを再開できます。アセンブリ・インスタンスを再開すると、停止したすべてのVMが起動し、VM内のアプリケーションも起動します。アセンブリ・インスタンスは、停止する前の状態にリストアされます。この操作は、デプロイメント操作よりも短時間で完了します。

5.4.8.1 Oracle Virtual Assembly Builder Studioによるアセンブリ・インスタンスの再開

「デプロイメント」ナビゲータの「デプロイメント・ターゲット」ペインで、アセンブリ・インスタンスを開始、停止、デプロイまたはアンデプロイできます。アセンブリ・インスタンスを再開するには、アセンブリ・インスタンスを選択し、「開始」をクリックします。

5.4.8.2 abctlによるアセンブリ・インスタンスの再開

restartAssemblyInstanceコマンドを使用して、アセンブリ・インスタンスを再開します。アセンブリ・インスタンスは、assemblyInstanceIdによって参照されます。describeAssemblyInstancesコマンドを使用して、アセンブリ・インスタンスのリストを取得できます。例5-24および例5-25に、restartAssemblyInstanceコマンドを示します。

例5-24 アセンブリ・インスタンスの再開(完了を待機しない場合)

$ ./abctl help –command restartAssemblyInstance
$ ./abctl restartAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdminRequest ID: 126a97ef-89db-4b05-88d5-17b70e5cc3d2Request to restart assembly instance has been submitted to deployer.

例5-25 アセンブリ・インスタンスの再開(完了を待機する場合)

$ ./abctl help –command restartAssemblyInstance
$ ./abctl restartAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdmin -waitForComplete -pollTime 30Request ID: 126a97ef-89db-4b05-88d5-17b70e5cc3d2Request to restart assembly instance has been submitted to deployer.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.9 アプライアンスのスケーリング

この項では、アセンブリの初期デプロイ後に、Oracle Virtual Assembly Builder Studioまたはabctlを使用して、選択したアプライアンス・インスタンスをスケーリングする方法について説明します。

アセンブリのデプロイ後、各アプライアンスのターゲット数のVMインスタンスが開始されます。各アプライアンス・インスタンスの初期ターゲット数は、デプロイメント・プランで指定されます。アセンブリのデプロイ後に新規ターゲットを動的に指定できます。新規ターゲットに達するまで、Oracle Virtual Assembly BuilderはVMインスタンスを動的に開始または停止(スケール・アップまたはスケール・ダウン)します。スケール・ダウン操作では、正しくデプロイされているインスタンスのみが停止されます。

5.4.9.1 Oracle Virtual Assembly Builder Studioによるアプライアンスのスケーリング

アプライアンスのインスタンス数をスケーリングする手順は、次のとおりです。

1. 「デプロイメント」ナビゲータでアセンブリ・インスタンスを選択し、構造ペインでアセンブリ構造を展開します。

2. スケーラブル・アプライアンスを右クリックし、「アプライアンスのスケール」を選択します。
「スケール」ダイアログに、現在稼働中のVMの数と同様、VMインスタンスの最小数と最大数が表示されます。

3. 「ターゲット」ドロップダウン・リストからアプライアンスのVMインスタンスのターゲット数を設定します。最小数から最大数の範囲の値を選択します。

4. 「OK」をクリックします。

5.4.9.2 scaleコマンドで使用するためのscalingGroupIdの取得

describeScalingGroupsコマンドを使用してscalingGroupIdを取得し、scaleコマンドに渡します。(例5-26)

例5-26 describeScalingGroupコマンド

$ ./abctl help -command describeScalingGroups
$ ./abctl describeScalingGroups

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.9.3 abctlによるアセンブリ・インスタンス内のアプライアンスのスケーリング

scaleコマンドを使用して、アプライアンスをスケールします(例5-27および例5-28)。

例5-27 scaleコマンド(完了を待機しない場合)

$ ./abctl help -command scale
$ ./abctl scale -scalingGroupId 1gWT-t0Np_SMALLOVA_1:zeroAppliancesSite/myWls/Server_3 -target 1 -c cloudAdminRequest ID: c1d2c742-d2fe-4698-bf61-99d619be4fcaRequest for scaling operation has been submitted to deployer.

例5-28 scaleコマンド(完了を待機する場合)

$ ./abctl help -command scale
$ ./abctl scale -scalingGroupId 1gWT-t0Np_SMALLOVA_1:zeroAppliancesSite/myWls/Server_3 -target 1 -c cloudAdmin -waitForComplete -pollTime 30Request ID: c1d2c742-d2fe-4698-bf61-99d619be4fcaRequest for scaling operation has been submitted to deployer.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.10 アセンブリ・インスタンスのアンデプロイ

この項では、Oracle Virtual Assembly Builder Studioまたはabctlを使用してアセンブリ・インスタンスをアンデプロイする方法について説明します。

アセンブリ・インスタンスをアンデプロイすると、稼働中のVMはすべて停止します。また、障害が発生したVMが存在する場合は、そのVMのクリーンアップも行います。

5.4.10.1 Oracle Virtual Assembly Builder Studioによるデプロイメントのアンデプロイ

「デプロイメント」ナビゲータで、デプロイされたアセンブリ・インスタンスを右クリックし、「アンデプロイ」を選択すると、アセンブリ・インスタンスをアンデプロイできます。成功した場合は、ノードが削除されます。操作が失敗した場合は、赤のアイコンが表示されます。進捗メッセージは、メッセージ・ログ・ウィンドウに表示されます。

5.4.10.2 abctlによるアセンブリ・インスタンスのアンデプロイ

undeployAssemblyInstanceコマンドを使用すると、アセンブリ・インスタンスをアンデプロイできます。アセンブリ・インスタンスは、assemblyInstanceIdによって参照されます。describeAssemblyInstancesコマンドを使用して、アセンブリ・インスタンスのリストを取得できます。例5-29に、undeployAssemblyInstanceコマンドを示します。

例5-29 undeployAssemblyInstanceコマンド(完了を待機しない場合)

$ ./abctl help –command undeployAssemblyInstance
$ ./abctl undeployAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdminRequest ID: 6b0f1b14-466e-4b23-bcc3-8b8506fd40acRequest to undeploy assembly instance has been submitted to deployer.

例5-30 undeployAssemblyInstanceコマンド(完了を待機する場合)

$ ./abctl help –command undeployAssemblyInstance
$ ./abctl undeployAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdmin -waitForComplete -pollTime 30Request ID: 6b0f1b14-466e-4b23-bcc3-8b8506fd40acRequest to undeploy assembly instance has been submitted to deployer.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.11 ターゲットからのアセンブリ・アーカイブの登録解除

この項では、abctlを使用してOracle Virtual Assembly Builder Deployerからアセンブリ・アーカイブを登録解除する方法について説明します。この操作でアセンブリ・アーカイブの登録は解除されますが、アップロード済アーカイブは削除されません。

5.4.11.1 Oracle Virtual Assembly Builder Studioによるアセンブリ・アーカイブの登録解除

登録済のアセンブリ・アーカイブ・バージョンを右クリックし、「登録解除」を選択すると、バージョンの登録が解除されます(デプロイメント・ターゲットから)。

要求されたら、アセンブリの登録解除を確認します。

5.4.11.2 abctlによるアセンブリ・アーカイブの登録解除

unregisterAssemblyArchiveコマンドを使用して、アセンブリのテンプレートを登録解除します。例5-31および例5-32に、unregisterAssemblyArchiveコマンドを示します。

例5-31 unregisterAssemblyArchiveコマンド(完了を待機しない場合)

$ ./abctl help –command unregisterAssemblyArchive
$ ./abctl unregisterAssemblyArchive -name SMALLOVA -version 1 -target LOCBOX1 -c cloudAdminRequest ID: f9f9d0b7-e334-4020-a038-2b728e9a0a37Request to unregister assembly has been submitted to deployer.

例5-32 unregisterAssemblyArchiveコマンド(完了を待機する場合)

$ ./abctl help –command unregisterAssemblyArchive
$ ./abctl unregisterAssemblyArchive -name SMALLOVA -version 1 -target LOCBOX1 -c cloudAdmin -waitForComplete -pollTime 30Request ID: f9f9d0b7-e334-4020-a038-2b728e9a0a37Request to unregister assembly has been submitted to deployer.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.11.3 redeployAssemblyInstance

redeployAssemblyInstanceコマンドを使用して、アセンブリ・インスタンスを再デプロイします。例5-33および例5-34に、redeployAssemblyInstanceコマンドを示します。

例5-33 redeployAssemblyInstanceコマンド(完了を待機しない場合)

$ ./abctl help –command redeployAssemblyInstance
$ ./abctl redeployAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdminRequest ID: eff86a4c-d064-4794-b1ae-0624a972ab06Request to redeploy assembly instance has been submitted to deployer.

例5-34 redeployAssemblyInstanceコマンド(完了を待機する場合)

$ ./abctl help –command redeployAssemblyInstance
$ ./abctl redeployAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdmin -waitForComplete -pollTime 30Request ID: eff86a4c-d064-4794-b1ae-0624a972ab06Request to redeploy assembly instance has been submitted to deployer.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.11.4 deleteAssemblyInstance

アセンブリ・インスタンスがアンデプロイ状態になったら、deleteAssemblyInstanceコマンドを使用して、アセンブリ・インスタンスを削除します。例5-35に、deleteAssemblyInstanceコマンドを示します。

例5-35 deleteAssemblyInstanceコマンド

$ ./abctl help –command deleteAssemblyInstance
$ ./abctl deleteAssemblyInstance -assemblyInstanceId gdc4_29x5_SMALLOVA_1 -c cloudAdminAssembly instance gdc4_29x5_SMALLOVA_1 has been deleted.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.12 デプロイヤ・リポジトリへのアセンブリ・アーカイブのアップロード

uploadAssemblyArchiveコマンドを使用すると、アセンブリ・アーカイブをOracle Virtual Assembly Builder Deployerにアップロードできます。

例5-36 uploadAssemblyArchiveコマンド

$ ./abctl help –command uploadAssemblyArchive
$ ./abctl uploadAssemblyArchive -fileName Path -name String [-description String] -connectionName String

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.13 デプロイヤ・リポジトリからのアセンブリ・アーカイブの削除

OVAB管理では、abctlのdeleteAssemblyArchiveコマンドを使用して、デプロイヤ・リポジトリからアセンブリ・アーカイブを削除できます。この操作は、アセンブリ・アーカイブの登録がない場合にのみ実行できます。

例5-37 deleteAssemblyArchiveコマンド(完了を待機しない場合)

$ ./abctl help –command deleteAssemblyArchive
$ ./abctl deleteAssemblyArchive -name TheAssembly -version 1 -connectionName myDeployerConnection

例5-38 deleteAssemblyArchiveコマンド(完了を待機する場合)

$ ./abctl help –command deleteAssemblyArchive
$ ./abctl deleteAssemblyArchive -name TheAssembly -version 1 -connectionName myDeployerConnection -waitForComplete -pollTime 30

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.14 エクスポート操作

次の各項では、使用可能なエクスポート・シナリオについて説明します。

- Oracle Virtual Assembly Builder Studioカタログから別のOracle Virtual Assembly Builder Studioカタログへのエクスポートおよび(エクスポートにより作成されたアーティファクトの)インポート。次の項を参照してください。

- 5.4.14.1項「カタログからのアプライアンスまたはアセンブリのエクスポート」

- 5.4.14.2項「カタログへのアプライアンスまたはアセンブリのインポート」

- アセンブリ・アーカイブのコピー。他のユーザーが消費するためにOracle Virtual Assembly Builderの外部へのアセンブリ・アーカイブの公開。たとえば、アセンブリ・アーカイブを作成し、他のユーザーがダウンロードおよびデプロイするために企業内で公開します。

- 5.4.14.3項「アセンブリ・アーカイブのエクスポート(コピー)」

- デプロイヤ・リポジトリからOracle Virtual Assembly Builder Studioカタログへのアセンブリ・アーカイブのインポート(importコマンドまたはStudioからのインポート)。

- 5.4.14.4項「カタログへのアセンブリ・アーカイブのインポート」

5.4.14.1 カタログからのアプライアンスまたはアセンブリのエクスポート

この項では、Oracle Virtual Assembly Builder Studioまたはabctlを使用してアプライアンスまたはアセンブリをカタログからエクスポートする方法について説明します。

あるカタログから別のカタログにアプライアンスまたはアセンブリをコピーするには、Oracle Virtual Assembly Builderのエクスポートおよびインポート機能を使用する必要があります。

注意:

あるカタログから別のカタログにディスク・ファイルを手動でコピーすることはサポートされておらず、機能しません。

5.4.14.1.1 Oracle Virtual Assembly Builder Studioを使用したカタログからのアプライアンスまたはアセンブリのエクスポート

「エクスポート」ダイアログ・ボックス(図5-17)にアクセスし、「ファイル」 > 「エクスポート」を選択するか、「アセンブリ」ナビゲータでアセンブリを右クリックして「エクスポート」を選択し、アプライアンスまたはアセンブリをカタログからエクスポートします。

次の情報を入力します。

- 名前: このフィールドには、エクスポート対象として選択したアプライアンスまたはアセンブリの名前が事前に移入されます。

- ディレクトリ: エクスポートする場所のディレクトリ名を参照して選択するか、入力します。このディレクトリは空である必要があり、そのディレクトリが存在しない場合は作成されます。

- メタデータのみ: メタデータのみ(関連するテンプレートまたはファイル・セットは除く)をエクスポートするには、このチェック・ボックスを選択します。

「OK」をクリックします。

図5-17 カタログからのアプライアンスまたはアセンブリのエクスポート

5.4.14.1.2 abctlを使用したカタログからのアプライアンスまたはアセンブリのエクスポート

exportコマンドを使用して、アセンブリまたはアセンブリ・メタデータをエクスポートします。例5-39に、メタデータと、関連するテンプレートおよびファイル・セットをエクスポートするためのexportコマンドを示します。例5-40に、メタデータのみのエクスポートを示します。

例5-39 exportコマンド

$ ./abctl help –command export
$ ./abctl export -name myOhs -toDir /tmp/myOhs.export/
(some progress messages)
Successfully exported to /tmp/myOhs.export/.

例5-40 exportコマンド(メタデータのみ)

$ ./abctl export -name myOhs -to /tmp/myOhs.export/ -metadataOnly
(some progress messages)
Successfully exported to /tmp/myOhs.export/.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細がコマンドのサンプル出力とともに記載されています。

5.4.14.2 カタログへのアプライアンスまたはアセンブリのインポート

この項では、Oracle Virtual Assembly Builder Studioまたはabctlを使用してアプライアンス、アセンブリまたはアセンブリ・アーカイブをインポートする方法について説明します。

あるカタログから別のカタログにアプライアンスまたはアセンブリをコピーするには、Oracle Virtual Assembly Builderのエクスポートおよびインポート機能を使用する必要があります。

5.4.14.2.1 Oracle Virtual Assembly Builder Studioを使用したインポート

「インポート」ダイアログ・ボックス(図5-18)にアクセスし、「ファイル」 > 「インポート」を選択して、カタログにアプライアンスまたはアセンブリをインポートします。次の情報を入力します。

- パス: エクスポートされたアセンブリまたはアプライアンスのディレクトリ名を参照して選択するか、入力します。パスおよび関連付けられているアセンブリがウィンドウに表示されます。

- 上書き: 既存のメタデータ、関連するファイル・セットおよびテンプレートのオーバーライドを指定するには、このチェック・ボックスを選択します。これは名前競合の修正に使用します。既存のアプライアンスをオーバーライドできるのは、既存のアプライアンスを削除できる場合のみです。

「OK」をクリックします。

図5-18 アセンブリ・アーカイブのインポート

5.4.14.2.2 abctlを使用したアプライアンスまたはアセンブリのインポート

importコマンドを使用して、エクスポートされたメタデータと、関連するファイル・セットおよびテンプレートの疎コピーが含まれる1つ以上のファイルのコンテンツを(ターゲット・カタログに)インポートします。

新しいエントリがターゲット・カタログ内に作成されます。名前の競合がある場合(importコマンドが"mySite"を作成しようとして、カタログに"mySite"がすでにある場合など)、操作は失敗します。

例5-41に、前にexportコマンドを実行したディレクトリからのimportコマンドを示します。

例5-41 ディレクトリからのimportコマンド

$ ./abctl help –command import
$ ./abctl import -from /tmp/myOhs.export/
Successfully imported myOhs to /example/ab_home/catalog.

例5-42に、アセンブリ・アーカイブからのimportコマンドを示します。

例5-42 アセンブリ・アーカイブからのimportコマンド

$ ./abctl help –command import
$ ./abctl import -from /tmp/myOhs.ova
Successfully imported myOhs to /example/ab_home/catalog.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.14.2.3 外部VMテンプレートのインポート

外部VMテンプレートを指定したカタログにインポートし、デプロイメント用に後でアセンブリに追加できる外部アプライアンスを作成できます。

この操作は、abctlを使用してのみ実行できます。

例5-43に、外部VMテンプレートのインポート・コマンドを示します。

例5-43 外部VMテンプレートのインポート

$ ./abctl importExternalTemplate -fromDir /dir/containing/image/file -name myExternalAppliance
Executing importExternalTemplate command.
Set the root and vnc passwords that will be configured in the imported template.
Enter root password:
Retype root password:
Enter vnc password:
Retype vnc password:
(some progress messages)
Successfully imported template.

5.4.14.3 アセンブリ・アーカイブのエクスポート(コピー)

Oracle Virtual Assembly Builder Studioカタログ内のアセンブリ・アーカイブは、$AB_INSTANCE/ovaディレクトリに格納されます。コピーまたはFTPを使用して、エクスポート・ユーティリティを使用せずにアセンブリ・アーカイブをこのディレクトリから転送できます。通常、アセンブリ・アーカイブをデプロイヤによって管理される「デプロイメント」ナビゲータにコピーします。

5.4.14.4 カタログへのアセンブリ・アーカイブのインポート

アセンブリ・アーカイブをインポートすると、アセンブリ・アプライアンスの編集ができるように、アセンブリ・アーカイブ・テンプレート・ファイルをディスクの場所からローカル・カタログにインポートできます。インポートでは、元のカタログと同じファイル・セットおよびテンプレート・アーティファクトでメタデータ構造を作成します。

アセンブリ・アーカイブをインポートするには、abctlのdownloadAssemblyArchiveコマンドを使用します。

例5-44 downloadAssemblyArchiveコマンド

$ ./abctl help –command downloadAssemblyArchive
$ ./abctl downloadAssemblyArchive -name MyAssembly -version 1 -fileName RenamedAssembly.ova

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.15 EMソフトウェア・ライブラリとのやり取り

Enterprise Manager Grid Control Cloud Management Packを使用してデプロイメント操作をアセンブリ・アーカイブに対して実行する予定の場合、これらの操作を使用します。このシナリオでは、Oracle Virtual Assembly Builderを使用してアセンブリ・アーカイブを作成し、Enterprise Managerソフトウェア・ライブラリにアップロードします。Enterprise Manager Grid Control Cloud Management Packを使用して、アセンブリ・インスタンスをデプロイします。

5.4.15.1 Enterprise Managerソフトウェア・ライブラリへの接続の構成

Enterprise Managerソフトウェア・ライブラリへの接続を構成するには、abctlのcreateEMConnectionコマンドを使用します。Enterprise Managerソフトウェア・ライブラリへの接続は、接続ファイルで維持されます。

リモートEnterprise Managerマシンの完全修飾ホスト名を指定する必要があります。例: myhostのかわりにmyhost.example.com。

例5-45 createEMConnection

$ ./abctl createEmConnection -connectionURL emMachine:7791 -connectionUser admin -namedHostCredential hostCredential -remoteUser mySshUser -remoteWorkingDir /scratch/myovas [-sshPort 23] [-privateKeyFile ~/.ssh/id_rsa]

connectionPasswordを要求されます。

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.15.2 アセンブリのアップロード

Oracle Virtual Assembly Builder StudioカタログからEnterprise Managerソフトウェア・ライブラリにアセンブリ・アーカイブをアップロードするには、abctlのuploadEMAssemblyArchiveコマンドを使用します。アセンブリ・アーカイブは、アセンブリを使用して作成しておく必要があります。

例5-46 Enterprise Managerソフトウェア・ライブラリへのアセンブリのアップロード

$ ./abctl uploadEMAssemblyArchive -name archiveName -description "my assembly archive"
Assembly archive upload started
Assembly archive upload at 10%
Assembly archive upload at 20%
Assembly archive upload at 30%
Assembly archive upload at 40%
Assembly archive upload at 50%
Assembly archive upload at 60%
Assembly archive upload at 70%
Assembly archive upload at 80%
Assembly archive upload at 90%
Assembly archive upload at 100%
Assembly archive upload complete
Assembly archive version 0.1 uploaded
Successfully uploaded the assembly archive mySite to EM Software Library.  Check the status of the assembly archive with describeEMAssemblyArchives before using.

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.15.3 Enterprise Managerソフトウェア・ライブラリのアセンブリ・アーカイブの記述

Enterprise Managerソフトウェア・ライブラリに存在する アセンブリ・アーカイブとそのバージョンをリストするには、abctlのdescribeEMAssemblyArchivesコマンドを使用します。

例5-47 EMソフトウェア・ライブラリのアセンブリ・アーカイブの記述

$ ./abctl describeEMAssemblyArchives [-name nameOfAssemblyArchive]

------------------------------------------------
Name   | Version | Description | Status
------------------------------------------------
mySite | 0.3     | mysite3     | READY
| 0.2     | mysite3     | READY
| 0.1     | mysite3     | READY
------------------------------------------------

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.15.4 Enterprise Managerソフトウェア・ライブラリからのアセンブリ・アーカイブの削除

Enterprise Managerソフトウェア・ライブラリから指定したバージョンのアセンブリ・アーカイブを削除するには、abctlのdeleteEMAssemblyArchiveコマンドを使用します。

注意:

describeEMAssemblyArchivesコマンドからのステータスがREADYになるまで、アセンブリ・アーカイブを削除しないでください。出力例は、例5-47「EMソフトウェア・ライブラリのアセンブリ・アーカイブの記述」を参照してください。

例5-48 Enterprise Managerソフトウェア・ライブラリからのアセンブリ・アーカイブの削除

abctl deleteEMAssemblyArchive -name archiveName -version 1.2

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

5.4.15.5 Oracle Virtual Assembly Builderカタログへのアセンブリのダウンロード

Enterprise Managerソフトウェア・ライブラリからOracle Virtual Assembly Builder Studioカタログにアセンブリをダウンロードするには、abctlのdownloadコマンドを使用します。

注意:

describeEMAssemblyArchivesコマンドからのステータスがREADYになるまで、アセンブリ・アーカイブをダウンロードしないでください。出力例は、例5-47「EMソフトウェア・ライブラリのアセンブリ・アーカイブの記述」を参照してください。

アセンブリ・アーカイブは、Oracle Virtual Assembly Builderメタデータ、ファイル・セットおよびテンプレートを作成してOracle Virtual Assembly Builder Studioカタログで維持するために、リバース・エンジニアリングされます。

例5-49 アセンブリのダウンロード

abctl downloadEMAssemblyArchive -name archiveName -version 1.0 -force -downloadAs newName

詳細は、付録A「コマンドライン・リファレンス」を参照してください。この付録には、コマンドに渡すことができるパラメータの詳細が記載されています。

A コマンドライン・リファレンス

この付録には、Oracle Virtual Assembly Builderに組み込まれているabctlコマンドに関する情報が記載されています。

- A.1項「コマンド」

- A.2項「help」

A.1 コマンド

この項では、使用可能なコマンドについて説明します。コマンドは、次の2つのカテゴリに分けられます。

- アプライアンスおよびアセンブリの作成、アプライアンス・テンプレートおよびアセンブリ・アーカイブの作成、デプロイメント・プランの作成のためのコマンド。

- デプロイメント・ターゲットの構成、デプロイヤへのアセンブリ・アーカイブのアップロード、アセンブリ・インスタンスの作成、アセンブリ・インスタンスのデプロイ、アンデプロイ、開始および停止、アプライアンス・インスタンスのスケーリングのためのコマンド。これらのコマンドは、Oracle Virtual Assembly Builder Deployer Webサービスとインタフェースをとります。

Oracle Virtual Assembly Builder Studioがインストールされている場合、すべてのコマンドを使用できます。Oracle Virtual Assembly Builder Deployerのみがインストールされている場合、一部のコマンドが使用できます。表A-1に、インストールされているOracle Virtual Assembly Builderコンポーネントに応じて使用可能なコマンドを示します。

表A-1 インストール・タイプ別の使用可能なコマンド

コマンド名と項

インストール・タイプに対するコマンドの可用性

デプロイヤのみのインストール

Studioのみのインストール

Studioおよびデプロイヤのインストール

A.1.1項「addAssemblyUsers」

はい

はい

はい

A.1.2項「addTargetUser」

はい

はい

はい

A.1.3項「addToAssembly」

いいえ

はい

はい

A.1.4項「captureFileSets」

いいえ

はい

はい

A.1.5項「connectEndpoints」

いいえ

はい

はい

A.1.6項「createAssembly」

いいえ

はい

はい

A.1.7項「createAssemblyArchive」

はい

はい

はい

A.1.8項「createAssemblyInstance」

はい

はい

はい

A.1.9項「createDeployerConnection」

はい

はい

はい

A.1.10項「createEMConnection」

いいえ

はい

はい

A.1.11項「createExternalResources」

いいえ

はい

はい

A.1.12項「createTags」

はい

はい

はい

A.1.13項「createTarget」

はい

はい

はい

A.1.14項「createTemplate」

いいえ

はい

はい

A.1.15「delete」

いいえ

はい

はい

A.1.16項「deleteAssemblyArchive」

はい

はい

はい

A.1.17項「deleteAssemblyInstance」

はい

はい

はい

A.1.18項「deleteDeployerConnection」

はい

はい

はい

A.1.19項「deleteEMConnection」

いいえ

はい

はい

A.1.20項「deleteEMAssemblyArchive」

いいえ

はい

はい

A.1.21項「deleteFailedAssemblyInstances」

はい

はい

はい

A.1.22項「deleteRequests」

はい

はい

はい

A.1.23項「deleteTags」

はい

はい

はい

A.1.24項「deleteTarget」

はい

はい

はい

A.1.25項「deployAssemblyInstance」

はい

はい

はい

A.1.26項「describeApplianceInstances」

はい

はい

はい

A.1.27項「describeAssemblyArchives」

はい

はい

はい

A.1.28項「describeAssemblyInstances」

はい

はい

はい

A.1.29項「describeAssemblyUsers」

はい

はい

はい

A.1.30項「describeCatalog」

いいえ

はい

はい

A.1.31項「describeDeployer」

はい

はい

はい

A.1.32項「describeDeployerConnections」

いいえ

はい

はい

A.1.33項「describeDeploymentPlans」

いいえ

はい

はい

A.1.34項「describeEMAssemblyArchives」

いいえ

はい

はい

A.1.35項「describeEMConnection」

いいえ

はい

はい

A.1.36項「describeEndpoints」

いいえ

はい

はい

A.1.37項「describeRegistrations」

はい

はい

はい

A.1.38項「describeRequests」

はい

はい

はい

A.1.39項「describeScalingGroups」

はい

はい

はい

A.1.40項「describeTags」

はい

はい

はい

A.1.41項「describeTargetConfigurations」

はい

はい

はい

A.1.42項「describeTargetNames」

はい

はい

はい

A.1.43項「describeTargetUsers」

はい

はい

はい

A.1.44項「describeTargets」

はい

はい

はい

A.1.45項「describeUserTargets」

はい

はい

はい

A.1.46項「describeVnets」

はい

はい

はい

A.1.47項「downloadAssemblyArchive」

はい

はい

はい

A.1.48項「downloadAssemblyMetadata」

はい

はい

はい

A.1.49項「downloadEMAssemblyArchive」

いいえ

はい

はい

A.1.50項「export」

いいえ

はい

はい

A.1.51項「getDefaultTarget」

はい

はい

はい

A.1.52項「getTargetType」

はい

はい

はい

A.1.53項「help」

はい

はい

はい

A.1.54項「import」

いいえ

はい

はい

A.1.55項「importExternalTemplate」

いいえ

はい

はい

A.1.56項「introspectCoherenceWeb」

いいえ

はい

はい

A.1.57項「introspectForms」

いいえ

はい

はい

A.1.58項「introspectGenericProd」

いいえ

はい

はい

A.1.59項「introspectOHS」

いいえ

はい

はい

A.1.60項「introspectOTD」

いいえ

はい

はい

A.1.61項「introspectRACDB」

いいえ

はい

はい

A.1.62項「introspectReports」

いいえ

はい

はい

A.1.63項「introspectSIDB」

いいえ

はい

はい

A.1.64項「introspectSOA」

いいえ

はい

はい

A.1.65項「introspectTuxedo」

いいえ

はい

はい

A.1.66項「introspectWebCache」

いいえ

はい

はい

A.1.67項「introspectWLS」

いいえ

はい

はい

A.1.68項「redeployAssemblyInstance」

いいえ

はい

はい

A.1.69項「registerAssemblyArchive」

はい

はい

はい

A.1.70項「removeAssemblyUsers」

いいえ

はい

はい

A.1.71項「removeTargetUsers」

はい

はい

はい

A.1.72項「restartAssemblyInstance」

はい

はい

はい

A.1.73項「scale」

はい

はい

はい

A.1.74項「setDefaultTarget」

はい

はい

はい

A.1.75項「startAssemblyInstance」

はい

はい

はい

A.1.76項「stopAssemblyInstance」

はい

はい

はい

A.1.77項「undeployAssemblyInstance」

はい

はい

はい

A.1.78項「unregisterAssemblyArchive」

はい

はい

はい

A.1.79項「updateAssemblyArchive」

はい

はい

はい

A.1.80項「updateTarget」

はい

はい

はい

A.1.81項「uploadAssemblyArchive」

はい

はい

はい

A.1.82項「uploadAssemblyResources」

はい

はい

はい

A.1.83項「uploadEMAssemblyArchive」

いいえ

はい

はい

A.1.84項「version」

はい

はい

はい

A.1.1 addAssemblyUsers

このコマンドの詳細は、次のとおりです。

A.1.1.1 形式

$ abctl addAssemblyUsers -assembly String -user String... -connectionName String

A.1.1.2 説明

1人以上のユーザーをアセンブリに追加します。

A.1.1.3 オプション

表A-2に、addAssemblyUsersのコマンド・オプションを示します。

表A-2 addAssemblyUsersのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assembly

a

true

なし

アセンブリの名前を表す文字列。

ユーザーを追加するアセンブリを指定します。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-user

u

true

なし

追加するユーザー名を表す文字列。

アセンブリに追加する1人以上のユーザーを指定します。

A.1.1.4 例

次に、コマンド例を示します。

A.1.1.4.1 アセンブリへのユーザーの追加

$ abctl addAssemblyUsers -assembly MyAssembly -user User1 User2

A.1.2 addTargetUser

このコマンドの詳細は、次のとおりです。

A.1.2.1 形式

$ abctl addTargetUser -user String -target String [-properties String...]
-connectionName String

A.1.2.2 説明

ユーザーをターゲットに追加します。

A.1.2.3 オプション

表A-3に、addTargetUserのコマンド・オプションを示します。

表A-3 addTargetUserのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-user

u

true

なし

ユーザーのユーザー名を表す文字列。

ユーザーのユーザー名。

-target

t

true

なし

ユーザーを追加するターゲットを表す文字列。

ユーザーを追加するターゲット。

-properties

p

false

なし

ユーザーに適用するプロパティ=値のペアを表す文字列。

ユーザーに適用するプロパティ。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.2.4 例

次に、コマンド例を示します。

A.1.2.4.1 1つのアセンブリへの複数のユーザーの追加

$ abctl addTargetUser -user Username -target Targetname -connectionName MyDeployerConnection

A.1.3 addToAssembly

このコマンドの詳細は、次のとおりです。

A.1.3.1 形式

$ abctl addToAssembly -name String -into String

A.1.3.2 説明

既存のアプライアンスまたはアセンブリを別の既存のアセンブリに追加します。

A.1.3.3 オプション

表A-4に、addToAssemblyのコマンド・オプションを示します。

表A-4 addToAssemblyのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

既存のアプライアンスまたは原子性アセンブリの名前。

追加する既存のアプライアンスまたは原子性アセンブリの名前。

-into

i

true

なし

非原子性アセンブリの名前。

移入する既存のアセンブリの名前。

A.1.3.4 例

次に、コマンド例を示します。

A.1.3.4.1 既存のアセンブリへのアプライアンスの追加

$ abctl addToAssembly -name myAppliance -into myAssembly

A.1.4 captureFileSets

このコマンドの詳細は、次のとおりです。

A.1.4.1 形式

$ abctl captureFileSets -name String [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path] [-quiet] [-force]

A.1.4.2 説明

指定されたアプライアンスまたはアセンブリのファイル・セットを作成します。

A.1.4.3 オプション

表A-6に、captureFileSetsのコマンド・オプションを示します。

表A-5 captureFileSetsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

操作の実行前と同様の、sudoを実行するリモート・マシンのユーザーの名前。sudoユーザーは、Oracle Virtual Assembly Builder Studioの実行ユーザーと同じであることに注意してください。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteCleanup

rc

false

なし

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-privateKeyFile

pkf

false

~/.ssh/id_rsa

秘密鍵ファイルの場所。

ローカル・マシンのSSH秘密鍵ファイル。

-quiet

q

false

なし

該当なし

デフォルトでは、詳細な進捗/成功メッセージが表示されます。-quietを設定すると、詳細モードはオフになり、1つまたは2つの進捗/成功メッセージのみが表示されます。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

アプライアンスまたはアセンブリの名前。ネストしたアプライアンスまたはアセンブリは、スラッシュ(/)を使用して参照されます。例: mySite/myOhs

取得するアプライアンスまたはアセンブリの名前を指定します。アセンブリの場合、原子性アセンブリ名のみを指定できます。非原子性アセンブリを取得するには、サブアプライアンスおよびサブアセンブリを個別に取得する必要があります。

-force

f

false

なし

該当なし

指定すると、既存のファイル・セットと、そのファイル・セットから作成されるアプライアンス・テンプレートが上書きされます。既存のファイル・セットから作成された登録済アプライアンス・テンプレートがすでに存在する場合、この操作が失敗する可能性があります。ファイル・セットまたはテンプレートが存在しない場合、このフラグは機能しません。

A.1.4.4 例

次に、コマンド例を示します。

A.1.4.4.1 ファイル・セットの取得

% abctl captureFileSets -name myOhs -force

A.1.5 connectEndpoints

このコマンドの詳細は、次のとおりです。

A.1.5.1 形式

$ abctl connectEndpoints -from String -fromOutput String -to String -toInput String

A.1.5.2 説明

出力と入力の間に、新しい接続を作成します。出力および入力のプロトコルは一致する必要があります。また、出力および入力の所有者は同じアセンブリに属する必要があります。

A.1.5.3 オプション

表A-6に、connectEndpointsのコマンド・オプションを示します。

表A-6 connectEndpointsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-from

f

true

なし

アプライアンスまたはアセンブリの名前。

接続元となるアプライアンスまたはアセンブリの名前。

-fromOutput

fout

true

なし

アプライアンス出力またはアセンブリ出力。

接続元となるアプライアンス出力またはアセンブリ出力。

-to

t

true

なし

アプライアンスまたはアセンブリの名前。

接続先となるアプライアンスまたはアセンブリの名前。

-toInput

tin

true

なし

アプライアンス入力またはアセンブリ入力。

接続先となるアプライアンス入力またはアセンブリ入力。

A.1.5.4 例

次に、コマンド例を示します。

A.1.5.4.1 connectEndpoints

% abctl connectEndpoints -from mySite/myOhs -fromOutput output1 -to mySite/myWls -toInput default

A.1.6 createAssembly

このコマンドの詳細は、次のとおりです。

A.1.6.1 形式

$ abctl createAssembly -name String [-defaultNetwork String] [-force]

A.1.6.2 説明

指定された名前のアセンブリがまだ存在しない場合、新しいアセンブリをカタログに作成します。

A.1.6.3 オプション

表A-7に、createAssemblyのコマンド・オプションを示します。

表A-7 createAssemblyのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

新しいアセンブリの名前。

作成する新しいアセンブリの名前。

-defaultNetwork

dn

false

なし

デフォルトvNetの名前。

指定する場合は、アセンブリのデフォルトvNetに使用する名前を指定します。

-force

f

false

なし

該当なし

-forceを設定すると、新しく作成されるアセンブリと同じ名前を使用して、カタログ内の既存のアプライアンスまたはアセンブリがオーバーライドされます。

A.1.6.4 例

次に、コマンド例を示します。

A.1.6.4.1 アセンブリの作成

$ abctl createAssembly -name myAssembly -defaultNetwork intranet

A.1.7 createAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.7.1 形式

$ abctl createAssemblyArchive -name String -platform String [-noCompress] [-force] [-quiet]

A.1.7.2 説明

指定された最上位アセンブリのアセンブリ・アーカイブを作成します。このコマンドは、最上位アセンブリに対してのみ呼び出すことができます。また、アセンブリ内のすべてのサブアプライアンスは、createTemplateコマンドを使用してすでにテンプレート化されている必要があります。

A.1.7.3 オプション

表A-9に、createAssemblyArchiveのコマンド・オプションを示します。

表A-8 createAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

アプライアンスまたは原子性アセンブリの名前。ネストしたアプライアンスまたはアセンブリは、スラッシュ(/)を使用して参照されます。例: mySite/myOhs。

カタログ内のアプライアンスまたはアセンブリの名前。最上位のアプライアンスまたはアセンブリのみ指定できます。

-platform

p

true

なし

指定されたアセンブリ用にテンプレートが作成されている有効なプラットフォームを表す文字列。

アセンブリ・アーカイブの作成対象となるターゲット・プラットフォーム。

-force

f

false

false

該当なし

指定すると、既存のアセンブリ・アーカイブがオーバーライドされます。アーカイブが存在しない場合、このフラグは機能しません。

-quiet

q

false

なし

該当なし

デフォルトでは、詳細な進捗/成功メッセージが表示されます。-quietを設定すると、詳細モードはオフになり、1つまたは2つの進捗/成功メッセージのみが表示されます。

A.1.7.4 例

次に、コマンド例を示します。

A.1.7.4.1 アセンブリ・インスタンスの作成

$ abctl createAssemblyArchive -name myWlsAssembly -platform OVM -nocompress

A.1.8 createAssemblyInstance

このコマンドの詳細は、次のとおりです。

A.1.8.1 形式

$ abctl createAssemblyInstance -deploymentPlan Path -name String -version String [-target String] -connectionName String

A.1.8.2 説明

アセンブリのアセンブリ・インスタンスを作成します。

A.1.8.3 オプション

表A-9に、createAssemblyInstanceのコマンド・オプションを示します。

表A-9 createAssemblyInstanceのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-deploymentPath

dp

true

なし

ディスク上のアセンブリ・デプロイメント・プランへのファイル・パス。

アセンブリ・インスタンスに使用するデプロイメント・プラン・ファイルへのパスを指定します。

-name

n

true

なし

アセンブリの名前を表す文字列。

アセンブリの名前。

-version

v

true

なし

アセンブリのバージョンを表す文字列。

アセンブリのバージョン。

-target

t

false

なし

ターゲットの名前を表す文字列。

ターゲットの名前。

-connectionName

c

true

なし

デプロイヤWebサービスへの接続の名前を表す文字列。

デプロイヤWebサービスへの接続の名前。

A.1.8.4 例

次に、コマンド例を示します。

A.1.8.4.1 アセンブリ・インスタンスの作成

$ abctl createAssemblyInstance -deploymentPlan c:/MyDeploymentPlan.xml -name MyAssembly -version 1

A.1.9 createDeployerConnection

このコマンドの詳細は、次のとおりです。

A.1.9.1 形式

$ abctl createDeployerConnection -name String -url String [-username String] [-noReviewCert]

A.1.9.2 説明

abctlとデプロイヤの間に、新しい接続を作成します。HTTPSプロトコルを使用して接続を指定する場合、証明書の承認が要求されることがあります。

A.1.9.3 オプション

表A-10に、createDeployerConnectionのコマンド・オプションを示します。

表A-10 createDeployerConnectionのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

デプロイヤ接続の名前を表す文字列。

デプロイヤ接続の名前。

-url

u

true

なし

デプロイヤWebサービスのURLを表す文字列。

デプロイヤのURL。

-username

un

false

なし

ユーザー名を表す文字列。

デプロイヤWebサービスで認証に使用するユーザー名。

-noReviewCert

nr

false

なし

該当なし

設定する場合は、承認用のHTTPS接続証明書を提示しないでください。

A.1.9.4 例

次に、コマンド例を示します。

A.1.9.4.1 デプロイヤ接続の作成

$ abctl createDeployerConnection -name WLS1 -url http://localhost:7001

A.1.10 createEMConnection

このコマンドの詳細は、次のとおりです。

A.1.10.1 形式

$ abctl createEmConnection -connectionURL emMachine:port -connectionUser admin -namedHostCredential hostCredential -remoteUser mySshUser -remoteWorkingDir myRemoteWorkingDir [-sshPort port] [-privateKeyFile ~/.ssh/id_rsa]

A.1.10.2 説明

Enterprise Managerソフトウェア・ライブラリへの接続を作成し、接続ファイルで維持します。

リモートEnterprise Managerマシンの完全修飾ホスト名を指定する必要があります。例: myhostのかわりにmyhost.example.com。

このコマンドを実行すると、接続パスワードを要求されます。

A.1.10.3 オプション

表A-11に、createEMConnectionのコマンド・オプションを示します。

表A-11 createEMConnectionのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionURL

c

true

なし

Hostname:port。

EMソフトウェア・ライブラリに接続するためのURL。

-connectionUser

cu

true

なし

有効なEMソフトウェア・ライブラリ・ユーザー。

EMソフトウェア・ライブラリのユーザー。

-namedHostCredential

n

true

なし

有効な名前付きホスト資格証明。

名前付きホスト資格証明。

-remoteUser

ru

true

なし

有効なSSHユーザー。

EMソフトウェア・ライブラリがあるマシンに接続するためのSSHユーザー。

-sshPort

s

false

なし

有効なSSHポート番号。

EMソフトウェア・ライブラリ・マシンのSSHポート。

-privateKeyFile

pkf

false

なし

~/.ssh/id_rsa, id_rsa

リモートEMソフトウェア・ライブラリ・マシンへのSSHに使用されるローカルSSH秘密鍵ファイル。

-remoteWorkingDir

rwd

true

なし

/scratch,/home/mydir

アセンブリ・アーカイブがアップロードおよび消費される、EMソフトウェア・ライブラリ・マシン上の有効なディレクトリ。/tmpディレクトリを使用しないことをお薦めします。

A.1.10.4 例

次に、コマンド例を示します。

A.1.10.4.1 createEMConnection

$ abctl createEmConnection -connectionURL emMachine:7791 -connectionUser admin -namedHostCredential hostCredential -remoteUser mySshUser -remoteWorkingDir /scratch/myovas [-sshPort 23] [-privateKeyFile ~/.ssh/id_rsa]

A.1.11 createExternalResources

このコマンドの詳細は、次のとおりです。

A.1.11.1 形式

$ abctl createExternalResources -from String [-fromOutput String] [-name String] [-recurse]

A.1.11.2 説明

アプライアンスまたはアセンブリの未接続出力ごとに外部リソースを作成します。

A.1.11.3 オプション

表A-12に、createExternalResourcesのコマンド・オプションを示します。

表A-12 createExternalResourcesのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-from

f

true

なし

アプライアンスまたはアセンブリの名前。

外部リソースを作成するアプライアンスまたはアセンブリの名前。

-fromOutput

fout

false

なし

アプライアンス出力またはアセンブリ出力の名前。

外部リソースを作成するアプライアンス出力またはアセンブリ出力の名前。

-name

n

false

なし

新しい外部リソース名。

新しい外部リソース・アプライアンスの名前。このパラメータは、-fromOutputパラメータを使用して個々の出力に対して外部リソースを作成する場合にのみ適用できます。

-recurse

r

false

なし

該当なし

指定すると、アセンブリのサブ要素ごとに外部リソースが作成されます。

A.1.11.4 例

次に、コマンド例を示します。

A.1.11.4.1 アセンブリの外部リソースの作成

% abctl createExternalResources -from mySite/myWls

A.1.11.4.2 アセンブリの各サブ要素の外部リソースの作成

% abctl createExternalResources -from mySite -r

A.1.11.4.3 jdbc0出力の外部リソースの作成

% abctl createExternalresources -from mySite/myWls -fromOutput jdbc0 -name my_Ext_JDBC

A.1.12 createTags

このコマンドの詳細は、次のとおりです。

A.1.12.1 形式

$ abctl createTags -tag String... -resource String... -connectionName String

A.1.12.2 説明

リソースのタグを1つ以上作成します。

A.1.12.3 オプション

表A-13に、createTagsのコマンド・オプションを示します。

表A-13 createTagsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-tag

t

true

なし

タグを指定する一連の名前=値のペア。

リソースにタグ付けする1つ以上のタグを指定します。

-resource

r

true

なし

タグ付けするオブジェクトのリソースIDを指定する文字列。

タグを適用する1つ以上のリソースを指定します。

-connectionName

c

true

なし

デプロイヤWebサービスへの接続の名前を表す文字列。

デプロイヤWebサービスへの接続の名前。

A.1.12.4 例

次に、コマンド例を示します。

A.1.12.4.1 タグの作成

$ abctl createTags -tag key=value -resource MyResource

A.1.13 createTarget

このコマンドの詳細は、次のとおりです。

A.1.13.1 形式

$ abctl createTarget -name String -type String -connectionName String [-properties String...] [-default]

A.1.13.2 説明

デプロイメント・ターゲットを作成します。このコマンドは、Oracle VMのターゲットに対して有効になっており、Oracle Exalogicに対しては無効になっています。Oracle Exalogicインストールでは1つのターゲットが事前構成され、変更できません。

次に、createTargetコマンドの必須およびオプションのプロパティを示します。(アスタリスク(*)は必須プロパティを示します)

- ovm [ovm.url*、ovm.poolName*、ovm.user*、ovm.pwd*、ovm.vmmversion*、ovm.
vmOperationTimeout]

A.1.13.3 Oracle VM構成

HTTPプロトコルのかわりにTCPを使用してOracle VM 3のターゲット接続を構成することをお薦めします。

TCPを使用して構成するには、"tcp://their-ovm-host:54321"形式のURLを指定します。

A.1.13.4 オプション

表A-14に、createTargetのコマンド・オプションを示します。

表A-14 createTargetのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

ターゲットの名前を表す文字列。

ターゲットの名前。

-type

t

true

なし

ターゲットのタイプを表す文字列。可能な値はovmです。

アセンブリ・インスタンス・ターゲットのタイプ。

-properties

p

false

なし

ターゲットに設定するプロパティ=値のペアを表す文字列。

ターゲットに設定するプロパティ。

-default

d

false

false

該当なし

設定すると、このターゲットがデフォルト・ターゲットであることを示します。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.13.5 例

次に、コマンド例を示します。

A.1.13.5.1 ターゲットの作成

$ abctl createTarget -name MyTarget -type OVM

A.1.14 createTemplate

このコマンドの詳細は、次のとおりです。

A.1.14.1 形式

$ abctl createTemplate -name String -platform String [-quiet] [-baseImage Path] [-force]

A.1.14.2 説明

指定されたアプライアンスまたはアセンブリのアプライアンス・テンプレートを作成します。

A.1.14.3 オプション

表A-15に、createTemplateのコマンド・オプションを示します。

表A-15 createTemplateのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-baseImage

bi

false

指定しないと、コマンドは、$<AB_INSTANCE>/templates/baseImage/OVM/OELからベース・イメージを探そうとします。そこで見つからない場合は、$<ORACLE_HOME>/templates/baseImage/OVM/OELから探そうとします。

有効なベース・イメージへのパス。

アプライアンス・テンプレートの作成に使用する有効なベース・イメージへのパス。

-force

f

false

false

該当なし

-forceを設定すると、アセンブリまたはアプライアンスの既存のテンプレートがオーバーライドされます。テンプレートが存在しない場合、このフラグは機能しません。

-name

n

true

なし

カタログ内のアプライアンスまたはアセンブリの名前。ネストしたアプライアンスまたはアセンブリは、スラッシュ(/)を使用して参照されます。例: mySite/myOhs。

カタログ内のアプライアンスまたはアセンブリの名前。

-platform

p

true

なし

OVM、Exalogic

アプライアンス・テンプレートの作成対象となるターゲット・プラットフォーム。

-quiet

q

false

false

該当なし

デフォルトでは、詳細な進捗/成功メッセージが表示されます。-quietを設定すると、詳細モードはオフになり、1つまたは2つの進捗/成功メッセージのみが表示されます。

A.1.14.4 例

次に、このコマンドの例を示します。

A.1.14.4.1 有効なベース・イメージが見つからない場合

$ abctl createTemplate -name myOhs -platform OVM
Executing createTemplate command.
Error: OAB-7389: Failed to create VM template for myOhs.
Caused by: OAB-20343: Unable to locate a valid default base image.
Action: Specify a base image location, or place a base image in default location. Refer to user guide for detail.

A.1.14.4.2 指定されたOSタイプのテンプレートがすでに存在する場合

$ abctl createTemplate -name myOhs -platform OVM
Executing createTemplate command.
Error: OAB-7389: Failed to create VM template for myOhs.
Caused by: OAB-20120: Appliance myOhs already has template for OEL.
Action: Use -force flag to override existing template.

A.1.14.4.3 テンプレート作成が成功した場合

$ abctl createTemplate -name myOhs -platform OVM -baseImage /private/baseImage/OVM/OEL/System.img
Executing createTemplate command.
Set the root and vnc passwords that will be configured in the template.
Enter root password:
Retype root password:
Enter vnc password:
Retype vnc password:
Step 1 of 2: Creating template for appliance myOhs started.
Step 1 of 6: Copying base image to catalog started.
Step 2 of 6: Copying base image to catalog completed.
Step 3 of 6: Creating AB image started.
Step 4 of 6: Creating AB image completed.
Step 5 of 6: Creating product disk for myOhs_root started.
Step 6 of 6: Creating product disk for myOhs_root completed.
Step 2 of 2: Creating template for appliance myOhs completed.
Successfully created template for myOhs.

A.1.15 delete

このコマンドの詳細は、次のとおりです。

A.1.15.1 形式

$ abctl delete [-name] String [-archiveOnly]

A.1.15.2 説明

指定された名前のアプライアンスまたはアセンブリを削除します。最上位のアプライアンスまたはアセンブリのみを削除できます。ネストしたアプライアンスまたはアセンブリは、このコマンドを使用して削除できません。また、登録済のアプライアンスまたはアセンブリも削除できません。

A.1.15.3 オプション

表A-16に、deleteのコマンド・オプションを示します。

表A-16 deleteのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

最上位のアプライアンスまたはアセンブリの名前。

削除する最上位のアプライアンスまたはアセンブリの名前。

-archiveOnly

o

false

なし

該当なし

指定すると、アセンブリ・アーカイブのみが削除されます。アセンブリの他の部分はそのまま残ります。

A.1.15.4 例

次に、コマンド例を示します。

A.1.15.4.1 ネストしたアプライアンス/アセンブリの削除の試行

$ abctl delete -name mySite/myOhs
Executing delete command.
Error: OAB-7672: Unable to delete mySite/myOhs from catalog.
Cause: Nested appliance or assembly cannot be deleted.
Action: Use AbStudio (GUI) to delete nested appliances or assemblies.

A.1.15.4.2 成功した削除

$ abctl delete -name myOhs
Executing delete command.
Successfully deleted myOhs.

A.1.15.4.3 アーカイブのみの削除

$ abctl delete -name myOhs -archiveOnly

A.1.15.4.4 失敗した削除

$ abctl delete -name myOhs
Deleted metadata
Deleted File Sets
Error: Failed to delete templates.

A.1.16 deleteAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.16.1 形式

$ abctl deleteAssemblyArchive -name String [-version String] -connectionName String

A.1.16.2 説明

デプロイヤからアセンブリを削除します。この操作は、アセンブリ・アーカイブの登録がない場合にのみ実行できます。

A.1.16.3 オプション

表A-17に、deleteAssemblyArchiveのコマンド・オプションを示します。

表A-17 deleteAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

アセンブリの名前を表す文字列。

デプロイヤのアセンブリの名前。

-version

v

false

デプロイヤによって割り当てられた最新のバージョン番号。

アセンブリのバージョンを表す文字列。

デプロイヤから削除するアセンブリのバージョンを指定します。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.16.4 例

次に、コマンド例を示します。

A.1.16.4.1 アセンブリの削除

$ abctl deleteAssemblyArchive -name TheAssemblyArchive -version 1

A.1.17 deleteAssemblyInstance

このコマンドの詳細は、次のとおりです。

A.1.17.1 形式

$ abctl deleteAssemblyInstance -assemblyInstanceId String -connectionName String

A.1.17.2 説明

アセンブリ・インスタンスを削除します。

この操作は、アセンブリ・インスタンスがアンデプロイ状態の場合のみ実行できます。

A.1.17.3 オプション

表A-18に、deleteAssemblyInstanceのコマンド・オプションを示します。

表A-18 deleteAssemblyInstanceのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

d

true

なし

assemblyInstanceIdを表す文字列。

削除するアセンブリ・インスタンスの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.17.4 例

次に、コマンド例を示します。

A.1.17.4.1 アセンブリ・インスタンスの削除

$ abctl deleteAssemblyInstance -assemblyInstanceId MyId

A.1.18 deleteDeployerConnection

このコマンドの詳細は、次のとおりです。

A.1.18.1 形式

$ abctl deleteDeployerConnection [-name] String

A.1.18.2 説明

デプロイヤへの接続を削除し、接続ファイルから接続を削除します。

A.1.18.3 オプション

表A-19に、deleteDeployerConnectionのコマンド・オプションを示します。

表A-19 deleteDeployerConnectionのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

デプロイヤ接続の名前を表す文字列。

デプロイヤ接続の名前。

A.1.18.4 例

次に、コマンド例を示します。

A.1.18.4.1 デプロイヤへの接続の削除

$ abctl deleteDeployerConnection -name WLS1

A.1.19 deleteEMConnection

このコマンドの詳細は、次のとおりです。

A.1.19.1 形式

$ abctl deleteEMConnection

A.1.19.2 説明

EMソフトウェア・ライブラリへの接続を削除します。

A.1.19.3 オプション

なし。

A.1.19.4 例

次に、コマンド例を示します。

A.1.19.4.1 EM接続の削除

$ abctl deleteEMConnection

A.1.20 deleteEMAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.20.1 形式

$ abctl deleteEMAssemblyArchive -name String -version String

A.1.20.2 説明

Enterprise Managerソフトウェア・ライブラリから指定されたバージョンのアセンブリ・アーカイブを削除します。

A.1.20.3 オプション

表A-20に、deleteEMAssemblyArchiveのコマンド・オプションを示します。

表A-20 deleteEMAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

アセンブリ・アーカイブの名前

EMソフトウェア・ライブラリから削除するアセンブリ・アーカイブの名前。

-version

v

true

なし

1.0、1.2、2.0など。

EMソフトウェア・ライブラリから削除するアセンブリ・アーカイブのバージョン。

A.1.20.4 例

次に、コマンド例を示します。

A.1.20.4.1 EMアセンブリ・アーカイブの削除

% abctl deleteEMAssemblyArchive -name archiveName -version 1.2

A.1.21 deleteFailedAssemblyInstances

このコマンドの詳細は、次のとおりです。

A.1.21.1 形式

$ abctl deleteFailedApplianceInstances -applianceId String -applianceInstanceIds String... -connectionName String

A.1.21.2 説明

1つ以上の失敗状態にあるアプライアンス・インスタンスを削除します。

A.1.21.3 オプション

表A-21に、deleteFailedAssemblyInstancesのコマンド・オプションを示します。

表A-21 deleteFailedAssemblyInstancesのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-applianceId

a

true

なし

アプライアンスのIDを表す文字列。

アプライアンスのID。

-applianceInstanceIds

ai

true

なし

アプライアンスのIDを表す文字列。

削除する失敗状態にあるアプライアンス・インスタンスのID。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.21.4 例

次に、コマンド例を示します。

A.1.21.4.1 失敗したアセンブリ・インスタンスの削除

% abctl deleteFailedApplianceInstances -applianceId MyId -applianceInstanceIds MyInstanceId1

A.1.22 deleteRequests

このコマンドの詳細は、次のとおりです。

A.1.22.1 形式

$ abctl deleteRequests [-requestId String...] -connectionName String

A.1.22.2 説明

1つ以上の以前に完了したリクエストを削除します。

A.1.22.3 オプション

表A-67に、deleteRequestsのコマンド・オプションを示します。

表A-22 deleteRequestsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-requestId

d

false

なし

requestIdを表す文字列。

以前に完了したリクエストのrequestId。

A.1.22.4 例

次に、コマンド例を示します。

A.1.22.4.1 リクエストの削除

$ abctl deleteRequests

A.1.23 deleteTags

このコマンドの詳細は、次のとおりです。

A.1.23.1 形式

$ abctl deleteTags -tag String... -resource String... -connectionName String

A.1.23.2 説明

リソースの1つ以上のタグを削除します。

A.1.23.3 オプション

表A-23に、deleteTagsのコマンド・オプションを示します。

表A-23 deleteTagsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-resource

r

true

なし

タグを削除するオブジェクトのリソースIDを指定する文字列。

タグを削除する1つ以上のリソースを指定します。

-tag

t

true

なし

タグを指定する一連の名前=値のペア。

リソースから削除する1つ以上のタグを指定します。

A.1.23.4 例

次に、コマンド例を示します。

A.1.23.4.1 タグの削除

$ abctl deleteTags -tag foo -resource MyResource

A.1.24 deleteTarget

このコマンドの詳細は、次のとおりです。

A.1.24.1 形式

$ abctl deleteTarget -name String -connectionName String

A.1.24.2 説明

ターゲットおよびすべての構成情報を削除します。このターゲットが1人のユーザーまたはすべてのユーザーのデフォルトだった場合、そのデフォルトは設定解除されます。

A.1.24.3 オプション

表A-24に、deleteTargetのコマンド・オプションを示します。

表A-24 deleteTargetのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

ターゲットの名前を表す文字列。

ターゲットの名前。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.24.4 例

次に、コマンド例を示します。

A.1.24.4.1 ターゲットの削除

$ abctl deleteTarget -name MyTarget

A.1.25 deployAssemblyInstance

このコマンドの詳細は、次のとおりです。

A.1.25.1 形式

$ abctl deployAssemblyInstance -assemblyInstanceId String -connectionName String
[-waitForComplete] [-pollTime String]

A.1.25.2 説明

アセンブリ・アーカイブをデプロイします。

A.1.25.3 オプション

表A-25に、deployAssemblyInstanceのコマンド・オプションを示します。

表A-25 deployAssemblyInstanceのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

a

true

なし

assemblyInstanceIdを表す文字列。

デプロイするアセンブリ・インスタンスの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

-pollTime

pt

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

A.1.25.4 例

次に、コマンド例を示します。

A.1.25.4.1 アセンブリ・インスタンスのデプロイ

$ abctl deployAssemblyInstance -assemblyInstanceId MyId

A.1.26 describeApplianceInstances

このコマンドの詳細は、次のとおりです。

A.1.26.1 形式

$ abctl describeApplianceInstances [-assemblyInstanceId String...] [-applianceInstanceId String...] [-applianceIndex String...] -connectionName String

A.1.26.2 説明

デプロイされた1つ以上のアセンブリ・インスタンスを記述します。

A.1.26.3 オプション

表A-26に、describeApplianceInstancesのコマンド・オプションを示します。

表A-26 describeApplianceInstancesのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

as

false

なし

assemblyInstanceIdを表す文字列。

1つ以上のassemblyInstanceIds。

-applianceInstanceId

ap

false

なし

applianceIdを表す文字列。

1つ以上のapplianceIds。

-applianceIndex

ai

false

なし

instanceIdを表す文字列。

1つ以上のinstanceIds。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.26.4 例

次に、コマンド例を示します。

A.1.26.4.1 アプライアンス・インスタンスの記述

$ abctl describeApplianceInstances

A.1.27 describeAssemblyArchives

このコマンドの詳細は、次のとおりです。

A.1.27.1 形式

$ abctl describeAssemblyArchives [-assembly String...] -connectionName String

A.1.27.2 説明

デプロイヤの1つ以上のアセンブリを記述します。

A.1.27.3 オプション

表A-27に、describeAssemblyArchivesのコマンド・オプションを示します。

表A-27 describeAssemblyArchivesのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assembly

a

false

なし

記述するアセンブリのリスト。

記述するアセンブリを指定します。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.27.4 例

次に、コマンド例を示します。

A.1.27.4.1 アセンブリ・アーカイブの記述

$ abctl describeAssemblyArchives -assembly TheAssembly

A.1.28 describeAssemblyInstances

このコマンドの詳細は、次のとおりです。

A.1.28.1 形式

$ abctl describeAssemblyInstances [-assemblyInstanceId String...] -connectionName String

A.1.28.2 説明

1つ以上のアセンブリ・インスタンスを記述します。

A.1.28.3 オプション

表A-28に、describeAssemblyInstancesのコマンド・オプションを示します。

表A-28 describeAssemblyInstancesのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

a

false

なし

アセンブリ・インスタンスIDのカンマ区切りのリスト。

記述する1つ以上のアセンブリ・インスタンスの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.28.4 例

次に、コマンド例を示します。

A.1.28.4.1 アセンブリ・インスタンスの記述

$ abctl describeAssemblyInstances

A.1.29 describeAssemblyUsers

このコマンドの詳細は、次のとおりです。

A.1.29.1 形式

$ abctl describeAssemblyUsers -assembly String -connectionName String

A.1.29.2 説明

アセンブリの1人以上のユーザーを記述します。

A.1.29.3 オプション

表A-28に、describeAssemblyUsersのコマンド・オプションを示します。

表A-29 describeAssemblyUsersのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assembly

a

false

なし

アセンブリの名前を表す文字列。

ユーザーが記述されるアセンブリを指定します。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.29.4 例

次に、コマンド例を示します。

A.1.29.4.1 アセンブリ・ユーザーの記述

$ abctl describeAssemblyUsers -assembly MyAssembly

A.1.30 describeCatalog

このコマンドの詳細は、次のとおりです。

A.1.30.1 形式

$ abctl describeCatalog [[-name] String] [-long]

A.1.30.2 説明

カタログのアプライアンスおよびアセンブリをリストします。

A.1.30.3 オプション

表A-30に、describeCatalogのコマンド・オプションを示します。

表A-30 describeCatalogのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-long

l

false

該当なし

該当なし

最大、詳細で情報をリストします。互換性のためにのみ組み込まれています。

-name

n

false

なし。

アプライアンスまたはアセンブリの名前。ネストしたアプライアンスまたはアセンブリは、スラッシュ(/)を使用して参照されます。例: mySite/myOhs。

指定しない場合、カタログ内のすべてのアプライアンスおよびアセンブリが表示されます。アセンブリの名前を指定すると、アセンブリ自体に加えて、サブアプライアンスおよびサブアセンブリもリストされます。アプライアンスの名前を指定すると、そのアプライアンスのみがリストされます。

A.1.30.4 例

次に、コマンド例を示します。

A.1.30.4.1 長い形式でのカタログの記述

$ abctl describeCatalog -name myAssembly -long

A.1.31 describeDeployer

このコマンドの詳細は、次のとおりです。

A.1.31.1 形式

$ abctl describeDeployer -connectionName String

A.1.31.2 説明

デプロイヤ・インスタンスを記述します。

A.1.31.3 オプション

表A-31に、describeDeployerのコマンド・オプションを示します。

表A-31 describeDeployerのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.31.4 例

次に、コマンド例を示します。

A.1.31.4.1 デプロイヤの記述

$ abctl describeDeployer

A.1.32 describeDeployerConnections

このコマンドの詳細は、次のとおりです。

A.1.32.1 形式

$ abctl describeDeployerConnections

A.1.32.2 説明

構成されたデプロイヤ接続を記述します。

A.1.32.3 オプション

なし。

A.1.32.4 例

次に、コマンド例を示します。

A.1.32.4.1 デプロイヤ接続の記述

$ abctl describeDeployerConnections

A.1.33 describeDeploymentPlans

このコマンドの詳細は、次のとおりです。

A.1.33.1 形式

$ abctl describeDeploymentPlans [-name String] [-plan String] [-long]

A.1.33.2 説明

使用可能なデプロイメント・プランを記述します。

A.1.33.3 オプション

表A-32に、describeDeploymentPlansのコマンド・オプションを示します。

表A-32 describeDeploymentPlanのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

false

.*

任意の正規表現。

1つまたは複数のアセンブリの名前。正規表現として指定します。

-plan

p

false

.*

任意の正規表現。

1つまたは複数のプランの名前。正規表現として指定します。

-long

l

false

なし

該当なし

長いバージョンの情報が必要かどうかを示すフラグです。

A.1.33.4 例

次に、コマンド例を示します。

A.1.33.4.1 デプロイメント・プランの記述

$ abctl describeDeploymentPlans -name myAssembly -plan myPlan -long

A.1.34 describeEMAssemblyArchives

このコマンドの詳細は、次のとおりです。

A.1.34.1 形式

$ abctl describeEMAssemblyArchives [-name nameOfAssemblyArchive]

A.1.34.2 説明

EMソフトウェア・ライブラリ内のアセンブリ・アーカイブを記述します。

A.1.34.3 オプション

表A-31に、describeEMAssemblyArchivesのコマンド・オプションを示します。

表A-33 describeEMAssemblyArchivesのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

false

.*

既存のアセンブリ・アーカイブ名。

1つまたは複数のアセンブリの名前。正規表現として指定します。

A.1.34.4 例

次に、コマンド例を示します。

A.1.34.4.1 EMアセンブリ・アーカイブの記述

$ abctl describeEMAssemblyArchives [-name nameOfAssemblyArchive]

A.1.35 describeEMConnection

このコマンドの詳細は、次のとおりです。

A.1.35.1 形式

$ abctl describeEMConnection

A.1.35.2 説明

構成されたEMソフトウェア・ライブラリ接続を記述します。

A.1.35.3 オプション

なし。

A.1.35.4 例

次に、コマンド例を示します。

A.1.35.4.1 EM接続の記述

$ abctl describeEMConnection

A.1.36 describeEndpoints

このコマンドの詳細は、次のとおりです。

A.1.36.1 形式

$ abctl describeEndpoints -name String [-recurse]

A.1.36.2 説明

アプライアンスまたはアセンブリのエンドポイントをリストします。アセンブリのサブアプライアンスおよびサブアセンブリのエンドポイントをリストするには、-recurseを指定します。

A.1.36.3 オプション

表A-34に、describeEndpointsのコマンド・オプションを示します。

表A-34 describeEndpointsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし。

アプライアンスまたはアセンブリの名前。

エンドポイントをリストするアプライアンスまたはアセンブリの名前。

-recurse

r

false

該当なし

該当なし

指定すると、アセンブリ自体のエンドポイントのかわりに、アセンブリのサブ要素のエンドポイントがリストされます。

A.1.36.4 例

次に、コマンド例を示します。

A.1.36.4.1 エンドポイントの記述

$ abctl describeEndpoints -name mySite/myWls -r

A.1.37 describeRegistrations

このコマンドの詳細は、次のとおりです。

A.1.37.1 形式

$ abctl describeRegistrations [-assembly String] [-version String] -connectionName String

A.1.37.2 説明

1つ以上のアセンブリ登録を記述します。

A.1.37.3 オプション

表A-35に、describeRegistrationsのコマンド・オプションを示します。

表A-35 describeRegistrationsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assembly

a

false

なし

アセンブリの名前を表す文字列。

アセンブリの名前。

-version

v

true

なし

アセンブリのバージョンを表す文字列。

アセンブリのバージョン。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.37.4 例

次に、コマンド例を示します。

A.1.37.4.1 登録の記述

$ abctl describeRegistrations -assembly MyAssembly -version 1

A.1.38 describeRequests

このコマンドの詳細は、次のとおりです。

A.1.38.1 形式

$ abctl describeRequests [-requestId String...] -connectionName String

A.1.38.2 説明

1つ以上の以前に発行された同期リクエストを記述します。

A.1.38.3 オプション

表A-36に、describeRequestsのコマンド・オプションを示します。

表A-36 describeRequestsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-requestId

r

false

なし

requestIdを表す文字列。

以前に発行された同期リクエストのrequestId。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.38.4 例

次に、コマンド例を示します。

A.1.38.4.1 リクエストの記述

$ abctl describeRequests

A.1.39 describeScalingGroups

このコマンドの詳細は、次のとおりです。

A.1.39.1 形式

$ abctl describeScalingGroups [-assemblyInstanceId String...] [-scalingGroupId String...] -connectionName String

A.1.39.2 説明

1つ以上のスケーリング・グループを記述します。

A.1.39.3 オプション

表A-37に、describeScalingGroupsのコマンド・オプションを示します。

表A-37 describeScalingGroupsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

a

false

なし

assemblyInstanceIdを表す文字列。

以前に作成されたアセンブリ・インスタンスの識別子。

-scalingGroupId

s

true

なし

scalingGroupIdを表す文字列。

以前に作成されたスケーリング・グループの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.39.4 例

次に、コマンド例を示します。

A.1.39.4.1 スケーリング・グループの記述

$ abctl describeScalingGroups

A.1.40 describeTags

このコマンドの詳細は、次のとおりです。

A.1.40.1 形式

$ abctl describeTags -resource String [-tag String...] -connectionName String

A.1.40.2 説明

デプロイヤが保持するアーティファクトに関連付けられた1つ以上のタグを記述します。

A.1.40.3 オプション

表A-38に、describeTagsのコマンド・オプションを示します。

表A-38 describeTagsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-resource

-r

true

なし

リソースのリソースIDを指定する文字列。

タグ情報を取得するリソースを指定します。

-tag

-t

false

なし

タグの名前を表す文字列。

値を取得する1つ以上のタグを指定します。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.40.4 例

次に、コマンド例を示します。

A.1.40.4.1 タグの記述

$ abctl describeTags -tag foo -resource MyResource

A.1.41 describeTargetConfigurations

このコマンドの詳細は、次のとおりです。

A.1.41.1 形式

$ abctl describeTargetConfigurations [-target String...] -connectionName String

A.1.41.2 説明

1つ以上のターゲット構成を記述します。

A.1.41.3 オプション

表A-39に、describeDeployerのコマンド・オプションを示します。

表A-39 describeDeployerのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-target

t

false

なし

ターゲットの名前を表す文字列。

1つ以上のターゲットの名前。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.41.4 例

次に、コマンド例を示します。

A.1.41.4.1 ターゲット構成の記述

$ abctl describeTargetConfigurations -target MyTarget

A.1.42 describeTargetNames

このコマンドの詳細は、次のとおりです。

A.1.42.1 形式

$ abctl describeTargetNames -type String -connectionName String

A.1.42.2 説明

アセンブリ・インスタンス・ターゲットの1つ以上のタイプを記述します。

A.1.42.3 オプション

表A-40に、describeTargetNamesのコマンド・オプションを示します。

表A-40 describeTargetNamesのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-type

t

true

なし

ターゲットのタイプを表す文字列。使用可能な値はexalogicまたはovmです。

ターゲットのタイプ。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.42.4 例

次に、コマンド例を示します。

A.1.42.4.1 ターゲット名の記述

$ abctl describeTargetNames

A.1.43 describeTargetUsers

このコマンドの詳細は、次のとおりです。

A.1.43.1 形式

$ abctl describeTargetUsers -target String -connectionName String

A.1.43.2 説明

アセンブリ・インスタンス・ターゲットの1人以上のユーザーを記述します。

A.1.43.3 オプション

表A-41に、describeTargetUsersのコマンド・オプションを示します。

表A-41 describeTargetUsersのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-target

t

true

なし

ターゲットの名前を表す文字列。

ターゲットの名前。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.43.4 例

次に、コマンド例を示します。

A.1.43.4.1 ターゲット・ユーザーの記述

$ abctl describeTargetUsers -target MyTarget

A.1.44 describeTargets

このコマンドの詳細は、次のとおりです。

A.1.44.1 形式

$ abctl describeTargets [-target String...] -connectionName String

A.1.44.2 説明

1つ以上のデプロイメント・ターゲットに関するランタイム情報を記述します。

A.1.44.3 オプション

表A-42に、describeTargetsのコマンド・オプションを示します。

表A-42 describeTargetsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-target

t

false

なし

ターゲットの名前を表す文字列。

1つ以上のターゲットの名前。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.44.4 例

次に、コマンド例を示します。

A.1.44.4.1 ターゲットの記述

$ abctl describeTargets

A.1.45 describeUserTargets

このコマンドの詳細は、次のとおりです。

A.1.45.1 形式

$ abctl describeUserTargets -user String -connectionName String

A.1.45.2 説明

デプロイメント・ターゲットの1つ以上のタイプを記述します。

A.1.45.3 オプション

表A-43に、describeUserTargetsのコマンド・オプションを示します。

表A-43 describeUserTargetsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-user

u

true

なし

ユーザーのユーザー名を表す文字列。使用可能な値はexalogicまたはovmです。

ユーザーのユーザー名。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.45.4 例

次に、コマンド例を示します。

A.1.45.4.1 ユーザー・ターゲットの記述

$ abctl describeUserTargets -user MyUser

A.1.46 describeVnets

このコマンドの詳細は、次のとおりです。

A.1.46.1 形式

$ abctl describeVnets -target String [-id String...] -connectionName String

A.1.46.2 説明

1つ以上のネットワークを記述します。

A.1.46.3 オプション

表A-43に、describeVnetsのコマンド・オプションを示します。

表A-44 describeVnetsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-id

i

false

なし

ネットワークIDを表す文字列。

記述するネットワークID。

-target

t

true

なし

ターゲット名を表す文字列。

ネットワークを記述するターゲットの名前。

A.1.46.4 例

次に、コマンド例を示します。

A.1.46.4.1 Vnetの記述

$ abctl describeVnets

A.1.47 downloadAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.47.1 形式

$ abctl downloadAssemblyArchive -name String -version String [-fileName Path] -connectionName String

A.1.47.2 説明

デプロイヤ・リポジトリからアセンブリ・アーカイブをダウンロードします。

A.1.47.3 オプション

表A-45に、downloadAssemblyArchiveのコマンド・オプションを示します。

表A-45 downloadAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

アセンブリの名前を表す文字列。

アセンブリ・アーカイブの名前。

-version

v

true

なし

アセンブリのバージョンを表す文字列。

アセンブリ・アーカイブのバージョン。

-fileName

r

true

なし

アセンブリの新しい名前または場所(あるいはその両方)を表す文字列。

アセンブリ・アーカイブの新しい名前。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.47.4 例

次に、コマンド例を示します。

A.1.47.4.1 アセンブリ・アーカイブのダウンロード

$ abctl downloadAssemblyArchive -name MyAssembly -version 1 RenamedAssembly.ova

A.1.48 downloadAssemblyMetadata

このコマンドの詳細は、次のとおりです。

A.1.48.1 形式

$ abctl downloadAssemblyMetadata -name String -version String [-fileName Path] [-generatePlan] -connectionName String

A.1.48.2 説明

デプロイヤからアセンブリ・メタデータ記述子をダウンロードします。これにより、アーカイブ全体をダウンロードせずに、アセンブリの内容を判別できます。

A.1.48.3 オプション

表A-46に、downloadAssemblyMetadataのコマンド・オプションを示します。

表A-46 downloadOVFのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-fileName

fn

false

なし

アセンブリ・メタデータが書き込まれるファイルへの絶対パスまたは相対パス。

OVFの新しい名前。

アセンブリ・メタデータが書き込まれるファイル名。省略すると、メタデータは<assembly name>.ovfとして現行作業ディレクトリに保存されます。ファイルへの絶対パスまたは相対パスを指定できます。

-generatePlan

g

false

なし

該当なし

設定すると、デフォルトのデプロイメント・プランが生成されます。プランは、ダウンロードされたメタデータの保存場所と同じ場所に生成されます。

-name

n

true

なし

アセンブリの名前を表す文字列。

メタデータ記述子をダウンロードするアセンブリの名前。

-version

v

true

なし

アセンブリのバージョンを表す文字列。

アセンブリのバージョン。

A.1.48.4 例

次に、コマンド例を示します。

A.1.48.4.1 アセンブリ・メタデータのダウンロード

$ abctl downloadAssemblyMetadata -name MyAssembly -version 1

A.1.49 downloadEMAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.49.1 形式

$ abctl downloadEMAssemblyArchive -name String -version String [-downloadAs String] [-force]

A.1.49.2 説明

Enterprise Managerソフトウェア・ライブラリからアセンブリ・アーカイブをダウンロードし、Oracle Virtual Assembly Builder Studioカタログにインポートします。アセンブリ・アーカイブは、Oracle Virtual Assembly Builderメタデータ、ファイル・セットおよびテンプレートを作成してカタログで維持するために、リバース・エンジニアリングされます。

デフォルトでは、同じ名前のアセンブリがカタログ内にすでに存在する場合、ダウンロードは失敗します。-downloadAsオプションを使用すると、異なる名前でアセンブリをダウンロードできます。

A.1.49.3 オプション

表A-47に、downloadEMAssemblyArchiveのコマンド・オプションを示します。

表A-47 downloadEMAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

アセンブリ・アーカイブ名。

ダウンロードするアセンブリ・アーカイブの名前。

-version

v

true

なし

アセンブリ・アーカイブのバージョンを表す文字列。

Enterprise Managerソフトウェア・ライブラリからダウンロードするアセンブリ・アーカイブのバージョンを指定します。

-force

f

false

false

該当なし

設定すると、インポートされるアセンブリと同じ名前の、カタログ内の既存のアセンブリが上書きされます。

-downloadAs

false

なし

アセンブリ・アーカイブ名。

カタログ内のダウンロードされたアセンブリに割り当てる名前。

A.1.49.4 例

次に、コマンド例を示します。

A.1.49.4.1 downloadEMAssemblyArchive

% abctl downloadEMAssemblyArchive -name archiveName -version 1.0 -force -downloadAs newName

A.1.50 export

このコマンドの詳細は、次のとおりです。

A.1.50.1 形式

$ abctl export -name String -toDir Path [-quiet] [-metadataOnly]

A.1.50.2 説明

後で別のカタログにインポートできるように、アプライアンスまたはアセンブリをディスクにエクスポートします。

A.1.50.3 オプション

表A-48に、exportのコマンド・オプションを示します。

表A-48 exportのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-metadataOnly

m

false

なし

該当なし

アプライアンスまたはアセンブリのメタデータ部分のみをエクスポートすることを示します。

-name

n

true

なし

カタログ内の最上位のアプライアンスまたはアセンブリ。ネストしたアプライアンスは、エクスポートできません。

カタログ内の最上位のアプライアンスまたはアセンブリの名前。

-quiet

q

false

なし

該当なし

デフォルトでは、詳細な進捗/成功メッセージが表示されます。-quietを設定すると、詳細モードはオフになり、1つまたは2つの進捗/成功メッセージのみが表示されます。

-toDir

td

true

なし

ディレクトリへのパス。ディレクトリは空である必要があります。存在しないディレクトリは作成されます。

指定されたアプライアンスまたはアセンブリのエクスポート先となるディレクトリへのパス。相対パスを指定した場合、このパスはAB_INSTANCEを基準とします。

A.1.50.4 例

次に、コマンド例を示します。

A.1.50.4.1 標準のエクスポート

$ abctl export -name mySite -toDir /tmp/mySite.export
Executing export to /tmp/mySite.export.
Step 1 of 4: Copying from source to dest.
Copying: 100% of   52MB completed.
Copying: 100% of  690MB completed.
Copying: 100% of   86MB completed.
Copying: 100% of   405B completed.
Copying: 100% of  188MB completed.
Copying: 100% of  1024B completed.
Step 2 of 4: Copying from source to dest completed.
Step 3 of 4: Archiving temporary catalog.
Zipping: 100% of  138MB completed.
Copying: 100% of  690MB completed.
Copying: 100% of  188MB completed.
Step 4 of 4: Archiving temporary catalog completed.
Successfully exported to /tmp/mySite.export.

A.1.50.4.2 -metadataOnlyフラグを指定したエクスポート

$ abctl export -name mySite -toDir /tmp/mySite.export -metadataOnly
Executing export to /tmp/mySite.export.
Step 1 of 2: Archiving temporary catalog.
Zipping: 100% of  6163B completed.
Step 2 of 2: Archiving temporary catalog completed.
Successfully exported to /tmp/mySite.export.

A.1.50.4.3 空でないディレクトリへのエクスポート

$ abctl export -name myOhs -toDir /tmp/non-empty-dir
Executing export to /tmp/non-empty-dir.
Error: OAB-7443: Failed to export myWls to /tmp/non-empty-dir.
Caused by: OAB-09509: Directory is not empty at /tmp/non-empty-dir.
Action: Clean up the directory, or choose an empty directory.

A.1.51 getDefaultTarget

このコマンドの詳細は、次のとおりです。

A.1.51.1 形式

$ abctl getDefaultTarget -connectionName String

A.1.51.2 説明

デフォルト・ターゲットを返します。

A.1.51.3 オプション

表A-49に、getDefaultTargetのコマンド・オプションを示します。

表A-49 getDefaultTargetのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.51.4 例

次に、コマンド例を示します。

A.1.51.4.1 デフォルト・ターゲットの取得

$ abctl getDefaultTarget

A.1.52 getTargetType

このコマンドの詳細は、次のとおりです。

A.1.52.1 形式

$ abctl getTargetType -name String -connectionName String

A.1.52.2 説明

ターゲットのタイプを返します。

A.1.52.3 オプション

表A-50に、getTargetTypeのコマンド・オプションを示します。

表A-50 getTargetTypeのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

ターゲットの名前を表す文字列

ターゲットの名前。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.52.4 例

次に、コマンド例を示します。

A.1.52.4.1 ターゲット・タイプの取得

$ abctl getTargetType -name MyTarget

A.1.53 help

このコマンドの詳細は、次のとおりです。

A.1.53.1 形式

help [[-command] string] [-usage]

A.1.53.2 説明

指定されたコマンドについて、簡単なヘルプ・メッセージまたはより詳細なヘルプを出力します。

A.1.53.3 オプション

表A-51に、helpのコマンド・オプションを示します。

表A-51 helpのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-command

c

false

なし

このユーティリティの任意のコマンド。

ヘルプを出力するコマンドを指定します。

-usage

u

false

なし

該当なし

指定されたコマンドのオプションのサマリーのみを出力します。

A.1.53.4 例

次に例を示します。

A.1.53.4.1 ヘルプの出力(introspectWLSコマンドのヘルプとimportコマンドのオプションのサマリー)

abctl help, abctl help -command introspectWLS,
abctl help -usage -command import

A.1.54 import

このコマンドの詳細は、次のとおりです。

A.1.54.1 形式

$ abctl import -from Path [-quiet] [-importAs String] [-force]

A.1.54.2 説明

指定されたディレクトリからアプライアンスを、または指定されたディレクトリまたはアセンブリ・アーカイブのいずれかからアセンブリをインポートします。

A.1.54.3 オプション

表A-51に、importのコマンド・オプションを示します。

表A-52 importのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-from

fr

true

なし

アセンブリ・アーカイブ・ファイル。あるいはエクスポートされたアプライアンスまたはアセンブリを格納するディレクトリ。

有効なエクスポート場所またはアセンブリ・アーカイブ・ファイルへのパス。

-quiet

q

false

なし

該当なし

デフォルトでは、詳細な進捗/成功メッセージが表示されます。-quietを設定すると、詳細モードはオフになり、1つまたは2つの進捗/成功メッセージのみが表示されます。

-importAs

ia

false

なし

カタログ内の最上位のアプライアンスまたはアセンブリ間で一意の名前。

指定すると、インポートされたアプライアンスまたはアセンブリはカタログに指定の名前で保存されます。

-force

f

false

false

該当なし

指定すると、インポートされたアプライアンスまたはアセンブリと同じ名前を使用して、カタログ内の既存の最上位のアプライアンスまたはアセンブリが上書きされます。

A.1.54.4 例

次に、コマンド例を示します。

A.1.54.4.1 アセンブリ・アーカイブのインポート

$ abctl import -from /tmp/mySite.ova -importAs myNewSite

A.1.54.4.2 エクスポート場所からのインポート

$ abctl import -fromDir /tmp/myWls.export -importAs wls_1

A.1.55 importExternalTemplate

このコマンドの詳細は、次のとおりです。

A.1.55.1 形式

$ abctl importExternalTemplate -fromDir Path -name String -platform String [-quiet] [-skipValidation] [-force]

A.1.55.2 説明

指定されたディレクトリにある既存の仮想マシン・テンプレートを外部アプライアンスとしてカタログにインポートします。

A.1.55.3 オプション

表A-53に、importExternalTemplateのコマンド・オプションを示します。

表A-53 importExternalTemplateのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-quiet

q

false

なし

該当なし

デフォルトでは、詳細な進捗/成功メッセージが表示されます。-quietを設定すると、詳細モードはオフになり、1つまたは2つの進捗/成功メッセージのみが表示されます。

-fromDir

fd

true

なし

VMテンプレートを格納するディレクトリ。

VMテンプレートを格納するディレクトリへのパス。

-name

n

true

なし

カタログ内の最上位のアプライアンスまたはアセンブリ間で一意の名前。

設定すると、インポートされたテンプレートはターゲット・カタログに指定の名前で保存されます。

-platform

p

true

false

製品でサポートされる有効なプラットフォームを表す文字列。

インポートされた外部アプライアンスのターゲット・プラットフォーム。

-skipValidation

s

false

false

該当なし

指定すると、テンプレートをインポートする前にプラットフォーム固有の検証が実行されません。

-force

f

false

false

該当なし

指定すると、インポートされた外部アプライアンスと同じ名前を使用して、カタログ内の既存の最上位のアプライアンスまたはアセンブリが上書きされます。

A.1.55.4 例

次に、コマンド例を示します。

A.1.55.4.1 外部テンプレートのインポート

$ abctl importExternalTemplate -fromDir /my/template -name myAppliance

A.1.56 introspectCoherenceWeb

このコマンドの詳細は、次のとおりです。

A.1.56.1 形式

$ abctl introspectCoherenceWeb -wlsHome Path -domainRoot Path -adminUser String [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.56.2 説明

introspectWLSの別名です。インストールされたWebLogic Serverドメインの構成を調査し、どのファイル・セットを取得する必要があるか、およびどの構成をデプロイ時に変更する必要があるかを決定します。収集されたデータはすべて、正常完了時にカタログに格納されます。

A.1.56.3 オプション

表A-54に、introspectCoherenceWebのコマンド・オプションを示します。

表A-54 introspectCoherenceWebのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-adminUser

au

true

なし

該当なし

WebLogic Serverドメインの管理名。

-domainRoot

dr

true

なし

該当なし

WebLogic Serverドメイン・ルートへのフルパス。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

なし

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

-wlsHome

wh

true

なし

該当なし

WebLogic Serverホームへのフルパス。通常は<middleware home>/wlserver_10.3です。

A.1.56.4 例

次に、コマンド例を示します。

A.1.56.4.1 コヒーレンス・アプライアンスの基本イントロスペクション

これは、取得名のmyIntrospectionを使用した、特定のカタログに対するコヒーレンス・アプライアンスの基本イントロスペクションです。

$ abctl introspectCoherenceWeb -name myIntrospection <Coherence options>

A.1.57 introspectForms

このコマンドの詳細は、次のとおりです。

A.1.57.1 形式

introspectForms -wlsHome Path -domainRoot Path -adminUser String [-soaGlobalCP Path] [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.57.2 説明

introspectWLSの別名です。インストールされたOracle WebLogic Serverドメインの構成を調査し、どのファイル・セットを取得する必要があるか、およびどの構成をデプロイ時に変更する必要があるかを決定します。

収集されたデータはすべて、正常完了時にカタログに格納されます。

A.1.57.3 オプション

表A-55に、introspectFormsのコマンド・オプションを示します。

表A-55 introspectFormsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-adminUser

au

true

なし

該当なし

Oracle WebLogic Serverドメインの管理名。

-domainRoot

dr

true

なし

該当なし

Oracle WebLogic Serverドメイン・ルートへのフルパス。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

false

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-soaGlobalCP

sgcp

false

なし

オプションのグローバル構成プランの場所。

オプションのグローバル構成プランへの絶対パス。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

-wlsHome

wh

true

なし

WLSホーム

Oracle WebLogic Serverホームへのフルパス(通常は<middleware home>/wlserver_10.3)。

A.1.57.4 例

次に、コマンド例を示します。

A.1.57.4.1 基本イントロスペクション

Formsアプライアンスの基本イントロスペクションです。

abctl introspectForms <Forms options>

A.1.57.4.2 特定の取得名を指定したイントロスペクション

"myIntrospection"というアプライアンス/アセンブリ名で保存されたコンポーネント"Forms"のイントロスペクション。

% abctl introspectForms -name myIntrospection <Forms options>

A.1.58 introspectGenericProd

このコマンドの詳細は、次のとおりです。

A.1.58.1 形式

$ abctl introspectGenericProd -productRoots String [-propertyFile Path] [-scriptRootDir Path] [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.58.2 説明

一般に、取得する製品ディレクトリのセット、ユーザーが変更できるプロパティのセット、デプロイメント操作時にアプライアンス・インスタンスに対して実行するスクリプトのセットを入力として取ることで、製品を取得します。

A.1.58.3 オプション

表A-56に、introspectGenericProdのコマンド・オプションを示します。

表A-56 introspectGenericProdのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-productRoots

pr

true

なし

取得する製品ディレクトリのコロン区切りのリスト。

1つ以上のコロン区切りのパスのリスト。各パスは、存在するディレクトリである必要があります。指定された各ディレクトリ内のすべてのファイルおよびディレクトリがファイル・セットとして取得されます。指定されたすべてのパスは、デプロイ時にアプライアンス・インスタンスの同じ場所で使用できます。

-propertyFile

pf

true

なし

アプライアンスに追加するプロパティが含まれているプロパティ・ファイル。

propertyFileパラメータを指定する場合、読取り可能な既存のファイルを指し示す必要があります。

プロパティ・ファイルは、名前/値のペアのリストが含まれているテキスト・ファイルである必要があります。プロパティ・ファイル内の各プロパティは、ユーザー・プロパティとしてアプライアンスに追加されます。他のユーザー・プロパティと同様に、これらのプロパティは生成されたアプライアンスで編集でき、デプロイメント・プランでオーバーライドできます。

プロパティは、アプライアンス内で編集された値またはデプロイメント・プランでオーバーライドされた値を含め、デプロイ時にファイルに書き戻されます。再生成されたプロパティ・ファイルは、$AB_USERPROPS_FILEという名前の環境変数を使用して、すべてのスクリプトで実行時に使用可能になります。

これらのプロパティは、scriptRootDirパラメータを使用して取得されるスクリプトによって最終的に使用されることを目的としています。このため、プロパティ名とプロパティ値は、シェル・スクリプトによるソーシングが可能な形式である必要があります。

プロパティ・ファイルの各行はゼロ以上の行で構成され、各行はプロパティ宣言、コメントまたは空白行である必要があります。各プロパティ宣言は、変数宣言(名前=値)と同等で、指定する名前は環境変数に変換でき名前である必要があります。プロパティ宣言は、1行で記述する必要があります。行を"\"で終わると、行は継続されません。

コメントおよび空白行は、デハイドレーション時に破棄され、再構成時にファイルが再生成されたときに再作成されません。

すべてのプロパティは、アプライアンス・メタデータで"required"のマークが付けられます。値が割り当てられていない("="の後に何もない)プロパティ宣言は、アプライアンス・メタデータでnullに設定されるため、デプロイ前にそのプロパティに値を割り当てる必要があります。

プロパティ宣言では、"="の左側のどこにも空白を指定することができません。"="の右側の空白は、目的の値の一部であると見なされ、維持されます(そのため、値がソーシングされると失敗します)。

プロパティ値を囲む引用符は維持され、値の一部としてスクリプトに表示されます。プロパティ値を編集するときは、シェルの解釈ルールに従って、ユーザーが必要に応じて引用符を追加、削除、維持します。

-remoteCleanup

rc

false

なし

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-scriptRootDir

srd

false

なし

スクリプト・サブディレクトリを格納する最上位のディレクトリ。

スクリプト・ルート・ディレクトリは、スクリプト・サブディレクトリを格納する最上位のディレクトリです。指定されたディレクトリが存在しない場合または読み取ることができない場合は、エラーが返され、アプライアンスは作成されません。

スクリプトは、スクリプト・ルート・ディレクトリ内の一般的なサブディレクトリ(config.d/、start.d/、ping.d/、stop.d/)下に入れる必要があります。各サブディレクトリ下のスクリプトは、イントロスペクション時に取得され、アプライアンスに格納されます。デプロイ時に、リクエストされた操作に応じて適切なスクリプト・セットが順次実行されます。

スクリプト・ルート・ディレクトリには、一般的なサブディレクトリをすべて含める必要はなく、これらのサブディレクトリは空でもかまいません。

すべてのスクリプトはrootユーザーとして実行されるため、root権限が必要な操作の実行や、必要に応じた別のユーザーへの切替えに柔軟に対応できます。

イントロスペクション時に指定された変数が含まれるプロパティ・ファイルへのパスは、$AB_USERPROPS_FILE環境変数を使用してスクリプト実行時に使用可能になります。このファイルは、スクリプトによるソーシングが可能です。

すべてのスクリプトは、成功時にゼロの終了ステータスで終了する必要があります。ゼロ以外の終了ステータスでスクリプトが終了すると、操作は失敗します。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

A.1.58.4 例

次に、コマンド例を示します。

A.1.58.4.1 アプライアンス"GenericProd"の基本イントロスペクション

これは、取得名のmyIntrospectionを使用した、特定のカタログに対するコヒーレンス・アプライアンスの基本イントロスペクションです。

$ abctl introspectGenericProd <GenericProd options>

A.1.58.4.2 アプライアンス"GenericProd"の基本イントロスペクション

これは、"myIntrospection"というアプライアンス名またはアセンブリ名で保存された汎用アプライアンスのイントロスペクションです。

$ abctl introspectGenericProd -name myIntrospection <GenericProd options>

A.1.59 introspectOHS

このコマンドの詳細は、次のとおりです。

A.1.59.1 形式

introspectOHS -oracleInstance Path -componentName String [-name string] [-force]
[-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String]
[-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.59.2 説明

インストールされたOHSコンポーネントの構成を調査し、どのファイル・セットを取得する必要があるか、およびどの構成をデプロイ時に変更する必要があるかを決定します。収集されたデータはすべて、正常完了時にカタログに格納されます。

A.1.59.3 オプション

表A-57に、introspectOHSのコマンド・オプションを示します。

表A-57 introspectOHSのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-componentName

cn

true

なし

該当なし

イントロスペクトするOracle HTTP Serverアプライアンスの名前(例: ohs1)。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名

カタログ内で以前に使用されていない名前

イントロスペクション出力を格納するための名前を指定します。

-oracleInstance

oi

true

なし

該当なし

イントロスペクトするORACLE_INSTANCEの絶対パス。

-privateKeyFile

pkf

false

なし

秘密鍵ファイルの場所。

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

false

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

操作の実行前と同様の、sudoを実行するリモート・マシンのユーザーの名前。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

A.1.59.4 例

次に、コマンド例を示します。

A.1.59.4.1 成功したイントロスペクション

% abctl introspectOHS -name myOHS -oracleInstance /ora/inst1 -componentName ohs1
Launching introspection of appliance 'OHS' ...
Step 1 of 5: OHS introspection starting
Step 1 of 4: OHS Httpd Configuration parsed
Step 2 of 4: OHS Httpd configuration transformed
Step 3 of 4: OHS Httpd configuration processed
Step 4 of 4: OHS Httpd configuration written
Step 2 of 5: HTTPD processing completed
Step 1 of 3: OHS OPMN configuration parsed
Step 2 of 3: OHS OPMN configuration processed
Step 3 of 3: OHS OPMN configuration writtend
Step 3 of 5: OPMN XML processing completed
Step 1 of 2: OHS opmnctl script parsed
Step 2 of 2: Appliance updated with ORACLE_HOME
Step 4 of 5: OPMNCTL processing completed
Step 5 of 5: OHS introspection complete
Task is done: DehydrateJob completed
Introspection complete
Storing result in catalog: '/Oracle/IntrospectionCatalog' ...
Introspection stored as 'myohs' in the catalog
%

A.1.59.4.2 失敗したイントロスペクション

無効な-oracleInstance値

% abctl introspectOHS -oracleInstance /ora/dontexist -componentName foobar
Launching introspection of appliance 'OHS' ...
Step 1 of 5: OHS task starting
Task is done: DehydrateJob failed with error: The specified Oracle Instance does not exist.
Error: Introspection failed
Caused by: The specified Oracle Instance does not exist.
%

A.1.60 introspectOTD

このコマンドの詳細は、次のとおりです。

A.1.60.1 形式

introspectOTD -oracleHome Path -oracleInstance Path -configName String [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.60.2 説明

インストールされたOracle Traffic Director構成の構成を調査し、どのファイル・セットを取得する必要があるか、およびどの構成をデプロイ時に変更する必要があるかを決定します。収集されたデータはすべて、正常完了時にカタログに格納されます。Oracle Traffic Director管理サーバーはイントロスペクトされず、再構成時に最初から再作成されることに注意してください。

A.1.60.3 オプション

表A-58に、introspectOTDのコマンド・オプションを示します。

表A-58 introspectOTDのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-configName

cn

true

なし

Oracle Traffic Director構成の名前。

イントロスペクトする必要があるOracle Traffic Director構成の名前を指定します。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名

カタログ内で以前に使用されていない名前

イントロスペクション出力を格納するための名前を指定します。

-oracleHome

oh

true

なし

Oracle Traffic Directorがインストールされているディレクトリ。

Oracle Traffic Directorがインストールされているディレクトリへの絶対パスを指定します。

-oracleInstance

oi

true

なし

該当なし

イントロスペクトするORACLE_INSTANCEの絶対パス。

-privateKeyFile

pkf

false

なし

秘密鍵ファイルの場所。

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

false

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

操作の実行前と同様の、sudoを実行するリモート・マシンのユーザーの名前。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

A.1.60.4 例

次に、コマンド例を示します。

A.1.60.4.1 基本イントロスペクション

% abctl introspectOTD <OTD options>

A.1.60.4.2 "myIntrospection"という名前で保存されたアプライアンス"OTD"のイントロスペクション

% abctl introspectOTD -name myIntrospection <OTD options>

A.1.61 introspectRACDB

このコマンドの詳細は、次のとおりです。

A.1.61.1 形式

introspectRACDB -crsHome Path -dbHome Path [-globalDbName String] [-sysDBAUserName String] -shutdownDBOK String [-asmHome Path] [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.61.2 説明

CRSおよびRACデータベースの構成を調査し、メタデータを取得します。

A.1.61.3 オプション

表A-59に、introspectRACDBのコマンド・オプションを示します。

表A-59 introspectRACDBのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-asmHome

ch

false

なし

該当なし

ASMが記憶域タイプとして使用され、別のOracleホームにインストールされている場合、このパラメータは必須です。

-crsHome

ch

true

なし

該当なし

イントロスペクトするOracle CRSのORACLE_HOMEです。

-dbHome

dh

true

なし

該当なし

イントロスペクトするOracle RDBMSのORACLE_HOMEです。

-globalDbName

dun

false

-oracleSidに指定された値

該当なし

イントロスペクトするOracle RDBMSのグローバル・データベース名。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

なし

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-shutdownDBOK

sdbok

true

なし

該当なし

このフラグは、データベース・リブートを承認するために渡す必要があります。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sysDBAUserName

sdbaun

false

なし

該当なし

SYSDBA権限を持つデータベース・アカウント。OS認証が現在のデータベースに対して無効である場合のみ、このパラメータは必須です。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

A.1.61.4 例

次に、コマンド例を示します。

A.1.61.4.1 基本イントロスペクション

これは、単一インスタンスDBアプライアンスの基本イントロスペクションです。

abctl introspectRACDB <DB options>

A.1.61.4.2 特定の取得名を指定した、特定のカタログへのイントロスペクション

% abctl introspectRACDB -name myIntrospection <DB options>

A.1.62 introspectReports

このコマンドの詳細は、次のとおりです。

A.1.62.1 形式

introspectReports -wlsHome Path -domainRoot Path -adminUser String [-soaGlobalCP Path] [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.62.2 説明

introspectWLSの別名です。インストールされたOracle WebLogic Serverドメインの構成を調査し、どのファイル・セットを取得する必要があるか、およびどの構成をデプロイ時に変更する必要があるかを決定します。

収集されたデータはすべて、正常完了時にカタログに格納されます。

A.1.62.3 オプション

表A-62に、introspectReportsのコマンド・オプションを示します。

表A-60 introspectReportsのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-adminUser

au

true

なし

該当なし

Oracle WebLogic Serverドメインの管理名。

-domainRoot

dr

true

なし

該当なし

Oracle WebLogic Serverドメイン・ルートへのフルパス。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

false

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-soaGlobalCP

sgcp

false

なし

オプションのグローバル構成プランの場所。

オプションのグローバル構成プランへの絶対パス。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

-wlsHome

wh

true

なし

WLSホーム

Oracle WebLogic Serverホームへのフルパス(通常は<middleware home>/wlserver_10.3)。

A.1.62.4 例

次に、コマンド例を示します。

A.1.62.4.1 基本イントロスペクション

Reportsアプライアンスの基本イントロスペクションです。

abctl introspectReports <Reports options>

A.1.62.4.2 特定の取得名を指定したイントロスペクション

"myIntrospection"というアプライアンス/アセンブリ名で保存されたコンポーネント"Reports"のイントロスペクション。

% abctl introspectReports -name myIntrospection <Reports options>

A.1.63 introspectSIDB

このコマンドの詳細は、次のとおりです。

A.1.63.1 形式

introspectSIDB -dbHome Path -oracleSid String [-name String] [-force] [-noing] [-remoteHost String] [-remoteUser String] [-remoteWorkingDir Path] -shutdownDBOK String [-remoteCleanup] [-dataFileDir Path] [-flashRecoveryDir Path] [-sudoUser]

A.1.63.2 説明

単一インスタンスOracleデータベース(リリース10.2、11.1、11.2)の構成を調査し、メタデータを取得します。

A.1.63.3 オプション

表A-61に、introspectSIDBのコマンド・オプションを示します。

表A-61 introspectSIDBのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-dataFileDir

dfd

false

DBリリース10.2: <Parent directory of $ORACLE_HOME>/oradata

DBリリース11.1および11.2: $ORACLE_BASE/oradata

該当なし

データベース・ファイルのフルパス。データベース・ファイル・ディレクトリがデフォルトと異なる場合、このパラメータは必須です。

-dbHome

dh

true

なし

該当なし

イントロスペクトするOracle RDBMSのORACLE_HOMEです。

-flashRecoveryDir

frd

false

DBリリース10.2: <Parent directory of $ORACLE_HOME>/flash_recovery_area

DBリリース11.1: $ORACLE_BASE/flash_recovery_area

DBリリース11.2: $ORACLE_BASE/recovery_area

該当なし

データベース・フラッシュ・リカバリ・ファイルのフルパス。リカバリ領域がデフォルトと異なる場合、このパラメータは必須です。リカバリ領域がない場合、このパラメータを無視できます。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-oracleSid

os

true

なし

該当なし

イントロスペクトするOracle RDBMSのSID。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

なし

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-shutdownDBOK

sdbok

true

なし

該当なし

このフラグは、データベース・リブートを承認するために渡す必要があります。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

A.1.63.4 例

次に、コマンド例を示します。

A.1.63.4.1 基本イントロスペクション

これは、単一インスタンスDBアプライアンスの基本イントロスペクションです。

abctl introspectSIDB <DB options>

A.1.63.4.2 特定の取得名を指定した、特定のカタログへのイントロスペクション

% abctl introspectSIDB -name myIntrospection <DB options>

A.1.64 introspectSOA

このコマンドの詳細は、次のとおりです。

A.1.64.1 形式

introspectSOA -wlsHome Path -domainRoot Path -adminUser String [-soaGlobalCP Path] [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.64.2 説明

introspectWLSの別名です。インストールされたOracle WebLogic Serverドメインの構成を調査し、どのファイル・セットを取得する必要があるか、およびどの構成をデプロイ時に変更する必要があるかを決定します。収集されたデータはすべて、正常完了時にカタログに格納されます。

A.1.64.3 オプション

表A-62に、introspectSOAのコマンド・オプションを示します。

表A-62 introspectSOAのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-adminUser

au

true

なし

該当なし

Oracle WebLogic Serverドメインの管理名。

-domainRoot

dr

true

なし

該当なし

Oracle WebLogic Serverドメイン・ルートへのフルパス。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

false

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-soaGlobalCP

sgcp

false

なし

オプションのグローバル構成プランの場所。

オプションのグローバル構成プランへの絶対パス。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

-wlsHome

wh

true

なし

WLSホーム

Oracle WebLogic Serverホームへのフルパス(通常は<middleware home>/wlserver_10.3)。

A.1.64.4 例

次に、コマンド例を示します。

A.1.64.4.1 基本イントロスペクション

これは、単一インスタンスDBアプライアンスの基本イントロスペクションです。

abctl introspectSOA <SOA options>

A.1.64.4.2 特定の取得名を指定したイントロスペクション

% abctl introspectSOA -name myIntrospection <SOA options>

A.1.65 introspectTuxedo

このコマンドの詳細は、次のとおりです。

A.1.65.1 形式

introspectTuxedo -TUXDIR Path -TUXCONFIG Path [-environmentScript Path] [-oracleClientDir Path] [-tnsNamesLocation Path] [-artCICSAppHome Path]  [-artBatchSecurityProfile Path] [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.65.2 説明

単一または複数マシンのOracle Tuxedoドメインと、そのドメインが(アドオンも含め)存在するOracleホーム・ディレクトリを調べます。

A.1.65.3 オプション

表A-63に、introspectTuxedoのコマンド・オプションを示します。

表A-63 introspectTuxedoのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-artCICSBatchHome

acicsah

false

なし

該当なし

ART CICSアプリケーション・ホームへの絶対パス。

-artBatchSecurityProfile

absp

false

なし

該当なし

ARTバッチのsecurity_profileへの絶対パス。

-environmentScript

es

false

なし

イントロスペクトするアプリケーションの環境スクリプトへの絶対パス。

イントロスペクトするTuxedoアプリケーションの環境を設定するスクリプトへの絶対パス。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-oracleClientDir

ocd

false

なし

Oracle Database Clientソフトウェアへの絶対パス。

Oracle Database Clientソフトウェアがインストールされている場所への絶対パス。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

false

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-soaGlobalCP

sgcp

false

なし

オプションのグローバル構成プランの場所。

オプションのグローバル構成プランへの絶対パス。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

-tnsNamesLocation

tnl

false

なし

TNSNAMES.oraファイルへの絶対パス。

TNSNAMES.oraファイルの場所への絶対パス。

-TUXDIR

tuxdir

true

なし

該当なし

イントロスペクトするTUXDIRへの絶対パス。

-TUXCONFIG

tuxconfig

true

なし

該当なし

イントロスペクトするアプリケーションのTUXCONFIGファイルへの絶対パス。

A.1.65.4 例

次に、コマンド例を示します。

A.1.65.4.1 基本イントロスペクション

これは、単一インスタンスDBアプライアンスの基本イントロスペクションです。

abctl introspectTuxedo <Tuxedo options>

A.1.65.4.2 特定の取得名を指定したイントロスペクション

% abctl introspectTuxedo -name myIntrospection <Tuxedo options>

A.1.66 introspectWebCache

このコマンドの詳細は、次のとおりです。

A.1.66.1 形式

$ abctl introspectWebCache -oracleInstance Path -componentName String [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.66.2 説明

インストールされたWeb Cacheコンポーネントの構成を調査し、ファイル・セットとして取得する必要があるもの、およびデプロイ時に構成する必要があるものを記録します。収集されたデータはすべて、正常完了時にカタログに格納されます。

A.1.66.3 オプション

表A-64に、introspectWebCacheのコマンド・オプションを示します。

表A-64 introspectWebCacheのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-componentName

cn

true

なし

該当なし

イントロスペクトするWeb Cacheコンポーネントの名前。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-oracleInstance

oi

true

なし

該当なし

イントロスペクトするORACLE_INSTANCEの絶対パス。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

false

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

A.1.66.4 例

次に、コマンド例を示します。

A.1.66.4.1 イントロスペクションでカタログ内のデフォルト取得名を選択できるようにする、デフォルト・カタログに対するWeb Cacheアプライアンスの基本イントロスペクション

$  introspectWebCache <WebCache options>

A.1.66.4.2 取得名"web cache"で特定のカタログに入れられるWeb Cacheアプライアンスのイントロスペクション

abctl introspectWebCache -name webcache -oracleInstance
/oracle/instances/instance1 -componentName webcache1

Launching introspection of appliance 'WebCache' ...
Step 1 of 9: Webcache task starting
Step 9 of 9: Webcache task complete
Task is done: DehydrateJob completed
Introspection complete
Storing result in catalog ...
backup needed
Introspection stored as 'webcache' in the catalog

A.1.66.4.3 正しくないコンポーネント名を指定したイントロスペクション

abctl introspectWebCache -name webcache -oracleInstance
/bea/Oracle_WT1/instances/instance1/ -componentName webcache2
Launching introspection of appliance 'WebCache' ...
Task is done: DehydrateJob failed with error: Unable to find file: /bea/Oracle_WT1/instances/instance1/config/WebCache/webcache2/webcache.xml
Error: Introspection failed
Caused by: Unable to find file: /bea/Oracle_WT1/instances/instance1/config/WebCache/webcache2/webcache.xml

A.1.67 introspectWLS

このコマンドの詳細は、次のとおりです。

A.1.67.1 形式

introspectWLS -wlsHome Path -domainRoot Path -adminUser String [-soaGlobalCP Path] [-name String] [-force] [-skipFileSetCapture] [-remoteHost String] [-remoteUser String] [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] [-privateKeyFile Path]

A.1.67.2 説明

インストールされたWebLogic Serverコンポーネントの構成を調査し、どのファイル・セットを取得する必要があるか、およびどの構成をデプロイ時に変更する必要があるかを決定します。収集されたデータはすべて、正常完了時にカタログに格納されます。

A.1.67.3 拡張機能

CoherenceWeb、SOACoherenceおよびSOA拡張機能は、別名コマンドとして使用できます。

A.1.67.4 CoherenceWeb拡張機能の記述

コヒーレンス・クラスタおよびWebLogicドメイン構成に定義されているキャッシュ・サーバーの構成を調査および取得します。この拡張機能では、キャッシュ・サーバーが独自のプロセスで実行するプロセス外デプロイメント・トポロジがサポートされます。

A.1.67.5 SOACoherence拡張機能の記述

SOAクラスタ高可用性を有効にするための、SOA管理対象サーバー起動引数に指定されたコヒーレンス構成を調査および取得します。

A.1.67.6 SOA拡張機能の記述

Oracle SOAプラットフォームのプラグイン。インストールされたOracle WebLogic Serverドメインの構成を調査し、どのファイル・セットを取得する必要があるか、およびどの構成をデプロイ時に変更する必要があるかを決定します。

A.1.67.7 オプション

表A-65に、introspectWLSのコマンド・オプションを示します。

表A-65 introspectWLSのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-adminUser

au

true

なし

該当なし

WebLogic Serverドメインの管理名。

-domainRoot

dr

true

なし

該当なし

WebLogic Serverドメイン・ルートへのフルパス。

-force

f

false

なし

該当なし

同じ名前で存在する、カタログ内のイントロスペクションを上書きします。

-name

n

false

コンポーネント・タイプ名が接頭辞として付いた導出ディレクトリ名。

カタログ内でまだ使用されていない名前。

イントロスペクション出力を格納するための名前を指定します。

-privateKeyFile

pkf

false

なし

該当なし

ローカル・マシンのSSH秘密鍵ファイル。

-remoteCleanup

rc

false

false

該当なし

フラグをリモート・クリーンアップします。設定すると、リモート作業ディレクトリは操作後に削除されます。それ以外の場合、ディレクトリは変更されません。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-remoteHost

rh

false

なし

該当なし

ホスト名またはIPアドレスと、リモート・マシンのSSHポート(オプション)。設定する場合は、remoteUserも指定する必要があります。

-remoteUser

ru

false

なし

該当なし

リモート・マシンへのアクセスに使用するSSHユーザーの名前。設定する場合は、remoteHostも指定する必要があります。

-remoteWorkingDir

rwd

false

/tmp/abRemote_<remote user name>

該当なし

作業するリモート・マシンのパス。設定する場合は、remoteUserおよびremoteHostも指定する必要があります。

-skipFileSetCapture

sf

false

なし

該当なし

指定すると、イントロスペクション時にコンポーネントのファイル・セットは取得されません。

-soaGlobalCP

sgcp

false

なし

オプションのグローバル構成プランの場所。

オプションのグローバル構成プランへの絶対パス。

-sudoUser

su

false

なし

sudoユーザーのユーザー名。

sudoユーザーを指定します。指定すると、リモートAssembly Builderを実行する前に、ファイル・セットのリモート取得またはイントロスペクションでユーザー(sudo)をsudoユーザーとして代用します。

sudoUserを指定した場合、privateKeyFileは使用できません。つまり、sudoUserはパスワードを入力した場合のみ使用できます。

-wlsHome

wh

true

なし

WLSホーム

Oracle WebLogic Serverホームへのフルパス(通常は<middleware home>/wlserver_10.3)。

A.1.67.8 例

次に、コマンド例を示します。

A.1.67.8.1 成功したイントロスペクション

すべてのオプションを使用したローカル実行

% abctl introspectWLS -name myWlsCapture
-wlsHome /ora/mw/wlserver_10.3 -domainRoot /ora/mw/user_projects/domains/MyDomain -adminUser weblogic
Launching introspection of appliance 'WLS' ...
Step 1 of 3: WLS dehydration starting. Due to domain template creation this may take some time
Step 1 of 15: WlsAssemblyBuilder has started creating the AssemblyBuilder
Step 1 of 2: Capturing Node Manager configuration.
Step 2 of 2: Node Manager capture complete.
Step 12 of 15: Processor: 10 completed
Step 15 of 15: WlsAssemblyBuilder has completed the AssemblyBuilder
Step 2 of 3: WLS Assembly is completed
Step 3 of 3: WLS dehydration completed
Task is done: DehydrateJob completed
Introspection complete
Storing result in catalog: ...
Introspection stored as 'myWlsCapture' in the catalog
%

A.1.67.8.2 成功したイントロスペクション

すべてのデフォルトおよび短縮名を使用したローカル実行

% abctl introspectWLS -adminUser weblogic -wh /ora/mw/wlserver_10.3
-dr /ora/mw/user_projects/domains/MyDomain
Launching introspection of appliance 'WLS' ...
Step 1 of 3: WLS dehydration starting. Due to domain template creation this may take some time
Step 1 of 15: WlsAssemblyBuilder has started creating the AssemblyBuilder
Step 1 of 2: Capturing Node Manager configuration.
Step 2 of 2: Node Manager capture complete.
Step 12 of 15: Processor: 10 completed
Step 15 of 15: WlsAssemblyBuilder has completed the AssemblyBuilder
Step 2 of 3: WLS Assembly is completed
Step 3 of 3: WLS dehydration completed
Task is done: DehydrateJob completed
Introspection complete
Storing result in catalog: '/ora/ab/catalog' ...
Introspection stored as 'WLS-1256089687424' in the catalog
%

A.1.67.8.3 -wlsHomeパラメータなし

% abctl introspectWLS -domainRoot
/ora/mw/user_projects/domains/MyDomain
Error: missing required parameter 'wlsHome'

Command usage:

introspectWLS [-name string]
[-remoteHost string] [-remotePort numeric] [-remoteUser string]
[-remoteWorkingDir path] -wlsHome path -domainRoot path

Try 'abctl help -command introspectWLS' for detailed help of the command.

%

A.1.67.8.4 無効な-domainRootパス

$ abctl introspectWLS -adminUser weblogic -wlsHome /scratch/aime1/Oracle/Middleware/wlserver_10.3/ -domainRoot /tmp/foobar -name test
Enter 'Admin Password':
Launching introspection of appliance 'WLS' ...
Step 1 of 3: Started WLS dehydration (expect delays during domain template creation)..
Task is done: Dehydration failed with error: The domainRoot specified does not exist..
Error: OAB-7105: Introspection failed.
Caused by: OAB-50005: The domainRoot specified does not exist.

A.1.68 redeployAssemblyInstance

このコマンドの詳細は、次のとおりです。

A.1.68.1 形式

$ abctl redeployAssemblyInstance -assemblyInstanceId String -connectionName String [-waitForComplete] [-pollTime String]

A.1.68.2 説明

アセンブリ・インスタンスを再デプロイします。undeployAssemblyInstanceの後にdeployAssemblyInstanceを実行することと同じです。

A.1.68.3 オプション

表A-66に、redeployAssemblyInstanceのコマンド・オプションを示します。

表A-66 redeployAssemblyInstanceのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

a

true

なし

assemblyInstanceIdを表す文字列。

再デプロイするアセンブリ・インスタンスの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-pollTime

pt

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

A.1.68.4 例

次に、コマンド例を示します。

A.1.68.4.1 デプロイメントの再デプロイ

$ abctl redeployAssemblyInstance -assemblyInstanceId MyId

A.1.69 registerAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.69.1 形式

$ abctl registerAssemblyArchive -name String [-version String] [-target String] -connectionName String [-waitForComplete] [-pollTime String]

A.1.69.2 説明

デプロイヤにアセンブリ・アーカイブを登録します。

A.1.69.3 オプション

表A-67に、registerAssemblyArchiveのコマンド・オプションを示します。

表A-67 registerAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-name

n

true

なし

アセンブリ・アーカイブの名前を表す文字列。

アセンブリ・アーカイブの名前。

-pollTime

pt

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

-target

t

false

なし

ターゲットの名前を表す文字列。

ターゲットの名前。

-version

v

false

なし

アセンブリ・アーカイブのバージョンを表す文字列。

アセンブリ・アーカイブのバージョン。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

A.1.69.4 例

次に、コマンド例を示します。

A.1.69.4.1 アセンブリ・アーカイブの登録

$ abctl registerAssemblyArchive -connectionName MyDeployerConnection -name TheAssembly -version 1

A.1.70 removeAssemblyUsers

このコマンドの詳細は、次のとおりです。

A.1.70.1 形式

$ abctl removeAssemblyUsers -assembly String -user String... -connectionName String

A.1.70.2 説明

アセンブリから1人以上のユーザーを削除します。

A.1.70.3 オプション

表A-69に、removeAssemblyUsersのコマンド・オプションを示します。

表A-68 getDefaultTargetのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assembly

a

false

なし

アセンブリ・アーカイブの名前を表す文字列。

ユーザーを削除するアセンブリを指定します。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-user

u

true

なし

アセンブリ・アーカイブから削除するユーザーのユーザー名を表す文字列。

アセンブリ・アーカイブから削除するユーザーのユーザー名。

A.1.70.4 例

次に、コマンド例を示します。

A.1.70.4.1 アセンブリ・ユーザーの削除

$ abctl removeAssemblyUsers -assembly MyAssembly -user User1 User2

A.1.71 removeTargetUsers

このコマンドの詳細は、次のとおりです。

A.1.71.1 形式

$ abctl removeTargetUsers -user String... -target String -connectionName String

A.1.71.2 説明

ターゲットからユーザーを削除します。

A.1.71.3 オプション

表A-69に、removeTargetUsersのコマンド・オプションを示します。

表A-69 getDefaultTargetのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-target

t

true

なし

ユーザーの追加先となるターゲットを表す文字列。

ユーザーの追加先となるターゲット。

-user

u

true

なし

ターゲットから削除するユーザーのユーザー名を表す文字列

ターゲットから削除するユーザーのユーザー名。

A.1.71.4 例

次に、コマンド例を示します。

A.1.71.4.1 ターゲット・ユーザーの削除

$ abctl removeTargetUsers -user Username -target Targetname

A.1.72 restartAssemblyInstance

このコマンドの詳細は、次のとおりです。

A.1.72.1 形式

$ abctl restartAssemblyInstance -assemblyInstanceId String -connectionName String [-waitForComplete] [-pollTime String]

A.1.72.2 説明

アセンブリ・インスタンスを再開します。stopAssemblyInstanceの後にstartAssemblyInstanceを実行することと同じです。

A.1.72.3 オプション

表A-70に、restartAssemblyInstanceのコマンド・オプションを示します。

表A-70 restartAssemblyInstanceのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

a

true

なし

assemblyInstanceIdを表す文字列。

再開するアセンブリ・インスタンスの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-pollTime

t

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

A.1.72.4 例

次に、コマンド例を示します。

A.1.72.4.1 デプロイメントの再開

$ abctl restartAssemblyInstance -assemblyInstanceId MyId

A.1.73 scale

このコマンドの詳細は、次のとおりです。

A.1.73.1 形式

$ abctl scale -scalingGroupId String -target String -connectionName String [-waitForComplete] [-pollTime String]

A.1.73.2 説明

スケーリング・グループを新しいサイズにスケーリングします。

A.1.73.3 オプション

表A-71に、scaleのコマンド・オプションを示します。

表A-71 scaleのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-pollTime

pt

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

-scalingGroupId

s

true

なし

scalingGroupIdを表す文字列。

スケーリング・グループのscalingGroupId。

-target

t

true

なし

新しいターゲットを表す文字列。

スケーリング後の新しい値。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

A.1.73.4 例

次に、コマンド例を示します。

A.1.73.4.1 スケーリング・グループのスケーリング

$ abctl scale -scalingGroupId FOO -target 4

A.1.74 setDefaultTarget

このコマンドの詳細は、次のとおりです。

A.1.74.1 形式

$ abctl setDefaultTarget -name String -connectionName String

A.1.74.2 説明

ターゲットをデフォルトとして設定します。

A.1.74.3 オプション

表A-72に、setDefaultTargetのコマンド・オプションを示します。

表A-72 setDefaultTargetのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-name

n

true

なし

ターゲットの名前を表す文字列。

ターゲットの名前。

A.1.74.4 例

次に、コマンド例を示します。

A.1.74.4.1 デフォルト・ターゲットの設定

$ abctl setDefaultTarget -name MyTarget

A.1.75 startAssemblyInstance

このコマンドの詳細は、次のとおりです。

A.1.75.1 形式

$ abctl startAssemblyInstance -assemblyInstanceId String -connectionName String [-waitForComplete] [-pollTime String]

A.1.75.2 説明

アセンブリ・インスタンスを開始します。

A.1.75.3 オプション

表A-73に、startAssemblyInstanceのコマンド・オプションを示します。

表A-73 startAssemblyInstanceのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

a

true

なし

assemblyInstanceIdを表す文字列。

開始するアセンブリ・インスタンスの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-pollTime

pt

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

A.1.75.4 例

次に、コマンド例を示します。

A.1.75.4.1 アセンブリ・インスタンスの開始

$ abctl startAssemblyInstance

A.1.76 stopAssemblyInstance

このコマンドの詳細は、次のとおりです。

A.1.76.1 形式

$ abctl stopAssemblyInstance -assemblyInstanceId String [-force] -connectionName String [-waitForComplete] [-pollTime String]

A.1.76.2 説明

アセンブリ・インスタンスのデプロイメントを停止します。

A.1.76.3 オプション

表A-74に、stopAssemblyInstanceのコマンド・オプションを示します。

表A-74 stopAssemblyInstanceのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

a

true

なし

assemblyInstanceIdを表す文字列。

停止するアセンブリ・インスタンスの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-force

f

false

なし

true、false。

リソース・マネージャを使用できない場合でも、ローカル・クリーンアップを実行する必要があるかどうかを示すフラグ。

-pollTime

pt

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

A.1.76.4 例

次に、コマンド例を示します。

A.1.76.4.1 アセンブリ・インスタンスの停止

$ abctl stopAssemblyInstance

A.1.77 undeployAssemblyInstance

このコマンドの詳細は、次のとおりです。

A.1.77.1 形式

$ abctl undeployAssemblyInstance -assemblyInstanceId String -connectionName String [-waitForComplete] [-pollTime String]

A.1.77.2 説明

アセンブリ・インスタンスをアンデプロイします。

A.1.77.3 オプション

表A-75に、undeployAssemblyInstanceのコマンド・オプションを示します。

表A-75 undeployAssemblyInstanceのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-assemblyInstanceId

d

true

なし

assemblyInstanceIdを表す文字列。

アンデプロイするアセンブリ・インスタンスの識別子。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-pollTime

pt

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

A.1.77.4 例

次に、コマンド例を示します。

A.1.77.4.1 アセンブリ・インスタンスのアンデプロイ

$ abctl undeployAssemblyInstance -assemblyInstanceId MyId

A.1.78 unregisterAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.78.1 形式

$ abctl unregisterAssemblyArchive -name String [-version String] [-target String] -connectionName String [-waitForComplete] [-pollTime String]

A.1.78.2 説明

デプロイヤからアセンブリを登録解除します。

A.1.78.3 オプション

表A-76に、unregisterAssemblyArchiveのコマンド・オプションを示します。

表A-76 unregisterAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-name

n

true

なし

アセンブリ・アーカイブの名前を表す文字列。

アセンブリ・アーカイブの名前。

-pollTime

pt

false

5

秒数を表す文字列。

非同期操作が正常に完了するまで待機する時間を指定します。

-target

t

false

なし

ターゲットの名前を表す文字列。

ターゲットの名前。

-version

v

false

なし

アセンブリ・アーカイブのバージョンを表す文字列。

アセンブリ・アーカイブのバージョン。

-waitForComplete

w

false

no

該当なし

非同期操作が正常に完了するまで待機するかどうかを指定します。

A.1.78.4 例

次に、コマンド例を示します。

A.1.78.4.1 アセンブリ・アーカイブの登録解除

$ abctl unregisterAssemblyArchive -name TheAssembly -version 1

A.1.79 updateAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.79.1 形式

$ abctl updateAssemblyArchive -name String -version String -description String -connectionName String

A.1.79.2 説明

デプロイヤでアセンブリ・アーカイブの記述(属性)を更新します。

A.1.79.3 オプション

表A-77に、updateAssemblyArchiveのコマンド・オプションを示します。

表A-77 updateAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-description

d

true

なし

アセンブリ・アーカイブの記述を表す文字列。

アセンブリ・アーカイブの記述。

-name

n

true

なし

アセンブリ・アーカイブの名前を表す文字列。

アセンブリ・アーカイブの名前。

-version

v

true

なし

アセンブリ・アーカイブのバージョンを表す文字列。

アセンブリ・アーカイブのバージョン。

A.1.79.4 例

次に、コマンド例を示します。

A.1.79.4.1 アセンブリ・アーカイブの更新

$ abctl updateAssemblyArchive -name MyAssembly -version 1 -description NewDescription

A.1.80 updateTarget

このコマンドの詳細は、次のとおりです。

A.1.80.1 形式

$ abctl updateTarget -name String [-properties String...] -connectionName String

A.1.80.2 説明

1つ以上のプロパティ値を更新します。このコマンドは、Oracle VMのターゲットに対して有効になっており、Oracle Exalogicに対しては無効になっています。Oracle Exalogicインストールでは1つのターゲットが事前構成され、変更できません。

A.1.80.3 オプション

表A-78に、updateTargetのコマンド・オプションを示します。

表A-78 updateTargetのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-name

n

true

なし

ターゲットの名前を表す文字列。

ターゲットの名前。

-properties

p

false

なし

更新するプロパティおよび値を表す文字列。

プロパティとその新しい値を表す一連のキー=値のペア。

A.1.80.4 例

次に、コマンド例を示します。

A.1.80.4.1 ターゲットの更新

$ abctl updateTarget -name MyTarget -properties prop=newvalue

A.1.81 uploadAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.81.1 形式

$ abctl uploadAssemblyArchive -fileName Path -name String [-description String] -connectionName String

A.1.81.2 説明

Oracle Virtual Assembly Builder Deployerにアセンブリ・アーカイブをアップロードします。

A.1.81.3 オプション

表A-79に、uploadAssemblyArchiveのコマンド・オプションを示します。

表A-79 uploadAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

-fileName

fn

true

なし

ディスク上のアセンブリ・アーカイブへのファイル・パスを表す文字列。

デプロイヤにアセンブリ・アーカイブをアップロードします。

-name

n

true

なし

アセンブリ・アーカイブの名前を表す文字列。

アセンブリ・アーカイブの名前。

-description

d

false

なし

アセンブリ・アーカイブの記述を表す文字列。

アセンブリ・アーカイブの記述。

A.1.81.4 例

次に、コマンド例を示します。

A.1.81.4.1 アセンブリ・アーカイブのアップロード

$ abctl uploadAssemblyArchive -fileName=c:/mySite.ova -name TheAssembly -version 1

A.1.82 uploadAssemblyResources

このコマンドの詳細は、次のとおりです。

A.1.82.1 形式

$ abctl uploadAssemblyResources -fileName Path -assemblyName String -version String -connectionName String [-append]

A.1.82.2 説明

特定のバージョンのアセンブリに関連付けるアセンブリ・リソース・ファイルをアップロードします。リソースのzipファイルがアップロードされ、リポジトリに抽出されます。

uploadAssemblyResourcesコマンドはセキュリティ・ポリシーによって制御されます。リソース・ファイルにはスクリプトが含まれる場合と含まれない場合があります。リスース・ファイルにスクリプトが含まれていない場合は、アセンブリ・アクセス・リスト上のユーザーがコマンドを実行できます。リソース・ファイルにスクリプトが含まれている場合は、悪意のある攻撃を防止するために、コマンドを実行できるのはCloud Adminユーザーのみになります。

リソース・ファイルにスクリプトが含まれる場合、サポートされるライフサイクル名は、pre-deploy、post-deploy、deployer-pre-app-config、deployer-post-app-config、deployer-pre-vm-start、deployer-post-vm-start、deployer-pre-vm-stop、deployer-post-vm-stop、pre-undeploy、post-undeployになります。対応するスクリプト・フォルダ名を作成できます。

スクリプトを含むリソースzipファイルの例を次に示します。

unzip ../myResources.zip
Archive:  ../myResources.zip
creating: disks/
inflating: disks/test1.iso
inflating: disks/test2.iso
creating: scripts.d/
creating: scripts.d/pre-deploy.d/
inflating: scripts.d/pre-deploy.d/00script.sh
inflating: scripts.d/pre-deploy.d/01script.sh
creating: scripts.d/post-deploy.d/
inflating: scripts.d/post-deploy.d/00script.sh
inflating: scripts.d/post-deploy.d/01script.sh
creating: scripts.d/deployer-pre-vm-stop.d/
inflating: scripts.d/deployer-pre-vm-stop.d/00script.sh
inflating: scripts.d/deployer-pre-vm-stop.d/01script.sh
creating: scripts.d/post-undeploy.d/
inflating: scripts.d/post-undeploy.d/00script.sh
inflating: scripts.d/post-undeploy.d/01script.sh

A.1.82.3 オプション

表A-80に、uploadAssemblyResourcesのコマンド・オプションを示します。

表A-80 uploadAssemblyResourcesのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-fileName

fn

true

なし

ディスク上のアセンブリ・リソース・ファイルへのファイル・パスを表す文字列。

デプロイヤにアセンブリ・リソース・ファイルをアップロードします。

-assemblyName

n

true

なし

アセンブリの名前を表す文字列。

アセンブリの名前。

-version

v

false

なし

アセンブリのバージョンを表す文字列。

アセンブリのバージョン。

-append

a

false

なし

設定されると、アセンブリ・リソース・ファイルのアップロードが追加されるフラグ。

設定されると、アセンブリ・リソース・ファイルのアップロードが追加されます。

-connectionName

c

true

なし

デプロイヤへの接続の名前を表す文字列。

デプロイヤへの接続の名前。

A.1.82.4 例

次に、コマンド例を示します。

A.1.82.4.1 アセンブリ・リソース・ファイルのアップロード

$ abctl uploadAssemblyResources -assemblyName myAssembly -version 1 -fileName resources.zip -connectionName myConnection

Upload File Size: 2,708
100% Complete
Assembly resources zip has been uploaded to associate with assembly myAssembly, version 1.

A.1.83 uploadEMAssemblyArchive

このコマンドの詳細は、次のとおりです。

A.1.83.1 形式

$ abctl uploadEMAssemblyArchive -name String -[description String]

A.1.83.2 説明

Enterprise Managerソフトウェア・ライブラリにアセンブリ・アーカイブをアップロードします。アセンブリは最上位アセンブリのみで、アセンブリ・アーカイブはアセンブリに対して作成する必要があります。

A.1.83.3 オプション

表A-81に、uploadEMAssemblyArchiveのコマンド・オプションを示します。

表A-81 uploadEMAssemblyArchiveのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-name

n

true

なし

カタログ内の最上位のアプライアンスまたはアセンブリ。

カタログ内の最上位のアプライアンスまたはアセンブリの名前。

-description

d

false

なし

テキストの記述。

アセンブリおよびアセンブリ・アーカイブの記述。

A.1.83.4 例

次に、コマンド例を示します。

A.1.83.4.1 uploadEMAssemblyArchive

% abctl uploadEMAssemblyArchive -name archiveName -description "my assembly archive"

A.1.84 version

このコマンドの詳細は、次のとおりです。

A.1.84.1 形式

$ abctl version

A.1.84.2 説明

Oracle Virtual Assembly Builder仕様のバージョンを表示します。

A.1.84.3 例

$ abctl version

A.2 help

このコマンドの詳細は、次のとおりです。

A.2.1 形式

$ abctl help [-command String] [-category] [-usage]

A.2.2 説明

パラメータを指定しないと、helpコマンドは、使用可能なコマンドのリストとともに各コマンドの簡単な説明を取得するために問い合せることができるヘルプ・カテゴリのリストを表示します。

-allオプションを指定すると、helpコマンドは、すべての使用可能なコマンドを各コマンドの簡単な説明とともにリストします。コマンド名を指定すると、指定したコマンドに関する詳細なヘルプ情報が出力されます。コマンド名および-usageパラメータを指定すると、シノプシス(引数の使用方法)のみが出力されます。

-categoryオプションを指定すると、helpコマンドは、そのカテゴリ内で使用可能なコマンドをリストします。コマンドは、複数のカテゴリ内に表示されることがあります。

A.2.3 オプション

表A-82に、helpのコマンド・オプションを示します。

表A-82 helpのオプション

名前

別名

必須

デフォルト値

可能な値

説明

-command

c

false

なし

コマンドの名前。

引数なしでヘルプを呼び出したときにリストされるコマンドのうちの1つの名前。指定すると、指定コマンドに関する詳細なヘルプ情報が出力されます。

-usage

u

false

なし

-commandパラメータが指定されていない場合は無効です。このフラグを指定すると、対応する指定コマンドについてシノプシスの詳細のみが出力されます。

-category

c

false

なし

このフラグを指定すると、helpコマンドは指定されたカテゴリで使用可能なコマンドをリストします。

-quiet

q

false

なし

該当なし

デフォルトでは、詳細な進捗/成功メッセージが表示されます。-quietを設定すると、詳細モードはオフになり、1つまたは2つの進捗/成功メッセージのみが表示されます。

A.2.4 例

次に、コマンド例を示します。

A.2.4.1 引数なし

$ abctl help

Usage: abctl command [options]

Command                 Description
------------------------------------------------------------------------------
abctl help all             List all commands.abctl help catalog         Manage appliances and assemblies.abctl help deployer        Setup and manage OVAB Deployer.abctl help deployments     Deploy and manage assembly deployments.abctl help EM              Manage assemblies in EM Software Library.abctl help general         General help commands.abctl help introspection   Capture product installations.abctl help targets         Configure and manage deployment targets.

Try "abctl help -command cmd_name" for detailed help of a specific command.

A.2.4.2 コマンドのカテゴリに関するhelpの指定

$ abctl help catalog

Usage: abctl command [options]

Command                 Description
------------------------------------------------------------------------------
addToAssembly            Adds an appliance or assembly to an assembly.connectEndpoints         Create a new connection between two endpoints.createAssembly           Creates a new empty assembly.createAssemblyArchive    Creates an assembly archive.createExternalResources  Creates and connects external resources for                          unconnected outputs.createTemplate           Creates an appliance template.delete                   Deletes an appliance or assembly.describeCatalog          Lists appliances and assemblies in the catalog.describeEndpoints        Lists endpoints of an appliance or assembly.export                   Exports an appliance or assembly to disk.import                   Imports an appliance or assembly from disk.importExternalTemplate   Imports a VM template as an external appliance.

Try "abctl help <command>" for detailed help of a specific command.

A.2.4.3 -commandパラメータを指定したhelp

$ abctl help -command captureFileSets

NAME

captureFileSets

SYNOPSIS

captureFileSets -name String [-remoteHost String] [-remoteUser String] \ [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] \ [-privateKeyFile Path] [-quiet] [-force]

DESCRIPTION

Creates file sets for specified appliance or assembly.

OPTIONS

Name: remoteHost
Aliases: rh
Type: String
Required: false
Value description: String
Default value:
Possible values:
Description: Host name or IP address and optional SSH port of the remote
machine.  If specified, the remoteUser must be specified as well.

Name: remoteUser
Aliases: ru
Type: String
Required: false
Value description: String
Default value:
Possible values:
Description: Name of the SSH user to use for accessing the remote machine.  If
specified, the remoteHost must be specified as well.

...

EXAMPLES

abctl captureFileSets -name myOhs -force

A.2.4.4 -commandパラメータおよび-usageフラグを指定したhelp

$ abctl help -command captureFileSets -usage

Command usage:

captureFileSets -name String [-remoteHost String] [-remoteUser String] \ [-sudoUser String] [-remoteWorkingDir Path] [-remoteCleanup] \ [-privateKeyFile Path] [-quiet] [-force]

Try 'abctl help -command captureFileSets' for detailed help of the command.

B Oracle Virtual Assembly Builderのイントロスペクション・プラグイン

この付録では、Oracle Virtual Assembly Builderがイントロスペクトできるアプライアンスのプラグインについて説明します。

- B.1項「Oracle WebLogic Serverプラグイン」

- B.2項「Oracle Coherence*Web拡張機能」

- B.3項「Oracle Forms and Reportsの拡張機能」

- B.4項「Oracle Service Busのサポート」

- B.5項「Oracle SOAプラグイン」

- B.6項「Oracle HTTP Serverイントロスペクタのプラグイン」

- B.7項「Oracle Web Cacheプラグイン」

- B.8項「Oracle Database (SIDB)プラグイン」

- B.9項「Oracle RAC Database (RACDB)プラグイン」

- B.10項「Oracle Traffic Directorプラグイン」

- B.11項「Oracle Tuxedoプラグイン」

- B.12項「汎用アプライアンス・プラグイン」

B.1 Oracle WebLogic Serverプラグイン

Oracle WebLogic Serverのイントロスペクション・プラグインでは、単一のOracle WebLogic Serverドメインと、そのドメインが存在するOracle Middlewareホームを調べます。指定のドメインとそのミドルウェア・ホームが取得されます。

B.1.1 サポートされるバージョン

このプラグインでは、11gR1 11.1.1.2以降のリリースがサポートされます。

B.1.2 Oracle WebLogic Serverのイントロスペクション・パラメータ

表B-1に、Oracle WebLogic Serverのイントロスペクション・パラメータを示します。

表B-1 Oracle WebLogic Serverプラグインのイントロスペクション・パラメータ

パラメータ

説明

domainRoot

イントロスペクトするドメインへの完全修飾パス。これは、"config"ディレクトリを格納するディレクトリです。

wlsHome

WLSホーム・サーバー・ディレクトリへの完全修飾パス。たとえば、/u01/oracle/middleware/wlserver_10.3です。

adminUser

WLSドメインの管理ユーザー。

adminPassword

adminUserプロパティに指定された管理ユーザーのパスワード。

B.1.3 参照システムの前提条件

ドメインのAdminServerは実行されている必要があり、イントロスペクションはAdminServerが実行されているホストをターゲットにする必要があります。

B.1.4 要件

Oracle WebLogic Serverには、次の要件が適用されます。

B.1.4.1 Oracle WebLogic Serverドメインの要件

イントロスペクション対象のOracle WebLogic Serverドメインは編集できるように構成する必要があります。これにより、デプロイ時に正常に編集できるようになります。Oracle WebLogic Serverの構成の詳細は、製品ドキュメントを参照してください。

B.1.4.1.1 LDAPプロバイダの要件

参照システムでは、ファイルベースのLDAPではなく、Oracle Internet DirectoryをLDAPプロバイダとして使用することをお薦めします。ファイルベースのLDAPは、同期問題のためにデプロイされるシステムで正しく機能しない可能性があります。

B.1.4.2 Oracle WebLogic Serverのリモート・イントロスペクション用に指定するリモート・ユーザーの要件

Oracle WebLogic Serverのリモート・イントロスペクション用に指定するリモート・ユーザーは、Oracle WebLogic Serverプロセスを所有するユーザーが作成したファイルにアクセスできる必要があります。可能な場合は、指定するリモート・ユーザーはOracle WebLogic Serverプロセスを所有するユーザーと同じであることをお薦めします。

B.1.4.3 SSL証明書とホスト名検証の要件

ホスト名検証をオフにして、デモ証明書のみを使用する必要があります。

B.1.4.4 Webサービスにアクセスしてアプライアンスを更新するための要件

Oracle WebLogic Server参照システムでホストされるWebサービスにアクセスするアプリケーションごとに、新しいOracle VMホストのWebサービスWSDLにアクセスできるようにアプリケーションを更新し、Oracle WebLogic Server管理ツール(管理コンソールやwlstなど)を使用してそのアプリケーションをOracle VMのOracle WebLogic Server環境に再デプロイする必要があります。

B.1.4.5 個々のサーバーでテンプレートを作成しない要件

Oracle WebLogic Server内の個々のサーバーでテンプレートを作成しないでください。このようなテンプレートは、特定のデプロイメント・アーティファクト(コンテンツ内のドメイン・テンプレートjarおよびアセンブリ・レベルのデータ)がないため、デプロイできません。

B.1.4.6 管理対象サーバーが実行されていないときに管理URLを指定するための要件

ゲストOSのコンテキストから手動起動を実行する場合、StartManagedServer.shスクリプトを手動で変更して正しい管理サーバーURL (管理サーバーのホスト名)を指定する必要があります。これは、デフォルト管理URLに正しい値を指定するのに必要です(テンプレート作成時に管理サーバーのマシン名はわかりません)。

サーバーの起動または停止は、管理コンソールでノード・マネージャを使用すれば可能です。

B.1.5 結果のアーティファクト・タイプ

AdminServerのアプライアンスと検出されたクラスタおよび検出されたスタンドアロン(非クラスタ)の管理対象サーバーのアプライアンスが含まれる原子性アセンブリ。1つのクラスタには、そのクラスタ内の管理対象サーバーの数関係なく、1つのアプライアンスが作成されます。Oracle WebLogic Serverプラグインでは、クラスタ内のすべての管理対象サーバーが同一に構成されていると想定しています。クラスタ内のサーバーの数は、クラスタ内のサーバーの名前と同様、アプライアンス・メタデータに"スケール・アウト"情報として保存されます。

注意:

原子性アセンブリを編集して、アプライアンスを追加または削除することはできません。他のアプライアンスをOracle WebLogic Server原子性アセンブリに接続するには、非原子性アセンブリを作成し、Oracle WebLogic Serverアセンブリをその非原子性アセンブリに追加する必要があります。

B.1.6 接続

入力は、ドメイン内のサーバーがリスニングするすべてのチャネルに対してOracle WebLogic Serverアセンブリで作成されます。通常、Oracle HTTP Server出力はOracle WebLogic Server入力に接続されます。

出力は、見つかった次の構成タイプに対してOracle WebLogic Serverアセンブリで作成されます。

- JDBC

- LDAP

- JMSメッセージ・ブリッジ

- 外部JMS

これらの出力はすべて、デプロイ前に外部リソースまたはアプライアンスのいずれかに接続する必要があります。出力および出力でサポートされるプロトコルの記述からは、出力の接続先となるアプライアンスのタイプに関するヒントが与えられます。

B.1.7 接続プロパティ

すべての入力エンドポイントには、2つの編集可能なプロパティportおよびdescriptionと、1つの編集不可のプロパティprotocolsのリストがあります。protocolsは、入力に接続できる出力の種類を示します。

すべての出力エンドポイントには、1つの編集可能なプロパティdescriptionと、2つの編集不可のプロパティprotocolおよびsingletonがあります。protocolは、出力に接続できる入力の種類を示します。Singletonは、出力を接続できるアプライアンスの種類を示します。singletonがtrueの場合、出力を接続できるのは、スケーラビリティ最大絶対値が1のアプライアンスの入力のみです。

次のプロパティは、Oracle WebLogic Serverエンドポイントに固有です。

表B-2では、Oracle WebLogic Serverアプライアンスの共通入力システム・プロパティについて説明します。

表B-2 Oracle WebLogic Serverアプライアンスの共通入力システム・プロパティ

名前

型

必須

デフォルト

説明

originalBindAddresses

String

false

なし

イントロスペクトされたシステムの元のアドレス。

originalDefaultHostname

String

false

なし

イントロスペクトされたシステムの元のホスト名(例: "example.com")。

表B-3では、Oracle WebLogic Serverアプライアンスの共通入力ユーザー・プロパティについて説明します。

表B-3 Oracle WebLogic Serverアプライアンスの共通入力ユーザー・プロパティ

名前

型

必須

デフォルト

説明

keepLocalHost

Boolean

false

なし

この入力が元々ローカルホストに明示的にバインドされていた場合、このプロパティは存在し、trueに設定されます。このプロパティが存在し、値をfalseでオーバーライドしない場合は、この入力への接続を作成しないでください。

readymetric-naming-password

String

false

なし

準備完了メトリック・チェックの実行時にサーバーに対して作成された接続に使用するパスワード。

readymetric-naming-protocol

String

false

なし

準備完了メトリック・チェックに使用される接続の名前付けに指定できるオプションのプロトコル(例: "iiop")。

readymetric-naming-user

String

false

なし

準備完了メトリック・チェックの実行時にサーバーに対して作成された接続に使用するユーザー(例: "weblogic")。

readymetric-server-protocol

String

false

なし

準備完了メトリック・チェックの実行時にサーバーに対して作成された接続に使用するプロトコル(例: "iiop")。

表B-4では、管理サーバー・アプライアンスの入力システム・プロパティについて説明します。

表B-4 管理サーバー・アプライアンスの入力システム・プロパティ

名前

型

必須

デフォルト

説明

admin-password

String

true

なし

管理ユーザーのパスワード。

admin-username

String

true

なし

管理サーバーに接続するための管理ユーザー名(例: "weblogic")。

表B-5から表B-8では、管理サーバー・アプライアンスのJDBC、外部JMS、JMSメッセージ・ブリッジおよびLDAP用の出力ユーザー・プロパティについて説明します。

表B-5では、管理サーバー・アプライアンスのJDBC用の出力ユーザー・プロパティおよびシステム・プロパティについて説明します。passwordおよびusernameプロパティはユーザー・プロパティ、original-urlはシステム・プロパティです。

表B-5 管理サーバー・アプライアンスの出力プロパティ: JDBC

名前

型

必須

デフォルト

説明

password

String

false

<空>

データ・ソース接続に必要なユーザーのパスワード。

username

String

false

なし

データ・ソース接続に必要なユーザー。値は、データ・ソース接続の元のユーザーになります。

original-url

String

false

なし

イントロスペクトされたOracle WebLogic Serverドメインからの元のJDBC URL (例: "jdbc:oracle:thin:@adc2100927.example.com:1521:orcl")。

表B-6では、管理サーバー・アプライアンスの外部JMS用の出力ユーザー・プロパティについて説明します。

表B-6 管理サーバー・アプライアンスの出力プロパティ: 外部JMS

名前

型

必須

デフォルト

説明

original-connection-url

String

false

なし

外部JMSサーバーの元のURL。

表B-7では、管理サーバー・アプライアンスのJMSメッセージ・ブリッジ用の出力システム・プロパティについて説明します。

表B-7 管理サーバー・アプライアンスの出力プロパティ: JMSメッセージ・ブリッジ

名前

型

必須

デフォルト

説明

original-url

String

false

なし

JMSメッセージ・ブリッジ・サーバーの元のURL。

original-username

String

false

なし

JMSメッセージ・ブリッジ・サーバーの元のユーザー名。

original-password

String

false

なし

暗号化された、JMSメッセージ・ブリッジ・サーバーの元のパスワード。

表B-8では、管理サーバー・アプライアンスのLDAP用の出力システム・プロパティについて説明します。

表B-8 管理サーバー・アプライアンスの出力プロパティ: LDAP

名前

型

必須

デフォルト

説明

original-name

String

false

なし

LDAPセキュリティ・プロバイダの元の名前。

original-host

String

false

なし

LDAPセキュリティ・プロバイダの元のホスト。

original-port

String

false

なし

LDAPセキュリティ・プロバイダの元のポート。

original-user

String

false

なし

LDAPセキュリティ・プロバイダの元のユーザー。

B.1.8 Oracle WebLogic Serverアプライアンスのプロパティ

この項では、Oracle WebLogic Serverアプライアンスが含まれるアセンブリの次のプロパティについて説明します。これらのプロパティには、アセンブリレベルのプロパティ、各アプリケーションの入力および出力に関するプロパティ、アプライアンス自体のプロパティが含まれます。この項の内容は次のとおりです。

- B.1.8.1項「アセンブリレベルのシステム・プロパティ」

- B.1.8.2項「管理サーバーおよび管理対象サーバーのアプライアンスに共通するプロパティ」

- B.1.8.3項「管理サーバー・アプライアンスのプロパティ」

B.1.8.1 アセンブリレベルのシステム・プロパティ

表B-9では、アセンブリレベルのシステム・プロパティについて説明します。

表B-9 アセンブリレベルのシステム・プロパティ

名前

型

必須

デフォルト

説明

admin-password

String

true

なし

ドメインの管理ユーザー・パスワード。

admin-username

String

true

なし

ドメインの管理ユーザー(例: "weblogic")。

admsvr-jmx-input

String

true

なし

JMX接続の作成時に、AdminServerアプライアンスのどの入力を使用するかを示します(例: "Default")。

admsvr-jmx-protocol

String

true

なし

管理サーバーへのJMX接続の作成時に使用するプロトコル(例: "iiop")。

domain-name

String

false

なし

イントロスペクトされたドメインのドメイン名(例: "test_domain")。

usesOracleHomes

boolean

true

なし

これがコアOracle Oracle WebLogic Serverインストールではなく、OracleHomeが関連付けられていることを示します。SOAおよびWebCenterドメインの場合、これはtrueです。指定可能な値は、trueおよびfalseです。

B.1.8.2 管理サーバーおよび管理対象サーバーのアプライアンスに共通するプロパティ

次に、管理サーバーおよび管理対象サーバーのアプライアンスに共通するプロパティについて説明します。

表B-10では、Oracle WebLogic Serverアプライアンスの共通システム・プロパティについて説明します。

表B-10 Oracle WebLogic Serverアプライアンスの共通システム・プロパティ

名前

型

必須

デフォルト

説明

capture.hostname

String

true

なし

イントロスペクションが実行されたホストの名前(例: "example.com")。

capture.is64bit

boolean

true

なし

イントロスペクションが実行されたシステムが64ビット・システムであるかどうかを示します。

capture.osarch

String

true

なし

イントロスペクトされたシステムのアーキテクチャ(例: "i386")。

capture.osname

String

true

なし

イントロスペクトされたシステムのオペレーティング・システムの名前(例: "Linux")。

capture.time

String

true

なし

イントロスペクションが実行された時間(例: "1269628142430")。

domain-name

String

false

なし

イントロスペクトされたシステムのドメイン名。

admin-input-name

String

false

なし

管理サーバーの管理トラフィックに対する入力の名前。

admin-input-protocol

String

false

なし

管理サーバーへの接続時に使用するプロトコル(例: "iiop")。

isAdminserver

String

false

なし

管理サーバーの場合はtrue、それ以外の場合はfalse。

NodeManagerType

String

true

なし

作成するノード・マネージャ・マシン定義のタイプ(例: "SSL")。

server-names

String

false

なし

アプライアンスのサーバー名のリスト(例: "AdminServer")。クラスタ・アプライアンスの場合、リスト内に1つ以上のサーバー名があると考えられます。

表B-11では、Oracle WebLogic Serverアプライアンスの共通ユーザー・プロパティについて説明します。

表B-11 Oracle WebLogic Serverアプライアンスの共通ユーザー・プロパティ

名前

型

必須

デフォルト

説明

NodeManagerPort

Integer

true

5556

ノード・マネージャがリスニングするポート(例: 5556)。これは、参照システムで構成されているノード・マネージャが見つかった場合のみ存在します。

readymetric-attribute-compare-type

String

false

EQUALS

準備完了メトリックの属性値とプロパティreadymetric-attribute-valueに指定された値との間で行われる比較。

有効値は、EQUALS、LESSER_THAN、GREATER_THAN、LESSER_THAN_OR_EQUALおよびGREATER_THAN_OR_EQUALです。

readymetric-attribute-name

String

false

State

チェックするMBean属性。

readymetric-attribute-type

String

false

STRING

MBean属性の型。

有効値(ただし、調査される属性に固有)はSTRING、INTEGER、SHORT、LONG、DOUBLE、FLOATおよびBOOLEANです。

readymetric-attribute-value

String

false

RUNNING

チェックが成功とみなされるために、プロパティreadymetric-attribute-nameが保持する必要がある値。

readymetric-instance-name-0

String

false

com.bea:Name=AdminServer,Type=ServerRuntime

JMX準備完了メトリック・チェックに使用するインスタンス名。

readymetric-max-wait-period

String

false

600

準備完了メトリック・チェックの成功を待機する最大時間(秒)。

readymetric-naming-input

String

false

なし

準備完了メトリック・チェックに使用する入力(例: "Default")。

readymetric-polling-period

String

false

なし

準備完了メトリック・チェックのために接続を試行する間隔(秒)。

readymetric-server-input

String

false

なし

準備完了メトリック・チェックに使用する入力(例: "Default")。

readymetric-trust-store-0

String

false

なし

準備完了メトリック・チェックがSSL対応ポートを使用している場合に使用する信頼ストアの場所。

readymetric-type

String

false

JMX

アプライアンスに使用する準備完了メトリックのタイプ。

readymetric-verify

String

false

true

このプロパティがtrueに設定されている場合、準備完了メトリック・チェックは実行されます。それ以外の場合は省略されます。

useTemplate

String

false

OEL

アプライアンスのテンプレートの作成時にデフォルトで使用するテンプレート・タイプを指定します。

B.1.8.3 管理サーバー・アプライアンスのプロパティ

表B-12では、管理サーバー・アプライアンスのシステム・プロパティについて説明します。

表B-12 管理サーバー・アプライアンスのシステム・プロパティ

名前

型

必須

デフォルト

説明

admin-input-name

String

false

なし

管理サーバーのadmin-input-protocolへの接続に使用する入力(例: "Default")。

admin-input-protocol

String

false

なし

管理サーバーへの接続に使用するプロトコル(例: "http")。

表B-13では、管理サーバー・アプライアンスのユーザー・プロパティについて説明します。

表B-13 管理サーバー・アプライアンスのユーザー・プロパティ

名前

型

必須

デフォルト

説明

<cluster name>-cluster-address

String

false

<空>

プロパティ名の最初の部分によって指定されたクラスタのクラスタ・アドレス。

<cluster name>-frontend-host

String

false

<空>

プロパティ名の最初の部分によって指定されたクラスタのフロントエンド・ホスト。

<cluster name>-frontend-http-port

String

false

<空>

プロパティ名の最初の部分によって指定されたクラスタのセキュアでないフロントエンド・ポート。

<cluster name>-frontend-https-port

String

false

<空>

プロパティ名の最初の部分によって指定されたクラスタのセキュアなフロントエンド・ポート。

B.1.9 プラグインの拡張機能

B.2項「Oracle Coherence*Web拡張機能」およびB.3項「Oracle Forms and Reportsの拡張機能」を参照してください。

B.1.10 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.2 Oracle Coherence*Web拡張機能

Oracle Coherence*Webイントロスペクション拡張機能は、WLSイントロスペクタの機能を拡張します。また、Oracle WebLogic Serverドメインの一部として構成されたコヒーレンス・キャッシュ・クラスタおよびサーバーの構成を調べます。

B.2.1 サポートされるバージョン

このプラグイン拡張機能は、Oracle WebLogic Server 11gR1リリース11.1.1.4.0 (Coherence 3.6を含む)と連携して機能します。

B.2.2 Oracle Coherence*Webのイントロスペクション・パラメータ

Oracle WebLogic Serverで必要とするもの以外に必要な追加のパラメータはありません。

B.2.3 参照システムの前提条件

Oracle WebLogic Serverで定義するもの以外に追加の前提条件はありません。

B.2.4 要件

Oracle Coherence*Webには、次の要件があります。

B.2.4.1 デプロイメント・モデルの要件

このプラグイン拡張機能では、プロセス外デプロイメント・モデルをOracle Coherence*Webに使用する必要があります。Oracle Coherence*Webでは、ストレージ対応のキャッシュ・サーバーがOracle WebLogic Server内で実行されるのではなく、別個のプロセスとして実行されます。

B.2.4.2 カスタム・クラスタ構成ファイルを手動更新するための要件

このプラグイン拡張機能では、Oracle WebLogic ServerコンソールおよびOracle WebLogic Server MBean (WLSTを含む)を使用して定義されたOracle Coherence*Web構成を調べます。tangosol-coherence-override.xmlなどのカスタム・クラスタ構成ファイルの調査および変更は実行しません。カスタム・クラスタ構成ファイルはデプロイされる環境に渡されますが、その環境を反映するようにそれらのファイルは構成変更されません。

デプロイ後、必ずカスタム・クラスタ構成ファイルに適切な構成変更を手動で行ってください。

B.2.5 結果のアーティファクト・タイプ

このプラグイン拡張機能は、イントロスペクトされたOracle WebLogic Serverドメインに定義されているコヒーレンス・クラスタごとに、新しいアプライアンスをOracle WebLogic Server原子性アセンブリ内に作成します。

B.2.6 接続

コヒーレンス・クラスタ・アプライアンスに対して接続は実行できません。各クラスタ・アプライアンスには、ドメインのAdminServerへの固定の事前定義済接続があり、リハイドレーション時にクラスタの構成を変更するために使用されます。

B.2.7 接続

なし。

B.2.8 Oracle Coherence*Webアプライアンスのプロパティ

各Oracle Coherence*Webクラスタ・アプライアンスには、次のシステム・プロパティおよびユーザー・プロパティがあります。

表B-14では、Oracle Coherence*Webクラスタ・アプライアンスのシステム・プロパティについて説明します。

表B-14 Oracle Coherence*Webアプライアンスのシステム・プロパティ

名前

型

必須

デフォルト

説明

cache-servers

String

false

なし

クラスタに属するキャッシュ・サーバーのリスト。

targets

String

false

なし

クラスタに属するWLS管理対象サーバーのリスト。

<cacheserver>.node-manager-type

String

false

なし

前述のリストのキャッシュ・サーバーごとに、ノード・マネージャ・タイプを示すプロパティがあります。

well-known-addresses

String

false

なし

クラスタに定義されたwell-known-addressesのリスト。well-known-addressがこのクラスタに定義されていない(つまり、マルチキャストを使用している)場合、このプロパティはありません。

<wellknownaddress>.server

String

false

なし

前述のリストのwell-known-addressesごとに、Well Knownアドレスが(一致するリスニング・アドレスおよびポート情報に基づいて)マップされるキャッシュ・サーバーを示すプロパティがあります。

表B-15では、Oracle Coherence*Webクラスタ・アプライアンスのユーザー・プロパティについて説明します。

表B-15 Oracle Coherence*Webアプライアンスのユーザー・プロパティ

名前

型

必須

デフォルト

説明

<cacheserver>.node-manager-port

String

false

なし

クラスタ内のキャッシュ・サーバーごとに、ノード・マネージャ・ポートがリストされ、ユーザーはこれを変更できます。

<cacheserver>.unicast-listen-port

String

false

なし

クラスタ内のキャッシュ・サーバーごとに、そのサーバーのユニキャスト・リスニング・ポートがリストされ、ユーザーはこれを変更できます。

multicast-listen-address

String

false

なし

クラスタ全体のマルチキャスト・リスニング・アドレス。1つ以上のwell-known-addressesがリストされる(つまり、クラスタではクラスタの検出にユニキャストを使用している)場合、このマルチキャスト・プロパティはありません。

multicast-listen-port

String

false

なし

クラスタ全体のマルチキャスト・リスニング・ポート。1つ以上のwell-known-addressesがリストされる(つまり、クラスタではクラスタの検出にユニキャストを使用している)場合、このマルチキャスト・プロパティはありません。

unicast-listen-port

String

false

なし

クラスタのデフォルト・ユニキャスト・リスニング・ポート。この値は、ユニキャスト・リスニング・ポートが定義されていないキャッシュ・サーバーと、クラスタに加わるWLS管理対象サーバーで使用されます。

<wellknownaddress>.server

String

true

なし

定義されたWell Knownアドレスのいずれかをキャッシュ・サーバーと(一致するリスニング・アドレスおよびポート情報に基づいて)相互に関連付けることができない場合、そのアドレスがここにリストされ、ユーザーがWell Knownアドレスとして使用されるキャッシュ・サーバー名を指定します。このプロパティは必須です。つまり、アプライアンスのプロパティとして指定するか、デプロイメント・プランを介して指定する必要があります。

B.2.9 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.3 Oracle Forms and Reportsの拡張機能

Oracle Forms and Reportsのイントロスペクション拡張機能は、Oracle WebLogic Serverのイントロスペクション・プラグインの機能を拡張します。これらは、Forms WebLogicサーバー、Reports WebLogicサーバー、Oracle Instanceに存在するForms and Reportsのアプリケーションと構成を調べます。

B.3.1 サポートされるバージョン

これらの拡張機能は次のシナリオにおけるイントロスペクションのみをサポートしています。

- Oracle Forms and Reports 11g リリース2。

- Forms and Reportsアプリケーションがシングル・サインオンによって保護される場合は、WebGateをアクセス・クライアントとして使用するIdentity Management/Access Control ServerがサポートされるOracle Access Manager 11gリリース1 (11.1.1.5)のみ。

- Oracle Access Manager (mod_ossoをアクセス・クライアントとして使用)またはOracle Single Sign-On Server (mod_ossoをアクセス・クライアントとして使用)がサポートされていない場合。

B.3.2 イントロスペクション・パラメータ

Oracle WebLogic Serverで必要とするもの以外に必要な追加のパラメータはありません。

B.3.3 参照システムの前提条件

前述のOracle WebLogic Serverプラグインに対する参照システムの要件に加え、次のような空のファイルを参照システムに作成します。

- $ORACLE_HOME/precomp/public/bnddsc.for

- $ORACLE_HOME/precomp/public/oraca.for

- $ORACLE_HOME/precomp/public/seldsc.for

- $ORACLE_HOME/precomp/public/sqlca.for

注意:

$ORACLE_HOMEはForms and Report Oracleホームを参照します。

B.3.3.1 パートナ・アプリケーション登録ユーティリティの追加(別のノードのWeb層)

参照システムへのForms and Reportsインストール用に別のノードにWeb層を設定した場合、Web層のノードでイントロスペクションを実行する前に、パートナ・アプリケーション登録ユーティリティ(rreg-toolkit.jar)を、Forms and Reportsのインストール場所(ORACLE_HOME/oam/server/rreg/clientディレクトリ)からWeb層のORACLE_HOME/oam/server/rreg/clientディレクトリにコピーします。

B.3.4 要件

前述のOracle WebLogic Serverプラグインに対する要件に加え、次の要件が満たされている必要があります。

B.3.4.1 管理対象サーバーの要件

イントロスペクションを開始する前に、Forms and Reports管理対象サーバーが起動および実行されている必要があります。

B.3.4.2 サポートされているトポロジ

Forms and Reportsの拡張機能は次のトポロジをサポートします。

- 管理サーバーが調査および取得されるのと同じマシンにある、Forms and Reports管理対象サーバー(スタンドアロンまたはクラスタの一部)のみ。

- 「クラスタを開く」構成シナリオの場合、cluster_formsクラスタ内に複数の管理対象サーバーが存在する参照システムでは、WLS_FORMS管理対象サーバーの構成が、仮想デプロイ環境にあるすべてのForms管理対象サーバーにレプリケートされます。同様に、WLS_REPORTS管理対象サーバーの構成が、仮想デプロイ環境にあるすべてのReports管理対象サーバーにレプリケートされます。

B.3.4.3 サポートされていないトポロジ

Forms and Reports拡張機能は次のトポロジをサポートしません。

- リモートのForms and Reports管理対象サーバーのイントロスペクション: 管理サーバーのマシンとは別のマシンで作成されたサーバー

- 「リモートによるドメインの拡張」構成シナリオで作成されたForms and Reports管理対象サーバー: ドメインがあらかじめ存在しており、「ドメインの拡張」構成シナリオでFormsまたはReports管理対象サーバーが管理サーバーとは別のマシンに後から追加された場合

B.3.4.4 デプロイされたアセンブリのスケール・アウトをサポートするための要件

アセンブリのデプロイ後、"スケール"操作によって、新しい管理対象サーバーをForms and Reports WLSクラスタに追加できます。ただし、クラスタは"max"スケーラビリティ・プロパティまでしかスケール・アウトできません。これは、イントロスペクション時に参照システム内のクラスタに存在した管理対象サーバーの数に制限されています。将来的なスケール・アウトを判断するためには、参照システム内で、WLSドメインをイントロスペクトする前に、WLS管理コンソールまたはWLSTを使用して、追加の管理対象サーバーをFormsクラスタ(cluster_forms)およびReportsクラスタ(cluster_reports)に一時的に追加する必要があります。

これらの追加の管理対象サーバーは、マシンとして割り当てたり、参照システム内で起動および実行したりする必要はありません。アセンブリの作成後、これらの一時的な管理対象サーバーは参照システムから削除できます。デプロイする必要があるForms and Reports管理対象サーバーの実際の数は、cluster_forms WLSアプライアンスの"target"スケーラビリティ・プロパティを使用して制御できます。スケーラビリティ・プロパティの詳細は、表B-44「インスタンス・アプライアンスのスケーラビリティ・プロパティ」を参照してください。

B.3.4.5 Oracle HTTP Server to Reportsクラスタ構成要件

参照システムでは、Reports管理対象サーバーがWebLogicクラスタ(cluster_reports)の一部であり、Oracle HTTP Serverがフロントエンドになっている場合、Oracle HTTP Server to Reports管理対象サーバーのルーティングにWebLogicClusterディレクティブが使用されていることを確認します。デフォルトでは、WebLogicHostおよびWebLogicPortディレクティブを使用して構成されています。次のファイルを変更して、WebLogicClusterディレクティブのエントリを追加し、WebLogicHostおよびWebLogicPortディレクティブをコメント・アウトします。

$ORACLE_INSTANCE/config/OHS/<ohs_name>/moduleconf/reports_ohs.conf

たとえば、次のようにします。

#mod_weblogic related entry
#<IfModule mod_weblogic.c>
<Location /reports>
SetHandler weblogic-handler

# Add this line:
WebLogicCluster machine1.domain:port1,machine2.domain:port2

# Comment following two entries
# WebLogicHost machine1.domain
# WebLogicPort port1
</Location>
#</IfModule>

B.3.4.6 tnsnames.ora

作成されるすべてのアセンブリ内に参照システム上のtnsnames.oraファイルが含まれます。また、このファイル内で参照されるデータベース(およびそれらのホスト・マシン)は、デプロイされるアセンブリの一部としてデプロイされるtnsnames.ora内でも参照されます。つまり、一般的に、アセンブリ作成前には参照システムからのtnsnames.oraファイルは空であるか削除される必要があります。特に、アセンブリがサード・パーティに出荷される場合には注意が必要です(これらのデータベースやマシンは新しい環境には存在しないため)。こうしたケースでは、ユーザーはデプロイメント後に、必要なデータベース・エントリをForms and Reports仮想ノード上のファイルに追加する必要があります。

B.3.5 結果のアーティファクト・タイプ

イントロスペクトされたWebLogic Serverドメイン内の、Forms and Reportsクラスタと、スタンドアロンの(クラスタ化されていない)管理対象サーバーのそれぞれに対して、Forms and Reports拡張機能は、原子性のOracle WebLogic Serverアセンブリ内に新しいアプライアンスを作成します。

B.3.6 接続

アプライアンスは次のように接続されます。

B.3.6.1 Oracle HTTP ServerアプライアンスからForms and Reports WLSアプライアンスへの接続

Oracle HTTP Serverが参照システム上に構成されている場合、接頭辞"wls-"が付いた1つ以上のアプライアンス出力がOracle HTTP Serverアプライアンス上に作成されます。説明プロパティ"loc=/forms"を含むアプライアンス出力を原子性WLSアセンブリ内のFormsアプライアンスに接続し、同様に、説明プロパティ"loc=/reports"を含むアプライアンス出力を原子性WLSアセンブリ内のReportsアプライアンスに接続します。

B.3.6.2 Forms and Reports WLSアプライアンスからOracle Internet Directory外部リソースへの接続

参照システムで、Forms and Reports管理対象サーバーが、Oracle Internet Directoryサーバーによって、シングル・サインオン保護によるForms and Reportsアプリケーションの実行をサポートするように構成されている場合、"OIDConnection"という名前のアプライアンス出力がForms and Reportsアプライアンス上に作成されます。

このアプライアンス出力の外部リソースを作成し、B.3.7項「プロパティの接続」で説明するプロパティを入力します。Forms and Reportsが同じアセンブリの一部である場合は、同じ外部リソースを使用してOracle Internet Directoryサーバーを表します。

B.6.7.1項「Oracle Access Manager管理サーバー」に記載されているOracle HTTP ServerとOAM Serverの接続も参照してください。

B.3.6.3 ReportsアプライアンスからOracle Databaseへの接続

Reports WLSクラスタを参照システム内で構成した場合は、"job_repos_db"という名前のアプライアンス出力がReportsクラスタ・アプライアンス(cluster_reports)上に作成されます。この出力を、Oracle Databaseアプライアンスか、必要なReportsジョブ・データベース・スキーマ(このスキーマの詳細は、Oracle Reportsのドキュメントを参照)を含むOracle Databaseを表す外部リソースに接続し、B.3.7項「プロパティの接続」で定義されているプロパティを入力する必要があります。

B.3.7 接続プロパティ

Oracle Internet Directoryサーバーを表す外部リソース(B.3.6.2項「Forms and Reports WLSアプライアンスからOracle Internet Directory外部リソースへの接続」を参照)には、次のプロパティを設定する必要があります。

表B-16 Oracle Internet Directory外部リソースのプロパティ

名前

型

必須

デフォルト

説明

UseOID

Boolean

true

true

仮想デプロイメントでFormsからOIDへの接続を構成するかどうかを決定します。参照システムがForms-OID/Reports-OID構成で設定されている場合は、このプロパティをtrueに設定します。このプロパティをfalseに設定すると、仮想デプロイメントでForms-OID/Reports-OID構成が無効になります。このプロパティをtrueに設定した場合は、この表にリストされている残りのプロパティも設定します。

Host

String

true

なし

OIDサーバーのホスト名。

Port

Integer

true

なし

OIDサーバーのポート番号。

OID_UserDn

Boolean

true

なし

OIDサーバー管理者のユーザー名(通常はorcladmin)。

OID_Password

String

true

なし

OIDサーバー管理者のパスワード。

sslConnection

Boolean

true

false

OIDサーバーとのSSL接続を確立するかどうかを示します。このプロパティをtrueに設定した場合は、PortプロパティにOIDサーバーのSSLポート番号を指定する必要があります。

注意:

デプロイ環境でデフォルトのForms and Reportsアプリケーションに対してSingle-Sign-On (SSO)保護を有効にする場合は、表B-25に示すように、/reports/rwservlet/*,/forms/frmservlet?*oamMode=true*という値を、OHSアプライアンスのwebgate.protectedResourcesListユーザー・プロパティに追加します。

注意:

表B-16に示したUseOIDプロパティをfalseに設定した場合、つまり、デプロイされたインスタンスでForms and ReportsアプリケーションのSign-Sign-On保護を有効にしない場合には、表B-25に示すように、/reports/rwservlet/*,/forms/frmservlet?*oamMode=true*という値を、OHSアプライアンスのwebgate.protectedResourcesListユーザー・プロパティから必ず削除してください。

Reportsアプライアンスのみに適用される事項として、Oracle Databaseアプライアンスか、必要なReportsジョブ・データベース・スキーマを含むOracle Databaseを表す外部リソースに対して、次のプロパティを設定する必要があります。

表B-17 Oracle Databaseアプライアンスのプロパティ

名前

型

必須

デフォルト

説明

global-db-name

String

true

なし

Oracle DatabaseのOracleシステム識別子(SID)。入力エンドポイントで定義されるプロパティ。

port

Integer

true

なし

Oracle Databaseリスナーのポート番号。入力エンドポイントで定義されるプロパティ。

表B-18 Oracle Database外部リソースのプロパティ

名前

型

必須

デフォルト

説明

hostname

String

true

なし

Oracle Databaseのホスト名。アプライアンス・レベルで定義されるプロパティ。

global-db-name

String

true

なし

Oracle DatabaseのOracleシステム識別子(SID)。入力エンドポイントで定義されるプロパティ。

port

String

true

なし

Oracle Databaseリスナーのポート番号。入力エンドポイントで定義されるプロパティ。

表B-19 Reportsアプライアンスの出力プロパティ: job_repos_db

名前

型

必須

デフォルト

説明

username

String

true

なし

データベース接続に必要なユーザー。

password

String

true

<空>

データベース接続に必要なユーザーのパスワード。

address-name

String

true

なし

tnsnames.oraファイルに渡されるデータベース・アドレス/サービス名(myProdDbなど)。

B.3.8 Oracle Forms and Reportsアプライアンスのプロパティ

Oracle WebLogic Serverアプライアンスと同じです。

(Reportsのみ) Reportsクラスタに対して参照システムが有効化されている場合、デプロイメント・プランでは次のプロパティを指定します。

wlsAssembly -->FileSets -> reportsClusterSharedDir

これは、VMのマウント先の共有のNFSディレクトリで、Oracle Reports共有キャッシュ用の共有ディレクトリの場所です。

B.4 Oracle Service Busのサポート

Oracle Serviceのサポートは、Oracle WebLogic Serverプラグインを介して提供されます。そのための別のプラグインはありません。Oracle WebLogic Serverプラグインを使用して、Oracle Service Busが構成されるOracle WebLogic Serverドメインをイントロスペクトできます。

B.4.1 サポートされるバージョン

このプラグインでは、リリース11gR1 11.1.1.6がサポートされます。

B.4.2 Oracle Service Busのイントロスペクション・パラメータ

Oracle WebLogic Serverで必要とするもの以外に必要な追加のパラメータはありません。

B.4.3 参照システムの前提条件

Oracle WebLogic Serverで定義するもの以外に追加の前提条件はありません。

B.4.4 要件

Oracle Service Busが含まれるOracle WebLogic Serverドメインには、次の要件が適用されます。

B.4.4.1 サポートされるドメイン

サポートされるOSBドメインは、単一サーバー、つまりOracle Service BusおよびSOAが入っている、またはOracle Service BusとSOAが別個のクラスタの1つの管理対象サーバーがある場所です。

B.4.4.2 構成アーカイブの要件

イントロスペクションを容易にするにはドメイン・セキュリティ構成を変更する必要があるため、構成アーカイブをオンにします。また、WebLogic Serverで構成バックアップをオンにすることをお薦めします。構成バックアップの詳細は、WebLogic Serverドキュメントを参照してください。

B.4.4.3 参照ドメインからのOSBアーティファクトのエクスポートおよび必要に応じた削除

OSBアーティファクトは、イントロスペクション前にエクスポートすることをお薦めします。必要に応じて、削除することもできます。

B.4.4.4 ドメイン・ディレクトリからのテンプレート・ファイルの削除

ドメインのイントロスペクションおよびファイル・セットの取得前に、ドメイン・ディレクトリ下のすべての一時ファイルをクリーンアップできます。OVABでは、WebLogicパック・ユーティリティを使用して参照ドメインからドメイン・ディレクトリをアーカイブします。名前に"\"が含まれるファイルは、パック・ユーティリティで処理できません。このようなファイルは、イントロスペクション前に手動で削除する必要があります。

B.4.4.5 アセンブリ・デプロイ後の要件

次に、デプロイ後の要件を示します。

B.4.4.5.1 OSBアーティファクトのインポート

OSBアセンブリ・インスタンスが正常にデプロイされると、アセンブリの作成を開始する前に、エクスポートおよび必要に応じて削除したOSBアーティファクトをインポートできます。

構成変更用に新しいセッションを作成し、以前に保存したOSBアーティファクトをインポートします。OSBアーティファクトが正常にインポートされると、セッションをアクティブ化できます。

B.4.4.5.2 カスタマイズの適用

エンドポイントURLによっては、ネットワーク構成が異なるため、デプロイされたVMでのカスタマイズが必要な場合があります。アセンブリ・インスタンス用にカスタマイズ・ファイルを作成し、必要な変更を行った後にカスタマイズを実行できます。

構成変更用に新しいセッションを作成し、OSBコンソールを使用してカスタマイズを適用します。カスタマイズの実行後、変更セッションをアクティブ化できます。

B.4.5 結果のアーティファクト・タイプ

Oracle WebLogic Serverプラグインの場合と同じです。

B.4.6 接続

Oracle WebLogic Serverプラグインの場合と同じです。

B.4.7 接続プロパティ

Oracle WebLogic Serverプラグインの場合と同じです。

B.4.8 Oracle Service Busアプライアンスのプロパティ

Oracle WebLogic Serverプラグインの場合と同じです。

B.4.9 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.5 Oracle SOAプラグイン

Oracle SOAのイントロスペクション・プラグインは、既存のSOA WebLogic Serverデプロイメントをイントロスペクトし、SOAドメイン内のすべての構成とともに、MDS内のコンテナ構成およびデプロイされたコンポジットを取得します。

SOAプラグインを使用すると、ターゲット環境でデプロイされたコンポジットの構成プランを実行できるようになります。

B.5.1 サポートされるバージョン

このプラグインでは、リリース11gR1 11.1.1.6がサポートされます。

B.5.2 Oracle SOAサービス・エンジン構成

SOAプラグインでは、プロパティ・マッピング・ファイルを使用して、構成要素をBeanプロパティにマップします。プロパティ・マッピング・ファイルのプロパティごとに、ユーザー・プロパティが管理アプライアンスで作成されます。これらのマッピング・ファイルは、/configのsoa-plugin.jarに格納されます。各マッピング・ファイルは、命名規則によって対応するサービス・エンジン構成ファイルに関連付けられます。各マッピング・ファイルでは、構成ファイル名の".xml"の直前に"-mappings"が追加されます。たとえば、サービス・エンジン構成ファイル"bpel-config.xml"の場合、関連付けられるプロパティ・マッピング・ファイルは"bpel-config-mappings.xml"です。

各プロパティ・マッピング・ファイルの構造は、次のとおりです。

例B-1 SOAプラグインで使用されるプロパティ・マッピング・ファイル

<property-mappings>
<prefix>soa.bpel</prefix>
<persistence-bean>oracle.soa.management.config.bpel.BPELConfig</persistence-bean>

<property name="my-property">
<bean property="myProperty" type="int"/>
</property>
<property name="my-nested-property">
<bean property="nestedObject.myProperty" type="string"/>
</property>
...
</property-mappings>

表B-20では、プロパティ・マッピング・ファイルの要素について説明します。

表B-20 SOA WebLogic Server: プロパティ・マッピング・ファイルの要素

パラメータ

説明

prefix

ファイルの各プロパティに追加する接頭辞。

persistence-bean

プロパティ値の設定/取得に使用されるBean。Beanでは、サービス・エンジン構成ファイルに対する読取り/書込みに任意の方式を使用できます。すべての永続性Beanでは、永続性にJAXBを現在使用しています。

property

プロパティに関する情報が含まれます。

property.name

エンドユーザーに表示されるプロパティの名前。この名前には、前述のprefixによって接頭辞が付けられます。

bean

このユーザー・プロパティがマップされるBeanプロパティに関する情報が含まれます。

bean.property

Beanのプロパティ名。この名前は、setter名/getter名の特定に使用されます。location="myProperty"が指定されているプロパティの場合、getter名はgetMyProperty、setter名はsetMyPropertyです。

boolean型の場合、"isMyProperty"および"hasMyProperty"も試行されます。Beanのプロパティがネストしたオブジェクトにある場合、notation location="nestedObject.myProperty"を使用して指定できます。この場合、"getNestedObject()"は永続性Beanでコールされ、その結果"getMyProperty()"がコールされます。

bean.type

Beanのプロパティの型。string、int、long、float、double、booleanのいずれかにする必要があります。

B.5.3 Oracle SOAアプリケーション構成

アプリケーション・スコープの構成は、コンポジット・アプリケーションにスコープ指定された構成です。SOAプラグインは、アセンブリの作成時にターゲット環境用に更新できるユーザー・プロパティとしてアプリケーション構成を公開します。アプリケーション構成では、SOA構成プランによって公開される構成がサポートされます。

次のタイプのアプリケーション構成がサポートされます。

- SOAコンポジット・アプリケーション・ファイル(composite.xml)内のすべてのコンポジット、サービス・コンポーネント、参照およびバインディング・プロパティ

- バインディング用の属性値(例: binding.wsの場所)

- WSDLファイル内のインポートのschemaLocation属性

- WSDLファイル内のインクルードのlocation属性

- XSDファイル内のインクルード、インポートおよび再定義のschemaLocation属性

- JCAアダプタ・ファイル内のすべてのプロパティ

- 次のポリシー参照を変更および追加します。

- サービス・コンポーネント

- サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネント

サポートされる構成の詳細は、Oracle SOA構成プランを参照してください。

SOAプラグインのイントロスペクション時に、構成プランの各コンポジットをチェックします。構成プランが存在しない場合、デフォルト構成プランがコンポジットに対して生成されます。

プラグインでは、構成プランを解析し、構成プラン内の各要素をユーザー・プロパティとしてOracle Virtual Assembly Builderで公開します。構成プランは、階層データが含まれるXMLドキュメントです。

B.5.3.1 構成プランのユーザー・プロパティ

ユーザー・プロパティのキーは、XML階層のレベルをピリオド(.)で分ける"ドット"表記法を使用してエンコードされます。これは、パス・トークンまたはトークンと呼ばれます。一意に要素を識別する、属性を持つ要素(nameなど)は、トークンに組み込まれ、アンダースコア(_)で要素タイプと分けられます。

"_"の後のトークン部分は、"トークンID"と呼ばれます。各トークン・タイプ(コンポジットやサービスなど)には、トークンIDを構成するものに関するルールがあります。構成プランのすべてのプロパティは、例B-2に示すようにsoa.cpで始まり、早い段階で特定できるようになっています。

例B-2 SOAプラグインで使用される構成プラン

<composite name="HelloWorldProject">
<service name="helloworldbpel_client_ep">
<binding type="ws">
<attribute name="port">
<replace>http://xmlns.oracle.com/myPort</replace>
</attribute>
</binding>
</service>
</composite>

関連付けられたユーザー・プロパティは、次のとおりです。

soa.cp.composite_ HelloWorldProject_1-1.service_ helloworldbpel_client_ep.binding_ws.attribute_port

このXMLコード例では、1つの構成要素、属性"port"があります。コンポジット、サービス、バインディングおよび属性のトークンにはそれぞれトークンIDがあります。コンポジットの場合、トークンIDはname属性およびコンポジット・バージョンです。バインディング要素の場合、それはバインディング・タイプです。

次に、構成プラン要素と、関連付けられたパス・トークンをトークンIDルールとともに示します。

表B-21では、構成プランの要素について説明します。

表B-21 SOA WebLogic Server: 構成プランの要素

要素

パス・トークン

Composite

composite_<コンポジット名>_<ピリオド(.)をハイフン(-)で置き換えたコンポジット・バージョン>

Service

service_<サービス名>

Reference

reference_<参照名>

Import

import_<生成されたID>

Property

property_<プロパティ名>

Component

component_<コンポーネント名>

Attribute

attribute_<属性名>

Binding

binding_<バインディング・タイプ>

SearchReplace

SearchReplaceにはトークンがありません。SearchトークンとReplaceトークンを参照してください。

Search

search_<生成されたID>

Replace

replace_<生成されたID>

PolicyReference

PolicyReference_<生成されたID>

Callback

callback (構成ファイル・プランで現在使用できるのは、要素ごとに1つのみです。トークンIDはありません。)

OverrideProperty

OverrideProperty_<オーバーライド・プロパティ名>

WsdlAndSchema

wsdlAndSchema_<wsdlAndSchema名>

B.5.3.2 外部参照

コンポジット構成には、外部リソースへの参照が含まれることがあります。たとえば、場所が指定されるWebサービス参照バインディングやインポートがあります。これらの外部参照はターゲット環境用に更新できます。外部参照の場合、"search"プロパティのみが解析されます。外部参照が含まれるsearchプロパティの場合、replace値は、URLのprotocol://host:port部分を<#Output::output-name#>形式のトークンで置換したsearch値です。これにより、そのユーザー・プロパティと適切なアセンブリ出力は相互に関連付けられます。

構成プランを使用してコンポジットがデプロイされると、コンポジット内の構成アーティファクトは構成プランに基づいて変更されます。このため、構成プランを使用してコンポジットをステージング環境にデプロイし、後でステージング環境をイントロスペクトすると、構成プランの外部参照はコンポジットですでに置換されています。その結果、search値がコンポジット構成にすでに存在しないため、構成プランの外部参照はいずれも再構成時に置換されません。このようなケースを処理するには、各出力にsoa.reference.aliasesというユーザー・プロパティを指定します。この別名プロパティにより、出力に別名を指定できるようになります。デフォルトでは、replace値の場所の部分が別名として設定されます。別名の間にカンマ(,)や空白( )の区切り文字を使用すると、他の別名を手動で追加することもできます。元のsearch値に加えて、別名もそれぞれ再構成時に置換されます。

例B-3 SOAプラグインで使用される構成プランの外部参照

<composite name="compositeA">  <reference name="reference1">    <binding type="ws">      <attribute name="location">        <searchReplace>          <search>http://my.host.com:8080/some/path/info</search>          <replace>https://my.new-host.com:8081/some/path/info</replace>        </searchReplace>    </attribute>     </binding>  </reference></composite

関連付けられたユーザー・プロパティは、次のとおりです。

- searchプロパティ:

- name=soa.cp.composite_compositeA_1-0.reference_reference1.binding_ws.attribute_location.search

- value=http://my.host.com:8080/some/path/info

- replaceプロパティ:

- name=soa.cp.composite_compositeA_1-0.reference_reference1.binding_ws.attribute_location.replace

- value=<#Output::my_host_com:8080#>/some/path/info

この例では、元のreplace値は使用されません。かわりに、元のsearch値が、このsearchとreplaceを外部参照出力と相互に関連付けるトークンでプロトコル、ホストおよびポートを置換して使用されます。再構成時、このトークンは、"my_host_com:8080"という名前の外部参照出力に接続されている外部リソースから取得されたプロトコル、ホストおよびポートで置換されます。置換トークンは変更できませんが、置換トークンの後に続くパス情報は必要に応じて更新できます。

ドメインにデプロイされたコンポジットの構成プランに"http://my.host.com:8080"と一致する別の外部参照が含まれている場合、同じ出力が使用されます。

次の構成プランでは、新しい出力はアセンブリに追加されません。

例B-4 新しい出力がアセンブリに追加されない構成プラン

<composite name="compositeB">
<import>
<searchReplace>
<search>http://my.host.com:8080</search>
<replace/>
</searchReplace>
</import>
</composite>

関連付けられたユーザー・プロパティは、次のとおりです。

- searchプロパティ:

- name=soa.cp.composite_compositeB_1-0.import.search

- value=http://my.host.com:8080

- replaceプロパティ:

- name=soa.cp.composite_compositeB_1-0.import.replace

- value=<#Output::my_host_com:8080#>

B.5.4 参照システムの前提条件

SOAプラグインには、SOA/WebLogic Serverディストリビューションの製品JARに対するランタイム依存性があります。これらの依存性は、プラグインの初期クラスパスに含まれていません。製品ディストリビューションから動的にこれらの製品依存性をロードする必要があります。

これらの依存性は、次の2つの機能カテゴリに分けられます。

- Fabric依存性には、コンポジットのファイル・セットの取得とコンポジットのデプロイメントが含まれ、dynlib/soa-plugin-fabric.jarに格納されます。

- MDS依存性には、MDSとのすべてのやり取りが含まれ、dynlib/soa-plugin-mds.jarに格納されます。

B.5.5 結果のアーティファクト・タイプ

イントロスペクションで作成されるSOAアセンブリは、少なくとも管理サーバーおよび管理対象サーバーで構成されますが、通常は管理サーバーと、管理対象SOAサーバーのクラスタで構成されます。これらの各サーバー、またはクラスタはアプライアンスによって表されます。

B.5.6 接続

コンポジット構成には、外部リソースへの参照が含まれることがあります。たとえば、場所が指定されるWebサービス参照バインディングやインポートがあります。これらの外部参照は、ターゲット環境用に更新できるように公開されます。

外部参照ごとに、出力が関連付けられたアセンブリに追加されます。各出力は、Oracle Virtual Assembly Builder Studioを使用して、外部リソースの入力に接続する必要があります。参照は、プロトコル、ホスト/IPアドレスまたはポートで異なれば、別の参照と区別されます。

B.5.7 接続プロパティ

B.5.3.2項「外部参照」を参照してください。

B.5.8 Oracle SOAアプライアンスのプロパティ

Oracle SOAアプライアンスには、次のプロパティがあります。

- ユーザー・プロパティ(B.5.2項「Oracle SOAサービス・エンジン構成」およびB.5.3項「Oracle SOAアプリケーション構成」)

- システム・プロパティ(表B-22)。

表B-22 Oracle SOA: システム・プロパティ

名前

型

必須

デフォルト

説明

SOA_MW_HOME

String

false

なし

ミドルウェア・ホーム・ディレクトリ。

SOA_HOME

String

false

なし

SOA Oracleホーム(例: "AS11gR1SOA")。

SOA_JDK_HOME

String

false

なし

JDKホーム。

IS_SOA_SERVER

String

false

なし

SOA管理対象サーバーを識別します。

B.5.9 プラグインの拡張機能

なし。

B.5.10 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.6 Oracle HTTP Serverイントロスペクタのプラグイン

Oracle HTTP Serverのイントロスペクション・プラグインでは、Oracle Web層インスタンスの単一のOracle HTTP Serverアプライアンスを調べます。Oracle Access Manager 11g管理サーバーおよび任意のサーバー・インスタンスに加えて、Oracle HTTP Serverとそれを管理するOracle Process Manager and Notification Serverが取得されます。

B.6.1 サポートされるバージョン

このプラグインでは、リリース11gR1 11.1.1.5および11gR1 11.1.1.6がサポートされます。

B.6.2 Oracle HTTP Serverのイントロスペクション・パラメータ

表B-23に、Oracle HTTP Serverのイントロスペクション・パラメータを示します。

表B-23 Oracle HTTP Serverプラグインのイントロスペクション・パラメータ

パラメータ

説明

oracleInstance

イントロスペクトされるOracle HTTP Serverアプライアンスを含むOracleインスタンスへの完全修飾パス。

componentName

指定されたOracle Instance内のOracle HTTP Serverアプライアンスの名前。たとえば、"ohs1"です。

B.6.3 参照システムの前提条件

次の要件を満たしている場合、Oracle HTTP Serverプラグインではシングル・サインオン用にOracle Access Manager 11g WebGateがサポートされます。

- WebGate 11gを、Oracle HTTP Serverと同じMW_HOMEにインストールし、WebGate 11gのORACLE_INSTANCEとOracle HTTP ServerのORACLE_INSTANCEも同一にします。

- Oracle Access Manager 11g WebgateでOracle HTTP Serverを構成し、Webgate 11gエージェントをOracle Access Managerサーバーに登録します。

- OHS_MW_HOME/Oracle_FRHome1/oam/server/rreg/clientの下にある参照システムでRREGツールキットrreg-toolkit.jarが使用できます。
Oracle Forms and Reportsのインストール後は、RREGツールキットがOracleホーム内のoamディレクトリに配置され、再構成時にパートナ・アプリケーションをOracle Access Manager 11gに登録するために使用されます。RREGツールキットのバージョンは、Oracle Access Manager 11gのバージョンと一致している必要があります。適切なバージョンのRREGツールキットがこの場所で使用できない場合は、イントロスペクションに失敗します。

参照システムでForms and Reportsインストール用の別のノードにWeb層を設定した場合は、イントロスペクションの前に、B.3.3.1項「パートナ・アプリケーション登録ユーティリティの追加(別のノードのWeb層)」に記載されている要件を満たしていることを確認します。

RREGツールキットの詳細は、『Oracle Fusion Middleware Oracle Forms and Reportsインストレーション・ガイド』のOracle Access Managerを使用したセキュア・モードでのOracle Forms and Reportsの構成に関する項を参照してください。

B.6.4 結果のアーティファクト・タイプ

単一のスケーラブル・アプライアンス。

B.6.5 要件

Oracle Access Manager管理サーバーとインスタンスが稼働していることを確認します。

B.6.6 接続

入力は、構成で見つかったListenディレクティブまたはPortディレクティブごとにOracle HTTP Serverアプライアンスで作成されます。Oracle HTTP Server入力のプロトコルはhttpに設定されます。ただし、VirtualHostディレクティブ内でListenディレクティブが見つかり、SSLEngine onディレクティブが設定されている場合は、httpsに設定されます。通常、Web Cache出力はOracle HTTP Server入力に接続されます。

Oracle HTTP Serverアプライアンスの出力は、Oracle HTTP Server構成のOracle WebLogic Serverに関連する様々なディレクティブに基づいて作成されます。出力は、出力の"記述"によって接続先のOracle WebLogic Serverアセンブリの入力を示します。

Oracle HTTP Serverアプライアンスに、Oracle Access Manager管理サーバーの接続を表す1つの出力エンドポイントが作成されます。

B.6.7 接続プロパティ

すべての入力エンドポイントには、2つの編集可能なプロパティportおよびdescriptionと、1つの編集不可のプロパティprotocolsのリストがあります。protocolsは、入力に接続できる出力の種類を示します。

すべての出力エンドポイントには、1つの編集可能なプロパティdescriptionと、2つの編集不可のプロパティprotocolおよびsingletonがあります。protocolは、出力に接続できる入力の種類を示します。Singletonは、出力を接続できるアプライアンスの種類を示します。singletonがtrueの場合、出力を接続できるのは、スケーラビリティ最大絶対値が1のアプライアンスの入力のみです。

B.6.7.1 Oracle Access Manager管理サーバー

Oracle HTTP Serverアプライアンスに、Oracle Access Manager管理サーバーの接続を表す1つの出力エンドポイントが作成されます。この出力は、次の編集できないプロパティを公開します。

表B-24 Oracle Access Manager管理サーバーの接続の出力

名前

型

デフォルト

説明

name

String

OAMRegistration

Oracle Access Manager管理サーバーの名前

protocols

String

イントロスペクション時に検出されます。

セキュリティ・プロトコル。simple、openまたはcertを指定できます。

Oracle Access Manager管理サーバーを表す外部リソースを作成する必要があります。この外部リソースは、入力エンドポイントのプロパティとしてadmin-username、admin-password、portおよびprotocolsを公開します。

B.6.8 Oracle HTTP Serverアプライアンスのプロパティ

Oracle HTTP Serverアプライアンスには、ユーザー・プロパティ(表B-25)およびシステム・プロパティ(表B-26)があります。再構成時のパートナ・アプリケーションの登録には、webgate接頭辞を使用したプロパティが必要です。

注意:

再構成時のパートナ・アプリケーションの登録で使用できるプロパティは他にもいくつか存在します。たとえば、maxConnections、maxSessionTime、failOverThresholdなどです。これらのプロパティは、Oracle HTTP Serverプラグインではアプライアンス・プロパティとして公開されません。

これらのプロパティは、再構成後に変更できます。サポートされるプロパティのリストは、『Oracle Fusion Middleware Oracle Access Manager with Oracle Security Token Service管理者ガイド』のパートナ(エージェントおよびアプリケーション)のリモート登録に関する項を参照してください。

表B-25 Oracle HTTP Server: ユーザー・プロパティ

名前

型

必須

デフォルト

説明

userDirective

String

false

なし

ユーザー・ディレクティブが構成ファイルに存在するかどうかを示します。

groupDirective

String

false

なし

グループ・ディレクティブが構成ファイルに存在するかどうかを示します。

readymetric.timeout

Integer

false

300

タイムアウト期間(秒)を設定します。

readymetric.pollingPeriod

Integer

false

5

ポーリング期間(秒)を設定します。

webgate.security

String

true

イントロスペクション時に検出されます。

エージェントおよびOracle Access Managerサーバー間の通信トランスポート・セキュリティのレベルを示します(これは、Oracle Access Managerサーバーに指定されたレベルと一致する必要があります)。

使用可能な値は、simple、openまたはcertです。

指定されたwebgate.securityユーザー・プロパティの値がcertの場合は、デプロイ済のVMに必要な資格証明をインストールし、再構成後に手動でWebGateとOracle Access Managerサーバー間の信頼チャネルを確立する必要があります。

再構成時のパートナ・アプリケーションの登録に同じ(参照システムの)Oracle Access Managerサーバーが使用される場合は、資格証明をインストールする必要がありません。これは、WebGateとOracle Access Managerサーバー間の通信に必要な資格証明が参照システムからデプロイ済のVMにデフォルトでコピーされるためです。

webgate.agentPassword

String

false

該当なし

このWebgateのオプションかつ一意のパスワードで、この登録プロセス中に割り当てられています。

webgate.agentKeyPassword

String

false

該当なし

Oracle Access Managerサーバーがpassword.xmlを生成するために必要です。

webgate.security値がcertの場合にのみ必要です。

webgate.protectedResourcesList

String

true

/,/.../*

認証スキームを使用してOracle Access Managerエージェントで保護するリソースURLを指定します。リソースURLは、agentBaseUrlを基準とした相対パスである必要があります。

カンマ区切りリストとして指定します。

たとえば、Oracle HTTP ServerがOracle Forms and Reportsのフロントエンドである環境では、/reports/rwservlet/*,/forms/frmservlet?*oamMode=trueです。

webgate.publicResourcesList

String

false

/public/index.html

公開する(Oracle Access Managerエージェントで保護されない)リソースURLを指定します。リソースURLは、agentBaseUrlを基準とした相対パスである必要があります。たとえば、アプリケーションのホームページやようこそページを指定します。

カンマ区切りリストとして指定します。

webgate.excludedResourcesList

String

false

/excluded/index.html

公開する(Oracle Access Managerエージェントで保護されない) HTTPタイプのリソースURLを指定します。リソースURLは、agentBaseUrlを基準とした相対パスである必要があります。たとえば、アプリケーションのホームページやようこそページを指定します。

HTTPリソース・タイプのみが除外できます。通常は、セキュリティの影響を受けにくく、認証や認可、レスポンス処理、セッション管理、監査を必要としない画像(*.jpg、*.png)などのファイル。除外されたリソースは、コンソール内のユーザー定義ポリシーには追加できません。

カンマ区切りリストとして指定します。

注意:

再構成時に、デプロイ済のVMホスト名およびOracle HTTP Serverインスタンスのポートに基づいてagentBaseURLが自動生成されます。

表B-26 Oracle HTTP Server: システム・プロパティ

名前

型

必須

デフォルト

説明

ORACLE_INSTANCE

String

false

なし

ユーザーがOracleインスタンスとして指定するパス。

COMPONENT_TYPE

String

false

なし

イントロスペクトされるアプライアンスのタイプ。

COMPONENT_NAME

String

false

なし

イントロスペクトされるアプライアンスの名前。

ORACLE_HOME

String

false

なし

このOracleインスタンスに関連するOracleホームへのパス。

FMW_HOME

String

false

なし

このOracleインスタンスに関連するFusion Middlewareホームへのパス。

JAVA_HOME

String

false

なし

このOracleインスタンスで使用されるJavaホームへのパス。

oraInstLocDir

String

false

なし

Oracle Universal Installerで使用されるインストール・ファイル用のディレクトリ。

B.6.9 プラグインの拡張機能

なし。

B.6.10 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.7 Oracle Web Cacheプラグイン

Oracle Web Cacheのイントロスペクション・プラグインでは、Oracle Web層インスタンスの単一のOracle Web Cacheアプライアンスを調べます。Oracle Web Cacheと、それを管理するOracle Process Manager and Notification Serverが取得されます。

B.7.1 サポートされるバージョン

このプラグインでは、リリース11gR1 11.1.1.5および11gR1 11.1.1.6がサポートされます。

B.7.2 Oracle Web Cacheのイントロスペクション・パラメータ

表B-27に、Oracle Web Cache Serverのイントロスペクション・パラメータを示します。

表B-27 Oracle Web Cacheプラグインのイントロスペクション・パラメータ

パラメータ

説明

oracleInstance

イントロスペクトされるOracle HTTP Serverアプライアンスを含むOracleインスタンスへの完全修飾パス。

componentName

指定されたOracle Instance内のOracle HTTP Serverコンポーネントの名前。たとえば、"ohs1"です。

B.7.3 参照システムの前提条件

Oracle Web Cacheのイントロスペクション・プラグインでは、複数のネットワーク・インタフェース・カード(NIC)による構成がサポートされません。Web Cache構成が複数のNICにバインドしている場合、イントロスペクションは失敗します。このような失敗を回避するには、イントロスペクション前に<LISTEN>要素内のすべてのIPアドレスを"ANY"に設定します。

B.7.4 要件

Oracle Web Cacheには、次の要件が適用されます。

B.7.4.1 仮想ホスト・マップ・プロパティを更新するための要件

ポート変更を行った場合は常に、仮想ホスト・マップ(VHM)に関連付けられているプロパティを手動で更新して、VHMポートを更新する必要があります。

B.7.5 結果のアーティファクト・タイプ

単一のスケーラブル・アプライアンス。

B.7.6 接続

入力は、webcache.xmlで見つかった<LISTEN>要素ごとにWeb Cacheアプライアンスで作成されます。

Oracle Web Cacheアプライアンスの出力は、出力の"記述"によってOracle HTTP Serverアプライアンスに接続する方法を示します。出力は、Oracle Web Cache構成内の様々なディレクティブに基づいて作成され、記述は、Oracle Web Cache出力を接続するOracle HTTP Serverアプライアンスの入力を特定するのに使用できます。

B.7.7 接続プロパティ

すべての入力エンドポイントには、2つの編集可能なプロパティportおよびdescriptionと、1つの編集不可のプロパティprotocolsのリストがあります。protocolsは、入力に接続できる出力の種類を示します。

すべての出力エンドポイントには、1つの編集可能なプロパティdescriptionと、2つの編集不可のプロパティprotocolおよびsingletonがあります。protocolは、出力に接続できる入力の種類を示します。Singletonは、出力を接続できるアプライアンスの種類を示します。singletonがtrueの場合、出力を接続できるのは、スケーラビリティ最大絶対値が1のアプライアンスの入力のみです。

次のプロパティは、Oracle Web Cacheエンドポイントに固有です。

仮想ホスト・マッピングごとに出力が1つ作成されます。各出力には、表B-28で説明するプロパティが含まれます。

表B-28 Oracle Web Cache: 出力のプロパティ

名前

型

必須

デフォルト

説明

relatedOriginServers

String

false

OEL

指定された仮想ホスト・マップに対するすべてのホスト定義名のカンマ区切りのリスト。

たとえば、"host1,host2,host3"です。

vhm-siteX-HOST

String

false

なし

仮想ホスト・マップのhostプロパティの値。

PORT

String

false

なし

仮想ホスト・マップのportプロパティの値。

B.7.8 Oracle Web Cacheアプライアンスのプロパティ

表B-29では、Oracle Web Cacheアプライアンスのユーザー・プロパティについて説明します。

表B-29 Oracle Web Cache: ユーザー・プロパティ

名前

型

必須

デフォルト

説明

adminPassword

String

false

なし

MONITORINGパスワードに使用するパスワード。指定しない場合、システム・プロパティのoriginalAdminPasswordが使用されます。

statisticsPassword

String

false

なし

INVALIDATIONパスワードに使用するパスワード。指定しない場合、システム・プロパティのoriginalStatisticsPasswordが使用されます。

readymetric.timeout

Integer

false

300

タイムアウト期間(秒)を設定します。

readymetric.pollingPeriod

Integer

false

5

ポーリング期間(秒)を設定します。

siteX-HOST

String

false

<ファイルから読取り>

サイト定義のホスト名。

siteX-PORT

String

false

<ファイルから読取り>

サイト定義のポート値。

表B-30では、Oracle Web Cacheアプライアンスのシステム・プロパティについて説明します。

表B-30 Oracle Web Cache: システム・プロパティ

名前

型

必須

デフォルト

説明

oracleInstance

String

false

なし

ユーザーがOracleインスタンスとして指定するパス。

componentType

String

false

なし

イントロスペクトされるアプライアンスのタイプ。

componentName

String

false

なし

イントロスペクトされるアプライアンスの名前。

oracleHome

String

false

なし

このOracleインスタンスに関連するOracleホームへのパス。

javaHome

String

false

なし

このOracleインスタンスで使用されるJavaホームへのパス。

originalAdminPassword

String

false

「説明」列を参照してください。

このOracle Web Cacheインスタンス用に存在するため、これはパスワード・ハッシュです。デプロイされるシステムでは、"adminPassword"ユーザー・プロパティの値を特別に設定しない場合、この値を使用します。

デフォルト値は、"MONITORING"パスワード・ハッシュに対する既存のOracle Web Cache構成のハッシュ済パスワードです。

originalStatisticsPassword

String

false

ハッシュ済の値。

これは、"INVALIDATION"パスワード・ハッシュに対する既存のOracle Web Cache構成のパスワード・ハッシュの値です。

oraInstLocDir

String

false

なし

Oracle Universal Installerで使用されるインストール・ファイル用のディレクトリ。

B.7.9 プラグインの拡張機能

なし。

B.7.10 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.8 Oracle Database (SIDB)プラグイン

単一インスタンスOracle Databaseのイントロスペクション・プラグインでは、単一インスタンスOracle Databaseアプライアンスを調べ、メタデータを取得します。

B.8.1 サポートされるバージョン

このプラグインでは、リリース10gR2、11gR1、11gR2がサポートされます。

B.8.2 Oracle Databaseのイントロスペクション・パラメータ

表B-31に、Oracle Databaseのイントロスペクション・パラメータを示します。

表B-31 Oracle Databaseプラグインのイントロスペクション・パラメータ

パラメータ

説明

asmHome

ASMが記憶域タイプとして使用され、別のOracleホームにインストールされている場合、このパラメータは必須です。

dbHome

イントロスペクトするOracle RDBMSのORACLE_HOMEです。

oracleSid

イントロスペクトするOracle RDBMSのOracleシステム識別子(SID)です。

shutdownDBOK

このフラグは、データベース・リブートを承認するために渡す必要があります。

sysDBAUserName

SYSDBA権限を持つデータベース・アカウント。OS認証が現在のデータベースに対して無効である場合のみ、このパラメータは必須です。

B.8.3 Oracle Databaseのイントロスペクション・パスワード・パラメータ

表B-32に、Oracle Databaseのイントロスペクション・パスワード・パラメータを示します。abctlツールを使用してイントロスペクションを実行すると、これらのパラメータの値を入力するためのプロンプトが表示されます。Oracle Virtual Assembly Builder Studioには、これらのパラメータ用のパスワード・フィールドがあります。

表B-32 Oracle Databaseプラグインの(イントロスペクション時に要求される)イントロスペクション・パラメータ

パラメータ

説明

rootPassword

省略可。使用可能なファイル・セットの取得を行うためにORACLE_HOMEファイルの権限を変更する場合、rootPasswordパラメータは必須です。

sysDBAPassword

省略可。sysDBAUserNameユーザーのパスワード。OS認証が現在のデータベースに対して無効である場合のみ、このパラメータは必須です。

B.8.4 参照システムの前提条件

このイントロスペクション・プラグインでは、複数のNICによる構成がサポートされません。

B.8.5 要件

Oracle Databaseには、次の要件が適用されます。

ベース・システム・イメージのOSバージョンが、参照システムのバージョンと一致する必要があります。

B.8.6 結果のアーティファクト・タイプ

単一のアプライアンス。

B.8.7 接続

入力は、デフォルトのListenerおよびPortを使用して、SIDBアプライアンスで作成されます。SIDB入力のプロトコルは"jdbc"に設定されます。

B.8.8 接続プロパティ

入力エンドポイントには、2つの編集可能なプロパティportおよびdescriptionと、2つの編集不可のプロパティprotocolおよびORACLE_SIDがあります。protocolは、入力に接続できる出力の種類を示します。

B.8.9 Oracle Databaseアプライアンスのプロパティ

Oracle Databaseアプライアンスが含まれるアセンブリには、ユーザー・プロパティ(表B-33)およびシステム・プロパティ(表B-34)があります。

表B-33 Oracle SIDBプラグイン: ユーザー・プロパティ

名前

型

必須

デフォルト

説明

asm-password

String

false

なし

SYS ASMアカウントのパスワード。

db-account-password

Password

true

なし

データベース・アカウントSYS、SYSTEM、SYSMANおよびDBSNMPのパスワード。

表B-34 Oracle SIDBプラグインのシステム・プロパティ

名前

型

必須

デフォルト

説明

ASM_BASE

String

false

なし

ASM ORACLE_BASEパス。

ASM_HOME

String

false

なし

ASM ORACLE_HOMEパス。

ASM_OWNER

String

false

なし

ASM ORACLE_HOMEを所有するOSユーザー。

DATA_ASM_DISCOVERY_STRING

String

false

なし

すべてのデータASMディスクを検出するためのパス。

DATA_ASM_DISK_GROUP_NAME

String

false

なし

データASMディスクグループの名前。

DATA_ASM_DISK_GROUP_REDUNDANCY

String

false

なし

データASMディスクグループ・レベルの冗長性。

DATA_ASM_DISKS

String

false

なし

データASMディスクグループに属するディスクのパス。

DATA_STORAGE_TYPE

String

false

なし

データベース・データの記憶域タイプ。

DB_BASE

String

false

なし

Oracleデータベースのベース・パス。

DB_GROUP

String

false

なし

Oracleホームを所有するOSユーザーのグループ。

DB_HOME

String

false

なし

Oracleデータベースのホーム・パス。

DB_HOME_NAME

String

false

なし

Oracleホームの名前。

DB_LISTENER_NAME

String

false

なし

Oracleデータベースのリスナー名。

DB_ORACLE_GROUPS

String

false

なし

OSDBA、OSOPERおよびOSASMグループ。

DB_OWNER

String

false

なし

Oracleホームを所有するOSユーザー。

DB_USING_ASM

String

false

なし

参照システムに従ってデータベースまたはリカバリ・ファイルのいずれかがASMに格納される場合は、trueに設定します。

DB_VERSION

String

false

なし

参照システムのOracleデータベース・ソフトウェアのバージョン。

ORACLE_SID

String

false

なし

OracleデータベースのSID。

ORIGINAL_GLOBAL_DB_NAME

String

false

なし

参照システムのデータベースの一意の名前。

RECOVERY_ASM_DISCOVERY_STRING

String

false

なし

すべてのリカバリASMディスクを検出するためのパス。

RECOVERY_ASM_DISK_GROUP_NAME

String

false

なし

リカバリASMディスクグループの名前。

RECOVERY_ASM_DISK_GROUP_REDUNDANCY

String

false

なし

リカバリASMディスクグループ・レベルの冗長性。

RECOVERY_ASM_DISKS

String

false

なし

リカバリASMディスクグループに属するディスクのパス。

RECOVERY_STORAGE_TYPE

String

false

なし

データベース・リカバリの記憶域タイプ。

B.8.10 プラグインの拡張機能

なし。

B.8.11 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.9 Oracle RAC Database (RACDB)プラグイン

RACDBのイントロスペクション・プラグインでは、Oracle ClusterwareおよびOracle RAC Databaseのコンポーネントを調べ、そのメタデータを取得します。

B.9.1 サポートされるバージョン

このプラグインでは、リリース11gR2がサポートされます。

B.9.2 Oracle RAC Databaseのイントロスペクション・パラメータ

表B-35に、RACDBのイントロスペクション・プラグイン用のイントロスペクション・パラメータを示します。

表B-35 Oracle RACDBプラグインのイントロスペクション・パラメータ

パラメータ

説明

asmHome

ASMが記憶域タイプとして使用され、別のOracleホームにインストールされている場合、このパラメータは必須です。

crsHome

イントロスペクトするOracle CRSのORACLE_HOMEです。

dbHome

イントロスペクトするOracle RDBMSのORACLE_HOMEです。

globalDbName

イントロスペクトするOracle RDBMSのグローバル・データベース名。

shutdownDBOK

このフラグは、データベース・リブートを承認するために渡す必要があります。

sysDBAUserName

省略可。SYSDBA権限を持つデータベース・アカウント。OS認証が現在のデータベースに対して無効である場合のみ、このパラメータは必須です。

B.9.3 Oracle RAC Databaseのイントロスペクション・パスワード・パラメータ

表B-36に、Oracle RAC Databaseプラグインのイントロスペクション・パスワード・パラメータを示します。abctlツールを使用してイントロスペクションを実行すると、これらのパラメータの値を入力するためのプロンプトが表示されます。Oracle Virtual Assembly Builder Studioには、これらのパラメータ用のパスワード・フィールドがあります。

表B-36 Oracle RACDBプラグインの(イントロスペクション時に要求される)イントロスペクション・パラメータ

パラメータ

説明

rootPassword

省略可。使用可能なファイル・セットの取得を行うためにORACLE_HOMEファイルの権限を変更する場合、rootPasswordパラメータは必須です。

sysDBAPassword

省略可。sysDBAUserNameユーザーのパスワード。OS認証が現在のデータベースに対して無効である場合のみ、このパラメータは必須です。

B.9.4 参照システムの前提条件

イントロスペクション時、クラスタウェア・スタックは実行されている必要があります。

B.9.5 要件

Oracle RAC Databaseには、次の要件が適用されます。

ベース・システム・イメージのOSバージョンが、参照システムのバージョンと一致する必要があります。

B.9.6 結果のアーティファクト・タイプ

単一のアプライアンス。

B.9.7 接続

11.2シリーズのRACDBの場合、1つの入力がRACDBアプライアンスで作成されます。

11.2シリーズより前のRACDBの場合、入力は、構成で見つかったListenerディレクティブまたはPortディレクティブごとにRACDBアプライアンスで作成されます。

B.9.8 接続プロパティ

11.2シリーズのRACDBの場合、入力エンドポイントには、2つの編集可能なプロパティscan-nameおよびglobal-db-nameと、入力に接続できる出力の種類を示す2つの編集不可のプロパティprotocolおよびportがあります。

11.2シリーズより前のRACDBの場合、入力エンドポイントには、1つの編集可能なプロパティglobal-db-nameと、2つの編集不可のプロパティprotocolおよびportがあります。

B.9.9 Oracle Databaseアプライアンスのプロパティ

Oracle Databaseアプライアンスが含まれるアセンブリには、ユーザー・プロパティ(表B-37)およびシステム・プロパティ(表B-38)があります。

表B-37 Oracle RAC Database: ユーザー・プロパティ

名前

型

必須

デフォルト

説明

asm-password

String

false

なし

SYS ASMアカウントのパスワード。

cluster-name

String

false

new_cluster

クラスタの名前(11.2シリーズより前のOracle Database専用)。

db-account-password

Password

true

なし

データベース・アカウントSYS、SYSTEM、SYSMANおよびDBSNMPのパスワード。

表B-38 Oracle RAC Databaseのシステム・プロパティ

名前

型

必須

デフォルト

説明

CRS_BASE

String

false

なし

クラスタウェア・ベース・パス。

CRS_HOME

String

false

なし

クラスタウェア・ホーム・パス。

CRS_OWNER

String

false

grid

クラスタウェア・ホームの所有者であるOSユーザーの名前。

CRS_GROUP

String

false

oinstall

クラスタウェア・ホームの所有者のOSユーザー・グループの名前。

CRS_ORACLE_GROUPS

String

false

oinstall

OSDBA、OSOPERおよびOSASMグループ。

VOTING_DISKS_LOCATIONS

String

false

なし

投票ディスクの場所(クラスタウェア・ファイルのファイル・システム記憶域タイプ専用)。

VOTING_DISKS_REDUNDANCY

String

false

なし

投票ディスクの冗長性(クラスタウェア・ファイルのファイル・システム記憶域タイプ専用)。

OCR_DISKS_LOCATIONS

String

false

なし

OCRディスクの場所(クラスタウェア・ファイルのファイル・システム記憶域タイプ専用)。

OCR_DISKS_REDUNDANCY

String

false

なし

OCRディスクの冗長性(クラスタウェア・ファイルのファイル・システム記憶域タイプ専用)。

SCAN_PORT

String

false

1521

SCANリスナーのポート。

CRS_STORAGE_TYPE

String

false

なし

参照システムに従ったクラスタウェア・ファイルの記憶域タイプ。

CRS_VERSION

String

false

なし

参照システムのクラスタウェア・ソフトウェアのバージョン。

CRS_ASM_DISK_GROUP_NAME

String

false

OVMOCRVD

クラスタウェアASMディスクグループの名前。

CRS_ASM_DISCOVERY_STRING

String

false

/dev/raw/ovmocrvd*

すべてのデータASMディスクを検出するためのパス。

CRS_ASM_DISK_GROUP_REDUNDANCY

String

false

NORMAL

クラスタウェアASMディスクグループ・レベルの冗長性。

CRS_ASM_DISKS

String

false

/dev/raw/ovmocrvd0,/dev/raw/ovmocrvd1,/dev/raw/ovmocrvd2

クラスタウェアASMディスクグループに属するディスクのパス。

ASM_BASE

String

false

なし

ASM ORACLE_BASEパス。

ASM_HOME

String

false

なし

ASM ORACLE_HOMEパス。

ASM_OWNER

String

false

grid

ASM ORACLE_HOMEを所有するOSユーザー。

DATA_ASM_DISCOVERY_STRING

String

false

/dev/raw/asm*

すべてのデータASMディスクを検出するためのパス。

DATA_ASM_DISK_GROUP_NAME

String

false

なし

データASMディスクグループの名前。

DATA_ASM_DISK_GROUP_REDUNDANCY

String

false

なし

データASMディスクグループ・レベルの冗長性。

DATA_ASM_DISKS

String

false

なし

データASMディスクグループに属するディスクのパス。

RECOVERY_ASM_DISCOVERY_STRING

String

false

/dev/raw/asm*

すべてのリカバリASMディスクを検出するためのパス。

RECOVERY_ASM_DISK_GROUP_NAME

String

false

なし

リカバリASMディスクグループの名前。

RECOVERY_ASM_DISK_GROUP_REDUNDANCY

String

false

なし

リカバリASMディスクグループ・レベルの冗長性。

RECOVERY_ASM_DISKS

String

false

なし

リカバリASMディスクグループに属するディスクのパス。

RECOVERY_STORAGE_TYPE

String

false

なし

データベース・リカバリの記憶域タイプ。

DATA_STORAGE_TYPE

String

false

なし

参照システムに従ったデータベースの記憶域タイプ。

RECOVERY_STORAGE_TYPE

String

false

なし

参照システムに従ったデータベース・リカバリ・ファイルの記憶域タイプ。

DB_USING_ASM

String

false

なし

参照システムに従ってデータベースまたはリカバリ・ファイルのいずれかがASMに格納される場合は、trueに設定します。

DB_VERSION

String

false

なし

参照システムのOracleデータベース・ソフトウェアのバージョン。

B.9.10 プラグインの拡張機能

なし。

B.9.11 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.10 Oracle Traffic Directorプラグイン

Oracle Traffic Directorプラグインでは、参照システムのOracle Traffic Director構成をイントロスペクトします。Oracle Traffic Directorのコンテキストでは、構成とは、Oracle Traffic Directorインスタンスの実行時の動作を決定する一連の構成可能な要素(メタデータ)です。

Oracle Traffic Directorの概要は、『Oracle Traffic Director管理者ガイド』の「Oracle Traffic Directorのスタート・ガイド」を参照してください。

B.10.1 サポートされるバージョン

Oracle Traffic Directorプラグインでは、Oracle Traffic Director 11.1.1.6がサポートされます。

B.10.2 Oracle Traffic Directorのイントロスペクション・パラメータ

表B-39に、Oracle Traffic Directorのイントロスペクション・パラメータを示します。パラメータはすべて必須です。

表B-39 Oracle Traffic Directorプラグインのイントロスペクション・パラメータ

パラメータ

説明

oracleHome

Oracle Traffic Directorバイナリがインストールされている参照システム内のディレクトリへの完全修飾パス。

oracleInstance

Oracle Traffic Director管理サーバー・インスタンスが存在する参照システム内のディレクトリへの完全修飾パス。

configName

プラグインがイントロスペクトするOracle Traffic Director構成の名前。

B.10.3 参照システムの前提条件

Oracle Traffic DirectorプラグインがOracleホームおよび管理サーバー・インスタンスを正常にイントロスペクトするには、参照システムで次の前提条件を満たす必要があります。

- Oracle Traffic Directorをインストールする必要があります。

- Oracle Traffic Director管理サーバー・インスタンスを構成する必要があります。

- 少なくとも1つの構成が使用可能である必要があります。

注意:

管理サーバーが稼働している必要はありません。

B.10.4 結果のアーティファクト・タイプ

イントロスペクションの結果は、次のものが含まれる原子性アセンブリです。

- Oracle Traffic Director管理サーバー・アプライアンス

- Oracle Traffic Directorインスタンス・アプライアンス
デフォルトでは、インスタンス・アプライアンスのデプロイ時に、Oracle Traffic Director構成のデプロイ先となる参照システム上のノードの数に関係なく、2つの仮想マシンが作成されます。デプロイメント・プロセス時に作成される仮想マシンの数は、スケーラビリティ・プロパティによって制御できます(表B-42「管理サーバー・アプライアンスのスケーラビリティ・プロパティ」を参照)。

B.10.5 接続

Oracle Traffic Directorアセンブリ内のアプライアンスは、入力エンドポイントおよび出力エンドポイントを使用して、外部コンポーネントと他のアプライアンスおよびアセンブリに接続できます。

注意:

このリリースでは、Oracle Traffic DirectorアセンブリはWLSアセンブリにのみ接続できます。

B.10.5.1 管理サーバー・アプライアンスのエンドポイントの接続

入力エンドポイントは、Oracle Traffic Director管理サーバー・アプライアンスのHTTPSリスニング・ポート用に1つ作成されます。管理サーバー・アプライアンスの入力エンドポイントには、2つの編集可能なプロパティportおよびdescriptionがあります。

出力エンドポイントは、管理サーバー・アプライアンス用に作成されません。

B.10.5.2 インスタンス・アプライアンスのエンドポイントの接続

入力エンドポイントは、Oracle Traffic Director構成のHTTPリスニング・ポートごとに1つ作成されます。インスタンス・アプライアンスの各入力エンドポイントには、2つの編集可能なプロパティportおよびdescriptionがあります。

出力エンドポイントは、構成のオリジン・サーバー・プールごとに1つ作成されます。インスタンス・アプライアンスの各出力エンドポイントには、1つの編集可能なプロパティdescriptionがあります。

注意:

オリジン・サーバー・プール内のオリジン・サーバーの詳細は、イントロスペクション時に取得されません。オリジン・サーバーは、Oracle Traffic Directorインスタンス・アプライアンスの出力エンドポイントの接続先となるアプライアンスに基づいてデプロイメント・プロセス時に定義されます。

B.10.6 Oracle Traffic Directorアプライアンス・プロパティ

この項では、Oracle Traffic Directorアセンブリ内のアプライアンスの編集可能なプロパティについて説明します。プロパティは、イントロスペクション時に取得され、アプライアンスのデプロイ時に仮想マシンの作成に使用されます。

この項の内容は次のとおりです。

- B.10.6.1項「管理サーバー・アプライアンスの編集可能なプロパティ」

- B.10.6.2項「インスタンス・アプライアンスの編集可能なプロパティ」

B.10.6.1 管理サーバー・アプライアンスの編集可能なプロパティ

表B-40 管理サーバー・アプライアンスの汎用プロパティ

名前

型

必須

デフォルト

説明

adminUser

String

true

admin

管理サーバーにログインするためのユーザー名。

adminPassword

String

true

なし

管理サーバー・ユーザー名のパスワード。

表B-41 管理サーバー・アプライアンスのリソース・プロパティ

プロパティ名

型

必須

デフォルト値

説明

CPU_MHZ

Integer

true

1000

CPUクロックの速度。

MEMORY_MB

Integer

true

1024

メモリー要件(MB)。

NUMBER_CPUS

Integer

true

1

プロセッサ数。

表B-42 管理サーバー・アプライアンスのスケーラビリティ・プロパティ

プロパティ名

型

必須

デフォルト値

説明

Min

Integer

true

1

デプロイできるアプライアンスの仮想マシンの最小数。

Max

Integer

true

1

デプロイできるアプライアンスの仮想マシンの最大数。この値は、Absolute-Max値よりも高くする必要があります。

Absolute-Max

Integer

false

1

デプロイできるアプライアンスの仮想マシンの最大絶対数。

Target

Integer

true

1

デプロイするアプライアンスの実際の仮想マシン数。

スケーラビリティ・プロパティの値は変更できますが、デフォルト値のままにしておくことをお薦めします。

B.10.6.2 インスタンス・アプライアンスの編集可能なプロパティ

表B-43 インスタンス・アプライアンスのリソース・プロパティ

プロパティ名

型

必須

デフォルト値

説明

CPU_MHZ

Integer

true

1000

CPUクロックの速度。

MEMORY_MB

Integer

true

1024

メモリー要件(MB)。

NUMBER_CPUS

Integer

true

1

プロセッサ数。

表B-44 インスタンス・アプライアンスのスケーラビリティ・プロパティ

プロパティ名

型

必須

デフォルト値

説明

Min

Integer

true

1

デプロイできるアプライアンスの仮想マシンの最小数。

Max

Integer

true

2

デプロイできるアプライアンスの仮想マシンの最大数。この値は、Absolute-Max値よりも低くする必要があります。

Absolute-Max

Integer

false

2

デプロイできるアプライアンスの仮想マシンの最大絶対数。

Target

Integer

true

2

デプロイするアプライアンスの実際の仮想マシン数。

B.10.7 サポートされるテンプレート・タイプ

Oracle Enterprise Linux。

B.10.8 デプロイ後のタスク

Oracle Traffic Directorアセンブリのデプロイ後に、次のタスクを実行する必要があります。

- 参照システムでは、Oracle Traffic DirectorがSSL終了ポイントとして構成される場合、構成の証明書データベース内の証明書は仮想サーバーに属し、参照システムのホスト名には属さないと想定されます。証明書が参照システムのホスト名に属する場合は、それらの証明書をターゲット仮想マシンに再インストールする必要があります。

- SSLがOracle Traffic DirectorとOracle WebLogic Server管理対象サーバーとの間で構成されている場合は、Oracle Traffic Directorアセンブリのデプロイ後に、必要に応じて新しい証明書をインストールする必要があります。

- 参照システムで構成されたフェイルオーバー・グループは、イントロスペクション時に取得されません。そのため、Oracle Traffic Director管理コンソールまたはCLIを使用して、高可用性を再度構成する必要があります。

注意:

高可用性は、ベース・イメージにkeepalivedが含まれる場合のみサポートされます。

B.11 Oracle Tuxedoプラグイン

Oracle Tuxedoのイントロスペクション・プラグインでは、単一または複数マシンのOracle Tuxedoドメインと、そのドメインが存在するOracleホーム・ディレクトリを調べます。TuxedoがインストールされているOracleホーム・ディレクトリには、次に示すTuxedoアドオンも格納できるため、これらも調べられます。

- Oracle TSAM

- Oracle SALT

- Oracle Tuxedo Application Runtime for CICS and Batch

- Oracle Tuxedo Mainframe Adapter SNA

単一マシン・ドメインとそのホーム・ディレクトリ(アドオン製品を含む)が取得されます。複数マシンのOracle Tuxedoドメインの場合、各マシンを個別にイントロスペクトして、1つのアセンブリに接続する必要があります。B.11.6項「接続」を参照してください。

B.11.1 サポートされるバージョン

このプラグインでは、リリース11gR1がサポートされます。

B.11.2 Oracle Tuxedoのイントロスペクション・パラメータ

表B-45に、Oracle Tuxedoのイントロスペクション・プラグイン用のイントロスペクション・パラメータを示します。

表B-45 Oracle Tuxedoプラグインのイントロスペクション・パラメータ

パラメータ

説明

TUXDIR

Oracle Tuxedoがインストールされている場所。

TUXCONFIG

コンパイルされた形式のアプリケーション構成ファイルの場所。このファイルには、Tuxedoコア構成と、最小限の値セット(APPDIRなど)が含まれます。

environmentScript

このスクリプトは、Tuxedoアプリケーションの環境を設定するためにイントロスペクションの実行前に実行します。スクリプトは、$APPDIRディレクトリを基準として検索されます。スクリプトを実行した結果として、ターゲット環境で妨げになる可能性があるDISPLAYやSHELLのようなものが取得されないように、既知のTuxedo関連の環境変数のみが取得されます。

設定しないと、プラグインはsetenv.shスクリプトを(そのとおりの名前で)$APPDIRディレクトリから実行しようとします。この動作は排他的で、つまり、最大1つのスクリプトしか実行できません。プラグインでは、envコマンドの出力を使用するため、このような環境設定スクリプトの出力がenvのコール結果に干渉しないよう注意する必要があります。

環境スクリプトを使用しない場合、または使用するが非Tuxedo環境変数も設定する必要がある場合は、一般的に知られている標準のJavaプロパティ・ファイルovab-application.propertiesが$APPDIRで検索されます。

oracleClientDir

Oracle Databaseクライアント・ソフトウェア・インストールの場所。通常、Oracle Instantクライアント・ソフトウェアが解凍されているディレクトリ。ユーザーが、この値が正確であることを確認します。Tuxedoプラグインにはこのインストールが有効であることを検証する方法がないためです。

tnsNamesLocation

TNSNAMES.oraクライアント構成ファイルの場所。このファイルが解析されてテンプレートが作成され、ubbconfig OPENINFO文字列または環境変数ORACLE_SIDに指定されたデータベース名が(その順序または優先度で)見つかった場合、アプライアンス出力が作成されます。OPENINFO/TNSNAMES.oraエントリが複数の場合、複数の出力が生成されます。

scriptWorkingDir

環境スクリプトの実行元となる作業ディレクトリ。これは、スクリプトで現行作業ディレクトリを使用してパス値を決定する場合に便利です。

artSecurityProfile

ART BatchまたはART CICSで使用されるセキュリティ・プロファイルの場所。

B.11.3 参照システムの前提条件

なし。

B.11.4 要件

Oracle Tuxedoには、次の要件が適用されます。

B.11.4.1 ベース・イメージの要件

ベース・システム・イメージのOSバージョンが、参照システムのバージョンと一致する必要があります。

さらに、『Oracle Tuxedo: Oracle Tuxedoシステムのインストール』(http://docs.oracle.com/cd/E18050_01/tuxedo/docs11gr1/install/insappd.html)に示すガイドラインに従って、IPCカーネル・パラメータをベース・システム・イメージで設定する必要があります。

B.11.4.2 MicrofocusまたはCOBOL ITを必要とするART CICS/Batchアプリケーション

MicrofocusまたはCOBOL ITのインストールを必要とするART CICS/Batchアプリケーションには、事前にインストールされたMicrofocusまたはCOBOL ITを使用して(インストール・パスは参照システム上のものと同じ)、元のOracle Virtual Assembly Builderベース・イメージに基づいて新しいベース・イメージを作成し、その新しいベース・イメージを使用してART CICS/Batchアプリケーション用にテンプレートを作成する必要があります。

この構成手順によってのみ、Microfocus/COBOL ITを必要とするART CICS/BatchアプリケーションはデプロイされたVMで正常に起動します。

B.11.4.3 スケーリングに関する要件

TMA SNAの場合、スケーリングは適用できません。

ART Batchの場合、スケーリングは適用できます。ただし、制限が1つあり、JES2QSPACEキュー・スペースを監視するTMQUEUEサーバーがスレーブ・マシンで稼働している場合、ART Batchのそのマシンにスケーリング機能を使用しないでください。

ART CICSの場合、スケーリングを適用できないサーバーがあります。ART CICSのリファレンス・ガイドを参照して、ART CICSの指定されたサーバーにスケーリングが適用できるかどうかを判断してください。

B.11.5 結果のアーティファクト・タイプ

結果のアーティファクト・タイプは、イントロスペクトする対象が単一マシン・ドメインか複数マシン・ドメインかによって異なります。

B.11.5.1 単一マシンのOracle Tuxedoドメイン

単一マシンのTuxedoドメインの場合、単一のスケーラブル・アプライアンス。

B.11.5.2 複数マシンのOracle Tuxedoドメイン

複数マシンのTuxedoドメインの場合、参照システム内の各マシンを個別にイントロスペクトする必要があります。結果のアプライアンスのタイプは次のとおりです。

- マスター: Tuxedoドメイン内のMASTERノードを表す単一の非スケーラブル・アプライアンス。

- バックアップ・マスター(オプション): Tuxedoドメイン内のBACKUP MASTERノードを表す単一の非スケーラブル・アプライアンス。参照システムに存在する場合、イントロスペクトする必要があります。

- その他: 参照Tuxedoドメイン内のマスターおよびバックアップ以外のノードを表す単一のスケーラブル・アプライアンス。参照システムのトポロジに応じて、このようなタイプのアプライアンスは1つまたは多数存在する可能性があります。

ドメインをデプロイするには、空のアセンブリを手動で作成する必要があります。または、既存のアセンブリにアプライアンスを含めて接続を実行する必要があります。

B.11.6 接続

この項では、接続について説明します。

B.11.6.1 複数マシン接続

入力は、参照システムに存在するマシンごとに(それ自身を除く)マスター・アプライアンスで作成されます。これらは、マスター以外のアプライアンスでリハイドレーション時にマスター・アプライアンスの情報を取得するために必要です。

出力は、参照システムに存在するマシンごとに(それ自身を除く)マスター・アプライアンスに作成されます。これらは、マスター・アプライアンスでリハイドレーション時にマスター以外のアプライアンスの情報を取得するために必要です。対応する入力および出力もマスター以外のアプライアンスで作成されます。

これらの出力はすべて、デプロイ前にアプライアンスに接続する必要があります。出力および出力でサポートされるプロトコルの名前からは、出力の接続先となるアプライアンスのタイプに関するヒントが与えられます。

B.11.6.2 その他の入力および出力

入力は、見つかった次の構成タイプについてOracle Tuxedoアプライアンスで作成されます。

- WSL (Oracle Tuxedo WorkStationプロトコル)

- JSL (Oracle Jolt)

- ISL (Oracle Tuxedo IIOPプロトコル)

- ドメイン(Oracle Tuxedoドメイン・ゲートウェイ)

出力は、見つかった次の構成タイプについてOracle Tuxedoアプライアンスに作成されます。

- ドメイン(Oracle Tuxedoドメイン・ゲートウェイ)

- Oracle単一インスタンス・データベース

- TMA_SNA (Oracle Tuxedo Mainframe Adapter SNA)

- TSAM (Oracle TSAM)

これらの出力はすべて、デプロイ前に外部リソースまたはアプライアンスのいずれかに接続する必要があります。出力および出力でサポートされるプロトコルの記述からは、出力の接続先となるアプライアンスのタイプに関するヒントが与えられます。

B.11.7 接続プロパティ

すべての入力エンドポイントには、2つの編集可能なプロパティportおよびdescriptionと、1つの編集不可のプロパティprotocolsのリストがあります。protocolsは、入力に接続できる出力の種類を示します。

すべての出力エンドポイントには、1つの編集可能なプロパティdescriptionと、2つの編集不可のプロパティprotocolおよびsingletonがあります。protocolは、出力に接続できる入力の種類を示します。Singletonは、出力を接続できるアプライアンスの種類を示します。singletonがtrueの場合、出力を接続できるのは、スケーラビリティ最大絶対値が1のアプライアンスの入力のみです。

次のプロパティは、Oracle Tuxedoエンドポイントに固有です(表B-46から表B-48)。

表B-46 Oracle Tuxedo: アプライアンスの出力プロパティ: ドメイン

名前

型

必須

デフォルト

説明

existing-address

String

false

参照システムからのリモート・ドメインのアドレス。

このドメインの接続先となるリモート・ドメインのアドレスを指定します。出力を外部リソースに接続する場合のみ使用します。

TMA_SNAおよびTSAMの出力のみ、外部リソースに接続できます。

表B-47 Oracle Tuxedo: アプライアンスの出力プロパティ: TMA_SNA

名前

型

必須

デフォルト

説明

tma-sna-crm-host

String

false

参照システムからのリモートCRMサーバーのIPアドレス。

このマシンの接続先となるリモートCRMサーバーのIPアドレスを指定します。出力を外部リソースに接続する場合のみ使用します。

tma-sna-crm-port

String

false

参照システムからのリモートCRMサーバーのポート。

このマシンの接続先となるリモートCRMサーバーのポートを指定します。出力を外部リソースに接続する場合のみ使用します。

tma-sna-crm-address

String

false

参照システムからのリモートCRMサーバーの、16進形式のIPアドレスおよびポート。

このマシンの接続先となるリモートCRMサーバーの、16進形式のIPアドレスおよびポートを指定します。出力を外部リソースに接続する場合のみ使用します。

表B-48 Oracle Tuxedo: アプライアンスの出力プロパティ: TSAM

名前

型

必須

デフォルト

説明

tsam-manager-addr

String

false

参照システムからのリモートTSAMマネージャのIPアドレス。

このマシンの接続先となるリモートTSAMマネージャのIPアドレスを指定します。出力を外部リソースに接続する場合のみ使用します。

tsam-manager-port

String

false

参照システムからのリモートTSAMマネージャのポート

このマシンの接続先となるリモートTSAMマネージャのポートを指定します。出力を外部リソースに接続する場合のみ使用します。

B.11.8 Oracle Tuxedoアプライアンスのプロパティ

Oracle Tuxedoアプライアンスには、ユーザー・プロパティ(表B-49)およびシステム・プロパティ(表B-50)があります。

表B-49 Oracle Tuxedo: ユーザー・プロパティ

名前

型

必須

デフォルト

説明

ALOGPFX

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

ALOGRTNSIZE

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

ALTCC

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

ALTCCFLAGS

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

applicationEnvVars

String

false

なし

アプリケーションでは、このプロパティを使用してTuxedo以外の変数をカンマ区切りのキーワード/値のペアで指定することができます。たとえば、次のようにします。

CURRENCY=dollar,GROUPNAME=stdev,JDK=/my/jdk/path.

このプロパティは、ovab-application.propertiesファイルが$APPDIRディレクトリに存在する場合、このファイルによって移入されます。

applicationPassword

String

false

なし

Tuxedoアプリケーションでセキュリティを使用する(つまり、*RESOURCESがAPP_PW、USER_AUTH、ACLまたはMANDATORY_ACLに設定されている)場合、このユーザー・プロパティを設定して、再構成時に使用する新しいパスワードを取得する必要があります。

COBCPY

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

COBDIR

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

COBOPT

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

dbPassword

String

false

なし

TuxedoアプリケーションでOracleデータベース用にOPENINFOが設定されている場合、データベース・ユーザー名の置換値(OPENINFOのRMタイプのOracle_XA)。

たとえば、次のようにします。

OPENINFO値が「Oracle_XA: Oracle_XA+Acc=P/Scott/*****+SesTm=30+SqlNet=instance1」の場合、dbPasswordプロパティを設定できます。その場合、そのプロパティを使用して、新しい暗号化されたパスワードを再生成します。

dbUsername

String

false

なし

TuxedoアプリケーションでOracleデータベース用にOPENINFOが設定されている場合、データベース・ユーザー名の置換値(OPENINFOのRMタイプのOracle_XA)。

たとえば、次のようにします。

OPENINFO値が"Oracle_XA: Oracle_XA+Acc=P/Scott/*****+SesTm=30+SqlNet=instance1"の場合、dbUsernameプロパティを設定して"Scott"をターゲット・マシン用の別の値に変更できます。

FIELDTBLS

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

FIELDTBLS32

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

FLDTBLDIR

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

FLDTBLDIR32

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

FSCONFIG

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

FSMAXCOMMIT

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

FSMAXUPDATE

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

FSMSGREP

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

FSOFFSET

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

ISSANE

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

QMCONFIG

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

runtimeLoadLibraryPath

String

false

なし

環境の設定後にLD_LIBRARY_PATHの内容が移入されます。この文字列の形式は、ターゲット・システムで使用される実際のLD_LIBRARY_PATHと同じです。

shutdownScript

String

false

なし

ターゲット・マシンを(アンデプロイ後、またはOracle Virtual Assembly Builder stopコマンドの結果として)停止するときに使用されるtmshutdown -yコマンドのかわりに使用されるシャットダウン・スクリプトの名前。

startupScript

String

false

なし

ターゲット・マシンを(デプロイ後、またはOracle Virtual Assembly Builder startコマンドの結果として)起動するときに使用されるtmboot -yコマンドのかわりに使用される起動スクリプトの名前。

TAGENTLOG

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TM_CBL_IGNORE_CONTEXT

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TM_CPAU

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TM_ENGINE_TMSHMSEGSZ

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TM_GWT_OLDSECCHECK

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TM_ICU_COMPATIBILITY

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TM_LOG_ESYS

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TM_ORB_CLTMAXRTY

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TMCMPLIMIT

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TMCMPPRFM

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TMNETLOAD

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TMNOTHREADS

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TMSICACHEENTRIESMAX

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TMUSEIPV6

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TPMBACONV

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TPMBENC

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TUX_BLOCKLICIW

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

TUX_SSL_ENFORCECONSTRAINTSUINMEDSIGS

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

URLENTITYCACHEDIR

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

URLENTITYCATCHING

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

VIEWDIR

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

VIEWDIR32

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

VIEWFILES

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

VIEWFILES32

String

false

なし

Tuxedo環境変数。『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)に関する項を参照してください。

KIX_TS_DIR

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_TD_DIR

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_TD_QSPACE_DEVICE

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_TD_QSPACE_NAME

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_TD_QSPACE_IPCKEY

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_TECH_DIR

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_CWA_SIZE

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_CWA_IPCKEY

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_QSPACE_IPCKEY

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_TRACE_LEVEL

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

KIX_MAP_PATH

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

DATA

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

SPOOL

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

TMP

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

PROCLIB

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

MT_ACC_FILEPATH

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

MT_DB_LOGIN

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

MT_LOG

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

MT_TMP

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

MT_KSH

String

false

なし

Tuxedo ART CICS環境変数。『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』のCICS Runtime環境変数に関する項を参照してください。

表B-50 Oracle Tuxedoのシステム・プロパティ

名前

型

必須

デフォルト

説明

appdir

String

false

なし

アプリケーション・ディレクトリ。Tuxedoアプリケーション実行可能ファイルおよびTuxedoアプリケーション・ファイルの場所。

masterTuxconfig

String

false

なし

複数マシン・ドメイン内のマスター・マシン用のTUXCONFIGファイルの場所。これは、スケールアウト操作の実行に必要です。

masterTuxdir

String

false

なし

複数マシン・ドメイン内のマスター・マシン用のTUXDIRファイルの場所。これは、スケールアウト操作の実行に必要です。

model

String

false

なし

このアプライアンスが単一マシン・アプライアンス(SHM)か複数マシン・アプライアンス(MP)かを示します。

pmid

String

false

なし

このアプライアンスのOracle Tuxedo Machine識別子。

role

String

false

なし

アプライアンスが複数マシン・ドメインに属するときに、そのアプライアンスのタイプを限定するために、モデルとともに使用します。ロールは、"MASTER"、"BACKUP"または"SLAVE"のいずれかにできます。単一マシン・ドメインの場合は、常に"SLAVE"です。

tuxconfig

String

false

なし

イントロスペクトされたTUXCONFIGの値の保存に使用します。

tuxdir

String

false

なし

イントロスペクトされたTUXDIRの値の保存に使用します。

kixdir

String

false

なし

イントロスペクトされたKIXDIRの値の保存に使用します。

kixconfig

String

false

なし

イントロスペクトされたKIXCONFIGの値の保存に使用します。

jesdir

String

false

なし

イントロスペクトされたJESDIRの値の保存に使用します。

B.11.9 プラグインの拡張機能

なし。

B.11.10 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

B.12 汎用アプライアンス・プラグイン

汎用アプライアンスのイントロスペクション・プラグインにより、イントロスペクション時に指定されたスクリプトを使用して構成およびデプロイされるアプライアンスを作成できます。汎用アプライアンス・イントロスペクタのプラグインは、不透明なスタンドアロンの自己完結型製品またはアプリケーションのプロパティを読み取りおよび収集し、ユーザーによって指定された製品を構成する一連のファイルを取得します。プラグインの出力はアプライアンスです。

汎用アプライアンスでは、構成または製品の場所を取得するのに製品固有のプラグイン・コードを使用しません。かわりに、単純なアプライアンスを作成し、一連のユーザー指定プロパティ、パスおよびスクリプトを一般的な方法で追加します。作成時に渡された一連のスクリプトが、必要な操作を実行するためにデプロイ時に実行されます。

B.12.1 要件

汎用アプライアンスには、次の要件が適用されます。

B.12.1.1 ファイル・セットの指定

含まれるすべてのファイルおよびディレクトリとともに取得するディレクトリのリストを指定する必要があります。この機能により、インストール・バイナリ、構成およびデータを取得できます。

B.12.1.2 rootとしてのスクリプトの起動

すべてのスクリプトは、rootユーザーとして起動されます。これにより、汎用アプライアンス・スクリプトではroot権限が必要な操作の実行や、必要に応じた別のユーザーへの切替えに柔軟に対応できます。

B.12.2 結果のアーティファクト・タイプ

単一のアプライアンス。

B.12.3 汎用アプライアンス・プラグインのイントロスペクション・パラメータ

表B-51に、Oracle Databaseのイントロスペクション・パラメータを示します。

表B-51 汎用アプライアンス・プラグインのイントロスペクション・パラメータ

パラメータ

説明

productRoots

string型の1つ以上のコロン区切りのパスの必須リスト。各パスは、アプライアンスのeDefinition内でFileSetのルートになります。指定された各ルート内のすべてのファイルは、操作時に取得されます。各パスは、デプロイ時にVMのそれぞれのファイルシステムにマップされます。

propertyFile

省略可。プロパティ・ファイルの絶対パス。指定されたファイル内の各プロパティは、アプライアンス・メタデータでユーザー・プロパティになります。

scriptRootDir

省略可。スクリプトが取得されるルート・ディレクトリへのパス。スクリプトは、操作タイプに応じてこのルート・ディレクトリ内のサブディレクトリにあります。

B.12.4 プロパティ・ファイル

propertyFileパラメータを指定する場合、参照システムに存在し、読取り可能なファイルを参照する必要があります(それ以外の場合は失敗し、アプライアンスは作成されません)。

プロパティ・ファイルは、名前/値のペアのリストが含まれるテキスト・ファイルです。プロパティ・ファイル内の各プロパティは、ユーザー・プロパティとしてアプライアンスに追加されます。デプロイ時に、アプライアンスのユーザー・プロパティは、$AB_USERPROPS_FILE環境変数によって示される絶対パスのファイルに書き出されます。

プロパティ・ファイルはゼロ以上の行で構成され、各行はプロパティ宣言、コメントまたは空白行である必要があります。さらに正式には、プロパティ・ファイルは次の構文に準拠する必要があります。

例B-5 プロパティ・ファイルの構文

property-file   = *line
line            = prop-decl | comment | blank-line
prop-decl       = name "=" value NL
comment         = *WS "#" *CHAR NL
blank-line      = *WS NL
name            = name-start-char *name-body-char
name-start-char = <any character in "a".."z", "A".."Z", "_">
name-body-char  = <any character in "a".."z", "A".."Z", "0".."9", "_">
value           = *SHCHAR | SQ *SHCHAR SQ | DQ *SHCHAR DQ
NL              = <platform dependent line termination sequence>
WS              = <white space character>
CTL             = <any control character (octets 0 -31) and DEL (127)>
CHAR            = <any character, excluding CTL (and NL), but including WS>
SHCHAR          = <any CHAR, escaped as necessary for shell interpretation>
SQ              = <single quote>
DQ              = <double quote>

前述の構文規則に準拠していないプロパティ・ファイルはエラーとなり、アプライアンスは作成されません。プロパティ宣言は、1行で記述する必要があります。行をバックスラッシュ(\)で終わると、行は継続されません。

すべてのプロパティは、アプライアンス・メタデータで"required"のマークが付けられます。値が割り当てられていない("="の後に何もない)プロパティ宣言は、アプライアンス・メタデータでnullに設定されるため、デプロイ前にそのプロパティに値を割り当てる必要があります。

プロパティ宣言では、等号(=)の左側のどこにも空白を指定することができません。等号の右側の空白は、目的の値の一部であると見なされ、維持されます(そのため、値がソーシングされると失敗します)。

プロパティ値を囲む引用符は維持され、値の一部としてユーザーに表示されます。プロパティ値を編集するときは、シェルの解釈ルールに従って、ユーザーが必要に応じて引用符を追加、削除、維持します。

コメントおよび空白行は、デハイドレーション時に破棄され、リハイドレーション時にファイルが再生成されたときに再作成されません。

通常、汎用アプライアンス・スクリプトがプロパティ・ファイルをスクリプト環境に読み込みます。共通の使用パターンは、次のとおりです。

#!/bin/bash
#
# This script reconfigures the example server of the
# example product.
#
. $AB_USERPROPS_FILE
$ORACLE_HOME/bin/oim_reconfig.sh $OIM_INSTANCE

次に、有効なプロパティ・ファイルの内容のサンプルを示します。

# The following property must have a user supplied value
SHELL=
# This is a variable that should not be changed
PRODUCT_HOME=/my/install/will/not/move
PRODUCT_INSTANCE=/my/instance/will/also/not/move
PRODUCT_PROPERTY="Hello World"
# This is a mispelled variable name
TRUSTROTE=/path/to/file.jks

上のプロパティ・ファイルの例(一部の値のユーザー編集を含む)の場合、再構成時に、次のプロパティ・ファイルの内容が生成されます。

SHELL=/bin/bash
PRODUCT_HOME=/my/install/will/not/move
PRODUCT_INSTANCE=/my/instance/will/also/not/move
PRODUCT_PROPERTY="Yo, peoples of planet Earth!"
TRUSTROTE=/path/to/file.jks

B.12.4.1 スクリプト・ルート・ディレクトリ

スクリプト・ルート・ディレクトリは、スクリプト・サブディレクトリを格納する最上位のディレクトリです。指定されたディレクトリが存在しない場合または読み取ることができない場合は、エラーが返され、アプライアンスは作成されません。

ユーザー指定の再構成スクリプトは、スクリプト・ルート・ディレクトリ内の一般的なサブディレクトリ(config.d/、start.d/、ping.d/、stop.d/)下に入れる必要があります。各サブディレクトリ下のスクリプトは、デハイドレーション時に取得され、アプライアンスに格納されます。デハイドレーション時に、リクエストされた操作に応じて適切なスクリプト・セットが辞書式順序(/bin/lsと同じ順序)で実行されます。

次に、ユーザーが作成できるスクリプト・ディレクトリ・セットの例を示します。

/path/to/script/dirs/
config.d/
00config.sh
01.config.sh
start.d/
00start.sh
01start.sh
stop.d/
stop.sh
ping.d/
ping.sh

一般的なサブディレクトリのセット以外のスクリプト・ルート・ディレクトリにあるファイルまたはディレクトリは、デハイドレーション時に無視され、取得されません。

スクリプト・ルート・ディレクトリには、一般的なサブディレクトリをすべて含める必要はありません。一般的なサブディレクトリの省略は、その特定のフェーズにはスクリプトが不要であると想定されて、デハイドレーション時に無視されます。

一般的なサブディレクトリは空でもかまいません。空の場合、一般的なサブディレクトリは取得されません。

一般的なサブディレクトリには、汎用アプライアンス・プラグインによって起動されるスクリプトのみを格納する必要があります。一般的なサブディレクトリ内にディレクトリがあると、デハイドレーション時にエラーが生成され、アプライアンスは作成されません。他のすべてが取得され、汎用アプライアンスではデハイドレーション時にそれらを実行しようとします。データ・ファイル、構成ファイル、ビデオなどのファイルは、適切に実行できず、対応する操作全体が失敗する可能性が高いです。このようなファイルをより適切に取得するには、productRootsパラメータを使用します。

B.12.5 接続

汎用アプライアンスに対して接続は実行できません。

B.12.6 プラグインの拡張機能

なし。

B.12.7 サポートされるテンプレート・タイプ

サポートされるテンプレート・タイプは、Oracle Enterprise Linux (OEL)です。

C Oracle Virtual Assembly Builderコンポーネントの共通プロパティ

この付録では、Oracle Virtual Assembly Builderがイントロスペクトできるコンポーネントの共通プロパティと、デプロイメント用に指定できるその他のプロパティについて説明します。ここでは、次の項目について説明します。

- C.1項「共通プロパティ」

- C.2項「システム・プロパティ」

- C.3項「外部リソース・プロパティ」

- C.4項「デプロイヤ・プロパティ」

C.1 共通プロパティ

次のOCM関連のプロパティは、すべてのアプライアンスに共通です。

表C-1 OCM関連の共通プロパティ

名前

必須

デフォルト

説明

ocm.anonymousEmailRegistration.emailId

false

なし

MetaLinkアカウントに関連付けられていない電子メール・アドレスを使用してOCMに登録するのに使用する電子メール・アドレス。

ocm.metalinkCsiRegistration.CSI

false

なし

カスタマ・サポートIDを使用してデプロイメントを登録します。

ocm.metalinkCsiRegistration.countryCode

false

なし

CSIに関連付けられた2文字の国コード。

ocm.metalinkCsiRegistration.metalinkId

false

なし

CSIに関連付けられたMetaLink ID。

ocm.metalinkEmailRegistration.metalinkEmailId

false

なし

MetaLinkアカウントに関連付けられた電子メールIDを使用してデプロイメントを登録します。

ocm.metalinkEmailRegistration.metalinkPassword

false

なし

MetaLinkアカウントに関連付けられたパスワード。

ocm.proxyHost

false

なし

プロキシを介してOCM登録を行う必要がある場合に必須です。

ocm.proxyPassword

false

なし

プロキシを介してOCM登録を行う必要がある場合に必須です。

ocm.proxyPort

false

なし

プロキシを介してOCM登録を行う必要がある場合に必須です。

ocm.proxyUsername

false

なし

プロキシを介してOCM登録を行う必要がある場合に必須です。

ocm.repeaterURI

false

なし

構成済のOCMハブを使用して登録する場合に使用します。

ocm.runConfiguration

false

false

OCM登録を実行する場合は、trueに設定します。

C.2 システム・プロパティ

次のOCM関連のシステム・プロパティは、すべてのアプライアンスに共通です。ユーザーが変更することはできません。

表C-2 OCM関連のシステム・プロパティ

名前

必須

デフォルト

説明

ocm.ccrDirPath.0

true

サンプル値: /swat/middleware_ps1/utils/ccr

ユーザーが編集することはできません。

C.3 外部リソース・プロパティ

外部リソースは、Oracle WebLogic Serverドメインの接続先となるサービスを表します。

C.3.1 共通プロパティ

すべての外部リソース・アプライアンスには、表C-3で説明するプロパティ(hostnameはユーザー・プロパティ、external-applianceはシステム・プロパティ)があります。

表C-3 外部アプライアンス・テンプレート・プロパティ: 共通プロパティ

名前

型

必須

デフォルト

説明

hostname

String

false

なし

外部アプライアンスが表すサービスが存在するホスト名。

デフォルトでは、この値は外部アプライアンス・テンプレートに設定されていません。デプロイ前に値を指定する必要があります。

C.3.2 foreignJMSプロパティ

表C-4では、外部アプライアンスがOracle WebLogic Server管理サーバーの外部JMS出力に接続するためのプロパティについて説明します。

表C-4 foreignJMSプロパティ

名前

型

必須

デフォルト

説明

url

String

false

なし

外部JMSサーバーへの接続に使用されるURL。テンプレートに指定されていない場合は、Oracle WebLogic Serverドメインのデプロイ時に参照システムからの値が保持されます。

Password

String

false

なし

外部JMSサーバーへの接続に使用されるパスワード。テンプレートに指定されていない場合は、Oracle WebLogic Serverドメインのデプロイ時に参照システムからの値が保持されます。

C.3.3 jmsBridgeDestinationプロパティ

表C-5では、外部アプライアンスがOracle WebLogic Server管理サーバーのJMSメッセージ・ブリッジ出力に接続するためのプロパティについて説明します。

表C-5 jmsBridgeDestinationプロパティ

名前

型

必須

デフォルト

説明

url

String

false

なし

JMSブリッジ宛先サーバーへの接続に使用されるURL。テンプレートに指定されていない場合は、Oracle WebLogic Serverドメインのデプロイ時に参照システムからの値が保持されます。

Username

String

false

なし

JMSブリッジ宛先サーバーへの接続に使用されるユーザー名。テンプレートに指定されていない場合は、Oracle WebLogic Serverドメインのデプロイ時に参照システムからの値が保持されます。

Password

String

false

なし

JMSブリッジ宛先サーバーへの接続に使用されるパスワード。テンプレートに指定されていない場合は、Oracle WebLogic Serverドメインのデプロイ時に参照システムからの値が保持されます。

C.3.4 LDAPプロパティ

表C-6では、外部リソースがOracle WebLogic Server管理サーバーのLDAP出力に接続するためのプロパティについて説明します。

表C-6 LDAPプロパティ

名前

型

必須

デフォルト

説明

Username

String

false

なし

LDAPサーバーへの接続に使用されるユーザー名。テンプレートに指定されていない場合は、Oracle WebLogic Serverドメインのデプロイ時に参照システムからの値が保持されます。

Password

String

false

なし

LDAPサーバーへの接続に使用されるパスワード。テンプレートに指定されていない場合は、Oracle WebLogic Serverドメインのデプロイ時に参照システムからの値が保持されます。

C.3.5 Oracle JDBC以外のプロパティ

表C-7では、外部リソースがOracle WebLogic Server管理サーバーのOracle JDBC以外の出力に接続するためのプロパティについて説明します。

表C-7 Oracle JDBC以外のプロパティ

名前

型

必須

デフォルト

説明

url

String

false

なし

Oracle以外のデータベースへの接続に使用されるURL。テンプレートに指定されていない場合は、Oracle WebLogic Serverドメインのデプロイ時に参照システムからの値が保持されます。

C.3.6 JDBCプロパティ

表C-8では、外部リソースがOracle WebLogic Server管理サーバーのOracle JDBC出力に接続するためのプロパティについて説明します。

表C-8 JDBCプロパティ

名前

型

必須

デフォルト

説明

global-db-name

String

false

orcl

Oracleデータベースへの接続に必要なglobal-db-name。外部リソースのユーザー・プロパティに指定されていない場合、デプロイメントは失敗します。

C.4 デプロイヤ・プロパティ

Oracle Virtual Assembly Builderを使用すると、表C-9で説明するデプロイヤ・プロパティをdeployer.propertiesファイルを使用して構成できます。このファイルは、<deployer WLS domain dir>/ovab/configディレクトリにあります。

表C-9 deployer.propertiesで構成可能なデプロイヤ・プロパティ

名前

型

必須

デフォルト

説明

phoneHomeTimeout

String

false

900

phone homeリクエストのタイムアウト(秒)を構成します。

D トラブルシューティング

次の各項では、Oracle Virtual Assembly Builderのトラブルシューティングに関するテクニックについて説明し、トラブルシューティング項目を特定します。

- D.1項「一般的な問題」

- D.2項「イントロスペクションおよびファイル・セット取得の失敗」

- D.3項「テンプレート作成の失敗」

- D.4項「デプロイヤ通信の失敗」

- D.5項「登録の失敗」

- D.6項「デプロイメントの失敗」

- D.7項「ログの場所と説明」

D.1 一般的な問題

この項では、一般的な問題のトラブルシューティングについて説明します。

D.1.1 別のクライアントが稼働していることを示すエラー

abctlまたはabstudio.shを起動しようとしてこのエラーが表示され、稼働しているOracle Virtual Assembly Builderクライアントが他にないことを確認した場合、マシンでファイル・ロックが不足している可能性があります。

Oracle Virtual Assembly Builder Studioまたはabctlを使用して同時操作を実行しているときにも、このようなエラーが表示されることがあります。この問題を解決するには、ロックの解放が遅くなる環境上の問題がないかどうかをチェックしてください。

D.1.2 phone homeのタイムアウト

phone homeのタイムアウトをトラブルシューティングする手順は、次のとおりです。

1. Oracle Virtual Assembly Builderホストのファイアウォールがオフになっていることを確認します。
rootとして、次のコマンドを実行します。

$/sbin/service iptables status
$/sbin/service iptables stop

マシンの再起動時に自動的に起動するようにファイアウォールが構成されている場合があります。これを回避するには、次のコマンドを実行して完全にオフにします。

$/sbin/chkconfig iptables off

2. phone homeのデフォルトのタイムアウトは、15分です。タイムアウトは、<Deployer WLS domain root>/ovab/config/deployer/deployer.propertiesで増やすことができます。
このファイルが存在しない場合は、作成してphoneHomeTimeout=<number of seconds>のような行を追加します。

D.1.3 既存のアセンブリ・アーカイブ(OVAファイル)によるアセンブリの変更の妨害

アセンブリ用にアセンブリ・アーカイブを作成すると、そのアセンブリはロックされます。つまり、アーカイブを削除しないかぎり、形状、プロパティ、パッケージまたはテンプレートを変更できません。アーカイブは、abctl delete -archiveOnly -name <assembly name>を使用して削除できます。

D.2 イントロスペクションおよびファイル・セット取得の失敗

この項では、イントロスペクションおよびファイル・セット取得の問題のトラブルシューティングについて説明します。

D.2.1 VMのイントロスペクション

デプロイされた仮想マシン(VM)のイントロスペクションは、イントロスペクションに使用される一時ディレクトリがマウントされたNFS共有で、NFSファイルがロックされている場合、完了に失敗することがあります。この問題を回避するには、ロックをオフにしてNFSファイル・システムを再マウントします。

mount -o nolock example:/scratch /net/example/scratch

D.2.2 リモート操作の失敗

リモート操作のログは、リモート操作の最後にローカル・ディレクトリ$AB_INSTANCE/logs/remote_<remote machine name>/にコピーされます。たとえば、リモート・マシンがabc12345の場合、ログは$AB_INSTANCE/logs/remote_abc12345.example.com/に格納されます。

デフォルトのリモート作業ディレクトリは/tmp/abRemote_<remote username>ですが、これは、-remoteWorkingDirフラグを使用してオーバーライドできます。

D.2.2.1 リモート・マシンでipv6を実行中に発生する接続不可エラー

リモート・イントロスペクション/パッケージングを実行できず、「接続できません」エラーが表示される場合、1つの可能性として、リモート・マシンでipv6を実行しているのにsshd_configファイルが正しくないことが考えられます。

リモート・システムがipv6およびipv4を使用するように構成されている場合、次の行がsshd_configファイルに指定されている必要があります。

AddressFamily any

(AddressFamily inetではありません)

D.2.2.2 パスワード入力後のリモート操作のハング

リモート・パスワードの入力後にリモート操作がハングする場合、強制終了された前のリモート操作から残された孤立したリモート・プロセスによる可能性があります。リモート作業ディレクトリがリモート・プロセス下から移されると、この事象が発生する場合があります。リモート・マシンに移動して孤立したリモート・プロセスをすべて強制終了し、リモート作業ディレクトリをクリーンアップして再度リモート操作を試行してください。

リモート・プロセスは、次のように表示されます。

aime1    11662     1  0 11:51 ?        00:00:01 /tmp/user/abRemote_aime1/ab_home/jre/jre/bin/java
-Doracle.core.ojdl.logging.config.file=/tmp/user/abRemote_aime1/ab_instance/config/logging.xml
-Djava.util.logging.config.class=oracle.core.ojdl.logging.LoggingConfiguration
-Djava.security.egd=file:/dev/./your -Dassemblybuilder.spif.app=apps/remotingapp
-jar /tmp/kaw/abRemote_aime1/ab_home/jlib/oracle.as.assemblybuilder.spif_0.1.0.jar

D.2.2.3 ファイル権限の問題

リモート操作用に指定するリモート・ユーザーまたはsudoユーザーが参照インストールのファイルに対する読取り権限を持っていることを確認してください。

D.2.2.4 リモート接続の失敗

リモート操作(イントロスペクションおよびファイル・セット作成)が正常に機能するように、参照システムのSSHポート転送を有効にする必要があります。次のようにして、ssh構成ファイルをチェックします。

~/.ssh/config
/etc/ssh/ssh_config

指定したremoteUserのシェルがログイン時にstdout/stderrに出力する場合、次のエラーが発生することがあります。

Error: Error initializing the remote connection.
Caused by: OAB-90061: Unable to create connection to remote server.
Cause: Timed out trying to connect to IPV4 and IPV6 sockets.

リモート・ユーザーのプロファイルおよびrcファイルをチェックし、これを実行するロジックを取り除きます。あるいは、別のリモート・ユーザーを指定し、sudoUserパラメータを使用して参照インストールを調査/取得する権限を持つユーザーを指定します。

D.2.2.5 リモート・ファイル・セット取得の失敗

リモート作業ディレクトリには、ローカル・マシンに戻される前に、ファイル・セットの格納に使用できる十分なディスク領域が必要です。

D.3 テンプレート作成の失敗

テンプレート作成操作が失敗した場合、次のことをチェックします。

- イントール時またはインストール後、$ORACLE_HOME/oracleRoot.shをrootとして実行したことを確認します。

- modifyjeosがインストールされていることを確認します。

- ovaユーティリティがインストールされていることを確認します。

- 有効なベース・イメージ(System.img)およびvm.cfgファイルがあることを確認します。ファイル権限が正しいことを確認します。

- ディスク領域が不足していないことを確認します。

- 取得するファイル・セットに対してループ・デバイス数が十分であることを確認します。D.3.1項「不十分なループ・デバイス数」を参照してください。

D.3.1 不十分なループ・デバイス数

大量のファイル・セットがある一般製品のテンプレートを作成するにはOracle Virtual Assembly BuilderホストのLinuxループ・デバイス数が足りないという問題が発生する場合があります。

テンプレートの作成時、Oracle Virtual Assembly Builderおよびmodifyjeosでは、テンプレートのディスクごとに使用可能なLinuxループ・デバイスが1つ(つまり、System.imgおよびAB.imgのそれぞれに1つと、製品ディスクごとに1つ)必要です。一般的なOracle Linuxシステムには、ループ・デバイスが7つしかありません。つまり、最大5つのファイル・セットがあるテンプレートに対してテンプレートを作成できます。

ファイル・セットがそれより多いアプライアンスのテンプレートを作成するには、ループ・デバイスを追加作成する必要があります。これを実行する方法は、次のとおりです。

1. /etc/modprobe.confを編集します。次のような行を追加します。

options loop max_loop=<n>

<n>は、作成するループ・デバイスの数です。

2. rootとして次のコマンドを実行し、Linuxカーネル・ループ・モジュールをアンロードおよびリロードします。

# /sbin/modprobe -r loop
# /sbin/modprobe -v loop

3. 新しいループ・デバイスが作成されたことを確認します。

$ ls -l /dev/loop*

<n>個のループ・デバイスが見つかります。

D.4 デプロイヤ通信の失敗

この項では、デプロイヤ通信の失敗のトラブルシューティングについて説明します。

D.4.1 無効なデプロイヤ・レスポンスが返される

次のエラーが発生することがあります。

Caused by: Invalid deployer response returned.
Cause: OAB-113409 - An invalid response was returned by the deployer.
Action: OAB-113409 - Please check the deployer log for additional details.

デプロイヤをホストするOracle WebLogic Serverのデプロイメントをチェックし、デプロイヤ・アプリケーションの状態が「アクティブ」であり、ヘルスが「OK」であることを確認します。

D.4.2 デプロイヤからの401/403エラー

デプロイヤとやり取りしようとして401/403エラーが発生した場合、デプロイヤをホストするOracle WebLogic Serverのコンソールで次の項目をチェックします。

1. 「デプロイメント」 > デプロイヤに移動し、セキュリティ・モデルが「CustomRoles」であることを確認します。

2. 「デプロイメント」 > デプロイヤ > [セキュリティ] > [ロール] > 「Application Admin」に移動し、条件にCloud AdminsグループまたはApplication Adminsグループが含まれていることを確認します。

3. 「デプロイメント」 > デプロイヤ > [セキュリティ] > [ロール] > 「Cloud Admin」に移動し、条件にCloud Adminsグループが含まれていることを確認します。

4. 「セキュリティ・レルム」 > 「myrealm」 > [ユーザーとグループ] > [グループ]に移動し、「Application Admins」と「Cloud Admins」が存在し、DefaultAuthenticatorによって処理されることを確認します。

5. 「セキュリティ・レルム」 > 「myrealm」 > [ユーザーとグループ] > [ユーザー]に移動し、「applicationAdmin」と「cloudAdmin」が存在し、DefaultAuthenticatorによって処理されることを確認します。

6. 「デプロイメント」 > デプロイヤ > [セキュリティ] > [URLパターン]に移動し、root url-patternにロール定義がないことを確認します。

7. クライアントで接続を作成するときに、ユーザー名が手順5で示した2つのうちのいずれかであり、そのユーザーのパスワードとともに指定されていることを確認します。

D.5 登録の失敗

登録が応答なしになった場合、次のことをチェックします。

- 登録がまったく成功していない場合は、Oracle VMコンソールを直接使用(Oracle Virtual Assembly Builderをバイパス)してテンプレートの登録を試みます。この方法が成功しない場合、問題はOracle VM環境にあります。

- 非常に大規模なアセンブリ・アーカイブがあるか、ネットワークが低速の場合、デプロイヤが実行されているOracle WebLogic ServerとOracle VM Managerが実行されているOracle WebLogic Serverの両方について、「スタック・スレッド最大時間」設定の増加が必要なことがあります。管理コンソールで、サーバーの「チューニング」タブを使用してこの設定にアクセスします。

D.6 デプロイメントの失敗

この項では、デプロイメントの失敗のトラブルシューティングについて説明します。

Studioログまたはデプロイヤ・ログから失敗の原因を特定できない場合、調査を続行する必要があります。Oracle VM Managerコンソールにログインし、アセンブリのVMが作成および起動されているかどうかを確認します。

D.6.1 VMが作成されない

VMが作成されなかった理由を示すものがないか、デプロイヤと、Oracle VMおよびOracle VM Serverのログをチェックします。

注意:

特にOracle Virtual Assembly Builder以外でクリーンアップ・タイプのアクティビティがOracle VM環境で実行された場合、デプロイヤの状態キャッシュがOracle VM環境と同期しなくなる可能性があります。アセンブリがOracle VM環境から実際には削除されている場合に、デプロイヤでは登録またはデプロイされていると記録されていることがあります。この事象が発生した場合、Oracle Virtual Assembly Builderを使用してアーカイブを登録解除およびアンデプロイしてから、もう一度登録およびデプロイする必要があります。

D.6.2 VMが作成されたが実行されない

VMが作成されたのに実行されない場合、次の手順を実行します。

1. VMが起動されなかった理由を示すものがないか、デプロイヤと、Oracle VMおよびOracle VM Serverのログをチェックします。

2. 手動によるVMの起動を試み、有効な出力が得られるかどうかを確認します。

1. 失敗したVMを作成したOracle VM Serverマシンにログインします(Oracle VM Managerコンソールから、プール内のどのマシンがVMを所有しているかを確認できます)。

2. 問題のVMのvm.cfgを探します。このファイルは/OVS/Repositories下のどこかにあり、Oracle VMコンソールからのIDがパスに含まれています。

3. xm create -f <vm.cfg file>コマンドを使用してVMを起動します。

3. ディスク・イメージのマウントを試み、ログが作成されるかどうかを確認します。(これは、VMが起動した後、なんらかの理由で停止した場合が考えられます)。Oracle Enterprise Linuxイメージは複数のディスクで構成されます。AB.img、System.img、Product_001.imgなど、該当するディスクをマウントする必要があります。

1. Oracle Virtual Assembly BuilderログはAB.imgディスクにあります。ただし、Oracle VM環境に登録されると、そのイメージの名前は変わります。新しい名前になったイメージの場所を探すには、vm.cfgを見つける必要があります。このファイルは/OVS/Repositories下のどこかにあり、Oracle VMコンソールからのVM IDがパスに含まれています。

2. 見つかったイメージ・ファイルへのパスを使用して、ループ・デバイスを特定します。

#kpartx -a <path to img file>
#kpartx -l <path to img file>

3. 前のコマンドのリスト出力から、どのループ・デバイスがディスクにマップされているかを特定できます。ディスクをマウントし、ループ・デバイスを指定します。

#mount /dev/mapper/loop?p? /mnt

上の最初の疑問符(?)はループ・デバイス数を表し、通常ゼロですが異なる数値でもかまいません。2番目の疑問符はパーティション番号で、通常ゼロですが異なる数値でもかまいません。

4. /mntに移動し、ファイルを調べます。再構成がログの作成に十分である場合、AB.imgのにログは/mnt/logsにあります。

5. 次のように入力します。

#umount /dev/mapper/loop?p?
#kpartx -d AB.img

D.6.3 VMが作成および実行されたがpingできない

マシンのネットワーク構成がなんらかの理由で正常に完了しませんでした。DHCPを使用している場合は、Oracle VM環境でDHCPをサポートしていることを確認します。静的IPアドレスを使用している場合は、対応するホスト名をデプロイメント・プランに指定していることも確認します。この指定は必須です。

次のネットワーク関連プロパティをすべてデプロイメント・プランに指定する必要があります。

- アセンブリ・レベル

- network_name (ターゲット(Oracle VM)環境のネットワーク名と一致する必要あり)

- 各アプライアンスのネットワーク・プロパティ内

- hostname (静的IPを使用する場合)

- default-gateway

- dns-domains (1つのみサポート)

- dns-servers (1つのみサポート)

- 各アプライアンスのネットワーク・インタフェース(NIC)ごと

- ip_address (静的IPを使用する場合)

- netmask

- usedhcp (静的IPを使用する場合はfalse)

D.6.3.1 pingできない実行中のVMへのアクセス方法

VMにアクセスする手順は、次のとおりです。

1. 失敗したVMを作成したOracle VM Serverマシンにログインします(Oracle VM Managerコンソールから、プール内のどのマシンがVMを所有しているかを確認できます)。

2. xm listコマンドを実行します。

3. 返されたリストでVMを探します。Oracle VM ManagerコンソールでVM IDを探します。

4. xm console <VM ID>コマンドを実行し、[Enter]を押して資格証明(user: root、password: テンプレート作成時に指定したパスワード)を指定します。

D.6.3.2 ネットワーク構成の失敗のトリアージ

失敗をトリアージする手順は、次のとおりです。

1. /assemblybuilder/logs下のログをチェックします。ログがない場合は、次の手順を続行します。

2. abサービスがインストールされたかどうかを確認します。abサービスは、/etc/init.d/abにインストールされます。そこにない場合は、oraclevm-templateサービス・ログ/var/log/oraclevm-templateを調べます。oraclevm-templateサービスによって、abサービスはインストールされます。
abサービスがない場合、ORACLE_HOMEのab_service.shおよびoraclevm-template.shに対する権限が正しいことを確認します。これらのファイルは、実行可能です。実行可能でない場合は、権限を修正し、アセンブリ・アーカイブを再作成してアップロードおよび登録し、デプロイを再試行します。

3. 遅延バインドが正しくない、またはVMに送信されなかったと考えられる場合は、/assemblybuilder/etc/vmapi get +コマンドを実行できます。
このコマンドにより、遅延バインドが出力されます。

D.6.3.3 VMが作成および起動されpingできる

VMが起動しpingできる場合、VMのネットワーク構成は正常に完了しました。

1. 失敗したVMにログインして、/assemblybuilder/logs下のログをチェックします。ログ・セクションで、各種ログ・ファイルの内容に関する詳細を確認します。rootユーザーおよびテンプレートの作成時に指定したパスワードを使用して、マシンへのsshを実行できる必要があります。

2. 遅延バインドが正しくない、またはVMに送信されなかったと考えられる場合は、/assemblybuilder/etc/vmapi get +コマンドを実行できます。
このコマンドにより、遅延バインドが出力されます。

D.7 ログの場所と説明

この項には、ログの場所と説明が記載されています。複数の異なるログとログの場所がありますが、これらは失敗をトリアージする時期を知るのに役立ちます。

D.7.1 Studioログ

Studioログのログ・レベルは、$AB_INSTANCE/config/logging.xmlを編集して変更することができます。目的のレベルを指定して次の行を変更します。

<logger name="oracle.as.assemblybuilder" level="FINE">

ローカル・ログ

$AB_INSTANCE/logs/assemblybuilder.log

$AB_INSTANCE/logs/bottler/* - テンプレート作成時に使用されるmodifyjeosツールからの出力

リモート・ログ

リモート操作のログは、リモート操作の最後にローカル・ディレクトリ$AB_INSTANCE/logs/remote_<remote machine name>/にコピーされます。たとえば、リモート・マシンがabc12345の場合、ログは$AB_INSTANCE/logs/remote_abc12345.example.com/に格納されます。

デフォルトのリモート作業ディレクトリは/tmp/abRemote_<remote username>ですが、これは、-remoteWorkingDirフラグを使用してオーバーライドできます。

D.7.2 デプロイヤ・ログ

デプロイヤ・アプリケーション・ログ・メッセージは、デプロイヤ・アプリケーションがデプロイされたWLSのサーバー・ログまたはドメイン・ログ、あるいはその両方にあります。また、Oracle WebLogic Serverのstdout/stderrにも関連情報やスタック・トレースが含まれることがあります。

<Deployer WLS domain root>/servers/<server targeted by Deployer app>/logs/*

D.7.3 Oracle VMログ

Oracle VM

/u01/app/oracle/ovm-manager-3/machine1/base_adf domain/servers/AdminServer/logs/AdminServer.log

Oracle VM Server

/var/log/ovs-agent.log

D.7.4 VMインスタンスのログ

/assemblybuilder/logs/ab.out - Oracle Virtual Assembly Builderインフラストラクチャ・コードおよびプラグイン・コードからのstdout/stderrおよび進捗メッセージ

/assemblybuilder/logs/assemblybuilder.log - Oracle Virtual Assembly Builderインフラストラクチャ・コードおよびプラグイン・コードからのログ・メッセージ

/assemblybuilder/logs/command.out - RehydrateUtils.runCommand()メソッドまたはrunCommandAs()メソッドを使用して起動されたコマンドの環境およびコマンド詳細

/assemblybuilder/logs/proc.<unique>.log - 渡されたdaemonフラグがtrueだったRehydrateUtils.runCommand()またはrunCommandAs()を使用して起動されたプロセスからのstdout/stderr

E サード・パーティ・ライセンス

この付録には、サード・パーティ・ライセンス情報が掲載されています。ここでは、次の項目について説明します。

- E.1項「Java Secure Channel (JSCH) for SSH2」

- E.2項「JViews Diagrammer」

- E.3項「Velocity Engine」

- E.4項「Commons Compress」

- E.5項「JSON in Java」

E.1 Java Secure Channel (JSCH) for SSH2

バージョン: 0.1.44

ベンダー: Atsuhiko Yamanaka, JCraft,Inc.

JSch 0.0.*は、GNU LGPLライセンスに基づいてリリースされました。その後、BSDスタイルのライセンスに切り替えられました。

------------------------------------------------------------------------------

Copyright (c) 2002-2011 Atsuhiko Yamanaka, JCraft,Inc.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. The names of the authors may not be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JCRAFT, INC. OR ANY CONTRIBUTORS TO THIS SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

E.2 JViews Diagrammer

バージョン8.5。

ベンダー: ILOG。

なし。

E.3 Velocity Engine

バージョン: 1.6.4

ベンダー: Apache Software Foundation。

この製品は、Apache 2.0のライセンス契約に基づいてライセンスが供与されています。E.3.1項「Apache License Version 2.0」を参照してください。

E.3.1 Apache License Version 2.0

次の条件は、Apache 2.0 Licenseに基づいてライセンスが供与されているすべての製品に適用されます。

Apache License, Version 2.0 (以下、「ライセンス」)に準拠しないかぎり、指定されたファイルを使用できません。

ライセンスのコピーは、http://www.apache.org/licenses/LICENSE-2.0で入手できます。また、このライセンスのコピーの複製を次に示します。

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and limitations under the License.

Apache License

Version 2.0, January 2004

http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.

"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.

You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!)The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.

Copyright © 1999-2002 The Apache Software Foundation. All rights reserved.; and (ii) the following statement "This product includes software developed by the Apache Software Foundation (http://www.apache.org/)."

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

E.4 Commons Compress

バージョン1.1。

ベンダー: Apache Software Foundation。

E.4.1 Apache License Version 2.0

次の条件は、Apache 2.0 Licenseに基づいてライセンスが供与されているすべての製品に適用されます。

Apache License, Version 2.0 (以下、「ライセンス」)に準拠しないかぎり、指定されたファイルを使用できません。

ライセンスのコピーは、http://www.apache.org/licenses/LICENSE-2.0で入手できます。また、このライセンスのコピーの複製を次に示します。

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and limitations under the License.

Apache License

Version 2.0, January 2004

http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.

"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.

You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!)The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.

Copyright © 1999-2002 The Apache Software Foundation. All rights reserved.; and (ii) the following statement "This product includes software developed by the Apache Software Foundation (http://www.apache.org/)."

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

E.5 JSON in Java

バージョン: なし。

ベンダー: JSON.org。

Copyright (c) 2002 JSON.org

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

The Software shall be used for Good, not Evil.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 作成者または著作権者は、契約行為または不法行為などの別を問わず、本ソフトウェアに起因もしくは関連するか、または本ソフトウェアの使用もしくはその他の扱いによって生じる一切の請求、損害、その他の義務に対して責任を負いません。

索引
A  C  D  E  G  H  I  M  O  P  R  S  T  U  V

A

abctlコマンド, A

addAssemblyUsers, A.1.1

addTargetUser, A.1.2

connectEndpoints, A.1.4, A.1.5

createAssembly, A.1.6

createAssemblyArchive, A.1.7

createAssemblyInstance, A.1.8

createDeployerConnection, A.1.9

createEMConnection, A.1.10

createExternalResources, A.1.11

createTags, A.1.12

createTarget, A.1.13

createTemplate, A.1.14

delete, A.1.15

deleteAssemblyArchive, A.1.16

deleteAssemblyInstance, A.1.17

deleteDeployerConnection, A.1.18

deleteEMAssemblyArchive, A.1.20

deleteEMConnection, A.1.19

deleteFailedAssemblyInstances, A.1.21

deleteRequests, A.1.22

deleteTags, A.1.23

deleteTarget, A.1.24

deployAssemblyInstance, A.1.25

describeApplianceInstances, A.1.26

describeAssemblyArchives, A.1.27

describeAssemblyInstances, A.1.28

describeAssemblyUsers, A.1.29

describeCatalog, A.1.30

describeDeployer, A.1.31

describeDeployerConnections, A.1.32

describeDeploymentPlans, A.1.33

describeEMAssemblyArchives, A.1.34

describeEMConnection, A.1.35

describeEndpoints, A.1.36

describeRegistrations, A.1.37

describeRequests, A.1.38

describeScalingGroups, A.1.39

describeTags, A.1.40

describeTargetConfigurations, A.1.41

describeTargetNames, A.1.42

describeTargets, A.1.44

describeTargetUsers, A.1.43

describeUserTargets, A.1.45

describeVnets, A.1.46

downloadAssemblyArchive, A.1.47

downloadAssemblyMetadata, A.1.48

downloadEMAssemblyArchive, A.1.49

export, A.1.50

getDefaultTarget, A.1.51

getTargetType, A.1.52

help, A.1.53

import, A.1.54

importExternalTemplate, A.1.55

introspectCoherenceWeb, A.1.56

introspectForms, A.1.57

introspectGenericProd, A.1.58

introspectOHS, A.1.59

introspectRACDB, A.1.61

introspectReports, A.1.62

introspectSIDB, A.1.63

introspectSOA, A.1.64

introspectTuxedo, A.1.65

introspectWebCache, A.1.66

introspectWLS, A.1.67

redeployAssemblyInstance, A.1.68

registerAssemblyArchive, A.1.69

removeAssemblyUsers, A.1.70

removeTargetUsers, A.1.71

restartAssemblyInstance, A.1.72

scale, A.1.73

setDefaultTarget, A.1.74

startAssemblyInstance, A.1.75

stopAssemblyInstance, A.1.76

undeployAssemblyInstance, A.1.77

unregisterAssemblyArchive, A.1.78

updateAssemblyArchive, A.1.79, A.1.80

uploadAssemblyArchive, A.1.81

uploadAssemblyResources, A.1.82

uploadEMAssemblyArchive, A.1.83

abctl help, A.2.1 addAssemblyUsers, A.1.1 addTargetUser, A.1.2 アプライアンス, 1.1.4

外部, 1.2.7

アセンブリ, 1.2.2 アセンブリ, 1.1.5

新規作成, 5.3.1.4

編集, 1.1.3, 5.3.4

空, 5.3.1.4

アセンブリ・エディタ, 1.1.6 アセンブリ・ステータスの概要, 5.3.2.2, 5.3.3.3.1

C

captureFileSets, A.1.4

ファイル・セットの取得, 1.2.8

カタログ, 1.2.6, 1.2.6

カタログ・ナビゲータ, 5.3.1.4.5

概念, 1

connectEndpoints, A.1.5

接続

作成, 5.3.4.1

createAssembly, A.1.6 createAssemblyArchive, A.1.7 createAssemblyInstance, A.1.8 createDeployerConnection, A.1.9 createEMConnection, A.1.10 createExternalResources, A.1.11 createTags, A.1.12 createTarget, A.1.13 createTemplate, A.1.14 接続の作成, 5.3.4.1

D

delete, A.1.15

deleteAssemblyArchive, A.1.16

deleteAssemblyInstance, A.1.17

deleteDeployerConnection, A.1.18

deleteEMAssemblyArchive, A.1.20

deleteEMConnection, A.1.19

deleteFailedAssemblyInstances, A.1.21

deleteRequests, A.1.22

deleteTags, A.1.23

deleteTarget, A.1.24

deployAssemblyInstance, A.1.25

デプロイ, 1.1.7.4

デプロイメント・プラン, 1.2.10

describeApplianceInstances, A.1.26

describeAssemblyArchives, A.1.27

describeAssemblyInstances, A.1.28

describeAssemblyUsers, A.1.29

describeCatalog, A.1.30

describeDeployer, A.1.31

describeDeployerConnections, A.1.32

describeDeploymentPlans, A.1.33

describeEMAssemblyArchives, A.1.34

describeEMConnection, A.1.35

describeEndpoints, A.1.36

describeRegistrations, A.1.37

describeRequests, A.1.38

describeScalingGroups, A.1.39

describeTags, A.1.40

describeTargetConfigurations, A.1.41

describeTargetNames, A.1.42

describeTargets, A.1.44

describeTargetUsers, A.1.43

describeUserTargets, A.1.45

describeVnets, A.1.46

downloadAssemblyArchive, A.1.47

downloadAssemblyMetadata, A.1.48

downloadEMAssemblyArchive, A.1.49

E

エンドポイント, 1.2.2

入力, 1.2.2

出力, 1.2.2

export, A.1.50 外部システム, 1.1.5

G

getDefaultTarget, A.1.51

getTargetType, A.1.52

H

help, A.1.53

I

import, A.1.54

importExternalTemplate, A.1.55

インストール

概要, B.1.4.1.1

introspectCoherenceWeb, A.1.56 introspectForms, A.1.57 introspectGenericProd, A.1.58 イントロスペクション, 1.1.7.1

プロパティ, 5.3.1.4.3

リモート, 5.3.1.4

コンポーネントの選択, 5.3.1.4

イントロスペクション・ウィザード, 5.3.1.5 introspectOHS, A.1.59 introspectRACDB, A.1.61 introspectReports, A.1.62 introspectSIDB, A.1.63 introspectSOA, A.1.64 introspectTuxedo, A.1.65 introspectWebCache, A.1.66 introspectWLS, A.1.67

M

メタデータ

アプライアンス, 1.2.2

O

Oracle Virtual Assembly Builder

概要, 1.1

ライフ・サイクル, 1.2.12

P

プロパティ・インスペクタ, 5.3.4.2

プロパティ・インスペクタ, 1.1.6

R

redeployAssemblyInstance, A.1.68

registerAssemblyArchive, A.1.69

removeAssemblyUsers, A.1.70

removeTargetUsers, A.1.71

要件

Oracle Internet Directory, B.1.4.1.1

restartAssemblyInstance, A.1.72

S

scale, A.1.73

setDefaultTarget, A.1.74

スプロール化, 1.1.2

startAssemblyInstance, A.1.75

stopAssemblyInstance, A.1.76

T

テンプレート

作成, 5.3.3.3

既存, 5.3.3.3.1

再作成, 5.3.3.3.1

U

undeployAssemblyInstance, A.1.77

unregisterAssemblyArchive, A.1.78

updateAssemblyArchive, A.1.79, A.1.80

uploadAssemblyArchive, A.1.81

uploadAssemblyResources, A.1.82

uploadEMAssemblyArchive, A.1.83

V

仮想マシン, 1.2.9

仮想化, 1.1.1

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2014, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

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の登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

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

保証免責

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

制限付権利

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

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）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

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

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。