Skip to main content

Software Deployment

This page covers installation and upgrade of the NE503 platform software release package (.tar.gz). The system OS uses a .swu package.

1. Prepare the Release Package​

Download aipc-hailo15-<version>.tar.gz from neoruntime Releases.

Before starting, confirm that:

  • The target is an NE503 device and the Web console or SSH is available.
  • Web upgrade uses an administrator account; SSH deployment requires root privileges.
  • /data is writable and has enough space: df -h /data.
  • Record the current Firmware Version. Keep power and network connectivity stable during the upgrade.

2. Upgrade Through the Web Console​

Use this method when the device is running and reachable through the Web console.

  1. Open https://<device-ip> and sign in with an administrator account.

  2. Open Settings → Device Info.

  3. Under Firmware & Hardware, find Firmware Version and click its Update button. Do not click Update beside System OS Version.

    Firmware Update dialog

  4. Upload one aipc-hailo15-<version>.tar.gz file.

  5. Confirm that power is stable, select I understand and wish to continue with the upgrade, and click Confirm Update.

  6. Wait for upload, writing, and reboot to finish. Do not refresh the page, click again, or cut power.

  7. After the device comes back online, sign in again and verify Firmware Version.

Success: the device is online again, you can sign in, and Firmware Version shows the target version. If Device offline appears, check power and network, then click Re-detect.

3. Install or Upgrade Through SSH​

Use deploy.sh when the Web entry is unavailable or command-line deployment is required:

scp build/release/aipc-hailo15-<version>.tar.gz root@<device-ip>:/data/
ssh root@<device-ip>
cd /data
tar xzf aipc-hailo15-<version>.tar.gz
cd aipc-hailo15-<version>
./deploy.sh

When Proceed with deployment? [y/N] appears, verify the target and enter y. Success includes:

[deploy]   Deploy successful!
[deploy]   Version: <version>

The install path is /data/aipc. Incompatible packages do not stop the existing services.

Common options:

OptionEffect
--no-configPreserve the device's existing configuration
--statusShow the current version and backup information
--rollbackRestore the previous version from the latest backup

4. Verify or Roll Back​

After signing in again, open Settings → Device Info and confirm that Firmware Version has changed.

Verify the version through SSH:

cat /data/aipc/VERSION

Success: the command prints the complete VERSION content and the version matches the target. To roll back, run the following from the release package directory:

./deploy.sh --rollback

Rollback requires an available device backup.