Install Tani Software

Windows

Under Windows all software comes with an installer which is an executable program. You can start it directly.
If You update an installed Tani product it will uninstall the previous version automatically and replaces it with the actual one.
All user configuration setting will be preserved.

A reboot will be requested in these conditions:

The running software can not be stopped. This may be true if an other running program uses the software.
Some parts of the software can not be removed because other software holds them open.
A program uses the directory holding the software.

A hint: If You uninstall the software separately and try installing them again it will request a reboot always.
Optionally you can ignore the reboot request. This is always at your own risk. Possibly required files can not be installed. The installed software may not work as expected.
Why a reboot is required after uninstall: The uninstall program can not be deleted by itself because it runs. Windows uses random generated file names in this registry key. So the installer cannot check if the reboot will be required or is optional.

The installation depending on your Windows patch level may start its internal update. This does not relay on software from Tani GmbH. If Windows will request updates it will do so. During the Windows update an internet connection is required. The installation process will need additional time until the update is finished. More information is available in the Windows Update.

For special envoronments it can be necessary running the OPC server or the PLC Engine not as a Windows service. We have a special documentation doing this.

If the software need to be installed unattended some command line parameters are required:
<name of the installer executable> /S /D=C:\Programs\Tani [Options]

Options for the first installation ur update:

/S - activates the Silent Mode
/D - defines the install destination path. Under Windows this could be /D=C:\Programs\Tani
/ignorereboot - will install also if a initial reboot is open from the operating system. (default: Installation will be canceled)
/enabledatestclient, /disabledatestclient - install / do not install the DA Test Client (default: as from the last installation, or disabled on fresh install)
/enableopccore, /disableopccore - install / do not install the OPC Core Components (default: as from the last installation, or enabled on fresh install)
/enableh1, /disableh1 - install / do not install the OSI H1 driver (default: deactivated)
/enabledesktopicons, /disabledesktopicons - install / do not install the desktop-icons (default: as from the last installation, or enabled on fresh install)
/enableconfiguration, /disableconfiguration - install / do not install the Configuration client (default: as from the last installation, or enabled on fresh install)
/enableuatestclient, /disableuatestclient - install / do not install the UA test client (default: as from the last installation, or enabled on fresh install)
/enablebonjour, /disablebonjour - install / do not install the Bonjour service (default: as from the last installation, or disabled on fresh install)
/enablewibu, /disablewibu - install / do not install the Wibu dongle driver (default: as from the last installation, or enabled on fresh install)
/enabledelayedstart, /disabledelayedstart - enable/disable the delayed start of the services (default: as in the last installation or deactivated)

Options for the first installation ur update (for PLC Engine installer with Historian only):

/enablehistorian, /disablehistorian - install / do not install the Historian (default: as from the last installation, or enabled on fresh install)

Options for fresh install (ignored on updates):

/enableuaserver, /disableuaserver - create / do not create the UA server connection (default: create the connection)
/enableuafirewall, /disableuafirewall - enable / do not enable the UA server in the firewall settings (default: enable in the firewall)
/enableinsecurecertificates, /disableinsecurecertificates - allow / do not allow untrusted certificates in the UA server (default: do not allow)
/enablepipeserver, /disablepipeserver - create / do not create the Pipe server connection (default: create the connection)
/enablepipefirewall, /disablepipefirewall - enable / do not enable the Pipe server in the firewall settings (default: enable in the firewall)
/enabledaserver, /disabledaserver - create / do not create the DA server connection (default: create the connection)
/enablebacnetfirewall, /disablebacnetfirewall - enable / do not enable BACnet in the firewall settings (default: enable in the firewall)
/enablememory, /disablememory - create / do not create the Memory connection (default: create the connection)
/enablesystem, /disablesystem - create / do not create the System connection (default: create the connection)
/enableuaitems, /disableuaitems - create / do not create the UA item access connection (default: create the connection)
/enableconfig, /disableconfig - create / do not create the Config connection (default: create the connection)

Options for fresh install (ignored on updates) (for PLC Engine installer only):

/enableexamples, /disableexamples - install / do not install the example logic table (default: do not install)

Errorlevel of the installer:

0 (ERROR_SUCCESS): no error did happen, installation OK
1: Installation canceled by the user (this only can happen after a user interaction, never in silent mode)
216 (ERROR_EXE_MACHINE_TYPE_MISMATCH): 64-Bit installer used on a 32 bit machine or vice versa
740 (ERROR_ELEVATION_REQUIRED): Administrator rights missing, installation canceled
1641 (ERROR_SUCCESS_REBOOT_INITIATED): Reboot was triggered (this only can happen after a user interaction, never in silent mode)
3010 (ERROR_SUCCESS_REBOOT_REQUIRED): Reboot is necessary but not triggered

Linux

PC

Linux requires the executable bit set in the installer.
Please set the execute bit.
In a command line enter: chmod u+x <installation file>

As security Linux does not start a program in the current directory. You need to give an additional path. The current path fixes this.
Example: ./<installation file>

If You are using a graphical frontend as KDE it is easier using a file manager like Krusader. You can start the install scripts directly, Krusader does the necessary things for You.

The configuration needs QT5 and Frameworks5 (KDE). Required is QT 5.6 or newer.

