i Important

This topic covers installing Retail Modern POS ready for use with MAX Mobile.

Overview

Retail Realm supply a customized MPOS package that includes the standard MPOS functionality along with the MAX Essentials customization extensions ready to start printing labels out of the box. Please check with your systems administrator before applying any Retail Realm MPOS packages to ensure compatibility.

Prerequisites

It is vital that any previous version of Retail Modern POS is un-installed and completely removed from the device, prior to commencing

Please check that there are no files existing in the following folder

C:\Program Files (x86)\Microsoft Dynamics 365\70\Retail Modern POS

Installation Procedure


    1. Flag the target POS device for Activation
    2. Navigate to: Retail and commerce > Channel setup > POS setup > Devices
    3. Edit the target device
    4. Set Activation status to Pending



    1. Click Download and choose RR.ModernPOSSetup. This will download the Retail Realm version of the MPOS setup.
    2. Once downloaded, right click on RR.ModernPOSSetup.exe and select Run as Administrator
    3. Accept any defaults and continue and complete the installation.

DLLHost.exe.config file configuration

Make the following changes to this configuration file

    1. Navigate to


C:\Program Files (x86)\Microsoft Dynamics 365\70\Retail Modern POS\ClientBroker

    1. Open the file DLLHost.exe.config in Notepad
    2. Update the AADClientId and AADRetailServerResourceId as shown below:



    1. Refer to this Microsoft article for further guidance:


https://community.dynamics.com/ax/b/axforretail/archive/2017/11/06/mpos-aad-changes-in-monthly-update-4


    1. Add the reference in the same file (after the legacy payment devices comment section) as shown in below screen-shot (copy the reference marked with blue and paste to the section marked with red)


NOTE: You can keep the <add source="assembly" value="Microsoft.Dynamics.Commerce. HardwareStation.Peripherals.Legacy.PaymentDeviceAdapter" /> in comment section.        

Updated DLLHost.exe.Config

    1. Save the changes and close the file.

Activating the POS

Follow these steps to activate Retail Modern POS

    1. Open Retail Modern POS
    2. Modern POS will prompt you to perform the standard Device Activation.
    3. Follow the on-screen prompts
    4. Use the Store and Register that was previously flagged as Pending.
    5. You will require the Activation URL – please consult with your systems administrator

Logging into Retail Modern POS for the first time


    1. Start Retail Modern POS
    2. Enter the Cashier UserID and Password
    3. Click Hardware Station

    1. Click Manage


    1. Turn it ON as shown:



    1. Click OK

Next topic