Installing fix packs on the Application Client on IBM i operating systems using response files

You can update the Application Client to a later version using Installation Manager response files.

About this task

Perform this procedure to use Installation Manager response files to update the Application Client.

Note: For information on installing and removing fix packs for WebSphere Application Server offerings on IBM i systems using the Installation Manager command line, read the following topics:

Installing fix packs on IBM i operating systems using the command line
Uninstalling fix packs from IBM i operating systems using the command line

Procedure

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

Tip: 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 that is specified.

Supported configurations:
Starting in Installation Manager Version 1.6.2, the -keyring and -password options that were used to access credentials in a key ring 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 before version 1.7. Update Installation Manager to version 1.7 or higher and then re-create and replace any secure storage files that you created with earlier versions.

There is no migration path from key ring files to storage files because of the differences in the file structures. You must create a storage file to replace a key ring file. For more information about using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the IBM Installation Manager documentation.
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 update the Application Client.
Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and update the Application Client. For example:
```
./imcl -acceptLicense 
  input $HOME/AppClientFiles/temp/update_response_file.xml 
  -log $HOME/AppClientFiles/temp/update_log.xml 
  -keyring $HOME/AppClientFiles/temp/im.keyring
```

Example

The following is an example of a response file for updating the Application Client to a later version.

<?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 id='com.ibm.websphere.APPCLIENT.v85' version='8.5.0.20101113_2239' profile='Application Client for IBM WebSphere Application Server V8.5'
   features='javaee.thinclient.core.feature,javaruntime'/>
</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:

The profile ID (<profile . . . id='profile_ID' . . . .> and <offering . . . profile='profile_ID' . . . .>) can be found when you run the imcl listInstallationDirectories -verbose command from the eclipse/tools subdirectory in the directory where you installed Installation Manager. It is the same as the package group's name.
The offering ID (<offering . . . id='offering_ID' . . . .>) can be found in the Install Manager Offering ID section of the report that is generated when you run the historyInfo or genHistoryReport command from the app_server_root/bin directory.
The version is a specific version of the offering to install (8.5.0.20101113_2239 for example). This specification is optional.
- If version is not specified, the latest version of the offering and all interim fixes for that version are installed.
- If version is specified, the specified version of the offering and no interim fixes for that version are installed.
The offering version can be found attached to the end of the offering ID with an underscore when you run the following command against the repository:
```
./imcl listAvailablePackages -repositories source_repository
```
You can also specify none, recommended or all with the -installFixes argument to indicate which interim fixes you want installed with the offering.
- If the offering version is not specified, the -installFixes option defaults to all.
- If the offering version is specified, the -installFixes option defaults to none.