Installing the Social Media Publisher

Follow these steps to install the Social Media Publisher on your authoring server, and then on any servers that subscribe from your authoring server.

Note: If you have migrated from a WebSphere® Portal version 7.0 or Web Content Manager version 7.0 server that was already using the Social Media Publisher, you will also need to run these steps on a version 8.0.0.1 system to enable the Social Media Publisher. All your data from your version 7.0 system will be maintained.
  1. Ensure that the following options have been correctly enabled:
    1. That the WasPassword and PortalAdminPwd passwords are set in the wkplc.properties file.
    2. That the jcr.DbPassword password is set in wkplc_dbdomain.properties file.
    3. That a proxy server is configured if your server is behind a proxy.
  2. Edit wp_profile_root/PortalServer/wcm/social/smp.properties file and to ensure the configuration is correct for the current server or cluster node.
  3. Run the following registration command from the wp_profile_root/ConfigEngine directory:
    Windows
    ConfigEngine.bat register-wcm-social
    AIX®, Linux, Solaris
    ./ConfigEngine.sh register-wcm-social
    IBM® i
    ConfigEngine.sh register-wcm-social
    z/OS®
    ./ConfigEngine.sh register-wcm-social
  4. Run the following deployment command from the wp_profile_root/ConfigEngine directory:
    Windows
    ConfigEngine.bat deploy-wcm-social
    AIX, Linux, Solaris
    ./ConfigEngine.sh deploy-wcm-social
    IBM i
    ConfigEngine.sh deploy-wcm-social
    z/OS
    ./ConfigEngine.sh deploy-wcm-social
  5. If you are publishing to an IBM Connections server, then import the SSL certificate from the IBM Connections server into the WebSphere Portal server. See the WebSphere Application Server documentation for instructions on importing certificates.
    Note: If your server is located behind a firewall, you may also need to import certificates for Facebook, LinkedIn and Twitter. See Working with social media certificates for further information.
  6. Restart the server.
  7. Add the Social Configuration library to all syndication relationships. Repeat these steps for each subscriber server in your environment. The settings defined for Shared Social database properties in the smp.properties file must be the same as those defined on the syndicator server.

    When installing on a server other than the authoring server, if your JCR database username or password is different from the authoring server, then run the following command from the wp_profile_root/ConfigEngine directory:

    Windows
    ConfigEngine.bat action-set-wcm-social-datasource-credentials -DWcmSocialDSNewUserName=AUTH_DB_USERNAME -DWcmSocialDSNewPassword=AUTH_DB_PASSWORD
    AIX, Linux, Solaris
    ./ConfigEngine.sh action-set-wcm-social-datasource-credentials -DWcmSocialDSNewUserName=AUTH_DB_USERNAME -DWcmSocialDSNewPassword=AUTH_DB_PASSWORD
    IBM i
    ConfigEngine.sh action-set-wcm-social-datasource-credentials -DWcmSocialDSNewUserName=AUTH_DB_USERNAME -DWcmSocialDSNewPassword=AUTH_DB_PASSWORD
    z/OS
    ./ConfigEngine.sh action-set-wcm-social-datasource-credentials -DWcmSocialDSNewUserName=AUTH_DB_USERNAME -DWcmSocialDSNewPassword=AUTH_DB_PASSWORD
  8. If your server contains virtual portals, you must also run the following task for each virtual portal on your server:
    Windows
    ConfigEngine.bat import-wcm-social-data -DVirtualPortalHostName=VirtualPortalHostName -DVirtualPortalContext=VirtualPortalContext
    AIX, Linux, Solaris
    ./ConfigEngine.sh import-wcm-social-data -DVirtualPortalHostName=VirtualPortalHostName -DVirtualPortalContext=VirtualPortalContext
    IBM i
    ConfigEngine.sh import-wcm-social-data -DVirtualPortalHostName=VirtualPortalHostName -DVirtualPortalContext=VirtualPortalContext
    z/OS
    ./ConfigEngine.sh import-wcm-social-data -DVirtualPortalHostName=VirtualPortalHostName -DVirtualPortalContext=VirtualPortalContext
  9. Restart WebSphere Portal.
  10. Repeat these steps on every server and cluster node.

Additional installation and configuration