...
toptop Anchor
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 Tools and commands) you can access the Administration Console by pointing your browser to the following URL:
The Administration Console log in page is depicted in the following figure.
...
#Welcome
#Server
#Services
#Applications
#Security
#Embedded DB
#JMX Viewer
#LDAP Viewer
...
Welcome Welcome
This is the welcome page you see when you log in. It provides a general description of what the Geronimo Administration Console is as well as some shortcut links to common tasks such as:
...
...
Server Server
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:
#Information
#JVM
#Server Logs
#Shutdown
#Web Server
#JMS Server
#Thread Pools
#Apache HTTP
...
Information Information
This portlet displays the server's uptime and the resources being used by the JVM.
...
JVM JVM
This portlet displays the values of the system properties available to the server process.
...
Server Logs Server Logs
This option provides four portlets, Log Manager, Server Log Viewer, Derby Log Viewer and Web Access Log Viewer.
...
- 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.
...
Shutdown Shutdown
This portlet allows a warm reboot of the server or a shutdown of it. A warm reboot will shutdown all applications and services and reboot the Geronimo kernel within the same process. The Administration Console session will be disconnected. Reconnect after the server is back up.
A shutdown will shutdown the server and cause the JVM to exit. To continue using the Geronimo Console after a shutdown, Geronimo must be restarted.
...
Web Server Web Server
This option provides two portlets, Web Server Manager and Network Listeners.
...
- Requests
- Connections
- Errors
- Active Requests
- Request Duration
- Connections Open
- Connection Requests
- Connection Duration info
For the last five values, Count, Average and Maximum will be also displayed.
- 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, start, delete) of the existing connectors.
...
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.
...
Thread Pools Thread Pools
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.
...
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 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.
...
Services Services
Organized under this group you will find links for configuring the following services:
#Common Libs
#Database Pools
#JMS Resources
...
Common Libs Common Libs
This portlet 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.
...
Database Pools Database Pools
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.
...
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.
...
JMS Resources JMS Resources
This portlet lists all the JMS resource groups 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 this last one you will have to provide the specific resource adapter RAR needed to connect to that particular provider.
<!-- CONTINUE HERE -->
...
Applications Applications
Organized under this group you will find links for installing and administering applications.
...
J2EE Connectors Anchor J2EE_C J2EE_C
This portlet displays the installed J2EE Connectors and their status. From this portlet you can also stop, start and uninstall the available J2EE Connectors.
...
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.
...
Security Security
#Console Realm
#Security Realm
#Keystores
#Certificate Authority
...
Console Realm Console Realm
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.
...
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, you will have to change the deployment plan in the application instead.
...
This portlet also includes a security realm creation wizard for creating new realms.
...
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.
...
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).
...
Embedded DB Embedded DB
Organized under this group you will find links:
...
- Run SQL
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 SQL Command(s) text box, select the database that will be used and then click on Run SQL to execute the command.
Debug Views Debug Views
Organized under this group you will find links:
#JMX Viewer
#LDAP Viewer
#ClassLoader Viewer
#JNDI Viewer
#Dependency Viewer
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.
LDAP Viewer
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.
ClassLoader Viewer
This view can be used to all the classloader involved in server and the classes it loads.
JNDI Viewer
This view can be used to view JNDI context for various modules.
Dependency Viewer
This view can be used to all the modules and its dependencies.