Skip to content

WebSphere Application

The Huddo Application is provided as a .war file that is to be installed as a WebSphere Application in your Connections server environment. The application provides the Huddo Badges & Analytics engines that drives the reward and recognition of user performance, as well as the widgets for user interaction.

Login to the WebSphere Integrated Solution

Login to the WebSphere Integrated Solution Console for your Connections environment via a webbrowser.

Enter your administrator User ID and Password, then click the “Log in” button.

login

Install the Huddo.war file

Navigate to Applications → Application Types → WebSphere enterprise applications

install app

Click the Install button

install button

Browse the Local File System Path for the downloaded Huddo.war file then Click Next

browse war

Check the Fast Path Option then Click Next

fastpath

Change the Application name to Huddo then Click Next

app name

Highlight the Nodes for the Application, including the IHS Node. Select the Badges Module, click Apply then Next.

Please Note: It’s recommended that you create a separate cluster for Huddo if your Connections install is bigger than 10,000 users. You can do this via the ISC by clicking on Servers > Clusters > WebSphere application server clusters and then clicking New.

server mapping

Click on Browse and map the default resources as shown. Click Next.

resource mapping

Enter Huddo as the Context Root, then click Next.

Please Note: The Huddo Installation guide assumes that the Context Root is set as ‘/Huddo’. If you set the Context Root to something other than ‘/Huddo’, then make sure that you replace ‘/Huddo’ with your Context Root when entering addresses.

context root

Review the Installation Summary. Click Finish.

summary

Review the Installation Results. Click Save.

save install

Review the Synchronisation Summary. Click OK.

You have now successfully installed Huddo as a WebSphere Enterprise Application. Next, you will need to edit the security settings.

Modify the Huddo Application Security Role assignments

During this step, we will be defining the authenticated users/groups for each Security Role.

Find Huddo in the list of enterprise applications and click on Huddo to open the application configuration screen

app list

Click Security role to user/group mapping

security role

To ensure that only authorised users have access to Huddo and its data, modify the mapping of the AllServlets and Reader roles to the Special Subjects: All Authenticated in Application/Trusted Realm, then Click OK

Please note: You may set the Reader role to Everyone to grant read-only access to Huddo widget data to unauthenticated users.

role mapping

Ensure the Signer Certificate for the Connections URL is Trusted

In order for Huddo to post entries into the Homepage Activity Stream, WebSphere must trust the certificate for the secure URL of your Connections Environment. During this step, we will be importing the environment certificate into the CellDefaultTrustStore.

Navigate to SecuritySSL certificate and key management and then select Key stores and certificates

ssl cert

Select CellDefaultTrustStore

trust store

Select Signer certificates

signer cert

You will now see a list of all trusted certificates.

If the URL of your Connections Environment is listed, skip to Add Huddo Related Strings to Connections

We will now import the public certificate from the IBM HTTP Server to the default trust store in IBM WebSphere Application Server

Click Retrieve from port

retrieve link

Enter the following details of the web server, then click Retrieve Signer Information:

  • Host (e.g. connections.company.com)
  • SSL Port (443)
  • Alias

port details

The certificate will now be retrieved. Please confirm the details of the certificate, Click OK. The root certificate is then added to the list of signer certificates.

This change will not be picked up by Connections until the servers are restarted. This will be performed at the end of the configuration.

Copy the .properties files from the folder Huddo.ear/Kudos.war/installFiles to the Connections strings customisation directory: /strings Where CONNECTIONS_CUSTOMIZATION_PATH is defined by the WebSphere variable. e.g. /opt/Connections/data/shared/customization/strings

IMPORTANT: If a file of the same name already exists, merge the contents into the existing file.

customisation path