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
- 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.
- 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.
- 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.
- Open the z/OS UNIX Files view and
browse to the directory that contains the JVM profile.
- Edit the JVM profile to update the OSGI_BUNDLES option.
- 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.
- 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.