Field Deployment Manager > v4.2.0 Release Description...• Mobile Devices now register to the last Business Unit they provisionedfrom . • Routes can be sorted by Route Status in

Itron

Field Deployment Manager v4.2.0

28 June 2019 INF-7228-000 1 of 27

Proprietary and Confidential

Itron Release Notes

Field Deployment Manager > v4.2.0 Release Description Field Deployment Manager (FDM) v4.2.0

Field Deployment Manager (FDM) v4.2.0 (4.2.0.300) was made available as of April 22, 2019. Since April 22 FDM has released follow-up hot fixes and post-installation scripts. Please refer to the Appendices of this document for up-to-date release information. This document contains information related to the release of the FDM suite of software products:

• Field Deployment Manager (FDM) Server

• FDM Tools

• FDM Tools with Enhanced Security

• FDM Workorders

• FDM Server Client

• FDM Mobile Client

• FDM Tools Standard Workflows for electricity, gas, and water

Field Deployment Manager (FDM) Tools Workflows v4.2.0.04 FDM Tools Workflows v4.2.0.04 was made available as of June 28, 2019. This software release supports the hosted services and local installation of the Field Deployment Manager (FDM) Tools application as it applies to OpenWay® Riva meters and other devices on the OpenWay Riva network. FDM Tools enables wireless access to OpenWay Riva devices via a 2.4GHz Wi-Fi connection. The intended use of the tool ranges from meter shop testing and inspection to local meter troubleshooting and auditing. FDM Tools requires a hosted server to manage software updates and utility user permissions. Utilities manage their own business unit within the hosted server after setup.

For business unit setup, submit an application form to [email protected]. Contact Itron Customer Support at (877) 487-6602 or [email protected] before applying system upgrades or modifications. To ensure proper system performance and compliance with software license and support agreements, avoid applying unapproved third-party service packs or program temporary fixes (PTFs).

mailto:[email protected]


Itron


28 June 2019 INF-7228-000 2 of 27


Itron Release Notes

Purpose This document describes the FDM v4.2.0 release and the FDM Tools Workflows v4.2.0 release including enhancements, resolved issues, known issues, and the test summary. Please read all release notes, installation instructions, and appendices to verify that you have the appropriate resources before starting the installation.

Note Itron updates the hosted FDM Tools servers. Customers who use the hosted FDM Tools servers automatically receive the upgraded Server and Mobile Client software upon logging in. Itron will make an announcement to customers before upgrading the hosted FDM Tools servers.

If your utility hosts its own FDM Tools, with or without Enhanced Security, the installation instructions can be found in the Field Deployment Manager v4.2 Server Installation and Upgrade Guide (TDC-7111-000).

Itron


28 June 2019 INF-7228-000 3 of 27


Itron Release Notes

Contents Release Description .......................................................................................................................................... 1

Field Deployment Manager (FDM) v4.2.0 .................................................................................................. 1 Field Deployment Manager (FDM) Tools Workflows v4.2.0.04 ................................................................. 1 Purpose ...................................................................................................................................................... 2

Contents ............................................................................................................................................................ 3 Test Summary ................................................................................................................................................... 4 Enhancements Overview .................................................................................................................................. 4

Server Client User Interface Enhancements .............................................................................................. 4 Electricity Workflow Enhancements ........................................................................................................... 5 Gas/Water Workflow Enhancements ......................................................................................................... 6

Database Changes ........................................................................................................................................... 8 Issues Overview ................................................................................................................................................ 8

Resolved Issues – Electricity Workflows .................................................................................................... 8 Resolved Issues – Gas/Water Workflows .................................................................................................. 9 Known Issues – Electricity Workflows ...................................................................................................... 11 Known Issues – Gas/Water Workflows .................................................................................................... 13 Product Documentation Suite .................................................................................................................. 13

System Requirements..................................................................................................................................... 14 FDM Server Requirements: ...................................................................................................................... 14 FDM Server Client Requirements:............................................................................................................ 14 FDM Mobile Client Requirements:............................................................................................................ 14

Software/Documentation ................................................................................................................................ 15 Installation and Upgrade ................................................................................................................................. 16

New Installation Instructions..................................................................................................................... 16 Upgrade Instructions ................................................................................................................................ 16

Itron Product Compatibility Matrix ................................................................................................................... 17 Supported Industry Standards ........................................................................................................................ 17 Appendix A: FDM Post Installation Script v4.2.0.300 .............................................................. 18

Purpose .................................................................................................................................................... 18 Upgrade Guidance ................................................................................................................................... 18

