Application Client installation information

Application Client installation information

Installation requirements, examples, and other information for installing and uninstalling the Application Client for WebSphere Application Server. The Application Client provides resources and clients to aid development of client applications for use with WAS.

About the Application Client
Requirements
Repositories and offering IDs
Installation examples
Usage notes
Uninstallation examples

About the Application Client

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, we need to install the client that provides the framework for the client application. Instead of installing WAS, we 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 WAS requires that the associated client is deployed with the client application. For client applications that only need a small fraction of the Application Client, we 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.

Before installing the Application Client, plan your topology and determine where to install each component. For more information, see Planning to install the Application Client for IBM WAS.

Requirements

In addition to the following requirements, the system might require other prerequisites so that we can install WAS offerings. For more information, see Prepare the operating system for product installation.

For transitioning users: IBM SDK is no longer embedded with the Application Client for WAS. The Java SDK is available as a separate offering that must be installed when we install the Application Client.IBM SDK, v8 is the Java SDK version for WAS v9.0.trns
The Application Client requires up to 350 MB of disk space.

Repositories and offering IDs

To install the Application Client from the online service repository, use the following repository URL with Installation Manager:
http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v90
When we use the command line or response files to install, uninstall, or otherwise modify the Application Client, specify the main offering ID. We can also add a comma-separated list of optional features to install. If we do not specify optional features, the default feature is installed. To install only the features that we want, specify the list of features explicitly.
Offering ID Optional feature IDs Default features
Application Client for WAS
com.ibm.websphere.APPCLIENT.v90
samples: Samples
standalonethinclient.resourceadapter.runtime: Standalone Thin Clients Runtime
standalonethinclient.resourceadapter.samples: Standalone Thin Clients Samples
embeddablecontainer: Embeddable EJB Container

embeddablecontainer
For a complete list of product repositories and offering IDs, see Online product repositories for WAS offerings and WAS product offerings for supported operating systems.

Installation examples

All WAS offerings are installed using IBM Installation Manager. For step-by-step instructions for installing product offerings, see Install the product offerings.

(Dist) Important: Because IBM SDK Java Technology Edition is no longer embedded with the product, specify both the Application Client offering ID (com.ibm.websphere.APPCLIENT.v90) and the IBM Java SDK offering ID (com.ibm.java.jdk.v8). The Application Client cannot be installed without a Java SDK.
Command-line examples
For step-by-step instructions for installing using the command line, see Install the product offerings using the command line.

(Windows)
imcl.exe install com.ibm.websphere.APPCLIENT.v90 com.ibm.java.jdk.v8
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v90 
  -installationDirectory "C:\IBM\WebSphere\AppClient"
  -sharedResourcesDirectory "C:\IBM\IMShared"
  -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts'/>=false
  -secureStorageFile C:\IM\credential.store -masterPasswordFile C:\IM\master_password.txt
  -log installv9appcli.xml
  -acceptLicense
  -showProgress
(Linux)
./imcl install com.ibm.websphere.APPCLIENT.v90 com.ibm.java.jdk.v8
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v90 
  -installationDirectory /opt/IBM/WebSphere/AppClient
  -sharedResourcesDirectory /opt/IBM/IMShared
  -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false
  -secureStorageFile /var/IM/credential.store -masterPasswordFile /var/IM/master_password.txt
  -log installv9appcli.xml
  -acceptLicense
  -showProgress
(iSeries)
./imcl install com.ibm.websphere.APPCLIENT.v90
  -repositories https://downloads.mycorp.com:8080/WAS_90_repository
  -installationDirectory /QIBM/ProdData/WebSphere/AppClient/V9/client
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppClient/V9/client
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store
  -acceptLicense
  -showProgress
Response file example
For step-by-step instructions for installing using a response file, see Install the product offerings using response files.

(Windows)
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean="true" temporary="true">
<server>
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v90" />
</server>
<install modify='false'>
<offering id='com.ibm.websphere.APPCLIENT.v90' 
  profile='Application Client for IBM WAS V9.0' 
  features='javaee.thinclient.core.feature,embeddablecontainer' installFixes='none'/>
<offering id='com.ibm.java.jdk.v8'
  profile='Application Client for IBM WAS V9.0'
  features='com.ibm.sdk.8'/>
</install>
<profile id='Application Client for IBM WAS V9.0' 
  installLocation='C:\IBM\WebSphere\AppClient'>
