Setup

Installation

Prerequisites

Before installing LS Central, make sure that you meet the following prerequisites:

  • You have administrative privileges on the machines where you plan to install the application.
  • You have the necessary permissions and licenses to install Business Central application objects and to create users.
  • You have a working knowledge of Business Central and Microsoft SQL Server, including how to create a new database, restore a SQL database backup, and install Business Central application objects (.fob files).
  • Microsoft Dynamics 365 Business Central is installed.
  • Microsoft SQL Server is installed.

LS Central is distributed in a single executable file, W1_LS_Central_xx.x.exe. Before you start the actual installation, you should run this application. This will uncompress the installation files and store them in an installation directory on your hard drive. The default path for these files is C:\LS Retail\LSxx.x.

Microsoft Dynamics 365 Business Central Application Objects Added or Modified by LS Central

LS Central consists of more than 4000 Microsoft Dynamics 365 Business Central application objects. This figure includes more than 150 standard application objects that are modified by LS Central. You can see which objects are modified and installed by LS Central by doing the following:

  1. Start the Dynamics Business Central Development Environment, and connect to a LS Central database.
  2. Open the Object Designer and put a filter containing *LS* on the Version List column. This will give you a list of all application objects created or modified by LS Central. If you wish to view modified standard objects only, you can add a filter on the ID column where ID < 50000.

As mentioned above, LS Central consists of modified standard application objects as well as objects that are only used by LS Central. Objects that are exclusive to LS Central can be found in the following object numbering ranges:

Range From ID To ID
Range 1 10000700 10000999
Range 2 10001200 10001499
Range 3 10011950 10012949
Range 4 10014500 10016999
Range 5 10032985 10034984
Range 6 10036985 10038984
Range 7 52099144 52100143
Range 8 70014000 70014199
Range 9 99001450 99001899
Range 10 99008700 99009699

Note: Not all objects within the ranges are used.

Installing LS Central in a New Database

Follow these steps to install LS Central in a new database:

  1. Start the Microsoft SQL Server 2014 Management Studio (or newer), and connect to the server.
  2. Restore the w1-ls-central-xx-x-release.bak backup file in a new database. You can find the backup in the installation directory.
  3. Open the Business Central Administration client, and define a service which connects to the database created.
  4. Install the required toolboxes. See the Toolbox Installation Guide for more information.
  5. Open the Dynamics Business Central Development Environment, and compile all objects in the database.
  6. Open the Windows client or the Business Central web client, and add the current user, followed by any additional users.
  7. Restart the service.
  8. The installation is done. You can now start to use LS Central.

Tip: The .bak file is compatible with Microsoft SQL Server 2014.

The Service Components need to be installed on the machine where the service tier is located.
The Client Components need to be installed on each machine that will run the POS.

Installing LS Central in an Existing Database

You might also want to install LS Central into an existing Business Central database. Please note that LS Central is based on the Business Central world-wide edition, and installing LS Central in a database that has been localized for other countries may not work as expected.

Important: When installing into an existing database only the application objects are installed – no demo data is installed as part of this routine. You are advised to install into a new database as described in the previous section if you plan to follow the training material or use the database for demonstrations.

Follow these steps to install LS Central into an existing Business Central database:

  1. Open the Business Central Administration client, and define a service which connects to the database where you plan to install LS Central.
  2. Open the database in the Dynamics Business Central Development Environment.
  3. Import the w1-ls-central-xx-x-all-ls-marked-objects.fob (LS Central (xx.x) release), which is located in the Application directory. This will install all Business Central objects required to run LS Central.
  4. Install the required toolboxes. See the Toolbox Installation Guide for more information.
  5. Compile all objects in the database.
  6. Open the Windows client or the Business Central web client, and add the current user, followed by any additional users.
  7. Build the Server Application Objects in the Dynamics Business Central Development Environment.
  8. Restart the service.
  9. The installation is done. You can now start to use LS Central.

Note: The Service Components need to be installed on the machine where the service tier is located.
The Client Components need to be installed on each machine that will run the POS.

Uninstall

Uninstall the LS Central xx.x Client Components

Follow these steps to uninstall the LS Central xx.x Client Components:

  1. Open the Windows Control Panel, and start the Programs and Features application.
  2. Browse to the Client Components entry, and select the Uninstall button.
  3. The Client Components will now be removed from the machine.

Uninstall the LS Central xx.x Service Components

Follow these steps to uninstall the LS Central xx.x Service Components:

  1. Open the Windows Control Panel, and start the Programs and Features application.
  2. Browse to the Service Components entry, and select the Uninstall button.
  3. The Service Components will now be removed from the machine.