WARNING this article is out of date - please refer to more recent documentation.

Teiid 7.0 installation is entirely different from previous versions. Previously Teiid could be installed as a standalone or embedded server. Starting with this release Teiid needs to be installed into an existing JBoss AS installation.  Teiid does not support the "embedded" mode in 7.0 version.

Installation:

1) Download the JBoss AS 5.1.0 application server. Install the server by unzipping into a known location. Ex: /apps/jboss-5.1.0

2) Download Teiid 7.0M3 . Unzip the downloaded artifact inside any "profiles" inside the JBoss AS installation. We suggest using either "default" or "all". Teiid 7.0 for the administrative purposes uses a service called "profile service" that is only installed in "default" and "all" profiles, so installing into one  of these profiles is required.  Ex: /apps/jboss-5.10/server/default

3) Start the JBoss AS server by executing "/apps/jboss-5.1.0/bin/run.sh" if you installed in the "default" profile. Other wise use "/apps/jboss-5.1.0/bin/run.sh -c <profilename>"

4) That it!. JBoss AS and Teiid are now installed and running.  See below instructions to customize various settings.

5)  Users can now connect their JDBC applications to Teiid using these instructions.

Directory Structure

The below file structure shows the contents of the Teiid 7.0 deployment. This directory structure is "exactly" same as what is under any JBoss profile directory structure like "default"

teiid
  /conf
     /props
        teiid-security-roles.properties
        teiid-security-users.properties
     jboss-teiid-log4j.xml
  /deploy
     /teiid
         /connectors
         teiid-jboss-beans.xml
         teiid-connector-templates-jboss-beans.xml
     admin-console.war
  /deployers
     /teiid.deployer
  /lib
  /teiid-examples

/deploy/teiid/teiid-jboss-beans.xml

Master configuration file for Teiid system. This file contains its own documentation, so refer to the file for all the available properties to configure.

/deploy/teiid/connectors

This directory contains all the connector RAR files that are supplied as part of the Teiid installation.

/conf/props

                      /teiid-security-users.properties

                      /teiid-security-roles.properties

These files define the allowed users and their defined roles in Teiid using the default security domain. Edit these files to add uses. If you want to use a different security domain look for details in main configuration file.

/conf/jboss-teiid-log4j.xml

This file contains the Teiid specific logging contexts to be included in the "jboss-log4j.xml" file.  If you need to turn ON or OFF specific logging in Teiid, then copy the contents of this file into "jboss-log4j.xml" in the installation directory.  See the Server Extension Guide for more on logging.

admin-console.war

This file has the required files for Teiid JOPR plugin. To see the Teiid's "admin-console", go to http://<host>:<port>/admin-console

/deployers/teiid.deployer

This directory contains Teiid runtime specific configuration files and its libraries. These configuration files define VDB deployers, connector binding deployers etc. Typically user never need to edit any files in this directory.

lib

This directory contains Teiid client libraries. It has the Teiid JDBC driver jar, "teiid-{version}-client.jar", and also contains "teiid-hibernate-dialect-{version}.jar" that contains Teiid's Hibernate dialect.

teiid-examples

This directory contains some examples of how Teiid can be used. Contains artifacts need by the Getting Started Guide. Also contains some sample XML files to define the connectors.