geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Geronimo v2.2 > Introducing Geronimo Administration Console
Date Fri, 30 Oct 2009 02:55:00 GMT
<html>
<head>
    <base href="http://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1519/1/1/_/styles/combined.css?spaceKey=GMOxDOC22&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background-color: white" bgcolor="white">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
     <h2><a href="http://cwiki.apache.org/confluence/display/GMOxDOC22/Introducing+Geronimo+Administration+Console">Introducing
Geronimo Administration Console</a></h2>
     <h4>Page <b>edited</b> by             <a href="http://cwiki.apache.org/confluence/display/~chirunhua@gmail.com">Runhua
Chi</a>
    </h4>
     
          <br/>
     <div class="notificationGreySide">
         <style type='text/css'>/*<![CDATA[*/
table.ScrollbarTable  {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color:
#f0f0f0}
table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}

/*]]>*/</style><div class="Scrollbar"><table class='ScrollbarTable'><tr><td
class='ScrollbarPrevIcon'><a href="/confluence/display/GMOxDOC22/Extensible+Administration+Console"><img
border='0' align='middle' src='/confluence/images/icons/back_16.gif' width='16' height='16'></a></td><td
width='33%' class='ScrollbarPrevName'><a href="/confluence/display/GMOxDOC22/Extensible+Administration+Console">Extensible
Administration Console</a>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a
href="/confluence/display/GMOxDOC22/Configuring+and+administering"><img border='0' align='middle'
src='/confluence/images/icons/up_16.gif' width='8' height='8'></a></sup><a
href="/confluence/display/GMOxDOC22/Configuring+and+administering">Configuring and administering</a></td><td
width='33%' class='ScrollbarNextName'>&nbsp;<a href="/confluence/display/GMOxDOC22/Monitoring+the+health+of+the+Apache+Geronimo+server">Monitoring
the health of the Apache Geronimo server</a></td><td class='ScrollbarNextIcon'><a
href="/confluence/display/GMOxDOC22/Monitoring+the+health+of+the+Apache+Geronimo+server"><img
border='0' align='middle' src='/confluence/images/icons/forwd_16.gif' width='16' height='16'></a></td></tr></table></div>

<p>This topic describes the overall portlets layout and features you can utilize within
Administration Console. If you prefer a command line interface, look into <a href="/confluence/display/GMOxDOC22/Tools+and+commands"
title="Tools and commands">Tools and commands</a> for command line usage.
<div>
<ul>
    <li><a href='#IntroducingGeronimoAdministrationConsole-Overview'>Overview</a></li>
    <li><a href='#IntroducingGeronimoAdministrationConsole-ConsoleNavigation%28leftpanel%29'>Console
Navigation (left panel)</a></li>
    <li><a href='#IntroducingGeronimoAdministrationConsole-Welcome'>Welcome </a></li>
    <li><a href='#IntroducingGeronimoAdministrationConsole-Server'>Server </a></li>
    <li><a href='#IntroducingGeronimoAdministrationConsole-Services'>Services
</a></li>
    <li><a href='#IntroducingGeronimoAdministrationConsole-Applications'>Applications
</a></li>
    <li><a href='#IntroducingGeronimoAdministrationConsole-Security'>Security
</a></li>
    <li><a href='#IntroducingGeronimoAdministrationConsole-EmbeddedDB'>Embedded
DB </a></li>
    <li><a href='#IntroducingGeronimoAdministrationConsole-DebugViews'>Debug Views
</a></li>
</ul></div><a name="IntroducingGeronimoAdministrationConsole-top"></a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-Overview"></a>Overview</h1>

<p>The Geronimo Administration Console is a Web based interface that provides a convenient,
user-friendly way to administer many aspects of the Geronimo server. Once you have the Apache
Geronimo server started (see <a href="/confluence/display/GMOxDOC22/Starting+and+stopping+the+server"
title="Starting and stopping the server">Starting and stopping the server</a>) you
can access the Administration Console by pointing your browser to the following URL:</p>

<p><a href="http://localhost:8080/console" rel="nofollow">http://localhost:8080/console</a></p>

<p>The Administration Console log in page is depicted in the following figure.</p>

<p><img src="/confluence/download/attachments/93292/consoleLogin.png" align="absmiddle"
border="0" /></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<p>Log in by specifying <b>system</b> as the username and <b>manager</b>
as the password. Once you are logged in you will be redirected to the console's welcome page.
The console has two main areas, a navigation panel on the left and a main content area on
the right.</p>

<p>The navigation panel on the left provides easy access to the individual tasks, it
is always present and allows easy transition from task to task. The main content area on the
right is where the real work happens, this area will change as you select the different tasks
in the navigation panel on the left. Each view contains one or more portlets that typically
include a link for help in the header, see the following figure as an example.</p>

<p><img src="/confluence/download/attachments/93292/consoleWelcome.png" align="absmiddle"
border="0" /></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-ConsoleNavigation%28leftpanel%29"></a>Console
Navigation (left panel)</h1>

<p>As briefly explained in the previous section, the navigation panel provides access
to the different tasks for administering resources in Geronimo. This navigation panel is organized
in the following main groups:</p>

<p><img src="/confluence/download/attachments/93292/ico_geronimo_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-Welcome">Welcome</a><br/>
<img src="/confluence/download/attachments/93292/ico_folder_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-Server">Server</a><br/>
<img src="/confluence/download/attachments/93292/ico_folder_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-Services">Services</a><br/>
<img src="/confluence/download/attachments/93292/ico_folder_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-Applications">Applications</a><br/>
<img src="/confluence/download/attachments/93292/ico_folder_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-Security">Security</a><br/>
<img src="/confluence/download/attachments/93292/ico_folder_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-EmbeddedDB">Embedded
DB</a><br/>
<img src="/confluence/download/attachments/93292/ico_folder_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-DebugViews">Debug
Views</a></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-Welcome"></a>Welcome
<a name="IntroducingGeronimoAdministrationConsole-Welcome"></a></h1>

<p>This is the welcome page you see when you log in. It provides a general description
of what the Geronimo Administration Console is and some shortcut links to common tasks such
as:</p>

<h4><a name="IntroducingGeronimoAdministrationConsole-CommonConsoleActions"></a>Common
Console Actions</h4>

<ul>
	<li><img src="/confluence/download/attachments/93292/ico_list_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-DeployNew">Deploy
Applications</a></li>
	<li><img src="/confluence/download/attachments/93292/ico_servcomp_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-WebServer">Web Server
Ports</a></li>
	<li><img src="/confluence/download/attachments/93292/ico_look_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-Information">Server
Information</a></li>
</ul>


<p>This page also provide links to:</p>

<h4><a name="IntroducingGeronimoAdministrationConsole-GeronimoOnline"></a>Geronimo
Online</h4>

<ul>
	<li><a href="http://geronimo.apache.org/" rel="nofollow">The Geronimo Home Page</a></li>
	<li><a href="http://nagoya.apache.org/jira/secure/BrowseProject.jspa?id=10220" rel="nofollow">Problem
Tracking Database</a></li>
	<li><a href="http://mail-archives.apache.org/mod_mbox/geronimo-user/" rel="nofollow">Users
Mailing List Archive</a></li>
	<li><a href="http://mail-archives.apache.org/mod_mbox/geronimo-dev/" rel="nofollow">Developers
Mailing List Archive</a></li>
	<li><a href="irc://irc.freenode.net/#geronimo" rel="nofollow">Geronimo IRC chat</a></li>
</ul>


<h4><a name="IntroducingGeronimoAdministrationConsole-GeronimoDocumentation"></a>Geronimo
Documentation</h4>

<ul>
	<li><a href="http://geronimo.apache.org/faq.html" rel="nofollow">FAQ</a></li>
	<li><a href="http://wiki.apache.org/geronimo" rel="nofollow">Wiki</a></li>
	<li><a href="http://geronimo.apache.org/documentation.html" rel="nofollow">Geronimo
Documentation</a></li>
	<li><a href="http://geronimo.apache.org/redirects/additionalDocumentation.html"
rel="nofollow">Additional Documentation</a></li>
</ul>


<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-Server"></a>Server
<a name="IntroducingGeronimoAdministrationConsole-Server"></a></h1>

