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.
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:
- Install Usage Archiver
- Install Overwatch
- Create and configure the Overwatch server on IIS 7 or IIS 6, as described below
- Configure the Web application
...and can be found here:
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:
- In Application Studio, enable the Server application property Track Usage.
- Find the Usage Archiver zip file at the Verivo product delivery location:
Shared\Pyxis Mobile 7.3\Overwatch\UsageArchiver.zip
- Extract the contents of the zip file to any location.
Note: Keep the extracted files in this location; otherwise, the Usage Archiver cannot execute.
- From the command line, run the Usage Archiver as follows:
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.
- 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 as follows:
- Download the Overwatch zip file from the Verivo product delivery location:
Shared\Pyxis Mobile 7.3\Overwatch\Overwatch_Raw.zip
- Extract the files on the desired server host.
- 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:
- Open IIS 7.
- In the Connections pane of the IIS console, navigate to the Web server host where you unzipped Overwatch earlier.
- Right click and select the menu option Add Application
- 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.
- Click OK.
- Configure the new virtual directory: return to the Connections pane of the IIS console and expand Default Web Site.
- Click the new virtual directory to set properties.
- In the center pane, open the Default Document and move index.html to the top priority position.
- 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:
- Open IIS 6.
- In the left pane of the IIS console, navigate to the Web server host where you unzipped Overwatch earlier.
- Right click and select the menu option New > Virtual Directory.
- In the Virtual Directory Alias page of the Virtual Directory Creation wizard, enter the alias for the Web site to host Overwatch. Click Next.
- In the Web Site Content Directory page of the wizard, point to the location where you installed Overwatch. Click Next.
- In the Access Permissions page of the wizard, allow Read and Run scripts permissions. Click Next and Finish.
- 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.
- On the Documents tab of the selected virtual directory Properties window, set the default document as index.html. Click Apply.
To launch Overwatch, from a browser go to the Overwatch URL:
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.