N1 Grid Service Provisioning System 5.0 Installation Guide

ProcedureHow to Upgrade a Master Server From an Operating System That Is No Longer Supported

Occasionally, new versions of the N1 Grid Service Provisioning System no longer contain support for operating systems that were previously supported. Upgrading the Master Server from a previously supported operating system to a new operating system version requires two phases. In the first phase, the data from the previous version of the Master Server is archived into a file. In the second phase, the data stored in the archive file is migrated into the new version of the Master Server.

Steps
  1. Log into the machine as the user who installed the 4.1 version of the Master Server.

  2. Verify that the database will not be optimized during the migration process.

    Check that you do not have any cron jobs scheduled that would start a database optimization while you are migrating the data.

  3. Access a command prompt.

  4. Access the migration script.

    • If you are migrating using a CD, insert the N1 Grid Service Provisioning System 5.0: IBM-AIX, Red Hat Linux CD.

    • If you are migrating using a image that you downloaded, change to the directory where you saved the downloaded image.

  5. Change to the directory on the software CD or within the downloaded image where the migration script is located.


    % cd /migrate
    
  6. Copy the migration script to the 4.1 Master Server.


    % cp migrateMS_4.1-5.0.sh /N1SPS4.1-home/server/bin
    

    N1SPS4.1-home is the directory where you installed the 4.1 Master Server.

  7. Change to the directory on 4.1 Master Server that contains the migration script that you copied.


    % cd /N1SPS4.1-home/server/bin
    
  8. Create a file that contains the data from the 4.1 Master Server.


    % ./migrateMS_4.1-5.0.sh -archive /path-to-archive-file/filename
    

    path-to-archive-file is the directory in which you want to save the archive file created by the migration script. filename is the name that you designate for the archive file.

  9. Follow the instructions on the screen to complete the creation of the file.

  10. Install the 5.0 version of the Master Server.

  11. Change to the directory that contains the migration script.


    % cd /N1SPS5.0-home/server/bin/migrate
    
  12. Start the migration script.


    % ./migrateMS_4.1-5.0.sh -migrate path-to-archive-file/filename
    

    path-to-archive-file is the path that you specified for the migration script to save the file that contains the archived data. filename is the name that you designated for the archive file.

  13. Follow the instructions on the screen to complete the migration.

    When the migration is complete, the following message appears.


    Master Server migration completed successfully.

    Note –

    The listener port numbers for the Postgres database, browser interface, and the Master Server are not migrated. The N1 Grid Service Provisioning System 5.0 Master Server uses the port numbers that you supplied during installation.


  14. Check the log file for any errors that might have occurred during migration.

    The migration script displays the location of the log file.

  15. Clear the cache on the browser that you use to access the Master Server browser interface.

    If you started a browser session before upgrading the Master Server, graphics and style sheets that are cached in the browser might prevent you from seeing the upgraded browser interface.

  16. Back up the data that you migrated to the new Master Server by using the instructions in Chapter 9, Backing Up and Restoring, in N1 Grid Service Provisioning System 5.0 System Administration Guide.

    You cannot restore data from the 4.1 Master Server to the 5.0 Master Server. Back up the data on the 5.0 Master Server so that you have a complete and accurate backup of the data to use if necessary.