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:

    Linux  /opt/takipi
    Windows   C:\Takipi
    macOS   /Library/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.

    Linux 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 either sudo service takipi start -OR- sudo start takipi
    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.
    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 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 servers to your proxy, you'll need to restart the OverOps daemon.

  5. If all these settings seem 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
    Linux /opt/takipi/work/secret.key
    Windows C:\Takipi\work\secret.key
    macOS  /Library/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:

  Stopping Starting
Linux run: sudo service takipi stop run: sudo service takipi start
Windows Run services.msc and stop TakipiService Run services.msc and start TakipiService
macOS run: sudo launchctl unload /Library/LaunchDaemons/com.takipi.service.plist  run: sudo launchctl load /Library/LaunchDaemons/com.takipi.service.plist 


Have more questions? Submit a request