test

N1 Grid Service Provisioning System 5.0 Installation Guide

Upgrading Remote Agents and Local Distributors

The N1 Grid Service Provisioning System 5.0 provides an automatic upgrade utility that allows you to upgrade Remote Agents and Local Distributors by using the browser interface to the Master Server. Before you use the automatic utility, all of the Remote Agents and Local Distributors must be running on operating system versions that are supported by the N1 Grid Service Provisioning System 5.0. If you begin an automatic upgrade and receive an error message indicating that some Remote Agents or Local Distributors were not upgraded because the operating system version is not supported, you will need to manually upgrade the Remote Agents and Local Distributors on those servers. See How to Manually Upgrade Remote Agents and Local Distributors From an Operating System That Is No Longer Supported.

ProcedureHow to Upgrade Remote Agents and Local Distributors

If you are running Remote Agents and Local Distributors on an operating system version that is not supported by the N1 Grid Service Provisioning System 5.0, you first upgrade the server to an operating system that is supported by both the 4.1 and 5.0 versions of the N1 Grid Service Provisioning System. Then, you use the browser interface to upgrade all of the Remote Agents and Local Distributors in your network. After the applications have been upgraded, you can then upgrade your servers to numerically higher versions of the operating system, if they are supported by the N1 Grid Service Provisioning System 5.0.

For example, you are running a 4.1 Remote Agent on a Red Hat Linux 7.1 server and you want to upgrade that server to Red Hat Linux 3.0 Advanced Server. First, you need to upgrade the server to Red Hat Linux Advanced Server 2.1, which is supported by both the 4.1 and 5.0 versions of the N1 Grid Service Provisioning System. Second, upgrade all of the Remote Agents by using the browser interface to the Master Server. Finally, upgrade the server to Red Hat Linux 3.0.

Before You Begin

Migrate the Master Server before upgrading Remote Agents and Local Distributors.

Steps

  1. Identify any server that is running the 4.1 Remote Agent or Local Distributor on an operating system that is not supported by the N1 Grid Service Provisioning System 5.0.

    For a list of supported operating systems, see Supported Operating Systems.

  2. On each server that is running the 4.1 Remote Agent or Local Distributor on an operating system that is not supported by the N1 Grid Service Provisioning System 5.0, upgrade the operating system to a version that is supported by both the 4.1 and 5.0 versions of the N1 Grid Service Provisioning System.

  3. Log in to the browser interface of the N1 Grid Service Provisioning System 5.0 Master Server.

  4. Click Hosts.

  5. Click masterserver.

  6. Click the Update Entire N1 SPS network... button.

    A window opens and displays a list of hosts that are being upgraded. The progress of the upgrade is also displayed. When the process completes, the window displays the following message.


    Host Update not yet complete.

  7. Click the Close button.

  8. To complete the second phase of the upgrade, click the Update Entire N1 SPS network... button again.

    A window displays a list of hosts that are being upgraded. The progress of the upgrade is also displayed. When the process completes, the status for each of the hosts displays as Updated.

  9. Click the Close button.

    The upgrade is complete.

  10. Prepare the Hosts that you upgraded.

    Before you can run a Plan on a Host that you upgraded, you must Prepare the Host. To Prepare Hosts, follow the instructions in How to Prepare a Physical Host in N1 Grid Service Provisioning System 5.0 System Administration Guide .

  11. (Optional) If you want to upgrade the operating system on your servers to a numerically higher version, you may do so.

    The version to which you upgrade the operating system must be supported by the N1 Grid Service Provisioning System 5.0.

ProcedureHow to Manually Upgrade Remote Agents and Local Distributors From an Operating System That Is No Longer Supported

If you did not upgrade servers running operating systems that are no longer supported by the N1 Grid Service Provisioning System 5.0 before you automatically upgraded the Remote Agents and Local Distributors, you need to manually upgrade those systems.

Steps

  1. On the server that is running the 4.1 Remote Agent or Local Distributor that you want to upgrade, log into the machine as the user who installed the 4.1 version of the Remote Agent or Local Distributor.

  2. Change to the directory that contains the application scripts.


    % cd /N1SPS4.1-home/app/bin/

    N1SPS4.1-home is the directory where you installed the application.

    app is agent for the Remote Agent and ld for the Local Distributor.

  3. Stop the 4.1 Remote Agent or Local Distributor.


    % ./cr_app stop

    app is agent for the Remote Agent and ld for the Local Distributor.

  4. Verify that the 4.1 Remote Agent or Local Distributor is not automatically started upon system reboot by system start up scripts.

  5. Upgrade the operating system on the server to a version that the N1 Grid Service Provisioning System 5.0 supports.

  6. Move the 4.1 Remote Agent or Local Distributor to a temporary location on the server.


    % mv /N1SPS4.1-home/app /temporary_directory

    N1SPS4.1-home is the directory where you installed the application.

    app is agent for the Remote Agent and ld for the Local Distributor.

    temporary_directory is the temporary directory in which to move the application.

  7. Install the 5.0 Remote Agent or Local Distributor in the same directory where the 4.1 application had been installed.

    For instructions, see How to Install the N1 Grid Service Provisioning System 5.0 on Solaris OS, Red Hat Linux, and IBM AIX Systems.

  8. Change to the directory that contains the scripts for the 5.0 Remote Agent or Local Distributor.


    % cd /N1SPS5.0-home/app/bin/

    N1SPS5.0-home is the directory where you installed the application.

    app is agent for the Remote Agent and ld for the Local Distributor.

  9. Migrate the data to the 5.0 Remote Agent or Local Distributor.


    % ./migrateNode_4.1-5.0.sh -n /N1SPS5.0-home/app -o /temporary_directory/N1SPS4.1-home/app

    N1SPS5.0-home is the directory where you installed the 5.0 application.

    /temporary_directory/N1SPS4.1-home is the directory to which you moved the 4.1 application.

    app is agent for the Remote Agent and ld for the Local Distributor.

    The migration script migrates the following files:

    • config.properties

    • transport.config

    • keystores

    • snapshots on the Remote Agent

  10. Start the 5.0 Remote Agent or Local Distributor.


    % ./cr_app start

    app is agent for the Remote Agent and ld for the Local Distributor.