1 概要とロードマップ

開始する前に、このガイドの内容および構成を理解してください。

• ドキュメントのスコープと対象読者
  このドキュメントでは、Oracle WebLogic Scripting Tool (WLST)について説明します。また、WLSTコマンドライン・スクリプト・インタフェースを使用して、WebLogic ServerのインスタンスおよびWebLogicドメインの構成、管理、およびこれらへの変更の永続化を行い、サーバー実行時イベントをモニターおよび管理する方法を説明します。
• このドキュメントの手引き
  このドキュメントの構成を理解してください。
• 関連ドキュメント
  
• WLSTサンプル・スクリプト
  Oracle Fusion Middlewareには、WLSTオンラインとオフライン両方のサンプル・スクリプトが用意されています。

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

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

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

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

このドキュメントの構成を理解してください。

次のように構成されています。

• この章「概要とロードマップ」では、このガイドの構成および関連ドキュメントについて説明します。

• WebLogic Scripting Toolの使用では、このスクリプト・ツールのしくみ、操作モード、およびこれを呼び出すための基本的なステップについて説明します。

• WLSTオフラインを使用したWebLogicドメインの作成では、実行中のWebLogic Serverへ接続することなく(つまり、WLSTオフラインを使用して)、新規WebLogicドメインを作成したり既存WebLogicドメインを更新したりする方法について説明します。これは、構成ウィザードと同じ機能をサポートしています。

• サーバーのライフサイクルの管理では、WLSTを使用したWebLogic Serverインスタンスの起動および停止と、サーバーのライフサイクルのモニターおよび管理について説明します。

• MBeanのナビゲート(WLSTオンライン)では、WebLogicドメインの構成および実行時の情報を取得して、構成MBeanまたはカスタムMBeanを編集する方法について説明します。

• 既存のWebLogicドメインの構成では、スクリプトを使用した、WebLogicドメイン、サーバー、およびリソースの作成と管理の自動化について説明します。

• デプロイメント・プランの更新では、WLSTを使用したアプリケーションのデプロイメント・プランの更新について説明します。

• 実行時情報の取得では、WLSTを使用して、WebLogic Serverインスタンスの実行時の状態に関する情報を取得する方法について説明します。

• WLSTデプロイメント・オブジェクトでは、デプロイメント・プランを更新したり、現在のデプロイメント・アクティビティに関する情報にアクセスしたりするのに使用できる、WLSTデプロイメント・オブジェクトについて説明します。

• FAQ: WLSTでは、一般的な質問と回答のリストを示します。

• WLSTの非推奨となった機能には、WLSTの非推奨となった機能がリストされます。

関連ドキュメント

WLSTコマンドとその構文の詳細は、次を参照してください。

• WebLogic Serverで使用可能なWLSTコマンドについては、WebLogic Server WLSTコマンド・リファレンスのオンラインおよびオフラインのWebLogic Server WLSTコマンド・リファレンス。

• Oracle Fusion Middlewareインフラストラクチャ・コンポーネント(Java Required Files (JRF)、Webサービス、メタデータ・サービス(MDS)、Application Development Framework (ADF)、ダイナミック・モニタリング・サービス(DMS)、ロギング、診断フレームワーク、ユーザー・メッセージング・サービス(UMS)など)で使用できるWLSTコマンドについては、インフラストラクチャ・コンポーネントWLSTコマンド・リファレンスのインフラストラクチャWLSTコマンドの概要とロードマップ。

• Oracle Fusion Middlewareインフラストラクチャ・セキュリティ・コンポーネント(Oracle Platform Security Services、監査、SSL、ウォレット、OPSSキーストア・サービスなど)で使用できるWLSTコマンドについては、インフラストラクチャ・セキュリティWLSTコマンド・リファレンスの概要とロードマップ。

• WebCenterコンポーネント(WebCenter Portal、WebCenter ContentおよびWebCenter Captureなど)に使用できるWLSTコマンドについては、WebCenter WLSTコマンド・リファレンスの概要とロードマップ。

• SOA、Business Process Management (BPM)、Enterprise Scheduler (ESS)およびManaged File Transfer (MFT)で使用できるWLSTコマンドについては、SOA Suite WLSTコマンド・リファレンスの概要とロードマップ。

• Oracle Traffic Directorに使用できるWLSTコマンドについては、Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンスのOracle Traffic Director用のWebLogic Scripting Toolの概要。

• Oracle HTTP Serverで使用可能なWLSTコマンドについては、Oracle HTTP Serverの管理のOracle HTTP Server WLSTカスタム・コマンド。

WLSTは、WebLogic Serverを管理およびモニターするためのインタフェースの1つです。他の管理インタフェースについては、以下の場所を参照してください。

• Oracle WebLogic Serverアプリケーションの開発のAntタスクを使用したWebLogic Serverドメインの構成と使用に関する項では、WebLogic Serverインスタンスの起動および停止とWebLogicドメインを構成するためのWebLogic Antタスクの使用について説明しています。

• Oracle WebLogic Serverへのアプリケーションのデプロイのデプロイメント・ツールに関する項では、アプリケーションおよびスタンドアロン・モジュールのデプロイ用にWebLogic Serverで提供されているいくつかのツールについて説明しています。

• Oracle WebLogic Server管理コンソール・オンライン・ヘルプ: WebLogicドメインを管理およびモニターするためのWebベースのグラフィカル・ユーザー・インタフェースについて説明します。

• 『構成ウィザードによるWebLogicドメインの作成』では、グラフィカル・ユーザー・インタフェースを使用したWebLogicドメインの作成または既存ドメインの拡張について説明しています。

• 「PackおよびUnpackコマンドを使用したテンプレートとドメインの作成」: 既存のWebLogicドメインをすばやく簡単に再作成するコマンドについて説明します。

• 『Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』: Java Management Extensions (JMX) APIを使用してWebLogic Serverリソースをモニターおよび変更する方法について説明します。

• 『SNMPによるOracle WebLogic Serverのモニタリング』: Simple Network Management Protocol (SNMP)を使用してWebLogicドメインをモニターする方法について説明します。

• 『Oracle WebLogic Serverサーバー環境の管理』: WebLogic Server環境の設計、構成および管理の方法について説明します。インストールされたWebLogic Serverの実装に携わるシステム管理者およびオペレータを対象としています。

• 『Oracle WebLogic Serverノード・マネージャの管理』: WebLogic Server環境内のサーバーを制御および管理するためにノード・マネージャを構成して使用する方法について説明します。

WLSTサンプル・スクリプト

Oracle Fusion Middlewareには、WLSTオンラインとオフライン両方のサンプル・スクリプトが用意されています。

以下の節では、付加的なスクリプトを作成する際のテンプレートとして実行または使用できるサンプル・スクリプトについて説明します。

スクリプトの実行については、「スクリプトの実行」を参照してください。

ノート:

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

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

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テンプレートを使用します。