Configuración del Node Manager

Cómo configurar y usar el Node Manager para controlar servidores administrados (iniciar, bajar, reiniciar) en una máquina Linux

Node Manager es una utilidad opcional pero recomendada en un entorno productivo de WebLogic. No está asociada a un dominio WebLogic en particular sino que a una máquina. Por cada máquina hay un Node Manager corriendo.

Existen dos versiones de Node Manager, una basada en java (corre dentro de una JVM) y otra basada en scripts (con menor seguridad, sólo para sistemas UNIX). Aquí se verá la versión basada en java.

El manual oficial es Oracle Fusion Middleware Node Manager Administrator's Guide for Oracle WebLogic Server 11g Release 1 (10.3.6).

Indice:

1. Archivos Principales de Configuración
2. Configuración general del Node Manager
3. Usando el Node Manager


Archivos Principales de Configuración

nodemanager.properties
Path: WL_HOME/common/nodemanager
(WL_HOME=/home/oracle/Oracle/Middleware/wlserver_10.3)
Este archivo es creado la primera vez que es iniciado el Node Manager después de la instalación de WebLogic Server. El listado de todas las propiedades que se pueden configurar en este archivo están descritas en el manual oficial.

nodemanager.domains
Path: WL_HOME/common/nodemanager
Mapea los nombres de dominios administrados por el Node Manager y su correspondiente directorio.

nm_data.properties
Path: WL_HOME/common/nodemanager
Almacena una llave de encriptación.

nm_password.properties
Path: DOMAIN_HOME/config/nodemanager/
(DOMAIN_HOME=/app/oracle/admin/domains/soadomain)
Almacena el username y password, encriptadas. Se usa para autenticar la conexión entre un cliente (ej: AdminServer) y el Node Manager.

boot.properties
Path: DOMAIN_HOME/servers/server_name/data/nodemanager
Este archivo es usado por el Node Manager para obtener las credenciales cuando inicia un servidor.

startup.properties
Path: DOMAIN_HOME/servers/server_name/data/nodemanager
Se configuran las propiedades de startup del servidor iniciado por el Node Manager. Por ejemplo, la característica de reinicio automático se configura en este archivo: si una instancia de servidor que fue iniciada con Node Manager falla, Node Manager la reinicia automáticamente.

Configuración general del Node Manager

Paso 1: Configurar las máquinas en WebLogic
Cada máquina que ejecutará Node Manager debe ser configurada en WebLogic Server. En la consola de administración click en Lock & Edit, ir al menú Environments > Machines, click New.

Asignarle a la nueva máquina los servidores que serán controlados con el Node Manager: Environments > Machines > (nombre de la máquina) > Configuration > Servers, click Add.

La instalación de WebLogic Server crea por default la máquina LocalMachine, por lo que no haremos configuraciones adicionales en nuestro dominio soadomain.

Paso 2: Especificar username y password de Node Manager en archivo nm_password.properties
Este archivo es creado automáticamente, por lo tanto no haremos configuraciones adicionales en nuestro dominio. Si se edita manualmente se debe reiniciar el Node Manager.

Paso 3: Configurar la comunicación entre el dominio y el Node Manager
Por cada máquina se deben configurar los atributos de conexión del Node Manager en la consola de administración. Ir al menú Environment > Machines > (nombre de la máquina) > Node Manager.

La instalación por default ya viene con la siguiente configuración:
Listen Address: localhost
Listen Port:5556

No haremos configuraciones adicionales en nuestro dominio soadomain.

Paso 4: Configurar archivo nodemanager.domains
En este archivo se especifican los dominios que un Node Manager controla. Este archivo es creado automáticamente por el Configuration Wizard, por lo que no haremos configuraciones adicionales en nuestro dominio.

Paso 5: Configurar argumentos de startup para cada servidor administrado
En la consola de administración, ir a: Environment > Servers > nombre de servidor > Configuration > Server Start.

En esa página se especifican los argumentos de startup que el Node Manager usa para iniciar un servidor administrado. Si no se especifican estas propiedades, el Node Manager usa su propia configuración como default.

NOTA: estos argumentos sólo se usan para iniciar servidores administrados, no para iniciar el servidor de administración.

La instalación por default de WebLogic no configura estos parámetros. En nuestro caso, no nos sirve que el Node Manager inicie los servidores con su propia configuración, por lo que debemos asignarle valores a las propiedades Class Path y Arguments.

¿Cómo obtener los valores para estas propiedades?

a) Primero se debe iniciar el servidor administrado soa_osb_server1 sin usar el Node Manager, con el siguiente comando:

cd /app/oracle/admin/domains/soadomain/bin

nohup ./startManagedWebLogic.sh soa_osb_server1 http://soa11:7001 -Dweblogic.management.username=weblogic -Dweblogic.management.password=welcome1 > soa_osb_server1.log & 

  
Una vez iniciado el servidor revisamos el contenido del archivo soa_osb_server1.log.  Buscar donde diga CLASSPATH y copiamos ese contenido en la propiedad Class Path:

Class Path soa_osb_server1:

/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.jdbc_11.1.1/ojdbc6dms.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/user-patch.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/soa-startup.jar::/home/oracle/Oracle/Middleware/Oracle_OSB1/lib/osb-server-modules-ref.jar:/home/oracle/Oracle/Middleware/patch_wls1036/profiles/default/sys_manifest_classpath/weblogic_patch.jar:/home/oracle/Oracle/Middleware/patch_ocp371/profiles/default/sys_manifest_classpath/weblogic_patch.jar:/home/oracle/jrockit-jdk1.6.0_45-R28.2.7-4.1.0/lib/tools.jar:/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/weblogic_sp.jar:/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.jar:/home/oracle/Oracle/Middleware/modules/features/weblogic.server.modules_10.3.6.0.jar:/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/webservices.jar:/home/oracle/Oracle/Middleware/modules/org.apache.ant_1.7.1/lib/ant-all.jar:/home/oracle/Oracle/Middleware/modules/net.sf.antcontrib_1.1.0.0_1-0b2/lib/ant-contrib.jar:/home/oracle/Oracle/Middleware/Oracle_OSB1/soa/modules/oracle.soa.common.adapters_11.1.1/oracle.soa.common.adapters.jar:/home/oracle/Oracle/Middleware/oracle_common/soa/modules/commons-cli-1.1.jar:/home/oracle/Oracle/Middleware/oracle_common/soa/modules/oracle.soa.mgmt_11.1.1/soa-infra-mgmt.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/communications/modules/usermessaging-config_11.1.1.jar:/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.xdk_11.1.0/xsu12.jar:/home/oracle/Oracle/Middleware/modules/features/weblogic.server.modules.xquery_10.3.1.0.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/db2jcc4.jar:/app/oracle/admin/domains/soadomain/config/soa-infra:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/fabric-url-handler_11.1.1.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/quartz-all-1.6.5.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/oracle.soa.fabric_11.1.1/fabric-runtime-ext-wls.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar:/home/oracle/Oracle/Middleware/Oracle_SOA1/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar:/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.jrf_11.1.1/jrf.jar:/home/oracle/Oracle/Middleware/Oracle_OSB1/lib/version.jar:/home/oracle/Oracle/Middleware/Oracle_OSB1/lib/alsb.jar:/home/oracle/Oracle/Middleware/Oracle_OSB1/3rdparty/classes:/home/oracle/Oracle/Middleware/Oracle_OSB1/lib/external/log4j_1.2.8.jar:/app/oracle/admin/domains/soadomain/config/osb:/home/oracle/Oracle/Middleware/wlserver_10.3/common/derby/lib/derbyclient.jar:/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/xqrl.jar

b) Luego, buscar donde diga "Starting WLS with line" y copiamos las líneas a la propiedad Arguments:

Arguments soa_osb_server1:

-jrockit   -Xms768m -Xmx1536m -Dweblogic.Name=soa_osb_server1 -Djava.security.policy=/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.policy  -Dweblogic.ProductionModeEnabled=true -Dweblogic.security.SSL.trustedCAKeyStore=/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/cacerts   -da -Dplatform.home=/home/oracle/Oracle/Middleware/wlserver_10.3 -Dwls.home=/home/oracle/Oracle/Middleware/wlserver_10.3/server -Dweblogic.home=/home/oracle/Oracle/Middleware/wlserver_10.3/server  -Dcommon.components.home=/home/oracle/Oracle/Middleware/oracle_common -Djrf.version=11.1.1 -Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.Jdk14Logger -Ddomain.home=/app/oracle/admin/domains/soadomain -Djrockit.optfile=/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.jrf_11.1.1/jrocket_optfile.txt -Doracle.server.config.dir=/app/oracle/admin/domains/soadomain/config/fmwconfig/servers/soa_osb_server1 -Doracle.domain.config.dir=/app/oracle/admin/domains/soadomain/config/fmwconfig  -Digf.arisidbeans.carmlloc=/app/oracle/admin/domains/soadomain/config/fmwconfig/carml  -Digf.arisidstack.home=/app/oracle/admin/domains/soadomain/config/fmwconfig/arisidprovider -Doracle.security.jps.config=/app/oracle/admin/domains/soadomain/config/fmwconfig/jps-config.xml -Doracle.deployed.app.dir=/app/oracle/admin/domains/soadomain/servers/soa_osb_server1/tmp/_WL_user -Doracle.deployed.app.ext=/- -Dweblogic.alternateTypesDirectory=/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.ossoiap_11.1.1,/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.oamprovider_11.1.1,/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.jps_11.1.1 -Djava.protocol.handler.pkgs=oracle.mds.net.protocol|oracle.fabric.common.classloaderurl.handler|oracle.fabric.common.uddiurl.handler|oracle.bpm.io.fs.protocol  -Dweblogic.jdbc.remoteEnabled=false -Doracle.security.jps.policy.migration.validate.principal=false  -da:org.apache.xmlbeans... -Dbam.oracle.home=/home/oracle/Oracle/Middleware/Oracle_SOA1 -Dbpm.enabled=true -Dsoa.archives.dir=/home/oracle/Oracle/Middleware/Oracle_SOA1/soa -Dsoa.oracle.home=/home/oracle/Oracle/Middleware/Oracle_SOA1 -Dsoa.instance.home=/app/oracle/admin/domains/soadomain -Dtangosol.coherence.clusteraddress=227.7.7.9 -Dtangosol.coherence.clusterport=9778 -Dtangosol.coherence.log=jdk -Djavax.xml.soap.MessageFactory=oracle.j2ee.ws.saaj.soap.MessageFactoryImpl -Dweblogic.transaction.blocking.commit=true -Dweblogic.transaction.blocking.rollback=true -Djavax.net.ssl.trustStore=/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/DemoTrust.jks -Dem.oracle.home=/home/oracle/Oracle/Middleware/oracle_common -Djava.awt.headless=true -Dums.oracle.home=/home/oracle/Oracle/Middleware/Oracle_SOA1 -Dweblogic.management.discover=false -Dweblogic.management.server=http://soa11:7001  -Dwlw.iterativeDev=false -Dwlw.testConsole=false -Dwlw.logErrorsToConsole=false -Dweblogic.ext.dirs=/home/oracle/Oracle/Middleware/patch_wls1036/profiles/default/sysext_manifest_classpath:/home/oracle/Oracle/Middleware/patch_ocp371/profiles/default/sysext_manifest_classpath   weblogic.Server

NOTA: se eliminan las líneas asociadas al user/Password:
-Dweblogic.management.username=weblogic -Dweblogic.management.password=welcome1

