You can use the System Modification Program / Extended
(SMP/E) to install the Feature Pack for OSGi Applications and Java
Persistence API 2.0 on WebSphere® Application
Server for z/OS® Version 7.0.
What to do next
Install the OSGi Applications and Java Persistence API
2.0 extensions for the Profile Management Tool.
- Make sure that you have installed the most current version of WebSphere Customization Tools
Version 7.0 on your workstation.
You can download the latest version
of WebSphere Customization
Tools from the following Web sites:
- Make sure that you performed the SMP/E installation of the WebSphere Application Server
Version 7.0 Feature Pack for OSGi Applications and Java Persistence
API 2.0 on your z/OS system.
- Create a folder on your workstation to receive the files to be
downloaded from the z/OS system.
- Download and install the extensions for the WebSphere Customization
Tools on your workstation. There is a separate extension for each
feature (OSGi Applications and Java Persistence API 2.0); you only
need to install the extensions for the features that you will be using.
- Download and install the Java Persistence API 2.0 feature extension.
- Using FTP, download the following file in binary format from the z/OS system where the WebSphere Application Server for z/OS Optional Materials program
is installed. For example:
/usr/lpp/zWebSphere_OM/V7R0/FPAJ/JPA/util/WCT/jpa.wct
- Open the WebSphere Customization
Tools on your workstation, and go to Help > Software Updates >
Install Extension.
- On the Extension Locations panel, click Install new extension
location.
- On the Source Archive File panel, use the Browse button
to specify the path to the jpa.wct file that you
downloaded from the SMP/E location and then click Next.
- On the Summary Location panel, click Next.
- On the Install Successful panel, perform the following actions:
- Select the entire contents of the Location field and copy them
to the clipboard.
- To be certain that you captured the location, paste it into a
text-editor session.
- Click Finish.
- In the Product Configuration panel that displays, click Add
an Extension Location.
Notes:
- You can always access this panel directly by going to Help
> Software Updates > Product Configuration.
- Do not use any other feature or link on this panel other than Add
an Extension Location. The other tasks listed on this panel are
not supported in the WebSphere Customization
Tools environment.
- In the panel that displays, paste the copied location into the
Folder field and click OK.
- Click Yes on the panel asking you if you would like to
restart the WebSphere Customization
Tools.
Note: You might need to manually restart the WebSphere Customization Tools if it does
not restart automatically.
- Download and install the OSGi Applications feature extension.
- Using FTP, download the following file in binary format from the z/OS system where the WebSphere Application Server for z/OS Optional Materials program
is installed. For example:
/usr/lpp/zWebSphere_OM/V7R0/FPAJ/Aries/util/WCT/aries.wct
- Open the WebSphere Customization
Tools on your workstation, and go to Help > Software Updates >
Install Extension.
- On the Extension Locations panel, click Install new extension
location.
- On the Source Archive File panel, use the Browse button
to specify the path to the aries.wct file that you
downloaded from the SMP/E location and then click Next.
- On the Summary Location panel, click Next.
- On the Install Successful panel, perform the following actions:
- Select the entire contents of the Location field and copy them
to the clipboard.
- To be certain that you captured the location, paste it into a
text-editor session.
- Click Finish.
- In the Product Configuration panel that displays, click Add
an Extension Location.
Notes:
- You can always access this panel directly by going to Help
> Software Updates > Product Configuration.
- Do not use any other feature or link on this panel other than Add
an Extension Location. The other tasks listed on this panel are
not supported in the WebSphere Customization
Tools environment.
- In the panel that displays, paste the copied location into the
Folder field and click OK.
- Click Yes on the panel asking you if you would like to
restart the WebSphere Customization
Tools.
Note: You might need to manually restart the WebSphere Customization Tools if it does
not restart automatically.
- Verify the proper installation of the extensions.
- Go to Help > About WebSphere Customization
Tools.
- Click Feature Details.
- Make sure that the OSGi Applications feature, the Java Persistence
API 2.0 feature, or both (depending on which extensions you installed)
appear in the list.
When you have finished the installation, you can create
a WebSphere Application
Server on z/OS runtime environment
that includes OSGi Applications and Java Persistence API 2.0 feature
functions (depending on which WebSphere Customization Tools extensions
you installed). To use a feature, you must create a new profile with
the feature or augment an existing profile with the feature.
Important: Back up your configuration file
system before augmenting any profiles. You cannot unaugment profiles,
and you might want to restore your pre-augmentation configuration
later. After you restore, you will have to manually make any other
changes that you made to the configuration after the backup.
Use
the workstation-based Profile Management Tool, which can be launched
from the WebSphere Customization
Tools, or the zpmt command to generate customization
jobs and associated instructions for OSGi Applications and Java Persistence
API 2.0 profile creation and augmentation.
You can create a
standalone application server that is enabled for a feature, or you
can enable an existing application server with this feature using
profile augmentation. If you want to enable more than one feature
or feature pack on a single application server node, you must use
the augmentation procedure. Either create a standalone application
server that is enabled for one feature or feature pack and then use
profile augmentation to enable it for another feature or feature pack;
or start with an existing application server and enable it for each
feature or feature pack using profile augmentation.
To use the
OSGi Applications or Java Persistence API 2.0 feature in a Network
Deployment cell, create a deployment manager that is enabled for the
feature or enable the deployment manager in an existing Network Deployment
cell for the feature.