Upgrading to Junos Space Network Management Platform Release 21.1R1

In Junos Space Network Management release 20.3R1 and before, the Junos Space database(DB) backup restore with Unicast mode of communication is restored in the setup which is visible in domain.xml file.

Since Junos Space Network Management 21.1R1 release includes CentOs upgrade, the DB backup from Junos Space Network Management release 20.3R1 with Unicast mode of communication is not restored. You need to reconfigure the data in Junos Space Network Management 21.1R1 release.

Table 1 shows various physical and network elements that are needed in order to perform this upgrade procedure.

Before taking backup from the Junos Space Network Management Platform Release 20.3R1, disable device communication to ensure that the discovered devices stop communicating with the Junos Space Server.

To disable device communication:

Before you begin upgrading Junos Space Platform Release 20.3R1 to Junos Space Platform Release 21.1R1, download and install the Junos Space Platform Release 20.3R1 patch from the link Junos Space 20.3R1 Backup Patch for Upgrade to 21.1R1 on the Junos Space Network Management Platform – Download Software page for Version 21.1R1.

To download and install the patch:

To run the backup script:

After executing the data backup procedure, we recommend that you validate the checksum for the backup file to ensure that the data from the Junos Space Platform Release 20.3R1 setup is copied to the selected backup location. This ensures that data from the Junos Space nodes is not lost and can be restored on the Junos Space Platform Release 21.1R1 setup when you upgrade.

To validate the backup file, complete one of the following procedures:

• To validate the backup file stored on a remote SCP server:

  1. Log in to the remote SCP server.

  2. Navigate to the directory where the backup file is stored.

  3. Type the following command and press Enter to generate the MD5 value for the backup file:

     [user@scp-server]> md5sum space-backup.tgz

     Note:

     On some systems, there is no md5sum command. On these systems, the md5 <file name> command should print the md5 hash value.

  4. Compare the calculated MD5 value with the value in the md5.txt file stored at the same location as the backup file. You can see the value stored in md5.txt using the following command:

     [user@scp-server]> cat md5.txt

     If the MD5 values are the same, the backup file is copied successfully to the backup location. If the MD5 values do not match, repeat the back up procedure detailed in Executing the Data Back Up Procedure.

  5. You can verify the integrity of the backup tar file to ensure that errors did not result in a corrupt backup file. To do this, type the following command and press Enter to verify the files in the backup tar file:

     [user@scp-server]> tar -tf space-backup.tgz

     The list of files contained in the tar file are displayed. If there are errors in the tar file, the error is displayed and the file listing stops.

• To validate the backup file stored on a USB storage device:

  Note:

  Ensure that the USB storage device is plugged-in to the Junos Space Appliance and mounted to the path /tmp/pendrive.

  1. Type the following command and press Enter to generate the MD5 value for the backup file:

     [root@space-20.3R1-node ~]# md5sum /tmp/pendrive/space-backup.tgz

  2. Compare the calculated MD5 value with the value in the md5.txt file stored at the same location as the backup file. You can see the value stored in md5.txt using the following command:

     [root@space-20.3R1-node]# cat md5.txt]

     If the MD5 values are the same, the backup file is copied successfully to the backup location. If the MD5 values do not match, repeat the back up procedure detailed in Executing the Data Back Up Procedure.

  3. Type the following command and press Enter to verify the files in the backup tar file:

     [root@space-20.3R1-node]# tar -tf /tmp/pendrive/space-20.3R1.4.tgz

     The list of files contained in the tar file are displayed. If there are errors in the tar file, the error is displayed and the file listing stops.

After you run the backup script and back up data from the Junos Space nodes, install the Junos Space Platform Release 21.1R1 software image, using the following procedure:

While upgrading to Junos Space Platform Release 21.1R1, if you are unable to restore the data backed up before you began upgrading Junos Space Platform, you can roll back to Junos Space Platform Release 20.3R1.

If data restore fails, complete one of the following procedures:

• If the Junos Space node is a standalone node:

  1. Complete one of the following procedures:

     • For a Junos Space Appliance , reimage the node to install the Junos Space Platform Release 20.3R1 software image, by using one of the following procedures:

     • For a Junos Space Virtual Appliance, roll back to the Junos Space Platform Release 20.3R1 setup by powering off the Junos Space Platform Release 21.1R1 node and powering on the Junos Space Platform Release 20.3R1 node.

       The roll back of the Junos Space Virtual Appliance to Release 20.3R1 is complete.

  2. Download and apply the Junos Space Platform Release 20.3R1 patch. See Downloading and Installing the Junos Space Platform 20.3R1 Patch to install the patch.

  3. Install the same Junos Space applications that were installed on the Junos Space Platform Release 20.3R1setup that you attempted to upgrade.

  4. Type the following command to navigate to the /var/cache/space-backup-restore directory:

     [root@space-20.3R1-node ~]# cd /var/cache/space-backup-restore

  5. Type the following command to restore the backup:

     [root@space-20.3R1-node /var/cache/space-backup-restore]# sh restore-20.3R1.sh

     You are prompted to specify the location from where you want to restore the backup.

     content_copy zoom_out_map

     1> Remote Server
     2> USB
     3> Local
     
     M> Return to Main Menu
     R> Redraw Menu
     
     Choice [1-3 MR]: 

  6. Select one of the following options depending on where the backup file is stored:

     • To restore from a remote Secure Copy Protocol (SCP) server:

       1. Type 1 and press Enter.

          You are prompted to confirm whether you want to continue.

          content_copy zoom_out_map

          You have selected [ Remote Server ]. Do you want to Continue? [Y/N]

       2. Based on whether you want to continue or exit, perform one of the following actions:

          • Type Y.

            You are prompted to enter the IPv4 address of the remote SCP server.

            content_copy zoom_out_map

            Please enter Remote Server IP:
            

            1. Type the IPv4 address of the remote SCP server and press Enter.

               You are prompted to enter the port number for the remote server.

               content_copy zoom_out_map

               Please enter port number for Remote Server REMOTE_SERVER_IP:
               

            2. Type the port number of the remote SCP server and press Enter.

               You are prompted to enter the username to access the remote server.

               content_copy zoom_out_map

               Please enter Remote Server REMOTE_SERVER_IP user:
               

            3. Type the username and press Enter.

               You are prompted to enter the password of the user.

               content_copy zoom_out_map

               Please enter Remote Server user REMOTE_SERVER_USER password:
               

            4. Type the password and press Enter.

               You are prompted to enter the full path of the directory where the backup file is stored.

               content_copy zoom_out_map

               Enter the path of the directory containing backup files:
               

            5. Type the full path of the directory and press Enter.

               Note:

               Ensure that the directory path does not contain any space characters.

               The messages displayed on the console indicate whether the data is restored successfully to the Junos Space node.

          • Type N to exit.

     • To restore from a USB storage device:

       Note:

       • Before you restore from a USB storage device, ensure that the USB device is plugged in. The restore procedure will try to mount the device to the path /tmp/pendrive.

       • For data backup and restore, identify the USB storage device using the fdisk -l command and format the device using the mkfs.ext2 <physical device> command. For example, mkfs.ext2 /dev/sdb. This ensures that the USB device has the correct disk layout for the execution of the backup and restore procedures and prevents loss of data.

       1. Type 2 and press Enter to restore the backup from the USB storage device.

          The messages displayed on the console indicate whether the data is restored successfully to the Junos Space node.

       2. Unmount the USB storage device by typing the following command:

          [root@space-20.3R1-node /var/cache/space-backup-restore]# umount /tmp/pendrive

          You can unplug the USB storage device after you unmount it.

     • To restore data from the backup file stored on the Junos Space node:

       Note:

       To restore data from the backup file stored on the Junos Space node, you must first copy the file from the backup location to the Junos Space node.

       1. Type 3 and press Enter.

          You are prompted to enter the full path of the directory where the backup file is stored.

          content_copy zoom_out_map

          Enter the tar file path to restore from local:

       2. Type the full path of the directory and press Enter.

          The messages displayed on the node indicate whether the data is restored successfully to the Junos Space node.

     If the messages displayed on the console indicate that the data is restored successfully and JBoss services are started on the node, you can access the Junos Space Platform UI through a browser by using the VIP address configured for Web access. You can now use this Junos Space Platform Release 20.3R1 installation.

     If the restore fails, save the troubleshooting log file, /var/log/restoreStatus.log to your computer; power off the node; and contact Juniper Networks support for assistance.

• If the node is a Junos Space Appliance and the first node of a Junos Space fabric, complete the following procedure:

  1. Power off the node.

  2. Power on the remaining nodes of the cluster, to bring up the cluster with the Junos Space Platform Release 20.3R1 installation.

  3. Delete the first node (on which upgrade failed) from the cluster, using the Junos Space Platform GUI. For more information about deleting the node, see Deleting a Node from the Junos Space Fabric.

  4. Power on and reimage the node that you attempted to upgrade, to install the Junos Space Platform Release 20.3R1 software image. To reimage the node, follow one of the procedures listed in 1.

  5. Add the node to the fabric by using the Junos Space Platform GUI. For information about adding nodes to the Junos Space fabric, see Adding a Node to an Existing Junos Space Fabric.

When you upgrade from Junos Space Platform Release 20.3R1 to Junos Space Platform Release 21.1R1, if you have dedicated database nodes or Fault Monitoring and Performance Monitoring (FMPM) nodes configured for the Junos Space Platform setup that you are upgrading, after the upgrade and data restoration on the first node of the Junos Space fabric is complete, you must add the dedicated database nodes and FMPM nodes to the fabric by using the Junos Space Platform GUI. You can configure the nodes as Junos Space nodes or Fault Monitoring and Performance Monitoring (FMPM) nodes, by using one of the following procedures:

• To install and configure the Junos Space Platform Release 21.1R1 software image on a Junos Space Virtual Appliance, see the Deploying the Junos Space Virtual Appliance, Configuring a Junos Space Virtual Appliance as a Junos Space Node and Configuring a Junos Space Virtual Appliance as a Standalone or Primary FMPM Node topics in the Junos Space Virtual Appliance Installation and Configuration Guide.

After you upgrade to the Junos Space Platform Release 21.1R1, you must configure device communication to ensure that discovered devices can communicate with the Junos Space server.

To configure device communication:

If you have disaster recovery configured for the Junos Space Platform Release 20.3R1 setup that you are upgrading, you must upgrade both the active and standby sites to Junos Space Platform Release 21.1R1 as explained in this topic and then reconfigure disaster recovery. For information about configuring disaster recovery, see Configuring the Disaster Recovery Process Between an Active and a Standby Site.