スクリプト・ライブラリーを使用した、wsadmin スクリプトによるアプリケーション・サービス提供環境の自動化
スクリプト・ライブラリーは、ご使用の環境で自動化を支援するための Jython スクリプト・プロシージャーを提供します。サンプル・スクリプトを使用して、アプリケーション、リソース、サーバー、ノード、およびクラスターを管理します。スクリプト・プロシージャーは、Jython 構文を学習するための例としても使用できます。
このタスクについて
Jython スクリプト・ライブラリーは、最も一般的なアプリケーション・サーバー管理機能を自動化するための、 プロシージャーのセットを提供します。 例えば、スクリプト・ライブラリーを使用して、サーバー、アプリケーション、メール設定、リソース、ノード、ビジネス・レベル・アプリケーション、クラスター、許可グループなどを容易に構成できます。各スクリプト・プロシージャーを個別に実行するか、いくつかのプロシージャーを結合することで、新規スクリプトを迅速に開発できます。
スクリプト・ライブラリーは、最も一般的なアプリケーション・サーバー管理機能を自動化するために、プロシージャーのセットを提供します。
Jython スクリプト・ライブラリーを使用するには、以下の 3 つの方法があります。
- wsadmin ツールを使用して、対話モードで、Jython スクリプト・ライブラリーのスクリプトを実行します。
wsadmin ツールを起動し、以下の構文を使用して、スクリプト・ライブラリーに含まれている個々のスクリプトを
実行することができます。
wsadmin>AdminServerManagement.createApplicationServer("myNode", "myServer", "default")
- 以下の例に示すように、テキスト・エディターを使用して、Jython スクリプト・ライブラリーの複数のスクリプトを組み合わせます。
カスタム・スクリプトを保存し、以下に示す構文を使用して、コマンド行から そのカスタム・スクリプトを実行します。# # My Custom Jython Script - file.py # AdminServerManagement.createApplicationServer("myNode", "Server1", "default") AdminServerManagement.createApplicationServer("myNode", "Server2", "default") # Use one of them as the first member of a cluster AdminClusterManagement.createClusterWithFirstMember("myCluster", "APPLICATION_SERVER", "myNode", "Server1") # Add a second member to the cluster AdminClusterManagement.createClusterMember("myCluster", "myNode", "Server3") # Install an application AdminApplication.installAppWithClusterOption("DefaultApplication", "..\installableApps\DefaultApplication.ear", "myCluster") # Start all servers and applications on the node AdminServerManagement.startAllServers("myNode")
bin>wsadmin -language jython -f path/to/your/jython/file.py
- カスタム・スクリプトの作成時に、構文例として Jython スクリプト・ライブラリー・コードを使用します。 スクリプト・ライブラリー内の各スクリプト例は、wsadmin スクリプトを作成する際のベスト・プラクティスを 示します。スクリプト・ライブラリー・コードは、app_server_root/scriptLibraries ディレクトリーにあります。スクリプトは、このディレクトリー内で、機能別にサブディレクトリーとして編成されています。例えば、app_server_root/scriptLibraries/application/V70 サブディレクトリーには、 製品のバージョン 7.0 以降に適用可能なアプリケーション管理タスクを実行するプロシージャーが含まれています。このスクリプト・ライブラリー・パスのサブディレクトリー V70 は、そのサブディレクトリー内のスクリプトがバージョン 7.0 のスクリプトであることを意味しているわけではありません。
スクリプト・ライブラリー・ディレクトリーの各スクリプトは、wsadmin ツールを起動すると自動的にロードされます。wsadmin ツールの起動時に独自の Jython スクリプト (*.py) を自動的にロードするには、新規サブディレクトリーを作成し、既存の自動化スクリプトを app_server_root/scriptLibraries ディレクトリーに保存します。各スクリプト・ライブラリー名は固有でなければならず、重複してはなりません。
トラブルの回避 (Avoid trouble): スクリプト・ライブラリー内のスクリプト・プロシージャーは編集しないでください。
スクリプト・ライブラリー・プロシージャーをカスタマイズするには、変更されるスクリプトを新規サブディレクトリーに保存してライブラリーが上書きされないようにします。gotcha

app_server_root/scriptLibraries ディレクトリー内にない Jython スクリプト (*.py) を wsadmin ツールの起動時に自動的にロードするには、wsadmin.script.libraries システム・プロパティーをスクリプトのロケーションに設定します。例えば、スクリプト・ライブラリーが Windows オペレーティング・システムの temp ディレクトリーに保存されている場合は、以下の例に示すように、wsadmin コマンド行ツールでスクリプト・パスを設定します。
bin>wsadmin -lang jython -javaoption "-Dwsadmin.script.libraries=c:/myJythonScripts"
複数のディレクトリーをロードするには、以下の例に示すように、システム・プロパティーの各ディレクトリーをセミコロン (;) で区切って指定します。
bin>wsadmin -lang jython -javaoption "-Dwsadmin.script.libraries=c:/myJythonScripts;c:/AdminScripts;c:/configScripts"
スクリプト・ライブラリーは、以下のアプリケーション・サーバー管理機能を実行する自動化スクリプトを提供します。
手順
- アプリケーション・サーバーを管理します。 AdminServerManagement スクリプトを使用して、クラス・ローダー、Java™ 仮想マシン (JVM) の設定、Enterprise JavaBeans (EJB) のコンテナー、パフォーマンス・モニター、動的キャッシュなどを構成できます。
- サーバーおよびシステム・アーキテクチャーを管理します。 AdminServerManagement、AdminNodeManagement、および AdminClusterManagement の各スクリプト・ライブラリーを使用して、クラスター、ノード、およびノード・グループを管理できます。
- アプリケーションを管理します。 AdminApplication スクリプトを使用し、さまざまなオプションを指定してアプリケーションをインストール、アンインストール、および更新できます。
- データ・アクセス・リソースを管理します。 AdminJDBC および AdminJ2C スクリプト・ライブラリーを使用して、データ・ソースと Java Database Connectivity (JDBC) プロバイダーを管理し、Java 2 Connector (J2C) リソース・アダプターを作成および構成できます。
- メッセージング・リソースを管理します。 AdminJMS スクリプト・ライブラリーを使用して、ご使用の Java Messaging Service (JMS) 構成を構成および管理できます。
- メール・リソースを管理します。 このスクリプト・ライブラリーの AdminResources スクリプトを使用して、メール、URL、およびリソースの各設定を構成できます。
- 許可グループを管理します。 AdminAuthorizations スクリプトを使用して、許可グループを構成できます。
- パフォーマンスをモニターして構成をトラブルシューティングします。 AdminUtilities スクリプトを使用して、トレース、デバッグ、ログ、およびパフォーマンス・モニターを構成できます。『ユーティリティー・スクリプト』トピックを参照してください。
- wsadmin を使用してスクリプト・ライブラリー・ヘルプを取得します。 AdminLibHelp スクリプト・ライブラリーを使用して、使用可能な各スクリプト・ライブラリーをリストし、特定のスクリプト・ライブラリーの情報を表示し、特定のスクリプト・プロシージャーの情報を表示できます。
次のタスク
ご使用の環境を自動化するために使用するスクリプトを決定するか、またはアセンブリー・ツールを使用してカスタム・スクリプトを作成します。