Page Comparison

...

Follow the steps below to point the user stores of all the nodes to a single user store database, and to mount all governance registries to a single registry and configuration registries to a single configuration registry.

Follow the steps below to configure the <DAS_HOME>/repository/conf/datasources/master-datasources.xml file as required

Enable the all the nodes to access the users database by configuring a datasource to be used by user manager as shown below.

Code Block

language	xml

<datasource>    
<name>WSO2UM_DB</name>
    <description>The datasource used by user manager</description>
    <jndiConfig>
    <name>jdbc/WSO2UM_DB</name>
    </jndiConfig>
    <definition type="RDBMS">
    <configuration>
        <url>jdbc:mysql://[MySQL DB url]:[port]/userdb</url>
        <username>[user]</username>
        <password>[password]</password>
        <driverClassName>com.mysql.jdbc.Driver</driverClassName>
        <maxActive>50</maxActive>
        <maxWait>60000</maxWait>
        <testOnBorrow>true</testOnBorrow>
        <validationQuery>SELECT 1</validationQuery>
        <validationInterval>30000</validationInterval>
    </configuration>
    </definition>
</datasource>

Enable the nodes to access the registry database by configuring the WSO2REG_DB data source as follows.

Code Block

language	xml

<datasource>
    <name>WSO2REG_DB</name>
    <description>The datasource used by the registry</description>
    <jndiConfig>
    <name>jdbc/WSO2REG_DB</name>
    </jndiConfig>
    <definition type="RDBMS">
    <configuration>
        <url>jdbc:mysql://[MySQL DB url]:[port]/regdb</url>
        <username>[user]</username>
        <password>[password]</password>
        <driverClassName>com.mysql.jdbc.Driver</driverClassName>
        <maxActive>50</maxActive>
        <maxWait>60000</maxWait>
        <testOnBorrow>true</testOnBorrow>
        <validationQuery>SELECT 1</validationQuery>
        <validationInterval>30000</validationInterval>
    </configuration>
    </definition>
</datasource>

For detailed information about registry sharing strategies, see the library article Sharing Registry Space across Multiple Product Instances.

Point to WSO2_ANALYTICS_EVENT_STORE_DB and WSO2_ANALYTICS_PROCESSED_DATA_STORE_DB in the <DAS_HOME>/repository/conf/datasources/analytics-datasources.xml file as shown below.

Code Block

language	xml

<datasources-configuration>
    <providers>
        <provider>org.wso2.carbon.ndatasource.rdbms.RDBMSDataSourceReader</provider>
    </providers>
 
    <datasources>
        <datasource>
            <name>WSO2_ANALYTICS_EVENT_STORE_DB</name>
            <description>The datasource used for analytics record store</description>
            <definition type="RDBMS">
                <configuration>
                    <url>jdbc:mysql://[MySQL DB url]:[port]/WSO2_ANALYTICS_EVENT_STORE_DB</url>
                    <username>[username]</username>
                    <password>[password]</password>
                    <driverClassName>com.mysql.jdbc.Driver</driverClassName>
                    <maxActive>50</maxActive>
                    <maxWait>60000</maxWait>
                    <testOnBorrow>true</testOnBorrow>
                    <validationQuery>SELECT 1</validationQuery>
                    <validationInterval>30000</validationInterval>
                    <defaultAutoCommit>false</defaultAutoCommit>
                </configuration>
            </definition>
        </datasource>
        <datasource>
            <name>WSO2_ANALYTICS_PROCESSED_DATA_STORE_DB</name>
            <description>The datasource used for analytics record store</description>
            <definition type="RDBMS">
                <configuration>
                    <url>jdbc:mysql://[MySQL DB url]:[port]/WSO2_ANALYTICS_PROCESSED_DATA_STORE_DB</url>
                    <username>[username]</username>
                    <password>[password]</password>
                    <driverClassName>com.mysql.jdbc.Driver</driverClassName>
                    <maxActive>50</maxActive>
                    <maxWait>60000</maxWait>
                    <testOnBorrow>true</testOnBorrow>
                    <validationQuery>SELECT 1</validationQuery>
                    <validationInterval>30000</validationInterval>
                    <defaultAutoCommit>false</defaultAutoCommit>
                </configuration>
            </definition>
        </datasource>
    </datasources>
