IBM Support

IBM Community Surveys 8.5: Updating the Sonata services for IBM Connections 5.5 CR2

Preventive Service Planning


Abstract

Customers that use Surveys will be required to update the Waltz and Sonta jars on the FEB Server due to changes in IC 5.5 CR2 Sonata services. Once the IC 5.5 CR2 is deployed the Waltz and Sonata jars file must be manually updated for IBM Community Surveys.

Content


Install Instructions for IBM Community Surveys 8.5.1 update for IBM Connections CR2

1. Download the Community Survey 8.5.1 Update for CR2 from Fix Central.


2. Copy the update package to the server on which the Deployment Manager is installed. Decompress the update package downloaded in the step 1 into a temp directory.

3. Update "IBM Forms Experience Builder" in WebSphere Integration Solution Console
    a. Go to the Enterprise applications page. Click Applications > Application Types > WebSphere enterprise applications in the console navigation tree.
    b. Select the "IBM Forms Experience Builder" and click Update.
    c. On the Preparing for application update page, select "Specify the path to the replacement ear file" and select ibm.nitro.packaging.ear-8.5.1.071.ear which is located in the temp directory in step 2 then click Next.
    d. Click through the remaining screens in update wizard (no additional changes are required) by clicking "Next" then click Finish to complete.

    e. Go to Enterprise Applications > Forms Experience Builder > Context For Web Modules. Make sure the context root is "/surveys" and "/surveys-basic".
4. Backup all files in Surveys extensions folder and replace them with the updated files
    a. Navigate to the Surveys extensions folder.
      Linux: /opt/ibm/Forms/extensions
      Windows: C:\ibm\Forms\extensions

    b. Backup the files in the Extensions folder and then remove all the files in the folder

    Important: Make sure to backup the files Builder_config.properties and Connections_config.properties, the original version of these files will need to be restored after updating the contents of the Extensions folder

    c. Copy the file ibm.nitro.integrations.connections.packaging-8.5.1.071.zip from the temp directory in step 2 to the extensions folder and decompress the contents in the directory.

    d. Restore the files Builder_config.properties and Connections_config.properties from the backup folder in step 4.b

    e. Edit the Builder_config.properties to update the serverURI to be: htt p://host:port/surveys

5. Update the client jar file
    a. Remove the file ibm.nitro.integrations.connections.packaging.client-8.5.1.028.jar from <Connections_Install_Dir>/Data/shared/provision/webresources/.

    b. Copy ibm.nitro.integrations.connections.packaging.client-8.5.1.071.jar from the temp directory in step 2 into that folder

6. Replace the string files
    a. Copy ibm.nitro.integrations.connections.client-8.5.1.071.zip from the temp directory in step 2 to <Connections_Install_Dir>/Data/shared/customization/strings and decompress the file.

7. Update the widget definition for the Surveys widget and Featured Survey widget in widgets-config.xml
    a. Navigate to the LotusConnections-config folder which can be found here:
      Linux: /opt/ibm/WebSphere/AppServer/profiles/Dmgr01/config/cells/cellName/LotusConnections-config
      Windows: C:\IBM\WebSphere\AppServer\profiles\Dmgr01\config\cells\cellName\LotusConnections-config

    b. Edit the widget-config.xml file and update both the widget definition for the Surveys widget and Featured Survey widget with following template. The highlighted text are updated or new settings

    Important: Make sure to update the SURVEYS_SERVER_HOST:PORT in remoteHandlerURL.

    <widgetDef defId="Surveys" description="Surveys.desc" themes="wpthemeNarrow wpthemeWide wpthemeBanner" bundleRefId="formiwidget" primaryWidget="true" showInPalette="true" modes="view edit fullpage" uniqueInstance="true" loginRequired="false" url="{webresourcesSvcRef}/web/com.ibm.form.integrations.formiwidget/Surveys.xml" helpLink="/topic/com.ibm.lotus.connections.communities.surveys.help/community_survey_frame.html" iconUrl="{webresourcesSvcRef}/web/com.ibm.form.integrations.formiwidget/images/survey_widget_icon.png">
    <itemSet>
    <item name="formSeverBaseUrl"
    value="/surveys" readOnly="true" />
    <item name="surveyNumberInOverview" value="5"
    readOnly="true" />
    <item name="communitiesSvcRef" value="{communitiesSvcRef}"
    readOnly="true" />
    <item name="webresourcesSvcRef" value="{webresourcesSvcRef}"
    readOnly="true" />
    <item name="opensocialSvcRef" value="{opensocialSvcRef}"
    readOnly="true" />
    <item name="version" value="{version}"
    readOnly="true" />
    </itemSet>


    <lifecycle remoteHandlerURL="
    htt p://SURVEYS_SERVER_HOST:PORT/surveys/secure/org/lifecycle " remoteHandlerAuthenticationAlias="connectionsAdmin">
    <event>community.members.added</event>
    <event>community.members.removed</event>
    <event>widget.added</event>
    <event>widget.removed</event>
    <event>community.updated</event>
    <event>community.visibility.changed</event>
    <event>community.prepare.delete</event>
    <event>community.members.modified</event>
    <event>community.org.changed</event>
    </lifecycle>
    </widgetDef>


    <widgetDef defId="FeaturedSurvey" description="FeaturedSurvey.desc" themes="wpthemeNarrow wpthemeWide wpthemeBanner" bundleRefId="formiwidget" primaryWidget="false" showInPalette="true" modes="view edit" loginRequired="false" uniqueInstance="false" url="{webresourcesSvcRef}/web/com.ibm.form.integrations.formiwidget/SingleSurvey.xml" helpLink="/topic/com.ibm.lotus.connections.communities.surveys.help/community_survey_frame.html" iconUrl="{webresourcesSvcRef}/web/com.ibm.form.integrations.formiwidget/images/survey_widget_icon.png">
    <itemSet>
    <item name="formSeverBaseUrl"
    value="/surveys" readOnly="true" />
    <item name="communitiesSvcRef" value="{communitiesSvcRef}"
    readOnly="true" />
    <item name="webresourcesSvcRef" value="{webresourcesSvcRef}"
    readOnly="true" />
    <item name="opensocialSvcRef" value="{opensocialSvcRef}"
    readOnly="true" />
    <item name="version" value="{version}"
    readOnly="true" />
    </itemSet>
    </widgetDef>

8. Sync the node(s) and restart the IBM Forms Experience Builder application server.

Note: If the mobile app is also used for Community Surveys then the change in context root for FEB also has to be taken into account in mobile, requiring an update to mobile-config.xml, specifically the SurveysURL setting.


11-16-2016

Document information

More support for: IBM Connections

Software version: 5.5

Operating system(s): AIX, Linux, Windows

Reference #: 1991532

Modified date: 05 June 2017


Translate this page: