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
- Open
...\Program Files\IBM\AppScan Standard\Glass box
The exact path will depend on where you installed AppScan.
- 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
- For a Linux server, copy the file
- 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) orGB_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
- Verify that your web server stopped at the end of the procedure. If it did not, then stop it manually.
- 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.