Configure LANforge for Auxiliary Management.

1. Connect LANforge systems through the normal management LAN for initial configuration. The resources should be visible in the management tab

2. In this case, we are using wiphy0 for the Aux-Mgt interfaces. On the manager system, configure wiphy0 to be on the desired channel, create a virtual AP on wiphy0, and configure it appropriately. The Aux-Mgt checkbox should be selected, a static IP should be assigned, and an appropriate SSID configured. The AP Aux-Mgt port will automatically serve DHCP and will try to NAT and route packets to the wired Management interface.

3. On the other resources, configure the wlanX interface to connect to the AP on the manager system, and select the Aux-Mgt checkbox.

4. The Port-Mgr tab should look something like this when the Aux-Management interfaces are configured.

5. To test that it works properly, you can now remove the wired Manament port connection and wait about 1 minute for the old connection to time out and re-connect to the Auxiliary Management port. Or, just reboot systems with the wired ports unplugged and they should be discovered on the Aux-Mgt ports promptly.

Find the IP Address of the Windows PC. There are two methods you can use:

1. Using the Control Panel:

   1. Click Start, Run, control, [enter]

   2. Search and select Network Status and Devices

   3. We click on our device, Ethernet 3:

   4. Find and/or set the IP address: from Status, click Properites

   5. double click TCP/IPv4

   6. you will see and can change the IP address.:

2. Various DOS commands to find the IP addresses on the system:

   1. ipconfig and ipconfig /all

   2. netsh interface ipv4 show address

3. Resetting your DHCP address via command line:

   1. ipconfig /release

   2. ipconfig /renew

Find the MAC Address of the Windows PC. There are two methods you can use:

1. Method 1: use the Control Panel

   1. Click Start, Run, control, [enter]

   2. Search and select Network Status and Devices

   3. We click on our device, Ethernet 3:

   4. Click Details...

   5. Details will show the MAC address (physical address):

   6. (Suggested) Set the IP address if you have not already.

      For more information see Finding Windows IP Address

2. Method 2: use the DOS command-line. You want to correlate the IP address and MAC address of the Windows ethernet port:

   1. Click Start, Run, and type cmd, and press [Enter]

   2. Show interfaces by name with the command: netsh interface ipv4 show addresses

   3. (Optional) if you do not see results, you might need to start the network autodiscovery service: net start dot3svc

   4. (Optional) Depending on the edition of Windows, the command netsh lan show interfaces will display mac addresses.

   5. Show mac addresses with: getmac /v /fo csv
      _{(The CSV formatted command of the command ensures that we will see the entire name of the interface which can be trimmed short in the default output format.)}

   6. These commands will make it easier to copy using notepad:
      

      netsh interface ipv4 addresses > ifnotes.txt
      getmac /v /fo csv >>ifnotes.txt
      notepad ifnotes.txt

      

   7. Now you can easily copy the values:

Type in cmd and hit Enter

To get to your DOS window faster, you can pin it to your task bar. Right click the task bar CMD window icon and select Pin this program to taskbar

On the DOS window title bar, Right click and select the Defaults menu item

Select the Quick Edit Mode setting. This allows you to highlight text in the window easily.

In the Font tab, select a slimmer TrueType font, like Consolas or Lucida Console, and set the font size to 10

In the Layout tab, change the Window Size to 132 columns and 56 rows

If perl is installed correctly, you should have it in your path.

You can also use this technique to find any environment variable. E.G., find if you have a temporary directory set:

set | findstr /i temp

Configuring a PuTTY Session

1. When you double click on the PuTTY icon and it launches, you can start customizing your session preferences. We'll name this session jedtest

2. Let's default the window to something large, like 120 columns and 56 rows.

3. The Fixed font can be replaced with the Consolas font.

4. Let's turn on TCP Keep-alive and set IPv4 as the default networking protocol.

5. We login to LANforge resources with user lanforge

6. Generating a SSH keypair is not difficult. Let's enter the path to our public key file.

7. We have done our PuTTY config. Now back to the top Session screen, and click Save

Configure Pagent with your public key

1. Create your own public ssh key.

   For more information see WinScp Net

2. Start Pagent. Configure it to load on startup.

3. In the System Tray you will see the Pagent icon.

4. Right-click the Pagent icon and click Add Key to select your key

