Introduction

The JMS Administration Console is a tool which enables users to administer a live (remote) JMS server. The JMS Administration Console specifically enables administrators to manage the destinations (queues and topics) hosted by any accessible Novell exteNd Messaging Platform JMS server. Also, the administrators can manage security for these destinations by setting permissions for users and groups.

The Administration Console is a J2EE Web Archive application with an html front-end. The application takes advantage of the Apache Struts model-view-controller framework, and uses custom tag libraries. As a consequence, the Administration Console can be deployed and run on any J2EE application server. This enables users to remotely administer a running messaging server via a browser.

Features

The functionality provided enables users to:

• Connect to a remote messaging server
• Create, delete and edit queues
• Create, delete and edit topics
• Create, delete and set passwords for users
• Create and delete groups, and add users to groups
• Create and delete Access Control Lists (ACL). Also, associate principals (users & groups) with an ACL with specific permissions)

Getting Started

The Administration Console is packaged as a Web Application Archive (WAR) file, which can be deployed into any J2EE Application Server. Below is a brief installation guide for common application servers. Please consult your Application Server documentation for more information about deploying WAR files. The WAR file for the console application is located in the console directory.

Novell exteNd Application Server Install

Perform the following steps to install the WAR file on Novell exteNd Application Server:

1. Start the application server.
2. Add a new webbase (database) to the local application server.
3. From a DOS prompt, change directory to the directory containing the Console WAR file. Then, run SilverCmd to deploy the application WAR file (mp-jms-console.war) to the Application Server webbase using the provided exteNd Application Server specific deployment plan (jms_console_war_deploy_plan.xml). For example:

      SilverCmd DeployWAR localhost:80 silvermaster51 mp-jms-console.war -f jms_console_war_deploy_plan.xml -o -v 1

4. Run a browser against the URL of the Console WAR application. For example: http://localhost:80/console

Please note that the supplied deployment plans are for Novell exteNd Application Server 4.0. You may need to modify the deployment plans for other version of the server.

Tomcat Install

Perform the following steps to install the WAR file on Tomcat:

1. Copy the Console WAR file (mp-jms-console.war) to the Tomcat webapps directory.
2. Start or re-start Tomcat (e.g. using the startup.bat or startup.sh script provided in the Tomcat bin directory).
3. Run a browser against the URL of the Console WAR application. For example: http://localhost:8080/mp-jms-console

Note: On Tomcat you need to place the mp-jms.jar file in the CLASSPATH available to Tomcat. You also need to place mp-orb.jar into the CLASSPATH, unless the ORB is installed as a Java 2 Extension.

Back to top.