installation guide apparently missing?

[vodana]

Hi there, I am new to Teiid and I am having a pretty miserable time trying to find any info on how to install it.

Firstly, there is the download page Downloads - JBoss Community , which has an 'install section' that only lists requirements. it does have a link to teiid quickstarts, the README's of which assumes you have already installed teiid (ie tells you to run ./standalone.sh -c standalone-teiid.xml).

Trying another approach, I found the Teiid designer quick start guide (Teiid Designer 8.0 Quick Start Guide) that has a link to the teiid install guide (https://docs.jboss.org/author/display/teiid82final/Installation+Guide) but unfortunately my jboss login wont allow me to see that, possibly because the link has 'author' in it?

googling returns nothing useful for teiid install guide. I can find some version 7 or earlier guides, maybe i can try those.

Any help welcome.

Thanks,

Vodana

[rareddy]

Vodana,

Firstly, there is the download page Downloads - JBoss Community , which has an 'install section' that only lists requirements. it does have a link to teiid quickstarts, the README's of which assumes you have already installed teiid (ie tells you to run ./standalone.sh -c standalone-teiid.xml).

Checkout the Administrator's Guide for full installation instructions. For standalone mode, it is as easy as "unzipped" the archive on top of the JBoss AS 7 installation directory and starting with command you mentioned above. We will fix the downloads page.

Trying another approach, I found the Teiid designer quick start guide (Teiid Designer 8.0 Quick Start Guide) that has a link to the teiid install guide (https://docs.jboss.org/author/display/teiid82final/Installation+Guide) but unfortunately my jboss login wont allow me to see that, possibly because the link has 'author' in it?

Can you see any other Teiid documents, all users (even without JBoss.org login) can view the documents, only users with login credentials can add comments. Looks like some configuration issue.

googling returns nothing useful for teiid install guide. I can find some version 7 or earlier guides, maybe i can try those.

Good question again, I am not sure why google not indexing the Teiid documents, we will look into it.

Thanks

Ramesh..

[shawkins]

> Can you see any other Teiid documents, all users (even without JBoss.org login) can view the documents, only users with login credentials can add comments. Looks like some configuration issue.

That has been corrected now for all of the Teiid spaces.

[vodana]

Ramesh, Steven, thanks for looking.

I can now access the administrator guide.

Unzipping the archive gives me some problems though..

Unzip the teiid-8.4.0.Final-jboss-dist.zip file into the root of $JBOSS_HOME. Following the instructions to start the server i get errors. The problem seems to be the line '<server xmlns="urn:jboss:domain:1.4">' in standalone-teiid.xml. in standalone.xml in that directory the line is'<server xmlns="urn:jboss:domain:1.2">'. I tried changing the line to be that in standalone-teiid.xml that but then i get other errors about jsf module not being available. See below for command and the output.

h@x:/teiid/jboss-as-7.1.1.Final/bin$ ./standalone.sh --server-config=standalone-teiid.xml

=========================================================================

  JBoss Bootstrap Environment

  JBOSS_HOME: /teiid/jboss-as-7.1.1.Final

  JAVA: /home/h/bin/jdk1.6.0_34/bin/java

  JAVA_OPTS:  -server -XX:+TieredCompilation -Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=true -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Djboss.modules.system.pkgs=org.jboss.byteman -Djava.awt.headless=true -Djboss.server.default.config=standalone.xml

=========================================================================

15:28:42,397 INFO  [org.jboss.modules] JBoss Modules version 1.1.1.GA

15:28:42,585 INFO  [org.jboss.msc] JBoss MSC version 1.0.2.GA

15:28:42,638 INFO  [org.jboss.as] JBAS015899: JBoss AS 7.1.1.Final "Brontes" starting

15:28:42,951 ERROR [org.jboss.as.server] JBAS015956: Caught exception during boot: org.jboss.as.controller.persistence.ConfigurationPersistenceException: JBAS014676: Failed to parse configuration

  at org.jboss.as.controller.persistence.XmlConfigurationPersister.load(XmlConfigurationPersister.java:141) [jboss-as-controller-7.1.1.Final.jar:7.1.1.Final]

  at org.jboss.as.server.ServerService.boot(ServerService.java:266) [jboss-as-server-7.1.1.Final.jar:7.1.1.Final]

  at org.jboss.as.controller.AbstractControllerService$1.run(AbstractControllerService.java:155) [jboss-as-controller-7.1.1.Final.jar:7.1.1.Final]

  at java.lang.Thread.run(Thread.java:662) [rt.jar:1.6.0_34]

Caused by: javax.xml.stream.XMLStreamException: ParseError at [row,col]:[3,1]

Message: Unexpected element '{urn:jboss:domain:1.4}server'

  at org.jboss.staxmapper.XMLMapperImpl.processNested(XMLMapperImpl.java:108) [staxmapper-1.1.0.Final.jar:1.1.0.Final]

  at org.jboss.staxmapper.XMLMapperImpl.parseDocument(XMLMapperImpl.java:69) [staxmapper-1.1.0.Final.jar:1.1.0.Final]

  at org.jboss.as.controller.persistence.XmlConfigurationPersister.load(XmlConfigurationPersister.java:133) [jboss-as-controller-7.1.1.Final.jar:7.1.1.Final]

  ... 3 more

15:28:42,958 FATAL [org.jboss.as.server] JBAS015957: Server boot has failed in an unrecoverable manner; exiting. See previous messages for details.

15:28:42,972 INFO  [org.jboss.as] JBAS015950: JBoss AS 7.1.1.Final "Brontes" stopped in 7ms

  JAVA: /home/h/bin/jdk1.6.0_34/bin/java

  JAVA_OPTS:  -server -XX:+TieredCompilation -Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=true -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Djboss.modules.system.pkgs=org.jboss.byteman -Djava.awt.headless=true -Djboss.server.default.config=standalone.xml

=========================================================================

15:28:42,397 INFO  [org.jboss.modules] JBoss Modules version 1.1.1.GA

15:28:42,585 INFO  [org.jboss.msc] JBoss MSC version 1.0.2.GA

15:28:42,638 INFO  [org.jboss.as] JBAS015899: JBoss AS 7.1.1.Final "Brontes" starting

15:28:42,951 ERROR [org.jboss.as.server] JBAS015956: Caught exception during boot: org.jboss.as.controller.persistence.ConfigurationPersistenceException: JBAS014676: Failed to parse configuration

  at org.jboss.as.controller.persistence.XmlConfigurationPersister.load(XmlConfigurationPersister.java:141) [jboss-as-controller-7.1.1.Final.jar:7.1.1.Final]

  at org.jboss.as.server.ServerService.boot(ServerService.java:266) [jboss-as-server-7.1.1.Final.jar:7.1.1.Final]

  at org.jboss.as.controller.AbstractControllerService$1.run(AbstractControllerService.java:155) [jboss-as-controller-7.1.1.Final.jar:7.1.1.Final]

  at java.lang.Thread.run(Thread.java:662) [rt.jar:1.6.0_34]

Caused by: javax.xml.stream.XMLStreamException: ParseError at [row,col]:[3,1]

Message: Unexpected element '{urn:jboss:domain:1.4}server'

  at org.jboss.staxmapper.XMLMapperImpl.processNested(XMLMapperImpl.java:108) [staxmapper-1.1.0.Final.jar:1.1.0.Final]

  at org.jboss.staxmapper.XMLMapperImpl.parseDocument(XMLMapperImpl.java:69) [staxmapper-1.1.0.Final.jar:1.1.0.Final]

  at org.jboss.as.controller.persistence.XmlConfigurationPersister.load(XmlConfigurationPersister.java:133) [jboss-as-controller-7.1.1.Final.jar:7.1.1.Final]

  ... 3 more

15:28:42,958 FATAL [org.jboss.as.server] JBAS015957: Server boot has failed in an unrecoverable manner; exiting. See previous messages for details.

15:28:42,972 INFO  [org.jboss.as] JBAS015950: JBoss AS 7.1.1.Final "Brontes" stopped in 7ms

[rareddy]

Teiid 8.4 works with EAP 6.1 Alpha, not JBoss 7.1.1.Final.

Also above shows it is invoking the domain stuff..

[rareddy]

Also updated "install" instructions at http://www.jboss.org/teiid/downloads

[vodana]

on the downloads page it still says

• JBoss AS7.1.1 for Teiid 8.x (JBoss 5.1.0 for Teiid 7.x)

but that isnt correct for 8.4 is it? as per my earlier post with error message. I now see there is another note in another part of the page saying to use 6.1 EAP, unfortunately I didnt see that first time round.

another issue i am having... posting to this forum. when i try to reply to this thread i just get 'error'. trying to post a new question i get told 'can only make new post once every 3600 seconds'. more than a little frustrating.

[shawkins]

> but that isnt correct for 8.4 is it?

Sorry for the confusion.  We've updated all of the AS version references on the download page now.  It should be clear how the versions match up.

> when i try to reply to this thread i just get 'error'. trying to post a new question i get told 'can only make new post once every 3600 seconds'. more than a little frustrating.

I've never seen that limitation.  You could email [e-mail] to see if something needs changed with the forum configuration.  It seems like it should be a smaller time window and at least send the post to the moderation queue rather than locking you out.

[vodana]

ok. thanks for the prompt replies.

As a Teiid newbie I have to say it is a bit of a concern to find such issues on my first encounter - just because 8.4 has been available for over 2 months, has every other newbie just worked it out for themselves in that time?

I now have the quickstarts working, but to get mvn commands going I had to add the following xml in order for it to get dependences, I also had to tweak the teiid version number.

None of this is a huge deal, but as I say my concern is that either all other newbies are happy to work all this out or actually there arent many new people trying the product. Data virtualization cant be that niche can it? How many active users of teiid are there?

<repositories>

    <repository>

      <id>my-repo1</id>

      <name>your custom repo</name>

      <url>https://repository.jboss.org/nexus/content/repositories/releases</url>

    </repository>

</repositories>

[shawkins]

> just because 8.4 has been available for over 2 months, has every other newbie just worked it out for themselves in that time?

You had the misfortune of zeroing in on an out-of-date reference.  The installation guide, the blog post, the other version reference on the download page, etc. would have lead you to the proper AS version.

> I now have the quickstarts working, but to get mvn commands going I had to add the following xml in order for it to get dependences

There may have been a built-in assumption that the suggested development settings.xml file was in use.  If that's not explicit in the quickstarts then yes the poms or the instructions need updated.

> I also had to tweak the teiid version number

Yes that does appear to be out of date.

> Data virtualization cant be that niche can it? How many active users of teiid are there?

There are no hard numbers on the active deployments of Teiid.  There are quite a few between the community and the EDS and now Data Virtualization product line.  So it's not necessarily a niche.  It's just that the issues that you encounter have encountered are due to the more rapid pace of change on the project side, while most of the hardening of documentation takes place on the product side.  But as always we'll make sure that anything that has been left out-of-date is addressed.

[rareddy]

As a Teiid newbie I have to say it is a bit of a concern to find such issues on my first encounter - just because 8.4 has been available for over 2 months, has every other newbie just worked it out for themselves in that time?

Teiid is no means a shiny new project, just look at the history, also Teiid has been in the community over 4 years. Redhat sells subscription to this product as Enterprise Data Services. So, rest assured this project is here to stay. 8.4 for the first time started using EAP version of JBoss AS, so you just caught us very old download page + a missing credentials to access a correct document pages.

As per the repository settings, the quick starts are being spun off as separate modules recently. Also, yes, we do not go at a depth in our documents to define the repository settings, it is kind of assumption we made that all JBoss developers know how to configure the maven to JBoss Maven repos.  We will update them to include the settings.xml.  So, far I have not seen any real issues that you encountered with the workings of project itself, if you do, we will fix as we are handling this issue.

Ramesh..

[vodana]

Thanks again guys. I guess I have just been a bit unlucky so far. Now I have things working to try out, so hopefully it'll go well from here.

[markaddleman]

Hi, Vodana -

We've been using Teiid in a commercial, enterprise-grade product for about three years.  We started with Teiid ~7.7 and we're currently using 8.1 so we haven't encountered the issues you've run into.  That's not to say we haven't had issues, we have - as you would expect from any software project.  The thing about our Teiid issues is that the community  in general, and Steven and Ramesh, specifically, is fantastic.  Most of our issues have been resolved within a couple of business days of providing a test case.  In general, the documentation is first-class and forum questions are answered promptly.  I wish the commercially licensed software that we use had such good support.

I wish you happy Teiidering!