Installing ACL Analytics using silent installation

If you need to deploy ACL Analytics to a large number of workstations, you can use silent installation to run the installer without requiring user interaction.

The installer file you use to perform the silent installation depends on whether the required software prerequisites are already installed on the target computer:

For a list of the software prerequisites, see ACL Analytics system requirements.

The two installer files are in the ACL Analytics installation package:

ACLAnalytics1130_<edition>.exe

Silent upgrade

If organizational policy does not allow users to upgrade ACL Analytics themselves, you can silently upgrade ACL Analytics from version 11.x to version 11.3. The ACL Analytics installer does not upgrade versions of ACL Analytics or ACL Desktop prior to version 11.1.

To silently upgrade ACL Analytics, follow the process for silent installation. The upgrade uses the existing installation directory, and the existing sample data files directory, which may or may not be the ACL Analytics default directories. If you want to change either of these directories, you need to use the INSTALLDIR or DATADIR parameters (explained below).

Important information about the Microsoft .NET Framework prerequisite

ACL Analytics requires that version 4.5.2 of the Microsoft .NET Framework is also installed. If the .NET Framework is not installed on the target computer, the ACL Analytics installer automatically installs it. However, ACL Analytics silent installation is simplified if .NET 4.5.2 is already installed on the target computer before you begin the ACL Analytics installation. The best way to install .NET 4.5.2 is to run the appropriate Windows Update.

If .NET 4.5.2 is not already installed, and you will be using the ACL Analytics installer to install it, you need to ensure the following:

Note

If you encounter an error during the ACL Analytics installation that appears related to the .NET installation, or that states a previous installation is not complete and requires a restart, reboot the target computer.

Extracting the installer files

In order to access the installer files you need to download and run the ACL Analytics installation package to extract the two installer files. The ACL Analytics installation package is designed to automatically start the installation process after the files are extracted. If you are using the silent installation option, you can click Cancel as soon as the files have been extracted. The default location for the extracted files is:

C:\Users\user_account_name\Downloads\ACL Installers\ACLAnalytics1130_<edition>\

Basic silent installation syntax

Table 1 provides the basic syntax for silent installation of ACL Analytics with default settings. Note the different syntax required depending on which installer file you use.

Specify the full path to setup.exe or ACL Analytics.msi and enclose the path in quotation marks if the path includes any spaces. Additional guidelines, information about specifying the language version, more detailed examples, and optional parameters are provided in subsequent sections.

Table 1. Basic silent installation syntax

Installer file

Basic syntax

setup.exe

  • installs required software prerequisites

"setup_exe_path_and_filename" /s /L<language ID> /v"/qr RUNFROMSETUPEXE=1 REBOOT=ReallySuppress"

ACL Analytics.msi

  • required software prerequisites must already be installed

msiexec /i "msi_path_and_filename" TRANSFORMS=<language ID>.mst /qn

Silent installation guidelines

Review and follow the guidelines below for entering the silent installation command syntax in the Windows command line. Not following any of the guidelines will cause the silent installation to fail.

Figure 1 below provides an example of silent installation command syntax in the Windows command line.

Figure 1. An example of silent installation command syntax

Specifying the language of the ACL Analytics user interface

To specify the language of the ACL Analytics user interface, use the /L parameter with setup.exe, or the TRANSFORMS parameter with ACL Analytics.msi. You need to specify the appropriate language ID with each parameter. For example:

Note

It is recommended that you always use the language parameter even if you are installing the English version of ACL Analytics on an English operating system.

If you omit the language parameter, the installation defaults to the language of the computer’s operating system, or to English, depending on which installer file you use.

Table 2 summarizes the behavior of the language parameters and the installer files. Table 3 provides the silent installation syntax for the languages supported by ACL Analytics.

Table 2. Behavior of language parameters and installer files

Parameter used

setup.exe

ACL Analytics.msi

/L

ACL Analytics uses the language specified

n/a

TRANSFORMS

n/a

ACL Analytics uses the language specified

parameter omitted

ACL Analytics uses the operating system language, or English if ACL Analytics does not support the operating system language

ACL Analytics uses English

 

Table 3. Silent installation syntax for the languages supported by ACL Analytics

Language

setup.exe syntax

ACL Analytics.msi syntax

Chinese

/L2052

TRANSFORMS=2052.mst

English

/L1033

TRANSFORMS=1033.mst

French

/L1036

TRANSFORMS=1036.mst

German

/L1031

TRANSFORMS=1031.mst

Japanese

/L1041

TRANSFORMS=1041.mst

Korean

/L1042

TRANSFORMS=1042.mst

Polish

/L1045

