Troubleshooting

If you encounter issues with the STACKIT Server Agent, you can try to perform a first fix with the following troubleshooting steps.

Check STACKIT Server Agent Service Status

Ensure that the STACKIT Server Agent service is running.

Windows (using the Windows Service Manager)

1. Press Win + R to open the Run dialog
2. Type services.msc and press Enter.
3. Find the entry STACKITServerAgent service:
   
4. If the service is stopped, start the service by right-clicking on the service and selecting Start:

Windows (using the PowerShell)

1. Open PowerShell and execute the following command to get the service status:
   Get-Service STACKITServerAgent
2. If the service is stopped, start the service by executing the following command:
   Start-Service STACKITServerAgent

Linux

1. Use the following command:
   systemctl status stackit-server-agent.service

2. If the service is stopped like this…
   
   …start the service by executing the following command:
   systemctl start stackit-server-agent.service

Restart the STACKIT Server Agent Service

If the STACKIT Server Agent Service is already running, but you are experiencing issues, try restarting the service.

Windows (using the Windows Service Manager)

1. Open the Windows Service Manager and find the STACKITServerAgent, as described above
2. Right-click on the STACKITServerAgent, then select Restart:
   

Windows (using the Power Shell)

• Open a powershell and execute the following command:
  Restart-Service STACKITServerAgent

Linux

• Use the following command:
  systemctl restart stackit-server-agent.service

Check Log Files

In case of errors or issues you may encounter in these logs in combination with a malfunctioning STACKIT Server Agent: Please open a ticket so that our STACKIT Support colleagues can take care of your issue.

Windows

Examine the log file (local.log) for any error message or relevant information.

Also check if the correct Service Account Access Token from your Portal project is placed inside the serviceToken.txt file.

Both files are located under C:\Program Files (x86)\STACKIT\STACKITServerAgent:

• In case of errors or issues you may encounter in these logs in combination with a malfunctioning STACKIT Server Agent, please open a ticket, so that our STACKIT Support colleagues can take care of your issue.

Linux

Examine the log file (local.log) for any error message or relevant information by using the following command:

cat /opt/stackit/server-agent/local.log

Reinstall the STACKIT Server Agent

If the above steps did not resolve the issue, consider reinstalling the STACKIT Server Agent:

Windows

1. Uninstall the existing STACKIT Server Agent via “Apps & Features”:
   
2. Confirm the Uninstallation in the next popup.
3. Make sure that the complete folder C:\Program Files (x86)\STACKIT\STACKITServerAgent is deleted. In case there might be some files left after the uninstallation, please delete the whole folder manually.
4. Install the STACKIT Server Agent as described here: Install the Server Agent via Portal

Linux

• Uninstall and reinstall the STACKIT Server Agent in one go by using one of the following commands, depending on the type of Linux you use:

Debian based (e. g. Debian, Ubuntu, Linux Mint):

apt remove -y stackit-server-agent && dpkg -i /tmp/stackit-server-agent.deb

Fedora/RedHat based:

yum remove stackit-server-agent -y && yum localinstall /tmp/stackit-server-agent.rpm -y