+

Search Tips   |   Advanced Search

(Dist) WebSphere Customization Toolbox (WCT)


Start WebSphere Customization Toolbox

To start the WebSphere Customization Toolbox...

The WebSphere Customization Toolbox contains the following optional tools that we can use to manage, configure, and migrate various parts of our WAS environment.


Requirements

In addition to the following requirements, the system might require other prerequisites so that we can install WAS offerings. See Prepare the operating system for product installation.


Repositories and offering IDs

To install WebSphere Customization Toolbox from the online service repository, use the following repository URL with Installation Manager: 

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

When we use the command line or response files to install, uninstall, or otherwise modify the WebSphere Customization Toolbox, specify the main offering ID. We can also add a comma-separated list of optional features to install. If we do not specify optional features, all of the optional features are installed. To install only the features that we want, specify the list of features explicitly.

Offering ID Optional feature IDs Default features
WebSphere Customization Toolbox 
com.ibm.websphere.WCT.v90

All optional features are installed by default

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


Installation examples

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

Important: Because IBM SDK Java Technology Edition is no longer embedded with the product, 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

For step-by-step instructions for installing using the command line, see Install the product offerings using the command line.

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:\IBM\WebSphere\Toolbox"
  -sharedResourcesDirectory "C:\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

For step-by-step instructions for installing using a response file, see Install the product offerings using response files.

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean="true" temporary="true">
<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:\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.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.

We can add and remove the tools installed as part of the WebSphere Customization Toolbox using the Installation Manager modify function. See Install and remove tools in the WebSphere Customization Toolbox.

Restriction:

We cannot use some combinations of the GUI customization tools for WAS concurrently.

Use one tool from one of these two sets and one tool from the other set at the same time.


Uninstallation examples

All WAS offerings are uninstalled using IBM Installation Manager. For step-by-step instructions for uninstalling product offerings on distributed operating systems, see Uninstall the product offerings.

IBM SDK (com.ibm.java.jdk.v8) must be uninstalled at the same time that you uninstall the product offering..

Command-line examples

For step-by-step instructions for uninstalling using the command line, see Uninstall the product offerings using the command line.

Windows: 

imcl.exe uninstall com.ibm.websphere.WCT.v90 com.ibm.java.jdk.v8
  -installationDirectory "C:\IBM\WebSphere\Toolbox"

Linux: 

./imcl uninstall com.ibm.websphere.WCT.v90 com.ibm.java.jdk.v8
  -installationDirectory /opt/IBM/WebSphere/Toolbox

Response file example

For step-by-step instructions for uninstalling using a response file, see Uninstall the product offerings using response files.

<?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:\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.v90' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>


Related:

  • WAS product offerings for supported operating systems
  • Online product repositories for WAS offerings
  • Install the product offerings on distributed operating systems using the GUI
  • Install the product offerings using the command line
  • Install the product offerings using response files
  • Install and remove tools in the WebSphere Customization Toolbox
  • Uninstall the product offerings
  • Supported hardware and software website