Readme for IBM WebSphere Application Server V6.1.0.47 for i5/OS

Content

IBM WebSphere Application Server for i5/OS, V6.1 Fix Pack 47
IBM WebSphere Application Server Network Deployment for i5/OS, V6.1 Fix Pack 47
IBM WebSphere Application Server Express for i5/OS, V6.1 Fix Pack 47
IBM WebSphere Application Server Application Client for i5/OS, V6.1 Fix Pack 47
IBM WebSphere Application Server Web Server Plug-ins for i5/OS, V6.1 Fix Pack 47
IBM Web Service Feature Pack for i5/OS, V6.1 Fix Pack 47

Note WAS 6.1.0.47 and WebServices FEP 6.1.0.47are the final fix packs for WAS 6.1 release stream that has End of Service (EOS) date of Sept 30, 2013.

Table of Contents

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

Compilation date: Sep 9, 2013

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

---

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

Back to top

---

Additional information
You can find additional product information on the WebSphere Application Server for i5/OS Version 6.1 documentation page.

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

Note: Fix Pack 6.1.0.47 needs to be installed using Update Installer version 7.0 or later. If earlier versions of Update Installer (For example: version 6.1.0.1 or 6.1) are used, prerequisite checking will 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.

The Update Installer version 7.0 requires Java version 6.0. Ensure at least one of the following Java 6 products is installed:
IBM i 5.4
5722JV1 option 10 - Java Developer Kit
5722JV1 option 11 - Java Developer Kit
IBM i 6.1
5761JV1 option 10 - Java Developer Kit 6
5761JV1 option 11 - Java SE 6 32 bit
5761JV1 option 12 - Java SE 6 64 bit
IBM i 7.1
5761JV1 option 11 - Java SE 6 32 bit
5761JV1 option 12 - Java SE 6 64 bit

Note: If 6.1.0.47 is retrieved by way of an i5/OS Group PTF, then the 7.0 Update Installer does not need to be downloaded. The Fix Pack 47 images for Express, Base, ND, Application Client, and Web Server Plug-ins are also included in the Group PTF for 6.1.0.47, and they do not need to be downloaded either. However the Group PTF for 6.1.0.47 does not contain Feature Pack images. If the Web Services Feature Pack Fix Pack 47 is needed (see below), it will need to be downloaded.

For Web Services Feature Pack users:
Web Services Feature Pack Fix Pack 47 is also available as a separate PAK file for Web Services Feature Pack users. If WebSphere Application Server Version 6.1 Feature Pack for Web Services is installed on your system, you must download and install the WebSphere Application Server Fix Pack 47 and the Web Services Feature Pack Fix Pack 47 together, or your Update Installer will not allow the installation to proceed.

For more information on the Web Services Feature Pack, see Feature Pack for Web Services for WebSphere Application Server V6.1 and Feature packs by version.

Note: When upgrading WebSphere Application Server and Web Services Feature Pack for Application Server as well as Application Client products from version 6.1.0.11 to version 6.1.0.47 or higher level, a mandatory Interim Fix must be installed prior to the installation of Fix Pack 6.1.0.47 or higher. The Update Installer will not allow you to upgrade WebSphere Application Server and Web Services Feature Pack to version 6.1.0.47 or higher from version 6.1.0.11 without installing this Interim Fix first.

Download Interim Fix PK53084 which is required to be installed while upgrading WebSphere Application Server and Web Services Feature Pack for Application Server version 6.1.0.11 to version 6.1.0.47 or higher level.

Download Interim Fix PK53210 which is required to be installed while upgrading WebSphere Application Client and Web Services Feature Pack for Application Client version 6.1.0.11 to version 6.1.0.47 or higher level.

Information about updates and related documentation is available from the WebSphere Application Server V6.1 Fix Pack 47 download page.

Note: When upgrading WebSphere Application Server and Web Services Feature Pack for Application Server as well as Application Client products from version 6.1.0.29, installed with the V6.1 Refresh image V6.1.0.29, to version 6.1.0.47 or higher level, a mandatory Interim Fix must be installed prior to the installation of Fix Pack 6.1.0.47 or higher. The Update Installer will not allow you to upgrade WebSphere Application Server and Web Services Feature Pack to version 6.1.0.47 or higher from refresh version 6.1.0.29 without installing this Interim Fix first.

Download Interim Fix PK53084 which is required to be installed while upgrading WebSphere Application Server and Web Services Feature Pack for Application Server version 6.1.0.29 to version 6.1.0.47 or higher level.

Download Interim Fix PK53210 which is required to be installed while upgrading WebSphere Application Client and Web Services Feature Pack for Application Client version 6.1.0.29 to version 6.1.0.47 or higher level.

