Readme for IBM WebSphere Application Server version 7.0.0.15 for IBM i

Content

IBM WebSphere Application Server for IBM i, V7.0 Fix Pack 15
IBM WebSphere Application Server Network Deployment for IBM i, V7.0 Fix Pack 15
IBM WebSphere Application Server Express for IBM i, V7.0 Fix Pack 15
IBM WebSphere Application Server Application Client for IBM i, V7.0 Fix Pack 15
IBM WebSphere Application Server Web Server Plug-ins for IBM i, V7.0 Fix Pack 15
IBM WebSphere DMZ Proxy Server for IBM i, V7.0 Fix Pack 15

Table of Contents

• About Fix Pack 15
• Additional information
• Prerequisites
• Space requirements
• Retrieving Fix Pack 15
• Steps for installing Fix Pack 15
• Known issues
• Change history
• Finding the Readme file for the Update Installer
• Trademarks and service marks
• More information

Compilation date: Feb 25, 2011

© Copyright International Business Machines Corporation 2008 All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

---

About Fix Pack 15
This document describes prerequisites, space requirements, download instructions, and installation instructions for Versions 7.0 Fix Pack 15.

Back to top

---

Additional information
You can find additional product information on the WebSphere Application Server for IBM i Version 7.0 documentation page.

The os400_readme_updateinstaller.html file in the Fix Pack contains more detailed information about applying Fix Packs.

Note: Fix Pack 7.0.0.15 needs to be installed using Update Installer version 7.0.0.15 or later. If earlier versions of Update Installer are used, prerequisite checking may fail with the following message:

"Prerequisite checking has failed. Failure messages follow:
A general exception has occurred during prerequisite checking. Check the log files for more information."

Users will see the following in the log file: ClassNotFoundException for StackDependencyPrereqChecking.

Note: If 7.0.0.15 is retrieved via an IBM i Group PTF, then the 7.0.0.15 Update Installer does not need to be downloaded. The Fix Pack 15 images for Express, Base, Network Deployment, Application Client, DMZ Secure Proxy Server and Web Server Plug-ins are also included in the Group PTF for 7.0.0.15, and they do not need to be downloaded either. However the Group PTF for 7.0.0.15 does not contain Feature Pack images.

For IBM WebSphere DMZ Proxy Server users:
The DMZ Secure Proxy Server for IBM WebSphere Application Server installation allows you to install your proxy server in the demilitarized zone (DMZ), while reducing the security risk that might occur if you choose to install an application server in the DMZ to host a proxy server. The risk is reduced by removing any functionality from the application server that is not required to host the proxy servers, but that could pose a security risk. Installing the secure proxy server in the DMZ rather than the secured zone presents new security challenges. However, the secure proxy server is equipped with capabilities to provide protection from these challenges. For detailed information on WebSphere DMZ Secure Proxy Server visit this Link.

Back to top

---

Prerequisites
Install the appropriate Fix Pack 15 on top of WebSphere Application Server Base, Network Deployment, Express, Application Client, DMZ Secure Proxy Server or Web Server Plug-ins version 7.0. To display the version of your WebSphere Application Server installation, invoke the versionInfo Qshell script as follows:

1. Sign on to your iSeries server.
   
   
2. Start a Qshell session:
   
   

STRQSH

3. Change directory to the product bin directory:
   
   

cd install_root/bin

For example: cd /QIBM/ProdData/WebSphere/AppServer/V70/Express/bin

4. Invoke the versionInfo Qshell script:
   
   

versionInfo

The following list indicates the recommended cumulative PTF package, required group PTF levels, and required singleton PTFs for the WebSphere Application Server for IBM i version 7.0 products. Fix Pack 15 was tested with the cumulative PTF package, group PTF levels and singleton PTFs listed below. If you fail to meet the requirements, you might experience unpredictable results.

i5/OS release V5R4M0
V5R4 Cumulative PTF Package C0292540 or higher.

Group PTF SF99504 Level 27 or higher
Group PTF SF99291 Level 25 or higher
Group PTF SF99114 Level 24 or higher

5722DG1 PTF SI31564
5722JV1 PTF SI33741
5722JV1 PTF SI30713
5722JV1 PTF SI30706
5722JV1 PTF SI30705
5722SS1 PTF SI36018
5722SS1 PTF SI36679

IBM i release V6R1M0
V6R1 Cumulative PTF Package C0215610 or higher.

