To migrate from an independent NFM-P system to the NSP

Purpose

Perform this procedure to transfer the nspOS functions of an independent NFM-P system to a greenfield NSP deployment in order to create a shared-mode NSP deployment.

Note: When you migrate from an independent NFM-P to a shared-mode NSP system, the NFM-P Service Supervision groups are transferred to the NSP. The transfer may take hours, depending on the number of services. During this time, you must not auto-create any Service Supervision groups. You can use the Find Ungrouped members count in the Group Manager application to help determine when the upload is complete, after which you can auto-create groups.

Note: Before you attempt an NSP migration, ensure that any third-party software installed on the NSP deployer host or any NSP cluster VM is disabled and stopped.

Note: release-ID in a file path has the following format:

R.r.p-rel.version

where

R.r.p is the NSP release, in the form MAJOR.minor.patch

version is a numeric value

Steps
Prepare for migration
 
1 

Perform Step 1 to Step 49 of To install the NSP to do the following.

  • Obtain the NSP software.

  • Create the NSP deployer host.

  • Create the NSP cluster VMs.

2 

Using the specifications in the response to your Nokia Platform Sizing Request, create a VM for each additional RPM-based NSP component.

3 

Perform the steps in the “To back up the main database from the client GUI” procedure in one of the following guides, depending on the installed NFM-P release:

  • Release 22.9 or earlier—NSP NFM-P Administrator Guide

  • Release 22.11 or later—NSP System Administrator Guide

4 

Transfer the following TLS files from the current PKI-server station to a secure location on a station that is unaffected by the migration activity:

Note: The PKI server address can be viewed using the samconfig utility on an NFM-P main server station.

  • ca.pem

  • ca.key

  • ca_internal.pem

  • ca_internal.key

5 

Perform Step 7 to Step 11 on each NSP cluster.

Note: In a DR deployment, you must perform the steps first on the NSP cluster that you want to be the primary cluster after the upgrade.

6 

Go to Step 12.

Deploy NSP clusters
 
7 

Perform Step 50 to Step 103 of To install the NSP to deploy the NSP Kubernetes cluster and configure the NSP deployment parameters.

Restore NSP databases
 
8 

Copy the following Neo4j and PostgreSQL database backup files created in Step 3 to an empty temporary directory on the NSP deployer host:

  • nspos-neo4j_backup_timestamp.tar.gz

  • nspos-postgresql_backup_timestamp.tar.gz

where timestamp is the backup creation time

9 

Perform “How do I restore the NSP cluster databases?” in the NSP System Administrator Guide to restore only the following databases on the NSP cluster:

Note: Performing the procedure also starts the NSP.

  • Neo4j database

  • PostgreSQL database

Transfer security artifacts to standby cluster
 
10 

If you are configuring the standby NSP cluster in a DR deployment, obtain the SSH, TLS, and telemetry artifacts from the NSP cluster in the primary data center.

  1. Open a console window on the NSP deployer host.

  2. Enter the following:

    # mkdir -p /opt/nsp/nsp-configurator/generated/ssh ↵

  3. Enter the following:

    # scp address:/opt/nsp/nsp-configurator/generated/ssh/* /opt/nsp/nsp-configurator/generated/ssh/ ↵

    where address is the address of the NSP deployer host in the primary cluster

  4. Enter the following:

    # scp -r address:/opt/nsp/NSP-CN-DEP-release-ID/NSP-CN-release-ID/tls/ca/* /opt/nsp/NSP-CN-DEP-release-ID/NSP-CN-release-ID/tls/ ↵

Set IGP topology data source
 
11 

In order for the IGP maps to function after the migration, you may need to change the IGP topology data source; see Configuring the IGP topology data source for information.

Reconfigure NFM-P
 
12 

Perform Step 1 to Step 17 of To add an independent NFM-P to an existing NSP deployment.

Synchronize system data
 
13 

Verify that the NFM-P main server is fully initialized.

Note: You must not advance to the next step until the server is fully initialized.

  1. Enter the following as the nsp user on the main server station.

    # cd /opt/nsp/nfmp/nms/bin ↵

  2. # ./nmsserver.bash -s nms_status ↵

    Output like the following is displayed:

    Network Functions Manager - Packet: Main Server Information

    -- Build Information

      -- NSP Version 23.11.MAIN.11098 - Built on Fri Nov 10 04:42:40 EST 2023

    -- System Information

      -- Host/IP: 135.121.101.164

    -- Server Information

      -- Server is a standalone system

      -- Server is server_state

      -- SSL Channel Disabled for OSS and GUI Clients

    The server is fully initialized if the following is displayed:

      -- Server is Up

    If the server is not fully initialized, wait five minutes and then repeat this step.

14 

Log in as the root user on the NSP deployer host in the primary data center.

15 

Enter the following:

# cd /opt/nsp/NSP-CN-DEP-release-ID/NSP-CN-release-ID/tools/database ↵

16 

Enter the following:

# ./nfmp-resync.sh ↵

The following time-stamped lines are displayed as the script synchronizes the NFM-P and NSP system data:

timestamp: Running with nsp-psa-restricted/nsp-platform-tomcat-pod_ID

timestamp: Resync triggered successfully

where pod_ID is an alphanumeric pod ID

Reconfigure NSP analytics servers
 
17 

If the system from which you are migrating includes one or more analytics servers, perform the following steps on each NSP analytics server station.

  1. Log in as the nsp user.

  2. Enter the following:

    bash$ cd /opt/nsp/analytics/bin ↵

  3. Enter the following to stop the server:

    bash$ ./AnalyticsAdmin.sh stop ↵

    The following and other messages are displayed:

    Stopping Analytics Application

    When the analytics server is completely stopped, the following is displayed:

    Analytics Application is not running

    Do not proceed to the next step until the server is completely stopped.

  4. Enter the following:

    bash$ ./AnalyticsAdmin.sh updateConfig ↵

    The script displays the following message and prompt:

    HIS ACTION UPDATES THE CONFIG FILE

    Please type 'YES' to continue

  5. Enter YES.

    The script displays the following, and the first in a series of prompts. At each prompt, you must enter a parameter value; to accept a default in brackets, press ↵.

    Config file found.

  6. Configure the following parameters as described below; see Table 14-2, NSP analytics server parameters for more information about a parameter.

    • Primary PostgreSQL Repository Database Host—standalone or primary NSP cluster VIP address

    • Secondary PostgreSQL Repository Database Host—standby NSP cluster VIP address; leave blank for a standalone NSP deployment

    • Zookeeper Connection String—the NSP cluster VIP addresses and ports, separated by a semicolon, for example:

      address_1:port;address_2:port

    • Use NFM-P-only mode—must be set to true

18 

Enter the following:

bash$ ./AnalyticsAdmin.sh start ↵

The analytics server starts.

Reconfigure WS-NOC
 
19 

If the deployment includes the WS-NOC, configure the WS-NOC to use the new nspOS instance by specifying the advertised address of the NSP cluster as the nspOS address.

End of steps