What: LS_HSI.

msi Partner Installation Requirements

Last Modified: 4/25/2007 10:57:00 AM

+++++++++++++++++++++++++++++++++++++++++++++++++++++

Forward:
This document applies to LightScribe 1.6 and newer. We have seen some examples recently of updates provide to
end users that did not provide a silent install experience. The LightScribe software installer is designed as a silent
installer. Please assure that all installs, both original installs and updates provided to end users, use the command
line switches described below to affect a silent install. In order to have a “silent” install of LightScribe
(LS_HSI.msi), you must follow these guidelines. Since the LS_HSI.msi installer will be used by a number of
partners, we have provided a simple “API” that all partners can use. This API consists of setting command-line
properties to pass information to the windows installer. We have also seen some updates that don’t set the
TRANSFORMS property called out below. This will result in the user getting English strings in the start menu and
autoplay dialogs even if they have a localized install for all other content. Please be sure to set the
TRANSFORMS property in all updates that are delivered to users.

New Features:
The command line property “SOURCELIST” is no longer required.
The LightScribe System Software installer now supports a number of languages in addition to English. You will
need to supply an additional property on the command line to tell the installer in what language the start menu
program group labels should be installed. The property is named TRANSFORMS and the possible values it can
take are listed at the end of this document. Please read this document carefully to assure you affect a correct
installation of the LightScribe System Software (refered to in the remainder of this document as LSS). It is
important that you use the “TRANSFORMS” file that matches the system language of the target system. Use the
list below to determine this. The Primary Language should be used (e.g. any sublanguage of Spanish will use the
Spanish transforms file)

How To:

There are two properties that must be supplied on the command line for a successful install. They are
UPDATE_SHELL_COMMAND and TRANSFORMS. If the last property is missing the labels in the start menu
program group will be in English even though the delivered content (e.g. the “Getting Started” page) will be in the
language of the target system.

There are three properties that are optional and control the creation of the “Getting Started” items. The “Getting
Started” items include a LightScribe desktop icon, launch target of this desktop icon and a LightScribe start menu
program group.

By default, the desktop icon and start menu group are created on a new install or an update if the end customer or
integrator has not removed them, or not installed by the following properties.

To opt-out of creating the desktop icon with a new install set SHOW_DESKTOP_ICON to 0. To opt-out of creating
the start menu program group with a new install, set SHOW_START_MENU to 0. Examples of how to use these
command line properties are shown below.

The third property, LS_LAUNCHER_COMMAND, is used to modify the default launch target of the desktop icon.
If this property is not set, the desktop icon will launch a “Getting Started” page, which is included and installed with
this package. If an integrator sets this property, the desktop icon will launch what this property specifies. This
property can contain a fully qualified local file, either static file or application, or a fully qualified URL.

Primary Contacts:
Technical Contact support@hurricane-dist.ipssources.com

Requirements:
Launch conditions (checked by install package)
• Supported Operating Systems
o Windows 2000 (Win2K)
o Windows XP (32 and 64)
o Windows MCE
o Windows Vista (32 and 64)
• User Rights
o Administrator rights required on Windows 2000, Windows XP, Windows MCE and Vista

Hardware (not checked by install package)

• Intel Pentium
• 128 MB RAM (higher is recommended)

Windows Installer (checked by Windows O.S.)

• Windows Installer Version 2.0 or later must be installed prior to running an installation of LS_HSI.msi from the
command line (using the msi file), or the installation will fail.

General Notes:
• Installing LS_HSI.msi from the command line can be very straightforward. However, the command-line syntax
is very exact with regard to spaces and quotation marks.
• Command-line parameters are passed in the form of PROPERTY=VALUE pairs. PROPERTY=VALUE pairs
are used to set Windows Installer properties. The section titled Command Line Specification for Installing
LS_HSI.msi explains how to use this form.
• The user has no choice on the install location of the “core” LightScribe files. The destination for the “core” is
%CommonProgramFiles%\LightScribe. On English systems, %CommonProgramFiles% usually expands to
“C:\Program Files\Common Files\”.

