アプリケーション・サーバー・ノードを登録抹消して、管理エージェントに登録されていない状態にすることができます。管理エージェント環境で不要になったノードがある場合、または、
アプリケーション・サーバー・ノード・プロファイルを削除
する場合は、ノードを登録抹消します。管理エージェントからノードを登録抹消した後、
そのノードをスタンドアロンとして使用したり、そのノードを別の管理エージェントに登録したり、
アプリケーション・サーバー・ノード・プロファイルを削除したりすることができます。
始める前に
管理エージェント環境から削除するアプリケーション・サーバー・ノードは、管理エージェントに登録されている必要があります。管理エージェントがまだ始動していない場合は、管理エージェントを始動します。
このタスクについて
ノードの登録を抹消するには、管理エージェントの bin ディレクトリーから deregisterNode コマンドを実行します。deregisterNode コマンドの
実行方法は、手順 1 を参照してください。
ノードを登録抹消すると、そのノード構成は保持されますが、管理エージェントに登録されていないとしてマークを付けられます。登録抹消するノードに、管理コンソールまたは管理 Enterprise JavaBeans (EJB) アプリケーションが、ノードの登録前にインストールされていた場合、それらは、再度使用可能になります。
アプリケーション・サーバー・ノード・プロファイルが壊れていたり使用不可の状態である場合に、deregisterNode コマンドを実行すると、NULL ポインター例外が戻されることがあります。NULL ポインター例外が戻される場合、アプリケーション・サーバーの管理エージェントからの登録抹消処理は失敗しています。エラー・ログに、ADMU0116I、ADMU0128I、ADMU0211I、ADMU0113E、ADMU1211I の各メッセージが書き込まれます。NULL ポインター例外が発生した場合にノードおよび関連するエンドポイントを削除する方法については、
手順 2 を参照してください。
ノードが登録抹消される前にアプリケーション・サーバー・ノード・プロファイルが削除した場合は、
deregisterNode コマンドを実行しても効果はありません。プロファイルがもう存在しないため、
管理エージェントはプロファイルを認識できません。管理エージェント環境からノードおよび関連するエンドポイントを削除するには、手順 2 を実行してください。
手順
- deregisterNode コマンドを使用して、ノードの登録を抹消します。
登録抹消するノードが存在する場合は、以下のように登録抹消するノードのプロファイル・パスを指定して deregisterNode コマンドを実行します。
deregisterNode -profilePath profile_root/profile_name
例えば、管理エージェント環境から AppSrv02 プロファイルの登録を抹消するには、以下のコマンドを実行します。
deregisterNode -profilePath profile_root/AppSrv02
このコマンドのパラメーターについては、deregisterNode コマンドに関するトピック
を参照してください。
- deregisterNode コマンドの実行により NULL ポインター例外が発生した場合、
またはノード・プロファイルが削除されている場合は、登録されているノードおよび関連したエンドポイントを
削除する wsadmin コマンドを実行します。
- コマンド行で、管理エージェントの bin ディレクトリーから wsadmin
スクリプト・ツールを開始するコマンドを実行します。
Jython スクリプト言語を使用する場合は、以下を入力します。
wsadmin -lang jython
Jacl スクリプト言語を使用する場合は、以下を入力します。
wsadmin
- 削除するノードの名前がわからない場合は、
AdminConfig list コマンドを実行して、管理エージェントに登録されているノード
をリストし、そのリストで削除するノードを見つけます。
Jython の場合:
print AdminConfig.list('ManagedNode')
Jacl の場合:
$AdminConfig list ManagedNode
登録済みノードのリストが、次のように表示されます。
nodeA(cells/myAACell01/managednodes/nodeA|managednode.xml#ManagedNode_1239121412703)
nodeB(cells/myAACell01/managednodes/nodeB|managednode.xml#ManagedNode_1239121498500)
このリストは、nodeA と nodeB が myAACell01 管理
エージェントの登録済みノードであることを示しています。
- ノードを削除する wsadmin コマンドを実行します。
nodeA を削除して変更を保存するには、以下のコマンドを続けて実行します。
Jython の場合:
mn = AdminConfig.getid('/ManagedNode:nodeA/')
AdminConfig.remove(mn)
AdminConfig.save()
Jacl の場合:
set mn [$AdminConfig getid /ManagedNode:nodeA/]
$AdminConfig remove $mn
$AdminConfig save
- ノード・プロファイルが登録された際にサブシステム用に生成されたエンドポイントを削除する wsadmin コマンドを実行します。
nodeA のエンドポイントを削除するには、以下のコマンドを続けて実行します。
Jython の for コマンドおよび Jacl の foreach コマンドは、
編集の都合上複数行に示されていますが、1 行に入力してください。
Jython の場合:
import java.lang.System as System
lineSeparator = System.getProperty("line.separator")
neps = AdminConfig.list("NamedEndPoint").split(lineSeparator)
for nep in neps:
set name = AdminConfig.showAttribute(nep, "endPointName")
if (name.endswith("nodeA") == 1):
AdminConfig.remove(nep)
AdminConfig.save()
quit
Jacl の場合:
set neps [$AdminConfig list NamedEndPoint]
foreach nep $neps {set name [$AdminConfig showAttribute $nep endPointName];
if {[string last "nodeA" $name] != -1} {$AdminConfig remove $nep}}
$AdminConfig save
quit
- 管理エージェントを再始動します。
adminagent という管理エージェントを再始動するには、
管理エージェント・プロファイルの bin ディレクトリーで、コマンド・プロンプトから
以下のコマンドを実行します。
stopServer adminagent
startServer adminagent
- ノードがもう管理エージェントに登録されていないことを確認します。
タスクの結果
アプリケーション・サーバー・ノードは管理エージェントにもう登録されていません。
次のタスク
登録抹消したノードをスタンドアロンで使用したり、別の管理エージェントに登録したりすることができるようになります。オプションで、manageprofiles コマンドを使用して、
アプリケーション・サーバー・プロファイルを削除します。