<p>Organized under the Server group you will find statistical information as well as
links for configuring and administering the different servers. This group is organized as
follows:</p>

<p><img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-Information">Information</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-JavaSystemInfo">Java System
Info</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-ServerLogs">Server Logs</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-Shutdown">Shutdown</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-WebServer">Web Server</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-ThreadPools">Thread Pools</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-ApacheHTTP">Apache HTTP</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-JARAliases">JAR Aliases</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-Monitoring">Monitoring</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-JMSServer">JMS Server</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-EJBServer">EJB Server</a></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-Information"></a>Information
<a name="IntroducingGeronimoAdministrationConsole-Information"></a></h3>

<p>This portlet displays server information such as the version, start time and up time.
 In addition, it also provides information about the JVM such as Java Version, Vendor, Node,
and Server Memory Usage.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-JavaSystemInfo"></a>Java
System Info <a name="IntroducingGeronimoAdministrationConsole-JavaSystemInfo"></a></h3>

<p>This portlet displays the values of the system properties available to the server
process.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-ServerLogs"></a>Server
Logs <a name="IntroducingGeronimoAdministrationConsole-ServerLogs"></a></h3>

<p>This option provides four portlets, <b><a href="/confluence/display/GMOxDOC22/Log+Manager"
title="Log Manager">Log Manager</a></b>, <b><a href="/confluence/display/GMOxDOC22/Server+Log+Viewer"
title="Server Log Viewer">Server Log Viewer</a></b>, <b><a href="/confluence/display/GMOxDOC22/Web+Access+Log+Viewer"
title="Web Access Log Viewer">Web Access Log Viewer</a></b> and <b><a
href="/confluence/display/GMOxDOC22/Derby+Log+Viewer" title="Derby Log Viewer">Derby Log
Viewer</a></b>.</p>
<ul>
	<li><b><a href="/confluence/display/GMOxDOC22/Log+Manager" title="Log Manager">Log
Manager</a></b><br/>
This portlet allows the user to select a configuration file for logging and/or change the
log level and Refresh interval. The default "Config file" is a standard <b>log4j</b>
file and defines the location where the Geronimo Server will log Geronimo output. The configuration
file also defines the log level which allows a finer control of what is being logged.</li>
</ul>


<ul>
	<li><b><a href="/confluence/display/GMOxDOC22/Server+Log+Viewer" title="Server
Log Viewer">Server Log Viewer</a></b><br/>
This portlet displays the Geronimo server log and is helpful for debugging problems with the
Geronimo Console and with deployed applications.</li>
</ul>


<ul>
	<li><b><a href="/confluence/display/GMOxDOC22/Web+Access+Log+Viewer" title="Web
Access Log Viewer">Web Access Log Viewer</a></b><br/>
This portlet displays and filters the Web container log file. This log file contains HTTP
accesses and messages from JSP and servlet applications that are running on Geronimo. By default
this portlet displays the contents of the log file for the current date. You can apply different
filtering criteria to view only data of your interest.</li>
</ul>


<ul>
	<li><b><a href="/confluence/display/GMOxDOC22/Derby+Log+Viewer" title="Derby
Log Viewer">Derby Log Viewer</a></b><br/>
This portlet displays the log file for Geronimo's internal database, Derby.</li>
</ul>


<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-Shutdown"></a>Shutdown
<a name="IntroducingGeronimoAdministrationConsole-Shutdown"></a></h3>

<p>Clicking <b>Shutdown</b> will shutdown the server and cause the JVM to
exit. To continue using the Geronimo Console after a shutdown, Geronimo must be restarted.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-WebServer"></a>Web
Server <a name="IntroducingGeronimoAdministrationConsole-WebServer"></a></h3>

<p>This option provides two portlets, <b>Web Server Manager</b> and <b>Network
Listeners</b>.</p>
<ul>
	<li><b>Web Server Manager</b><br/>
When this portlet is enabled, it will collect server performance statistics. The values being
measured are:
	<ul>
		<li>Total Requests</li>
		<li>Total 1xx, 2xx, 3xx, 4xx, 5xx Responses</li>
		<li>Active Request Count (Current, Low, High)</li>
		<li>Request Duration</li>
	</ul>
	</li>
	<li><b>Network Listeners</b><br/>
