This chapter describes how to install and run the QNX Cabin for Cloud.
This chapter contains the following topics:
Setting up a Hypervisor AMI
You must set up a Hypervisor AMI instance with the minimum volume
requirement of 48GiB for Cabin and a guest image of Android or Yocto Linux.
For details on setting up the Hypervisor AMI instance,
go to the QNX Amazon Machine Image Technotes
Note: You should prepare back-up solutions (e.g., back-up images) and
perform sanity checks to make sure the instance is functional.
You must configure the instance's security group to allow the following ports:
Table 1. List of ports required for the QNX Cabin AMI
Protocol |
Port number or range |
Description |
ICMP |
All |
ping |
TCP |
22 |
Host SSH |
TCP |
24 |
Yocto SSH |
TCP |
3478 |
WebRTC Turn Server |
TCP |
4000 |
LiveAMP |
TCP |
5555 |
Android ADB |
TCP |
8000 |
qconn |
TCP |
8080 |
lighttpd |
TCP |
8443 |
WebRTC Server |
UDP |
3478 |
WebRTC Turn Server |
UDP |
49152-65535 |
WebRTC Turn Server |
Create and copy your guest image to your AMI instance
You need to create the Android or Yocto guest image
and copy the guest image to your instance.
To create and copy a guest image:
- Create the Android or Yocto guest using the following instructions:
- Use mkqnx6fsimg
to create a qnx6 partition image that includes your guest.
Note: The sector size is 512.
- Name the partition image guests.image.
- Copy the created guests.image
to /dev/shmem.
Here's an example of the guest directory structure:
- /guests/android/Android14-auto/kernel-5.10
- /guests/android/Android14-auto/vendor_ramdisk
- /guests/android/Android14-auto/android14-disk.img
- /guests/linux/Yocto/core-image-weston-qvmaarch64.ext4
- /guests/linux/Yocto/Image
- /guests/android/Android14-auto/graviton2-vm.dtb
Installing and running the Cabin image
After setting up your Hypervisor instance with the guest image,
install and run the QNX image on your instance.
To install and run Cabin:
- On the development host:
- Download QNX Cabin on AWS Graviton —
com.qnx.qnx710.target.cabin.AWS_Graviton*
from the QNX Software Centre.
- Copy the image archive files from
[installation folder]/target to your
instance using your key pair (PEM file) and the IP of your instance.
For example:
scp -i [pem path] target/qnx7/aarch64le/images/Cabin/vCabin_b[build_number].zip
qnxuser@[instance IP]:/dev/shmem
- Run Cabin using the following commands on the instance:
cd /dev/shmem
tar -xvf vCabin_b[build_number].zip
ksh ./copy_and_run_auto_img.sh
Note: The script
./copy_and_run_auto_img.sh
performs a partition fixing workaround that allows the
instance to use a bigger physical disk space than the
default disk image size of 4GiB (i.e.,
growing disk).
Currently in QNX SDP 7.1, the MBR (or GPT) partition editing tool,
pted,
doesn't support
growing disk partition fixing;
a future QNX SDP 7.1 patch will address this.
By default, the QNX cloud target automatically runs the
webrtc-server-iosock WebRTC utility
and the screen graphics utility,
so you can immediately access the WebRTC interface.
Go to the Using the WebRTC server
chapter to start using the WebRTC graphics and audio.