Установка вручную на сервере JBoss или JBoss Service

В этом разделе приведены инструкции по установке агента glass box вручную на сервере JBoss или JBoss Service.

1. Откройте ...\Program Files\IBM\AppScan Standard\Glass box

   Полный путь зависит от установочного расположения AppScan.

2. Найдите файл GB_Java_Manual_Setup.zip и скопируйте его на веб-сервер.
3. Извлеките содержимое этой папки в предпочитаемое расположение на сервере.
4. Укажите имя пользователя и пароль для агента (допустимы только английские символы ASCII):
   • Сервер Linux: запустите AgentCredentials.sh <имя-пользователя> <пароль>
     Прим.: Для файла AgentCredentials.sh требуются права на выполнение.
   • Сервер Windows: запустите AgentCredentials.bat <имя-пользователя> <пароль>
5. Разверните веб-приложение GBootStrap:
   1. Войдите в консоль администрирования JBoss. Расположение по умолчанию: http://<сервер>:<порт>/admin-console/
   2. Выберите Приложения > Файлы WAR веб-приложений, затем выберите Добавить новый ресурс.
   3. Введите путь к файлу GBootStrap.war (расположен в извлеченной папке glass box) и нажмите кнопку Продолжить.
   Появится сообщение об успешном создании ресурса.
6. Завершите работу сервера/службы JBoss.
7. Укажите файл gbAgent.jar агента Java (расположен в извлеченной папке) в качестве аргумента JVM. Для этого выполните одно из следующих действий:
   • С помощью переменной среды: настройте JVM JBoss с помощью переменной среды JAVA_OPTS (если она не существует, создайте ее) со следующим значением:

     -javaagent:"<путь-к-файлу-gbAgent.jar>/gbAgent.jar"
     -Djava.net.preferIPv4Stack=true
     -Djboss.modules.system.pkgs=com.ibm.glassbox.asm.agent,
     		com.ibm.glassbox.agent,com.ibm.glassbox.logger,
     		com.ibm.glassbox.jsp,org.jboss.byteman

   • С помощью сценариев: передайте аргументы в JVM JBoss путем изменения файлов конфигурации, поставляемых вместе с сервером:

     Сервер Linux:

     1. В папке JBoss найдите и откройте файл в редакторе (обычное расположение - /bin):
        • JBoss AS: run.sh
        • JBoss EAP Standalone: standalone.sh
        • JBoss EAP Managed Domain: domain.sh
     2. Найдите строку, которая начинается с символов JAVA_OPTS, и добавьте ниже следующий код:

        export JAVA_OPTS=$JAVA_OPTS "-javaagent:<путь-к-файлу-gbAgent.jar>/gbAgent.jar"
        -Djava.net.preferIPv4Stack=true
        -Djboss.modules.system.pkgs=com.ibm.glassbox.asm.agent,
        		com.ibm.glassbox.agent,
        		com.ibm.glassbox.logger,
        		com.ibm.glassbox.jsp,org.jboss.byteman

     3. Сохраните и закройте файл.

     Сервер Windows:

     1. В папке JBoss найдите и откройте файл в редакторе (обычное расположение - /bin):
        • JBoss AS: run.conf
        • JBoss EAP Standalone: standalone.conf
        • JBoss EAP Managed Domain: domain.conf
     2. Найдите строку, которая начинается с символов set JAVA_OPTS=, и добавьте ниже следующую строку:

        set JAVA_OPTS=$JAVA_OPTS "-javaagent:<путь-к-файлу-gbAgent.jar>\gbAgent.jar"
        -Djava.net.preferIPv4Stack=true
        -Djboss.modules.system.pkgs=com.ibm.glassbox.asm.agent,
        		com.ibm.glassbox.agent,com.ibm.glassbox.logger,
        		com.ibm.glassbox.jsp,org.jboss.byteman"

     3. Сохраните и закройте файл.

   Важное замечание: Убедитесь, что JAVA_OPTS инициализируется только один раз до указанных выше строк, чтобы другие назначения JAVA_OPTS не изменили параметр -javaagent.

   Прим.: Для добавления аргументов в JAVA_OPTS применяется соглашение %JAVA_OPTS% / $ JAVA_OPTS.
8. Перезапустите сервер/службу JBoss.