IBM Support

Update Strategy for IBM Connections 6.0

Preventive Service Planning


Abstract

This document describes the recommended strategy and steps for applying maintenance updates to IBM Connections 6.0. It includes important information on known issues.

Content

Table of Contents:

Before you begin

It's important that you read this document to understand the requirements and the steps to deploy the latest IBM Connections 6.0 updates. This document is a summary of requirements for installing the latest updates.

Important Update:

  • IBM Connections V6.0 IFR1 (April, 2018)
    IBM Connections has delivered an interim release for IBM Connections v6 that removes Cognos Business Intelligence v10.2.2 as a supporting program from the Connections License. The reason for the update is that IBM Cognos Business Intelligence v10.2.x is reaching End of Support. IBM Connections V6.0 IFR1 has replaced IBM Connections 6.0 GA on Passport Advantage (see table below for part numbers). IC V6.0 IFR1 includes IC 6.0 CR1 so there is no need to apply CR1 after installation. The "Database Wizard for IBM Connections 6.0 IFR1" creates and updates connections databases to the CR1 level so no manual db schema updates are required when using the IFR1 DB Wizard. However if you are manually upgrading the Connections databases then the scripts will need to be run, see topic Migrating 5.0 and 5.5 databases manually for details. For more information on Metrics support in IBM Connections 6.0 refer to IBM Connections 6 Metrics update (Technote 2012379) .

    IBM Connections V6.0 IFR1 Passport Advantage Part Numbers:
    Description
    Part Numbers
    IBM Connections V6.0 IFR1 for Windows Multilingual
    CNS97ML
    IBM Connections V6.0 IFR1 for AIX Multilingual
    CNS98ML
    IBM Connections V6.0 IFR1 for Linux Multilingual
    CNS99ML
    IBM Connections V6.0 IFR1 Linux for System z Multilingual
    CNS9AML
    IBM Connections V6.0 IFR1 Wizard for Windows Multilingual
    CNS9BML
    IBM Connections V6.0 IFR1 Wizard for Linux, AIX Multilingual
    CNS9CML

Section 1 - General Information

  • Updates for IBM Connections 6.0 are delivered via interim fixes called "Cumulative Refreshes" (CRs). CRs are cumulative. The latest CR will contain the changes included in all previous required iFixes and CRs. It is only necessary to install the latest CR to get all available changes.
  • Cumulative Refreshes (CRs) consist of a set of cumulative fixes, one for each IBM Connections application. The entire application is updated. The CR includes multiple code changes bundled into a single package and verified together following IBM's interim fix delivery process.
  • It is important to backup customization and product modifications made to the application prior to applying a set of CR interim fixes. Review the instructions to back up customization and product modifications in Section 5 - Instructions on applying Cumulative Refresh (CR) updates before installing the latest CR
  • We recommend customers to apply the latest set of CR fixes as it becomes available. This ensures that all the applications in the IBM Connections environment are at the latest version. This in turn prevents the occurrence of known issues in your environment, increasing stability and minimizing downtime. It also helps expedite the resolution of newly reported issues.

Section 2 - List of IBM Connections 6.0 CRs

IBM Connections 6.0 CR4 (February 2019)

IBM Connections 6.0 CR3 (September 2018)

IBM Connections 6.0 CR2 (June 2018)


IBM Connections 6.0 CR1 (November 2017)

Section 3 - Important Release Notes

  • IBM Connections 6.0 CR3 Communities now integrates a subset of IBM Connections Engagement Center features, collectively known as the "Highlights app." This app can be customized to retrieve community content and present it to fit the needs of your community. To make this possible, CR3 installs the Highlights app on the same cluster as the Communities app. If ICEC was previously deployed on a different server, the CR3 install will move it to the Communities cluster to ensure that the Highlights app functions properly.
  • Refer to technote 871628 if the My Communities page is blank after deploying IC 6.0 CR4
  • If you use Cognos for the Metrics feature and install WebSphere Application Server 8.5.5.14 on the Cognos server, configure the server to use JDK v7.1 as explained in the technote - IBM Connections 6.0 CR3 Metrics with Cognos and WebSphere Application Server 8.5.5.14
  • Review the System Requirements for IBM Connections 6.0 document
  • Refer to the topic Updating IBM Connections 6.0 with the latest interim fix for details on installing interim fixes (iFix).
  • Updated 18-6-19The Update Installer for IBM Connections has been extended to support IBM Connections Engagement Center (ICEC) and Communities Surveys.The latest version can be downloaded here - Fix Central download link for the 6.0 Update installer (build 2018-06-14) . Make sure to download the latest version of the installer for installing IBM Connections 6.0 interim fixes (iFixes). While IBM Connections CRs does not use the Update Installer however interim fixes (iFixes) for IC 6.0 require the Update Installer.
  • Additional steps are required for performing a Rollback for IC 6.0 CRs.  Refer to the following technotes for additional information:
  • iFixes and required updates are available for download from Fix Central.

