Run the Feature Pack for EJB 3.0 Client installation program
to install the feature pack on an existing installation of the IBM
Application Client for the WebSphere Application Server Version 6.1 product.
About this task
This topic describes how to install the Feature Pack for
EJB 3.0 Client using the installation wizard graphical interface.
It is recommended that you have 350 MB of temporary disk space available
before beginning the installation.
The installation program installs
the following program files:
- Version 6.1.0.13 maintenance packages
- Feature pack enablement extensions
- IBM Application Client for WebSphere Application Server V6.1 Feature
Pack for EJB 3.0
Results
The installation wizard records installation events in the
installation log files and installs the feature pack.
Examine messages
that the installation program displays. If the feature pack does not
install successfully, read the messages to identify why the installation
failed. Correct the problems identified and try installing the product
again.
Tip: If you are logged in as non-root or non-admin
user, you may not get a successful installation. When the installer
runs, a log file is created in your home directory. If the installation
fails, an attempt is made to move the log to the
app_client_root/uninstall_ejb3 directory;
however, without the necessary permission to move the file to the
app_client_root/uninstall_ejb3 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
If you find that your installation is interrupted, look for
the installation logs in the user_home/ejb3logs/log.txt directory.
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 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.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.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 WebSphere 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.
- If the installation program is interrupted while the fix pack
files are being installed, a later attempt to install the feature
pack might fail with an error similar to the following message:
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.