Group PTF SF99601 Level 15 or higher
Group PTF SF99562 Level 14 or higher
Group PTF SF99115 Level 14 or higher

5761SS1 PTF SI32628
5761DG1 PTF SI31900
5761DG1 PTF SI41253
5761DG1 PTF SI42561
5761JV1 PTF SI33743
5761JV1 PTF SI33842
5761JV1 PTF SI36898
5761JV1 PTF SI36936
5761JV1 PTF SI36931
5761JV1 PTF SI37022
5761JV1 PTF SI37023
5761SS1 PTF SI36019

IBM i release V7R1M0
V6R1 Cumulative PTF Package C0229710 or higher.

Group PTF SF99701 Level 3 or higher
Group PTF SF99572 Level 4 or higher
Group PTF SF99368 Level 2 or higher

5770SS1 PTF SI40973
5770SS1 PTF SI40974
5770DG1 PTF SI41367

Back to top

---

Space requirements
Space requirements vary depending on what you are installing. The size of each download is available on the Support site. For a Fix Pack, you will need approximately 800 MB of free space.

Verify that the free space is available before beginning the installation. After the Fix Pack is installed, Fix Pack 15 increases the IBM WebSphere Application Server installation and run-time footprints by a small amount.

Space is also required for backup files in the /properties/version/backup directory of the product installation root. The space required is about the same as the size of the Fix Pack.

When installing Fix Pack 15, the update installer checks for required disk space in the /tmp directory and in the backup directory. If the /tmp directory or the backup directory have insufficient space, the update installer issues a warning message and stops the update.

Back to top

---

Retrieving Fix Pack 15
Fix Pack 15 platform-specific files for WebSphere Application Server Base, Network Deployment, Express, Application Client, Web Server Plug-ins and DMZ Proxy server:

Product edition	Fix Pack 15 pak file	Fix Pack 15 ID
Express, Base, ND	7.0.0-WS-WAS-i5osPPC-FP00000015.pak	7.0.0-WS-WAS-i5osPPC-FP00000015
Application Client	7.0.0-WS-AppClient-i5osPPC-FP00000015.pak	7.0.0-WS-AppClient-i5osPPC-FP00000015
Web Services Feature Pack for Application Server	7.0.0-WS-WASWebSvc-i5osPPC-FP0000015.pak	7.0.0-WS-WASWebSvc-i5osPPC-FP0000015
Web Services Feature Pack for Application Client	7.0.0-WS-AppClientWebSvc-i5osPPC-FP0000015.pak	7.0.0-WS-AppClientWebSvc-i5osPPC-FP0000015
Web Server Plug-ins	7.0.0-WS-PLG-i5osPPC-FP00000015.pak	7.0.0-WS-PLG-i5osPPC-FP00000015
DMZ Proxy Server	7.0.0-WS-NDDMZ-i5osPPC-FP00000015.pak	7.0.0-WS-NDDMZ-i5osPPC-FP00000015

Back to top

---

Steps for installing Fix Pack 15

A. Prepare

1. Verify required disk space.
   
   
2. Obtain the update installer V7.0.0.15 downloadable package that you need from Update Installer for V7.0 page on product support web site. Unzip or unjar the package and install it. You can install the update installer remotely from a Windows workstation or locally from the IBM i Qshell command line. The install executable is located in the UpdateInstaller directory after you extract the contents of the downloaded package.
   
   
3. (Optional) Delete the update installer ZIP file if you need more space.
   
   
4. Obtain the Fix Pack 15 downloadable package that you need from the WebSphere Application Server V7.0 Fix Pack 15 download page. Download the Fix Pack 15 maintenance package to the updi_install_root/maintenance directory. Where updi_install_root is the directory to which you installed the update installer. Usually this is the following directory:
   
   

/QIBM/ProdData/WebSphere/UpdateInstaller/V7/UPDI

5. Stop all Java™ processes that use the WebSphere Application Server product you are updating. These processes include all application server processes, the nodeagent process, the deployment manager process, and any WebSphere Application Server client applications.
   
   
6. Start the host servers if they are not currently active:
   
   

STRHOSTSVR *ALL

