admin@glassfish.java.net

Re: manpage delivery, index.html changes etc.

From: Kedar Mhaswade <Kedar.Mhaswade_at_Sun.COM>
Date: Mon, 08 Sep 2008 10:53:55 -0700

Paul,

Paul Davies wrote:
> Hi Kedar,
>
> Thanks for this information.
>
> After looking more closely at the prototype for text-manpages.jar, I
> noticed that some man pages for v3 Prelude that were not in TP2 are not
> listed. From the information that I have, I assume that the location of
> these man pages should be as follows:
>
> *create-audit-module.1:*
> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/create-audit-module.1
> *delete-audit-module.1:
> *core/kernel/src/main/resources/com/sun/enterprise/v3/admin/delete-audit-module.1
> *list-audit-modules.1:*
> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/list-audit-modules.1

I would really want to put these into security module. But if they had been
here, let's go with it.

> *monitor.1*:
> admin/monitor/src/main/resources/org/glassfish/admin/monitor/cli/monitor.1
> *uptime.1*:
> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/uptime.1

These two are ok.

>
> Please let me know if my assumptions are correct.
>
> I also have a questions about *change-admin-password.1*. According to
> the list, this man page is to be located at:
>
> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/change-admin-password.1
>
> However, the command itself is located at:
>
> security/realm/src/main/java/com/sun/enterprise/security/cli/ChangeAdminPassword.java
>
> Therefore, I'm wondering if the correct location should be as follows:

>
> security/realm/src/main/resources/com/sun/enterprise/security/cli/change-admin-password.1
>
You are right.

> Please let me know the correct location for the change-admin-password.1
> man page.
>
> Thanks!
> -Paul
Thanks,
Kedar

>
>
> On 09/04/08 17:36, Kedar Mhaswade wrote:
>> Paul,
>>
>> These are the things we have decided about manpages, index.html etc.
>>
>> admin_at_glassfish folks, please read and let me know if something is not
>> clear.
>>
>> Regards,
>> Kedar
>>
>> Things we decided:
>>
>> - "asadmin login" command will be implemented by Kedar by HCF (5624)
>> - "asadmin backup/restore-domain and list-backups" are not available
>> (5776).
>> - "asadmin start-domain --verbose" behavior is unchanged from V2.
>> - Kedar will implement "asadmin <remote-command> --secure |-s
>> behavior. The
>> behavior is unchanged from V2.
>> - uptime manpage looks all right except --
>> change "Enterprise Server" to "server".
>>
>> - Deliver a single jar with following directory structure. When you
>> fix a bug,
>> generate a single jar with all manpages. Someone from engg will
>> integrate it.
>> Eventually move to Hudson. [Paul hands this over to admin folks a
>> day before
>> HCF].
>>
>>
>> text-manpages.jar:
>>
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/start-domain.1
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/stop-domain.1
>> admin/cli-optional/src/main/resources/com/sun/enterprise/admin/cli/optional/create-domain.1
>>
>> admin/cli-optional/src/main/resources/com/sun/enterprise/admin/cli/optional/delete-domain.1
>>
>> admin/cli-optional/src/main/resources/com/sun/enterprise/admin/cli/optional/list-domains.1
>>
>> admin/cli-optional/src/main/resources/com/sun/enterprise/admin/cli/optional/start-database.1
>>
>> admin/cli-optional/src/main/resources/com/sun/enterprise/admin/cli/optional/stop-database.1
>>
>> admin/cli-optional/src/main/resources/com/sun/enterprise/admin/cli/optional/login.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/change-admin-password.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/create-jvm-options.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/delete-jvm-options.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/list-jvm-options.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/generate-jvm-report.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/get.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/list.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/commands/set.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/create-profiler.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/create-ssl.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/create-system-properties.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/delete-profiler.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/delete-ssl.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/delete-system-property.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/list-commands.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/list-containers.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/list-modules.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/list-system-properties.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/ping-connection-pool.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/admin/version.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/deployment/deploy.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/deployment/deploydir.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/deployment/disable.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/deployment/enable.1
>> core/kernel/src/main/resources/com/sun/enterprise/v3/deployment/list-applications.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/deployment/list-components.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/deployment/redeploy.1
>>
>> core/kernel/src/main/resources/com/sun/enterprise/v3/deployment/undeploy.1
>>
>> jdbc/admin/src/main/resources/org/glassfish/jdbc/admin/cli/add-resources.1
>>
>> jdbc/admin/src/main/resources/org/glassfish/jdbc/admin/cli/create-jdbc-connection-pool.1
>>
>> jdbc/admin/src/main/resources/org/glassfish/jdbc/admin/cli/create-jdbc-resource.1
>>
>> jdbc/admin/src/main/resources/org/glassfish/jdbc/admin/cli/delete-jdbc-connection-pool.1
>>
>> jdbc/admin/src/main/resources/org/glassfish/jdbc/admin/cli/delete-jdbc-resource.1
>>
>> jdbc/admin/src/main/resources/org/glassfish/jdbc/admin/cli/list-jdbc-connection-pools.1
>>
>> jdbc/admin/src/main/resources/org/glassfish/jdbc/admin/cli/list-jdbc-resources.1
>>
>> security/realm/src/main/resources/com/sun/enterprise/security/cli/create-auth-realm.1
>>
>> security/realm/src/main/resources/com/sun/enterprise/security/cli/create-file-user.1
>>
>> security/realm/src/main/resources/com/sun/enterprise/security/cli/delete-auth-realm.1
>>
>> security/realm/src/main/resources/com/sun/enterprise/security/cli/delete-file-user.1
>>
>> security/realm/src/main/resources/com/sun/enterprise/security/cli/list-auth-realms.1
>>
>> security/realm/src/main/resources/com/sun/enterprise/security/cli/list-file-users.1
>>
>> security/realm/src/main/resources/com/sun/enterprise/security/cli/update-file-user.1
>>
>> web/admin/src/main/resources/org/glassfish/web/admin/cli/create-http-listener.1
>>
>> web/admin/src/main/resources/org/glassfish/web/admin/cli/create-virtual-server.1
>>
>> web/admin/src/main/resources/org/glassfish/web/admin/cli/delete-http-listener.1
>>
>> web/admin/src/main/resources/org/glassfish/web/admin/cli/delete-virtual-server.1
>>
>> web/admin/src/main/resources/org/glassfish/web/admin/cli/list-http-listeners.1
>>
>> web/admin/src/main/resources/org/glassfish/web/admin/cli/list-virtual-servers.1
>>
>>
>> 1m pages:
>>
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/asadmin.1m
>>
>> concept manpages:
>>
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/application.5asc
>>
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/configuration.5asc
>>
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/domain.5asc
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/dotted-names.5asc
>>
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/instance.5asc
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/logging.5asc
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/passwords.5asc
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/resource.5asc
>> admin/cli/src/main/resources/com/sun/enterprise/admin/cli/security.5asc
>>
>>
>> Once the text-manpages.jar is delivered by Paul, someone in admin team
>> should
>> unjar it at <v3> ws and check the changed manpages in.
>>
>>
>> - Regarding index.html (5623)
>> The index.html resides at: glassfish-svn/v3-docs, at:
>> glassfish/lib/templates/docroot/index.html.
>> This should be used by all distributions of GF.
>>
>>
>> -Kedar
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>>
>
> --
> Paul Davies, Senior Technical Writer, Sun Microsystems, Inc.
> http://blogs.sun.com/techscribe/
>