Release Notes from Previous CRs

Section 4 - Software Requirements and Recommended Updates


Review this section for the software updates and requirements for your IBM Connections environment. The installation details are included in Section 5 - Instructions on applying Cumulative Refresh (CR) updates . The following table lists specific configuration requirements per CR level:

  • IBM FileNet & IBM Connections 6.0 databases

CR level IBM FileNet (if using CCM) Database Updates
CR4 No Filenet Updates Required database updates for Communities, Files, HomePage, Solr and Wikis. See technote 796158 for details
CR3 No Filenet Updates Required database updates for Homepage, Solr, and creating a new database for the Highlights widget. See  technote 731733  for details
CR2 No FileNet Updates Required database updates for Communities, Files, HomePage, Metrics and Wikis. See technote 2016898 for details
CR1 *FileNet updates are required for CR1. See technote 2009305 for details **Homepage and Activities database updates required. See technote 2009306 for details

*There are no Filenet Component updates required for IBM Connections 6.0 IFR1. The IFR1 installation defaults to the fix packs for IC 6.0 CR1

** The "Database Wizard for IBM Connections 6.0 IFR1" creates and updates connections databases (Activities and Homepage) to the CR1 level so no manual db schema updates are required when using the IFR1 DB Wizard.

If the FileNet Components require updating on your deployment, upgrade to WebSphere Application Server 8.5.5.14 AFTER the FileNet components have been updated. Updating the FileNet components requires switching to Java 6.0 which WAS 8.5.5.14 no longer supports. WAS 8.5.5.14 forces all profiles within WebSphere to be upgraded to Java 8.

  • IBM WebSphere Application Server 8.5.5 

Use the recommended Java SDK for the supported versions of IBM Websphere Application Server

IBM WebSphere Application Server 8.5.5
Minimum
Recommended
CR3 & CR4 8.5.5 FP10 (8.5.5.10) 8.5.5 FP14 (8.5.5.14)
CR2 8.5.5 FP10 (8.5.5.10) 8.5.5 FP13 (8.5.5.13)
CR1


The following are offerings are available to IBM Connections customers:

IBM Connections 6.0 Add-ons

Component Pack for IBM Connections 6.0.0.7

The Component Pack for IBM Connections introduces new connectivity capabilities that enhance collaboration and boost productivity. Component Pack 6.0.0.7  introduces the following improvements and bug fixes and improvements. The Component Pack for IBM Connections 6.0.0.7 can be downloaded from Fix Central: Component Pack for IBM Connections 6.0.0.7.

  • The Component Pack for IBM Connections 6.0.0.6 requires IBM Connections 6.0 CR1 or above
  • Component Pack for IBM Connections includes the following services:
    The Component Pack is available for download on Fix Central. You can perform a full installation to deploy all of the components or use Starter Stacks to install specific components. Refer to the IBM Knowledge Center topic Optional: Installing the Component Pack for IBM Connections for details.
    • The Orient Me home page provides your users with a cognitive view of their most essential Connections content. Orient Me shows users prioritized updates, with content from the people and communities they interact with the most at the top and grouped by source, or view a single stream based on time. The page is fully integrated with an updated Notification Center to truly make the home page a command center for managing time and attention. IBM Connections Orient Me 6.0.0.7 is an incremental update to IBM Connections Orient Me 6.0 which is an optional add-on to the Homepage that presents the data largely contained by Connections in an effectively prioritized manner.
      • Orient Me 6.0.0.7 - new features:
        • Top Updates: Activity Stream 3rd party event support
        • Top Updates: Notification and Responses event support
        • Embedded Experiences
        • Announcement Bar support on Orient page
        • Hashtag support within Orient Tiles
        • Updated Security Compliance for Kubernetes install
        • Ingress Controller for Component Pack Applications
           
    • IBM Connections Customizer is a middleware proxy service that enables the customization of the IBM Connections UX (User eXperience). In essence Customizer acts as a proxybetween IBM Connections and the end-user, which gives it the ability to intercept and modify requests and responses, and thus customize anything that flows through it, e.g. the behaviour of APIs, the presentation of the user interface, etc
      • Customizer 6.0.0.7 new Features & Updates:
        • Refresh button added to all apps page
        • Feature to enable or disable individual extensions
        • Application IDs removed from extension data
        • Support for insensitive service names in application definitions
        • Support iFrame injections
        • Profile type match support
        • Help section added to extension list page
        • Performance optimisations
        • Preview feature set updates
    • Elasticsearch can be used for a variety of different features within Connections:
      • Elasticsearch and Metrics
        • Search and metrics capabilities based on Elasticsearch give you greater insights into your data. If you are an administrator, you can get meaningful metrics that demonstrate the business value of IBM Connections in your organization. You can chart Connections events such as every time that users read a blog entry, create a To Do item in an Activity, update a wiki page, or follow a Community. Community owners can also get metrics for the communities that they own. Track who visits the community, information shared such as comments, and participation in such activities as downloading file. Whether your organization is deploying metrics for the first time or migrating your existing Cognos metrics data to the new metrics, you can now visualize your data more easily with the improved interface
        • Type-ahead Search (IC 6.0 CR3 or higher)
 

