WSO2 Governance Registry - User Guide [ Documentation Index ]

WSO2 Governance Registry - User Guide

Registry Configurations

The configurations for the registry is kept in the registry.xml which can be found inside the CARBON_HOME/conf/. You can configure various parameters of the registry in there. The following sub sections will describe these parameters in details. Note that in order to take effect these parameters, you have to restart the registry.

Configure Read-Only Registry

To run the registry in read-only mode set the 'readOnly' element to 'true'. Setting the read-only mode allows you to run an immutable instance of registry repository.

Configure Registry Root

In here, you can specify the absolute path of the collection which you wish to use as the root of this registry instance.

Database Configurations

Database configurations for the registry is in the following schema.


    <currentDBConfig>wso2registry</currentDBConfig>

    <dbConfig name="wso2registry">
        <url>jdbc:h2:database/WSO2CARBON_DB</url>
        <userName>wso2carbon</userName>
        <password>wso2carbon</password>
        <driverName>org.h2.Driver</driverName>
        <maxActive>50</maxActive>
        <maxWait>60000</maxWait>
        <minIdle>5</minIdle>
    </dbConfig>

url: The URL of the database
userName: The name of the database user
password: The password of the database user
maxActive: The maximum number of active connections that can be allocated from this pool at the same time, or negative for no limit.
maxWait: The maximum number of milliseconds that the pool will wait (when there are no available connections) for a connection to be returned before throwing an exception, or <= 0 to wait indefinitely.
minIdle: The minimum number of active connections that can remain idle in the pool, without extra ones being created, or 0 to create none.

In parellel you have to configure the user-mgt.xml in the same directory as registry.xml with the custom database settings. You can find the database configurations for the different databases in the respective installation guides.

Handler Configurations

You can use this to configure handlers and associate them with filters and custom properties. Example of handler configurations in registry.xml

    <handler class="org.wso2.carbon.registry.extensions.handlers.WSDLMediaTypeHandler">
        <property name="schemaLocationConfiguration" type="xml">
            <locationType>absolute</locationType>
            <location>/governance/schemas/</location>
        </property>
        <property name="wsdlLocationConfiguration" type="xml">
            <locationType>absolute</locationType>  <!-- absolute or relative -->
            <location>/governance/wsdls/</location>
        </property>
        <filter class="org.wso2.carbon.registry.core.jdbc.handlers.filters.MediaTypeMatcher">
            <property name="mediaType">application/wsdl+xml</property>
        </filter>
    </handler>

Please have a look at the Handler Developer Guide for more details.

Mounting Configuraions

In order to mount an external registry, you have to provide the following configuration in the registry.

id: Remote registry id
username: Username of the remote registry login
password: Password of the remote registry login

Here is an example configuration of mouting a registry running on localhost:9442

    <remoteInstance url="https://host:port/registry">
        <id>instanceid</id>
        <username>username</username>
        <password>password</password>
    </remoteInstance-->

Static (One-time) Configurations

You are suppose to change the static configuration section only before loading any data to the registry. (That is before the first startup.) The following configurations are possible in this section.

versioningProperties - Whether the properties are versioned when a snapshot is created. (Default is true).
versioningComments - Whether the comments are versioned when a snapshot is created. (Default is true).
versioningTags - Whether the tags are versioned when a snapshot is created. (Default is true).
versioningRatings - Whether the ratings are versioned when a snapshot is created. (Default is true).

Configure Auto Versioning Resources

You can configure whether you want to auto-version the resources (non-collection) by setting 'versionResourcesOnChange' element to 'true'. In this configuration it will create a version for the resources whenever it is updated.

WSO2 Governance Registry v3.0.2

Downloads

Documentation

Samples

Getting Help

Get Involved

Project Information