Background

The LANforge InterOp solution of Candela technologies are used to support real clients for testing Access Points. InterOp gives the ease of handling real clients with complete automation and populate a detailed reports on the entire duration of the test.

We have support for various kinds of real clients:

-      Android clients.
-      iOS clients.
-      Windows Machines.
-      Linux Machines.
-      MacOS Machines.

Network Topology:

Before getting started:

• The LANforge Manager this MacOS machine will be clustered with must be in clustering mode. That includes configuring the realm, mode, and resource number of the manager, as well as having the right licenses. Please verify you have the correct licenses and follow this cookbook to set your manager up.

• All applications requiring internet for installation should be installed before starting the LANforge server.

  MacOS Device Initial Setup

1. Create a user account named "lanforge". This account will have administrator permissions by default if it is the only user account on the macOS machine.
2. Sign in to your Apple ID and allow the MacOS machine to proceed through its initial setup process.
3. Once the Mac desktop is accessible, open a new terminal and run the command: sudo ipconfig setverbose 1 to enable logging and prevent SSIDs from being reported as <redacted>.
4. Enable Screen Sharing and Remote Login (SSH and VNC): Click on the gear icon ('System Preferences' or 'System Settings'), click 'Sharing', and check 'Remote Login' and 'Remote Management'. Then enable VNC Viewer remote login with password by clicking on 'Remote Management', 'Computer Settings', and checking 'VNC Viewers may control screen with password (and set password of preference).
5. Enable 'Restart after Power Failure'. This can be done by the terminal. Open a new terminal and run the command: sudo systemsetup -setrestartpowerfailure. This means that the system will restart after a blackout / power outage by itself. Beware that not all systems have the ability to set this.
6. Verify that the lanforge user has Admin permissions. Click on 'System Settings' or 'System Preferences', navigate to 'Users & Groups'. If the only user is lanforge, they may already be an admin. If there are other user accounts on the machine, click on the lanforge user, and check the box 'Allow user to administer this computer' and enter a password.
7. Within 'Users & Groups' settings, click the 'Login Options' button. There should be an 'Automatic Login' dropdown. Set 'lanforge' as the dropdown selection. This ensures remote access is not interrupted when the Mac reboots.
8. If the lanforge user does not have lanforge permissions now, reboot the system.

Steps to install LANforge Server on MacOS machine

1. Open a new terminal.

2. Type in the command: sudo su – root to become root user.

3. Type into the terminal:

   1. curl -o lf_kinstall.pl https://www.candelatech.com/lf_kinstall.pl

   Then, press enter. This command downloads Candela's server installation script.

   

   2. chmod a+x lf_kinstall.pl

   Then, press enter. This command give permissions and set proper bits.

   

   3. ./lf_kinstall.pl --do_all_ct --lfver 5.5.3

   Then, press enter. This command runs the server installation script we downloaded above (with the proper arguments).

   

4. Type in the terminal: cd /Users/lanforge and press enter. Then, type in: ./lfconfig and press enter. These 2 commands change terminal to /Users/lanforge and run the command to configure LANforge realms.

5. Specify your lanforge ip manager and press enter. Below is the example of specifying manager 192.168.200.239

connect_mgr 192.168.200.239:4002

8. Specify your realm id and press enter. Below is command example of specifying realm 41.

realm 41

9. Set a resource number for your laptop. This is any resource number that is already used. Below is an example of using resource 44. Press enter after the command is typed.

resource 44

10. Give mode as resource to act the Mac laptop as resource using the command below. Then press enter.

mode resource

11. Type in config and enter to save changes.

12. Start the lanforge server by typing in ./serverctl.bash start and pressing enter.

After starting the LANforge server, go to the Lanforge GUI Port Mgr tab to find your MacOS machine clustered.

Resource Mgr tab will also show the laptop and the resource id that was given earlier above to the MacOS machine.

Now en0 port can be used as station of laptop wiphy radio and run traffic.

Upgrading LANforge Software on MacOS

1. Open a terminal

2. Type in the command: sudo su – root to become root user.

3. Type into the terminal:

   1. curl -o lf_kinstall.pl https://www.candelatech.com/lf_kinstall.pl

   Then, press enter. This command downloads Candela's server installation script.

   

   2. chmod a+x lf_kinstall.pl

   Then, press enter. This command give permissions and set proper bits.

   

   3. ./lf_kinstall.pl --do_upgrade --lfver 5.5.3

   Then, press enter. This command runs the server installation script we downloaded above (with the proper arguments).