Installing FuelTMS applications

The actual quantity of concurrent users at peak workload and desire for redundancy is what determines the quantity and size of the Terminal or Citrix servers deployed. Both Remote Desktop Services (RDS) and Citrix virtualize well and require no specific change to the resources. For full desktop or VDI environments take extra care to ensure that the resources listed below are available in addition to the ancillary applications required to support the users' applications.

This server runs Windows Services, which are used to communicate with devices and customers outside of the company firewall. It is required only for those with Mobile Communications units or Electronic Data Transfer agreements.

In FuelTMS’s Fuel Dispatch and Inventory Services applications, users can modify layouts for windows, data grids, and menus. For optimal performance, monitors and video cards should allow for a minimum resolution of 1280x1024.

Be sure to set your zoom level and font size at 100% in your Windows Display settings in the Control Panel. Other setting values might cause distortion. Refer to your Microsoft documentation for additional information.

To uninstall Fuel Dispatch or Inventory Services using the .MSI file, follow these steps.

To uninstall Fuel Dispatch or Inventory Services through the Control Panel, follow these steps.

Note: These instructions are based on using Windows 10 as your operating system. If you are using a different version of Windows, you should consult its user documentation for instructions.

When you check logs in Fuel Dispatch or Inventory Services, you can easily identify operations performed by the Forecaster Console.

To identify database changes made by the Forecaster Console when it is run as a Windows scheduled task, you create a virtual user in System Administration before installing the Forecaster Console. A virtual user account is one for which an actual user does not exist. The virtual user login ID and password create a connection between the Forecaster Console and the TMWSuite database. If you use an existing user account to set up the connection, you cannot tell whether an operation was performed by the user or by the scheduled task.

Before installing the Importer Service Console, you should also create the Importer virtual user in System Administration. The virtual user login ID and password will create a connection between the Importer Service Console and the TMWSuite database.

Note: For more information about creating users, see:

System Administration | Establishing User Profiles on the Learning Center.

To create user accounts to represent the Forecaster Console and Importer Service Console, follow these steps.

Follow these steps to install the Forecaster Console for the first time.

Follow these steps to install the Importer Service Console for the first time.

By default, the ForecasterConsole.exe file is located in the Forecaster Console folder. This file is used to:

The first time you run ForecasterConsole.exe, you must supply information the Forecaster Console needs to connect to the TMWSuite database. This information is recorded in the connection.txt file.

To record connection information for the Forecaster Console in the connection.txt file, follow these steps.

The completed window should resemble this example:

Notes:

By default, the ImporterServiceConsole.exe file is located in the Importer Service Console folder. This file is used to:

To record connection information for the Importer Service Console in the connection.txt file, follow these steps.

The completed window should resemble this example:

Notes:

By default, the Trimble Transportation applications, including Fuel Dispatch, are installed in the
C:\Program Files (x86)\TMW Systems, Inc\TMWSuite\ folder. You can store the TTS50 and TTSLocal INI files in that folder, or in another location.

Note: If you use separate TTS50 files for TMWSuite and Fuel Dispatch, store the TTS50 and TTSLocal files used for Fuel Dispatch in the Fuel Dispatch sub-folder. For example:

When you install Fuel Dispatch, the FuelINISetings.ini file is created in your Fuel Dispatch program folder. This INI file contains several groups of settings that must be copied to your TMWSuite TTS50. Follow these steps to copy the settings to your TTS50 file.

Notes:

In the Fuel Dispatch TTS50 file, give the absolute path to the specified report template file for the following settings. By default, the report templates are in the main installation’s \Reports directory. For example:

C:\TMWSuite\Fuel Dispatch\Reports*ReportTemplate.rpt*

Notes:

The Forecaster Console can create and update orders, or update sales models, for groups of stores organized into batches. A store can belong to a Forecast Batch, and to a Sales History Batch, both of which are assigned in the Company Tank Setup application.

The IDs used to identify batches are label options. Your company defines them using the ForecastBatch and SalesHistoryBatch labels. The system comes with options 1-5 already created for each label. You can set up other batch options as shown in the following illustrations.

Notes:

The Forecaster Console generates orders automatically based on a store’s historical sales data, actual inventory readings, and delivered product data. Stores are set up for forecasting and pricing in the Company Tank Setup window in Inventory Services.

A store must already have a profile set up in the Company Tank Setup window before you can assign it to a batch.

In the Company Tank Setup window, use the Forecast Batch and Sales History Batch fields to assign a store to processing batches.

Note: For more information about setting up stores to use the Forecaster Console, see: Inventory Services | Performing preliminary setup on the Learning Center.

The method used to run the Forecaster Console depends on your company’s business practices and the accuracy of your sales models. You can run the Forecaster Console manually, using a desktop shortcut or batch file, or you can run it automatically by creating a scheduled task in Microsoft Windows Task Scheduler.

Readings, pricing, and delivery information is stored in sub folders in the Fuel Dispatch folder. Use these steps to create the folders where this information is stored.

Note: If you import readings or delivery data for several customers, you can create an archive folder for each customer. For example, ReadingsCompanyA, ReadingsCompanyB, DeliveryCompanyA, DeliveryCompanyB, and so on.

You use the Reading Import Configuration Maintenance window to create a configuration file. The file specifies the format and content of each tank reading file, and indicates whether the file is accessed from a network directory or FTP network. It can be a fixed-length flat file or it can use character-delimited format. The tank reading file records can include the following information:

You can also provide additional information about file type and path, information for storing data on an FTP site, SQL lookup information, and characters to be stripped from the input string.

The Forecaster projects when orders are needed, and how much product should be delivered. By default, the Forecaster uses the latest tank reading to calculate the fuel level inside a tank.

If you have [InventoryService]CheckForDeliveryReadings=Y in your TTS50, the Forecaster imports and stores data from automatic tank gauges (ATG). During a delivery, the Forecaster records ATG information. It uses these values to calculate the fuel level inside a tank. If there is no ATG information, the Forecaster uses the most current tank reading.

To use the setting, you must set up the Importer delivery configuration file to record ATG information, including:

You use the Delivery Import Configuration Maintenance window to create the delivery configuration file. The file can be a fixed-length flat file or it can use character-delimited format.

After you create the .RCONFIG Importer readings file, you can run the Importer Service Console. Use the following steps to create a shortcut on your Windows desktop. This will allow you to run the Importer Service Console to import readings more quickly.

Note: For information about creating the .RCONFIG file, refer to the Setting up the Importer reading configuration file section.

You can run the Importer Service Console manually using a desktop shortcut or batch file, or you can run it automatically by creating a scheduled task in Microsoft Windows Task Scheduler.

Defining a trailer compartment setup is the first step when setting up trailer compartments. Once you define a setup, you can then assign a default trailer to a consignee and clone the compartment configuration.

The system adds the fields needed to configure each trailer compartment.

After you define a trailer’s compartment setup, you can assign that trailer to one or more consignees. When the Forecaster creates orders for them, it uses the default configuration to calculate the maximum gallons and product mix on a load.

After you define a trailer’s compartment setup, you can clone that configuration to other trailers in your fleet.