Using IBM Connections 5.5 Type-ahead in your environment – Part 1

connections cnx

With Connections 5.5 IBM provides a new feature called Type-ahead search. When you start typing in the search box, Connections will show matching content directly in a popup. This nice feature uses a search index called Apache Solr, which is not included in the Connections installation process. You will need to do some manual work to get this feature working after downloading the Fix from Fixcentral. 

After downloading, unzipping and reading the readme file, you will be disappointed:

  • No Windows, only Linux.
  • No clustering, or high availability
  • No Init-scripts

Many of my customers are running Connections on Windows. A Linux Server for Solr Search only is not an option! Let’s start with this challenge.

Using Connections Type-ahead on Windows (this configuration is not supported by IBM or myself!):

  1. Unzip the Thype-ahead search fix
  2. Install Java (or using WebSphere JVM). Add JRE to the Path variable
  3. Create import-cert.bat
    @echo off
     
    IF NOT DEFINED JAVA_HOME echo JAVA_HOME is NOT defined
     
    %JAVA_HOME%\bin\keytool -importcert -alias connections -file root.crt -keystore node1\etc\solrtest.keystore -storepass secret -noprompt
    %JAVA_HOME%\bin\keytool -list -keystore node1\etc\solrtest.keystore -storepass secret
  4. Import the certificate as described in the readme file (step 1.4) using import-cert.bat
  5. Create start-solr.bat
    @echo off
     
    IF NOT DEFINED JAVA_HOME echo JAVA_HOME is NOT defined
     
    cd node1
    start /B "Solr" ""%JAVA_HOME%\bin\java"" -DSTOP.KEY=mysecret -DSTOP.PORT=8079 -Djetty.ssl.clientAuth=true -Dhost=%COMPUTERNAME% -Dcollection.configName=myConf -DzkRun -DnumShards=1 -Dbootstrap_confdir="solr\quick-results-collection\conf" -jar start.jar
    cd ..
  6. Create stop-solr.bat
    @echo off
     
    IF NOT DEFINED JAVA_HOME echo JAVA_HOME is NOT defined
     
    cd node1
    start /B "Solr" ""%JAVA_HOME%\bin\java"" -DSTOP.PORT=8079 -DSTOP.KEY=mysecret -jar start.jar --stop
    cd ..
  7. Create Windows Scheduled Tasks based on both scripts
  8. Follow the steps in the readme file. Step 1.5.1+

I will focus on Linux Init-scripts in a later post.

One thought on “Using IBM Connections 5.5 Type-ahead in your environment – Part 1”

Leave a Reply

Your email address will not be published. Required fields are marked *