Friday, July 10, 2015

SOA12c nodemanager and WLST

Nodemanager and WLST


In my other post we discussed the essentials & basics of nodemanager and also looked at some differences between the NM in SOA 10.1.3 and pre 12.1.3 releases.


I’ll have another post wherein we pay due honor to WLST as at topic in itself; while in this one, we’ll the cover the particulars of WLST in context of tasks listed below.

v  Connect to the running nodemanager

o   Using nodemanager credentials in plain text

o   Generating authentication keys to connect to the nodemanager

v  Starting the nodemanager

v  Starting & checking the status the Admin & Manager servers with nodemanager

v  Stopping the servers

v  Precautions




Ø  Connect to the running nodemanager instance

To connect to the running instance of nodemanager, the command at your service is nmConnect(). The basic syntax to use this command is:

nmConnect ( [username, password], [host], [port], [domainName], [domainDir], [nmType], [verbose])

nmConnect ( [userConfigFile, userKeyFile], [host], [port], [domainName], [domainDir], [nmType], [verbose])


Except for the argument nmType, for which valid options can be plain/ssl/ssh/etc., all other arguments have intuitive names.



Connecting to NM using credentials:

wls :/offline> nmConnect('weblogic', 'pass123', '', '5556','mypoc_domain','/opt/app/oracle/middleware/user_projects/domains/mypoc_domain','plain')

Connecting to Node Manager ...

Successfully Connected to Node Manager.

wls :/nm/mypoc_domain>


Generating authentication keys for password less connection with nodemanager:

Use the command storeUserConfig(), after connecting to the nodemanger

Connecting to Node Manager ...

Successfully Connected to Node Manager.

wls :/nm/mypoc_domain> storeUserConfig('/home/oracle/.scripts/.wlstscriptkey/nmconfigfile.securee', '/home/oracle/.scripts/.wlstscriptkey/')

Currently connected to Node Manager to monitor the domain mypoc_domain.

You will need to be connected to a running WLS or Node Manager to execute this command


The above snippet shows an error arisen because the storeConifg () command currently consider that we are trying to store the config details for weblogic connection and NOT for NM.I correct my mistake by providing more argument to the command as below, and got the authentication files generated.


Word of caution: If we hadn’t provided the option nm=true, and had also been in online mode (by being already connected to the weblogic domain using connect command), we would have got the keys created that may have not worked for subsequent connection to NM.


wls :/nm/mypoc_domain> storeUserConfig('/home/oracle/.scripts/.wlstscriptkey/', '/home/oracle/.scripts/.wlstscriptkey/',nm='true')


Currently connected to Node Manager to monitor the domain mypoc_domain.

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 n:y



The username and password that were used for this WebLogic NodeManager connection are stored in /home/oracle/.scripts/.wlstscriptkey/ and /home/oracle/.scripts/.wlstscriptkey/


Connecting to nodemanager without credentials, using authentication keys:

wls :/offline>nmConnect(userConfigFile='/home/oracle/.scripts/.wlstscriptkey/',

userKeyFile ='/home/oracle/.scripts/.wlstscriptkey/',host='', port='5556', domainName='mypoc_domain', domainDir='/opt/app/oracle/middleware/user_projects/domains/mypoc_domain',nmType='plain')


Connecting to Node Manager ...

Successfully Connected to Node Manager.


Stupid Advise: If you already have the authentication keys generated for connecting to WLST for managing weblogic (using connect command), and if the NM credentials are same as that of weblogic credentials, then you use directly use those keys. Otherwise you can use the below storeConfig() to generate the keys separately for connecting to NM using nmConnect().




Ø  Starting the nodemanager

It is strongly recommended by oracle to startup nodemanger using wlst command startNodeManager ()”. Rather it’s recommended to use the scripts based approach to start and stop nodemanager.*


* Script available in 12cweblogic






Ø  Starting the Admin & Manager servers with nodemanager

Well, it appears very straight forward. After connecting to the nodemanger in wlst, you can run nmStart() to start any servers in the domain as below.


nmStart ('AdminServer')

nmStart ('soa_server1')

nmStart ('odi_server1')


Sample run for starting the server and checking the status of the server started with wlst NM commands.

Wls :/ nm/mypoc_domain> nmStart(‘AdminServer’)

Starting server AdminServer

Successfully started server AdminServer

wls :/nm/mypoc_domain> nmStart(‘soa_server1’)

Starting server soa_server1 …

Successfully started server soa_server1 …

wls :/nm/mypoc_domain> nmServerStatus(‘AdminServer’)




wls :/nm/mypoc_domain> nmServerStatus(‘soa_server1’)




wls :/nm/mypoc_domain>




Ø  Stopping the servers

Unfortunately, there is no nmStop() command from nodemanager for gracefully shutting down the servers, but only a blunt nmKill().-


nmKill (‘AdmingServer’)

nmKill (‘soa_server1’)




Ø  Precautions:

1.       Ensure that file exists in “$DOMAIN_HOME/servers/<<ServerName>>/data/nodemanager/” to be able to start the server using nmStart(). If this is not done, attempt to start the server will result in error and the error will show the server to be in “FAILED_NOT_RESTARTABLE” state.


Hence, when starting the Admin/managed server for first time we either-

o   Need to run “un the nmGenBootStartupProps command to and files for the server” to create the file manually or using

o   OR, create manually

o   OR, you can use the nmStartprops argument to provide user credentials (after connecting to Node Manager):

nm> prps = makePropertiesObject("AdminURL=http://listen_address:listen_port; Username=username; Password=password")

nm> nmStart ("AdminServer",props=prps)


2.       You can check the status of servers using nmServerStatus if and only if they were started using nmStart(). Otherwise the command will not give accurate result.



More weblogic posts coming up soon. Till then, continue to seeITwithSanjay.


1 comment: