[jboss-cvs] JBossAS SVN: r101568 - in projects/docs/community/6: Admin_Console_Guide and 2 other directories.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Fri Feb 26 13:12:28 EST 2010
Author: smcgowan at redhat.com
Date: 2010-02-26 13:12:27 -0500 (Fri, 26 Feb 2010)
New Revision: 101568
Added:
projects/docs/community/6/Admin_Console_Guide/
projects/docs/community/6/Admin_Console_Guide/en-US/
projects/docs/community/6/Admin_Console_Guide/en-US/Accessing_the_Console.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Adding_Resources.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Admin_Console_Guide.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Administration_Console_Quick_Start_Guide.ent
projects/docs/community/6/Admin_Console_Guide/en-US/Application_undeployment_and_resource_removal.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Author_Group.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Book_Info.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Common_Tasks.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Feedback.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Flushing_the_Connection_Pool_for_a_Datasource.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Further_Information.xml
projects/docs/community/6/Admin_Console_Guide/en-US/JBCache.xml
projects/docs/community/6/Admin_Console_Guide/en-US/JVM_Metrics.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Legal_Notice.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Monitoring_the_JBoss_Application_Server_Instance.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Navigation_Panel.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Overview.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Port_Configuration.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Preface.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Resource_Panel.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Revision_History.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Scripts.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Updating_Applications.xml
projects/docs/community/6/Admin_Console_Guide/en-US/Updating_Resource_Configurations.xml
projects/docs/community/6/Admin_Console_Guide/en-US/User_Interface_Overview.xml
projects/docs/community/6/Admin_Console_Guide/en-US/images/
projects/docs/community/6/Admin_Console_Guide/en-US/images/AS_Banner.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/AS_Metrics.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_1736bd6b.jpg
projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_24ffdce8.jpg
projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_3cb12404.jpg
projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_m6fe09573.jpg
projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_ma5a1ef5.jpg
projects/docs/community/6/Admin_Console_Guide/en-US/images/Application_Nav.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Binding.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/DataSource_Summary.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Enterprise_App_Summary.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Expanded.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/JBCache.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/JBossAS_JVM.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Login.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Metrics_Summary.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Resource_Nav.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Resource_Panel.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Scripts.png
projects/docs/community/6/Admin_Console_Guide/en-US/images/Update_EAR.png
projects/docs/community/6/Admin_Console_Guide/pom.xml
Log:
JBoss AS 6 Admin Console User Guide
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Accessing_the_Console.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Accessing_the_Console.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Accessing_the_Console.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,57 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. -->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]>
+<chapter id="Administration_Console_User_Guide-Accessing_the_Console">
+ <title>Accessing the Console</title>
+ <para>
+The Console, as well as the JMX and JBossWS consoles, are deployed "on-demand" by default. This means that the consoles are deployed when the user requests access. This deferred deployment strategy minimizes the overall server boot time. This feature can be disabled, however, by passing the following property to the server start command:
+
+<programlisting>
+/run.sh -Djboss.as.deployment.ondemand=false
+</programlisting>
+
+Once the server is started, simply point your browser of choice to:
+
+<programlisting>
+http://localhost:8080/admin-console
+</programlisting>
+
+JBoss AS binds its services to localhost (127.0.0.1) by default, instead of binding to all available interfaces (0.0.0.0). This was primarily done for security reasons because of concerns of users going to production without having secured their servers properly. To enable remote access by binding JBoss services to a particular interface, simply start the JBoss AS server with the <emphasis>-b</emphasis> option. To bind to all available interfaces and re-enable the legacy behaviour use <emphasis>-b 0.0.0.0</emphasis>. If the server is started with the <emphasis>-b</emphasis> option, you will have to alter the URL accordingly.
+
+ <note>
+ <title>Note</title>
+ <para>It is expected that the JBoss AS Administration Console will work with any custom configuration that supports the
+ installation of Seam applications.</para>
+ <para>JBoss AS Administration Console is not supported with the <emphasis>minimal</emphasis> configuration.</para>
+ </note>
+
+This will bring you to the JBoss AS Administration Console Login page.
+
+ <imageobject>
+ <imagedata fileref="images/Login.png"/>
+ </imageobject>
+
+Login credentials are the same as used for the JMX console. A default user/password combination, <emphasis role="bold">admin/admin</emphasis>, is provided for out-of-box access.
+
+You can change/update the usernames/passwords for the configured security domain by editing the corresponding credential files:
+
+<programlisting>
+server/<emphasis>configuration</emphasis>/conf/props/jmx-console-users.properties
+</programlisting>
+
+Similarly, you can change/update roles for the configured security domains by editing corresponding credential files:
+
+<programlisting>
+server/<emphasis>configuration</emphasis>/conf/props/jmx-console-roles.properties
+</programlisting>
+
+For more information on modifying user credentials, refer to the <ulink url="http://community.jboss.org/wiki/securetheJmxConsole">Secure the JMX Console</ulink> wiki.
+</para>
+<para>Click the Login button using the default user provided or your customized administrative login.</para>
+
+<note>
+ <title>Note</title>
+ <para>The Console is expected to work with any browser and has been tested with Mozilla FireFox 3.</para>
+ </note>
+
+</chapter>
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Adding_Resources.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Adding_Resources.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Adding_Resources.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,88 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Adding_Resources">
+ <title>Adding Resources</title>
+ <para>
+ Other resources, in addition to applications, can be added to your JBoss Application Server instance using the Administration Console. In fact whether you adding new resources or modifying resources already deployed to the running server, the Administration Console offers easy management of the resource properties avoiding error-prone editing of XML configuration files.
+ </para>
+
+ <para>
+ Similar to deploying an application, choose the specific type of resource you want to add from the navigation panel (for example, <emphasis>Local Tx Datasources</emphasis> rather than just <emphasis>Datasources</emphasis>), this will bring up the Summary tab for this type. Next hit the <emphasis role="bold">Add a new resource</emphasis> button on the right hand side of the main panel. You will be prompted for the template that will be used to create the configuration.
+ </para>
+
+ <para>
+ A template is just a set of suggested values to use for the properties defined on that resource. For example, the Oracle templates contain suggested values that are typically used when creating a Datasource for connecting to an Oracle database. Your template choices for datasource types are:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Local Tx Datasource</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Oracle Local TX (Local Tx Datasource)</para>
+ </listitem>
+
+ <listitem>
+ <para>default (Local Tx Datasource)</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
+ <para>No Tx Datasources</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Oracle No TX (No Tx Datasource)</para>
+ </listitem>
+
+ <listitem>
+ <para>default (No Tx Datasource)</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
+ <para>XA Datasources</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Oracle XA (XA Datasource)</para>
+ </listitem>
+
+ <listitem>
+ <para>default (XA Datasource)</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ After selecting the appropriate template, click <emphasis role="bold">CONTINUE</emphasis>. Add the appropriate configuration information for the datasource. Next to each editable property is a description detailing the use of the property, default value if any, and the affect of the property change. Common configuration errors are detected and will be highlighted after attempting to save. Check the Unset box if the property will not be used. At the end of your configuration session, click <emphasis role="bold">SAVE</emphasis> at the bottom of the page which deploys the configuration information to the server. Click <emphasis role="bold">CANCEL</emphasis> if you decide not to create the new resource.
+ </para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata depth="43"
+ fileref="images/Admin-Console-QuickStart_html_1736bd6b.jpg"
+ width="247" />
+ </imageobject>
+ </mediaobject>
+
+ <para>
+ After you have saved the new configuration the main panel should return to displaying a list of resources along with a message about whether or not the resource creation succeeded.
+ </para>
+
+ <important>
+ <para>
+ Any database drivers needed for the Datasource to function correctly must be deployed to the JBoss Application Server instance separately.
+ </para>
+ </important>
+
+ <para>
+ A similar procedure works for creating JMS Destinations and Connection Factories. For Connection Factories however the required resource adapter must already be deployed prior to configuring the connection factory. If this has not yet been done, simply navigate to the Resource Adapters (RAR)s or Enterprise Application (EAR)s (for a resource adapter deployed as part of an Enterprise Archive) and deploy the adaptor JAR file.
+ </para>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Admin_Console_Guide.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Admin_Console_Guide.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Admin_Console_Guide.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,27 @@
+<?xml version='1.0'?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<book>
+ <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Accessing_the_Console.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="User_Interface_Overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Resource_Panel.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Navigation_Panel.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Common_Tasks.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Updating_Applications.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Application_undeployment_and_resource_removal.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Adding_Resources.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Updating_Resource_Configurations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Scripts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Monitoring_the_JBoss_Application_Server_Instance.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="JVM_Metrics.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Flushing_the_Connection_Pool_for_a_Datasource.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Port_Configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="JBCache.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Further_Information.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</book>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Administration_Console_Quick_Start_Guide.ent
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Administration_Console_Quick_Start_Guide.ent (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Administration_Console_Quick_Start_Guide.ent 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,6 @@
+<!ENTITY HOLDER "Red Hat, Inc">
+<!ENTITY YEAR "2010">
+<!ENTITY BOOKID "Administration Console Guide">
+<!ENTITY JBAS "JBoss Application Server">
+<!ENTITY VER "6.0">
+<!ENTITY PRODUCT "JBoss Application Server">
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Application_undeployment_and_resource_removal.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Application_undeployment_and_resource_removal.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Application_undeployment_and_resource_removal.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,17 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Application_undeployment_and_resource_removal">
+ <title>Application undeployment and resource removal</title>
+ <para>
+ Many types of resources including applications can be deleted by navigating to the Resources' Type specific (for example, Enterprise Application (EAR)s) Summary Tab and simply clicking the <emphasis role="bold">DELETE</emphasis> button next to the name of the resource you want to delete. For example, to undeploy an EAR file, choose the <emphasis>Enterprise Application (EAR)s</emphasis> folder from the navigation and then in the main panel find the application you are looking to remove and click the <emphasis role="bold">DELETE</emphasis> button next to it. Once the removal has been confirmed, the Application will be undeployed from the server and will no longer be able to be managed. You will have to deploy it again if it is needed. As noted above, Embedded Applications do not have the delete option available.
+ </para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Datasource_Summary.png"/>
+ </imageobject>
+ </mediaobject>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Author_Group.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Author_Group.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Author_Group.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,10 @@
+<?xml version='1.0'?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<authorgroup>
+ <author>
+ <firstname>Shelly</firstname>
+ <surname>McGowan</surname>
+ </author>
+</authorgroup>
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Book_Info.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Book_Info.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,34 @@
+<?xml version='1.0'?>
+<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<bookinfo id="Administration_Console_User_Guide-Documentation">
+ <title>JBoss AS Administration Console User Guide</title>
+ <subtitle></subtitle>
+ <productname>JBoss AS Administration Console</productname>
+ <productnumber>1.4.0.B01</productnumber>
+ <pubdate>February 26, 2010</pubdate>
+ <edition>1</edition>
+ <issuenum>1</issuenum>
+ <pubsnumber>1</pubsnumber>
+ <abstract>
+ <para>Administration Console User Guide for JBoss Application Server 6.</para>
+ </abstract>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="images/title_logo.svg" />
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <copyright>
+ <year>&YEAR;</year>
+ <holder>&HOLDER;</holder>
+ </copyright>
+ <xi:include href="Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</bookinfo>
+
+
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Common_Tasks.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Common_Tasks.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Common_Tasks.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,68 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Common_Tasks">
+ <title>Common Tasks</title>
+ <para>
+ Next we will give an overview of some common tasks you can do with the Administration Console. Each task will be used to highlight a particular function within the console.
+ </para>
+
+ <para>
+ For a detailed list of all the supported resources and the functions the Administration Console can perform on them please see the accompanying resource specific documentation.
+ </para>
+
+ <bridgehead>Application Deployment</bridgehead>
+
+ <para>All applications running in the JBoss Application Server instance are listed in the summary
+ view under <emphasis>: <machine> : JBossAS Servers : JBoss AS 6
+ (all) : Applications </emphasis>in the navigation. Applications can also
+ be further organized by their types to simplify the view:</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata depth="215"
+ fileref="images/Application_Nav.png"
+ width="326" />
+ </imageobject>
+ </mediaobject>
+
+ <important>
+ <para>
+ The Embedded application types were deployed as part of an Enterprise Archive. They are listed separately for easier management and each embedded archive shows the relationship to its' parent. Embedded applications are managed via their parent. In other words, they cannot be deleted or updated and control operations do not apply to them. The management of these applications is done through the operations on the parent.
+ </para>
+ </important>
+
+ <para>To deploy an application, navigate to the Application type you want to
+ add. In this example, we will use an Enterprise Application. Clicking on the
+ link <emphasis>Enterprise Applications (EAR)s</emphasis> will bring you to
+ the Enterprise Application (EAR) Summary Tab.</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Enterprise_App_Summary.png"/>
+ </imageobject>
+ </mediaobject>
+
+ <para>Clicking on:</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata depth="46"
+ fileref="images/Admin-Console-QuickStart_html_m6fe09573.jpg"
+ width="247" />
+ </imageobject>
+ </mediaobject>
+
+ <para>brings you to <literal>Add New Enterprise Application (EAR)</literal> page. Click the
+ <emphasis role="bold">BROWSE</emphasis> button and select the EAR file to
+ be deployed. Select whether to deploy the app exploded or to the farm
+ directory. Click <emphasis role="bold">CONTINUE</emphasis> to proceed with
+ the application deployment. The status of the deployment will be shown and
+ if successful, added to the list of applications ready to be managed.
+ Otherwise, the reason for the failed deployment will be shown.</para>
+
+ <para>You can follow this same procedure for other application types that
+ you want to add.</para>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Feedback.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Feedback.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Feedback.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,21 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<section>
+ <title>We Need Feedback!</title>
+ <indexterm>
+ <primary>feedback</primary>
+ <secondary>contact information for this manual</secondary>
+ </indexterm>
+ <para>
+ If you find a typographical error in the <citetitle>Administration Console User Guide</citetitle>, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in JIRA: <ulink url="http://jira.jboss.org">http://jira.jboss.org</ulink> against the project <citetitle>JBoss Application Server</citetitle>.
+ </para>
+ <para>
+ When submitting a bug report, be sure to mention the manual's identifier: <citetitle>&BOOKID;</citetitle>
+ </para>
+ <para>
+ If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily.
+ </para>
+</section>
+
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Flushing_the_Connection_Pool_for_a_Datasource.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Flushing_the_Connection_Pool_for_a_Datasource.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Flushing_the_Connection_Pool_for_a_Datasource.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Flushing_the_Connection_Pool_for_a_Datasource">
+ <title>Flushing the Connection Pool for a Datasource</title>
+ <para>
+ Certain resources, such as Datasources, have support for executing particular operations from the Administration Console. These operations are exposed on the Control tab for a particular resource. Below is the Control tab for a Datasource:
+ </para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Admin-Console-QuickStart_html_3cb12404.jpg"/>
+ </imageobject>
+ </mediaobject>
+
+ <para>
+ In order to flush the connection pool associated with a Datasource you navigate to the Datasource you are interested in, select its Control tab and then push the <emphasis role="bold">FLUSH</emphasis> button. Once the Control operation is executed, the Operation status is returned and listed in the Operations History section at the bottom of the main pane. Multiple operations can be executed and a history of results is maintained until the JBoss Application Server instance is restarted.
+ </para>
+
+ <para>
+ Other control operations include stopping the JBoss Application Server instance and removing all messages from a JMS Queue.
+ </para>
+
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Further_Information.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Further_Information.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Further_Information.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,41 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Further_Information">
+ <title>Further Information</title>
+ <para>
+ For more information on the JBoss Application Server, Administration Console, and supporting technologies, refer to the following project links.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <ulink url="http://www.jboss.org/jbossas">JBoss Application Server</ulink>
+ </listitem>
+
+ <listitem>
+ <ulink url="http://www.jboss.org/embjopr">Embedded Jopr</ulink>
+ </listitem>
+
+ <listitem>
+ <ulink url="http://www.jboss.org/jopr">Jopr</ulink>
+ </listitem>
+
+ <listitem>
+ <ulink url="http://www.seamframework.org">SEAM Framework</ulink>
+ </listitem>
+
+ <listitem>
+ <ulink url="http://www.jboss.org/richfaces">RichFaces</ulink>
+ </listitem>
+
+ <listitem>
+ <ulink url="http://community.jboss.org/wiki/AS6ProfileServiceDesign">JBoss AS 6 Profile Service Design</ulink>
+ </listitem>
+
+ <listitem>
+ <ulink url="http://www.jboss.org/jsfunit">JSFUnit</ulink>
+ </listitem>
+ </itemizedlist>
+
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/JBCache.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/JBCache.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/JBCache.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,15 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-JBCache">
+ <title>JBoss Caches</title>
+
+<para>If you are running the <emphasis role="bold">all</emphasis> configuration or a customized configuration based on <emphasis role="bold">all</emphasis>, the JBoss Cache instances of the running server are shown. Various metrics and control operations available for the cache instances are easily accessible from the main tabs of the resource panel.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/JBCache.png"/>
+ </imageobject>
+ </mediaobject>
+
+</chapter>
Added: projects/docs/community/6/Admin_Console_Guide/en-US/JVM_Metrics.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/JVM_Metrics.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/JVM_Metrics.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,21 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-JBossAS_JVM">
+ <title>JBoss Application Server JVM</title>
+
+
+<para>Additional JVM metrics and monitoring capabilities are available by clicking on the JBoss AS JVM link in the left navigation panel.
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/JBossAS_JVM.png"/>
+ </imageobject>
+ </mediaobject>
+
+
+From here, you can view JVM metrics including virtual memory utilization, execute operations such as garbage collection and thread dumps of daemon and non-daemon threads,
+memory pool metrics, and metrics of classes loaded in the VM.
+</para>
+</chapter>
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Legal_Notice.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Legal_Notice.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Legal_Notice.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,17 @@
+<?xml version='1.0'?>
+<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<legalnotice id="Book-Legal_Notice">
+ <title>Legal Notice</title>
+ <para>
+ <address>
+ <street>1801 Varsity Drive</street>
+ <city>Raleigh</city>, <state>NC</state><postcode>27606-2072</postcode><country>USA</country><phone>Phone: +1 919 754 3700</phone>
+ <phone>Phone: 888 733 4281</phone>
+ <fax>Fax: +1 919 754 3701</fax>
+ <pob>PO Box 13588</pob><city>Research Triangle Park</city>, <state>NC</state><postcode>27709</postcode><country>USA</country>
+ </address>
+ </para>
+</legalnotice>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Monitoring_the_JBoss_Application_Server_Instance.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Monitoring_the_JBoss_Application_Server_Instance.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Monitoring_the_JBoss_Application_Server_Instance.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,27 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Monitoring_the_JBoss_Application_Server_Instance">
+ <title>Monitoring the JBoss Application Server Instance</title>
+ <para>
+ Basic information is provided on every resource managed by the Admin Console via the resources Summary tab. However some resources such as the JBoss Application Server instance itself, also offer more detailed metrics. See below for an example:
+ </para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/AS_Metrics.png" />
+ </imageobject>
+ </mediaobject>
+
+ <para>
+ This metrics are collected from the resource when the Metrics tab is viewed and can be recalculated by hitting the <emphasis role="bold">REFRESH</emphasis> button at the bottom main panel.
+ </para>
+
+ <note>
+ <para>
+ In order to see JVM resources and metrics, the JBoss Application Server instance must be started with the <property>-Djboss.platform.mbeanserver</property> system property specified as part of <varname>JAVA_OPTS</varname>.
+ </para>
+ </note>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Navigation_Panel.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Navigation_Panel.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Navigation_Panel.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,83 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Navigation_Panel">
+ <title>Navigation Panel</title>
+ <para>All applications and resources discovered during server start up
+ should be available underneath the JBoss Application Server instance in the navigation tree. The
+ example below demonstrates a view with items in the tree expanded.</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Expanded.png"/>
+ </imageobject>
+ </mediaobject>
+
+ <note>
+ <para>
+ The navigation panel is currently fixed width so to see wider entries use the scroll bar at the bottom of the panel.
+ </para>
+ </note>
+
+ <para>The are two sorts of items shown in the navigation panel:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Collection of resources: These items are indicated by a yellow
+ folder icon.</para>
+ </listitem>
+
+ <listitem>
+ <para>Individual resources: These are indicated by a blue document
+ icon.</para>
+ </listitem>
+ </itemizedlist>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata depth="152"
+ fileref="images/Resource_Nav.jpg"
+ width="326" />
+ </imageobject>
+ </mediaobject>
+
+ <para>Clicking on a collection resource (for example, the
+ <emphasis>Resources</emphasis> link above) will render in the main panel
+ either:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>a list of resource categories from where you can drill down
+ further:</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Resource_Panel.png"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+
+ <listitem>
+ <para>or a list of actual resources from where you can drill down to see
+ a particular resource. For some resource types you can create or delete
+ instances of a resource from this view.</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Admin-Console-QuickStart_html_ma5a1ef5.jpg"/>
+ </imageobject>
+ </mediaobject>
+ </listitem>
+ </itemizedlist>
+
+ <para>Expanding one of the folder nodes in the navigation will show either
+ individual resources or further collections of resources which themselves
+ can be expanded.</para>
+
+ <para>Click on an individual resource will show the Summary tab for that
+ resource, as seen previously for the JBoss Application Server instance. If available, expanding
+ an individual resource node in the navigation will show the child resources
+ it has deployed within it.</para>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Overview.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Overview.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Overview.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,102 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Overview">
+ <title>Overview</title>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/AS_Banner.png"/>
+ </imageobject>
+ </mediaobject>
+
+<para>The JBoss AS Administration Console is a SEAM-based web application for managing and monitoring a single JBoss AS instance. Known in the community as the open source project Embedded Jopr (pronounced "jopper"): Embedded because it runs inside a JBoss Application Server and Jopr because it uses the same infrastructure the Jopr project which is the open source enterprise management solution for JBoss middleware projects. The JBoss AS Administration Console (also referred to as Console in this guide) has been included in JBoss Application Server distributions since release 5.1.0. Successive releases continue to improve the server management capabilities eventually replacing the jmx- and web consoles.</para>
+
+ <para>This release of the Administration Console provides the following administrative features:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Deploy, Undeploy, and Update Enterprise Applications
+ including:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Enterprise Applications (EARs)</para>
+ </listitem>
+
+ <listitem>
+ <para>Web Applications (WARs)</para>
+ </listitem>
+
+ <listitem>
+ <para>Resource Adapters(RARs)</para>
+ </listitem>
+
+ <listitem>
+ <para>EJB JARs (EJB2 and EJB3)</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
+ <para>Persistent configuration changes for the following
+ resources:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Datasources</para>
+ </listitem>
+
+ <listitem>
+ <para>Connection Factories</para>
+ </listitem>
+
+ <listitem>
+ <para>Service Binding Manager</para>
+ </listitem>
+
+ <listitem>
+ <para>JMS Queues and Topics based on JBoss Messaging</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+
+ <itemizedlist>
+ <listitem>
+ <para>View statistics and carry out operations on many other
+ components:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>JBoss Application Server examples: version, memory
+ usage, thread count and stop operation</para>
+ </listitem>
+
+ <listitem>
+ <para>Hibernate Session factories</para>
+ </listitem>
+
+ <listitem>
+ <para>JBoss Web vhosts: supported aliases</para>
+ </listitem>
+
+ <listitem>
+ <para>JBoss Web connectors: for example, Maximum Request Time</para>
+ </listitem>
+
+ <listitem>
+ <para>EARs and WARs: for example, Average Response Time and lifecycle
+ operations (start, stop and reload)</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
+ <para>Monitor all standard JVM metrics and execute operations. For example, garbage collection.</para>
+ </listitem>
+ </itemizedlist>
+<para>Let's take a closer look at how easy it is to manage your JBoss AS instance from a single administration point.</para>
+
+</chapter>
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Port_Configuration.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Port_Configuration.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Port_Configuration.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,50 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Port_Configuration">
+ <title>Port Configuration</title>
+ <para>The Service Binding Manager co-ordinates which ports the JBoss Application Server instance listens on when it starts up and the Administration Console provides a mechanism for configuring this service to change which ports get used. In the navigation pane select the SBM: <emphasis><machine> : JBossAS Servers : JBoss AS 6 (default) : Service Binding Manager</emphasis>. Next go to its Configuration tab and for the Active Binding Set Name property enter the name of the new port set you wish the JBoss Application Server instance to use and hit the <emphasis role="bold">SAVE</emphasis> button at the bottom of the page. Out of the box, the JBoss Application Server ships with four port sets defined as:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ ports-default: The standard ports, for instance JBoss Web listens for HTTP requests on 8080. You can view all of the standard port settings on the Configuration tab of the Service Binding Manager resource.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ ports-01: The standard ports incremented by 100. For example, HTTP is on 8180
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ ports-02: The standard ports incremented by 200. For example, HTTP is on 8280
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ ports-03: The standard ports incremented by 300. For example, HTTP is on 8380
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="" contentwidth="" fileref="images/Binding.png"
+ width="" />
+ </imageobject>
+ </mediaobject>
+
+ <para>
+ If you wish to specify a different range of ports to use then you can create your own Service Binding Set resource through the Administration Console. Select the <emphasis>Service Binding Sets</emphasis> folder from the navigation, hit the <emphasis role="bold">Add a new resource</emphasis> button on the main panel and enter in the necessary information.
+ </para>
+
+ <para>
+ Once you have updated the configuration for the Service Binding Manager, the JBoss Application Server instance must be restarted for those changes to take effect. After the restart, the new ports will be used when accessing the Administration Console (for example, http://localhost:8180/admin-console).
+ </para>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Preface.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Preface.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Preface.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,12 @@
+<?xml version='1.0'?>
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<preface id="Administration_Console_User_Guide-Preface">
+ <title>Preface</title>
+ <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude">
+ <xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </xi:fallback>
+ </xi:include>
+</preface>
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Resource_Panel.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Resource_Panel.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Resource_Panel.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,46 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Resource_Panel">
+ <title>Resource Panel</title>
+ <para>You can see in the example above the main tabs which are present for all individual resources. Not all tabs are available for every sort of resource, though Summary and Metrics tabs will always be enabled. If a feature is not supported for a particular resource then that tab is greyed out (for example, the Administration Console does not support configuring a JBoss Web Virtual Host so the Configuration tab for those sort of resources will be disabled). The following is a breakdown of the functionality behind each tab:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Summary: This presents a quick overview of the resource including
+ relevant metrics on how its operating.</para>
+ </listitem>
+
+ <listitem>
+ <para>Configuration: If enabled this tab lets you update the
+ configuration of a resource (for example, increase the pool size for a
+ Datasource) or switch the JBoss Application Server instance to use a different set of
+ ports.</para>
+ </listitem>
+
+ <listitem>
+ <para>Metrics: Shows the same information as the summary tab plus any
+ more detailed metrics which are collected on the resource. Metrics will
+ be gathered each time you visit the page.</para>
+ </listitem>
+
+ <listitem>
+ <para>Control: If enabled this tab lets you execute operations on the
+ resource (for example, stopping the JBoss Application Server instance).</para>
+ </listitem>
+
+ <listitem>
+ <para>Content: If enabled this tab lets you update the actual files used
+ to deploy the resource (for example, update the WAR file used to deploy a web
+ application).</para>
+ </listitem>
+ </itemizedlist>
+
+ <note>
+ <para>
+ The currently selected tab is shown in white, available tabs are blue and unavailable ones are grey.
+ </para>
+ </note>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Revision_History.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Revision_History.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Revision_History.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<appendix id="appe-Publican-Revision_History">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>1.0</revnumber>
+ <date>Feb 26 2010</date>
+ <author>
+ <firstname>Shelly</firstname>
+ <surname>McGowan</surname>
+ <email>smcgowan at redhat.com</email>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Initial draft for JBoss AS 6</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Scripts.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Scripts.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Scripts.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,21 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Scripts">
+ <title>Script Execution</title>
+
+<para>Scripts in the server <emphasis role="bold">bin</emphasis> directory are now available for execution via the Administration Console.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Scripts.png"/>
+ </imageobject>
+ </mediaobject>
+
+ <note>
+ <para>
+ Starting the JBoss Application Server from the Administration Console is not supported because the Console requires a running instance of the JBoss Application Server in order to operate.
+ </para>
+ </note>
+
+</chapter>
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Updating_Applications.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Updating_Applications.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Updating_Applications.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,23 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Updating_Applications">
+ <title>Updating Applications</title>
+ <para>
+ To update an application, select it from the navigation panel and then in the main panel click on the Content Tab. <emphasis role="bold">BROWSE</emphasis> to the location of where the updated application resides then hit the <emphasis role="bold">UPDATE</emphasis> button. Example below of updating an .EAR deployment:
+ </para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Update_EAR.png"/>
+ </imageobject>
+ </mediaobject>
+
+ <important>
+ <para>
+ The file to be updated must have the same name as the application you plan to update.
+ </para>
+ </important>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/Updating_Resource_Configurations.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/Updating_Resource_Configurations.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/Updating_Resource_Configurations.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,25 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-Updating_Resource_Configurations">
+ <title>Updating Resource Configurations</title>
+ <para>
+ For resources that support configuration, either created through the Administration Console or deployed separately, you can use the Console to make modifications to their settings. Simply choose the resource to be modified from the navigation panel or from one of the resource list views and then select its Configuration tab, from where changes can then be made:
+ </para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Admin-Console-QuickStart_html_24ffdce8.jpg"/>
+ </imageobject>
+ </mediaobject>
+
+ <para>Updating a resources configuration follows a very similar pattern to adding a resource described above. Change the properties you want to be updated and hit the <emphasis role="bold">SAVE</emphasis> button at the bottom of the page and the changes will be applied to the JBoss Application Server instance.</para>
+
+ <warning>
+ <para>
+ If a resource was previously deployed and modified via the Console, the administration of the resource should continue to be done via the Console. The resource modifications are persistent but will not be reflected in the resources original configuration file. This means that changes between manual edits to configuration files and changes performed via the Console are not interchangeable. If you make a change to a configuration file outside of the Administration Console it will override and replace any changes you have previously made via the Console.
+ </para>
+ </warning>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/User_Interface_Overview.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/en-US/User_Interface_Overview.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/en-US/User_Interface_Overview.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,40 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<chapter id="Administration_Console_User_Guide-User_Interface_Overview">
+ <title>User Interface Overview</title>
+ <para>
+ Once successfully logged in, you have an overall summary of the system that the JBoss Application Server is running on such as Operating System information and host name.
+ </para>
+
+ <para>
+ The Administration Console pages are split up into two main areas:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ The left navigation panel (blue background) allows the user to browse the different resources which are deployed into their JBoss Application Server instance. A tree metaphor is used to represent the resource hierarchy, with the root being the machine the JBoss Application Server instance is running on. The tree can be expanded to show child resources, for example the JBoss Application Server instance and then within that a list of Datasources.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The main resource panel (white background) shows information about a particular resource or resources which were selected from the navigation on the left. This is also the place that allows direct access to all the administrative tasks for a resource (for example, update its configuration), delete it. The resource showing in the main pane is normally highlighted in <emphasis role="bold">bold</emphasis> in the navigation pane.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata scalefit="1" fileref="images/Metrics_Summary.png"/>
+ </imageobject>
+ </mediaobject>
+
+ <note>
+ <para>
+ The currently running JBoss Application Server instance, with its configuration shown in parentheses, is found under the <emphasis>JBossAS Servers</emphasis> folder near the top of the navigation tree. Only one running server is managed at a time through the Administration Console. Click on the <emphasis>JBoss AS 6 (all)</emphasis> link and an overview of the JBoss Application Server instance which is running the Administration Console is shown.
+ </para>
+ </note>
+</chapter>
+
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/AS_Banner.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/AS_Banner.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/AS_Metrics.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/AS_Metrics.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_1736bd6b.jpg
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_1736bd6b.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_24ffdce8.jpg
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_24ffdce8.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_3cb12404.jpg
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_3cb12404.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_m6fe09573.jpg
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_m6fe09573.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_ma5a1ef5.jpg
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Admin-Console-QuickStart_html_ma5a1ef5.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Application_Nav.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Application_Nav.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Binding.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Binding.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/DataSource_Summary.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/DataSource_Summary.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Enterprise_App_Summary.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Enterprise_App_Summary.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Expanded.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Expanded.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/JBCache.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/JBCache.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/JBossAS_JVM.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/JBossAS_JVM.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Login.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Login.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Metrics_Summary.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Metrics_Summary.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Resource_Nav.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Resource_Nav.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Resource_Panel.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Resource_Panel.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Scripts.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Scripts.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/en-US/images/Update_EAR.png
===================================================================
(Binary files differ)
Property changes on: projects/docs/community/6/Admin_Console_Guide/en-US/images/Update_EAR.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: projects/docs/community/6/Admin_Console_Guide/pom.xml
===================================================================
--- projects/docs/community/6/Admin_Console_Guide/pom.xml (rev 0)
+++ projects/docs/community/6/Admin_Console_Guide/pom.xml 2010-02-26 18:12:27 UTC (rev 101568)
@@ -0,0 +1,107 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+ <modelVersion>4.0.0</modelVersion>
+
+ <groupId>org.jboss.jbossas</groupId>
+ <artifactId>admin-console-guide-${translation}</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <packaging>jdocbook</packaging>
+ <name>Administration Console Guide (${translation})</name>
+
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <version>2.1.2</version>
+ <extensions>true</extensions>
+ <dependencies>
+ <dependency>
+ <groupId>org.jboss</groupId>
+ <artifactId>jbossorg-docbook-xslt</artifactId>
+ <version>1.1.0</version>
+ </dependency>
+ <dependency>
+ <groupId>org.jboss</groupId>
+ <artifactId>jbossorg-jdocbook-style</artifactId>
+ <version>1.0.0</version>
+ <type>jdocbook-style</type>
+ </dependency>
+ </dependencies>
+ <configuration>
+ <!--minmemory>1024m</minmemory>
+ <maxmemory>1024m</maxmemory -->
+ <sourceDocumentName>Admin_Console_Guide.xml</sourceDocumentName>
+ <sourceDirectory>en-US</sourceDirectory>
+ <imageResource>
+ <directory>en-US</directory>
+ <includes>
+ <include>images/*</include>
+ </includes>
+ </imageResource>
+ <!-- <cssResource>
+ <directory>src/main/css</directory>
+ </cssResource> -->
+ <!--put back css -->
+
+ <formats>
+ <format>
+ <formatName>pdf</formatName>
+ <!--<stylesheetResource>classpath:/xslt/org/jboss/main-pdf.xsl</stylesheetResource>-->
+ <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource>
+ <finalName>Admin_Console_Guide.pdf</finalName>
+ </format>
+ <format>
+ <formatName>html</formatName>
+ <!--<stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>-->
+ <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+
+ <format>
+ <formatName>html_single</formatName>
+ <!--<stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>-->
+ <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+
+ <!--<format>
+ <formatName>eclipse</formatName>
+ <stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>-->
+ </formats>
+ <options>
+ <xincludeSupported>true</xincludeSupported>
+ <!-- <xmlTransformerType>saxon</xmlTransformerType>-->
+ <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme -->
+ <!-- could also locate the docbook dependency and inspect its version... -->
+ <!--docbookVersion>1.72.0</docbookVersion -->
+ <!--
+ <docbookVersion>1.72.0</docbookVersion>
+ <transformerParameters>
+ <property>
+ <name>javax.xml.parsers.DocumentBuilderFactory</name>
+ <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value>
+ </property>
+ <property>
+ <name>javax.xml.parsers.SAXParserFactory</name>
+ <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value>
+ </property>
+ -->
+ <!--<javax.xml.parsers.DocumentBuilderFactory>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</javax.xml.parsers.DocumentBuilderFactory>
+ <javax.xml.parsers.SAXParserFactory>org.apache.xerces.jaxp.SAXParserFactoryImpl</javax.xml.parsers.SAXParserFactory>
+ <javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>org.apache.xerces.jaxp.validation.XMLSchemaFactory</javax.xml.validation.SchemaFactory:http\://www.w3.org/2001/XMLSchema>-->
+ <!-- </transformerParameters> -->
+ </options>
+ </configuration>
+ </plugin>
+</plugins>
+</build>
+
+<properties>
+ <translation>en-US</translation>
+</properties>
+</project>
More information about the jboss-cvs-commits
mailing list