Overwatch Installation Guide

Overwatch is a Web application that provides reports on their Verivo usage activity and metrics. With Overwatch, you can sort and refine data by individuals, dates, and activities. Overwatch provides a collection of charts, graphs, and reports that help you track mobile activity, such as most prevalent device, model or carrier, screen visit metrics, and response-time performance trends.

Prerequisites

You must have:

  • Your installed software version of Verivo must be 7.1 or higher.
  • Administrative privileges to create virtual directories in Internet Information Services, version 7 (IIS 7) or 6 (IIS 6).
  • Microsoft .NET Framework v4.0 or higher

Installation steps are:

  1. Install Usage Archiver
  2. Install Overwatch
  3. Create and configure the Overwatch server on IIS 7 or IIS 6, as described below
  4. Configure the Web application

...and can be found here:

http://appstudio.verivo.com/display/coredoc/Using+Overwatch

Install Usage Archiver

Usage Archiver is a Windows-only service. You can install only one instance of the service on a given computer, with only one configuration.

To install and configure Usage Archiver:

  1. In Application Studio, enable the Server application property Track Usage.
  2. Find the Usage Archiver zip file at the Verivo product delivery location:

Shared\Pyxis Mobile 7.3\Overwatch\UsageArchiver.zip

  1. Extract the contents of the zip file to any location.

Note: Keep the extracted files in this location; otherwise, the Usage Archiver cannot execute.

  1. From the command line, run the Usage Archiver as follows:

C:\WINDOWS\Microsoft.NET\Framework\v4.0.xxxx\installutil
   unzip-dir\UsageArchiverService.exe

Note: The command line shown above assumes a standard installutil.exe location.  Be sure to set unzip-dir to the directory where you extracted Usage Archiver files.

  1. Edit UsageArchiverService.exe.config as required by your environment.  These settings are the connection parameters for your Verivo database. The distributed file with placeholder and default database connection settings is shown below.

<add key="Usage_ConnectionNickName" value="CONNECTION" />
    <add key="Usage_DataSource" value="SERVER_NAME" />
    <add key="Usage_Catalog" value="DATABASE_NAME" />
    <add key="Usage_UserID" value="USERID" />
    <add key="Usage_Password" value="ENCRYPTED_PASSWORD" />
    <add key="Usage_Timeout" value="30" />
    <add key="Usage_DBCommandTimeout" value="1800"/>

    <add key="PyxisMobile_ConnectionNickName" value="CONNECTION" />
    <add key="PyxisMobile_DataSource" value="SERVER_NAME" />
    <add key="PyxisMobile_Catalog" value="DATABASE_NAME" />
    <add key="PyxisMobile_UserID" value="USERID" />
    <add key="PyxisMobile_Password" value="ENCRYPTED_PASSWORD" />
    <add key="PyxisMobile_Timeout" value="30" />
    <add key="PyxisMobile_DBCommandTimeout" value="1800"/>

Note: Usage_Password must be set to the encrypted password that is used in the Web server's web.config file.

Install Overwatch

Install Overwatch as follows:

  1. Download the Overwatch zip file from the Verivo product delivery location:

Shared\Pyxis Mobile 7.3\Overwatch\Overwatch_Raw.zip

  1. Extract the files on the desired server host.
  2. Edit the Overwatch Web.config file as required by your environment.  The distributed file with placeholder and default settings is shown below.

<add key="DataSource" value="DB_SERVER\INSTANCE" />
    <add key="Catalog" value="DB_NAME" />
    <add key="UserID" value="DB_LOGIN" />
    <add key="Password" value="ENCRYPTED_PASSWORD" />
    <add key="UserDataFilter" value="" />
    <add key="TimeOut" value="30" />
    <add key="TopN" value="10" />
    <add key="MinimumRequest" value="10" />
    <add key="ApplicationCookie" value="RENAME_ME"/>.

Note the following property settings:

  • Password must be set to the encrypted password that is used in the Web server's web.config file
  • If you have multiple instances of Overwatch, be sure to set ApplicationCookie to a unique value in each instance's Web.config file; otherwise, the various instances are liable to share settings.

IIS 7 Configuration

You configure Internet Information Services (IIS) 7 in order to create a virtual directory for the Web site that hosts Overwatch:

  1. Open IIS 7.
  2. In the Connections pane of the IIS console, navigate to the Web server host where you unzipped Overwatch earlier.
  3. Right click and select the menu option Add Application
  4. In the Add Application dialog, set the following fields:
  • Alias: Enter an alias name.
  • Physical path: Point to the location where you installed the Verivo application server. Creating the virtual directory as an application enables it for ASP.NET.
  1. Click OK.
  2. Configure the new virtual directory: return to the Connections pane of the IIS console and expand Default Web Site.
  3. Click the new virtual directory to set properties.
  4. In the center pane, open the Default Document and move index.html to the top priority position.
  5. Overwatch is a 32 bit application. If you run IIS 7 in a 64 bit environment, enable IIS to support 32 bit applications:
  • Double-click Application Pools for your server in the Connections pane.
  • From the Application Pools center pane, right-click the pool hosting the Verivo application server and select Advanced Settings.
  • In the Advanced Settings window, in the General section, set Enable 32 Bit Applications to True.
  • Click OK.

IIS 6 Configuration

You configure Internet Information Services (IIS) 6 in order to create a virtual directory for the Web site that hosts Overwatch:

  1. Open IIS 6.
  2. In the left pane of the IIS console, navigate to the Web server host where you unzipped Overwatch earlier.
  3. Right click and select the menu option New > Virtual Directory.
  4. In the Virtual Directory Alias page of the Virtual Directory Creation wizard, enter the alias for the Web site to host Overwatch. Click Next.
  5. In the Web Site Content Directory page of the wizard, point to the location where you installed Overwatch. Click Next.
  6. In the Access Permissions page of the wizard, allow Read and Run scripts permissions. Click Next and Finish.
  7. Configure the new virtual directory by returning to the left pane of the IIS console. Right-click the new virtual directory—the new alias name—and select Properties.
  8. On the Documents tab of the selected virtual directory Properties window, set the default document as index.html. Click Apply.

Launching Overwatch

To launch Overwatch, from a browser go to the Overwatch URL:

http://server-name/overwatch-dir/SystemOverview.aspx

where server-name and the server where you installed Overwatch and overwatch-dir is the virtual directory name you chose when you installed Overwatch.

where server-name and  overwatch-dir are the server and virtual directory of the Overwatch installation, respectively.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk