Manuelle Installation auf einem Tomcat-Server

In diesem Abschnitt wird die manuelle Installation des Glass-Box-Agenten auf einem Tomcat-Server beschrieben.

Informationen zu diesem Vorgang

Bei der Installation von AppScan werden die für die Installation des Server-Agenten benötigten Dateien in einem speziellen Ordner auf Ihrem Computer gespeichert. Zum Ausführen dieser Aufgabe benötigen Sie Zugriff auf diesen Ordner sowie auf Ihren Anwendungsserver.

Vorgehensweise

Öffnen Sie ...\Programme\IBM\AppScan Standard\Glass box
Wie der absolute Pfad lautet, hängt davon ab, in welchem Verzeichnis Sie AppScan installiert haben.
Suchen Sie die Datei GB_Java_Manual_Setup.zip und kopieren Sie sie auf Ihren Web-Server.
Extrahieren Sie den Inhalt dieses Ordners in das gewünschte Verzeichnis auf dem Web-Server.
Legen Sie einen Benutzernamen und ein Kennwort für den Agenten fest (verwenden Sie nur englische ASCII-Zeichen):
- Linux-Server: Führen Sie folgenden Befehl aus: AgentCredentials.sh <Benutzername> <Kennwort>
  Anmerkung: AgentCredentials.sh muss über Ausführungberechtigungen verfügen.
- Windows-Server: Führen Sie folgenden Befehl aus: AgentCredentials.bat <Benutzername> <Kennwort>
Implementieren Sie die Webanwendung "GBootStrap".
- Bevorzugte Methode:
  1. Melden Sie sich beim Tomcat-Manager an. Die Standardposition ist http://<Servername>:<Portnummer>/manager/html
  2. Klicken Sie unter Deploy table > War file to deploy (Implementierungstabelle, Zu installierende WAR-Datei) auf Choose file (Datei auswählen).
  3. Suchen Sie die Datei "GBootStrap.war" (im extrahierten Glass-Box-Ordner) und klicken Sie auf Open (Öffnen).
  4. Klicken Sie auf Deploy (Implementieren) und stellen Sie sicher, dass "GBootStrap" zur Anwendungsliste hinzugefügt wurde.
- Alternative Methode:
  1. .Kopieren Sie die Datei "GBootStrap.war" aus dem extrahierten Glass-Box-Ordner.
  2. Fügen Sie sie in den Ordner \webapps ein, Standardverzeichnis:
```
C:\apache-tomcat-[version]\webapps
```
Fahren Sie Tomcat herunter.
Konfigurieren Sie Tomcat für die ständige Verwendung des Glass-Box-Agenten, indem Sie eine der folgenden Aktionen durchführen:
- Über die Umgebungsvariable: Konfigurieren Sie die JVM von Tomcat über die Umgebungsvariable JAVA_OPTS (erstellen Sie sie, falls sie noch nicht vorhanden ist) mit dem folgenden Wert: -javaagent:<path_to_gbAgent.jar>/gbAgent.jar.
- Durch Batch-/sh-Scripts: Übergeben Sie Argumente an die JVM, indem Sie Tomcat durch Bearbeitung der gelieferten Konfigurationsscripts ausführen:
  Linux-Server:
  1. Öffnen Sie im Ordner "Tomcat" (in der Regel unter <Pfad_zu_Tomcat-Ordner>/bin) die Datei startup.sh.
  2. Suchen Sie die Zeile, die mit CATALINA_OPTS beginnt, und fügen Sie darunter die folgende Zeile ein:
```
export CATALINA_OPTS = $CATALINA_OPTS -javaagent:<Pfad_zu_gbAgent.jar>/gbAgent.jar
```
  3. Speichern und schließen Sie die Datei.
  Windows-Server:
  1. Öffnen Sie im Ordner "Tomcat" (in der Regel unter <Pfad_zu_Tomcat-Ordner>\bin) die Datei startup.bat.
  2. Suchen Sie die Zeile, die mit set CATALINA_OPTS= beginnt, und fügen Sie darunter die folgende Zeile ein:
```
set CATALINA_OPTS = %CATALINA_OPTS% -javaagent:<Pfad_zu_gbAgent.jar>/gbAgent.jar
```
  3. Speichern und schließen Sie die Datei.
Wichtig: Stellen Sie sicher, dass CATALINA_OPTIONS nur einmal initialisiert wird und sich über den obigen Zeilen befindet, damit keine anderen CATALINA_OPTS-Zuordnungen -javaagent überschreiben.

Anmerkung: Um Argumente zu CATALINA_OPTS hinzuzufügen, verwenden Sie die Konvention %CATALINA_OPTS% / $ CATALINA_OPTS.
Starten Sie Tomcat erneut.