Installing Intouch Søk og SMS

(1)

BluePosition ApS - SCION-DTU - Diplomvej 376 - 2800 Lyngby - Tlf.: +45 70 20 65 25 - Fax.: +45 45 26 77 10 www.MobileCTI.dk – www.BluePosition.com – www.MobileIVR.dk

Installing Intouch Søk og SMS™

(2)

Introduction

This document describes how to configure group policy to install Intouch Søk og SMS. Installation from the command line using Msiexec and manual install is also briefly described.

The guide is not intended to be a manual in software deployment using group policy. Refer to Microsoft® documentation for further information on group policy and group policy based software deployment. The guide assumes reader knowledge of group policy concepts and the Group Policy Management Console, as well as Active Directory Organizational Units and related concepts.

Note: BluePosition does not offer support for group policy creation, configuration, or trouble-shooting.

Important: Since the group policy installer does not check for system prerequisites such as Microsoft .net

framework 4 and Microsoft Lync, you must install those before you can run the Intouch Søk og SMS group policy installer.

Installing from the Command Line

The INI file can be referenced from the command line as shown in following example:

Msiexec /quiet /i “Intouch Søk og SMS.msi” CMDLINE=”/inifile \\mys erver\myinstallerfilespath\myi nifile.ini”

Patching the MSI File using Microsoft Orca

The INI file can be placed on a network drive which must accessible from the client PC when ru nning the installation.

To make the INI file accessible to the Intouch Søk og SMS MSI installer it must be referenced by patching the MSI file or by supplying command line parameters if installing from a command line.

Orca is part of the Microsoft SDK which can be downloaded here: http://www.microsoft.com/en-us/download/details.aspx?id=3138

(4)

Important: even if the path to the INI file or the name of the INI file itself contains spaces it is not allowed

to use quotation marks around the full path to the INI file.

Create a Group Policy to deploy Intouch Søk og SMS

To create a new group policy to deploy Intouch Søk og SMS, open the Group Policy Management Console on a domain controller.

(5)

Note that Intouch Søk og SMS must be installed from the User Configuration part of the group policy, as the installer requires access to the user’s profile.

Right-click the “Software installation” branch in the tree and select “New->Package…”. Select “Intouch Søk og SMS.msi” as the package to install.

Select”Advanced” as the deployment method. This is necessary to configure further steps below.

(6)

Now you can click “OK” to store the GPO.

The next time a user in the selected organizational unit logs on to their computer, the group policy software deployment will take care of installing the package.

Note, that due to Windows’ ”Logon Optimization”, you may have to reboot the target computer twice before the installation is performed.1

Upgrading

(7)

Also check the “Required upgrade for existing packages” to for clients to automatically upgrade. Note that you must not remove the old MSI file before all clients have upgraded. If the clients cannot access the old MSI file, they are unable to uninstall the old version of Intouch Søk og SMS. This will make the upgrade fail.

Customize Group Policy Installation

Since there is no user input in the group policy based installation, it is possible to customize some of the Intouch Søk og SMS installation parameters using an INI file.

Manual Installation

(8)

The INI File Format

The INI file can have any name like “Intouch Søk og SMS.ini” as long as the file extension is “.ini”. The parameters which can be set are described in the table below. All the parameters must be after the first line containing only the text “[Global]”. Comments may be added to the file with lines starting with semi-colon (“;”).

Parameter Description

License The license key provided by Intouch.

Company The company name associated with the license

key.

Username The username for the Intouch search service.

Password The password for the Intouch search service.

UiLanguage The user interface language for Søk and SMS.

Valid values:

 Norwegian

 English

 Danish

DefaultSearchCountry The default search country used in the Intouch search service.

Valid values:

 Norway

 Sweden

 Denmark

(9)

Example file

Troubleshooting

In case of problems with the installation, look at the Windows event logs for problem details. The Intouch Søk og SMS MSI based installer will also log to the TEMP folder, if it is able to.

The Windows group policy installer (Application Management) may log the following messages to the Windows event log in case of problems:2

Log message Possible resolution

Failed to apply changes to software installation settings. The error was: The group policy framework should call the extension in the synchronous foreground policy refresh.

Restart the computer. Due to the Windows logon optimization feature, the group policy updates are normally applied asynchronously. Software installation must be done synchronously. The installation will run when the computer is rebooted.

The install of application Intouch Søk og SMS from policy Install Intouch Søk og SMS failed. The error was: The installation source for this product is not available. Verify that the source exists and that you can access it.

The MSI package for the referenced product version has been removed from its original

location. Never remove the MSI files unless you are absolutely certain that no computers have that specific version installed. The problem can be resolved by restoring the missing MSI file. Product: Intouch Søk og SMS -- Error 1303. The

installer has insufficient privileges to access this directory: C:\Program Files\LinkSMS. The

The user to which the group policy is assigned – the user who logs on to the target computer – does not have write access to the folder specified

2_{The Application Management log entries are in the Application event log on Windows XP™, and in the System event} log on Windows Vista™ and Windows 7™.

[Global]

License=12345-67890

Company=Your company name Username=user33

Password=secret uiLanguage=Norwegian

(10)

installation cannot continue. Log on as administrator or contact your system administrator.

in the error message. The user must have the ability to install programs for the group policy software distribution to work.

In case of problems, also look for log messages from MSIInstaller in the Windows event log. If the log messages indicate that the installation was performed successfully, but the product is not installed, then wait a few minutes. The Windows MSI installer may sti ll be working.

Installing Intouch Søk og SMS