Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Instructions on how to migrate from WSO2 Business Activity Monitor 2.x to WSO2 DAS are as follows.

...

Before running the <DAS_HOME>/bin/analytics-migrate.sh script, the event table(s) that serve as the destination for migrated data should be defined in WSO2 DAS. For more information on event tables, see Analytics event tableFollow the procedure below to create the required event tables by copying the relevant stream definitions from WSO2 BAM.

 

  1. Log into the WSO2 BAM Management Console, and go to the Main tab.
  2. Under Registry, click Browse to open the Browse page.
  3. Navigate to <Top_Folder>/system/governance/StreamDefinitions/<relevant_event_stream>/<relevant_stream_version> as shown in the example below.
    Image Added
  4. Click on the stream version. This will open the Detail View tab for the event stream version you selected.
  5. Click Display as Text to view the event stream configuration as a JSON array.
    Image Added 
  6. Copy the JSON array to the clipboard.
  7. Log into the DAS Management Console and go to the Main tab.
  8. Click Streams to open the Available Event Streams page.
  9. Click Add Event Streams to open the Define New Event Stream page.
  10. Click switch to source view.
  11. Clear the existing text in the source view and paste the JSON array you copied to the clipboard.
  12. Click Add Event Stream.
  13. If you want the event stream to persist events, follow the instructions in Persisting Data for Batch Analytics.

 

Alternatively, you can redefine the complete event stream configuration as described in Understanding Event Streams and Event Tables.


Sample command

Code Block
languagepowershell
./analytics-migrate.sh -serverUrl <DAS_SERVER_URL> -cassandra_Url <CASSANDRA_URL> -serverPort <DAS_PORT> -columnFamily <COLUMN_FAMILY-NAME> -analyticTable <ANALYTICS_TABLE_NAME> -batchSize 1000 -tenantId -1234 -username <CASSANDRA_SERVER_USERNAME> -password <CASSANDRA_SERVER_PASSWORD> -cassandraPort <CASSANDRA_PORT> -clusterName <CLUSTER_NAME>

...

Toolboxes concept of WSO2 Business Activity Monitor is replaced in WSO2 DAS by a CAR file based deployment approach. Since you need to map Hive queries to the Apache Spark syntax that is supported by WSO2 DAS, you cannot directly upload WSO2 BAM (2.x versions) toolboxes to WSO2 DAS. Thereby, you need to wrap all the artifacts (stream definitions, event receivers, event stores, event publishers, Spark scripts etc.) in a .car file and upload it to WSO2 DAS. For instructions on how to create a Carbon application with the CAR extension, see Carbon Application Deployment for DAS. However, you can use the analytics migration tool to migrate the data from Cassandra to the DAS datasource.