1. Installing Community Surveys in Connections 5.5
Contents
Software needed ........................................................................................................................................... 1
Creating a DB2 database for Community Surveys......................................................................................... 1
Installing Community Surveys with IBM Installation Manager ..................................................................... 2
Map the Application to the HTTP Server....................................................................................................... 8
Perform Survey setup.................................................................................................................................. 10
Surveys in IBM Connections communities ...................................................................................................... 13
Registering the resource bundle to provide titles and descriptions for iWidget........................................ 13
Enabling custom widgets for Communities................................................................................................. 15
Adding the Widgets to a community........................................................................................................... 17
Software needed
Before the installation you will need to download the following software:
IBM Connections Community Surveys V5.5 Windows Multilingual (CN80KML )
It is assumed, that you already have IBM Connections 5.5 installed and have access to the Connections
database server (this guide will use DB2).
Since in this case it is a single server installation the IBM Installation Manager of IBM Connections will be
reused.
Creating a DB2 database for Community Surveys
Open a DB2 Command Window Administrator
Type db2 "CREATE DB FEBDB using codeset UTF-8 territory us PAGESIZE 32768"
Type db2 connect to FEBDB
Type db2 CREATE BUFFERPOOL BUFFERFEB IMMEDIATE SIZE 250 PAGESIZE 32K
2. Type db2 CREATE USER TEMPORARY TABLESPACE LARGE_USERTEMP PAGESIZE 32k MANAGED BY
AUTOMATIC STORAGE EXTENTSIZE 16 PREFETCHSIZE 16 BUFFERPOOL BUFFERFEB
Type db2 grant dbadm on database to LCUSER
Installing Community Surveys with IBM Installation Manager
You must enable Administrative security and Application security in WebSphere Application Server before
you install Community Survey
Extract the file you downloaded, and go in the directory where you unzipped it.
5. Choose a path where to install, avoid Program Files (x86), and click Next
Click Next
6. Fill in the values required and click Validate. You will get no confirmation dialog, upon successful validation
the button Next becomes active. Click it
Fill in the values required and click Validate. You will get no confirmation dialog, upon successful validation
the button Next becomes active. Click it
8. Click Next
Click Install
Go and grab a coffee, when you come back you will see this
Click Finish
Close the launchpad
Map the Application to the HTTP Server
Open the WebSphere Integrated Solution Console
Go in Application -> WebSphere enterprise applications
9. Click on Forms Experience Builder
Click on Manage Modules
10. Select the checkboxes and in the section Cluster and Servers select the Connections cluster and the
webserver and click Apply
Click OK
Click Save
Perform Survey setup
Open http://yourserver.yourdomain.com/forms
12. Click on Continue to Manager
You will see this
This means Community Surveys is now ready to use.
Now we need to create some extra table spaces to minimize the database size as applications are created.
Open a db2 Command Window Administrator
Type db2 connect to FEBDB
Type db2 CREATE BUFFERPOOL FEB4KBP IMMEDIATE SIZE 250 AUTOMATIC PAGESIZE 4 K
13. Type db2 CREATE LARGE TABLESPACE USERSPACE4K PAGESIZE 4 K MANAGED BY AUTOMATIC STORAGE
BUFFERPOOL FEB4KBP
Type db2 CREATE BUFFERPOOL FEB8KBP IMMEDIATE SIZE 250 AUTOMATIC PAGESIZE 8 K
Type db2 CREATE LARGE TABLESPACE USERSPACE8K PAGESIZE 8 K MANAGED BY AUTOMATIC STORAGE
BUFFERPOOL FEB8KBP
Type db2 CREATE BUFFERPOOL FEB16KBP IMMEDIATE SIZE 250 AUTOMATIC PAGESIZE 16 K
Type db2 CREATE LARGE TABLESPACE USERSPACE16K PAGESIZE 16 K MANAGED BY AUTOMATIC STORAGE
BUFFERPOOL FEB16KBP
Surveys in IBM Connections communities
Community Surveys delivers survey components for integration with IBM Connections 5.5. These
components include two different survey widgets for community pages. The Survey widget shows active
surveys in a community page. The Featured Survey widget displays a survey or survey results.
There is the need to perform some other steps to configure the widgets
Registering the resource bundle to provide titles and descriptions for iWidget
Unzip the resource bundle from the directory C:IBMFormsExperienceBuilderdeploywidget
/ibm.nitro.integrations.connections.client-8.5.1.028.zip
Copy the files in c:IBMConnectionsdatasharedcustomization
14. To register the resource bundle in the LotusConnections-config.xml file, open a command prompt and start
the wsadmin command-line tool, to do so go in c:IBMWebSphereAppServerprofilesDmgr01bin and
type “wsadmin.sh -lang jython -user your wasadmin -password your password”
Enter the following command to access the Connections configuration file.
Execfile (“connectionsConfig.py”)
Enter the following command to check out the Connections configuration file,
LCConfigService.checkOutConfig(“working_directory”, “cell_name”) where working_directory is the
temporary working directory to which the configuration XML and XSD files are copied and cell_name is the
name of the WebSphere Application Server cell hosting the Connections application
Note, even if we’re on Windows you should type the directory path with a / and not a
From the c:temp directory edit the file LotusConnections-config.xml
Add the following line of code into the <resources> element block to register the resource bundle.
<widgetBundle prefix="formiwidget" name="ibm.nitro.integrations.connections.client.resources"/>
Save the file
Check in the file using the following command
LCConfigService.checkInConfig(working_directory, cell_name)
Restart the Common application using the WebSphere Integrated Solutions Console.
15. Enabling custom widgets for Communities
Go in C:IBMFormsExperienceBuilderdeploywidget and copy the file
ibm.nitro.integrations.connections.packaging.client-8.5.1.028.jar in
c:IBMConnectionsdatasharedprovisionwebresources
Restart the Common application with the WebSphere Application Server Integrated Solutions Console.
Verify the resource is available for access by visiting the Connections resource URL:
http://Connections_hostname:Connections_port/connections/resources/web/com.ibm.form.integrations.f
ormiwidget/Surveys.xml
Open a command prompt and start the wsadmin command-line tool.
Enter the following command to access the Communites Administration
execfile("communitiesAdmin.py")
Enter the following command to check out the widgets-config.xml configuration file,
CommunitiesConfigService.checkOutWidgetsConfig(“working_directory”,”cell_name”)
Open the widgets-config.xml file in a text editor. Find the resource section that has a type="community"
and add the following lines:
17. Check in the file using the following command
CommunitiesConfigService.checkInWidgetsConfig(working_directory, cell_name)
Restart the Communities application with the WebSphere Application Server Integrated Solutions Console.
Adding the Widgets to a community
Log on to your Connections server
Go in Communities
Click on Community Actions in the top right and in the drop down menu select Add Apps
You will see Surveys and FeaturedSurvey in the list of available apps