c) Se repite lo anterior para el servidor bam_server1:

cd /app/oracle/admin/domains/soadomain/bin

nohup ./startManagedWebLogic.sh bam_server1 http://soa11:7001 -Dweblogic.management.username=weblogic -Dweblogic.management.password=welcome1 > bam_server1.log &

Classpath BAM:

Es el mismo usado para el servidor soa_osb_server1

Arguments BAM:

-jrockit   -Xms768m -Xmx1536m -Dweblogic.Name=bam_server1 -Djava.security.policy=/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/weblogic.policy  -Dweblogic.ProductionModeEnabled=true -Dweblogic.security.SSL.trustedCAKeyStore=/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/cacerts   -da -Dplatform.home=/home/oracle/Oracle/Middleware/wlserver_10.3 -Dwls.home=/home/oracle/Oracle/Middleware/wlserver_10.3/server -Dweblogic.home=/home/oracle/Oracle/Middleware/wlserver_10.3/server  -Dcommon.components.home=/home/oracle/Oracle/Middleware/oracle_common -Djrf.version=11.1.1 -Dorg.apache.commons.logging.Log=org.apache.commons.logging.impl.Jdk14Logger -Ddomain.home=/app/oracle/admin/domains/soadomain -Djrockit.optfile=/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.jrf_11.1.1/jrocket_optfile.txt -Doracle.server.config.dir=/app/oracle/admin/domains/soadomain/config/fmwconfig/servers/bam_server1 -Doracle.domain.config.dir=/app/oracle/admin/domains/soadomain/config/fmwconfig  -Digf.arisidbeans.carmlloc=/app/oracle/admin/domains/soadomain/config/fmwconfig/carml  -Digf.arisidstack.home=/app/oracle/admin/domains/soadomain/config/fmwconfig/arisidprovider -Doracle.security.jps.config=/app/oracle/admin/domains/soadomain/config/fmwconfig/jps-config.xml -Doracle.deployed.app.dir=/app/oracle/admin/domains/soadomain/servers/bam_server1/tmp/_WL_user -Doracle.deployed.app.ext=/- -Dweblogic.alternateTypesDirectory=/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.ossoiap_11.1.1,/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.oamprovider_11.1.1,/home/oracle/Oracle/Middleware/oracle_common/modules/oracle.jps_11.1.1 -Djava.protocol.handler.pkgs=oracle.mds.net.protocol|oracle.fabric.common.classloaderurl.handler|oracle.fabric.common.uddiurl.handler|oracle.bpm.io.fs.protocol  -Dweblogic.jdbc.remoteEnabled=false -Doracle.security.jps.policy.migration.validate.principal=false  -da:org.apache.xmlbeans... -Dbam.oracle.home=/home/oracle/Oracle/Middleware/Oracle_SOA1 -Dbpm.enabled=true -Dsoa.archives.dir=/home/oracle/Oracle/Middleware/Oracle_SOA1/soa -Dsoa.oracle.home=/home/oracle/Oracle/Middleware/Oracle_SOA1 -Dsoa.instance.home=/app/oracle/admin/domains/soadomain -Dtangosol.coherence.clusteraddress=227.7.7.9 -Dtangosol.coherence.clusterport=9778 -Dtangosol.coherence.log=jdk -Djavax.xml.soap.MessageFactory=oracle.j2ee.ws.saaj.soap.MessageFactoryImpl -Dweblogic.transaction.blocking.commit=true -Dweblogic.transaction.blocking.rollback=true -Djavax.net.ssl.trustStore=/home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/DemoTrust.jks -Dem.oracle.home=/home/oracle/Oracle/Middleware/oracle_common -Djava.awt.headless=true -Dums.oracle.home=/home/oracle/Oracle/Middleware/Oracle_SOA1 -Dweblogic.management.discover=false -Dweblogic.management.server=http://soa11:7001  -Dwlw.iterativeDev=false -Dwlw.testConsole=false -Dwlw.logErrorsToConsole=false -Dweblogic.ext.dirs=/home/oracle/Oracle/Middleware/patch_wls1036/profiles/default/sysext_manifest_classpath:/home/oracle/Oracle/Middleware/patch_ocp371/profiles/default/sysext_manifest_classpath   weblogic.Server

