In this article, you will learn how to troubleshoot issues regarding the HEIMDAL Agent installation and the HEIMDAL license key activation.
heimdal-clienthost.service is loaded (instead of running) and it is not showing up in the Heimdal Dashboard -> Active Clients
BEHAVIOR: the HEIMDAL Agent's Client Host service is loaded (instead of running) and it is not showing up in the Heimdal Dashboard -> Active Clients. The service is setting a default policy Free key.
User 05/09/2023 12:34 ● heimdal-clienthost.service - Heimdal ClientHost
Loaded: loaded (/etc/systemd/system/heimdal-clienthost.service; enabled; vendor preset: enabled)
Active: active (running) since Tue 2023-09-05 11:25:18 UTC; 8min ago
Main PID: 624726 (dotnet)
Tasks: 14 (limit: 9425)
Memory: 20.8M
CGroup: /system.slice/heimdal-clienthost.service
└─624726 /usr/share/heimdal-utils/dotnet /usr/sbin/heimdal/Heimdal.ClientHost.dll
Sep 05 11:25:18 test systemd[1]: Started Heimdal ClientHost.
Sep 05 11:25:18 test heimdal-clienthost[624726]: CoreServiceBaseUrl: https://rc-coreservice.heimdalsecurity.com
Sep 05 11:25:18 test heimdal-clienthost[624726]: CoreServiceBaseUrl: https://rc-coreservice.heimdalsecurity.com
Sep 05 11:25:18 test heimdal-clienthost[624726]: CoreServiceBaseUrl: https://rc-coreservice.heimdalsecurity.com
Sep 05 11:25:18 test heimdal-clienthost[624726]: Now we have /etc/apt/sources.list
Sep 05 11:25:18 test heimdal-clienthost[624726]: CoreServiceBaseUrl: https://rc-coreservice.heimdalsecurity.com
Sep 05 11:25:18 test heimdal-clienthost[624726]: CoreServiceBaseUrl: https://rc-coreservice.heimdalsecurity.com
Sep 05 11:25:20 test heimdal-clienthost[624726]: Heimdal.ClientHost.Workers.PolicyWorker[0] will set default policy Free key: 00000000-0000-0000-0000-000000000000
Sep 05 11:25:20 test heimdal-clienthost[624726]: Heimdal.ClientHost.Workers.PatchingWorker[0] [Patching] PatchingWorker starting at: 09/05/2023 11:25:20 +00:00
Sep 05 11:25:20 test heimdal-clienthost[624726]: Microsoft.Hosting.Lifetime[0] Application started. Hosting environment: Production; Content root path: /usr/sbin/heimdal
user@testenvironment:~$
SOLUTION: To solve this issue, you need to create a license.key file (with the Heimdal license key inside) in the /usr/sbin/heimdal/ folder. Here are the steps on how to do it:
1. Open the Terminal, run the following command line and press Enter:
cd /usr/sbin/heimdal/
2. Run the following command line and press Enter:
sudo nano license.key
3. Paste the Heimdal license key inside the file and save the file by pressing CTRL + X. Press Y (Yes) to Save modified buffer and Enter.
4. Restart the heimdal-clienthost service with the following command line:
sudo systemctl restart heimdal-clienthost
5. Check the status of the heimdal-clienthost service again (sudo systemctl status heimdal-clienthost) or look in the Heimdal Dashboard -> Active clients to see if the endpoint shows up.