Oracle by Example brandingInstalling Oracle Application Performance Management Agent on Microsoft Internet Information Services

section 0Before You Begin

This 10 minute tutorial shows you how to install the APM .NET Agent on Microsoft Internet Information Services (IIS) Server to monitor the sample application running on the IIS server.

What Do You Need?

  • A valid Oracle Cloud account, an Oracle Management Cloud instance, and OMC Administrator role credentials.

    You should have administrator access to download the APM .Net Agent or create a key.

  • IIS Server 7
  • Visual Studio 2013 or Visual Studio Express for Web 2013
  • ASP.NET 4 registered with IIS 7 on your local computer and an ASP.NET 4 application pool assigned to the Default Web Site
  • Administrative rights on your local computer
  • Windows Server 2008 and above

section 1Prerequisites

Before installing the APM .NET Agent, ensure that you have done the following:

  • Generate or download a registration key.
  • Make a backup of the following system configuration files:
    • C:\Windows\System32\inetsrv\config\applicationHost.config
    • C:\Windows\Microsoft.NET\Framework\v4.0.30319\Config\web.config
    • C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG\web.config
    • C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\web.config
    • C:\Windows\Microsoft.NET\Framework64\v2.0.50727\CONFIG\web.config

section 2Importing a Package to IIS

For this example, we're going to be using a new MVC project Sample from Visual Studio 2013

  1. In the Visual Studio home page, click New Project.
  2. From the list of available templates, select Visual C#, select Web, then click ASP.NET Web Application.
    This image shows the ASP .NET Web Application sample project selected.
    Description of the illustration
  3. Enter a name for the application. For example: Sample.
  4. From the available templates, click MVC and click OK.
  5. You now have a working project Sample that you we can export to IIS.
  6. Press F5 to start IIS Express and run your web application in your localhost:port.

section 3Downloading and Installing the APM Agent in an IIS Server

To install the APM .Net Agent on your IIS server:

  1. Log in as administrator to Oracle Management Cloud and click Administration > Agents > Downloads.
  2. Download the NET Agent zip file and extract it in a new folder.
  3. Click the Start menu on your local computer and enter the following command to stop the IIS server:
    iisreset /stop
  4. Ensure that the file and the ApmAgent.msi file is in the same folder in which you downloaded the zip file.
  5. Select and click the ApmAgent.msi executable in the folder.

    The installation wizard is displayed in a new window.

  6. Click Next. Read and accept the terms in the License Agreement.
  7. Select the folder in which you want to install the agent and click Next.
    This image shows the folder to install the .Net Agent.
    Description of the illustration
  8. (Optional) Select Configure a Proxy and specify the proxy information.

    The password that you specify here is encrypted to enhance security.

  9. Click Next.
  10. Enter the required details.

    (Optional) Select Configure Gateways and specify the required details for the fields, Gateway Host and Gateway Port.

    This image shows the fields which require the appropriate details to install the .Net Agent.
    Description of the illustration
  11. Click Next.
  12. In the Set Host Name field, review the default host name, and modify if required.
  13. Select Sample as the application to be monitored from the Monitored Application Configuration screen. Click Next.
  14. Click Install.
  15. After the installation is complete, click the Start menu and enter the following command to start the IIS server:
    iisreset /start
  16. Open the Sample application in any browser window.

    This generates the agent log files and enables the APM agent to start monitoring the application.

section 4Verifying the APM Agent Installation

  1. Log in to the Oracle Management Cloud home page.
  2. Click Administration.
  3. This image shows the main page for Oracle Management Cloud, with the Administration page highlighted.
    Description of the illustration
  4. Click Agents and then click APM Agents.

    The status of the .NET agent is displayed.

  5. This image shows the status of the .Net Agent which you installed.
    Description of the illustration

more informationWant to Learn More?