![]() ![]() ![]() ![]() |
以下の節では、WLST コマンドと変数について詳細に説明します。以下のトピックがあります。
注意 : | コマンドの構文の要件について、「WLST コマンドの構文」を参照しておくことをお勧めします。 |
表 A-2 に示す WLST 参照コマンドを使用して、コンフィグレーション Bean または実行時 Bean の階層を移動したり、プロンプトの表示を制御したりします。
コマンド カテゴリ : 参照コマンド
WLST の使用状況 : オンラインまたはオフライン
コンフィグレーション Bean または実行時 Bean の階層を移動します。このコマンドでは、Windows または UNIX コマンド シェルのファイル システムを移動するときと同様のモデルを使用しています。たとえば、親のコンフィグレーション Bean または実行時 Bean に戻るには、cd('..')
と入力します。文字列 ..
(ドット、ドット) は、カレント ディレクトリのすぐ上のディレクトリを表します。階層の深くにある Bean に移動した後でルートの Bean に戻るには、cd('/')
と入力します。
現在の階層内の Bean に移動できます。子やインスタンスに移動することができます。
cd
コマンドは、コンフィグレーション Bean または実行時 Bean のインスタンスがある場合は、そのスタブを返します。特定のタイプに移動する場合は、移動元になるコンフィグレーション Bean または実行時 Bean インスタンスのスタブを返します。エラーが発生した場合は、WLSTException
が返されます。
注意 : | cmo 変数は、WLST をサーバ インスタンスに最初に接続するときに、すべてのドメイン コンフィグレーション Bean のルートに初期化されます。あるインスタンスに移動するまでは、この値が親コンフィグレーション Bean タイプとなります。cmo 変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。 |
以下の例では、コンフィグレーション Bean の階層を移動します。最初のコマンドでは Servers
コンフィグレーション Bean タイプに、2 番目のコマンドでは myserver
コンフィグレーション Bean インスタンスに移動します。最後のコマンドで、2 レベル上の元のディレクトリ位置に戻ります。
wls:/mydomain/serverConfig>cd('Servers')
wls:/mydomain/serverConfig/Servers>cd('myserver')
wls:/mydomain/serverConfig/Servers/myserver>cd('../..')
wls:/mydomain/serverConfig>
コマンド カテゴリ : 参照コマンド
WLST の使用状況 : オンライン
階層内の現在の場所を返します。このコマンドを使用すると、階層内の現在の場所を格納しておいて、参照後に簡単にそこに戻ることができます。エラーが発生した場合は、WLSTException
が返されます。
currentTree()
以下の例では、階層内の現在の場所を myTree
に格納して、管理サーバ インスタンス上の実行時 MBean 階層から編集 MBean 階層に戻るときに使用します。
wls:/mydomain/edit>myTree=currentTree()
wls:/mydomain/edit>serverRuntime()
Location changed to serverRuntime tree.This is a read-only tree with
wls:/mydomain/serverRuntime>
ServerRuntimeMBean as the root.
For more help, use help('serverRuntime')myTree()
wls:/mydomain/edit>
コマンド カテゴリ : 参照コマンド
WLST の使用状況 : オンラインまたはオフライン
引数なしで入力した場合は、プロンプトでパス情報の表示を切り替えます。このコマンドは、パスが長くてプロンプトが長くなり過ぎた場合に便利です。
このコマンドに、引数として on
または off
を明示的に指定することもできます。off
を指定した場合、WLST は WLST プロンプトを非表示にして、デフォルトで Jython プロンプトを表示します。デフォルトでは、WLST プロンプトはコンフィグレーションまたは実行時の移動パス情報を表示します。
プロンプトの詳細を表示しない場合に、階層内の現在の場所を調べるには、pwd
コマンドを使用できます (「pwd」を参照)。
エラーが発生した場合は、WLSTException
が返されます。
|
以下の例では、プロンプトでパス情報を非表示にしてから再表示します。
wls:/mydomain/serverConfig/Servers/myserver>prompt()
wls:/> prompt()
wls:/mydomain/serverConfig/Servers/myserver>
以下の例では、プロンプトを非表示にして、デフォルトで Jython プロンプトを表示し (WLST オンラインを使用してコマンドを実行している場合)、Jython プロンプトを変更してから、WLST プロンプトを再表示します。この例では、pwd
コマンドの使い方も示しています。
注意 : | Jython を使用したプログラミングの詳細については、http://www.jython.org を参照してください。 |
wls:/mydomain/serverConfig/Servers/myserver>prompt('off')
>>>sys.ps1="myprompt>"
myprompt>prompt()
wls:>pwd()
`serverConfig:Servers/myserver'
wls:>prompt()
wls:/mydomain/serverConfig/Servers/myserver>
コマンド カテゴリ : 参照コマンド
WLST の使用状況 : オンラインまたはオフライン
コンフィグレーション Bean または実行時 Bean 階層内の現在の場所を表示します。
このコマンドは、prompt
コマンドを使用してプロンプトでパス情報の表示を無効にした場合に便利です (「prompt」を参照)。
エラーが発生した場合は、WLSTException
が返されます。
pwd()
以下の例では、コンフィグレーション Bean 階層内の現在の場所を表示します。
wls:/mydomain/serverConfig/Servers/myserver/Log/myserver> pwd()
'serverConfig:/Servers/myserver/Log/myserver'
表 A-3 に示す WLST 制御コマンドを使用して、以下のタスクを行います。
表 A-3 に、WLST コンフィグレーションの制御コマンドを示します。
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
アプリケーションまたはサービスの拡張テンプレートを使用して、現在のドメインを拡張します。Template Builder を使用してアプリケーション テンプレートまたはサービスの拡張テンプレートを作成します。『Domain Template Builder を使用したテンプレートの作成』を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、ドメインを開いて、指定された拡張テンプレート DefaultWebApp.jar
を使用してドメインを拡張します。
wls:/offline>readDomain('c:/bea/user_projects/domains/wlw')
wls:/offline/wlw>addTemplate('c:/bea/wlserver_10.0/common/templates/
applications/DefaultWebApp.jar')wls:/offline/wlw>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
現在のドメインを閉じます。一度閉じるとそのドメインは編集できなくなります。エラーが発生した場合は、WLSTException
が返されます。
closeDomain()
wls:/offline>readDomain('c:/bea/user_projects/domains/medrec')
...
wls:/offline/medrec>updateDomain()
wls:/offline/medrec>closeDomain()
wls:/offline>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
現在のドメイン テンプレートを閉じます。一度閉じるとそのテンプレートは使用できなくなります。エラーが発生した場合は、WLSTException
が返されます。
closeTemplate()
以下の例では、既存のドメイン テンプレートを開き、いくつかのオペレーションを実行してから、現在のドメイン テンプレートを閉じます。
wls:/offline>readTemplate('c:/bea/wlserver_10.0/common/templates/domains/
...
wls.jar')
wls:/offline/wls>closeTemplate()
wls:/offline>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST を WebLogic Server インスタンスに接続します。
アクティブな WebLogic セキュリティ レルムで定義されているユーザの資格 (ユーザ名およびパスワード) を提供する必要があります。接続後は、一群のセキュリティ ポリシーによって、表示または変更できるコンフィグレーション属性が決まります (『WebLogic Server MBean リファレンス』の「Default Security Policies for MBeans」を参照)。
storeUserConfig
コマンドを使用して、暗号化された形式の資格が格納されたユーザ コンフィグレーション ファイル、およびその資格の復号化に使用されるキー ファイルを作成する。以降の WLST セッション (または WLST スクリプト) では、コマンドラインで資格を入力する代わりに、このユーザ コンフィグレーション ファイルおよびキー ファイルの名前を指定します。この方法は、WLST をスクリプト モードで使用している場合にお勧めします。スクリプト モードでは、暗号化されていないユーザの資格がスクリプトに格納されないためです。boot.properties
ファイルに格納されている資格を使用する。デフォルトでは、管理サーバを作成すると、WebLogic Server はサーバの作成に使用された資格を暗号化し、暗号化した資格を boot.properties
ファイルに格納します。
ユーザ名とパスワード、またはユーザ コンフィグレーション ファイルとキー ファイルを指定しないで connect
コマンドを実行した場合、WLST は以下のいずれかの方法を順次使用してコマンドを処理しようとします。
adminServerName
引数が指定されていない場合、./boot.properties
または ./servers/myserver/security/boot.properties
にある boot.properties
ファイルを検索します。adminServerName
引数が指定されている場合、/servers/
adminServerName
/security/boot.properties
にある boot.properties
を検索します。ここで、adminServerName
は、adminServerName
引数の値です。Warning: An insecure protocol was used to connect to the server.To ensure
on-the-wire security, the SSL port or Admin port should be used instead.
java -Dweblogic.security.SSL.ignoreHostnameVerification=true
-Dweblogic.security.TrustKeyStore=DemoTrust weblogic.WLST
WLST の呼び出しの詳細については、「対話モードまたはスクリプト モードでの WLST の使用の主な手順」を参照してください。
TunnelingEnabled
属性が true
に設定されていることを確認してください。詳細については、『WebLogic Server MBean リファレンス』の「TunnelingEnabled」を参照。
WebLogic Server インスタンスに正常に接続した後で、すべてのローカル変数が初期化されます。
エラーが発生した場合は、WLSTException
が返されます。
connect([
username,
password], [
url
], [
timeout
])
connect([
userConfigFile,
userKeyFile], [
url
], [
timeout
])
connect([
url
], [
adminServer], [
timeout
])
userConfigFile=' file-system-path '
storeUserConfig コマンドはキー ファイルを使用してユーザ名とパスワードを暗号化する。ユーザ コンフィグレーション ファイルを暗号化するキー ファイルのみが、そのユーザ名とパスワードを復号化できる (「storeUserConfig」を参照)。
|
|
userKeyFile=' file-system-path '
|
|
boot.properties ファイルに格納されている資格を使用するようにする。この引数には次の構文を使用すること。adminServerName=' server-name '
|
以下の例では、WLST を WebLogic Server インスタンスに接続します。この例では、管理サーバ名はデフォルトの AdminServer
になります。サーバへの接続に SSL または管理ポートが使用されない場合は警告が表示されます。
wls:/offline>connect('weblogic','weblogic','t3://localhost:8001')
Connecting to weblogic server instance running at t3://localhost:8001 as username weblogic...
Successfully connected to Admin Server 'AdminServer' that belongs to domain
'mydomain'.
Warning: An insecure protocol was used to connect to the server.To ensure on-the-wire security, the SSL port or Admin port should be used instead.
wls:/mydomain/serverConfig>
以下の例では、WLST を指定された URL の WebLogic Server インスタンスに接続します。この例では、ユーザ名とパスワードが引数として渡されます。この例ではセキュアなプロトコルを使用しています。
wls:/offline>username = 'weblogic'
wls:/offline>password = 'weblogic'
wls:/offline>connect(username,password,'t3s://myhost:8001')
Connecting to weblogic server instance running at t3://myhost:8001 as
username weblogic...
Successfully connected to Admin Server 'AdminServer' that belongs to domain
'mydomain'.
wls:/mydomain/serverConfig>
以下の例では、ユーザの資格を提供するユーザ コンフィグレーション ファイルとキー ファイルを使用して、WLST を WebLogic Server インスタンスに接続します。
wls:/offline>connect(userConfigFile='c:/myfiles/myuserconfigfile.secure', userKeyFile='c:/myfiles/myuserkeyfile.secure')
Connecting to weblogic server instance running at t3://localhost:7001 as
username ...
Successfully connected to Admin Server 'AdminServer' that belongs to domain 'mydomain'.
wls:/mydomain/serverConfig>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
注意 : | ドメイン作成時にドメイン コンフィグレーションの設定を変更する場合は、「ドメインの編集 (オフライン)」のオプション 2 を参照してください。 |
注意 : | createDomain コマンドは、『pack および unpack コマンドを使用したテンプレートとドメインの作成』で説明されているように、unpack コマンドに類似した機能を備えています。 |
エラーが発生した場合は、WLSTException
が返されます。
createDomain(domainTemplate, domainDir, user, password)
次の例では、Avitek MedRec テンプレートを使用して新しいドメインを作成し、デフォルトのユーザ名とパスワードを weblogic
に設定しています。ドメインは、c:/bea/user_projects/domains/medrec
ディレクトリに格納されます。
wls:/offline> createDomain('c:/bea/wlserver_10.0/common/templates/domains
/wls_medrec.jar','c:/bea/user_projects/domains/medrec', 'weblogic', 'weblogic')
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オンライン
WLST を WebLogic Server インスタンスから接続解除します。disconnect
コマンドを実行しても対話スクリプト シェルは終了しません。対話シェルを開いたままで、現在の WebLogic Server インスタンスの接続を閉じて、すべての変数をリセットします。
エラーが発生した場合は、WLSTException
が返されます。
connect
コマンドを使用して別の WebLogic Server インスタンスに接続できます (「connect」を参照)。
wls:/mydomain/serverConfig>disconnect()
Disconnected from weblogic server: myserver
wls:/offline>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST をユーザ セッションから終了させて、スクリプト シェルを閉じます。
進行中の編集セッションがある場合、WLST はユーザに確認を求めます。このプロンプトをスキップするには、defaultAnswer
引数を y
に設定します。
デフォルトでは、WLST を終了するときに、現在の WLST JVM の System.exit(0)
が呼び出されます。JVM に別の終了コードで終了させるには、exitCode
引数を使用して値を指定できます。
注意 : | Ant スクリプトの中で WLST exit コマンドが発行されると、Ant スクリプトの実行も終了する可能性があります。Ant スクリプトの中で WLST を呼び出す場合は、fork="true" を指定して新しい JVM を使用することをお勧めします。 |
エラーが発生した場合は、WLSTException
が返されます。
exit([defaultAnswer], [exitcode])
以下の例では、ユーザ セッションから接続解除して、スクリプト シェルを閉じます。
wls:/mydomain/serverConfig>exit()
Exiting WebLogic Scripting Tool ...
c:\>
以下の例では、ユーザ セッションから接続解除して、スクリプト シェルを閉じ、エラー コードを 101 に設定します。
wls:/mydomain/serverConfig>exit(exitcode=101)
Exiting WebLogic Scripting Tool ...
c:\>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
WLST オフラインでは、Template Builder を使用して作成したドメイン テンプレート JAR 内、またはドメインの config
ディレクトリ内に永続化されているコンフィグレーション データへの読み書きアクセスが可能です。このデータは、XML ドキュメントの集合であり、管理オブジェクトの階層構造を表します。
テンプレートまたはドメインを開くと、WLST はそのドメインのコンフィグレーション階層のルートに入り、プロンプトはそのコンフィグレーション階層での現在の場所を示すように更新されます。次に例を示します。
詳細については、「MBean の移動と照会」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、編集するために medrec
ドメインを開きます。
wls:/offline> readDomain('c:/bea/user_projects/domains/medrec')
wls:/offline/medrec>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
ドメインを作成するために既存のドメイン テンプレートを開きます。
ドメイン テンプレートを開くと、WLST はそのドメイン テンプレートのコンフィグレーション Bean 階層に入り、プロンプトはそのコンフィグレーション階層での現在の場所を示すように更新されます。次に例を示します。
WebLogic Server コンフィグレーション Bean は階層構造の中に存在します。WLST ファイル システムでは、階層はドライブに、タイプとインスタンスはディレクトリに、属性とオペレーションはファイルに相当します。UNIX または Windows コマンド シェルでファイル システムを移動するときと同じように、WLST は cd
、ls
、および pwd
などのコマンドを使用して、コンフィグレーション Bean の階層構造を移動します。コンフィグレーション Bean インスタンスに移動したら、WLST コマンドを使用して Bean と対話します。詳細については、「MBean の移動と照会」を参照してください。
注意 : | WLST とドメイン テンプレートを使用する場合、新しいドメインを作成するときにのみセキュリティ情報を作成してアクセスできます。ドメインを更新するときは、WLST からセキュリティ情報にアクセスすることはできません。 |
エラーが発生した場合は、WLSTException
が返されます。
readTemplate(templateFileName)
以下の例では、ドメインを作成するために medrec.jar
ドメイン テンプレートを開きます。
wls:/offline> readTemplate('c:/bea/wlserver_10.0/common/templates/domains
/wls_medrec.jar')
wls:/offline/wls_medrec>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
現在のドメインを更新して保存します。更新して保存した後、ドメインは引き続き編集可能になります。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、medrec ドメインを開き、いくつかのオペレーションを実行してから、現在のドメインを更新して保存します。
wls:/offline>readDomain('c:/bea/user_projects/domains/medrec')
...
wls:/offline/medrec>updateDomain()
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
指定されたディレクトリにドメインのコンフィグレーション情報を書き込みます。
ドメインをファイル システムに書き込んだ後で、メモリ内に存在するドメイン テンプレート オブジェクトを引き続き更新し、writeDomain
コマンドを再発行して、ドメイン コンフィグレーションを新しいファイルまたは既存のファイルに格納できます。
デフォルトでは、ドメインを書き込むときに、関連するアプリケーションが BEAHOME
/user_projects/applications/
domainname
に書き込まれます。BEAHOME
は BEA ホーム ディレクトリ、domainname
はドメインの名前を表します。このディレクトリは空でなければなりません。空でない場合はエラーが表示されます。
メモリ内のドメイン テンプレート オブジェクトを使用し終えたら、closeTemplate
コマンドを使用して閉じます。ディスクに保存されているドメインを編集する場合は、readDomain
コマンドを使用してドメインを開くことができます。
注意 : | ドメインの名前はドメイン ディレクトリの名前から取られます。たとえば、ドメインが c:/bea/user_projects/domains/myMedrec に保存される場合、ドメイン名は myMedrec になります。 |
ドメインを書き込む前に、まだ定義されていない場合は、デフォルト ユーザのパスワードを定義する必要があります。次に例を示します。
cd('/Security/base_domain/User/weblogic')
cmo.setPassword('weblogic')
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、medrec.jar ドメイン テンプレートを読み込み、いくつかのオペレーションを実行してから、ドメイン コンフィグレーション情報を c:/bea/user_projects/domains/medrec
ディレクトリに書き込みます。
wls:/offline>readTemplate('c:/bea/wlserver_10.0/common/templates/domains
...
/wls.jar')
wls:/offline/base_domain>writeDomain('c:/bea/user_projects/domains/base_domain')
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
指定されたドメイン テンプレート ファイルにドメイン コンフィグレーション情報を書き込みます。ドメイン コンフィグレーション テンプレートを使用してドメインを再作成できます。
コンフィグレーション情報をドメイン コンフィグレーション テンプレートに書き込んだ後で、メモリ内に存在するドメインまたはドメイン テンプレート オブジェクトを引き続き更新し、writeDomain
または writeTemplate
コマンドを再発行して、ドメイン コンフィグレーションを新規あるいは既存のドメインまたはドメイン テンプレート ファイルに格納できます。詳細については、「writeDomain」または「writeTemplate」をそれぞれ参照してください。
エラーが発生した場合は、WLSTException
が返されます。
注意 : | writeTemplate コマンドは、『pack および unpack コマンドを使用したテンプレートとドメインの作成』で説明されているように、pack コマンドに類似した機能を備えています。ただし、writeTemplate は管理対象サーバ テンプレートの作成をサポートしていません。 |
以下の例では、現在のドメイン コンフィグレーションを c:/bea/user_projects/templates/myTemplate.jar
というドメイン テンプレートに書き込みます。
wls:/offline>readDomain('c:/bea/user_projects/domains/mydomain')
...
wls:/offline/base_domain>writeTemplate('c:/bea/user_projects/templates/myTemplate.jar')
表 A-4 に示す WLST デプロイメント コマンドを使用して、以下のことを行います。
詳細については、『WebLogic Server アプリケーションのデプロイメント』を参照してください。
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
WebLogic Server インスタンスにアプリケーションをデプロイします。
deploy
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。エラーが発生した場合は、WLSTException
が返されます。
注意 : | 進行中の編集セッションがある場合、deploy コマンドはユーザの対話をブロックしません。 |
deploy(appName, path, [targets], [stageMode], [planPath], [options])
stage 、nostage 、および external_stage 。ステージング モードについては、『WebLogic Server アプリケーションのデプロイメント』の「ステージング モードによるデプロイメント ファイルのコピーの制御」を参照。この引数のデフォルトは null。
|
|
|
|
|
|
|
以下の例では、c:/myapps/business
にある businessApp
アプリケーションをデプロイします。デフォルトのデプロイメント プランが作成されます。
deploy
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトはユーザ定義の変数 (この場合は progress
) に格納されます。
wls:/mydomain/serverConfig/Servers> progress= deploy(appName='businessApp',path='c:/myapps/business',createplan='true')
前の例では、返された WLSTProgress
オブジェクトが、ユーザ定義の変数 (この場合は progress
) に格納されています。progress
変数を使用して deploy
コマンドのステータスを出力できます。次に例を示します。
wls:/mydomain/serverConfig/Servers>progress.printStatus()
Current Status of your Deployment:
Deployment command type: deploy
Deployment State : completed
Deployment Message : null
wls:/mydomain/serverConfig/Servers>
WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。
以下の例では、c:/myapps/demos/app/demoApp.ear
にあるアーカイブ ファイル内の demoApp
アプリケーションをデプロイして、そのアプリケーション モジュールを myserver
に割り当てます。c:/myapps/demos/app/plan/plan.xml
にあるデプロイメント プラン ファイルを使用します。WLST はプロセスが完了するまで 120,000 ミリ秒待機します。
wls:/mydomain/serverConfig/Servers> deploy('demoApp', 'c:/myapps/demos/app/demoApp.ear', targets='myserver', planPath='c:/myapps/demos/app/plan/plan.xml', timeout=120000)
以下の例では、c:/myapps/demos/jmsApp/demo-jms.xml
にある jmsApp
アプリケーションをデプロイして、そのアプリケーション モジュールを特定の対象に割り当てます。
wls:/mydomain/serverConfig/Servers>deploy('jmsApp',path='c:/myapps/demos/jmsApps/demo-jms.xml', subModuleTargets='jmsApp@managed1')
次の例では、プロダクションの (side-by-side) 再デプロイメントをサポートするように、アプリケーションのバージョン (appVersion
) をユニークな識別子に設定する方法を示します。この例では、c:/myapps/demos/app/demoApp.ear
にあるアーカイブ ファイル内の demoApp
アプリケーションをデプロイし、アプリケーションとアーカイブのバージョン番号を、指定された値に設定します。
wls:/mydomain/serverConfig> deploy('demoApp', 'c:/myapps/demos/app/demoApp.ear', archiveVersion='901-101', appVersion='901-102')
プロダクションの再デプロイメント方式の詳細については、『WebLogic Server アプリケーションのデプロイメント』の「プロダクション環境でのアプリケーションの再デプロイメント」を参照してください。
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
指定された対象にデプロイメント バンドルをコピーします。デプロイメント バンドルにはモジュール、コンフィグレーション データ、その他の生成コードが含まれます。distributeApplication
コマンドではデプロイメントは開始されません。
distributeApplication
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。エラーが発生した場合は、WLSTException
が返されます。
distributeApplication(appPath, [planPath], [targets], [options])
以下の例では、c:/myapps
ディレクトリにある BigApp
アプリケーションをロードして、WLSTProgress
オブジェクトを、ユーザ定義の変数 (この場合は progress
) に格納します。
以下の例では、c:/deployment/BigApp/plan.xml
で定義されたデプロイメント プランを使用して、c:/myapps/BigApp
アプリケーションを myserver
、oamserver1
、oamcluster
の各サーバに配布します。
wls:/offline> progress=distributeApplication('c:/myapps/BigApp', 'c:/deployment/BigApp/plan.xml', 'myserver,oamserver1,oamcluster')
Distributing Application and Plan ...
Successfully distributed the application.
前の例では、WLSTProgress
オブジェクトが、ユーザ定義の変数 (この場合は progress
) に格納されています。progress
変数を使用して、distributeApplication
コマンドが完了したかどうかを判断できます。次に例を示します。
wls:/mydomain/serverConfig/Servers>progress.isCompleted()
1
wls:/mydomain/serverConfig/Servers>
WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
WebLogic DeploymentManager
オブジェクトを返します。このオブジェクトのメソッドを使用して、アプリケーションをコンフィグレーションしたりデプロイしたりできます。このコマンドを実行するには、WLST が管理サーバに接続している必要があります。エラーが発生した場合は、WLSTException
が返されます。
getWLDM()
以下の例では、WebLogicDeploymentManager
オブジェクトを取得して wldm
変数に格納します。
wls:/mydomain/serverConfig> wldm=getWLDM()
wls:/mydomain/serverConfig> wldm.isConnected()
1
wls:/mydomain/serverConfig>
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
アプリケーションとデプロイメント プランをメモリにロードします。
loadApplication
コマンドは、デプロイメント プランを変更するためにアクセスできる WLSTPlan
オブジェクトを返します。WLSTPlan
オブジェクトの詳細については、「WLSTPlan オブジェクト」を参照してください。エラーが発生した場合は、WLSTException
が返されます。
loadApplication(appPath, [planPath], [createPlan])
以下の例では、c:/myplans/myejb/plan.xml
のプラン ファイルを使用して c:/myapps/myejb.jar
アプリケーションをロードします。
wls:/myserver/serverConfig> myPlan=loadApplication('c:/myapps/myejb.jar', 'c:/myplans/myejb/plan.xml')
Loading application from c:/myapps/myejb.jar and deployment plan from c:/myplans/myejb/plan.xml ...
Successfully loaded the application.
wls:/myserver/serverConfig>
前の例では、返された WLSTPlan
オブジェクトを myPlan
変数に格納しています。myPlan
変数を使用して、プランに関する情報 (変数など) を表示できます。次に例を示します。
wls:/myserver/serverConfig>myPlan.showVariables()
MyEJB jndi.ejb
MyWAR app.foo
wls:/myserver/serverConfig>
WLSTPlan
オブジェクトの詳細については、「WLSTPlan オブジェクト」を参照してください。
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
クラスを再ロードして、以前にデプロイされたアプリケーションを再デプロイします。
redeploy
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
アプリケーションの再デプロイの詳細については、『WebLogic Server アプリケーションのデプロイメント』の「一般的なデプロイメント シナリオの概要」を参照してください。
redeploy(appName, [planPath], [options])
以下の例では、c:/myapps
ディレクトリにある plan.xml
ファイルを使用して myApp
アプリケーションを再デプロイします。
wls:/mydomain/serverConfig> progress=redeploy('myApp' 'c:/myapps/plan.xml')
Redeploying application 'myApp' ...
Redeployment of 'myApp' is successful
wls:/mydomain/serverConfig>
前の例では、返された WLSTProgress
オブジェクトが、ユーザ定義の変数 (この場合は progress
) に格納されています。progress
変数を使用して redeploy
コマンドの状態にアクセスできます。次に例を示します。
wls:/mydomain/serverConfig/Servers>progress.getState()
`completed'
wls:/mydomain/serverConfig/Servers>
WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
アプリケーションを起動して、ユーザが利用できるようにします。アプリケーションは完全にコンフィグレーション済みで、ドメインで利用できる状態でなければなりません。
startApplication
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。エラーが発生した場合は、WLSTException
が返されます。
startApplication(appName, [options])
以下の例では、指定されたデプロイメント オプションで BigApp
アプリケーションを起動します。
wls:/offline> progress=startApplication('BigApp', stageMode='NOSTAGE', testMode='false')
Starting the application...
Successfully started the application.
前の例では、返された WLSTProgress
オブジェクトが、ユーザ定義の変数 (この場合は progress
) に格納されています。progress
変数を使用して startApplication
コマンドの状態にアクセスできます。次に例を示します。
wls:/mydomain/serverConfig/Servers>progress.getState()
`completed'
wls:/mydomain/serverConfig/Servers>
WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
アプリケーションを停止して、ユーザが利用できないようにします。アプリケーションは完全にコンフィグレーション済みで、ドメインで利用できる状態でなければなりません。
stopApplication
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
stopApplication(appName, [options])
wls:/offline> progress=stopApplication('BigApp')
Stopping the application...
Successfully stopped the application.
前の例では、返された WLSTProgress
オブジェクトが、ユーザ定義の変数 (この場合は progress
) に格納されています。progress
変数を使用して、stopApplication
コマンドが実行中かどうかをチェックできます。次に例を示します。
wls:/mydomain/serverConfig/Servers>progress.isRunning()
0
wls:/mydomain/serverConfig/Servers>
WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
undeploy
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。エラーが発生した場合は、WLSTException
が返されます。
アプリケーションのデプロイとアンデプロイの詳細については、『WebLogic Server アプリケーションのデプロイメント』の「一般的なデプロイメント シナリオの概要」を参照してください。
undeploy(appName,[targets],[options])
以下の例では、すべての対象サーバから businessApp アプリケーションを削除します。WLST はプロセスが完了するまで 60,000 ミリ秒待機します。
wls:/mydomain/serverConfig>undeploy('businessApp', timeout=60000)
Undeploying application businessApp ...
<Jul 20, 2005 9:34:15 AM EDT> <Info> <J2EE Deployment SPI> <BEA-260121>
<Initiating undeploy operation for application, businessApp [archive: null],
to AdminServer .>
Completed the undeployment of Application with status
Current Status of your Deployment:
Deployment command type: undeploy
Deployment State : completed
Deployment Message : no message
wls:/mydomain/serverConfig>
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
新しいデプロイメント プランを使用してアプリケーションのコンフィグレーションを更新します。アプリケーションは完全にコンフィグレーション済みで、ドメインで利用できる状態でなければなりません。
updateApplication
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。エラーが発生した場合は、WLSTException
が返されます。
updateApplication(appName, [planPath], [options])
以下の例では、c:/myapps/BigApp/newPlan
にある plan.xml
ファイルを使用して、BigApp
のアプリケーション コンフィグレーションを更新します。
wls:/offline> progress=updateApplication('BigApp', 'c:/myapps/BigApp/newPlan/plan.xml', stageMode='STAGE', testMode='false')
Updating the application...
Successfully updated the application.
前の例では、返された WLSTProgress
オブジェクトが、ユーザ定義の変数 (この場合は progress
) に格納されています。progress
変数を使用して updateApplication
コマンドの状態にアクセスできます。次に例を示します。
wls:/mydomain/serverConfig/Servers> progress.getState()
`completed'
wls:/mydomain/serverConfig/Servers>
WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。
表 A-5 に示す WLST 診断コマンドを使用し、WebLogic 診断フレームワーク (WLDF) のデータ ストアに対してクエリを実行することによって、診断データを取得できます。WLDF の詳細については、『WebLogic 診断フレームワークのコンフィグレーションと使い方』を参照してください。
コマンド カテゴリ : 診断コマンド
WLST の使用状況 : オフライン
指定されたログ ファイルに対するクエリを実行します。結果は XML ファイルとして保存されます。
WebLogic Server 診断サービスの詳細については、『WebLogic 診断フレームワークのコンフィグレーションと使い方』を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
exportDiagnosticData([options])
|
以下の例では、myserver.log
という名前の ServerLog
に対してクエリを実行し、その結果を myExport.xml
というファイルに格納します。
wls:/offline/mydomain>exportDiagnosticData(logicalName='ServerLog', logName='myserver.log', exportFileName='myExport.xml')
{'elfFields': '', 'logName': 'myserver.log', 'logRotationDir': '.',
'endTimestamp': 9223372036854775807L, 'exportFileName': 'export.xml',
'storeDir': '../data/store/diagnostics', 'logicalName': 'ServerLog',
'query': '', 'beginTimestamp': 0}
Exporting diagnostic data to export.xml
<Aug 2, 2005 6:58:21 PM EDT> <Info> <Store> <BEA-280050> <Persistent store
"WLS_DIAGNOSTICS" opened: directory="c:\bea\wlserver_10.0\server\data\store\diagnostics"
writePolicy="Disabled" blockSize=512 directIO=false driver="wlfileio2">
wls:/mydomain/serverRuntime>
コマンド カテゴリ : 診断コマンド
WLST の使用状況 : オンライン
サーバ サイドでクエリを実行して、エクスポートされた WebLogic 診断フレームワーク (WLDF) データを取得します。結果は XML ファイルとして保存されます。
WebLogic Server 診断サービスの詳細については、『WebLogic 診断フレームワークのコンフィグレーションと使い方』を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
exportDiagnosticDataFromServer([options])
以下の例では、HTTPAccessLog
に対してクエリを実行し、その結果を myExport.xml
というファイルに格納します。
wls:/mydomain/serverRuntime> exportDiagnosticDataFromServer(logicalName="HTTPAccessLog", exportFileName="myExport.xml")
表 A-6 に示す WLST 編集コマンドを使用して、コンフィグレーション Bean の照会や編集を行います。
注意 : | コンフィグレーション Bean を編集するには、管理サーバに接続している必要があります。また、編集ツリーに移動して、編集セッションを開始する必要があります。「edit」および「startEdit」をそれぞれ参照してください。 |
注意 : | 管理対象サーバに接続した場合、WLST の機能はコンフィグレーション Bean 階層の参照だけに制限されます。WLST を使用して管理対象サーバ上の MBean の値を変更することはできませんが、管理 API を使用すれば可能です。ただし、管理サーバ上のコンフィグレーション MBean の値のみを変更することをお勧めします。管理対象サーバ上の MBean の値を変更すると、ドメイン コンフィグレーションに矛盾が生じる可能性があります。 |
注意 : | コンフィグレーション Bean の編集に関する詳細については、WLST オンラインを使用した既存ドメインの更新」を参照してください。 |
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
現在の編集セッション中に保存されてまだデプロイされていない変更をアクティブ化します。アクティブ化する変更内容にサーバの再起動が必要なものがある場合、このコマンドはメッセージを出力します。
activate
コマンドは、ユーザが現在行っている変更、または最近行った変更の状態を反映する、最新の ActivationTask
MBean を返します。メソッドを呼び出して、進行中または完了したばかりの、最近のコンフィグレーション マネージャのアクティブ化タスクに関する情報を取得できます。エラーが発生した場合は、WLSTException
が返されます。
false で、ユーザ対話がブロックされないことを示す。この場合、WLST はコマンドを発行した後でユーザに制御を返し、現在のタスクに関連付けられているタスク MBean を変数に割り当てる。その変数を利用すると、タスクのステータスをチェックできる。「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合、block は常に true に設定される。
|
以下の例では、現在の編集セッション中に変更され、ディスクに保存されていて、まだアクティブ化されていない変更内容をアクティブ化します。WLST はアクティブ化が完了するのを 100,000 ミリ秒待機し、アクティブ化を停止する前に 200,000 ミリ秒待機します。
wls:/mydomain/edit !>activate(200000, block='true')
すべての変更をアクティブ化しています。しばらく時間がかかる場合があります ...
アクティブ化が完了すると、この編集セッションに関連付けられた編集ロックが開放されます。
Action completed.
wls:/mydomain/edit>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オフライン
エラーが発生した場合は、WLSTException
が返されます。
assign(sourceType, sourceName, destinationType, destinationName)
|
|
sourceType
および destinationType
の設定では以下のガイドラインを使用してください。
myServer
と myServer2
をクラスタ myCluster
に割り当てる。wls:/offline/mydomain> assign("Server", "myServer,myServer2", "Cluster", "myCluster")
myCluster
に割り当てる。wls:/offline/mydomain> assign("Server", "*", "Cluster", "myCluster")
myAppDeployment
を対象サーバ newServer
に割り当てる。wls:/offline/mydomain> assign("AppDeployment", "myAppDeployment", "Target", "newServer")
newUser
をグループ Monitors
に割り当てる。wls:/offline/mydomain> assign("User", "newUser", "Group", "Monitors")
myQueueSubDeployment
(JMS リソース myJMSResource
の子) を対象サーバ newServer
に割り当てる。wls:/offline/mydomain> assign('JMSSystemResource.SubDeployment', 'myJMSResource.myQueueSubDeployment', 'Target', 'newServer')
MedRecAppScopedJMS.MedRecJMSServer
(アプリケーション デプロイメント AppDeployment
の子) を対象サーバ AdminServer
に割り当てる。wls:/offline/mydomain>assign('AppDeployment.SubDeployment.SubDeployment
','MedRecEAR.MedRecAppScopedJMS.MedRecJMSServer','Target','AdminServer')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オフライン
注意 : | このコマンドは WebLogic Server 9.0 から非推奨になりました。assign コマンドを使用するようにスクリプトを更新してください (「assign」を参照)。このコマンドは引き続き、指定された sourceType のリソースが存在する場合は、そのリソースに対して機能します。 |
すべてのアプリケーションまたはサーバを 1 つまたは複数の送り先に割り当てます。
注意 : | JMS サーバと JMS 分散送り先は assign コマンドを使用して割り当てる必要があります (「assign」を参照)。 |
エラーが発生した場合は、WLSTException
が返されます。
assignAll(sourceType, destinationType, destinationName)
以下の例では、すべてのサービスを adminServer
と cluster1
に割り当てます。
wls:/offline/mydomain> assignAll("Services", "Target", "adminServer,cluster1")
以下のサービスが存在する場合は、指定された対象に割り当てられます。MigratableRMIService
、Shutdownclass
、Startupclass
、FileT3
、RMCFactory
、MailSession
、MessagingBridge
、JMSConnectionFactory
、JDBCConnectionPool
、JDBCMultipool
、JDBCTxDatasource
、JDBCDataSource
、JDBCPoolComp
、JoltConnectionPool
、WLECConnectionPool
、および WTCServer
。
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
編集セッションを取り消して、編集ロックを解放し、未保存の変更をすべて破棄します。
このコマンドを発行するユーザは現在の編集者でなくてもかまいません。つまり、必要な場合は、他のユーザが編集セッションを開始できるように、管理者が編集セッションを取り消すことができます。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、現在の編集セッションを取り消します。WLST は取り消す前に確認を求めます。
wls:/mydomain/edit !>cancelEdit()
Sure you would like to cancel the edit session?(y/n)y
Edit session is cancelled successfully
wls:/mydomain/edit>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンラインまたはオフライン
現在の Bean に対して、指定されたタイプのコンフィグレーション Bean を作成します。
create
コマンドは新しく作成されたコンフィグレーション Bean のスタブを返します。エラーが発生した場合は、WLSTException
が返されます。
注意 : | 子タイプは、その親タイプのインスタンスの下に作成される必要があります。現在のコンフィグレーション管理オブジェクト (cmo ) タイプの子であるコンフィグレーション Bean のみを作成できます。cmo 変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。 |
WLST オンラインで create
コマンドを使用する場合は、以下の点に注意してください。
create
コマンドを使用することはできない。 edit
コマンドを使用してコンフィグレーション MBean 階層に移動する必要があります。「edit」を参照。
WLST オフラインで create
コマンドを使用する場合は、以下の点に注意してください。
create(name, childMBeanType, [baseProviderType])
config.xml ファイルに定義されたタイプのインスタンスを作成できる (カスタム セキュリティ タイプは除く)。有効なコンフィグレーション Bean の詳細については、『WebLogic Server MBean リファレンス』を参照。
|
|
以下の例では、現在のコンフィグレーション Bean で、newServer という名前の Server
タイプの子コンフィグレーション Bean を作成して、スタブを server1
に格納します。
wls:/mydomain/edit !>server1=create('newServer','Server')
Server with name `newServer' has been created successfully.
wls:/mydomain/edit !>server1.getName()
`newServer'
wls:/mydomain/edit !>
以下の例では、myProvider
という認証セキュリティ プロバイダを作成します。
wls:/mydomain/edit !>cd('SecurityConfiguration/mydomain/Realms/myrealm')
wls:/mydomain/edit !>create('myProvider','weblogic.security.providers.authentication.SQLAuthenticator','AuthenticationProvider')
以下の例では、highsec_nm
というマシンを作成して、関連するノード マネージャの属性を設定します。
wls:/mydomain/edit !>create('highsec_nm', 'Machine')
wls:/mydomain/edit !>cd('Machine/highsec_nm/NodeManager/highsec_nm')
wls:/mydomain/edit !>set('DebugEnabled', 'true')
wls:/mydomain/edit !>set('ListenAddress', 'innes')
wls:/mydomain/edit !>set('NMType', 'SSL')
wls:/mydomain/edit !>set('ShellCommand', '')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンラインまたはオフライン
現在のコンフィグレーション Bean に対する、指定されたタイプのコンフィグレーション Bean のインスタンスを削除します。
エラーが発生した場合は、WLSTException
が返されます。
注意 : | 現在のコンフィグレーション管理オブジェクト (cmo ) タイプの子であるコンフィグレーション Bean のみを削除できます。cmo 変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。 |
config.xml ファイルで定義されたタイプのインスタンスを削除できる。有効なコンフィグレーション Bean の詳細については、『WebLogic Server MBean リファレンス』を参照。
|
以下の例では、newServer という名前の Server
タイプのコンフィグレーション Bean を削除します。
wls:/mydomain/edit !> delete('newServer','Server')
Server with name 'newServer' has been deleted successfully.
wls:/mydomain/edit !>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
指定された文字列を暗号化します。暗号化した文字列は、コンフィグレーション ファイルやコマンドの引数として使用できます。
このコマンドは、暗号化された文字列を使用する必要のある各ドメインにつき 1 回呼び出す必要があります。暗号化された文字列は、その文字列が元々暗号化されたドメインでのみ使用できます。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、指定されたドメイン ディレクトリにある security/SerializedSystemIni.dat
ファイルを使用して、指定された文字列を暗号化します。
wls:/mydomain/serverConfig> es=encrypt('myPassword','c:/bea/domains/mydomain')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンラインまたはオフライン
指定された属性の値を返します。表示できる MBean 属性の詳細については、『WebLogic Server MBean リファレンス』を参照してください。エラーが発生した場合は、WLSTException
が返されます。
注意 : | ls('a') と入力すると、すべての属性とその現在の値を表示できます。詳細については、「ls」を参照してください。 |
代わりに、cmo
変数を使用して、現在のコンフィグレーション Bean の任意の get メソッドを実行できます。次に例を示します。
cmo
変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。
以下の例では、現在のコンフィグレーション Bean の AdministrationPort
の値を返します。
wls:/mydomain/serverConfig> get('AdministrationPort')
9002
cmo.getAdministrationPort()
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
ユーザがステータスを取得できる最新の ActivationTask
MBean を返します。ActivationTask
MBean には、ユーザが現在行っている変更、または最近行った変更の状態が反映されています。メソッドを呼び出して、進行中または完了したばかりの、最近のコンフィグレーション マネージャのアクティブ化タスクに関する情報を取得できます。エラーが発生した場合は、WLSTException
が返されます。
getActivationTask()
以下の例では、ユーザがステータスを取得できる最新の ActivationTask
MBean を返して、task 変数に格納します。
wls:/mydomain/serverConfig>task=getActivationTask()
wls:/mydomain/serverConfig>task.getState()
STATE_COMMITTED
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
現在のコンフィグレーション Bean の管理オペレーションを呼び出します。通常、このコマンドを使用して、ほとんどの WebLogic Server コンフィグレーション Bean で提供されている get
および set
以外のオペレーションを呼び出します。クラス オブジェクトは、このアクションが呼び出されるコンフィグレーション Bean をロードする際に使用されたものと同じクラス ローダから、ロードされます。
WLST が管理対象サーバ インスタンスに接続しているときに invoke
コマンドを使用することはできません。
成功した場合、invoke
コマンドは、呼び出されたオペレーションが返すオブジェクトを返します。エラーが発生した場合は、WLSTException
が返されます。
invoke(methodName, parameters, signatures)
以下の例では、現在のコンフィグレーション Bean の lookupServer
メソッドを呼び出します。
wls:/mydomain/config>objs = jarray.array([java.lang.String("oamserver")],java.lang.Object)
wls:/mydomain/edit>strs = jarray.array(["java.lang.String"],java.lang.String)
wls:/mydomain/edit>invoke('lookupServer',objs,strs)
true
wls:/mydomain/edit>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
編集セッションの進行中にこのコマンドを呼び出すと、現在進行中の編集に基づいて応答が行われます。属性の名前を指定した場合は、その属性に関してのみ、サーバの再起動が必要かどうかが示されます。
エラーが発生した場合は、WLSTException
が返されます。
isRestartRequired([attributeName])
以下の例では、現在の WLST セッション中に行われるすべての変更について、サーバの再起動が必要かどうかが示されます。
wls:/mydomain/edit !> isRestartRequired()
Server re-start is REQUIRED for the set of changes in progress.
The following attribute(s) have been changed on MBeans that require server re-start.
MBean Changed : mydomain:Name=mydomain,Type=Domain
Attributes changed : AutoConfigurationSaveEnabled
以下の例では、ConsoleEnabled
属性を編集する場合にサーバの再起動が必要かどうかが示されます。
wls:/mydomain/edit !>isRestartRequired("ConsoleEnabled")
Server re-start is REQUIRED if you change the attribute ConsoleEnabled wls:/mydomain/edit !>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オフライン
loadDB
コマンドは、テンプレート ファイルから SQL ファイルをロードします。このコマンドは、ドメイン テンプレートまたは拡張テンプレートがメモリにロードされた後でのみ発行できます (「readDomain」および「readTemplate」を参照)。
このコマンドを実行する前に、以下の条件に該当することを確認してください。
エラーが発生した場合は、WLSTException
が返されます。
loadDB(dbVersion, datasourceName, dbCategory)
jdbc.index ファイルおよびデータベース カテゴリの詳細については、http://edocs.beasys.co.jp/e-docs/common/docs100/tempref/tempref.html にある『ドメイン テンプレート リファレンス』の「テンプレートに含まれるファイル」を参照。
|
以下の例では、p13nDataSource
JDBC データ ソースを使用して、データベースのバージョン 5.1
用の Drop/Create P13N Database Objects
に関連する SQL ファイルをロードします。
wls:/offline/mydomain> loadDB('5.1', 'p13nDataSource', 'Drop/Create P13N Database Objects')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンラインおよびオフライン
プロパティ値をファイルからロードして、WLST セッションで使用できるようにします。
このコマンドは、「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合は使用できません。
エラーが発生した場合は、WLSTException
が返されます。
wls:/mydomain/serverConfig> loadProperties('c:/temp/myLoad.properties')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
編集されてまだ保存されていない編集内容を保存します。このコマンドは、編集セッションが進行中の場合にのみ有効です。編集セッションの開始方法については、「startEdit」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
save()
以下の例では、まだディスクに保存されていない編集内容を保存します。
wls:/mydomain/edit !>save()
Saving all your changes ...
Saved all your changes successfully.
wls:/mydomain/edit !>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンラインまたはオフライン
現在の管理オブジェクトの指定された属性値を設定します。WLST オフラインを使用する場合、このコマンドは、属性値をドメインのコンフィグレーション ファイルに書き込みます。WLST オンラインでは、MBean 属性の値が設定されます。オンラインでの変更は、編集をアクティブ化したときに、ドメインのコンフィグレーション ファイルに書き込まれます。
エラーが発生した場合は、WLSTException
が返されます。
暗号化された属性 (名前の末尾が Encrypted
となっている属性) の設定については、「暗号化されたコンフィグレーション値の読み書き」を参照してください。
WLST オンラインを使用する場合は以下の点に注意してください。
cmo
変数を使用できる。cmo.set
attrName
(
value
)
たとえば、set(`ListenPort', 7011)
を使用する代わりに、cmo.setListenPort(7011)
を使用できます。
cmo
変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。
以下の例では、DomainMBean
の ArchiveConfigurationCount
属性を 10
に設定します。
wls:/mydomain/serverConfig> set('ArchiveConfigurationCount',10)
次の例では、カスタム Mbean の T1TimerInterval
属性の long 値を 123
に設定しています。
wls:/mydomain/serverConfig> set(`T1TimerInterval', Long(123))
次の例では、カスタム Mbean の MyBooleanAttribute
属性のブール値を true
に設定しています。
wls:/mydomain/serverConfig> set(`MyBooleanAttribute', Boolean(true))
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オフライン
ドメインの作成または更新に関連するオプションを設定します。エラーが発生した場合は、WLSTException
が返されます。
setOption(optionName, optionValue)
以下の例では、CreateStartMenu
オプションを false
に設定します。
wls:/offline> setOption('CreateStartMenu', 'false')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
現在の編集セッション中に現在のユーザが行ったコンフィグレーションの変更内容を表示します。エラーが発生した場合は、WLSTException
が返されます。
以下の例では、現在の編集セッションが開始されてから、現在のユーザがコンフィグレーションに加えたすべての変更が表示されます。
wls:/mydomain/edit !>showChanges()
Changes that are in memory and saved to disc but not yet activated are:
MBean Changed : com.bea:Name=basicWLSDomain,Type=Domain
Operation Invoked : add
Attribute Modified : Machines
Attributes Old Value : null
Attributes New Value : Mach1
Server Restart Required : false
MBean Changed : com.bea:Name=basicWLSDomain,Type=Domain
Operation Invoked : add
Attribute Modified : Servers
Attributes Old Value : null
Attributes New Value : myserver
Server Restart Required : false
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
現在接続しているユーザのためにコンフィグレーション編集セッションを開始します。このコマンドを発行する前に、edit
コマンドを使用してコンフィグレーション MBean 階層に移動する必要があります。詳細については、「edit」を参照してください。
ドメイン コンフィグレーションを変更するコマンドを呼び出す前に、このコマンドを呼び出す必要があります。
エラーが発生した場合は、WLSTException
が返されます。
注意 : | 同じユーザによる進行中の編集セッションがあることを検出した場合、WLST は自動的に編集セッションを開始します。進行中のセッションは Administration Console または別の WLST セッションから開始された可能性があります。 |
startEdit([waitTimeInMillis], [timeoutInMillis], [exclusive])
以下の例では、まだディスクに保存されていない編集内容を保存します。
wls:/mydomain/edit>startEdit(60000, 120000)
Starting an edit session ...
Started edit session, please be sure to save and activate your changes once you are done.
wls:/mydomain/edit !>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
編集セッションを停止して、編集ロックを解放し、未保存の変更を破棄します。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、現在の編集セッションを停止します。WLST は取り消す前に確認を求めます。
wls:/mydomain/edit !>stopEdit()
Sure you would like to stop your edit session?(y/n)y
Edit session has been stopped successfully.
wls:/mydomain/edit>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オフライン
1 つまたは複数の送り先からアプリケーションまたはリソースの割り当てを解除します。
エラーが発生した場合は、WLSTException
が返されます。
unassign(sourceType, sourceName, destinationType, destinationName)
sourceType
および destinationType
の設定では以下のガイドラインを使用してください。
myServer
と myServer2
をクラスタ myCluster
から割り当て解除する。wls:/offline/medrec> unassign("Server", "myServer,myServer2", "Cluster", "myCluster")
myCluster
から割り当て解除する。wls:/offline/mydomain> unassign("Server", "*", "Cluster", "myCluster")
newUser
をグループ Monitors
から割り当て解除する。wls:/offline/medrec> unassign("User", "newUser", "Group", "Monitors")
myAppDeployment
を対象サーバ newServer
から割り当て解除する。wls:/offline/mydomain> unassign("AppDeployment", "myAppDeployment", "Target", "newServer")
MedRecAppScopedJMS.MedRecJMSServer
(アプリケーション デプロイメント AppDeployment
の子) を対象サーバ AdminServer
から割り当て解除する。wls:/offline/mydomain> assign('AppDeployment.SubDeployment.SubDeployment',
'MedRecEAR.MedRecAppScopedJMS.MedRecJMSServer', 'Target','AdminServer')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オフライン
注意 : | このコマンドは WebLogic Server 9.0 から非推奨になりました。unassign コマンドを使用するようにスクリプトを更新してください (「unassign」を参照)。このコマンドは引き続き、指定された sourceType のリソースが存在する場合は、そのリソースに対して機能します。 |
1 つまたは複数の送り先からすべてのアプリケーションまたはサービスの割り当てを解除します。
エラーが発生した場合は、WLSTException
が返されます。
unassignAll(sourceType, destinationType, destinationName)
以下の例では、すべてのサービスを adminServer
と cluster1
から割り当て解除します。
wls:/offline/medrec> unassignAll("Services", "Target", "adminServer,cluster1")
以下のサービスが存在する場合は、指定された対象から割り当て解除されます。MigratableRMIService
、Shutdownclass
、Startupclass
、FileT3
、RMCFactory
、MailSession
、MessagingBridge
、JMSConnectionFactory
、JDBCConnectionPool
、JDBCMultipool
、JDBCTxDatasource
、JDBCDataSource
、JDBCPoolComp
、JoltConnectionPool
、WLECConnectionPool
、および WTCServer
。
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
保存またはアクティブ化されていない編集をすべて元に戻します。
(ディスクに保存されたものも含めて) アクティブ化されていないすべての編集を元に戻すか、または、最後の save
オペレーション以降に行われたすべての編集を元に戻すかを指定します。このコマンドでは編集セッションは解放されません。
エラーが発生した場合は、WLSTException
が返されます。
undo([unactivateChanges], [defaultAnswer])
以下の例では、最後の save
オペレーション以降に行われたすべての変更を元に戻します。WLST は元に戻す前に確認を求めます。
wls:/mydomain/edit !>undo()
Sure you would like to undo your changes?(y/n)y
Discarded your in-memory changes successfully.
wls:/mydomain/edit>
以下の例では、アクティブ化されていないすべての変更を元に戻します。WLST は元に戻す前に確認を求めます。
wls:/mydomain/edit !>undo('true')
Sure you would like to undo your changes?(y/n)y
Discarded all your changes successfully.
wls:/mydomain/edit>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
変更されてまだ保存されていない変更内容を検証します。このコマンドを使用すると、保存する前に、すべての変更が有効かどうかを検証することができます。
エラーが発生した場合は、WLSTException
が返されます。
validate()
以下の例では、変更されてまだ保存されていないすべての変更内容を検証します。
wls:/mydomain/edit !>validate()
Validating changes ...
Validated the changes successfully
表 A-7 に示す WLST 情報コマンドを使用して、ドメイン、サーバ、変数に照会したり、コンフィグレーション Bean、実行時 Bean、WLST に関連した情報を提供したりします。
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
指定された MBean に JMX リスナを追加します。MBean で変更が行われると、その内容が標準出力に報告されて、指定されたコンフィグレーション ファイルに保存されます。
エラーが発生した場合は、WLSTException
が返されます。
addListener(mbean, [attributeNames], [logFile], [listenerName])
以下の例では、cmo
MBean で、Notes
および ArchiveConfigurationCount
属性に対して JMX リスナを定義します。リスナの名前は domain-listener
で、./listeners/domain.log
に保存されます。
wls:/mydomain/serverConfig> addListener(cmo, "Notes,ArchiveConfigurationCount","./listeners/domain.log","domain-listener")
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
既存のサーバ コンフィグレーション (config
ディレクトリ) を実行可能な WLST スクリプトに変換します。その結果得られたスクリプトは、他のサーバ上のリソースの再作成に使用できます。
configToScript コマンドでは次のファイルが作成されます。
エラーが発生した場合は、WLSTException
が返されます。
configToScript([configPath], [pyPath], [overwrite], [propertiesFile], [createDeploymentScript])
以下の例では、コンフィグレーションを WLST スクリプト config.py
に変換します。デフォルトで、コンフィグレーション ファイルは ./config
からロードされて、スクリプト ファイルは .config/config.py
に、プロパティ ファイルは .config/config.py.properties
に保存されます。
wls:/offline>configToScript()
configToScript is loading configuration from c:\bea\user_projects\domains\wls\config\config.xml ...
Completed configuration load, now converting resources to wlst script...
configToScript completed successfully
The WLST script is written to c:\bea\user_projects\domains\wls\config\config.py
and the properties file associated with this script is written to c:\bea\user_projects\domains\wls\config\config.py.properties
wls:/offline>
以下の例では、c:\bea\user_projects\domains\mydomain\config
ディレクトリにあるファイルでコンフィグレーションされたサーバ リソースを、WLST スクリプト c:\bea\myscripts\config.py
に変換します。
wls:/offline>configToScript('c:/bea/user_projects/domains/mydomain',
configToScript is loading configuration from c:\bea\user_projects\domains\mydomain\config\config.xml ...
'c:/bea/myscripts')
Completed configuration load, now converting resources to wlst script...
configToScript completed successfully
The WLST script is written to c:\bea\myscripts\config.py
and the properties file associated with this script is written to c:\bea\mydomain\config.py.properties
wls:/offline>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST アクションの実行中に発生した最近の例外のスタック トレースを表示して、スタック トレースをリセットします。
成功した場合、dumpstack
コマンドは Throwable オブジェクトを返します。エラーが発生した場合は、WLSTException
が返されます。
wls:/myserver/serverConfig>dumpStack()
com.bea.plateng.domain.script.jython.WLSTException: java.lang.reflect.Invocation TargetException
...
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST によって使用されたすべての変数を、その名前と値を含めて表示します。エラーが発生した場合は、WLSTException
が返されます。
wls:/mydomain/serverConfig>dumpVariables()
adminHome weblogic.rmi.internal.BasicRemoteRef - hostID:
'-1 108080150904263937S:localhost:[7001,8001,-1,-1,-1,-1,-1]:
mydomain:AdminServer', oid: '259', channel: 'null'
cmgr [MBeanServerInvocationHandler]com.bea:Name=ConfigurationManager,
Type=weblogic.management.mbeanservers.edit.ConfigurationManagerMBean
cmo [MBeanServerInvocationHandler]com.bea:Name=mydomain,Type=Domain
connected true
domainName mydomain
...
wls:/mydomain/serverConfig>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
WLST は、属性または属性タイプとその値を格納する MBean のパス名を返します。searchInstancesOnly
を false
に設定した場合は、サーバでインスタンス化されていないものの、作成が可能な MBeanType パスの検索も行います。エラーが発生した場合は、WLSTException
が返されます。
find([name], [type], [searchInstancesOnly])
以下の例では、現在のコンフィグレーション階層で javaCompiler
という属性を検索します。
wls:/mydomain/serverConfig>find(name = 'JavaCompiler')
Finding 'JavaCompiler' in all registered MBean instances ...
/Servers/AdminServer JavaCompilerPreClassPath null
/Servers/AdminServer JavaCompiler java
/Servers/AdminServer JavaCompilerPostClassPath null
wls:/mydomain/serverConfig>
以下の例では、現在のコンフィグレーション階層で JMSRuntime
タイプの属性を検索します。
wls:/mydomain/serverRuntime>find(type='JMSRuntime')
Finding MBean of type 'JMSRuntime' in all the instances ...
/JMSRuntime/AdminServer.jms
wls:/mydomain/serverRuntime>
以下の例では、現在のコンフィグレーション階層で execute
という属性を検索します。searchInstancesOnly
引数は false
に設定されており、サーバでインスタンス化されていない MBeanType も検索することを示しています。
wls:/mydomain/serverConfig>find(name='execute', searchInstancesOnly='false')
Finding 'execute' in all registered MBean instances ...
/Servers/AdminServer ExecuteQueues [Ljavax.management.ObjectName;@1aa7dbc
/Servers/AdminSever Use81StyleExecuteQueues false
Now finding 'execute' in all MBean Types that can be instantiated ...
/Servers ExecuteQueues
/Servers Use81StyleExecuteQueues
wls:/mydomain/serverConfig>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
変更プロセスを管理している最新の ConfigurationManager
MBean を返します。そのメソッドを呼び出して、ドメイン内のコンフィグレーションの変更を管理できます。エラーが発生した場合は、WLSTException
が返されます。
以下の例では、最新の ConfigurationManagerBean
MBean を返して、cm 変数に格納します。
wls:/mydomain/serverConfig>cm=getConfigManager()
wls:/mydomain/serverConfig>cm=getType()
'weblogic.management.mbeanservers.edit.ConfigurationManagerMBean'
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
指定されたパスを参照して MBean を返します。エラーが発生した場合は、WLSTException
が返されます。
注意 : | MBean が見つからない場合に例外は送出されません。 |
wls:/mydomain/edit !>com=getMBean('Servers/myserver/COM/myserver')
wls:/mydomain/edit !>com.getType()
`Server'
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
指定された MBeanType
または cmo
変数の MBeanInfo
を返します。エラーが発生した場合は、WLSTException
が返されます。
以下の例では、指定された MBeanType
の MBeanInfo
を取得して、svrMbi
変数に格納します。
wls:/mydomain/serverConfig> svrMbi=getMBI('weblogic.management.configuration.ServerMBean')
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
現在のツリーで、指定された MBean インスタンスの MBean パスまたは MBean の ObjectName を返します。エラーが発生した場合は、WLSTException
が返されます。
wls:/mydomain/edit !>path=getPath('com.bea:Name=myserver,Type=Server')
wls:/mydomain/edit !>print path
'Servers/myserver'
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
cmo
で作成または削除できるすべての子 MBean を表示します。cmo
変数は、WLST を使用して最後に移動したコンフィグレーション Bean インスタンスを表します。cmo
変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、cmo
タイプで作成または削除できる子 MBean を表示します。
wls:/mydomain/serverConfig>listChildTypes()
AppDeployments
BridgeDestinations
CachingRealms
Clusters
...
wls:/mydomain/serverConfig>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
指定された MBean をルックアップします。MBean は現在の MBean の子でなければなりません。エラーが発生した場合は、WLSTException
が返されます。
lookup(name, [childMBeanType])
以下の例では、指定されたサーバ myserver
をルックアップして、返されたスタブを sbean
変数に格納します。
wls:/mydomain/serverConfig>sbean=lookup('myserver','Server')
wls:/mydomain/serverConfig>sbean.getType()
`Server'
wls:/mydomain/serverConfig>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
指定した管理オブジェクトの属性、オペレーション、および子の管理オブジェクトをリストします。
エラーが発生した場合は、WLSTException
が返されます。
デフォルトでは、出力は文字列として返され、3 つの列に配列されます。
:
parameterType(
parameterName)
デフォルトの出力では、現在の管理オブジェクトのすべての属性、オペレーション、および子の管理オブジェクトがリストされます。出力をフィルタリングする、または異なる管理オブジェクトのリストを表示するには、コマンドの引数を指定します。
WLST オフラインを使用する場合は以下の点に注意してください。
Log
管理オブジェクトは表示されません。
WLST オフラインで表示されない管理オブジェクトの属性のデフォルト値を変更する場合、最初に create
コマンドを使用して管理オブジェクトを作成する必要があります。次に、cd
を使用して管理オブジェクトに移動し、属性値を変更します。「create」を参照してください。
ls( [
moPath ]
returnMap
[
returnType
]
)
以下の例では、examples
ドメインの、すべての子コンフィグレーション Bean と属性名および値を表示します。このドメインは WLST オフライン モードでメモリにロードされています。
wls:/offline/mydomain >ls()
dr-- AppDeployments
dr-- BridgeDestinations
dr-- Clusters
dr-- CustomResources
dr-- DeploymentConfiguration
dr-- Deployments
dr-- EmbeddedLDAP
dr-- ErrorHandlings
dr-- FileStores
dr-- InternalAppDeployments
dr-- InternalLibraries
dr-- JDBCDataSourceFactories
dr-- JDBCStores
dr-- JDBCSystemResources
dr-- JMSBridgeDestinations
dr-- JMSInteropModules
dr-- JMSServers
dr-- JMSSystemResources
dr-- JMX
...
wls:/offline/examples>
以下の例では、DomainMBean
ドメインのすべての属性名と値を表示します。
wls:/mydomain/serverConfig>ls('a')
-r-- AdminServerName AdminServer
-r-- AdministrationMBeanAuditingEnabled false
-r-- AdministrationPort 9002
-r-- AdministrationPortEnabled false
-r-- AdministrationProtocol t3s
-r-- ArchiveConfigurationCount 0
-r-- ClusterConstraintsEnabled false
-r-- ConfigBackupEnabled false
-r-- ConfigurationAuditType none
-r-- ConfigurationVersion 9.0.0.0
-r-- ConsoleContextPath console
-r-- ConsoleEnabled true
-r-- ConsoleExtensionDirectory console-ext
-r-- DomainVersion 9.0.0.0
-r-- LastModificationTime 0
-r-- Name basicWLSDomain
-r-- Notes null
-r-- Parent null
-r-- ProductionModeEnabled false
-r-- RootDirectory .
-r-- Type Domain
wls:/mydomain/serverConfig>
以下の例では、Servers
MBean のすべての子 Bean と属性名および値を表示します。
wls:/mydomain/serverConfig> ls('Servers')
dr-- AdminServer
以下の例では、指定された MBean パスの属性名と値を表示し、その情報をマップで返します。
wls:/mydomain/serverConfig> svrAttrList = ls('edit:/Servers/myserver', 'true', 'a')
-rw- AcceptBacklog 50
-rw- AdminReconnectIntervalSeconds 10
-rw- AdministrationPort 9002
-rw- AdministrationProtocol t3s
-rw- AutoKillIfFailed false
-rw- AutoMigrationEnabled false
-rw- AutoRestart true
-rw- COMEnabled false
-rw- ClasspathServletDisabled false
-rw- ClientCertProxyEnabled false
-rw- Cluster null
-rw- ClusterRuntime null
-rw- ClusterWeight 100
wls:/mydomain/serverConfig>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
現在の MBean またはその MBean の指定された属性に関する、MBeanInfo
のヘルプを表示します。エラーが発生した場合は、WLSTException
が返されます。
以下の例では、ServerMBean
Bean に関する MBeanInfo
のヘルプを表示します。
wls:/mydomain/serverConfig>man('Servers')
dynamic : true
creator : createServer
destroyer : destroyServer
description : <p>Returns the ServerMBeans representing the servers that have been configured to be part of this domain.</p>
descriptorType : Attribute
Name : Servers
interfaceClassName : [Lweblogic.management.configuration.ServerMBean;
displayName : Servers
relationship : containment
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST の情報、エラー、およびデバッグに関する各メッセージを指定したファイル名にリダイレクトします。また、dumpStack()
および dumpVariables()
コマンドの出力を、指定したファイル名にリダイレクトします。
エラーが発生した場合は、WLSTException
が返されます。
redirect(outputFile, [toStdOut])
以下の例では、logs/wlst.log
ファイルへ、WLST 出力のリダイレクトを開始します。
wls:/mydomain/serverConfig> redirect('./logs/wlst.log')
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
以前に定義したリスナを削除します。引数を指定しない場合は、すべての MBean で定義されたすべてのリスナが削除されます。リスナの設定の詳細については、「addListener」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
removeListener([mbean], [listenerName])
以下の例では、mylistener
というリスナを削除します。
wls:/mydomain/serverConfig> removeListener(listenerName="mylistener")
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
現在定義されているすべてのリスナを表示します。リスナの設定の詳細については、「addListener」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
showListeners()
以下の例では、現在定義されているすべてのリスナを表示します。
wls:/mydomain/serverConfig> showListeners()
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST とユーザのすべての対話を記録します。このコマンドは、再試行するコマンドの捕捉に役立ちます。
エラーが発生した場合は、WLSTException
が返されます。
このコマンドは、「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合は使用できません。
startRecording(recordFile, [recordAll])
以下の例では、record.py
ファイルに WLST コマンドの記録を開始します。
wls:/mydomain/serverConfig>startRecording('c:/myScripts/record.py')
Starting recording to c:/myScripts/record.py
wls:/mydomain/serverConfig>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
ノード マネージャを使用して、サーバまたはクラスタとその状態のマップを返します。ノード マネージャが動作している必要があります。
サーバの状態の詳細については、『サーバの起動と停止の管理』の「サーバのライフサイクルについて」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、管理対象サーバ managed1
の状態を返します。
wls:/mydomain/serverConfig>state('managed1','Server')
Current state of "managed1": SUSPENDED
wls:/mydomain/serverConfig>
以下の例では、クラスタ mycluster
の状態を返します。
wls:/mydomain/serverConfig>state('mycluster','Cluster')
There are 3 server(s) in cluster: mycluster
States of the servers are
MServer1---SHUTDOWN
MServer2---SHUTDOWN
MServer3---SHUTDOWN
wls:/mydomain/serverConfig>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST コマンドの記録を停止します。記録の開始の詳細については、「startRecording」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
wls:/mydomain/serverConfig>stopRecording()
Stopping recording to c:\myScripts\record.py
wls:/mydomain/serverConfig>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST 出力のファイルへのリダイレクトが行われている場合は、リダイレクトを停止します。
エラーが発生した場合は、WLSTException
が返されます。
stopRedirect()
以下の例では、WLST 出力のファイルへのリダイレクトを停止します。
wls:/mydomain/serverConfig> stopRedirect()
WLST output will not be redirected to myfile.txt any more
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
ユーザ コンフィグレーション ファイルと、関連付けられたキー ファイルを作成します。ユーザ コンフィグレーション ファイルには、暗号化されたユーザ名とパスワードが格納されます。キー ファイルには、ユーザ名とパスワードの暗号化と復号化に使用される秘密鍵が格納されます。
最初にユーザ名とパスワードを暗号化したキー ファイルのみが、その値の復号化に使用されます。キー ファイルを失った場合には、新しいユーザ コンフィグレーション ファイルとキー ファイルのペアを作成しなければなりません。
エラーが発生した場合は、WLSTException
が返されます。
storeUserConfig([
userConfigFile
], [
userKeyFile
], [
nm
])
以下の例では、デフォルトの場所に、ユーザ コンフィグレーション ファイルとキー ファイルが作成および格納されます。
wls:/mydomain/serverConfig>storeUserConfig()
キー ファイルを作成する場合、作成後にそのファイルを保護された場所に格納しないと、システムのセキュリティが低下する可能性があります。キー ファイルを作成しますか?y または ny
この (現在の WLS 接続) 接続に使用されたユーザ名とパスワードは C:\Documents and Settings\pat\pat-WebLogicConfig.properties と
C:\Documents and Settings\pat\pat-WebLogicKey.properties に保存されています。
以下の例では、指定された場所に、ユーザ コンフィグレーション ファイルとキー ファイルが作成および格納されます。
wls:/mydomain/serverConfig>storeUserConfig('c:/myFiles/myuserconfigfile.secure', 'c:/myFiles/myuserkeyfile.secure')
キー ファイルを作成する場合、作成後にそのファイルを保護された場所に格納しないと、システムのセキュリティが低下する可能性があります。キー ファイルを作成しますか?y または ny
この (現在の WLS 接続) 接続に使用されたユーザ名とパスワードは c:/myFiles/mysuserconfigfile.secure と c:/myFiles/myuserkeyfile.secure に保存されています。
wls:/mydomain/serverConfig>
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインまたはオフライン
指定されたサーバのスレッド ダンプを表示します。エラーが発生した場合は、WLSTException
が返されます。
threadDump([writeToFile], [fileName], [serverName])
以下の例では、現在のサーバのスレッド ダンプを表示して、出力を Thread_Dump_
serverName
ファイルに保存します。
wls:/mydomain/serverConfig> threadDump()
以下の例では、サーバ managedServer
のスレッド ダンプを表示します。情報はファイルに保存されません。
wls:/mydomain/serverConfig> threadDump(writeToFile='false', serverName='managedServer')
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
属性名と属性値、オペレーションなど、MBean に関する情報を表示します。エラーが発生した場合は、WLSTException
が返されます。
以下の例では、現在の MBean cmo
に関する情報を表示します。
wls:/mydomain/serverConfig>cmo.getType()
`Domain'
wls:/mydomain/serverConfig>viewMBean(cmo)
Attribute Names and Values
--------------------------
XMLEntityCaches null
Targets javax.management.ObjectName[com.bea
:Name=MedRecJMSServer,Type=JMSServer,
com.bea:Name=WSStoreForwardInternalJMSServerMedRecServer,Type=JMSServer,
com.bea:Name=MedRecWseeJMSServer,Type=JMSServer,
com.bea:Name=PhysWSEEJMSServer,Type=JMSServer,
com.bea:Name=MedRecSAFAgent,Type=SAFAgent,
com.bea:Name=AdminServer,Type=Server]
RootDirectory .
EmbeddedLDAP com.bea:Name=OOTB_medrec,Type=EmbeddedLDAP
RemoteSAFContexts null
Libraries javax.management.ObjectName[com.bea
...
wls:/mydomain/serverConfig>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
上級ユーザが Jython モジュールとしてインポートできるように、WLST 定義およびメソッド宣言を Python (.py
) ファイルに変換します。インポートすると、その定義とメソッド宣言は他の Jython モジュールから使用できるようになり、Jython 構文を使用して直接アクセスできます。詳細については、「Jython モジュールとしての WLST のインポート」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、WLST を wl.py
という Python ファイルに変換します。
wls:/offline>
writeIniFile("wl.py")
The Ini file is successfully written to wl.py
wls:/offline>
表 A-9 に示す WLST ライフサイクル コマンドを使用して、サーバ インスタンスのライフサイクルを管理します。
サーバ インスタンスのライフサイクルの詳細については、『サーバの起動と停止の管理』の「サーバのライフサイクルについて」を参照してください。
コマンド カテゴリ : ライフサイクル コマンド
WLST の使用状況 : オンライン
指定されたサービス (JTA、JMS、またはサーバ) を、クラスタ内の対象のサーバに移行します。エラーが発生した場合は、WLSTException
が返されます。
サービスの移行については、『WebLogic Server クラスタ ユーザーズ ガイド』の「サービス レベルの移行」を参照してください。
migrate(sname
,destinationName
, [sourceDown
], [destinationDown
], [migrationType
])
以下の例では、server1
にあるすべての JMS および JTA サービスを server2
に移行します。ブール値の引数では、元のサーバが停止していて、移行先のサーバが動作していることを指定します。
wls:/mydomain/edit !>migrate('server1','server2', 'true', 'false', 'all')
Migrating all JMS and JTA services from 'server1' to destination `server2' ...
wls:/mydomain/edit !>
以下の例では、server1
にあるすべてのサーバ サービスを server2
に移行します。ブール値の引数では、元のサーバが停止していて、移行先のサーバが動作していることを指定します。
wls:/mydomain/edit !>migrate('server1','server2', 'true', 'false', 'Server')
Migrating singleton server services from 'server1' to machine 'server2'...
wls:/mydomain/edit !>
コマンド カテゴリ : ライフサイクル コマンド
WLST の使用状況 : オンライン
中断された、または ADMIN
状態にあるサーバ インスタンスを再開します。このコマンドはサーバを RUNNING
状態に移行します。サーバの状態の詳細については、『サーバの起動と停止の管理』の「サーバのライフサイクルについて」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
false で、ユーザ対話がブロックされないことを示す。この場合、WLST はコマンドを発行した後でユーザに制御を返し、現在のタスクに関連付けられているタスク MBean を変数に割り当てる。その変数を利用すると、タスクのステータスをチェックできる。「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合、block は常に true に設定される。
|
wls:/mydomain/serverConfig>resume('managed1', block='true')
Server 'managed1' resumed successfully.
wls:/mydomain/serverConfig>
コマンド カテゴリ : ライフサイクル コマンド
WLST の使用状況 : オンライン
実行中のサーバ インスタンスまたはクラスタを正常に停止します。shutdown
コマンドは、進行中のすべての作業が完了するのを待機してから、サーバまたはクラスタを停止します。
引数を指定しないで shutdown
コマンドを入力すると、WLST が接続しているサーバが停止されます。
管理対象サーバ インスタンスに接続している場合は、WLST が接続している管理対象サーバ インスタンスを停止するためにのみ shutdown
コマンドを使用できます。管理対象サーバ インスタンスに接続しているときに、別のサーバを停止することはできません。
WLST はノード マネージャを使用して管理対象サーバを停止します。管理対象サーバを停止するときは、ノード マネージャが動作している必要があります。
エラーが発生した場合は、WLSTException
が返されます。
shutdown([name], [entityType], [ignoreSessions], [timeOut], [force], [block])
false で、ユーザ対話がブロックされないことを示す。この場合、WLST はコマンドを発行した後でユーザに制御を返し、現在のタスクに関連付けられているタスク MBean を変数に割り当てる。その変数を利用すると、タスクのステータスをチェックできる。「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合、block は常に true に設定される。
|
以下の例では、接続しているサーバを停止するように WLST に指示します。
wls:/mydomain/serverConfig>shutdown()
Shutting down the admin server that you are currently connected to .......
Disconnected from weblogic server: AdminServer
以下の例では、HTTP セッションが完了または (1000 ミリ秒で) タイムアウトするのを 1000 ミリ秒待機してから myserver
を停止するように、WLST に指示します。
wls:/mydomain/serverConfig> shutdown('myserver','Server','false',1000, block='false')
以下の例では、管理対象サーバ インスタンスに接続しているときに、すべての HTTP セッションを直ちに中止するように、WLST に指示します。
wls:/mydomain/serverConfig>shutdown('MServer1','Server','true',1200)
Shutting down a managed server that you are connected to ...
Disconnected from weblogic server: MServer1
以下の例では、クラスタ mycluster
を停止するように WLST に指示します。
wls:/mydomain/serverConfig>shutdown('mycluster','Cluster')
Shutting down the cluster with name mycluster
Shutdown of cluster mycluster has been issued, please
refer to the logs to check if the cluster shutdown is successful.
Use the state(<server-name>) or state(<cluster-name>,"Cluster")
to check the status of the server or cluster
wls:/mydomain/serverConfig>state('mycluster','Cluster')
There are 3 server(s) in cluster: mycluster
States of the servers are
MServer1---SHUTDOWN
MServer2---SHUTDOWN
MServer3---SHUTDOWN
wls:/mydomain/serverConfig>
コマンド カテゴリ : ライフサイクル コマンド
WLST の使用状況 : オンライン
ノード マネージャを使用して管理対象サーバ インスタンスまたはクラスタを起動します。WLST が管理サーバに接続していて、ノード マネージャが動作している必要があります。
ノード マネージャに接続して使用するための WLST コマンドの詳細については、「ノード マネージャ コマンド」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
start(name, [type], [url], [block])
false で、ユーザ対話がブロックされないことを示す。この場合、WLST はコマンドを発行した後でユーザに制御を返し、現在のタスクに関連付けられているタスク MBean を変数に割り当てる。その変数を利用すると、タスクのステータスをチェックできる。「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合、block は常に true に設定される。
|
以下の例では、ノード マネージャに管理対象サーバ インスタンスを起動するように指示します。リスン アドレスは localhost
、リスン ポートは 8801
です。block
が false
に設定されているので、WLST はこのコマンドを発行した後で制御をユーザに返します。
wls:/mydomain/serverConfig>start('myserver', 'Server', block='false')
Starting server myserver ...
Server with name myserver started successfully.
wls:/mydomain/serverConfig>
以下の例では、ノード マネージャにクラスタを起動するように指示します。block
は true
に設定されているので、WLST はクラスタが起動されるまでユーザの対話をブロックします。
wls:/mydomain/serverConfig>start('mycluster', 'Cluster')
Starting the following servers in Cluster, mycluster: MS1, MS2, MS3...
......................................................................
All servers in the cluster mycluster are started successfully.
wls:/mydomain/serverConfig>
コマンド カテゴリ : ライフサイクル コマンド
WLST の使用状況 : オンラインまたはオフライン
管理サーバを起動します。エラーが発生した場合は、WLSTException
が返されます。
startServer([adminServerName], [domainName], [url], [username], [password],
[domainDir], [block], [timeout], [serverLog], [systemProperties], [jvmArgs])
block を false に設定した場合、WLST はコマンドを発行した後でユーザに制御を返し、現在のタスクに関連付けられているタスク MBean を変数に割り当てる。その変数を利用すると、タスクのステータスをチェックできる。この引数のデフォルトは true で、ユーザ対話がブロックされることを示す。「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合、block は常に true に設定される。
|
|
以下の例では、demoDomain
の demoServer
という管理サーバを起動します。
wls:/offline> startServer('demoServer','demoDomain','t3://localhost:8001',
'myweblogic','wlstdomain','c:/mydomains/wlst','false', 60000, jvmArgs='-XX:MaxPermSize=75m, -Xmx512m, -XX:+UseParallelGC')
wls:/offline>
コマンド カテゴリ : ライフサイクル コマンド
WLST の使用状況 : オンライン
実行中のサーバを中断します。このコマンドでは、サーバを RUNNING
状態から ADMIN
状態に移行します。サーバの状態の詳細については、『サーバの起動と停止の管理』の「サーバのライフサイクルについて」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
suspend([sname], [ignoreSessions], [timeOut], [force], [block])
false で、ユーザ対話がブロックされないことを示す。この場合、WLST はコマンドを発行した後でユーザに制御を返し、現在のタスクに関連付けられているタスク MBean を変数に割り当てる。その変数を利用すると、タスクのステータスをチェックできる。「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合、block は常に true に設定される。
|
wls:/mydomain/serverConfig> suspend('managed1')
Server 'managed1' suspended successfully.
wls:/mydomain/serverConfig>
表 A-10 に示す WLST ノード マネージャ コマンドを使用して、WebLogic Server インスタンスを起動、停止、再起動、およびモニタします。
このカテゴリのコマンドを実行する前に、ノード マネージャを実行する必要があります。
ノード マネージャの詳細については、『サーバの起動と停止の管理』の「ノード マネージャを使用したサーバの制御」を参照してください。
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST がノード マネージャに接続しているかどうかを判断します。true
または false
を返し、説明のメッセージを出力します。このコマンドを実行する前に、ノード マネージャを実行する必要があります。
エラーが発生した場合は、WLSTException
が返されます。
nm()
以下の例では、WLST は現在、mydomain
をモニタするノード マネージャに接続しています。
wls:/mydomain/serverConfig>nm()
Currently connected to Node Manager that is monitoring the domain "mydomain"
wls:/mydomain/serverConfig>
以下の例では、WLST は現在ノード マネージャに接続していません。
wls:/mydomain/serverConfig>nm()
Not connected to any Node Manager
wls:/mydomain/serverConfig>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST をノード マネージャに接続してセッションを確立します。ノード マネージャに接続したら、WLST からノード マネージャ コマンドを呼び出すことができます。このコマンドを実行する前に、ノード マネージャを実行する必要があります。
接続すると、WLST プロンプトには wls:/nm/
domainName
> と表示されます。domainName
は管理するドメインの名前を表します。その後で WLST を WebLogic Server に接続すると、プロンプトには WebLogic Server インスタンスが示されます。nm
コマンドを使用すると、WLST がノード マネージャに接続しているかどうかを判断できます (「nm」を参照)。
エラーが発生した場合は、WLSTException
が返されます。
nmConnect([username, password], [host], [port], [domainName], [domainDir] [nmType], [verbose])
nmConnect([userConfigFile, userKeyFile], [host], [port], [domainName], [domainDir] [nmType], [verbose])
|
|||
|
|||
storeUserConfig コマンドはキー ファイルを使用してユーザ名とパスワードを暗号化する。ユーザ コンフィグレーション ファイルを暗号化するキー ファイルのみが、そのユーザ名とパスワードを復号化できる (「storeUserConfig」を参照)。
|
|||
以下の例では、デフォルトのホストおよびポート番号と plain
ノード マネージャ タイプを使用して、oamdomain
をモニタするノード マネージャに WLST を接続します。
wls:/myserver/serverConfig>nmConnect('weblogic', 'weblogic', 'localhost', '5555', 'oamdomain', 'c:/bea/user_projects/domains/oamdomain','plain')
Connecting to Node Manager Server ...
Successfully connected to Node Manager.
wls:/nm/oamdomain>
以下の例では、ユーザの資格を提供するユーザ コンフィグレーション ファイルとキー ファイルを使用して、WLST をノード マネージャ サーバ インスタンスに接続します。
wls:/myserver/serverConfig>nmConnect(userConfigFile='c:/myfiles/myuserconfigfile.secure', userKeyFile='c:/myfiles/myuserkeyfile.secure',
host='172.18.137.82', port=26106, domainName='mydomain',
domainDir='c:/myfiles/mydomain', mType='plain')
Connecting to Node Manager Server ...
Successfully connected to Node Manager.
wls:/nm/mydomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
このコマンドを実行するには、WLST が管理サーバに接続している必要があります。
WLST をノード マネージャ セッションから接続解除します。
エラーが発生した場合は、WLSTException
が返されます。
nmDisconnect()
以下の例では、WLST をノード マネージャ セッションから接続解除します。
wls:/nm/oamdomain>nmDisconnect()
Successfully disconnected from Node Manager
wls:/myserver/serverConfig>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンライン
WLST が現在動作しているマシンを登録します。このコマンドを実行するには WLST が管理サーバに接続している必要がありますが、ノード マネージャに接続している必要はありません。
このコマンドでは、以下のファイルを管理サーバからダウンロードします。
また、このコマンドでは、WL_HOME
/common/nodemanager
ディレクトリにある nodemanager.domains
ファイルをドメイン情報で更新します。WL_HOME
は WebLogic Server の最上位のインストール ディレクトリです。
ドメインが管理サーバとルート ディレクトリを共有している場合を除いて、このコマンドは 1 つのドメイン、1 つのマシンごとに実行する必要があります。
このコマンドを実行するときにそのマシンが既に登録されている場合は、ノード マネージャ秘密ファイル (nm_password.properties
) が管理サーバの最新の情報で更新されます。
エラーが発生した場合は、WLSTException
が返されます。
nmEnroll([domainDir], [nmHome])
以下の例では、現在のマシンをノード マネージャに登録して、ノード マネージャ秘密ファイル (nm_password properties
) と SerializedSystemIni.dat
ファイルを c:/bea/mydomain/common/nodemanager/nm_password.properties
に保存します。nodemanager.domains
ファイルはデフォルトでは WL_HOME
/common/nodemanager
に書き込まれます。
wls:/mydomain/serverConfig>nmEnroll('c:/bea/mydomain/common/nodemanager')
Enrolling this machine with the domain directory atc:\bea\mydomain\common\nodemanager
....
Successfully enrolled this machine with the domain directory at C:\bea\mydomain\common\nodemanager
wls:/mydomain/serverConfig>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンライン
指定されたサーバのためのノード マネージャ プロパティ ファイル boot.properties
および startup.properties
を生成します。ノード マネージャ プロパティ ファイルは、指定されたサーバのルート ディレクトリを基準とする相対的な場所に格納されます。対象となるルート ディレクトリは、コマンドを実行しているマシンと同じマシン上にある必要があります。
サーバの名前を指定する必要があります。指定しないと、コマンドは失敗します。
エラーが発生した場合は、WLSTException
が返されます。
nmGenBootStartupProps(serverName)
次の例では、指定されたサーバ ms1
のルート ディレクトリ内に boot.properties
および startup.properties
を生成します。
wls:/mydomain/serverConfig>nmGenBootStartupProps('ms1')
Successfully generated boot.properties at c:\bea\mydomain\servers\ms1\data\nodemanager\boot.properties
Successfully generated startup.properties at c:\bea\mydomain\servers\ms1\data\nodemanager\startup.properties
wls:/mydomain/serverConfig>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
このコマンドを実行するには、WLST が管理サーバに接続している必要があります。
ノード マネージャで起動された、指定されたサーバ インスタンスを強制停止します。
serverName
引数を使用してサーバ名を指定しない場合、引数はデフォルトで myServer
に設定されます。この引数は使用しているサーバ名と一致している必要があり、一致していない場合はコマンドが失敗します。
起動する際にノード マネージャを使用しなかったサーバ インスタンスを強制停止しようとすると、エラーが表示されます。
エラーが発生した場合は、WLSTException
が返されます。
以下の例では、oamserver
というサーバを強制停止します。
wls:/nm/oamdomain>nmKill('oamserver')
Killing server `oamserver' ...
Server oamServer killed successfully.
wls:/nm/oamdomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
このコマンドを実行するには、WLST が管理サーバに接続している必要があります。
エラーが発生した場合は、WLSTException
が返されます。
wls:/nm/oamdomain>nmLog()
Successfully retrieved the Node Manager log and written.
wls:/nm/oamdomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
このコマンドを実行するには、WLST が管理サーバに接続している必要があります。
ノード マネージャで起動されたサーバのサーバ出力ログを返します。
エラーが発生した場合は、WLSTException
が返されます。
nmServerLog([serverName], [writer])
以下の例では、oamserver
サーバのサーバ出力ログを表示して、ログ出力を myWriter
に書き込みます。
wls:/nm/oamdomain>nmServerLog('oamserver',myWriter)
Successfully retrieved the server log and written.
wls:/nm/oamdomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
このコマンドを実行するには、WLST が管理サーバに接続している必要があります。
ノード マネージャで起動されたサーバのステータスを返します。
エラーが発生した場合は、WLSTException
が返されます。
次の例では、ノード マネージャで起動された oamserver
というサーバのステータスを表示します。
wls:/nm/oamdomain>nmServerStatus('oamserver')
RUNNING
wls:/nm/oamdomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
このコマンドを実行するには、WLST が管理サーバに接続している必要があります。
ノード マネージャを使用して、現在のドメイン内のサーバを起動します。
エラーが発生した場合は、WLSTException
が返されます。
注意 : | boot.properties は、nmStart でサーバを起動するために存在している必要があります。サーバを起動するのが今回が最初である場合、nmStart を使用するために、boot.properties を手動で作成する必要があります。 |
nmStart([serverName], [domainDir], [props], [writer])
以下の例では、ノード マネージャを使用して、現在のドメインで managed1
サーバを起動します。
wls:/nm/mydomain>nmStart("managed1")
Starting server managed1 ...
Server managed1 started successfully
wls:/nm/mydomain>
以下の例では、ノード マネージャを使用して、指定されたドメインで管理サーバを起動します。この例では、prps
変数にシステム プロパティ設定を格納し、props
引数を使用してコマンドに渡されます。
wls:/nm/mydomain> prps = makePropertiesObject("weblogic.ListenPort=8001")
wls:/nm/mydomain> nmStart("AdminServer",props=prps)
Starting server AdminServer...
Server AdminServer started successfully
wls:/nm/mydomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
このコマンドを実行するには、WLST が管理サーバに接続している必要があります。
エラーが発生した場合は、WLSTException
が返されます。
nmVersion()
wls:/nm/oamdomain>nmVersion()
The Node Manager version that you are currently connected to is 9.0.0.0
wls:/nm/oamdomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST を実行している同じコンピュータ上のノード マネージャを起動します。
注意 : | WebLogic Server のカスタム インストール プロセスでは、必要に応じてノード マネージャを Windows システム上の Windows サービスとしてインストールおよび起動します。詳細については、『インストール ガイド』の「Windows サービスとしてのノード マネージャのインストール」を参照してください。この場合、ノード マネージャを手動で起動する必要はありません。 |
startNodeManager
コマンドを呼び出すときに、ノード マネージャを既に実行している場合は、次のメッセージが表示されます。
A Node Manager has already been started.
Cannot start another Node Manager process via WLST
エラーが発生した場合は、WLSTException
が返されます。
startNodeManager([verbose], [nmProperties])
以下の例では、ノード マネージャのサーバのバージョンを表示します。
wls:/mydomain/serverConfig> startNodeManager(verbose='true', NodeManagerHome='c:/bea/wlserver_10.0/common/nodemanager', ListenPort='6666', ListenAddress='myhost'))
Launching Node Manager ...
Successfully launched the Node Manager.
The Node Manager process is running independent of the WLST process
Exiting WLST will not stop the Node Manager process. Please refer
to the Node Manager logs for more information.
The Node Manager logs will be under c:\bea\wlserver_10.0\common\nodemanager.
wls:/mydomain/serverConfig>
表 A-11 に示す WLST ツリー コマンドを使用して、MBean 階層内を移動します。
|
||||
|
||||
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
注意 : | このコマンドは WebLogic Server 9.0 以降から非推奨になりました。serverConfig コマンドを使用するようにスクリプトを更新してください (「serverConfig」を参照)。 |
コンフィグレーション MBean 階層内で最後に移動した MBean、または階層のルートである DomainMBean
に移動します。詳細については、「MBean 階層間の移動」を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
config()
以下の例では、管理サーバ インスタンス上で、実行時 MBean 階層からコンフィグレーション MBean 階層に移動する方法を示しています。
wls:/mydomain/runtime>config()
Location changed to config tree (deprecated).This is a writeable tree with DomainMBean as the root.
For more help, use help('config')
wls:/mydomain/config> ls()
dr-- Applications
dr-- BridgeDestinations
dr-- Clusters
dr-- DeploymentConfiguration
dr-- Deployments
dr-- DomainLogFilters
dr-- EmbeddedLDAP
dr-- JDBCConnectionPools
dr-- JDBCDataSourceFactories
dr-- JDBCDataSources
dr-- JDBCMultiPools
dr-- JDBCTxDataSources
dr-- JMSBridgeDestinations
dr-- JMSConnectionFactories
dr-- JMSDestinationKeys
dr-- JMSDestinations
dr-- JMSDistributedQueueMembers
dr-- JMSDistributedQueues
dr-- JMSDistributedTopicMembers
dr-- JMSDistributedTopics
dr-- JMSFileStores
dr-- JMSJDBCStores
...
wls:/mydomain/config>
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
サーバに登録されているカスタム MBean のルートに移動します。WLST はドメイン MBean と同じようにカスタム MBean への移動、照会、編集を行いますが、カスタム MBean ではスタブを利用できないため cmo
変数は使用できません。
注意 : | custom ツリーに移動する場合、WLST は互換性 MBean サーバ、実行時 MBean サーバ、あるいは JVM プラットフォーム MBean サーバにあるすべての MBean に問い合わせて、カスタム MBean を検索します。現在のドメインにある MBean の数によっては、このプロセスに数分かかり、WLST がすぐにプロンプトを返さない場合があります。 |
custom
コマンドは、WLST が管理サーバ インスタンスまたは管理対象サーバ インスタンスに接続しているときに使用できます。WebLogic Integration または WebLogic Portal サーバに接続している場合、WLST はすべての WebLogic Integration または WebLogic Portal サーバ MBean と対話できます。
カスタム MBean の詳細については、『JMX によるカスタム管理ユーティリティの開発』を参照してください。
エラーが発生した場合は、WLSTException
が返されます。
custom()
以下の例では、管理サーバ インスタンス上で、コンフィグレーション MBean 階層からカスタム MBean 階層に移動します。
wls:/mydomain/serverConfig>custom()
Location changed to custom tree.This is a writeable tree with No root.For more help, use help('custom')
wls:/mydomain/custom>
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
ドメインのコンフィグレーション階層内で最後に移動した MBean、または階層のルートである DomainMBean
に移動します。この読み込み専用の階層には、現在のドメインを表すコンフィグレーション MBean が格納されています。
エラーが発生した場合は、WLSTException
が返されます。
domainConfig()
以下の例では、管理サーバ インスタンス上で、コンフィグレーション MBean 階層からドメインのコンフィグレーション階層に移動します。
wls:/mydomain/serverConfig>domainConfig()
Location changed to domainConfig tree.This is a read-only tree with DomainMBean as the root.
For more help, use help('domainConfig')
wls:/mydomain/domainConfig>ls()
dr-- AppDeployments
dr-- BridgeDestinations
dr-- Clusters
dr-- CustomResources
dr-- DeploymentConfiguration
dr-- Deployments
dr-- EmbeddedLDAP
dr-- ErrorHandlings
dr-- FileStores
dr-- InternalAppDeployments
dr-- InternalLibraries
dr-- JDBCDataSourceFactories
dr-- JDBCStores
dr-- JDBCSystemResources
dr-- JMSBridgeDestinations
dr-- JMSInteropModules
dr-- JMSServers
dr-- JMSSystemResources
...
wls:/mydomain/domainConfig>
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
ドメインの実行時階層内で最後に移動した MBean、または階層のルートである DomainRuntimeMBean
に移動します。この読み込み専用の階層には、現在のドメインを表す実行時 MBean が格納されています。
エラーが発生した場合は、WLSTException
が返されます。
domainRuntime()
以下の例では、管理サーバ インスタンス上で、コンフィグレーション MBean 階層からドメインの実行時階層に移動します。
wls:/mydomain/serverConfig>domainRuntime()
wls:/mydomain/domainRuntime>ls()
dr-- AppRuntimeStateRuntime
dr-- DeployerRuntime
dr-- DomainServices
dr-- LogRuntime
dr-- MessageDrivenControlEJBRuntime
dr-- MigratableServiceCoordinatorRuntime
dr-- MigrationDataRuntimes
dr-- SNMPAgentRuntime
dr-- ServerLifeCycleRuntimes
dr-- ServerRuntimes
dr-- ServerServices
-r-- ActivationTime Mon Aug 01 11:41:25 EDT 2005
-r-- Clusters null
-r-- MigrationDataRuntimes null
-r-- Name sampleMedRecDomain
-rw- Parent null
-r-- SNMPAgentRuntime null
-r-- Type DomainRuntime
-r-x restartSystemResource Void : WebLogicMBean(weblogic.management.configuration.SystemResourceMBean)
wls:/mydomain/domainRuntime>
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
編集コンフィグレーション MBean 階層内で最後に移動した MBean、または階層のルートである DomainMBean
に移動します。この書き込み可能な階層には、現在のドメインを表すすべてのコンフィグレーション MBean が格納されています。
注意 : | コンフィグレーション Bean を編集するには、管理サーバに接続する必要があります。管理対象サーバに接続した場合、WLST の機能はコンフィグレーション Bean 階層の参照だけに制限されます。WLST を使用して管理対象サーバ上の MBean の値を変更することはできませんが、管理 API を使用すれば可能です。ただし、管理サーバ上のコンフィグレーション MBean の値のみを変更することをお勧めします。管理対象サーバ上の MBean の値を変更すると、ドメイン コンフィグレーションに矛盾が生じる可能性があります。 |
注意 : | コンフィグレーション Bean の編集に関する詳細については、「WLST オンラインを使用した既存ドメインの更新」を参照してください。 |
エラーが発生した場合は、WLSTException
が返されます。
edit()
以下の例では、管理サーバ インスタンス上で、サーバ コンフィグレーション MBean 階層から、ドメイン コンフィグレーション MBean 階層の編集可能なコピーに移動する方法を示しています。
wls:/myserver/serverConfig>edit()
Location changed to edit tree.This is a writeable tree with DomainMBean as the root.
For more help, use help('edit')
wls:/myserver/edit !>ls()
dr-- AppDeployments
dr-- BridgeDestinations
dr-- Clusters
dr-- DeploymentConfiguration
dr-- Deployments
dr-- EmbeddedLDAP
...
wls:/myserver/edit !>
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
WLST が現在接続しているサーバの JNDI ツリーに移動します。この読み込み専用のツリーには、現在 JNDI にバインドされているすべての要素が保持されています。
エラーが発生した場合は、WLSTException を返します。
jndi()
以下の例では、管理サーバ インスタンス上で、実行時 MBean 階層からドメインの JNDI ツリーに移動します。
wls:/myserver/runtime> jndi()
Location changed to jndi tree.This is a read-only tree with No root.For more help, use help('jndi')
wls:/myserver/jndi> ls()
dr-- ejb
dr-- javax
dr-- jms
dr-- weblogic
...
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
注意 : | このコマンドは WebLogic Server 9.0 以降から非推奨になりました。serverRuntime コマンドを使用するようにスクリプトを更新する必要があります (「serverRuntime」を参照)。 |
実行時階層内で最後に移動した MBean、またはすべての実行時オブジェクトのルートである DomainRuntimeMBean
に移動します。管理対象サーバに接続している場合、実行時 MBean のルートは ServerRuntimeMBean
になります。
エラーが発生した場合は、WLSTException
が返されます。
詳細については、「実行時 MBean の参照」を参照してください。
runtime()
以下の例では、管理対象サーバ インスタンス上で、コンフィグレーション MBean 階層から実行時 MBean 階層に移動します。
wls:/mydomain/serverConfig> runtime()
Location changed to runtime tree (deprecated).This is a read-only tree with DomainRuntimeMBean as the root.
For more help, use help('runtime')
wls:/mydomain/runtime>
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
コンフィグレーション MBean 階層内で最後に移動した MBean、または階層のルートである DomainMBean
に移動します。
この読み込み専用の階層には、WLST が現在接続しているサーバを表すコンフィグレーション MBean が格納されています。MBean 属性値には、サーバの起動時にユーザが指定したコマンドラインのオーバーライドが含まれています。
エラーが発生した場合は、WLSTException
が返されます。
詳細については、「MBean 階層間の移動」を参照してください。
serverConfig()
以下の例では、管理サーバ インスタンス上で、ドメインの実行時 MBean 階層からコンフィグレーション階層に移動します。
wls:/mydomain/domainRuntime> serverConfig()
wls:/mydomain/serverConfig>
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
実行時 MBean 階層内で最後に移動した MBean、または階層のルートである ServerRuntimeMBean
に移動します。この読み込み専用の階層には、WLST が現在接続しているサーバを表す実行時 MBean が格納されています。
エラーが発生した場合は、WLSTException
が返されます。
serverRuntime()
以下の例では、管理サーバ インスタンス上で、コンフィグレーション MBean 階層から実行時 MBean 階層に移動します。
wls:/mydomain/serverConfig>serverRuntime()
Location changed to serverRuntime tree.This is a read-only tree with ServerRuntimeMBean as the root.
For more help, use help('serverRuntime')
wls:/mydomain/serverRuntime>
表 A-12 では、WLST の変数とその一般的な使用方法について説明します。すべての変数はユーザ セッションの開始時にデフォルト値に初期化されて、ユーザと WLST の対話に従って変更されます。
|
||||
cmo 変数には、WLST を使用して移動した Bean インスタンスが設定される。この変数を使用すると、現在の Bean インスタンスの get 、set 、または invoke メソッドを実行できる。
|
||||
|
||||
![]() ![]() ![]() |