Ephox Editors - Textbox.io 2.4.2.74 for IBM Connections 6.0

The Ephox editor, Textbox.io, is a full featured editor to enhance content authoring with wikis, blogs, profiles, forums, activities, and communities in IBM Connections.

  • New version of Ephox Editors for IBM Connections Version: 3.7.7.0 which includes an updated version of Textbox.io v2.4.2.74 is now available. Textbox.io 2.4.2.74 has an updated theme to match IBM Connections in addition to some bug fixes. The Ephox editor can the found at Fix Central here

IBM Connections 6.0 Smart Type-ahead search

Try out the enhanced type-ahead Search from any page within Connections 6.0. This suggests content in the Search box based on content that you have previously interacted with. For example, if you have recently created, updated or even simply visited any content within Connections, this will appear as a suggestion in the type-ahead once you start to enter text in the Search input field that matches the title of this content. Refer to the topic

Installing Type Ahead Search for installation details. IBM Connections smart Type-ahead search can the found at Fix Central here

IC 6.0 CR4 requires a schema update for Type-ahead search. The Solr schema update is in the database updates download file which is listed in  
Section 4 - Software Requirements and Recommended Updates of this document.
Metrics Cognos Reports migration tool

If you previously used Cognos to provide Metrics data for your IBM Connections deployment, Metrics reports are stored in Cognos PowerCube. You can migrate existing Metrics report data from Cognos to Elasticsearch. For more information on the migration tool refer to the topic " Migrating Metrics data from Cognos PowerCube to Elasticsearch " in the IBM Connections Knowledge Center . The Metrics Cognos Reports migration tool downloaded can be found at Fix Central. Make sure to download the version for the IC 6.0 CR that is deployed on your system.

Section 5 - Instructions on applying Cumulative Refresh (CR) updates

Always install the latest Cumulative Refresh (CR), as it contains the changes from all previous CRs. CRs are cumulative. It is only necessary to install the latest CR to get all available changes. For example, CR2 contains all the changes from CR1 plus the new changes added in CR2.

Before you begin:

  • These instructions are a summary of the procedure. They are intended to complement the product documentation pages on installing fix packs, because CRs use the same installation process as a fix pack. Review the topics under the  Updating IBM Connections 6.0  page for more details specifically  Updating IBM Connections 6.0 with the latest Cumulative Refresh (CR)
  • IBM Connections 6.0 environments using Connections Content Management (CCM) will need to upgrade the FileNet installation as part of the upgrade to a 6.0 CR. IBM Connections environments that do not have CCM can follow these guides disregarding the FileNet sections. Here are Step-by-Step examples of applying a CR to IBM Connections 6.0 with CCM

Important: Prior to applying a CR, it is important to back up customization and product modifications made to the application refer to the following:

Steps to install IBM Connections CRs

The installation of a 6.0 CR consists of the following steps:

1. Upgrade WebSphere Application Server