NOTA: También se asignan valores a las propiedades User Name y Password. En nuestro caso, corresponden a weblogic y welcome1, respectivamente.

Paso 6: Configurar las propiedades de startup de cada servidor en archivo startup.properties
Este archivo es creado automáticamente (no hacemos configuraciones adicionales).

Paso 7: Definir la dirección del servidor de administración
Para el AdminServer configurar en: Environment > Servers > AdminServer > Configuration > General: Listen Address: se configura el nombre o la IP.

En nuestro dominio soadomain no es necesario configurar este parámetro, ya que sólo usamos una máquina para todos los servidores.

Paso 8: Configurar las variables de entorno de Node Manager
Antes de iniciar el Node Manager hay que setear algunas variables de entorno. El script startNodeManager.sh setea las variables requeridas e inicia el Node Manager, por lo que no hacemos configuraciones adicionales.

Paso 9. Configurar la ejecución de Node Manager como un servicio del sistema operativo
Oracle recomienda que el Node Manager se ejecute como un servicio del sistema operativo para que se reinicie automáticamente cuando se rebootea el sistema.

NOTA: No correr el Node Manager como ususario root.
 

En nuestro dominio soadomain no es necesario realizar esa configuración.

Paso 10. Configurar la seguridad SSL 
El AdminServer y los servidores administrados se comunican con el Node Manager usando SSL de una vía. La instalación default de WebLogic configura los archivos DemoIdentity.jks y DemoTrust.jks que vienen en el directorio /home/oracle/Oracle/Middleware/wlserver_10.3/server/lib. Eso está configurado en el menú Environment > Servers > AdminServer > Configuration > Keystores.

En un entorno de producción se debe cambiar esa configuración. Para configurar las componentes SSL se puede revisar el capítulo Configuring SSL en el manual oficial Oracle Securing Oracle WebLogic Server.

Para que nuestra instalación funcione con el SSL de Demo se debe configurar en el AdminServer el parámetro Hostname Verification en None. Ir al menú Environment > Servers > AdminServer > Configuration > SSL, click en Advanced. Elegir el valor None en la propiedad Hostname Verification. Reiniciar el AdminServer.

Si no se hace esta configuración aparece el siguiente error:

BAD_CERTIFICATE alert was received from nombre_máquina - dirección_IP. Check the peer to determine why it rejected the certificate chain (trusted CA configuration, hostname verification). SSL debug tracing may be required to determine the exact reason the certificate was rejected.

Usando el Node Manager

Iniciar el Node Manager

cd /home/oracle/Oracle/Middleware/wlserver_10.3
./server/bin/startNodeManager.sh 

Detener el Node Manager: no hay un script para detener el Node Manager, simplemente se cierra la ventana donde se está ejecutando (kill al proceso).

Subir un servidor administrado
Ingresar a la consola de administración: http://soa11:7001/console/

Ir al menú Environment > Servers > Control, seleccionar el servidor, click en Start. Si el Node Manager está abajo muestra el siguiente mensaje de error:

"For server soa_server1, the Node Manager associated with machine LocalMachine is not reachable".

Bajar un servidor administrado

Environment > Servers > Control, seleccionar el servidor, Shutdown > Force Shutdown Now.

NOTA: si el servidor está en la misma máquina que el AdminServer se puede hacer el shutdown sin tener el Node Manager arriba.

Archivo de log del Node Manager
Nombre archivo: nodemanager.log
Path: WL_HOME/common/nodemanager/
 

La rotación del log está deshabilitada por default, pero se puede activar seteando la propiedad LogCount en el archivo nodemanager.properties.

---
EOF
---