Page History

This is the step-by-step detail guide with screenshots to setup for LUSH POS. (Last update 13 Jun 2024)

Table of Contents

Step-by-step guide

We recommend to install POS in non-administrator user for security.

Step 1) Download Setup files

Download the setup files at http://cloud.bizspoketech.com:8088/index.php/s/aWBTld533Q2cr3N at Download folder. Then extract the zip file.

Image Modified

Contents inside the zip:

Image Modified

Step 2) Install Business Central

1) Go to C:\Users\

...

%USERNAME%\Downloads\LUSH_POS_Installation\LUSH_POS_Installation\POS\BC 365 Wave2. Then copy to e.g. Download folder and shorten the folder name. (Avoid filepath too long error during extraction)

Image Modified

2) Click setup.exe at the folder

Image Modified

3) Select “Advanced installation options” then select “Developer”.

...

Image Added

4) Click "Apply". The instance name is "BC230" by default.

Image Added

Info

title	Remark

You can save the installation parameters as xml file if you need to setup multiple POS.

5) Wait for finish

Image Added

Info

title	Remark

If the progress bar stuck for a while, click it to reload.

Step 3) Open BC Web UI

1) Go to “Internet Information Services (IIS) Manager”, then click “BC230” (the instance name at step2.4) > Browse *:8080 (http).

Image Added

2) BC Web UI open successfully (e.g. http://local http://localhost:8080/BC230/host:8080/BC230/)

Image Added

Step 4) Restore Database for Lush POS
Anchor
Restore DB
Restore DB

As the BC instance set up in step (3) links to the default Demo database, we are going import the Lush's POS DB.

1) Check Microsoft SQL Server Management Studio (SQL Studio) whether installed on the computer or not. If not, refer to appendix (1) for MS SQL Server Management Studio Installation

2) Open SQL Studio

Image Added

3) Login to database at localhost.

Server name: *no need to change, it takes the computer name automatically.

Remember to put a check on the checkbox to trust server certificate.
Image Added

4) Go to "C:\Users\%USERNAME%\Downloads\LUSH_POS_Installation\LUSH_POS_Installation\POS\Lush_LSBC.zip".

Image Added

5) Copy the DB file Lush_LSBC.bak to "C:\tmp" to avoid permission deny error in the following import DB procedures.

Image AddedCopy Lush_LSBC.bak

Image AddedPaste DB at C:\tmp

6) Switch to SQL Studio then restore database. Click "Database" and right-click at left-side menu.

Image Added

7) Click "Device" then the three-dots button

Image Added

8) Click "Add" then fill the filepath "C:\tmp\Lush_LSBC.bak" (same at 5 the DB pasted path).

Image AddedImage Added

9) Then click OK to restore DB.

Info

title	Remark

If you cannot access due to permission, restore the DB at "C:\", instead of under the current user.

Step 5) Switch to Lush POS DB to the BC Instance

1) At start menu, select “Business Central Administration Shell” with right click “Run as administrator”.

Image Added

2) Type command

Code Block

theme	FadeToGrey
title	Command

Get-NAVServerInstance

Image Added

3) Stop the instance (e.g. BC230 instance)

Code Block

theme	FadeToGrey
title	Command

Stop-NAVServerInstance -ServerInstance BC230

Image Added

4) Go to Microsoft SQL Server Management Studio to check the LS Central database. We use Lush_LSBC

Image Added

5) Type the command in BC Administration Shell to update BC230 instance configuration to link the Lush_LSBC database. Then restart the instance to take effect.

Code Block

theme	FadeToGrey
title	Command

Set-NAVServerConfiguration -ServerInstance BC230 -KeyName DatabaseName -KeyValue Lush_LSBC
### For two POSs till setting, the secondary till database server should point to primary till database server
## Set-NAVServerConfiguration -ServerInstance BC230 -KeyName DatabaseServer -KeyValue <IP_OF_THE_PRIMARY_TILL>
Restart-NAVServerInstance -ServerInstance BC230

Info

title	Remark

If access denied, please delete BC all user using the following SQL syntax in SQL Studio

Code Block

language	sql

DELETE FROM [dbo].[User]
DELETE FROM [dbo].[Access Control]
DELETE FROM [dbo].[User Property]

6) Go to http://localhost:8080/BC230/. The company should be "LUSH Asia Limited - Rebuild"