Note:  Review the System Requirements for IBM Connections 6.0 document to determine if your deployment has the most up to date supported version of WebSphere Application Server (WAS).
If you need to apply WebSphere Application Server (WAS) fixes or fixpacks, we recommend you install these prior to updating Connections. Applying WAS fixes follow these general steps:

1. Stop WAS processes (deployment manager, node agents, application servers).

2. Apply any recommended WAS fixes. Refer to Section 4 - Software Requirements and Recommended Updates for all recommended fixes

3. In the soap.client.props file change the SOAP Request Timeout to com.ibm.SOAP.requestTimeout=0 to ensure that no requests timeout during a CR install.

4. Restart WAS processes (deployment manager, node agents, application servers).

For detailed information on how to apply fixes and fix packs on WAS, review the Installing and uninstalling interim fixes and fix packs on distributed operating systems topics in the product documentation.

2. Upgrade to the latest version of the Installation Manager

Note: This section is not required when upgrading to  IC 6.0 CRs
Upgrade to the IBM Installation Manager 1.8.5 64 bit or above. The latest version of the install manager is available from Fix Central via this link: IBM Installation Manager

3. Update the Connections Databases

The necessary database updates are listed in Section 4 - Software Requirements and Recommended Updates of this document.
To apply the database updates:

1.    Download the database script package for the CR.
        -- technote 796158 for IC 6.0 CR4
        -- technote 731733 for IC 6.0 CR3
        -- technote 2016898 for IC 6.0 CR2          
        -- technote 2009306 for IC 6.0 CR1
2.    Review the steps to run the database update scripts for your database type.
3.    Run the commands for your database type.

Note: The "Database Wizard for IBM Connections 6.0 IFR1" creates and updates connections databases (Activities and Homepage) to the CR1 level so no manual db schema updates are required when using the IFR1 DB Wizard.

Important:  If the server already has IC 6.0 CR3 deployed then this section can be skipped. IBM Connections 6.0 CR3 requires a new database for the Highlights Community widget. The script to create the database is located in the database download script package in the Highlights_DB_Creation directory.

•    Review the scripts to and make the appropriate changes the script file to better fit into your system. Refer to the topic Creating a database for details. Note the username and password that is defined in the script to create the XCC database.  IC 6.0 CR install will prompt for that information.
•    If your server already has IBM Connections Engagement Center deployed on it then the XCC database does not need to be created.

Important:
As of IBM Connections CR3 Communities is now integrated with IBM Connections Engagement Center. Due to this, ICEC deployment will be moved from its current deployment location to the Communities cluster.

4. Install IBM Connections CR

1. Download the latest CR update. The latest CR update is on IBM Fix Central . (You will find the direct link to the latest CR listed in Section 2 - List of IBM Connections 6.0 CRs of this document.)
 
2. Copy the CR package and the database schema to the server on which the Deployment Manager is installed. Decompress the CR package downloaded in the step #1 into a temp directory.
 
3. If applying the CR to a clustered environment, ensure the WebSphere Application Server Deployment Manager is started and all node agents and application servers are shutdown.
 
4. Run the IBM Installation Manager from the server on which the Deployment Manager is installed to apply the CR.
 
5. Configure the repository in the IBM Installation Manager

a.    From the IBM Installation Manager menu, click File > Preferences.
b.    Click Repositories from the left navigation > Add Repository
c.    Enter the full path to the CR that you downloaded or click Browse to navigate to the location of the CR and then click OK. (The location is the temp directory in step #2)

In IC 6.0 CR1 for example: C:\Install\Connections CR\LC_version_Fixpack\Updates\repository.config
 image-20180915125012-1
d.    The IBM Installation Manager indicates if it can connect to the repository.
e.    Click OK to save the new repository.

 6. Apply the CR

a.    Click Update in the Installation Manager.
b.    The package group panel appears. Select the IC 6.0 package group (the default is IBM Connections) and click Next.
c.    Review and accept the license agreement by clicking I accept terms in the license agreements and then click Next.
d.    Ensure that all the applications are selected and click Next.
Note: All of the installed applications are selected by default. If you add any of the non-selected applications, those applications will be installed. If you clear any of the selected applications, those applications will be uninstalled.
e.    Enter the administrative ID and password of the Deployment Manager and click Validate. Once the administrative ID is validated, click Next.
f.    If IC 6.0 CR3 has already been deployed then you will not be prompted to enter the database information for the XCC database.
Important: The username and password need to match the user and password in the script that was used to create that database in step 3 Update Connections Databases and Create the database for the Highlights widget
g.    Review the summary information and click Update.
h.    When the update is completed, click Finish button.

7.   Start node agents and then perform a full synchronization to push the update to all nodes. Check the SystemOut.log of each nodeagent to ensure synchronization completed successfully.

8.   In the WebSphere Integrated Solutions Console Select Servers > Server Types > Webservers

9.   Select the Webserver then click on Generate Plug-in

10. Once the plug-in is generated then select the Webserver and click on Propagate Plug-in

11.  Stop the Node Agent

12.  Delete the contents of the cache under the App Server (i.e. C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)

13.  IC 6.0 CR4 updates the Search Conversion Tool (Sellent) and Multi-Node Deployments require an additional step to copy the updates to the local nodes. Refer to the instructions in the following topics:
        Copying Search conversion tools to local nodes for AIX and Linux
        Copying Search conversion tools to local nodes for Windows

14. Start node agents, then perform a full synchronization to push the update to all nodes. Check the SystemOut.log of each node agent to ensure synchronization completed successfully.

15.  It's recommended that a check of the Security Roles for the ICEC application is done. See topic Mapping security roles for further details

16.    Start the Connections Server

17.    Verify that the CR was successfully installed. Go to \IBM\Connections and open Version.txt to confirm the CR build number

1.    IC 6.0 CR4 build number: IC6.0_CR4_Connections_20190131-2045
2.    IC 6.0 CR3 build number: IC6.0_CR3_Connections_20180926-2237
3.    IC 6.0 CR2 build number: IC6.0_CR2_Connections_20180606-1047
4.    IC 6.0 CR1 build number: IC6.0_CR_Connections_20171116-0818

18. IBM Connections Engagement Center CR versions:

1. ICEC version for IC 6.0 CR4: [ICEC 6.0.2.4] 20190131-054514
2. ICEC version for IC 6.0 CR3: [ICEC 6.0.1.2] 20180926-075902

5. Upgrade FileNet Components

After applying an IBM Connections 6.0 CR1, you must upgrade FNCE Server & Client. Please read the entire install instructions before beginning the installation. The topic Updating IBM Connections 6.0 with the latest Cumulative Refresh (CR) has important information that must be followed when applying IBM Connections 6.0 CRs and the subtopic Post-update tasks has information on deploying the latest FileNet FixPacks and Interim Fixes.

There are examples of the FileNet installation process in the following technotes:

  • There are no FileNet updates when upgrading from IC 6.0 CR3 to IC 6.0 CR4
  • There are no FileNet updates when upgrading from IC 6.0 CR2 to IC 6.0 CR3
  • There are no FileNet updates when upgrading from IC 6.0 CR1/IFR1 to IC 6.0 CR2
  • Technote 2009611 for installing IC 6.0 CR1 from IC 6.0

Note: There are no Filenet Component updates required for IBM Connections 6.0 IFR1. The IFR1 installation defaults to the fix packs for IC 6.0 CR1


7. Update Tivoli Directory Integrator assembly line

If an update to the TDISOL package is available in Section 2 - List of IBM Connections 6.0 CRs then download the update and follow the installation instructions that are included in the download.

8. Update miscellaneous items

Metrics: For customers who will deployed Elastic search for Metrics

  1. Migrating data from your relational database to Elasticsearch storage is an iterative process. Because data continues to be generated during the testing period, plan to migrate your data at least once more after you switch users to the Elasticsearch Metrics component. Review the steps in the following topic  Deploying Elasticsearch Metrics with the data migrated from the metrics relational database
  2. Refer to the topic Migrating Metrics data from Cognos PowerCube to Elasticsearch to migrate existing Metrics reports from Cognos to Elasticsearch.

Orient Me: For customers who have installed Orient Me refer to the topic Enabling profiles events for orient me for configuration details.

Installation Note: Make sure to clear the contents of the cache under the App Server by deleting the files in the directory C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp before restarting the node and cluster. Once the CR is installed restart DMGR and node agents then sync the nodes.


The IC 6.0 CR installation is complete; start the environment and you should be on the latest 6.0 CR.


Document information

More support for: IBM Connections

Component: Install

Software version: 6.0

Operating system(s): AIX, Linux, Windows

Reference #: 1999492

Modified date: 13 February 2019