Emerson TankMaster Installation Manual
Installation Manual
00809-0200-5120, Rev AA
April 2021
Rosemount™ TankMaster™ Mobile
Inventory Management Software
TMN Mobile
NOTICE
Read this manual before working with the product. For personal and system safety, and for optimum product performance, ensure you thoroughly understand the contents before installing, using, or maintaining this product.
For equipment service or support needs, contact your local Emerson Automation Solutions/Rosemount Tank Gauging representative.
2
Installation Manual |
Contents |
00809-0200-5120 |
April 2021 |
Contents
Chapter 1 |
Introduction.............................................................................................................. |
5 |
|
|
1.1 |
Manual overview.......................................................................................................................... |
6 |
|
1.2 |
System architecture..................................................................................................................... |
7 |
|
1.3 |
Workspace................................................................................................................................. |
11 |
|
1.4 |
Before you begin........................................................................................................................ |
14 |
|
1.5 |
Technical documentation.......................................................................................................... |
15 |
Chapter 2 |
Getting started......................................................................................................... |
17 |
|
|
2.1 |
System requirements................................................................................................................. |
17 |
|
2.2 |
Quick start installation guide..................................................................................................... |
19 |
Chapter 3 |
Install the Rosemount™ TankMaster™ Mobile server software.................................. |
21 |
|
|
3.1 |
Preparations.............................................................................................................................. |
21 |
|
3.2 |
Software installation overview................................................................................................... |
22 |
|
3.3 |
Docker installation..................................................................................................................... |
25 |
|
3.4 |
Data Server and Application Server setup................................................................................... |
26 |
Chapter 4 |
Install the Tank Server Connector............................................................................. |
37 |
|
|
4.1 |
Preparations.............................................................................................................................. |
37 |
|
4.2 |
Rosemount™ TankMaster™ Tank Server Connector installation................................................... |
37 |
|
4.3 |
Connect to Tank Server.............................................................................................................. |
42 |
Chapter 5 |
Server management................................................................................................. |
45 |
|
|
5.1 |
Edit an Application Server.......................................................................................................... |
46 |
|
5.2 |
Edit a Tank Server...................................................................................................................... |
48 |
Chapter 6 |
Sign in procedure..................................................................................................... |
51 |
|
|
6.1 |
Sign in........................................................................................................................................ |
51 |
Chapter 7 |
License management............................................................................................... |
53 |
|
|
7.1 |
License management................................................................................................................. |
53 |
Chapter 8 |
Service and maintenance......................................................................................... |
63 |
|
|
8.1 |
Uninstall TankMaster Mobile...................................................................................................... |
63 |
|
8.2 |
Reinstall TankMaster Mobile...................................................................................................... |
67 |
|
8.3 |
Uninstall Tank Server Connector................................................................................................ |
68 |
|
8.4 |
Uninstall Docker........................................................................................................................ |
71 |
|
8.5 |
TankMaster™ Administration Utility........................................................................................... |
72 |
|
8.6 |
Servers....................................................................................................................................... |
73 |
|
8.7 |
Backup and restore.................................................................................................................... |
74 |
|
8.8 |
Reset user.................................................................................................................................. |
75 |
|
8.9 |
Change URL............................................................................................................................... |
76 |
Rosemount TankMaster Mobile |
3 |
Contents |
|
Installation Manual |
April 2021 |
|
00809-0200-5120 |
8.10 |
Certificate management.......................................................................................................... |
77 |
8.11 |
Add an Application Server........................................................................................................ |
78 |
8.12 |
Administration mode............................................................................................................... |
82 |
8.13 |
Software updates..................................................................................................................... |
84 |
8.14 |
Tank Server Connector setup................................................................................................... |
84 |
4 |
Installation Manual |
Installation Manual |
Introduction |
00809-0200-5120 |
April 2021 |
1 Introduction
This is an introduction to the Rosemount™ TankMaster™ Mobile Inventory Management software.
Rosemount TankMaster Mobile is an application for remote monitoring of tank farms. It is designed for standard web browsers and mobile phones. The application connects with servers that run Rosemount TankMaster inventory management software.
The graphical interface gives you a clear overview of tanks. Various views are available for different levels of detail.
Rosemount TankMaster Mobile is designed to meet applicable requirements for network and system security in international standard IEC 62443-3-3. It is designed for an architecture that supports segmentation of network layers and separate security zones with different access levels for various components.
Rosemount TankMaster Mobile is designed for the Docker platform. This ensures stable and reliable operation and simple installation in various computer network environments.
Subscribe to software updates
You can subscribe to Rosemount TankMaster Mobile updates for a specified period of time.
A license gives you access to software upgrades and security patches when available. Software updates are available on TankMaster.Rosemount.com/ServiceCenter.
Related information
Software updates
Rosemount TankMaster Mobile |
5 |
Introduction |
Installation Manual |
April 2021 |
00809-0200-5120 |
1.1Manual overview
This manual provides information on installing, and maintaining the Rosemount™ TankMaster™ Mobile system.
Chapter Introduction provides a description of the TankMaster Mobile workspace and system architecture.
Chapter Getting started provides system requirements and guidelines for installing the Rosemount TankMaster Mobile system.
Chapter Install the Rosemount™ TankMaster™ Mobile server software describes installation steps for installing Rosemount TankMaster Mobile.
Chapter Install the Tank Server Connector describes how to install the Tank Server Connector.
Chapter Server management describes how to edit application server and tank server features.
Chapter Sign in procedure describes how to sign in to TankMaster Mobile. Chapter License management describes various license management options.
Chapter Service and maintenance describes various maintenance functions such as backup, restore and more.
6 |
Installation Manual |
Installation Manual |
Introduction |
00809-0200-5120 |
April 2021 |
1.2System architecture
Rosemount™ TankMaster™ Mobile is a web-based system that allows you to collect realtime data and status information from Rosemount TankMaster Inventory Management systems. You may use desktop computers, laptops, tablets, and mobile phones to monitor tank farms via standard web browsers.
Rosemount TankMaster Mobile supports a network topology where different access points can be placed on different network layers as illustrated in Figure 1-1.
The system architecture is designed to meet high security requirements based on segmented networks with multiple layers isolated by firewalls.
A network is typically partitioned into separate network segments. The objective of network topology is to ensure that only authorized devices are connected to the network, and that their connectivity is restricted to the network segments where they are used.
The system can be setup with multiple access points (via Application Servers) on different network layers. Privileges are assigned to each Application Server in the system. A client connecting to a server on one network layer may have different privileges than a client on a second network layer.
Users are required to sign in for access to the TankMaster Mobile system. Full authentication requires registered devices which are validated by the TankMaster Mobile system for access to the system. All data is encrypted for secure communication.
Your site dictates PC addressing, applications allowed, timing of Windows Software Updates, and so on for the TankMaster Mobile Server. You must ensure that the TankMaster Mobile computer is compatible with site policy with regard to anti-virus software, security (such as PC hardening), and software updates.
Components
Components in the TankMaster Mobile system:
•Web Server/NGINX Reverse Proxy
•Application Server
•Identity Server
•Data Server
•Tank Server Connector
•Docker software platform
The Tank Server and Tank Server Connector are running on the same Rosemount TankMaster workstation. In a segmented topology the TankMaster workstation is typically installed on a Plant Network Layer 2 protected by firewalls. The Tank Server Connector communicates with the existing TankMaster system's Tank Server. It collects measurement data and status information and provides it to the Data Server.
TankMaster Mobile components are installed on a separate machine on Plant Network Layer 3 as illustrated in Figure 1-1.
Rosemount TankMaster Mobile |
7 |
Introduction |
Installation Manual |
April 2021 |
00809-0200-5120 |
Clients connect to the system via a Web Server/Reverse Proxy. The Application Server provides data to clients and can be configured to provide limited features for selected user groups.
Application Servers can be added to an existing TankMaster Mobile system. This may be useful, for example, in case you would like to provide access for clients on a Business Network Layer 4.
8 |
Installation Manual |
Installation Manual |
Introduction |
00809-0200-5120 |
April 2021 |
Figure 1-1: TankMaster Mobile System Architecture
Rosemount TankMaster Mobile |
9 |
Introduction |
Installation Manual |
April 2021 |
00809-0200-5120 |
User documentation
User documentation is organized as illustrated in Figure 1-2 to cover installation and operation.
Figure 1-2: TankMaster Mobile System and User Documentation Architecture
10 |
Installation Manual |
Installation Manual |
Introduction |
00809-0200-5120 |
April 2021 |
1.3Workspace
TankMaster Mobile web application start page has menus and icons for easy navigation to the various TankMaster functions.
Figure 1-3: Menus and Icons on the Start Page |
|
|
|
|
|
||||||
A |
B |
C |
E |
G H |
|||||||
|
|
|
|
|
D |
|
F |
|
I |
||
|
|
|
|
|
|
|
|||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
J
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
M |
||
K |
L |
||||||
|
|
||||||
A.Overview tab
B.Movement
C.Watchlist
D.Add tank group
E.Shortcut to My Profile
F.User account ("Administration Mode" appears to the left when signed in as administrator)
G.Print
H.Message
I.Sign out
J.Menu options (Administration Mode(1), My Profile, Sign Out, Help Center, About TankMaster)
K.Tank card
L.Tank groups
M.Tank card size (small, medium, large)
(1) Available for administrator accounts
Rosemount TankMaster Mobile |
11 |
Introduction |
Installation Manual |
April 2021 |
00809-0200-5120 |
Administration Mode
New menu options appear when you sign in to Administration Mode .
Figure 1-4: Menus in Administration Mode
12 |
Installation Manual |
Installation Manual |
Introduction |
00809-0200-5120 |
April 2021 |
1.3.1Start page menus
Summary of start page menus.
Table 1-1: Menus and icons on the start page
Item |
Description |
|
|
|
|
Overview |
Presents an overview of tanks and tank groups |
|
|
|
|
Movement |
Shows all tanks with moving product surface, i.e. tanks which are |
|
|
filled or emptied |
|
|
|
|
Watchlist |
Presents a group of tanks of special interest |
|
|
|
|
Add tank group |
Lets you add a new group with the desired tanks |
|
|
|
|
User account |
User account currently signed in |
|
|
|
|
Shortcut to print dialog. |
||
|
|
|
Message |
The message flag indicates that a message is available. Click the |
|
|
icon to read messages. |
|
|
|
|
Sign out |
Sign out from this account |
|
|
|
|
Menu options |
List of menu options: |
|
|
• |
Administrator Mode |
|
• |
My Profile |
|
• |
Sign out |
|
• |
Help center |
|
• |
About TankMaster |
|
|
|
Tank card |
Tank cards are available in small, medium, and large size |
|
|
|
|
Tank groups |
Available tank groups |
|
|
|
|
Shortcut to My Profile |
Opens My Profile with Account and Tank Groups |
|
|
|
|
Select tank card size |
Select the desired tank card size; small, medium, or large |
|
|
|
|
Rosemount TankMaster Mobile |
13 |
Introduction |
Installation Manual |
April 2021 |
00809-0200-5120 |
1.4Before you begin
To install and use TankMaster Mobile software, you should be familiar with:
•Microsoft® Windows
•Your local area network (LAN) configuration and security settings
•Network components installed on your system
•System requirements
•System management functions such as backup and restore
•Synchronizing system clocks for servers and clients
Related information
Software installation overview
14 |
Installation Manual |
Installation Manual |
Introduction |
00809-0200-5120 |
April 2021 |
1.5Technical documentation
The Rosemount™ Tank Gauging System includes a wide portfolio of user documentation. For a complete list, see product pages on Emerson.com/Rosemount.
Reference manuals
•Rosemount Tank Gauging System Configuration Manual (00809-0300-5100)
•Rosemount 2460 System Hub (00809-0100-2460)
•Rosemount 2410 Tank Hub (00809-0100-2410)
•Rosemount 5900S Radar Level Gauge (00809-0100-5900)
•Rosemount 5900 Proof Test with Reference Reflector (00809-0200-5900)
•Rosemount 5900C Radar Level Gauge (00809-0100-5901)
•Rosemount 2240S Multi-Input Temperature Transmitter (00809-0100-2240)
•Rosemount 2230 Graphical Field Display (00809-0100-2230)
•Rosemount 5300 Guided Wave Radar (00809-0100-4530)
•Rosemount 5408 Radar Level Transmitter (00809-0300-4408)
•Rosemount Tank Gauging Wireless System (00809-0100-5200)
•Rosemount TankMaster WinOpi (00809-0200-5110)
•Rosemount TankMaster WinSetup (00809-0100-5110)
•Rosemount TankMaster Floating Roof Monitoring (00809-0500-5100)
•Rosemount TankMaster Network Configuration (00809-0500-5100)
•Rosemount 5900 Radar Level Gauge and Rosemount 2410 Tank Hub Safety Manual Option S (00809-0500-5100)
Rosemount TankMaster Mobile |
15 |
Introduction |
Installation Manual |
April 2021 |
00809-0200-5120 |
Product data sheets
•Rosemount Tank Gauging System Data Sheet (00813-0100-5100)
•Rosemount 2460 System Hub Product Data Sheet (00813-0100-2460)
•Rosemount 2410 Product Data Sheet (00813-0100-2410)
•Rosemount 5900S Product Data Sheet (00813-0100-5900)
•Rosemount 5900C Product Data Sheet (00813-0100-5901)
•Rosemount 2240S Product Data Sheet (00813-0100-2240)
•Rosemount 2230 Product Data Sheet (00813-0100-2230)
•Rosemount 5300 Product Data Sheet (00813-0100-4530)
•Rosemount 5408 Product Data Sheet (00813-0100-4408)
16 |
Installation Manual |
Installation Manual |
Getting started |
00809-0200-5120 |
April 2021 |
2 Getting started
2.1System requirements
Hardware and software requirements for TankMaster Mobile Data server and Application server.
Version
1.1.0
Hardware
•64-bit processor
•Intel® i7 processor or similar is recommended
•Internal memory (RAM): Minimum 16 GB
•Hard disk drive:
—Minimum: 100 GB free disk space
—Recommended: 256 GB
Software
•Microsoft® Windows Server 2019 Standard version 1577 or later. Desktop Experience version.
•Firewall: open appropriate ports on the TankMaster Mobile server
•Supported web browsers for Microsoft Windows: Chrome, Firefox
•Supported web browsers on Android devices: Chrome
•Supported web browsers on iOS devices: Safari
Rosemount TankMaster Mobile |
17 |
Getting started |
Installation Manual |
April 2021 |
00809-0200-5120 |
Other requirements
•Installation requires administrator privileges
•To access the TankMaster Mobile system you need to make sure that the ports specified in Table 2-1 are open:
Table 2-1: Firewall Connections
Node |
Protocol |
Port |
|
|
|
Data Server (Main node) |
TCP |
2377, 5011, 7946 |
|
|
80, 443(1) |
Data Server (Main node) |
UDP |
4789, 5011, 7946 |
|
|
|
Tank Server Connector |
TCP |
5805(1) |
|
|
5805+1(1) |
Additional App Server |
TCP |
2377, 4433(1), 7946 |
Additional App Server |
UDP |
4789, 7946 |
|
|
|
Firewall Layer 3 |
TCP |
80, 443(1) |
|
|
5805(1) |
|
|
5805+1(1) |
Firewall Layer 4 |
TCP |
2377, 5011, 7946 |
|
|
|
Firewall Layer 4 |
UDP |
4789, 5011, 7946 |
|
|
|
External network nodes |
|
Appropriate ports |
|
|
|
(1) User configurable, i.e you may choose a port that complies with local IT policies
TankMaster
The following requirements refer to the server machine that hosts the Tank Master Tank Server and the Tank Server Connector:
•TankMaster version 6.F0 and higher
•Operating system Microsoft Windows 2012 Server R2 may not be used on TankMaster machine due to security limitations
Certificates
TankMaster Mobile requires digital certificates for a secure and trusted communication. Self-signed certificates are automatically distributed to all servers upon installation of TankMaster Mobile. The self-signed public root certificate needs to be distributed securely to clients using the system in order to be trusted by web browsers.
In case your organization has trusted root certificates from a root certificate vendor, you may use these instead of the self-signed certificates.
Related information
System architecture
18 |
Installation Manual |
Installation Manual |
Getting started |
00809-0200-5120 |
April 2021 |
2.2Quick start installation guide
This is a brief introduction how to setup the Rosemount™ TankMaster™ Mobile system.
The following steps need to be managed in order to properly setup a Rosemount TankMaster Mobile system. More information is provided in appropriate sections of this installation manual.
1.Setup a server machine for Rosemount TankMaster Mobile. Ensure that system requirements are fulfilled.
2.Ensure that TankMaster version 6.F0 or higher is installed on the TankMaster workstation.
3.Install Docker on the TankMaster Mobile machine.
4.Install Rosemount TankMaster Mobile on the dedicated machine.
5.Install Tank Server Connector on the TankMaster workstation.
6.Configure the TankMaster Mobile system:
•Connect the TankMaster Mobile server to the Tank Server on the TankMaster workstation
•Configure users and user groups
7.Activate your Rosemount TankMaster Mobile license.
Figure 2-1: Installation of components on various servers
Rosemount TankMaster Mobile |
19 |
Getting started |
Installation Manual |
April 2021 |
00809-0200-5120 |
20 |
Installation Manual |
Installation Manual |
Install the Rosemount™ TankMaster™ Mobile server software |
00809-0200-5120 |
April 2021 |
3 Install the Rosemount™ TankMaster™
Mobile server software
3.1Preparations
Before you begin installing the Rosemount™ TankMaster™ Mobile application, make sure that hardware and software system requirements are fulfilled.
Make sure that you have required information such as IP addresses, server names, firewall ports, service accounts, and other essential information.
The following information is required:
•IP address of the TankMaster Mobile computer
•IP address of the TankMaster Tank Server computer (will be needed after installation when connecting to TankMaster Tank Server)
Prior to installing Rosemount TankMaster Mobile you also need to:
•Assign computers that fulfill system requirements to host the TankMaster Mobile application and the Tank Server Connector. The Tank Server Connector is installed on the same machine as the Rosemount TankMaster software.
•Make sure that Docker is installed and up and running on the TankMaster Mobile computer.
•No other services than TankMaster Mobile services may be running in the Docker environment. Other services will automatically be terminated by the installer program.
•Multiple network cards must not be enabled during installation of TankMaster Mobile. Make sure that only one network card is enabled. Once installation is finished other network cards may be enabled again.
It is recommended that you collaborate with the IT department in order to integrate the TankMaster Mobile application with your network infrastructure.
Note
TankMaster Mobile is running in a Docker environment. In the event that Docker is used on the server machine for other services than TankMaster Mobile, they will automatically be terminated by the software installer. No other services may be used by Docker on a TankMaster Mobile server machine.
Related information
System requirements
Docker installation
Certificate management
Rosemount TankMaster Mobile |
21 |
Install the Rosemount™ TankMaster™ Mobile server software |
Installation Manual |
April 2021 |
00809-0200-5120 |
3.2Software installation overview
This is an introduction to the Rosemount™ TankMaster™ Mobile installation procedure.
Installation procedure
Installation of the system includes the following steps:
•Install Docker on the machine where TankMaster Mobile will be installed
•Install the TankMaster Mobile server software
•Install the Tank Server Connector on the computer where the TankMaster Tank Server is installed
•Configure the system:
—Connect the TankMaster Mobile server to the TankMaster Tank Server (Administrator mode; Servers>Tank Servers)
—configure users and user groups (Administrator mode; Users>User administration)
•Activate the TankMaster Mobile license
•Optional: setup custom certificates
Note
Once TankMaster Mobile is installed, ensure that clocks in servers and clients are synchronized. They may be located in different time zones as long as using accurate system time.
Related information
Docker installation
Data Server and Application Server setup
Rosemount TankMaster Tank Server Connector installation
Connect to Tank Server
Tank Server Connector setup
Administration mode
Software updates
22 |
Installation Manual |
Installation Manual |
Install the Rosemount™ TankMaster™ Mobile server software |
00809-0200-5120 |
April 2021 |
3.2.1System components
This is a brief summary of software components installed with the TankMaster Mobile system.
Table 3-1: System Components
Component |
Description |
|
|
Tank Server Connector |
The Tank Server Connector runs as a service on the same |
|
computer as the Tank Server and connects the existing Tank |
|
Server with the TankMaster Mobile system. It is installed on the |
|
same hardware and operating systems as the Tank Server. |
|
|
Data Server |
The Data Server collects data from one or several Tank Server |
|
Connectors and provides data to Application Servers. It also |
|
manages users, system settings and logging. |
|
|
SQL Server |
The SQL Server is a database that stores persistent data in the |
|
system. |
|
|
Identity Server |
The Identity Server is responsible for authenticating users. The |
|
Identity Server also manages authentication between servers in |
|
the system. |
|
|
Application Server |
The Application Server interacts with the Data Server to retrieve |
|
information. All communication with clients and Data Server is |
|
encrypted. |
|
|
Reverse Proxy Server |
The Reverse Proxy runs the web server. It routes client requests |
|
to Application Server and Identity Server running on a different |
|
network layer. |
|
|
Docker |
Docker is an application that is used to run TankMaster Mobile in |
|
an isolated environment called a container. This allows efficient |
|
use of computer resources. |
|
|
Administration Utility |
Includes functions for server management, backup and restore, |
|
user password reset, web server URL handling, and certificate |
|
management. |
|
|
Backup & Restore service |
Lets you make system backup and restore installation. This |
|
function is included in the Administration Utility. |
|
|
Related information
System architecture
Rosemount TankMaster Mobile |
23 |
Install the Rosemount™ TankMaster™ Mobile server software |
Installation Manual |
April 2021 |
00809-0200-5120 |
3.2.2Certificates
Digital certificates allow clients to check if the received data is coming from a trusted Server (Client/Server model).
Clients connect to Rosemount™ TankMaster™ Mobile servers using digital certificates. Servers and clients require separate web certificates. Self signed certificates are generated by the Data Server and distributed to all servers in the system.
Installation of server certificates is done automatically upon installation of TankMaster Mobile.
Once a client machine is approved by, and registered in, the TankMaster Mobile system, a root certificate can be downloaded. This option is provided from the start page when signing in the first time.
Should you want to use CA (Certificate Authority) web certificates, begin the process of establishing the chain of trust. CA certificates can be applied after installation.
You are responsible for system security, practices, and processes, and for the proper configuration and use of the Rosemount TankMaster Mobile product.
Related information
Install digital certificate
24 |
Installation Manual |
Installation Manual |
Install the Rosemount™ TankMaster™ Mobile server software |
00809-0200-5120 |
April 2021 |
3.3Docker installation
Docker needs to be installed prior to installing the Rosemount™ TankMaster™ Mobile package. We recommend that you use the script that is included in the TankMaster Mobile software package for a complete Docker installation.
Related information
Docker
Docker docs
3.3.1Install Docker
This is an instruction for installing the Docker software.
Prerequisites
Ensure that system requirements are fulfilled for the TankMaster Mobile server machine as well as any additional Application server machine.
Procedure
1.Locate the installation file named Install Docker.
2.Double-click the Install Docker file.
3.Wait until the installation process is finished.
4.When Docker installation is completed you will be prompted to restart the computer now (y) or manually at a later occasion.
Rosemount TankMaster Mobile |
25 |
Install the Rosemount™ TankMaster™ Mobile server software |
Installation Manual |
April 2021 |
00809-0200-5120 |
3.4Data Server and Application Server setup
Related information
Software installation overview
3.4.1Data Server and Application Server installation
Follow this instruction to install the Rosemount™ TankMaster™ Mobile Server software. The installation wizard automatically installs all the necessary components.
Prerequisites
Prior to installing the Rosemount TankMaster Mobile software you need to ensure that Docker is installed and up and running.
Make sure that server address and port number are available when requested during the installation process.
Procedure
1.Locate the installation file named Start The TankMaster Mobile Installation Wizard.
The installation program is located on the Rosemount TankMaster Mobile software installation disk, or in the downloaded and extracted zip-file if downloaded from the TankMaster.Rosemount.com/ServiceCenter web site.
2.Double-click the installation file to start the TankMaster Mobile installation wizard.
3. Click Next to proceed with the installation procedure.
26 |
Installation Manual |
Loading...