<data key='eclipseLocation' value='C:\IBM\WebSphere\AppClient'/>
<data key='user.import.profile' value='false'/>
<data key='user.select.64bit.image,com.ibm.websphere.APPCLIENT.v90' 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>
(iSeries)
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean="true" temporary="true">
<server>
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v90" />
</server>
<install modify='false'>
  <offering id='com.ibm.websphere.APPCLIENT.v90'
     profile='Application Client for IBM WAS V9.0' 
     features='embeddablecontainer'/>
</install>
<profile id='Application Client for IBM WAS V9.0' 
  installLocation='/QIBM/ProdData/WebSphere/AppClient/V9/client'>
  <data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/AppClient/V9/client'/>
  <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppClient/V9/client'/>
  <data key='user.appclient.serverHostname' value='localhost'/>
  <data key='user.appclient.serverPort' value='2809'/>
  <data key='user.import.profile' value='false'/>
  <data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>
Usage notes

The versionInfo and historyInfo commands return version and history information for the Application Client based on all of the installation, uninstallation, update, and rollback activities performed on the system.

(iSeries) Create a client profile using the manageprofiles command.. The following example creates a default client profile based on the following assumptions:

The system host name for the application server that the client will connect to is myhost.abc.com.
The bootstrap port for the application server is 2809.
The app_client_root is /QIBM/ProdData/WebSphere/AppClient/V9/client.
manageprofiles -create
  -templatePath /QIBM/ProdData/WebSphere/AppClient/V9/client/profileTemplates/client 
  -serverHostname myhost.abc.com 
  -serverPort 2809 
  -profileName client 
After creating a profile successfully, the console prints a message that indicates success and advises you to check the AboutThisProfile.txt file. However, a AboutThisProfile.txt file is not generated when we create a client profile on IBM i.

Uninstallation examples

All WAS offerings are uninstalled using IBM Installation Manager. For step-by-step instructions for uninstalling product offerings, see Uninstall the product offerings.

IBM SDK (com.ibm.java.jdk.v8) must be uninstalled at the same time that you uninstall the product offering..
Command-line examples
For step-by-step instructions for uninstalling using the command line, see Uninstall the product offerings using the command line.

(Windows)
imcl.exe uninstall com.ibm.websphere.APPCLIENT.v90 com.ibm.java.jdk.v8
  -installationDirectory "C:\IBM\WebSphere\AppClient"
(HPUX) (Linux) (Solaris)
./imcl uninstall com.ibm.websphere.APPCLIENT.v90 com.ibm.java.jdk.v8
  -installationDirectory /opt/IBM/WebSphere/AppClient
(iSeries)
./imcl uninstall com.ibm.websphere.APPCLIENT.v90
  -installationDirectory /QIBM/ProdData/WebSphere/AppClient/V9/client
Response file example
For step-by-step instructions for uninstalling using a response file, see Uninstall the product offerings using response files.

(Windows)
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<uninstall modify='false'>
<offering id='com.ibm.websphere.APPCLIENT.v90' 
  profile='Application Client for IBM WAS V9.0' 
  features='embeddablecontainer'/>
<offering id='com.ibm.java.jdk.v8' 
  profile='Application Client for IBM WAS V9.0' />
</uninstall>
<profile id='Application Client for IBM WAS V9.0' 
  installLocation='C:\IBM\WebSphere\AppClient'>
<data key='eclipseLocation' value='C:\IBM\WebSphere\AppClient'/>
<data key='user.import.profile' value='false'/>
<data key='user.select.64bit.image,com.ibm.websphere.APPCLIENT.v90' 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>
(iSeries)
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<uninstall modify='false'>
<offering id='com.ibm.websphere.APPCLIENT.v90' 
  profile='Application Client for IBM WAS V9.0'/>
</uninstall>
<profile id='Application Client for IBM WAS V9.0' 
  installLocation='/QIBM/ProdData/WebSphere/AppClient/V9/client'>
  <data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/AppClient/V9/client'/>
  <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppClient/V9/client'/>
  <data key='user.appclient.serverHostname' value='localhost'/>
  <data key='user.appclient.serverPort' value='2809'/>
  <data key='user.import.profile' value='false'/>
  <data key='cic.selector.nl' value='en'/>
</profile>
</profile>
</agent-input>
Related:

WAS product offerings for supported operating systems
Online product repositories for WAS offerings
Planning to install the Application Client for IBM WAS
Install the product offerings on distributed operating systems using the GUI
Install the product offerings using the command line
Install the product offerings using response files
Uninstall the product offerings
Supported hardware and software website