JAR-Dateien von Drittanbietern installieren

Das Dienstprogramm " install3rdParty kopiert die bereitgestellten Ressourcen in die Verzeichnisstruktur der Anwendung und fügt die hinzugefügten benutzerdefinierten JAR-Dateien von Drittanbietern an den globalen Klassenpfad, den Agentenklassenpfad oder die EAR-Datei des Anwendungsservers an.

Hinweis: Wenn JAR-Dateien aufgrund von Sicherheitslücken veraltet sind, stellen Sie sicher, dass Sie die Abhängigkeit von solchen JAR-Dateien bewerten und ihre Verwendung in Ihrer Anpassung eliminieren. Wenn JAR-Dateien aus nicht sicherheitsrelevanten Gründen veraltet sind, können Sie die Bibliothek des Drittanbieters weiterhin verwenden, indem Sie die JAR-Dateien der Bibliothek, die aus Ihrem Anpassungspaket entfernt werden, paketieren. Weitere Informationen finden Sie unter Veraltete Komponenten.

Die Syntax für das Script install3rdParty lautet wie folgt:


./install3rdParty.sh vendorName vendorVersion <-d | -j | -l | -p | -r > filelist 
[-targetJVM EVERY | NOWHERE | DCL | APP | AGENT | [-uninstall]

hier

  • <vendorName> muss yfsextn sein.
  • <vendorVersion> muss 1_0 sein.
  • [-uninstall] wird verwendet, um eine JAR-Datei aus dem JAR-Verzeichnis oder den Klassenpfaddateien zu entfernen. Stellen Sie sicher, dass Sie den Befehl " setupfiles.sh ausführen.

    Wenn Sie zum Beispiel die benutzerdefinierte JAR-Datei zur Datei " AGENTDynamicclasspath.cfg hinzufügen möchten, führen Sie den Befehl install3rdparty mit den folgenden Argumenten aus:

    ./install3rdParty.sh yfsextn 1_0 -j <Path_to_your_custom_JAR> -targetJVM AGENT

Übergeben Sie je nach Dateityp die entsprechenden Argumente:

  • -d für Datenbank-JAR oder komprimierte Dateien
  • -j für JAR- oder komprimierte Dateien
  • -l für gemeinsam genutzte Bibliotheken
  • -p für Eigenschaftendateien
  • -r für Ressourceneigenschaftendateien

<filelist> verweist auf den Pfad zu Ihrer Anpassungsdatei.

Verwenden Sie beispielsweise den folgenden Befehl, um wsogclient.jar im dynamischen Klassenpfad des Agenten zu installieren:


<runtime_sandbox>/bin/install3rdParty.sh yfsextn 1_0 -j
<WAS_HOME>/lib/wsogclient.jar -targetJVM AGENT

<WAS_HOME> befindet sich normalerweise im Verzeichnis /opt/IBM/WebSphere/AppServer .

Dieser Befehl bewirkt, dass die Datei " wsogclient.jar vom WebSphere in das Produktinstallationsverzeichnis (<runtime_sandbox>/jar/yfsextn/1_0/wsogclient.jar) kopiert wird. Das Dienstprogramm aktualisiert dann die Datei " <runtime_sandbox>/properties/AGENTDynamicclasspath.cfg.in mit der neuen JAR-Datei und verwendet das Dienstprogramm " <runtime_sandbox>/bin/setupfiles.sh, um die Datei " AGENTDynamicclasspath.cfg anhand der geänderten Datei ".in neu zu generieren.

Wenn Sie möchten, dass die neue JAR-Datei dem Anwendungsserver und den Agenten beim Ausführen des Dienstprogramms " install3rdParty zur Verfügung gestellt wird, übergeben Sie die folgenden Argumente:

Argument
Beschreibung
Alle
Fügt die neue JAR-Datei allen dynamischen Klassenpfaddateien hinzu (z. B. APPDynamicclasspath.cfg, AGENTDynamicclasspath.cfgund dynamicclasspath.cfg).
nirgendwo
Fügt die neue JAR-Datei zum Verzeichnis <runtime_sandbox>/jar hinzu und möchte keine der dynamischen Klassenpfaddateien aktualisieren
dcl
Fügt die neue JAR-Datei nur zur Hauptdatei Dynamicclasspath.cfg hinzu
ANW
Fügt die neue JAR-Datei zur EAR-Datei hinzu
AGENT
Fügt die neue JAR-Datei zur Datei AgentDynamicclasspath.cfg hinzu.
Hinweis: Die Anwendung unterstützt nur die Optionen, die oben für das Dienstprogramm " install3rdParty aufgeführt sind. Alle anderen Optionen, die mit dem Nachrichtenbefehl -help angezeigt werden, werden nicht unterstützt.

Wenn das Argument für " -targetJVM nicht angegeben wird, wird die neue JAR-Datei der Datei " Dynamicclasspath.cfg hinzugefügt.

Wenn Sie das Dienstprogramm " install3rdParty verwenden, um einen Klassenpfad zu aktualisieren:

  • Die Reihenfolge der Zeilen in den dynamischen Klassenpfaddateien bestimmt die Reihenfolge des Klassenpfads für den Anwendungsserver oder Agenten.
  • Was auch immer am Anfang der Datei steht, ist analog zur JAR-Datei am Anfang des Klassenpfads angesiedelt.

Um Hilfe bei der Verwendung des Dienstprogramms " install3rdParty zu erhalten, geben Sie in der Befehlszeile den Befehl einschließlich der Option " -help ein. Das Dienstprogramm ' install3rdParty gibt eine Benutzungsmeldung aus.