Honeywell MasterLink User Manual

MasterLink Software Application User's Guide

Version 3.0 | July 2020

Patch Release to Support MIWI350 R110.1

Honeywell Process Solutions | Mercury Instruments

1280 Kemper Meadow Drive,

Cincinnati, OH 45240

855 251-7065 – United States & Canada | 302 669-4253 – Outside the United States

[e-mail] | www.honeywellprocess.com

Copyright July 2020. Honeywell Process Solutions. All rights reserved. 

Information in this document is subject to change without notice. The software described in

this document is furnished under a license agreement or non-disclosure agreement. The

software may be used or copied only in accordance with the terms of those agreements. No

part of this publication may be reproduced, stored in a retrieval system, or transmitted in

any form or any means electronic or mechanical, including photocopying and recording for

any purpose other than the purchaser's personal use without the written permission of

Honeywell Process Solutions.

For technical assistance, email at [e-mail].

CONTENTS

1 About MasterLink 1

1.1 Features 1

1.2 Security Considerations 2

1.1 Supported Device Functionality 3

1.2 Supported File formats and extensions 5

2 Installation 7

2.1 Before you install 7

2.2 Interoperability with SuiteSQL 8

2.3 Silent Installation 8

2.4 MasterLink Client Installation with SQL Server 9

2.4.1 Installing MasterLink with remote SQL Server 15

2.5 Installing MasterLink with SQLite 20

2.6 Upgrading MasterLink with SQLite/ SQL Server 26

2.7 Post Installation Steps 27

3 MasterLink User Interface 29

3.1 Getting Started 29

3.1.1 User Creation and Activation Process 29

3.1.1.1 Site Administrator Creation 29

3.1.1.2 Creating Users 30

3.1.1.3 User Registration 30

3.1.1.4 Forgot Password 32

3.2 Sites 33

3.2.1 Add Site 34

3.2.2 Connecting to a Site 37

3.2.3 Direct Connect 39

3.3 Dashboard 40

3.3.1 User Interface 43

3.3.2 Instrument Data 47

3.3.3 Alarms 48

3.3.4 Configuration Check 50

3.3.5 Time Sync 52

3.3.6 Firmware Update 53

3.3.7 Data Transfer 55

3.3.8 Instrument or Modem Power 57

3.3.9 Update User Account 61

3.3.10 Change Password 62

3.4 View and Edit 63

3.4.1 Configure by Group 63

3.4.2 Configure by Item 66

3.4.3 Send Item File 69

3.4.4 Logging Configuration 71

3.4.5 Manage User Table 74

3.4.6 Manage Shortlist 76

3.4.7 Manage AGA-8 77

3.5 Calibrate 78

3.5.1 Pressure Calibration P1 78

3.5.2 Pressure Calibration P2 86

3.5.3 Pressure Calibration P3 86

3.5.4 Temperature Calibration 88

3.5.5 Calibration Parameter 94

3.6 Read Data 95

3.6.1 Item File 96

3.6.2 Audit Trail 100

3.6.2.1 Audit Trail Graphs 105

Line Graphs 107

Circular Graphs 110

3.6.3 Alarm Logs 113

3.6.4 Event Logs 116

3.6.5 Diagnostic Logs 119

3.6.6 Cellular Logs 121

3.6.7 Shortlist 123

3.6.8 Activity Log 125

3.6.9 Item Reference CSV Export 127

3.7 Live Data 128

3.8 Administer 134

3.8.1 Activity Log - Purge 134

3.8.2 Export Instrument Data 137

3.8.3 Import Instrument Data 141

3.8.4 Item Template Configuration 146

3.8.5 Clear Logs 149

3.9 Settings 150

3.9.1 Communications Setup 150

3.9.2 Time-Sync Properties 153

3.9.3 Auto Download Settings 154

3.9.4 Device Properties 155

3.10 Security and User Management 156

3.10.1 User Configuration 157

3.10.1.1 Passkey Generation 159

3.10.2 User Roles 161

CONTENTS

4 Updates and Upgrades 163

4.1 EC 350/ ERX 350 Firmware Update 163

4.2 CloudLink Modem Firmware Update 164

4.3 Upload CloudLink Modem Certificates 165

4.4 Legacy Devices Firmware Upgrades 167

5 Glossary 169

5.1 Troubleshooting scenarios 171

1 About MasterLink

1 About MasterLink

MasterLink application provides a single software package to configure, calibrate and access data

