Blog

Get Start Teiid From Source Code

Posted by Kylin Soong on Apr 7, 2016 categorized as teiid

Install from source code

To build Teiid

The following are prerequisites to build Teiid:

  1. install JDK 1.7 or higher
  2. install maven 3 - http://maven.apache.org/download.html
  3. Set Up Git - https://help.github.com/articles/set-up-git/
  4. Create a github account and fork Teiid

Enter the following:

$ git clone https://github.com/<yourname>/teiid.git
$ cd teiid
$ mvn clean install -P release -Dmaven.javadoc.skip=true -s settings.xml

To install Teiid

Standalone Mode

$ unzip build/target/teiid-9.0.0.Alpha3-SNAPSHOT-wildfly-server.zip
$ cd teiid-9.0.0.Alpha3-SNAPSHOT/
$ ./bin/standalone.sh  
$ ./bin/jboss-cli.sh --connect --file=bin/scripts/teiid-standalone-mode-install.cli

Domain Mode

$ unzip build/target/teiid-9.0.0.Alpha3-SNAPSHOT-wildfly-server.zip
$ cd teiid-9.0.0.Alpha3-SNAPSHOT/
$ ./bin/domain.sh  
$ ./bin/jboss-cli.sh --connect --file=bin/scripts/teiid-domain-mode-install.cli

quickstart.sh

quickstart.sh is a automatically shell, execute

$ ./quickstart.sh // need download quickstart.sh to Teiid server home.
$ ./quickstart.sh ${path}/teiid-${version}

will do the following task automatically

  1. Clone teiid-quickstarts to Teiid Server Home
  2. Creat Application Users and Management User
  3. Start Teiid Server
  4. Run vdb-datafederation
  5. Run vdb-materialization
  6. Run vdb-restservice

Create User

The User including dashboardUser, teiidUser, restUser, odataUser, ManagementUser, use create-user script to create:

$ ./bin/add-user.sh -a -u dashboardAdmin -p password1! -g admin  
$ ./bin/add-user.sh -a -u teiidUser -p password1! -g user  
$ ./bin/add-user.sh -a -u restUser -p password1! -g rest  
$ ./bin/add-user.sh -a -u odataUser -p password1! -g odata  
$ ./bin/add-user.sh admin password1!

Run Quick Start

If teiid-quickstart not exist under WildFly Home, Clone it to WildFly Home:

$ git clone https://github.com/teiid/teiid-quickstarts.git

vdb-datafederation

$ cp -r teiid-quickstarts/vdb-datafederation/src/teiidfiles/ ./
$ ./bin/jboss-cli.sh --connect --file=teiid-quickstarts/vdb-datafederation/src/scripts/setup.cli
$ cd standalone/deployments/
$ cp ../../teiid-quickstarts/vdb-datafederation/src/vdb/portfolio-vdb.xml* ./

PortfolioCient

vdb-materialization

Refer to vdb-datafederation section, make sure all setps are setup completely and correctly.

$ cd standalone/deployments/
$ cp ../../teiid-quickstarts/vdb-materialization/src/vdb/portfolio* ./

PortfolioMaterializeClient

PortfolioInterMaterializeClient

vdb-restservice

Refer to vdb-datafederation section, make sure all setps are setup completely and correctly.

$ cd standalone/deployments/
$ cp ../../teiid-quickstarts/vdb-restservice/src/vdb/portfolio-rest-vdb.xml* ./
  • Simple Web Client - Open a web broswer, entry the following API will extract data from the VDB:
http://localhost:8080/PortfolioRest_1/Rest/foo/1
http://localhost:8080/PortfolioRest_1/Rest/getAllStocks
http://localhost:8080/PortfolioRest_1/Rest/getAllStockById/1007
http://localhost:8080/PortfolioRest_1/Rest/getAllStockBySymbol/IBM

NOTE: http://localhost:8080/PortfolioRest_1/api will list all API.

  • HTTP Java Client
$ cd teiid-quickstarts/vdb-restservice/http-client/
$ mvn package exec:java
  • Resteasy client
$ cd teiid-quickstarts/vdb-restservice/resteasy-client
$ mvn package exec:java