Install packages using imcl commands

Install packages or updates from the tools directory using install command. To identify the package ID, version, and feature ID; run the listAvailablePackages command. See:

If we use repositories that require authentication, create a storage file. 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 versions 1.6.1 and earlier, use the -keyring option. Some packages require entitlement for versions or fixes. If we are not entitled for an update, the update is not installed during the installation process. Entitlement is based on your IBM ID credentials. Some Installation Manager features might or might not be supported by packages. Check the package documentation to determine whether a feature is supported.

Procedure

  1. Open a command-line utility.

  2. Open the tools directory.

  3. Run the installation command:

      imcl install packageID[_version][,featureID]
          -repositories source_repository
          -acceptLicense
          -installationDirectory installation_directory
          [ -eclipselocation eclipse_directory ]
          [ -installFixes none|recommended|all ]
          [ -secureStorageFile storage_file -masterPasswordFile master_password_file | -keyring keyring_file [ -password password ] ]
          [ -sharedResourcesDirectory shared_directory ]
          [ -preferences preference_key=value ]
          [ -properties key_1=value_1a,,value_1b,key_2=value_2 ]

    Enclose file paths that include spaces with double quotation marks.


Example

Operating system Administrator Nonadministrator Group
Windows imcl.exe install com.ibm.package_7.1
-repositories http://repository/package/7.1/repository.config
-installationDirectory installation_dir\Package
-secureStorageFile C:\credential.store
-masterPasswordFile C:\master_password_file.txt
-acceptLicense
imcl.exe install com.ibm.package_7.1
-repositories http://repository/package/7.1/repository.config
-installationDirectory user_home\Package
-secureStorageFile C:\credential.store
-masterPasswordFile C:\master_password_file.txt
-acceptLicense
Not available
UNIX ./imcl install com.ibm.package_7.1
-repositories http://repository/package/7.1/repository.config
-installationDirectory installation_dir/Package
-secureStorageFile /var/credential.store
-masterPasswordFile /var/master_password_file.txt
-acceptLicense
./imcl install com.ibm.package_7.1
-repositories http://repository/package/7.1/repository.config
-installationDirectory user_home/Package
-secureStorageFile user_home /credential.store
-masterPasswordFile /user_home/master_password_file.txt
-acceptLicense
./imcl install com.ibm.package_7.1
-repositories http://repository/package/7.1/repository.config
-installationDirectory user_home/Package_Group
-secureStorageFile user_home/credential.store
-masterPasswordFile /user_home/master_password_file.txt

Group mode is not supported on IBM i.


Install packages silently using imcl with a response file

Install packages or updates silently from the tools directory using imcl commands with a response file.

Create a response file with the specifications for your installation.

If we use repositories that require authentication, create a storage file. Starting in version 1.6.2, 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 versions 1.6.1 and earlier, use the -keyring option.

Procedure

  1. Open a command-line utility.

  2. Open the tools directory.

  3. Run the installation command:

      imcl input response_file_path_and_name
          [ -secureStorageFile storage_file -masterPasswordFile master_password_file | -keyring keyring_file [ -password password ] ]
          [ -log log_file_path_and_name ]
          [ -acceptLicense ]


Example

Operating system Command
Windows imcl input c:\response_files\install_product.xml
    -secureStorageFile C:\credential.store
    -masterPasswordFile C:\master_password_file.txt
    -log c:\mylog\silent_install_log.xml
    -acceptLicense
UNIX ./imcl input /response_files/install_product.xml
    -secureStorageFile /var/credential.store
    -masterPasswordFile /var/master_password_file.txt
    -log /mylog/silent_install_log.xml
    -acceptLicense

Home