Red Hat Training

A Red Hat training course is available for Red Hat JBoss Data Virtualization

Chapter 9. Integrating Red Hat JBoss Data Virtualization with Red Hat JBoss Data Grid

9.1. Installing in Domain Mode

When you have more than one Red Hat JBoss EAP instance in your server farm and you start them all in domain mode, all of the configuration options for this server farm can be centrally managed. For example, you can deploy a VDB or create a data source across all the instances, with one single CLI-based call. Red Hat JBoss Data Virtualization extends this configuration concept to allow you to deploy your VDBs and translators across the whole server farm.
When domain mode is combined with the "HA (high availability)" profile, you can cluster the Red Hat JBoss EAP server instances that are deployed. (The HA profile is set as the default in the "domain.xml" file.) When you start the server using the "domain.xml" file, the distributed caching that is used for ResultSet caching and Internal Materialized caching is automatically configured. The usage of Admin API is same in both standalone mode and domain mode.
When multiple Red Hat JBoss Data Virtualization instances are available in a cluster, you can make use load balancing and fail-over features.
  1. To start the server in "Domain" mode, install Red Hat JBoss Data Virtualization on all the servers that are going to be part of the cluster. Select one of the servers as the "master" domain controller. (The rest of the servers will be slaves that connect to the "master" domain controller for all the administrative operations.)
  2. Once you have configured all the servers, start the "master" node: /bin/domain.sh
  3. Start the "slave" nodes: /bin/domain.sh
    The slave nodes fetch their domain configuration settings from the "master" node.
    See the section "Start JBoss EAP 6 as a Managed Domain" for more information.
  4. Once all the servers are running, complete the installation to run in domain mode by executing this command on the "master" node: /bin/jboss-cli.sh --file=[JBOSS_HOME_DIR]/cli-scripts/teiid-domain-mode-install.cli
    This only needs to be run once per domain (cluster) install. This script will install Red Hat JBoss Data Virtulization in the ha and full-ha profiles. It will also re-configure the main-server-group to start the HA profile. Once in domain mode, you can not statically deploy resources by dropping them in the domain/deployments directory, so this script will deploy the default resources (such as file, ldap, salesforce and ws connectors) using the CLI interface.
  5. If you need to install Red Hat JBoss Data Virtualization in profiles other than HA, edit the teiid-domain-mode-install.cli file before installing it, and make the appropriate changes to the profile, socket-bindings, and server-groups.
  6. Once VDBs have been deployed, users can now connect their JDBC applications to Red Hat JBoss Data Virtualization.

Note

Teiid Designer cannot connect to the Red Hat JBoss Data Virtualization Server in "domain" mode. Red Hat recommends using other types of deployment strategies (such as CLI, web-console) for deploying and testing, as it is expected you will be using Domain mode in production environments. Teiid Designer is to aid development-time activities only and should thus only be used in testing environments.