How to upgrade Connections Content Manager to CR1

- ibm-connections installation manager update

UPDATE: IBM added finally complete instructions how to upgrade to CR1

-> hopefully next time they will provide documentation not 1 month after a fixpack release!

 

Recently I started to update our productional IBM Connections 4.5 environment to CR1 which was easy for the Connections part but rather complicated for the Filenet/CCM part.

As I always tell my customers RTFM I checked the provided documentation first:

Fixcentral IBM Connections 4.5 CR1

IBM Connection Content Manager (CCM) – Information on FileNet 5.2.0 FP1

Mhm, sounds easy but I could not find the mentioned script after the Filenet FP1 installation and therefore decided to have a look at the developerworks IBM Connections Forum and surprise, surprise, I wasn’t the only one with this issue. To make a long story short this post pointed me to the right direction:

http://www-10.lotus.com/ldd/lcforum.nsf/d6091795dfaa5b1185256a7a0048a2d0/93ff690e7fec60f485257b9c004b3919?OpenDocument

So here are the details what worked for me (Win install):

Remark: Whenever you see the wasadmin user in the following screens replace it with your WAS admin user from LDAP!

  1. Download all needed fixpacks via FixCentral – 5.2.0.1-P8CE-WIN-FP001.zip (2.6GB!), 5.2.0.1-P8CE-CLIENT-WIN-FP001.zip, 2.0.0.1-FNCS-FP001-WIN.zip
  2. Shutdown your CCM server
  3. Make a backup of the existing bootstrapped Engine-ws.ear file – backups are not for losers

    (can be found in Connections_Install/addons/ccm/ContentEngine/tools/configure/profiles/CCM/ear/)

  4. Install FP 1 for FileNet Content Engine Server – Run 5.2.0.1-P8CE-WIN-FP001.EXE

  5. Click through installer (I added the .NET Clients)

  6. FP1 Readme suggests to remove the deployed CPE and the application server cache directories, I ignored this and just started the Configuration Manager

  7. In the Configuration Manager click on “File” – “Upgrade Profile”

  8. Click “Next” and fill in your WAS credentials and test the connection

  9. Click “Finish” and “Ok”, double click “Configure Bootstrap and Text Extraction” and check that the “Bootstrap operation” property shows “Upgrade” and that the fully qualified path to the currently bootstrapped Content Platform Engine EAR file is correct

  10. Click on “Run Task”, you will see the status of the Task in the Console, wait a few minutes until completion

  11. Double click on “Deploy Application” and check the “Bootstrapped EAR file” path, then click on “Run Task”, wait a few minutes until completion

  12. Close the Configuration Manager

  13. Now start your CCM server and go to http://:/FileNet/AutomaticUpgradeStatus

  14. Wait until “Upgrade Status” shows “Completed”

  15. Install FP1 for FileNet Content Engine Client – 5.2.0.1-P8CE-CLIENT-WIN-FP001.EXE

  16. Uninstall the FileNet Collaboration Services (Windows Control Panel – Remove application)

  17. Install the FileNet Collaboration Services – FNCS-2.0.0.1-WIN.exe (Installation directory Connections_Install\addons\ccm\FNCS)

  18. Install CR1

  19. Run the updateJVMArgs script:

    wsadmin.bat -lang jython -conntype soap -username wasadminID -password PASSWORD -f Connections_Install\addons\ccm\ccmDomainTool\updateJVMArgs.py -servers CCM_server1

  20. Documentation says next is running the ccmUpdate.bat in Connections_Install\addons\ccm\ccmDomainTool but this didn’t work for me

    I opened up the config.properties file in Connections_Install folder and changed ccm.existingDeployment=false to ccm.existingDeployment=true

  21. Now I run the ccmUpdate.bat inside Connections_Install\addons\ccm\ccmDomainTool

    The scripts asks me for the CPE hostname, port, object store name (ICObjectStore), admin name and password

  22. Now I reconfigure the FNCS for Connections with following settings (-> Connections 4.5 Wiki)

  23. Modify security role mapping for FNCS application and add “Everyone” to the “Authenticated” role

  24. Install the authentication filter code by going to WebSphere Enterprise Applications -> Select FNCS ->Click Update.

    Choose “Replace, add, or delete multiple files” as Application update option and Connections_Instal\ccm\ccm\ccm\auth_filter_patch\auth_filter_patch.zip as local file

  25. Map the FNCS,FileNetEngine modules back to your webserver (Enterprise Applications – FNCS/FileNetEngine – Manage Modules)

  26. Generate the IHS Plug-in file and propagate it

  27. Restart your IHS

  28. Finally restart the CCM server

Easy, isn’t it?