5 Configuring Script Node Manager

The following sections describe how to configure script-based Node Manager:


The SSH Node Manager is a shell script, wlscontrol.sh, located in WL_HOME/common/bin/. The wlscontrol.sh file must exist on each machine that hosts server instances that you want to control with Node Manager. This script can be customized to meet site-specific requirements.

You must have an SSH client executable on each machine where Node Manager or a Node Manager client runs. This script must also be in the path of the user-id running it. Typically, an SSH client is a standard part of a UNIX or Linux installation.

Step 1: Create User Accounts

Before running Node Manager, you should create a dedicated UNIX user account for performing Node Manager functions. Add this user to all machines that will host the SSH Node Manager and to all machines that will host a Node Manager client, including the Administration Server.

For example:

  1. On each host machine, as the root user, create two new operating system (OS) users: bea and ndmgr, both associated with a new group called bea.

    • Use bea for installing WebLogic Server only.

    • Use ndmgr to create a WebLogic Server domain and start the Administration Server and remote Managed Servers using Node Manager.

  2. Both OS users should have the same OS group (bea) to ensure that the correct permissions are in place for ndmgr to run WebLogic scripts and executables.

    For example:

    > groupadd bea

    > useradd -g bea -m bea

    > passwd bea

    > useradd -g bea -m ndmgr

    > passwd ndmgr

Step 2: Configure Node Manager Security

The Node Manager SSH shell script relies on SSH user-based security to provide a secure trust relationship between users on different machines. Authentication is not required. You create a UNIX user account—typically one per domain—for running Node Manager commands and scripts. A user logged in as this user can issue Node Manager commands without providing a username and password.


You must also ensure that the Node Manager and WebLogic Server commands are available in the path of the UNIX user-id used to run them. Change the environment file of the user to contain the path to WL_HOME/common/bin/ or DOMAIN_HOME/bin/nodemanager.

For example:


This file resides in USER_HOME/.ssh/.

Configure SSH trust between the ndmgr user on each machine that will run a WebLogic Server instance and the same ndmgr user on the same machine, plus the corresponding ndmgr user on every other machine.

In other words, any ndmgr user on one machine must be able to establish an SSH session without being prompted for security credentials, with a ndmgr user of the same name on the same or a different machine. A ndmgr user must also be able to establish an SSH session with itself without being prompted for security credentials. This is necessary because any Managed Server can become the cluster master for migratable servers and issue commands to start other remote Managed Servers in the cluster using SSH. For Managed Server migration to work, the ndmgr user needs only to be able to run the wlscontrol.sh script using SSH. For more information, see Configuring Security for WebLogic Server Scripts.

For example, to configure one instance of a user to trust another instance of a user for SSH version2:

  1. From a terminal logged in as ndmgr user:

    > ssh-keygen -t dsa

  2. When prompted, accept the default locations and press Enter for passphrase so that no passphrase is specified.

  3. Copy the ndmgr user's public key to the ndmgr user's home on the same machine and all other machines.

    > scp .ssh/id_dsa.pub ndmgr@

  4. Establish an SSH session with the target machine as the ndmgr user and set up trust for the remote ndmgr user.

    > ssh -l ndmgr (you should be prompted for password)

    > mkdir .ssh

    > chmod 700 .ssh

    > touch .ssh/authorized_keys2

    > chmod 700 .ssh/authorized_keys2

    > cat id_dsa.pub >> .ssh/authorized_keys2

    > rm id_dsa.pub

    > exit

  5. Test that you can establish an SSH session with the ndmgr user on the remote machine without requiring a password.

    > ssh -l ndmgr

  6. Repeat this process for all combinations of machines.

Alternatively, you can achieve the same result by generating a key value pair on each machine, concatenating all of the public keys into an authorized_keys2 file, and copying (scp) that file to all machines. Try establishing SSH sessions between all combinations of machines to ensure that the ~/.ssh/known_hosts files are correctly configured. For more information, see Generating and Distributing Key Value Pairs.

