com.github.veithen.visualwas:earscan

Open Source implementation of the WebSphere SOAP JMX protocol

License	GNU General Public License (GPL) version 3.0
GroupId	com.github.veithen.visualwas
ArtifactId	earscan
Last Version	4.0.0
Release Date	May 7, 2020
Type	jar
Description	Open Source implementation of the WebSphere SOAP JMX protocol
Project URL	https://github.com/veithen/visualwas

Download earscan

Filename	Size
earscan-4.0.0.pom
earscan-4.0.0.jar	13 KB
earscan-4.0.0-sources.jar	9 KB
earscan-4.0.0-javadoc.jar	65 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.veithen.visualwas/earscan/ -->
<dependency>
    <groupId>com.github.veithen.visualwas</groupId>
    <artifactId>earscan</artifactId>
    <version>4.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.veithen.visualwas/earscan/
implementation 'com.github.veithen.visualwas:earscan:4.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.veithen.visualwas/earscan/
implementation ("com.github.veithen.visualwas:earscan:4.0.0")

Apache Buildr

'com.github.veithen.visualwas:earscan:jar:4.0.0'

Apache Ivy

<dependency org="com.github.veithen.visualwas" name="earscan" rev="4.0.0">
  <artifact name="earscan" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.veithen.visualwas', module='earscan', version='4.0.0')
)

Scala SBT

libraryDependencies += "com.github.veithen.visualwas" % "earscan" % "4.0.0"

Leiningen

[com.github.veithen.visualwas/earscan "4.0.0"]

Dependencies

compile (6)

Group / Artifact	Type	Version
com.github.veithen.visualwas : clientlib	jar	4.0.0
wsdl4j : wsdl4j	jar	1.6.2
asm : asm	jar	3.3
commons-io : commons-io	jar	2.1
org.apache.ws.commons.axiom : axiom-api	jar	1.2.22
org.codehaus.woodstox : woodstox-core-asl	jar	4.2.0

runtime (1)

Group / Artifact	Type	Version
org.apache.ws.commons.axiom : axiom-impl	jar	1.2.22

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.13

Project Modules

There are no modules declared in this project.

VisualWAS - WebSphere plugin for VisualVM

Introduction

The VisualWAS project provides a VisualVM plugin to connect to WebSphere Application Server. It is based on a GPL licensed implementation of WebSphere's proprietary JMX/SOAP protocol and therefore doesn't require any additional libraries from the WebSphere runtime.

Also provided is a WebSphere plugin that registers the platform MXBeans in WebSphere's MBean server so that memory and thread statistics are available in VisualVM.

Compatibility

VisualWAS >= 4.0.0 is designed to work with VisualVM >= 2.0. Older versions of VisualWAS work with VisualVM 1.3.x and 1.4.x.

Installation

VisualVM plugin installation

1. Download the VisualWAS-x.y.z.nbm file for the latest VisualWAS release from the Releases page.

2. Choose Tools > Plugins from the main menu in VisualVM.

3. In the Plugins dialog that opens, switch to Downloaded tab, then click Add Plugins....

4. Select the downloaded .nbm file and click the Open button.

5. Click the Install button, review and accept the plugin license and wait for the plugin to be installed.

WebSphere plugin installation

Perform the following steps if you want to access process statistics for your WebSphere server in VisualVM:

1. Download the com.github.veithen.visualwas.mxbeans_x.y.z.jar file for the latest VisualWAS release from the Releases page and copy it to the plugins directory of your WebSphere installation (typically /opt/IBM/WebSphere/AppServer/plugins).

2. If necessary, stop the WebSphere server. Then use the osgiCfgInit command to clear the OSGi cache, as described here.

Installation of the MBeans plugin

To access the MBeans registered in WebSphere's MBean server, you need to install the VisualVM-MBeans plugin:

1. Choose Tools > Plugins from the main menu in VisualVM.

2. In the Plugins dialog that opens, switch to Available Plugins tab and click the checkbox next to VisualVM-Beans.

3. Click the Install button, review and accept the plugin license and wait for the plugin to be installed.

Usage

In order to connect to a WebSphere instance, select Add JMX Connection as usual, but then select WebSphere from the Connection type list and enter the relevant information:

Use Test connection to check that a connection to the WebSphere instance can successfully be established. If security is enabled, then you may be presented with a dialog to import the server certificate or one of the certificates in the certificate chain to the trust store:

You should typically add the root certificate to avoid problems later when the server certificate is renewed. For Network Deployment cells, this also allows you to connect to all servers in a cell without importing additional certificates.

After clicking OK the new connection should appear in the Applications view and you can start monitoring the server:

If you have installed VisualVM-MBeans plugin you can also interact with the MBeans exported by the server:

Versions

Version
4.0.0 May 7, 2020
3.0.0 Jan 12, 2019
2.2.0 Nov 11, 2018
2.1.0 Aug 27, 2018
2.0.0 Apr 28, 2018
1.0.0 Nov 6, 2016