Command Line Invocation for Installing LS_HSI.msi

How to Call the MSI Installer with LS_HSI.msi
The lines below should have no carriage returns nor line feeds. If a line is wrapped due to the document width limitation
please be sure to remove any returns/linefeeds when using these command line examples

For a “silent” install: Call the install as:

( The square brackets indicate the argument is optional and the brackets are not part of the argument string)
Please note, on Vista you will either need to turn off UAC during this install OR use /qb+ instead of /qn. The option
/qb+ will allow a few dialogs to be displayed, but will require some user interaction during the install. If the UAC is
not turned off during the install and the /qn option is used, the install will silently fail as Vista will be asking for
permission to continue, but the silent option will hide this dialog so the installer will silently exit. So, the
recommended method on vista for those needing a completely silent install is to turn off UAC during the install and
then turning UAC back on after the install.

msiexec.exe /I LS_HSI.msi /qn UPDATE_SHELL_COMMAND=”<your_update_string>”

TRANSFORMS=”<xxxx.mst> [SHOW_DESKTOP_ICON=”0”] [SHOW_START_MENU=”0”]
[LS_LAUNCHER_COMMAND=”<your_launcher_command_string>”]

Here is an example for a Spanish system: (you must use your own update string. Do not use
“http://www.someSite.com/” as your string, it is just an example string. Please see the “LS Host
Software Delivery Informative” for details on the use of this UPDATE_SHELL_COMMAND property.

msiexec.exe /I LS_HSI.msi /qn UPDATE_SHELL_COMMAND=”http://www.someSite.com/”

TRANSFORMS=”1031.mst”

Page 2 of 5
This will hide all install dialogs and set the update registry setting to http://www.someSite.com/
You must check that the “HKLM/Software/LightScribe/Update” registry setting exists with your string to
verify that the “UpdateShellCommand” has been set correctly. This command line will also install a desktop
icon and a start menu group if these items have not been deleted or “opted-out” in a previous installation. The
start menu items for “LightScribe Direct Disc Labeling” will be in Spanish and the “Getting Started” page will be in
Spanish
.

For a “silent” install with no desktop icon: Call the install as:

msiexec.exe /I LS_HSI.msi /qn UPDATE_SHELL_COMMAND=”<your_update_string>”

TRANSFORMS=”<xxxx.mst>” [SHOW_DESKTOP_ICON=”0”]

For a “silent” install with no start menu group: Call the install as:

msiexec.exe /I LS_HSI.msi /qn UPDATE_SHELL_COMMAND=”<your_update_string>”

TRANSFORMS=”<xxxx.mst>” [SHOW_START_MENU=”0”]

For a “silent” install with your own launcher command: Call the install as:

msiexec.exe /I LS_HSI.msi /qn UPDATE_SHELL_COMMAND=”<your_update_string>”

TRANSFORMS=”<xxxx.mst>”LS_LAUNCHER_COMMAND=”http://www.someSite.com/someSubLevel”

For a “silent” install with a log file: For troubleshooting during configuration testing, append /L*! filename as
in this example:

msiexec.exe /I LS_HSI.msi /qn UPDATE_SHELL_COMMAND=”<your_update_string>” /L*! C:\theLog.txt

TRANSFORMS=”<xxxx.mst>”

This will create a log file named “theLog.txt” at C:\. It also hides all install dialogs.

Note that msiexec.exe is usually located in C:\WINNT\system32 on Win2k type OS’s

Version Management:
• LS_HSI.msi will not allow an older version to be installed over a newer installed version. In this scenario, the
installer will not install any files nor will it update the UPDATE_SHELL_COMMAND registry setting..
• LS_HSI.msi will not prompt a user to upgrade but will proceed silently. If the install is newer than the currently
installed product, it will use Windows Installer technology to upgrade the product. Any upgrade will be placed
in the same location as the current installation.

Opt-Out options:
• Starting with versions newer than 1.4.67.1 of the LS_HSI.msi, it contains the “Getting Started” features of
which an integrator can choose to opt-out from. These features include a LightScribe desktop icon and a
LightScribe start menu program group. These items are intended to make the use of LightScribe more visible
to end customers and it is strongly encouraged that integrators allow these items to be installed. If there is
some compelling reason why either of these should not be installed an integrator can opt-out of these items
by following the command line options explained above in this document.

Configuring LsLauncher:

The LS_HSI.msi package creates a desktop icon (shortcut) and a few start menu items. The desktop shortcut
and the “LightScribe->LightScribe” start menu item will launch LsLauncher.exe. LsLauncher.exe first looks in the

Page 3 of 5
registry to determine what action to take. If the registry entry is not present, or if the registry entry is not valid
then LsLauncher takes a default, built-in action (currently opening a local htm page).

In order to configure LsLauncher to launch an executable or open a document, you must create or reset the
“LSLauncher” entry in “HKLM/Software/LightScribe” with your string. To check that your setting is
correct, double click the desktop icon (shortcut) or select the “Lightscribe->Lightscribe” start menu item. If you
don’t see the action you expected then the registry item points to a non-existing file or the executable is not
working as expected. Try launching your executable in a command prompt window to see if it can launch
correctly.

Possible installation scenarios of LS_HSI.msi

There are several installation scenarios using the LS_HSI.msi:

1. Default install of the LS_HSI.msi resulting in:

a. LSS install
b. LightScribe desktop icon launching LightScribe default HTML page
c. LightScribe start menu program group

2. Install LS_HSI.msi with command line option (LS_LAUNCHER_COMMAND) resulting in:

a. LSS install
b. LightScribe desktop icon launching integrator specified target (local file, local app or website)
c. LightScribe start menu program group

3. Install LS_HSI.msi with command line option to opt-out of the desktop icon (SHOW_DESKTOP_ICON=”0”)
resulting in:
a. LSS install
b. LightScribe start menu program group

4. Install LS_HSI.msi with command line option to opt-out of the start menu program group
(SHOW_START_MENU=”0”) resulting in:
a. LSS install
b. LightScribe desktop icon

5. Install LS_HSI.msi with command line options to opt-out of all “Getting Started” items
(SHOW_DESKTOP_ICON=”0” & SHOW_START_MENU=”0”) resulting in:
a. LSS install

List of Supported LanguageID’s:

LSS Installer can be installed in any of these Primary Languages and supports sub languages by installing the
related Primary Language. Please note, setting the TRANSFORMS property to one of the values below only
controls the language of the labels in the “start menu” and the “autoplay” dialogs. The language for the remaining
content of the installation is determined internally to the installer by the System Language.

Primary Language Transform Name

Arabic 1025.mst
Simplified Chinese 2052.mst
Traditional Chinese 1028.mst
Czech 1029.mst

Page 4 of 5
 Danish 1030.mst
German 1031.mst
Greek 1032.mst
English 1033.mst
Spanish 1034.mst
Finnish 1035.mst
French 1036.mst
Hebrew 1037.mst
Italian 1040.mst
Japanese 1041.mst
Korean 1042.mst
Dutch 1043.mst
Norwegian 1044.mst
Polish 1045.mst
Portuguese-Brazilian 1046.mst
Portuguese-Portugal 2070.mst
Russian 1049.mst
Slovak 1051.mst
Swedish 1053.mst
Turkish 1055.mst

Manual uninstall:

If necessary, starting with release 1.4.89.1 the LS_HSI.msi package can be uninstalled using msiexec.exe. This
only applies to systems where previous “permanent” versions of the LS_HSI.msi have not been installed. Use the
following command line:

msiexec.exe /x LS_HSI.msi

Page 5 of 5