Appendix B: FDM Tools v4.2.0 Gas and Water Check Endpoint Status Hotfix ..................... 20 Purpose .................................................................................................................................................... 20

Appendix C: Field Deployment Manager Mobile Release v4.2.0.335 ..................................... 20 Upgrade Guidance .......................................................................................................................................... 20 Release Description ........................................................................................................................................ 22

Purpose .................................................................................................................................................... 22 Resolved Issues .............................................................................................................................................. 23 Upgrade Guidance .......................................................................................................................................... 23

Itron


28 June 2019 INF-7228-000 4 of 27


Itron Release Notes

Test Summary The FDM test team performed test cases specifically selected to ensure a high-quality release. The following types of testing were performed:

• Installation/Upgrade

• Functional testing

• Error conditions/fault tolerance

• Usability testing

Enhancements Overview The FDM v4.2 release contains the following new or updated functionality as well as various bug fixes.

Note For information on earlier releases, or subsequent hot fixes or product temporary fixes, be sure to read the release notes of those versions for any information that may possibly affect you. Log on to Itron Access or contact Itron Support if you need release notes for any earlier version(s).

Server Client User Interface Enhancements • Supports snapshot file save of device properties.

• Supports using Secure Device List and Get Commands for provisioning.

• Mobile Devices now register to the last Business Unit they provisioned from.

• Routes can be sorted by Route Status in the Work Orders view.

• GPS and Use Internal GPS default values are now set to true, and the Save Endpoint Info default value is now set to false.

• Spanish language support is available for the FDM Mobile Client, Installer, and standard Electricity workflow.

• A Meter Shop radio mode has been added to FDM. • The default can be set in the Server Client. • The setting may be overridden in the Mobile Client if necessary.

Itron


28 June 2019 INF-7228-000 5 of 27


Itron Release Notes

Electricity Workflow Enhancements Service Limiting Support

FDM Tools supports two operations regarding service limiting mode.

• The Service Limiting Settings operation will allow users to locally initiate a service limiting mode change. The service limiting modes supported are defined in the meter’s configuration file.

• Clear all Scheduled and Active Service Limiting allows a user to locally clear out any active or scheduled service limiting mode that have been initiated locally or via the network.

SiteScan Support for Polyphase meters FDM Tools supports the following SiteScan functionality.

• New Service Phasor Diagram with additional meter diagnostic counts and service information.

• Ability to reset SiteScan Diagnostic Counters.

• Diagnostic parameter overrides allowing customers to customize settings based on unique service characteristics.

• Diagnostic Events support.

Manage Diagnostic Data File Support FDM Tools Manage Diagnostic Data Files is a menu option that allows users to view collected files in a single repository.

• The ability to view all diagnostic data files collected and stored on the local device.

• Users can select file to view meter attributes collected. The data contained is all device data as if they were logged onto the device.

• Ability to view the configuration in the meter at the time the data file was created. Users can then choose to compare against other configurations that reside on the local machine.

• Ability to move (upload) diagnostic data files to a utility defined directory.

User Activity Log (Command Log) support FDM Tools support for logging users’ activities for electric, gas, and water. This provides administrators the ability to monitor field activities at a user level.

Manage CRF file Support FDM Tools Manage CRF Files is a menu option that allows users to view collected files in a single repository.

• The ability to view all CRF files collected and stored on the local device.

• Users can view CRF data collected.

Itron


28 June 2019 INF-7228-000 6 of 27


Itron Release Notes

• Ability to move (upload) CRF data files to a utility defined directory.

System Title Barcode Scanning FDM Tools support for System Title scanning via 2D barcode scanner.

DHCP address Offset Operation FDM Tools DHCP address offset operation allows users to support a multi-application network. This provides the flexibility needed to deploy a Riva network solution in a configuration that allows customers to monetize their Riva network "as a service" to other utilities or non-utility business.

TLV Reader Updates Added New TLVs to Field Deployment Manager’s definition file.

• ACTrootQoSConfiguration

• ACTrootQosStatistics

• ACTrootQosQueueStatistics

• ACTEndPointQoSConfiguration

• ACTEndPointQoSStatistics

New Distributed Intelligence support • Users can view current license status information for all installed agents.

• Extraction and viewing of compressed DI Agent log files.

• File Retrieval support for DataV diagnostic data.

• Start and Stop options for individual agents and containers.

ESN Serial Number viewing once logged on Field Deployment Manager will show the device ESN on every screen once logged in. This allow users to quickly identify what device they are logged into.

Gas/Water Workflow Enhancements The standard FDM Tools gas and water workflows contain the following updates since the last standard FDM Tools workflows release. Please refer to the Software/Documentation section of this Release Note for detailed part numbers.