This portlet displays all the connector listeners (HTTP, HTTPS and AJP) and status for both
Jetty and Tomcat Web containers. From this portlet you can add new listeners and change the
status (stop, start, restart, edit, delete) of the existing connectors.</li>
</ul>


<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-ThreadPools"></a>Thread
Pools <a name="IntroducingGeronimoAdministrationConsole-ThreadPools"></a></h3>

<p>This portlet lists all the thread pools defined in the server. It shows the pool
size and allows you to monitor individually each of the listed thread pools. By monitoring
these threads you can gather statistical information such as pool max, lowest recorded, highest
recorded and threads in use.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-ApacheHTTP"></a>Apache
HTTP <a name="IntroducingGeronimoAdministrationConsole-ApacheHTTP"></a></h3>

<p>This portlet is a wizard that walks you through the process of configuring Apache
Geronimo to use a remote Apache 2 HTTP server. To configure the remote HTTP server you will
need to install the mod_jk Apache module on the remote server. Based on a series of questions
the wizard will guide you through the configuration process.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-JARAliases"></a>JAR
Aliases<a name="IntroducingGeronimoAdministrationConsole-JARAliases"></a></h3>
<p>This portlet is used to manage existing artifact aliases on Geronimo server, which
means user can update the <tt>artifact_aliases.properties</tt> file directly on
the server Console.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-Monitoring"></a>Monitoring
<a name="IntroducingGeronimoAdministrationConsole-Monitoring"></a></h3>

<p>The Geronimo monitoring plug-in is broken down between server and client plug-ins,
referred to as the 'Agent' and 'Console' respectively. When properly setup, these plug-ins
provide both local and remote real-time JSR77 compliant statistic monitoring, as well as historical
tracking of any exposed statistic with visual representations drawn in the form of graphs
through the Dojo Toolkit's dojoX Charting packages. Starting from v2.2, this portlet is optional,
you can enable it by installing a plugin from Geronimo repository.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-JMSServer"></a>JMS
Server <a name="IntroducingGeronimoAdministrationConsole-JMSServer"></a></h3>

<p>This option provides two portlets, <b>JMS Server Manager</b> and <b>JMS
Network Listeners</b>.</p>
<ul>
	<li><b>JMS Server Manager</b><br/>
This portlet displays the available JMS Brokers and their state.</li>
</ul>


<ul>
	<li><b>JMS Network Listeners</b><br/>
This portlet displays all the network connectors configured for the currently available JMS
Brokers. From this portlet you can also start, stop, edit, add and delete JMS network connectors.
 Some connectors available to be added to ActiveMQ are tcp, stomp, vm, udp and multicast listeners.</li>
</ul>


<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-EJBServer"></a>EJB
Server <a name="IntroducingGeronimoAdministrationConsole-EJBServer"></a></h3>

<p>This portlet provides all EJB statistics deployed in the server including stateless(stateful)
Containers, CMP(BMP) Entity Containers and Message Driven Containers. By default, Geronimo
is using <a href="http://openejb.apache.org/" rel="nofollow">Openejb</a> as its
EJB 3.0 implementation.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Server">Back to Server</a><br/>
<a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-Services"></a>Services
<a name="IntroducingGeronimoAdministrationConsole-Services"></a></h1>

<p>Organized under this group you will find links for configuring the following services:</p>

<p><img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-Repository">Repository</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-DatabasePools">Database Pools</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-JMSResources">JMS Resources</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-Repository"></a>Repository
<a name="IntroducingGeronimoAdministrationConsole-Repository"></a></h3>

<p>This portlet provides two functionalities. It assists in adding an archive into the
Repository.  Secondly it displays the artifacts installed in the server's repository. The
layout of the repository is the same as that used by Apache Maven making it possible to easily
copy files over. From this portlet you can also install new artifacts and remove existing
ones.</p>


<h3><a name="IntroducingGeronimoAdministrationConsole-DatabasePools"></a>Database
Pools <a name="IntroducingGeronimoAdministrationConsole-DatabasePools"></a></h3>

<p>This portlet displays all the available database pools and their status. Only server-wide
database pools can be edited in this portlet, database pools deployed as part of a single
application cannot, you will have to change the deployment plan in the application instead.</p>

