User’s Guide
Ref. no: 303040E
Third Edition, February 2007
Rosemount TankMaster.net
Website
www.rosemount-tg.com
Rosemount TankMaster.net Website
User’s Guide
Third Edition
Copyright © 2001-2007 Rosemount Tank Radar AB
Rosemount TankMaster.net 3
Third Edition, February 2007
Copyright © 2001 - 2007 Rosemount Tank Radar AB, Sweden,
Copyright law and international treaties protect this program. Unauthorized
reproduction, distribution of this program or any portion of it may result in severe civil
and criminal penalties, and will be prosecuted to the maximum extent possible under
the law.
4 Rosemount TankMaster.net
Third Edition, February 2007
Overview of Manuals
Overview of Manuals
TMn2Installation.pdf
This manual describes the procedure for installing TankMaster.net on Windows
2000 Server, Windows XP Pro and Windows 2003 Server with Internet
Information Services (IIS). Before installing TankMaster.net Server, minimum
system requirements have to be met that are mentioned in this manual. The
manual also presents the minimum system requirements for installing
TankMaster.net.
TMn2Config.pdf
This manual describes the procedure for configuring the TankMaster.net
Server. The information that is viewed on the TankMaster.net Website/WAP
website is set by the Administrator using the TankMaster.net Configuration
application. The manual describes how the Administrator can create, edit,
delete and assign rights to the Users and Groups for viewing tanks.
TMn2DataCollector.pdf
This manual describes the DataCollector application, which displays the Live
and Static data of the tanks polled with the current date and time. The manual
also explains how to start and end the application manually or automatically.
The data collected by this application is displayed on the TankMaster.net
Website/WAP websites.
TMn2Website.pdf
This manual provides a detailed description of various menus, products,
information etc which are viewed by the user on the website. The user can
change limited details of his profile, view details of all products, individual tanks,
view graphs and download tank information in Excel format.
TMn2UserStatus.pdf
This manual gives a detailed description of the information that is available on
users who are logged on to the TMn2Web website. It also displays the current
page being viewed by the user, the session Id assigned, session start time and
session expiry time. Only the Administrator can access this website.
Rosemount TankMaster.net 5
Third Edition, February 2007
Overview of Manuals
TMn2Wapsite.pdf
This manual describes how the TankMaster.net WAP website works using an
Internet browser. It also describes how to view details of individual tanks and
product groups.
6 Rosemount TankMaster.net
Third Edition, February 2007
Contents
Contents
1.0 Folder names and conventions used throughout this document.......8
2.0 Introduction........................................................................................9
2.1 Overview of TankMaster.net website.............................................9
2.1.1 TankMaster.net Login page.....................................................9
2.1.2 TankMaster.net Post Login Page..........................................10
3.0 Login................................................................................................13
4.0 Change Profile.................................................................................15
5.0 Help.................................................................................................17
5.1 Help..............................................................................................17
5.2 Glossary.......................................................................................17
6.0 Tank Inventory.................................................................................18
7.0 Overview .........................................................................................19
7.1 All Products..................................................................................19
7.2 All Tanks ......................................................................................21
7.3 Schematic ....................................................................................22
7.4 Error Indications...........................................................................23
8.0 History Graphs ................................................................................25
9.0 Download ........................................................................................30
10.0 Auto Refresh .................................................................................32
11.0 Logout ...........................................................................................35
12.0 Add/Modify a Language to theTankMaster.net website................36
12.1 To change the default language of the TankMaster.net website
...........................................................................................................36
12.2 To add a language to the TankMaster.net website....................37
12.3 To modify a Language for the TankMaster.net website.............39
13.0 Description of .ini files for TankMaster.net website......................47
13.1 Colors.ini....................................................................................49
13.2 Current.ini...................................................................................51
13.3 DownloadUnicode.ini.................................................................57
13.4 Format_Html.ini and Format_Win.ini.........................................60
13.5 History.ini and HistoryUnicode.ini..............................................67
13.6 Language.ini ..............................................................................69
13.7 Login.ini......................................................................................75
13.8 PieChartUnicode.ini...................................................................75
13.9 Schematic.ini..............................................................................76
14.0 Troubleshooting.............................................................................78
Rosemount TankMaster.net
Second Edition, February 2007
7
Folder names and conventions used throughout this document
1.0 Folder names and conventions used
throughout this document
In this document we will need to refer to some folders regularly. With a view to
make such references easier and shorter we will use the following
conventions:
TMnData will refer to the folder that by default resides in:
C:\Program Files\Saab\TankMasternet\TMnData
TMn2Web will refer to the folder that by default resides in:
C:\Program Files\Saab\TankMasternet\TMn2Web
TMn2WebHelp will refer to the folder that by default resides in:
C:\Program Files\Saab\TankMasternet\TMn2Web\WebHelp
Language Folder will refer to a subfolder of TMnData with the
LanguageName, Example: The English folder will refer to the folder that
resides in:
C:\Program Files\Saab\TankMasternet\TMnData\English.
There is also a Language subfolder that resides in:
C:\Program Files\Saab\TankMasternet\TMn2Web\WebHelp.
8 Rosemount TankMaster.net
Third Edition, February 2007
Introduction
2.0 Introduction
2.1 Overview of TankMaster.net website
The main aim of TankMaster.net is to make data of the tanks and
products available to users all over the world from offices, residences or
WAP phones. This data is available to users who are assigned a
Username and Password by the administrator. Users can only read the
data available on the website and view/download data in the form of Excel
spreadsheets for editing. The configuration of TankMaster.net is achieved
with the help of the TankMaster.net Configuration and TankMaster.net
DataCollector applications.
To access the Tankmaster.net website open the Internet browser, in the
address field enter
should be replaced by the internet name of the TankMaster Server or its
IP address. (E.g.
http://59.181.101.23/tankmasternet). The TCP port 80 (HTTP) is needed
to be enabled in the firewall/router settings for TankMaster.net to be
accessible on Internet.
If the TankMaster Server does not have a hardware lock, the
DataCollector and the website will run in DEMO MODE. A user by the
name of DEMO is created by default during the TankMaster.net
installation. If the application is working in DEMO MODE, only the user by
the name DEMO will be allowed to login to the website. To overcome this
mode, connect the hardware lock to the parallel/USB port of the
TankMaster Server.
2.1.1 TankMaster.net Login page
The Login page is the default page of the TankMaster.net website.
This page allows a valid user to Login, Change Profile and
change Language. It also provides Help for items on the Login
page.
Language Selection
The website can be configured to be viewed in different languages.
The default language is English. The administrators can add/modify
a language. The language configuration files are located in
TMnData and TMn2Web\WebHelp folders.
Note! For adding/modifying a language the Operating System should support
the desired language.
http://servername/tankmasternet. The servername
http://mpix191/tankmasternet or
Rosemount TankMaster.net 9
Third Edition, February 2007
Introduction
Login
The Login option allows a valid user to login into the website.
Change Profile
The Change Profile option allows the user to change their profile
according to the rights assigned by the administrator.
To change the user profile, click the Change Profile option on the
Login page. The administrator can add/remove the fields of the
Change Profile window, by editing the Login.ini file located in the
TMnData\Language directory.
Help option
The Help option has two submenus, Help and Glossary.
Help
The Help submenu provides help on items of the Login page.
Glossary
The Glossary submenu displays the details of the terms used
on the TankMaster.net website.
After the user logs in, the default page as set by the administrator is
displayed.
2.1.2 TankMaster.net Post Login Page
The navigation bar of this website contains: Tank List, Overview,
History, Download, Help and Logout.
Tank List
This option displays the list of available tanks mapped to the local
computer. Individual tank inventory can be viewed by clicking on a
tank in the Tank List.
Overview option
The Overview option has sub menus: All Products, All Tanks and
Schematic.
10 Rosemount TankMaster.net
Third Edition, February 2007
Introduction
All Products
The All Products submenu will display the details of all products
in a pie chart. It also displays the aggregate of the tank values in
the product group. The administrator can control the fields
displayed by editing the Current.ini file, located in the TMnData
directory.
All Tanks
The All Tanks submenu will display the details of all tanks as a
bar graph. It also displays available values of each tank. The
administrator can control the fields displayed by editing the
Current.ini file, located in the TMnData directory.
Schematic
The Schematic submenu will display the layout of the Tank
Farm. The Schematic web page has links (hotspot) to the Tank
Inventory page. The web user can click on the hotspot of the
tank that is visible on the schematic image to view the details of
the selected tank. The administrator can control the hotspots
displayed on the schematic diagram by editing the
Schematic.ini file, located in the TMnData\Language folders.
This file contains the tank name and the co-ordinates that are
used to control the size and the location of the tank in the
schematic diagram.
History option
The History option will display the past data of the OPC items in a
graphical format. The History page allows the user to view the
graphs of the tanks, by selecting the OPC items and setting the
date/time period. Tanks are identified by using different colors set
by the administrator. Changes can be made by editing the
History.ini and HistoryUnicode.ini files located in
TMnData\Language folders. This file allows the administrator to
set/change the default Refresh Rate for the history page, items to
be viewed under OPC items and the history period (in time) for the
graph to be displayed.
Download option
The Download option allows the user to download Live and Static
data in the form of an Excel workbook. The data contains Inventory
data of All Tanks and All Products.
Rosemount TankMaster.net 11
Third Edition, February 2007
Introduction
When the Download option is clicked during browsing the History
page, the data downloaded, will be the History data. If any other
page is being browsed, and the user clicks on the Download
option, the data downloaded is the Current data.
The administrator can control the fields that can be downloaded by
the user through a file DownloadUnicode.ini”. This file is in the
TMnData\Language directory. The Excel workbook will display the
Current and History data.
Help option
The Help option has two submenus: Help and Glossary.
Help
The Help submenu displays the help file of the current web
page.
Glossary
The Glossary submenu displays the details of the terms used
on the TankMaster.net website.
Logout
The Logout option exits the users from the TankMaster.net website
and displays the Login page.
12 Rosemount TankMaster.net
Third Edition, February 2007
Login
3.0 Login
To access the Tankmaster.net website open the Internet browser, and in the
address field enter
be replaced by the internet name of the TankMaster Server or its IP address.
(E.g.
http://mpix191/tankmasternet or http://59.181.101.23/tankmasternet
Select the Login button. This allows TankMaster.net web users to login to the
website. Only those web users who have a valid
assigned by the administrator will be able to login to this website.
http://servername/tankmasternet. The servername should
LoginID and Password
Login to the TankMaster.net website the user will have to do the following:
To
The default language of the Login page is English. The user can change
the language, by selecting a language on the language bar.
Select the Login option from the navigation bar, to allow the user to login
to the website
A Login window will be displayed with fields for LoginID and Password.
The valid LoginID and Password should be entered in these fields.
If an incorrect LoginID or Password is entered, an error message
Authentication error. Please try again will appear.
Note! A hardware lock should be connected on the TankMaster Server. If the
hardware lock is not found, the user will have to login to the website with
Rosemount TankMaster.net 13
Third Edition, February 2007
a LoginID and Password as “demo”. In DEMO MODE a maximum of five
Demo users are allowed. The number of concurrent users will depend
upon the hardware lock connected to the machine.
Login
14 Rosemount TankMaster.net
Third Edition, February 2007
Change Profile
4.0 Change Profile
The user can change his profile by selecting the
navigation bar of the Login page, according to the rights assigned by the
administrator.
To Change Profile
The Change Profile window is displayed below.
Change Profile option on the
The user will have to click on the Change Profile option on the navigation
bar of the Login page.
Note! The user is allowed to change his profile if the administrator has
assigned rights to the user in the TankMaster.net Configuration
application.
The user should enter the LoginID, Old Password, New Password and
Confirm Password in the fields provided. All fields are mandatory.
To change the password, the user should enter the LoginID in the field
provided for the LoginID. The old password (which at present is the
current password) is to be provided in Old Password field. The New
Password is to be entered in the field for New Password. This password
will be retyped in the field provided for Confirm Password.
Rosemount TankMaster.net 15
Third Edition, February 2007
Change Profile
The user should click on the button to submit the information. After
clicking the
If the user does not want to change his profile, he should select any other
option available on the Login page of the navigation bar or click on the
Change Profile option to exit from the Change Profile menu.
Note! If for any reason the user is not able to change his profile, he will have to
ask for the administrator’s assistance. After the password is changed, the user
will login to the website with the new password. The administrator can add
fields in the Change Profile menu by making changes in the “Login.ini” file
located in the TMnData\Language directories. A user cannot change his profile
in DEMO MODE.
button, the user data will be saved.
16 Rosemount TankMaster.net
Third Edition, October2004
Help
5.0 Help
The
Help option is available on the navigation bar of the Login Page.
The Help menu contains two submenus,
submenu contains the help on various pages on the website and the
Glossary submenu contains the definitions of terms used in the
TankMaster.net website.
5.1 Help
If the user clicks on the Help option before logging into the
TankMaster.net website, he will be able to view help on Login and
Change Profile.
If the user clicks on the Help option after logging into the TankMaster.net
website, he will be able to view help on the section that he is currently
viewing.
5.2 Glossary
To access the Glossary section the user will have to click on the Help
option on the navigation bar and click on Glossary.
The Glossary page will contain definitions of the terms used in the
TankMaster.net website.
Help and Glossary. The Help
Rosemount TankMaster.net 17
Third Edition, February 2007
6.0 Tank Inventory
To view a single tank’s inventory, either select a tank from the
option in the navigation bar, or select the tank from the
The single tank inventory window is as displayed below.
Tank Inventory
Tank List
Tree view.
The Tree view will display Available Tanks. These tanks can be viewed
under
belong.
All Tanks will display a list of all available tanks of all products. Click on the ‘+’
button to view all tanks.
To view tanks of a particular product, click on the ‘+’ button under the product
group.
To view a single tank’s inventory, click on an individual tank name from
Tanks
The rate of change in the levels of the product in the tank is shown by the up
and down arrows on the image of the tank. The up arrow signifies that the rate
of change is increasing and the down arrow signifies that the rate of change is
decreasing. If a red cross is visible in place of the arrow it signifies that it is an
Invalid Tank.
Note! For details on Error Indications in OPC value of a tank, refer to
7.4
All Tanks and under the respective product category to which they
or the product group.
All
section
18 Rosemount TankMaster.net
Third Edition, February 2007
Overview
7.0 Overview
The Overview option on the navigation bar has three submenus, All
Products, All Tanks and Schematic.
7.1 All Products
Overview of All Products
The All Products submenu allows the user to view details of all the
products that are available. The pie chart displays the aggregate of Total
Level Available, Total Level Utilized and the Free Water Level, by the
product available in the tanks in percentage value.
The net aggregate values as set up by the administrator are displayed
below the pie charts.
The image shown below, displays the Overview of all products.
Rosemount TankMaster.net 19
Third Edition, February 2007
Overview
If the user clicks on the pie chart of a product it will link to a page where
he will be able to view all the tanks that are listed under the particular
product.
The Overview of All Products will show the products with their levels
and other details. The rates of change in levels of the product in the tank
are shown by the up and down arrows. The Up arrow signifies that the
rate of change is increasing and the Down arrow signifies that the rate of
change is decreasing.
The Refresh Rate window appears below the Product tree view. The
default Refresh Rate is set as 90 seconds. This setting can be changed
by entering the Refresh Rate in seconds and clicking on the Set Rate
button.
If the Refresh Rate is set to zero, it means that the data will not be
refreshed. Do not set the Refresh Rate below 30 seconds.
Note! For details on Error Indications in OPC value of a tank, refer to
7.4
section
20 Rosemount TankMaster.net
Third Edition, February 2007
Overview
7.2 All Tanks
Overview of All Tanks
The All Tanks submenu allows the user to view details of all the tanks
that are available.
The tanks are displayed as a bar graph showing the Free Water Level at
the bottom of the tank and the product contained in it in a different color.
All Products are depicted in different colors.
If the user clicks on the arrow near a particular tank or the tank name, it
will display the tank’s inventory.
The Overview of all tanks will show all the tanks with their levels and
other details. The rate of change of the levels of the product in the tank is
shown by the up and down arrows. The Up arrow signifies that the rate of
change is increasing and the Down arrow signifies that the rate of change
is decreasing.
The Refresh Rate window appears below the Product tree view. The
default Refresh Rate is set as 90 seconds. This setting can be changed
by entering the Refresh Rate in seconds and clicking on the Set Rate
button.
If the Refresh Rate is set to zero, it means that the data will not be
refreshed. Do not set the Refresh Rate below 30 seconds.
Note! For details on Error Indications in OPC value of a tank, refer to
7.4
section
Rosemount TankMaster.net 21
Third Edition, February 2007
7.3 Schematic
This option displays the Schematic diagram of the Tank Farm.
The image shown below is a sample of the schematic diagram.
Overview
Setting up the Schematic diagram
To set up the Schematic diagram of the Tank farm:
Take an image of your tank farm. Re-scale that image to 838 pixels x 527
pixels and save as “Schematic.gif” in the TMn2Web\Images directory.
The outline of a tank can be defined as a circle, rectangle or a polygon.
If a circle is a suitable definition for the tank, determine the center
point in pixels and the radius in pixels.
If a rectangle is a suitable definition for the tank, determine the leftx, top-y, right-x, bottom-y co-ordinates of the rectangle.
If a polygon is a suitable definition for the tank, determine the x1,
y1, x2, y2, ..., xN, yN co-ordinates.
Determine a suitable place to place the legend (short name) of the tank
and note down the co-ordinates.
With the above information the Schematic.ini file can be edited.
22 Rosemount TankMaster.net
Third Edition, February 2007
Overview
To view the Schematic diagram:
Select the Schematic submenu under the Overview option on the
navigation bar.
The Schematic web page has links (hotspot) to the Tank Inventory page.
The web user can click on the hotspot of the tank that is visible on the
schematic image to view the details of the selected tank.
7.4 Error Indications
Significance of the red cross “x” and black cross “X”
If a red cross “x” is visible in place of the arrow it signifies that the data
pertaining to the status is invalid.
If a black cross “X” is visible in the center of the tank it signifies that the
data pertaining to the tank is invalid.
The image shown below is a sample of a tank having an invalid Level.
Significance of “?”
“?” displayed in a table indicates that the OPC_Quality is bad.
The image shown below is a sample of a tank having a bad OPC Quality.
Significance of “!”
“!” displayed against a value of an OPC item it signifies that the value is
an Invalid Value.
The image shown below is a sample of OPC item having an invalid value
Rosemount TankMaster.net 23
Third Edition, February 2007
Overview
Significance of “Man”
“Man” displayed as a prefix to a value signifies that the value of the OPC
item is manually set by the administrator.
The image shown below is a sample of a tank entry entered manually
Significance of date and time displayed in red
If the date and time is displayed in red with a warning message (warning:
last known data is used!)” then the data displayed is past data. This
error can be due to data collector service not started or data collection has
stalled
The image shown below is a sample of past data displayed.
24 Rosemount TankMaster.net
Third Edition, February 2007
History Graphs
8.0 History Graphs
The History option shows a graphical representation of the past data of the
OPC items of a product. The user will be able to view the graphs of only those
OPC items that are setup by the administrator on the TankMaster Server. The
administrator will have to set the OPC items on the TankMaster Server so that
the user can view the history graphs on the TankMaster.net website.
The following steps should be taken to setup the OPC Items history on
TankMaster Servers:
Open the WinOPI application by double clicking the icon on the desktop.
Login using the Username and Password. The Username is Supervisor
and the Password is Super by default. For security reasons, you are
advised to change the password at the earliest.
Select the View>Historical Graph option on the Menu bar. A window titled
Historical View will be displayed.
Rosemount TankMaster.net 25
Third Edition, February 2007
Loading...