Installing Glassbox

Start the Glassbox installer using the following commands. Glassbox supports Apache Tomcat, IBM WebSphere, Oracle BEA WebLogic, RedHat JBoss, and Jetty.

Run the Glassbox installer.

java -jar Appvance_home/installme/glassbox.jar

Follow the Glassbox installer instructions.

Depending on your application server, Glassbox may require changes and customization to the installation. For example, a Jetty application server installing Glassbox requires the following changes.

Install the following files and directory in the Jetty_home/lib directory:

aspectweaver.jar

glassboxMonitor.jar

glass box directory of supporting files

Change the Jetty start-up script (Jetty_home/start.sh or Jetty_home/start.bat) by adding the following command line switches:

-javaagent:./lib/aspectjweaver.jar -Dglassbox.install.dir=./lib/glassbox

Optionally set the Glassbox JMX port and authentication parameters in the Jetty start-up script:

-Dcom.sun.management.jmxremote.port=9999

-Dcom.sun.management.jmxremote.authenticate=false

-Dcom.sun.management.jmxremote.ssl=false

Restart Jetty

Browse http://localhost:8080/glassbox

Installation support is available at Glassbox Web site.

Installation Issues and Answers

Glassbox installation requires a Java application server to use AspectJ Weaver. Glassbox requires AspectJ 1.6 or later. Configuring AspectJ can be an issue depending on the application server. For example, IBM WebSphere ships with an older and incompatible version of AspectJ and requires a simple upgrade to the AspectJ jar files.

Note: The OpenAMF and Calendar example services (openamf.war and calendar.war) that come with AIQ is not compatible with Glassbox. Disable the OpenAMF and Calendar example services by removing openamf.war and calendar.war from Appvance_home/TestNetwork/TestNode/webapps.