Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Database Server Instance is a RDBMS server instance which is used as a data store for the applications running under a tenant domain. <Add a better introduction>

This functionality is provided by the following feature in the WSO2 feature repository.

Name : RSS Manager Feature
Identifier : org.wso2.carbon.rssmanager.feature.group

This feature can be installed/uninstalled from a running Carbon instance using the instructions given in section Installing FeaturesThis database server instance is used to store database servers, database instance information, users etc..

Follow the instructions below to create a database service instance.

  1. First, configure Storage Server to connect to your metadata repository. This can be done in <PRODUCT_HOME>/repository/conf/etc/rss-config.xml file. The metadata repository stores all metadata related to each database accessed through this server instance, such as the users of a given database, time of creation, privilege templates of the users etc. 

    For example, the following sample configuration uses a MySQL database by the name rssdb as the metadata repository.

    Code Block
    languagehtml/xml
    <!-- RSS database used to store database servers, database instance information, users etc.. -->
    <rss-mgt-repository>
        <datasource-config>
           <dataSourceClassName>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</dataSourceClassName>
           <dataSourceProps>
              <property name="url">jdbc:mysql://localhost:3306/rssdb</property>
              <property name="user">root</property>
              <property name="password">root</property>
           </dataSourceProps>
        </datasource-config>
    </rss-mgt-repository>
    Info

    The database user should have super admin privileges.


  2. The metadata repository should have a set of tables for metadata storage. Create these tables in the database mentioned in step 1 (rssdb in this example) by executing the script <PRODUCT_HOME>/dbscripts/mysql/wso2_rss_mysql.sql on the database.

  3. Log in to the Storage Server management console and select Database Server Instances in the Configure menu.

  4. Click the Add Server Instance link, fill in the details and click Save to complete. For example,
      

    FieldDescription
    Database Server Instance NameName of the database instance.
    Server Category
    • RDS - Use this option if your relational database server setup is in the Amazon cloud. 
    • Local - Use this option if your relational database setup is installed locally.
    TypeOnly MySQL is supported in this release. Support for Oracle, DB2 and other popular relational database management systems will be added in future releases.
    JDBC URL 
    Administrative username and password 

    You can use this database server instance when creating databases to store and manage data related to applications running on a particular domain. See Creating Databases for Application Data.