VirtualBox Deployments

Lighthouse can be installed on the following hosts:

• VirtualBox on Windows as host

• VirtualBox on macOS as host

• VirtualBox on Ubuntu as Host

• VirtualBox on Fedora Workstation as host

VirtualBox on Windows as host

Note:We recommend that VirtualBox users customize their instances and change their network cards to one other than e1000. We also suggest virtio for better performance.

This procedure assumes VirtualBox is already installed on the host machine and the required PKZip archive, lighthouse-23.10.0-ovf.zip is in C:\Users\%USERNAME%$\Downloads.

1. Unzip lighthouse-ovf. It may appear as lighthouse-23.10.0-ovf.zip depending on the Windows Explorer preference settings).

2. Right-click the lighthouse-ovf archive and select Extract all from the context menu.

3. The Select a Destination and Extract Files dialog opens. The destination is C:\Users\%USERNAME%\Downloads\Lighthouse-ovf.

4. Uncheck the Show extracted files when complete checkbox and edit the destination by removing Lighthouse-ovf from the path.

5. Click Extract.

6. A folder called lighthouse-ovf is created inside C:\Users\%USERNAME%\Downloads\.

7. Launch VirtualBox.

8. The Oracle VM VirtualBox Manager window displays.

9. Choose File > Import Appliance.

10. The Appliance to Import dialog opens.

11. Click Expert Mode.

12. The Appliance to import dialog changes from Guided Mode to Expert Mode.

13. Click the icon of a folder with an upward pointing arrow superimposed. This icon is to te far right of the Appliance to import field.h

14. The Open File dialog displays with C:\Users\%USERNAME%\Documents as the current folder.

15. Navigate to C:\Users\%USERNAME%\Downloads\Lighthouse.ovf\Opengear Lighthouse VM\.

16. Select the file Opengear Lighthouse VM and click Open.

17. Double-click the text vm in the Name row and Configuration column to make it editable.

18. Type Opengear Lighthouse VM and press Enter.

19. Click Import.

20. A new virtual machine, called Opengear Lighthouse VM is added to the list of virtual machines available to Virtual Box.

21. Select Opengear Lighthouse VM from the list.

22. Select Machine > Settings or click the Settings icon in the VirtualBox Manager toolbar or press Control+S.

23. The Opengear Lighthouse VM - Settings dialog displays.

24. Click the System option in the list of options running down the left-hand side of the dialog.

25. The dialog shows the System options available as three tabs: Motherboard, Processor, and Acceleration. Depending on the underlying hardware platform, Acceleration may be greyed-out and unavailable. The Motherboard tab is preselected.

26. In the Motherboard tab, select the Hardware Clock in UTC Time checkbox.

27. Click OK or press Return

28. Select Opengear Lighthouse VM from the list and click Start in the Oracle VM VirtualBox Manager toolbar to boot Lighthouse. Double-clicking Opengear Lighthouse VM in the list also boots Lighthouse.

Note:Selecting the Hardware Clock in UTC Time checkbox is necessary because Lighthouse expects the hardware clock to be set to UTC, not local time. Unlike other Virtual Machine Managers, Virtual Box both exposes this option as a user-adjustable setting and does not set it to UTC by default.

VirtualBox on macOS as host

VirtualBox should already installed on the host macOS machine and the required PKZip archive, lighthouse-23.10.0-ovf.zip is in ~/Downloads.

1. Unzip lighthouse-23.10.0-ovf.zip.
   This creates a folder Lighthouse-ovf in ~/Downloads that contains the following files and folders:
   
   

2. Launch Virtual Box. The Oracle VM VirtualBox Manager window displays.

3. Select File > Import ApplianceI or press Command+I.

4. The Appliance to Import dialog sheet slides down from the Oracle VM VirtualBox Manager toolbar.

5. Click Expert Mode.
   
   The Appliance to Import dialog sheet changes from Guided Mode to Expert Mode.

6. Click the icon of a folder with an upward pointing arrow superimposed. This icon is to the far-right of the Appliance to Import field.

7. The Open File dialog sheet slides down from the Oracle VM VirtualBox Manager toolbar. This sheet opens with ~/Documents as the current folder.

8. Navigate to ~/Downloads/Lighthouse.ovf/Opengear Lighthouse VM/.

9. Select Opengear Lighthouse VM and click Open. (Depending on the Finder Preferences settings, the file may present as Opengear Lighthouse VM.ovf.)

10. Double-click the text vm in the Name row and Configuration column to make it editable.

11. Type Opengear Lighthouse VM and press Return.

12. Click Import.
    
    A new virtual machine, called Opengear Lighthouse VM is added to the list of virtual machines.

13. Select Opengear Lighthouse VM from the list.

14. Choose Machine > Settings. Or click the Settings icon in the VirtualBox Manager toolbar. The Opengear Lighthouse VM Settings dialog displays.

