USER GUIDE ProBase POS 2 JavaPOS™, OPOS, POS for .NET and CPOS August 2019 Imprint Mathias Janke Diebold Nixdorf Product Line Retail Wohlrabedamm 31 13629 Berlin [email protected] Systems Group Retail Products 2 Revision history Version Date Author Comment/Change 1.0 November 2016 Mathias Janke Initial Version 2.0 November 2016 Mathias Janke Changes for PBP 2.1 2.1 November 2016 Mathias Janke Typos; WNLPOS 4 Support 3.0 March 2017 Mathias Janke Changes for PBP 2.2 Additional chapters/enhancements – Configuration, 3.1 April 2017 Mathias Janke Logging, Tools, Samples 3.2 May 2017 Mathias Janke Typos; path values corrected in chapter 7.1.1 Additional information about UDM Client Logging, 3.3 June 2017 Mathias Janke UDM Server start and CPOS examples 4.0 July 2017 Mathias Janke Changes for PBP 2.3 4.1 August 2017 Mathias Janke Corrections 5.0 September 2017 Mathias Janke Changes for PBP 2.4 6.0 May 2018 Mathias Janke Changes for PBP 2.6 Additions to chapter 11.2.3 with PC108 – Property 6.1 June 2018 Mathias Janke “labelIDMicroPDF417” changed to “0x380B” for USB scanner 7.0 January 2019 Mathias Janke Changes for PBP 2.8 8.0 May 2019 Mathias Janke Changes for PBP 2.9 8.1 August 2019 Mathias Janke Limitation of supported JavaVM versions Systems Group Retail Products 3 Copyright and Trademarks Microsoft and Windows are registered trademarks of Microsoft Corporation. Diebold Nixdorf and BEETLE are registered trademarks of Diebold Nixdorf, Inc. Linux is a registered trademark of Linus Torvalds. Red Hat and CentOS are registered trademarks of Red Hat, Inc. JavaPOS is a trademark of Sun Microsystems, Inc. Oracle and Java are registered trademarks of Oracle and/or its affiliates. iButton is a registered trademark of Maxim Integrated All other company names and trademarks mentioned in this documentation are the property of their respective owners. © Copyright 2019 by Diebold Nixdorf Systems GmbH Systems Group Retail Products 4 Contents 1 Introduction ............................................................................................................... 8 2 General information .................................................................................................. 9 2.1 Background ..................................................................................................................... 9 2.2 Environment at Diebold Nixdorf ..................................................................................... 10 2.3 Provision ........................................................................................................................ 10 2.4 Maintenance and service ............................................................................................... 10 2.5 License agreement / rights of use .................................................................................. 11 3 Current service and features .................................................................................. 12 3.1 Unified Device Manager ................................................................................................ 12 3.2 JavaPOS guide line ....................................................................................................... 14 3.3 Version numbering concept ........................................................................................... 14 3.4 Product installer ............................................................................................................. 15 4 Installation of ProBase POS 2 ................................................................................ 19 4.1 Prerequisites ................................................................................................................. 19 4.2 Installation under Windows ............................................................................................ 19 4.3 Installation under Linux .................................................................................................. 24 5 Uninstallation of ProBase POS 2 ........................................................................... 26 5.1 Uninstallation under Windows ........................................................................................ 26 5.2 Uninstallation under Linux ............................................................................................. 26 6 Configuration ........................................................................................................... 28 6.1 JavaPOS configuration .................................................................................................. 28 6.2 JavaVM configuration .................................................................................................... 31 6.3 OPOS configuration ....................................................................................................... 32 6.4 P4DN configuration ....................................................................................................... 33 6.5 CPOS configuration ....................................................................................................... 34 6.6 UDM configuration ......................................................................................................... 34 7 Logging .................................................................................................................... 40 7.1 Logging during installation ............................................................................................. 40 Systems Group Retail Products 5 7.2 Logging during uninstallation ......................................................................................... 41 7.3 JavaPOS logging ........................................................................................................... 41 7.4 OPOS logging................................................................................................................ 45 7.5 P4DN logging ................................................................................................................ 46 7.6 CPOS logging ................................................................................................................ 46 7.7 UDM logging .................................................................................................................. 47 7.8 JavaPOS Configurator logging ...................................................................................... 49 8 Programming examples.......................................................................................... 50 8.1 JPOS ............................................................................................................................. 50 8.2 OPOS ............................................................................................................................ 50 8.3 CPOS ............................................................................................................................ 50 8.4 P4DN ............................................................................................................................. 50 9 Tools ........................................................................................................................ 51 9.1 ProBase/JavaPOS Tool Center ..................................................................................... 51 9.2 OPOS UDM Configuration Updater ............................................................................... 52 9.3 Test tools ....................................................................................................................... 53 10 Specifications .......................................................................................................... 59 10.1 Current installer variants ................................................................................................ 59 10.2 Supported peripherals ................................................................................................... 59 10.3 Supported operating systems ........................................................................................ 62 10.4 Software requirements ................................................................................................... 63 10.5 Components included .................................................................................................... 64 10.6 Currently available add-ons ........................................................................................... 65 10.7 Restrictions in 2.9 .......................................................................................................... 66 11 Appendix .................................................................................................................. 67 11.1 End-user license agreement .......................................................................................... 67 11.2 Changes to version 2.9 .................................................................................................. 70 11.3 Changes to version 2.8 .................................................................................................. 77 11.4 Changes to version 2.6 .................................................................................................. 85 11.5 Changes to version 2.4 .................................................................................................. 94 11.6 Changes to version 2.3 .................................................................................................