Gen™5 Gas Modules The following new features have been added to FDM for support of the Gen5 Gas Modules. For detailed information on these features, please see the appropriate documentation:

• Data extraction of 5, 15, 30, and 60-minute intervals in Network/ Mobile mode.

• Display battery status in Check Endpoint summary for Network/ Mobile mode.

Itron


28 June 2019 INF-7228-000 7 of 27


Itron Release Notes

• Network Management functionality covers reading the security information, network status, and registration status of the network where the endpoint is registered. It also allows deletion of the capture status information.

• Supports uninstalling a Gen5 Gas Module, exporting the uninstall data, and creating an RMA of the endpoint if the endpoint is to be sent back for repair.

• Supports the change-out of devices in the field.

• Supports switching the Module into Network mode on install.

• Allows logging several events supported by the Gen5 Gas Module.

• Supports over-the-air Firmware Download (FWDL) to the Gen5 Gas Module.

• Supports signed authorization commands as part of security model.

• Added new Network Operation menu items: • Network Registration Status • Network First Capture Security Information • Force Parent Discovery • Delete Network First Capture

OpenWay® Riva 500G Module, OpenWay Riva Water Module, and Intelis Gas Meter • Supports collection, processing, and display of sub hourly gas and water usage

down to one-minute intervals.

• Supports partial Firmware Download (FWDL) to the OpenWay Riva Water Module and Intelis Gas Meter.

Note The OpenWay Riva 500G does not currently support partial FWDL.

• Supports checking status and modifying the Extended FAN Connectivity (EFC) (like how this same feature worked on 100W GeoMode).

• Supports programming DHCP NMS Address Index and DHCP CE Address Index for metering devices for multi-application networks.

• Supports determining the status of the network connection for a battery powered device (500G, 500W, OWR-GRD, Intelis Gas Meter).

• Software and documentation are updated to reflect correct naming of the Intelis Gas Meter.

• A View Calibration Values operation is now available for the Intelis Gas Meter Ultrasonic Measurement Unit (UMU), which can help identify if the meter requires calibration adjustments.

• Supports the alarm for potential index corruption if specific conditions are met.

Itron


28 June 2019 INF-7228-000 8 of 27


Itron Release Notes

• If there isn’t programmed meter config logs or Signed Authentication command for the device, then the Check Endpoint command prompts the selection of the dial configuration before it displays the result screen.

• The Check Endpoint command returns additional programmed information.

• New 500G Quick Check Operation is a smaller version of "Check Endpoint" with limited parameters in the summary window.

Database Changes Minor changes to the database schema with this release, specifically to the MobileDevice and BusinesUnit tables, to support the Meter Shop Radio mode and Itron Customer traceability to their Business Unit on the FDM Tools servers.

Issues Overview Resolved and Known Issues for FDM Tools electric workflow v4.2.0.02 and FDM v4.2.0 are listed below.

Resolved Issues – Electricity Workflows This section lists significant issues addressed in–or related to–the FDM Tools electricity workflow.

Functionality Affected

Reference Number

Description

Tampers 597942 Issue: OpenWay Riva bottom-connect (IEC) meter: The tamper event for terminal cover removal was erroneously reported as “Meter Cover Removed.” Resolution: “Meter Cover Removed” event has been renamed “Terminal Cover Tamper” to properly indicate the event state.

User Interface 830575 Issue: When the submit button was selected to retrieve event log data, the end date of the search increased by one day. Resolution: Corrected the user interface to prevent the search window from incrementing.

Contingency Reads

935840 Issue: FDM Tools was not differentiating between current register and previous registers when generating a CRF file. This caused an import failure when importing into Itron Enterprise Edition (IEE). Resolution: A change was made to append a previous billing tag to all previous billing data. This permits current

Itron


28 June 2019 INF-7228-000 9 of 27


Itron Release Notes

registers and previous registers to be stored on separate channels within IEE.

Contingency Reads

1283896 Issue: Upon CRF file import into Itron Enterprise Edition (IEE), an error occurred when a CRF file contained profile (interval) data. This was caused by an interval mismatch due to incorrect start/stop time. Resolution: A change was made to ensure that the interval count and start/stop time are aligned.

Firmware Download

1597266 Issue: In some instances when performing a firmware update on a large list of devices, a timeout occurred and rendered the connection lost, but FDM Tools continued to run in the background. Users were unable to tell without investigation what the application was doing. Resolution: A modification was made to ensure that if an error condition occurred, FDM Tools would resume operation by continuing to the next device in the list.