TRANSFORMS=1045.mst

Portuguese

/L1046

TRANSFORMS=1046.mst

Spanish

/L1034

TRANSFORMS=1034.mst

Syntax examples

Table 4 provides several examples of command line syntax for silently installing ACL Analytics.

If you are installing ACL Analytics on computers running 64-bit operating systems, and you are specifying an installation directory rather than using the default location, substitute C:\Program Files (x86)\ for C:\Program Files\ in the examples below.

Table 4. Examples of command line syntax for silently installing ACL Analytics

Installation details

Required syntax

  • uses setup.exe

  • installs required software prerequisites

  • English non-Unicode edition

  • default settings

\\nas-server-2\shared_files\installers\ACLAnalytics1130_nonUnicode\setup.exe /s /L1033 /v"/qr
RUNFROMSETUPEXE=1 REBOOT=ReallySuppress"
  • uses setup.exe

  • installs required software prerequisites

  • uses the operating system language

  • Unicode edition

  • default settings

"\\nas-server-2\shared files\installers\ACLAnalytics1130_Unicode\setup.exe" /s /v"/qr
RUNFROMSETUPEXE=1 REBOOT=ReallySuppress"
  • uses setup.exe

  • installs required software prerequisites

  • English non-Unicode edition

  • 2 custom settings

\\nas-server-2\shared_files\installers\ACLAnalytics1130_nonUnicode\setup.exe /s /L1033 /v"/qr
INSTALLDIR=\"C:\Program Files\ACL Analytics\" DATADIR=\"C:\ACL Data\"
RUNFROMSETUPEXE=1 REBOOT=ReallySuppress"
  • uses setup.exe

  • installs required software prerequisites

  • German non-Unicode edition

  • default settings

\\nas-server-2\shared_files\installers\ACLAnalytics1130_nonUnicode\setup.exe /s /L1031 /v"/qr
RUNFROMSETUPEXE=1 REBOOT=ReallySuppress"
  • uses ACL Analytics.msi

  • required software prerequisites must already be installed

  • English Unicode edition

  • 1 custom setting

msiexec /i
"\\nas-server-2\shared_files\installers\ACLAnalytics1130_Unicode\ACL Analytics.msi"
INSTALLDIR="C:\Program Files\ACL Analytics"
TRANSFORMS=1033.mst /qn
  • uses ACL Analytics.msi

  • required software prerequisites must already be installed

  • Chinese Unicode edition

  • default settings

msiexec /i
"\\nas-server-2\shared_files\installers\ACLAnalytics1130_Unicode\ACL Analytics.msi"
TRANSFORMS=2052.mst /qn

Command line parameters – setup.exe

/qr

Specifies that the installer runs in silent mode with a reduced user interface.

"setup_exe_path_and_filename"

Specifies the network or local path to the setup.exe installer file. Use this parameter if the required prerequisites have not yet been installed on the end user’s computer. The path must include the file name.

/s

Specifies that setup.exe runs in silent mode.

/L<language ID>

Specifies the language of the ACL Analytics user interface.

/v

Specifies that parameter values will be passed to the installer. Do not include a space between /v and the first parameter. If more than one parameter follows /v the list of parameters must be enclosed in quotation marks.

/RUNFROMSETUPEXE=1

Use this parameter and a value of “1” to specify that the silent installation is using the setup.exe installer file.

/REBOOT=ReallySuppress

Use this parameter and a value of “ReallySuppress” to specify that the silent installation in /qr mode suppresses any reboot messages.

Command line parameters – ACL Analytics.msi

/qn

Specifies that the installer runs in silent mode with no user interface.

msiexec /i "msi_path_and_filename"

Specifies the network or local path to the ACL Analytics.msi installer file. Use this parameter if all prerequisites have already been installed on the end user’s computer. The path must include the file name.

TRANSFORMS=language ID

Specifies the language of the ACL Analytics user interface.

Command line parameters – general

INSTALLDIR=path to ACL Analytics application files folder

Specifies the destination folder for application files.

If you do not include this parameter in the silent installation syntax, the default location is used:

C:\Program Files\ACL Software\ACL Analytics 11\

On computers running 64-bit operating systems the default location is:

C:\Program Files (x86)\ACL Software\ACL Analytics 11\

DATADIR=path to sample data files folder

Specifies the destination folder for ACL sample data files, which is also the ACL Analytics working directory.

If you do not include this parameter in the silent installation syntax, the default location is used:

C:\Users\user_account_name\Documents\ACL Data\Sample Data Files\

Note

Make sure end users have read and write permissions to the data files folder you specify.



(C) 2015 ACL Services Ltd. All Rights Reserved.