Step 3: Install WebLogic Server

As the bea user, install a WebLogic Server instance in the base directory, /opt/bea/wlserver_103, on all the machines that will run WebLogic Server.

For example:

> ./ wlserver_103_linux32.bin

Step 4: Create a WebLogic Domain

In the ndmgr user's home directory, create a WebLogic domain on the machine which will host the Administration Server only.

Subsequently, when you start the Administration Server, it will use the configuration in the config subdirectory of this domain directory to determine the settings for the Administration Server and the domain.

It is likely that most Managed Server instances will be run remotely with respect to the Administration Server. Therefore, these Managed Servers will not have direct access to the domain configuration directory of the Administration Server. Instead they will run from a skeleton domain directory in their respective machine's ndmgr home directory and will obtain their configuration over the network on startup from the remotely running Administration Server.

As the ndmgr user, create the WebLogic domain.

For example:

  1. Run the Configuration Wizard:

    > /opt/bea/wlserver_103/common/bin/config.sh

  2. Create a new WebLogic domain based on the default WebLogic Server template.

  3. For the Administration Server, specify a fixed IP address (for example,

  4. In Customize Environment and Service Settings, select Yes.

  5. In Configure Managed Servers, add two Managed Servers, MS1 and MS2.

    For the Managed Servers, specify floating IP addresses (for example, and

  6. In Configure Clusters, add a cluster, CLUST, and then assign MS1 and MS2 to it.

    Do not specify any Machines or UNIX Machines; you will do this manually in a subsequent step.

  7. Name the domain clustdomain and save it to /opt/bea/clustdomain

Step 5: Start the Administration Server

As the ndmgr user, start the Administration Server locally from a terminal using the wlscontrol.sh Node Manager script.

For example:

> /opt/bea/wlserver_103/common/bin/wlscontrol.sh -d clustdomain -r
 /opt/bea/clustdomain -c -f startWebLogic.sh -s AdminServer START

For verbose logging to standard out, add the -x parameter to the command.

Once successfully started, stop the Administration Server and then start it remotely using SSH.

For example:

> ssh -l ndmgr -o PasswordAuthentication=no %p 22
103/common/bin/wlscontrol.sh -d clustdomain -r /home/ndmgr/clustdomain -c -f
 startWebLogic.sh -s AdminServer START 

Step 6: Configure Node Manager on the Managed Servers

Each machine that will host a Managed Server will have a skeleton domain created and configured.

  1. From a local terminal, create a new empty directory (clustdomain) in the home directory for the ndmgr user for each of the Managed Server host machines and also a back-up machine. For example:

    > mkdir clustdomain

  2. For each of the Managed Server host machines and the back-up machine, as the ndmgr user, use WLST to enroll the user's home directory as being the base directory for remotely run servers and for Node Manager.

    For example:

    > opt/bea/wlserver_103/common/bin/wlst.sh

    > connect('weblogic','welcome1','t3://')

    > nmEnroll('/home/ndmgr/clustdomain','/home/ndmgr')

    > exit()

    Be sure to run nmEnroll on each remote machine. This command creates a property file, /home/ndmgr/nodemanager.domains, which maps domain names to home directories, and creates the required domain configuration and security information so that Managed Servers can communicate with the Administration Server.

    The nodemanager.domains file removes the need to specify the domain home directory (with -r) when starting wlscontrol.sh. However, since you changed the Node Manager home directory, you must specify -n /home/ndmgr. The default Node Manager home directory is /opt/bea/wlserver_103/common/nodemanager.domains; you might not want to use this directory as it is in the product installation directory and owned by another user.

Step 7: Test Node Manager Setup and Configuration by Starting Managed Servers

  1. Create a WebLogic script directory (bin) in the Node Manager's new domain home.

    For example:

    > mkdir ~/clustdomain/bin

  2. Copy the scripts from the Administration Server's domain bin directory to the corresponding domain bin directory on each Node Manager machine (for example, /home/ndmgr/bin). For example:

    > scp ndmgr@ ~/clustdomain/bin/* ndmgr@

  3. For each Node Manager machine (including the back-up machine), edit the shell scripts in the bin directory to reflect the proper path for the local domain home, and the remote Administration Server's IP address.

    For example:

    1. Edit the DOMAIN_HOME and LONG_DOMAIN_HOME variables in the setDonainEnv.sh script to correctly reflect this remote domain home directory: DOMAIN_HOME=/home/ndmgr/clustdomain

    2. LONG_DOMAIN_HOME=/home/ndmgr/clustdomain

    3. Similarly, edit the DOMAIN_HOME variable in startWebLogic.sh

    4. Edit the DOMAIN_HOME and ADMIN_URL (for example, t3:// variables in startManagedWebLogic.sh).

  4. For each of the Managed Server host machines (including the back-up machine), as the ndmgr user, create a server/security subdirectory in the domain directory.

    For example, for the Managed Server MS1:

    > mkdir -p ~/clustdomain/servers/MS1/security


    For the back-up machine, create a server directory for every migratable Managed Server (for example, both MS1 and MS2).
  5. Create a new boot.properties file with the appropriate username and password variables specified in each Managed Server's security directory (for example, /home/ndmgr/clustdomain/servers/MS1/security).

    For example:




    When a Managed Server is first started using the script-based Node Manager, the values in this file will be encrypted.
  6. For each of the Managed Server machines, as the ndmgr user, start the Managed Server locally from a terminal using the wlscontrol.sh Node Manager script.

    For example, to start the Managed Server, MS1:

    > opt/bea/wlserver_103/common/bin/wlscontrol.sh -d clustdomain -n /home/ndmgr -c -f startManagedWebLogic.sh -s MS1 START

    For verbose logging to standard out, add the -x parameter to the command.

  7. Once successfully started, stop the Managed Servers and then, as the ndmgr user, attempt to start the Managed Servers remotely using SSH.

    For example to start MS1:

    > ssh -l ndmgr -o PasswordAuthentication=no -p 22 /opt/bea/wlserver_103/common/bin/wlscontrol.sh -d clustdomain -n /home/ndmgr -c -f startManagedWebLogic.sh -s MS1 START

  8. Once successfully started, stop the Managed Servers again and then repeat the process by trying to start each Managed Server (MS1) on the back-up machine instead. Again, stop this server once it successfully starts.

Step 8: Configure UNIX Machines

Using the Administration Console, add a new UNIX Machine for each machine which will host an Administration or Managed Server (including the back-up machine) and include the following settings:

Table 5-1 UNIX Machine Settings

Property Value

O.S. Type


Node Manager Type


Node Manager Listen Address

primary-ip-address (not floating IP address)

Node Manager Listen Port


Node Manager Home


Node Manager Shell Command

ssh -l ndmgr -o PasswordAuthentication=no -p %P %H
/opt/bea/wlserver_103/common/bin/wlscontrol.sh -d %D
-n /home/ndmgr -c -f startManagedWebLogic.sh -s %S %C

Node Manager Debug Enabled



name of the Administration or Managed Servers 
hosted on machine

Step 9: Assign Servers to Machines

Once all of the UNIX Machines are created, use the Administration Console to set the Machine property for each server, to ensure each server is associated with its corresponding UNIX Machine. See "Assign server instances to machines" in the Oracle Fusion Middleware Oracle WebLogic Server Administration Console Help.

Step 10: Start Managed Servers

In the Administration Console, start each Managed Server. See "Start Managed Servers from the Administration Console" in the Oracle Fusion Middleware Oracle WebLogic Server Administration Console Help.

Check the server logs in the /home/ndmgr/clustdomain/servers/managed_server_name/logs directory of each Managed Server to ensure that the server has started with no errors.

Overriding the Default SSH Port

The default SSH port used by Node Manager is 22. You can override that setting in the following ways:

  • Set the Port= parameter in the ~/.ssh/config file to set the default port for an individual user.

  • Set the Port= parameter in the /etc/ssh_config file to set the default port across the entire system.

  • Start the Administration Server using the following system property:

    -Dweblogic.nodemanager.ShellCommand="ssh -o PasswordAuthentication=no -p %P
     wlscontrol.sh -d %D -r %R -s %S %C"

    After starting the server, you can edit the SSH port in the Administration Server's configuration file.

Configuring Security for WebLogic Server Scripts

To perform server migration and other tasks, the user-id executing scripts such as wlscontrol.sh must have sufficient security permissions. This includes being able to bring an IP address online or take an IP address offline using a network interface.

Server migration is performed by the cluster master when it detects that a server has failed. It then uses SSH to launch a script on the target machine to begin the migration. The script on the target machine runs as the same user ID running the server on the cluster master.

The commands required to perform server migration are wlsifconfig and arping. Since these scripts require elevated OS privileges, it is important to note that this can prevent a potential security hole. Using sudo, you can configure your SSH to only allow wlsifconfig and arping to be run using elevated privileges.

Configuring Remote Server Start Security for Script-based Node Manager

A remote start username and password is required to start a server instance with Node Manager. These credentials are provided differently for Administration Servers and Managed Servers.

  • Credentials for Managed Servers—When you invoke Node Manager to start a Managed Server, it obtains its remote start name and password from the Administration Server.

  • Credentials for Administration Servers—When you invoke Node Manager to start an Administration Server, the remote start username can be provided on the command line, or obtained from the Administration Server's boot.properties file. The Configuration Wizard initializes the boot.properties file and the startup.properties file for an Administration Server when you create the domain.

Any server instance started by Node Manager encrypts and saves the credentials with which it started in a server-specific boot.properties file, for use in automatic restarts.

Generating and Distributing Key Value Pairs

The script-based Node Manager uses two types of key value pairs. This section contains instructions for distributing key value pairs to the machines that will host a Node Manager client or server.

Shared Key Value Pair

This option distributes the same key value pair to all machines that will host a Node Manager client or server.

The simplest way to accomplish this is to set up your LAN to mount the Node Manager user home directory on each of the machines. This makes the key value pair available to the machines. Otherwise:

  1. Generate an RSA key value pair for the user with the ssh-keygen command provided with your SSH installation.

    The default location for the private and public keys are ~/.ssh/id_rsa and ~/.ssh/id_rsa.pub respectively.

    If these keys are stored in a different location, modify the ShellCommand template, adding an option to the ssh command to specify the location of the keys.

  2. Append the public key to the ~/.ssh/authorized_keys file on the Node Manager machine.

    For example:

    command="/home/bea/server90/common/nodemanager/nodemanager.sh" 1024 33 23...2323

    in which the you substitute the public key that you generated, as stored in id_rsa.pub, for the string shown in the example as

    1024 33 23...2323


    The prefix command=command ensures that a user that establishes a session with the machine using the public key can only run the command specified—nodemanager.sh. This ensures that the user can only perform Node Manager functions, and prevents unauthorized access to data, system utilities, or other resources on the machine.
  3. Manually distribute the key value pair to each machine that will host a Node Manager server instance or client.

  4. Execute the following command on the client machine to check that the Node Manager client can access the Node Manager:

    /home/bea$ ssh montgomery VERSION

    This response indicates that the client accessed Node Manager successfully:

    +OK NodeManager v9.1.0

Individual Key Value Pairs

On each machine that will host a Node Manager client:

  1. Generate a separate RSA key value pair for the Node Manager user as described in step one in the previous section.

  2. Append the public key to the machine's ~/.ssh/authorized_keys file user as described in step two in the previous section.