Silent installation preference keys

You specify preferences in a response file for use during silent installation.

Note: You can specify more than one preference in a response file.

For some preferences, the _EDITABLE option can be added at the end of the preference name. The _EDITABLE option enables or disables the preference for a user in the Installation Manager interface. In the Installation Manager interface, users cannot edit a preference that ends with the _EDITABLE option. Changes made to _EDITABLE preferences are persistent.

For example, the preference com.ibm.cic.common.core.preferences.ssl.nonsecureMode can be set in Installation Manager. The preference com.ibm.cic.common.core.preferences.ssl.nonsecureMode_EDITABLE cannot be set in Installation Manager.

When you define preferences in a response file, the XML code looks like the following example:

<preference
	name = 'the key of the preference'
	value = 'the value of the preference to be set'>
</preference>
Example:
<preference
	name = 'com.ibm.cic.common.core.preferences.searchForUpdates'
	value = 'false'>
</preference>
Many but not all keys can be set in Installation Manager. The keys are provided in tables that correspond to the list of preferences in Installation Manager. To access the preferences in Installation Manager, click File > Preferences. You can set these preferences in a response file:
You cannot set these keys in a response file:
  • Appearance keys. To set the Appearance key preferences in Installation Manager, click File > Preferences > Appearance.
  • Help keys. To set the Help key preferences in Installation Manager, click File > Preferences > Help.

Credentials required for authenticating to repositories and proxy servers during silent installations are also not saved in a response file or Installation Manager Preferences. You must create a keyring file for authenticating.

Repository keys Value Notes
offering.service.repositories.areUsed True or False When this preference is set to true, service repositories are searched when products are installed or updated. Change this preference to false to disable it.

Click File > Preferences > Repositories to set the Search service repositories during installation and updates preference in Installation Manager.

offering.service.repositories.areUsed_EDITABLE True or False When set to true, the Search service repositories during installation and updates preference cannot be checked or cleared in Installation Manager. True is the default value.

With the _EDITABLE option included, you cannot set this preference in Installation Manager.

com.ibm.cic.common.core.preferences.repositoryLocations_EDITABLE True or False Use this preference to specify whether users can change the list of repositories. If set to false, users cannot modify the repository locations. True is the default value.

With the _EDITABLE option, you cannot set this preference in Installation Manager.

Rollback keys Value Notes
com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts True or False When this preference is set to True, the files that are required to roll the package back to a previous version are stored on your computer. Change this preference to false to disable it. When this preference is set to false, these files are not stored. If you do not store these files, you must connect to your original repository or media to roll back.

Click File > Preferences > Files for Rollback to check Save files for rollback in Installation Manager.

com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts_EDITABLE True or False When this preference is set to true, the Save files for rollback check box can be checked or cleared in theInstallation Manager interface. True is the default value. Change this preference to false to disable it.

With the _EDITABLE option included, you cannot set this preference in Installation Manager.

com.ibm.cic.common.core.preferences.directArtifactAccessMode True or False When this preference is set to false, before Installation Manager begins the installation process, all required installation files are downloaded to the shared repository location. The default setting is false. When this preference is set to true, Installation Manager accesses the installation files directly from the input repositories during the installation process instead of first downloading and verifying the files.

You cannot set this preference in Installation Manager.

Internet keys Value Notes
HTTP: com.ibm.cic.common.core.preferences.http.proxyEnabled True or False Use this preference to enable an HTTP or SOCKS proxy. After the proxy is enabled, the proxy will be used for all server communications. Proxy servers enable connection to remote servers from behind the firewall. False is the default value.

Click File > Preferences > Internet > HTTP Proxy to set the Enable proxy server field in Installation Manager.

HTTP: com.ibm.cic.common.core.preferences.http.proxyUseSocks True or False False is the default value. Set to true to define a SOCKS proxy.

com.ibm.cic.common.core.preferences.http.proxyEnabled must be set to true to define com.ibm.cic.common.core.preferences.http.proxyUseSocks.

HTTP: com.ibm.cic.common.core.preferences.http.proxyHost Host name or IP address Click File > Preferences > Internet > HTTP Proxy to set the Proxy host field in Installation Manager.
HTTP: com.ibm.cic.common.core.preferences.http.proxyPort Port number Click File > Preferences > Internet > HTTP Proxy to set the Proxy port field in Installation Manager.
HTTP: com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.http Host name or IP address To use different proxy settings for HTTP and HTTPS servers, set the HTTP proxy server using this HTTP preference. For HTTPS, use the com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.https key to define the HTTPS proxy server. This key overrides the com.ibm.cic.common.core.preferences.http.proxyHost key, if that key is defined.

You cannot set this preference in Installation Manager.

HTTP: com.ibm.cic.common.core.preferences.HTTP11.proxyPort.for.http Port number Use this key only when com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.http is defined.

You cannot set this preference in Installation Manager.

HTTP: com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication True or False False is the default value.

You cannot set this preference in Installation Manager.

HTTPS: com.ibm.cic.common.core.preferences.https.proxyEnabled True or False When set to false or if the value is not defined, the HTTP settings are used for HTTPS access. False is the default value. When set to true, you can use different proxy settings for HTTP and HTTPS servers.

You cannot set this preference in Installation Manager.

