Install packages silently from authenticated repositories using the installer

We can silently install from an authenticated repository. However, authenticated repositories require credentials for access.

In the same directory as the installation command, Installation Manager checks for a file that has the same name and the .ini extension. For example, if installc is the command, Installation Manager checks for installc.ini. If the .ini file contains the input command, the install command does not work. Before we run the command, remove two lines from the .ini file: the line that includes the input command and the line that points to the response file. An example of the two lines to remove:

input
@osgi.install.area\install.xml

The -keyring and -password options that are used to store credentials to a key ring file are deprecated. Use the -secureStorageFile and -masterPasswordFile options to store credentials to a credential file. For more information, see Migrate from key ring files to storage files. For versions 1.6.1 and earlier, use the -keyring option. For more information, see Store credentials in a key ring file.

If we are storing credentials for a service repository, we must have an IBM user name and password. To register for an IBM user name and password, go to: http://www.ibm.com/account/profile. For information about service repositories, see Search service repositories.

Authenticated repositories are repositories that are in a location that require credentials. The authentication requirements are set by your company administrators. Installation Manager saves credentials that are required for authentication but does not configure the authentication requirements.

If we use a key ring file and share an instance of Installation Manager with other users, see Save credentials in a key ring file when we share an instance of Installation Manager.

Procedure

To access authenticated repositories in silent mode:

  1. From a command line, switch to the directory that contains the extracted installation kit for Installation Manager. Switch to the InstallerImage_platform subdirectory if we are using the installer included with your IBM product.
  2. From the command line, open the tools directory.

  3. Run the command: 
    imutilsc saveCredential   
	-url address | -passportAdvantage 
	-userName user_name -userPassword password 
	-secureStorageFile storage_file -masterPasswordFile master_password_file | -keyring keyring_file [-password password ]  
	[ -preferences com.ibm.cic.common.core.preferences.ssl.nonsecureMode=true|false ]
	[ -proxyHost proxy_host -proxyPort proxy_port
		[ -proxyUsername proxy_user_name 
		  -proxyUserPassword proxy_user_password ]
 		[ -useSocks ] ]   
	[ -verbose ]

    • Do not use -url and -passportAdvantage in the same command.

    • If we use the -keyring option and we want to require authentication for the key ring file when referenced in another command, we must include a password for the file.

    • We can specify the location of the storage file or key ring by including a file path in the name. If a file path is not included, a default location is used.

    • If we use the IBM service repositories, we can specify the http://www.ibm.com/software/repositorymanager/com.ibm.cic.agent/repository.xml value for the -url option. This value is a generic service repository that can be used for IBM packages.

    • Enclose file paths that include spaces with double quotation marks.

    • We can specify only the com.ibm.cic.common.core.preferences.ssl.nonsecureMode preference key for the -preferences option. See Silent installation preference keys. The default value for the preference key is false.
  4. Repeat to store the credentials for multiple URLs in one storage file.
  5. Return to the main installation files directory.

  6. Run the installation command:

    • If we use the-keyring option, we must include a password with the install command when the key ring file requires authentication.

    • Enclose file paths that include spaces with double quotation marks.

    Operating system Administrator Nonadministrator Group
    Windows installc.exe input response_file -secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt -acceptLicense userinstc.exe input response_file -secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt -acceptLicense Not available.
    UNIX ./installc input response_file -secureStorageFile /var/credential.store -masterPasswordFile /var/master_password_file.txt -acceptLicense ./userinstc input response_file -secureStorageFile user_home /credential.store -masterPasswordFile /user_home/master_password_file.txt -acceptLicense Not supported.
Home