Upgrading from EVE-NG Community to EVE-NG Professional/Learning Center

 

Pre-requisites:

1. Upgrade to latest version of EVE Community Edition(v2.0.3-86). To check the current version installed issue the following command in the CLI of EVE:

dpkg -l eve-ng

2. Must have enough HDD space available. Main evg-root HDD must have at least 10Gb free while the boot HDD must have 50Mb. To check how much space is available on your HDD issue the following command in the CLI of EVE:

df -h

Tip: You can free up some HDD space by removing unnecessary packages from your installation. To clean up boot hdd, issue the following command in the CLI of EVE and confirm with “Y”:

apt-get autoremove

3. Ensure your installation of EVE has internet and DNS access. Test by issuing the following command in the CLI of EVE

ping www.google.com

Upgrade steps

1. To upgrade to EVE-NG Pro, issue the following commands in the CLI of EVE.

apt-get update

apt-get install eve-ng-pro

WARNING: Please be ready to purchase a license when upgrading, as you will not be able to run any nodes until a license is loaded.

2. Reboot EVE

3. Next install docker support by issuing the following command from the CLI of EVE

apt-get update

apt-get install eve-ng-dockers

4. Continue to the EVE-NG Pro license purchase section of the website and follow the remaining instructions.

 

Install new EVE Professionnal/Learning Center  from OVA

 

1. Download the EVE Pro OVA from our Download section.

2. Deploy it in VMware (Esxi, VMWare Workstation, VMware Player)

3. Be sure the host machine and the hypervisor of choice has Intel VT-X/EPT enabled. This step is necessary to install the Pro license and run QEMU nodes.

4. Set your preferred Network option, NAT/Bridged/VMNet

5. Start EVE VM

6. Login the first time with root/eve and follow the setup wizard to assign the required management settings.

7. Ensure EVE-NG is updated to the latest version available by issuing the following commands in the CLI of EVE.

apt-get update

apt-get upgrade

8. The OVA of EVE-NG, by default, has a very small HDD. It is recommended to add more HDD space if you plan on building large labs and storing lots of images. To add more space, if available on your host machine, shutdown your EVE-VM and add new second HDD.

shutdown -h now

Next, edit the Virtual Machine and add a new HDD. Size the HDD according to your needs. Once the VM is turned back on, EVE-NG will take care of expanding the drive automatically.

WARNING: Please do not try to re-size the existing HDD as this may corrupt your EVE-NG installation.

9. Continue to the EVE-NG Pro license purchase section of the website and follow the remaining instructions.

 

Install new EVE Professional/Learning Center from ISO

 

1. Download the EVE-NG Pro ISO from our Download section.

2. Create a new Virtual Machine on ESXi or VMware Workstation.

3. Set Typical/Standard VM option

4. Choose the “I will install Operating system later” option.

5. Guest operating system: Linux, Version Ubuntu 64-bit

6. Name your EVE Virtual Machine. Example: EVE-PRO

7. Optional: You can set preferred VM Location, depending on the available HDD space on the host.

8. Set the HDD size. It is recommended to plan the size of your HDD according to the size of your labs and the nodes contained within them.

9. Set option store as single HDD. ESXi option: HDD must be thick provisioned and eager zeroed

10. Customize VM Options:

   10.1. VM Workstation

 a) Set your preferred RAM

 b) Set your CPU settings. It is recommended to set the number of processors to the maximum available threads your host’s CPU offers. Enter only 1 for the number of cores per processor. (Example, a CPU with 8 threads available will be set for 8 processors and 1 core.)

 c) Enable CPU option Intel VT-x/EPT

 d) Edit CD-ROM, set option Use ISO image file and locate your EVE ISO on your PC

 e) Set your preferred Network Adapter (NAT/Bridged)

 f) Finish VM setup

   10.2. ESXi VM

 a) Set your preferred RAM

 b) Set your CPU settings. It is recommended to set the number of processors to the maximum available threads your host’s CPU offers. Enter only 1 for the number of cores per processor. (Example, a CPU with 8 threads available will be set for 8 processors and 1 core.)

 c) Enable CPU option: Expose hardware assisted virtualization to the guest OS

 d) Add/Edit CD-ROM, set option “Use ISO image file” and locate your EVE ISO on your Server

 e) Set your preferred Network Adapter (VMnet). WARNING: Your EVE-NG Pro VM should have all VMware Virtual Machine settings pre-planned and configured before purchasing a license. Please add extra VMnics to your EVE-NG pro VM if you intend to use more than one interface. We recommend adding additional VMnics if you are unsure. Adding them after purchasing a license can cause issues if the VMware hypervisor decides to automatically reorder the interfaces

 f) Finish VM setup

11. Start VM and follow Ubuntu install steps.

12. When Ubuntu install is finished, it will ask to remove install CD-ROM from VM, DON'T DO IT, after reboot it will continue the second setup stage and install EVE-PRO.

13. Login for the first time with root/eve and Follow IP setup wizard to complete management IP setup.

14. Finish upgrade to EVE-NG Pro, issue the following commands in the CLI of EVE.

apt-get update

apt-get install eve-ng-pro

15. Reboot EVE

16. Next install docker support by issuing the following command from the CLI of EVE

apt-get install eve-ng-dockers

17. Continue to the EVE-NG Pro license purchase section of the website and follow the remaining instructions

 

Rolling back to EVE-NG Community from EVE-Pro

 

1. To roll back from EVE-NG Pro to the Community Edition, issue the following commands in the CLI of EVE

  apt-get install eve-ng eve-ng-guacamole

  systemctl disable docker

  systemctl disable udhcpd

2. Reboot EVE

WARNING: Labs built with features that are only available in EVE PRO will be limited to the features offered in EVE Community. Multi-configuration sets for labs will be lost, as only the initial default configuration will remain upon completion of the roll back. Please backup all device configs before rolling back.