Skip to content
myosicam.us

Upgrading the Agent

The MyOsicam agent is a statically compiled Go binary deployed as a systemd service. Upgrades replace the binary in place and restart the service. OScam is not affected at any point — it continues running throughout the upgrade.

Checking whether an upgrade is available

The Agents list in the panel shows the currently installed agent version alongside the latest available version:

  1. Log in to the panel.
  2. In the left sidebar, click Agents.
  3. The Version (installed) column shows the version running on each server.
  4. If a newer version is available, an Update badge appears next to the installed version, and the available version is shown in a lighter style below it.

The safest and most reliable way to upgrade an agent is to re-run the bootstrap installer from the panel. The bootstrap script is idempotent — it stops the existing service, replaces the binary, and restarts the service cleanly.

  1. In the panel, navigate to Agents in the sidebar.
  2. Find the agent you want to upgrade and click Details to open its detail page.
  3. If the agent is Online, you will see the agent’s action buttons at the top of the page. Click Re-run Bootstrap — or, if the agent is Offline or Unknown, the Agent Recovery section shows the Re-run Bootstrap button automatically.
  4. The panel generates a fresh single-use install token and displays the bootstrap command.
  5. Copy the bootstrap command and run it on the OScam server as root.

The bootstrap script:

  1. Stops the existing myosicam-agent service.
  2. Downloads the latest agent binary from the install service.
  3. Replaces the binary at /usr/local/bin/myosicam-agent.
  4. Restarts the service.
  5. The agent re-registers with the panel using the new install token.

Alternative: panel-triggered SSH install

If you want the panel to perform the upgrade over SSH rather than running the bootstrap command manually on the server:

  1. In the panel, navigate to Agents → Install Agent (or use the Install Agent button).
  2. Enter the same SSH credentials you used for the original install.
  3. The panel connects over SSH, runs the bootstrap script, and the agent upgrades itself.

What happens during an upgrade

  • The myosicam-agent service is stopped briefly while the binary is replaced.
  • OScam is not affected. OScam runs independently of the agent and continues serving subscribers without interruption.
  • Once the new binary is in place, systemd brings the service back up. With Restart=always configured, the service restarts automatically even if the stop was unclean.
  • The upgraded agent reconnects to the panel, sends a heartbeat, and the panel shows it as Online within the next heartbeat cycle.

Verifying the upgrade

After the bootstrap completes:

  1. In the panel, open the Agents list.
  2. Confirm the agent’s Version (installed) column shows the new version number.
  3. Confirm the status badge is Online.
  4. If the server previously showed an Update badge, it should now show Up to date.

If the agent does not come back online within a minute, check the service status on the server:

Check the agent service after upgrade
systemctl status myosicam-agent
journalctl -u myosicam-agent -n 50