Diebold Nixdorf T/SOP Retail 1 Installation guide

Brand: Diebold Nixdorf

Model: T/SOP Retail 1

Type: Installation guide

Installation Guide

T/SOP Retail 1.1 Windows

Diebold Nixdorf - Customer/Partner Use

Version 1.1.7

Table of Contents

1. Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê1

2. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê2

2.1. Product installer variants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê2

2.2. Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê2

2.3. Installation profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê2

2.4. Installation Requirements Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê3

2.5. Supported Java Runtime Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê3

2.6. Installation under Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê3

2.6.1. Interactive installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê3

Interactive installation Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê3

2.6.2. Silent installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê8

2.6.3. Unattended installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê8

2.7. Uninstallation under Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê8

2.7.1. Interactive uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê8

2.7.2. Silent uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê9

3. Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê10

3.1. Logging during installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê10

3.2. Logging during uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê10

4. Command line parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê11

5. References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ê12

Chapter 1. Introduction

The D&S Platform with the graphical user interface T/SOP is not part of the ProBase Store product

installer anymore. Instead it now gets provided by a separate T/SOP Retail product installer.

The current product installer for Windows operating systems is based on Inno Setup, that provides

the concept of profiles. T/SOP Retail installer currently offers two profiles to chose from: a standard

installation and a custom installation that allows selection of components to be installed.

Internally, the product is organized in components. The product installer will ensure that all

components needed for the selected profile are installed and configured. If the user would like to

adjust the subset of components selected through a profile, he also has the possibility to customize

it by selecting/deselecting components in the custom installation profile. However, the customized

subset of components will not be checked for consistency before the installer continues. Therefore,

dependency errors for lacking packages have to be solved by the user when customizing a profile.

Otherwise, the application may fail at runtime afterwards.

Installation Guide

Diebold Nixdorf - Customer/Partner Use 1

Chapter 2. Installation

The T/SOP Retail product installer can run in interactive mode as well as in silent mode. It also

provides the possibility of performing so-called unattended installations based on an initial master

installation.

2.1. Product installer variants

The T/SOP Retail product installer is available as 64-bit version for Windows and Linux based

operating systems. There is no 32-bit version available.

The provided product installer follow the naming scheme:

•TSOP-Retail-MAJOR.MINOR.BUILD.exe

Example: TSOP-Retail-1.0.30.exe

2.2. Supported Operating Systems

This version of T/SOP Retail has been tested on the following Windows operating systems:

•Windows® POSReady 7™ (64 bit)

•Windows® 7™ (64 bit)

•Windows® 10™ (64 bit)

2.3. Installation profiles

The current product installer for Windows operating systems is based on Inno Setup, which offers

the concept of installation profiles and can be used interactively as well as remotely, silent or

unattended.

In case of the T/SOP Retail installer, there are two profiles to chose from. The installer ensures that

all components for the selected profile are installed correctly and completely.

If necessary, the user can also make changes to the selection of the components specified by the

preselected profile by further selecting or deselecting components in the Custom Installation

profile. However, the installer cannot perform a consistency check of the components in the

modified profile, so the user must ensure that all required components are installed. Otherwise, the

application may not work at all or may work in a limited way.

The following table shows the currently defined installation profiles:

Profile Name Profile Meaning

Diagnostics and Serviceability (D&S) Platform

with T/SOP

Standard profile that installs all components

Installation Guide

Diebold Nixdorf - Customer/Partner Use 2

Profile Name Profile Meaning

Expert Installation Installation profile for customizing the

component selection.

NOTE It is recommended to use the predefined profiles and to perform a customized

installation only after consultation with the Diebold Nixdorf support team [1]

2.4. Installation Requirements Windows

•Administrator permissions required for installation.

•Microsoft Visual C++ Redistributable Package 2015 or newer is required to be installed on the

system.

•This product is intended to run with ProBase Store 2 and it conflicts with former ProBase

products, such as ProBase Store 1, ProBase POS, or ProBase Retail that must be uninstalled

beforehand.

2.5. Supported Java Runtime Environments

If not deselected, the product installer will install an appropriate Java Runtime Environment that

will be used by the service and tools provided.

However, any Java 17 JRE should work. But only when running against the incorporated JRE

