Geronimo
  1. Geronimo
  2. GERONIMO-4056

Tutorials - Custom Server assemblies using Apache Geronimo Administrative Console

    Details

    • Type: Task Task
    • Status: Resolved
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 2.1, 2.1.1
    • Fix Version/s: 2.1
    • Component/s: documentation
    • Security Level: public (Regular issues)
    • Labels:
      None

      Description

      Geronimo v2.1 documentation, Tutorials section.

      Develop a tutorial for "Creating your own custom server with Geronimo framework" addressing the following common topics (use this list as the initial guideline). This document should also match the styling used in the existing tutorials.

      • Setting up Eclipse for Application development
      • Sample application overview
        identify the different components
      • Prerequisites
        external resources (i.e. databases, connection pools, JMS queues, etc)
      • Sample app creation
        breakdown into multiple bullets
      • Deploy and Test the application

      See http://cwiki.apache.org/GMOxDOC21/tutorials.html

        Activity

        Hide
        Ashish Jain added a comment -

        The tutorial is available at the following link http://cwiki.apache.org/confluence/display/GMOxDOC21/Create+your+own+custom+server+with+Geronimo+framework.
        Request you to review and provide comments.

        Show
        Ashish Jain added a comment - The tutorial is available at the following link http://cwiki.apache.org/confluence/display/GMOxDOC21/Create+your+own+custom+server+with+Geronimo+framework . Request you to review and provide comments.
        Hide
        Hernan Cunico added a comment -

        The starting point for this tutorial should be the bin distro of Geronimo Framework. ( see http://geronimo.apache.org/apache-geronimo-v211-release.html)

        Roughly the sequence in this tutorial should be something like this

        • getting the geronimo framework distro
        • starting the framework
        • using either Geronimo native commands or GShell search/list plugins
        • select the required plugins and install them
        • test the newly installed plugins
        Show
        Hernan Cunico added a comment - The starting point for this tutorial should be the bin distro of Geronimo Framework. ( see http://geronimo.apache.org/apache-geronimo-v211-release.html ) Roughly the sequence in this tutorial should be something like this getting the geronimo framework distro starting the framework using either Geronimo native commands or GShell search/list plugins select the required plugins and install them test the newly installed plugins
        Hide
        Ashish Jain added a comment -

        Renaming this JIRA to Custom Server assemblies using Apache Geronimo Administrative Console

        Show
        Ashish Jain added a comment - Renaming this JIRA to Custom Server assemblies using Apache Geronimo Administrative Console
        Hide
        Ashish Jain added a comment -

        Added a new JIRA for the suggestions added by Hernan.
        https://issues.apache.org/jira/browse/GERONIMO-4179

        Show
        Ashish Jain added a comment - Added a new JIRA for the suggestions added by Hernan. https://issues.apache.org/jira/browse/GERONIMO-4179
        Hide
        Ashish Jain added a comment -

        Here is the new link for the tutorial
        http://cwiki.apache.org/confluence/display/GMOxDOC21/Custom+server+assemblies+using+Geronimo+Administrative+console
        Please review and provide your comments

        Show
        Ashish Jain added a comment - Here is the new link for the tutorial http://cwiki.apache.org/confluence/display/GMOxDOC21/Custom+server+assemblies+using+Geronimo+Administrative+console Please review and provide your comments
        Hide
        Hernan Cunico added a comment -

        I think we should provide some more details about what the custom server assemblies are. If we already provide those details, then point to that section in the documentation.

        We should establish a more solid starting point for this tutorial or the rest of the sections/step won't be fully understood.

        We also need to improve the Geronimo Plugin Architecture documentation so instructions like "...To assemble a server from existing instance of geronimo we need to include geronimo-boilerplate-minimal plugin which includes several files used to start the server..." have more meaning.

        It is not clear what we should achieve after completing section "Identifying the functional components required by our server".

        Looking at step 6 under "Assembling a custom server" I see "default/StatelessSessionEJB/1.0/car" and "default/ApplicationClient/1.0/car" but it is not clear how/when these should be selected. I think we should indicate first the components for the application we want to create a custom server assembly for. Then indicate what are the minimum server components needed to get a functional custom server assembly. Last indicate the optional componenets like Administration Console, etc. It is not too clear to me how, if I include the Administration Console plugin the DB wizard won't be included and still have to explicitly add it. (Geronimo Plugin Architecture documentation should probably address this)

        Could a plugin (or custom server assembly) contain information to create a DB and populate some data if such DB is on the embedded Derby?

        Show
        Hernan Cunico added a comment - I think we should provide some more details about what the custom server assemblies are. If we already provide those details, then point to that section in the documentation. We should establish a more solid starting point for this tutorial or the rest of the sections/step won't be fully understood. We also need to improve the Geronimo Plugin Architecture documentation so instructions like "...To assemble a server from existing instance of geronimo we need to include geronimo-boilerplate-minimal plugin which includes several files used to start the server..." have more meaning. It is not clear what we should achieve after completing section "Identifying the functional components required by our server". Looking at step 6 under "Assembling a custom server" I see "default/StatelessSessionEJB/1.0/car" and "default/ApplicationClient/1.0/car" but it is not clear how/when these should be selected. I think we should indicate first the components for the application we want to create a custom server assembly for. Then indicate what are the minimum server components needed to get a functional custom server assembly. Last indicate the optional componenets like Administration Console, etc. It is not too clear to me how, if I include the Administration Console plugin the DB wizard won't be included and still have to explicitly add it. (Geronimo Plugin Architecture documentation should probably address this) Could a plugin (or custom server assembly) contain information to create a DB and populate some data if such DB is on the embedded Derby?
        Hide
        Ashish Jain added a comment -

        Thank you Hernan for the comments. I will incorporate all the changes suggested.

        Show
        Ashish Jain added a comment - Thank you Hernan for the comments. I will incorporate all the changes suggested.
        Hide
        Ashish Jain added a comment -

        Added a introductory section on custom server assemblies. Added a section suggesting application centric approach in use for this illustration. Clarified why the section "Identifying the functional components required by our server" is required.
        DB plugin is again a plugin on the top of Tomcat Administration Console plugin and that is why we need to include both to get a GUI based DB console.
        Regarding the last point that is "Could a plugin (or custom server assembly) contain information to create a DB and populate some data if such DB is on the embedded Derby?" I could not find one in the list of plugins in the local server.

        Please provide your comments on the updated tutorial
        http://cwiki.apache.org/confluence/display/GMOxDOC21/Custom+server+assemblies+using+Geronimo+Administrative+console

        Show
        Ashish Jain added a comment - Added a introductory section on custom server assemblies. Added a section suggesting application centric approach in use for this illustration. Clarified why the section "Identifying the functional components required by our server" is required. DB plugin is again a plugin on the top of Tomcat Administration Console plugin and that is why we need to include both to get a GUI based DB console. Regarding the last point that is "Could a plugin (or custom server assembly) contain information to create a DB and populate some data if such DB is on the embedded Derby?" I could not find one in the list of plugins in the local server. Please provide your comments on the updated tutorial http://cwiki.apache.org/confluence/display/GMOxDOC21/Custom+server+assemblies+using+Geronimo+Administrative+console
        Hide
        Ashish Jain added a comment -

        Shall I go ahead and close this JIRA? I guess there are no further improvements required for the tutorial.

        Show
        Ashish Jain added a comment - Shall I go ahead and close this JIRA? I guess there are no further improvements required for the tutorial.

          People

          • Assignee:
            Ashish Jain
            Reporter:
            Hernan Cunico
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development