Install Application Client features on IBM i operating systems

(iseries)
Install Application Client features on IBM i operating systems

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

Optional: If the repository requires a username and password, create a keyring file to access this repository.
For more information on creating a keyring file for Installation Manager, read the IBM Installation Manager Version 1.6 Information Center or the IBM Installation Manager Version 1.5 Information Center.
When creating a keyring file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the URL specified.

Start in Installation Manager Version 1.6.2, the -keyring and -password options that have been used to access credentials in a keyring file are deprecated. For Installation Manager Version 1.6.2 and later, use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file.
In Version 1.7, the format of the secure storage file is revised, and is no longer compatible with versions of Installation Manager prior to version 1.7. Update Installation Manager to version 1.7 or higher and then recreate and replace any secure storage files created with earlier versions.
There is no migration path from keyring files to storage files because of the differences in the file structures. Create a storage file to replace a keyring file. For more information on using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the Installation Manager Version 1.6 Information Center.

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.

Use a response file to install or remove a feature.
Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and modify the Application Client. For example:

./imcl input $HOME/AppClientFiles/temp/modify_response_file.xml -log $HOME/AppClientFiles/temp/modify_log.xml -keyring $HOME/AppClientFiles/temp/im.keyring

Here is a response file that adds the embeddable EJB container feature to an existing Application Client installed in the /QIBM/ProdData/WebSphere/AppClient/V85/client directory:
<?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='true'>
  <offering profile='Application Client for IBM WebSphere Application Server V8.5' features='embeddablecontainer' 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>
To alter this response file to remove a feature, simply change the install tags to uninstall. Here is the same response file modified to remove the embeddable EJB container feature:
<?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>
<uninstall modify='true'>
  <offering profile='Application Client for IBM WebSphere Application Server V8.5' features='embeddablecontainer' id='com.ibm.websphere.APPCLIENT.v85'/>
</uninstall>
<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>
In the following list, the optional feature 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, we 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 we can use to run enterprise beans in a standalone Java Platform, Standard Edition environment. We 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.
Use the Installation Manager imcl command-line tool to install or remove a feature in the Application Client for IBM WebSphere Application Server.
Read Install the Application Client on IBM i operating systems using the command line, Uninstall the Application Client from IBM i operating systems using the command line, and the IBM Installation Manager Version 1.6 Information Center or the IBM Installation Manager Version 1.5 Information Center for more information.
Related tasks

Installing, updating, rolling back, and uninstalling the Application Client for IBM WAS on IBM i operating systems
Install the Application Client on IBM i operating systems using response files
Install the Application Client on IBM i operating systems using the command line
Install fix packs on the Application Client on IBM i operating systems using response files
Uninstall fix packs from the Application Client on IBM i operating systems using response files
Uninstall the Application Client from IBM i operating systems using response files
Uninstall the Application Client from IBM i operating systems using the command line