POS Installation Guide with Screencaps

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

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.

Contents inside the zip:

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)

2) Click setup.exe at the folder

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

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

5) Wait for finish

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).

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

Step 4) Restore Database for Lush POS

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

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.
• 

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

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

Copy Lush_LSBC.bak

Paste DB at C:\tmp

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

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

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

9) Then click OK to restore DB.

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”.

2) Type command

Get-NAVServerInstance 

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

Stop-NAVServerInstance -ServerInstance BC230

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

5) Type the command in BC Administration Shell to update BC230 instance configuration. Then effects the change with restart instance.

Set-NAVServerConfiguration -ServerInstance BC230 -KeyName DatabaseName -KeyValue Lush_LSBC
Restart-NAVServerInstance -ServerInstance BC230

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

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

8) If no pop-up window for dual display, allow the Pop-ups for localhost:8080.

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.

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

3) Click gear icon to edit the URL

4) Set the parameters as followings:

• Host Name: localhost
• Port: 8080
• Environment Name: BC230 (The BC instance)
• Company: Lush_DEV

• Page: 99008880

  Remark

  You may open the Business Central on the browser. Check the URL to find the environment name and company.

  

  

5) Empty Login Settings for Windows user login

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

Step 7) Install and Setup Hardware Station

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".

2)  Accept the agreement

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

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

5) Add Printer:

1. Select "Create Windows Printer"
2. Select driver (dedicate driver is needed for the model)
3. Create device

6) Same step for drawer

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"

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

EFT part for A920 card machine.

* EFT represents "Electronic Fund Transfer"

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". 

2) Enable all option then click next.

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

4) Add POS Host

• Copy the device name at Setting > System Info.

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

5) Add Head Office (HO) 

• Host: LUSHBC
• Then click "Add"

• Successful result

Step 9) Create 

Step #) Step Title

Related articles

Deployment procedure for LushBC

• Page:
  POS Installation Guide with Screencaps
• Page:
  How to update all Lush specific app at once
• Page:
  Givex Setup
• Page:
  Givex troubleshooting

Appendix

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

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

2) Use the default parameters, then click next.

3) Restart the computer if required.

Continue to restore database.

Appendix 2) 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

3) Use the default configuration. Then click Next.

Continue back to Install Hardware Station

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

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

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

1) Open command prompt to ping LUSHBC          *case insensitive

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.

3) Ping LUSHBC again to test connectivity.

Continue to setup DD Config Tool

Appendix #) Append. Title

Appendix #) Append. Title