Updating IBM Cognos BI

If you update IBM® Cognos® Business Intelligence or your Java Database Connectivity (JDBC) drivers, you must also regenerate the IBM Cognos BI enterprise archive (EAR) file. The deployed IBM Cognos BI service application must be updated with the new EAR file.

To update IBM Cognos BI and the EAR file, complete the following steps:

1. To update IBM Cognos BI:
   1. Obtain the IBM Cognos BI service compressed file (tar.gz) for the platform type of your node.
   2. Unpack the file into a working directory.
   3. Locate and run the issetup command. When prompted for the installation location, enter app_server_root/cognos.
      Tip: If you cannot run the graphical user interface of the update, or if you know that you do not have the MOTIF package installed, you must copy the silent installer from your existing IBM Cognos BI installation. Complete the following steps:

      1. Locate the following file in your existing IBM Cognos BI installation:

         app_server_root/cognos/uninstall/issetupnx

      2. Copy the file to the working directory of the new installer, placing it in the same directory as issetup.
      3. Update the file response.ats with the following values:

         I Agree=y
         APPDIR=app_server_root/cognos
         C8BISRVR_APP=1
         C8BISRVR_APPLICATION_TIER=1
         C8BISRVR_GATEWAY=1
         C8BISRVR_CONTENT_MANAGER=1
         C8BISRVR_CONTENT_DATABASE=1 

      4. Open a command prompt in the working directory and run:

         ./issetupnx -s

2. To update the EAR file after updating IBM Cognos BI, complete the following steps:
   1. If you have updated your JDBC drivers, you must apply the new version to IBM Cognos Business Intelligence as well as to IBM Business Monitor. Before regenerating the EAR file, apply the new version to IBM Cognos BI in the following directories:

      app_server_root/cognos/webapps/p2pd/WEB-INF/lib
      app_server_root/cognos/v5dataserver/lib

   2. On your deployment manager or stand-alone server, open a command prompt in app_server_root/cognos/war/p2pd.
   3. Run the following command:
      • build.bat ear
      • build.sh ear
      This command creates a WebSphere EAR file called p2pd.ear in the IBM Cognos BI root directory. Building the EAR file might take several minutes.
   4. On your deployment manager or stand-alone server, open the WebSphere administrative console and click Applications > Application type > WebSphere enterprise applications.
   5. Select the IBM Cognos check box and click Update.
   6. Under Specify the path to the replacement ear file, browse to the EAR file you created in Step c.
   7. Complete the steps in the Update wizard to update the application. After you click Finish, the update might take several minutes.
   8. Save your changes. Saving the new configuration might take several minutes.
   9. Restart the application servers that were updated with the new IBM Cognos BI EAR file.