概要とロードマップ

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

マニュアルの内容と対象読者

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

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

このマニュアルの手引き

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

関連ドキュメント

WLST サンプルスクリプト

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

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

WLST オンラインサンプルスクリプトは、実行中のサーバに接続して、管理タスクを実行し、WebLogic Server コンフィグレーションの変更を開始する方法を示します。WLST オンラインスクリプトは、SAMPLES_HOME\server\examples\src\examples\wlst\online ディレクトリにあります。SAMPLES_HOME は、WebLogic Server のメインのサンプルディレクトリ (c:\beahome\weblogic92\samples など) を表します。

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

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

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

WLST オフラインサンプルスクリプトは、ソフトウェアと一緒にインストールされたドメインテンプレートを使用してドメインを作成する方法を示します。WLST オフラインスクリプトは、WL_HOME\common\templates\scripts\wlst ディレクトリにあります。WL_HOME は、WebLogic Server の最上位のインストールディレクトリを表します。

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

表 1-2 WLST オフラインサンプルスクリプト
WLST サンプルスクリプト	説明
`basicWLSDomain.py`	ドメインテンプレートを開き、コンフィグレーションオブジェクトを作成および編集し、指定したディレクトリにドメインコンフィグレーション情報を書き込む方法を示す、単純な WebLogic ドメインを作成する。このサンプルは、一般的な開発環境を表す単一のサーバで構成されている。このタイプのコンフィグレーションは、プロダクション環境では推奨されない。このスクリプトでは、Basic WebLogic Server Domain テンプレートを使用する。
`clusterMedRecDomain.py`	3 つの管理対象サーバを作成してそれらをクラスタに割り当て、単一クラスタのドメインを作成する。このスクリプトは Basic WebLogic Server Domain テンプレートを Avitek Medical Records Sample 拡張テンプレートで拡張して使用する。
`distributedQueues.py`	分散キューを作成する 2 つの方法を示す。このスクリプトは Basic WebLogic Server Domain テンプレートを Avitek Medical Records Sample で拡張して使用する。
`sampleMedRecDomain.py`	Avitek MedRec サンプルで使用されているものと同様のリソースを定義するドメインを作成する。このサンプルでは、MedRec サンプル全体の再作成や、サンプルアプリケーションのデプロイは行われない。このサンプルは、「サンプルドメインの作成 : 主な手順」で説明する WLST オンラインスクリプトで示される手順と同様の手順を示すが、WLST オフラインを使用する。このスクリプトでは、Basic WebLogic Server Domain テンプレートを使用する。

また、BEA の dev2dev Web サイトでは、WLST オフラインおよびオンラインを使用して WebLogic ドメインリソースをコンフィグレーションするサンプルスクリプトを提供しています。詳細については、https://wlst.projects.dev2dev.bea.com の「WLST プロジェクトホーム」を参照してください。

WebLogic Scripting Tool ガイド