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

Connection Statuses

304

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.

627

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
After running the installation script, you're not able to find the OverOps service by running ps -ef | grep takipi

Try restarting the service as follows:
Run sudo /opt/takipi/etc/takipi-start.

Windows
If you're still getting this message after completing the downloaded installer steps successfully, you may need to restart the OverOps service.

Try restarting the service as follows:
Run services.msc and then start/stop the TakipiService.

macOS
If you're still getting this message after completing the downloaded installer steps successfully, you may need to restart the OverOps service.

Try restarting the service as follows:
Run sudo launchctl load /Library/LaunchDaemons/com.takipi.service.plist

Problem: Test Agent connectivity fails in the "Attach Agent" step.

644

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:

  1. You haven't attached the Micro-Agent to your application

  2. The Micro-Agent was attached an application that's not currently running.

Start the application that is attached to the OverOps Micro-Agent so that OverOps can monitor the application.

  1. The user with which you are running your application does not have access to the agent files/folder

Stop the collector macOS
Change the Owner of Takipi to the user:group you are running your application with
Run sudo chown -R <user:group> /Library/TakipiRestart the collector

  1. The Collector requires as a minimum 10% of FREE disk space.

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.
Otherwise, use the default location of this folder, which matches the OS of your computer.

Look for the default locations of the installation folder by operating system:

Windows: C:\Takipi\installation.key
Mac: /Library/Takipi/installation.key
Linux: /opt/takipi/installation.key

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.

Docker Trial installation Video

Mac Trial installation Video

Windows Trial installation Video

Linux Trial installation Video