{"id":3049,"date":"2011-08-23T10:40:30","date_gmt":"2011-08-23T15:40:30","guid":{"rendered":"http:\/\/jianmingli.com\/wp\/?p=3049"},"modified":"2012-07-25T09:48:35","modified_gmt":"2012-07-25T14:48:35","slug":"weblogic-11g-node-manager-overview","status":"publish","type":"post","link":"https:\/\/jianmingli.com\/wp\/?p=3049","title":{"rendered":"WebLogic 11g: Node Manager Overview"},"content":{"rendered":"

Overview<\/h2><\/span>\n

* Not <\/em>associated with a specific WebLogic domain.
\n* Is <\/em>Associated with a machine<\/em>.
\n* Same node manager can control server instances in any WebLogic Server domain, as long as server instances reside on the same machine as the Node Manager.<\/p>\n

\"\"<\/a><\/h4><\/span>\n

Node Manager Types<\/h3><\/span>\n

Java-based Node Manager<\/a><\/h4><\/span>\n

* Version can be found in nodemanager.properties<\/a>
\n* Compare to script-based:
\n– More secure.
\n– Faster due to consensus leasing.<\/p>\n

Script-based Node Manager<\/a><\/h4><\/span>\n

* Not <\/em>supported in Windows OS.
\n* Compare to Java-based:
\n– Easier to configure (just copying, existing SSH connections).
\n– Smaller footprint.<\/p>\n

Access Node Manager<\/h3><\/span>\n

* Admin Console
\n* WLST<\/p>\n

Node Manager Function<\/h3><\/span>\n

* Start\/Stop\/Suspend\/Restart managed server.
\n* Auto restart failed Admin\/Managed servers that were started by node manager.
\n* Monitor servers.
\n* View log files.<\/p>\n

Node Manager Config Files<\/a><\/h3><\/span>\n

WL_HOME\/common\/nodemanager Directory<\/strong>
\nnodemanager.properties<\/em>
\n* Used by Java-based Node Manager.<\/p>\n

nodemanager.domains<\/em>
\n* Contains domain name and directory mappings.<\/p>\n

nm_data.properties<\/em>
\n* Contains symmetric encryption key.<\/p>\n

DOMAIN_HOME\/config\/nodemanager Directory<\/strong>
\nnm_password.properties<\/em>
\n* Contains NM username and password.<\/p>\n

DOMAIN_HOME\/servers\/server_name\/data\/nodemanager Directory<\/strong>
\nboot.properties<\/em>
\n* Contains user credentials when starting a server.<\/p>\n

startup.properties<\/em>
\n* Used to start\/restart managed servers.
\n* Contains properties copies from Admin Server.
\n* One file for each managed server.<\/p>\n

server_name.addr<\/em>
\n* Contains IP address added when a server starts or is migrated.
\n* Generated after server IP address is successfully brought online during migration.
\n* Deleted when IP address is brought offline.<\/p>\n

server_name.lck<\/em>
\n* Generated by each server.
\n* Contains internal lock id.<\/p>\n

server_name.pid<\/em>
\n* Contains process id for each server.<\/p>\n

server_name.state<\/em>
\n* Contains server’s current state.<\/p>\n

Log Files<\/a><\/h3><\/span>\n

nodemanager.log<\/em>
\n* For Java-based node manager only.
\n* Located in WL_HOME\/common\/nodemanager directory.
\n* Can be viewed by
\n– Admin Console: Machines > Monitoring > Node Manager Log<\/strong> page.
\n– WLST nmlog <\/strong>command.<\/p>\n

server_name.out<\/em>
\n* Server specific log file.
\n* Located in domain_name\/servers\/server_name\/logs directory.
\n* Can be viewed by
\n– Admin Console: Diagnostics > Log<\/strong> page.
\n– WLST nmServerLog <\/strong>command.<\/p>\n

General Node Manager Configuration<\/h2><\/span>\n

Configure Machine to Run NM<\/h3><\/span>\n

Default Behavior<\/h4><\/span>\n

* NM is ready to run after WebLogic Server installation if you
\n– run NM and WLS on the same machine.
\n– use the demo SSL config.
\n* NM can be started using NM via WLS.
\n* NM monitors the MS that it started.
\n* Auto restart of MS is enabled.<\/p>\n

Enroll WLST Client in Prod Environment<\/h4><\/span>\n

* Start WLS.
\n* Update NM credentials.
\n– Click domain_name -> Security -> General tab<\/strong>.
\n– Click Advanced <\/strong>arrow.
\n– Update NodeManager Password<\/strong>.
\n* Invoke WLST and use connect command to connect to WLS.
\n* Use nmEnroll to envroll WLST client.
\n– Syntax:<\/p>\n

\r\nnmEnroll([domainDir], [nmHome])\r\n<\/pre>\n
* Sample run:<\/p>\n
\r\ncd \/opt\/oracle\/Middleware\/home_11gr1\/wlserver_10.3\/common\/bin\r\n.\/wlst.sh\r\n\r\nnmConnect('weblogic', 'welcome1', 'localhost', '5556', 'soa_domain', '\/opt\/oracle\/Middleware\/home_11gr1\/user_projects\/domains\/soa_domain','ssl')\r\nConnecting to Node Manager ...\r\nSuccessfully Connected to Node Manager.\r\n\r\nnmEnroll('\/opt\/oracle\/Middleware\/home_11gr1\/user_projects\/domains\/soa_domain', '\/opt\/oracle\/Middleware\/home_11gr1\/wlserver_10.3\/common\/nodemanager')\r\nEnrolling this machine with the domain directory at \/opt\/oracle\/Middleware\/home_11gr1\/user_projects\/domains\/soa_domain ...\r\nSuccessfully enrolled this machine with the domain directory at \/opt\/oracle\/Middleware\/home_11gr1\/user_projects\/domains\/soa_domain.\r\n<\/pre>\n
* Run nmEnroll
\n– on each machine that is running a MS.
\n– on each domain directory on each machine.<\/p>\n
Specify Node Manager Username and Password<\/h4><\/span>\n
* Maintained in nm_password.properties file.
\n* nm_password.properties is created by nmEnroll <\/em>command.
\n* Use Admin Console to change username and password.
\n* Manual editing of nm_password.properties file requires NM restart.<\/p>\n
Configure a Machine to user NM<\/h4><\/span>\n
* Config machine definition for each machine that runs a NM process
\n– Login Admin Console.
\n– Go to Environment > Machines > machine_name > Node Manager<\/strong>.
\n– Set Listen Address<\/strong> and Listen Port<\/strong>.<\/p>\n
\"\"<\/a><\/h4><\/span>\n
Config nodemanager.domains File<\/h4><\/span>\n
* This file specifies domains that a NM instance controls in the format:
\ndomain-name=domain-directory<\/p>\n
\r\ncd \/opt\/oracle\/Middleware\/home_11gr1\/wlserver_10.3\/common\/nodemanager\r\ncat nodemanager.domains\r\n\r\nsoa_domain=\/opt\/oracle\/Middleware\/home_11gr1\/user_projects\/domains\/soa_domain\r\n<\/pre>\n
* Client can only execute commands for the domains listed in this file.<\/p>\n
Config Remote Startup Arguments<\/h4><\/span>\n
* In Admin Server’s Server > Configuration > Server Start<\/strong> page.
\n* If NM is run as a Windows Service, you must config following JVM property for each MS. Otherwise, NM can not restart MS.
\n– For Sun JVM: -Xrs<\/strong>
\n– For JRockit: -Xnohup<\/strong><\/p>\n
Config Server Startup Properties<\/h4><\/span>\n
* Defined in DOMAIN_HOME\/servers\/server_name\/data\/nodemanager\/startup.properties file.<\/p>\n
Define Admin Server Listen Address<\/h4><\/span>\n
* Make sure that a listen address is defined for each Administration Server that will connect to the Node Manager process.
\n* If the listen address for an Administration Server is not defined, when Node Manager starts a Managed Server it will direct the Managed Server to contact localhost for its configuration information.
\n* Set the Listen Address using the Servers > Configuration > General page<\/strong> in the Administration Console.<\/p>\n
Set NM Env Variables<\/h4><\/span>\n
* See samples startup script at
\n\/opt\/oracle\/Middleware\/home_11gr1\/wlserver_10.3\/server\/bin\/ startNodeManager.sh<\/p>\n
Config Java NM<\/h2><\/span>\n
Reconfigure Startup Service for Windows Installations<\/h3><\/span>\n
* Go to WL_HOME\\server\\bin<\/strong> directory.
\n* Delete the existing service using uninstallNodeMgrSvc.cmd<\/strong> script.
\n* Edit installNodeMgrSvc.cmd<\/strong> to specify Node Manager’s listen address and listen port.
\n* Make the same edit to uninstallNodeMgrSvc.cmd<\/strong>.
\n* Run installNodeMgrSvc.cmd<\/strong> to re-install Node Manager as a service, listening on the updated address and port.<\/p>\n
Config Script NM<\/h2><\/span>\n
Start NM<\/h2><\/span>\n
Start Java-based NM Using Scripts<\/h3><\/span>\n
Sample NM Startup Script<\/h4><\/span>\n
* Located in WL_HOME\\server\\bin<\/strong> directory:
\n– Win: startNodeManager.cmd<\/strong>
\n– Unix: startNodeManager.sh<\/strong>
\n* Working directory is: WL_HOME\/common\/nodemanager<\/strong><\/p>\n
Stop Java-based NM<\/h3><\/span>\n
* Ctr-C<\/strong> or close the command shell.
\n* Use WLST stopNodeManager<\/strong>.
\n– Need to set in nodemanager.properties.<\/p>\n
\r\nQuitEnabled=true\r\n<\/pre>\n
Use NM<\/h2><\/span>\n
Start Admin Server with NM<\/h3><\/span>\n
* Start NM.
\n* Invoke WLST<\/a>.
\n* nmConnect to NM.
\n* nmStart Admin Server.<\/p>\n
Start Managed Server with NM<\/h3><\/span>\n
* Start NM.
\n* Invoke WLST<\/a>.
\n* nmConnect to NM.
\n* Start Managed Server.<\/p>\n
\r\nwls:\/wl_server\/serverConfig> start('MyMSvr2')\r\n\r\nStarting server MyMSvr2 .................................................\r\nServer with name MyMSvr2 started successfully\r\n<\/pre>\n
* Stop Managed Server.<\/p>\n
\r\nwls:\/wl_server\/serverConfig> nmKill('MyMSvr2')\r\nKilling server MyMSvr2 ...\r\nSuccessfully killed server MyMSvr2 ...\r\n<\/pre>\n
Start Managed Server with NM without Admin Server<\/h3><\/span>\n
* Used when Admin Server is not <\/strong>available.
\n* Similar to with Admin Server but use nmStart instead of Start WLST command.<\/p>\n
Example Setup<\/h2><\/span>\n
* See this post<\/a> for an example NM setup.<\/p>\n
References<\/h2><\/span>\n
* Oracle\u00ae Fusion Middleware Node Manager Administrator’s Guide for Oracle WebLogic Server 11g Release 1 (10.3.4) Part Number E13740-03<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Overview * Not associated with a specific WebLogic domain. * Is Associated with a machine. * Same node manager can control server instances in any WebLogic Server domain, as long as server instances reside on the same machine as the … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[91],"tags":[],"class_list":["post-3049","post","type-post","status-publish","format-standard","hentry","category-weblogic"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p8cRUO-Nb","_links":{"self":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/3049","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3049"}],"version-history":[{"count":23,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/3049\/revisions"}],"predecessor-version":[{"id":5485,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/3049\/revisions\/5485"}],"wp:attachment":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3049"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3049"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3049"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}