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.
Remark
You can save the installation parameters as xml file if you need to setup multiple POS.
5) Wait for finish
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).
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.
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”.
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"
Remark
If keep failed to open the web UI, clear cookie and browsing data on the browser (or use private mode).
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.
Remark
The POS will pop up "Cannot connect to Hardware Station" and "Dual Display cannot open".
Soultion for "Cannot connect to Hardware Station"
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".
Remark
If "C:\LSRetail" not available, check appendix to install LS Central.
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.
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
Remark
Restart LS Hardware Station at Service to scan hardware change.
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. (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"
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
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 9) 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).
New-NAVServerInstance -ServerInstance BC230_N -ManagementServicesPort 9000 -ClientServicesPort 9001 -SOAPServicesPort 9002 -ODataServicesPort 9003 -DatabaseServer localhost -DatabaseName Lush_LSBC
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.
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 Start-NAVServerInstance -ServerInstance BC230_N
Step #) Step Title
Related articles
Deployment procedure for LushBC
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