WebSphere Customization Toolbox installation information

Installation requirements, examples, and other information for installing and uninstalling the WebSphere® Customization Toolbox. The WebSphere Customization Toolbox can be installed only on distributed operating systems, and the tools that you can install vary by operating system.

About WebSphere Customization Toolbox

The WebSphere Customization Toolbox contains the following optional tools that you can use to manage, configure, and migrate various parts of your WebSphere Application Server environment.

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

    Supported configurations: The graphical user interface (GUI) is supported only on AIX®, Linux®, and Windows. On other platforms, use the wctcmd -tool pct command.
  • 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.

Requirements

In addition to the following requirements, your system might require other prerequisites so that you can install WebSphere Application Server offerings.

  • For transitioning users: IBM® SDK, Java™ Technology Edition is no longer embedded with the WebSphere Customization Toolbox . The Java SDK is available as a separate offering that must be installed when you install the WebSphere Customization Toolbox.IBM SDK, Java Technology Edition, Version 8 is the Java SDK version for WebSphere Application Server Version 9.0.
  • WebSphere Customization Toolbox V9 requires 64-bit Windows and up to 600 MB of disk space, depending on how many tools you install.

Repositories and offering IDs

To install WebSphere Customization Toolbox from the online service repository, use the following repository URL with Installation Manager. The repository URL does not load in a web browser and is used only with Installation Manager.
http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v90
When you use the command line or response files to install, uninstall, or otherwise modify the WebSphere Customization Toolbox, specify the main offering ID. You can also add a comma-separated list of optional features to install. If you do not specify optional features, all of the optional features are installed. To install only the features that you want, specify the list of features explicitly.
Table 1. Offering and optional feature IDs
Offering ID Optional feature IDs Default features
WebSphere Customization Toolbox
com.ibm.websphere.WCT.v90
  • zpmt: Profile Management Tool (z/OS only)
  • zmmt: z/OS Migration Management Tool
  • pct: Web Server Plug-ins Configuration Tool

All optional features are installed by default

For a complete list of product repositories and offering IDs, see Online product repositories for WebSphere Application Server offerings and WebSphere Application Server product offerings for supported operating systems.

To install WebSphere Customization Toolbox from the online service repository, use the information, Installation Manager and Packaging Utility download documents, located at this URL, https://www.ibm.com/support/pages/node/609575 in conjunction with the Installation Manager.

Installation examples

All WebSphere Application Server offerings are installed by using IBM Installation Manager. For step-by-step instructions for installing product offerings on distributed operating systems, see Installing the product offerings.

Important: Because IBM SDK Java Technology Edition is no longer embedded with the product, you must specify both the WebSphere Customization Toolbox offering ID (com.ibm.websphere.WCT.v90) and the IBM Java SDK offering ID (com.ibm.java.jdk.v8). The WebSphere Customization Toolbox cannot be installed without a Java SDK.
Command-line examples
Windows:
imcl.exe install com.ibm.websphere.WCT.v90 com.ibm.java.jdk.v8
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v90 
  -installationDirectory "C:\Program Files\IBM\WebSphere\Toolbox"
  -sharedResourcesDirectory "C:\Program Files\IBM\IMShared"
  -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false
  -secureStorageFile C:\IM\credential.store -masterPasswordFile C:\IM\master_password.txt
  -log installv9wct.xml
  -acceptLicense
  -showProgress
Linux:
./imcl install com.ibm.websphere.WCT.v90 com.ibm.java.jdk.v8
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v90 
  -installationDirectory /opt/IBM/WebSphere/Toolbox
  -sharedResourcesDirectory /opt/IBM/IMShared
  -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false
  -secureStorageFile /var/IM/credential.store -masterPasswordFile /var/IM/master_password.txt
  -log installv9wct.xml
  -acceptLicense
  -showProgress
Response file example
<?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.v90" /> 
</server>
<install modify='false'>
<offering id='com.ibm.websphere.WCT.v90' 
  profile='WebSphere Customization Toolbox V9.0' 
  features='core.feature,pct,zpmt,zmmt' installFixes='none'/>
<offering id='com.ibm.java.jdk.v8'
  profile='WebSphere Customization Toolbox V9.0'
  features='com.ibm.sdk.8'/>
</install>
<profile id='WebSphere Customization Toolbox V9.0' 
  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.v90' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>

Usage notes

To configure web server plug-ins on distributed operating systems, use the WCT command to invoke the pct tool.

The versionInfo and historyInfo commands return version and history information for the WebSphere Customization Toolbox based on all of the installation, uninstallation, update, and rollback activities performed on the system.

Restriction:
You cannot use some combinations of the GUI customization tools for WebSphere Application Server concurrently.
  • You cannot have the following two tools or two instances of either tool open at the same time:
    • Profile Management Tool for distributed operating systems
    • Configuration Migration Tool for distributed operating systems
  • You cannot have two of the following tools within the WebSphere Customization Toolbox or two instances of any one tool open at the same time:
    • Web Server Plug-ins Configuration Tool
    • Profile Management Tool (z/OS only), which runs on Intel-based Windows or Linux operating systems
    • z/OS Migration Management Tool, which runs on Intel-based Windows or Linux operating systems
You can use one tool from one of these two sets and one tool from the other set at the same time.

Uninstallation examples

All WebSphere Application Server offerings are uninstalled by using IBM Installation Manager.

Avoid trouble: IBM SDK, Java Technology Edition (com.ibm.java.jdk.v8) must be uninstalled at the same time that you uninstall the product offering.
Command-line examples
Windows:
imcl.exe uninstall com.ibm.websphere.WCT.v90 com.ibm.java.jdk.v8
  -installationDirectory "C:\Program Files\IBM\WebSphere\Toolbox"
Linux:
./imcl uninstall com.ibm.websphere.WCT.v90 com.ibm.java.jdk.v8
  -installationDirectory /opt/IBM/WebSphere/Toolbox
Response file example
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<uninstall modify='false'>
<offering id='com.ibm.websphere.WCT.v90' 
  profile='WebSphere Customization Toolbox V9.0' 
  features='core.feature,pct,zpmt,zmmt'/>
<offering id='com.ibm.java.jdk.v8' 
  profile='WebSphere Customization Toolbox V9.0'/>
</uninstall>
<profile id='WebSphere Customization Toolbox V9.0' 
  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.v90' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>