GuidesAPI
DocumentationAPICommunitySupportLog In

OverOps for .NET on Windows

This article walks you through the process of installing OverOps on your laptop or local PC .NET application using Windows. Remember to verify that you have these software and hardware requirements in place before beginning.

Prerequisites

  1. You'll need an installation key for this procedure. The key is provided by OverOps for each of your environments.
  2. If your environment requires the use of an HTTP or HTTPS proxy to access external web sites, make sure you have your HTTPS proxy settings on-hand, since this is information you'll need to provide as part of the installation wizard.

Install the .NET Micro-Agent and Collector

  1. Download the latest MSI installer for the .NET Agent/Collector - download link.
    Note that the OverOps MSI deploys the relevant files (.dll, libs, db) under the OverOps directory (C:\Takipi by default). In addition, the MSI sets environment variables for the CLR used by the IIS to load the Micro-Agent.
  2. In the Welcome screen, click Next to run the installer.
  1. Enter your installation key (aka secret key), which you can find in your welcome email or in app.overops.com in the Manage Environments window.
  2. Select the "Install agent and collector" option and click Next to continue.
  1. In the next screen, set the source and PDB location:
    5.1. If you want your sources to be attached automatically to the Automated Root Cause (ARC) screen, enter your source location. Providing the source file location enables OverOps to attach your sources automatically when resolving an event.
    5.2 Make sure that the 'Install .NET agent' option is selected.
    5.3 Enter the Program Database (PDB) path to the Micro-Agent (see note below for a detailed explanation).

📘

Why is the PDB File Path Necessary?

The PDB is a file for storing debugging information about an application, which is generated during the compilation phase. OverOps uses this file to extract variable names. When compiling and running on the same machine, the default location will be near the generated EXE.

For OverOps to fully diagnose your errors and exceptions, it needs to have access to the PDB files. If you don't specify the path, the ARC screens will only provide partial and inaccurate information.The PDB is a file for storing debugging information about an application, which is generated during the compilation phase. OverOps uses this file to extract variable names. When compiling and running on the same machine, the default location will be near the generated EXE.

For OverOps to fully diagnose your errors and exceptions, it needs to have access to the PDB files. If you don't specify the path, the ARC screens will only provide partial and inaccurate information.

Installing on IIS
When installing the .NET Micro-Agent for IIS, because of the way IIS runs, you'll need to implement one of the following options to ensure that OverOps can access the PDB files for your application:

Option 1. Use the PDBs that exist in the IIS publish folder, for example: C:\inetpub\wwwroot\MyApplication
Option 2. Verify the PDB folder Read permissions for the following users: IUSR and IIS_IUSRS

5.4 The Dump files option is selected by default; if you clear it, OverOps will not receive information about any problems encountered by the .NET Micro-Agent.

  1. Click Next to continue.
  1. You can now click Install to begin the installation, or select advanced options by clicking Advanced.
  1. Specify an alternative path to the Java installation path (for the Collector) and then click Next.
  1. Proxy settings: If required, enter your proxy settings and then click Next. To verify that the proxy settings are correct, click Test connection.
  1. Alternative installation path: If you chose to install OverOps in a location other than the default (C:/Takipi), enter the installation path here and then click Install to begin the installation process.
  1. When the installation completes, click Finish.

Silent installation instructions

  1. Click here to download and run the OverOps MSI installer.

  2. From an administrative command line run:
    msiexec.exe /i [path\to\Takipi.msi] SK="[installation key]" COLLECTOR_HOST=[IP of collector] COLLECTOR_PORT=6060 SUPPORT_DOT_NET=1 SOURCES_DIR=[Path_to_source_directory] PDB_DIR=[Path_to_PDB_directory] ENABLE_DUMPS=1

🚧

When only installing the AGENT make sure argument INSTALL_COLLECTOR is set to 0.

❗️

If Overops is already installed you cannot reinstall (msiexec.exe /i) overops with different parameters again.

Argument

Description

Default

SK

Mandatory - Environment Key

N/A

INSTALL_COLLECTOR

Optional - Install Collector 1=Yes, 0=No will install the agent only!

1

COLLECTOR_HOST

Optional - Domain name or IP address of the Collector

blank

COLLECTOR_PORT

Optional - Port number on which collector is listening. Typical default is 6060.

blank

SUPPORT_DOT_NET

Optional - Install .net micro Agent libraries 1=Yes, 0=No

0

SOURCES_DIR

Mandatory with DOT_NET support - Path to Source Directory

blank

PDB_DIR

Mandatory with DOT_NET support - Path to PDB Directory

blank

ENABLE_DUMPS

OPTIONAL with DOT_NET support - allows dumps file collection by Overops 1=YES, 0=NO

1

Attach the Micro-Agent to Your Application

  1. Follow the steps to attach the .NET Micro-Agent. After the connection is established, the application status will show that OverOps is active.
  2. Verify that your application throws exceptions.