deregisterNode command

Use the deregisterNode command to unregister a node from an administrative agent so that you can use the node stand-alone, register the node with another administrative agent, or federate the node with the deployment manager.

Run the deregisterNode command from the bin directory of the administrative agent. The node must have been previously registered with the administrative agent. When you unregister a node, the node configuration is retained, but is marked as not registered with the administrative agent.

When you run the deregisterNode command, the command stops all running application servers on the node. You can optionally stop application servers on the node that you are unregistering prior to running the deregisterNode command.

If the node that you unregister had the administrative console or management Enterprise JavaBeans (EJB) applications installed prior to registering the node, they are re-enabled.

Syntax

The deregisterNode command syntax is as follows:

deregisterNode [options]

Parameters

The following options are available for the deregisterNode command:

-conntype<JSR160RMI|IPC|RMI|SOAP>
The optional connector type used to connect to the administrative agent to initiate node deregistration. The default is SOAP.
已淘汰的特性 已淘汰的特性: You should eventually switch from the RMI connector to the JSR160RMI connector because support for the RMI connector is deprecated.depfeat
-host host_name
An optional parameter that specifies the host name of the administrative agent.
-nodepassword node_password
An optional parameter that specifies the password of the node that you are unregistering. Specify this parameter if security is on at the node and the password is different than the administrative agent password. Use this parameter with the -nodeusername parameter. The -nodeusername and -nodepassword parameters are used to stop all servers on the node.
-nodeusername node_user_name
An optional parameter that specifies the use name of the node that you are unregistering. Specify this parameter if security is on at the node and the user name is different than the administrative agent user name. Use this parameter with the -nodepassword parameter. The -nodeusername and -nodepassword parameters are used to stop all servers on the node.
-port port_number
An optional parameter that specifies the port number of the administrative agent connector port.

The default port number is 8878 for the default SOAP port of the administrative agent. SOAP is the default Java™ Management Extensions (JMX) connector type for the command. If you have multiple product installations or multiple profiles, the SOAP port might be different than 8878. Examine the administrative agent SystemOut.log file to see the current ports in use.

Note: 這個主題參照一或多個應用程式伺服器日誌檔。 此外,在分散式和 IBM® i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.logSystemErr.log, trace.logactivity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
-profilePath profile_path
A required parameter that specifies the path to the profile of the base node to be unregistered.
-trace
An optional parameter that provides tracing output for the deregisterNode command.
-profileName profile_name
An optional parameter that specifies the profile name of the administrative agent.
-username username
An optional parameter that specifies the user ID of the node to be unregistered.
-password password
An optional parameter that specifies the password of the node to be unregistered.
-help
An optional parameter that prints a usage statement.
-?
An optional parameter that prints a usage statement.

Usage scenarios

The following examples demonstrate correct syntax. Commands are split on multiple lines for printing purposes.

[AIX][HP-UX][Linux][Solaris][z/OS]
deregisterNode.sh -conntype SOAP -port 8878 
 -profilePath app_server_root/profiles/AppSrv01
[Windows]
deregisterNode.bat -conntype SOAP -port 8878 
 -profilePath app_server_root\profiles\AppSrv01
[IBM i]
deregisterNode -conntype SOAP -port 8878 
 -profilePath user_data_root/profiles/AppSrv01

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: July 9, 2016 11:12
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ragt_deregisterNode
檔名:ragt_deregisterNode.html