Echelon LNS - Manual (Page 321)

LNS Programmer's Guide 307
not need to use setup.exe, and should use the simpler _SetupLNS.dll, as described in
the following sections.
The setup.exe application introduces a noticeable delay after the LNS runtime
installation progress dialogs are complete, potentially causing it to appear as if your
installation is complete before it actually finishes. For this reason, Echelon recommends
using _SetupLNS.dll in the Windows Installer environments where it is supported.
Even though Echelon recommends that you use _SetupLNS.dll to install the LNS
runtime, this document will explain the use of the setup.exe option first. Because this
option automates less of the installation process, using it requires a more comprehensive
description of the LNS runtime installation options, and is valuable for all LNS runtime
redistributors.
Using setup.exe
Since setup.exe should be used by all environments except Windows Installer based
installations, this document cannot assume any particular capabilities exist in the
runtime installation other than Windows Registry access. All inputs to the LNS runtime
installation and outputs from the LNS runtime installation are described in terms of
Windows Registry entries. For proper function, the setup.exe file should be kept in the
same directory on your source medium as the rest of the LNS runtime installation
redistributable files.
To embed the LNS Runtime installation into your LNS-based product installation, follow
these steps. Each step is described in detail in the following sections:
1. Preset the L ON W ORKS path
2. Preset the LNS network database path
3. Check the installed LNS version
4. Check the LNS runtime installation completion status
5. Install the version 3 Microsoft XML Parser
Step 1: Preset the LONWORKS Path
The “LonWorks Path” entry in the Windows Registry must be defined before you launch
the LNS Runtime installation, if you want to install to a L ON W ORKS path different than
the default. Although Echelon does not recommend changing this path, it may be
necessary in your particular product installation scenario.
The location from which the LNS runtime reads the L ON W ORKS path information is
stored in the following Windows Registry string value:
HKEY_LOCAL_MACHINE\SOFTWARE\LonWorks\LonWorks Path
This string value determines the location of the main “LonWorks” installation folder. The
LNS runtime files will be installed in subfolders of this folder. If this Windows Registry
entry does not exist, the default path will be [WindowsVolume]\LonWorks, where
[WindowsVolume] is the drive where the Windows operating system resides.