EVE-PRO Upgrade from v4.x to v5.x

NOTE: How to pages contain long CLI commands with slider which are not visible using Edge or Chrome browsers. Please use Firefox browser!

1. EVE Pro or EVE LC upgrade from version 4.x to version 5.x

Steps how to upgrade your EVE-NG Professional or EVE-NG Learning centre edition version 4.x to version 5.x
RED RULE: DO NOT upgrade your Ubuntu version even it is offered on CLI, EVE-NG OS version is 20.04. Upgrade to the newer Ubuntu will fail all your EVE !

Pre-rquisities:

IMPORTANT NOTE: No custom repositories or any other addons are allowed to be in your EVE-NG repositories list. It will cause of upgrade failure.

  • Internet reachability from your EVE is a must!
  • DNS must resolve Internet names!
  • Only official Eve repositories, no 3rd party repositories of any kind allowed.
  • All labs on the EVE must be stopped

 WARNING !!! Google cloud EVE Pro users, please install new EVE VM, Upgrade is not suitable for cloud VM.

Strong recommendation !!! Make backup all of your labs

cd /opt/unetlab ;  tar -czvf /root/labs-backup.tgz labs

PHASE 1, Pre-stage your EVE Pro to the latest version 4.0.1-86. Even you already have version 4.0.1-86, please complete steps of Phase 1.

IMPORTANT NOTE: No custom repositories or any other addons are allowed to be in your EVE-NG repositories list. It will cause of upgrade failure.

Update/Upgrade steps

1. Free up your EVE Pro from older packages:

apt autoremove

2. make sure you have free space on EVE HDD, to check issue command. vg-root and /boot should not be in 100% or close to that.

df -h

3. Verify DNS, example, ping www.google.com, if success, follow step 4. If ping is not success, check your DNS IP assigned for EVE. Some of networks can be protected and disabled outgoing ping, make sure that your DNS is right and you are able reach internet and resolve names.

4. Execute command

apt update

5. Execute command, when it prompt to confirm, answer “Y”

apt upgrade

6. Execute command, when it prompt to confirm, answer “Y”

apt dist-upgrade

NOTE: Making upgrade from older 4.0.x EVE Pro version, installation can ask to confirm some of installation steps:

Answer for screenshot above, N

7. IMPORTANT: Reboot EVE

reboot

PHASE 2, upgrade your EVE Pro to version 5.0.1-X

IMPORTANT NOTE: No custom repositories or any other addons are allowed to be in your EVE-NG repositories list. It will cause of upgrade failure.

Upgrade steps

1.  SSH to your EVE as root

2. Run command, if you do not see full command in the slider, use Firefox browser.

wget https://www.eve-ng.net/focal/update-eve-pro.sh -O /tmp/upgrade.sh && chmod +x /tmp/upgrade.sh && /tmp/upgrade.sh

3. If you did Phase 1 properly after command above you will get prompt: to start upgrade process?  Answer yes

4. Reboot your EVE (The script will ask you hit enter to reboot)

Please enter to reboot

IMPORTANT: Clear your browser chache and cookies

2. EVE Pro Cluster upgrade from version 4.x to version 5.x

Steps how to upgrade your EVE-NG Professional or EVE-NG Learning centre edition version 4.x to version 5.x
Pre-rquisities For all cluster Members (Master and Satellite):

IMPORTANT NOTE: No custom repositories or any other addons are allowed to be in your EVE-NG repositories list. It will cause of upgrade failure.

  • Internet reachability from your EVE is a must!
  • DNS must resolve Internet names!
  • Only official Eve repositories, no 3rd party repositories of any kind allowed.
  • All labs on the EVE must be stopped

Strong recommendation !!! Make backup all of your labs, Master server only

cd /opt/unetlab ;  tar -czvf /root/labs-backup.tgz labs

PHASE 1, Pre-stage your EVE Pro Master and Satellites

It is recommended to start upgrade from Master Server

IMPORTANT NOTE: No custom repositories or any other addons are allowed to be in your EVE-NG repositories list. It will cause of upgrade failure.

Update/Upgrade steps for Master and Satellite Servers

1. Free up your EVE Pro from older packages:

apt autoremove

2. Make sure you have free space on EVE HDD, to check issue command. vg-root and /boot should not be in 100% or close to that.

df -h

3. Verify DNS, example, ping www.google.com, if success, follow step 4. If ping is not success, check your DNS IP assigned for EVE. Some of networks can be protected and disabled outgoing ping, make sure that your DNS is right and you are able reach internet and resolve names.

4. Execute command

apt update

5. Execute command, when it prompt to confirm, answer “Y”

apt upgrade

6. Execute command, when it prompt to confirm, answer “Y”

apt dist-upgrade

NOTE: Making upgrade from older 4.0.x EVE Pro version, installation can ask to confirm some of installation steps:

Answer for screenshot above, N

7. IMPORTANT: Reboot EVE

reboot

8. SSH to your Master server and to the Satellite servers

Check the installed version:

For Master Server

root@eve-ng-master:~# dpkg -l eve-ng-pro
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
||/ Name           Version      Architecture Description
+++-==============-============-============-==============================================
ii  eve-ng-pro     4.0.1-86     amd64        A new generation software for networking labs.
root@eve-ng-master:~#

For Satellite Server

root@eve-sat01:~# dpkg -l eve-agent
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
||/ Name                    Version          Architecture     Description
+++-=======================-================-================-===================================================
ii  eve-agent               4.0.1-86         amd64            Agent for EVE-NG Sat Cluster member
root@eve-sat01:~#

 

PHASE 2, upgrade your EVE Pro Cluster to version 5.0.1-X

Upgrade steps Master Server

IMPORTANT NOTE: No custom repositories or any other addons are allowed to be in your EVE-NG repositories list. It will cause of upgrade failure.

1.  SSH to your EVE master as root

2. Run command, if you do not see full command in the slider, use Firefox browser.

wget https://www.eve-ng.net/focal/update-eve-pro.sh -O /tmp/upgrade.sh && chmod +x /tmp/upgrade.sh && /tmp/upgrade.sh

3. If you did Phase 1 properly after command above you will get prompt: to start upgrade process?  Answer yes

4. Reboot your EVE Master (The script will ask you hit enter to reboot)

Please enter to reboot

 

Upgrade steps Satellite Server

IMPORTANT NOTE: No custom repositories or any other addons are allowed to be in your EVE-NG repositories list. It will cause of upgrade failure.

1.  SSH to your EVE Satellite as root

2. Run command, if you do not see full command in the slider, use Firefox browser.

wget https://www.eve-ng.net/focal/update-sat-pro.sh -O /tmp/upgrade.sh && chmod +x /tmp/upgrade.sh && /tmp/upgrade.sh

3. If you did Phase 1 properly after command above you will get prompt: to start upgrade process?  Answer yes

4. Reboot your EVE Satellite (The script will ask you hit enter to reboot)

Please enter to reboot

IMPORTANT: Clear your browser chache and cookies