Run the Feature Pack for EJB 3.0 installation program to silently
install the feature pack on an existing installation of an IBM Application
Client for the WebSphere Application Server Version 6.1 product.
Before you begin
The Feature Pack for EJB 3.0 implements the Enterprise JavaBeans
(EJB) Version 3.0 and Java Persistence API (JPA) specifications.
Before
starting this installation, do the following:
- Read Planning to install Feature Pack for EJB 3.0.
- Install a Version 6.1 WebSphere® Application Server product
if you have not done so already.
- Download and extract the Feature Pack for EJB 3.0.
For example, create
two directories, ejb3_download and ejb3_installation_image.
Then, download the feature pack to the ejb_download directory
and then extract the downloaded file to the ejb_installation_image directory.
Do not move any files out of the ejb_installation_image directory.
- The operating system requirements for a feature pack are the same as for
the IBM Application Client for the WebSphere Application Server Version 6.1
installation. However, you need to ensure that you have enough free disk space
to install the feature pack and the included maintenance onto the application
client installation.
- 1450 MB of free space available in your target installation directory
for the feature pack and included maintenance. This is in addition to the
required Version 6.1 application client product.
- 600 MB of free space available in your temporary directory
About this task
This topic describes how to install the feature pack using the installation
wizard graphical interface.
The installation program installs the following
program files if they are not already installed:
- IBM Application Client for WebSphere Application Server Version 6.1 Fix
Pack 13 (6.1.0.13)
- Java SDK 1.5 SR6 Cumulative Fix (6.1.0.13)
- Feature pack enablement extensions
- IBM Application Client for WebSphere Application Server Version 6.1 Feature
Pack for EJB 3.0
Note: Consider your current product topography before installing the
feature pack because it installs maintenance packages which may affect the
version of your application client product. If the application client is already
at or above the levels of maintenance included with the feature pack, then
the installation of these maintenance packages will be skipped.
Results
The installation wizard installs the feature pack and records installation
events in the installation log files in the
app_client_root/logs/install/ejb3 directory.
Tip: If you are logged in as non-root or non-admin
user, you may not always find a log in the application server directory after
a failed installation or uninstallation attempt. When the installer runs,
a log file is created in your user home directory. If the installation fails,
an attempt is made to move the log to the
app_client_root directory;
however, without the necessary permission to move the file to the
app_client_root directory,
the attempt to move fails and the log remains in your home directory. Look
for the following log files in the
user_home/ejb3logs directory:
- log.txt
- trace.txt.gz
- trace.xml.gz
Troubleshooting
If the installation
program is interrupted for any reason while feature pack files are being installed,
examine the messages that the installation program displays and the information
in the installation logs. Correct the problems identified and try installing
the product again. Since the feature pack installation contains the feature
pack and various fix packs, an installation failure might occur at different
points in the process.
- If the installation program is interrupted while the fix pack files are
being installed, a later attempt to install the feature pack might fail. This
could occur during the installation of the feature pack enablement fixes or
the fix pack as seen in the following example:
A failure from a previous installation or uninstallation attempt has been
detected. The failed package is 6.1.0-WS-WASSDK-WinX32-FP00000011. Click Next to
initiate automated recovery.
Since the failure occurred
during the fix pack installation, the Update Installer must be used to recover
after the failure. The feature pack installer cannot automatically recover
the installation. Cancel the automated recovery process and perform the following
actions to recover the installation.
- Install the Update Installer and launch the wizard.
- On the product selection panel, select or enter the location of the application
server product directory which you used in part d of step 4 in the Procedure.
- The Update Installer will detect that there was an update failure.
- Click Next to start the automated recovery process.
- If the installation program is interrupted while feature pack files are
being installed, a later attempt to install the feature pack might fail with
the following message:
Failure Recovery Complete
Failure recovery unsuccessful: The failed installation or uninstallation
of maintenance package fep.clt.ejb3.primary.pak was not recovered.
Click Cancel to exit the installation wizard.
Exit the installer and then perform the following manual steps:
- Remove the fep.clt.ejb3.primary.pak file from the app_client_root/properties/version/nif/backup/ directory
- Remove the app_client_root/properties/version/nif/backup/legal.ejb3 directory.
- Remove the app_client_root/lafiles/ejb3 directory.
- Make a backup copy of app_client_root/properties/version/nif/backup/updateStatus.xml. Look for the section beginning with the <package> entry
associated with fep.clt.websv.primary.ejb3 and ending with </package>,
remove it, and save the file:
<package MaintenanceNamesOfPackagesToBeCleaned=""
URIsOfPackagesToBeCleaned=""
URIsOfPackagesToBeExecuted="zip:///home/<user_name>/IBM/WebSphere/AppClient/properties/version/nif/backup/fep.clt.ejb3.primary.pak"
isprimary="true"
maintenancefilename="fep.clt.ejb3.primary.pak"
maintenancename="fep.clt.ejb3.primary.pak" mode="installconfig" modified="true"
timestamp="2007-04-05 19:16:22-0400"
uritoreinstall=""
uritouninstall="zip:///home/<user_name>/IBM/WebSphere/AppClient/properties/version/nif/backup/fep.clt.ejb3.primary.pak">
...
</package>
- Remove the EJB3 entries from the IBM Application Client
for the WebSphere Application Server registry with the InstallRegistryUtils command
in the app_client_root/bin directory.
- Run the install executable file in the EJB3 directory
of the Feature Pack for EJB 3.0 installation image and install the feature
pack.