</datasources-configuration>

For more information, see Datasources in DAS documentation.

To share the user store among the nodes, open the <DAS_HOME>/repository/conf/user-mgt.xmlfile and modify the dataSource property of the <configuration> element as follows.
Code Block
language xml
<configuration> ... <Property name="dataSource">jdbc/WSO2UM_DB</Property> </configuration>
Info
The datasource name specified in this configuration should be the same as the datasource used by user manager that you configured in sub step a, i.

In the <DAS_HOME>/repository/conf/registry.xml file, add or modify the dataSource attribute of the <dbConfig name="govregistry"> element as follows.

Code Block

language	xml

<dbConfig name="govregistry">
	<dataSource>jdbc/WSO2REG_DB</dataSource>
</dbConfig>
<remoteInstance url="https://localhost:9443/registry"> 
	<id>gov</id>
	<cacheId>user@jdbc:mysql://localhost:3306/regdb</cacheId>
	<dbConfig>govregistry</dbConfig>
	<readOnly>false</readOnly>
	<enableCache>true</enableCache>
	<registryRoot>/</registryRoot>
</remoteInstance>
<mount path="/_system/governance" overwrite="true">
	<instanceId>gov</instanceId>
	<targetPath>/_system/governance</targetPath>
</mount>
<mount path="/_system/config" overwrite="true">
	<instanceId>gov</instanceId>
	<targetPath>/_system/config</targetPath>
</mount>

Note

Do not replace the following configuration when adding in the mounting configurations. The registry mounting configurations mentioned in the above steps should be added in addition to the following.

Code Block

language	xml

<dbConfig name="wso2registry">
    <dataSource>jdbc/WSO2CarbonDB</dataSource>
</dbConfig>

Update the <DAS_HOME>/repository/conf/axis2/axis2.xml file as follows for he nodes to enable Hazlecast clustering.

To enable Hazlecast clustering, set the clustering class="org.wso2.carbon.core.clustering.hazelcast.HazelcastClusteringAgent" property to true as shown below.
Code Block
language xml
<clustering class="org.wso2.carbon.core.clustering.hazelcast.HazelcastClusteringAgent" enable="true">
To ensure that all the nodes in the cluster identify each other, enable the wka mode for all of them as shown below.
Code Block
language xml
<parameter name="membershipScheme">wka</parameter>

Add all the nodes in the cluster as well known members under the <members> element as shown below.

Info
In a fully distributed DAS setup, Apache Spark identifies the worker nodes that analyze data via Hazalcast clustering. Only the nodes that are assigned as analyzer nodes should be identified as Spark workers, they should be in a separate cluster.

For each of the two analyser nodes, list the members as shown below. This groups them in a separate cluster.

Code Block

language	xml

<members>
	<member>
		<hostName>[Analyzer1 IP]</hostName>
		<port>[Analyzer1 port]</port>
	</member>
	<member>
		<hostName>[Analyzer2 IP]</hostName>
		<port>[Analyzer2 port]</port>
	</member>
</members>

For the other nodes that are not analyser nodes, list the members as shown below.

Code Block

language	xml

<members>
	<member>
		<hostName>[indexer1 IP]</hostName>
		<port>[indexer1 port]</port>
	</member>
	<member>
		<hostName>[indexer2 IP]</hostName>
		<port>[indexer2 port]</port>
	</member>
	<member>
		<hostName>[Receiver1 IP]</hostName>
		<port>[Receiver1 port]</port>
	</member>
	<member>
		<hostName>[Receiver2 IP]</hostName>
		<port>[Receiver2 port]</port>
	</member>
</members>

For each node, enter the respective server IP address as the value for the localMemberHost property as shown below.
When you enable the HA mode for WSO2 DAS, state persistence is enabled by default. If there is no real time use case that requires any state information after starting the cluster, you should disable event persistence by setting the persistence attribute to false in the
Code Block
language xml
<parameter name="localMemberHost">[Server_IP_Address]</parameter>
Info

Update the <DAS_HOME>/repository/conf/event-processor.xml file as shown below. Code Block

language	xml

<persistence file of the nodes as follows.

