Installing the Feature Pack for Web Services Client

Run the Feature Pack for Web Services Client installation program to install the feature pack on an existing installation of the IBM® Application Client for the WebSphere® Application Server V6.1 product.

Before you begin

Before starting this installation, do the following:
  1. Install the IBM Application Client for WebSphere Application Server V6.1 if you have not already done so.
  2. If your IBM Application Client for WebSphere Application Server V6.1 installation already has the Web Services Client feature pack installed and you want to install the feature pack again, run the uninstall command in the app_client_root/uninstall_websv directory:
    • [AIX] [HP-UX] [Linux] [Solaris] uninstall.sh
    • [Windows] uninstall.exe

    Select options to complete uninstallation in the feature pack uninstallation wizard. After the wizard runs, delete the /uninstall_websv directory and any log files if necessary.

About this task

This topic describes how to install the Feature Pack for Web Services 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:

Procedure

  1. Log on as the user who installed the IBM Application Client for the WebSphere Application Server V6.1 product.
    • [AIX] [HP-UX] [Linux] [Solaris] Log on using the same user ID that was used when the product was installed.

      Run the ls -al command at the root of the IBM Application Client for WebSphere Application Server V6.1 installation to find the user ID that was used to install the product.

    • [Windows] Log on as a user who belongs to the administrator group or as the user who installed the product.
  2. Stop all processes for the Version 6.1 product on which you are installing the feature pack.

    Stop any other product processes.

  3. Run the Feature Pack for Web Services Client installation program.
    Extract the downloaded product files and run the program manually. To run the program manually, run the install executable file in the WEBSV directory of the Feature Pack for Web Services Client installation image:
    • [AIX] [HP-UX] [Linux] [Solaris] /WEBSV/install
    • [Windows] \WEBSV\install
  4. Complete the steps in the Feature Pack for Web Services Client installation wizard.
    1. On the Welcome panel, click Next.
    2. On the Software License Agreement panel, select I accept both the IBM and the non-IBM terms and click Next.
    3. On the System prerequisites check panel, do the following:
      • Read the panel information. The panel informs you whether your machine has a supported operating system with all service packs and patches needed by the feature pack installed.
      • If the system prerequisite check shows Passed, click Next.
      • If the check shows Failed, click Cancel. Install operating system service packs and patches needed for the Web Services Client feature pack, and then try installing the feature pack again. Or, click Next to continue the installation even though the check shows Failed.
    4. On the Installation Directory panel, specify the location of the app_client_root directory of your existing IBM Application Client for WebSphere Application Server installation and click Next.

      The program will add new files to the existing product installation.

    5. On the Version Prerequisites Check panel, click Next.

      The Feature Pack for Web Services Client installation uses IBM Application Client for WebSphere Application Server Version 6.1.0.9 or later. This panel informs you that Version 6.1 maintenance packages need to be installed. If you click Next, the installation program installs the maintenance packages for you and continues the installation.

      The Version Prerequisites Check panel is not displayed if the Version 6.1.0.9 maintenance packages are already installed.

      Click Back to select a different product installation.

    6. On the Installation Summary panel, click Next.

      Provided that the only IBM Application Client for WebSphere Application Server Java™ process running on your machine is this installation program when you click Next, the installation program copies Feature Pack for Web Services Client program files on your product installation.

    7. On the Installation Results panel, click Finish.

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_websv directory; however, without the necessary permission to move the file to theapp_client_root/uninstall_websv directory, the attempt to move fails and the log remains in your home directory. Look for the following log files in the user_home/webserviceslogs 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/webserviceslogs/log.txt directory.

Best practice: Certain events can prevent ISMP from starting the installation wizard. Such an event is not enough disk space to launch the installation wizard for example. If your installation fails and there is no information 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:[AIX] [HP-UX] [Linux] [Solaris]
./install -is:javaconsole
[Windows]
install.exe -is:javaconsole
bprac



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 7:37:48 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=tcli_installclient_wbs
File name: tcli_installclient_wbs.html