Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Upgrading to Junos Space Network Management Platform Release 16.1R1

    In Junos Space Network Management Platform Release 16.1R1, CentOS 6.8 is used as the underlying OS. As a direct upgrade of the OS from CentOS 5.9 to CentOS 6.8 is not supported, a direct upgrade to Junos Space Platform Release 16.1R1 by using the Junos Space Platform UI is also not supported. You must follow a multi-step procedure to upgrade to Junos Space Platform Release 16.1R1.

    Upgrading to Junos Space Platform Release 16.1R1 involves backing up data from the nodes in the Junos Space Platform setup, installing Junos Space Platform Release 16.1R1 on the nodes, and restoring backed up data to the nodes. After Junos Space Platform is upgraded, you can upgrade previously installed Junos Space applications.

    You can upgrade to Junos Space Platform Release 16.1R1 only from Junos Space Platform Release 15.2R2. To upgrade to Junos Space Platform Release 16.1R1 from releases earlier than Junos Space Platform Release 15.2R2, you must first upgrade to Junos Space Platform Release 15.2R2 and then follow the procedures specified in this topic.

    Note: For more information about upgrading to Junos Space Platform Release 15.2R2, see the Junos Space Network Management Platform Release 15.2R2 Release Notes.

    To upgrade from Junos Space Platform Release 15.2R2 to Junos Space Platform Release 16.1R1, complete the tasks in the sequence below. The Appendix provides sample data of time taken for backing up and restoring data while upgrading to Junos Space Platform Release 16.1R1.

    Downloading and Installing the Junos Space Platform 15.2R2 Patch

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

    To download and install the patch:

    1. Download the 15.2R2 patch to your local computer from the Junos Space 15.2R2 Backup Patch for Upgrade to 16.1R1 and 16.1R2 link at the following location:

      http://www.juniper.net/support/downloads/?p=space#sw

    2. Log in to the Junos Space active VIP node as the admin user.
    3. Transfer the patch to the Junos Space node by using Secure Copy Protocol (SCP).

      Save the file in a temporary location, such as /tmp/patch.

    4. Navigate to the location on the node where you stored the patch.
    5. (Optional) To verify the checksum for the downloaded file, type the following command and press Enter:

      md5sum -c md5.txt

      The messages displayed on the console indicate whether the downloaded file is validated.

    6. Extract the patch by using the following command:

      tar -xzvf 15.2R2.2-SpaceUpgradeBackup.tgz

    7. Type the following command and press Enter to install the patch:

      sh patchme.sh

      The messages displayed on the console indicate whether the patch is installed successfully.

    Executing the Data Back Up Procedure

    To back up Junos Space Platform and Junos Space Application data from the Junos Space nodes, execute the backup script provided in the 15.2R2 patch that you installed.

    The backup script backs up the required configuration files, data files, and the database dump files of the MySQL, PostgreSQL, and Cassandra databases from the Junos Space nodes. Data files of the installed Junos Space Applications are also backed up. The backup script generates a compressed tar file containing the backed up data.

    To run the backup script:

    1. If you have not done so, log in to the Junos Space active virtual IP (VIP) node as the admin user.
    2. Type the following command and press Enter to navigate to the /var/cache/space-backup-restore directory:

      cd /var/cache/space-backup-restore

    3. Type the following command and press Enter to run the backup script:

      sh backup.sh

      You are prompted to specify whether you want to clear system-related jobs from the Junos Space database.

    4. Perform one of the following actions based on whether you want to clear system-related jobs or not:
      • Type Y to clear system-related jobs.
      • Type N if you do not want to clear system-related jobs.

        If you choose not to clear system-related jobs, the jobs are not purged and are backed up by the backup script.

      You are prompted to specify whether you want to stop the services running on the node.

    5. Perform one of the following actions based on whether you want to continue backing up Junos Space data:
      • Type N to continue running the services on the node and to exit the backup process.

        Caution: If you exit the backup process, the backup file required for restoring data on the Junos Space Platform Release 16.1R1 setup is not generated.

      • Type Y to stop services running on the node and to continue the backup procedure.

        Note: If you have Junos Space Service Now installed, you are prompted to confirm whether you want to restore the same version of the Service Now image that is currently installed, after the Junos Space Platform upgrade. Select the required option and follow the prompts that appear on the console. For more information, see the Junos Space Service Automation Release 16.1R1 release notes.

        If you are taking a backup of Service Now Release 16.2R1 installed on Junos Space Platform Release 15.2R2, follow the procedure, Taking Back Up of Service Now Release 16.2R1 Data Before Upgrading Junos Space Platform to Release 16.1R1, provided in the Service Now Release 16.2R1 release notes.

        You are prompted to select the location to store the generated backup file.

        1.USB
        2.Remote SCP server
        Option to Select :
        
        
    6. Select one of the following options depending on where you want to store the backup file:
      • To store the file on a USB storage device:

        Note: Before you back up to the USB storage device, you must ensure that the USB device is plugged in and mounted to the path /tmp/pendrive.

        1. Type 1 and press Enter.

          You are prompted to specify whether you want to continue.

        2. Type Y to continue. The file is copied to the USB storage device.

          A message indicating that the file is successfully copied is displayed.

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

          umount /tmp/pendrive

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

      • To store the file on a remote SCP server:
        1. Type 2 and press Enter.

          You are prompted to specify whether you want to continue.

        2. Type Y to continue.

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

          Please enter remote machine IP:
          
        3. Type the IPv4 address of the remote SCP server and press Enter.

          You are prompted to enter the port number of the remote SCP server.

          Please enter remote machine port number:
          
        4. Type the port number of the remote SCP server and press Enter.

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

          Please enter remote machine user:
          
        5. Type the username and press Enter.

          You are prompted to enter the password of the user.

          Please enter remote machine user password:
          
        6. Type the password and press Enter.

          You are prompted to enter the full path of the directory on the remote SCP server where you want to store the backup file.

          Please enter remote dir path:
          
        7. Type the full path of the directory and press Enter.

          For example, /root/user/space_backup/

          Note: Ensure that there is no space character in the specified directory path. Also, ensure that the specified directory already exists on the remote SCP server. If the directory does not exist, you are prompted to enter a valid directory.

          The backup file is copied to the specified backup location.

    Validating the Backup File

    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 15.2R2 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 16.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:

        md5sum space-15.2R2.4.tgz

      4. Compare the generated MD5 value with the value in the md5.txt file stored at the same location as the backup file.

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

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

        tar -tf space-15.2R2.4.tgz

        You can verify the list of files displayed on the console.

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

      Note: Ensure that the USB storage device is plugged-in and mounted to the path /tmp/pendrive.

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

        md5sum /tmp/pendrive/space-15.2R2.4.tgz

      2. Compare the generated MD5 value with the value in the md5.txt file stored at the same location as the backup file.

        If the MD5 values are the same, the backup file is copied successfully to the backup location. If the MD5 values do not match, ensure that you 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:

        tar -tf /tmp/pendrive/space-15.2R2.4.tgz

        You can verify the list of files displayed on the console.

    Installing Junos Space Platform Release 16.1R1 on a Standalone Node or the First Node of the Fabric and Restoring the Backed-Up Data

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

    Caution:

    • If you are upgrading a standalone node, back up all data on the node to a remote server before you install the Junos Space Platform Release 16.1R1 software image. You cannot retrieve previously saved data after the Junos Space Platform Release 16.1R1 software image is installed.
    • In addition to executing the data backup procedure before installing Junos Space Platform Release 16.1R1, it is recommended that you back up the Junos Space databases (MySQL, Cassandra, and network monitoring data) by using the Database Backup action on the Junos Space Platform UI. For more information, see Backing Up and Restoring the Database Overview.
    • When you configure the Junos Space Platform Release 16.1R1 node, ensure that you use the same network configuration (network interfaces and IP adresses) as the Junos Space Platform Release 15.2R2 fabric. If you configure different network settings, device connectivity and SNMP traps are affected.
    1. Power off all the nodes of the fabric.

      Note: If you are upgrading a Junos Space Platform fabric with only Junos Space Virtual Appliances, ensure that you do not delete the powered off virtual appliances. If data restore on the Junos Space Platform Release 16.1R1 node fails, you can roll back to the Junos Space Platform Release 15.2R2 setup by powering off the Junos Space Platform Release 16.1R1 node and powering on the Junos Space Platform Release 15.2R2 nodes.

    2. Complete one of the following procedures:
      • If the Junos Space Platform fabric has only Junos Space Appliances (JA2500 or JA1500), power on one of the appliances that is part of the fabric and reimage it by following the procedure in 3.

        Caution: If you are upgrading a Junos Space Platform setup with a single Junos Space Appliance (JA2500 or JA1500), you must validate the backup file before you reimage the appliance with the Junos Space Platform Release 16.1R1 software image. If you do not ensure that the data backup from the Junos Space Platform Release 15.2R2 setup is complete before you reimage the appliance, the data is lost. For information about validating the backup file, see Validating the Backup File.

      • If the Junos Space Platform fabric has Junos Space Virtual Appliances, deploy a new Junos Space Platform Release 16.1R1 virtual appliance instance and configure it as a Junos Space node by following the procedure in 3.
    3. Install Junos Space Platform Release 16.1R1 and restore data by using one of the following procedures:

      Note: To ensure that you upgrade Junos Space Platform and not choose a fresh installation of Junos Space Platform Release 16.1R1, select the option to restore backed-up data when you are prompted during the configuration of the node.

      If the messages displayed on the console indicate that 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 virtual IP (VIP) address configured for Web access.

    4. (Optional) If the messages displayed on the console indicate that data is not restored successfully, you can roll back to the Junos Space Platform Release 15.2R2 setup. See Rolling Back to Junos Space Platform Release 15.2R2 if Upgrade Fails.
    5. If the Junos Space Platform Release 15.2R2 setup had Junos Space applications installed, after the data is restored successfully and the Junos Space Platform UI becomes accessible, you must upgrade the applications to releases that are compatible with Junos Space Platform Release 16.1R1 by using the Junos Space Platform UI.

      Note: After the upgrade to Junos Space Platform Release 16.1R1, the Junos Space applications that were installed prior to the upgrade, with the exception of Junos Space Service Now Releases 15.1R3, 15.1R4, and 16.1R1, appear disabled. For more information about upgrading an application, refer to the release notes of the Junos Space application that you want to upgrade.

      Before you install or upgrade an application, verify the DNS server configuration.

      To ensure that the DNS server is configured correctly:

      1. Log in to the Junos Space CLI.

        The Junos Space Settings Menu appears.

      2. On the Junos Space Settings Menu, to access shell, type one of the following:
        • 6, if the Junos Space Appliance is a JA1500 or JA2500 Junos Space hardware appliance
        • 7, if the Junos Space Appliance is a virtual appliance

        You are prompted to enter the administrator password.

      3. Enter the administrator password.
      4. Type the following command at the command prompt and press Enter:

        host -a localhost

        If the output of the command contains the following line, or if the output contains the IPv4 address as well as the IPv6 address, you must modify the DNS server configuration in Junos Space Platform:

        localhost. 86400 IN AAAA ::1

        To modify the DNS server configuration, go to step e, else, go to step f.

      5. To modify the DNS server configuration in Junos Space:
        1. Type the following command and press Enter to create a backup of the resolve.conf file:

          cp /etc/resolv.conf /etc/resolv.conf.orig

        2. Type the following command and press Enter to edit the resolve.conf file:

          vi /etc/resolv.conf

        3. Delete all entries in the file and save and close the file.
      6. Install or upgrade the required Junos Space applications from the Junos Space Platform UI.

        For more information, see the release notes of the Junos Space application that you want to install or upgrade.

      7. If you modified the DNS server configuration before installing or upgrading the applications, type the following command and press Enter to revert to the original configuration, after you have installed or upgraded all required applications:

        cp /etc/resolv.conf.orig /etc/resolv.conf

    6. After you have verified that the data is restored successfully, if the node you upgraded is the first node of a Junos Space fabric, install the Junos Space Platform Release 16.1R1 software image on the remaining nodes of the fabric. See Installing Junos Space Platform Release 16.1R1 on the Remaining Nodes of the Fabric.

    Rolling Back to Junos Space Platform Release 15.2R2 if Upgrade Fails

    While upgrading to Junos Space Platform Release 16.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 15.2R2.

    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:
      2. Download and apply the Junos Space Platform Release 15.2R2 patch. See Downloading and Installing the Junos Space Platform 15.2R2 Patch to install the patch.
      3. Install the same Junos Space applications that were installed on the Junos Space Platform Release 15.2R2 setup that you attempted to upgrade.
      4. Type the following command and press Enter to navigate to the /var/cache/space-backup-restore directory:

        cd /var/cache/space-backup-restore

      5. Type the following command and press Enter to restore the backup:

        sh restore-15.2r2.sh

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

        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.

            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.

              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.

                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.

                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.

                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.

                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 have any space character.

                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 and mounted to the path /tmp/pendrive.

          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:

            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.

            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 15.2R2 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 (JA2500 or JA1500) 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 15.2R2 installation.
      3. Delete the first node (on which upgrade failed) from the cluster, by using the Junos Space Platform UI. 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 15.2R2 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 UI. For information about adding nodes to the Junos Space fabric, see Adding a Node to an Existing Junos Space Fabric.

    Installing Junos Space Platform Release 16.1R1 on the Remaining Nodes of the Fabric

    In the case of a Junos Space fabric with two or more nodes, after you configure the first node, you can install the Junos Space Platform Release 16.1R1 software image on the remaining nodes and configure them as Junos Space nodes or Fault Monitoring and Performance Monitoring (FMPM) nodes, by using one of the following procedures:

    Note: After you configure the nodes from the Junos Space Platform CLI, you can add the nodes to the Junos Space fabric as JBoss nodes, dedicated database nodes, dedicated Cassandra nodes or FMPM nodes, by using the Junos Space Platform UI. For information about adding nodes to the Junos Space fabric, see Adding a Node to an Existing Junos Space Fabric.

    Configuring Device Communication

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

    To configure device communication:

    1. On the Junos Space Platform UI, select Administration > Applications.

      The Applications page is displayed.

    2. Click Network Management Platform and select Modify Application Settings from the Actions menu. Alternatively, right-click Network Management Platform and select Modify Application Settings.

      The Modify Application Settings (Modify Network Management Platform Settings) page is displayed and the Device section is selected by default.

    3. Select the Allow Device Communication check box.
    4. Click Modify to modify the settings.

    Devices discovered in Junos Space Platform can now communicate with the Junos Space server.

    Appendix: Sample Data of Time Taken for Backup and Restore While Upgrading to Junos Space Platform Release 16.1R1

    In Table 1, you can view data gathered from test setups, which show the approximate time taken for data backup and restore while upgrading to Junos Space Platform Release 16.1R1.

    Table 1: Sample Data Showing Approximate Time Taken for Backup and Restore

    Database

    CPU

    CPU Speed MHz

    RAM
    (GB)

    Disk
    (GB)

    Applications Installed

    Backup Size
    (GB)

    Backup Duration
    (HH:MM:SS)

    Restore Duration
    (HH:MM:SS)

    Database1

    4

    2500

    32

    140

    Security Director, Service Now

    5

    0:23:34

    0:44:14

    Database2

    4

    2500

    32

    140

    Service Now

    15

    0:53:45

    1:35:40

    Database3

    4

    2500

    32

    140

    Service Now

    3

    0:21:27

    0:19:41

    Database4

    4

    2500

    32

    140

    Security Director

    2.6

    0:27:00

    0:22:56

    Database5

    4

    2500

    32

    140

    ICEAA

    11

    0:36:09

    0:48:58

    Database6

    4

    2500

    32

    140

    None

    2.7

    0:24:00

    1:04:54

    Modified: 2017-03-20