Professional Documents
Culture Documents
03.04.06 TPEM Remote Client Desktop (TPEM RC DT) 1252 4268 - en
03.04.06 TPEM Remote Client Desktop (TPEM RC DT) 1252 4268 - en
EN
2019-01
Competence level CL 1
Contents
1 Introduction to operation ............................................................................................................... 4
1.1 Starting and exiting TPEM RC ..................................................................................................... 5
1.1.1 Starting TPEM RC ............................................................................................................... 5
1.1.2 Exiting TPEM RC ................................................................................................................. 6
2 “File” menu...................................................................................................................................... 8
2.1 Login ........................................................................................................................................... 8
2.2 Access mode ............................................................................................................................. 10
2.2.1 Creating / editing intranet profile ................................................................................... 10
2.2.2 Connecting to a plant ...................................................................................................... 12
2.2.3 Remote access ................................................................................................................. 15
2.2.4 Service ............................................................................................................................. 19
2.2.5 Adjusting the network adapter configuration of the host computer.............................. 21
2.3 Copying to the TPEM USB token .............................................................................................. 24
2.3.1 Copying authorization profile or developer certificate to a token.................................. 24
2.3.2 Saving TPEM Update Container on a TPEM USB token ................................................... 26
2.4 Updating TPEM USB token ....................................................................................................... 27
2.4.1 Initializing the TPEM USB token ...................................................................................... 28
2.4.2 Creating TPEM USB token................................................................................................ 29
2.5 Settings ..................................................................................................................................... 30
2.6 Managing screenshots ............................................................................................................. 32
2.6.1 Displaying screenshots saved on the TPEM USB token ................................................... 32
2.6.2 Downloading screenshots to the disk.............................................................................. 33
2.6.3 Deleting screenshots on the TPEM USB token ................................................................ 33
2.7 Data export............................................................................................................................... 34
2.7.1 Displaying data saved on the TPEM USB token ............................................................... 34
2.7.2 Downloading data to the disk.......................................................................................... 35
2.7.3 Deleting screenshots on the TPEM USB token ................................................................ 35
2.7.4 Unzipping data ................................................................................................................. 35
3 "View" Menu ................................................................................................................................. 37
3.1 Opening a New Window .......................................................................................................... 37
3.2 Refreshing................................................................................................................................. 38
3.3 Screenshot ................................................................................................................................ 39
3.4 Zoom......................................................................................................................................... 40
Date: 2019-01-17
Page: 2 of 43
4 "Help" Menu .................................................................................................................................. 41
4.1 Displaying software version ..................................................................................................... 41
4.2 Displaying TPEM USB token information ................................................................................. 41
5 Installing TPEM RC ......................................................................................................................... 43
6 List of abbreviations ...................................................................................................................... 43
Date: 2019-01-17
Page: 3 of 43
1 Introduction to operation
The TPEM Remote Client (TPEM RC) is the software for TPEM visualization on a computer.
The following actions are possible using the TPEM Remote Client:
• For Service:
o Performing remote diagnostics and remote maintenance on a plant
o Providing an authorization profile on a plant
o Providing TPEM Update Container on a TPEM USB token
• For the operator:
o Remote operation and monitoring of a plant
o Providing an authorization profile on a plant
o Extending authorizations to a TPEM USB token
o Providing an authorization profile on a plant
The remote access is realized via a router, the so-called TPEM Remote Plant Gateway, which displays
the interface to the area network in the plant. The TPEM Remote Plant Gateway is installed in the
TPEM Control Cabinet.
The remote access to the plant control is established using a secured connection (VPN tunnel).
To authenticate the users at the plant and when accessing remotely, as well as to transport data
to and from the plant, a TPEM USB token is used.
Only TPEM USB tokens can be used in conjunction with the TPEM Remote Client.
TPEM USB tokens are encrypted and can only be read or written via TPEM Remote Client.
A TPEM USB token cannot be accessed via the Windows File Manager.
Date: 2019-01-17
Page: 4 of 43
1.1 Starting and exiting TPEM RC
1.1.1 Starting TPEM RC
Desktop Shortcut
The menu bar with the following menus appears on screen pages:
The content of the menu is dependent on the operator's authorization level. The figures in the
documentation always correspond to the highest authorization level.
• File, with the menu items:
o Login, only available when “Remote access” has been selected in access mode
o Access mode
o Copy to TPEM USB token, available for authorization level 200 and above
o Update TPEM USB token, for extending user authorization
o Settings, default settings of the software
Date: 2019-01-17
Page: 5 of 43
o Manage screenshots, to download or delete screenshots saved on the connected
TPEM USB token
o Data export, for exporting operating data saved on a TPEM USB token to the disk
o Intranet profiles, to access created Intranet profiles
o Exit, for exiting the software
• View, only available when a TPEM screen is visible, with the menu items:
• Help, for displaying the software version and information about the TPEM USB token
Date: 2019-01-17
Page: 6 of 43
Individual windows, in which TPEM is displayed, can be closed using the Close button (x) in
the header line on the top right.
Date: 2019-01-17
Page: 7 of 43
2 “File” menu
2.1 Login
When “Remote” has been selected as the access mode, the “Login” function is available / appears
automatically in the “File” menu.
• Select “Login”, or
• select “Access mode” and then “Remote” and confirm by clicking “OK”
The login window opens
Date: 2019-01-17
Page: 8 of 43
If no TPEM USB token with an authorization level of at least 50 is connected, the following
message appears:
“TPEM USB Token not found. Connect a valid token and try again.”
o Confirm the message by clicking “OK”. Connect TPEM USB token to the USB interface
and repeat the procedure.
While TPEM USB token reading is still in progress when logging in, the following message
appears:
“TPEM USB token reading in progress. Please wait."
o Confirm the message by clicking “OK”, wait a short time and repeat the procedure.
Note:
When a user has been set up for use of the TPEM RC, they automatically receive the login
data via e-mail.
Date: 2019-01-17
Page: 9 of 43
2.2 Access mode
Note: Before the TPEM RC can be used after installation, certain settings have to be made. See
section 2.5 Settings, page 30.
Access to the TPEM operating software is always possible directly via the same network from the
same IP address area (Intranet), via the service socket on the switch cabinet or via remote access.
Multiple users with reading rights can be connected to the plant at the same time, whereas just one
user with editing rights can connect to the plant.
Date: 2019-01-17
Page: 10 of 43
Add: Opens the editing mask for creating new intranet profiles
Edit: Opens the editing mask for editing created intranet profiles
Delete: Deletes a selected intranet profile
Filter (Search): Clicking in the “Filter” area displays an additional line above the list entries.
The designation “Filter” changes to “clear”, with which the line can be hidden again.
When the filter is activated, you can search separately by entering a search input in the top
cell of each column.
Note:
When searching with "*" at the beginning as a placeholder, the search looks for results
"containing" the search text.
When searching without "*" at the beginning as a placeholder, the search looks for results
"beginning" with the search text.
If, for example, you are looking for names that end in "son", you will not find them by
entering just "son". Instead, enter "*son".
Print: Prints the list of user gateways after selection of the printer properties.
Export: For exporting the list of user gateways as a json file.
Import: For importing a list of user gateways as a json file
Date: 2019-01-17
Page: 11 of 43
2.2.2 Connecting to a plant
For access via "Intranet" the TPEM Remote Client must be executed by a terminal in the same
network as the plant, with which a connection is to be established (identical IP address area).
If a plant should be operated, control via the plant must be established. A connected TPEM
USB token with the necessary authorization is required.
• To do this, click the "Take control" button for the desired plant.
Intranet access in Control mode with TPEM USB token authentication via the USB interface of
the terminal in use:
The TPEM screen of the plant appears.
While the connection to the plant is being established, the message “Please wait...” and
the button “Disconnect” are shown. The process can be terminated by clicking on the button.
When the connection to the plant is established, the message and button are hidden.
If the plant is already being accessed by another TPEM Remote Client, a connection is not
possible. The following message appears: “Another user is accessing the HMI page, closing
the application.”
Once the connection to the plant is established, the following display appears on the
touch panel of the selected plant: “Another user is controlling this system remotely.” and the
button “Take Control”
Date: 2019-01-17
Page: 13 of 43
The operator on the plant has the option to exit the control at any time by clicking the “Take
Control” button. The remote access is then interrupted.
The following message then appears on the screen of the TPEM Remote Client:
“Local user has taken control. Closing the connection.”
If the operator on the plant does not exit the control, operation of the TPEM interface is
possible with the TPEM Remote Client in compliance with the authorization level.
In order to interrupt the connection to the plant using the TPEM Remote Client, the following
actions are possible:
• Close window of the TPEM screen, close TPEM Remote Client or change the access mode.
The connection is severed
The message “Another user is controlling this system remotely” and the button “Take
Control” on the touch panel of the plant are hidden.
Date: 2019-01-17
Page: 14 of 43
2.2.3 Remote access
To access the system “remotely”, the TPEM USB-Token of a user with the access rights to the desired
plant must be connected to the USB interface of the terminal in use.
• Select “Access mode” in the “File” menu
The selection mask appears
Date: 2019-01-17
Page: 15 of 43
Reload:
For updating the data connection and screen display.
Export:
For exporting the contents of the list.
Print:
For printing the contents of the list
• highlight desired objects in the list.
• click on “Print”.
• select desired printer and save location.
Filter (Search):
Clicking in the “Filter” area will display an additional line above the list entries. The
designation “Filter” changes to “clear”, with which the line can be hidden again.
When the filter is activated, you can search separately by entering a search input in the top
cell of each column.
Note:
When searching with "*" at the beginning as a placeholder, the search looks for results
"containing" the search text.
When searching without "*" at the beginning as a placeholder, the search looks for results
"beginning" with the search text.
If, for example, you are looking for names that end in "son", you will not find them by
entering just "son". Instead, enter "*son".
Save Remarks:
Saves the entries in the “Remarks” column.
ID:
Serial number of the TPEM Remote Plant Gateway
Plant name
Name of the plant
Remark:
Remarks on each plant can be saved here.
Date: 2019-01-17
Page: 16 of 43
Connected users:
Displays the user names of all users currently connected to one of the plants assigned to the
logged in user.
Logged in as:
Displays the user name
The status of the plant switches from “Online” to “Connected”, the display on the
“Connect” button switches to “Disconnect”.
If a plant is selected that is already being accessed by another TPEM Remote Client, a
connection is not possible. See column “Connected users”. The following message appears:
“Cannot establish connection. Device is already connected.”
Date: 2019-01-17
Page: 17 of 43
The TPEM screen of the selected plant appears.
While the connection to the plant is being established, the message “Please wait...” and
the button “Disconnect” are shown. The process can be terminated by clicking on the button.
When the connection to the plant is established, the message and button are hidden.
Once the connection to the plant is established, the following display appears on the
touch panel of the selected plant: “Another user is controlling this system remotely” and the
button “Take Control”
The operator on the plant has the option to exit the control at any time by clicking the “Take
Control” button. The connection in Control mode is interrupted and re-opened in View
mode.
The following message then appears on the screen of the TPEM Remote Client:
“Local user has taken control. Closing the connection.”
If the operator on the plant does not exit the control, operation of the TPEM interface is
possible with the TPEM Remote Client in compliance with the authorization level.
In order to interrupt the connection to the plant using the TPEM Remote Client, the following
actions are possible:
Date: 2019-01-17
Page: 18 of 43
• Click “Disconnect” button, close window of the TPEM screen, close the TPEM Remote Client
or change the access mode.
The connection is severed.
The message “Another operator is controlling this system remotely.” and the button
“Take Control” on the touch panel of the plant are hidden.
2.2.4 Service
No more adjustments in the settings are required, as because of the selection a permanently
saved IP is used and all the entered IPs in the settings are ignored.
Date: 2019-01-17
Page: 19 of 43
While the connection to the plant is being established, the message “Please wait...” and
the button “Disconnect” are shown. The process can be terminated by clicking on the button.
When the connection to the plant is established, the message and button are hidden.
If the plant is already being accessed by another TPEM Remote Client, a connection is not
possible. The following message appears: “Another user is accessing the HMI page, closing
the application.”
Once the connection to the plant is established, the following display appears on the
touch panel of the selected plant: “Another user is controlling this system remotely” and the
button “Take Control”
The operator on the plant has the option to end the remote access at any time by clicking the
“Take Control” button. The connection is then severed.
The following message then appears on the screen of the TPEM Remote Client:
“Local user has taken control. Closing the connection.”
If the plant is already being accessed by another TPEM Remote Client, a connection is not
possible. The following message appears: “Another user is accessing the HMI page, closing
the application.”
If the operator on the plant does not exit the control, operation of the TPEM interface is
possible with the TPEM Remote Client in compliance with the authorization level.
In order to interrupt the connection to the plant using the TPEM Remote Client, the following
actions are possible:
• Close window of the TPEM screen, close TPEM Remote Client or change the access mode.
The connection is severed
The message “Another user is controlling this system remotely” and the button “Take
Control” on the touch panel of the plant are hidden.
Date: 2019-01-17
Page: 20 of 43
2.2.5 Adjusting the network adapter configuration of the host computer
To connect the laptop to the TPEM Remote Plant Gateway, the laptop must have an IP address from
the same address area as the Remote Plant Gateway. If necessary, the IP address of the
corresponding network interface must be changed at the laptop for this.
Note:
The description was formulated as an example for a laptop with the operating system Windows 7.
Administrator rights may be required to change the IP address of the laptop.
Start bar
• Click on the “Open Network and Sharing Center” line (1) in the “Internet connections”
selection window
• Click on the “Change adapter settings” line (1) in the “Open Network and Sharing Center”
selection window.
Date: 2019-01-17
Page: 21 of 43
Change adapter settings selection window
• Right click “LAN Connection” button (1) or the button of the adapter that was connected to
the service socket.
Date: 2019-01-17
Page: 22 of 43
Input mask for Internet Protocol Version 4 (TCP/IPv4) Properties
Date: 2019-01-17
Page: 23 of 43
2.3 Copying to the TPEM USB token
2.3.1 Copying authorization profile or developer certificate to a token
An authorization profile must be brought to the plant with a TPEM USB token to enable customer-
specific authentication at the plant.
Note:
The “Copy authorization profile to token” function is available for authorization level 200 and above.
The “Copy developer authorization to token” function is available for authorization level 300 and
above.
Requirements:
• The authorization profile or developer certificate received by email is saved on the computer
• The TPEM USB token is connected to the USB port
• In the “File” menu select “Copy to TPEM USB token”, “Authorization profile” or “Developer
authorization”
The following window appears
• Click on the “Browse” button (2) and search for the folder in which the desired authorization
profile is saved or the desired authorization profiles are saved. Authorization profiles have
the ending “tef”
Date: 2019-01-17
Page: 24 of 43
• Highlight the folder and click on the “Select folder” button
The folder path appears in the window (1)
The pull-down menu (3) shows all companies for which authorization profiles are saved in
the folder
• Select desired company in the pull-down menu
The pull-down menu (4) displays all gateways for which authorization profiles for the
selected company are saved in the folder
• Select whether to download the authorization profile of all gateways or a particular gateway
of the selected company
• Confirm selection by clicking “OK”
If the process was successful, the following message will appear: “Selected plant
authorization profile downloaded successfully.”
Date: 2019-01-17
Page: 25 of 43
2.3.2 Saving TPEM Update Container on a TPEM USB token
Note:
The “Copy TPEM Update Container to the TPEM USB token” function is available for authorization
level 200 and above.
Requirements:
• The TPEM Update Container received by email is saved on the computer
• TPEM USB token is connected to the USB port
• In the “File” menu, select “Copy to TPEM USB token”, “Save TPEM Update Container to TPEM
USB token”
The following window appears
• Search for the folder in which the TPEM Update Container is saved. TPEM Update Containers
have the ending “icef”
• Open the folder and select the icef file
• Click on the “Open” button
The TPEM Update Container is copied to the TPEM USB token
If the procedure was successful, the following message appears: “TPEM Update Container
successfully copied”
Date: 2019-01-17
Page: 26 of 43
2.4 Updating TPEM USB token
• To extend the validity of the user authorization on a TPEM USB token
• To be able to temporarily install greater access rights to a token
Requirements:
• The user authorization received by email is saved on the computer
• The TPEM USB token is connected to the USB port
• In the File menu select “Update TPEM USB token” -> “From file”
The input window appears
• Click on the “Browse” button and search for the folder in which the desired user
authorization is saved. User authorizations have the ending “upef”
If the connected TPEM USB token is still new, it must be initialized first.
Warning: TPEM USB tokens for which there is no upef file are unusable after initialization.
Date: 2019-01-17
Page: 28 of 43
2.4.2 Creating TPEM USB token
Requirements:
• The authorization file received by email is saved on the computer
• TPEM USB token is connected to the USB port
• In the File menu select “Update token” -> “From file” and proceed as described under
Section 2.4 Updating TPEM USB token, page 27
If the connected TPEM USB token is still new, it must be initialized first.
For this see: Section 2.4.1 Initializing the TPEM USB token, page 28
Date: 2019-01-17
Page: 29 of 43
2.5 Settings
2 Max. number of windows: Preselection of the maximum number of on-screen windows that
can be open at the same time. The maximum number of screen windows is 10.
4 Proxy settings: If proxy settings are to be used, this can occur using a stored script or by
manually inputting the settings.
Date: 2019-01-17
Page: 30 of 43
Manual input:
If proxy settings are to be used, this can be done on the one hand by manually inputting the
settings Proxy server, Proxy port, User name and Password.
Date: 2019-01-17
Page: 31 of 43
2.6 Managing screenshots
For information on taking screenshots, see section 3.3 Screenshot, page 39
All screenshots that are on the TPEM USB token are displayed.
Date: 2019-01-17
Page: 32 of 43
2.6.2 Downloading screenshots to the disk
• Display saved screenshots (see above)
• Click on “Download” button
The Windows Explorer window appears
Date: 2019-01-17
Page: 33 of 43
2.7 Data export
Data such as messages, histories, parameters and log files for the software analysis can be exported
from the TPEM TP to a TPEM USB token. See “TPEM operating manual”.
Using the TPEM RC desktop, it is possible to export the data either to a TPEM USB token or to the
disk.
The exported data are compressed in an encrypted Zip file.
Data found on a TPEM USB token can be saved and unzipped on the hard drive.
All data that are on the TPEM USB token are displayed.
Date: 2019-01-17
Page: 34 of 43
2.7.2 Downloading data to the disk
• Display saved data (see above)
• Highlight desired Zip file
• Click on “Download” button
The Windows Explorer window appears
Date: 2019-01-17
Page: 35 of 43
• Select export file
• Select or create extract folder
Date: 2019-01-17
Page: 36 of 43
3 "View" Menu
3.1 Opening a New Window
Individual subwindows, in which TPEM is displayed, can be closed using the Close button (x)
in the header line on the top right.
Date: 2019-01-17
Page: 37 of 43
3.2 Refreshing
Date: 2019-01-17
Page: 38 of 43
3.3 Screenshot
Date: 2019-01-17
Page: 39 of 43
3.4 Zoom
o Select “Zoom in” or press the keyboard shortcut “Ctrl” and “+”:
The highlighted screen area is magnified.
o Select “Zoom out” or press the keyboard shortcut “Ctrl” and “-”:
The highlighted screen area is made smaller.
Date: 2019-01-17
Page: 40 of 43
4 "Help" Menu
Date: 2019-01-17
Page: 41 of 43
User type:
Display options:
Service Technician
Customer
Dealer
Authorization level: Level of access rights that exist until the TPEM USB token's validity has
expired.
Authorization File:
Yes: An extended authorization file was found on the TPEM USB token, which governs
further authorizations. This may be: temporary higher access rights or temporary access to a
certain plant.
No: No extended authorization file was found on the TPEM USB token.
Token valid until: Date and time after which the TPEM USB token loses the access rights
entered into it.
Date: 2019-01-17
Page: 42 of 43
5 Installing TPEM RC
Requirements:
• Administrator authorization
• System requirement: Windows 7 or higher
• The installation file received by email is saved on the computer
The TPEM RC also installs the network adapter “TpemEngineConnector”, which is required to
establish a secure connection to a plant via the Internet.
This can be found in Control Panel > Network and Internet > Network Connections.
Before the TPEM RC can be used after installation, certain settings have to be made. See section 2.5
Settings, page 30.
6 List of abbreviations
DEV Developer
Date: 2019-01-17
Page: 43 of 43