5. You will need to provide your pass-phrase to load your key

6. We see a loaded key

7. Here is our key, we will view the .pub file to copy out the public key.

8. In a putty window you will log into your LANforge server and edit /home/lanforge/.ssh/authorized_keys

9. Copy the text and place the "Comment" section at the end when you paste it into your ssh

10. Here is the public key string, with newlines and spaces removed. The Comment text goes at the end.

11. Check the permissions of the authorized_keys file. You might need to use the command

    chmod 600 authorized_keys

    to correct the permissions.

12. The next time we load the jedtest PuTTY session we should not be prompted for our password.

You want to install the windows version of the LANforge Server beforehand.

For more information see Installing LANforge Server on Windows

Getting to the Device Manager

1. Start by clicking the Start Menu and typing control ENTER

2. Select Hardware and Sound

3. Select Device Manager

4. In the Device Manager window, right-click on the computer and select Scan for hardware changes

5. There will be an Other devices→Unkown Device entry. Right-click on it. If the options menu only gives you Scan for hardware changes or Properties, you might need to restart your control panel as Administrator, that is discussed next.

6. If you have recently removed a driver, you might need to reboot your Windows system for it to complete the driver installation process.

Using the Run as Administrator option to start the Control Panel in administrator mode.

1. This works best with a CMD window pinned to the task bar. You can do that using Start Menu→ cmdENTER; and then right-click→ Pin to Task Bar option on the task bar icon for the cmd.exe window.

2. Then right-click→ Run as Administrator on the cmd taskbar icon

3. Repeat your navigation steps to get to the Device Manager

If you find a previously installed driver, uninstall it. Especially if this is labeled Windows Arduino Mega

1. Right-click → Uninstall

2. Select Delete the driver software for this device, and click OK

3. Right-click on the computer, and select Scan for Hardware Changes

4. You might need to un-plug and plug-in your Attenuator.

5. If the right-click options menu does not allow you to change drivers, reboot your system.

Install the LANforge Arduino Driver

Depending on your version of Windows, you might not find the driver file using the Browse my computer choice, you might find it using the Automatically Search choice.

1. In Device Manager, you want right-click on the Unknown Device and select Update Driver Software...

2. Option 1: Select Search automatically for updated driver software:

   

   1. Click on Let me pick from a list of device drivers on my computer

   2. You see a list of drives. Click the Have Disk button:

   3. Enter C:\Program Files (x86)\LANforge-Server. Click OK.

3. Option 2: Select Browse my computer for driver software:

   

   1. Browse to C:\Program Files (x86)\LANforge-Server and click Next

   2. This is not a signed driver. Please confirm the installation.

   3. You will see the Update Driver Software confirmation. Click Close.

4. You should not need to reboot your system in order to run the Attenuator.

From your Windows Start Menu, type "remote" and Remote Desktop Connection should be an option.

If you are using the Start→Run menu, type mstscEnter

If you want to create a desktop shortcut, explore the folder C:\windows\system32 and right-click mstsc.exe

Configure your connection:

1. Fedora version 24 and 25 have a bug in the vncserver triggered by xrdp. The effective way to use rdesktop on those systems is to select an Xorg session for connecting (not a Xvnc session).

2. When connecting to Fedora 14-23 systems:

   1. User Name: lanforge

   2. You will not need to fill out the xrdp login screen.

3. When connecting to Fedora 24-25 systems:

   1. Do not specify a user name, and select Always ask for credentials.

   2. Select Xorg as the session type

   3. Specify username lanforge and password lanforge

4. Local Resources

   1. If your rdesktop session immediately closes, you might have hit the xrdp clipboard bug. If so:

   2. For Windows Remote Desktop (mstsc.exe): unselect Local Devices→Clipboard

   3. For Linux rdesktop, use the command: rdesktop -a16 -r cliboard:off -u lanforge [machine-name]

5. Disable remote audio settings

6. Disable local printers

7. Set Server authentication to Connect and do not warn

8. Connection quality can be 16-bit (millions of colors)

Click Connect to connect to the default desktop, the default password is lanforge

When you are DONE with your connection, you may close the Remote Desktop window. You will not be logged out. However, if you log in without setting the Username option, you will be logged into a new session alongside your old session. If you see this screen below, you are starting a new desktop session:

To logout of the desktop session, select System→Log Out from the top window of the Linux desktop.

