WAS v8.5 > Develop applications > Develop Client applications > Develop client applications > Run the Pluggable Application Client code > Install and uninstall the Pluggable Application Client for WASInstall the Pluggable Application Client using response files
We can install the Pluggable Application Client using Installation Manager response files.
Install Installation Manager on each of the systems onto which to install the product.
- To use the Installation Manager that is included 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 your 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.
See How to download WAS V8.5 from Passport Advantage Online for a list of the IBM WAS v8.5 installation images downloadable from the IBM Passport Advantage Online website and other information.
- Install Installation Manager on your 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 your 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.PLUGCLIENT.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 for the value of the -repositories parameter so the imcl command can access the files in this repository to install the product.
Whenever possible, you should use the remote web-based repositories so that you are accessing the most up-to-date installation files.
Notes:
- If we do not have a Passport Advantage ID and password, install the product from the product repositories on the media or local repositories.
- With the Packaging Utility, we can create and manage packages for installation repositories. We can copy multiple packages into one repository or copy multiple disks for one product into a repository. We can copy packages from Passport Advantage or a web-based repository into a local repository for example. For more information on the Packaging Utility, go to the IBM Installation Manager v1.5 Information Center.
- Change to the location containing the Installation Manager installation files, and run one of the following commands to install Installation Manager:
- Administrative installation:
- installc.exe -acceptLicense -log log_file_path_and_name
- Non-administrative installation:
- userinstc.exe -acceptLicense -log log_file_path_and_name
- If you already have Installation Manager v1.5.2 or later installed on your 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.
See How to download WAS V8.5 from Passport Advantage Online for a list of the IBM WAS v8.5 installation images downloadable from the IBM Passport Advantage Online website and other information.
- 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.PLUGCLIENT.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 for the value of the -repositories parameter so the imcl command can access the files in this repository to install the product.
Whenever possible, you should use the remote web-based repositories so that you are accessing the most up-to-date installation files.
Notes:
- If we do not have a Passport Advantage ID and password, install the product from the product repositories on the media or local repositories.
- With the Packaging Utility, we can create and manage packages for installation repositories. We can copy multiple packages into one repository or copy multiple disks for one product into a repository. We can copy packages from Passport Advantage or a web-based repository into a local repository for example. For more information on the Packaging Utility, go to the IBM Installation Manager v1.5 Information Center.
Using Installation Manager, we can work with response files to install the Pluggable Application Client in a variety of ways. We can record a response file using the GUI as described in the following procedure, or we can generate a new response file by hand or by taking an example and modifying it.
- Optional: Record a response file to install the Pluggable Application Client: On one of your systems, perform the following actions to record a response file that will install the Pluggable Application Client.
- From a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
- Start Installation Manager from the command line using the -record option.
For example:
IBMIM.exe -skipInstall "C:\temp\imRegistry" -record C:\temp\install_response_file.xml
When you record a new response file, we can specify the -skipInstall parameter. Using this parameter has the following benefits:
- No files are actually installed, and this speeds up the recording.
- If we use a temporary data location with the -skipInstall parameter, Installation Manager writes the installation registry to the specified data location while recording. When you start Installation Manager again without the -skipInstall parameter, you then can use your response file to install against the real installation registry.
The -skipInstall operation should not be used on the actual agent data location used by Installation Manager. This is unsupported. Use a clean writable location, and re-use that location for future recording sessions.
For more information, read the IBM Installation Manager v1.5 Information Center.
- Add the appropriate repositories to your Installation Manager preferences.
- In the top menu, click File > Preferences.
- Select Repositories.
- Perform the following actions for each repository:
- Click Add Repository.
- Enter the path to the repository.config file in the remote web-based repository or the local directory into which you unpacked the repository files.
For example:
- Remote repositories:
https://downloads.mycorp.com:8080/WAS_85_repository
orhttp://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLUGCLIENT.v85
- Local repositories:
C:\repositories\plugclient\local-repositories
- Click OK.
- Click Apply.
- Click OK.
- Click Install.
If you are prompted to authenticate, use the IBM ID and password that you registered with on the program website.
Installation Manager searches its defined repositories for available packages.
- Perform the following actions.
- Select Pluggable Application Client for IBM WAS and the appropriate version.
If you are installing the ILAN version WAS v8.5, select Pluggable Application Client for IBM WAS (ILAN).
If you already have the Pluggable Application Client installed on your system, a message displays indicating the Pluggable Application Client is already installed. For a given Installation Manager, we can install only one Pluggable Application Client.
- Select the fixes to install.
Any recommended fixes are selected by default.
If there are recommended fixes, we can select the option to show only recommended fixes and hide non-recommended fixes.
- Click Next.
- Accept the terms in the license agreements, and click Next.
- Specify the installation root directory for the Pluggable Application Client binaries, which are also referred to as the core product files or system files.
The panel also displays the shared resources directory and disk-space information.
Restrictions:
- Deleting the default target location and leaving an installation-directory field empty prevents you from continuing.
- Do not use a semicolon in the directory name.
The Pluggable Application Client cannot install properly if the target directory includes a semicolon.
A semicolon is the character used to construct the class path on Windows systems.
- Click Next.
- Optional: Select Pluggable Application Client Samples to install the samples.
We can run the Installation Manager later to modify this installation and add or remove the feature.
- Click Next.
- Enter the host name and port number of the Websphere Application Server to which to connect, and click Next.
- Enter the location of the SUN JRE to use with the clients.
- Optional: Enter the location of the SUN SDK to use when compiling the sample clients.
- Click Next.
- Review the summary information, and click Install.
- If the installation is successful, the program displays a message indicating that installation is successful.
The program might also display important post-installation instructions as well.
- If the installation is not successful, click View Log File to troubleshoot the problem.
- Click Finish.
- Click File > Exit to close Installation Manager.
- Optional: If we are using an authenticated remote repository, create a keyring file for installation.
- From a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
- Start Installation Manager from the command line using the -record option.
For example:
IBMIM.exe -skipInstall "C:\temp\imRegistry" -keyring C:\IM\im.keyring -record C:\temp\keyring_response_file.xml
- When a window opens that requests your credentials for the authenticated remote repository, enter the correct credentials and save them.
- Click File > Exit to close Installation Manager.
For more information, read the IBM Installation Manager v1.5 Information Center.
- Use the response files to install the Pluggable Application Client:
- Optional: Use the response file to install the keyring: Go to a command line on each of the systems on which to install the Pluggable Application Client, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install the keyring.
For example:
imcl.exe -acceptLicense input C:\temp\keyring_response_file.xml -log C:\temp\keyring_log.xml- Use the response file to install the Pluggable Application Client: Go to a command line on each of the systems on which to install the Pluggable Application Client, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install the Pluggable Application Client.
For example:
imcl.exe -acceptLicense input C:\temp\install_response_file.xml -log C:\temp\install_log.xml -keyring C:\IM\im.keyringNotes:
- 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 v1.5 Information Center for more information.
Example
The following is an example of a response file for installing the Pluggable Application Client.
<?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.PLUGCLIENT.v85" /> </server> <install modify='false'> <offering id='com.ibm.websphere.PLUGCLIENT.v85' profile='Pluggable Application Client for IBM WAS V8.5' features='pluggableclient.core.feature' installFixes='none'/> </install> <profile id='Pluggable Application Client for IBM WAS V8.5' installLocation='C:\Program Files\IBM\WebSphere\PlugClient'> <data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\PlugClient'/> <data key='user.import.profile' value='false'/> <data key='user.select.64bit.image,com.ibm.websphere.PLUGCLIENT.v85' value='false'/> <data key='user.appclient.serverHostname' value='localhost'/> <data key='user.appclient.serverPort' value='2809'/> <data key='user.plugclient.sunJreHome' value='C:\Program Files\Java\jre6'/> <data key='user.plugclient.sunJdkHome' value='C:\Program Files\Java\jdk1.6.0_21'/> <data key='cic.selector.nl' value='en'/> </profile> </agent-input>See Sample response file: Installing the Pluggable Application Client for IBM WebSphere Application Server for an annotated sample of a response file for performing this procedure.
Related
Install and uninstall the Pluggable Application Client for WAS
Install the Pluggable Application Client using the GUI
Install the Pluggable Application Client using the command line
Uninstall the Pluggable Application Client using the GUI
Uninstall the Pluggable Application Client using response files
Uninstall the Pluggable Application Client using the command line