Install and remove tools in the WebSphere Customization Toolbox

Use Installation Manager to install or remove a tool in the WebSphere Customization Toolbox.

Make sure that your Installation Manager preferences are pointing to the appropriate web-based or local repositories containing the WebSphere Customization Toolbox.

Important: When uninstalling the Web Server Plug-ins Configuration Tool, the process does not unconfigure existing web server plug-ins configurations. We might want to use the Web Server Plug-ins Configuration Tool to delete any plug-in configurations that we created using the Web Server Plug-ins Configuration Tool before you remove the tool.

Perform this procedure to use the Installation Manager GUI to install or remove a tool in the WebSphere Customization Toolbox.

Like other Installation Manager operations, we can also invoke a modification using one of the following procedures:

• Use a response file

  We can record this response file using the GUI and Installation Manager's record mode, or we can manually create or modify a response file to suit our needs.

• Use the imcl command-line tool

  Go to the IBM Installation Manager documentation for more information.

Tasks

1. Close the WebSphere Customization Toolbox installation being used modified.

2. Start Installation Manager.

3. Click Modify.

4. Select the package group to modify.

5. Click Next.

   If we are prompted to authenticate, use the IBM ID and password registereded 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 we already have it installed.
   • Web Server Plug-ins Configuration Tool

     The Web Server Plug-ins Configuration Tool configures the web server plug-ins for WAS so that the 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 used to create or augment WAS 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 used to migrate a WAS 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.

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)

(Windows) The following response file modifies an existing WebSphere Customization Toolbox installation:

<?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>
    <uninstall modify='true'>
        <offering id='com.ibm.websphere.WCT.v90' 
                   profile='WebSphere Customization Toolbox V9.0' 
                   features='zmmt,zpmt'/>
    </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>

(Windows) Modify the tools in an installation:

imcl.exe modify com.ibm.websphere.WCT.v90 
       -addFeatures zmmt 
       -removeFeatures zpmt 
       -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v90 
       -installationDirectory C:\IBM\WebSphere\Toolbox 
       -secureStorageFile C:\IM\credential.store 
       -masterPasswordFile C:\IM\master_password.txt 

WebSphere Customization Toolbox installation information