Instructions on how to migrate from WSO2 Business Activity Monitor 2.x to WSO2 DAS are as follows.
Migrating analytics data
The analytics data migration tool can be used to migrate the column family data of a WSO2 BAM 2.x server to WSO2 Data Analytics Server (DAS) 3.0.0. The <DAS_HOME>/bin/analytics-migrate.sh script serves as the analytics migration tool.
Prerequisites
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 table.
Sample command
./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>
Parameters
The arguments that can be used with the command are described below.
| Parameter | Description | Default Value | Example |
|---|---|---|---|
| Destination name of the table which will have the migrated data. | None | testTable |
| Name of the columnFamily to which analytics data will be migrated. | None | jmx_agent_toolbox |
| Tenant ID of the considered tenant. | super tenant | -1234 |
-serverUrl | DAS server URL | localhost | 10.100.5.73 |
-serverPort | DAS server port | 9443 | 9443 |
-cassandra_URL | The URL to access the Cassandra server. | 9160 |
|
-cassandraPort | Cassandra server port. | 9042 | 9042 |
-batchSize | Cassandra data is migrated from BAM to DAS in batches. This property specifies the size of a batch of data transferred at a given time. | 1000 | 1000 |
-username | The username to access the Cassandra server. | None | admin |
-passwords | The password to access the Cassandra server. | None | admin |
-clusterName | The name of the cluster to which the data should be migrated. | None | cluster001 |
Example
wso2das-3.0.0-SNAPSHOT/bin$ ./analytics-migrate.sh -analyticTable TESTTABLE -columnFamily TestCLMNFamily -port 9042 -serverUrl 192.168.200.130 -tenantId -1234
Migrating WSO2 BAM toolboxes
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.