Installing, updating, rolling back, and uninstalling the Application Client for IBM WebSphere Application Server

IBM® Installation Manager is a common installer for many IBM software products that you use to install, update, roll back, and uninstall the Application Client for IBM WebSphere Application Server.

Before you begin

New feature New feature: Application Client for IBM WebSphere Application Server is now installed by Installation Manager rather than by the programs based on InstallShield MultiPlatform (ISMP) that are used to install and uninstall previous versions.newfeat

Before you start to use the installation tools, prepare for choosing and installing the variety of options and features provided by the Application Client. Read through all the steps in this article and read the related topics before installing the Application Client:

It is recommended that you have 350 MB of temporary disk space available before starting the installation.

Restrictions:
  • [Solaris] The Installation Manager GUI is not supported on Solaris 10 x64 systems. Perform the following actions to install or uninstall the product on these systems:
    • Use the Installation Manager GUI on a supported system to record a response file that will allow you to install or uninstall the product.
    • Edit the recorded response file if necessary.
    • Use the response file to install or uninstall the product on your system.
  • [Linux] For any Linux system that is enabled for Security Enhanced Linux (SELinux), such as Red Hat Enterprise Linux Version 5 or SUSE Linux Enterprise Server Version 11, you must identify the Java shared libraries in the Installation Manager Version 1.4.3 or earlier installation image to the system. Also, you must identify the Java shared libraries in the Installation Manager Version 1.4.3 or earlier installation after it has been installed. For example:
    chcon -R -t texrel_shlib_t ${IM_Image}/jre_5.0.3.sr8a_20080811b/jre/bin
    chcon -R -t texrel_shlib_t ${IM_Install_root}/eclipse/jre_5.0.3.sr8a_20080811b/jre/bin 
  • Application Client for WebSphere® Application Server ships only with the 32-bit WebSphere Application Server.
  • Installation Manager console mode, which is included in Installation Manager Version 1.4.3 and later, does not work with WebSphere Application Server Version 8.0 offerings.

About this task

The Application Client provides resources and clients to aid development of client applications for use with WebSphere Application Server. The Application Client is a source for the clients (as runtime frameworks) for client applications, either to run on the Application Client machine or to be distributed with client applications that are to run on other machines.

To assemble some types of client applications, you need to install the client that provides the framework for the client application. Instead of installing WebSphere Application Server, you can install the Application Client feature, which provides the same resources and clients to aid development of client applications.

Similarly, running some types of client applications for use with WebSphere Application Server requires that the associated client is deployed with the client application. For client applications that only need a small fraction of the Application Client, you can install the Application Client onto a convenient machine, such as the machine used to develop the client application, then package the client application with only the clients that it needs. For example, this means that a standalone client application is deployed on only the required fraction of the clients provided with the Application Client.

Procedure

Results

Notes on logging and tracing:
  • An easy way to view the logs is to open Installation Manager and go to File > View Log. An individual log file can be opened by selecting it in the table and then clicking the Open log file icon.
  • Logs are located in the logs directory of Installation Manager's application data location. For example:
    • [Windows] Administrative installation:
      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs
    • [Windows] Non-administrative installation:
      C:\Documents and Settings\user_name\Application Data\IBM\Installation Manager\logs
    • [AIX] [HP-UX] [Linux] [Solaris] Administrative installation:
      /var/ibm/InstallationManager/logs
    • [AIX] [HP-UX] [Linux] [Solaris] Non-administrative installation:
      user_home/var/ibm/InstallationManager/logs
  • The main log files are time-stamped XML files in the logs directory, and they can be viewed using any standard web browser.
  • The log.properties file in the logs directory specifies the level of logging or tracing that Installation Manager uses. To turn on tracing, for example, create a log.properties file with the following content:
    com.ibm.ws=DEBUG
    com.ibm.cic.agent.core.Engine=DEBUG
    global=DEBUG
    Restart Installation Manager as necessary, and Installation Manager outputs traces.
Notes on troubleshooting:
  • [HP-UX] By default, some HP-UX systems are configured to not use DNS to resolve host names. This could result in Installation Manager not being able to connect to an external repository.

    You can ping the repository, but nslookup does not return anything.

    Work with your system administrator to configure your machine to use DNS, or use the IP address of the repository.

  • In some cases, you might need to bypass existing checking mechanisms in Installation Manager.
    • On some network file systems, disk space might not be reported correctly at times; and you might need to bypass disk-space checking and proceed with your installation.
      To disable disk-space checking, specify the following system property in the config.ini file in IM_install_root/eclipse/configuration and restart Installation Manager:
      cic.override.disk.space=sizeunit  
      where size is a positive integer and unit is blank for bytes, k for kilo, m for megabytes, or g for gigabytes. For example:
      cic.override.disk.space=120 (120 bytes)
      cic.override.disk.space=130k (130 kilobytes)
      cic.override.disk.space=140m (140 megabytes)
      cic.override.disk.space=150g (150 gigabytes)
      cic.override.disk.space=true
      Installation Manager will report a disk-space size of Long.MAX_VALUE. Instead of displaying a very large amount of available disk space, N/A is displayed.
    • To bypass operating-system prerequisite checking, add disableOSPrereqChecking=true to the config.ini file in IM_install_root/eclipse/configuration and restart Installation Manager.
    If you need to use any of these bypass methods, contact IBM Support for assistance in developing a solution that does not involve bypassing the Installation Manager checking mechanisms.
  • For more information on using Installation Manager, read the IBM Installation Manager Version 1.4 Information Center.
    Read the release notes to learn more about the latest version of Installation Manager. To access the release notes, complete the following task:
    • [Windows] Click Start > Programs > IBM Installation Manager > Release Notes.
    • [AIX] [HP-UX] [Linux] [Solaris] Go to the documentation subdirectory in the directory where Installation Manager is installed, and open the readme.html file.



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 Task topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 6:15:55 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-express-dist&topic=tcli_installation_appclient
File name: tcli_installation_appclient.html