Rosemount TankMaster Net WebSite User guide

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

Rosemount TankMaster.net 3

Third Edition, February 2007

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

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

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

http://servername/tankmasternet. The servername

should 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). 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.

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

http://servername/tankmasternet. The servername should

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

LoginID and Password

assigned by the administrator will be able to login to this website.

To

Login to the TankMaster.net website the user will have to do the following:

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

Login

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.

14 Rosemount TankMaster.net

Third Edition, February 2007

Change Profile

4.0 Change Profile

The user can change his profile by selecting the

Change Profile option on 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.

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

button, the user data will be saved.

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.

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,

Help and Glossary. The Help

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.

Rosemount TankMaster.net 17

Third Edition, February 2007

Tank Inventory

6.0 Tank Inventory

To view a single tank’s inventory, either select a tank from the

Tank List

option in the navigation bar, or select the tank from the

Tree view.

The single tank inventory window is as displayed below.

The Tree view will display Available Tanks. These tanks can be viewed

under

All Tanks and under the respective product category to which they

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

All

Tanks

or the product group.

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

section

7.4

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

section

7.4

20 Rosemount TankMaster.net

Third Edition, February 2007

Page is loading ...

Rosemount TankMaster Net WebSite User guide

Rosemount TankMaster Net WebSite User guide

Related papers

Other documents