Install automatically using the glass box agent installer

This section describes how to install the glass box agent automatically through the user interface.

About this task

When AppScan® is installed, the files needed for installing the server agent are saved in a dedicated folder on your machine. To perform this task you will need access to this folder, and to your application server.

Procedure

  1. Open ...\Program Files\IBM\AppScan Standard\Glass box

    The exact path will depend on where you installed AppScan.

  2. Copy the relevant setup file to the web server:
    • Linux server: Copy the file GB_Java_Setup.bin
    • Windows server: Copy the file GB_Java_Setup.exe
  3. Launch the GB_Java_Setup application, and follow the online instructions. During this process you will be asked to:
    • Select your web application server. If the server is not listed (for example JBoss Service, Tomcat Service, or WebLogic Service), select Other.
    • Define a username and password for the agent. Later, when the agent is defined in AppScan, these credentials will be needed to enable communication between it and the agent. Only English ASCII characters can be used.
    Note: If you selected Other, continue as for relevant manual installation, starting from Step 5.
    Note: You may also be asked to supply the path to the relevant JAVA_HOME (JDK) or JRE_HOME (JDK or JRE) folder for your framework.
    Tip: The installer interface language options include only languages supported by your operating system. If you want to run the installer in a different language, you can start the installer through the command line, and add a flag for the required language. For example, to run the installer in Japanese on an English OS, run the command GB_Java_Setup.bin -l ja
    • A starting script is created in the glass box agent installation folder
    • I you have a desktop, a shortcut is created for starting the server with the glass box agent activated.
    Important: In order to enable glass box scanning, the application server must be started using one of these, as this starts the server with the glass box agent activated.