Resolved Issues – Gas/Water Workflows

This section lists significant issues addressed in–or related to–the FDM Tools gas and water workflows. Items listed may be directly workflow-related or enhancements to the server.


Reference Number

Description

Endpoint support

962379, 962380, 962381, 962382, 962383, 962384, 962385, 962386, 962387, 962388, 962389, 962390, 962392, 962393,

962429,

New addition of Gen5 Gas Module support

Endpoint Support

700697, 703105, 747515, 747761, 882786, 906351, 906352, 906353,

906354, 1148387, 1281123,

New addition of OpenWay Riva 500G, OpenWay Riva Water Modules, and Intelis Gas Meter support

Itron


28 June 2019 INF-7228-000 10 of 27


Itron Release Notes

FDM Workorders

919519 Issue: Unable to filter Routes in the Work Orders view Resolution: A new filter property was added to the Routes tab in the Work Orders view. This is only available to FDM Work Orders customers

User Interface 919560 Issue: Default settings for GPS and Save Endpoint Information create extra work to change on every new device Resolution: Changed defaults to GPS Enabled = true, Use Internal GPS = true, Save Endpoint Information = false

Support 1295474 Issue: Itron customer Oracle ID was not associated with customer name in FDM Tools Server Resolution: Added a field to the Business Unit to list the Itron Oracle ID

User Interface 1329705 Issue: The Check screen didn’t show how the endpoint was configured Resolution: Added a dialog to request the user to enter Dials and Billing Units so FDM can properly format the configuration value on the Check Screen

User Interface 1403534 Issue: There were too many items to scroll through on the Check screen Resolution: A Quick Check operation was added for OpenWay Riva 500G Modules

User Interface 1419307 Issue: Radio settings specific to Meter Shop use were unavailable. Resolution: Added new settings to select the radio mode to use.

Signed Authorizations

1322721 Issue: The Signed Authorization TimeToLive max value exceeded the max value expected by the endpoint, resulting in an error. Resolution: Updated the maximum allowed TimeToLive value for Signed Authorizations to match the max expected by the endpoint

Itron


28 June 2019 INF-7228-000 11 of 27


Itron Release Notes

CE Mobile Client

1425680 Issue: FC300 did not perform as expected and required restart when performing disconnects on Intelis Gas Meters Resolution: The FC300 now performs as expected when disconnecting Intelis Gas Meters

Prerequisites 1426611 Issue: New version of .NET framework available Resolution: .NET Framework v4.7 is now included with the installer

User Interface 1435111 Issue: Seal Certificate ID was not included in the Business Units Properties Resolution: The Seal Certificate ID is now displayed in the Business Unit Properties

User Interface 1491788 Issue: Cut Cable tampers incorrectly displayed in result screens of Intelis Gas Meter Valve; meter does not include Cut Cable tampers Resolution: The "Cut Cable" tamper does not appear in results screens for the Intelis Gas Meter anymore

User Interface 1497848 Issue: Clock times could overlap in the Interval data graph resulting in poor readability Resolution: The graph’s readability was improved by removing seconds from the hourly interval display

Signed Authorizations

1512418 Issue: Saving RMA Signed Authorizations to a File does not work as expected for the Manager user role Resolution: The Manager role now includes permissions for creating RMA Signed Authorization zip files

Known Issues – Electricity Workflows The following section describes significant known issues. Workarounds are provided where available.


Reference Number

Description

Electric Workflow 594910 Issue: FDM Tools window distortion may occur if display settings are altered (specifically enlarging text sizes beyond 100% in Microsoft® Windows® display settings)

Itron


28 June 2019 INF-7228-000 12 of 27


Itron Release Notes

Workaround: If distortion occurs, change Microsoft Windows display settings to correct problem (change and/or reduce text size to 100%)

Electric Workflow 766426 Issue: An error occurs when users attempt to initiate a reset registration state on an OpenWay Riva Mesh Node. FDM Tools software supports this feature, but until it is added to the OpenWay Riva Mesh Node firmware, this feature is unavailable.

Electric Workflow 855572 Issue: When viewing the RN-ERT Gateway configuration in FDM Tools, the user cannot see the Utility ID or Collected ERT types. The Utility ID and Collected ERT types are user-defined parameters in the OpenWay Operations Center -Collection Manager (OWOC-CM). Workaround: Use the Advanced Diagnostics “LID Reader” feature to read the following:

• ILID_RFLAN_UTILITY_IDS (to read the Utility ID) • ILID_TYPE_EXCLUSION_FILTER (to read the

Collected ERT Types)