You can download a variety of viewers:

1. Check for viewer packages on your LANforge web page: http://192.168.1.101/

2. or download RealVnc

3. or download TightVnc

From your Windows Start Menu, type "vnc" and VNC viewer should be an option.

If you are using the start menu, it will be under either in All Programs > RealVNC or TightVNC

Double click the vnc icon and it will ask you for the IP address. You want to set the Encryption option to off because we presume you are connected directly to the LANforge.

VNC Viewer might warn you about connecting without encryption. This is a valid warning if you are connecting across public networks.

The password is lanforge.

You will see the LANforge Linux desktop. This is not the same desktop that is actually running on the console if you have a monitor and keyboard connected.

To restart the vnc desktop session, select you can issue either of these two commands. You start using ssh (PuTTY et. al.) to connect as lanforge to the LANforge machine, and:

1. sudo systemctl restart "vncserver@:1.service"

2. or

3. sudo vncserver -kill :1

We will start at Cygwin.org and download the Cygwin installer.

Download setup-x86.exe or setup-x86_64.exe as appropriate. Go to your Downloads folder and double start the program.

Next

Next

Next

Choose a mirror that might be close to you, click Next

Now you see a the software selection screen, sorted by category. Some of these entries appear two or more times, because they belong to multiple categores. Try using the search box in upper middle above the software list to search for the packages listed below.

The items you want to search for are

• openssh
• xorg-server
• xinit
• rxvt
• xlaunch

1. Search for openssh and click the Skip property once to change it to the most recent version to set it to install.

2. xorg-server provides the X display system

3. xinit helps the X system launch

4. xlaunch is what you will drag to your task bar to launch your Cygwig X server

5. rxvt and rxvt-unicode are more useful terminals than the minterm program that Cygwin provides by default.

Click Next and let the installer finish the installation of the Cygwin packages. You will see a Cygwin Terminal icon appear on your desktop and new Cygwin icons in your Start menu.

Next we will right-click on the Cygwin Terminal icon and select Open File Location

In the Explorer window, scroll to find xlaunch.exe, and drag it to the Task Bar

Click the xlaunch icon on the task bar, and click Next

Next

Check Disable Access Control and add the option: -listen tcp. Click Next

Firewall, Click Allow Access

If the LANforge Messages window reports 'No Access', you might need to use xhost.exe to grant X11 access.

1. Open a CMD window

2. Go to the cygwin\bin folder:

   C:\> cd \cygwin\bin

3. Use xhost.exe to open permissions:

   C:\> .\xhost.exe +

   

Now your X display service is running. You can check that it's running by clicking into the System Tray and seeing if the icon is there.

Launch the LANforge GUI from your desktop. Select a port from the Port Mgr tab. Notice how the Disp field has your laptop's LAN address. This is the display address the remote machine will display the Wireshark window to.

You will see WireShark

Resources and other Documentation:

1. http://unix.stackexchange.com/questions/227889/cygwin-on-windows-cant-open-display

2. https://www.cs.virginia.edu/~csadmin/wiki/index.php/Using_Cygwin_for_X11_Forwarding

3. http://www.arsc.edu/arsc/knowledge-base/ssh-and-x11-forwarding-us/index.xml

Here we're using Etcher which handles compressed file system images without any trouble. There are other programs (like Win32 Disk Imagaer or dd for windows) but those are more complex to use.

Items we'll want:

1. 30GB or larger mSATA drive

2. USB3 mSATA drive adapter

3. The image writing program Etcher

Download and install Etcher

Identify your drive in Control Panel → Hardware and Sound → Hardware and Printers.

Download your image file:

Start Etcher

Select the compressed image:

Select the removable drive

You might have to enable unsafe mode if the drive you plugged in has previously been used

1. in Settings, enable Unsafe mode

2. Select the removable drive

Select the removable drive

Write image.

1. click Flash

2. It might take 20 minutes to write a 20GB (uncompressed) image.

Make coffee.

When the image is finished writing, close etcher and use the Safely Eject Thing dialog in the system tray.

1. right click

2. select device

Unplug your drive from the computer, remove the msata drive drive from the USB caddy and then install into your embedded device

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:

1. 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

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

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

3. Install LANforge:

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

4. 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

   

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

6. When installation finishes, reboot:

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

7. 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