Skip navigation.
Downloads | Product Documentation | Support

Upgrading WebLogic Application Environments

# Upgrading Node Manager

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

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

- What Happens During a Node Manager Upgrade
- Upgrading Node Manager

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

For more information about Node Manager, see "Using Node Manager to Control Servers" in Managing Server Startup and Shutdown at `http://e-docs.bea.com/wls/docs91/server_start/nodemgr.html`.

# What Happens During a Node Manager Upgrade

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

- Upgrades Node Manager in the directory you specify so that Node Manager runs in a WebLogic Server 9.1 application environment. The Upgrade Wizard upgrades the `nodemanager.properties` file and converts the `NodeManagerSerializedSystemIni.dat` to `nm_data.properties`.
- Backs up existing log and state management files and stores them in a zip file, `weblogic-nodemanager-backup.zip`.

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

You are prompted to specify the username and password that will be used for Node Manager authorization when upgrading the domain. For more information, see Enter Node Manager Credentials. The listen port number used by Node Manager in the pre-9.1 installation is maintained during the upgrade process.

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

Once the upgrade process is complete, perform the following:

- Enroll the machine with Node Manager, as described in Step 4: Enroll the Machine with Node Manager.
- Verify that the username, password, and listen port settings for Node Manager are set as desired.

# Upgrading Node Manager

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

- Graphical—For upgrading Node Manager interactively, using the graphical user interface.
- Silent—For upgrading Node Manager silently, by specifying upgrade requirements in a file.

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

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

- Upgrading Node Manager in Graphical Mode
- Upgrading Node Manager in Silent Mode

## 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
- Procedure for Upgrading Node Manager

Note: The console from which you are running the Upgrade Wizard in graphical mode must support a Java-based GUI. If you attempt to start the Upgrade Wizard in graphical mode on a system that cannot support a graphical display, the invocation fails and an error message is displayed.

### 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 5: Set Up the Environment.
3. If the Node Manager directory resides in the pre-9.1 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 9.1 installation directory.

In this case, you will need to upgrade the copy Node Manager in the 9.1 installation directory.

Note: Make sure you maintain the current directory structure. You do not need to copy the log (`.log`) files to the new location.

If the Node Manager directory resides outside of the pre-9.1 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 at the end of the upgrade process.

After you run the command, the WebLogic Upgrade Wizard opens, as shown in the following figure.

5. Click Next to proceed to the next window.

### Procedure for Upgrading Node Manager

The following table 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, as shown in the following example. 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, as shown in the following example. Once this 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, such as those shown in the following example. Click Done to close the WebLogic Upgrade Wizard. Note: Before using Node Manager, you must enroll the machine, as described in Step 4: Enroll the Machine 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 machine, 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 5: Set Up the Environment.
3. If the Node Manager directory resides in the pre-9.1 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 9.1 installation directory.

In this case, you will need to upgrade the copy of Node Manager in the 9.1 installation directory.

Note: Make sure you maintain the current directory structure. You do not need to copy the log (`.log`) files to the new location.

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

4. (Optional) Create an XML script to define the upgrade requirements. For more information, see Silent Upgrade XML Script Reference.
5. Navigate to the Node Manager directory that you want 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 if you want 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 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 machine that is hosting the WebLogic domain with Node Manager, as described in Step 4: Enroll the Machine with Node Manager. This step should be performed after you complete the WebLogic domain upgrade process.