Electric Workflow 636444 Issue: Modifying user role permission levels (permissions inside of the Read FSR, Program FSR, Reset FSR and Power FSR) requires the enabling of the “OpenWay CENTRON” Endpoint Configuration. Workaround: The employee who manages the Business Unit must enable the OpenWay CENTRON Endpoint Configuration in order to change permissions within the four levels. After changing the permissions, the BU manager must disable the OpenWay CENTRON Endpoint Configuration so that it does not appear in the workflows of the FDM Tools menu when FSRs synchronize with the server. Granting users access to any of the four levels does not require the enabling of the OpenWay CENTRON Endpoint Configuration item. This issue is scheduled to be fixed in a later release.

Itron


28 June 2019 INF-7228-000 13 of 27


Itron Release Notes

Known Issues – Gas/Water Workflows The following section describes significant known issues. Workarounds are provided where available.


Reference Number

Description

Gas Workflow

1643678 Issue: FDM Tools may indicate an incorrect “Valve Actuation Life Status” and “Non Metrology Counter” when checking the Service Status of the Intelis Gas Meter when in Mobile Mode. Workaround: There is no workaround for this issue. Itron will release a fix in the next scheduled release.

Gas/Water Workflow

1560845 Issue: 1st Article "built to stock" in factory ship mode with a pending takeover package cannot be programmed Workaround: Perform an Auto Detect to wake up the endpoint, check the mode, and then apply the takeover package

Gas/Water Workflow

1556271 Issue: FDM Server is not updating Extract Interval Data from BPD on 5 min Workaround: Reduce the amount of interval data being selected; choose an interval greater than five minutes, recommend 15-minute or larger

FDM Workorders

838785 Issue: In FDM Workorders systems, some instances of synchronized workorders might not properly link to the workorder data to show a proper status of "Installed." Workaround: Manually update a field in the workorder completion details and re-save the order. This should trigger a change to the inventory status to show "Installed."

Gas workflow

1552520 Issue: Unable to Seal Intelis Gas Meter when Seal Certificate ID is null Workaround: In FDM server client, navigate to Business Administration > Business Unit Properties and enter any value into the Seal Certificate ID field. For example, you can enter the text string space or you could enter a single or double space.

Product Documentation Suite For detailed hardware and software requirements, please refer to the following documents for Field Deployment Manager and FDM Tools:

Document Title Part Number Field Deployment Manager v4.2 Server Installation and Upgrade Guide

TDC-7111-000

Field Deployment Manager v4.2 Server Client Guide TDC-7112-000

Itron


28 June 2019 INF-7228-000 14 of 27


Itron Release Notes

Field Deployment Manager v4.2 Field Service Representative’s Guide

TDC-7113-000

Field Deployment Manager Tools v4.2 Mobile Application Guide TDC-7114-001 Field Deployment Manager Tools v4.2 Configuration Guide TDC-7115-000 Field Deployment Manager and Tools Workflows v4.2 Release Notes

INF-7228-000

System Requirements Itron has certified and supports the following external system component versions and may require separate installation of software products used with the FDM server:

FDM Server Requirements: System Component Version

Minimum Tested Windows Server 2008 R2 with SP1 Standard or Datacenter Edition

6.1.7601 6.1.7601

Windows Server 2012 R2 Standard or Datacenter Edition

6.3.9600 6.3.9600

SQL Server 2012 R2 with SP1 Standard or Enterprise Edition

11.0.3000.0 SP1 - 11.0.3000.0

SQL Server 2016 with SP2 13.0.5026.0 13.0.5026.0 SQL Reporting Services Microsoft .NET Framework (installed with FDM) 4.7 4.7

FDM Server Client Requirements: System Component Version

Minimum Tested Windows 10 Pro or Enterprise 1803 17134.677 1809 17763.379 Microsoft .NET Framework (installed with FDM) 4.5.2 4.5.2

FDM Mobile Client Requirements: System Component Version

Minimum Tested Windows 10 Pro or Enterprise (for PC Client) 1803 17134.677 1809 17763.379 Microsoft .NET Framework (for PC Client) 4.5.2 4.5.2 FC300 OS Package (provisioned to client automatically) Notes

• Version FC300P501Ch2-i1 or greater is required for use with some advanced tools functionality

FC300PC501Dr- i2-a3-v20

FC300PC501Dr- i2-a3-v20

Itron


28 June 2019 INF-7228-000 15 of 27


Itron Release Notes

• Version FC300PC501Dr-i2-a3-v20 should be installed after installing the FDM Mobile Client

SRead Radio Firmware (installed with FDM for FC300 client)

033 033

Software/Documentation Itron Component Version Software Part

