Installing fix packs

IBM® provides interim maintenance packages that contain updates to one or more components in your IBM Cognos® product.

If a fix pack becomes available after your IBM Cognos product has been deployed, you must stop the service, install the fix pack in the same location as the IBM Cognos BI components, and then start the service.

Fix packs are available for download from IBM Support at http://www.ibm.com/support/us/en/.

Important: Fix packs are not standalone installations. You must install them on computers that have IBM Cognos BI server components installed. Install the fix pack or packs that are appropriate for your product version. To check your version, open the component list file at ccr_location\cmplst.txt and check the line that starts with C8BISRVR_version=.

Before you begin

Before you install the fix pack, create a backup of the content store database. In addition, back up any customized files from the current installation.

Important: You must also download and install the Microsoft WebView2 Runtime. For more information, go to the Microsoft web page Download the WebView2 Runtime (https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download-section).

Procedure

  1. Stop the following services:
    • Internet Information Services (IIS) Manager (the Default Web Site)
    • IBM Cognos Controller Consolidation
  2. Delete all instances of the workarea folder from your existing Controller installation.
    Important: By deleting this folder, you remove any cached instances of log4j-1.2.17.jar or log4j-1.2.5.jar files. These are obsolete files that may contain security vulnerabilities. When you install Fix Pack 1 or later, log4j files are installed that meet all security requirements.
    1. Go to the folder C:\Program Files\ibm\cognos\ccr_64
    2. Search recursively for all instances of the subfolder workarea.
    3. Delete all instances of the workarea folder that appear in the search results.
  3. Back up the content store database.
  4. If your IBM Cognos BI environment is customized, back up the entire IBM Cognos BI location.
  5. Insert the disk for the Microsoft Windows operating system fix pack or go to the location where you downloaded and extracted the files.

    If more than one fix pack is available, install the fix pack with the lowest version number first.

  6. On the disk or in the download location, go to the win32 directory and double-click the issetup.exe file.
  7. Follow the directions in the installation wizard, installing in the same location as your existing IBM Cognos BI server components.

    The issetup program prompts you to allow the fix pack to create a backup copy in the installation folder before copying new files.

  8. If an updater is available, do the following:
    • To install from a disk, insert the updater disk for the Windows operating system.
    • To install from a download, follow the instructions on the support site and then go to the location where you downloaded and extracted the files.
    • In the updater directory on the disk or download location, go to the win32 directory and double-click the issetup.exe file.
    • Follow the directions in the installation wizard.
  9. Upgrade your Controller application databases.
  10. To return a deployed IBM Cognos BI product to service, open IBM Cognos Configuration, save the configuration, and then start the IBM Cognos service.
  11. If you have a distributed environment, repeat these steps for all remaining IBM Cognos BI servers.
  12. If you are running the IBM Cognos BI product on an application server other than the default, IBM WebSphere, redeploy the IBM Cognos BI product to the application server.
  13. Start the Internet Information Services (IIS) Manager (the Default Web Site).
  14. Start the IBM Cognos Controller Consolidation service.