from gas volume correctors. The software’s intuitive dashboard enables users to quickly determine

the overall health status of instruments. Employing standardized terminology, it is now an easy

task to configure and calibrate instruments, import data, and generate reports and graphs, thereby

eliminating time-consuming manual effort.

This software employs a dashboard based design philosophy enabling users to get a one-shot

status of connected devices. A gas industry first, the software can connect to the device using a

choice of short- range wireless communication protocols. The dashboard displays information

about alarms, battery voltage, audit trail, configuration integrity, firmware status, time sync and

live data. This helps the user understand the current condition of the connected device from a hol-

istic point of view.

MasterLink software addresses the increasing adoption of mobile devices for functions like check-

ing the health of field devices, downloading reports, instrument calibration and other activities

once performed exclusively on a laptop. It offers versatile wireless connectivity and is compatible

with the latest versions of both iOS and Android operating systems.

1.1 Features

MasterLink allows users to:

Define dashboard data (auto) download settings

Secure critical site data

Enable SSL encrypted communication with site Over the Air (OTA)

View / Edit item parameters of a connected device

Provides a wizard based calibration approach

Generate reports such as:

Item report - Item Report by Group, Site Report and Calibration Report

Audit Trail report (Plot graph over Audit Trail data)

Alarm Log report

Event Log report

Diagnostic Log report

Cellular Log report

Short List report

Activity Log report

Item Reference CSV Export

Capture live data and plot graphs

Honeywell | 1

Perform Database Administrative tasks such as

Activity Log Purge

Import/Export site or instrument data

Item Template Configuration

Clear Logs

Configure settings

Communication Setup

Time Sync Properties

Auto Download Settings for Dashboard

Device Properties

Email Options

Perform role based user administration for MasterLink

1 About MasterLink

Administer access privileges for device level functions by sending user table

Perform offline log-in configuration and send to instrument when connected

Perform instrument and modem firmware updates

1.2 Security Considerations

It is recommended to use the CloudLink modem in integrated mode with EC 350 for better

security during pairing

For data protection, it is recommended to provide full privileges to the Pro-

gramData\Honeywell\MasterLink folder only to appropriate MasterLink users

It is recommended to keep the PC used for MasterLink updated with the security patches

released by the respective platforms

It is also recommended to enable SSL for secure communication with MasterLink.

Its highly recommended to Install latest operating system security patches on the

machine where ML is installed.

Do not share MLK file with any unintended user

Honeywell | 2

1.1 Supported Device Functionality

*CL = CloudLink, PA = Pulse Accumulator, TC = Turbo Corrector

EC 350 CL*EC350 +CLPA* CNI4

Mini-

Max

ERX TCI

Mini-

AT

TC* Accutest ERX 350

ERX 350 +

CL

Mini

Turbo

Monitor

PT Mod-

bus

ER ECAT

Item Report

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Audit Report

ü û ü ü ü ü ü ü ü ü ü ü ü û û û ü ü

Alarm Report

ü ü ü û ü ü û û ü ü ü ü ü û û û û ü

Event Report

ü ü ü û ü ü û û ü ü ü ü ü û û û û ü

Diagnostic Report

û ü ü û ü û û û û û û û ü û û û û û

Cellular Report

û ü ü û ü û û û û û û û ü û û û û û

Shortlist Report

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Activity Report

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Send Log
Configuration

ü û ü û û û û û û û û ü ü û û û û û

Change
Instrument
Access Code

û û û ü û ü ü ü ü ü ü û û ü ü ü ü ü

Send User Table

ü ü ü û ü û û û û û û ü ü û û û û û

Send Item File

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Config Check
Template

ü û ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

P1 Calibration

ü û ü û û ü ü û ü ü ü ü ü ü û û ü ü

P2 Calibration

ü û ü û û û ü û ü ü ü ü ü û û û ü û

P3 Calibration

û û û û û û ü û û û û û û û û û û û

Temperature

ü û ü û û ü ü ü ü ü ü ü ü ü û û ü ü

*CL = CloudLink, PA = Pulse Accumulator, TC = Turbo Corrector

EC 350 CL*EC350 +CLPA* CNI4

Mini-

Max

ERX TCI

Mini-

AT

TC* Accutest ERX 350

ERX 350 +

CL

Mini

Turbo

Monitor

PT Mod-

bus

ER ECAT

Calibration

Firmware
Download

ü ü ü û ü û û û û û û ü ü û û û û û

Config By Item Or
Group

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Audit Trail Edit

