jdg-visualizer

What is it?

This is a graphical JBoss Data Grid visualizer based on the 2011 JBoss World Keynote presented by Burr Sutter (https://vimeo.com/25258416).

This visualizer works with out of the box JDG configuration with JMX and Management User configured (see below for instructions).

Configure Maven

See here to make sure JBoss Repository is configured - http://www.jboss.org/jdf/quickstarts/jboss-as-quickstart/#mavenconfiguration

In addition, please make sure JDG 6 repository is configured based on JDG 6 Maven Repository installation instructions. If not using JDG 6, please change the pom.xml so that the Infinispan dependency is based on community project.

NOTE: This code hasn't been tested w/ Infinispan community project.

Add Management User to JBoss Data Grid

cd $JDG_HOME/bin
./add-user.sh
Select <a> to add a Management User
Hit <Enter> for default realm (ManagementRealm)
Follow instruction to add a user with your username/password of your choice. ALL nodes should have the exact same login credentials in order for this visualizer to run correctly.

Running JBoss Data Grid

For this visualizer to work in a clustered environment, each JDG node must use the standalone-ha.xml configuration (for clustering), and each JDG node must be running on a dedicated network interface (i.e., a specific IP). This can be achieved mostly through the use of IP Aliasing (you may need to look up more documentation regarding IP Aliasing for your Operating System). Optionally, you can also run each JDG node in a virtual machine instance, each with a different IP address.

An example to create local IP Aliases in Mac OS X:

sudo ifconfig lo0 alias 127.0.0.2 255.0.0.0
sudo ifconfig lo0 alias 127.0.0.3 255.0.0.0

Each JDG instance must bind to a specific IP address, e.g.:

./standalone.sh -c standalone-ha.xml -b 127.0.0.2 -bmanagement=127.0.0.2 -Djboss.node.name=jdg-2
./standalone.sh -c standalone-ha.xml -b 127.0.0.3 -bmanagement=127.0.0.3 -Djboss.node.name=jdg-3

If running JDG inside a VM, please make sure JDG is bound to the non-local network interface. (JDG binds to localhost unless otherwise specified), e.g.:

./standalone.sh -c standalone-ha.xml -b 192.168.100.101 -bmanagement=192.168.100.101 -Djboss.node.name=jdg-1

Configure jdg-visualizer

Configure JMX Credentials

Open src/main/java/com/redhat/middleware/jdg/visualizer/cdi/Resources.java
Locate the following lines of code:

manager.setJmxUsername("admin");
manager.setJmxPassword("qwerty");
manager.setJmxPort(9999);
Replace these with your own values. _NOTE: JDG JMX port is 9999 by default if you haven't changed it. Replace "namedCache" with a cache that you are interested in monitoring. JDG comes pre-configured with "namedCache", use it if you haven't changed it. _

Configure hotrod-client.properties

Open src/main/resources/hotrod-client.properties
Set infinispan.client.hotrod.server_list to at least one of your JDG server IP address, e.g.:

infinispan.client.hotrod.server_list=127.0.0.2

Start JBoss Enterprise Application Platform 6 or JBoss AS 7.1

Open a command line and navigate to the root of the JBoss server directory.

The following shows the command line to start the server with the web profile:

 For Linux:   JBOSS_HOME/bin/standalone.sh
 For Windows: JBOSS_HOME\bin\standalone.bat

Build and Deploy

NOTE: The following build command assumes you have configured your Maven user settings. If you have not, you must include Maven setting arguments on the command line. See Build and Deploy the Quickstarts for complete instructions and additional options.

Make sure you have started the JBoss Server as described above.
Open a command line and navigate to the root directory of this quickstart.
Type this command to build and deploy the archive:
```
 mvn clean package jboss-as:deploy
```
This will deploy target/jdg-visualizer.war to the running instance of the server.

Access the application

The application will be running at the following URL: http://localhost:8080/jdg-visualizer/.

NOTE: Before accessing the application, please ensure a JDG server is up and running!

Undeploy the Archive

Make sure you have started the JBoss Server as described above.
Open a command line and navigate to the root directory of this quickstart.
When you are finished testing, type this command to undeploy the archive:
```
 mvn jboss-as:undeploy
```

Debug the Application

If you want to debug the source code or look at the Javadocs of any library in the project, run either of the following commands to pull them into your local repository. The IDE should then detect them.

    mvn dependency:sources
    mvn dependency:resolve -Dclassifier=javadoc

alns/visual