If you’re having trouble with the Reftab Windows agent, follow this guide for troubleshooting steps.
Agent Requirements: The Windows agent requires .NET 4.6 in order to connect securely with Reftab. It also needs to be installed with administrative rights to run as a service in the background.
Step 1: Make Sure Reftab has Fields Setup for Agent
Log into Reftab as an administrator and click “Settings” > “Agent“.
Next, make sure you have a location and category selected. Then, make sure the fields “guid” and “Last Updated” are highlighted in green.
If you do not have a field for guid, the agent will not connect.
Finally, make sure “Use Agents” is set to “On“
If you do not have a field for “Last Updated” the agent can still connect, however it will become difficult to troubleshoot any issues because you won’t be able to tell the last time it made a connection.
If you do not have these two fields, please click “Asset Categories” and click on your Category you are using for the agent and add “guid” as a text field and “Last Updated” as a date field.
Make sure to save them to your category that you are using for the Reftab agent and click “Save Category” when done.
Step 2: Make sure the agent is running on the Windows PC
You will need to look at Services. You can launch services by opening Start, typing: services then hitting Enter
Find “Reftab Agent” and make sure the status is “Running“
If it is not running, right click and select “Start Service“
Next, go back into Reftab, and check to see if this Windows machine has been created as an asset. If it has the agent is working and you no longer need to troubleshoot.
If you’re having issues with connectivity and the agent had already created an asset in Reftab , check the “Last Updated” field to see if it updated to now. If it has not, move to the next step.
Step 2: Check Event Viewer Logs
If you’re still having issues, you will need to view logs in Windows Event Viewer.
On the windows machine, open the start menu and type “event viewer” and click “open“
Next, click expand “Windows Logs” and click “Application“
Next click “Filter Current Log” and set event source as “Reftab Agent” and click “Ok“
Then, you will be able to see the logs filtered for Reftab Agent. If you see any errors, view these errors to help troubleshoot further.
You can also email any errors to “[email protected]”