Upgrading Cognos

Upgrade the version of Cognos® that you use with Device Management Enablement. However, if you are moving to IBM® Intelligent Operations Center V5.2.1, which requires Red Hat Enterprise Linux V7.6 or later, you must do a new installation of IBM Intelligent Operations Center and Cognos.

Before you begin

Ensure that the steps to upgrade Device Management Enablement are completed successfully. For more information, see Installing or upgrading Device Management Enablement.
Ensure that WebSphere® Application Server Liberty Profile is running on each server. For more information about starting WebSphere Application Server Liberty Profile, see Restarting the WebSphere Application Server Liberty Profile server.
Ensure that your ioc.install.properties file is up-to-date as these property settings are also used during the Cognos upgrade.

About this task

You cannot use the following procedure to upgrade your Cognos version if you are moving to IBM Intelligent Operations Center V5.2.1. Instead, you must do a new installation of IBM Intelligent Operations Center V5.2.1 on an environment that is running Red Hat Enterprise Linux V7.6 or later, and then do a new installation of Cognos. For more information about installing Cognos, see Installing Cognos.

Procedure

Copy the Cognos installation file, ca_srv_linuxi38664_11.0.12.18101713.bin, into the directory /installmedia/linux_x64 on the analytics server.

Making a backup of your existing reports

Save your existing reports.
- If you are upgrading from Cognos version 10 to version 11, see the instructions in the Creating a deployment archive topic in the Cognos Analytics product documentation. For example, if you are upgrading from Cognos V10.2.2, see Business Intelligence 10.2.2 product documentation: Creating a deployment archive.
- If you are upgrading from Cognos V11.0.9 to V11.0.12, see Cognos Analytics 11.0.x product documentation: Creating a deployment archive.
The exported reports are then available in a .zip file in the cognos_install_dir/deployment directory on the analytics server, where cognos_install_dir is the Cognos installation directory.
Move the .zip file to a safe location.

Stopping the Cognos server

Log on to the analytics server as a root user and open a terminal window.
If you are upgrading from Cognos version 10, run the following commands, where cognos_install_dir is the installation directory that is defined by the cognos.install.location property in the cognos.properties file, and the ioc_user user is defined by the ioc.user property in the ioc.install.properties file:
```
su - ioc_user -c "cognos_install_dir/wlp/bin/server stop servletgateway"
su - ioc_user -c "cognos_install_dir/wlp/bin/server stop cognosserver"
```
For example,
```
su - iocadmin -c "/opt/ibm/cognos/analytics/wlp/bin/server stop servletgateway"
su - iocadmin -c "/opt/ibm/cognos/analytics/wlp/bin/server stop cognosserver"
```

If you are upgrading from Cognos version 11, run the following commands:

su - ioc_user -c "cognos_install_dir/wlp/bin/server stop dataset-service"
su - ioc_user -c "cognos_install_dir/wlp/bin/server stop cognosserver"

For example,

su - iocadmin -c "/opt/ibm/cognos/analytics/wlp/bin/server stop dataset-service"
su - iocadmin -c "/opt/ibm/cognos/analytics/wlp/bin/server stop cognosserver"

Upgrading Cognos

Make a backup of your existing installation directory. For example, if your installation directory is /opt/ibm/cognos/analytics run the following command:
```
mv /opt/ibm/cognos/analytics /opt/ibm/cognos/analytics1109/
```
Run the following command to ensure that the ca_srv_linuxi38664_11.0.12.18101713.bin has the correct permissions:
```
chmod 755 /installmedia/linux_x64/ca_srv_linuxi38664_11.0.12.18101713.bin
```
Edit the /opt/IBM/ioc_install/cfg/cognos.properties file.
1. Ensure that the values for the following properties are correct:
  - cognos.install.server.ana: The fully qualified domain name of the analytics server.
  - cognos.install.server.dat: The fully qualified domain name of the data server.
  - cognos.install.location: The directory to install Cognos to.
  - existing.install.location: The directory for the existing Cognos installation.
  - cognos.image.file: The name of the Cognos image file.
  - cognos.image.location: The directory that contains the Cognos image file.
2. Ensure that the values for the following properties are different from the values of these properties for your existing installation:
  - cognos.ssl.extracted.cert.label.disptach
  - cognos.ssl.extracted.cert.label.gateway
  - cognos.ssl.ihs.cert.name
  - cognos.db.content.db
  - cognos.db.log.db
3. Update the following LDAP properties to match your LDAP configuration:
```
#*****************************
# LDAP properties *
#*****************************
cognos.ldap.host =  # hostname, where LDAP is running
cognos.ldap.port = # port on which the LDAP service listens
cognos.ldap.credential.username =  # LDAP admin user
cognos.ldap.credential.password = # LDAP admin user's password
cognos.ldap.base.dn = # LDAP base DN
cognos.ldap.user.lookup = # LDAP user DN
```
Run the following commands, where the ioc_installer user is defined by the ioc.install.user property in the ioc.install.properties file:
```
su - ioc_installer
cd /opt/IBM/ioc_install/bin
sudo ./ioc.server.install.sh -p 4.ana.cognos.all
```

Importing your reports

To import your saved reports to Cognos V11, complete the following steps:
1. As the ioc_user user, copy the .zip file that you created to the cognos_install_dir/deployment directory on the analytics server. For example, as the iocadmin user, copy the file to the /opt/ibm/cognos/analytics/deployment directory.
2. To import your saved reports, see the following topics:
  1. Cognos Analytics 11.0.x product documentation: Including configuration objects when you import a deployment archive of the entire content store.
  2. Cognos Analytics 11.0.x product documentation: Importing a deployment archive.