ü û ü ü ü ü ü ü ü ü ü ü ü û û û ü ü

Shut Down Device

ü û ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Live Data Graph

ü û ü û û ü ü ü ü ü ü ü ü ü û û ü ü

Administer Data

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

EVC Firmware
Download

ü û ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Certificate Upload

û ü ü û ü û û û û û û û ü û û û û û

Modem Firmware
Download

û ü ü û ü û û û û û û û ü û û û û û

Time Sync

ü ü ü ü ü ü ü ü ü ü ü ü ü û û û ü ü

Write Items

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Active Alarms

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü û ü ü

User
Management

ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü ü

Generate Reports

ü ü ü û ü ü ü ü ü ü ü ü ü ü ü ü ü ü

EVC Reset Battery

ü ü ü û û û û ü û û û ü ü û û û û û

1.2 Supported File formats and extensions

FILE FORMAT EXTENSION

Item

File

Item Tem-

plate File

Firmware

File

User
Table

Shortlist

file

Logging Con-

figuration

Audit

Graphs

Live Graph

Setting

Live Graph

Values

Shortlist file with

value

Certificate

file

EC 350 IE3 TE3 BIN UTE CE3 LC AGS LGS LGV KE3

CloudLink
Modem

ICL TCL BIN UTE CCL KCL PEM

EC 350 +
CloudLink

ECL TEL BIN UTE CEL LC AGS LGS LGV KEL

Pulse Accu­mulator

IPA TPA MMX CPA KPA

CNI4 INI4 TNI4 MMX/BIN UTE SNI4 KNI4

Mini-Max IMX TMX MMX CMX LGS LGV KMX

ERX IEX TEX MMX CEX LGS LGV KEX

TCI ITC TTCI TCA CTC LGS LGV KTC

Mini-AT IMA TMA TXT CMA LGS LGV KMA

Turbo Cor­rector

ITT TTT CTT LGS LGV KTT

Accutest ITA TTA CTA LGS LGV KTA

ERX 350 IER3 TER3 BIN UTE CER3 LCER3 LGS LGV KER3

ERX 350 +
CloudLink

IER3L TER3L BIN UTE CER3L LCER3 AGS LGS LGV KER3L

Mini IMN TMN CMN LGV KMN

Turbo Monitor ITB TTB TBX/T8X CTB KTB

PT Modbus IPTC TPTC PTX CPTC KPTC

ER IER TER CER LGS LGV KER

FILE FORMAT EXTENSION

Item

File

Item Tem-

plate File

Firmware

File

User
Table

Shortlist

file

Logging Con-

figuration

Audit

Graphs

Live Graph

Setting

Live Graph

Values

Shortlist file with

value

Certificate

file

ECAT IAT TAT CAT LGS LGV KAT

Note: While upgrading R500 to R510, the file format extensions of CloudLink Modem and EC 350 + CloudLink Integrated device are to be changed as

FILE FORMAT EXTENSION

Item File Item Template File Shortlist file

Shortlist file with value

CloudLink Modem ICL TCL CCL KCL

EC 350 + CloudLink ECL TEL CEL KEL

below.

2 Installation

Component Requirement

CPU Quad Core and above

RAM 8 GB and above

Disk Space 80 GB and above

Operating System

Microsoft Windows 2008 Standard Edition 32 bit

Microsoft Windows 2008 Standard Edition 64 bit

Microsoft Windows 2008 R2 Standard Edition 32 bit

Microsoft Windows 2008 R2 Standard Edition 64 bit

Windows Server 2012 – SP1 (Standard, Essentials) : 64 bit

Windows Server 2012 R2 –SP1 (Standard, Essentials) : 64 bit

Windows Server 2016 (Standard, Essentials) : 64 bit

Database Server

SQL Server 2008 R2 (Standard, Enterprise) : 32 bit

SQL Server 2012 (Standard, Enterprise) : 32 bit

SQL Server 2014 (Standard, Enterprise) : 32 bit

SQL Server 2008 R2 (Standard, Enterprise) : 64 bit

SQL Server 2012 (Standard, Enterprise) : 64 bit

SQL Server 2014 (Standard, Enterprise) : 64 bit

SQL Server 2016 (Standard, Enterprise) : 64 bit

SQL Server 2017 (Standard, Enterprise) : 64 bit

2 Installation

This chapter describes the installation of MasterLink software.

2.1 Before you install

Here are the recommended system specifications:

Database Server Configuration

Note: If you are using a database instance on your network, you need to have domain user per-

