Troubleshooting glass box scanning

This table lists glass box scanning error messages that might appear if AppScan® is unable to work with the glass box agent on the selected server, and possible user responses to them.

Message Explanation and possible user actions
Unable to connect to agent AppScan cannot reach the server. Either the URL is incorrect, the glass box agent application (GBootStrap) is not running, or the server is down.
Incorrect agent address The URL leads to a site that is not the glass box agent application (GBootStrap) root. Verify the URL. By default it is of the format: http://:<server_name>:<port_number>/GBootStrap/
Agent not running on server The glass box agent is not instrumented on the specified server. Possible solutions:
  • Stop the server and restart it using the desktop shortcut, if one was created when you installed the agent.
  • Reinstall the glass box agent manually. See Troubleshooting glass box scanning.
Credentials needed Given credentials are incorrect. Supply the username and password that were defined during the glass box agent installation.
AppScan version older than agent version The version of AppScan is not up to date. Install the latest version of AppScan.
Agent version older than AppScan version Possibilities:
  • Agent version older than AppScan version. Install the latest version of glass box agent on the server machine.
  • Glass box agent application version is older than AppScan version. It is probable that you installed the glass box agent manually, and did not deploy GBootStrap.war. Make sure to follow the manual installation procedure for your server thoroughly.
  • Glass box agent JAR file version is older than AppScan version. You might have not restarted the server after installing the agent. Try restarting the server. If this does not help, reinstall the glass box agent.
Agent rules older than AppScan rules Glass box agent rules are out of date.
  1. Go to the Glass Box page and click Update Agent Rules in the Agent Definition of the page. If a download is available, it will be automatically downloaded to your machine and installed.
  2. Manually restart the application server, for the change to take effect.
Restart web application server Glass box agent rules were updated. Now the server must be restarted to load the new instrumentation rules.
Glass box agent JAR file version is older than AppScan version You might have not restarted the server after installing the agent. Try restarting the server. If this does not help, reinstall the glass box agent.​