Installing Liberty interim fixes on IBM i operating systems using the command line

Interim fixes provide corrective service for specific known problems. You can use the IBM® Installation Manager command-line function to update the offering with the fixes that are available for your service level of WebSphere® Application Server Liberty for IBM i.

Before you begin

Contact the IBM Software Support Center for information about updates for WebSphere Application Server Liberty for IBM i. The most current information is available from the IBM Software Support Center and Fix Central.

IBM Installation Manager Version 1.8.5 or later is used to apply maintenance to WebSphere Application Server Liberty for IBM i.

Through version 19.0.0.8, the minimum acceptable version of IBM Installation Manager is 1.8.5.

As of version 19.0.0.9, the minimum acceptable version of IBM Installation Manager is 1.9.0.

About this task

Use this procedure whenever you want to apply a new interim fix to your system.
Tip: You can also install interim fixes using silent response files with Installation Manager. For information on creating and using response files, read the IBM Installation Manager product documentation.

Procedure

  1. For a list of interim fixes that are available for WebSphere Application Server Liberty for IBM i and specific information about each interim fix, perform the following actions.
    1. Go to Fix Central.
    2. Click Find product.
    3. Select WebSphere Liberty as the product group.
    4. Select the version of the product to be updated.
    5. Select IBM i as the platform, and click Continue.
    6. Select Browse for fixes, and click Continue.
    7. Click More Information under each fix to view information about the fix.
  2. Update WebSphere Application Server Liberty for IBM i with the interim fixes using one of the following procedures.
    • Access the live service repository that contains the fixes, and use web-based updating.
      Use Installation Manager on your local system to update WebSphere Application Server Liberty for IBM i with the interim fixes from the live web-based service repositories.
      • For the live service repositories, use the same URLs as those used for the generally available product-offering repositories during installation. These URLs are listed in Online product repositories for Liberty offerings.
      • These locations do not contain web pages that you can access using a web browser. They are remote web-based repository locations that you specify for Installation Manager so that it can maintain the offering.
      To install an interim fix from a service repository, perform the following actions:
      1. If you do not already have Installation Manager credential-storage and master-password files containing your IBM software user ID and password, create files that will allow you to access the repository.
        Note: These are the credentials that you use to access protected IBM software websites.
        Tip: When creating a credential-storage file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the URL that is specified.
      2. Sign on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
      3. Stop all servers and applications on the WebSphere Application Server Liberty for IBM i installation that is being updated.
      4. On a CL command line, run the STRQSH command to start the Qshell command shell.
      5. Make sure that the umask is set to 022.
        To verify the umask setting, issue the following command:
        umask
        To set the umask setting to 022, issue the following command:
        umask 022
      6. Change to the Installation_Manager_binaries/eclipse/tools directory, where Installation_Manager_binaries is the installation root directory for the Installation Manager.

        On IBM i systems, the root directory for the Installation Manager is /QIBM/ProdData/InstallationManager.

      7. Install the interim fix.
        ./imcl install interim_fix_name
          -installationDirectory offering_installation_location
          -repositories repository_URL_or_path
          -secureStorageFile storage_file -masterPasswordFile master_password_file
      8. Optional: List all installed packages to verify the installation:
        ./imcl listInstalledPackages -long
    • Download the files that contain the fixes from Fix Central, and use local updating.
      You can download compressed files that contain the fixes from Fix Central. Each compressed fix file contains an Installation Manager repository for the fix and usually has a .zip extension. After downloading the fix files, you can use Installation Manager to update WebSphere Application Server Liberty for IBM i with the interim fixes.
      1. To download the interim fixes, perform the following actions:
        1. Go to Fix Central.
        2. Select WebSphere as the product group.
        3. Select the product.
        4. Select the version of the offering to be updated.
        5. Select your operating system as the platform, and click Continue.
        6. Select Browse for fixes, and click Continue.
        7. Select the interim fixes that you want to download, and click Continue.
        8. Select your download options, and click Continue.
        9. Click I agree to agree to the terms and conditions.
        10. Click Download now to download the interim fixes.
        11. Transfer the compressed fix files in binary format to the IBM i system on which they will be installed.
      2. To install an interim fix from a downloaded file, perform the following actions:
        1. Sign on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
        2. Stop all servers and applications on the WebSphere Application Server Liberty for IBM i installation that is being updated.
        3. On a CL command line, run the STRQSH command to start the Qshell command shell.
        4. Make sure that the umask is set to 022.
          To verify the umask setting, issue the following command:
          umask
          To set the umask setting to 022, issue the following command:
          umask 022
        5. Change to the Installation_Manager_binaries/eclipse/tools directory, where Installation_Manager_binaries is the installation root directory for the Installation Manager.

          On IBM i systems, the root directory for the Installation Manager is /QIBM/ProdData/InstallationManager.

        6. Install the interim fix.
          ./imcl install interim_fix_name 
             -installationDirectory offering_installation_location
             -repositories compressed_file
        7. Optional: List all installed packages to verify the installation:
          ./imcl listInstalledPackages -long