mission.

Honeywell | 7

Client Configuration

Component Requirement

CPU Dual Core and above

RAM 4 GB and above

Disk Space 40 GB and above

Operating Sys­tem

Windows 7 – SP2 / Convenience rollup (Professional, Enterprise, Ultimate) :

32bit, 64 bit

Windows 8 – (Core, Pro, Enterprise) : 32bit, 64 bit

Windows 8.1 – (Core, Pro, Enterprise) : 32bit, 64 bit

Windows 10 – (latest build 2 months before release) : 32bit, 64 bit

Windows Vista Standard Edition 32 bit

Android

Android OS 4.3x, 4.4.0-4.4.4, 5.0.0-5.0.2, 5.1.x, 6.0

RAM: 1 GB onwards Memory: 8 GB onwards

Processor Speed: Dual-core 1 GHz onwards

Communication BLE compatible

General availability of Mail Client required

iOS

OS 7.1.x, 8.4.x, 9.1.x, 10.1.x

Memory: 8 GB onwards

Screen Size: 3.5 inches onwards

RAM: 1 GB onwards

Communication BLE capability

General availability of Mail Client required

Mobile Recommendations

2 Installation

2.2 Interoperability with SuiteSQL

MasterLink application can coexist with Suite SQL.

New MasterLink can be used with either SQL database Server or SQLite database.

If a single data source is preferred with an existing MasterLink SQL installation, please choose SQL

Server as a database option during installation.

2.3 Silent Installation

TO INSTALL SQL LITE IN SILENT MODE:

Command to Install the exe

Msiexec /i “<Path to MasterLink515.1exe>” /S /v”/qn DBTYPE=2 INSTALLDIR= <Path to Install>”

Honeywell | 8

2 Installation

Note:

INSTALLDIR is an optional argument, if it is not passed, by default it will get installed to

“C:\Program Files(x86) \Honeywell\MasterLink”

There is no space between /v and “

/S is case sensitive and it must be upper case.

DBTYPE is passed as empty, then SQLite DB will be installed

Example:

