Getting Started Guide

Red Hat JBoss Data Virtualization 6.3

Learn how to perform a basic installation of Red Hat JBoss Data Virtualization and perform some rudimentary tasks with the product.

David Le Sage


1. Goals of This Guide

Businesses increasingly need to access data residing in multiple disparate data sources. Therefore, you need to consider ways of making this information readily available for them to use.

Red Hat JBoss Data Virtualization is a data integration solution used to integrate data from sources such as relational databases, text files, web services, and ERP/CRM mainframe systems, as well as "big data" datasources such as Apache Hadoop (Hive) and MongoDB.

Red Hat JBoss Data Virtualization provides a unified virtualized view of information combined from multiple disparate sources. It hides details from the end user about the physical data sources, such as location, structure, API, access language and storage technology. This allows for more effort to be spent on data analysis and manipulation rather than on technical issues regarding the physical separation of the data. A virtual database (VDB) is used to map physical data sources to integrated views. At runtime, queries submitted against these views are coordinated among the dependent physical data sources, according to query criteria and the mappings defined by the VDB.

By following this guide, you will be taught how to download and install the product for testing in a non-production environment. (If you want to learn about installing on production systems, please refer to the Red Hat JBoss Data Virtualization Installation Guide.)

2. Key Components

A complete JBoss Data Virtualization solution consists of the following:

The Server
The server is positioned between business applications and one or more data sources. It coordinates integration of these data sources so they can be accessed by the business applications at runtime.
Design Tools
Various design tools are available to assist users in setting up JBoss Data Virtualization for a particular data integration solution.
Administration Tools
Various management tools are available for administrators to configure and monitor JBoss Data Virtualization.

3. Minimum Hardware Requirements

  • 16 GB Java Virtual Machine memory size
  • A modern multi-core processor or a multi-socket system with multi-core processors
  • 20 GB or more disk space for the JBoss server product and DV components. This will consist of:

    • 1 GB disk for installed product files
    • 5 GB or more for log files and deployed artifacts
    • 15 GB (default) for BufferManager maxBufferSpace
    • If Modeshape is used, you will need an additional 5 GB or more of filespace.

This will suffice for your development or testing system. For a more detailed discussion of system requirements when you later go to install Red Hat JBoss Data Virtualization on a production system, please refer to the Installation Guide.

4. Downloading and Installing the Product

4.1. Prerequisites

  • Red Hat Customer Portal Account
  • Adequate minimum system resources
  • Administrative Security privileges for your chosen installation directory
  • JAVA_HOME and PATH have been set in the Environment properties (for shortcuts to work on Microsoft Windows servers.)
  • Java Developer Kit 6, 7 or 8.
  • Java Virtual Machine. You can use the JVM installed with your JDK or an alternative such as OpenJDK.

4.2. Download JBoss Data Virtualization Installer

  1. Go to
  2. Click Log in and enter your Red Hat Login and Password to access the Customer Portal. You will need to register for an account if you do not yet have one.
  3. Click Downloads ⇒ Red Hat JBoss Data Virtualization.
  4. Click Download (next to the Red Hat JBoss Data Virtualization [Version] Installer) option.
  5. Save the file.

4.3. Install JBoss Data Virtualization

Red Hat JBoss Data Virtualization is installed using a graphical wizard. The following instructions will guide you step-by-step through this graphical installer. In this example, we will be using default options to install the standalone version. The purpose of this Guide is to teach you how to install the product in a development or testing environment.

  1. Open a command line window and navigate to the directory in which the GUI installer was downloaded.
  2. Enter the following command to launch the GUI installer:

    java -jar jboss-dv-VERSION-installer.jar
  3. A dialogue box will open followed by the End User License Agreement. If you accept the terms of the agreement, click I accept the terms of this license agreement and then click Next.
  4. Tell Red Hat JBoss Data Virtualization where Red Hat JBoss EAP is installed on your server or specify a new location if you do not have it installed as it comes bundled with the product. (If you have a pre-existing installation of Red Hat JBoss EAP, ensure that it is patched to the latest version of 6.4.x.) Click Next.
  5. Ensure Teiid Installation and Modeshape Installation are selected. Click Next.
  6. You will be prompted to create a new EAP Admin, Dashboard Admin, Teiid data access user, and ModeShape user. You will also be asked if you want to enable OData access and a logging role. Once created, these are added to the AdminRealm and can be used to access the Management Console and other applications secured using ManagementRealm. Enter the new username and password in the appropriate fields and click Next.


    Ensure that you remember all of these passwords. They give you access to different parts of the system. The EAP account and password allows you to administer the EAP Server, the Dashboard password is for administrative functions related to the web interface, and the Teiid data access user and ModeShape user are for standard user access.


    The username and password are not allowed to match and the password must have at least eight characters, with one alphabetical character, one numeric character, and one non-alpha-numeric character.

  7. Select Perform default configuration. The database logging configuration is the only option selected by default. Click Next.
  8. The Configure password vault screen appears. Input your desired password, which must have no fewer than six characters. Click Next.


    The H2 database (used as the default for the Vault) is not suitable for production databases. Use it in testing and evaluation environments only.

    A summary of the installation is displayed. Click Next for the installation to commence. This may take a few moments. Once all the components are installed, click Next again.

  9. Click Generate an installation script and properties file if you wish to generate a script for automatic future installations. This script allows you to quickly reinstall or mass-deploy the product using the settings you have configured during the initial installation, without having to step through the wizard each time.
  10. Make a note of the URLs of the Administration Console and the Data Virtualization Dashboard and click Done to exit the installer.

Note that after installing Red Hat JBoss Data Virtualization, if you move the product to another location, you may see some FileNotFound exceptions. This is because some filepaths are hard-coded by the JBoss EAP Server.


If you attempt to use a vault with a keystore created with a different JDK than the one in which the data is stored, your server will fail to start. You must consistently use the same JDK when accessing the vault.

5. Starting and Stopping Red Hat JBoss Data Virtualization

5.1. Starting Red Hat JBoss Data Virtualization

  1. To run Red Hat JBoss Data Virtualization, you must first start the JBoss EAP server. To start the JBoss EAP server, follow the instructions below for your operating system:

    • For Red Hat Enterprise Linux, open an command line window and enter this command from your EAP_HOME directory:

    • For Microsoft Windows, open a command-line window and enter these commands:

      chdir EAP_HOME/bin
  2. To ensure that the server has started correctly and to verify that there have been no errors, check the server log: EAP_HOME/MODE/log/server.log

You can also verify the execution was error-free by opening the Management Console in a web browser and logging in using the username and password of a registered JBoss EAP Management User. The console’s address is http://localhost:9990/console/ (For more information about using the Management Console see the Red Hat JBoss Enterprise Application Platform Administration and Configuration Guide.)


For more advanced starting options, see the Red Hat JBoss Enterprise Application Platform Administration and Configuration Guide.

5.2. Stopping Red Hat JBoss Data Virtualization

To stop Red Hat JBoss Data Virtualization, halt the JBoss EAP Server. Do this by pressing Ctrl+C in the terminal in which EAP is running.

6. Further Steps

Having worked through this book, Red Hat recommends that you read the Quick Starts Guide next as it provides information to help you start using this product. Quick starts are sample projects. By examining them, you can learn about functionality. You can also use them as templates for modeling your own business solutions.