Legacy Glassbox Installation Reference

StartLast reviewed: September 25, 2026

This page is retained as a legacy reference for environments that still require Glassbox integration or installation notes.

What changed in this article

• Marked Glassbox installation as legacy/environment-specific unless a current customer deployment still depends on it.
• Added validation steps around version compatibility, required access, and post-install evidence.
• Avoided presenting Glassbox installation as a default AIQ integration path.

Validation workflow

1. Confirm the customer still uses Glassbox and identify the required version.
2. Validate prerequisites and access with the Glassbox installerowner usingbefore installation work.
3. After installation, run a small validation flow and capture evidence that AIQ and Glassbox data align.

Review note: Flagged the followingarticle commands.as 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 customizationlegacy to theprevent 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.warit from Appvance_home/TestNetwork/TestNode/webapps.being treated as standard integration guidance.