[z/OS]

Installing and configuring the feature pack on z/OS systems

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.

Before you begin

Before starting this installation, perform the following actions:
  • Install the WebSphere Application Server for z/OS Version 7.0 product code and optional materials if you have not done so already.
  • Install the WebSphere Customization Tools, which contain the Profile Management Tool, if you are going to use it to create the jobs for enabling profiles for the feature pack.

    The latest version of the WebSphere Customization Tools can be downloaded from IBM® WebSphere Customization Tools.

About this task

The Feature Pack for OSGi Applications and Java Persistence API 2.0 is included as service with the WebSphere Application Server for z/OS optional materials.

Procedure

  1. Obtain the program temporary fix (PTF) numbers for the Feature Pack for OSGi Applications and Java Persistence API 2.0 product code from the WebSphere Application Server for z/OS service support Web site.
  2. Order or download the appropriate PTFs.
  3. Verify that you are running the minimum level of WebSphere Application Server for z/OS that is required by the feature pack, and install any WebSphere Application Server for z/OS maintenance that is needed.
  4. Install the product PTFs for the Feature Pack for OSGi Applications and Java Persistence API 2.0.

    Follow the instructions provided in the PTFs.

    The product files for the feature pack are installed into the following directory:

    -PathPrefix-/usr/lpp/zWebSphere_OM/V7R0/FPAJ

    The product files for the OSGi Applications feature are installed into the following directory:

    -PathPrefix-/usr/lpp/zWebSphere_OM/V7R0/FPAJ/Aries

    The product files for the Java Persistence API 2.0 feature are installed into the following directory:

    -PathPrefix-/usr/lpp/zWebSphere_OM/V7R0/FPAJ/JPA

    The file system containing these directories must be mounted on all z/OS systems on which the feature pack will be used.

What to do next

Install the OSGi Applications and Java Persistence API 2.0 extensions for the Profile Management Tool.
  1. 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:
  2. 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.
  3. Create a folder on your workstation to receive the files to be downloaded from the z/OS system.
  4. 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.
      1. 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
      2. Open the WebSphere Customization Tools on your workstation, and go to Help > Software Updates > Install Extension.
      3. On the Extension Locations panel, click Install new extension location.
      4. 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.
      5. On the Summary Location panel, click Next.
      6. On the Install Successful panel, perform the following actions:
        1. Select the entire contents of the Location field and copy them to the clipboard.
        2. To be certain that you captured the location, paste it into a text-editor session.
        3. Click Finish.
      7. 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.
      8. In the panel that displays, paste the copied location into the Folder field and click OK.
      9. 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.
      1. 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
      2. Open the WebSphere Customization Tools on your workstation, and go to Help > Software Updates > Install Extension.
      3. On the Extension Locations panel, click Install new extension location.
      4. 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.
      5. On the Summary Location panel, click Next.
      6. On the Install Successful panel, perform the following actions:
        1. Select the entire contents of the Location field and copy them to the clipboard.
        2. To be certain that you captured the location, paste it into a text-editor session.
        3. Click Finish.
      7. 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.
      8. In the panel that displays, paste the copied location into the Folder field and click OK.
      9. 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.
  5. Verify the proper installation of the extensions.
    1. Go to Help > About WebSphere Customization Tools.
    2. Click Feature Details.
    3. 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.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 12, 2013 3:32:32 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v700osgijpa&product=was-nd-mp&topic=tins_pmt_osgi_jpa2
File name: tins_install_osgi_jpa2_zos.html