Installing community surveys in connections 5.5

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

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.

Launch launchpad64.exe

You will see this

Click on Install

Installation Manager will start. You will see this

Click Next

Accept the license agreement

Click Next

Choose a path where to install, avoid Program Files (x86), and click Next

Click Next

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

Click Next

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

Click on Forms Experience Builder

Click on Manage Modules

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

http://yourserver.yourdomain.com/forms

Click on Setup

Click on Fix

Click on Continue to Secured Setup

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

Type db2 CREATE LARGE TABLESPACE USERSPACE4K PAGESIZE 4 K MANAGED BY AUTOMATIC STORAGE BUFFERPOOL FEB4KBP





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:\IBM\FormsExperienceBuilder\deploy\widget /ibm.nitro.integrations.connections.client-8.5.1.028.zip

Copy the files in c:\IBM\Connections\data\shared\customization

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:\IBM\WebSphere\AppServer\profiles\Dmgr01\bin 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 were 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 element block to register the resource bundle.

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.

Enabling custom widgets for Communities Go in C:\IBM\FormsExperienceBuilder\deploy\widget and copy the file ibm.nitro.integrations.connections.packaging.client-8.5.1.028.jar in c:\IBM\Connections\data\shared\provision\webresources\

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.formiwidget/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:

http://Connections_hostname:Connections_port/connections/resources/web/com.ibm.form.integrations.formiwidget/Surveys.xmlhttp://Connections_hostname:Connections_port/connections/resources/web/com.ibm.form.integrations.formiwidget/Surveys.xml

community.members.added community.members.removed widget.added widget.removed community.updated community.visibility.changed community.prepare.delete community.members.modified community.org.changed

Replace the FORMS_SERVER_HOST:PORT in the element with your Community Surveys host and port.

Save the file

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

Software neededCreating a DB2 database for Community SurveysInstalling Community Surveys with IBM Installation ManagerMap the Application to the HTTP ServerPerform Survey setupSurveys in IBM Connections communitiesRegistering the resource bundle to provide titles and descriptions for iWidgetEnabling custom widgets for CommunitiesAdding the Widgets to a community