Camio provides an image of the Camio Box software that can be run inside of Oracle VirtualBox. Virtual Machines made from this image will act just like a physical Camio Box on your local network.
What you need
- Oracle VirtualBox Software
- Camio Box VirtualBox Appliance Image.
- A computer that can run VirtualBox
- A MAC address, given to you by Camio, to use with your virtual Camio Box.
To start, you'll need the free and open-source Oracle VirtualBox software installed on your computer.
1. Install VirtualBox
- Go to this link: https://www.virtualbox.org/wiki/Downloads
- Download the version of VirtualBox for your specific operating system.
- Follow the steps listed on the downloads page to install VirtualBox onto your computer.
2. Download the Camio Box VirtualBox Appliance
- Download the
camio-box-os-virtualbox-2017-04-12.zipfile from go.camio.com/virtualbox
- Unzip the downloaded file to extract the
OVA files are VirtualBox Appliance files that contain an image of a virtual machine that can loaded into any VirtualBox environment.
Note - On some machines (like OS X), the default Archive Utility will automatically unpack
camio-box-os-virtualbox-2017-04-12.ovafile into two files:
camio-box-os-virtualbox-2017-04-12.vmdkThat's fine. Just use the .ovf file in place of the .ova file in the steps below.
3. Get a MAC address for your Virtual Camio Box
Please email email@example.com to request a MAC address for your virtual machine.
Note: You must use a MAC address provided by Camio in order to register your Virtual Camio Box.
4. Create the Camio Box Virtual Machine
- Open the VirtualBox program.
- Choose 'File' > 'Import Appliance'
- Use the file-selector to select the
camio-box-os-virtualbox-2017-04-12.ovafile that you unzipped previously. (or, select the
camio-box-os-virtualbox-2017-04-12.ovffile if you see that instead)
- Click the 'Import' button when you see a window pop up with information about the virtual machine you are creating. You can customize the virtual machine settings later.
5. Set the MAC address and Networking for your VM
You should now be on the main VirtualBox window and there should be an entry in the left column that says 'CamioBox VM'. To set the MAC address of your VM:
- Click on the 'CamioBox VM' entry to highlight it.
- Click on the 'Settings' button at the top of the page.
- Click on the 'Network' tab.
- Select the 'Bridged Adapter' with the correct 'Name' that varies by OS:
Linux: This is normally either 'eth0', or 'enp1s0'. Use the 'ifconfig' terminal tool to find your primary networking interface.
OS X: This is normally 'en0'. You can use the 'ifconfig' terminal tool to find the primary networking interface.
- Expand the 'Advanced' section.
- In the 'MAC Address' text-box, enter the MAC address that Camio gave you for this specific virtual Camio Box.
- Click 'Ok' at the bottom of the 'Settings' window to save your changes.
6. Start your Camio Box Virtual Machine
- On the main VirtualBox window, highlight the 'Camio Box VM' entry.
- At the top of the main window, click the 'Start' button.
- A window will pop up showing a Unix terminal and boot diagnostics for the device.
Once the virtual machine is finished booting, it's ready to be registered to your Camio account.
7. Register your Camio Box:
- Go to www.camio.com/box/register
- Enter a name for your Camio Box and enter the MAC address that you set for your virtual Camio Box.
- Click 'Register' and wait for confirmation of registration success to appear on that page.
Congratulations! You have now registered your virtual Camio Box. Go to the www.camio.com/boxes page to connect cameras on your network to your Camio account.
You can of course customize the amount of resources dedicated to your Camio Box virtual machine. For more information see this help article : How do I tune my Camio Box VM to match the number of connected video streams?.
There is an issue with VirtualBox on some combinations of host-hardware and networking-hardware that prevents bridged-networking from working. If your Camio Box fails to register itself, or if it hangs on boot while "Raising Network Interfaces", it may be useful to set up a regular Ubuntu 16.04 virtual machine and see if you can get bridged networking to work. This will help us diagnose if it's a VirtualBox issue or a Camio Box issue.