Image Added

Info

title	Remark

If keep failed to open the web UI, clear cookie and browsing data on the browser (or use private mode).

7) Add retail user with current Windows username.

1) Search "Retail User" in BC. Then click "New"

Image Added

2) Fill the following fields

Field	Value
ID	*current Windows Username
Name
POS Suer User
Store No.
Location Code
POS Terminal

8) Click the magnifier icon, search "Run POS"

Image Added

Info

title	Remark

If dual-display windows not shown, please allow to pop-up for browser.

Step 6) LS AppShell Setup

LS AppShell allows user to use the POS in full screen mode.

1) Go to Microsoft Store then search “LS Central AppShell” then install.

Image Added

2) Open LS AppShell. Then click three-dots button > Edit at AppShell to map Lush POS interface at Settings.

Image Added

3) Click gear icon to edit the URL

Image Added

4) Set the parameters as followings:

Host Name: localhost
Port: 8080
Environment Name: BC230 (The BC instance)
Company: Lush_DEV
Page: 99008880
Info
title Remark
You may open the Business Central on the browser. Check the URL to find the environment name and company.
Image Added
Image Added

5) Empty Login Settings for Windows user login

Image Added

6) Scroll down, and click “Run Web Client”. The LUSH POS interface appears.

Image Added

Info

title	Remark

The POS will pop up "Cannot connect to Hardware Station" and "Dual Display cannot open".
Soultion for "Cannot connect to Hardware Station"

Solution for "Dual Display cannot open"

Step 7) Install and Setup Hardware Station

Anchor

	Install LS Central
	Install LS Central

Hardware Station (HW Station) acts as a bridge between BC and peripherals (e.g. receipt printer, cash drawer, and A920 card machine).

1) Go to "C:\LSRetail\setup\", then run "Hardware Station.exe".

Image Added

Info

title	Remark

If "C:\LSRetail" not available, check appendix to install LS Central.

2) Accept the agreement

Image Added

3) Enable “Start Service” after installation, Automatic Start, and Install CCO. Then click next.

Image Added

4) Go to http://localhost:8088/ to add hardware peripherals, e.g. receipt printer, cash drawer, and card machine.

Image Added

Info

title	Remark: Practice to setup HW Station

Recommend to set unique ID for each device. (naming pattern example $deviceName-receiptPrinter)

Required drivers to allow HW Station recognizes printer and drawer.

5) Add Printer:

Select "Create Windows Printer"
Select driver (dedicate driver is needed for the model)
Create device

Image Added

Info

title	Remark

Restart LS Hardware Station at Service to scan hardware change.

Image Added

6) Same step for drawer

7) For A920 card machine, please refer to Deployment for API Server (for A920)

Step 8) Map Hardware to POS's BC

After HW Station setup, we required to set it at BC's POS Hardware Profile.

1) Go to BC, and search for "POS Hardware Profile List"

Image Added

2) Create a new hardware profile, modify the config as below:

EFT part for A920 card machine. (tbc)

Part	Field	Value	Remark
General	Profile	IT-TEST06	Same as device name
LS Hardware Station	HWST Host	localhost	no need to change
LS Hardware Station	LS Management Portal	http://localhost:8088/	no need to change
EFT	ID
EFT	Hardware Station Host
EFT	IP Address
EFT	Port Number
EFT	Terminal ID
EFT	Store ID
EFT	Remark
EFT	Terminal IP
EFT	Terminal Port
EFT	Terminal Timeout
POS Drawers	ID	IT-TEST06-DRAWER	must same with the device ID at HW Station
POS Drawers	Hardware Station Host	localhost:8082
POS Printers	ID	IT-TEST06-PRINTER	must same with the device ID at HW Station
POS Printers	Hardware Station Host	localhost:8082

* EFT represents "Electronic Fund Transfer"

Image Added

Step 9) Data Director (DD) Installation and Setup

Data Director (DD) is responsible for data sync between Head Office and POS database.

1) Run datadirectorlscentral302146setup.exe at "C:\Users\%USERNAME%\Downloads\LUSH_POS_Installation\LUSH_POS_Installation\POS".

Image Added

2) Enable all option then click next.

Image Added

3) After Install, run Configuration Tool under LS Retail in Start menu

Image AddedImage Added

4) Add POS Host

Copy the device name at Setting > System Info.

Image Added