<p>From this portlet you can edit the available, system-wide, database pools. There
is also a <b>usage</b> link with examples of how to use the pool from your application.</p>

<p>This portlet includes a database pool creation wizard for new pools and also lets
you import database pools from JBoss 4 and WebLogic 8.1.</p>

<h3><a name="IntroducingGeronimoAdministrationConsole-JMSResources"></a>JMS
Resources <a name="IntroducingGeronimoAdministrationConsole-JMSResources"></a></h3>

<p>This portlet lists all the JMS resource groups and states available in the Geronimo
server, that is queues and factories. From this portlet you can create new JMS resource groups,
this portlet provides two wizards, one for ActiveMQ and one for another JMS provider. For
the latter you will have to provide the specific resource adapter RAR needed to connect to
that particular provider.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-Applications"></a>Applications
<a name="IntroducingGeronimoAdministrationConsole-Applications"></a></h1>

<p>Organized under this group you will find links for installing and administering applications.</p>

<p><img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-WebAppWARs">Web
App WARs</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-SystemModules">System Modules</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-ApplicationEARs">Application
EARs</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-EJBJARs">EJB JARs</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-J2EEC">J2EE Connectors</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-AppClients">App Clients</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-DeployNew">Deploy New</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-Plugins">Plugins</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-PlanCreator">Plan Creator</a></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-WebAppWARs"></a>Web
App WARs <a name="IntroducingGeronimoAdministrationConsole-WebAppWARs"></a></h3>

<p>This portlet displays the installed Web applications and their status. From this
portlet you can also stop, start and uninstall the available Web applications.</p>

<p>In addition, there is a new feature added "Expert Mode" that allows users more advanced
options. Expert mode, which is commonly seen as the expert user checkbox, allows you to enable
all actions for components. This can be understood as an override feature that will fully
enable the user to perform options (Stop, Restart, and Uninstall) on components which would
otherwise be grayed out and cause the application server to malfunction.</p>

<p><img src="/confluence/download/attachments/93292/expertmode.png" align="absmiddle"
border="0" /></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Applications">Back to Applications</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-SystemModules"></a>System
Modules <a name="IntroducingGeronimoAdministrationConsole-SystemModules"></a></h3>

<p>This portlet displays the installed System Modules and their status. From this portlet
you can also stop, start and uninstall the available System Modules.</p>

<p>In addition, this portlet makes use of the "Expert Mode" feature as described <a
href="#IntroducingGeronimoAdministrationConsole-WebAppWARs">here</a>.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Applications">Back to Applications</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-ApplicationEARs"></a>Application
EARs <a name="IntroducingGeronimoAdministrationConsole-ApplicationEARs"></a></h3>

<p>This portlet displays the installed Application EARs and their status. From this
portlet you can also stop, start and uninstall the available application EARs.</p>

<p>In addition, this portlet makes use of the "Expert Mode" feature as described <a
href="#IntroducingGeronimoAdministrationConsole-WebAppWARs">here</a>.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Applications">Back to Applications</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-EJBJARs"></a>EJB JARs
<a name="IntroducingGeronimoAdministrationConsole-EJBJARs"></a></h3>

<p>This portlet displays the installed EJB JARs and their status. From this portlet
you can also stop, start and uninstall the available EJB JARs.</p>

<p>In addition, this portlet makes use of the "Expert Mode" feature as described <a
href="#IntroducingGeronimoAdministrationConsole-WebAppWARs">here</a>.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Applications">Back to Applications</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-J2EEConnectors"></a>J2EE
Connectors <a name="IntroducingGeronimoAdministrationConsole-J2EEC"></a></h3>

<p>This portlet displays the installed J2EE connectors and their status. From this portlet
you can also stop, start and uninstall the available J2EE Connectors.</p>

<p>In addition, this portlet makes use of the "Expert Mode" feature as described <a
href="#IntroducingGeronimoAdministrationConsole-WebAppWARs">here</a>.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Applications">Back to Applications</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-AppClients"></a>App
Clients <a name="IntroducingGeronimoAdministrationConsole-AppClients"></a></h3>


