Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 8

...

urlThe URL of the remote instance.
idRemote instance id.
usernameUsername of the remote registry login.
passwordPassword of the remote registry login.
type 

 

-

...

Set the type to ws.
cacheId

...

The identifier used in computing cache keys.

 

More You can attach more than one remote instance can be attached to a given WSO2 product by adding the relevant configuration details as seen above. Each Provide each remote instance must be given an identifier along with valid credentials that have sufficient privileges to perform the desired registry operations (requires at least read-privileges to the registry along with permission to log-in to the server). The URL of the remote instance can be deduced as follows:

...

...

...

The cache id is an optional parameter and should be used only if multi-node replicated caching is enabled. The cache id should be in the format of databaseUser@databaseURL. For example, the cache id for a remote instance running with the default embedded H2 database would will be, wso2carbon@jdbc:h2:repository/database/WSO2CARBON_DB.

Info
titleNote
You cannot mount the same server as a remote instance to itself.

Mount Configurations

Once a remote instance has been defined a collection on the remote registry can be mounted to the local instance.

path - Following is an example configuration of a mount.

Code Block
languagehtml/xml
<mount path="/_system/config" overwrite="true|false|virtual">
   <instanceId>instanceId</instanceId>
   <targetPath>/_system/nodes</targetPath> 
</mount>

Elements of the configuration are explained below.

pathThe path to which the mount will be added to.
overwrite

...

Optional. Defines whether an existing collection at the given path will be overwritten or not.
instanceId

...

Remote instance id.
targetPath

...

The path on the remote registry.

Here is an example configuration of a mount.

<mount path="/_system/config" overwrite="true|false|virtual"> <instanceId>instanceId</instanceId> <targetPath>/_system/nodes</targetPath> </mount>

 Once you have defined a remote instance, a collection on the remote registry can be mounted to the local instance.

 

Info
titleNote

It is recommended to refrain from mounting a target path under "/_system/governance" of a remote registry to path "/_system/config". Similarly, refrain from mounting a target path under "/_system/config" of a remote registry to path "/_system/governance". Such configurations can produce unpredictable results.

For example, with the following mounting configurations, "/_system/governance" will be mounted to the correct path, which is "/_system/governance/mounting/governance" but "/_system/config" will be mounted to " /_system/governance/mounting/governance/ mounting/config".

...

Code Block
languagehtml/xml
<mount path="/_system/config" overwrite="true"> 
   <instanceId>instanceId</instanceId> 
   <targetPath>/_system/governance/mounting/config</targetPath> 
</mount> 
<mount path="/_system/config" overwrite="true"> 
   <instanceId>instanceId</instanceId> 
   <targetPath>/_system/governance/mounting/governance</targetPath> 
</mount>

 

 

Enable Clustering 

To enable clustering for a node, the enable attribute of the configuration in $GREG_HOME/repository/conf/axis2/axis2.xml should file should be set to true as follows:

Code Block
languagehtml/xml
<clustering class="org.apache.axis2.clustering.tribes.TribesClusteringAgent" enable="true">

This configuration is responsible for the initialization of a node in the cluster and getting this node it to join the cluster. 

Description of remote instance and mount configuration details.