IBM How to upgrade Controller 10.1.1.x to a later Interim Fix (IF) Fix Pack (patch) le...

Page 1 of 3

How to upgrade Controller 10.1.1.x to a later Interim Fix (IF) Fix Pack (patch) level

Document information
Cognos Controller Controller

Technote (troubleshooting) Problem(Abstract)

Customer has a working Controller 10.1.1.x application server. Customer would like to upgrade their server to a later patch level of 10.1.1 (for example 10.1 IF1 = 10.1.1306). How do they do this?

Software version: 10.1.1

Operating system(s): Windows

Symptom
For reference, here are some version numbers of Controller (click "Help System Info" in Controller, and check the top line): 10.1.1 RTM = 10.1.1305 10.1.1 IF1 = 10.1.1306

Reference #: 1602419

Modified date: 2012-07-13

Cause
It is possible to patch the Controller application server *without* having to perform a full uninstall/re-install of the Controller application server software. However, care needs to be taken (during the patching process) to ensure that all Controller-related services/systems/components are stopped.

Environment
Controller 10.1.1 RTM (also known as Controller 10.1.1305) or later Interim Fix (IF) release.

Resolving the problem

Perform the following tasks: 1. Download a copy of the latest Interim Fix (IF) patch. TIP: You will need to log a support call with IBM Support to obtain a copy of most IF patches. 2. Obtain downtime (no users on system) 3. As a precaution, backup all Controller-related databases (application repositories, ContentStore and FAP) 4. As a precaution, launch "Cognos Configuration" and create a backup of all the settings (e.g. export to an XML file and/or create a Word document with printscreens of all the current settings). 5. As a precaution, launch "Controller Configuration" and create a backup of all the settings (e.g. create a Word document with printscreens of all the current settings). 6. VITAL: Shut down all Controller-related services/components on

http://www-01.ibm.com/support/docview.wss?uid=swg21602419&myns=swgimgmt&... 16/7/2012

IBM How to upgrade Controller 10.1.1.x to a later Interim Fix (IF) Fix Pack (patch) le... Page 2 of 3

application server(s) (see later for list of these) 7. As a precaution, take a backup copy of the entire c10 folder (e.g. compress inside a backup ZIP file) 8. Install IF patch onto Controller 10.1 application server(s) by launching ...Win32\issetup.exe and following the installation wizard 9. Afterwards, launch "Controller Configuration" and check that all settings look the same as before the upgrade. Most importantly, open section "Report Server". Replace all references saying "http://localhost/...." to "http://<servername>/...." where <servername> is the same name that was used before the upgrade process was run. TIP: Take care to use the same naming convention (NetBIOS or FQDN) that was used before the upgrade. Refer to your printscreen backups that you made in step (5). 10. If used ISAPI before upgrade, then change "Report Server" to mention cognosisapi.dll instead of cognos.cgi 11. If using ISAPI before the upgrade, then modify the files "default.htm" and "index.html" (located in webcontent folder) to refer to cognosisapi.dll instead of cognos.cgi 12. Check the Windows service "IBM Cognos Controller Java Proxy". Ensure that it is configured to 'Log On As' using the correct Windows user (typically the COM+ user e.g. <domain>\Controller_system).

14. Inside the IIS Manager, start the Default Web Site 15. Afterwards, reboot Controller 10.1 application server(s) (to automatically start relevant services) 16. Upgrade client software on each-and-every end-user's client device. More detail on above Steps (Step 6) How to shut down all Controller-related services on application server(s) Stop the following services: IBM Cognos service IBM Cognos Controller Batch Server IBM Cognos Controller Java Proxy IBM Cognos Controller User Manager IBM Cognos FAP Service Internet Information Services (IIS) Manager (the Default Web Site) Components Services IBMCOGNOSCONTROLLER and any other Controller-related COM+ application (e.g. "COGNOSVFP" or "IBMCOGNOSVFP") (Step 8) How to Patch Controller 10.1.1 application server(s) 1. Extract the compressed patch file (for example IF1 = up_cntrl_win32_10.1.6235.100_ml.tar.gz) 2. Double-click on installer file issetup.exe (in subfolder win32). 3. If the Controller database version has increased (with the new IF) then use the Database Conversion utility to upgrade your Controller

http://www-01.ibm.com/support/docview.wss?uid=swg21602419&myns=swgimgmt&... 16/7/2012

IBM How to upgrade Controller 10.1.1.x to a later Interim Fix (IF) Fix Pack (patch) le... Page 3 of 3

application databases. 4. Open "IBM Cognos Configuration", save the configuration, and then start the IBM Cognos service. 5. If you have a distributed environment, repeat these steps for all remaining IBM Cognos BI servers. 6. Reboot the Controller application server (to automatically start the IIS and Controller-related services). (Step 16) Upgrade client software on each-and-every end-user's client device. 1. Logon to the client device as a Windows administrator 2. Launch "Add/Remove Programs" and remove the Controller client (for example "IBM Cognos Controller Local Client") 3. Download the new version of the Controller client from the application server (for example "http://SERVERNAME/ibmcognos/controllerbin/ccrlocalclient.msi"). TIP: There are three different versions of the client - see Technote#1371088. For most customers, CCRLocalClient.MSI is the best version to use. 4. Double-click on the client installation file (for example "ccrlocalclient.msi") 5. Follow the installation wizard. TIP: If unsure what values to use (for example WSSUrl) then open the file % APPDATA%\Cognos\CCR\ccr.config inside NOTEPAD and read the values from there,

Copyright and trademark information

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

http://www-01.ibm.com/support/docview.wss?uid=swg21602419&myns=swgimgmt&... 16/7/2012