Geronimo
  1. Geronimo
  2. GERONIMO-4303

Document new 2.2 Plugin features - plugingroups, pluginGroup attribute and no classloader option

    Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 2.2
    • Fix Version/s: 2.2
    • Component/s: documentation
    • Security Level: public (Regular issues)
    • Labels:
      None

      Description

      Need to make sure this new pluginGroup attribute and no plan behavior gets added to the 2.2 Docs. We should also document what pluginprofiles we will be providing in 2.2 (along with adding some info to the GMOxDEV wiki, as we want these to be portable between releases) and what each one provides.

        Activity

        Show
        Chi Runhua added a comment - So far we have the following list of topics to be updated upon plugin profiles in GMOxDOC22. 1. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+Console 2. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+command+line 3. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+GEP 4. http://cwiki.apache.org/GMOxDOC22/plugin-groups.html Any other topics, please add.... Jeff C
        Hide
        Donald Woods added a comment -

        Looking good. Some comments so far:
        #1 - No longer have to manually choose Framework for Function centric assemblies (check with Lin on her recent changes)
        #2 - No longer have to choose Boilerplate or Framework for Application/Function centric assemblies (check with Lin on her recent changes)
        #3 - I'll defer to Tim/BJ/Ted for review
        #4 - Needs to be completed

        Show
        Donald Woods added a comment - Looking good. Some comments so far: #1 - No longer have to manually choose Framework for Function centric assemblies (check with Lin on her recent changes) #2 - No longer have to choose Boilerplate or Framework for Application/Function centric assemblies (check with Lin on her recent changes) #3 - I'll defer to Tim/BJ/Ted for review #4 - Needs to be completed
        Hide
        Lin Sun added a comment -

        Hi Jeff,

        Thanks for producing these pages. I quickly looked at the first two links and here are my comments so far -

        for the 1st link -

        1. you can mention that framework is pre-selected for you by default.

        2. the 3rd bullet under "Identifying the functional components required by our server.", I wonder if it is necessary, because the Datasource pool plugin should have a depedency on system-database. Also, if the app client has dependency on either the console/dbpool/jdbc_userds/1.0/car plugin or default/StatelessSessionEJB/1.0/car, or both, then you don't need to select the ones that the app client depends on. The plugin installer will install the plugin and all its dependencies for you automatically.

        3. you might want to update the screen shot for No. 7 to display exactly what you closed earlier.

        4. you might want to give desps to your plugins, such as the app client and default/StatelessSessionEJB/1.0/car. It will make things look nicer on the screen shot for No. 7 and 8.

        for the 2nd link -

        1. for gshell, you'll have to select the framework plugin group manually. I'd suggest us showing an example with framework selected.

        For both links -

        1. you might want to demonstrate the assemblies server after it is build. For example, cd to the directory and list the directory structure... able to start the server, list configurations - should contain at list what you selected earlier on to build the custom server.

        Thanks again

        Lin

        Show
        Lin Sun added a comment - Hi Jeff, Thanks for producing these pages. I quickly looked at the first two links and here are my comments so far - for the 1st link - 1. you can mention that framework is pre-selected for you by default. 2. the 3rd bullet under "Identifying the functional components required by our server.", I wonder if it is necessary, because the Datasource pool plugin should have a depedency on system-database. Also, if the app client has dependency on either the console/dbpool/jdbc_userds/1.0/car plugin or default/StatelessSessionEJB/1.0/car, or both, then you don't need to select the ones that the app client depends on. The plugin installer will install the plugin and all its dependencies for you automatically. 3. you might want to update the screen shot for No. 7 to display exactly what you closed earlier. 4. you might want to give desps to your plugins, such as the app client and default/StatelessSessionEJB/1.0/car. It will make things look nicer on the screen shot for No. 7 and 8. for the 2nd link - 1. for gshell, you'll have to select the framework plugin group manually. I'd suggest us showing an example with framework selected. For both links - 1. you might want to demonstrate the assemblies server after it is build. For example, cd to the directory and list the directory structure... able to start the server, list configurations - should contain at list what you selected earlier on to build the custom server. Thanks again Lin
        Hide
        B.J. Reed added a comment -

        I've reviewed the 3rd link and it looks pretty good to me. My only suggestion is that maybe have all the above pages reference another page that explains plugin groups (and maybe even what plugins are currently in each group, but that may be a bit much to maintain as things change).

        Show
        B.J. Reed added a comment - I've reviewed the 3rd link and it looks pretty good to me. My only suggestion is that maybe have all the above pages reference another page that explains plugin groups (and maybe even what plugins are currently in each group, but that may be a bit much to maintain as things change).
        Hide
        Chi Runhua added a comment -

        Thanks all for your comments.

        1. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+Console

        • the 3rd bullet under "Identifying the functional components required by our server." In the sample, user need to create a derby database and that's why Geronimo Plugins, Console :: System Database(Tomcat) should be checked;
        • for the 3 plugins of app client, user don't need to select all of them since they are dependent with each other.
        • In Geronimo-4492, I reported a problem about converting datasource pool into plugin, if anyone could help to look into the problem, I can complete the page and update more screenshots to help user understand the benefits of new assembly.

        2. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+command+line

        • updated as Lin Sun suggested.

        3. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+GEP

        4. http://cwiki.apache.org/GMOxDOC22/plugin-groups.html

        • Trying to fill in description of each plugin, but not every plugin has description for itself(I looked into pom.xml of individual plugin). Anyone could help with this, it would be great. And you may also update the page directly.

        Because above pages are under different parents, the best way I can figure out to indicate the references is to put the others in its context...

        Jeff C

        Show
        Chi Runhua added a comment - Thanks all for your comments. 1. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+Console the 3rd bullet under "Identifying the functional components required by our server." In the sample, user need to create a derby database and that's why Geronimo Plugins, Console :: System Database(Tomcat) should be checked; for the 3 plugins of app client, user don't need to select all of them since they are dependent with each other. In Geronimo-4492, I reported a problem about converting datasource pool into plugin, if anyone could help to look into the problem, I can complete the page and update more screenshots to help user understand the benefits of new assembly. 2. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+command+line updated as Lin Sun suggested. 3. http://cwiki.apache.org/confluence/display/GMOxDOC22/Assembling+a+server+via+GEP 4. http://cwiki.apache.org/GMOxDOC22/plugin-groups.html Trying to fill in description of each plugin, but not every plugin has description for itself(I looked into pom.xml of individual plugin). Anyone could help with this, it would be great. And you may also update the page directly. Because above pages are under different parents, the best way I can figure out to indicate the references is to put the others in its context... Jeff C

          People

          • Assignee:
            Lin Sun
            Reporter:
            Donald Woods
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development