この章では、『Oracle Fusion Middleware Oracle WebLogic Scripting Tool ガイド』の内容と構成について説明します。
このマニュアルでは、WebLogic Scripting Tool (WLST) について説明します。また、WLST コマンドライン スクリプト インタフェースを使用して、WebLogic Server のインスタンスおよびドメインのコンフィグレーション、管理、およびこれらへの変更の永続化を行い、サーバ実行時イベントをモニタおよび管理する方法を説明します。
このマニュアルは、Sun Microsystems の Java Platform, Enterprise Edition (Java EE) を使用して Java EE アプリケーションをデプロイする、WebLogic Server の管理者およびオペレータを対象としています。読者は、Web テクノロジ、および WebLogic Server がインストールされているオペレーティング システムとプラットフォームに精通していることが前提となっています。
このドキュメントの構成は次のとおりです。
この章「概要とロードマップ」では、このガイドの構成および関連ドキュメントについて説明します。
「WebLogic Scripting Tool の使用」では、このスクリプト ツールのしくみ、操作モード、およびこれを呼び出すための基本的な手順について説明します。
「WLST オフラインを使用したドメインの作成」では、実行中の WebLogic Server へ接続することなく (つまり、WLST オフラインを使用して)、新規ドメインを作成したり既存ドメインを更新したりする方法について説明します。これは、コンフィグレーション ウィザードと同じ機能をサポートしています。
「サーバのライフサイクルの管理」では、WLST を使用した WebLogic Server インスタンスの起動および停止と、サーバのライフサイクルのモニタおよび管理について説明します。
「MBean の移動 (WLST オンライン)」では、ドメインのコンフィグレーションおよび実行時の情報を取得して、コンフィグレーション MBean またはカスタム MBean を編集する方法について説明します。
「既存ドメインのコンフィグレーション」では、スクリプトを使用しての、ドメイン、サーバ、およびリソースの作成と管理の自動化について説明します。
「デプロイメント プランの更新」では、WLST を使用したアプリケーションのデプロイメント プランの更新について説明します。
「実行時情報の取得」では、WLST を使用して WebLogic Server インスタンスの実行時状態に関する情報を取得する方法について説明します。
「WLST デプロイメント オブジェクト」では、デプロイメント プランを更新したり、現在のデプロイメント アクティビティに関する情報にアクセスしたりするのに使用できる、WLST デプロイメント オブジェクトについて説明します。
「FAQ : WLST」では、一般的な質問と回答のリストを示します。
Oracle WebLogic Server WLST コマンドおよび Oracle Fusion Middleware コンポーネントのカスタム コマンドの詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』を参照してください。
WLST は、WebLogic Server を管理およびモニタするためのインタフェースの 1 つです。他の管理インタフェースについては、以下の場所を参照してください。
『Oracle Fusion Middleware Oracle WebLogic Server アプリケーションの開発』の「Ant タスクを使用した WebLogic Server ドメインのコンフィグレーションと使用」。WebLogic Server インスタンスを起動および停止し、WebLogic Server ドメインをコンフィグレーションするための WebLogic Ant タスクの使用について説明します。
『Oracle Fusion Middleware Oracle WebLogic Server アプリケーションのデプロイメント』の「デプロイメント ツール」。アプリケーションやスタンドアロンのモジュールのデプロイ用に WebLogic Server で用意されているいくつかのツールについて説明します。
Oracle Fusion Middleware Oracle WebLogic Server の Administration Console オンライン ヘルプ。WebLogic Server ドメインを管理およびモニタするための Web ベースのグラフィカル ユーザ インタフェースについて説明します。
『Oracle Fusion Middleware コンフィグレーション ウィザードを使用したドメインの作成』。グラフィカル ユーザ インタフェースを使用した WebLogic Server ドメインの作成、または既存ドメインの拡張について説明します。
『Oracle Fusion Middleware pack および unpack コマンドを使用したテンプレートとドメインの作成』。既存のドメインを素早く簡単に再作成するコマンドについて説明します。
『Oracle Fusion Middleware Oracle WebLogic Server JMX によるカスタム管理ユーティリティの開発』。Java Management Extensions (JMX) API を使用して WebLogic Server リソースをモニタおよび変更する方法について説明します。
『Oracle Fusion Middleware Oracle WebLogic Server SNMP 管理ガイド』。Simple Network Management Protocol (SNMP) を使用した WebLogic Server ドメインのモニタについて説明します。
以下の節では、付加的なスクリプトを作成する際のテンプレートとして実行または使用できる、WLST オンラインおよびオフラインのサンプル スクリプトについて説明します。スクリプトの実行については、「スクリプトの実行」を参照してください。
注意 : サンプル スクリプトはデフォルトではインストールされていません。サーバ サンプルをインストールするには、WebLogic Server のカスタム インストールを選択して、[Server サンプル] のインストールを選択する必要があります。 |
WLST オンライン サンプル スクリプトは、実行中のサーバに接続して、管理タスクを実行し、WebLogic Server コンフィグレーションの変更を開始する方法を示します。WLST オンライン スクリプトは、SAMPLES_HOME
\server\examples\src\examples\wlst\online
ディレクトリにあります。SAMPLES_HOME
は、WebLogic Server のメインのサンプル ディレクトリ (c:\Oracle\Middleware\wlserver_10.3\samples
など) を表します。
表 1-1 は、WLST オンライン サンプル スクリプトの概要を示します。
表 1-1 WLST オンライン サンプル スクリプト
WLST サンプル スクリプト | 説明 |
---|---|
cluster_creation.py |
WLST から管理サーバに接続し、編集セッションを開始し、10 個の管理対象サーバを作成する。その後、2 つのクラスタを作成し、サーバを各クラスタに割り当て、WLST とサーバの接続を解除する。 |
cluster_deletion.py |
|
configJMSSystemResource.py |
WLST から管理サーバに接続して編集セッションを開始し、2 つの JMS サーバを作成した後でそれらを管理サーバに対象指定する。その後、JMS システム モジュール内に、JMS トピック、JMS キュー、および JMS テンプレートを作成する。JMS キューおよび JMS トピックは、サブデプロイメントを使用して対象指定される。 |
deleteJMSSystemResource.py |
|
jdbc_data_source_creation.py |
WLST から管理サーバに接続し、編集セッションを開始し、 |
jdbc_data_source_deletion.py |
|
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 サンプル全体の再作成や、サンプル アプリケーションのデプロイは行われない。 このスクリプトでは、Basic WebLogic Server Domain テンプレートを使用する。 |
また、WLST オフラインおよびオンラインを使用して WebLogic ドメイン リソースをコンフィグレーションするサンプル スクリプトは、Oracle Technology Network サイト (http://www.oracle.com/technology/index.html
) から入手できます。WLST サンプル スクリプトおよび WLST スクリプトに関する情報を検索するには、以下の用語のいずれかを指定してください。
WLST スクリプト
WLST オンライン スクリプト
WLST オフライン スクリプト
WebLogic Server のこのリリースに追加された新機能の一覧については、『Oracle Fusion Middleware Oracle WebLogic Server の新機能』を参照してください。