(iseries)Install the Application Client on IBM i operating systems using response files
We can install the Application Client using Installation Manager response files.
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 to install the product.
- 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.
- Access the physical media, and use local installation
We can access the product repositories on the product media.
- Install Installation Manager on the system.
We can install Installation Manager using the product media, using a file obtained from the Passport Advantage site, or using a file containing the most current version of Installation Manager from the IBM Installation Manager download website.
- 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 files from the Passport Advantage site.
- Install Installation Manager on the system.
We can install Installation Manager using the product media, using a file obtained from the Passport Advantage site, or using a file containing the most current version of Installation Manager from the IBM Installation Manager download website.
- Use Installation Manager to install the product from the downloaded repositories.
- Access the live repositories, and use web-based installation
If we have a Passport Advantage ID and password, we can install the product from the web-based repositories.
- Install Installation Manager on the system.
We can install Installation Manager using the product media, using a file obtained from the Passport Advantage site, or using a file containing the most current version of Installation Manager from the IBM Installation Manager download website.
- 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
This location does not contain a web page that we can access using a web browser. This is a remote web-based repository location that 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.
If we do not have a Passport Advantage ID and password, 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 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
- For more information on installing Installation Manager, see the IBM Installation Manager Version 1.6 Information Center or the IBM Installation Manager Version 1.5 Information Center.
- When installing the product on IBM i operating systems, use only the installc command to install Installation Manager.
- If we are using local repositories to install and maintain the product, unpack the compressed file containing the repository to a directory on the system.
- If we already have a version of Installation Manager installed on the system and 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
We 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 we have a Passport Advantage ID and password, we 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
This location does not contain a web page that we can access using a web browser. This is a remote web-based repository location that 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.
If we do not have a Passport Advantage ID and password, install the product from the product repositories on the media or local repositories.
Use Installation Manager, we can work with response files to install the product.
- 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.
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.
- Make sure 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
- Use a response file to install the product.
Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install the product. For example:
./imcl -acceptLicense input $HOME/AppClientFiles/temp/install_response_file.xml -log $HOME/AppClientFiles/temp/install_log.xml -keyring $HOME/AppclientFiles/temp/im.keyring
- The relevant terms and conditions, notices, and other information are provided in the license-agreement files in the lafiles or product_name/lafiles subdirectory of the installation image or repository for this product.
- The program might write important post-installation instructions to standard output.
Read the IBM Installation Manager Version 1.6 Information Center or the IBM Installation Manager Version 1.5 Information Center for more information.
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 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.
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:
- offering.service.repositories.areUsed
Used for searching remote repositories for updates to installed offerings
- com.ibm.cic.common.core.preferences.searchForUpdates
Used for searching for updates to Installation Manager
For example:
<preference value='false' name='offering.service.repositories.areUsed'/> <preference value='false' name='com.ibm.cic.common.core.preferences.searchForUpdates'/>We 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, 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.
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.
If no features are specified, the required features and the optional feature selected by default (embeddablecontainer) are installed. To install only the features we want, specify the list of features explicitly.
What to do next
We 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 clientAfter 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 creating a client profile on IBM i.
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 the command line Install Application Client features on IBM i operating systems 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