Installing and removing features in the Application Client

You can use Installation Manager to install or remove a feature in the Application Client for IBM WebSphere Application Server.

Procedure

Use the Installation Manager GUI to install or remove a feature in the Application Client for IBM WebSphere Application Server.
1. Stop all servers and applications on the Application Client installation that is being modified.
2. Start Installation Manager.
3. Make sure that your Installation Manager preferences are pointing to the appropriate web-based or local repositories containing the Application Client for IBM WebSphere Application Server.
4. Click Modify.
5. Select the package group to modify.
6. Click Next.
  Note: If you are prompted to authenticate, use the IBM ID and password that you registered with on the program website.
7. Expand Application Client for IBM WebSphere Application Server.
8. Check the appropriate checkbox to install a feature, or clear the appropriate checkbox to remove a feature if you already have it installed.
  - IBM Developer Kit, Java 2 Technology Edition
    This option installs the IBM Developer Kit, Java 2 Technology Edition.
    
    This feature includes a development kit and a runtime-environment package. The runtime-environment package is always installed with the Java EE and Java thin application client feature even if this feature is not installed.
    - Java 2 Runtime Environment
      This option installs the Java 2 runtime environment.
      
      This feature includes the Java 2 runtime environment of IBM Developer Kit, Java 2 Technology Edition.
    - Developer Kit
      This option installs the developer kit.
      
      This feature includes the developer kit of IBM Developer Kit, Java 2 Technology Edition.
  - Samples
    This option installs executable and source-code examples of programming in both Java EE and non-Java EE client environments.
  - Standalone Thin Clients, Resource Adapters, and Embeddable Containers
    IBM thin clients and resource adapters provide a set of clients and resource adapters for a variety of technologies, such as JAX-WS, JAX-RPC, JAX-RS, XML, EJB, JPA, JMS, and more. An embeddable container runs in a standalone Java Platform, Standard Edition environment. For example, you can use the embeddable EJB container to run enterprise beans outside the application server.
    - Standalone thin clients and resource adapters
      This option installs the runtime for standalone thin clients.
    - Embeddable EJB container
      This option installs the embeddable EJB container.
      
      The embeddable EJB container is a Java Archive (JAR) file that you can use to run enterprise beans in a standalone Java Platform, Standard Edition environment. You can run enterprise beans using this embeddable container outside the application server. The embeddable EJB container is a part of the EJB 3.1 specification and is primarily used for unit testing enterprise beans business logic.
9. Click Next.
10. Review the summary information, and click Modify.
  - If the modification is successful, the program displays a message indicating that installation is successful.
  - If the modification is not successful, click View Log File to troubleshoot the problem.
11. Click Finish.
12. Click File > Exit to close Installation Manager.

Use an Installation Manager response file to install or remove a feature in the Application Client for IBM WebSphere Application Server.

You can record this response file using the GUI and Installation Manager's record mode, or you can manually create or modify a response file to suit your needs.

Go to the IBM® Installation Manager documentation for more information.

Example: Here is a response file that modifies an existing Application Client for IBM WebSphere Application Server installation:

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<server>
<repository location="https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85" />
</server>
<install modify='true'>
<offering id='com.ibm.websphere.APPCLIENT.v85' 
  profile='Application Client for IBM WebSphere Application Server V8.5' 
  features='samples,standalonethinclient.resourceadapter.runtime'/>
</install>
<uninstall modify='true'>
<offering id='com.ibm.websphere.APPCLIENT.v85' 
  profile='Application Client for IBM WebSphere Application Server V8.5' 
  features='embeddablecontainer,developerkit'/>
</uninstall>
<profile id='Application Client for IBM WebSphere Application Server V8.5' 
  installLocation='C:\Program Files\IBM\WebSphere\AppClient'>
<data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\AppClient'/>
<data key='user.import.profile' value='false'/>
<data key='user.select.64bit.image,com.ibm.websphere.APPCLIENT.v85' value='false'/>
<data key='user.appclient.serverHostname' value='localhost'/>
<data key='user.appclient.serverPort' value='2809'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>

In the following list, the optional feature offering IDs are enclosed in parentheses:

IBM Developer Kit, Java 2 Technology Edition
- Java 2 Runtime Environment (javaruntime)
- Developer Kit (developerkit)
Samples (samples)
Standalone Thin Clients, Resource Adapters, and Embeddable Containers
- Standalone Thin Clients Runtime (standalonethinclient.resourceadapter.runtime)
- Standalone Thin Clients Samples (standalonethinclient.resourceadapter.samples)
- Embeddable EJB container (embeddablecontainer)

Tip: See Sample response file: Modifying the Application Client for IBM WebSphere® Application Server for an annotated sample of a response file for performing this procedure.

Use the Installation Manager imcl command-line tool to install or remove a feature in the Application Client for IBM WebSphere Application Server.
Read Installing the Application Client using the command line, Uninstalling the Application Client using the command line, and the IBM Installation Manager documentation for more information.