You can install the Application Client using Installation
Manager response files.
Before you begin
Before you install the Application Client, ensure that
your user profile has *ALLOBJ and *SECADM special authorities.
Install
Installation Manager on the system onto which you want to install
the product.
- If you want to use the Installation Manager that comes with this
product, perform the following actions:
- Obtain the necessary files.
There are three basic options for
obtaining and installing Installation Manager and the product.
Note: If you do not have a Passport Advantage ID and password,
you must install the product from the product repositories on the
media or local repositories.
- Install Installation Manager.
- Sign on to the IBM i system
with a user profile that has *ALLOBJ and *SECADM special authorities.
- On a CL command line, run the STRQSH command
to start the Qshell command shell.
- Make sure that the umask is set to 022.
To verify the umask
setting, issue the following command:
umask
To
set the umask setting to 022, issue the following command:
umask 022
- Change to the location containing the Installation Manager installation
files.
- Run the following command:
installc -acceptLicense -log log_file_path_and_name
- If you are using local repositories to install
and maintain the product, unpack the compressed file containing the
repository to a directory on your system.
- If you already have a version of Installation Manager installed
on your system and you want to use it to install and maintain the
product, obtain the necessary product files.
There are three basic
options for installing the product.
- Access the physical media, and use local installation
You
can access the product repositories on the product media. Use Installation
Manager to install the product from the product repositories on the
media.
- Download the files from the Passport Advantage site, and use
local installation
Licensed customers with a Passport Advantage ID and password
can download the necessary product repositories from the Passport Advantage site.
- Download the product repositories from the Passport Advantage site.
- Use Installation Manager to install the product from the downloaded
repositories.
- Access the live repositories, and use web-based installation
If
you have a Passport
Advantage ID and password, you can use Installation Manager to
install the product from the web-based repositories. Use Installation
Manager to install the product from the web-based repository located
at
http://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85
Note: This location
does not contain a web page that you can access using a web browser.
This is a remote web-based repository location that you must specify
in the response file so that the installation can access the files
in this repository.
Whenever possible, you should use
the remote web-based repositories so that you are accessing the most
up-to-date installation files.
Note: If you do not have a Passport Advantage ID and password,
you must install the product from the product repositories on the
media or local repositories.
About this task
Using Installation Manager, you can work with response
files to install the product.
Example
The following is an example of a response file for installing
the product with no optional features into the
/QIBM/ProdData/WebSphere/AppClient/V85/client directory
using a web-based repository located at
https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85.
<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
<repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85'/>
</server>
<profile id='Application Client for IBM WebSphere Application Server V8.5'
installLocation='/QIBM/ProdData/WebSphere/AppClient/V85/client'>
<data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/AppClient/V85/client'/>
<data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppClient/V85/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>
<install modify='false'>
<offering profile='Application Client for IBM WebSphere Application Server V8.5'
features='javaee.thinclient.core.feature' id='com.ibm.websphere.APPCLIENT.v85'/>
</install>
<preference name='com.ibm.cic.common.core.preferences.eclipseCache'
value='/QIBM/UserData/InstallationManager/IMShared'/>
<preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.readTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
<preference name='offering.service.repositories.areUsed' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
<preference name='http.ntlm.auth.kind' value='NTLM'/>
<preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
<preference name='PassportAdvantageIsEnabled' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
</agent-input>
The following is an example
of a response file for installing the product ILAN version.
<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
<repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENTILAN.v85'/>
</server>
<profile id='Application Client for IBM WebSphere Application Server (ILAN) V8.5'
installLocation='/QIBM/ProdData/WebSphere/AppClient/V85/client'>
<data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/AppClient/V85/client'/>
<data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppClient/V85/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>
<install modify='false'>
<offering profile='Application Client for IBM WebSphere Application Server (ILAN) V8.5'
features='javaee.thinclient.core.feature' id='com.ibm.websphere.APPCLIENTILAN.v85'/>
</install>
<preference name='com.ibm.cic.common.core.preferences.eclipseCache'
value='/QIBM/UserData/InstallationManager/IMShared'/>
<preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.readTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
<preference name='offering.service.repositories.areUsed' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
<preference name='http.ntlm.auth.kind' value='NTLM'/>
<preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
<preference name='PassportAdvantageIsEnabled' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
</agent-input>
Tips: - Make sure that the repository location points to the web-based
or local repository. For example:
<repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85'/>
- The following line from the example specifies the default value
of the profile location for IBM i:
<data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppClient/V85/client'/>
To
override this default location, specify a different location
- The following line from the example specifies the default value
of the shared resources directory for IBM i:
<preference name='com.ibm.cic.common.core.preferences.eclipseCache'
value='/QIBM/UserData/InstallationManager/IMShared'/>
To
override this default location, specify a different location.Note: There
is only one shared resources directory for Installation Manager. If
there has been an installation on the system in the past, it will
use that shared resources directory and not the one specified in the
response file.
- To disable remote searches for updates in the response file, set
the following preferences to false:
For example:
<preference value='false' name='offering.service.repositories.areUsed'/>
<preference value='false' name='com.ibm.cic.common.core.preferences.searchForUpdates'/>
You can find more details on silent preference keys in
the Installation Manager information center.
- To install more than one instance of an offering, you must make
the profile ID of each additional instance unique. For example:
<offering profile='Application Client for IBM WebSphere Application Server V8.5 - Another User's AppClient'
features='javaee.thinclient.core.feature' id='com.ibm.websphere.APPCLIENT.v85'/>
This must
be changed in both places that specify the profile ID in the response
file.
Here are some examples of changes that you could make
to manipulate this response file to perform alternative actions.
- To alter the location of the installation, simply change the installation
location. For example:
Replace
<profile id='Application Client for IBM WebSphere Application Server V8.5'
installLocation='/QIBM/ProdData/WebSphere/AppClient/V85/client'>
with
<profile id='Application Client for IBM WebSphere Application Server V8.5'
installLocation='/home/user/IBM/Websphere/AppClient/Server'>
- To install from a local repository instead of the live remote
repository, replace the repository location. For example:
Replace
<repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85'/>
with
<repository location='/home/user/repositories/AppClient/local-repositories'/>
- To add the optional features, add each desired feature in the
offering as an entry in a comma-separated list.
In the following
list of optional features, the offering IDs to be used in the response
files are enclosed in parentheses:
- 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 Runtime (standalonethinclient.resourceadapter.runtime)
This
option installs the runtime for standalone thin clients.
- Embeddable EJB Container (embeddablecontainer)
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.
For example, to install the embeddable EJB container: Replace
<offering profile='Application Client for IBM WebSphere Application Server V8.5'
features='javaee.thinclient.core.feature' id='com.ibm.websphere.APPCLIENT.v85'/>
with
<offering profile='Application Client for IBM WebSphere Application Server V8.5'
features='javaee.thinclient.core.feature,embeddablecontainer' id='com.ibm.websphere.APPCLIENT.v85'/>
where embeddablecontainer indicates
the embeddable EJB container feature.
Tip: If no features are specified, the required features
and the optional feature selected by default (embeddablecontainer)
are installed. To install only the features that you want, specify
the list of features explicitly.
What to do next
You can create a client profile using the manageprofiles command.
The
following is an example of using the
manageprofiles command
to create a default client profile. The example is 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/V85/client.
manageprofiles -create
-templatePath /QIBM/ProdData/WebSphere/AppClient/V85/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.