The Master Server application is not upgraded like most software is upgraded. Rather, the new version of the Master Server is installed on the same server as the previous version of the Master Server. Then, the data is migrated from the previous version of the Master Server to the new version of the Master Server. The upgrade procedure you complete depends on whether you are running the 4.1 Master Server on an operating system version that is supported by the N1 Grid Service Provisioning System 5.0.
If you are running the Master Server on Red Hat Linux 7.2, 7.3, or 8.0, which are not supported by the N1 Grid Service Provisioning System 5.0, follow the instructions in How to Upgrade a Master Server From an Operating System That Is No Longer Supported.
If you are running the Master Server on any other operating system, follow the instructions in How to Migrate Master Server Data From Supported Operating Systems.
Migrating data from the 4.1 version of the Master Server to the 5.0 version of the Master Server deletes any data in the 5.0 version of the Master Server. The migration script stops both versions of the Master Server until the script completes the migration. The Master Servers will be unavailable for the duration of the migration.
Verify that the operating system version on the server you want to upgrade is supported by the N1 Grid Service Provisioning System 5.0. For a list of supported operating systems, see Supported Operating Systems. If the operating system version is no longer supported, follow the instructions in How to Upgrade a Master Server From an Operating System That Is No Longer Supported.
Back up your data before you migrate. See Chapter 9, Backing Up and Restoring, in N1 Grid Service Provisioning System 5.0 System Administration Guide.
Log into the machine as the user who installed the 4.1 version of the Master Server.
Install the 5.0 version of the Master Server on the same server where the 4.1 version of the Master Server is installed.
If you are running the Solaris OS or Red Hat Linux follow the instructions in How to Install the N1 Grid Service Provisioning System 5.0 on Solaris OS, Red Hat Linux, and IBM AIX Systems to install the N1 Grid Service Provisioning System 5.0 Master Server.
If you are running Windows, complete the following steps.
Stop the 4.1 Master Server by using the Service application in the Windows Administrative Tools to stop the IPC Daemon service.
Set the 4.1 Master Services to start manually, specifically the IPC Daemon and Server.
Install the 5.0 version of the Master Server by following the instructions in How to Install the N1 Grid Service Provisioning System 5.0 Master Server on Windows.
Install the 5.0 version of the Master Server with ownership by the same user and group that owns the 4.1 version of the Master Server.
For Solaris OS and Red Hat Linux Master Servers, 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.
Access a command prompt.
On Solaris OS or Red Hat Linux servers, open a shell window and log in as the user that owns the Master Server.
On Windows, open a Command Prompt window.
Change to the directory that contains the migration script.
On Solaris OS or Red Hat Linux servers, type:
% cd /N1SPS5.0-home/server/bin/migrate |
N1SPS5.0-home is the directory where you installed the Master Server.
On Windows, type:
C:\> cd C:\N1SPS5.0-home\server\bin\migrate |
C:\N1SPS5.0-home is the directory in which you installed the Master Server.
Start the migration script.
On Solaris OS or Red Hat Linux servers, type:
% ./migrateMS_4.1-5.0.sh |
On Windows, type:
C:\N1SPS5.0-home\5.0\server\bin\migrate\>.\migrateMS_4.1-5.0.cmd |
Follow the instructions on the screen to complete the migration.
When the migration is complete, the following message appears.
Master Server migration completed successfully. |
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.
Check the log file for any errors that might have occurred during migration.
The migration script displays the location of the log file.
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.
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.
(Optional) Uninstall the 4.1 version of the Master Server.
You can uninstall the 4.1 version of the Master Server if you do not want to use it by following the instructions in Chapter 10, Uninstalling the N1 Grid Service Provisioning System 5.0.
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.
Log into the machine as the user who installed the 4.1 version of the Master Server.
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.
Access a command prompt.
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.
Change to the directory on the software CD or within the downloaded image where the migration script is located.
% cd /migrate |
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.
Change to the directory on 4.1 Master Server that contains the migration script that you copied.
% cd /N1SPS4.1-home/server/bin |
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.
Follow the instructions on the screen to complete the creation of the file.
Install the 5.0 version of the Master Server.
If you are installing the 5.0 Master Server on a new server, follow these steps:
Install the 5.0 Master Server by following the steps in Chapter 4, Installing the N1 Grid Service Provisioning System 5.0 on Solaris OS, Red Hat Linux, and IBM AIX Systems.
Copy the archive file that you created in the previous step to the new server.
If you want to install the 5.0 Master Server on the same server as the 4.1 Master Server, follow these steps:
Copy the archive file that you created in the previous steps to another directory on the server.
Uninstall the 4.1 Master Server.
Upgrade the server to an operating system version that is supported by the N1 Grid Service Provisioning System 5.0. For a list, see Supported Operating Systems.
Install the 5.0 Master Server by following the steps in Chapter 4, Installing the N1 Grid Service Provisioning System 5.0 on Solaris OS, Red Hat Linux, and IBM AIX Systems .
Change to the directory that contains the migration script.
% cd /N1SPS5.0-home/server/bin/migrate |
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.
Follow the instructions on the screen to complete the migration.
When the migration is complete, the following message appears.
Master Server migration completed successfully. |
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.
Check the log file for any errors that might have occurred during migration.
The migration script displays the location of the log file.
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.
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.
This section describes details about the data that is migrated from the previous version of the Master Server to the new version of the Master Server.
The following table details the types of data that are migrated on the Master Server.
Table 9–1 Migration Overview
Data on the Master Server |
Is the Data Migrated? |
Mechanism for Migration |
---|---|---|
PostgresSQL data |
Yes |
SQL scripts |
CLI Client script for changes to existing commands |
No | |
Migration of objects serialized through CLI Client |
No | |
Migration of changes to the config.properties file on each host |
Yes |
Properties listed in the file are migrated using the details found in Migration Details for the Properties File. |
Resource migration |
Yes |
Copy the resources directory. |
Logger Configuration file |
No | |
User interface customizations |
No |
The 4.1 config.properties file is migrated to the 5.0 config.properties file. During the migration, the value of each property in the 4.1 file is compared to the value of the property in the 5.0 config.properties file. If the value is the same, the property is ignored. If the value is different, then the 4.1 value is copied to the 5.0 config.properties file. If a property exists in the 4.1 file and is absent in the 5.0 file, then the 4.1 value is added to the 5.0 file. Values for the following properties are not migrated to the 5.0 config.properties file:
webserver.TomcatHome
rsrc.localrepo
db.port
hostdb.ms.ipaddress
hostdb.ms.port
note.mailsubject
net.server.nconn
net.server.type.1
net.server.ip.1
net.server.port.1
net.server.parms.1
note.url
pe.defaultUserToRunAs
hostdb.ms.connectiontype
pe.maxSimulPlans
If you have changed the values for any of these properties in the 4.1 properties file, you need to manually change the value in the 5.0 config.properties file.