Updating OSGi middleware bundles

To update the middleware bundles that are running in an OSGi framework, you must stop and restart the JVM server.

About this task

OSGi middleware bundles are installed in the OSGi framework during the initialization of the JVM server. If you want to update a middleware bundle, for example to apply a patch or use a new version, you must stop and restart the JVM server to pick up the changed bundle.

You can manage the lifecycle of the JVM server and edit the JVM profile by using CICS Explorer®.

Procedure

  1. Ensure that the new version of the middleware bundle is in a directory on zFS to which CICS® has read and execute access. CICS also requires read access to the files.
  2. If the zFS directory or file name is different from the values that are specified in the JVM profile, edit the OSGI_BUNDLES option in the JVM profile for the JVM server.
    1. Open the JVM Servers view in CICS Explorer to find out the name and location of the JVM profile in zFS.
      You must be connected with a region or CICSplex selected to see the JVMSERVER resources.
    2. Open the z/OS UNIX Files view and browse to the directory that contains the JVM profile.
    3. Edit the JVM profile to update the OSGI_BUNDLES option.
  3. Disable the JVMSERVER resource to shut down the JVM server.
    Disabling the JVMSERVER also disables any BUNDLE resources that contain OSGi bundles that are installed in that JVM server.
  4. Enable the JVMSERVER resource to start the JVM server with the updated JVM profile.
    The JVM server starts up and installs the new version of the middleware bundle in the OSGi framework. CICS also enables the BUNDLE resources that were disabled and installs the OSGi bundles and services in the updated framework.

Results

The OSGi framework contains the updated middleware bundles and the OSGi bundles and services for Java™ applications that were installed before you shut down the JVM server.