Number Field Deployment Manager Kit 4.2.0 SWK-0478-003

Field Deployment Manager Server - Server installer and prerequisites (.NET, ZenBarcode, SQL CE)

4.2.0 SFL-1680-003

Itron Component Version Software Part Number

Field Deployment Manager Mobile • Mobile installer for PC • FC300 zip package • FC200 zip package • Mobile provisioning package

4.2.0 SFL-1681-003

Field Deployment Manager Tools Gas/Water 4.2.0 SFL-1682-003

• COSEMGeneric Workflow 4.2.0.300

• EndpointTools.ChoiceConnect Workflow 4.2.0.300

• EndpointTools.Gallus.RF1Net Workflow 4.2.0.300

• EndpointTools.OpenWay Workflow 4.2.0.300

• EndpointTools.WaterSaveSource Workflow 4.2.0.300

• OWRivaConfigurationFiles folder contains the workflow configurations for the CosemGeneric workflow

4.2.0.300

Field Deployment Manager Tools Electric 4.2.0.04 SFL-1678-002

• OpenWay COSEM Workflow 4.2.0.04

Field Deployment Manager Release Notes v4.2 INF-7228-000

Itron


28 June 2019 INF-7228-000 16 of 27


Itron Release Notes

Field Deployment Manager Documents v4.2 TDD-0089-000

Installation and Upgrade New Installation Instructions

For new installations of FDM server for FDM Tools or FDM workorder systems, see the Field Deployment Manager v4.2 Server Installation and Upgrade Guide (TDC-7111-000).

Upgrade Instructions Before You Begin

Read all instructions before starting an installation. Ensure that you have read the release notes and that the system requirements have been fulfilled.

Supported Upgrade Paths The FDM development team tested upgrading from the following listed versions to the latest v4.2.0 release: • FDM v4.1.0 • FDM v4.1.1

To Upgrade FDM Server For upgrades to existing on-premises FDM Tools or FDM workorders servers, see the Field Deployment Manager v4.2 Server Installation and Upgrade Guide (TDC-7111-000). Upgrading the server takes many specialized steps and configurations. Please refer to the installation guide for detailed instructions.

To Upgrade FDM Server Client For complete instructions on upgrading your current FDM Server Client installation to v4.2.0, see the Field Deployment Manager Tools v4.2 Configuration Guide (TDC-7115-000).

To upgrade your Itron Hosted FDM Server Client, log in to your existing client. The new update should automatically start and install the new v4.2.0 Server Client.

Note The new server client version will not be available until the Itron Hosted FDM Tools Servers are updated. Please refer to the Hosted Server Upgrade Announcement.

If you host your own on-premises FDM Tools or FDM workorders server, you must first upgrade the server to v4.2.0. Then upgrade your FDM Server Client by logging into your existing client. The new update should automatically begin and install the new v4.2.0 client.

To Upgrade FDM Mobile Tools Client For complete instructions on upgrading your FDM Tools Mobile Client to v4.2.0, see the Field Deployment Manager Tools v4.2 Mobile Application Guide (TDC-7114-000).

Itron


28 June 2019 INF-7228-000 17 of 27


Itron Release Notes

To upgrade your Itron Hosted FDM Tools Mobile Client, log in to your existing client on your PC or your FC300. The new update should automatically start and install the new FDM Tools Mobile Client v4.2.0.

Note The new mobile client version will not be available until the Itron Hosted FDM Tools Servers are updated. Please refer to the Hosted Server Upgrade Announcement.

To upgrade customer on-premises FDM Tools Moblie Clients, the business unit manager must first update the FDM Server and provision the new FDM Tools Mobile Client software. Once provisioned, the mobile user must log in to the existing FDM Tools Mobile Client to get the update.

Itron Product Compatibility Matrix The following table lists hardware, software, and firmware used for testing this release. Where applicable, versions or part numbers Itron has certified and supports are listed.

Additional Hardware / Software / Firmware

Version/Part Number

Minimum Tested Unsupported Itron Security Manager (ISM) 3.6.11.0 3.6.11.0

4.0.13.0

3.3 3.4*

Itron Mobile Radio IMR 1 IMR 1 *Itron Security Manager v3.4 or higher is required for use with OpenWay Riva water and gas modules that are operating with enhanced security enabled or if using Advanced commands, or reconfiguration requests to migrate from mobile mode to OpenWay Riva network mode.

Supported Industry Standards The following standards are used by the FDM Server application:

Products Standard Name and Version Use FDM Application Server XML 1.0 Import/Export File

Processing

Itron Release Notes

