X Tracking Setup

Owned by Michelle Cabaya
May 13, 2022

Table of Contents

Overview

X Tracking allows the plotting of orders, routes and delivery personnel on a web-based map in real time. This means that delivery personnel can be tracked to their last GPS fix, or if GPS devices are not used, to their last pickup or delivery. Unassigned and assigned orders are shown in additional to route stops that are plotted in sequential order for a true graphical representation of a single or multiple routes. Several reports can be created, such as the "Driving Distance" report which shows true GPS driving distance the delivery personnel. All of these features add up to an easy and intuitive tool that can be used to more effectively manage the fleet. 

Installation Notes

Before X Tracking can be used, ensure at least X Dispatch Server 11.0.7 is installed and X Internet .NET is configured on web server. X Dispatch Server contains all necessary files required to use X Tracking.  To learn how to install and configure X Dispatch Server, X Internet and .NET application pools, please review the following knowledge base articles:


These instructions assume the Connexion folder is located in C:\Program Files\Connexion or C:\Program Files (x86)\Connexion. If it is located elsewhere modify procedure for true location.


Installation and Configuration

 Internet Information Server (IIS) 7.x

Installation of X Tracking on IIS 7.x

  1. Install X Dispatch Server to default path of C:\Program Files\Connexion or C:\Program Files (x86)\Connexion.
  2. Open IIS Manager : Start > Programs > Administrative Tools > Internet Information Services (IIS) Manager and expand "Sites" node.
  3. Right click on web site to which X Internet .NET should be added. It should already be an existing X Internet ASP site. Select "Add Application."
  4. Set "Alias" to "XInternet."
  5. Set "Physical Path" to XInternet folder:
    C:\Program FilesConnexionXInternet or C:Program Files (x86)Connexion.
    Set Application Pool to: "    .NET 2.0." 
    Change "Connect As" user to "cxtbll" user account.
  6. Click "Test Settings..." to verify path and user account are accurate.
  7. Select newly created "XInternet" application and open "Application Settings" section.
  8. Set "AspAddress" value under "Application Settings" to URL location of ASP site: " / " is fine if virtual directory is created under ASP web site and ASP web site is default web site in IIS. Select "Add" under "Actions" to add new "Application Setting" named "RemoteServer."  Enter IP address of X Dispatch Server.
  9. Add (for new installations) or modify (for upgrades) the key indicated in image with settings below.
  10. Continue with X Tracking installation.

If upon completion of this article X Tracking doesn't work, "Impersonation" may need to be enabled.  Do this in "Authentication Settings."  Set to same user as Application.

                    

Connect to Legacy X Internet

  1. Find "global.asa" file in directory where existing ASP site is located (usually C:inetpubwwwrootxinternet). Right click and choose "Edit".
  2. In "Sub Application_Start" section set application variable "XInternetURL" to new XInternet site location. "Application(XInternetURL) = /XInternet/" is fine if "Virtual Directory" was added to existing website and was given "XInternet" alias.

Accessing X Tracking

  1. Once X Internet .NET is configured, access X Tracking via URL, default is: http://127.0.0.1/xinternet/xtracking/xtracking.aspx
  2. Update X Tracking URL in "Options -> Company Tab" of X Dispatch.

The URL domain / server of the X Tracking URL may differ based on network setup, but path should still be the same. Replace 127.0.0.1 with URL domain / server data.   
X Tracking may be used secured, so change "http" to "https" if desired.

 Internet Information Server (IIS) 6.X

Installation of X Tracking on IIS 6.x

  1. Open IIS Manager by clicking: "Start -> Programs -> Administrative Tools -> Internet Information Services (IIS) Manager." Expand "Web Sites" node. Right click "X Internet" site.  Select "New -> Virtual Directory."
  2. The "Virtual Directory Creation Wizard" displays.  Enter "XInternet" into "Alias" and press "Next."
  3. Enter "C:\Program Files\Connexion\XInternet" as path to XInternet folder and press "Next."
  4. On "Virtual Directory Access Permission" window, select "Read" and "Run scripts (such as ASP)." checkboxes and press "Next."
  5. Right Click new "XInternet" virtual directory and select "Properties."
  6. Select "Virtual Directory" tab and verify "XInternet" virtual application is running under ".Net 2.0" Application Pool.
  7. While in "Virtual Directory" tab, verify "Execute permissions" is set to “Scripts Only."

  8. Select "ASP.NET" tab. Verify "ASP.NET 2.0" is set to "2.0.50727."
  9. Click "Edit Configuration" button.. On "General" tab set the AspAddress value under Application settings to the URL location of the ASP site - / is fine if the Virtual Directory is created under the ASP web site and the ASP web site is the default web site in IIS.  Press "OK."
  10. Add Silverlight MIME types to server by right clicking on "Local Computer" and selecting "Properties."
  11. Click "MIME Types" button.
  12. Click "New."
  13. In "MIME Type" window enter the three MIME types described below.

    • Extension: .xap
      MIME Type: application/x-silverlight-app
    • Extension: .xaml
      MIME Type: application/xaml+xml
    • Extension: .xbap
      MIME Type: application/x-ms-xbap

Accessing X Tracking

  1. Once X Internet is configured, access X Tracking via URL, default is:  http://127.0.0.1/xinternet/xtracking/xtracking.asp

  2. Update X Tracking URL in "Options -> Company Tab" of  X Dispatch.


    The URL domain / server of the X Tracking URL may differ based on network setup, but path should still be the same. Replace 127.0.0.1 with URL domain / server data

 Logging into X Tracking

Logging into X Tracking

  1. Before logging into X Tracking for the first time, each user must create their X Tracking password.  Passwords are created in "Maintenance > Permissions." Open user and update and confirm password information in X Tracking section.
  2. Login to X Tracking in "Tools - > X Tracking - > Run X Tracking." 
  3. The X Tracking login screen is displayed. Login using X Dispatch username and X Tracking password.