Skip to content
This repository has been archived by the owner on Mar 9, 2022. It is now read-only.

Latest commit

 

History

History
62 lines (44 loc) · 3.06 KB

README.md

File metadata and controls

62 lines (44 loc) · 3.06 KB
Raw

Simple Conferencing in sandboxed VM (Webex, Zoom, ...)

This is nothing really special...

Goal:

  • Provide a ready to run an isolated Zoom (or WebEx*) Conferencing environment that can be run on Linux.
  • Download and install the software to be able to run the software on Linux
  • Run X, not Wayland, to enable screen sharing (but keeping your host system safe, isolated from the VM)
  • NOTE: Master branch has been switched to Zoom only -- see below.

How:

  • Using Vagrant to create a fresh [VirtualBox (https://www.virtualbox.org/) virtual machine image
  • Base OS: Ubuntu with a small(ish) desktop environment: LXDE
  • Uses 32-bit OS (legacy, because WebEx Java plugins required it before. This will likely change at some point because Zoom has a 64-bit native client)
  • Install Firefox + Zoom native client

*Branches (IMPORTANT):

Master branch has now been switched over to install only Zoom, because we no longer use WebEx at GENIVI. If you want to use WebEx - consider the webex+zoom branch -- however it should be considered unsuppported.

Running:

  1. Install Vagrant & VirtualBox

  2. Clone project, cd to project dir and run:

$ vagrant up --provision

  1. Open the VirtualBox user interface, find the VM and restart the VM (Do a clean ACPI Shutdown, followed by Start. Alternatively from command line: vagrant halt ; vagrant up)

  2. Check that the folder that is shared with the host is working. It seems to be automatic now - if not, try manually adding it. ~/vmshare-zoom (previously vmshare-webex) is the default path on both host and guest.

  3. Optionally use apt-get to install any software you might lack - e.g. LibreOffice if you're sharing documents.

Troubleshooting:

If you have issues with any of this:

  • Shared folder won't work
  • Shared clipboard doesn't work (also see Bugs section)
  • Guest screen won't resize when you resize the VirtualBox window (or set it to full screen)

... then you likely have mismatched guest additions installed.

VirtualBox support is beyond this project - please look elsewhere. It's always a challenge to get the guest OS set up correctly because you host system changes, VirtualBox version changes, but the guest OS might not. In particular the guest additions need to match the VirtualBox version. Since this is based on a fixed base box, there is no way to guarantee that, but installing vagrant guest additions plugin BEFORE running vagrant up / provisioning, might help.

Tweaks:

Depending on your system resources you could tweak memory or number of CPUs for better perfomance - either in the Vagrantfile before building, or later on in the VirtualBox user interface.

Bugs:

  • At the moment, shared clipboard is not working for me (it should, due to guest additions being installed, but who knows)

(!) This is not a complete list - also refer to GitHub Issues.