FDM Post Installation Script v4.2.0.300

28 June 2019 INF-7228-000


18 of 27

Appendix A: Field Deployment Manager > FDM Post Installation Script v4.2.0.300 Release Description

These release notes were originally released 26 June 2019 as part number INF-7233-000.

The FDM Post Installation Script v4.2.0.300 modifies the existing device names of “OWR Intelis Gas” endpoint configurations to be “Intelis Gas Meter”. It also modifies existing device names of “Intelis Gas Meter” meter configuration to be “Intelis Gas Meter Config”. This post installation script only needs to be applied if an upgrade to an existing FDM Server v4.1.1 system is being performed. This sql script must be applied on the FDM database server using the SQL Management Studio. Contact Itron Customer Support at (877) 487-6602 or [email protected] before you apply system upgrades or modifications. To ensure proper system performance and compliance with software license and support agreements, do not apply unapproved third-party service packs or program temporary fixes (PTFs).

Purpose This document describes the resolved issue and provides upgrade guidance for the FDM Post Installation Script v4.2.0.300 release.

Upgrade Guidance Only apply this post installation upgrade script on an FDM server running v4.2.0.300 that has been upgraded from v4.1.1. This script does not apply to a new installation of FDM or an upgrade from any version of Field Deployment Manager prior to v4.1.1.

To Upgrade the FDM Server For upgrades to existing on-premises FDM Tools or FDM workorders servers, see the Field Deployment Manager v4.2 Server Installation and Upgrade Guide (TDC-7111-000). Upgrading the server takes many specialized steps and configurations. Please refer to the installation guide for detailed instructions. To Apply this script:

1. Open SQL Management Studio and connect to the database server hosting the FDM database.

2. Open the script file “Upgrade_4.1.1_To_4.2.0_Name_Change_Intelis.sql” included in SFL- 1752-00 in SQL Management Studio

3. Select the target database as shown in the image below and click the “Execute” button on the toolbar


Itron Release Notes

FDM Post Installation Script v4.2.0.300

28 June 2019 INF-7228-000


19 of 27

Itron Release Notes

FDM Tools v4.2.0 Gas and Water Check Endpoint Status Hotfix

28 June 2019 INF-7228-000


20 of 26

Appendix B: Field Deployment Manager > FDM Tools v4.2.0 Gas and Water Check Endpoint Status Hotfix Release Description


The FDM Tools v4.2.0 Gas and Water Check Endpoint Status Hotfix addresses an issue with the Check Endpoint Status operation returning an “Operation Failed” error for some OpenWay Riva Water Modules running firmware version 2.1.10.0. This Hotfix requires that FDM Server v4.2.0.300 is already installed. This software must be installed on the FDM application server using the server client. Contact Itron Customer Support at (877) 487-6602 or [email protected] before you apply system upgrades or modifications. To ensure proper system performance and compliance with software license and support agreements, do not apply unapproved third-party service packs or program temporary fixes (PTFs).

Purpose This document describes the resolved issue and provides upgrade guidance for the FDM Tools v4.2.0 Gas and Water Check Endpoint Status Hotfix release.

Resolved Issues The following issues have been resolved in this release.


Reference Number

Description

Workflow 1640725 Issue: The “Check Endpoint Status” workflow for OW Riva Water Module running Firmware 2.1.10.0 could result in an operation failed error. Resolution: The workflow has been modified to correctly handle the 64-bit unsigned integer value returned by the OpenWay Riva Water Module

Upgrade Guidance Only perform this upgrade on an FDM server running v4.2.0.300 with mobile client v4.2.0.335. To fix existing Field Deployment Manager v4.2.0.300 deployments

1. Sign on to the Field Deployment Manager server client as a system administrator. 2. Navigate to the System Administration workbench. 3. Select the Workflows node in the navigation tree. 4. From the list view toolbar, click +. 5. Navigate to and select CosemGeneric.fdmwp from the “FDM Tools v4.2.0 Gas_Water Check

Endpoint Status Hotfix” release media. 6. Select the Copy Settings From Previous Enabled Version check box.


Itron Release Notes

FDM Tools v4.2.0 Gas and Water Check Endpoint Status Hotfix

28 June 2019 INF-7228-000


21 of 26

7. From the Upload Options drop-down menu, select Replace Existing Versions.

8. Click OK. 9. Restart all FDM mobile applications and complete sign on and synchronization to update mobile

devices to the latest workflow version. 10. After synchronization has completed, verify the mobile client has been updated to the new

workflow version from the “About” view. The new CosemGenericWorkflow version will be 4.2.0.336.

Itron Release Notes

