If you want 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.