Installing packages by using imcl commands

Install packages or updates from the tools directory by using install command.

Before you begin

To identify the package ID, version, and feature ID; run the listAvailablePackages command. See Listing available packages by using imcl commands.

If you 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 more information, see Migrate from key ring files to storage files. For versions 1.6.1 and earlier, you must use the -keyring option. For more information, see Storing credentials in a key ring file.

On IBM z/OS®, use the zCreateFileSystem.sh script to create and mount a file system for a product installation. Use the zMountFileSystem.sh script to mount an existing file system and set ownership and permissions before you apply service or add packages to an existing location. Both scripts are in the tools directory.

Some packages require entitlement for versions or fixes. If you are not entitled for an update, the update is not installed during the installation process. Entitlement is based on your IBM® ID credentials. For more information, see IBM ID credentials Help and FAQ. For more information about entitlement, see IBM Entitlement Help.

Some Installation Manager features might or might not be supported by packages. Check your package documentation to determine whether a feature is supported. For a list of features, see Installation Manager features.

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

Table 1. Examples of installation commands by operating system and mode
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_directory\Package -secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt -acceptLicense Not available
Linux®, UNIX, IBM i, z/OS, and the OS X operating system ./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_directory/Package -secureStorageFile user_home_directory /credential.store -masterPasswordFile /user_home_directory/master_password_file.txt -acceptLicense ./imcl install com.ibm.package_7.1 -repositories http://repository/package/7.1/repository.config -installationDirectory user_home_directory/Package_Group -secureStorageFile user_home_directory/credential.store -masterPasswordFile /user_home_directory/master_password_file.txt

Group mode is not supported on IBM i.

Installing packages silently by using imcl with a response file

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

Before you begin

Create a response file with the specifications for your installation. For more information about how to create a response file, see Response files.

If you 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 more information, see Migrate from key ring files to storage files. For versions 1.6.1 and earlier, you must use the -keyring option. For more information, see Storing credentials in a key ring file.

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 ]
    Enclose file paths that include spaces with double quotation marks.

Example

Table 2. Examples of installation commands by operating system
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
Linux, UNIX, IBM i, z/OS, and the OS X operating system ./imcl input /response_files/install_product.xml -secureStorageFile /var/credential.store -masterPasswordFile /var/master_password_file.txt -log /mylog/silent_install_log.xml -acceptLicense