Network Deployment (Distributed operating systems), v8.0 > Scripting the application serving environment (wsadmin) > Administer jobs in a flexible management environment using wsadmin.sh
Register nodes with the job manager using commands
Configure your flexible management environment by registering application servers that are registered with admin agents, or by registering dmgrs as nodes on the job manager. After you register nodes with the job manager, you can submit and manage jobs.
Configure a flexible management environment, consisting of a job manager, and optionally an admin agent for the application server node to register. Start the job manager and the administrative agent processes before registering nodes or dmgrs with the job manager.
Attention: The identity under which the admin agent server is running must have at least the monitor role for the profile of the managed application server node. Otherwise, when you attempt to register the node with the job manager, registration fails with the ADMN0022E message.
Ensure that the admin agent or dmgr version number is not higher than the version number of any job manager with which the administrative agent or dmgr is registered. A job manager can manage a node at an equal or lesser version number than the job manager. For example, a v8 job manager can manage v8 and 7 nodes. A v7 job manager can manage v7 nodes. The fix pack portion of the version number does not matter; for example, a v7.0.0.3 job manager can manage a node at v7.0.0.9, which is Version 7 with fix pack 9 installed.
A job manager can manage a Version 8 or v7 dmgr that has a v6 federated node. A dmgr that is registered with a job manager can manage a mixed version cell. Using the job manager, you can submit jobs that manage any resources in the mixed version cell, including resources on a v6 federated node.
We can administer multiple application servers that run customer applications from a management profile that contains an admin agent. The admin agent provides a single administrative console to administer the application servers.
We can coordinate management actions among multiple dmgrs, asynchronously administer multiple unfederated application servers, and submit jobs to start servers from a management profile that contains a job manager. In order to begin using the job manager to run jobs, register the application server and dmgr nodes as managed nodes of the job manager.
Use the following steps to register profiles that contain admin agents as nodes on the job manager.
Procedure
- Register the application server with the administrative agent if it is not yet registered.
Run the registerNode command from the bin directory for the administrative agent server to register a node with the admin agent. When you run the command, the stand-alone node is converted into a node that the admin agent manages. The admin agent and the node being registered must be on the same system. We can only run the command on an unfederated node. If the command is run on a federated node, the command exits with an error.
If the administrative console or the management EJB applications of the application server being registered are enabled, the node registration process disables them.
Use the registerNode command utility to register the application server profile with the administrative agent, as the following command demonstrates:
bin>registerNode -profilePath /AppServer/profiles/AppSrv01 -host localhost -conntype SOAP -port 8878- Launch wsadmin.sh.
Navigate to the PROFILE_ROOT/profiles/myAdminAgent/bin directory and use the following command to connect wsadmin.sh to the administrative agent process:
wsadmin -profileName myAdminAgent -lang jython- Register the node as a node on the job manager.
If the node to register contains an admin agent, use the registerWithJobManager command and the following parameters to register a node as a node on the job manager.
registerWithJobManager parameter descriptions. Run registerWithJobManager to register a node with a job manager.
Parameter Description Data type -managedNodeName Name of the node that is registered with the admin agent. If the node is a dmgr profile, specify the node name of the dmgr. (Required) String -host Optionally specifies the hostname of the job manager. String -port Optionally specifies the administrative port number to use. The default secure port number is 9943. The default unsecure port number is 9960. -user Optionally specifies the connector login user name. String -password Optionally specifies the password for the connector login user name. String -alias Optionally specifies an alias for the node. The job manager uses this name instead of the value of the managedNodeName parameter to register the node. Use this parameter if the new node has the same name of a node that is registered with the job manager. String -startPolling Optionally specifies whether to start polling after registering the node. Specify false to disable polling. The default value is true. Boolean -autoAcceptSigner Optionally specifies whether to automatically accept the signer provided by the server. Specify false to disable this option. The default value is true. Boolean The following sample command registers the AppSvr01 application server profile with the job manager:
AdminTask.registerWithJobManager('[-host jobMgrHost -managedNodeName AppSvr01]')The following sample command registers the DMGR01 dmgr profile with the job manager:
AdminTask.registerWithJobManager('[-host jobMgrHost -managedNodeName DMGR01]')
- Optional: Repeat the registerWithJobManager command to register additional profiles as nodes on the job manager.
Results
The node of interest is registered with the job manager when the system successfully runs the registerWithJobManager command.
What to do next
Submit, monitor, and manage jobs for the nodes that are registered with the job manager.
Administrative agent
Job manager
Create management profiles with admin agents
Create management profiles for job managers
Related
ManagedNodeAgent command group using wsadmin.sh
AdministrativeJobs command group using wsadmin.sh