CapaOne Agent Installation
The agent service isn’t added to services.msc
Section titled “The agent service isn’t added to services.msc”Problem
Section titled “Problem”CapaOne Agent service is not being added to the services.msc and therefore cannot be started.
Solution
Section titled “Solution”Create a new enrollment config on CapaOne for Windows
- Open PowerShell as an administrator on the client
- Copy the PowerShell code from CapaOne and paste it into the PowerShell terminal.
- Remove /qn from the code and run the PowerShell code
- Install the CapaOne agent from the GUI and see if the service gets started successfully
- If the CapaOne Agent is not installing, check the antivirus to ensure the CapaOne Agent service is allowed.
The agent service is installed but doesn’t start
Section titled “The agent service is installed but doesn’t start”Problem
Section titled “Problem”The CapaOne Agent installs, and the COA service exists in services.msc, but the service
doesn’t start. Reinstalling the agent doesn’t help. This can happen after the computer was
forced to shut down or restart.
When the agent starts, it unpacks files to C:\Windows\SystemTemp\.net\COA. The agent reuses
this folder when you install it again. If a file in the folder is damaged or missing, the
service stops every time it starts, no matter how often you reinstall.
Uninstall tools such as Revo Uninstaller don’t remove this folder. The agent includes its own .NET runtime, so repairing .NET or Windows doesn’t help either.
Solution
Section titled “Solution”- Uninstall the CapaOne Agent.
- Delete these folders, if they exist:
C:\Windows\SystemTemp\.net\COAC:\Windows\Temp\.net\COA
- Restart the computer.
- Install the agent again.
The COA service starts.
Clean reinstall
Section titled “Clean reinstall”If the service still doesn’t start, remove everything the agent leaves on the computer before you install it again.
-
Uninstall the CapaOne Agent.
-
Delete the
COAservice, if it still exists. In a command prompt as an administrator, runsc.exe delete COA. -
Delete these folders, files, and registry keys, if they exist:
Type Location Folder C:\Program Files\CapaSystems\COAFolder C:\ProgramData\CapaSystems\COAFolder C:\Windows\SystemTemp\.net\COAFolder C:\Windows\Temp\.net\COAFile C:\Windows\System32\config\systemprofile\AppData\Local\CoaRecovery.jsonRegistry key HKLM\SOFTWARE\CapaSystems\CapaOneAgentDon’t delete the whole
CapaSystemsfolder or theHKLM\SOFTWARE\CapaSystemskey. CapaInstaller uses them too. -
Restart the computer.
-
Install the agent again.
To clean up many computers, you can write your own script that removes the locations in the table. Test it on one computer first.
The computer can appear as a new device in CapaOne after a clean reinstall. Delete the old device in the CapaOne portal.
Antivirus
Section titled “Antivirus”If the service still doesn’t start, check whether your antivirus has quarantined or removed an
agent file, such as Serilog.Sinks.File.dll. Restore the file, and then do a
clean reinstall.
To stop it from happening again, you can exclude these folders from antivirus scanning:
C:\Program Files\CapaSystems\COAC:\Windows\SystemTemp\.net\COA
These exclusions are a recommendation only. Exclusions reduce the protection on the computer, so check with your security team before you add them.