Troubleshooting SaaS Trial Installations
This article addresses common issues you may encounter during your SaaS trial installation, and provides solutions to these issues.
Relevant Installation Video
- Agent and Collector installation on MAC
- Agent and Collector installation on Windows 10
- Docker installation Video
- Agent and Collector installation on Linux
Connection Statuses
Status | Explanation | Next Steps |
---|---|---|
OverOps isn't Active | No collectors are connected | Follow the instructions in the "Install OverOps" step. |
Micro-Agent isn’t Attached | This status appears if you've installed OverOps successfully but there's no Micro-Agent attached to your Java or .NET application | Follow the instructions in the "Attach Agent" step to attach a a Micro-Agent to your application. |
OverOps is Active | The Collector and Micro-Agent are both connected | You've completed the installation and everything is good to go! |
Common Issues in a SaaS Trial Installation
Problem: Test Installation fails in the "Install OverOps" step.
Problem | Additional Explanation | Solution |
---|---|---|
You clicked Test Installation and received the following error: "OverOps backend wasn’t able to communicate with your Collector(s)" | Linux | Try restarting the service as follows: |
Windows | Try restarting the service as follows: | |
macOS | Try restarting the service as follows: |
Problem: Test Agent connectivity fails in the "Attach Agent" step.
Problem | Additional Explanation | Solution |
---|---|---|
You clicked "Test Agent connectivity" and received the following error: "Couldn’t find a running application that has an attached OverOps Micro-Agent". | This message means that either:
| Start the application that is attached to the OverOps Micro-Agent so that OverOps can monitor the application. |
| Stop the collector macOS | |
| Free enough diskspace that you have at least 12% of free disk space available. |
Problem: You can't find the OverOps installation folder
Problem | Additional Explanation | Solution |
---|---|---|
You can't find the OverOps installation folder on your machine. | The OverOps installation directory/folder is mentioned in some of the procedure in the "Attach Agent" step. If you selected a custom location during the installation when asked, use that location. | Look for the default locations of the installation folder by operating system: Windows: |
Problem: You can't proceed to the OverOps dashboard
Problem | Additional Explanation | Solution |
---|---|---|
You're unable to access the OverOps dashboard. | This means that you haven't fully completed steps 1-3 in the OverOps trial installation wizard. | Follow the instructions in the installer wizard to complete steps 1-3. |