0 mins to read•
Public Works Getting Started Guide for Resellers
0 mins to read•
Learn how to set up a Public Works Customer, including how to set up a database, install and provision the IOX-WRKS, and enable and configure Public Works MyGeotab features. Browse the provided additional resources for more information on the Public Works solution.
Congratulations on securing a Public Works deal! Wondering what to do next?
This document aims to guide you, the Partner, through the actions required to get your Customer up and running as quickly and smoothly as possible.
✱ NOTE: This document is not intended to replace more detailed documentation. This guide, along with the Public Works bootcamp slide presentations and associated links, are intended for use as a reference.
This document highlights how to prepare for installation, install and provision IOX-WRKS, and enable and configure Public Works MyGeotab features.
The GO9/GO9 RUGGED/GO9+ are telematics devices required for vehicle tracking, and the means of data transmission.
The IOX-WRKS is required for the GO9 Device to interface with the spreader controller.
Spreader Specific Cable
A cable is required to connect the IOX-WKRS cable to the specific controller.
(Optional) Used to make auxiliary input connections. One IOX-AUXM supports up to four inputs, but two IOX-AUXMs can be chained together to support up to eight inputs.
As a Partner, it is your responsibility to complete the actions outlined in the following sections, before the Customer can start their IOX-WRKS installations.
Gather information from the customer about the project/requirements:
You must order the following products for your Customer to use the Public Works solution with a spreader controller:
Integration cables are specific to the spreader controller head make and model. To ensure the appropriate integration cable is used, refer to this guide: Public Works Controller Integrations [PUBLIC]
✱ NOTE: The IOX-WRKS cable is required to obtain spreader controller data. However, not all Public Works MyGeotab features require data communicating via the IOX-WRKS cable. Therefore, the hardware requirements depend on your customer’s needs.
When ordering the GO9 device, the T-Harness, IOX-WRKS and the spreader specific cable, follow your standard ordering process by logging into MyAdmin. The IOX-WRKS cable is ordered from the IOX section of the MyAdmin Store. Please refer to the MyAdmin User Guide for further details.
Once you have ordered the required products, you must set up the MyGeotab database on behalf of the Customer. For new Customers, you must first create a new MyGeotab database. For existing Customers, you can use the existing MyGeotab database.
Use the MyGeotab Quick Reference Guide for any step-by-step instructions as noted below.
Once the database is created:
✱ NOTE: Please ensure that all vehicles with spreader controllers are on the ProPlus Public Works Rate Plan. This ensures the communication of spreader controller data to the MyGeotab servers.
As setting up Public Works is a complex process of preparation, information gathering, setup, and installations, it is understandable that the above steps may be done during the entire preparation process before and after installs.
To support IOX-WRKS firmware updates and over the air (OTA) support for all Public Works customer databases, please submit a MyAdmin support ticket to advise Geotab with your customer’s database name before the installation.
! IMPORTANT: The Geotab Public Works Support team will set up a service account as part of the Public Works process for any customer with spreader controllers. This user account is for IOX-WRKS firmware updates. Partners and Customers are to be aware of this user in MyGeotab — please DO NOT REMOVE the following user account from your list of users:
✱ NOTE: This email address is not monitored. Please do not send emails or reports to this email address.
If geospatial reporting (Route Completion or Live Route display) is part of the Customer solution, the creation of a service group in MyGeotab is required. Subsequent to the Public Works group, create a separate service group for each type of route that has customer-provided GIS data (e.g. plow, sidewalk, waste management, etc.). The vehicles associated with each service group must be defined and added to the groups. For example, service groups allow the Plow Route Completion map view & report or Live Route display to only include vehicles tagged as snow plows in a service group.
Please engage the customer’s GIS data department to review the geospatial requirements.
✱ NOTE: This step is only required if the Customer has opted in to use geospatial reporting (e.g. Route Completion).
To configure and install Route Completion shapefiles into your MyGeotab database, refer to the Route Completion user guide here. Live Route is available in MyGeotab version 8.0 in Feature Preview. Ensure ‘Live Route Tracking’ is set to ‘ON’ in the users Feature Preview tab settings (Administration > Users).
Prior to the scheduled installation date, it is important to verify that the hired Geotab-certified Installer is familiar with the following information:
✱ NOTE: If the Installer is unfamiliar with how to enable simulation mode, please contact the Geotab Field Services team prior to the installation day for assistance. Knowledge of simulation mode is required as part of the installation verification process
The IOX-WRKS requires a material spreader-specific configuration to function.
There are 2 methods to provision the IOX-WRKS cable for the required spreader controller:
The provisioning steps above require the GO9 device and IOX-WRKS cable to be installed and are successfully communicating (while Ignition ON) to complete the provisioning process.
✱ NOTE: If you are installing an IOX-WRKS and do not require any custom configurations, please proceed to Method 2.
Place a MyAdmin support ticket with the customer’s database and URL information before installation day:
This newly developed self-service add-in to set the spreader controller configuration and perform installation checks is now available. It will allow Partners and/or Customers to perform their own provisioning of the IOX-WRKS cable and verify the data is communicating from the spreader controller during the installation check.
The link to add-in install instructions and the how-to user guide is here. This Add-In can also be found on the Geotab Marketplace.
On the day of the scheduled installation, contract or employ a Geotab Public Works Certified Installer and verify that the Installer and Customer have the following required hardware and information:
✱ NOTE: For more information, please refer to the IOX-WRKS support document.
Once the GO9 device and IOX-WRKS cable is connected and if your IOX-WRKS cable requires a custom configuration, the installer will need to contact Geotab Public Works support to verify the data flow and complete the provisioning of the IOX-WRKS. Public Works support needs the following:
! IMPORTANT: The provisioning and data validation process may take up to one hour, and it is important to set the Installer’s expectation accordingly.
You may choose to expedite the process by provisioning the hardware prior to the installation. To do so, connect the IOX-WRKS to the GO9 device and power the GO9 device using a test bench station. Once the GO9 device connects, contact Geotab Public Works support to provision the hardware.
✱ NOTE: This method causes the GO9 device to log a GPS point at your facility. If you have a bench tester set up and your Customer is not concerned with the logged GPS point, the Installer is not required to contact Geotab Public Works Support to verify the data validation on the scheduled installation date.
The Partner and/or Customer installer will be able to provision and perform installation checks via the MyGeotab database by using a new add-in (Method 2 as per above). The link to add-in install instructions and the how-to user guide is here.
MyGeotab features related to Public Works are found in the database. Some features are still in Feature Preview mode, meaning the customer must enable Feature Preview to view and use these features. For further reference on these features, review the Public Works Features Customer User Guide.
To help your Customer obtain their Public Works spreader controller data more efficiently, it is recommended that the Partner sets up and/or enables the following in the MyGeotab database:
! IMPORTANT: Before using Live Route Tracking, ensure that you configure Route Completion with appropriately defined Service Groups, and upload GIS route data to MyGeotab. For more information, refer to the section above.
✱ NOTE: If the Service time window is not required, click Remove in the Service Window section.
Geotab Public Works Support Contact Information
Hours of Operation
Monday to Friday — 7:30 a.m. to 8:00 p.m. EST
Saturday — 11:00 a.m. to 7:00 p.m. EST
Geotab Public Works Support will assist the Installer with the following when on-site: