Description

NorthStar is installed in a single Virtual Machine, where JunosVM is nested in the NorthStar VM as depicted in  Installation Options . The requirement is to update Junos in JunosVM that is installed with NorthStar Controller. This article instructs users on how to upgrade JunosVM.

Solution

To upgrade JunosVM, first log in to the Software Download page and go to the Virtual Route Reflector page. Copy the URL link for the vmdk image that you want to upgrade to.

Download the vmdk image of the vRR that you want to upgrade to.

  1. From the shell of your NorthStar server, download the vmdk image from the URL above via wget: 

[root@jtac-rhel69 ~]# wget -O /opt/northstar/junos-x86-64-18.4R3.3.vmdk "https://cdn.juniper.net/software/vrr/18.4R3.3/junos-x86-64-18.4R3.3.vmdk?SM_USER=user&__gda__=1617838854_efdd3f319eb5b6f11f2aa8148baeacd5"

  1. After the download, you will need to convert the vmdk image to the qcow2 file format. You may need to download qemu-img if it is not already installed on your server. You can do this by using the following: 

yum install qemu-img

  1. After this is installed, convert the vmdk image to qcow2: 

[root@jtac-rhel69 northstar]# qemu-img convert -p -f vmdk -O qcow2 junos-x86-64-18.4R3.3.vmdk junos-x86-64-18.4R3.3.qcow2
    (100.00/100%)
[root@jtac-rhel69 northstar]#

Back Up your JunosVM Configuration.

Back up your existing JunosVM configuration. You can do this by running /opt/northstar/utils/net_setup.py , and then selecting D (Maintenance & Troubleshooting), followed by option 1 (Backup JunosVM Configuration). 

Main Menu:
    ...................................................
    A.) Host Setting
    ...................................................
    B.) JunosVM Setting
    ...................................................
    C.) Check Network Setting
    ...................................................
    D.) Maintenance & Troubleshooting
    ...................................................
    E.) HA Setting
    ...................................................
    F.) Collect Trace/Log
    ...................................................
    G.) Analytics Data Collector Setting
        (External standalone/cluster analytics server)
    ...................................................
    H.) Setup SSH Key for external JunosVM setup
    ...................................................
    I.) Internal Analytics Setting (HA)
    ...................................................
    X.) Exit
    ...................................................

Please select a letter to execute.

D


Maintenance & Troubleshooting:
   ..................................................
   1.) Backup JunosVM Configuration
   2.) Restore JunosVM Configuration
   3.) Change UI Admin Password
   4.) Change Database Password
   5.) Change MQ Password
   6.) Change Host Root Password
   7.) Change JunosVM root and northstar User Password
   8.) Initialize all credentials (3,4,5,6,7 included)
       This option will restart NorthStar services
   ..................................................

Please select a number to modify.
[<CR>=return to main menu]:
1
Backup JunosVM Configuration
Are you sure you want to backup JunosVM configuration? (Y/N) Y

Connecting to JunosVM to backup the config ...

Checking md5 sum. Login to JunosVM
Please check the result at /opt/northstar/data/junosvm/junosvm.conf
JunosVm configuration has been successfully backed up

After the upgrade, if needed, you can restore from this backup configuration.

Upgrade JunosVM.

  1. Replace the existing /opt/northstar/data/junosvm/northstar_junosvm.qcow2.run with the qcow2 that you just converted. 

[root@jtac-rhel69 northstar]# cp junos-x86-64-18.4R3.3.qcow2 /opt/northstar/data/junosvm/northstar_junosvm.qcow2.run
cp: overwrite `/opt/northstar/data/junosvm/northstar_junosvm.qcow2.run'? y
[root@jtac-rhel69 northstar]#

  1. Restart the junos:junosvm service. 

[root@jtac-rhel69 northstar]# supervisorctl restart junos:junosvm
junos:junosvm: stopped
junos:junosvm: started
[root@jtac-rhel69 northstar]#

It could take about 10-15 minutes for JunosVM to finish booting on the new Junos OS image. You can monitor progress in the log file /opt/northstar/logs/junosvm_telnet.log .  You can additionally send pings to 172.16.16.2. When you get the ping responses, JunosVM should be up and running.