Setup
Installation
Prerequisites
Before installing LS Nav, 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 Microsoft Dynamics NAV application objects and to create users.
- You have a working knowledge of Microsoft Dynamics NAV and Microsoft SQL Server, including how to create a new database, restore a SQL database backup, and install Microsoft Dynamics NAV application objects (.fob files).
- Microsoft Dynamics NAV 2018 is installed.
- Microsoft SQL Server is installed.
LS Nav is distributed in a single executable file, W1_LS_Nav_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 NAV Application Objects Added or Modified by LS Nav
LS Nav consists of more than 3500 Microsoft Dynamics NAV application objects. This figure includes more than 150 Microsoft Dynamics NAV standard application objects that are modified by LS Nav. You can see which objects are modified and installed by LS Nav by doing the following:
- Start the Microsoft Dynamics NAV Development Environment, and connect to a LS Nav database.
- 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 Nav. If you wish to view modified Microsoft Dynamics NAV standard objects only, you can add a filter on the ID column where ID < 50000.
As mentioned above, LS Nav consists of modified Microsoft Dynamics NAV standard application objects as well as objects that are only used by LS Nav. Objects that are exclusive to LS Nav 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 Nav in a New Database
Follow these steps to install LS Nav in a new database:
- Start the Microsoft SQL Server 2014 Management Studio, and connect to the server.
- Restore the w1-ls-nav-xx-x-release.bak backup file in a new database. You can find the backup in the installation directory.
- Open the Microsoft Dynamics Administration client, and define a service which connects to the database created.
- Install the required toolboxes. See the Toolbox Installation Guide for more information.
- Open the Microsoft Dynamics Development Environment, and compile all objects in the database.
- Build the Server Application Objects.
- Open the Microsoft Dynamics NAV Windows Client, and add the current user, followed by any additional users.
- Restart the service.
- The installation is done. You can now start to use LS Nav.
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 Nav in an Existing Database
You might also want to install LS Nav into an existing Microsoft Dynamics NAV database. Please note that LS Nav is based on the Microsoft Dynamics NAV 2018 world-wide edition, and installing LS Nav in a Microsoft Dynamics NAV 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 Nav into an existing Microsoft Dynamics NAV database:
- Open the Microsoft Dynamics Administration client, and define a service which connects to the database where you plan to install LS Nav.
- Open the database in the Microsoft Dynamics NAV Development Environment.
- Import the w1-ls-nav-xx-x-all-ls-marked-objects.fob (LS Nav (xx.x) release), which is located in the Objects directory. This will install all Microsoft Dynamics NAV objects required to run LS Nav.
- Install the required toolboxes. See the Toolbox Installation Guide for more information.
- Compile all objects in the database.
- Open the Microsoft Dynamics NAV Windows Client, and add the current user, followed by any additional users.
- Build the Server Application Objects in the Microsoft Dynamics NAV 2017 Development Environment.
- Restart the service.
- The installation is done. You can now start to use LS Nav.
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 Nav xx.x Client Components
Follow these steps to uninstall the LS Nav xx.x Client Components:
- Open the Windows Control Panel, and start the Programs and Features application.
- Browse to the Client Components entry, and select the Uninstall button.
- The Client Components will now be removed from the machine.
Uninstall the LS Nav xx.x Service Components
Follow these steps to uninstall the LS Nav xx.x Service Components:
- Open the Windows Control Panel, and start the Programs and Features application.
- Browse to the Service Components entry, and select the Uninstall button.
- The Service Components will now be removed from the machine.
Uninstall LS Nav from a Microsoft Dynamics NAV Database
To uninstall LS Nav, run Power Shell ISE as administrator, and open the UninstallLS_NAV.ps1 and set the parameters as follows:
$StdDBServer | SQL Server\Instance containing the Standard NAV Database. |
$StdNAVdb | Standard NAV Database name |
$LSDatabaseServer | SQL Server\Instance containing LS Retail database |
$LSDbName | LS Retail NAV Database name |
$LSNavServerName | Server running the Service Tier for LS Retail Database |
$LSServiceInstance | NAV Service Instance running on LS Retail Database |
$LSMgmtPort | NAV Service Instance Management Port No (7045 is default) |
$WorkPath | Path in the file system for the script to keep object files |
$RTCPath | Path to the Role Tailored Client executable |
$ServiceTierPath | Path to the Service Tier executable |
Then run the script.
Note: The uninstall script does not remove external LS Nav components, such as the Toolbox, Data Director, KDS, and Dual Display.