Oracle WebLogic Server 12c: Configuring and Using Node Manager

<Do not delete this text because it is a placeholder for the generated list of "main" topics when run in a browser>

Purpose

This tutorial shows how to configure and use the Oracle WebLogic Server 12c Java-based Node Manager.

Time to Complete

Approximately 1 hour

Overview

In a production environment, WebLogic Server instances are often distributed across multiple domains, machines, and geographic locations. Node Manager is a WebLogic Server utility that enables you to start, shut down, and restart the administration server and managed servers from a remote location. Although Node Manager is not required, it is recommended if your WebLogic Server environment hosts applications with high availability requirements.

A Node Manager process is not associated with a specific WebLogic domain, but with a particular machine. You can use the same Node Manager process to control server instances from any WebLogic Server domain, as long as those server instances reside on the same machine as the Node Manager process.

This tutorial covers configuring and starting the Java-based Node Manager and using it to control Oracle WebLogic Server 12c (12.1.1) managed servers.

Software Requirements

The following is a list of software requirements:

Prerequisites

Before starting this tutorial, you should have completed the Oracle by Example tutorials titled Oracle WebLogic Server 12c: Installing WebLogic Server and Creating a Domain, Oracle WebLogic Server 12c: Configuring Managed Servers, and Oracle WebLogic Server 12c: Creating and Configuring Machines.

Inspecting the Current Machine Configuration

To check the configuration of the machines created in the earlier tutorial, perform the following steps:

.

If the administration server of the domain is not already running, it must be started. To start it, in a Terminal window, navigate to the domain directory, and enter the command:

$ ./startWebLogic.sh

 

When prompted for a username and password, enter the credentials of the domain administrator.

 

.

After the administration server is up and running, access the WebLogic Server administration console. Open a web browser and enter the URL:
http://hostname:port/console

In this tutorial, that is: http://host01.example.com:8001/console

Note: Use the host name of your host. Also, if you used a different port number for the administration server, use that port instead.

On the Welcome screen, log in using the username and password entered to start the administration server.

 

.

If any of the managed servers (dizzy1, dizzy2, dizzy3) are running, shut them down.

 

.

Check the configuration of the machines created in the tutorial titled Oracle WebLogic Server 12c: Creating and Configuring Machines.

Under Domain Structure, expand Environment (by clicking the + next to it). Then click Machines.

 

.

In the Machines table, click dizzyMachine1.

 

.

Under Settings for dizzyMachine1, click the Configuration tab and the Node Manager subtab.

 

.

Here you can see the settings for the Node Manager for this machine. It has the Type set to Plain (which means the Java-based Node Manager that does not use SSL), the Listen Address set to host01.example.com , and the Listen Port set to 5556.

 

.

Also check the Node Manager settings for dizzyMachine2. Back under the Domain Structure, under Environment, click Machines.

In the Machines table, click dizzyMachine2.

Under Settings for dizzyMachine2, click the Configuration tab and the Node Manager subtab.

Here you can see the settings for the Node Manager for dizzyMachine2. It has the same settings as the Node Manager for dizzyMachine1, except the Listen Address is set to host02.example.com and the Listen Port is set to 5557.

 

Configuring Node Manager

To create a new Node Manager home directory on a machine and then configure its settings, perform the following steps:

 

.

Open a new Terminal on host01, and navigate to the installation directory, <MIDDLEWARE_HOME>. In this tutorial it is: /u01/app/oracle/Middleware.

 

.

Create a new directory <MIDDLEWARE_HOME>/user_projects/nodemanager/dizzyMachine1.

 

.

Copy the following file to the dizzyMachine1 directory: <MIDDLEWARE_HOME>/wlserver_12.1/server/bin/startNodeManager.sh.

 

.

Edit the file <MIDDLEWARE_HOME>/user_projects/nodemanager/dizzyMachine1/startNodeManager.sh.

 

.

Set the NODEMGR_HOME variable to the current path. In this tutorial, it is <MIDDLEWARE_HOME>/user_projects/nodemanager/dizzyMachine1. Then save your changes.

 

.

Create a new file <MIDDLEWARE_HOME>/user_projects/nodemanager/dizzyMachine1/nodemanager.properties and edit it.

 

.

