Upgrading Cognos

Upgrade to a supported version of Cognos® Analytics.

1. Log on to the reporting server as a user with administrative privileges.
2. Stop all Cognos services.
3. Upgrade Cognos Analytics. See Upgrading your current version of Cognos Analytics 11.
4. Locate the bcprov-jdk15to18-1.68.jar file.
   The file is available on each application server in the <OP_HOME>/temp/jre/lib/ext/ directory.
5. If the Cognos software is using the JRE that is installed with Cognos, do the following steps:
   1. Copy the bcprov-jdk15to18-1.68.jar file to the <COGNOS_HOME>/analytics/jre/lib/ext directory.
      Note: If you are using Cognos Analytics 11.1.5 or later, copy the file to <COGNOS_HOME>/analytics/ibm-jre/lib/ext.
   2. Register the BouncyCastleProvider in the JRE master security provider file, if it is not already registered.
      To register the provider, add the following line to the java.security file that is stored in the <COGNOS_HOME>/analytics/jre/lib/security directory.

      security.provider.<#>=
          org.bouncycastle.jce.provider.BouncyCastleProvider

      Note: If you are using Cognos Analytics 11.1.5 or later, the java.security file is in the <COGNOS_HOME>/analytics/ibm-jre/lib/security directory.

      Where: The number sign, <#>, is one increment above the last number in the list. For example, security.provider.9.

6. If the Cognos software is using the JRE that is installed with IBM SDK, Java Technology Edition, do the following steps:
   1. Copy the bcprov-jdk15to18-1.68.jar file to the <JAVA_HOME>/lib/ext directory.
   2. Register the BouncyCastleProvider in the JRE master security provider file, if it is not already registered.
      To register the provider, add the following line to the java.security file that is stored in the <JAVA_HOME>/lib/security directory.

      security.provider.<#>=
          org.bouncycastle.jce.provider.BouncyCastleProvider

      Where: The number sign, <#>, is one increment above the last number in the list. For example, security.provider.9.

7. If the Cognos software is using a JRE that is installed in another location on the reporting server, do the following steps:

   Replace <JAVA_LOCATION> with the directory where the JRE is installed.

   1. Copy the bcprov-jdk15to18-1.68.jar file to the <JAVA_LOCATION>/lib/ext directory.
   2. Register the BouncyCastleProvider in the JRE master security provider file, if it is not already registered.
      To register the provider, add the following line to the java.security file that is stored in the <JAVA_LOCATION>/lib/security directory.

      security.provider.<#>=org.bouncycastle.jce.provider.BouncyCastleProvider

      Where: The number sign, <#>, is one increment above the last number in the list. For example, security.provider.9.

8. Restart the reporting servers.
9. If you upgraded to 11.1.5 or later and you are using the JRE that is installed with Cognos, you need to update the Java location.
   In Cognos Analytics 11.1.5 and later, the path is:

   • On Windows: C:\IBM\cognos\analytics\ibm-jre\jre
   • On Linux®: /usr/IBM/cognos/analytics/ibm-jre/jre

   For more information, see How to Change the Java Location on an OpenPages Reporting Server.

10. If you upgraded to 11.1.5 or later and you are using the JRE that is installed with Cognos, re-import the OpenPages SSL certificates into the Cognos JRE.
    For more information, see Importing the CA certificate for the Java Runtime Environment of Cognos Analytics.