Installation Troubleshooting

Contents

"OverOps not active" message

Secret Key Lost

Restarting the OverOps Daemon

 

"OverOps not active" message

When setting up OverOps, an installation dialog will guide you on how to install OverOps and connect it to your JVM. At the end of this process you'll be asked to test the installation. If the setup process wasn't completed or was unsuccessful, a message saying "OverOps is not active" will be displayed. Here are the different messages that might be displayed in this dialog, with possible reasons and solutions:
OverOps is not active - No communication
 
This message means that the OverOps service installed on your machine/server was unable to communicate with OverOps' backend. If you get this message, try these solutions:
  1. Make sure OverOps is installed on the same machine you wish to monitor. Please verify that the Takipi folder exists on that machine: Win: C:\Takipi | macOS: /Library/Takipi | Linux: /opt/takipi If this folder doesn't exist, please re-install OverOps.
  2. If OverOps is installed, make sure Takipi’s service is running on your machine. The service needs to be running continuously and communicating with OverOps' backend. Windows: open your services screen and make sure the Takipi-service is running. If the Takipi service is not running, right click and start it. Linux / macOS: Run in a terminal: ps -ef | grep -v grep | grep takipi-service and make sure there is a PID. If the Takipi service is not running, start it by running: Linux: sudo service takipi start -OR- sudo start takipi macOS: sudo launchctl load /Library/LaunchDaemons/com.takipi.service.plist
  3. Check your internet connection - If OverOps was installed and the service is running on your server, make sure you're able to connect to the internet. Takipi requires a continuous internet connection to function properly.
  4. Make sure your proxy server / VPN is not blocking OverOps. OverOps communicates via port 443 (Standard HTTPS). If you're working via a proxy server or a local / company firewall, please make sure:
    • Port 443 is open for outgoing HTTPS/SSL communication.
    • Takipi-service.exe (Win) / takipi-service (Linux / macOS) is authorized to send and receive data.
    • That your proxy allows you to access: backend.takipi.com, prod1-sparktale.s3.amazonaws.com, prod1-frontend-sparktale.s3.amazonaws.com, prod1-demo-sparktale.s3.amazonaws.com, d16f8x4wee2da2.cloudfront.net. (After adding these server to your proxy, you'll need to restart the OverOps daemon.
  5. If all these settings seems to be correct, but you still see the same message while testing the connection, use the live chat or email us at: hello@overops.com.
OverOps is not active - No connected JVMs found / Only 32bit JVMs found / -agentlib:TakipiAgent argument is misplaced
 
This message means that OverOps was not connected to a running JVM on your machine, or was connected incorrectly. After installing OverOps on your machine/server, you will need to connect OverOps to the JVMs/apps that you'd like to monitor, and then start those apps. (Click here for full connection instructions) If you get this message, try these solutions:
  1. Make sure the -agentlib:TakipiAgent is set up correctly (located in the right place, no mistypes, with a space separating it from other startup arguments) when you start your JVM. Also note that -agentlib is a JVM argument and it must be written before the -jar/-cp/-classpath arguments. Be sure you followed the specific instructions for the launcher you’re trying to connect OverOps to. If placed incorrectly, OverOps will not be able to connect and monitor your JVM.
  2. Make sure your JVM is running when you click on “test connection” - If your JVM/app has not been started, OverOps will not be able to monitor it for exceptions/slowdowns.
  3. Verify that OverOps was successfully loaded: Add -Dtakipi.silent=false to the startup arguments. This will add notifications to your app's console, and allow you to get more info regarding the installation. If OverOps was loaded, these messages should be displayed there: [OverOps is loading] followed by [OverOps loaded successfully].
  4. Make sure you added the JVM argument to the same JVM you’re trying to monitor.
  5. Make sure you’re connecting the OverOps agent to a 64-bit JVM. OverOps does not monitor 32-bit processes. If you’re running a 32-bit JVM, download 64bit Java and try again.
  6. Make sure you’re running an Oracle / OpenJDK Java. macOS users: Apple’s JVMs are not supported. Please download Oracle’s 64-bit Java and try again.
  7. OverOps was loaded, but you still get an error message? Make sure you’ve connected OverOps to a JVM that contains your own code. Since OverOps was designed to find errors within your code, it won’t monitor known 3rd party libraries. If the JVM you’re running only contains 3rd party code, you might get an error message when testing the installation. Please connect OverOps to a JVM containing your own code and try again. Note: If you'd like to turn off these limitation and monitor 3rd party code, click here for instructions.
  8. Everything is set up correctly, but you’re still getting this message? We’re happy to help. Click here or use our live chat to get in touch.

Secret Key Lost

If you've lost or forgotten your secret key, you can still retrieve it through one of the following methods:

  1. Search for the key in your inbox. The key which was generated for you when you signed up was emailed to you from hello@overops.com.
  2. When you install OverOps on a machine, the key is stored in the secret.key file located in
    • Windows: C:\Takipi\work\secret.key
    • Mac: /Library/Takipi/work/secret.key
    • Linux: /opt/takipi/work/secret.key

You can also generate a new key. However, data which was collected and encrypted using your previous key will no longer be available to you - Learn more.


Restarting the OverOps Daemon

If you want to close or restart the OverOps daemon, do the following: On Windows - Run services.msc and start/stop TakipiService. On Linux - To stop it run:sudo service takipi stopand to start it run:sudo service takipi startOn Mac - To stop it run:sudo launchctl unload /Library/LaunchDaemons/com.takipi.service.plistand to start it run:sudo launchctl load /Library/LaunchDaemons/com.takipi.service.plist
Have more questions? Submit a request