admin@glassfish.java.net

Re: manpage delivery, index.html changes etc.

From: Paul Davies <Paul-Martin.Davies_at_Sun.COM>
Date: Mon, 08 Sep 2008 10:49:27 -0700

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
*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

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

Please let me know the correct location for the change-admin-password.1
man page.

Thanks!
-Paul


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/