Installing third-party JAR files

The install3rdParty utility copies the supplied resources to the application directory structure, and appends the added third-party custom JAR files to the global classpath, agent classpath, or application server EAR file.

Note: If JAR files are deprecated due to security vulnerabilities, ensure that you evaluate the dependency of such JAR files and eliminate their use in your customization. If JAR files are deprecated for nonsecurity reasons, you can continue to use the third-party library by packaging the library JAR files that are removed from your customization package. For more information, see Deprecated components.

Following is the syntax for the install3rdParty script:


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

Here

  • <vendorName> must be yfsextn.
  • <vendorVersion> must be 1_0.
  • [-uninstall] is used to remove a JAR file from the JAR directory or the classpath files. Ensure that you run the setupfiles.sh command.

    For example, if you want to add the custom JAR file to the AGENTDynamicclasspath.cfg file, run the install3rdparty command with following arguments:

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

Based on the file type, pass the appropriate arguments:

  • -d for database JAR or compressed files
  • -j for JAR or compressed files
  • -l for shared libraries
  • -p for properties files
  • -r for resource properties files

<filelist> refers to the path to your custom file.

For example, to install the wsogclient.jar to the dynamic classpath of the agent, use the following command:


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

<WAS_HOME> is typically in /opt/IBM/WebSphere/AppServer

This command causes the wsogclient.jar file to be copied from the WebSphere installation location into the product installation location (<runtime_sandbox>/jar/yfsextn/1_0/wsogclient.jar). The utility then updates the <runtime_sandbox>/properties/AGENTDynamicclasspath.cfg.in file with the new JAR file and uses the <runtime_sandbox>/bin/setupfiles.sh utility to regenerate the AGENTDynamicclasspath.cfg file from the modified ".in" file.

If you want the new JAR file to be made available to the Application Server and Agents when running the install3rdParty utility, pass the following arguments:

Argument
Description
EVERY
Adds the new JAR file to all the dynamic classpath files (for example, APPDynamicclasspath.cfg, AGENTDynamicclasspath.cfg, and dynamicclasspath.cfg.
NOWHERE
Adds the new JAR file to the <runtime_sandbox>/jar directory and do not want to update any of the dynamic classpath files
DCL
Adds the new JAR file to the main Dynamicclasspath.cfg file only
APP
Adds the new JAR file to the EAR file
AGENT
Adds the new JAR file to the AgentDynamicclasspath.cfg file
Note: The application supports only those options that are listed earlier for the install3rdParty utility. Any other options that are displayed with the -help message command are not supported.

If the argument for -targetJVM is not specified, the new JAR file is added to the Dynamicclasspath.cfg file.

When you use the install3rdParty utility to update a classpath:

  • The order of lines in the dynamic classpath files determines the order of the classpath for the application server or agent.
  • Whatever is in the beginning of the file is analogous to the JAR file as it is in the beginning of the classpath.

For help with using the install3rdParty utility, on the command line, enter the command, including the -help option. The install3rdParty utility prints a usage message.