Skip to content

Installation

Jump to bottom
inno-juanal edited this page Mar 22, 2017 · 17 revisions

Where to Find the Distributions

Go to the releases section.

Using the Stand-alone JAR

There are two ways you can install this library:

  • Add wmboost-data standalone JAR once per Integration Server package.
  • Share a single copy of wmboost-data standalone JAR across Integration Server packages either for a single Integration Server instance or for the entire installation

Steps

  1. Grab the wmboost-data-x-standalone.jar release file, where x is the latest version number. It's also recommended to download the sources and javadoc JARs so you can access them from the IDE.

  2. Copy the JAR(s) to webMethods Integration Server

  • Per package:
    • webMethods 9.6 and higher: copy it to _pathToIntegrationServer_/instances/_default_/packages/_MyPackage_/code/jars folder, where MyPackage is the name of your package.
    • previous versions: copy it to _pathToIntegrationServer_/packages/_MyPackage_/code/jars folder, where MyPackage is the name of your package.
  • Shared across packages.
    • For a specific instance (webMethods 9.6 and higher), copy the JAR to _pathToIntegrationServer_/instances/_default_/lib/jars/custom where default is the name of your instance.
    • Across all Integration Server instances, copy the JAR to _pathToIntegrationServer_/lib/jars

Refer to the webMethods Integration Server Administrator's Guide for more details.

Using the Non-stand-alone JAR

If you need to use the non-stand-alone JAR as described in the [Distributions] (Distributions and Dependencies) section, the safest way is to:

  • include the JAR and your Spring JAR once per package
  • configure the package to give preference to the classes in your package in order to avoid class loader conflicts. To accomplish this, change the package's manifest.v3 file to include the following line:

<value name='classloader'>package</value>

Refer to the webMethods Integration Server Administrator's Guide for more details.

Note: An alternative is to share the Spring version that comes with webMethods but do this with caution, making sure it won't cause any problems. webMethods 9.12 includes Spring version 3.2.x. The embedded one is version 4.x, which comes with automatic type conversions for Java types introduced in Java 8 - which may or not be relevant depending on what you use.

Clone this wiki locally