Paste the device name at DD Configuration Tool Host field, then click "Get Config".
The Host name (at left list) become green => success

Image Added

5) Add Head Office (HO)

Anchor

	DDHO
	DDHO

Host: LUSHBC
Then click "Add"

Image Added

Successful result

Image Added

Info

title	Remark

Keep the fields blank in POS and Head Office at the DD Configuration Tool.

If cannot get config form LUSHBC, go to appendix (4) to solve

Step 10) Create another instance for Distribution Location and Data Director (DD)

Create a new instance that linked the POS's database. The instance use NavUserPassword to login, not Windows login.

1) Open Business Central Administration Shell (with admin right). Then run the command to create another instance (name: BC230_N).

Code Block

theme	FadeToGrey
title	Command

New-NAVServerInstance -ServerInstance BC230_N -ManagementServicesPort 9000 -ClientServicesPort 9001 -SOAPServicesPort 9002 -ODataServicesPort 9003 -DatabaseServer localhost -DatabaseName Lush_LSBC
Set-NAVServerConfiguration -ServerInstance BC230_N -KeyName ClientServicesCredentialType -KeyValue NavUserPassword

Info

title	Remark

If Lush_LSBC database running other from default instance, append database instance parameter with "-DatabaseInstance $DB_Instance_Name" at the end of command.

2) Create web server instance and modify config. Then start the instance to effect changes.

...

Code Block

theme	FadeToGrey
title	Command

New-NAVWebServerInstance -WebServerInstance BC230_N -Server 'localhost' -ServerInstance BC230_N -SiteDeploymentType Subsite -WebSitePort 8080 
Set-NAVWebServerInstanceConfiguration -WebServerInstance BC230_N -KeyName 'ClientServicesPort' -KeyValue 9001
Set-NAVWebServerInstanceConfiguration -WebServerInstance BC230_N -KeyName 'ManagementServicesPort' -KeyValue 9000
Set-NAVWebServerInstanceConfiguration -WebServerInstance BC230_N -KeyName ClientServicesCredentialType -keyvalue NavUserPassword  

Restart-NAVServerInstance -ServerInstance BC230_N

Info

title	Remark

If the instance or web server instance fail to run, you can check the error logs at Event Viewer.

Image Added

Step 11) Distribution Location Setup

1) Click the magnifier icon then search “Distribution Location List”

Image Added

2) Setup both Distribution location web services with the following:

	HO Head Office	Store Location (eg S106)
Distribution Server	LUSHBC	<Store PC Name>
WS Distribution Server	http://localhost/DDWebService
Replication
Company Name	LUSH ASIA TEST
User ID	dduser	<database SQL authentication username>
Password
Db Server Name	localhost	localhost
Db. Path & Name	BC_SIT	<database name>
Driver Type	SQL	SQL
Net Type	tcp	tcp
Web Server
Web Server Computer Name	LUSHBC
Web Server Port	7086
Web Server Company Name	LUSH ASIA TEST
Web Server Auth Type	Basic
Web Service User Name	webservice
Web Server Password

Image Added

3) In POS machine, Go to "Web Service Setup" , Under "Server", set:

Server Computer Name	LUSHBC
Company Name	LUSH ASIA Test(?)
Server_Name	BC_SIT_N
Server Port	7086

Image Added

Under "Client Credentials" (This username should be in BC "User")

Http Authentication	Basic
User name	webservice
Password	(web service key, not password)

Image Added

Press "Web Request 2.0", press "Publisher" and "Subscriber" button
Image Added
Image Added

Disable Void Slip in LS Central

In POS Terminal Card, select the terminal, disable void slip.

Appendix

...

Content by Label

showLabels	false
max	5
spaces	fnr867rh5fc4lexy
showSpace	false
sort	modified
reverse	true
type	page
cql	label in ("installation","lscentral","lush","pos","lsretail") and type = "page" and space = "fnr867rh5fc4lexy"
labels	lush pos installation lscentral lsretail

Page properties

hidden	true

Related issues

Appendix

Appendix 1) Install Microsoft SQL Server Management Studio (SQL Studio)
Anchor
Apdx Install SQL Studio
Apdx Install SQL Studio

1) Run "C:\Users\%USERNAME%\Downloads\LUSH_POS_Installation\LUSH_POS_Installation\MSSQL Server Management Studio\SSMS-Setup-ENU.exe"

