1 概要とロードマップ

この章では、このWebLogic Server 12.1.3ガイド(『WebLogic Scripting Tool 12.1.3の理解』)の内容と構成について説明します。

この章の内容は次のとおりです。

ドキュメントのスコープと対象読者
このドキュメントの手引き
関連ドキュメント
WLSTサンプル・スクリプト

ドキュメントのスコープと対象読者

このドキュメントでは、Oracle WebLogic Scripting Tool (WLST)について説明します。また、WLSTコマンドライン・スクリプト・インタフェースを使用して、WebLogic ServerのインスタンスおよびWebLogicドメインの構成、管理、およびこれらへの変更の永続化を行い、サーバー実行時イベントをモニターおよび管理する方法を説明します。

このドキュメントは、Java Platform、Enterprise Edition (Java EE)を使用してJava EEアプリケーションをデプロイする、WebLogic Serverの管理者およびオペレータを対象としています。読者は、Webテクノロジ、およびWebLogic Serverがインストールされているオペレーティング・システムとプラットフォームに精通していることが前提となっています。

このドキュメントの手引き

このドキュメントの構成は次のとおりです。

この章「概要とロードマップ」では、このガイドの構成および関連ドキュメントについて説明します。
第2章「WebLogic Scripting Toolの使用」では、このスクリプト・ツールのしくみ、操作モード、およびこれを呼び出すための基本的な手順について説明します。
第3章「WLSTオフラインを使用したWebLogicドメインの作成」では、実行中のWebLogic Serverへ接続することなく(つまり、WLSTオフラインを使用して)、新規WebLogicドメインを作成したり既存WebLogicドメインを更新したりする方法について説明します。これは、構成ウィザードと同じ機能をサポートしています。
第4章「サーバーのライフサイクルの管理」では、WLSTを使用したWebLogic Serverインスタンスの起動および停止と、サーバーのライフサイクルのモニターおよび管理について説明します。
第5章「MBeanのナビゲート(WLSTオンライン)」では、WebLogicドメインの構成および実行時の情報を取得して、構成MBeanまたはカスタムMBeanを編集する方法について説明します。
第6章「既存のWebLogicドメインの構成」では、スクリプトを使用しての、WebLogicドメイン、サーバー、およびリソースの作成と管理の自動化について説明します。
第7章「デプロイメント・プランの更新」では、WLSTを使用したアプリケーションのデプロイメント・プランの更新について説明します。
第8章「実行時情報の取得」では、WLSTを使用してWebLogic Serverインスタンスの実行時状態に関する情報を取得する方法について説明します。
付録A「WLSTデプロイメント・オブジェクト」では、デプロイメント・プランを更新したり、現在のデプロイメント・アクティビティに関する情報にアクセスしたりするのに使用できる、WLSTデプロイメント・オブジェクトについて説明します。
付録B「FAQ : WLST」では、一般的な質問と回答のリストを示します。

WLSTサンプル・スクリプト

以下の節では、付加的なスクリプトを作成する際のテンプレートとして実行または使用できる、WLSTオンラインおよびオフラインのサンプル・スクリプトについて説明します。スクリプトの実行については、「スクリプトの実行」を参照してください。

注意:

サンプル・スクリプトはデフォルトではインストールされていません。サーバー・サンプルをインストールするには、WebLogic Serverをインストールする際に付属サンプル・オプションを選択する必要があります。

WLSTオンライン・サンプル・スクリプト

WLSTオンライン・サンプル・スクリプトは、実行中のサーバーに接続して、管理タスクを実行し、WebLogic Server構成の変更を開始する方法を示します。WLSTオンライン・スクリプトは、ORACLE_HOME\user_projects\applications\wl_server\examples\src\examples\wlst\onlineディレクトリに格納されています。

表1-1は、WLSTオンライン・サンプル・スクリプトの概要を示します。

表1-1 WLSTオンライン・サンプル・スクリプト

