Change EEPOS Machine Role

Overview

The role of a EEPOS installation can be changed using the command line.

This means that a store can be reconfigured without needing to reinstall EEPOS.

The command line tool is accessed as follows:

• Ensure EEPOS is closed on the till.

• Open Command Prompt as an administrator.

• Enter the below command to browse to the EEPOS folder.

cd "c:\Program Files (x86)\Magenta Retail\EEPOS"

• Run EEE_POS.exe /c storeservername storeserverdatabase replicationsourceiseee
  • Storeservername is the full SQL instance name of the store server including \MAGENTAPOS if necessary.
  • StoreServerdatabase is the store servers database name
  • Replicationsourceiseee is a flag indicating if this machine will replicate from EEE or from the store server (e.g. Y or N)
  • All parameters must be supplied
• After a few moments it should display the below message indicating the change is

complete.

• Once the Process complete text is shown, press Enter to return to the command prompt.
• Open EEPOS and ensure the till is displaying the green POS Service light.
• If the POS Service is displaying the orange light, this may indicate the wrong computer name was used in the above command. The command can be run again with the correct computer name.

Available Versions

The table below details which versions contain which functionality

Versions

Function	EEE Version	POS Version(s)
Reconfigure POS Role	1.92.05	2.20.16.00
Reconfigure POS Role	1.88.26	2.18.12.00

Configuration Required

None

Detail

Here are some scenarios where this can be used. There are 3 machines at the store in the following scenarios.

- MAG1 – Store Server

- MAG2 – Till 2

- MAG3 – Till 3

Scenario 1 – Promoting a till to a store server

MAG1 is the existing store server but it has had a hardware failure. Whilst MAG1 is being replaced, MAG2 is going to be the store server.

Promoting a till to a store server

On MAG2

• Close EEPOS
• Open an Administrator command prompt.
• Change to the EEPOS installation folder (e.g. C:\Program Files (x86)\Magenta Retail\EEPOS)
• Run the command

EEE_POS.exe /c MAG2\magentapos EEPOS Y

• Start EEPOS and ensure the POS Service indicator light is green

Updating tills to communicate with the replacement store server

On MAG3

• Close EEPOS
• Open an Administrator command prompt.
• Change to the EEPOS installation folder (e.g. C:\Program Files (x86)\Magenta Retail\EEPOS)
• Run the command

EEE_POS.exe /c MAG2\magentapos EEPOS N

• Start EEPOS and ensure the POS Service indicator light is green

Scenario 2 – Store Server replacement

The store server (MAG1) hardware has been replaced and it has had EEPOS re-installed to the correct version (note: the same version as the other tills in the store) and replication from EEE has completed successfully.

Install new store server

On MAG1

• Ensure the hostname on the tills record has been updated to the new machine name (if a new machine name has been assigned)
• Install EEPOS to replicate from EEE
• Upgrade EEPOS to the same version that is installed on the existing store tills
• Replication from EEE must complete prior to completing further steps

Demoting the existing store server to a till

On MAG2

• Close EEPOS
• Open an Administrator command prompt.
• Change to the EEPOS installation folder (e.g. C:\Program Files (x86)\Magenta Retail\EEPOS)
• Run the command

EEE_POS.exe /c MAG1\magentapos EEPOS N

• Start EEPOS and ensure the POS Service indicator light is green

Updating tills to communicate with the new store server

On MAG3

• Close EEPOS
• Open an Administrator command prompt.
• Change to the EEPOS installation folder (e.g. C:\Program Files (x86)\Magenta Retail\EEPOS)
• Run the command

EEE_POS.exe /c MAG1\magentapos EEPOS N

• Start EEPOS and ensure the POS Service indicator light is green

Scenario 3 – All tills replicate from EEE

MAG1 will still be classified as the store server as it will hold stocktake data, suspended transactions, and local journal data however MAG1, MAG2 and MAG3 will replicate master data and transactions directly to and from EEE.

Update tills to replicate directly with EEE

MAG1 as the existing store server does not need to be reconfigured.

On MAG2 and MAG3

• Close EEPOS
• Open an Administrator command prompt.
• Change to the EEPOS installation folder (e.g. C:\Program Files (x86)\Magenta Retail\EEPOS)
• Run the command

EEE_POS.exe /c MAG1\magentapos EEPOS Y

• Start EEPOS and ensure the POS Service indicator light is green

Scenario 4 – All tills replicate from a store server

MAG1 will still be classified as the store server and MAG2 and MAG3 will replicate master data and transactions from MAG1

Update tills to replicate from the store server

MAG1 as the existing store server does not need to be reconfigured.

On MAG2 and MAG3

• Close EEPOS
• Open an Administrator command prompt.
• Change to the EEPOS installation folder (e.g. C:\Program Files (x86)\Magenta Retail\EEPOS)
• Run the command

EEE_POS.exe /c MAG1\magentapos EEPOS N

• Start EEPOS and ensure the POS Service indicator light is green