Chapter 4. User Interface

Table of Contents

4.1. Install the UI
4.2. Configure the UI
4.3. Running the UI
4.4. Creating a new modelcluster
4.5. Creating the Servers and Jasmine Hosts
4.6. Creating the Applications
4.7. Deployment and life cycle of an application
4.8. Using JOnAS Admin with JASMINe
4.9. Monitoring from the UI
4.10. Rules logs

4.1. Install the UI

The UI is provided in a separate package named jasmine-ui-<version>.zip. For install JASMINe, just unzip this file in a separate directory.

4.2. Configure the UI

Inside the jasmine-gui folder there is one folder called conf, which contains configuration files. The jasmine.properties file contains the listening address and ports of the node which acts as a control node. The other files (apache.properties, jonas.properties, ...) contain the default values used for the wrappers in the deployment. This values can be changed later in the GUI. These properties allow us to customize the wrappers to each node dinamically.

4.3. Running the UI

If jasmine.properties aren't correctly configurated or there is a problem on the sever side, the following screen will appear.

The different parts are:

  • Jade Front: Corresponds to the connection with the jade-ejb.jar EJB. It also needs the location where the JMX bridge creates the RMI registry and the location where the jadeboot creates the Fractal RMI registry.

  • Probe Front: It's the connection used for the real-time monitoring. It creates a subscriber to the JMS topic where the monitoring system sends the data.

  • Rulelogs Front: It connects with the logs EJB and it's used for retrieving from the UI the logs data.

In each part, there are a connection status, the IP and the port for each part of the server side. There are three possible status :

  • Connected: the connection is established.

  • Disconnected: the connection has been closed.

  • Connection Failed: there is a problem. The connection can't be established.

It's possible change the IP and the port for each part and test the new values with the connection button. To continue starting of JASMINe, press the continue button. It's possible to start JASMINe even if a part isn't connected.

4.4. Creating a new modelcluster

This is the main screen of JASMINe, the ModelCluster perspective. This perspective is useed to design and configure the cluster.

For creating a new project, click on File -> New -> ModelCluster Model and write the name of the project. The project will be saved in a modelcluster file with this name. It's possible to use the Browse... button to choose the desired folder for saving the project.

After clicking Finish the project will be created and it will return to the main screen:

4.5. Creating the Servers and Jasmine Hosts

  1. Extend Jasmine (click on the arrow).

  2. Right-click on Server Pool.

  3. Choose New Child/Server.

  4. Right-click on the new Server.

  5. Choose New Child/Jasmine Host.

A server represents a machine inside the cluster. A Jasmine Host corresponds to a jadenode, to make an equivalence between Jade and the UI. The node id property corresponds to the number given by the jadeboot to the nodes. By default is 0, but if we start more than one jadenode by machine, it will increase. The jadeboot will tell us this number when the nodes connect:

[java] [Allocator] receive newNode jmsMessage : <jasmine-monitored-node-address>_<node-id>

The Applications property contains all the applications in the domain that are associated with the node. For the Ip property we can specify the hostname or the IP. The rest of the properties are not currently used.

4.6. Creating the Applications

For each application to deploy the steps to follow are:

  1. Right-click on Domain.

  2. Choose New Child/<Application>

For deploying an application click on Jasmine Host property in the Properties view and choose the Jasmine Host on which you want to use the Application.

4.7. Deployment and life cycle of an application

To deploy an application, right-click on the application you want to deploy and choose Deploy on the contextual menu.

To start an application, right-click on the application you want to start and choose Start on the contextual menu.

4.8. Using JOnAS Admin with JASMINe

  1. Choose a JOnAS which is running.

  2. Right-click on the JOnAS.

  3. Choose Browser on contextual menu.

  4. JASMINe will automatically switch to the browser perspective.

  5. In this perspective, you can open severals browsers for each JOnAS.

4.9. Monitoring from the UI

To monitor a Jasmine Host, the monitoring system must be deployed and started on that node:

  1. Right-click on a Jasmine Host.

  2. Choose one of the three possible monitors inside the Monitoring option.

  3. JASMINe will automatically switch to the monitoring perspective.

For each view of monitoring, you have three tabs:

  • The values tab where you can read numeric values.

  • The graph tab wher you can see curves.

  • The setting tab where you can choose which data you want to display, and the refresh rate.

4.10. Rules logs

To view the rules logs, it's necessary to open the RuleLogs perspective. On this perspective there are severals actions :

  • To sort logs by type or date (push buttons on the top of the table).

  • To filter logs by type or date.

  • To save logs in an Excel file logs by type or date.

  • To delete logs on the server side by type.

  • To change the logs refresh rate (choose a value on the list).

Copyright © 2006-2007 JASMINe / ObjectWeb consortium
Creative Commons License
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 License.

http://jasmine.objectweb.org