Installation

Requirements

• Windows Server 2016 or higher
• Internet Information Services 10

Prerequisites

The UI uses the Data Extraction (DX) API v2.1 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.

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.

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