Skip Headers
Oracle® Fusion Middleware Upgrade Guide for Oracle WebLogic Server
11g Release 1 (10.3.6)

Part Number E13754-07
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

4 Upgrading Node Manager

If you are using a customized version of Node Manager in a pre-9.x environment, you can use the WebLogic Upgrade Wizard to upgrade Node Manager for use in a WebLogic Server 10.3.6 application environment.

The following sections describe how to use the WebLogic Upgrade Wizard for this purpose:

For more information about Node Manager, see "Node Manager Overview" in Node Manager Administrator's Guide for Oracle WebLogic Server.

What Happens During a Node Manager Upgrade

During a Node Manager upgrade, you specify the home directory of the Node Manager to upgrade. The WebLogic Upgrade Wizard performs the following tasks:

Any existing Node Manager files are overwritten during the upgrade process.

You are prompted to specify the username and password to be used for Node Manager authorization when upgrading the domain. For more information, see "Enter Node Manager Credentials" in Table 5-1. If you are upgrading to WebLogic Server 10.3.6 from any pre-9.0 installation, the listen port number used by Node Manager is maintained during the upgrade process.

Note:

When installing the 10.3.6 product, you should, if possible, set the Node Manager listen port to the same port number used in any pre-9.0 installation, if applicable. The default listen port for Node Manager is 5556.

When the upgrade process is complete, perform the following:

Upgrading Node Manager

You must upgrade each instance of Node Manager to run in the WebLogic Server 10.3.6 environment. Specifically, you must upgrade Node Manager on every computer in the domain. You perform an upgrade using the WebLogic Upgrade Wizard in either of the following modes:

You must upgrade Node Manager on each computer in the domain.

The following sections describe how to upgrade Node Manager, including:

Upgrading Node Manager in Graphical Mode

The following sections describe how to upgrade Node Manager using the WebLogic Upgrade Wizard in graphical mode:

Starting the WebLogic Upgrade Wizard in Graphical Mode to Upgrade Node Manager

Note:

Before proceeding, make sure you have performed the prerequisite steps described in Prepare to Upgrade.

To start the WebLogic Upgrade Wizard in graphical mode and upgrade Node Manager:

  1. Verify that the WebLogic domain is not running.

  2. Open an MS-DOS command prompt window (on Windows) or a command shell (on UNIX) and set up the environment as described in Step 6: Set Up the Environment.

  3. If the Node Manager directory resides in a pre-9.0 installation directory, for example, in the default location, WL_HOME/common/nodemanager (where WL_HOME specifies the root directory of the WebLogic Server installation), copy the contents of the Node Manager directory to the following 10.3.6 installation directory:

    MW_HOME/wlserver_10.3/common/nodemanager
    

    In this case, you must upgrade the copy Node Manager in the 10.3.6 installation directory.

    Note:

    Make sure you maintain the current directory structure. It is not necessary for you to copy the log (.log) files to the new location.

    If the Node Manager directory resides outside of the pre-9.0 installation directory, you can skip this step.

  4. At a command prompt, enter the following command:

    java weblogic.Upgrade -type nodemanager [-out file]
    

    The -out argument is optional. It allows you to designate a file in which you want all standard output (stdout) and error messages to be written. By default, these messages are written to the command window and a summary of them is displayed when the upgrade process is complete.

    After you run the command, the WebLogic Upgrade Wizard opens, as shown in Figure 4-1.

    Figure 4-1 WebLogic Upgrade Wizard for Node Manager

    Description of Figure 4-1 follows
    Description of "Figure 4-1 WebLogic Upgrade Wizard for Node Manager"

  5. Click Next to proceed to the next window.

Procedure for Upgrading Node Manager

Table 4-1 summarizes the steps in the procedure to upgrade Node Manager using the WebLogic Upgrade Wizard.

Table 4-1 Procedure for Upgrading Node Manager

In this step ... You ...

Node Manager Home Directory Selection

Select a home directory for the instance of Node Manager to be upgraded by navigating the local directory hierarchy.

The Node Manager home directory contains the nodemanager.properties file, logs, and other related files. The exact set of files generated by Node Manager varies between releases and service packs.

By default, the Node Manager home directory is WL_HOME/common/nodemanager, where WL_HOME specifies the root directory of the WebLogic Server installation.

Click Next to proceed to the next window.

Upgrade Your Node Manager Home

Review progress of the wizard as it saves the upgraded configuration and deletes any temporary files that were created during the upgrade process. Progress messages are displayed in the window.

After the process is complete, click Next to proceed to the next window.

Upgrade Complete

Review the upgrade results, including any important messages that require further consideration.

Click Done to close the WebLogic Upgrade Wizard.

Note: Before using Node Manager, you must enroll the computer, as described in Step 4: Enroll the Computer with Node Manager. This step should be performed after you complete the WebLogic domain upgrade process.


Upgrading Node Manager in Silent Mode

In some circumstances, for example, when Node Manager resides on a remote computer, it is not practical to use the WebLogic Upgrade Wizard in graphical mode. In such situations, you can use the wizard in silent mode to upgrade Node Manager.

Note:

Before proceeding, make sure you have performed the prerequisite steps described in Prepare to Upgrade.

To start the WebLogic Upgrade Wizard in silent mode and upgrade Node Manager:

  1. Verify that Node Manager and all instances of WebLogic Server in the domain are not running.

  2. Open an MS-DOS command prompt window (on Windows) or a command shell (on UNIX) and set up the environment as described in Step 6: Set Up the Environment.

  3. If the Node Manager directory resides in the pre-9.0 installation directory, for example, in the default location, WL_HOME/common/nodemanager (where WL_HOME specifies the root directory of the WebLogic Server installation), copy the contents of the Node Manager directory to the 10.3.6 installation directory.

    In this case, you must upgrade the copy of Node Manager in the 10.3.6 installation directory.

    Note:

    Make sure you maintain the current directory structure. It is not necessary to copy the log (.log) files to the new location.

    If the Node Manager directory resides outside of the pre-9.0 installation directory, you can skip this step.

  4. (Optional) Create an XML script to define the upgrade requirements. For more information, see Appendix E, "Silent Upgrade XML Script Reference."

  5. Navigate to the Node Manager directory to upgrade.

  6. At a command prompt, enter the following command:

    java weblogic.Upgrade -mode silent -type nodemanager [-responses xmlfile] [-out file]
    

    Two arguments are optional: -responses and -out. Include these arguments to override the default values for the following:

    • The location of an XML file that defines the upgrade requirements. If you do not specify a file with the -responses option, the wizard uses the default values during the upgrade process. For more information about the format of the XML file and the default values, see Appendix E, "Silent Upgrade XML Script Reference."

    • The output file in which all standard output (stdout) and error messages are written. If you do not specify a file with the -out argument, these messages are written to the command window.

      Note:

      Before using Node Manager, you must enroll the computer, as described in Step 4: Enroll the Computer with Node Manager. This step should be performed after you complete the WebLogic domain upgrade process.