My experiences with Connections Component Pack 6.0.0.5

IBM released Connections Pack 6.0.0.5 earlier this week. With this new release, IBM added new features and improvements:

  • Full upgrade path

I did a new installation as well as an upgrade and would like to share my experience in this blog post.Installation

I had some difficulties installing Component Pack 6.0.0.5 as mentioned in the Knowledge Center.

You either can provide your Connections hostname using “ — set_ic_host” parameter or let the installer asking you for it. The script will try to access that URL and will also the check the HTTP response code as well as the size of the response. In an environment without an HTTP Proxy, the response code will be 200 which unfortunately will break the installation because of a missing “https://” in one of the installation scripts.

You can easily fix that by editing the 00-all-config.sh script and adding the missing “https://” as mentioned below:

After changing the file you can install IBM Cloud private as usual. Please be aware that you either need to include the “ — development_mode” parameter to skip the checksum check or generate a new md5sum and customize the manifest.md5 file before.

Update: IBM released a Technote on this topic.

Downsizing

The downsizing script I created for Component Pack 6.0.0.4 some weeks ago is still working. You will find it here. Still without any support.

Connections Customizer

IBM did some great work here. All the manually changes which were needed with Component Pack 6.0.0.4 are gone. Just install it and it will work. You will find the updated documentation here.

Please don’t miss to update following two parameters in the connections-env Configmap:

  • customizer-interservice-host

You need to recreate the mw-proxy pods afterward. Some more information and insights are listed in my last Connections Customizer post. I also suggest tuning your Nginx configuration!

IBM also released a new version of Visual Update 1 which now includes some more apps as well as Orient Me. It is the perfect start to work with Connections Customizer. Find more information here.

Upgrade

I only did one upgrade to Component Pack 6.0.0.5 yet. So my issues might be related to my environment but I would like to share them with you.

Some tips below:

  • Change your default namespace back to “default” in case you changed it to “connections”. Some scripts will not work with the changed namespace.

Elasticsearch

The upgrade process created new Elasticsearch certificates which the documentation does not mention. Therefore you need to copy the new chain file as well as the certificate to a Websphere Node and redo the merge. Either using the enableSslForMetrics wsadmin command or the ISC:

IBM Cloud private update

I had a strange issue while updating IBM Cloud private. It looks like the upgrade process has issues recreating the Kubernetes mongo secret. I fixed it by customizing the B-23-master-configure-cfc.sh script and removing the following two links:

Update: It looks like this issue occurred because of a previous problem which forced me to rerun the upgrade process. You can manually fix it by removing the /opt/mongo-secret/yamlContent directory. This is a known issue by IBM. They will publish a technote soon.

Service ports

After installing the updates some of my Kubernetes services where mapped to different ports (which wasn’t the same in a new installation). Therefore I needed to remap my IBM HTTP Server configuration.

Update: You can fix this by executing following lines within the /microservices/hybridcloud directory:

helm upgrade community-suggestions helmbuilds/community-suggestions/community-suggestions-0.1.0-20180207-181337.tgz –values=bin/common_values.yaml –set service.nodePort=32200
helm upgrade itm-services helmbuilds/itm-services/itm-services-0.1.0-20180213-003437.tgz –values=bin/common_values.yaml –set service.nodePort=31100
helm upgrade orient-web-client helmbuilds/orient-web-client/orient-web-client-0.1.0-20180222-120221.tgz –values=bin/common_values.yaml –set service.nodePort=30001
helm upgrade mail-service helmbuilds/mail-service/mail-service-0.1.0-20171205-071234.tgz –values=bin/common_values.yaml –set service.nodePort=32721

Thanks to Conall Ó Cofaigh who provided those commands.

I’m not sure if those are real issues or only related to my environment. Please let me know :)

ICS & IBM Connections

Stories related to IBM Connections and other ICS topics by Nico Meisenzahl.

Nico Meisenzahl

Written by

Senior Consultant @panagenda, @soccnx & @DockerRosenheim team member. Blogger, speaker & IBM Champion. Loves DevOps, K8s. His desk is a ping pong table.

ICS & IBM Connections

Stories related to IBM Connections and other ICS topics by Nico Meisenzahl.