(BETA) How to set up a Batch-Import enabled Camio Box VM

Camio is debuting a new "batch-import" feature that allows one to import large quantities of existing video into the Camio service. See https://camio.com/metadata/ for more information on this feature. In order to use the batch-import feature, one needs to use a Camio Box that has this feature enabled. This help-article describes how to obtain and set-up a Camio Box VM that is batch-import enabled.

What you need

To start, you'll need the free and open-source Oracle VirtualBox software installed on your computer. 

1. Install VirtualBox

    1. Go to this link: https://www.virtualbox.org/wiki/Downloads
    2. Download the version of VirtualBox for your specific operating system.
    3. Follow the steps listed on the downloads page to install VirtualBox onto your computer.

2. Download the Camio Box VirtualBox Appliance

    1. Download the camio-box-os-virtualbox-2017-05-16.zip file
    2. Unzip the downloaded file to extract the camio-box-os-virtualbox-2017-05-16.ova file.
      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-05-16.ova file into two files:

      That'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

Copy the MAC address shown on this page:
Note: If you're running multiple Virtual Machines, then you can get additional MAC addresses by appending a number at the end of the URL above (e.g. /box/register/box_vm_mac2).

4. Create the Camio Box Virtual Machine

    1. Open the VirtualBox program.
    2. Choose 'File' > 'Import Appliance'
    3. Use the file-selector to select the camio-box-os-virtualbox-2017-05-16.ova file that you unzipped previously. (or, select the camio-box-os-virtualbox-2017-05-16.ovf file if you see that instead)
    4. 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 Batch Import'. To set the MAC address of your VM:

    1. Click on the 'CamioBox VM' entry to highlight it.
    2. Click on the 'Settings' button at the top of the page.
    3. Click on the 'Network' tab.
    4. 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.
    5. Expand the 'Advanced' section.
    6. In the 'MAC Address' text-box, enter the MAC address you copied from the prior step.
    7. Click 'Ok' at the bottom of the 'Settings' window to save your changes.

6. Start your Camio Box Virtual Machine

    1. On the main VirtualBox window, highlight the 'Camio Box VM Batch Import' entry.
    2. At the top of the main window, click the 'Start' button.
    3. A window will pop up showing a Unix terminal and boot diagnostics for the device.

Once the virtual machine is finished booting and you see a login prompt, it's ready to be registered to your Camio account.

7. Register your Camio Box:

    1. Go to camio.com/box/register
    2. Enter a name for your Camio Box and enter the MAC address that you set for your virtual Camio Box.
    3. 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 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?.

Known Issues:

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.




Have more questions? Submit a request


Powered by Zendesk