Skip to content

Orient Me installation and integration guide

Given that Orient Me is based on technology unfamiliar to many folks that had been working with Connections before, some people might be struggling with installing it.  I have created a guide that should help you getting it running for a demo environment with everything from Orient Me (Kubernetes, Docker, all Boot-, Master- and Workersnodes) on a single CentOS image and help you integrate it with your Connections 6.0 server. 

And since I am aware that copying text out of a PDF often results in bad characters being copied, here a list of the more complex commands I had to use during the installation in a text file for easier copying.

PS: You can also download both documents from the Viewer.



  1. Damien Damien

    thanks a lot for your doc

  2. Gert-Jan Alderlieste Gert-Jan Alderlieste

    Martti, I have also installed Orient Me. But I have a problem. Orient Me is working, only I cannot post a “update” or “like” a post.
    Error: “Unable to post the update, try again later”.
    Maybe you can help.

    • Martti Garden Martti Garden

      This is hard to solve as remote as this. Are you seeing anything in the Connections logs?

      • Gert-Jan Alderlieste Gert-Jan Alderlieste

        Martti, no cannot find any related errors. If I check the Orient-webclient log, I can see my “status update” I posted. And if I check the WebSphere plugin log, I can see that the plugin is receiving information from the Orient-webclient.
        I think there is a problem between Docker(CFC) and IBM Connections.

        • Martti Garden Martti Garden

          You might have to open a PMR then. I have not had this before and have no idea right now what could be causing this. You are seeing things on the latest update page, though, right? This would mean in general the connection between Connections & OM is established.

    • Hi,

      do you have an HTTPS forced Connections environment? If yes, you should configure Orient Me to talk HTTPS only by changing the Interservice Ports/Protocol within the configmap (“kubectl edit configmap”) and redeploy all itm and orientme pods afterward.

      Greets Nico

      • Gert-Jan Alderlieste Gert-Jan Alderlieste

        Thanks Nico,

        My colleague found the blog from Charlie Price on DeveloperWorks.
        That was the trick 🙂

      • Richard Dew Richard Dew

        Hi Nico, would I be right in thinking that if you did have a forced https environment that during the config of Orient Me as long as you put in the URL strings requested as HTTPS this should also work with out the extra config afterward?

  3. Richard Dew Richard Dew

    Hi Martti, thanks for the guide using that and the one from Charlie Price I seem to have the installation correct now which is great. I followed your advise and changed the Home link to Orient Me and also changed the HTTP server so that it goes to Social if you hit the main server URL, however I also have Touchpoint installed and I have it so that any new user or a user who has never been through onboarding goes to Touchpoint. This is done by adding the Touchpoint footer customization. The issue is because Orient Me is outside the WebSphere build it doesn’t redirect a user to Touchpoint until the go to something else in Connections such as Profile etc.. Do you have any ideas how I can get around this so that even going to OrientMe it redirects to TouchPoint?

  4. Hi Martti, thanks for your greate guide for installation.

    I have installed the IBM Connections ComponentPack and i got the follow error, after running ./

    mkdir: can’t create directory ‘/var/lib/zookeeper/data’: Permission denied

    The problem was, that you create the persistent volumes like this:

    mkdir -p /pv/mongo-node-{0,1,2}/data/db
    mkdir -p /pv/solr-data-{1,2,3}
    mkdir -p /pv/zookeeper-conf-{1,2,3}
    mkdir -p /pv/zookeeper-data-{1,2,3}
    chmod -R 777 /pv

    But this will not work for me. I had to create the volumes with these commands:

    sudo mkdir -p /pv-connections/mongo-node-{0,1,2}/data/db
    sudo mkdir -p /pv-connections/solr-data-solr-{0,1,2}
    sudo mkdir -p /pv-connections/zookeeper-data-zookeeper-{0,1,2}
    sudo mkdir -p /pv-connections/esdata-{0,1,2}
    sudo mkdir -p /pv-connections/esbackup
    sudo mkdir -p /pv-connections/customizations
    sudo chmod -R 777 /pv-connections

    Than I run the commands again:

    kubectl create -f /home/microservices/hybridcloud/doc/samples/fullPVCs.yml
    kubectl create -f /home/microservices/hybridcloud/doc/samples/fullPVs_HostPath.yml.

    Now the ./ script run fine.


    • Martti Garden Martti Garden

      Hi Martin,

      ah, right! I did the installation as root and therefore had all permissions and did not need the sudo.

      Thank you for sharing this!



      • Martin Alter Martin Alter


        I don’t talk about the sudo. Is more the path. In my enviroment I need to create “pv-connections” an not only “pv”.



        • Hi,
          the path has changed with Conponent Pack

          Greets Nico

  5. Martin Alter Martin Alter


    after an installation of orientMe I get the Browser Error ERR_TOO_MANY_REDIRECTS if I call https://connections_url/social

    Maybe you have some information about this scenario? Maybe you run in the same issue?



    • Hi,
      does your Connections environment forces HTTPS?
      In this case you will need to change some settings from http to https as well as 80 to 433. those are stored in a configmap. You can access them using „kubectl edit configmap connections-env -n connections“. You will need to recreate the pods afterwards.

      Greets Nico

Leave a Reply

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