<p>This portlet displays the installed application clients and their status. From this
portlet you can also stop, start and uninstall the available application clients.</p>

<p>In addition, this portlet makes use of the "Expert Mode" feature as described <a
href="#IntroducingGeronimoAdministrationConsole-WebAppWARs">here</a>.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Applications">Back to Applications</a></p>


<h3><a name="IntroducingGeronimoAdministrationConsole-DeployNew"></a>Deploy
New <a name="IntroducingGeronimoAdministrationConsole-DeployNew"></a></h3>

<p>This portlet allows you to deploy new applications to the Apache Geronimo server.
Web applications require deployment plans, which are either packaged with the war file or
kept in a separate file which is typically called <tt>geronimo-web.xml</tt>.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Applications">Back to Applications</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-Plugins"></a>Plugins
<a name="IntroducingGeronimoAdministrationConsole-Plugins"></a></h3>

<p>This portlet allows you to install or create Geronimo plugins. From this portlet
you can select a remote plugins repository and search for available plugins and install them
or export to plugins just about any module you have already installed in Geronimo.  In addition
you can create custom assembly server packages built with only the modules you specify.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-Applications">Back to Applications</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-PlanCreator"></a>Plan
Creator <a name="IntroducingGeronimoAdministrationConsole-PlanCreator"></a></h3>

<p>This portlet features assisting you in creating a Geronimo Deployment Plan.  Currently
only supporting WAR files. For details visit the <a href="/confluence/display/GMOxDOC22/Creating+deployment+plans+using+the+deployment+plan+wizard"
title="Creating deployment plans using the deployment plan wizard">Creating deployment
plans using the deployment plan wizard</a> section. Starting from v2.2, this portlet
is optional, you can enable it by installing a plugin from Geronimo repository.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-Security"></a>Security
<a name="IntroducingGeronimoAdministrationConsole-Security"></a></h1>

<p><img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-UsersandGroups">Users
and Groups</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-Keystores">Keystores</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-CertificateAuthority">Certificate
Authority</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-SecurityRealm">Security Realm</a></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-UsersandGroups"></a>Users
and Groups <a name="IntroducingGeronimoAdministrationConsole-UsersandGroups"></a></h3>

<p>This option provides two portlets, <b>Console Realm Users</b> and <b>Console
Realm Groups</b>.</p>
<ul>
	<li><b>Console Realm Users</b><br/>
This portlet displays all the Console Realm Users and allows you to add, change password and
delete them.</li>
</ul>


<ul>
	<li><b>Console Realm Groups</b><br/>
This portlet displays all the Console Realm Groups and allows you to add, modify and delete
them.</li>
</ul>



<h3><a name="IntroducingGeronimoAdministrationConsole-Keystores"></a>Keystores
<a name="IntroducingGeronimoAdministrationConsole-Keystores"></a></h3>

<p>This portlet walks you through the process of configuring keystores to use with SSL
connectors. From this portlet you can add or edit keystores, add Trust Certificates and create
private keys.</p>


<h3><a name="IntroducingGeronimoAdministrationConsole-CertificateAuthority"></a>Certificate
Authority <a name="IntroducingGeronimoAdministrationConsole-CertificateAuthority"></a></h3>

<p>This portlet allows you to create a Certification Authority (CA) in Geronimo and
issue certificates in reply to Certificate Signing Requests (CSRs). <a href="/confluence/display/GMOxDOC22/Certification+Authority"
title="Certification Authority">Click here</a> for more detailed instructions.</p>


<h3><a name="IntroducingGeronimoAdministrationConsole-SecurityRealm"></a>Security
Realm <a name="IntroducingGeronimoAdministrationConsole-SecurityRealm"></a></h3>

<p>This portlet displays all available security realms and their status. Only server-wide
security realms can be edited in this portlet. Security realms deployed as part of a single
application cannot, and you will have to change the deployment plan in the application instead.</p>

<p>From this portlet you can edit the available, system-wide, security realms. There
is also a <b>usage</b> link with examples of how to use the realm from your application.</p>

<p>This portlet also includes a security realm creation wizard for creating new realms.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-EmbeddedDB"></a>Embedded
DB <a name="IntroducingGeronimoAdministrationConsole-EmbeddedDB"></a></h1>

