Install ACL for Windows using silent installation
Important
If you intend to silently install ACL for Windows on a computer with the Windows 8.1 operating system, you must first install Windows Update KB2919355.
This requirement applies only to those computers that do not have the Microsoft .NET 4.6.x prerequisite already installed.
For more information, see ACL for Windows system requirements.
If you need to deploy ACL for Windows to a large number of workstations, you can use silent installation to run the installer without requiring user interaction.
How it works
Silent installation uses the Windows command line to run the ACL for Windows installer with preselected options and no user interface.
The command uses either of the installer files from the installation package. See Two installer files to decide which one you should use.
Example
The figure below provides an example of silent installation syntax in the Windows command line.
Extracting the installer files
In order to access the installer files, download the ACL for Windows installation package (ACLforWindows141.exe) from Launchpad (www.highbond.com). Run the installation package to extract the two installer files.
The installation package is designed to automatically start the installation process after the files are extracted. If you are using the silent installation option, 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\ACLforWindows14\
Two installer files
The ACL for Windows installation package (ACLforWindows141.exe) contains two installer files:
- setup.exe
- ACL for Windows.msi
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 for Windows system requirements.
setup.exe
setup.exe installs the required software prerequisites on the target computer if they are not already installed.
ACL for Windows.msi
All software prerequisites must already be installed on the target computer in order to use ACL for Windows.msi.
Run the silent installation
- Double-click the installation package ACLforWindows141.exe and click Cancel as soon as the installers are extracted.
- Open the Windows command prompt as an administrator.
There are different methods for opening the command prompt as an administrator depending on your version of Windows.
This method works for all versions of Windows:
In the C:\windows\system32 sub-folder in Windows Explorer, right-click on cmd.exe and select Run as administrator.
- Run one of the silent installation commands below.
Note
Specify the full path to an installer file. Enclose the path in quotation marks if the path includes any spaces.
The examples below provide generic syntax only. Detailed syntax guidelines, and additional information about silent installation, appear in subsequent sections.
To do this: Use this file: With this command: Install ACL for Windows 14.1 setup.exe "setup_exe_path_and_filename" /s /L<language ID> /v"/qn APPENCODING=<ACL Edition> RUNFROMSETUPEXE=1"
ACL for Windows.msi msiexec /i "msi_path_and_filename" TRANSFORMS=<language ID>.mst APPENCODING=<ACL Edition> /qn
Silent installation guidelines
Review and follow the guidelines below for entering the silent installation command syntax in the Windows command line.
Caution
Not following any of the guidelines will cause the silent installation to fail.
Guideline | Details |
---|---|
Run as administrator | To use the .msi file to silently install ACL for Windows you need to run the Windows command line as an administrator. Right-click cmd.exe and select Run as administrator. |
Wrapping syntax | Do not enter any line breaks in the syntax. Allow the Windows command line to automatically wrap syntax to the next line. |
Separating parameters | Separate parameters with a space. For example: TRANSFORMS=1033.mst INSTALLDIR="C:\Program Files\ACL Analytics" The one exception is the following piece of syntax, which must be entered without any spaces: /v"/qn" |
Values with spaces | Any parameter values or network paths that include spaces
must be enclosed in quotation marks. For example:
|
Multiple parameters following the /v parameter | Multiple parameters following the /v parameter
must be enclosed in quotation marks. For example: /v"/qn INSTALLDIR=C:\ACL_Analytics DATADIR=C:\ACL_Data" |
Quotation marks within quotation marks | Quotation marks within quotation marks must use a backslash
as an escape character ( \" ). For example: /v"/qn DATADIR=\"C:\ACL Data\"" In the example above, quotation marks are required around the entirety of the two parameters (/qn and DATADIR), and quotation marks are also required around a parameter value that includes a space (C:\ACL Data). The escape character must precede each quotation mark in the internal set of quotation marks. |
Format of quotation marks | If you copy and paste syntax into the Windows command line, make sure any quotation marks are straight quotation marks rather than curly quotation marks. |
Command line parameters
setup.exe parameters
Parameter | Details |
---|---|
"setup_exe_path_and_filename" |
Specifies the network or local path to the setup.exe installer file. The path must include the file name and file extension. Use this parameter if the required prerequisites have not yet been installed on the end user’s computer. |
/s | Specifies that setup.exe runs in silent mode. |
/L<language ID> | Specifies the language of the ACL for Windows user interface. |
/v |
Specifies that parameter values will be passed to the installer.
|
/RUNFROMSETUPEXE=1 | Use this parameter and a value of 1 to specify that the silent installation is using the setup.exe installer file. |
ACL for Windows.msi parameters
Parameter | Details |
---|---|
msiexec /i "msi_path_and_filename" |
Specifies the network or local path to the ACL for Windows.msi installer file. The path must include the file name and file extension. Use this parameter if all prerequisites have already been installed on the end user’s computer. |
TRANSFORMS=language ID | Specifies the language of the ACL for Windows user interface. |
General parameters – both setup.exe and ACL for Windows.msi
Parameter | Details |
---|---|
/qn | Specifies that the installer runs in silent mode with no user interface. |
INSTALLDIR=path to ACL for Windows application files folder |
Specifies the destination folder for application files. If you omit the parameter, the default location is used:
|
DATADIR=path to sample data files folder |
Specifies the destination folder for Analytics sample data files, which is also the Analytics working directory. If you omit the parameter, 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. |
APPENCODING=ACL edition |
Specifies which edition of Analytics is installed.
|
Specifying the language of the user interface
To specify the language of the ACL for Windows user interface:
- use the /L parameter with setup.exe
- use the TRANSFORMS parameter with ACL for Windows.msi
You need to specify the appropriate language ID with each parameter.
For example:
-
Use /L1033 to specify the English user interface if you are using setup.exe
-
Use /L1034 to specify the Spanish user interface if you are using setup.exe
-
Use TRANSFORMS=1034.mst to specify the Spanish user interface if you are using ACL for Windows.msi
Note
It is recommended that you always use the language parameter even if you are installing the English version of ACL for Windows on an English operating system.
Omitting the language parameter
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.
Behavior of language parameters and installer files
Parameter used |
setup.exe |
ACL for Windows.msi |
---|---|---|
/L |
ACL for Windows uses the language specified |
n/a |
TRANSFORMS |
n/a |
ACL for Windows uses the language specified |
parameter omitted |
ACL for Windows uses the operating system language, or English if ACL for Windows does not support the operating system language |
ACL for Windows uses English |
Silent installation syntax for the languages supported by ACL for Windows
Language |
setup.exe syntax |
ACL for Windows.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 |
Polish |
/L1045 |
TRANSFORMS=1045.mst |
Portuguese |
/L1046 |
TRANSFORMS=1046.mst |
Spanish |
/L1034 |
TRANSFORMS=1034.mst |
Specifying the non-Unicode or Unicode edition
Note
- You cannot use the installer to upgrade non-Unicode Analytics to Unicode Analytics, or vice versa.
- Unicode and non-Unicode editions of Analytics or ACL Desktop cannot be installed side by side.
To specify which edition of Analytics is installed, use the APPENCODING parameter with either setup.exe or ACL for Windows.msi. The parameter is optional if you are installing the non-Unicode edition.
-
Use APPENCODING=NonUnicode, or do not use the parameter, to install the non-Unicode edition of Analytics.
-
Use APPENCODING=Unicode to install the Unicode edition of Analytics.
Note
The Chinese, Japanese, and Polish versions of Analytics are Unicode-only.
Syntax examples
The table below provides several examples of command line syntax for silently installing ACL for Windows.
If you are installing ACL for Windows on computers running 32-bit operating systems, and you are specifying an installation directory rather than using the default location, substitute C:\Program Files\ for C:\Program Files (x86)\ in the examples below.
Installation details | Required syntax |
---|---|
|
\\nas-server-2\shared_files\installers\ACLforWindows14\setup.exe /s /L1033 /v"/qn RUNFROMSETUPEXE=1" |
|
"\\nas-server-2\shared_files\installers\ACLforWindows14\setup.exe" /s /v"/qn APPENCODING=Unicode RUNFROMSETUPEXE=1" |
|
\\nas-server-2\shared_files\installers\ACLforWindows14\setup.exe /s /L1033 /v"/qn APPENCODING=NonUnicode INSTALLDIR=\"C:\Program Files (x86)\ACL Analytics\" DATADIR=\"C:\ACL Data\" RUNFROMSETUPEXE=1" |
|
\\nas-server-2\shared_files\installers\ACLforWindows14\setup.exe /s /L1031 /v"/qn RUNFROMSETUPEXE=1" |
|
msiexec /i "\\nas-server-2\shared_files\installers\ACLforWindows14\ACL for Windows.msi" INSTALLDIR="C:\Program Files (x86)\ACL Analytics" TRANSFORMS=1033.mst APPENCODING=Unicode /qn |
|
msiexec /i "\\nas-server-2\shared_files\installers\ACLforWindows14\ACL for Windows.msi" TRANSFORMS=2052.mst APPENCODING=Unicode /qn |