For more information on the Web Services Feature Pack, see Feature Pack for Web Services for WebSphere Application Server V6.1 and Feature packs by version.

For Feature Pack users:
Feature Pack Fix Pack 47 is also available as a separate PAK file for Feature Pack users. If WebSphere Application Server Version 6.1 Feature Pack is installed on your system, you must download and install the WebSphere Application Server Fix Pack 47 and the Feature Pack Fix Pack 47 together, or your Update Installer will not allow the installation to proceed.

Back to top

---

Prerequisites
Install the appropriate Fix Pack 47 on top of WebSphere Application Server Base, Network Deployment, Express, Application Client or Web Server Plug-ins version 6.1. 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/V61/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 i5/OS version 6.1 products. Fix Pack 47 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 C2094540 or higher.

Group PTF SF99504 Level 33 or higher
Group PTF SF99291 Level 29 or higher
Group PTF SF99114 Level 32 or higher

5722BZ1 PTF SI12985
5722BZ1 PTF SI20298

i5/OS release V6R1M0
V6R1 Cumulative PTF Package C2122610 or higher.

Group PTF SF99601 Level 26 or higher
Group PTF SF99562 Level 19 or higher
Group PTF SF99115 Level 26 or higher

5761DG1 PTF SI47942

i5/OS release V7R1M0
V6R1 Cumulative PTF Package C2115710 or higher.

Group PTF SF99701 Level 14 or higher
Group PTF SF99572 Level 8 or higher
Group PTF SF99368 Level 14 or higher



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 47 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 47, 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 47
Fix Pack 47 platform-specific files for WebSphere Application Server Base, Network Deployment, Express, Application Client and Web Server Plug-ins:

Product edition	Fix Pack 47 pak file	Fix Pack 47 ID
Express, Base, ND	6.1.0-WS-WAS-i5osPPC-FP0000047.pak	6.1.0-WS-WAS-i5osPPC-FP0000047
Application Client	6.1.0-WS-AppClient-i5osPPC-FP0000047.pak	6.1.0-WS-AppClient-i5osPPC-FP0000047
Web Services Feature Pack for Application Server	6.1.0-WS-WASWebSvc-i5osPPC-FP0000047.pak	6.1.0-WS-WASWebSvc-i5osPPC-FP0000047
Web Services Feature Pack for Application Client	6.1.0-WS-AppClientWebSvc-i5osPPC-FP0000047.pak	6.1.0-WS-AppClientWebSvc-i5osPPC-FP0000047
Web Server Plug-ins	6.1.0-WS-PLG-i5osPPC-FP0000047.pak	6.1.0-WS-PLG-i5osPPC-FP0000047

Back to top

---

Steps for installing Fix Pack 47

A. Prepare

1. Verify required disk space.
   
   
2. Obtain the update installer V7.0 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 i5/OS 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 47 downloadable package that you need from the WebSphere Application Server V6.1 Fix Pack 47 download page. Download the Fix Pack 47 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/V61/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/V61/updi/update -W product.location=/QIBM/ProdData/WebSphere/AppServer/V61/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/V61/updi/maintenance/6.1.0-WS-WAS-i5osPPC-FP0000047.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/6.1.0-WS-WAS-i5osPPC-FP0000047.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 V6.1 application servers if any were active during the update.
   

Back to top

---

Known issues

Fix Pack 6.1.0.47 needs to be installed by the latest version of Update Installer 7.0. If earlier versions of Update Installer (For Example: versions 6.1.0.1 or 6.1) are used, prerequisite checking will 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.

Customers interested in upgrading their WebSphere Application Server, or WebSphere Application Client environments (only) to the latest maintenance level (6.1.0.47) need to download and install only maintenance Fix Pack 6.1.0.47.

Customers interested in upgrading their WebSphere Application Server, or WebSphere Application Client environments, which also have Feature Pack for Web Services installed must apply both maintenance Fix Packs to their systems (both WebSphere Fix Pack 47 and Web Services Feature Pack Fix Pack 47.)

Customers wishing to install Fix Pack 6.1.0.47 must use the latest version of Update Installer (7.0) which can be obtained from the Update Installer version 7.0 download page.

Note: If 6.1.0.47 is retrieved via an i5/OS Group PTF, then the 7.0.0.3 Update Installer does not need to be downloaded. The Fix Pack 47 images for Express, Base, ND, Application Client, and Web Server Plug-ins are also included in the Group PTF for 6.1.0.47, and they do not need to be downloaded either.

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 6.1 Information Center.

Back to top

---

Change history

• Sep 9, 2013: Initial publication.

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