Skip to content

Updating the Agent on a Teltonika

Initial Checks

Web Interface

If the agent version does not appear in the Monitoring section of the web interface, the agent is out-of-date.

To verify:

  1. Log in to the web interface: Open the Alemca web console.
  2. Select the device: Search for and click the relevant device.
  3. Open Monitoring: The Monitoring panel is on the right-hand side.
  4. Show all metrics: Click Show more to display every metric.
  5. Check the version_agent field: Make sure the version_agent metric is visible.
    If it is missing, the agent needs to be updated.

SSH Access

Because the agent is already installed, you can update it directly over SSH.

Steps:

  • Create a connection link: You need a connection link to reach the device via SSH.
    Create an SSH session in the web interface:

  • Open the web console: Log in and select the target device.

  • Go to the Remote tab: Click Remote.

  • Create an SSH session under Direct Access:

    • Protocol: choose tcp
    • Port: enter 22 (the SSH port)
    • Session duration: pick a duration—1 h is usually enough.
    • Create Session: click Create Session.

  • Copy the connection link: Click the copy icon to grab the device’s SSH link.

  • SSH to the device: In a terminal, run:

ssh root@<connection_link>

Example

The command will look like this:

ssh root@fr04.remote.alemca.tech -p 12345

Check Free Space

Run:

df -h
  • Ensure the device has at least 3 MB free before updating.
    Look at the Available column on the line where Mounted on is simply /.

Agent Update Procedure

  1. Identify the device architecture:

Execute on the device:

cat /etc/os-release

Or, on a Teltonika device:

cat /etc/openwrt_release

Note the value of OPENWRT_ARCH; this is the device’s architecture.

  1. Download the latest agent:
  2. Visit the official repository: http://repo.alemca.io/#/aca04-agent-alemca/latest/.
  3. Go into the opkg folder (Teltonika devices use opkg).
  4. Copy the .ipk download link that matches your architecture.

Example

For an arm_cortex-a7_neon-vfpv4 architecture, the file is:

agent-alemca-arm_cortex-a7_neon-vfpv4-latest.ipk
  1. Install the agent on the device:

On the device, run (replace <file_link> with the direct .ipk URL):

opkg install <file_link.ipk>

Example

Your command should look like:

opkg install http://repo.alemca.io/*/*/*/*/agent-alemca-*****-latest.ipk
  1. Reboot the device:

Apply the changes:

reboot

After rebooting, verify that version_agent now appears in the Monitoring section of the web interface.

Info

Displaying the version on the web platform can take a little time.
Please wait a few moments, or try clearing your browser cache to speed things up.

If the field is still missing after a few minutes

The configuration is likely incorrect.
In that case, edit the configuration file and repeat the above steps in order.