IBM i: Installing with the response file

Use either a sample response file or a response file that you created to install HCL on to an existing IBM® WebSphere® Application Server. You can create a response file with the graphical or console mode interface.

Before you begin

  • A working installation of IBM® WebSphere® Application Server is required. Ensure that it is not used by another copy of HCL.
  • You need to create a response file first based on your environment. Go to Create a response file for your IBM i environment for more information.

About this task

Locate the sample response file in the setup_root/responsefiles directory. Modify the file with your environment values. Search for repository and enter the appropriate paths for your environment. Then, search on offering and enter the appropriate offering IDs and profiles for your license. Finally, search on value= and either leave the default values or enter appropriate values for your environment. Read all of the comments for important information.

The installation program verifies the operating system and its prerequisites, available disk space, and any required software prerequisites before installation. You cannot install two instances of the server at the same time, even if you are installing to different directories. You must install each server completely before you install the next one.

Tip: Ensure that the installation paths for WebSphere® Application Server and HCL Portal that are reasonably short. Long paths can cause installation problems. Use the following suggested paths or choose locations of this length or shorter to ensure success:
  • WebSphere® Application Server installation location: /QIBM/ProdData/WebSphere/AppServer/V85/ND
  • WebSphere® Application Server default profile location: /QIBM/UserData/WebSphere/AppServer/V85/ND
  • HCL Portal installation location: /QIBM/ProdData/WebSphere/PortalServer/V85/Server
  • Configuration Engine location: /QIBM/ProdData/WebSphere/PortalServer/V85/ConfigEngine
  • HCL Portal profile path: /QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/wp_profile


  1. If the repository URL requires authentication, use the IBM® Installation Manager command-line tool to create a secure Storage File.

    The secure Storage File stores the credentials that are needed for the repositories. The IBM® Installation Manager command-line tool imutilsc is available from the installation tools directory. The following information is an example of the imutilsc key ring file command:

    imutilsc saveCredential -url repository_URL -userName credential_userName
    	-userPassword password -secureStorageFile storage_file [ -masterPasswordFile master_password_file ]
    [ -preferences|false ]
    	[ -proxyHost proxy_host -proxyPort proxy_port
    		[ -proxyUsername proxy_username -proxyUserPassword proxyuser_password ]
    		[ -useSocks ] ]
    	[ -verbose ]
    Tip: If you install on a different computer, copy the secure Storage File to that computer.
  2. Go to the InstallationManager_root/eclipse/tools directory.
  3. Run the following task to install HCL on an existing WebSphere® Application Server:
    Tip: Add the -secureStorageFile pathtosecureStorageFile -masterPasswordFile pathtomasterPasswordFile parameters to the imcl command if you are using a secure Storage File to store credentials.
    imcl -acceptLicense input pathtoresponse.xml -log dirpath/logfilename
    imcl -acceptLicense input pathtoresponse.xml -log dirpath/logfilename

What to do next

Before you access WebSphere® Application Server, configure the software license agreement to set the usage limit from the Proof of Entitlement (POE) or invoice. Go to Configuring software license information for information.