EEPOS:Installation - Standard Installation

The following article will provide basic instructions for a standard installation of EEPOS. For more detailed instruction documentation, please contact Magenta Support).

Hardware/Software Specifications

Please refer to EEPOS Hardware and Software Specifications page

Preparing EEE

NOTE: With the exception of the till specific settings, the following instructions will need to be run once, on the initial setup of EEPOS with EEE.

Configure the Distributed Transaction Co-ordinator (MSDTC)

1. On the EEE database server, set the Distributed Transaction Coordinator service to set the Start-up type to Automatic
2. Control Panel > Administrative Tools > Component Services > Computers > My Computer > Distributed Transaction Coordinator > Right Click “Local DTC” and click properties. Click the security tab.
3. Enable the following options:
   1. Network DTC Access > Allow Remote Clients
   2. Transaction Manager Communication > Allow Inbound, Allow Outbound, No Authentication Required
4. Click OK.
5. Restart the MSDTC Service (if not already prompted to).

Configure Windows Firewall

The following exceptions will need to be created/enabled within your Firewall:

• The Distributed Transaction Coordinator (on the EEE Server and on the till)
  • MSDTC.exe
  • TCP Port 135
  • UDP Port 137.
• Query Server Port (if not already configured)

If not created by the installer, the following exceptions will need to be created/enabled:

• The POS Service application (POSService.exe) (Till only)
• SQL Server
  • The installed SQL Server instance application (i.e. C:\ProgramFiles\MicrosoftSqlServer\MSSQL11.MAGENTAPOS\Binn\SqlServr.exe)
  • TCP Ports:
    • 1433, 1103, 135
  • UDP Port:
    • 1434

NOTE: Please ensure the firewall exceptions are enabled on the correct profile (Domain/Private or Public).

EEE Configurations

1. Open Tools Configurator. Select the correct profile, and enable “This EEE Instance has Enabler Enterprise POS stores. Click Save, and close the configurator.
2. Restart EEE Dataloader.
3. Log into EEE. Navigate to Utilities > Configuration > Company Preferences.
4. Enable the “Has Enabler Enterprise POS stores”. Click Save.
5. If tills are already setup, and will be reused, ensure they have been configured as a EEPOS till. (Location Management > POS Till Maintenance > select till and click Edit > “Is Enabler Enterprise POS till?”). Otherwise, set up your tills with this option enabled.

Installation Wizard

Step 1 - Select Installation Type

Start the EEPOS Installation Wizard. Select the installation Type: (This article describes the “Install & Configure” option)

• Install only, without configuration
• Install & Configure
• Master Image install for store server
• Master Image install for till

Step 2 - Enter Branch and Till Code

Enter the Branch and Till Codes. These must be registered in the EEE database before starting the installation.

Step 3 - User group

If your computer is not on a domain, use the default setting. If the installer fails to create the local user group, you will need to create the group manually. NOTE: If the installer detects that the machine is on a domain, it will provide an option to have the POS user group placed on the domain. If you select this option, you need to ensure that the EEPOSUsers group is created before progressing with the installation.

Step 4 - Where will the POS Database be stored?

If the SQL Database Engine has not already been installed, ‘tick’ the Install SQL Server option. Ensure the collation of the SQL Server is the same as your EEE SQL Server collation. Leave all other options at their default values.

Step 5 - Enter the POS Database Name

Use the default setting. The database name is typically ‘EEPOS’, and does not need to be changed in a normal installation.

Step 6 - Select Replication Source

The Replication Source screen allows the Replication source to be either EEE (if you are installing EEPOS as a Store Server) or Store Server (if you are installing EEPOS as a till).

Replication Source: EEE

Specify the "Replication Source SQL Server Instance Name" to your EEE Database Server Instance Name (or just the server name if the EEE database is installed on the default instance of SQL Server).

Specify the "Replication Source Database Name" as your EEE Database name.

Ensure "This machine is a store server?" is checked, and accept the defaults for the Store Server Machine Name (name of current machine - autopopulated) and Store Server .Net Remoting Port (8080).

Replication Source: Store Server

Specify the "Replication Source SQL Server Instance Name" to your Store Servers instance name (default is MACHINENAME\MAGENTAPOS)

Specify the "Replication Source Database Name" as your Store Servers EEPOS Database name (default is EEPOS).

The Store Server Machine Name will be auto-populated with the machine name obtained from the "Replication Source SQL Server Instance Name" field.

Accept the default for the Store Server .Net Remoting Port (8080).

Step 7 - Install screen

Confirm the settings and press the Install button.

Step 8 - Installation Complete

Check the installation Log and then press Next once installation has completed.

Step 9 - Test Distributed Transaction Coordinator

Press the Test button to ensure that a connection can be made to the database.

Step 10 - Update Software Version

This is an optional step. To proceed without updating, click Next.

Once the installation is complete, you will be able to update to the latest version available. Press the Check Version button.

If no updates are available, you will be notified that the latest version is already installed. No earlier versions will be available.

To proceed with the upgrade, press the Start Upgrade button. The updating process may take some time. You will be notified of the progress during the update.

Step 11 - Master Table Replication

At the completion of the process, continue the Wizard and complete Master Table Replication if/when requested.

Step 12 – MANUAL STEP - Migrate Enabler Seed Values for use in EEPOS

MUST BE RUN IF BRANCH/TILL IS BEING REUSED FROM ENABLER

If the branch/till used during the installation already existed, and is being reused from an Enabler till, the following procedure needs to be run in the EEE database to migrate Enabler Seed Values for use in EEPOS. This must only be run AFTER all tills in the Enabler environment have finished trading on their last day of trade.

NOTE: Replace the @prmCustPrefix value with the configured customer prefix (if required), otherwise use null as the value

exec usp_MigrateEnablerSeedValues @till = '<tillcode>', @branch ='<branchcode>', @prmCustPrefix = null

Once the procedure has been run, when EEPOS starts up it will retrieve the newly populated seed values from EEE.

Step 13 - Run EEPOS

At the completion of the installation, the installer will ask if you wish to run the application. Click yes.

Once EEPOS has opened, you will be prompted to license the application.

After you had completed licensing, you can login to EEPOS using your EEE credentials.