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.
Requirements
In addition to the following requirements, your system might require other prerequisites so that you can install WebSphere Application Server offerings. For more information, see Preparing the operating system for product installation.
-
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.
-
To run the GUI, AIX systems must have GTK+ 2.24 or later installed from the AIX Toolbox for Linux. Linux systems arequire GTK+ 2.18 or later, and GTK+ 3.0 is supported only for Linux on Intel and POWER® Little Endian (LE) processors. If GTK+ 3.0 is installed on a platform where it is not supported, you might encounter errors. To resolve these errors, add the following two lines to the eclipse.ini file to start GTK+ 2.
--launcher.GTK_version 2
Repositories and offering IDs
http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v90
Offering ID | Optional feature IDs | Default features |
---|---|---|
WebSphere Customization
Toolbox
|
|
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.
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 by using the command line, see Installing the product offerings by 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:\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
-
For step-by-step instructions for installing by using a response file, see Installing the product offerings by using response files.
<?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.
You can add and remove the tools that are installed as part of the WebSphere Customization Toolbox by using the Installation Manager modify function. For more information, see Installing and removing tools in the WebSphere Customization Toolbox.
Uninstallation examples
All WebSphere Application Server offerings are uninstalled by using IBM Installation Manager. For step-by-step instructions for uninstalling product offerings on distributed operating systems, see Uninstalling the product offerings.
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 by using the command line, see Uninstalling the product offerings by using the command line.
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
-
For step-by-step instructions for uninstalling by using a response file, see Uninstalling the product offerings by 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:\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>