HTTPS: com.ibm.cic.common. core.preferences.https. proxyUseSocks True or False False is the default value. When set to true, the specified SOCKS proxy uses com.ibm.cic.common.core.preferences.SOCKS.proxyHost and com.ibm.cic.common.core.preferences.SOCKS.proxyPort for connections.
HTTPS: com.ibm.cic.common.core.preferences.ssl.nonsecureMode True or False When set to true Nonsecure SSL Mode is enabled and is set to permanent by default. You cannot enable Nonsecure SSL Mode with the session setting in a response file.
When set to false, Nonsecure SSL Mode is disabled.
Note: If you start Installation Manager and use a nonsecure SSL repository location, you are prompted to either remain in the secure mode or switch to a nonsecure mode. The nonsecure mode can be either permanent or for the current session only. You can switch to the nonsecure mode even if this preference is set to false. The Permanent and Sessions options that are available in Installation Manager do not have a preference key.

In Installation Manager, you have the Permanent and Sessions options. When Permanent is checked, Nonsecure SSL Mode remains enabled the next time you start Installation Manager. When the Session option is checked, Nonsecure SSL Mode is enabled only for this session.

Click File > Preferences > Internet to set the Nonsecure SSL Mode field in Installation Manager.

HTTPScom.ibm.cic.common.core.preferences.ssl.nonsecureMode_EDITABLE True or False When set to false, the Nonsecure SSL Mode option is disabled in Installation Manager. True is the default value.

You cannot set this preference in Installation Manager.

HTTPS: com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.https Host name or IP address To use different proxy settings for HTTP and HTTPS servers, set the HTTPS proxy server using this preference. For HTTP, use com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.http to define the HTTP proxy server. This key overrides the com.ibm.cic.common.core.preferences.http.proxyHost key, if that key is defined. This key is used only when the com.ibm.cic.common.core.preferences.https.proxyEnabled key is defined.

You cannot set this preference in Installation Manager.

HTTPS:com.ibm.cic.common.core.preferences.HTTP11.proxyPort.for.https Port number This key overrides the com.ibm.cic.common.core.preferences.http.proxyPort key, if that key is defined. This key is used only when the com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.https key is defined.

You cannot set this preference in Installation Manager.

FTP: com.ibm.cic.common.core.preferences.ftp.proxyEnabled True or False False is the default value. When set to true, the specified SOCKS proxy uses com.ibm.cic.common.core.preferences.SOCKS.proxyHost and com.ibm.cic.common.core.preferences.SOCKS.proxyPort for FTP connections.

Click File > Preferences > Internet > FTP Proxy to set the SOCKS proxy host field in Installation Manager.

FTP: com.ibm.cic.common.core.preferences.SOCKS.proxyHost Host name or IP address Click File > Preferences > Internet > FTP Proxy to set the Enable proxy server field in Installation Manager.
FTP: com.ibm.cic.common.core.preferences.SOCKS.proxyPort Port number Click File > Preferences > Internet > FTP Proxy to set the SOCKS proxy port field in Installation Manager.
For Linux,:

http.ntlm.auth.kind

Specifies the type of authentication scheme used.

Values: LM, NTLM, or NTLMv2

NTLM is the default value.
Definition of values:
  • LM - LANMANAGER authentication is used
  • NTLM - NTLM version 1 authentication is used
  • NTLMv2 - NTLM versions 2 authentication is used.

You cannot set this preference in Installation Manager.

Note: Authentication schemes for Windows™ are configured using the registry key LMCompatibilityLevel.

Updates keys Value Notes
com.ibm.cic.common.core.preferences.searchForUpdates True or False When this preference is set to true, a search for updates is performed first when running a silent installation. The default is false.
Click File > Preferences > Updates to set the Search for Installation Manager updates field in Installation Manager.
Note: When the preference is set to false and the HCL product that you are installing requires a newer version of Installation Manager, a message shows when you run the silent installation. The message indicates that a later version of Installation Manager is required. The silent installation does not continue.
com.ibm.cic.common.core.preferences.searchForUpdates_EDITABLE True or False When set to true, the Search for Installation Manager updates preference cannot be checked or cleared. True is the default value.

You cannot set this preference in Installation Manager.

Other keys Value Notes
com.ibm.cic.common.core.preferences.logLocation This key specifies the location of Installation Manager log file.
Important: This key is optional and is designed for testing and debugging. If you do not specify a location for the log file, both silent installations and installations using the Installation Manager GUI use the same location.

You cannot set this preference in Installation Manager.

com.ibm.cic.license.policy.location Use this key to specify a URL that defines the location of the remote license policy file.

You cannot set this preference in Installation Manager.

com.ibm.cic.common.core.preferences.eclipseCache The product you are installing provides the default value for this preference. This key specifies the location of the shared resources directory. The shared resource directory is specified the first time you install a package. You cannot change this location if you have already installed a package.

This preference is set during the installation process when you use the Installation Manager GUI.

com.ibm.cic.common.core.preferences.http.enableGzipAcceptEncoding True or False When the preference is set to true or when the preference is not in the response file, a request is issued for a repository.xml file over HTTP or HTTPS that includes an Accept-Encoding:gzip request header. The default value for this preference is false.

When set to false, the request does not include the Accept-Encoding:gzip request header.

You cannot set this preference in Installation Manager.

com.ibm.cic.common.core.preferences.connectTimeout Number The default value is 30 seconds.

You cannot set this preference in Installation Manager.

com.ibm.cic.common.core.preferences.readTimeout Number The default value is 30 seconds.

You cannot set this preference in Installation Manager.

com.ibm.cic.common.core.preferences.downloadAutoRetryCount Number The default value is 0.

You cannot set this preference in Installation Manager.

com.ibm.cic.common.core.preferences.import.enabled True or False When the preference is set to true the Import wizard shows in Installation Manager. The default value for this preference is false.
Attention: The Import wizard is used only with IBM® WebSphere® products

You cannot set this preference in Installation Manager.