Add the following three lines to the new file:

  • ListenAddress=host01.example.com
  • ListenPort=5556
  • SecureListener=false

Then save your changes.

 

.

Access the second machine, host02.

You will set up node manager here as well, this time for dizzyMachine2:

Create a new directory <MIDDLEWARE_HOME>/user_projects/nodemanager/dizzyMachine2, and copy the startNodeManager.sh script into this location.

Edit the copied script to set the NODEMGR_HOME variable to the current path. In this tutorial, it is <MIDDLEWARE_HOME>/user_projects/nodemanager/dizzyMachine2. Save the file.

Create a nodemanager.properties file once again, but this time enter the listen address and port number for dizzyMachine2:

  • ListenAddress=host02.example.com
  • ListenPort=5557
  • SecureListener=false

Save this file.

 

Enrolling Computers with a Domain

To enroll a computer with a domain, so that the Node Manager on that computer will accept requests from the domain, perform the following steps:

.

Access host01. In a Terminal window navigate to <MIDDLEWARE_HOME>/wlserver_12.1/server/bin.

Run the setWLSEnv.sh script to set up the environment needed for WLST as follows:

$ source setWLSEnv.sh

 

.

Open WLST in interactive mode by entering the following command in the Terminal window:

java weblogic.WLST

 

.

At the WLST prompt, enter the following command to connect to the running administration server:

wls:/offline> connect('<USERNAME>', '<PASSWORD>', 't3://<ADMIN_HOST>:<ADMIN_PORT>')

Replace the sample argument values with those that match your domain environment. In this tutorial, the command is:

wls:/offline> connect('weblogic', 'Welcome1', 't3://host01.example.com:8001')

 

.

Run the nmEnroll() command. This command enrolls the computer on which WLST is running with the domain of the administration server to which WLST is connected. What "enrolling" means is the command downloads two files from the administration server to this computer: nm_password.properties and SerializedSystemIni.dat.

The Node Manager "secret file," nm_password.properties, contains the encrypted username and password used by the adminstration server to authenticate itself to the Node Manager process. This file is placed in the domain directory under /config/nodemanager/.

The file used for encryption and decryption, SerializedSystemIni.dat, is placed in the domain directory under /security/.

In addition, the nmEnroll() command creates or updates the nodemanager.domains file found in the Node Manager home directory. It adds the current domain to the list of domains that this Node Manager is allowed to manage.

The nmEnroll() command has two arguments:

  • The domain home directory on this computer
  • The Node Manager home directory on this computer

In this tutorial, the command is:

nmEnroll('/u01/app/oracle/Middleware/user_projects/domains/dizzyworld',
'/u01/app/oracle/Middleware/user_projects/nodemanager/dizzyMachine1')

Note: Be sure to put the right path to your domain and to your Node Manager when using the command.

 

.

Exit WLST by entering the following command at the prompt:
exit()

 

.

Access host02 and repeat these steps to run nmEnroll() for the dizzyMachine2 Node Manager home directory:

nmEnroll('/u01/app/oracle/Middleware/user_projects/domains/dizzyworld',
'/u01/app/oracle/Middleware/user_projects/nodemanager/dizzyMachine2')

 

Starting Node Manager

To start Node Manager, perform the following steps:

.

On host01, navigate to <MIDDLEWARE_HOME>/user_projects/nodemanager/dizzyMachine1 and enter:

./startNodeManager.sh

Notice that Node Manager starts for dizzyMachine1.

 

.

On host02, navigate to <MIDDLEWARE_HOME>/user_projects/nodemanager/dizzyMachine2 and enter:

./startNodeManager.sh

 

Starting Servers with Node Manager and the Administration Console

To start the managed servers from the console, perform the following steps:

.

Access the WebLogic Server administration console again. In the Domain Structure section, expand Environment and click Servers.

 

.

Click the Control tab.

 

.

Select the check boxes for all of the managed servers (dizzy1, dizzy2, and dizzy3).

Then click the Start button.

 

.

When prompted for confirmation to start the three servers, click Yes

 

.

Click the refresh icon to periodically refresh the Servers table.

 

.

After a few minutes, verify that each server's State is "Running."

 

Summary

In this tutorial, you learned how to:

Resources

Credits

Hardware and Software Engineered to Work Together Copyright © 2011, Oracle and/or its affiliates. All rights reserved