IBM Support

Updating the BoardReader license key

Question & Answer


Question

How do I update the BoardReader license key in Social Media Analytics?

Answer

To update your BoardReader license key, you must do the following things:

  • Find the values for MaxDataSet and MaxMatches.
  • Update the app.properties file.
  • Update the crawler.properties file.
  • Update the cci_topology.xml file.
  • Restart the Social Media Analytics services.

Finding the values for MaxDataSet and MaxMatches

Before performing this procedure, you must have the following items:
    • The value of the BoardReader license key that you received from BoardReader as part of your license agreement.
    • Access to a computer whose IP address or domain is registered with BoardReader for your BoardReader license key. This information is in your BoardReader license-related communication. Ensure that the IP address or domain of the user interface nodes and the Hadoop Master nodes are registered with BoardReader.
  1. On the computer whose IP address or domain is registered with BoardReader, open a web browser and enter the following web address:
    http://api.boardreader.com/v1/Keys/Info?key=<board-reader-key>
    where <board-reader-key> is the value of the BoardReader key that you received from BoardReader as part of your license agreement.
  2. Note the values for MaxDataSet and MaxMatches.

Updating the app.properties file

Perform the following steps for each project in Social Media Analytics:
  1. Log in to the user interface node as the cciusr user.
  2. Edit the app.properties file located at:
    <WAS_DIRECTORY>/profiles/sma1Profile/installedApps/sma1_cell/<projectID>AdminApp.ear/<projectID>AdminApp.war/ WEB-INF/classes/res/
    where the default path for <WAS_DIRECTORY> is /local/ibm/cognos/ci/coninsight/was_sma/ewas/
  3. Change the value of the boardreader.url.param.value.key property to the value of your BoardReader key.
  4. Save and close the file.

Updating the crawler.properties file
  1. Log in to the hadoop master node as the hadoop user.
  2. Edit the crawler.properties file located at:
    <FLOWMGR_HOME_DIR>/toroBackend/crawler/conf/
    where the default path for <FLOWMGR_HOME_DIR> is /home/hadoop/FlowMgr/
  3. Change the value of the boardreaderapi.key property to the value of your BoardReader key.
  4. Change the value of the fetch.docs.per.request property to your MaxDataSet value.
  5. Change the value of the default.max.matches property to your MaxMatches value.
  6. Save and close the file.

Updating the cci_topology.xml file
  1. Log in to the user interface node as the cciusr user.
  2. Copy the cci_topology.xml file to a file named cci_topology.xml.orig.
  3. Edit the cci_topology.xml file located at:
    <SMAInstallDirectory>/cci_installmgr/cci_mngmt/cci_cli/
    where the default path for <SMAInstallDirectory> is /local/ibm/cognos/ci/coninsight/cci_installmgr/cci_mngmt/cci_cli/
  4. Change the value of the boardreaderapi.key property to the value of your BoardReader key.
  5. Change the value of the boardreader.maxDataSet property to your MaxDataSet value.
  6. Change the value of the boardreader.maxMatches property to your MaxMatches value.
  7. Save and close the file.

Restarting the Social Media Analytics services
  1. Log in to the user interface node as the cciusr user.
  2. Change directory to
    <SMAInstallDirectory>/cci_installmgr/cci_mngmt/cci_cli/
    where the default path for <SMAInstallDirectory> is /local/ibm/cognos/ci/coninsight/cci_installmgr/cci_mngmt/cci_cli/
  3. Run the following commands:
    ./cci_cli.sh -process stop
    ./cci_cli.sh -process start

[{"Product":{"code":"SSJHE9","label":"Social Media Analytics"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"--","Platform":[{"code":"PF016","label":"Linux"}],"Version":"1.2","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
15 June 2018

UID

swg21627041