7. Ensure that as little activity as possible is occurring on the system. Do not put the system in restricted state or the Fix Pack install will fail.
   
   
8. You can choose to install the Fix Pack interactively or by submitting the install as a batch job. The recommended method is to submit the install as a batch job. Follow the steps below to install the Fix Pack using the SBMJOB command.
   
   Note: The SBMJOB command will submit the job to the QBATCH subsystem by default. Also by default, the QBATCH subsystem allows only one active job.
   
   You can control what subsystem the job runs in by specifying the JOBQ parameter. For example, JOBQ(QSYSNOMAX) submits the job to the QSYSWRK subsystem by default which allows an unlimited number of jobs.
   
   Ensure that the storage pool in which the job runs has at least 512 MB of memory available to be used by the updateinstaller. More memory will improve the performance time of the Fix Pack install.

B. Apply

1. If your ID has no authority to *ALLOBJ, sign on to your iSeries server with a user ID that has enough authority.
   
   
2. Use the Submit Job command to invoke the update script:
   
   

SBMJOB CMD(STRQSH CMD('updi_install_root/update -W product.location=was_install_root')) JOB(UPDATEWAS) ALWMLTTHD(*YES) JOBQ(QSYS/QSYSNOMAX)

Where updi_install_root is the directory under which the update installer is installed and was_install_root is the directory under which the product you wish to update is located. For example: SBMJOB CMD(STRQSH CMD('/QIBM/ProdData/WebSphere/UpdateInstaller/V7/UPDI/update -W product.location=/QIBM/ProdData/WebSphere/AppServer/V71/Express')) JOB(UPDATEWAS) ALWMLTTHD(*YES) JOBQ(QSYS/QSYSNOMAX)

If the updi_root/maintenance directory contains more than one .pak file, add the -W maintenance.package=fullyQualifiedPakFileName parameter to the CMD parameter above. For example: -W maintenance.package=/QIBM/ProdData/WebSphere/UpdateInstaller/V7/UPDI/maintenance/7.0.0-WS-WAS-i5osPPC-FP00000015.pak

3. Wait for the submitted job to complete. A Fix Pack install can take anywhere from 30 minutes to two hours depending on your system. If enough memory is not available, the install can take much longer, for example 22 hours or even longer.
   
   
4. Once the job has completed, check the updatelog.txt file to see if the install was successful. The last lines of the file should indicate INSTCONFSUCCESS. The log file is located under the following directory:
   
   

was_install_root/logs/update/7.0.0-WS-WAS-i5osPPC-FP00000015.install

5. Restart the HTTP Administrative instance if it was active during the update.
   
   

ENDTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN) STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

6. Restart any Web Server instances which are associated with V7.0 application servers if any were active during the update.
   
   

Back to top

---

Known issues

Known side-effects
The following are useful tips:

1. Customers wishing to install Fix Pack 7.0.0.15 must use the latest version of Update Installer (7.0.0.15), which can be obtained from the Update Installer version 7.0 download page.
   
   
2. Adjustments are required to WebSphere MQ resource adapter configuration when updating WebSphere Application Server Version 7.0 profiles. Users of WebSphere MQ messaging provider, WebSphere MQ link, or the WebSphere MQ server may need to perform some manual steps when changing maintenance levels. Information on the affected profiles and what steps are required can be obtained from Adjusting the WebSphere MQ resource adapter configuration when migrating profiles between maintenance level 7.0.0.0 and later levels.

Note: If 7.0.0.15 is retrieved via an IBM i Group PTF, then the 7.0.0.15 Update Installer does not need to be downloaded. The Fix Pack 15 images for Express, Base, ND, Application Client, DMZ Secure Proxy Server, and Web Server Plug-ins are also included in the Group PTF for 7.0.0.15, and they do not need to be downloaded either. However the Group PTF for 7.0.0.15 does not contain Feature Pack images.

Back to top

---

Finding the Readme file for the Update Installer

The readme file is available as the updi_install_root/os400_readme_updateinstaller.html file.
The information in the readme file is also available in the WebSphere Application Server Version 7.0 Information Center.

Back to top

---

Change History

28 Feb 2011

Initial Publication for Fix Pack 7.0.0.15

Back to top

---

Trademarks and service marks
The following terms are trademarks of IBM Corporation in the United States, other countries, or both:

• iSeries
• OS/400
• AS/400
• i5/OS
• System i
• System i5
• IBM
• Redbooks
• WebSphere

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Linux is a trademark of Linus Torvalds in the U.S., other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

Back to top

---

More information
For more information, refer to the Recommended fixes for WebSphere Application Server.

Back to top