Make sure that the HA mode is enabled as follows.
Code Block
language xml
<mode name="HA" enable="
false
true">
Enable the Distributed mode as shown below.
Code Block
language xml
Make sure that the HA mode is enabled as follows.
Code Block
language xml
<mode name="HA" enable="true">
Enable the Distributed mode as shown below.
Code Block
language xml
<mode name="Distributed" enable="true">

Set the following property for the two nodes that should function as presenter nodes.

Info
This property should be set only for the presenter nodes.

Code Block

language	xml

<mode

<persistenceIntervalInMinutes>15</persistenceIntervalInMinutes> <persisterSchedulerPoolSize>10</persisterSchedulerPoolSize> <persister class="org.wso2.carbon.event.processor.core.internal.persistence.FileSystemPersistenceStore"> <property key="persistenceLocation">cep_persistence</property> </persister> </persistence>

Tip

When state persistence is enabled for WSO2 DAS, the internal state of DAS is persisted in files. These files are not automatically deleted. Therefore, if you want to save space in your DAS pack, you need to delete them manually.

These files are created in the <DAS_HOME>/cep_persistence/<tenant-id> directory. This directory has a separate sub-directory for each execution plan. Each execution plan can have multiple files. The format of each file name is <TIMESTAMP>_<EXECUTION_PLAN_NAME> (e.g, 1493101044948_MyExecutionPlan). If you want to clear files for a specific execution plan, you need to leave the two files with the latest timestamps and delete the rest.

Update the <DAS_HOME>/repository/conf/event-processor.xml file of the nodes as follows.

<presenter enable="true"/>name="Distributed" enable="true">

Set the following property for the two nodes that should function as presenter nodes.
Info
This property should be set only for the presenter nodes.
Code Block
language xml
<presenter enable="true"/>

For each receiver node, enter the respective server IP address under the HA mode Config section as shown in the example below.

Info

When you enable the HA mode for WSO2 DAS, state persistence is enabled by default. If there is no real time use case that requires any state information after starting the cluster, you should disable event persistence by setting the persistence attribute to false in the <DAS_HOME>/repository/conf/event-processor.xml file as shown below.

Code Block

language	xml

<persistence enable="false">
    <persistenceIntervalInMinutes>15</persistenceIntervalInMinutes>
    <persisterSchedulerPoolSize>10</persisterSchedulerPoolSize>
    <persister class="org.wso2.carbon.event.processor.core.internal.persistence.FileSystemPersistenceStore">
        <property key="persistenceLocation">cep_persistence</property>
    </persister>
</persistence>

Tip

When state persistence is enabled for WSO2 DAS, the internal state of DAS is persisted in files. These files are not automatically deleted. Therefore, if you want to save space in your DAS pack, you need to delete them manually.

These files are created in the <DAS_HOME>/cep_persistence/<tenant-id> directory. This directory has a separate sub-directory for each execution plan. Each execution plan can have multiple files. The format of each file name is <TIMESTAMP>_<EXECUTION_PLAN_NAME> (e.g, 1493101044948_MyExecutionPlan). If you want to clear files for a specific execution plan, you need to leave the two files with the latest timestamps and delete the rest.

Code Block

language	xml

<!-- HA Mode Config -->
<mode name="HA" enable="true">
   ...
    <eventSync>
        <hostName>[Server_IP_Address]</hostName>

To define the two analyzer nodes as Spark masters, configure the <DAS_home>/repository/conf/analytics/spark/spark-defaults.conf file as follows.

Info
2 Sparkmasters are created because this cluster is a high-availability cluster. When the active spark master fails, the other node configured as a Spark master becomes active and continues to carry out the tasks os the Spark master.

Specify the number of Spark masters as 2 by setting the following property.
Code Block
language js
carbon.spark.master.count 2

Specify a DAS symbolic link for both nodes as shown in the example below.

Info
The directory path for the Spark Class path is different for each node depending on the location of the `<DAS_HOME>`. The symbolic link redirects the Spark Driver Application to the relevant directory for each node when it creates the Spark class path.

For more information about Spark related configurations, see Spark Configurations.

In order to share the C-Apps deployed among the nodes, configure the SVN-based deployment synchronizer. For detailed instructions, see Configuring SVN-Based Deployment Synchronizer.
Info
If you do not configure the deployment synchronizer, it is required to deploy any C-App you use in the fully distributed HA set up to all the nodes.

...

Versions Compared

Old Version 7

New Version 8

Key