Creating a response file

After IBM Installation Manager is installed, you can use it to record a response file that is based on your environment. Record a response file on the same operating system you plan for the installation. If you have multiple operating systems, you must record a response file for each operating system. Use a response file to automate your installation on multiple servers.

About this task

You can also use the console mode to generate a response file. Go to Installing with a console for an AIX environment for more information. After you review the summary information, enter G to generate a response file instead of I to install.

Procedure

  1. Start all servers and applications that require a port number to avoid port conflicts when you install HCL Portal. If you are installing multiple copies of HCL Digital Experience on your server, start the existing Configuration Wizard servers.
    Note: Currently, the cw_profile starting point always defaults to 10200. If you install a second version of portal on the same server, you must customize the cw_profile port value. Add the following line to the InstallationManager_root/InstallationManager/eclipse/tools/imcl.ini file: 
    -Dcwprofile_startingport=new_starting_port_number
  2. Go to the InstallationManager_root/eclipse directory.
  3. Go to the InstallationManager_root/eclipse/tools directory.
  4. Run the following task to start the recording:
    ./IBMIM -record pathtoresponsexmlfile -skipInstall tempinstalldirectory
    imcl -c
    IBMIM.exe -record pathtoresponsexmlfile -skipInstall tempinstalldirectory
    -record
    This parameter indicates recording the actions and parameters into the response file. The pathtoresponsexmlfile text is the name of the response file, for example Wp8SampleResp.xml. The tempinstalldirectory text is the directory where the response file is recorded.
    -skipInstall
    This parameter indicates that no actual installation is completed even though it leads to the final pane.
    tempinstalldirectory
    This value is a directory where the installation saves the history and data when you record the response files.
  5. Complete the following steps to add the repositories where the installation media exists:
    1. Open the IBM® Installation Manager and go to File > Preferences > Repositories.
    2. Select Add Repositories.
    3. Select Browse and go to the Portal-install-eimage/Setup/repository.config file and then click OK.
    4. Ensure that all required repositories are checked. Then, click Test Connections to ensure that the IBM® Installation Manager can successfully access the directory where the service repositories are stored.
    5. Select Apply.
    6. Select OK.
  6. On the main IBM® Installation Manager panel, select Install.
  7. Optional: If you are installing Portal to an existing copy of WebSphere® Application Server, then select only HCL Portal server on the Install Packages screen. To complete this installation option, your existing copy of WebSphere® Application Server must meet the following requirements:
    • WebSphere Application Server Version 8.5.5.2 or later
    • Java Version 7.0
    • No existing Portal profile

    Skip the following step, if you choose to install to an existing copy of WebSphere® Application Server.

  8. On Install Packages: Select packages to install, select the following packages, and then click Next:
    • IBM WebSphere Application Server Network Deployment
    • HCL Portal server
    • IBM WebSphere SDK Java Technology Edition
      Note: For new installations, you must have SDK Java version 7.0.
      Note: The IBM WebSphere SDK Java Technology Edition option is required for a HCL Portal installation even though it might be marked as "Optional" on the Select packages to install screen.
    Tip: If you have a HCL Digital Experience Enable license, you must select both the HCL Portal serverHCL Portal Express and HCL Portal Enable packages.
  9. On Install Packages: Select the fixes to install screen, select any required fixes. Then, click Next.
  10. Accept the license agreement and then click Next.
  11. Enter the directory where you want to store shared resources and then click Next.
  12. Complete the following steps on the Install Packages: Installation Directory panel:
    Remember: The installation directory that you specify must NOT contain any files or the following characters: ~ ! @ # $ % ^ & * ( ) + { } | < > ? ` = [ ] ; ' , . " and spaces.
    1. Select the WebSphere® Application Server Package Group Name and then enter the installation directory path.
    2. Select the HCL Digital Experience Package Group Name and then enter the installation directory path.
    3. Click Next.
  13. Select the translations to install and then click Next.
  14. Optional: If you chose to install Portal to an existing copy of WebSphere® Application Server, select the available copy of WebSphere® Application Server, and click Next.
    Note: Skip this step, if you are not installing Portal to an existing copy of WebSphere® Application Server.
  15. On Install Packages: Select the features to install, expand the WebSphere® Application Server and HCL Portal packages to modify the features you want to install and then click Next.
    Note: Ensure that Portal Server Profile is selected to create a profile that contains the Portal application server and the product binary files. Clear this option if you need a binary only installation for migration or your clustered environment.
    Note: As you select the items, read the Details section for information.
  16. On Profile configuration details, enter the user ID and password for the configuration wizard administrator. Then, click Next.
  17. If you selected the Portal Server Profile package, click Enter the Administrator user ID and password for the Portal Server. Then, select either the Standard or Advanced configuration mode and then enter the parameter details for the selected configuration mode.
    Note: Select Advanced if you want to specify Uniform Resource Identifier (URI) information that is specific to your company.
  18. Confirm the Summary information and then click Install.
  19. After the Installation Manager finishes creating the response file, click Finish and then close the Installation Manager to complete the response file recording.
  20. Complete the following steps to add the repositories:
    1. Enter P to go to the Preferences menu.
    2. Enter 1 to go to the Repositories menu.
    3. Enter D to add repositories.
    4. Type the path for your HCL Portal repository file.
    5. Enter A to apply your repositories and return to the Preferences menu.
    6. Enter R to return to the Main menu.
  21. Enter 1 to install the software packages.
  22. Select HCL Portal server. To complete this installation option, your existing copy of WebSphere® Application Server must meet the following requirements:
    • WebSphere Application Server Version 8.5.5.2 or later
    • Java Version 7.0
    • No existing Portal profile
    Tip: If you have a HCL Digital Experience Enable license, you must select both the HCL Portal serverHCL Portal Express and HCL Portal Enable packages.
  23. Choose one of the following options:
    • Enter 1 to choose version 8.5.0.0 for installation.
    • Enter 2 to show all available versions of the package.
  24. Enter N.
  25. Enter A to accept the license agreement.
  26. Enter N.
  27. Choose one of the following options for translation packages:
    • Enter N to select the default English package only.
    • Enter the number for the translation package you want to install.
  28. On the Incompatible package group menu, choose one of the following options:
    • Enter M to change the installation directory. Then, enter the new installation directory. Read the Tip about installation path length to avoid issues that are caused by long paths.
    • Enter N to keep the existing directory.
    Tip: Ensure that the installation paths for WebSphere® Application Server and HCL Digital Experience 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 Digital Experience installation location: /QIBM/ProdData/WebSphere/PortalServer/V85/Server
    • Configuration Engine location: /QIBM/ProdData/WebSphere/PortalServer/V85/ConfigEngine
    • HCL Digital Experience profile path: /QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/wp_profile
  29. Enter the number for the WebSphere® Application Server root directory to use as the existing WebSphere® Application Server.
  30. Enter the configuration wizard administrator user ID and password.
  31. If you selected the Portal Server Profile feature, enter the information for the following prompts:
    • Enter the host name
    • Enter the node name
    • Enter the cell name
    • Enter an administrator user ID for the portal server
    • Enter an administrator user password for the portal server
    • Confirm administrator user password for the portal server
  32. Enter Y to enter advanced parameters such as customized Uniform Resource Identifier (URI) settings, profile name, and port numbers. Enter N to accept the default parameters.
    • Enter the context root
    • Enter the default home
    • Enter the personalized home
    • Enter the profile name
    • Enter the starting port number
    • Enter the profile path
  33. Enter N.
  34. Review the summary information.
  35. Enter G to generate a response file.
  36. If you plan to install on a different server, copy the response file to the response file directory on that server. Open the response file, make any necessary changes to the repository location. Search for value= and make any necessary changes for the new server.