WLSTサンプル・スクリプト	説明
cluster_creation.py	WLSTから管理サーバーに接続し、編集セッションを開始し、10個の管理対象サーバーを作成します。その後、2つのクラスタを作成し、サーバーを各クラスタに割り当て、WLSTとサーバーの接続を解除します。
cluster_deletion.py	`cluster_creation.py`で作成したクラスタおよびサーバーを削除します。
configJMSSystemResource.py	WLSTから管理サーバーに接続して編集セッションを開始し、2つのJMSサーバーを作成した後でそれらを管理サーバーにターゲット指定します。その後、JMSシステム・モジュール内に、JMSトピック、JMSキュー、およびJMSテンプレートを作成します。JMSキューおよびJMSトピックは、サブデプロイメントを使用してターゲット指定されます。
deleteJMSSystemResource.py	`configJMSSystemResource.py`で作成したJMSシステム・モジュールを削除します。
jdbc_data_source_creation.py	WLSTから管理サーバーに接続し、編集セッションを開始し、`myJDBCDataSource`というJDBCデータ・ソースを作成します。
jdbc_data_source_deletion.py	`jdbc_data_source_creation.py`で作成したJDBCデータ・ソースを削除します。

WLSTオフライン・サンプル・スクリプト

WLSTオフライン・サンプル・スクリプトは、ソフトウェアと一緒にインストールされたドメイン・テンプレートを使用してWebLogicドメインを作成する方法を示します。WLSTオフライン・スクリプトは、ORACLE_HOME\wlserver\common\templates\scripts\wlstディレクトリに格納されています。

表1-2 WLSTオフライン・サンプル・スクリプトの概要

表1-2 WLSTオフライン・サンプル・スクリプト

WLSTサンプル・スクリプト	説明
`basicWLSdomain.py`	ドメイン・テンプレートを開き、構成オブジェクトを作成および編集し、指定したディレクトリにドメイン構成情報を書き込む方法を示す、単純なWebLogicドメインを作成します。このサンプルは、一般的な開発環境を表す単一のサーバーで構成されています。このタイプの構成は、本番環境では推奨されません。このスクリプトでは、Basic WebLogic Server Domainテンプレートを使用します。
`basicWLSSdomain.py`	Basic WebLogic SIP Server Domainテンプレートを使用して、簡単なWebLogic SIP Serverドメインを作成します。スクリプトでは、ドメイン・テンプレートの開き方、構成オブジェクトの作成および編集方法、指定したディレクトリへのドメイン構成情報の書込み方法が示されます。このサンプルは、一般的な開発環境を表す単一のサーバーで構成されています。このタイプの構成は、本番環境では推奨されません。
`clusterMedRecDomain.py`	3つの管理対象サーバーを作成してそれらをクラスタに割り当て、単一クラスタのWebLogicドメインを作成します。このスクリプトはBasic WebLogic Server DomainテンプレートをAvitek Medical Records Sample拡張テンプレートで拡張して使用します。
`distributedQueue.py`	分散キューを作成する2つの方法を示します。このスクリプトはBasic WebLogic Server DomainテンプレートをAvitek Medical Records Sample拡張テンプレートで拡張して使用します。
`geo1Domain.py`	Geographic Redundancy Site 1 Domainテンプレートを使用して、簡単なWebLogic SIP Serverドメインを作成します。スクリプトでは、ドメイン・テンプレートの開き方、構成オブジェクトの作成および編集方法、指定したディレクトリへのドメイン構成情報の書込み方法が示されます。このサンプルは、一般的な開発環境を表す単一のサーバーで構成されています。このタイプの構成は、本番環境では推奨されません。
`geo2Domain.py`	Geographic Redundancy Site 2 Domainテンプレートを使用して、簡単なWebLogic SIP Serverドメインを作成します。スクリプトでは、ドメイン・テンプレートの開き方、構成オブジェクトの作成および編集方法、指定したディレクトリへのドメイン構成情報の書込み方法が示されます。このサンプルは、一般的な開発環境を表す単一のサーバーで構成されています。このタイプの構成は、本番環境では推奨されません。
`replicatedDomain.py`	Oracle WebLogic SIP Server Replicated Domainテンプレートを使用して、簡単なWebLogic SIP Serverドメインを作成します。スクリプトでは、ドメイン・テンプレートの開き方、構成オブジェクトの作成および編集方法、指定したディレクトリへのドメイン構成情報の書込み方法が示されます。このサンプルは、一般的な開発環境を表す単一のサーバーで構成されています。このタイプの構成は、本番環境では推奨されません。
`sampleMedRecDomain.py`	Avitek MedRecサンプルで使用されているものと同様のリソースを定義するWebLogicドメインを作成します。このサンプルでは、MedRecサンプル全体の再作成や、サンプル・アプリケーションのデプロイは行われません。このスクリプトでは、Basic WebLogic Server Domainテンプレートを使用します。