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 WebSphere Application Server.

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, 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.

Note: The IBM Java™ Development Kit (JDK) is required for the Java Platform, Enterprise Edition (Java EE) Application Client.

Before you install 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 WebSphere Application Server.

Requirements

In addition to the following requirements, your system might require other prerequisites so that you can install WebSphere Application Server offerings. For more information, see Preparing the operating system for product installation.

For transitioning users: IBM® SDK, Java Technology Edition is no longer embedded with the Application Client for WebSphere Application Server. The Java SDK is available as a separate offering that must be installed when you install the Application Client.IBM SDK, Java Technology Edition, Version 8 is the Java SDK version for WebSphere Application Server Version 9.0.
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 you use the command line or response files to install, uninstall, or otherwise modify the Application Client, specify the main offering ID. You can also add a comma-separated list of optional features to install. If you do not specify optional features, the default feature is installed. To install only the features that you want, specify the list of features explicitly.

Table 1. Offering and optional feature IDs
Offering ID	Optional feature IDs	Default features
Application Client for WebSphere Application Server `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 WebSphere Application Server offerings and WebSphere Application Server product offerings for supported operating systems.

Installation examples

All WebSphere Application Server offerings are installed by using IBM Installation Manager. For step-by-step instructions for installing product offerings, see Installing the product offerings.

Important: Because IBM SDK Java Technology Edition is no longer embedded with the product, you must 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.

The following installation examples are for the command line:

For step-by-step instructions for installing by using the command line, see Installing the product offerings by using the command line.

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:\Program Files\IBM\WebSphere\AppClient"
  -sharedResourcesDirectory "C:\Program Files\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

./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

./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

The following installation examples are for the response file:

For step-by-step instructions for installing by using a response file, see Installing the product offerings by using response files.

<?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 WebSphere Application Server V9.0' 
  features='javaee.thinclient.core.feature,embeddablecontainer' installFixes='none'/>
<offering id='com.ibm.java.jdk.v8'
  profile='Application Client for IBM WebSphere Application Server V9.0'
  features='com.ibm.sdk.8'/>
</install>
<profile id='Application Client for IBM WebSphere Application Server V9.0' 
  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.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>

<?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 WebSphere Application Server V9.0' 
     features='embeddablecontainer'/>
</install>
<profile id='Application Client for IBM WebSphere Application Server 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.

You can 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

Note: After you create 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 you create a client profile on IBM i.

Uninstallation examples

All WebSphere Application Server offerings are uninstalled by using IBM Installation Manager. For step-by-step instructions for uninstalling product offerings, see Uninstalling the product offerings.

Avoid trouble: IBM SDK, Java Technology Edition (com.ibm.java.jdk.v8) must be uninstalled at the same time that you uninstall the product offering.

The following uninstallation examples are for the command line:

For step-by-step instructions for uninstalling by using the command line, see Uninstalling the product offerings by using the command line.

imcl.exe uninstall com.ibm.websphere.APPCLIENT.v90 com.ibm.java.jdk.v8
  -installationDirectory "C:\Program Files\IBM\WebSphere\AppClient"

./imcl uninstall com.ibm.websphere.APPCLIENT.v90 com.ibm.java.jdk.v8
  -installationDirectory /opt/IBM/WebSphere/AppClient

./imcl uninstall com.ibm.websphere.APPCLIENT.v90
  -installationDirectory /QIBM/ProdData/WebSphere/AppClient/V9/client

The following uninstallation examples are for the response file:

For step-by-step instructions for uninstalling by using a response file, see Uninstalling the product offerings by using response files.

<?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 WebSphere Application Server V9.0' 
  features='embeddablecontainer'/>
<offering id='com.ibm.java.jdk.v8' 
  profile='Application Client for IBM WebSphere Application Server V9.0' />
</uninstall>
<profile id='Application Client for IBM WebSphere Application Server V9.0' 
  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.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>

<?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 WebSphere Application Server V9.0'/>
</uninstall>
<profile id='Application Client for IBM WebSphere Application Server 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>