Install using the command line

Learn how to install the glass box agent through the command line, automatically or interactively.

Procedure

  1. On the Glass Box page of a content scan job, expand the Download glass box agent installer section:
    • For a Linux™ server, click GB_Setup.bin.
    • For a Windows™ server, click GB_Setup.exe.
  2. Do one of the following:
    • To install automatically: Run a command line containing all the following commands that apply to your server, separated by spaces.

      Command

      Description

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

      The setup file.

      -i console

      -l en

      Sets the language for the application. 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 Server, Tomcat Server, or WebLogic Server), setOther.

      -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\HCL\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.

      Example for WebSphere:

      GB_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/HCL/WebSphere/AppServer/profiles/AppSrv01
-DWEBSPHERE_SERVER_NAME=server1
-DWEBSPHERE_USERNAME=admin -DWEBSPHERE_PASSWORD=admin_pw
    • To install interactively: Run the following command line:
      -i console -DMODE=interactive

      You will then be able to enter the information through the command line. (At any step of the process you can return to the previous step by typing back).

    Important: Whenever the server is started, it must be started using the desktop shortcut, so that the glass box agent is active.