You can install the Application Client for WebSphere® Application Server by using the installation
wizard provided on the product CD-ROM. This guided, manual procedure
is an alternative to using a silent installation based on a pre-configured
option response file.
Before you begin
Before starting this task, read the information in the Installing
Application Client for
WebSphere Application Server
topic.
If you want to silently install the Application Client, refer
to the Installing Application Client for WebSphere Application Server
silently topic.
About this task
The installation wizard does not upgrade or remove previous
Application Client installations automatically.
Application
Client V6.1 and later can be installed together with previously installed
Application Client installations if their versions are lower than
6.1. However, only one instance of Application Client V6.1 and later
can be installed on the same system. When the installer is launched,
it will detect any existing installation of Application Client V6.1
and later and direct the installation flow to the feature panels so
that additional features can be added on top of the existing installation.
Procedure
- Start the installation wizard
- Use the Launchpad GUI.
Important: The
free download Application Client installation is not packaged with
the Launchpad program. To start the installation wizard for the download
Application Client installation, use the install command.
- Start the launchpad. For more information, see the topic "Using
the launchpad to start the installation".
- On the launchpad, click Launch the installation wizard
for Application Client for WebSphere Application Server.
- Use the install command.
When you install
Application Client, the current working directory must be the directory
where the installer binary program is located. This placement is important
because the resolution of the class files location is done in the
current working directory. Failing
to use the correct working directory can cause ISMP errors that stop
the installation.
- On the command line, change directory to the directory where the
installer binary program is located.
- To install from a product installation: cd /app_server_root/AppClient
- To install from the product CD: cd CD_mount_point/AppClient
- To install from a free download Application Client installation: cd
/download_dir/AppClient
- Enter the install command:
- Run the install.exe for the Application
Client.
Using the Launchpad GUI to begin installing a Websphere
Application Server Version 7.0 component
is not supported on a machine that is running the Microsoft® Windows® Vista operating system. If the Launchpad
starts automatically when the installation media is inserted in a
machine running the Windows Vista operating system,
cancel the Launchpad.
To install the Application Client on a machine
running the Windows Vista operating system,
you must complete the following actions:
- Go to the Application Client component directory.
- To install from a product installation: cd /app_server_root/AppClient
- To install from the product CD: cd CD_mount_point/AppClient
- Run the install.exe program, using the administrator
account that was created when the Windows Vista
operating system was installed.
- The Windows Vista operating system
detects that install.exe is an installation program,
and presents you with an elevation prompt for Administrator privileges.
Click Allow to proceed.
- When the Windows Vista operating system
is asked to run a program that requires elevated (Administrator) privileges,
it first tells the user whether the publisher of the program is recognized.
For certain WebSphere Application Server programs,
for example, an operating-system dialog might appear that states "An
unidentified program wants access to your computer." Examine the program
details; and if it is the WebSphere Application Server program that you
intend to run, click Allow to proceed.
The Welcome panel of the installation wizard is displayed.
- Click Next.
- Accept the licence agreement. If you agree to
the license agreement, select I accept the terms in the
license agreement then click Next to
continue. The installation wizard checks the system
for prerequisites.
- Ensure that the prerequisites are installed.
- If you see a success message on the wizard panel, click Next to
continue.
- If you see a warning message on the wizard panel, click Cancel to
exit the installation wizard, then install the prerequisites before
restarting the installation wizard.
Important: Application Client may be fully functional
even if some prerequisites are not installed on the system, however
it is recommended you update your system to the required level.
Attention: If you select any of the available options and need
to go backwards on the installation panels (for instance, to reread
the license agreement), the installable options panel disappears when
continuing through the installation panels. To access these panels
again, you must restart the installation wizard.
- Specify a destination directory.
- If you do not want to use the default destination directory,
specify a different target directory. The Product installation
location field must contain a valid target directory for
you to continue with the installation.
- Ensure that there is adequate space available in the
target directory.
- Click Next to continue.
- Choose either a typical or custom installation.
- Typical
- Select this choice if you want to install only the Java™ EE and Java thin application clients, samples
and IBM® Developer Kit, Java 2
Technology Edition.
- Click Next to continue with the next step.
- Enter the host name and
port number of the WebSphere Application Server
you want to connect to.
These details are for Java EE and Java thin application clients that
use the Application Client as their runtime environment.
The
default bootstrap port number is 2809.
Click Next to
continue.
- Review the summary information
- To install the product code, click Next
- To change choices that you made on earlier panels, click Back.
- After the Application Client installation
has finished, verify success.
- If a Success message is displayed on the Completion panel,
click Finishto exit the wizard.
- If you want more information, or the installation failed,
examine the app_client_root/logs/install/log.txt file
for installation status.
The installer program records the following
indicators of success in the logs:
- INSTCONFSUCCESS indicates that the
installation is successful and that no further log analysis is required.
- INSTCONFFAILED indicates an installation
failure from which you cannot retry or recover without reinstalling.
The installation wizard records installation events in
the installation log files. Examine messages that the installation
program displays. If the Application Client for WebSphere Application Server 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 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/cltlogs directory:
- log.txt
- trace.txt.gz
- trace.xml.gz
Results
You successfully installed the Application Client for WebSphere Application Server and the features
you selected.
What to do next
Use the installation verification utility to verify a successful
installation. If the installation is not successful, fix the error
as indicated in the installation error message. For example, if you
do not have enough disk space, make more space available, then reinstall
the Application Client.