Installing the WebSphere Customization Toolbox using response files

You can install the WebSphere Customization Toolbox using Installation Manager response files.

1. Optional: Record a response file to install the WebSphere Customization Toolbox: On one of your systems, perform the following actions to record a response file that will install the WebSphere Customization Toolbox.
   1. From a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
   2. Start Installation Manager from the command line using the -record option.
      For example:

      • Windows administrator or non-administrator:

        IBMIM.exe -skipInstall "C:\temp\imRegistry" 
          -record C:\temp\install_response_file.xml

      • AIX, HP-UX, Linux, or Solaris administrator:

        ./IBMIM -skipInstall /var/temp/imRegistry 
          -record /var/temp/install_response_file.xml

      • AIX, HP-UX, Linux, or Solaris 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.

   3. Add the appropriate repositories to your Installation Manager preferences.
      1. In the menu, click File > Preferences.
      2. Select Repositories.
      3. Perform the following actions for each repository:
         1. Click Add Repository.
         2. 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

              or

              https://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v85 

            • Local repositories:
              • Windows: C:\repositories\wct\local-repositories
              • AIX, HP-UX, Linux, Solaris: /var/repositories/wct/local-repositories
         3. Click OK.
      4. Click Apply.
      5. Click OK.
   4. 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.

   5. Perform the following actions.
      1. Select WebSphere Customization Toolbox and the appropriate version.

         If you already have the WebSphere Customization Toolbox installed on your system, a message displays indicating that the WebSphere Customization Toolbox is already installed. To create another installation of the WebSphere Customization Toolbox in another location, click Continue.

      2. Select the fixes to install.

         Any recommended fixes are selected by default.

         If there are recommended fixes, you can select the option to show only recommended fixes and hide non-recommended fixes.

      3. Click Next.
   6. Accept the terms in the license agreements, and click Next.
   7. Specify the installation root directory for the WebSphere Customization Toolbox 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 WebSphere Customization Toolbox cannot install properly if the target directory includes a semicolon.

      • The maximum path length on the Windows Server 2008, Windows Vista, and Windows 7 operating systems is 60 characters.
   8. Click Next.
   9. Select the features (tools) that you want to install.
      Choose from the following optional tools:

      • Web Server Plug-ins Configuration Tool

        The Web Server Plug-ins Configuration Tool configures the web server plug-ins for WebSphere Application Server so that your web server and application server can communicate with each other.

      • Profile Management Tool (z/OS only)
        The Profile Management Tool (z/OS only) creates customized definitions on an Intel-based Windows or Linux operating system that are used to create or augment WebSphere Application Server profiles on z/OS systems. Each customization definition includes a set of customized jobs with associated instructions. The generated jobs must be uploaded to and run on the target z/OS system.

        Restriction: This tool can be installed and run on Intel-based Windows and Linux platforms only.
      • z/OS Migration Management Tool
        The z/OS Migration Management Tool creates migration definitions on an Intel-based Windows or Linux operating system that are used to migrate a WebSphere Application Server for z/OS node. Each migration definition consists of a set of customized migration jobs with associated instructions. The generated migration jobs must be uploaded to and run on the target z/OS system.

        Restriction: This tool can be installed and run on Intel-based Windows and Linux platforms only.
      • Remote Installation Tool for IBM i
        The iRemoteInstall command that is installed when you select this option allows you to install IBM Installation Manager or a WebSphere Application Server product offering from a Windows workstation to a remote target IBM i system. The iRemoteInstall command is installed into the following directory:

        wct_root/Remote_Installation_Tool_for_IBM_i

        Restriction: This tool can be installed and run on Windows operating systems only.

      Note: If you install the z/OS Migration Management Tool, you must also install the Profile Management Tool (z/OS only). This selection is done automatically.
   10. Click Next.
   11. 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.
   12. Optional: Select None to deselect WebSphere Customization Toolbox if you do not want to open the WebSphere Customization Toolbox when this installation is finished.

       This option is unavailable if you used the -skipInstall parameter.

   13. Click Finish.
   14. Click File > Exit to close Installation Manager.
   15. Optional: If you are using an authenticated remote repository, create a keyring file for installation.
       1. From a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
       2. Start Installation Manager from the command line using the -record option.
          For example:

          • Windows administrator or non-administrator:

            IBMIM.exe -skipInstall "C:\temp\imRegistry" 
              -keyring C:\IM\im.keyring 
              -record C:\temp\keyring_response_file.xml

          • AIX, HP-UX, Linux, or Solaris administrator:

            ./IBMIM -skipInstall /var/temp/imRegistry 
              -keyring /var/IM/im.keyring 
              -record /var/temp/keyring_response_file.xml

          • AIX, HP-UX, Linux, or Solaris 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

       3. When a window opens that requests your credentials for the authenticated remote repository, enter the correct credentials and save them.
       4. 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.

2. Use the response files to install the WebSphere Customization Toolbox:
   1. 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 WebSphere Customization Toolbox, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install the keyring.
      For example:

      • Windows administrator or non-administrator:

        imcl.exe -acceptLicense 
          input C:\temp\keyring_response_file.xml 
          -log C:\temp\keyring_log.xml

      • AIX, HP-UX, Linux, or Solaris administrator:

        ./imcl -acceptLicense 
          input /var/temp/keyring_response_file.xml 
          -log /var/temp/keyring_log.xml

      • AIX, HP-UX, Linux, or Solaris non-administrator:

        ./imcl -acceptLicense 
          input user_home/var/temp/keyring_response_file.xml 
          -log user_home/var/temp/keyring_log.xml

   2. Use the response file to install the WebSphere Customization Toolbox: Go to a command line on each of the systems on which you want to install the WebSphere Customization Toolbox, change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and install the WebSphere Customization Toolbox.
      For example:

      • Windows 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

      • AIX, HP-UX, Linux, or Solaris administrator:

        ./imcl -acceptLicense 
          input /var/temp/install_response_file.xml 
          -log /var/temp/install_log.xml 
          -keyring /var/IM/im.keyring

      • AIX, HP-UX, Linux, or Solaris 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.

Example

The following is an example of a response file for installing all of the WebSphere Customization Toolbox.

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean="true" temporary="true">
<repository location="https://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v85" /> 
</server>
<install modify='false'>
<offering id='com.ibm.websphere.WCT.v85' 
  profile='WebSphere Customization Toolbox V8.5' 
  features='core.feature,pct,zpmt,zmmt' installFixes='none'/>
</install>
<profile id='WebSphere Customization Toolbox V8.5' 
  installLocation='C:\Program Files\IBM\WebSphere\Toolbox'>
<data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\Toolbox'/>
<data key='user.import.profile' value='false'/>
<data key='user.select.64bit.image,com.ibm.websphere.WCT.v85' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>

Tip: See Sample response file: Installing the WebSphere Customization Toolbox for an annotated sample of a response file for performing this procedure.

Tip: To select the features (tools) that you want to install, add each desired feature in the offering as an entry in a comma-separated list. To install all of the optional features, for example, specify something like this:

<offering profile='WebSphere Customization Toolbox V8.5' 
  features='core.feature,zpmt,zmmt,pct,installtools' id='com.ibm.websphere.WCT.v85'/>

where zpmt indicates the Profile Management Tool (z/OS only), zmmt indicates the z/OS Migration Management Tool, pct indicates the Web Server Plug-ins Configuration Tool, and installtools indicates the Remote Installation Tool for IBM i.