WAS v8.0 > Install the application serving environment > Distributed operating systems > Install and using the WebSphere Customization Toolbox > Install, updating, rolling back, and uninstalling the WebSphere Customization Toolbox


Install the WebSphere Customization Toolbox using response files

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

Install Installation Manager on each of the systems onto which to install the product.

  1. Perform one of the following procedures:

    • To use the Installation Manager that is included with this product, perform the following actions:

      1. Obtain the necessary files from the physical media or the web.

        There are three basic options for obtaining and installing the product.

        • Access the physical media, and use local installation

          You can access the product repositories on the product media.

          1. Install Installation Manager on the 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.

          2. 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.

          1. Download the files from the Passport Advantage site.

            Tip: See How to download WAS V8.0 from Passport Advantage Online for a list of the IBM WebSphere Application Server v8.0 installation images downloadable from the IBM Passport Advantage Online website and other information.

          2. Install Installation Manager on the 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.

          3. 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, you can install the product from the web-based repositories.

          1. Install Installation Manager on the 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.

          2. Use Installation Manager to install the product from the web-based repository located at
            http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v80
            

            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 specify in the response file so that the installation can access the files in this repository.

          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, 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. 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.4 Information Center.

      2. Change to the location containing the Installation Manager installation files, and run one of the following commands:

        Administrative installation:

        • Windows: installc.exe -acceptLicense -log log_file_path_and_name
        • AIX, HP-UX, Linux, and Solaris: ./installc -acceptLicense -log log_file_path_and_name

        Non-administrative installation:

        • Windows: userinstc.exe -acceptLicense -log log_file_path_and_name
        • AIX, HP-UX, Linux, and Solaris: ./userinstc -acceptLicense -log log_file_path_and_name

        Group-mode installation (AIX, HP-UX, Linux, and Solaris only):

        ./groupinstc -acceptLicense -dataLocation application_data_location -log log_file_path_and_name

        Notes on group mode:

        • Group mode allows users to share packages in a common location and manage them with the same instance of Installation Manager.
        • 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 v1.4 Information Center before installing in group mode.

        • For more information on using group mode, read the Group mode road maps in the IBM Installation Manager v1.4 Information Center.

    • If you already have a version of Installation Manager installed on the system and to use it to install and maintain the product, obtain the necessary product files from the physical media or the web.

      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.

        1. Download the product repositories from the Passport Advantage site.

          Tip: See How to download WAS V8.0 from Passport Advantage Online for a list of the IBM WebSphere Application Server v8.0 installation images downloadable from the IBM Passport Advantage Online website and other information.

        2. 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, 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

        http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v80
        

        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 specify in the response file so that the installation can access the files in this repository.

        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, 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. 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.4 Information Center.

  2. Add the product repository to your Installation Manager preferences.

    1. Start Installation Manager.

    2. In the top menu, click File > Preferences.

    3. Select Repositories.
    4. Perform the following actions:

      1. Click Add Repository.

      2. Enter the path to the repository.config file in the location containing the repository files.

        For example:

        • Windows: C:\repositories\product_name\local-repositories
        • AIX, HP-UX, Linux, Solaris: /var/repositories/product_name/local-repositories

        or

        http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v80
        

      3. Click OK.

    5. Deselect any locations listed in the Repositories window that you will not be using.

    6. Click Apply.

    7. Click OK.

    8. Click File > Exit to close Installation Manager.

Use Installation Manager, you can work with response files to install the WebSphere Customization Toolbox in a variety of ways. We 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

  1. Optional: Record a response file to install the WebSphere Customization Toolbox: On one of the 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.

      For more information, read the IBM Installation Manager v1.4 Information Center.

    3. Add the appropriate repositories to your Installation Manager preferences.

      1. In the top 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_80_repository
            
            or
            http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v80
            
          • 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.

      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.

        New feature: New feature: If you are installing the unsupported ILAN version of this product, select WebSphere Customization Toolbox (ILAN).New feature:

        If you already have the WebSphere Customization Toolbox installed on the 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. 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:

      • Delete 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) 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 WAS 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 WAS 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.

      If you install the z/OS Migration Management Tool, 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.

        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.

      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.

    12. Click Finish.

    13. Click File > Exit to close Installation Manager.

    14. 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.

        For more information, read the IBM Installation Manager v1.4 Information Center.

  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 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 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.

      Read the IBM Installation Manager v1.4 Information Center for more information.


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">
<server>
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v80" />

</server>
<install modify='false'>
<offering id='com.ibm.websphere.WCT.v80'
  profile='WebSphere Customization Toolbox V8.0'
  features='core.feature,pct,zpmt,zmmt' installFixes='none'/>
</install>
<profile id='WebSphere Customization Toolbox V8.0'
  installLocation='C:\IBM\WebSphere\Toolbox'>
<data key='eclipseLocation' value='C:\IBM\WebSphere\Toolbox'/>
<data key='user.import.profile' value='false'/>
<data key='user.select.64bit.image,com.ibm.websphere.WCT.v80' 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) 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.0'
  features='core.feature,zpmt,zmmt,pct,installtools' id='com.ibm.websphere.WCT.v80'/> 
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.
Install and using the WebSphere Customization Toolbox
Install, updating, rolling back, and uninstalling the WebSphere Customization Toolbox
Install the WebSphere Customization Toolbox using the GUI
Install and uninstall tools in the WebSphere Customization Toolbox
Install fix packs on the WebSphere Customization Toolbox using the GUI
Uninstall fix packs from the WebSphere Customization Toolbox using the GUI
Uninstall the WebSphere Customization Toolbox using the GUI
Uninstall the WebSphere Customization Toolbox using response files

+

Search Tips   |   Advanced Search