INTUS RemoteSetup - maintenance tool for INTUS terminals

 

Newer version of INTUS RemoteSetup available? Look at:
https://download.pcs.com/irs/

 

System preconditions:

INTUS RemoteSetup uses the protocol UDP from port 57005 or 48879 to port 57005 and TFTP (UDP, port 69) to maintain INTUS terminals. The ports, TFTP uses to establish a connection, can be limited to a range of numbers (INTUSRemoteStp.ini).
For state HTTP (TCP, Port 80) is used, for data (TCL download) TCP is used as well. The delivery status is that the terminal features server function and receives ONE connection on port 3001. Connection mode and port are configurable (Setup).

INTUS RemoteSetup now is named INTUS RemoteStp.exe, to avoid the User Account Control (UAC), implemented since WINDOWS VISTA, to require increased rights. Because of this reason the file description is adjusted too.

Attention: INTUS RemoteSetup must be executed as administrator (right mouse click), when routing entries are necessary to find terminals in the net.

 

More topics of this online help:

You find a detailed description of INTUS RemoteSetup in the manual "Terminal Configuration and Operation" (G3000-011)


Terminal list

INTUS RemoteSetup shows on the left side of the window INTUS terminals, which are reachable in the local area network.

First of all you select which LAN interface of your personal computer will be used to look up for terminals, or wether a file with extension *.rch  will be read to add the therein specified terminals to the terminal list of INTUS RemoteSetup.

When INTUS RemoteSetup ends, it creates optionally a file in the working directory with user-defined name and extension *.rch. This file saves a copy of the current terminal list. For future maintenance requirements you may save terminals in several lists, i.e. separating maintenance groups or locations.

The list is sorted according to various attributes by selection of a radio button in the box "looking for terminals using ... sorted by ..."

Sorting criteria:

Check boxes:

Define the sorting criteria and check box settings suitable for you on program start in INTUSRemoteStp.ini.

Buttons relating to terminal list:

Select one or more terminals with the usual key combinations (left mouse button and Ctrl-key or Shift-key) in the terminal list.

Buttons relating to selected terminals:

To Top

Terminal reachability in the local area network

If the personal computer provides more than one LAN interface, the process described below is executed on each of the LAN interfaces, or only on the selected one. Find and echo requests use UDP from port 57005 or 48879 to port 57005.

Reachability with IPv6 addresses:

INTUS RemoteSetup with IPv6 support first sends a find request into the local network segment [ff02::1]. All terminals with IPv6 suppport know about the find request. These terminals hold a unique, automatically from their MAC address generated local link IPv6 address. The terminals message with this IPv6 address and INTUS RemoteSetup receives these responds. Next the terminals get an echo request to their local link IPv6 address.

INTUS RemoteSetup registers, if an authentification by the terminal succeeds. The result of the authentification depends on the maintenence group in INTUS RemoteSetup and terminal.

Reachability with IPv4 addresses:

Terminals without IPv6 support also know about the find request from TCL 6.10 on. This find request is send as IPv4 broadcast to the terminals. Then an echo request is send as IPv4 broadcast as well, to find the terminals with elder TCL revisions.

Responding terminals get in both cases an echo request to their IPv4 address. If a terminal responds, it is reachable for INTUS RemoteSetup and included in the terminal list. If it does not respond, INTUS RemoteSetup generates a routing entry and tries to reach the terminal again. From WINDOWS VISTA on INTUS RemoteSetup needs administrator rights to do this.

Normally terminals, which reside in a different subnet then the personal computer, do not receive the IPv4 broadcast. The routers between the subnets are configured not to let the broadcasts pass. To maintain these terminals with INTUS RemoteSetup too, there are two ways: Use Add button and edit-field to insert additional terminals by IP address or host name into the list. These terminals are searched specificly and not by broadcast. The other way is to edit a file with extension *.rch. INTUS RemoteSetup reads it and looks up for the listed terminals specificly too.

INTUS RemoteSetup registers, if an authentification by the terminal succeeds. The result of the authentification depends on the maintenence group in INTUS RemoteSetup and terminal.

To Top

Actions - headline buttons

First select a terminal from the terminal list, then push the appropriate button for the maintenance tool. "Firmware Update" performs several selected terminals at the same time.

If you want to continue maintaining terminals, select the next terminal and click on the same or another button of the headline.

HTML - State

You see a static HTML-page from the terminal. It contains

of the terminal. An incorrect or problematic value is shown in red.

Use the Setup button to change operation parameters. 

To Top

Setup

The actual configuration of the terminal is read in and displayed on several register sheets. The topics of the register sheets are the main menu of the setup mode of the terminal. Only relevant register sheets and operation parameters are shown.

A warning is generated, if your changes will cause a cold boot. Be aware that a cold boot may also happen due to other reasons, i.e. an empty battery.

To Top

TCL download

You are connected to the TCL programming system of the selected terminal. You can send single TCL commands to the terminal or download files with TCL programming code. Data, sent by the TCL programming system, is shown.

The connection to the TCL programming system of the terminal is a TCP connection using the port 3001 (default) or any else port number set in the terminal's setup mode. INTUS RemoteSetup is client. The terminal must be server (Connection startup passive in setup mode). The terminal accepts only one connection using this port. If the terminal is already connected, an error message is shown and the connected host is named too.

TCL command

TCL file

Button clock

Button (Dis-) Connect

To Top

Firmware update

You can change TCL  and Server versions on the selected terminals. In the listboxes all versions are shown, INTUS RemoteSetup finds in the directory .\FirmwareDir. Select the firmware version and the language, the terminal will use. The firmware update collects all files needed for changing the version. For INTUS 3300, INTUS 3400, INTUS 3500, INTUS ACM8 and INTUS 3000 ACM autoexec.bat is analysed, to change also software for PCMCIA cards.

Two terminals can be updated at the same time. The terminals actually updated are indicated. Below this the updating progress is shown in a line of text. The 1. progressbar displays the progress of a file transfer to the terminal. The 2. progressbar shows the progress of updating the actual terminal. The progressbar at the bottom grows with every updated terminal from the list of selected terminals.

Every terminal updated and started with new TCL or server firmware is recorded in the file INTUSUpdateDone.txt in the directory of INTUS RemoteSetup.

When you change between TCL version 4, 5 and version 6 a cold boot is executed without warning. This avoids an interruption of the fully automated process of updating terminals.

To Top

Reset

Execute a reset on the selected terminal. From TCL 5.50 on you can select the startup mode: warm boot, cold boot, comstart or ice-cold boot.

For INTUS 3460, INTUS 3660 and INTUS ACM40 you may force a system reboot of the LINUX kernel.

To Top

Keyboard layout

This program assists you in defining a keyboard layout for the matrix touch keyboard of the selected terminal. On start the actual keyboard layout is read from the terminal and displayed. You can modify this layout, load a different layout from a file or again read the layout from terminal. You can save a modified keyboard layout in a file. For loading a new keyboard layout into the terminal push the button "Send to terminal". Finally a reset is automatically executed.  

The keyboard file of an INTUS 3460 and 3660 includes an identification and revision number of the keyboard layout as well as a description. If the keyboard file is consistent with the delivery status a [verified] is shown. After a modification of the file [not verified] is displayed.

To Top

LBus security

Load LBus key: In Setup for a subset of readers a key can be generated and stored in the terminal. Transfer this key now to the selected readers. You need the key transfer in case of  initial startup or of key modification.

Enable / disable parameter card: from TCL V6.04 on you can enable or disable the reader function "Read parameters from parameter card after power on reset". This allows changes and additions of the reader parameters after initial startup. PCS service generates paramater cards.

Reader firmware update: from TCL V6.20 on INTUS ACM40/INTUS3460/INTUS 3660 you can update the reader firmware on LBus. The PCS Service Centre provides a file with reader firmware for you individually. For creating this so-called "IRFW" file, the PCS Service Centre needs a list of serial numbers of the respective terminals/ACMs.
After the reader firmware was updated from 4.x or 5.x to version 6.x, the reader always has to be reconfigured. This is done via a VX parameter card.

To Top

Setup IPv4

If a terminal is NOT found in the terminal list after searching in the local area network, use this function. It sets up the IPv4 network parameters and restarts the terminal to take over the values. Afterwards the terminal is searched by an echo request with its new IPv4 address as usually. If it is reachable it is included in the terminal list. INTUS RemoteSetup uses broadcasts for these configuration process (with TCL versions before TCL 5.50 and from TCL 5.52 on).

This scenario happens,

Insert the serial number of the terminal (rating plate). From TCL 5.52 on the maintenance group is also required. In the delivery status it is group 0. Specify the following IPv4 network parameters to put a terminal in operation from a personal computer in a net without DHCP server or with a crossed patch cabel:

To Top

Button Info

Version and license issues of INTUS RemoteSetup

Button ?

Short description of INTUS RemoteSetup in HTML format. You find a detailed description of INTUS RemoteSetup in the manual "Terminal Configuration and Operation" (G3000-011).

Exit INTUS RemoteSetup

The terminal list is saved in a file with user-defined name and extension *.rch in the directory of INTUS RemoteSetup on your request.

To Top

Files, created by INTUS RemoteSetup:

INTUS RemoteSetup creates all files in its working directory.

 

List of reachable terminals: file with extension *.rch