Field Deployment Manager v4.2.0.335

22 of 25

Appendix C: Field Deployment Manager Mobile > Release v4.2.0.335 Release Description


The Field Deployment Manger Mobile release v4.2.0.335 addresses several high priority bugs in the mobile application that were resolved after the v4.2.0.300 release. This hotfix, which is also known as a program temporary fix (PTF), as a prerequisite requires that the FDM server version is 4.2.0.300. This software must be installed on the FDM application server using the FDM Server client. This release: • Corrects the battery counter value reported for all 500S endpoints. • Corrects an extract interval data issue for all 500S endpoints. • For the OWR-GRD, adds the SSID value to the Check Result screen. • Corrects the device sub-type that is reported for the Gen5 Gas Module. • For the OpenWay Riva Water Module, corrects programming to use the correct cut orientation

value. • Corrects the way the application functions when viewing event details for the Image Activation

Successful event for Gen5 Gas Modules. • Updates the Measurement Unit FW CRC display value on the Firmware Versions overlay to

match Intelis Gas Meter’s index display. Contact Itron Customer Support at (877) 487-6602 or [email protected] before you apply system upgrades or modifications. To ensure proper system performance and compliance with software license and support agreements, do not apply unapproved third-party service packs or program temporary fixes (PTFs).

Purpose This document describes the resolved issue and provides upgrade guidance for the Field Deployment Manger v4.2.0.335 release.


Itron Release Notes


23 of 25

Resolved Issues The following issues have been resolved in this release.


Reference Number

Description

User Interface 1490514 Issue: The Check Endpoint Status result screen for 500S endpoints could display an incorrect battery counter value. Resolution: The FDM mobile application now correctly provides a 64-bit full battery counter value.

Data Integrity 1555161 Issue: The FDM mobile application failed to retrieve all interval data records from 500S endpoints when the buffer was full or nearly full. Resolution: FDM mobile application now reads the interval data table in blocks until all records in the buffer are read.

User Interface 1573687 Issue: The Check Endpoint Status result screen did not display the SSID for the OWR-GRD endpoint. Resolution: The Check Endpoint Status result screen for the OWR-GRD now includes its SSID value.

User Interface 1574109 Issue: The FDM mobile application reported the incorrect device subtype for the Gen5 Gas Module. Resolution: The enumeration for sub-type values is now updated to include the Gen5 Gas Module subtypes.

Workflow 1574450 Issue: The Program Endpoint workflow for the OpenWay Riva Water Module incorrectly used the Cut Orientation value from the 60WP endpoint. Resolution: The FDM mobile application workflow now uses the correct meter configuration value for the OpenWay Riva Water Module.

User Interface 1596969 Issue: Viewing the event detail for the Image Activation Successful event on a Gen5 Gas Module caused the FDM mobile application running on a desktop to stop running. Resolution: The FDM mobile application now displays the event detail as expected.

User Interface 1597304 Issue: The FDM mobile application displayed the Measurement Unit FW CRC value incorrectly on the Firmware Versions overlay, and it did not match the value on the LCD display of the Intelis Gas Meter. Resolution: The FDM mobile application now applies the correct conversion to the stored value before display.

Upgrade Guidance Only perform this PTF upgrade on an FDM server running v4.2.0.300.

To fix existing Field Deployment Manager v4.2.0.300 deployments

1. Sign on to the Field Deployment Manager server client as a system administrator.

Itron Release Notes


24 of 25

2. Navigate to the System Administration workbench. 3. Select the Provisioning Packages node in the navigation tree. 4. In the list view toolbar, click +. 5. Navigate to and select Fdm.xprov from the FDM Mobile v4.2.0.335 release media. 6. Click OK.

After the provisioning package upload completes, you must disable the old version. 7. Select the Workflows node in the navigation tree. 8. From the list view toolbar, click +. 9. Navigate to and select CosemGeneric.fdmwp from the FDM Tools Gas & Water v4.2.0.335

release media. 10. Select the Copy Settings From Previous Enabled Version check box. 11. From the Upload Options drop-down menu, select Replace Existing Versions.

12. Click OK. 13. From the list view toolbar, click +. 14. Navigate to and select EndpointTools.ChoiceConnect.fdmwp from the FDM Tools Gas &

Water v4.2.0.335 release media. 15. Select the Copy Settings From Previous Enabled Version check box. 16. From the Upload Options drop-down menu, select Replace Existing Versions.

Itron Release Notes


25 of 25

17. Click OK. 18. Restart all FDM mobile applications and complete sign on and synchronization to update mobile

devices to the latest version. The application updates during synchronization.