THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
INLINE
This topic describes the overall portlets layout and features you can utilize within Administration Console.
...
...
Anchor
Console enhancements
A quick look at some console enhancements added into this Apache Geronimo 2.1
Overview
The Geronimo Administration Console is a Web based interface that provides a convenient, user-friendly way to administer many aspects of the Geronimo Serverserver. Once you have the Apache Geronimo server started (see Tools Starting and commandsstopping the server) 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.
Log in by specifying system as the username and manager 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.
...
As briefly explained in the previous section, the navigation panel provides access to the different tasks for administering the resources in Geronimo. This navigation panel is organized in the following main groups:
#Welcome
#Server
#Services
#Applications
#Security
#Embedded DB
#Debug Views
...
Anchor
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 and some shortcut links to common tasks such as:
Common Console Actions
This page also provide links to:
...
Server Anchor 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
#Java System Info
#Server Logs
#Shutdown
#Web Server
#Thread Pools
#Apache HTTP
#JAR Aliases
#Monitoring
#JMS Server
#EJB Server
Information Anchor Information 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 Java System Info
This portlet displays the values of the system properties available to the server process.
...
Anchor
This option provides four portlets, Log Manager, Server Log Viewer, Web Access Log Viewer and Derby Log Viewer.
...
- Derby Log Viewer
This portlet displays the log file for Geronimo's internal database, Derby.
Shutdown Anchor
Clicking Shutdown
...
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.
- Web Server Manager
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, start, restart, edit, delete) of the existing 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 Anchor
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.
JAR AliasesJAR Aliases
This portlet is used to manage existing artifact aliases on Geronimo server, which means user can update the artifact_aliases.properties file directly on the server Console.
Monitoring Monitoring Anchor Monitoring Monitoring
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. Click here for more details on the Monitoring plugin. Starting from v2.2, this portlet is optional, you can enable it by installing a plugin from Geronimo repository.
...
...
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.
EJB Server 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.
Services Services Anchor Services Services
Organized under this group you will find links for configuring the following services:
#Repository
#Database Pools
#JMS Resources
Repository Anchor Repository Repository
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.
Database Pools Anchor 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 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.
Applications Anchor Applications Applications
Organized under this group you will find links for installing and administering applications.
#Web App WARs
#System Modules
#Application EARs
#EJB JARs
J2EE Connectors
#App Clients
#Deploy New
#Plugins
#Plan Creator
...
Web App WARs Web App WARs
This portlet displays the installed Web Applications applications and their status. From this portlet you can also stop, start and uninstall the available Web Applicationsapplications.
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.
System Modules Anchor System Modules System Modules
This portlet displays the installed System Modules and their status. From this portlet you can also stop, start and uninstall the available System Modules.
In addition, this portlet makes use of the "Expert Mode" feature as described here.
Application EARs Anchor Application EARs
This portlet displays the installed Application EARs and their status. From this portlet you can also stop, start and uninstall the available Application application EARs.
In addition, this portlet makes use of the "Expert Mode" feature as described here.
EJB JARs Anchor EJB JARs EJB JARs
This portlet displays the installed EJB JARs and their status. From this portlet you can also stop, start and uninstall the available EJB JARs.
In addition, this portlet makes use of the "Expert Mode" feature as described here.
J2EE Connectors Anchor J2EE_C
This portlet displays the installed J2EE Connectors connectors and their status. From this portlet you can also stop, start and uninstall the available J2EE Connectors.
In addition, this portlet makes use of the "Expert Mode" feature as described here.
...
...
App Clients App Clients
This portlet displays the installed Application Clients application clients and their status. From this portlet you can also stop, start and uninstall the available Application Clientsapplication clients.
In addition, this portlet makes use of the "Expert Mode" feature as described here.
...
...
Deploy New Deploy New
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 geronimo-web.xml.
...
...
Plugins Plugins
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.
...
...
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.
Security Anchor 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 Anchor 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.Back to Top
Certificate Authority Anchor 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 . Security realms deployed as part of a single application cannot, and 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.
Embedded DB Anchor Embedded DB
Organized under this group you will find links:
DB Info
This portlet displays information about the internal database, such as:
- Database Product name and version.
- Driver and version.
- Connection URL.
- Supported functions and the supported SQL commands.
...
DB Manager
This option provides two portlets, DB VIewer and Run SQL.
...
- 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.
...
Anchor
Organized under this group you will find links:
#JMX Viewer
#LDAP Viewer
#ClassLoader Viewer
#JNDI Viewer
#Dependency Viewer
Starting 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.
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.Back to Top
ClassLoader Viewer
This view can be used to all the classloader involved in server and the classes it loads.Back to Top
JNDI Viewer
This view can be used to view JNDI context for various modules.Back to Top
Dependency Viewer
This view can be used to view all the modules and its dependencies.
...