15. Click the System option in the dialog’s toolbar.
    
    The dialog shows the System options available as three tabs: Motherboard, Processor, and Acceleration. (Depending on the underlying hardware platform, Acceleration may be greyed-out and unavailable). The Motherboard tab is preselected.

16. In the Motherboard tab, select the Hardware Clock in UTC Time checkbox.

17. Click OK or press Return.

18. Select Opengear Lighthouse VM from the list and click Start in the Oracle VM VirtualBox Manager toolbar to boot Lighthouse. Double-clicking Opengear Lighthouse VM in the list also boots Lighthouse.

Note: Selecting the Hardware Clock in UTC Time checkbox is necessary because Lighthouse expects the hardware clock to be set to UTC, not local time. Unlike other Virtual Machine Managers, Virtual Box both exposes this option as a user-adjustable setting and does not set it to UTC by default.

Note:By default, VirtualBox stores virtual machines in ~/VirtualBox VMs. If this is the first virtual machine setup by VirtualBox, it creates the VirtualBox VMs folder in the current user’s home-directory and a folder — Opengear Lighthouse VM — inside the VirtualBox VMs folder. The Opengear Lighthouse VM folder contains the files and folders which make up Lighthouse when run under Virtual Box.

VirtualBox on Ubuntu as Host

Before beginning the procedure, make certain that VirtualBox and all required support files are installed on the host machine and the PKZip archive, lighthouse-23.10.0-ovf.zip is in ~/Downloads.

1. Unzip lighthouse-23.10.0-ovf.zip. This creates a folder, Lighthouse-ovf in ~/Downloads that contains the following files and folders:

   
   
   

2. Launch Virtual Box.

3. The Oracle VM VirtualBox Manager window displays.

4. Choose File > Import Appliance.

5. The Appliance to import dialog opens.

6. Click Expert Mode.

7. The Appliance to Import dialog changes from Guided Mode to Expert Mode.

8. Click the icon of a folder with an upward pointing arrow superimposed. This icon is positioned to the right of the Appliance to Import field.

9. A file-navigation dialog, Choose a Virtual Appliance to Import, opens with ~/Documents as the current folder.

10. Navigate to ~/Downloads/Lighthouse.ovf/Opengear Lighthouse VM/.

11. Select Opengear Lighthouse VM.ovf and click Open.

12. Double-click the text vm in the Name row and Configuration column to make it editable.

13. Type Opengear Lighthouse VM and press Return.

14. Click Import.
    
    A new virtual machine, called Opengear Lighthouse VM is added to the list of virtual machines available to Virtual Box.

15. Select Opengear Lighthouse VM from the list and click Start in the Oracle VM VirtualBox Manager toolbar to boot Lighthouse. Double-clicking Opengear Lighthouse VM in the list also boots Lighthouse.

Note:VirtualBox stores virtual machines in ~/VirtualBox VMs. If this is the first virtual machine setup by VirtualBox it creates the VirtualBox VMs folder in the current user’s home-directory and a folder Opengear Lighthouse VM inside the VirtualBox VMs folder. Inside Opengear Lighthouse VM are the files and folders which make up Lighthouse when run under Virtual Box.

VirtualBox on Fedora Workstation as host

Before beginning, make certain that VirtualBox and all required support files are already installed on the host machine and the PKZip archive, lighthouse-23.10.0-ovf.zip is in ~/Downloads.

1. Unzip lighthouse-23.10.0-ovf.zip. This creates a folder Lighthouse.ovf in ~/Downloads that contains the following files and folders:
   
   

2. Launch Virtual Box.
   
   The Oracle VM VirtualBox Manager window displays.

3. Choose File > Import Appliance or press Control-I.
   
   The Appliance to Import dialog opens.

4. Click Expert Mode.
   
   The Appliance to Import dialog changes from Guided Mode to Expert Mode.

5. Click the icon of a folder with an upward pointing arrow superimposed. This icon is to the far right of the Appliance to Import field.
   
   The Open File dialog opens with ~/Documents as the current folder.

6. Navigate to ~/Downloads/Lighthouse.ovf/Opengear Lighthouse VM/.

7. Select Opengear Lighthouse VM and click Open.

8. Double-click the text vm in the Name row and Configuration column to make it editable.

9. Type Opengear Lighthouse VM and press Return.

10. Click Import.
    
    A new virtual machine, called Opengear Lighthouse VM is added to the list of virtual machines available to Virtual Box.

11. Select Opengear Lighthouse VM from the list and click Start in the Oracle VM VirtualBox Manager toolbar to boot Lighthouse. Double-clicking Opengear Lighthouse VM in the list also boots Lighthouse.

Note:VirtualBox stores virtual machines in ~/VirtualBox VMs. If this is the first virtual machine setup by VirtualBox, it creates the VirtualBox VMs folder in the current user’s home-directory and a folder Opengear Lighthouse VM inside the VirtualBox VMs folder. Inside Opengear Lighthouse VM are the files and folders which make up Lighthouse when run under Virtual Box.