Skip to content

Install Application

The Kudos 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 Kudos 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 Kudos.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 Kudos.war file then Click Next

browse war

Check the Fast Path Option then Click Next

fastpath

Change the Application name to Kudos 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 Kudos 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 Kudos as the Context Root, then click Next.

Please Note: The Kudos Installation guide assumes that the Context Root is set as ‘/Kudos’. If you set the Context Root to something other than ‘/Kudos’, then make sure that you replace ‘/Kudos’ 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 Kudos as a WebSphere Enterprise Application. Next, you will need to edit the security settings.

Modify the Kudos Application Security Role assignments

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

Find Kudos in the list of enterprise applications and click on Kudos 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 Kudos 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 Kudos widget data to unauthenticated users.

role mapping

Ensure the Signer Certificate for the Connections URL is Trusted

In order for Kudos 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 Kudos 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 Kudos.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