WebLogic Scripting Tool ガイド
以下の節では、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
変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。
cd(mbeanName
)
以下の例では、コンフィグレーション 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
を返します。
prompt(myPrompt
)
|
以下の例では、プロンプトでパス情報を非表示にしてから再表示します。
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 の使用状況 : オフライン
アプリケーションまたはサービスの拡張テンプレートを使用して、現在のドメインを拡張します。エラーが発生した場合は、WLSTException
を返します。
addTemplate(templateFileName
)
以下の例では、ドメインを開いて、指定された拡張テンプレート DefaultWebApp.jar
を使用してドメインを拡張します。
wls:/offline>readDomain('c:/bea/user_projects/domains/wlw')
wls:/offline/wlw>addTemplate('c:/bea/weblogic90/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/weblogic81/common/templates/domains/
...
wls.jar')
wls:/offline/wls>closeTemplate()
wls:/offline>
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オンラインまたはオフライン
WLST を WebLogic Server インスタンスに接続します。
ユーザ名とパスワードをコマンドラインで指定できます。または、connect
コマンドの引数としてユーザ コンフィグレーション ファイルとキー ファイルの場所を指定して、ローカルで格納されている暗号化済みパスワードを指定できます。ユーザ コンフィグレーション ファイルとキー ファイルの作成の詳細については、「storeUserConfig」を参照してください。
ユーザ名とパスワードを指定しないで connect
コマンドを実行した場合、WLST は以下のいずれかの方法を順次使用してコマンドを処理しようとします。
管理サーバ名を指定しない場合、その引数はデフォルトで AdminServer
に設定されます。
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」 (http://edocs.beasys.co.jp/e-docs/wls/docs90/wlsmbeanref/mbeans/ServerMBean.html?skipReload=true#TunnelingEnabled
) を参照してください。WebLogic Server インスタンスに正常に接続した後で、すべてのローカル変数が初期化されます。
エラーが発生した場合は、WLSTException
を返します。
connect([username
,password
], [url
], [adminServerName
])
connect([userConfigFile
,userKeyFile
], [adminServerName
])
|
|
|
|
|
|
|
|
|
|
|
以下の例では、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 インスタンスに接続します。管理サーバ名はデフォルトの AdminServer
になります。
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 の使用状況 : オンライン
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 はそのドメインのコンフィグレーション Bean 階層に入り、プロンプトはそのコンフィグレーション階層での現在の場所を示すように更新されます。次に例を示します。
WebLogic Server コンフィグレーション Bean は階層構造の中に存在します。WLST ファイル システムでは、階層はドライブに、タイプとインスタンスはディレクトリに、属性とオペレーションはファイルに相当します。UNIX または Windows コマンド シェルでファイル システムを移動するときと同じように、WLST は cd
、ls
、および pwd
などのコマンドを使用して、コンフィグレーション Bean の階層構造を移動します。コンフィグレーション Bean インスタンスに移動したら、WLST コマンドを使用して Bean と対話します。詳細については、「MBean の移動と照会」を参照してください。
エラーが発生した場合は、WLSTException
を返します。
readDomain(domainDirName
)
以下の例では、編集するために 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/weblogic90/common/templates/domains
wls:/offline/wls_medrec>
/wls_medrec.jar')
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
現在のドメインを更新して保存します。更新して保存した後、ドメインは引き続き編集可能になります。
エラーが発生した場合は、WLSTException
を返します。
updateDomain()
以下の例では、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
を返します。
writeDomain(domainDir
)
以下の例では、medrec.jar ドメイン テンプレートを読み込み、いくつかのオペレーションを実行してから、ドメイン コンフィグレーション情報を c:/bea/user_projects/domains/medrec
ディレクトリに書き込みます。
wls:/offline>readTemplate('c:/bea/weblogic81/common/templates/domains
...
/wls.jar')
wls:/offline/base_domain>writeDomain('c:/bea/user_projects/domains/base_domain')
コマンド カテゴリ : 制御コマンド
WLST の使用状況 : オフライン
指定されたドメイン テンプレート ファイルにドメイン コンフィグレーション情報を書き込みます。ドメイン コンフィグレーション テンプレートを使用してドメインを再作成できます。
コンフィグレーション情報をドメイン コンフィグレーション テンプレートに書き込んだ後で、メモリ内に存在するドメインまたはドメイン テンプレート オブジェクトを引き続き更新し、writeDomain
または writeTemplate
コマンドを再発行して、ドメイン コンフィグレーションを新規あるいは既存のドメインまたはドメイン テンプレート ファイルに格納できます。詳細については、「writeDomain」または「writeTemplate」をそれぞれ参照してください。
エラーが発生した場合は、WLSTException
を返します。
writeTemplate(templateName
)
以下の例では、現在のドメイン コンフィグレーションを 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 9.0 アプリケーションのデプロイメント』 (http://edocs.beasys.co.jp/e-docs/wls/docs90/deployment/index.html
) を参照してください。
コマンド カテゴリ : デプロイメント コマンド
WLST の使用状況 : オンライン
WebLogic Server インスタンスにアプリケーションをデプロイします。
deploy
コマンドは、コマンドのステータスをチェックするためにアクセスできる WLSTProgress
オブジェクトを返します。WLSTProgress
オブジェクトの詳細については、「WLSTProgress オブジェクト」を参照してください。エラーが発生した場合は、WLSTException
を返します。
注意 : 進行中の編集セッションがある場合、deploy
コマンドはユーザの対話をブロックしません。
deploy(appName
,path
, [targets
], [stageMode
], [planPath
], [options
])
|
|
|
|
|
|
|
|
|
|
|
以下の例では、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 ms 待機します。
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')
コマンド カテゴリ : デプロイメント コマンド
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 9.0 アプリケーションのデプロイメント』の「Overview of Common Deployment Scenarios」 (http://edocs.beasys.co.jp/e-docs/wls/docs90/deployment/deploy.html#overview
) を参照してください。
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 9.0 アプリケーションのデプロイメント』の「Common Deployment Operation」 (http://edocs.beasys.co.jp/e-docs/wls/docs90/deployment/intro.html
) を参照してください。
undeploy(appName
,[targets
],[options
])
|
以下の例では、すべての対象サーバから businessApp アプリケーションを削除します。WLST はプロセスが完了するまで 60,000 ms 待機します。
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 Server 診断サービスの詳細については、『WebLogic 診断フレームワークのコンフィグレーションと使い方』 (http://edocs.beasys.co.jp/e-docs/wls/docs90/wldf_configuring/index.html
) を参照してください。
コマンド カテゴリ : 診断コマンド
WLST の使用状況 : オフライン
指定されたログ ファイルに対するクエリを実行します。結果は XML ファイルとして保存されます。
WebLogic Server 診断サービスの詳細については、『WebLogic 診断フレームワークのコンフィグレーションと使い方』 (http://edocs.beasys.co.jp/e-docs/wls/docs90/wldf_configuring/index.html
) を参照してください。
エラーが発生した場合は、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\weblogic90b\server\data\store\diagnostics" writePolicy="Disabled" blockSize=512 directIO=false driver="wlfileio2">
wls:/mydomain/serverRuntime>
コマンド カテゴリ : 診断コマンド
WLST の使用状況 : オンライン
サーバ サイドでクエリを実行して、エクスポートされた WebLogic 診断フレームワーク (WLDF) データを取得します。結果は XML ファイルとして保存されます。
WebLogic Server 診断サービスの詳細については、『WebLogic 診断フレームワークについて』 (http://edocs.beasys.co.jp/e-docs/wls/docs90/wldf_understanding/index.html
) を参照してください。
エラーが発生した場合は、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 の編集の詳細については、「コンフィグレーション MBean の編集」を参照してください。
|
||
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
現在の編集セッション中に保存されてまだデプロイされていない変更をアクティブ化します。アクティブ化する変更内容にサーバの再起動が必要なものがある場合、このコマンドはメッセージを出力します。
activate
コマンドは、ユーザが現在行っている変更、または最近行った変更の状態を反映する、最新の ActivationTask
MBean を返します。メソッドを呼び出して、進行中または完了したばかりの、最近のコンフィグレーション マネージャのアクティブ化タスクに関する情報を取得できます。エラーが発生した場合は、WLSTException
を返します。
activate([timeout
],
[block
])
|
|
|
以下の例では、現在の編集セッション中に変更され、ディスクに保存されていて、まだアクティブ化されていない変更内容をアクティブ化します。WLST はアクティブ化が完了するのを 100,000 ms 待機し、アクティブ化を停止する前に 200,000 ms 待機します。
wls:/mydomain/edit !>activate(200000, block='true')
Activating all your changes, this may take a while ...
The edit lock associated with this edit session is released once the activation is completed.
Action completed.
wls:/mydomain/edit>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オフライン
エラーが発生した場合は、WLSTException
を返します。
assign(sourceType, sourceName, destinationType, destinationName
)
sourceType
および destinationType
の設定では以下のガイドラインを使用してください。
sourceType
: service
.SubDeployment
。service
には SubDeployment
の親を指定します (JMSSystemResource.SubDeployment
など)。ネストされたサブデプロイメントも指定できます (AppDeployment.SubDeployment.SubDeployment
など)。destinationType
: Target
myServer
と myServer2
をクラスタ myCluster
に割り当てます。
wls:/offline/mydomain>assign("Server", "myServer,myServer2", "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
を返します。
cancelEdit([defaultAnswer
])
以下の例では、現在の編集セッションを取り消します。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 オフラインでアクセスおよび更新できるのは、コンフィグレーション ファイル内にあるコンフィグレーション オブジェクトのみなので、XML 要素としてコンフィグレーション ファイル内に既に永続化されていないコンフィグレーション オブジェクトの属性値を表示したり変更したりするには、まずコンフィグレーション オブジェクトを作成する必要があります。
WLST オンラインで create
コマンドを使用する場合は、以下の点に注意してください。
create
コマンドを使用することはできません。 edit
コマンドを使用してコンフィグレーション MBean 階層に移動する必要があります。「edit」を参照してください。WLST オフラインで create
コマンドを使用する場合は、以下の点に注意してください。
http://edocs.beasys.co.jp/e-docs/wls/docs90/jmx/understandWLS.html
) を参照してください。http://edocs.beasys.co.jp/e-docs/wls/docs90/wlsmbeanref/core/index.html
) を参照してください。
create(name
,childMBeanType
, [baseProviderType
])
|
|
|
以下の例では、現在のコンフィグレーション 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
変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。
delete(name
,childMBeanType
)
|
以下の例では、newServer という名前の Server
タイプのコンフィグレーション Bean を削除します。
wls:/mydomain/edit !> delete('newServer','Server')
Server with name 'newServer' has been deleted successfully.
wls:/mydomain/edit !>
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
指定された文字列を暗号化します。暗号化した文字列は、コンフィグレーション ファイルやコマンドの引数として使用できます。
weblogic.security.Encrypt
ユーティリティは、クリアテキストの文字列を WebLogic Server 用に暗号化します。このユーティリティでは、現在のディレクトリまたは指定した WebLogic Server ドメインのルート ディレクトリの暗号化サービスが使用されます。
注意 : 文字列は、暗号化した文字列が使用される WebLogic Server ドメインの暗号化サービスを使って暗号化しなければなりません。そうしないと、サーバはその文字列を復号化できません。
エラーが発生した場合は、WLSTException
を返します。
encrypt(obj
, [domainDir
])
|
以下の例では、指定されたドメイン ディレクトリにある security/SerializedSystemIni.dat
ファイルを使用して、指定された文字列を暗号化します。
wls:/mydomain/serverConfig> es=encrypt('myPassword','c:/bea/domains/mydomain')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンラインまたはオフライン
指定された属性の値を返します。参照できる MBean 属性の詳細については、『WebLogic Server® MBean リファレンス』 (http://edocs.beasys.co.jp/e-docs/wls/docs90/wlsmbeanref/core/index.html
) を参照してください。エラーが発生した場合は、WLSTException
を返します。
注意 : ls('a')
と入力すると、すべての属性とその現在の値を表示できます。詳細については、「ls」を参照してください。
代わりに、cmo
変数を使用して、現在のコンフィグレーション Bean の任意の get メソッドを実行できます。次に例を示します。
cmo
変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。
get(attrName
)
以下の例では、現在のコンフィグレーション 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 ファイルをロードします。readTemplate
または addTemplate
コマンドを使用してドメイン テンプレートまたは拡張テンプレートをメモリにロードした後にのみ、このコマンドを発行できます。
このコマンドを実行する前に、以下の条件に該当することを確認してください。
エラーが発生した場合は、WLSTException
を返します。
loadDB(dbVersion
,connectionPoolName
)
以下の例では、myPool-PointBase
JDBC 接続プールを使用して、データベースのバージョン 4.4 用の SQL ファイルをロードします。
wls:/offline/mydomain>loadDB('4.4', 'myPool-PointBase')
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンラインおよびオフライン
プロパティ値をファイルからロードして、WLST セッションで使用できるようにします。
「Jython モジュールとしての WLST のインポート」で説明するように、WLST を Jython モジュールとしてインポートしている場合は、このコマンドを使用できません。
エラーが発生した場合は、WLSTException
を返します。
loadProperties(fileName
)
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 の使用状況 : オンラインまたはオフライン
現在のコンフィグレーション Bean の指定された属性値を設定します。設定できる MBean 属性の詳細については、『WebLogic Server® MBean リファレンス』 (http://edocs.beasys.co.jp/e-docs/wls/docs90/wlsmbeanref/core/index.html
) を参照してください。
エラーが発生した場合は、WLSTException
を返します。
注意 : ls('a')
と入力すると、すべての属性とその現在の値を表示できます。詳細については、「ls」を参照してください。
このコマンドをドメイン コンフィグレーション MBean に対して使用すると、新しい値が config.xml
ファイルに保存されます。
WLST オンラインを使用する場合は以下の点に注意してください。
set
コマンドを使用することはできません。 代わりに、cmo
変数を使用して、現在のコンフィグレーション Bean の任意の set メソッドを実行できます。次に例を示します。
cmo
変数の詳細については、「現在の管理オブジェクトの変更」を参照してください。
set(attrName
,value
)
以下の例では、DomainMBean
の ArchiveConfigurationCount
属性を 10
に設定します。
wls:/mydomain/serverConfig>set('ArchiveConfigurationCount',10)
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オフライン
ドメインの作成または更新に関連するオプションを設定します。エラーが発生した場合は、WLSTException
を返します。
setOption(optionName, optionValue
)
以下の例では、CreateStartMenu
オプションを false
に設定します。
wls:/offline>setOption('CreateStartMenu', 'false')
コマンド カテゴリ : 編集コマンド
WLST の使用状況 : オンライン
現在の編集セッション中に現在のユーザが行ったコンフィグレーションの変更内容を表示します。エラーが発生した場合は、WLSTException
を返します。
showChanges([onlyInMemory
])
以下の例では、現在の編集セッションが開始されてから、現在のユーザがコンフィグレーションに加えたすべての変更が表示されます。
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
を返します。
stopEdit([defaultAnswer
])
以下の例では、現在の編集セッションを停止します。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")
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
を返します。
getConfigManager()
以下の例では、最新の ConfigurationManagerBean
MBean を返して、cm 変数に格納します。
wls:/mydomain/serverConfig>cm=getConfigManager()
wls:/mydomain/serverConfig>cm=getType()
'weblogic.management.mbeanservers.edit.ConfigurationManagerMBean'
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
指定されたパスを参照して MBean を返します。エラーが発生した場合は、WLSTException
を返します。
注意 : MBean が見つからない場合に例外は送出されません。
getMBean(mbeanPath
)
wls:/mydomain/edit !>com=getMBean('Servers/myserver/COM/myserver')
wls:/mydomain/edit !>com.getType()
`Server'
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
指定された MBeanType
または cmo
変数の MBeanInfo
を返します。エラーが発生した場合は、WLSTException
を返します。
getMBI([mbeanType
])
以下の例では、指定された MBeanType
の MBeanInfo
を取得して、svrMbi
変数に格納します。
wls:/mydomain/serverConfig>svrMbi=getMBI('weblogic.management.configuration.ServerMBean')
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
現在のツリーで、指定された MBean インスタンスの MBean パスまたは MBean の ObjectName を返します。エラーが発生した場合は、WLSTException
を返します。
getPath(mbean
)
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
を返します。
listChildTypes([parent
])
以下の例では、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 の使用状況 : オンラインまたはオフライン
現在のコンフィグレーション Bean または実行時 Bean のすべての子 Bean と属性を表示します。
引数を指定して出力を制御することもできます。引数を指定しない場合は、ドメイン内のすべての子 Bean と属性が表示されます。出力は文字列として返されます。
注意 : WLST オフラインでアクセスおよび更新できるのは、コンフィグレーション ファイル内にあるコンフィグレーション オブジェクトのみなので、XML 要素としてコンフィグレーション ファイル内に既に永続化されていないコンフィグレーション オブジェクトの属性値を表示したり変更したりするには、まずコンフィグレーション オブジェクトを作成する必要があります。
エラーが発生した場合は、WLSTException
を返します。
表 A-8 では、ls
コマンドの出力の左側の列に表示されるプロパティ情報について説明します。
注意 : このプロパティ情報は MBeanInfo
に基づいており、ユーザ パーミッションは反映されていません。
ls( ['a' | 'c' | 'o' |mbeanPath
], [returnMap
] [returnType
])
以下の例では、examples
ドメインの、すべての子コンフィグレーション Bean と属性名および値を表示します。このドメインは WLST オフライン モードでメモリにロードされています。
wls:/offline/mydomain >ls()
dr-- AppDeployments
dr-- BridgeDestinations
dr-- Clusters
dr-- DeploymentConfiguration
dr-- Deployments
dr-- EmbeddedLDAP
dr-- ErrorHandlings
dr-- FileStores
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-- ConsoleEnabled true
-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', returnMap='true', returnType='a')
コマンド カテゴリ : 情報コマンド
WLST の使用状況 : オンライン
現在の MBean またはその MBean の指定された属性に関する、MBeanInfo
のヘルプを表示します。エラーが発生した場合は、WLSTException
を返します。
man([attrName
])
以下の例では、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 の使用状況 : オンラインまたはオフライン
エラーが発生した場合は、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 の使用状況 : オンライン
ノード マネージャを使用して、サーバまたはクラスタとその状態のマップを返します。ノード マネージャが動作している必要があります。
サーバの状態の詳細については、『サーバの起動と停止の管理』の「Understanding Server Life Cycle」 (http://edocs.beasys.co.jp/e-docs/wls/docs90/server_start/index.html
) を参照してください。
エラーが発生した場合は、WLSTException
を返します。
state(name
, [type
])
|
以下の例では、管理対象サーバ managed1
の状態を返します。
wls:/mydomain/serverConfig>state('managed1','Server')
Current state of "managed1": SUSPENDED
wls:/mydomain/serverConfig>
以下の例では、クラスタ managed1
の状態を返します。
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('c:/myFiles/myuserconfigfile.secure', 'c:/myFiles/myuserkeyfile.secure')
Creating the key file can reduce the security of your system if it is not kept in a secured location after it is created.Do you want to create the key file? y or ny
The username and password that were used for this current WLS connection are stored in c:/myFiles/mysuserconfigfile.secure and 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
を返します。
viewMBean(mbean
)
以下の例では、現在の 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
を返します。
writeIniFile(filePath
)
以下の例では、WLST を wl.py
という Python ファイルに変換します。
wls:/offline>
writeIniFile("wl.py")
The Ini file is successfully written to wl.py
wls:/offline>
表 A-9 に示す WLST ライフサイクル コマンドを使用して、サーバ インスタンスのライフサイクルを管理します。
サーバ インスタンスのライフサイクルの詳細については、『サーバの起動と停止の管理』の「Understanding Server Life Cycle」 (http://edocs.beasys.co.jp/e-docs/wls/docs90/server_start/index.html
) を参照してください。
コマンド カテゴリ : ライフサイクル コマンド
WLST の使用状況 : オンライン
指定されたサービス (JTA、JMS、またはサーバ) を、クラスタ内の対象のサーバに移行します。エラーが発生した場合は、WLSTException
を返します。
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
状態に移行します。サーバの状態の詳細については、『サーバの起動と停止の管理』の「Understanding Server Life Cycle」 (http://edocs.beasys.co.jp/e-docs/wls/docs90/server_start/index.html
) を参照してください。
エラーが発生した場合は、WLSTException
を返します。
resume([sname
], [block
])
|
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
])
|
|
|
|
|
|
|
|
|
以下の例では、接続しているサーバを停止するように WLST に指示します。
wls:/mydomain/serverConfig>shutdown()
Shutting down the admin server that you are currently connected to .......
Disconnected from weblogic server: AdminServer
以下の例では、HTTP セッションが完了または (1000 ms で) タイムアウトするのを 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])
|
|
|
|
|
以下の例では、ノード マネージャに管理対象サーバ インスタンスを起動するように指示します。リスン アドレスは 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
])
|
|
|
|
|
|
|
|
以下の例では、demoDomain
の demoServer
という管理サーバを起動します。デフォルトでは useNM
が true
に設定されるので、ノード マネージャを実行している必要があります。
wls:/offline>startServer('demoServer','demoDomain','t3://localhost:8001',
wls:/offline>
'myweblogic','wlstdomain','c:/mydomains/wlst','false', 60000, jvmArgs='-XX:MaxPermSize=75m, -Xmx512m, -XX:+UseParallelGC')
コマンド カテゴリ : ライフサイクル コマンド
WLST の使用状況 : オンライン
実行中のサーバを中断します。このコマンドでは、サーバを RUNNING
状態から ADMIN
状態に移行します。サーバの状態の詳細については、『サーバの起動と停止の管理』の「Understanding Server Life Cycle」 (http://edocs.beasys.co.jp/e-docs/wls/docs90/server_start/index.html
) を参照してください。
エラーが発生した場合は、WLSTException
を返します。
suspend([sname
], [ignoreSessions
], [timeOut
], [force
], [block
])
|
|
|
|
|
|
|
wls:/mydomain/serverConfig> suspend('managed1')
Server 'managed1' suspended successfully.
wls:/mydomain/serverConfig>
表 A-10 に示す WLST ノード マネージャ コマンドを使用して、WebLogic Server インスタンスを起動、停止、再起動、およびモニタします。ノード マネージャの詳細については、『サーバの起動と停止の管理』の「Using Node Manager to Control Servers」 (http://edocs.beasys.co.jp/e-docs/wls/docs90/server_start/nodemgr.html
) を参照してください。
注意 : このカテゴリのコマンドを実行する前に、ノード マネージャを実行する必要があります。nm
および nmconnect
以外のコマンドの場合、WLST は実行中のノード マネージャに接続している必要があります。
コマンド カテゴリ : ノード マネージャ コマンド
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
])
以下の例では、デフォルトのホストおよびポート番号と 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 の使用状況 : オンライン
WLST をノード マネージャ セッションから接続解除します。このコマンドを実行するには、WLST がノード マネージャに接続している必要があります。
エラーが発生した場合は、WLSTException
を返します。
nmDisconnect()
以下の例では、WLST をノード マネージャ セッションから接続解除します。
wls:/nm/oamdomain>nmDisconnect()
Successfully disconnected from Node Manager
wls:/myserver/serverConfig>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンライン
WLST が現在動作しているマシンを登録します。このコマンドを実行するには WLST が管理サーバに接続している必要がありますが、ノード マネージャに接続している必要はありません。
このコマンドでは、以下のファイルを管理サーバからダウンロードします。
nm_password.properties
)。サーバ認証に使用される暗号化されたユーザ名とパスワードが含まれています。SerializedSystemIni.dat
ファイル。また、このコマンドでは、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 の使用状況 : オンライン
ノード マネージャで起動された、指定されたサーバ インスタンスを強制停止します。
serverName
引数を使用してサーバ名を指定しない場合、引数はデフォルトで myServer
に設定されます。この引数は使用しているサーバ名と一致している必要があり、一致していない場合はコマンドが失敗します。
起動する際にノード マネージャを使用しなかったサーバ インスタンスを強制停止しようとすると、エラーが表示されます。このコマンドを実行するには、WLST がノード マネージャに接続している必要があります。
エラーが発生した場合は、WLSTException
を返します。
nmKill([serverName
])
以下の例では、oamserver
というサーバを強制停止します。
wls:/nm/oamdomain>nmKill('oamserver')
Killing server `oamserver' ...
Server oamServer killed successfully.
wls:/nm/oamdomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンライン
ノード マネージャ ログを返します。このコマンドを実行するには、WLST がノード マネージャに接続している必要があります。
エラーが発生した場合は、WLSTException
を返します。
nmLog([writer
])
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
を返します。
nmServerStatus([serverName
])
以下の例では、oamserver
というサーバを強制停止します。
wls:/nm/oamdomain>nmServerStatus('oamserver')
RUNNING
wls:/nm/oamdomain>
コマンド カテゴリ : ノード マネージャ コマンド
WLST の使用状況 : オンライン
ノード マネージャを使用して、現在のドメイン内のサーバを起動します。このコマンドを実行するには、WLST がノード マネージャに接続している必要があります。
エラーが発生した場合は、WLSTException
を返します。
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 の使用状況 : オンラインまたはオフライン
ノード マネージャをデフォルト ポート (5556) で起動します。
注意 : WebLogic Server のカスタム インストール プロセスでは、Windows システム上でノード マネージャを Windows サービスとしてインストールすることができます。詳細については、『インストール ガイド』の「Windows サービスとしてのノード マネージャのインストールについて」 (http://edocs.beasys.co.jp/e-docs/common/docs90/install/prepare.html#node_manager
) を参照してください。この場合、ノード マネージャを手動で起動する必要はありません。
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/weblogic90/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\weblogic90\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 の詳細については、『WebLogic JMX Service プログラマーズ ガイド』の「WebLogic Server 以外の MBean」 (http://edocs.beasys.co.jp/e-docs/wls/docs81/jmx/overview.html#non_weblogic_server_mbeans
) を参照してください。
エラーが発生した場合は、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-- DeploymentConfiguration
dr-- Deployments
dr-- EmbeddedLDAP
dr-- ErrorHandlings
dr-- FileStores
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-- SNMPAgentRuntime
dr-- ServerLifeCycleRuntimes
dr-- ServerRuntimes
dr-- ServerServices
-r-- ActivationTime Mon Aug 01 11:41:25 EDT 2005
-r-- Clusters null
-rw- CurrentClusterDeploymentTarget null
-rw- CurrentClusterDeploymentTimeout 0
-r-- Name sampleMedRecDomain
-rw- Parent null
-r-- SNMPAgentRuntime null
-r-- Type DomainRuntime
wls:/mydomain/domainRuntime>
コマンド カテゴリ : ツリー コマンド
WLST の使用状況 : オンライン
編集コンフィグレーション MBean 階層内で最後に移動した MBean、または階層のルートである DomainMBean
に移動します。この書き込み可能な階層には、現在のドメインを表すすべてのコンフィグレーション MBean が格納されています。
注意 : コンフィグレーション Bean を編集するには、管理サーバに接続する必要があります。管理対象サーバに接続した場合、WLST の機能はコンフィグレーション Bean 階層の参照だけに制限されます。WLST を使用して管理対象サーバ上の MBean の値を変更することはできませんが、管理 API を使用すれば可能です。ただし、管理サーバ上のコンフィグレーション MBean の値のみを変更することをお勧めします。管理対象サーバ上の MBean の値を変更すると、ドメイン コンフィグレーションに矛盾が生じる可能性があります。
コンフィグレーション Bean の編集の詳細については、「コンフィグレーション MBean の編集」を参照してください。
エラーが発生した場合は、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 の対話に従って変更されます。