How to upgrade Connections Content Manager to CR1

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
    Screen01
  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
    Screen02
  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://<server>:<port>/FileNet/AutomaticUpgradeStatus
  14. Wait until “Upgrade Status” shows “Completed”
    Screen03
  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

    Screen04
  22. Now I reconfigure the FNCS for Connections with following settings (-> Connections 4.5 Wiki)
    Screen05
    Screen06
    Screen07
    Screen08
    Screen09
    Screen10
    Screen11
  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?

 

Comments

Julius Schwarzweller
Reply

Hi,

in step 20:
…Documentation says next is running the ccmUpdate.bat in Connections_Install\addons\ccm\ccmDomainTool but this didn’t work for me … most likely this was due to wrong node information in the dminfo.properties file…
you could have also deleted the file …/AppServer/profiles/Dmgr01/bin/dminfo.properties and rerun the ccmUpdate.bat command. Then it works like charm 😉
This is a common problem that can be solved like that…

enzo stanzione
Reply

Great post very useful, I have to arrange it for linux syst.ems, but no problem.
Thanks for the share !

Oliver Regelmann
Reply

Thanks. It’s unbelievable how bad the IBM docs for this are. At least they now added the info that you also need to download the Filenet Client and FNCS setups seperately.

Giannandrea
Reply

Simply “BRILLIANT” !
Many thanks for sharing.
Giannandrea

Christoph Stoettner
Reply

Thanks for sharing Klaus! Works perfect with CNX 4.5 Linux and AIX too!

Maurizio Andreotti
Reply

Thanks for your instructions: I succeeded installing CR1. Thumbs up!!

Christoph Stöttner
Reply

You’re my hero today!

I installed a new Connections 4.5 inkl CR1 today and had to make each step too, even i had no configured CCM.

Leave a Reply

%d bloggers like this: