Creating a cluster of WSO2 Identity Server instances is very similar to clustering other WSO2 products (see Clustering Business Process Server for details). To ensure that the instances share governance registry artifacts, you create a JDBC mount. At a high level, you take the following steps to cluster Identity Server:
- Install Identify Server on each node.
- Create the registry database.
Configure the WSO2_CARBON_DB data source in
<IS_HOME>/repository/conf/datasources/master-datasources.xml
on node 1 to point to the registry database with the correct URL, username, password, and driver class name. For example:Code Block language none <datasource> <name>WSO2_CARBON_DB</name> <description>The datasource used for registry and user manager</description> <jndiConfig> <name>jdbc/WSO2CarbonDB</name> </jndiConfig> <definition type="RDBMS"> <configuration> <url>jdbc:mysql://localhost:3306/reg_db</url> <username>regadmin</username> <password>regadmin</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 clustering on node 1 in
<IS_HOME>/repository/conf/axis2/axis2.xml
by setting the clustering element to true:
Repeat steps 3 and 4 on node 2, but name the data source WSO2_CARBON_DB_IS.
<clustering class="org.apache.axis2.clustering.tribes.TribesClusteringAgent" enable="true"> On node 2, open
<IS_HOME>/repository/conf/registry.xml
and add the following entries to configure access to the remote registry instance and to create the mount:Code Block language none <dbConfig name="wso2registry_registry"> <dataSource>jdbc/WSO2CarbonDB_IS<WSO2CarbonDB</dataSource> </dbConfig> <remoteInstance url="https://localhost:9443/registry"> <id>instanceid</id> <dbConfig>wso2registry_registry</dbConfig> <readOnly>false</readOnly> <enableCache>true</enableCache> <registryRoot>/</registryRoot> </remoteInstance> <mount path="/_system/config" overwrite="true"> <instanceId>instanceid</instanceId> <targetPath>/_system/nodes</targetPath> </mount> <mount path="/_system/governance" overwrite="true"> <instanceId>instanceid</instanceId> <targetPath>/_system/governance</targetPath> </mount>
- If both nodes are running on the same server, set the port offset.
- Start the nodes and verify in the registry browser that the governance collection is shown with the symlink icon.
...