---
title: "Installation"
slug: "wtr-installation"
updated: 2024-06-13T20:49:46Z
published: 2024-06-13T20:49:46Z
canonical: "onpremises.webtrends.help/wtr-installation"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://onpremises.webtrends.help/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

## Requirements

* Windows Server 2016 or higher
* Internet Information Services 10


## Prerequisites

The UI uses the [Data Extraction (DX) API v2.1](https://onpremises.webtrends.help/docs/about-the-data-extraction-api) to access data that has been analyzed in Analytics 9.  Therefore, you must already have existing Webtrends Analytics 9.4.1 and DX servers in your Webtrends environment.

:::(Info) (Note)
Profile key metrics may not be available with versions of Analytics prior to 9.4.1.
:::


## Installation Overview

An installer is available to quickly configure a Webtrends Reporting site in Internet Information Services on a Windows server.  The static assets for the web app are also available in case manually configuring the hosting environment is preferred.

:::(Info) (Note)
Depending on where Webtrends Reporting is being deployed, the Data Extraction API may need to be configured to accept cross-origin requests.  See the [CORS Configuration](https://onpremises.webtrends.help/docs/wtr-configuration#cross-origin-resource-sharing-(cors)) section for details.
:::

### Automatic Installation

To deploy the Webtrends Reporting UI automatically:

1. Ensure you are logged into the server with a local admin user account.
2. Run the installer (`wtr_setup.exe`).
3. Select **Yes** when asked if IIS should be installed.
4. Provide the DX API endpoint.
   * Example: http://myDomain.com/v2_0/ReportService
   * This is where report data will be retrieved.
5. Provide the URL of the Analytics 9 UI.
   * Example: http://myDomain.com:7099
   * This is used for the Analytics 9 link in the account menu, allowing users to quickly access the Analytics 9 UI if needed.
6. Provide a port number for the Webtrends Reporting UI IIS site.
   * If IIS was not installed on the server prior to starting the Webtrends Reporting installation, then port 80 can be used.  The Default Website will be stopped to avoid a conflict.
   * If Webtrends Reporting is being installed on a server that already includes IIS, an unused port will be required.
7. Apply any additional configurations (e.g. security certificates, firewall rules, etc.) after the Webtrends Reporting installation is complete.

### Manual Installation

To deploy the Webtrends Reporting UI manually:

1. Install the Web Server (IIS) with the default features.
2. Install URL Rewrite 2.1.
   * The installer is found in the zip file or can be downloaded here:
	[https://www.iis.net/downloads/microsoft/url-rewrite](https://www.iis.net/downloads/microsoft/url-rewrite)
3. Add a new IIS Application Pool with default options.
4. Add a new IIS site and select the newly created Application Pool.
5. Copy all contents of the `\app` folder in the zip to the physical path of the new site.
6. Create a `config.js` file from `\app\config.js.example`, replacing the DX endpoint and Analytics 9 URL with correct values.