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
MI-TAC-Support@Honeywell.com | 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 MI-TAC-Support@Honeywell.com.
<![endif]>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 InstallingMasterLink 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 andActivation Process |
29 |
|
3.1.1.1 Site Administrator Creation |
29 |
|
3.1.1.2 CreatingUsers |
30 |
|
3.1.1.3 User Registration |
30 |
|
3.1.1.4 Forgot Password |
32 |
3.2 |
Sites |
33 |
|
3.2.1 AddSite |
34 |
|
3.2.2 Connectingto 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 SendItem File |
69 |
|
3.4.4 LoggingConfiguration |
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 |
<![endif]>CONTENTS
|
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 TrailGraphs |
105 |
|
Line Graphs |
107 |
|
Circular Graphs |
110 |
|
3.6.3 Alarm Logs |
113 |
|
3.6.4 Event Logs |
116 |
|
3.6.5 DiagnosticLogs |
119 |
|
3.6.6 Cellular Logs |
121 |
|
3.6.7 Shortlist |
123 |
|
3.6.8 Activity Log |
125 |
|
3.6.9 Item Reference CSVExport |
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-SyncProperties |
153 |
|
3.9.3 Auto DownloadSettings |
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 |
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
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 holistic point of view.
MasterLink software addresses the increasing adoption of mobile devices for functions like checking 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.
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
1 About MasterLink
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
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
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 ProgramData\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
Note: While upgrading R500 to R510, the file format extensions of CloudLink Modem and EC 350 + CloudLink Integrated device are to be changed as
below.
2 Installation
This chapter describes the installation of MasterLink software.
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 permission.
Honeywell | 7
2 Installation
Client Configuration
Mobile Recommendations
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.
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\\””
Prerequisites:
Honeywell | 9
2 Installation
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. The License Agreement page appears. Click I accept... and then click Next.
Honeywell | 10
2Installation
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
2Installation
7.The Ready to install the Program page appears. Click Install to continue.
Honeywell | 13
2 Installation
8. Finally, click Finish to complete.
Note: Select the check box to view the Installer log.
Honeywell | 14
2 Installation
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 Wizard 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 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.
4. The Database Server page appears.
Honeywell | 16
2 Installation
You can browse and select a database on your network. Click OK.
Click Next after selecting the required database.
Note: If you are using a database instance on your network, you need to have domain user permission.
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
2Installation
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.
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
2Installation
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
2 Installation
3. For smooth installation, click 'Yes' to allow the changes to be effective immediately.
4.The MasterLink - InstallShield Wizard appears. Click Next.
Honeywell | 22
2Installation
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 Installation
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.
View the download process in the progress bar.
Honeywell | 26
2Installation
3.Click Finish to complete.
Note: Select the check box to view the Installer log.
1.To log on to MasterLink application, users need access to C:\ProgramData\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” privileges on folder “C:\ProgramData\Honeywell\Masterlink” for that particular user group.
Honeywell | 27