THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
excerptINLINE
This topic describes the overall portlets layout and features that you can utilize within the Administration Console.
...
...
Anchor
Overview
The Geronimo Administration Console is a Web based interface that provides a convenient, user-friendly way to administer many aspects of the Geronimo server. After you have the Apache Geronimo server started (see Starting and stopping the server), you can access the Administration Console by navigating your browser to the following URL:
...
- The basic mode is the default configuration mode for the navigation panel, displaying the most frequently used functions, including:
- The advance mode diaplays links to every portlet included in the console. It is organized in the following main groups:
Search bar Search barAnchor Searchbar
#Searchbar
The Search bar provides convenient searching capabilities to locate portlets on the navigation panel. Type in the search field and press enter.
...
Welcome Welcome
This is the welcome page that 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:
...
...
Application Server Application Server
Organized under the Application Server group, you will find statistical information and support for configuring and administering the server. This group is organized as follows:
...
...
...
...
System Information System Information
Organized under this group you will find links for the following portlets:
...
#Server Information
#Java System Info
#Thread Pools
...
Server Information Server Information
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.
Java System Info Anchor Java System Info Java System Info
This portlet displays the values of the system properties available to the server process.
...
Thread Pools Thread Pools
This portlet lists all the thread pools defined in the server. You can see the pool size and monitor individually each of the listed thread pools with this portlet. By monitoring these threads, you can gather statistical information such as pool max, lowest recorded, highest recorded, and threads in use.
Web Server Anchor Web Server
This option provides two portlets, Web Server Manager and Network Listeners.
- Web Server Manager ? not sure
When this portlet is enabled, it will collect server performance statistics. The values being measured are:- Total Requests
- Total 1xx, 2xx, 3xx, 4xx, 5xx Responses
- Active Request Count (Current, Low, High)
- Request Duration
- Network Listeners
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, restart, edit, delete) of the existing connectors.
EJB Server Anchor EJB Server
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 Openejb as its EJB 3.0 implementation.
Back to Application Server Back to Top
Derby server Anchor derby server derby server
Organized under this group you will find links:
DB Info
This portlet displays information about the internal database, such as:
...
...
Shutdown Shutdown
Clicking Shutdown will shutdown the server and cause the JVM to exit. To continue using the Geronimo Console after a shutdown, you must restart Geronimo.
...
...
JMS Server JMS Server
This option provides two portlets, JMS Server Manager and JMS Network Listeners.
...
- JMS Network Listeners
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.
...
Applications Applications
Organized under this group you will find links for installing and administering applications.
...
!ico_doc_16x16.gif! [#Web App WARs] Deployer Deployer
This portlet allows you to deploy new applications to the Apache Geronimo server. For example, a
...
!ico_doc_16x16.gif! [#Application EARs] ...
!ico_doc_16x16.gif! [#EJB JARs] ...
!ico_doc_16x16.gif! [#App Clients] ...
!ico_doc_16x16.gif! [#Application EBAs] not on the console yet:
#Plan Creator
...
This portlet allows you to deploy new applications to the Apache Geronimo server. For example, a Web applications requires a deployment plan, which is either packaged within the war file with the name geronimo-web.xml, or kept as a separate XML file that is deployed by using the Plan field in the Deployer portlet. See Deploying applications Via Geronimo Administration Console for more information on using the Deployer function.
...
User Assets User Assets
Organized under this group you will find links for the following portlets:
...
...
#Application EARs
#EJB JARs
#App Clients
#Aries EBAs
#OSGi Bundles
...
Web App WARs Web App WARs
This portlet displays the installed Web applications and their status. From this portlet, you can stop, start, and uninstall the available Web applications. This portlet provides the following two options that help manage Web applications:
...
- Show parent and child components option, which displays the parent and child components of the Installed Web Applications. The parent components refer to the components that the Installed Web Applications dependent on, while the child components are the components that dependent on the Installed Web Applications. You can use this option by selecting the following check box.
...
...
Application EARs Application EARs
This portlet displays the installed Application EARs and their status. From this portlet, you can stop, start, and uninstall the available application EARs.
In addition, this portlet makes use of the Expert Mode and Show parent and child components features as described here.
...
EJB JARs EJB JARs
This portlet displays the installed EJB JARs and their status. From this portlet, you can stop, start, and uninstall the available EJB JARs.
In addition, this portlet makes use of the Expert Mode and Show parent and child components features as described here.
...
App Clients App Clients
This portlet displays the installed Application Clients and their status. From this portlet, you can stop, start, and uninstall the available application clients.
In addition, this portlet makes use of the Expert Mode and Show parent and child components features as described here.
Application EBAs
...
(EBA) Aries EARs
This portlet displays the installed Application EBAs and their status. From this portlet, you can stop, start, and uninstall the available application EBAs.
OSGi Bundles OSGi Bundles
This portlet displays the installed Web Application Bundles and their status. From this portlet, you can stop, start, and uninstall the available application bundlesIn addition, this portlet makes use of the Expert Mode and Show parent and child components features as described here.
...
Plan Creator Plan Creator
This portlet features assisting you in creating a Geronimo Deployment Plan. Currently only supporting WAR files. For details visit the Creating deployment plans using the deployment plan wizard section. Starting from v2.2, this portlet is optional, you can enable it by installing a plugin from Geronimo repository.
...
Resources Resources
Organized under this group you will find links for configuring the following services:
# DB pools
# JMS Resources J2EE Connectors
#JAR Aliases
#Repository
#Apache HTTP
#System Modules
#Plugins #Bundlesnot on the console yet:
#Database Pools #OSGi Bundles
#Datasources
#JMS Resources
J2EE Connectors Anchor J2EE_C
This portlet displays the installed J2EE connectors and their status. From this portlet, you can stop, start and, uninstall the available J2EE Connectors.
In addition, this portlet makes use of the Expert Mode and Show parent and child components features as described here.
...
...
JAR AliasesJAR Aliases
This portlet allows you to manage the existing artifact aliases on the Geronimo server, which means you can update the artifact_aliases.properties file directly on the administration console.
...
Repository Repository
This portlet provides two functionalities. Firstly, 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, which makes it possible to easily copy files over. From this portlet, you can install new artifacts. To use these artifacts in an application, you need to modify your deployment plan according to Define the dependency in the deployment plan. For more information on using the repository portlet, see Update the repository with new library.
...
Apache HTTP Apache HTTP
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 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. See Configuring a remote Apache HTTP server for two alternative ways to configure a remote Apache HTTP server.
...
System Modules System Modules
This portlet displays the installed System Modules and their status. From this portlet, you can stop, start, and uninstall the available System Modules.
In addition, this portlet makes use of the Expert Mode and Show parent and child components features as described here.
...
Plugins Plugins
This portlet allows you to install or create Geronimo plugins. From this portlet, you can install the plugins available in the remote plugins repository you selected, 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. For more information on using the plugins portlet, see Converting applications into plugins using the Administration Console.
...
OSGI Bundles
...
OSGi Bundles
This portlet allows you to install OSGi Bundles to the Apache Geronimo server. You can define a start level for the bundle you install by inputting a non-negative integer into the Start Level field.
This portlet displays the installed OSGi Bundles and their status in the table under the installation area. Double click one bundle in the table, you will see the content of the MANIFEST.MF file of the bundle. From this portlet you can stop, start, and uninstall the available bundles in this table. For more information, see Managing OSGi Bundles.
...
Datasources Datasources
This portlet displays all the available database pools and their status. Only server-wide database pools can be edited in this portlet. For database pools deployed as part of a single application, you will have to change the deployment plan in the application to edit these database pools.
...
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.
...
Anchor
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.
...
Security Security
#Users and Groups
#Keystores
#Certificate Authority
#Security Realm
...
...
Users and Groups Users and Groups
This option provides two portlets, Console Realm Users and Console Realm Groups.
...
- Console Realm Groups
This portlet displays all the Console Realm Groups and allows you to add, modify, and delete them.
...
Keystores Keystores
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. See the Administering certificates section about how to create a keystore and a private key with the keystores portlet. See the Certificate Properties File Realm about how to create and import certificates.
...
Certificate Authority Certificate Authority
This portlet allows you to create a Certification Authority (CA) in Geronimo and issue certificates in reply to Certificate Signing Requests (CSRs). Click here for more detailed instructions.
...
Security Realm Security Realm
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.
...
Monitoring and Troubleshooting Anchor MonitoringandTroubleshooting MonitoringandTroubleshooting
Organized under this group you will find links for:
#Logs
#Server Logs # Monitoring
# Debug Views
o JMX Viewer
o Classloader Viewer
o JNDI Viewer
o Dependency Viewernot on the console yet: #Debug Views
#Monitoring
Logs
Organized under this group, you will find links for the following item.
...
...
Server Logs Server Logs
This option provides four the following portlets, : Log Manager, Server Log Viewer, and Web Access Log Viewer and Derby Log Viewer.
- Log Manager
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 log4j file and defines the location where the Geronimo Server will log Geronimo output. The configuration file also defines the log level that allows a finer control of what is being logged.
...
- Web Access Log Viewer
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.
Derby Logs Derby Logs
- Derby Log Viewer
This portlet displays the log file for Geronimo's internal database, Derby. (not sure of the information yet
For more information, see Configuring log level.
Back to Monitoring and Troubleshooting
Monitoring Anchor Monitoring
The Geronimo monitoring plugin is broken down between server and client plugins, referred to as the 'Agent' and 'Console' respectively. When properly set up, these plugins provide both local and remote real-time JSR77 compliant statistic monitoring, and 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.
...
Debug Views Debug Views
Organized under this group you will find links:
#JMX Viewer
#LDAP Viewer
#ClassLoader Viewer
#JNDI Viewer
#Dependency Viewer
Back to TopStarting from v2.2, these portlets are optional, you can enable them by installing a plugin from Geronimo repository.
JMX Viewer
This portlet provides a tree 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.
...