Install automatically using the command line

This section describes how to install the glass box agent through the command line.

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:
    • For a Linux server, copy the file GB_Java_Setup.bin
    • For a Windows server, copy the file GB_Java_Setup.exe
  3. Run a command line containing all of the following arguments that apply to your server, separated by spaces.

    Command

    Description

    GB_Java_Setup.bin (Linux) or GB_Java_Setup.exe (Windows)

    The setup file.

    -i console

    -l en

    Sets the language for the installation. Use the code for your language ("en" is for English).

    -DCHOSEN_INSTALL_SET=JBoss / WebSphe / Tomcat / WebLogic / Other
    The type of server on which you are installing the agent.
    Note: If your server is not one of those listed (for example, if it's JBoss Service, Tomcat Service, or WebLogic Service), set Other.

    -DUSER_INSTALL_DIR=value

    Sets the path where the agent will be installed.

    -DGLASS_USERNAME=value

    Sets a username for accessing the agent. Only English characters and numbers can be used.

    -DGLASS_PASSWORD=value

    Sets a password for accessing the agent. Only English characters and numbers can be used.

    -DWEBLOGIC_PATH / -DJBOSS_PATH / -DTOMCAT_PATH / -DWEBSPHERE_PATH=value

    Sets the path of the web server installation directory.

    Examples (actual location depends on your system):

    WebLogic: C:\weblogic\user_projects\domains\base_domain\

    JBoss: C:\jboss-6.0.0\

    Tomcat: C:\apache-tomcat-6.0.32\

    WebSphere: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\

    -DJBOSS_SERVER_NAME=value / -DWEBSPHERE_SERVER_NAME=value

    The server name.

    -DWEBLOGIC_USERNAME / -DWEBSPHERE_USERNAME=value

    -DWEBLOGIC_PASSWORD / -DWEBSPHERE_PASSWORD=value

    Username and password to access the application server

    -DWEBLOGIC_LIB=value

    The path to the LIB folder, for example:

    C:\weblogic\wlserver_10.3\server\lib\

    -DWEBLOGIC_TARGET=value

    The server/target name.

    -DWEBLOGIC_PORT=value

    The administration port.

    -DSELECTED_JBOSS_TYPE=value

    Use one of the following values:

    JBoss AS

    JBoss EAP Standalone

    JBoss EAP Managed Domain

    Example for WebSphere:

    GB_Java_Setup.bin -i console -l en -DCHOSEN_INSTALL_SET=WebSphe
-DUSER_INSTALL_DIR=/opt/glass_box -DGLASS_USERNAME=jsmith
-DGLASS_PASSWORD=1234
-DWEBSPHERE_PATH=/opt/IBM/WebSphere/AppServer/profiles/AppSrv01
-DWEBSPHERE_SERVER_NAME=server1
-DWEBSPHERE_USERNAME=admin -DWEBSPHERE_PASSWORD=admin_pw
  4. Verify that your web server stopped at the end of the procedure. If it did not, then stop it manually.
  5. Start the web server again using the desktop shortcut, or the starting script in the glass box agent installation folder, so that the glass box agent is now active.