Installing the Web Server Plug-ins using response files
You can install the Web Server Plug-ins using Installation Manager response files.
Before you begin
- The target directory for the plug-in must be an empty directory and cannot be installed in a subdirectory of the IBM HTTP Server target directory.
- If you want 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
You can access the product repositories on the product media.
- Install Installation Manager on your system.
You 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.
- Install Installation Manager on your system.
- 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.Tip: See How to download WebSphere® Application Server V8.5.5 from Passport Advantage Online for a list of the IBM WebSphere Application Server Version 8.5 installation images downloadable from the IBM Passport Advantage Online website and other information.
- Install Installation Manager on your system.
You 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.
- Download the files from the Passport
Advantage site.
- Access the live repositories, and use web-based installation
If you have a Passport Advantage ID and password, you can install the product from the web-based repositories.
- Install Installation Manager on your system.
You 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
https://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.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 for the value of the -repositories parameter so that 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.
- Install Installation Manager on your system.
Notes:- 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.
- With the Packaging Utility, you can create and manage packages for installation repositories. You can copy multiple packages into one repository or copy multiple disks for one product into a repository. You 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 documentation.
- Access the physical media, and use local installation
- 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
./installc -acceptLicense -log log_file_path_and_name
- Non-administrative installation:
-
userinstc.exe -acceptLicense -log log_file_path_and_name
./userinstc -acceptLicense -log log_file_path_and_name
- Group-mode installation:
./groupinstc -acceptLicense -dataLocation application_data_location -log log_file_path_and_name -installationDirectory Installation_Manager_home
Notes on group mode:- Group mode allows multiple users to use a single instance of IBM Installation Manager to manage software packages.
- Group mode is not available on Windows operating systems.
- If you do not install Installation Manager using group mode, you will not be able to use group mode to manage any of the products that you install later using this Installation Manager.
- Make sure that you change the installation location from the default location in the current user's home directory to a location that is accessible by all users in the group.
- Set up your groups, permissions, and environment variables as described in the Group mode road maps in the IBM Installation Manager documentation before installing in group mode.
- Obtain the necessary files.
- If you already have Installation Manager Version 1.5.2 or later
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.Tip: See How to download WebSphere Application Server V8.5.5 from Passport Advantage Online for a list of the IBM WebSphere Application Server Version 8.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.
- Download the product repositories from the Passport Advantage site.
- 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
https://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.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 for the value of the -repositories parameter so that 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 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.
- With the Packaging Utility, you can create and manage packages for installation repositories. You can copy multiple packages into one repository or copy multiple disks for one product into a repository. You 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 documentation.
- Access the physical media, and use local installation
About this task
Using Installation Manager, you can work with response files to install the Web Server Plug-ins in a variety of ways. You can record a response file using the GUI as described in the following procedure, or you can generate a new response file by hand or by taking an example and modifying it.
Procedure
- Optional: Record a response file to install
the Web Server Plug-ins: On one of your systems, perform the
following actions to record a response file that will install the
Web Server Plug-ins.
- 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:
- Administrator or non-administrator:
IBMIM.exe -skipInstall "C:\temp\imRegistry" -record C:\temp\install_response_file.xml
- Administrator:
./IBMIM -skipInstall /var/temp/imRegistry -record /var/temp/install_response_file.xml
- Non-administrator:
./IBMIM -skipInstall user_home/var/temp/imRegistry -record user_home/var/temp/install_response_file.xml
Tip: When you record a new response file, you can specify the -skipInstall parameter. Using this parameter has the following benefits:- No files are actually installed, and this speeds up the recording.
- If you 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.
- Administrator or non-administrator:
- Add the appropriate repositories to your Installation
Manager preferences.
- 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:
orhttps://downloads.mycorp.com:8080/WAS_85_repository
https://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v85
- Local repositories:
C:\repositories\plugins\local-repositories
/var/repositories/plugins/local-repositories
- Remote
repositories:
- Click OK.
- Click Apply.
- Click OK.
- Click Install. Note: 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 Web Server Plug-ins for IBM WebSphere Application Server and
the appropriate version.Note: If you are installing the ILAN version of this product, select Web Server Plug-ins for IBM WebSphere Application Server (ILAN).
If you already have the Web Server Plug-ins installed on your system, a message displays indicating that the Web Server Plug-ins are already installed. To create another installation of the Web Server Plug-ins in another location, click Continue.
- Click Next.
- Select Web Server Plug-ins for IBM WebSphere Application Server and
the appropriate version.
- Accept the terms in the license agreements, and click Next.
- Specify the installation root directory for the Web
Server Plug-ins 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 symbolic links as the destination directory.
Symbolic links are not supported.
- Do not use a semicolon in the directory name.
The Web Server Plug-ins cannot install properly if the target directory includes a semicolon.
A semicolon is the character used to construct the class path on Windows systems.
- The maximum path length on the Windows Server 2008, Windows Vista, and Windows 7 operating systems is 60 characters.
- Click Next.
- If you are installing on a 64-bit
system, choose between a 32-bit and 64-bit IBM Runtime Environment
for Java and click Next. Notes:
- This option displays only if you are installing on a 64-bit system.
- You must select one of the two options.
- You cannot modify this installation later and change this selection.
- Review the summary information, and click Install.
- If the installation is successful, the program displays a message
indicating that installation is successful.Note: 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.
- If the installation is successful, the program displays a message
indicating that installation is successful.
- Click Finish.
- Click File > Exit to close Installation Manager.
- Optional: If you are using an authenticated
remote repository, create a keyring file for silent 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:
- Administrator or non-administrator:
IBMIM.exe -skipInstall "C:\temp\imRegistry" -keyring C:\IM\im.keyring -record C:\temp\keyring_response_file.xml
- Administrator:
./IBMIM -skipInstall /var/temp/imRegistry -keyring /var/IM/im.keyring -record /var/temp/keyring_response_file.xml
- Non-administrator:
./IBMIM -skipInstall user_home/var/temp/imRegistry -keyring user_home/var/IM/im.keyring -record user_home/var/temp/keyring_response_file.xml
- Administrator or non-administrator:
- 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.
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.
- Use the response files to install the Web Server Plug-ins:
- Optional: Use the response file to install
the keyring: Go to a command line on each of the systems on which
you want to install the product, change to the eclipse/tools subdirectory
in the directory where you installed Installation Manager, and install
the keyring. For example:
- Administrator or non-administrator:
imcl.exe -acceptLicense input C:\temp\keyring_response_file.xml -log C:\temp\keyring_log.xml
- Administrator:
./imcl -acceptLicense input /var/temp/keyring_response_file.xml -log /var/temp/keyring_log.xml
- Non-administrator:
./imcl -acceptLicense input user_home/var/temp/keyring_response_file.xml -log user_home/var/temp/keyring_log.xml
- Administrator or non-administrator:
- Use the response file to install the product: Go
to a command line on each of the systems on which you want to install
the product, change to the eclipse/tools subdirectory
in the directory where you installed Installation Manager, and install
the product. For example:
- Administrator or non-administrator:
imcl.exe -acceptLicense input C:\temp\install_response_file.xml -log C:\temp\install_log.xml -keyring C:\IM\im.keyring
- Administrator:
./imcl -acceptLicense input /var/temp/install_response_file.xml -log /var/temp/install_log.xml -keyring /var/IM/im.keyring
- Non-administrator:
./imcl -acceptLicense input user_home/var/temp/install_response_file.xml -log user_home/var/temp/install_log.xml -keyring user_home/var/IM/im.keyring
Notes:- 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.
- Administrator or non-administrator:
- Optional: Use the response file to install
the keyring: Go to a command line on each of the systems on which
you want to install the product, change to the eclipse/tools subdirectory
in the directory where you installed Installation Manager, and install
the keyring.
Example
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean="true" temporary="true">
<server>
<repository location="https://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v85" />
</server>
<install modify='false'>
<offering id='com.ibm.websphere.PLG.v85'
profile='Web Server Plug-ins for IBM WebSphere Application Server V8.5'
features='core.feature,arch.32bit' installFixes='none'/>
</install>
<profile id='Web Server Plug-ins for IBM WebSphere Application Server V8.5'
installLocation='C:\Program Files\IBM\WebSphere\Plugins'>
<data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\Plugins'/>
<data key='user.import.profile' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>
- If you want to use the 32-bit IBM Runtime Environment for Java,
include
jre.6_32bit
as a feature in the response file.For example:<offering profile='Web Server Plug-ins for IBM WebSphere Application Server V8.5' features='com.ibm.jre.6_32bit' id='com.ibm.websphere.PLG.v85'/>
- If you want to use the 64-bit IBM Runtime Environment for Java,
include
com.ibm.jre.6_64bit
as a feature in the response file.For example:<offering profile='Web Server Plug-ins for IBM WebSphere Application Server V8.5' features='core.feature,com.ibm.jre.6_64bit' id='com.ibm.websphere.PLG.v85'/>
- Include this feature only if you are installing on a 64-bit system; do not include it if you are installing on a 32-bit system.
- You must include one of the two options if you are installing on a 64-bit system.
- You cannot modify this installation later and change the selection.