If INTUS RemoteSetup is closed, in the working directory a file with user-defined name and extension *.rch can be stored. This file includes all terminals of the current terminal list. On the next start of INTUS RemoteSetup all files in the working directory with extension *.rch are available. In case not one or all LAN interfaces but a file is selected to look up for terminals, INTUS RemoteSetup reads the included list and tries to reach all the terminals one after another. If a terminal responds, it is inserted into the terminal list.

Syntax of a line in file:
<serial number of terminal>;<IPv4 address>;<IPv4 address of PC LAN interface> ;<IPv4 host name>;<global IPv6 address>;<local link IPv6 address>;<IPv6 host name>;

Example of a file, created by INTUS RemoteSetup:

2195133;192.168.80.245;;intus-2195133.entwicklung.pcs.de;2001:a60:f055:1fff:a00:27ff:fe60:af9d;fe80::a00:27ff:fe60:af9d;autoconf-intus-2195133.entwicklung.pcs.de;
4017896;192.168.80.232;;intus-4017896.entwicklung.pcs.de;2001:a60:f055:1fff:a00:27ff:fe60:c2d6;fe80::a00:27ff:fe60:c2d6;;
4482396;192.168.80.157;192.168.10.165;intus-4482396.entwicklung.pcs.de;;;;
4697436;192.168.11.142;;intus-4697436.pcs.ditec.de;;fe80::a00:27ff:fe60:a281;;

You may edit a file with simplified syntax in advance, to find the terminals, which are not reachable by a broadcast. Fill in one line per terminal with the following syntax:
<serial number of terminal>;<IPv4 address>;<IPv4 host name>.
Single fields may be empty, if the information is not yet available.

Example of a file to be read in:

4455576;192.168.11.90;intus-4422576.pcs.ditec.de
4422578;192.168.10.17;irstest.pcs.ditec.de

In elder versions the file name was fixed to INTUSReachable.txt.

 

INTUSRemoteStp.ini

The INI file provides settings for the look of the terminal list and for TFTP, which are adopted on the start of INTUS RemoteSetup.

Example of INTUSRemoteStp.ini:

[Terminallist]
;arrange according to
; PRODUCT: INTUS product names (default)
; SERIALNO: serial numbers
; IPADDR: IP addresses
; DNSNAME: host names
; FIRMWARE: firmware versions

Order=SERIALNO

;add to terminal list
; ALL all terminals (default)
; MAINTGRP only terminals of current maintenance group

Add=ALL

;show host name
; FQDN: full qualified domain name: means entire host name (default)
; SHORT: host name up to the 1. point in notation

ShowHostname=FQDN

;show IP address
; MIXED: IPv4 addresses in IPv4 format (default)
; IPV6: all addresses in IPv6 format

ShowIPAddr=MIXED

[TFTP]
;Establish TFTP connections on port numbers between <minPort> and <maxPort>

minPort=2010
maxPort=2020

 

INTUSUpdateDone.txt

contains a protocol of firmware updates. Every successful firmware update is listed by a line with serial number and new TCL or server version. The file grows constantly. Print it and clear it. It is created again by the next firmware update.

Example:

0594051 TCL 6.12
1983054 TCL 6.12
2320637 TCL 6.12

 

INTUSRSetupTrace.txt

Trace file of INTUS RemoteSetup for debugging. This file is only written, when it exists.

To Top

FAQ    Frequently Asked Questions

The firewall prohibits INTUS RemoteSetup to access the network

WINDOWS operating systems block the first execution of INTUS RemoteSetup.
Click on "Unblock". Then repeat the search for terminals in the network or start INTUS RemoteSetup again.

 

The terminal list is empty:

The network card of your personal computer should be set up to Auto Negotiation. It must not be set up definitely to the transfer rate of 100 Mbit/s.

This setting is not always found on the same way. Here an example: Settings -> Control Panel -> Network -> LAN connection -> State of LAN connection -> Attributes: now you find in Configure, register sheet Additional settings the attribute Connection Type with value AutoSense

 

The terminal list includes none or not enough terminals:

The terminals have the option DHCP, but the network has no DHCP server, so the terminals have to use the default IP address 0.0.0.0. But WINDOWS operating systems drop ethernet packets with this source address. INTUS RemoteSetup seems to get no responses from the terminals. Use the function Setup IPv4 to set up the IPv4 network parameters.

 

Some terminals are not reachable:

ICMP redirect messages must be switched off in the network. Otherwise the attempt of INTUS RemoteSetup fails to add a routing entry to reach a terminal with inappropriate IP address for the subnet.

For personal computers with WINDOWS 2000 or WINDOWS XP: use the registry editor and look for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters. Change EnableICMPRedirect of type REG_DWORD to value 0.

 

To Top