Managing shared libraries

Shared libraries are files used by multiple applications. Each shared library consists of a symbolic name, a Java™ class path, and a native path for loading Java Native Interface (JNI) libraries. You can use shared libraries to reduce the number of duplicate library files on your system.

Before you begin

Your applications use the same library files. The applications already are deployed on a server or you currently are deploying the applications.

About this task

Suppose that you have four applications that use the same library file, my_sample.jar. Instead of having four copies of my_sample.jar on your system after the four applications are deployed, you can define a shared library for my_sample.jar and have the four deployed applications use that one my_sample.jar library file.
Avoid trouble: If you are adding a new JAR to the shared libraries that are defined for your system, always remember to restart the Java Virtual Machine (JVM) so that this shared library addition for the new JAR becomes known to the system.

Isolated shared libraries provide another way to reduce the number of library files. Isolated shared libraries each have their own class loader, enabling a single instance of the classes to be shared across the applications. Each application can specify which isolated shared libraries that it wants to reference. Different applications can reference different versions of the isolated shared library, resulting in a set of applications sharing an isolated shared library. With isolated shared libraries, some applications can share a single copy of Library A, Version 1 while other applications share a single copy of Library A, Version 2, for a total of two instances in memory.

Using the administrative console, you can define shared libraries for the library files that multiple applications use and then associate the libraries with specific applications or modules or with an application server. Guidelines for associating shared libraries are as follows:

  • Associate a shared library file with an application or module to load the classes represented by the shared library in a local class loader, which can be an application-wide or module-wide class loader.
  • Associate an isolated shared library file with an application or module to load the classes represented by the shared library in a separate class loader created for that shared library.
  • Associate a shared library file with a server to load the classes represented by the shared library in a server-wide class loader. This class loader is the parent of the application class loader, and the WebSphere® Application Server extensions class loader is its parent. Associating a shared library file with a server associates the file with all applications on the server.

Instead of using the administrative console to associate a shared library with an application, you can use an installed optional package. You associate a shared library to an application by declaring the dependent library .jar file in the MANIFEST.MF file of the application. Refer to the Java 2 Platform, Enterprise Edition (J2EE) 1.4 specification, section 8.2 for an example.

Procedure

  • Use the administrative console to define a shared library.
    1. Create a shared library.

      On a single-server product, you can define a shared library at the cell, node, or server level.

      On a multiple-server product, you can define a shared library at the cell, node, server, or cluster level.

      Defining a library at one of the these levels does not automatically place the library into a class loader. You must associate the library with an application, module, or server before the product loads the classes represented by the shared library into a local or server-wide class loader.

    2. Associate each shared library with an application, module, or server.
      • Associate a shared library with an application or module that uses the shared library file.

        If you enabled the Use an isolated class loader for this shared library setting when creating the shared library, associate the isolated shared library with an application or module to use a separate class loader for the shared library.

      • Associate a shared library with an application server so every application on the server can use the shared library file.
  • Use an installed optional package to declare a shared library for an application.
  • Remove a shared library.
    1. Click Environment > Shared libraries in the console navigation tree to access the Shared libraries page.
    2. Select the library to be removed.
    3. Click Delete.

    The list of shared libraries is refreshed. The library file no longer displays in the list.