Installing and removing tools in the WebSphere Customization Toolbox

You can use Installation Manager to install or remove a tool in the WebSphere Customization Toolbox.

1. Close the WebSphere Customization Toolbox installation that is being modified.
2. Start Installation Manager.
3. Click Modify.
4. Select the package group to modify.
5. Click Next.
   Note: If you are prompted to authenticate, use the IBM ID and password that you registered with on the program website.
6. Expand WebSphere Customization Toolbox.
7. Check the appropriate checkbox to install a tool, or clear the appropriate checkbox to remove a tool if you already have it installed.
   • 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 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.
   • 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 WebSphere Application Server 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.
8. Click Next.
9. Review the summary information, and click Modify.
   • If the modification is successful, the program displays a message indicating that installation is successful.
   • If the modification is not successful, click View Log File to troubleshoot the problem.
10. Click Finish.
11. Click File > Exit to close Installation Manager.

Example

In the following list, the optional feature offering names are enclosed in parentheses at the end of the items:

• Web Server Plug-ins Configuration Tool (pct)
• Profile Management Tool (z/OS® only) (zpmt)
• z/OS Migration Management Tool (zmmt)
• Remote Installation Tool for IBM i (installtools)

Windows: Here is a response file that modifies an existing WebSphere Customization Toolbox installation:

<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<server>
<repository location="https://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v85" />
</server>
<uninstall modify='true'>
<offering id='com.ibm.websphere.WCT.v85' 
  profile='WebSphere Customization Toolbox V8.5' 
  features='zmmt,zpmt'/>
</uninstall>
<profile id='WebSphere Customization Toolbox V8.5' 
  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.v85' value='false'/>
<data key='cic.selector.nl' value='en'/>
</profile>
</agent-input>

Tip: See Sample response file: Modifying the WebSphere Customization Toolbox for an annotated sample of a response file for performing this procedure.

Windows: Here is an example of using the imcl command to modify the tools in an installation:

imcl.exe modify com.ibm.websphere.WCT.v85
  -addFeatures zmmt
  -removeFeatures zpmt
  -repositories https://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v85
  -installationDirectory C:\Program Files\IBM\WebSphere\Toolbox
  -keyring C:\keyring_file.keyring -password password

Supported configurations:

Starting in Installation Manager Version 1.6.2, the -keyring and -password options that were used to access credentials in a key ring file are deprecated. For Installation Manager Version 1.6.2 and later, use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file.

In Version 1.7, the format of the secure storage file is revised, and is no longer compatible with versions of Installation Manager before version 1.7. Update Installation Manager to version 1.7 or higher and then re-create and replace any secure storage files that you created with earlier versions.

There is no migration path from key ring files to storage files because of the differences in the file structures. You must create a storage file to replace a key ring file. For more information about using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the IBM Installation Manager documentation.