Post-installation tasks for Connections Touchpoint

The following topics cover tasks that apply to any environment in which Touchpoint is installed, plus one task that is only for Touchpoint environments that are also deploying Orient Me in place of the standard Connections home page.

For optional customizations of Touchpoint to fit your environment, contact IBM Services.

Optional: Adjusting TDI profile functions

If you prefer, you can adjust TDI profile functions (TDISOL/profiles_functions.js) to match the LDAP structure in your IBM Connections environment.

Procedure

  1. Adjust the function func_generate_recommended_tags to return a comma-separated string with the LDAP attributes that you want as recommended tags, such as tag1, tag2, tag3.

    Example 1: Fetch displayName from LDAP and extract departmentCode (the value in braces). Then split it up by separator "/" and append all subvalues to the tags array.

    Example 2: Fetch workLocation(extattr.city) and append it to the tags array.

    Example 3: Fetch country and append it to the tags array.

  2. Adjust the function func_make_department_keyto return the correct identifier that is later used to determine the "promoted" experts and communities for the following example: Fetch displayName from LDAP and extract the departmentCode (value in braces)
. Then split it up by separator "/" and return the first match.

Synchronizing WebSphere Application Server cells

After installing IBM Connections Touchpoint, you must synchronize your WebSphere Application Server cells.

Procedure

  1. Log in to the wasadmin console with the was administrator ID and password. (e.g. For example, log in from the following URL: https://HOST_NAME/ibm/console/logon.jsp).
  2. Navigate to System administrationNodesSynchronize the selected node, for example, connectionsNode.

Adding an alias to the IBM HTTP Server configuration

Add a new alias to all IBM HTTP Servers by editing the httpd.conf file.

Procedure

  1. In the /opt/ibm/data/HTTPServer/conf/httpd.conf file (Linux) or C:\IBM\data\HTTPServer\conf\httpd.conf file (Windows), add the following line to the end of the file:
     # TOUCHPOINT 
    Alias /touchpoint/img/upload_pic/ "/opt/ibm/data/connections/data/shared/touchpoint/upload_pic/" 
    <Directory "/opt/ibm/data/connections/data/shared/touchpoint/upload_pic/"> 
         Order Deny,Allow 
     Allow from all 
    </Directory> 
    # TOUCHPOINT
  2. Adapt the path to the one you set previously. Check that the path ends with a slash ( / ).
  3. Verify that users have access to the HTTP Server files. Find the following reference to the HTTPServer\conf\httpd.conf file:
    # Controls who can get stuff from this server.
            #
            Order allow,deny
            Allow from none
  4. Replace the reference with these lines:
    # Controls who can get stuff from this server.
            #
            Order allow,deny
            Allow from all
  5. From the command line, restart the HTTP Servers. If necessary, use the root as follows:

    su -

    <IBM HTTP Server>\bin>./apachectl –k stop

    <IBM HTTP Server>\bin>./apachectl –k start

Restarting servers and applications

Before you can see Touchpoint, you must restart your WebSphere Application Server cluster, IBM HTTP Servers, and all IBM Connections applications and servers.

Procedure

  1. To restart the WebSphere cluster that you configured in installation package/touchpoint.deploy.properties, from the wasadmin console, navigate to Servers > Server Types > WebSphere application servers > restart the configured server > .
  2. Restart your IBM HTTP Servers as follows:
    1. Change the directory to the IBM HTTP Server command folder (for example, /opt/IBM/HTTPServer/bin).
    2. Run the scripts ./apachectl stop and ./apachectl start to restart the HTTP Servers.
  3. Restart all IBM Connections applications and servers as follows:
    1. Change the directory to the WebSphere command folder (for example, /opt/IBM/WebSphere/AppServer/bin).
    2. Run the script services wasservice.sh stop and wasservice.sh start.

Results

Now you are able to visit Touchpoint (https://<Host_name>/touchpoint).

Changing users' default landing page to "Orient Me"

If your organization is deploying Orient Me in place of the standard IBM Connections home page, don't forget this step so that your users arrive at the correct home page once they successfully complete Touchpoint.

Procedure

Adjust the link for your "submit URL" in <IBM HTTP Server>/htdocs/touchpoint/js/touchpoint.js (config.submitUrl) The submit URL is the relative location that the user goes to after successfully completing Touchpoint.