Suse provides this with version Leap 42.1 or newer
Kubuntu provides this from version 16 (version 15 is not supported).
Ubuntu 16.04 and 17.04 requires the Backport-Repository "ppa:kubuntu-ppa/backports"
(Type "sudo add-apt-repository ppa:kubuntu-ppa/backports && sudo apt-get update" on a command line).
Newer Ubuntu releases already have a QT library that is new enough.
All required libraries are installed by typing "sudo apt-get install plasma-desktop" on the command line.
If the program does not start behind please use Kubuntu instead of Ubuntu.
In Kubuntu 20.4 for using the graphical configuration please install qt5scripttools or qt5scripttools5, or for Ubuntu 2.04 libqt5scripttools5.
CentOS: yum install kf5-plasma
From version 7 additionally the packet kf5-kdelibs4support need to be installed also.
Debian 10 needs to be have installed KDE Plasma. Additionally install libqt5scripttools5 using the apper software installer.

Other dependencies:

(up to PLC Engine 1.8.x) openssl (version 1.0.0 or newer). Later versions are shipping the ssl libraries.
(up to PLC Engine 1.8.x)libz. Later versions are shipping the libz libraries.
xdg-utils (required for setup of Tani configuration)

To install them, use the commands on the command line:

"zypper install <packet name>" (for Suse distributions)
"sudo apt-get install <packet name>" (for Debian- and Ubuntu-based distributions)

If the software should be installed unattended some command line parameters are required:
<name of the installer executable> -destination=/opt/plcengine --i-agree-to-all-licenses --noprompt --noreadme --nooptions [additional options]
This example is for the standard case which will install it as a system daemon.

Options for the first installation or update:

-destination=[path] - destination path for the installation
--i-agree-to-all-licenses - don't show/auto-accept the EULA
--noprompt - don't show any messages
--noreadme - don't show readme files
--nooptions - don't show option selection

--force_root - always install as if running as root; NOTE: this assumes the current user can write to /etc and /var
--no_root - disable the root account detection, install in destination directory only, don't write to /etc and /var

The next two options exist only on the x86_64 installer.
--ui=ncurses - disable the graphical installer, use ncurses instead
--ui=stdio - disable both graphical and ncurses installer, use plain terminal instead
All other versions only support the stdio interface.

--enableupdate, --disableupdate - allow / do not allow updating the software via remote configuration client (default: as from the last installation, or disabled on fresh install)
--enablewibu, --disablewibu - install / do not install the Wibu dongle driver (default: as from the last installation, or enabled on fresh install)
--enablestationparamdebian - enable changing IP station parameters via Debian-specific /etc/network/interfaces file
--enablestationparamsystemd - enable changing IP station parameters via Systemd-managed /etc/systemd/network/*.network files
--disablestationparam - disable changing IP station parameters (default for fresh install)
--enablewebconfig, --disablewebconfig - install/do-not-install the web config process (default: as in the last installation or deactivated)

Options for fresh install (ignored on updates):

--enableuaserver, --disableuaserver - create / do not create the UA server connection (default: create the connection)
--enableinsecurecertificates, --disableinsecurecertificates - allow / do not allow untrusted certificates in the UA server (default: do not allow)
--enablepipeserver, --disablepipeserver - create / do not create the Pipe server connection (default: create the connection)
--enablememory, --disablememory - create / do not create the Memory connection (default: create the connection)
--enablesystem, --disablesystem - create / do not create the System connection (default: create the connection)
--enableuaitems, --disableuaitems - create / do not create the UA item access connection (default: create the connection)
--enableconfig, --disableconfig - create / do not create the Config connection (default: create the connection)

Options for fresh install (ignored on updates) (for PLC Engine installer only):

--enableexamples, --disableexamples - install / do not install the example logic table (default: do not install)

Raspberry, Odroid and compatible embedded devices

The web configuration bases on the Lighttpd Web Server. As standard it will not be installed.
Install it with
sudo apt-get install lighttpd
The software works without this web server, too. Use the configuration software for Linux or Windows on Your PC.

W&T pure.box3 and pure.box5

The pure.box is using a text based installer.
Put the installer to the device using ftp.
Start a ssh connection to the device.
Set the installer executable with "chmod u+x [filename]".
Execute it with "./[filename]".
After installation the software must be set started by the environment from W&T.
Select the file "userfiles/programs/plcengine/purebox_firmware_start.sh".
Press on the edit button on the left. Press "Create options". Check the "At system startup" and "Program".

Phytec Regor and Tauri

The Phytec devices are using a text based installer.
Put the installer to the device using ftp.
Start a ssh connection to the device.
Set the installer executable with "chmod u+x [filename]".
Execute it with "./[filename]".

For the Phytec devices a special software exists. It allows overlapping networks.
This is important on two networks which are using the same subnets.
This software is designed to security.
It removes all users and services which Phytec ships on the standard software for this devices.
Fort the protection against unauthorized installation (ald the denied access th the system) a command line parameter is needed.
./DeviceSetupRegorInstaller-[Version]-arm -fwinstall
or
./DeviceSetupPlusRegorInstaller-[Version]-arm -fwinstall

Later a firmware update can be done with the graphical configuration software.
The change from a firmware without and with the integrated web server can be done with the command line only.

Imprint

Tani GmbH, Freiligrathstrasse 12, 90482 Nuremberg Phone: +49 911 47766300 E-Mail: info@tanindustrie.de HRB: Amtsgericht Nürnberg 29562