Echelon LNS User Manual
Page 325
LNS Programmer's Guide
311
Property Description
DLL
Filename
Install
Execute
Sequence
The _SetupLNS.dll component provides the following features:
1. The
_SetupLNS.dll custom actions take care of all LNS version checking that is
required to install an LNS runtime of a particular version. The version that it
attempts to install is based on the _SetupLNS.dll file version, so this DLL
should be re-imported into your installation when you generate a new version of
the LNS runtime installation with the LNS Redistribution Kit. For example, if
the LNS Redistribution Kit is patched within a future LNS service pack in order
to generate new LNS runtime installations, this DLL should also be re-imported.
2. The user may define a Windows Installer property named LnsDbPath to pass in
the LNS network database path described in the Using setup.exe section, instead
of writing to the Windows Registry.
3. The DLL will define a Windows Installer property named
LNSREQUIRESREBOOT and set it to the string value “1” if the LNS runtime
installation requires a reboot for completion. Note that your LNS-based product
installation should either force a reboot or inform the user that a reboot is
necessary. The LNS runtime installation case that requires a reboot will return a
success code to the Custom Action that calls it, filtering out the
ERROR_SUCCESS_REBOOT_REQUIRED error return from MsiExec.exe.
Table 14.2 shows an example of using this notification from your product
installation with an InstallShield DevStudio 9 sequence table entry. The
ScheduleReboot standard action may be found by going to the “Sequences” item
under the “Behavior and Logic” item, then expanding the actions found in the
Installation Execute sequence. When this standard action is run, directly after
completion of a successful installation, it informs the user that a reboot is
required, and gives the choice of rebooting now or later.
Table 14.2 Using LNSREQUIRESREBOOT Example
ScheduleReboot Standard Action (Installation Execute Sequence)
DLL
Filename
Sequence
Number
6410
Condition
ISSCHEDULEREBOOT or LNSREQUIRESREBOOT
Comments
ScheduleReboot