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.
Note
Silent installation of ACL for Windows does not support excluding the Python engine or the optional data connectors. Silent installation automatically installs these optional components.
If you want to exclude the optional components, you must perform the installation using the installation wizard.
For more information, see Perform the main ACL for Windows installation or upgrade.
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.
You can use silent installation to perform a fresh installation of ACL for Windows 16.1.1.
After you perform the silent installation, you need to activate ACL for Windows. For the steps to activate ACL for Windows, see Activate Analytics.
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
To access the installer files, download the ACL for Windows installation package (ACLforWindows1611.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\ACLforWindows1611\
Two installer files
The ACL for Windows installation package (ACLforWindows1611.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 ACLforWindows1611.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 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.
Action Installer file Silent installation command Install ACL for Windows 16.1.1
setup.exe "setup_exe_path_and_filename" /s /L<language ID> /v"/qn APPENCODING=<Analytics Edition> RUNFROMSETUPEXE=1"
ACL for Windows.msi msiexec /i "msi_path_and_filename" TRANSFORMS=<language ID>.mst APPENCODING=<Analytics Edition> /qn
Silent installation guidelines
Review and follow the guidelines 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\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: DATADIR="C:\Analytics Data" "\\nas-server-2\installers\ACLforWindows1611\ACL for Windows.msi" |
| Multiple parameters following the /v parameter | Multiple parameters following the /v parameter
must be enclosed in quotation marks. For example: /v"/qn INSTALLDIR=C:\Analytics DATADIR=C:\Analytics_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:\Analytics 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:\Analytics 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 mandatory 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.
|
| SKIP_MS_ACCESS=TRUE | Specifies that 32-bit Microsoft Access Database Engine is not installed as part of the ACL for Windows installation. |
| /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 – 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 that end users have read and write permissions to the data files folder you specify. |
| APPENCODING=Analytics 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 |
|
Portuguese |
/L1046 |
TRANSFORMS=1046.mst |
|
Spanish |
/L1034 |
TRANSFORMS=1034.mst |
Excluding Microsoft Access Database Engine
If you use setup.exe for the silent installation, you have the option of excluding Microsoft Access Database Engine from the ACL for Windows installation.
You may want to exclude the Database Engine if your organization uses only the current generation of Excel file (*.xlsx) with Analytics and no longer uses the older Excel file type (*.xls). For more information, see Exclude optional Microsoft Access Database Engine.
- To exclude the Database Engine, use SKIP_MS_ACCESS=TRUE .
- To include the Database Engine, do not use the SKIP_MS_ACCESS parameter.
If the Database Engine is already installed on a computer as part of a previous ACL for Windows installation, the SKIP_MS_ACCESS parameter does not uninstall it.
The SKIP_MS_ACCESS parameter is not intended for use with the ACL for Windows.msi installer file.
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 and Japanese versions of Analytics are Unicode-only.
Syntax examples
The following table provides several examples of command line syntax for silently installing or upgrading 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\ACLforWindows1611\setup.exe /s /L1033 /v"/qn RUNFROMSETUPEXE=1" |
|
"\\nas-server-2\shared_files\installers\ACLforWindows1611\setup.exe" /s /v"/qn SKIP_MS_ACCESS=TRUE APPENCODING=Unicode RUNFROMSETUPEXE=1" |
|
\\nas-server-2\shared_files\installers\ACLforWindows1611\setup.exe /s /L1033 /v"/qn APPENCODING=NonUnicode INSTALLDIR=\"C:\Program Files (x86)\Analytics\" DATADIR=\"C:\Analytics Data\" RUNFROMSETUPEXE=1" |
|
\\nas-server-2\shared_files\installers\ACLforWindows1611\setup.exe /s /L1031 /v"/qn RUNFROMSETUPEXE=1" |
|
msiexec /i "\\nas-server-2\shared_files\installers\ACLforWindows1611\ACL for Windows.msi" INSTALLDIR="C:\Program Files (x86)\Analytics" TRANSFORMS=1033.mst APPENCODING=Unicode /qn |
|
msiexec /i "\\nas-server-2\shared_files\installers\ACLforWindows1611\ACL for Windows.msi" TRANSFORMS=2052.mst APPENCODING=Unicode /qn |
