Install using the command line
Learn how to install the glass box agent through the command line, automatically or interactively.
Procedure
- 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
.
- For a Linux™ server,
click
- 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) orGB_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. - To install automatically: Run a command line containing all the
following commands that apply to your server, separated by
spaces.