Device deployment with chroot
There are different ways to provision and deploy devices with qbee. One possible option is to use a script that handles the qbee bootstrapping. Another option is to use chroot to setup an image. In this example it is shown how a Raspberry Pi is provisioned on a master device.
Please do not have qbee running on the master device during the provisioning
If there is an active instance of qbee running on the master device the VPN might not work.
These are the steps:
- Flash an SD card with your OS. In this case we use a Raspberry Pi OS.
- Mount that SD card rootfs from another Raspberry Pi, e.g.
sudo mount /dev/sdb2 ./sd_card_mount
- Also mount
/proc
into the rootfs e.g.sudo mount -t proc /proc ./sd_card_mount /proc
- Chroot into the SD card rootfs e.g.
sudo chroot ./sd_card_mount
-
Install qbee in the chroot:
wget https://cdn.qbee.io/software/qbee-agent/qbee-agent_1.2.1_armhf.deb && sudo dpkg -i qbee-agent_1.2.1_armhf.deb
qbee-agent service might not be enabled
Depending on your deployment setup it might occur that the qbee-agent service cannot be enabled. That means that after restarting your system, the qbee-agent will not be invoked and your device appears as offline. Either create a script that is run on first time with the command
sudo systemctl enable qbee-agent.service
or create the symlink manually during the image creation
ln -s /etc/systemd/system/qbee-agent.service /etc/systemd/system/multi-user.target.wants
Please note that the paths might vary depending on your OS. Please contact us if you run into any problems.
-
Run the qbee bootstrap:
/opt/qbee/bin/qbee-bootstrap -k <bootstrap_key>
and wait for it to finish - Exit the chroot, unmount
/proc
and unmount./sd_card_mount
- Run
sync
to flush the SD card - Put the new SD card into another Raspberry Pi and turn it on. It should now come back online in the qbee UI.
- Please note that the VPN (remote access) needs two agent runs to come online (ca. 10 minutes). This will be accelerated eventually.