Run the IBM WebSphere Application Server Version 6.1 Feature
Pack for Web 2.0 and Mobile installation
program to install the feature pack on an existing installation of
a WebSphere Application Server Version 6.1 product.
Before you begin
The Feature Pack for Web 2.0
and Mobile is
an optionally installable product extension for IBM WebSphere Application
Server Version 6.x that offers targeted, incremental new features
that can make your Web applications running on WebSphere Application
Server easier to use. This feature pack extends Service Oriented
Architecture (SOA) by connecting external Web services, internal Service
Oriented Architecture (SOA) services, and Java 2 Platform Enterprise
Edition (J2EE) objects into highly-interactive Web application interfaces.
Before
starting this installation, complete the following actions:
- 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.19.
- Download and extract the Feature Pack for Web 2.0 and
Mobile.
For example, create two directories, web20_download and web20_installation_image.
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 the 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 disk space is required:
- 350 MB
of free space available in your target installation directory. This
is in addition to the required application server product.
- 300 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.
Procedure
- Log on to the system.
- Stop the application server and any other processes for
the product on which you are installing the feature pack.
For
the Network Deployment product, for example, stop all application
server processes, the node agent, and the deployment manager.
- Run the feature-pack installation program.
Extract
the downloaded product files and run the program manually from a command
prompt. Run the
install executable file in the
root directory of the feature pack installation image and point to
the Java Virtual Machine (JVM) already included with the application
server, where
app_server_root is the root directory
of your existing application server product:
- Complete the steps in the feature-pack installation wizard.
- On the Welcome panel, click Next.
- On the Software License Agreement panel, select I
accept both the IBM and the non-IBM terms and click Next.
- On the Installation Directory panel, specify the location
of the app_server_root directory
of your existing WebSphere® Application Server installation
and click Next.
- On the Installation Summary panel, click Next.
The program copies feature pack program files to the existing application
server installation.
- The installation completes and the Installation Results
panel is displayed. If the application server is not at or above 6.1.0.13,
a message is displayed indicating that you should install the appropriate
fix packs to reach the supported level before contacting IBM Support
for any subsequent problems. Use the IBM Update Installer for WebSphere
Software to update your application server to the required level.
Click Finish.
Results
The installation wizard installs the feature pack and records
installation events in the installation log files in the
app_server_root/logs/install/web2mobilefep_1.1 directory.
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.
- If you are logged in as non-root or non-admin
user, then you might not always find a log file 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_server_root directory;
however, without the necessary permission to move the file to the app_server_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/web2mobilefep_1.1logs directory:
- log.txt
- trace.txt.gz
- trace.xml.gz
- 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 errors. Exit the installer and follow the instructions
to manually uninstall the feature pack. See Uninstalling the feature pack for more information.
Avoid trouble: Certain events can prevent
InstallShield Multi-Platform (ISMP) from starting the installation
wizard, such as not having enough disk space to launch the installation
wizard. If your installation fails and no information is available
in the installation logs, use the
-is:javaconsole parameter
to record entries for events that cause the ISMP program to fail
to start the installation wizard. The syntax of the
install command
for observing such events is:
./install -is:javaconsole
install.exe -is:javaconsole
Avoid trouble: Although the usage of
-is:javaconsole is
supported, the usage of
-console, for example
install
-console, is not supported.
gotcha
gotcha
What to do next
You can begin using the feature pack by working with the
various included features and applications.
Use the Update
Installer to install maintenance packages for the application server
and the feature pack. See Installing maintenance packages for more
information.