INSTALLATION GUIDE ProBase POS 2 Installing JavaPOS, OPOS, POS for .NET and CPOS on Windows May 2019 Imprint Mathias Janke Diebold Nixdorf Systems Group Retail Products Wohlrabedamm 31 13629 Berlin [email protected] Systems Group Retail Products 2 Revision history Version Date Author Comment/Change 1.0 Sep. 2016 Mathias Janke 1st version Typos corrected, chapter JavaPOS configurator and 2.0 Dec. 2016 Mathias Janke Verifying the installed configuration updated, chapter OPOS Configuration Updater added 3.0 Jul. 2017 Mathias Janke Typos corrected; Adaptations for PBP 2.3 4.0 Sep. 2017 Mathias Janke Adaptations for PBP 2.4 5.0 May 2018 Mathias Janke Adaptations for PBP 2.6 6.0 Dec. 2018 Mathias Janke Adaptations for PBP 2.8 Adaptations for PBP 2.9, small corrections and additional 7.0 May 2019 Mathias Janke pictures. Systems Group Retail Products 3 Contents Introduction ........................................................................................................... 6 Installation of ProBase POS 2 ................................................................................. 7 Prerequisites .............................................................................................................................. 7 Supported Operating Systems ....................................................................................................... 7 Minimum prerequisites ................................................................................................................. 7 Additional prerequisites ................................................................................................................ 8 Product installer variants ............................................................................................................... 8 Installation profiles .................................................................................................................... 8 Interactive installation ............................................................................................................... 9 Silent installation ..................................................................................................................... 14 Unattended installation ........................................................................................................... 14 Updating to new product version ............................................................................................ 15 Changing profile on update or re-installation ............................................................................. 15 Upgrading of older installations before ProBase POS 2.0 ....................................................... 15 Installing additional features ................................................................................................... 15 Installing ProBase Retail in parallel .......................................................................................... 15 Uninstallation of ProBase POS 2 ........................................................................... 16 Interactive uninstallation ......................................................................................................... 16 Silent uninstallation ................................................................................................................. 16 Logging ................................................................................................................. 17 Installation log .......................................................................................................................... 17 Uninstallation log ..................................................................................................................... 17 Command line parameters ................................................................................... 18 Configuration ....................................................................................................... 19 Systems Group Retail Products 4 JavaPOS configuration ............................................................................................................. 19 JavaVM configuration .............................................................................................................. 19 OPOS configuration .................................................................................................................. 20 OPOS Configuration Updater ................................................................................................... 20 P4DN configuration .................................................................................................................. 21 Verifying the installed configuration .................................................................... 22 Verifying the JavaPOS installation ........................................................................................... 22 Verifying the OPOS installation ................................................................................................ 24 Verifying the POS for .NET installation .................................................................................... 26 Frequently asked questions (FAQs) ...................................................................... 27 Systems Group Retail Products 5 Introduction ProBase POS 2 provides implementations for all programming platforms defined by the international standard UnifiedPOS1. In particular, these are JavaPOS, OPOS, and POS for .NET. Additionally, an implementation for C based application called CPOS (not standardized in UnifiedPOS) is provided. The current product installer for Windows operating systems is based on Inno Setup2, which provides the concept of profiles. Here, a profile is associated with a particular programming platform providing programmatic access to peripheral devices. This concept offers the user to choose the right platform he would like to program in. Internally the product is organized in components. The product installer will ensure that all components needed for the selected programming platform 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. So, dependency errors for lacking packages have to be solved by the user when customizing a profile. Otherwise, the application may fail at runtime afterwards. 1 https://nrf.com/resources/retail-technology-standards/unifiedpos 2 http://www.jrsoftware.org/isinfo.php Systems Group Retail Products 6 Installation of ProBase POS 2 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. Prerequisites Supported Operating Systems ProBase POS supports the following Windows based operating systems: Windows XP (x86) POSReady 2009 (x86) Windows 7 Professional (x86/x64) POSReady 7 (x86/x64) Windows 8.1 Professional (x86/x64) Windows 8.1 Industry Embedded (x86/x64) Windows 10 Professional (x86/x64) Windows 10 IoT Enterprise (x86/x64) Minimum prerequisites The following software must already be installed on the target machine in order to successfully run the ProBase POS installer: Java Virtual Machine (JavaVM) (at least version 6) Note: A JavaVM is also required for the installation profiles OPOS Installation, POS for .NET Installation and CPOS Installation of the product installer. Especially for this the UDM Default Runtime, a Diebold Nixdorf distribution package of a Java Runtime Engine (JRE) based on OpenJDK 6 is proposed. The UDM Default Runtime installation package does not install a publicly available JRE and takes some other security measures (see separate documentation3). The user profile used for the application must be added to the user group wndev, so that the UDM DefaultRuntime can be executed. The installation package of the UDM Default Runtime Engine45 (currently available only as 32-bit version) is provided with the pre-installations or as a separate download. 3 UDM Security Considerations; Diebold Nixdorf; Denis Kuniss; version 1.0 4 > Intranet > Portfolio > Our Portfolio > Software Solutions > Retail Software Solutions > System Software & Operating Systems > System oriented Software > Middleware > ProBase POS 5 ProBase POS 2.1 (32-bit) requires the UDM Default Runtime Engine Version 1.1-3 or newer Systems Group Retail Products 7 Additional prerequisites In case the POS for .NET Installation or POS for .NET 1.12 Installation profile or corresponding POS for .NET components have been selected (see chapter Interactive installation), ensure that the following software has already been installed on the target machine: Microsoft .Net Framework (at least version 2.0 up to 4.0) Microsoft POS for .Net (version 1.12) In case the POS for .NET 1.14 Installation profile or corresponding POS for .NET components have been selected (see chapter Interactive installation), ensure that the following software has already been installed on the target machine: Microsoft .Net Framework (at least version 4.0) Microsoft POS for .Net (version 1.14) Additional packages might be required to support certain devices (see chapter Installing additional features). Product installer variants The ProBase POS 2