IBM UnifiedPOS - Version 1.13.1

System Requirements

Before installing IBM UnifiedPOS 1.13.1, you have to check if the following system requirements are fulfilled:

Microsoft Windows Embedded for Point of Service(WEPOS) 1.11
Microsoft Windows Embedded for POSReady
Microsoft Windows 7 (Professional/Ultimate)
Microsoft Windows Installer 3.1
Pentium class processor
250 MB RAM (required)
375 MB hard disk space

Uninstallation of the previous version

Before installing this version, any previous versions of IBM POS products must be uninstalled:

IBM Point of Sale Suite
IBM Point of Sale Subsystem
IBM OLE for Retail POS (Omnichannel Point-of-Sale)
IBM JavaPOS
IBM POS Device Diagnostics
When uninstallation is completed, a system restart is required.

Installation under Windows

For installation of IBM UnifiedPOS 1.13.1, a package with UPOS JRE and UPOS SDK (JDK), respectively, is available. The following installation packages are used:

upos1131ga.zip (with UPOS JRE)
upos1131sdkga.zip (with UPOS SDK)
jposl1131ga.zip (Linux with UPOS JRE)

Unpack the corresponding ZIP file and then execute setup.exe. Confirm the information shown in the subsequent windows. Under the menu UnifiedPOS Custom Install, take care to enable the JavaPOS Device Support as well as the installation of UPOS JRE/SDK (Java and JCOMM 1.6.0-SR9).

IBM UnifiedPOS 1.13.1 is installed to the directory c:\POS :

Once installation is complete, a system restart is required.

For further information on the installation process, please refer to the file Readme.txt in the installation package.

Installation under Linux

For installation, proceed as described in the installation instructions which are available in this package.

Touch Screen Configuration

The touch screen configuration is described in the Linux Operating Systems Configuration Guide ( ftp://ftp.software.ibm.com/software/retail/pubs/sw/opsys/SLE/hag2_linux_config_mst.pdf), chapter “Touch screen configuration”.

The following configuration must be made for Elo touch screens connected via USB:

An FDI file must be used to allow performing autodetection and configuration of the Single Elo USB touch screen via HAL.

Create a touchscreen.fdi file under /etc/hal/fdi/policy and enter the following information:

<?xml version="1.0" encoding="ISO-8859-1"?>
<deviceinfo version="0.2">
<device>
<match key="input.product" contains="Elo TouchSystems">
<merge key="input.x11_driver" type="string">evdev</merge>
</match>
</device>
</deviceinfo>

Configure X in order to use HAL.
Edit /etc/X11/xorg.conf and add the following line to the section ServerLayout:
```
Option "AutoAddDevices" "on"
```
Remove all input devices that include keyboard (kbd) or mouse driver from the section ServerLayout.
Restart the POS Client so that the changes resulting from steps 1 and 2 will take effect.

Sound support for Elo touch screen

In order to turn off the touch screen sounds, enter the following command:

./elotone4sle -s OFF -d USB

Note:

The elotone tool is part of the JavaPOS installation.

Configuration in GK/Retail

Support is only granted by IBM for the delivered IBM UnifiedPOS 1.13.1 if the accompanying UPOS JRE is used, too. Therefore, make sure that the POS application actually uses this JRE.

The following configuration setting must be made in the start scripts of the GK/Retail POS applications.

Configuration file defaultVars.cmd:

SET JRE="C:\POS\IBMJRE\jre"

This path can be indicated during installation with installer and is automatically entered correctly.

The path to JavaPOS is set in the configuration file hw-profile-ibm.cmd:

REM HOME DIR IMB JPOS 1.13
SET IBMJPOS_HOME=C:\POS\IBMJPOS

Device Drivers

Device drivers for IBM UnifiedPOS 1.13.1 (JavaPOS Device Support) are available in the file jposSample.xml under

C:\POS\IBMJPOS\Docs\jposSample.xml

These drivers must be included in the corresponding template configuration file.

Configuration file jpos.xml:

<JposEntry logicalName="pr_ibm_4610_TF6_com2">
 <creation factoryClass="com.ibm.jpos.services.IBMJposServiceInstanceFactory" serviceClass="com.ibm.jpos.services.SdiIBM4610EPOSPrinter"/>
 <vendor name="IBM" url="http://www.ibm.com"/>
 <jpos category="POSPrinter" version="1.9.2"/>
 <product description="IBM JavaPOS(TM) POSPrinter USB Service for IBM 4610 TI3/4/5/8/9 TM/F 6/7 Printer" name="IBM JavaPOS for Linux/Windows Version 1.9.2" url="http://www.pc.ibm.com/store/"/>
 <prop name="portName" value="COM2" type="String"/>
 <prop name="Interface" value="RS232" type="String"/>
 <prop name="dataBits" value="8" type="String"/>
 <prop name="com.ibm.posj.bus.hid.usagePage" value="0xFF45" type="String"/>
 <prop name="abstractionClass" value="com.ibm.jpos.services.SdiIBM4610EPOSPrinter" type="String"/>
 <prop name="impClass" value="com.ibm.jpos.services.sdi.IBM4610PrinterServiceImp" type="String"/>
 <prop name="parity" value="None" type="String"/>
 <prop name="flowControl" value="Xon/Xoff" type="String"/>
 <prop name="stopBits" value="1" type="String"/>
 <prop name="deviceBus" value="RS232" type="String"/>
 <prop name="com.ibm.posj.bus.hid.usageId" value="0x3500" type="String"/>
 <prop name="baudRate" value="19200" type="String"/>
 <prop name="com.ibm.posj.bus.deviceNumber" value="0" type="String"/>
 </JposEntry>

It may be necessary to adjust the interface configuration to the hardware being used.

<prop name="portName" value="COM2" type="String"/>

Finally, the assignment to the POS Client device configuration must be made. The configuration is set in the file hal.properties : For details, refer to the chapter "Configuring the Printer".

For detailed information on the device configuration, please refer to:

C:\POS\doc\UPosUsersGuide.pdf

Test tools

The following test tools can be used for correctly installed IBM UnifiedPOS 1.13.1:

POS Control Center

For starting the POS Control Center, a jpos.xml is required with entries related to the devices that are connected to the system.

For this purpose, either copy the file C:\POS\IBMJPOS\Docs\jposSample.xml to C:\POS\IBMJPOS\jpos.xml , or, preferably, copy the GK/Retail configuration file ..\parameter\client\jpos.xml to C:\POS\IBMJPOS\jpos.xml.

The test tool can be called via Windows Start menu or by entering C:\Windows\system32\javaw.exe com.ibm.jpos.tools.sdicc.ControlCenterApp on the Windows command line.

The connected and correctly configured devices should then be marked as Online and Configured. After selecting the corresponding device, different tests can be performed.

POSTest – The JavaPOS Device Test v1.10.0

POSTest is a universal tool for testing JavaPOS devices.

In order to use the tool, it is recommended to copy the complete folder POSTest to drive C:\ of the system being used for device testing. In addition, copy again the file C:\POS\IBMJPOS\Docs\jposSample.xml or the GK/Retail configuration file ..\parameter\client\jpos.xml to C:\POSTest\jpos.xml.

The tool is started via IBM_POSTest.bat if it is used exclusively for testing IBM devices.

Refer to Configured Devices for an overview of all devices included in the file jpos.xml. Go to the desired device category and enter the corresponding LogicalName. Then select Open and Claim in order to perform different tests.

JavaPOStester - Test