Dear document team.
I read the little .
At that time , I noticed that
there is no document about delegate-admin task.
Actually I don't know where should you write the paragraph.
# In the Realm ? or Create user or group ?
# Or isn't it included in the TP2 ?
Anyway if it is possible , could you write additional info about
the "delegated-admin" ?
Best regards.
Yoshio.
On 2008/04/24, at 9:42, Dixie Pine wrote:
> Reviewers: This is the most thorough review I've received, so I'm
> cc'ing all on my responses. If you have additions or corrections,
> please respond.
> Dixie
>
> Jennifer Chou wrote:
>>
>> Hi Dixie,
>>
>> I reviewed most of the beginning sections and those commands I
>> worked on: start/stop-database, create/delete/list-resource-ref,
>> create/delete/list/jdbc-resource, create/delete/list-jdbc-
>> connection-pool.
>> Organization looks good. Any cluster-specific things should be
>> removed for TP2.
>> Also cc'ing Jerome, Dinesh, and Sahoo to help clarify whether
>> JavaDB is bundled. It is mentioned in the guide as bundled on p.
>> 19, 54, and 68
> I removed all text referring to bundled Java DB. I saw some email
> threads which I believe culminated in saying that Java DB is not
> bundled for TP2. If user has to download it separately, I hope the
> install doc and the quick start are telling users that.
>>
>> p.17 - name change
>> Should "Sun Java System Application Server documentation set" be
>> changed to "GlassFish Application Server documentation" set? I
>> believe the name change is official. Can you check with managment?
> You're right. The master preface had not been updated, so name was
> wrong there. It's fixed now.
>>
>> p. 19 - I don't know if JavaDB is included. I think Jerome, Sahoo,
>> Dinesh can clarify.
>> For information about the JavaDB database included with the
>> Application Server, see
>> http://developers.sun.com/javadb/.
>>
>> p. 26 - remove 'the'
>> If you created multiple domains, you must start a separate Admin
>> Console session to manage the each domain.
> done
>>
>> p. 31 - Maybe this section can be removed?
>> For subcommands that can be run locally or remotely:
>> -The commands are either run locally or remotely. I don't think we
>> have commands that can do both.
>> -I don't think we support --local option.
>> -The 3rd bullet is confusing. I think 'local' should be replaced
>> with 'remote' in a couple places in this paragraph?
>> If none of the local remote options are set, either on the command
>> line or in the environment, the
>> subcommand runs locally by default. Setting the --local option to
>> true overrides the local remote
>> --host, --port, --user, and --passwordfile settings, even if
>> specified. In this case, the
>> subcommand runs locally.
> I removed this list. Some of this old material has not been looked
> at in a long time. I will take any chance to purge doubtful text.
>>
>> p. 31 - --help displays the entire manpage, not just usage. Move
>> the example from the 2nd paragraph to the 1st.
>> You can obtain usage information for any of the asadmin utility
>> subcommands by using the
>> --help option. The usage information for that subcommand is
>> displayed.
>> For example, asadmin create-jdbc-resource --help.
> done
>>
>> p.31 - --help without subcommand does not display list of all
>> subcommands
>> Using the --help option without a subcommand displays a listing of
>> all available
>> subcommands.
>> -Using the --help option without a subcommand displays information
>> about asadmin utility command.
> done
>>
>> p. 32 - You have to start the app server before you can see the
>> help for a remote command. Need to run asadmin start-domain
> added
>> To view command syntax and examples, type the command name followed
>> by--help at the
>> utility prompt. For example:
>> asadmin create-jdbc-resource --help
>>
>> p. 38 - I don't think profile option is supported for create-
>> domain. Check with Siraj.
>> You can choose the profile of a domain only during creation. Use
>> the --profile option with
>> the create-domain command to specify a profile for the domain. If
>> you do not use the
>> --profile option to explicitly specify a profile, the default
>> profile is associated with the domain.
>> The AS_ADMIN_PROFILE variable in the asadminenv.conf file defines
>> the default profile.
> I hid this material for TP2. Does it apply for v3?
>>
>> p. 41 - typo
>> fro -> for
> fixed
>>
>> p. 43 - typo
>> Tthe
> fixed
>>
>> p. 43, 44, 45, 46, 117, 118, 119 Applies to all commands.
>> --target option is not supported for TP2
> removed
>>
>> p. 43 - typo
>> type asadmincreated-resource-ref --help
>> - Change to "type asadmin create-resource-ref --help"
> fixed
>>
>> p. 44 - TP2 does not support clustering, it supports default
>> server. Applies to all commands.
>> Change:
>> The following example command lists resource references for the
>> NewServer server:
>> asadmin list-resource-refs --user admin --passwordfile
>> passwords.txt MyCluster
>> to
>> The following example command lists resource references for the
>> default server:
>> asadmin list-resource-refs --user admin --passwordfile passwords.txt
> Removed MyCluster and reworded the example lead-in sentences.
>>
>> p. 44 typo - remove 'the resource'
>> The following example command deletes a resource reference the
>> resource named
> done
>>
>> p. 54 - I don't know if Application Server is really bundled with
>> JavaDB.
>> Can you check with Jerome, Dinesh, Sahoo?
>> Also, p. 68 The JavaDB/Derby JDBC driver is included with the
>> Application Server by default,
> I have reworded without claiming that Java DB is bundled.
>>
>> p. 54 - Domain does not need to be running to use start-database
> Removed. Did this get to Paul? I think I got this prerequisite from
> a man page.
>>
>> p. 60 - typo - missing a '-' in front of -property
>> You can either use a -property option
> fixed
>>
>> p. 60 - typo - extra z, need space between --host and --passowordfile
>> list-jdbc-connection-pool --user --host--passzwordfile
> fixed
>>
>> p. 64 - Remove 'in a Developer Domain' to be consistent with others.
>> Deleting a JDBC Resource in a Developer Domain
>> The following example command deletes a JDBC resource named jdbc/
>> DerbyPool from a
>> domain that uses the developer profile:
> done
>>
>> p. 127 - need definition - Creates a reference to a previously
>> created resource.
>> create-resource-ref(1) need def Supported in remote mode only.
> done
>>
>> Thanks,
>> Jennifer
>>
>> Dixie Pine wrote:
>>>
>>> Greetings,
>>>
>>> I have attached a PDF copy of the GlassFish v3 TP2 Administration
>>> Guide for your review.
>>> Review Dates: Thursday 4/17/08-Wednesday 4/23/08
>>> Here's what has happened with this manual:
>>> TP2 Content Only
>>> I have removed all material that does not apply to TP2. Please
>>> let me know if more material should be removed.
>>> Reorganized
>>> I have reorganized the chapters and split the former security
>>> chapter into System Security and User Security. I've done lots of
>>> renaming of sections, sometimes guesswork, so any suggestions for
>>> improvements are welcome.
>>> Streamlined
>>> I have streamlined the overview material, which means there is now
>>> less of it. I would still like to reduce the amount of explanatory
>>> material in the System Security chapter.
>>> Task Based
>>> I have written tasks for the asadmin CLI commands that are
>>> included in TP2. The Admin Guide is all about asadmin now, not
>>> about the Admin Console GUI. The only Admin Console procedures
>>> that are still in the manual are in the Logging chapter, because
>>> I haven't had time to determine what asadmin commands can do those
>>> tasks.
>>>
>>> Many of the new tasks are incomplete. Most of the settings
>>> material is incomplete. I have done as much as I had time for,
>>> extrapolating from man pages and the Admin Console online help.
>>> Now I need reviewers to help me fill in the gaps and fix the gaffs.
>>> In email feedback, please specify the PDF page number for your
>>> comment. A paper markup is also great. Or a phone call. The doc
>>> team is using the following list of contributors from GlassFish
>>> engineering, so if you are a SME in an area addressed in this
>>> manual, please review.
>>>
>>> http://wiki.glassfish.java.net/Wiki.jsp?page=GlassFishV3DocPlan#section-GlassFishV3DocPlan-EngineeringStaff
>>>
>>> I will only have a few days to make corrections to the manual
>>> before TP2 delivery, so review soon.
>>> Thanks very much,
>>> Dixie
>>> x15591
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>>
***********************************************
> Yoshio Terada
Solution Architect
Sun Microsystems K.K.
SBS Tower 15 Fl, 4-10-1 Yoga
Setagaya-ku, Tokyo, 158-8633 Japan
Phone: +81-3-5717-4697
Fax : +81-3-5717-2582
Mail : Yoshio.Terada_at_Sun.COM
Blog :
http://blogs.sun.com/yosshi
***********************************************