allxon-ota-update

OTA Update Jetson via Allxon DMS

Uses Allxon DMS Portal to generate, upload, and distribute OTA Payload Packages for updating Jetson devices from one JetPack version to another. The OTA payload is delta-based (Base BSP → Target BSP).

Hardware: Jetson Xavier NX / AGX Xavier / TX2 (NOT Nano), USB-C cable, HDMI display (optional) Software: Ubuntu 20.04 host PC (native), Allxon DMS agent installed on Jetson

---

Execution model

Run one phase at a time. After each phase:

• If output contains [STOP] → stop immediately, consult the failure decision tree
• If output ends with [OK] → tell the user "Phase N complete" and proceed

Warning: The OTA update erases the file system. Only /ota survives. Ensure the user has backed up important data before proceeding.

---

Phase 1 — prerequisites check (~1 min)

On the Jetson device:

cat /etc/nv_tegra_release

Confirm Allxon DMS agent is installed:

dpkg -l | grep allxon-dms-agent

Confirm Ethernet is connected (required throughout the entire OTA process).

On the Ubuntu host PC, confirm native Ubuntu 20.04 or 22.04.

[OK] when all prerequisites confirmed. [STOP] if using Jetson Nano (not supported) or no Allxon agent.

---

Phase 2 — prepare Base BSP on host PC (~10 min)

Download the L4T Driver Package (BSP) and Sample Root Filesystem matching the CURRENT version on the Jetson device from: https://developer.nvidia.com/embedded/linux-tegra-archive

sudo tar -vxjf <Base_BSP>.tbz2
cd <Base_BSP>/Linux_for_Tegra/rootfs
sudo tar -jxpf ../../<rootfs>.tbz2
cd ..
sudo ./apply_binaries.sh

[OK] when apply_binaries.sh completes without errors.

---

Phase 3 — prepare Target BSP on host PC (~15 min)

Repeat Phase 2 steps for the TARGET JetPack version.

Then add the auto-install Allxon agent mechanism to the Target BSP:

1. Create /etc/init.d/install_allxon_dms.sh in Target BSP rootfs (script content in references/source.body.md)
2. Create /etc/systemd/system/dms-install.service in Target BSP rootfs (service content in references/source.body.md)
3. Set permissions and create symlink:

sudo chmod 644 ./etc/systemd/system/dms-install.service
sudo chmod 777 ./etc/init.d/install_allxon_dms.sh
sudo ln -s /etc/systemd/system/dms-install.service \
  ./etc/systemd/system/multi-user.target.wants/dms-install.service