support may be given.

2.6. Installation under Windows

The product installer may run in interactive mode as well as in silent mode. It also provides the

possibility of performing so-called unattended installations based on an initial master installation.

2.6.1. Interactive installation

The product installer provides an interactive mode, where the end user can:

•select one of the pre-defined installation profiles

•customize the installation by selecting/deselecting particular components

•define the Windows start menu shortcut group name

Interactive installation Example

NOTE

The setup can be cancelled on each step by clicking the [Cancel] button. If the setup

is already in the step of copying files, then the installation abort will roll back the

changes done to the system. Before this step, nothing will have happened to your

system. By clicking the [Back] button, you can go a step back in the setup if needed.

After launching the T/SOP Retail installer, the following welcome screen will appear

Installation Guide

Diebold Nixdorf - Customer/Partner Use 3

Dialog: Welcome to Setup Wizard

>> Click the [Next] button to go on with the setup.

Dialog: License Agreement

>> Choose [I accept the agreement] after reading.

>> Click the [Next] button.

Installation Guide

Diebold Nixdorf - Customer/Partner Use 4

Dialog: Select Components

In this dialog, one of the predefined installation profiles can be selected. Alternatively, you can

create your own installation using the Expert Installation profile and selecting the appropriate

components.

>> Select the components to install by using one of the installation profiles.

>> Click the [Next] button.

>> Alternatively, choose [Expert Installation] and check the features you want to install from the

list.

Dialog: Select Components - Expert Installation

>> Click the [Next] button.

Installation Guide

Diebold Nixdorf - Customer/Partner Use 5

Dialog: Select Start Menu Folder

>> Specify a start menu folder for this T/SOP Retail version.

>> Click the [Next] button.

The installer is ready to proceed with the installation and provides an installation summary for

letting you check all your previously made choices.

Dialog: Ready to Install

>> Click the [Install] button.

Installation Guide

Diebold Nixdorf - Customer/Partner Use 6

Dialog: Installing

The dialog above shows the current installation step and the overall progress of the installation.

Please wait until the installer finishes this step, except you want to cancel the installation (click the

[Cancel] button if so).

If no error had been encountered and everything had been finished successfully, you are going to

see a last dialog, informing you that the installation is complete and providing the possibility to

perform prepared post installation actions.

Dialog: Completing the Setup

>> Click [Finish] to end the installation.

Installation Guide

Diebold Nixdorf - Customer/Partner Use 7

2.6.2. Silent installation

A silent installation of T/SOP Retail is possible. For this, the product installer must be called with the

/SILENT parameter via the command line.

During a silent installation, the wizard and other background windows are not displayed. However,

a window showing the progress of the installation is displayed.

If this window is not to be displayed, you should use the completely silent installation mode with

the /VERYSILENT parameter. The JavaPOS installation profile is installed by default in silent

installation modes.

NOTE

Note: The silent or very-silent installation mode installs the standard profile with all

components. If a different selection of components is required, an unattended

installation is to be carried out (see chapter Unattended installation).

2.6.3. Unattended installation

As with silent installation, an unattended installation with command line parameters is also

possible. To do this, a supervised installation on a system must be executed with the parameter

/SAVEINF="pathToFile" in the first step. The following installation must be carried out with all

necessary specifications and settings. These settings and changes to the setup are stored in the file

specified.

With this file, the product installer and the setup parameters /LOADINF="pathToFile" as well as

/SILENT or /VERYSILENT, this recorded installation can now be run automatically, still and

unattended on other systems.

2.7. Uninstallation under Windows

The product uninstaller will remove all components, previously installed by the product installer,

even if the profile has been changed by subsequent installation attempts. See Inno-Setup

documentation for details.

2.7.1. Interactive uninstallation

There are three possibilities offered to run the uninstallation of the product interactively:

•direct call of the uninstaller unins000.exe located under the directory <TSOP Retail

installation-directory>\Uninstall\

•use the Windows start menu entry Uninstall TSOP Retail at the location Start Menu > all

programs > Diebold Nixdorf TSOP Retail

•or use the Windows system tool with Control Panel > Add or Remove Programs

Note: It is recommended not to call the uninstaller directly from the Windows Explorer, as the

