[jaikiran]

"ALRubinger" wrote:


Is this now fixed in the release you're using? I made some cleanup changes last week.

S,
ALR

Yes this has been resolved. The maven-jboss-as-control-plugin-0.1.0.jar does not have this issue.

[jaikiran]

"ALRubinger" wrote:

* Adding a Hudson run to verify everything is OK

I have configured a Hudson run against JBoss-5.0 GA locally, which i trigger after every major commit. The tutorials are now at a stage where we can configure a central Hudson run for verification.

"ALRubinger" wrote:


* Deploying the docs via DAV or some other mechanism to a www-accessible site

* Making an assembly of all docs together with an index for separate download

S,
ALR

We can discuss this. This week i am planning to beef up the tutorial "guide" (docs) to cover the 24 tutorials that are now runnable.

[alrubinger]

"jaikiran" wrote:
I have configured a Hudson run against JBoss-5.0 GA locally, which i trigger after every major commit. The tutorials are now at a stage where we can configure a central Hudson run for verification.

Cool. I think you should have permissions on my machine if you'd like to make a new Job there. Eventually we'll have to revisit putting all the jobs we need on JBossQA or the new lab machine.

S,
ALR

[jaikiran]

Most of the tutorials are now ready and even the guide for these working tutorials has been made available. The wiki has been updated with the steps to build the tutorials/guide https://www.jboss.org/community/docs/DOC-13215.

There are around 10 more tutorials remaining which i plan to take up this week. We can even discuss about making the guide available online during this week.

"ALRubinger" wrote:
I think you should have permissions on my machine if you'd like to make a new Job there.

Not enough permissions :) Can just login but can't create a job.

[jaikiran]

What remains on the tutorial part:

1) The "jca_inflow_quartz" tutorial which is being tracked here http://www.jboss.com/index.html?module=bb&op=viewtopic&t=148386 and will be fixed today

2) The "tableperinheritance" tutorial which is broken because of a issue in HSQLDB.
https://jira.jboss.org/jira/browse/EJBTHREE-1657

http://opensource.atlassian.com/projects/hibernate/browse/HHH-2920

I am planning to include this tutorial and add a note to the guide saying its broken on HSQLDB. If someone wants to try to use the tutorial against a different DB, then they could do so. We could have upgraded the tutorial to use some other DB like MySQL, but that would involve listing the steps required to download/install/start the MySQL server. Any opinion?

3) The "thirdpartyjms" tutorial - This one involves downloading/installing/starting a thirdparty JMS server (like OpenJMS). Should we be including this in our tutorials? If yes, then we would have to see how we can integrate this steps in our Mavenized tutorial.

4) The "HTTP_HTTPS" tutorial - This one shows how an EJB can be accessed via HTTP/HTTPS. Involves multiple configuration changes to the JBossAS. If we have to include this tutorial through our Maven process, then will have to think of a way where we can configure the server configuration of JBossAS and restart it with these changes. Any opinions?

For #3 and #4, i guess we also have "reference guide" for EJB3, where the documentation to configure the AS to achieve these functionality can be documented.

What remains on the tutorial guide part:

1) The documentation for most these completed tutorials has already been committed.

2) The Maven plugin which generates this docbook style documentation allows uploading the guide in a "war" format to Maven repositories. A snapshot version of the guide is available at http://snapshots.jboss.org/maven2/org/jboss/ejb3/tutorial/documentation/jboss-ejb3-tutorial-user-guide-en-US/1.0.0-SNAPSHOT/

3) However i was thinking more on the following lines for making available the tutorial and the guide:
* A downloadable version of the tutorial (source code) and the guide - We can make this available on our EJB3 project site download page. This will help the users to run these tutorials offline.
* A (latest/live) version of the tutorial and the guide - The live version of the tutorial can be checked out from SVN. However, for providing a live version of the guide (in html format rather than the war format), i am still looking to see if there are some options available. Anyone has any suggestions?

[jaikiran]

"jaikiran" wrote:

However, for providing a live version of the guide (in html format rather than the war format), i am still looking to see if there are some options available.

The maven-upload-plugin will help us in this.

[jaikiran]

"jaikiran" wrote:

1) The "jca_inflow_quartz" tutorial which is being tracked here http://www.jboss.com/index.html?module=bb&op=viewtopic&t=148386 and will be fixed today

Done. The tutorial now works against the JBossAS5 with the EJB3 plugin patching.

"jaikiran" wrote:

2) The "tableperinheritance" tutorial which is broken because of a issue in HSQLDB.
https://jira.jboss.org/jira/browse/EJBTHREE-1657

http://opensource.atlassian.com/projects/hibernate/browse/HHH-2920

I am planning to include this tutorial and add a note to the guide saying its broken on HSQLDB. If someone wants to try to use the tutorial against a different DB, then they could do so. We could have upgraded the tutorial to use some other DB like MySQL, but that would involve listing the steps required to download/install/start the MySQL server. Any opinion?

The tutorial has been included with a note to the user that it won't work against HSQLDB.

"jaikiran" wrote:

3) The "thirdpartyjms" tutorial - This one involves downloading/installing/starting a thirdparty JMS server (like OpenJMS). Should we be including this in our tutorials? If yes, then we would have to see how we can integrate this steps in our Mavenized tutorial.

Have left this out since it requires installing a third party jms server, configuring it and running it.

"jaikiran" wrote:

4) The "HTTP_HTTPS" tutorial - This one shows how an EJB can be accessed via HTTP/HTTPS. Involves multiple configuration changes to the JBossAS. If we have to include this tutorial through our Maven process, then will have to think of a way where we can configure the server configuration of JBossAS and restart it with these changes. Any opinions?

Since this contains more of AS configuration, have left it out from the EJB3 tutorials.

"jaikiran" wrote:

What remains on the tutorial guide part:

The guide has been completed.

With this, the tutorials and the guide for EJB3 has been completed. I have a Hudson run going on right now, after which i will do a final commit.