<p>Organized under this group you will find links:</p>

<p><img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-DBInfo">DB Info</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-DBManager">DB Manager</a></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h3><a name="IntroducingGeronimoAdministrationConsole-DBInfo"></a>DB Info</h3>

<p>This portlet displays information about the internal database, such as:</p>
<ul>
	<li>Database Product name and version.</li>
	<li>Driver and version.</li>
	<li>Connection URL.</li>
	<li>Supported functions and the supported SQL commands.</li>
</ul>



<h3><a name="IntroducingGeronimoAdministrationConsole-DBManager"></a>DB
Manager</h3>

<p>This option provides two portlets, <b>DB VIewer</b> and <b>Run
SQL</b>.</p>
<ul>
	<li><b>DB Viewer</b><br/>
This portlet displays all the available databases and their tables and displays the contents
of the tables. To view the tables in a particular database, click on the database link. This
will show all the tables in the database. To view the contents of the tables, click on the
<b>View Contents</b> link. At the bottom of the DB Viewer portlet there are links
to take you back to <b>View Databases</b> or <b>View Tables</b>.</li>
</ul>


<ul>
	<li><b>Run SQL</b><br/>
This portlet lets you run SQL commands to manipulate the data in the tables, create a new
database or delete a database. You can enter the SQL commands in the <b>SQL Command(s)</b>
text box, select the database that will be used and then click on <b>Run SQL</b>
to execute the command.</li>
</ul>


<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<h1><a name="IntroducingGeronimoAdministrationConsole-DebugViews"></a>Debug
Views <a name="IntroducingGeronimoAdministrationConsole-DebugViews"></a></h1>

<p>Organized under this group you will find links:</p>

<p><img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle"
border="0" /> <a href="#IntroducingGeronimoAdministrationConsole-JMXViewer">JMX Viewer</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-LDAPViewer">LDAP Viewer</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-ClassLoaderViewer">ClassLoader
Viewer</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-JNDIViewer">JNDI Viewer</a><br/>
<img src="/confluence/download/attachments/93292/ico_doc_16x16.gif" align="absmiddle" border="0"
/> <a href="#IntroducingGeronimoAdministrationConsole-DependencyViewer">Dependency
Viewer</a></p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>

<p>Starting from v2.2, these portlets are optional, you can enable them by installing
a plugin from Geronimo repository.</p>

<h3><a name="IntroducingGeronimoAdministrationConsole-JMXViewer"></a>JMX
Viewer</h3>

<p>This portlet provides a <b>tree</b> like representation for you to browse
the different types of MBeans. Each MBean will be represented as a tree node that shows its
object name representation. All MBeans will give you a list of MBeans grouped by its domain.</p>



<h3><a name="IntroducingGeronimoAdministrationConsole-LDAPViewer"></a>LDAP
Viewer</h3>

<p>This portlet lets you connect to any LDAP server and browse its content but not edit
it. This portlet comes predefined to access the LDAP embedded in Geronimo, make sure the service
is running before you connect to the server.</p>



<h3><a name="IntroducingGeronimoAdministrationConsole-ClassLoaderViewer"></a>ClassLoader
Viewer</h3>

<p>This view can be used to all the classloader involved in server and the classes it
loads.</p>



<h3><a name="IntroducingGeronimoAdministrationConsole-JNDIViewer"></a>JNDI
Viewer</h3>

<p>This view can be used to view JNDI context for various modules.</p>


<h3><a name="IntroducingGeronimoAdministrationConsole-DependencyViewer"></a>Dependency
Viewer</h3>

<p>This view can be used to view all the modules and its dependencies.</p>

<p><a href="#IntroducingGeronimoAdministrationConsole-top">Back to Top</a></p>
     </div>
     <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;">
            <a href="http://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
       </div>

       <a href="http://cwiki.apache.org/confluence/display/GMOxDOC22/Introducing+Geronimo+Administration+Console">View
Online</a>
       |
       <a href="http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=93292&revisedVersion=60&originalVersion=59">View
Change</a>
              |
       <a href="http://cwiki.apache.org/confluence/display/GMOxDOC22/Introducing+Geronimo+Administration+Console?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message