Image Added

2) Use the default parameters, then click next.

3) Restart the computer if required.

Continue to restore database.

Appendix 2) Install LS Central
Anchor
Apdx Install LS Central
Apdx Install LS Central

1) Go to "C:\Users\%USERNAME%\Downloads\LUSH_POS_Installation\LUSH_POS_Installation\POS\LS Central 23"

2) Run "w1_ls_central_23-0-0-0.exe" to install

Image Added

3) Use the default configuration. Then click Next.

Image Added

Continue back to Install Hardware Station

Appendix 3) Solve dual display window not shown when run POS
Anchor
Apdx dual display
Apdx dual display

1) In browser, allow to pop-up windows for localhost BC (below pic is the example for Edge)

Image Added

Appendix 4) Connectivity to LUSHBC for Data Director (DD)
Anchor
Apdx LUSHBC DD
Apdx LUSHBC DD

1) Open command prompt to ping LUSHBC *case insensitive

Image Added

2) If you cannot ping LUSHBC

Edit the host file with notepad, that locates at "C:\Windows\System32\drivers\etc\hosts"

Add one line to refer LUSHBC server IP as below pic. Then save.

Image Added

3) Ping LUSHBC again to test connectivity.

Continue to setup DD Config Tool

Page tree

Versions Compared

Old Version 4

New Version Current

Key

Step-by-step guide

Step 1) Download Setup files

Step 2) Install Business Central

Step 3) Open BC Web UI

Step 4) Restore Database for Lush POS
Anchor
Restore DB
Restore DB

Step 5) Switch to Lush POS DB to the BC Instance

Step 6) LS AppShell Setup

Step 7) Install and Setup Hardware Station

7) For A920 card machine, please refer to Deployment for API Server (for A920)

Step 8) Map Hardware to POS's BC

Step 9) Data Director (DD) Installation and Setup

Step 10) Create another instance for Distribution Location and Data Director (DD)

Step 11) Distribution Location Setup

Related articles

Appendix

Appendix

Appendix 1) Install Microsoft SQL Server Management Studio (SQL Studio)
Anchor
Apdx Install SQL Studio
Apdx Install SQL Studio

Appendix 2) Install LS Central
Anchor
Apdx Install LS Central
Apdx Install LS Central

Appendix 3) Solve dual display window not shown when run POS
Anchor
Apdx dual display
Apdx dual display

Appendix 4) Connectivity to LUSHBC for Data Director (DD)
Anchor
Apdx LUSHBC DD
Apdx LUSHBC DD

Page tree

Page History

Versions Compared

Old Version 4

New Version Current

Key

Step-by-step guide

Step 1) Download Setup files

Step 2) Install Business Central

Step 3) Open BC Web UI

Step 4) Restore Database for Lush POS AnchorRestore DBRestore DB

Step 5) Switch to Lush POS DB to the BC Instance

Step 6) LS AppShell Setup

Step 7) Install and Setup Hardware Station

7) For A920 card machine, please refer to Deployment for API Server (for A920)

Step 8) Map Hardware to POS's BC

Step 9) Data Director (DD) Installation and Setup

Step 10) Create another instance for Distribution Location and Data Director (DD)

Step 11) Distribution Location Setup

Related articles

Appendix

Appendix

Appendix 1) Install Microsoft SQL Server Management Studio (SQL Studio) AnchorApdx Install SQL StudioApdx Install SQL Studio

Appendix 2) Install LS Central AnchorApdx Install LS CentralApdx Install LS Central

Appendix 3) Solve dual display window not shown when run POS AnchorApdx dual displayApdx dual display

Appendix 4) Connectivity to LUSHBC for Data Director (DD) AnchorApdx LUSHBC DDApdx LUSHBC DD

Step 4) Restore Database for Lush POS
Anchor
Restore DB
Restore DB

Appendix 1) Install Microsoft SQL Server Management Studio (SQL Studio)
Anchor
Apdx Install SQL Studio
Apdx Install SQL Studio

Appendix 2) Install LS Central
Anchor
Apdx Install LS Central
Apdx Install LS Central

Appendix 3) Solve dual display window not shown when run POS
Anchor
Apdx dual display
Apdx dual display

Appendix 4) Connectivity to LUSHBC for Data Director (DD)
Anchor
Apdx LUSHBC DD
Apdx LUSHBC DD