Running AX Client silent installation

Use the silent installation option to deploy the AX Client application to a large number of workstations.

How it works

The silent installation option runs the installer with preselected options and no user interface.

The command uses one of two files from the AX Client installation package:

  • setup.exe
  • AXCoreClient.msi

In order to access this file you need to download and run the AX Client installer to extract the installation files. The AX Client installer is designed so that the installation process starts automatically after the files are extracted.

The default destination folder for the extracted files is: C:\Program Files\ACL Software\Installers\ACLAX<version>_Client_<edition>.

Example

Using setup.exe

setup.exe /S /l"2052" /v"/qn SERVERADDRESS=AXSERVER.ACL.COM WEBPORT=443 INSTALLDIR=\"C:\ACL\AX Client\" /log \"C:\install.log\" TRUST_SELFSIGNED=1"

Using msiexec

msiexec /i "AXCoreClient.msi" TRANSFORMS=1033.mst /qn SERVERADDRESS=AXSERVER.ACL.COM WEBPORT=443 INSTALLDIR="C:\ACL\AX Client" /log "C:\install.log" TRUST_SELFSIGNED=1

Command options for for setup.exe

/S
Specifies that setup.exe should run in silent mode. This must be entered in upper-case.
/l
Optional. Specifies the installation language. This value must be enclosed in quotation marks and follow directly after the /l without any spaces: /l"2052".

ACL GRC Analytics Exchange supports the following languages:

  • Chinese (zh-cn) 2052
  • English (en-us) 1033
  • French (fr) 1036
  • German (de) 1031
  • Japanese (ja) 1041
  • Portuguese (pt-br) 1046
  • Spanish (es) 1034
/v
Specifies that arguments will be passed to the installer. Do not include a space between /v and arguments. Multiple arguments must be enclosed in quotation marks.

Example/v"/qn serveraddress=ax.acl.com"

/qn
Specifies that the installer should run without a user interface.
SERVERADDRESS
The hostname of the server where your organization’s installation of AX Server is located.
The hostname you enter must match the hostname specified in the SSL security certificate to connect without encountering security certificate errors. If you do not know the hostname, ask your ACL GRC Analytics Exchange administrator for this setting.
You can enter the IP address for the server instead of the hostname, but this is not recommended as you encounter security certificate errors.
WEBPORT
Optional. The HTTPS port used to connect to AX Server. If the port is not specified, 443 is used.
INSTALLDIR
The target installation directory for AX Client application files.
You must install AX Client in a folder that the AX Client end-user has write access to. By default, only users assigned to the Administrators user group are granted write access to the Program Files folder.
If the file path includes any spaces, you must use a double-quote and an escape character (\") to specify the path.
Example to use C:\AX Client as the path, you must enter the following: \"C:\AX Client\"
log
Optional. Specifies the path and file name of the log file used to record the installation. The specified log directory must exist before you run the installation.
CUSTOM_CERTIFICATES
Optional. The full path to a security certificate file(s) you want to import into the client machine's keystore file. For more information about certificates, see Security certificates.

Note

To verify that a certificate imports successfully, check the keystore file or installation log file.

The argument must be enclosed by a double-quote and any spaces must be escaped with the escape character (\"). Delimit multiple certificate files with semi-colons.
Example CUSTOM_CERTIFICATES=\"C:\Temp\Cert1;C:\Program Files\MyCerts\Cert2\"
If you are importing multiple certificate files, each file must have a unique file name regardless of the full file path. The AX Client installer uses the file name as the certificate alias in the keystore so the file name must be unique.
TRUST_SELFSIGNED
Optional. Specifies whether or not to automatically trust the default self-signed certificate installed with AX Server:
  • 0 false (default value)
  • 1 true
For more information about certificates, see Security certificates.

Command options for msiexec

/i
Specifies that a normal installation should be run.
/TRANSFORMS
Specifies the installation language. This value references a .mst file in the same directory as the installer. Use the desired language code as the filename (1033.mst):
  • Chinese (zh-cn) 2052
  • English (en-us) 1033
  • French (fr) 1036
  • German (de) 1031
  • Japanese (ja) 1041
  • Portuguese (pt-br) 1046
  • Spanish (es) 1034
/qn
Specifies that the installer should run without a user interface.
SERVERADDRESS
The hostname of the server where your organization’s installation of AX Server is located.
The hostname you enter must match the hostname specified in the SSL security certificate to connect without encountering security certificate errors. If you do not know the hostname, ask your ACL GRC Analytics Exchange administrator for this setting.
You can enter the IP address for the server instead of the hostname, but this is not recommended as you encounter security certificate errors.
WEBPORT
Optional. The HTTPS port used to connect to AX Server. If the port is not specified, 443 is used.
INSTALLDIR
The target installation directory for AX Client application files.
You must install AX Client in a folder that the AX Client end-user has write access to. By default, only users assigned to the Administrators user group are granted write access to the Program Files folder.
If the file path includes any spaces, you must use a double-quote and an escape character (\") to specify the path.
Example to use C:\AX Client as the path, you must enter the following: \"C:\AX Client\"
log
Optional. Specifies the path and file name of the log file used to record the installation. The specified log directory must exist before you run the installation.
CUSTOM_CERTIFICATES
Optional. The full path to a security certificate file(s) you want to import into the client machine's keystore file. For more information about certificates, see Security certificates.

Note

To verify that a certificate imports successfully, check the keystore file or installation log file.

The argument must be enclosed by a double-quote and any spaces must be escaped with the escape character (\"). Delimit multiple certificate files with semi-colons.
Example CUSTOM_CERTIFICATES=\"C:\Temp\Cert1;C:\Program Files\MyCerts\Cert2\"
If you are importing multiple certificate files, each file must have a unique file name regardless of the full file path. The AX Client installer uses the file name as the certificate alias in the keystore so the file name must be unique.
TRUST_SELFSIGNED
Optional. Specifies whether or not to automatically trust the default self-signed certificate installed with AX Server:
  • 0 false (default value)
  • 1 true
For more information about certificates, see Security certificates.

Run the silent installation

  1. Run the installer ACLAX<version>_Client_<edition>.exe and click Cancel on the Welcome page of the setup wizard.
  2. Open the OS command prompt as an administrator by doing one of the following:
    • Use the runas command from the prompt.
    • In the C:\windows\system32 sub-folder in Windows Explorer, right-click on cmd.exe and select Run as administrator.
  3. Change directories to the directory containing the installer and run one of the following silent installation commands:

setup.exe

For a fresh installation:

setup.exe /S /l"2052" /v"/qn SERVERADDRESS=ax_server_name WEBPORT=ax_server_port INSTALLDIR=path /log path TRUST_SELFSIGNED=1"

For an upgrade:

setup.exe /S /v/qn

The upgrade installation syntax will use the settings from the previous installation.

msiexec

For a fresh installation:

msiexec /i "AXCoreClient.msi" TRANSFORMS=1033.mst /qn SERVERADDRESS=ax_server_name WEBPORT=ax_server_port INSTALLDIR=path /log path TRUST_SELFSIGNED=1

For an upgrade:

msiexec /i "AXCoreClient.msi" \qn

[ Back to top ]

(C) ACL Services Ltd. All Rights Reserved. Thursday, October 4, 2018