Topic
7 replies Latest Post - ‏2013-02-26T19:35:24Z by tfriedr
thompsam
thompsam
7 Posts
ACCEPTED ANSWER

Pinned topic Installing BigSheets Plugins in V 2.0

‏2012-12-04T19:21:54Z |
I've just installed BigInsights V2.0 and am trying to migrate over some custom developed plugins(visualizers) for BigInsights 1.3. In 1.3, there was a "Settings" button when viewing the BigSheets tab, that one could use to install the plugins. In Version 2.0, the "Settings" button is no longer there. The V 2.0 documentation for the development of plugins states:

For more information about the structure a InfoSphere BigInsights application, see (application packaging).
For more information about installing a InfoSphere BigInsights application for use in extending BigSheets, see (deploying apps).

but no links are provided and searches in the BigInsights Infocenter don't yield any obvious answers? Are version 1.3 plugins supported ? If so, how does one install a BigSheets plugin in Version 2.0?

Sam Thomspon
Updated on 2013-02-26T19:35:24Z at 2013-02-26T19:35:24Z by tfriedr
  • SystemAdmin
    SystemAdmin
    603 Posts
    ACCEPTED ANSWER

    Re: Installing BigSheets Plugins in V 2.0

    ‏2012-12-05T00:07:24Z  in response to thompsam
    Hi Sam,

    Checked with our dev team on your question.

    Here's the response I got:

    "1.3 style of deploying the plugin is no longer supported. Users have to deploy those plugins as apps from eclipse tooling although they can use the same java code."

    Thank you,

    Zach
  • SystemAdmin
    SystemAdmin
    603 Posts
    ACCEPTED ANSWER

    Re: Installing BigSheets Plugins in V 2.0

    ‏2012-12-06T22:29:33Z  in response to thompsam
    Hi Sam,

    Just adding to what Zach responded with. The links you referenced in the documentation will be added in the next Information Center documentation refresh, which should be Dec 12.

    Information about developing applications with the Eclipse Tooling can already be found here:
    http://pic.dhe.ibm.com/infocenter/bigins/v2r0/index.jsp?topic=%2Fcom.ibm.swg.im.infosphere.biginsights.dev.doc%2Fdoc%2Fdev_app.html

    And the topic documenting application administration is here:
    http://pic.dhe.ibm.com/infocenter/bigins/v2r0/index.jsp?topic=%2Fcom.ibm.swg.im.infosphere.biginsights.dev.doc%2Fdoc%2Fbi_admin_administer_apps.html

    Thanks,

    Kevin
  • SystemAdmin
    SystemAdmin
    603 Posts
    ACCEPTED ANSWER

    Re: Installing BigSheets Plugins in V 2.0

    ‏2013-01-30T17:01:54Z  in response to thompsam
    Hello,
    The Eclipse Tooling does work for plugins, which act as readers or functions. But we are trying to migrate a plugin with a visualizer extension.
    We create an application and we try to publish it as BigSheets application. It looks like it is possible to define only reader or function extension, but not a visualizer. Is there something we are missing?
    Thank you!
    Denitsa Tsolova
    • tfriedr
      tfriedr
      28 Posts
      ACCEPTED ANSWER

      Re: Installing BigSheets Plugins in V 2.0

      ‏2013-01-31T19:17:21Z  in response to SystemAdmin
      Hi Denitsa,
      Publishing BigSheets visualizers is currently not supported as part of a BigSheets application. However, you can use REST APIs to install and uninstall your visualizer plugins into BigSheets. When installing through the REST APIs, you use the plugin.zip file as before and are not building a BigSheets application. The visualizer won't show up in the applications tab but directly in BigSheets.

      Here are the steps for installing and uninstalling a BigSheets visualizer plugin using curl to make the REST API calls:

      1. If you have a secure cluster, follow the steps described in the BigInsights Information Center to obtain a session token for calling REST APIs that will be used in any subsequent calls:
      http://pic.dhe.ibm.com/infocenter/bigins/v2r0/topic/com.ibm.swg.im.infosphere.biginsights.admin.doc/doc/security_rest_api_auth.html

      The calls are:
      1) curl -i -c /tmp/cookie_jar http://yourserver.com:8080/login.jsp
      2) curl -i -c /tmp/cookie_jar -d 'j_username=user' -d 'j_password=yourpassword' 'http://yourserver.com:8080/j_security_check'

      The location that you specify in the -c parameter needs to be passed in to any subsequent calls with the -b parameter.

      2. To install the visualizer plugin, there are two calls required: first the zip file with the plugin needs to be uploaded, and then installed.

      a) Upload
      To upload the zip file with the BigSheets visualizer plugin, call this REST API:
      curl -i -b /tmp/cookie_jar -H "Expect:" --form uploadedfiles[]=@yourVisualizer.zip http://yourserver.com:8080/bigsheets/api/file/upload

      The form parameter uploadedfiles[] needs to point to the zip file in your local file system that contains your visualizer plugin.

      As result of the call, you should see an output like this:
      You will need the value for tfhash in the next step.

      b) Install
      To install the just uploaded plugin, use this call:
      curl -i -b /tmp/cookie_jar -H "ContentType: application/json" --data request='{"_type":"install_plugin","tfhash":"0e4df01c-6d71-43d6-b5c1-425bc4409c47"}' http://yourserver.com:8080/bigsheets/api/execute

      In the request parameter, replace the value for tfhash with the value that was returned in the upload step 2a).

      The call should return a message like this:
      {
      "msg": "Install was successful",
      "status": "OK"
      }

      After this call, the visualizer plugin will be available in BigSheets.

      3. To uninstall the visualizer, run the following command:
      curl -i -b /tmp/cookie_jar -H "ContentType: application/json" --data request='{"_type":"uninstall_plugin","pluginId":"yourVisualizerPluginId"}' http://yourserver.com:8080/bigsheets/api/execute

      The pluginId value in the request parameter needs to match the plugin id of your visualizer (the value for pluginId in the plugin.json of your visualizer).
      • SystemAdmin
        SystemAdmin
        603 Posts
        ACCEPTED ANSWER

        Re: Installing BigSheets Plugins in V 2.0

        ‏2013-02-04T09:28:02Z  in response to tfriedr
        Thank you, the REST API solution works and the visualizer plug-in can be used in BigInsights 2.

        Denitsa
  • SystemAdmin
    SystemAdmin
    603 Posts
    ACCEPTED ANSWER

    Re: Installing BigSheets Plugins in V 2.0

    ‏2013-02-21T10:43:16Z  in response to thompsam
    Hi all,
    I have been using the BigInsights V2.0 Eclipse tooling for several publishes the last month but recently the publish functionality stopped working. Here are the error details I collected:
    1) Eclipse shows the following alert: An unexpected error occurred when connecting to the BigInsights server.
    2) The log file under Eclipse workspace metadata folder is not quite descriptive and contains nothing more than this same message.
    3) Digging deeper into the plugin com.ibm.biginsights.application_1.0.0.v20121025_1601.jar I traced the problem to:
    java.lang.reflect.InvocationTargetException
    at org.eclipse.jface.operation.ModalContext.run(ModalContext.java:421)
    at org.eclipse.jface.wizard.WizardDialog.run(WizardDialog.java:1008)
    at com.ibm.biginsights.application.publish.Publisher.getExistingBSPIds(Publisher.java:180)
    ...
    4) The extract of the BigInsights messages.log under /var/ibm/biginsights/console/log is attached.

    Any idea what started to cause this exception?

    Thank you.
    • tfriedr
      tfriedr
      28 Posts
      ACCEPTED ANSWER

      Re: Installing BigSheets Plugins in V 2.0

      ‏2013-02-26T19:35:24Z  in response to SystemAdmin
      Hi, It looks like that one of the applications that contain a BigSheets plugin has a malformed plugin.json inside. During publish in the publish wizard, we look at the existing apps in the BigInsights server and according to the log, there is a parse exception with one of the plugin.json files on the server.
      To get around the problem, you'd have to pinpoint the BigSheets application that has the problem and delete it in the Applications tab. Once you delete that application, you should be able to use the publish from Eclipse again.
      To help us identify what caused the problem in the first place it would be good if you can send us the plugin.json or the app itself that caused the problem. Before deleting the app from the server, you can import it into Eclipse. From the Eclipse tooling, in the BigInsights servers view, you can expand the node for the published applications. Once you right-mouse button click on an application that caused the problem, you select "Import application from BigInsights server" and select a BigInsights project as the target (create a new BigInsights project before). After the import is done, you have all the application artifacts in the BigInsights project. If you can send us either the application.zip file (which has all the artifacts) or at least the plugin.json, that would be helpful.

      Thanks
      Thomas