12 Replies Latest reply on Aug 29, 2013 10:00 AM by Mark Addleman

    installation guide apparently missing?

    vodana carr Newbie

      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

        • 1. Re: installation guide apparently missing?
          Ramesh Reddy Master

          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..

          • 2. Re: installation guide apparently missing?
            Steven Hawkins Master

            > 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.

            • 3. Re: installation guide apparently missing?
              vodana carr Newbie

              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

              • 4. Re: installation guide apparently missing?
                Ramesh Reddy Master

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

                 

                Also above shows it is invoking the domain stuff..

                • 6. Re: installation guide apparently missing?
                  vodana carr Newbie

                  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.

                  • 7. Re: installation guide apparently missing?
                    Steven Hawkins Master

                    > 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 help@jboss.org 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.

                    • 8. Re: installation guide apparently missing?
                      vodana carr Newbie

                      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>

                      • 9. Re: installation guide apparently missing?
                        Steven Hawkins Master

                        > 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.

                        • 10. Re: installation guide apparently missing?
                          Ramesh Reddy Master

                          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..

                          • 11. Re: installation guide apparently missing?
                            vodana carr Newbie

                            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.

                            • 12. Re: installation guide apparently missing?
                              Mark Addleman Master

                              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!