Adding a LANforge Virtual Machine

Create a new guest instance.
1. When creating the guest, we should use 2 GB of RAM:
2. 20 GB of disk:
3. Omit a floppy drive, use a USB table as pointing device:
4. Allocate two or more cores and PAE/NX:
5. And the usual virtual processor features:
6. We don't need graphics on these nodes, so use minimum graphics memory:
7. Enable RDP access, that is useful. It might be a good habit to allocate separate RDP ports per host, we'll use 9134 for the first guest, 9135 for the second
8. Enable Host I/O caching for your SATA device. Specify the Fedora 27 Server ISO image as the DVD:
9. Disable Audio
10. Configure the network adapter to:
  1. Use the LAN bridged adapter br0
  2. Use a server adapter driver
  3. Enable Promiscuous Mode to allow sniffing
11. Start the installation
12. Under System Automatic partitioning should be adequate for general use.
  1. If you develop on these image (do lots of updates, install new kernels) reserve 1GB for /boot
13. Set the root password to lanforge. Click Done twice.
14. Add user LANforge:
  1. Make user lanforge an Administrator
  2. Set password to lanforge
  3. Click Done twice
15. When installation finishes, reboot. You will see a login prompt:
16. Login as root. Do updates:
```
[root@localhost]# dnf update -y
```
17. Install perl:
```
[root@localhost]# dnf install -y perl
```
18. Set guest's hostname:
```
[root@localhost]# hostnamectl --static set-hostname atlas-fedora27s01
```
19. Reboot:
```
[root@localhost]# shutdown -r now
```

Install LANforge on the guest instance. Start by logging in as root: screenshot

Use wget (or curl) to download lf_kinstall.txt:

[root@atlas-fedora27s01]# cd /root
[root@atlas-fedora27s01]# curl -o lf_kinstall.pl http://www.candelatech.com/lf_kinstall.txt
[root@atlas-fedora27s01]# chmod +x lf_kinstall.pl

You don't need to do a burn in, so toggle that off:

[root@atlas-fedora27s01]# touch /home/lanforge/did_cpuburn

Install LANforge:

[root@atlas-fedora27s01]# ./lf_kinstall.pl --lfver 5.3.7 --kver 4.13.16+ --do_all_ct

You can disable the VNC Server and Xrdp services on these guests:

[root@atlas-fedora27s01]# systemctl stop vncserver@\:1 xrdp.service
[root@atlas-fedora27s01]# systemctl disable vncserver@\:1 xrdp.service
[root@atlas-fedora27s01]# systemctl daemon-reload

You will notice that we have about 6GB of disk space left in this VM

When installation finishes, reboot:

[root@atlas-fedora27s01]# shutdown -r now

On next boot, you will see a LANforge kernel option, it should be automatically selected:

From your LANforge GUI, configure a MAC-VLAN the on default Ethernet port.
1. In the LANforge GUI, choose the Port Mgr tab, and highlight the new enp0s17 port:
2. Click the Create button
3. create one MAC-VLAN port
  1. Select MAC-VLAN
  2. Quantity: 1
  3. Select DHCP-IPv4
  4. Click Apply
4. You will see the new port in the GUI:
5. In the guest VM, you will also see the new port:
```
[root@localhost]# ip a show
```
Add a second VM
1. Shut down the previous VM:
```
[root@atlas-fedora27s01]# shutdown -r now
```
2. clone the VM
  1. Select the Reinitialize MAC addresses choice, these machine will operate simultaneously.
  2. Verify the MAC address of the new guest is set
  3. Boot the second guest
3. Change the hostname of the second guest:
```
[root@localhost]# hostnamectl --static set-hostname atlas-fedora27s02
```
4. Make sure that the MAC address of the second guest is not listed in the ifcfg-enp0s17 file.
  1. Compare the adapter to the file:
```
[root@localhost]# cd /etc/sysconfig/network-scripts
[root@localhost]# cat ifcfg-enp0s17
```
  2. If it is listed, change it or remove it.
5. LANforge changes the /etc/udev/rules.d/70-persistent-net.rules file, edit tht file those as to match the value of your mac address.
```
[root@localhost]# cd /etc/udev/rules.d
[root@localhost]# ip li show enp0s17
[root@localhost]# cat 70-persistent-net.rules
```
6. Stop LANforge and change the resource ID for this guest:
```
[root@localhost]# service lanforge stop
[root@localhost]# cd /home/lanforge
[root@localhost]# ./lfconfig
Your command: resource 5
Your command: config
```
7. Reboot the second guest:
```
[root@localhost]# shutdown -r now
```
8. Start up your first guest (resource 4)
9. In your LANforge GUI, you should see your two VMs.
10. Create a MAC-VLAN port for the second guest
Create a VOIP connection between the two guests.
1. In the VOIP tab, click Create
2. You configure:
  1. Side-A will be resource 3
  2. Side-B will be resource 4
  3. Click Apply
3. See the newly created connection:
4. In the VOIP/RPT tab, click Start
5. Monitor traffic on the connection with the Modify->View button

We review the configuration steps necessary to add a virtual LANforge resource. This was done using VirtualBox 5.2.10 and Fedora 27 Server edition. The guest instances will be configured to export MAC-VLAN ports to run traffic on their physical management port.

Adding a LANforge Virtual Machine

Goal: Add a virtual machine running LANforge to a LAN with a physical LANforge manager.