DocumentationAPICommunitySupport
GuidesAPI
DocumentationAPICommunitySupportLog In

## Before You Begin

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 available. This is required as part of the installation wizard.

Also make sure you have the installation key available (see step 3 below).

  1. Download the .NET installer from [this link](🔗), which points to the latest msi installer. The OverOps MSI deploys the relevant files (.dll, libs, db) under the C:\Takipi directory. 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.

772


  1. Define your installation preferences: 3.1 Enter your installation key (aka secret key), which you can find in your welcome email or in app.overops.com in the Environments window (accessible by click **Settings** in the top navigation bar and then **Manage Environments**). 3.2 Select the "Install (only) agent" option.

  2. Click Next to continue.

772


  1. 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 Path location enables OverOps to attach your sources automatically when resolving an event. You can use a semi-colon ";" to delimit multiple paths. 5.2 Make sure that the 'Install .NET agent' option is selected. 5.3 Enter the Program Database (PDB) path to the Micro-Agent. You can use a semi-colon ";" to delimit multiple paths.

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.

** You'll need to verify that the user that the application is running under has read permissions to the PDB and Source folder. **

**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.

498


  1. You can now click **Install** to begin the installation, or select advanced options by clicking **Advanced**.

772


  1. Specify an alternative path to the Java installation path (for the Collector) and then click **Next**.

519


  1. Proxy settings: If required, enter your proxy settings and then click **Next**. To verify that the proxy settings are correct, click **Test connection**.

522


  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.

523


  1. When the installation completes, click **Finish**.

  2. You'll now need to add these Collector parameters to the [agent.properties file](🔗):

  • `takipi.collector.host=<collector_host>`

  • `takipi.collector.port=<collector_port>`

Note

The installation process for IIS and standalone applications is the same process; however, the process of attaching the Micro-Agent to the application differs. See [Attach the .NET Micro-Agent](🔗) for details.

## Silent installation

see [here](🔗)



Make sure Argument INSTALL_COLLECTOR is set to 0!