uninstallation log will not be created (see chapter Logging during uninstallation for more details).

Installation Guide

Diebold Nixdorf - Customer/Partner Use 8

2.7.2. Silent uninstallation

Like for the installation, it is also possible to execute the uninstaller silently by applying the

command line argument /SILENT or /VERYSILENT.

Example

"C:\Program Files\Diebold Nixdorf\TSOP-Retail\Uninstall\unins000.exe"

/LOG="C:\ProgramData\javapos\dn\logs\uninstall_TSOP_Retail.log" /SILENT

NOTE

Unlike the installation, the uninstallation log is not activated by default, and

therefore, it is recommended to call the uninstaller with the /LOG="PathToLogFile"

switch also (see chapter Logging during uninstallation for more details).

[1] GSE; mail to [email protected]

Installation Guide

Diebold Nixdorf - Customer/Partner Use 9

Chapter 3. Logging

3.1. Logging during installation

The logging for the installation process is always activated. If the installer is not called with the

parameter /LOG="filename", the setup logging file will be stored in the %TMP% directory with a

unique filename based on the current date according to the pattern Setup Log yyyy-mm-dd

#<number>.txt.

Example

Setup Log 2023-06-16 #002.txt

3.2. Logging during uninstallation

The logging feature for the uninstallation process cannot be generally activated as it is for the

installation process. Therefore, and to activate logging for the uninstallation process, the parameter

/LOG="filename" must be appended to the uninstaller call.

The uninstallation logging has the following limitations:

•If the uninstaller is called directly (and without giving the /LOG option), then no uninstallation

log is created.

•The uninstaller cannot append a counter to the log file name as the installer can. Therefore,

only one uninstallation log per defined name is possible. If the product has been

installed/uninstalled multiple times, the uninstallation log will always be overwritten.

NOTE

We recommend using the product version number as well as the date and/or the

time within the log file name (e.g. /LOG=%TMP%/Uninstall_<ProductName>-

<Version>.<Build>.%DATE%.log).

Installation Guide

Diebold Nixdorf - Customer/Partner Use 10

Chapter 4. Command line parameters

Below you will find a short list of the most important command line parameters supported by the

product installer derived from the Inno Setup installer runtime.

This list is non-exhaustive and shows only the important command switches. For a complete list,

please refer to the Inno Setup official help.

/SILENT

The setup will run silent without displaying the wizard and the background window. However,

the installation progress window is shown as well as error messages during the installation.

/VERYSILENT

The setup will run silent without displaying the wizard, the background window and the

progress windows. Only error messages during the installation are shown.

/LOADINF="filename"

The installer will load the settings from the specified file after having checked the command

line. This file can be prepared using the /SAVEINF= parameter as explained below.

/SAVEINF="pathToFile"

The installer will save the installation settings to the specified file. Do not forget to use quotes if

the filename contains spaces and always use the absolute path to the file.

/LOG

The installer will create a log file in the user’s TEMP directory detailing file installation and

[Run] actions taken during the installation process. This can be a helpful debugging aid. For

example, if you suspect a file is not being replaced when you believe it should be (or vice versa),

the log file will tell you if the file was really skipped, and why.

The log file will be created with a unique name based on the current date. (It will not overwrite

or append to existing files.) The information contained in the log file is technical in nature and

therefore not intended to be understandable by end user. Nor is it designed to be machine-

parsable. The format of the file is subject to change without notice.

/LOG="filename"

Same as /LOG, except it allows specifying a fixed path/filename to be used as log file. If a file with

the specified name already exists, it will be overwritten and if the file cannot be created, the

installer will abort with an error message.

Installation Guide

Diebold Nixdorf - Customer/Partner Use 11

Chapter 5. References

▪[TSOP] Diebold Nixdorf. (2023). Technical Service and Operation (T/SOP) User Manual (version

1590).

▪[DS] Diebold Nixdorf. (2023). Diagnostics and Serviceability Platform Integration Manual

(version 1760).

Installation Guide

Diebold Nixdorf - Customer/Partner Use 12

Diebold Nixdorf T/SOP Retail 1 Installation guide

Diebold Nixdorf T/SOP Retail 1 Installation guide

Diebold Nixdorf T/SOP Retail 1 Installation guide

Related papers

Other documents