“C:\E569427___tanmay\RMG (\ML\build\MasterLinkR515.1.exe” /S /v”/qn DBTYPE=2 INSTALLDIR-

R=\”C:\Program Files(x86)\Honeywell\MasterLink\””

Path to Masterlink.exe - C:\E569427___tanmay\RMG (\ML\build\MasterLinkR515.1.exe

Path to Install - \”C:\Program Files(x86)\Honeywell\MasterLink\””

TO INSTALL SQL DB SERVER IN SILENT MODE:

Command to Install the exe

Msiexec /i “<Path to MasterLink515.1exe>” /S /v”/qn DBTYPE=1 INSTALLDIR= <Path to

Install> IS_DATABASESERVER=< Database Server that you are installing > DATABASEDIR=

<Place to Install the Database>”

Note:

INSTALLDIR is an optional argument, if it is not passed, by default it will get installed to

“C:\Program Files(x86) \Honeywell\MasterLink”

There is no space between /v and “

/S is case sensitive and it must be upper case.

DBTYPE is passed as empty, then SQLite DB will be installed. So DBTYPE=1 is mandatory

IS_DATABASESERVER= Database Server that you are installing to

DATABASEDIR = C:\Programdata\Honeywell\MasterLink\SQL (default value)

Example:

“C:\E569427___tanmay\RMG (\ML\build\MasterLinkR515.1.exe” /S /v”/qn DBTYPE=1

INSTALLDIR= \”C:\Program Files(x86)\Honeywell\MasterLink\” IS_DATABASESERVER-

R=IE1FLT5614GH2 DATABASEDIR=\”C:\ProgramData\Honeywell \MasterLink\SQL\\””

Path to Masterlink.exe - C:\E569427___tanmay\RMG (\ML\build\MasterLinkR515.1.exe

Path to Install - \”C:\Program Files(x86)\Honeywell\MasterLink\”

Database Server that you are installing - IE1FLT5614GH2

Place to install the Database - \”C:\ProgramData\Honeywell \MasterLink\SQL\\””

2.4 MasterLink Client Installation with SQL Server

Prerequisites:

Honeywell | 9

If you are using SQL Server, then a SQL Server instance must be installed before installing

MasterLink.

Administrative Privileges are required to install the application.

Ensure Masterlink.exe and Redist folder should be in the same path to avoid any errors on

crystal report.

To Install MasterLink Installation with SQL Server:

1. Launch the installer. The MasterLink - InstallShield Wizard appears. Click Next.

2 Installation

2. The License Agreement page appears. Click I accept... and then click Next.

Honeywell | 10

2 Installation

3. The Database Selection page appears. By default, SQL DB Server is selected.

If you choose to continue with a SQL DB Server for installation, then you will see the

following page (as shown in step 4), where you need to select the database server

instance.

Click Next to continue.

4. The Database Server page appears. Click Next.

Honeywell | 11

2 Installation

5. The Database Folder page appears. Browse and select the folder where you need to install

MasterLink and database files.

Click Next.

6. The Destination folder page appears, displaying information about the default destination

folder.

Click Next.

Honeywell | 12

2 Installation

7. The Ready to install the Program page appears. Click Install to continue.

Honeywell | 13

8. Finally, click Finish to complete.

2 Installation

Note: Select the check box to view the Installer log.

Honeywell | 14

2 Installation

2.4.1 Installing MasterLink with remote SQL Server

Prerequisites:

If you are using SQL Server, then a SQL Server instance must be installed before installing

MasterLink.

Administrative Privileges are required to install the application.

Ensure Masterlink.exe and Redist folder should be in the same path to avoid any errors on

crystal report.

To Install MasterLink with remote SQL Server

1. Right-click Setup file and then click Run as administrator. The MasterLink - InstallShield Wiz-

ard appears. Click Next.

2. The License Agreement page appears.

Click I accept the terms in the license agreement and then click Next.

Honeywell | 15

2 Installation

3. The D

atabase Selection page appears.

By default, SQL DB Server is selected. If you choose to continue with a SQL DB Server

for installation, then you will see the following page (as shown in step 4), where you

need to select the database server instance. Click Next.

4. The Database Server page appears.

Honeywell | 16

You can browse and select a database on your network. Click OK.

2 Installation

Click Next after selecting the required database.

Note: If you are using a database instance on your network, you need to have domain user per-

mission.

5. The Database Folder page appears. Click on Change and enter the path on the remote

machine where user intends to create the Database files. The path selected on remote

machine should not exist on the machine where the installer is running.

Click Next.

Note: The path selected on remote machine should exist on remote machine.

Honeywell | 18

2 Installation

6. The Destination folder page appears, displaying information about the default destination

folder. The path selected on remote machine should not exist on current machine where

installer is running.

Click Next.

7. The Ready to install the Program page appears. Click Install to continue.

Honeywell | 19

2 Installation

8. Click Finish to complete.

Note: Select the check box to view the Installer log.

2.5 Installing MasterLink with SQLite

Prerequisites:

Administrative Privileges are required to install the application.

Ensure Masterlink.exe and Redist folder should be in the same path to avoid any errors on

crystal report.

Honeywell | 20

2 Installation

1. Right-click Setup file and then click Run as administrator. Allow the program to make

changes to your computer by clicking Yes.

2. Click 'Install' to allow the Crystal Reports installation on your machine.

Honeywell | 21

3. For smooth installation, click 'Yes' to allow the changes to be effective immediately.

2 Installation

4. The MasterLink - InstallShield Wizard appears.

Click Next.

Honeywell | 22

2 Installation

5. The License Agreement page appears.

Click I accept the terms in the license agreement and then click Next.

6. The Database Selection page appears. By default, SQLDB Server is selected. User is required

to select SQLite DB.

Click Next.

Honeywell | 23

2 Installation

7. The Destination folder page appears, displaying information about the default destination

folder.

Click Next.

8. The Ready to install the Program page appears. Click Install to continue.

Honeywell | 24

2 Installation

9. Click Finish to complete.

Note: Select the check box to view the Installer log.

Honeywell | 25

2.6 Upgrading MasterLink with SQLite/ SQL Server

1. Right-click Setup file and then click Run as administrator. Allow the wizard to perform an

upgrade to your computer by clicking Yes.

2. The MasterLink - InstallShield Wizard appears. Click Next.

2 Installation

View the download process in the progress bar.

Honeywell | 26

2 Installation

3. Click Finish to complete.

Note: Select the check box to view the Installer log.

2.7 Post Installation Steps

1. To log on to MasterLink application, users need access to C:\Pro-

gramData\Honeywell\Masterlink. By default, all users under Users group has the required

privileges.

If a user falls under any other user group, then administrator should give “Full Control” priv-

ileges on folder “C:\ProgramData\Honeywell\Masterlink” for that particular user group.

Honeywell | 27