Checkbox Agent Systemd Service¶
Checkbox snaps supporting Checkbox Remote functionality usually come with a systemd service that can ensure Checkbox Agent is loaded and active.
In the examples below, the checkbox snap is used. For project-specific
checkbox with the name of the Checkbox snap for your
Enabling the service¶
By default, Checkbox snaps should automatically start the systemd service. To make sure it is running, run
$ sudo systemctl restart snap.checkbox.agent.service
Stopping the service¶
In a rare case where you want to have multiple Checkbox snaps installed on the system, it’s necessary to disable all but one service.
To do this, run
$ sudo systemctl stop snap.checkbox.agent.service
You can also press
Ctrl+C on the Checkbox instance controlling that
particular agent, and select
Exit and stop the Checkbox service on the agent
Note that the Agent service will come back up after a reboot.
Whenever you have a problem with misbehaving service, it’s advisable to start troubleshooting by restarting the DUT.
I cannot connect to the Agent from the Controller¶
Check if the service is enabled:
$ sudo systemctl status snap.checkbox.agent.service
The output should state it’s
If it’s not running, make sure the service is enabled.
The Controller connects to the Agent but I’m seeing the wrong test plans¶
There is a chance that you have two services running that compete to listen on the default port.
Try listing statuses of all Checkbox Agent services and make sure only one is running:
$ sudo systemctl status "*checkbox*service*"