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 the setup.exe file from the AX Client installation package. 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>.

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. Run one of the following silent installation commands:

   For a fresh installation:

   setup.exe /S /l"2052" /v"/qn SERVERADDRESS=ax_server_ip 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.

Command arguments

/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".

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 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.

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.