Install a feature pack directly from your iSeries server
onto an existing Version 6.1 application server.
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,
complete the following actions:
- Read Planning to install Feature Pack for EJB 3.0.
- Ensure that your user profile has *ALLOBJ and *SECADM special
authorities.
- Determine if the application server is already installed on your
server. The feature pack must be installed on an existing application
server installation.
- Enter the Display Software Resources (DSPSFWRSC)
command on a CL command line.
- Look for an entry with the product Resource ID
5733W61.
- If you do not find the product Resource ID, then this product
has not been installed on your iSeries server.
- If you find the product Resources ID, ensure that at least one
of the following entries is displayed:
- 5733W61 2 5102 WebSphere Application Server V6.1
- 5733W61 1 5101 WebSphere Application Server V6.1 Express
- 5733W61 3 5103 WebSphere Application Server V6.1 Network
Deployment
- Install a WebSphere Application Server Version
6.1 product if you have not done so already. Update the application
server to at least version 6.1.0.13.
- Download the feature pack and extract the contents to an integrated
file system (IFS) directory on the iSeries system on which you will
install.
For example, create two directories, web20_download and web20_installation_image.
Then, download the feature pack to the web20_download directory
and then extract the downloaded file to the web20_installation_image directory.
Do not move any files out of the web20_installation_image directory.
- The operating-system requirements for a feature pack are the same
as for an application server installation. However, you need to ensure
that you have enough free disk space to install the feature pack onto
the application server installation. The following space is required:
- 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 application server product.
- 600 MB of free space available in your temporary directory
Restriction: You cannot install a feature pack remotely,
for example from a Windows workstation. You must install a feature
pack on an IBM i server using a local command-line installation.
About this task
This topic describes how to install the Feature Pack for EJB
3.0 silently using the installation program. You can
install the feature pack from Qshell using the INSTALL command.
You can also use the RUNJVA command to invoke the
installation wizard.
The installation
program installs the following program files if they are not already
installed:
- WebSphere Application Server Version 6.1 Fix Pack 13 (6.1.0.13)
- Feature pack enablement extensions
- WebSphere® Application Server Version
6.1 Feature Pack for EJB 3.0
Avoid trouble: If
you are planning to install multiple feature packs on the application
server product, then there might be other steps to consider based
on your topology. See
Installing and configuring multiple feature packs for
more information.
gotcha
Procedure
- Log on to the iSeries system with a user profile that has
*ALLOBJ and *SECADM special authorities.
- Copy the responsefile.EJB3.txt file located in the EJB3 subdirectory
of the extracted install image.
- Edit the copy of the response file. You can edit the file
using a mapped drive and a text editor or by using the EDTF
CL command from the IBM i system command line.
Set
values for the following options where app_server_root is
the directory path to your WebSphere Application Server installation:
-OPT silentInstallLicenseAcceptance="true"
-OPT installLocation=app_server_root
To
override any option in the response file with command-line options,
include the following option in the response file:
-OPT overrideResponsefileOptions=true
- Optional: You
can set values to create new application server and deployment manager
profiles which are already augmented with the feature pack, or you
can augment existing deployment manager profiles. You can also choose
to create and augment profiles after installation. See "What to do
next" on this page for more information. Change the following values
in the response file to work with profiles during installation:
- Stop all processes for the application server product on
which you are installing the feature pack.
Stop the
application server and any other product processes. For example, for
the Network Deployment product, stop the deployment manager, the node
agent, and all application server processes.
- Verify that the host server jobs have started on your iSeries
server.
The host server jobs allow the installation
code to run on iSeries. On a CL command line, enter the following
command:
STRHOSTSVR SERVER(*ALL)
- If you have not already done so, read the IBM International
Program License Agreement located in the lafiles directory.
If
you agree to the terms of the agreement, continue with the installation
process.
- Invoke the installation program for the feature pack.
Run the INSTALL command from Qshell or use
the RUNJVA command from the CL command line.
In
the following example commands, path/responsefile represents
the fully qualified path of the response file that you edited:
- For security purposes, if the host servers were not running
prior to installation, it is recommended that you run the end host
server (ENDHOSTSVR) command after the installation
is complete.
Results
The installation program records events in the log files
and installs the feature pack.
Troubleshooting
If the installation program is interrupted
for any reason while feature pack files are being installed, then
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, then 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.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.ejb3.primary.pak file
from the app_server_root/properties/version/nif/backup/ directory
- Remove the app_server_root/properties/version/nif/backup/legal.ejb3 directory.
- Remove the app_server_root/lafiles/ejb3 directory.
- Make a backup copy of app_server_root/properties/version/nif/backup/updateStatus.xml.
Look for the section beginning with the <package> entry
associated with fep.ejb3.primary.pak and
ending with </package>, remove it, and save the
file. The following is an example of such a section
<package MaintenanceNamesOfPackagesToBeCleaned=""
URIsOfPackagesToBeCleaned=""
URIsOfPackagesToBeExecuted="zip:///home/<user_name>/IBM/WebSphere/WASND0405/properties/version/nif/backup/fep.ejb3.primary.pak"
isprimary="true"
maintenancefilename="fep.ejb3.primary.pak"
maintenancename="fep.ejb3.primary.pak" mode="installconfig" modified="true"
timestamp="2007-04-05 19:16:22-0400"
uritoreinstall=""
uritouninstall="zip:///home/<user_name>/IBM/WebSphere/WASND0405/properties/version/nif/backup/fep.ejb3.primary.pak">
...
</package>
- Remove the EJB3 entries from the WebSphere registry
with the installRegistryUtils command in the app_server_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-WAS-i5osPPC64-FP0000009. Click Next to
initiate automated recovery.
Since the failure occurred
during the fix pack installation portion of the feature pack, 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 uninstall the fix pack to recover
the installation.
- Install the Update Installer. See Installing the Update Installer for WebSphere Software for
more information.
- Follow the instructions to uninstall a fix pack at Uninstalling a fix pack, an interim fix, a test fix using the silent uninstall. Use the location of the
application server product directory which you used in step 3 in the
Procedure for the response file's product.location value.
Use the fix pack name in the above error message for the backup.package value.
What to do next
Applying Maintenance
Use
the Update Installer to install maintenance packages for any of the
installable WebSphere software components in the product package.
Read the "Installing maintenance packages" topic for more information.
If you have already installed Feature Pack for
EJB 3.0, then you must apply the PK53084 interim fix before applying
any feature pack fix packs to Feature Pack for Web Services, unless
you originally installed Feature Pack for Web Services using
a CIP created with the Installation Factory. See Installing and configuring multiple feature packs for more information.
Use the Update Installer
to install maintenance packages for any of the installable WebSphere
software components in the product package. See Applying maintenance for Feature Pack for EJB 3.0 with the Update Installer for more information.
Profiles
In order to use the feature pack functionality,
you must first create a new profile enabled with the feature pack,
or augment an existing deployment manager profile.
For the Feature Pack for EJB
3.0 you can only augment the deployment manager or standalone
application server profile types. It is recommended that you create
a new deployment manager profile or a new application server profile
that is already enabled for the feature pack. Use the profile creation
tasks to create these profiles.
Samples
The Feature Pack for EJB 3.0 provides several
sample applications that you can install onto an application server
profile that has been created with the feature pack functionality.
See Installing EJB 3.0 Samples with the console for more information.