Updating the Cognos® server with fix packs

Apply available fix packs to the Cognos® Business Intelligence server to provide important product corrections.

About this task

Download the latest fix pack and apply it to the Cognos® server. Fix packs are cumulative; when you install the latest fix pack, it includes updates from all previous fix packs.

Note: If the latest available Cognos fix packs have been applied during installation, you do not need to do so again at this time. If some fix packs come out later, you can follow this procedure to apply them.

Procedure

  1. Stop IBM® WebSphere® Application Server and verify that all Cognos® services have stopped before proceeding to the next step.
    After stopping the server, wait at least 1 full minute to ensure that all Cognos® processes have stopped:
    • AIX® or Linux: cgsServer.sh and CAM_LPSvr processes
    • Windows: cgsLauncher.exe and CAM_LPSvr processes
  2. Download fix packs for Cognos® Business Intelligence from IBM® Fix Central.
    1. Review the fix pack prerequisites and make sure your deployment satisfies all requirements.
    2. Download the appropriate compressed tar file for your operating system using the links in the "Download Package" section.

      Some browsers might change a downloaded file's type from .tar.gz to a file type not recognized by the operating system. To correct this, change the file type back to .tar.gz after the download is complete. Using Download Director will prevent inadvertent renaming of files at download.

  3. Expand the downloaded fix pack.
    IBM® AIX® or Linux
    1. Open command prompt or terminal window.
    2. Change to the directory where you have downloaded the fix pack.
    3. Run the following command to expand the package using either GNU Zip (gzip) or GNU Tar (tar):
      gunzip fix_pack_file_name.tar.gz | tar xvf - 
    Microsoft Windows
    1. Open a command prompt.
    2. Change to the directory where you have downloaded the fix pack.
    3. Expand the package using your file compress and decompress utility (if you are using WinZip, select the option "Use folder names" to retain the package's folder structure).
  4. Apply the fix pack:

    AIX® or Linux:

    1. Change to the directory where you expanded the fix pack.
    2. Now change to the following subdirectory:
      • AIX®: /aix64h
      • Linux: /linuxi38664h
      • zLinux: /zlinux64h
    3. Run the following command: ./issetup

      If you do not use XWindow, run an unattended installation as explained in Set Up an Unattended Installation Using a File From an Installation on Another Computer in the Cognos® information center.

    4. Follow the instructions in the installation wizard, install the fix pack in the same location as your existing IBM® Cognos® components.

      This installation location is the path specified for the cognos.biserver.install.path property in the cognos-setup.properties file.

    Windows:

    1. Change to the directory where you expanded the fix pack.
    2. Now change to the \win64h subdirectory.
    3. Run the following command: issetup.exe
    4. Follow the instructions in the installation wizard, install the fix pack in the same location as your existing IBM® Cognos® components.

      This installation location is the path specified for the cognos.biserver.install.path property in the cognos-setup.properties file.

  5. Generate a new Cognos® BI Server EAR file with the fix pack:
    1. Locate the cognos-setup-update.sh|bat script in the directory where you expanded the CognosConfig.zip or CognosConfig.tar when you installed Cognos® Business Intelligence components as part of the pre-install task.
    2. Edit the cognos-setup.properties file and verify that it contains the appropriate values for each property.

      All passwords were removed from this file that last time it was used, so you must either add the passwords again, or pass them in from the command line when you run the cognos-setup-update.sh|bat script in the next step.

    3. Run the cognos-setup-update.sh|bat script.
  6. Use the IBM® WebSphere® Integrated Solutions Console to apply the new EAR file to the Cognos® server:
    1. On the Deployment Manager, log in to the Integrated Solutions Console as the WebSphere® administrator.
    2. Click Servers > Enterprise Applications.
    3. In the list of applications, select the Cognos® where you generated the new EAR file, and click the Update button in the table.
    4. Browse to the newly built EAR file residing in the Cognos_BI_Server_install_path directory, and click Next.
    5. Complete the remaining screens by accepting the default values and clicking Next.
    6. Click Finish to complete the update.
  7. Update the Cognos® server configuration as follows:
    1. Start the Cognos server. Verify that all processes are started by accessing the Cognos BI dispatch URL. If startup is complete, the Public Folders directory is present.
    2. Locate the cognos-configure-update.sh|bat script in the directory where you expanded the CognosConfig.zip|tar file when you installed Cognos Business Intelligence components.
    3. Edit the cognos-setup.properties file and verify that it contains the appropriate values for each property.
      All passwords were removed from this file the last time that it was used, so you must either add the passwords again, or pass them in from the command line when you run the cognos-configure-update.sh|bat script.
    4. Run the cognos-configure-update.sh|bat script.

    Output from this operation is stored in the /CognosSetup/cognos-configure.log file.

    Attention: If you encounter an error when running the cognos-configure-update.sh|bat script, correct the error and run the script again before proceeding to the next task.
  8. Start WebSphere® Application Server and Cognos®.

Results

For additional information on updating Cognos® Business Intelligence with fix packs, see Installing Fix Packs in the Cognos® information center.