How to install WebSphere Customization Toolbox on Linux on the command line

Home > Search > How-to

If you have not installed IBM Installation Manager, install IBM Installation Manager

There are multiple ways to install WebSphere Customization Toolbox:

  • GUI
  • Command Line - from IBM HTTP repository
  • Command Line - from local repository
  • Command Line - Response file


From IBM HTTP repository

When installing WebSphere Customization Toolbox via the command line, IBM recommends installing the toolbox from the IBM HTTP repository instead of from a local repository, as this ensures that the latest installation files are used during the install.

List the available packages. The -prompt option is used to get a prompt to provide your IBM username and password.

~]# cd /opt/IBM/InstallationManager/eclipse/tools/
~]# ./imcl listAvailablePackages -repositories -prompt


Install the toolbox. When installing version 9, you will need to install both the toolbox and Java JDK.

~]# ./imcl install
  -installationDirectory /opt/IBM/WebSphere/WCT
  -sharedResourcesDirectory /opt/IBM/IMShared
  -prompt or -masterPasswordFile /var/ibm/InstallationManager/master_password.txt


From local repository

Installing a offering from a local repository is nearly identical to installing from IBM HTTP repository, except you would download the products you want to install from Fix Central. When installing version 9 of the toolbox, don't forget to download Java JDK. After the packages have been downloaded, you will unzip the packages to a location on your server, such as /tmp/wct and /tmp/java. Then, you can use /tmp/wct and /tmp/java in the install command.

~]# ./imcl install
  -repositories /tmp/wct,/tmp/java  
  -installationDirectory /opt/IBM/WebSphere/WCT
  -sharedResourcesDirectory /opt/IBM/IMShared
  -prompt or -masterPasswordFile /var/ibm/InstallationManager/master_password.txt


Response file

A request file is an XML file that contains details regarding the product being installed, such as the offering ID and the installation directory. Create the response file.

~]# touch /opt/IBM/response_file.xml


Add the following text to the response_file.xml. In this example, version 9 of the toolbox is installed, along with Java JDK.

<?xml version="1.0" encoding="UTF-8"?>
    <variable name='sharedLocation' value='/opt/IBM/IMShared'/>

    <repository location="" />

  <profile id='IBM WebSphere Customization Toolbox' installLocation='/opt/IBM/WebSpere/WCT'>
    <data key='user.import.profile' value='false'/>
    <data key='' value='en'/>

  <install modify='false'>
    <offering id='' 
      profile='IBM WebSphere Customization Toolbox' 
      features='core.feature,ejbdeploy,thinclient,embeddablecontainer' installFixes='none'/>
    <offering id=''
      profile='IBM WebSphere Java'


You can create a response file by issuing the following command, which will launch the Installation Manager GUI, so this must be done in a graphical environment. Follow the steps on installing WebSphere using the GUI.

~]# cd /opt/IBM/InstallationManager/eclipse
~]# ./IBMIM -record /path/to/response.xml -skipInstall /opt/IBM


Install the toolbox.

./imcl input /opt/IBM/response_file.xml 
  -secureStorageFile /var/ibm/InstallationManager/secure_storage
  -masterPasswordFile /var/ibm/InstallationManager/master_password.txt


Post installation

The installation_directory/logs/install/log.txt file can be reviewed to ensure the installation was successful.

The listInstalledPackages command can be used to see what packages are installed.. In this example, the toolbox and Java JDK are installed.

~]# ./imcl listInstalledPackages


The utility can be used to verify that the toolbox was successfully installed.

~]# /opt/IBM/WebSphere/WCT/bin/
. . .
Installed Product
Name              IBM WebSphere Customization Toolbox
. . .


Add a Comment

We will never share your name or email with anyone. Enter your email if you would like to be notified when we respond to your comment.

Please enter in the box below so that we can be sure you are a human.