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.

Before you begin

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

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

About this task

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

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

Procedure

  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:
  • Web Server Plug-ins Configuration Tool (pct)
  • z/OS Profile Management Tool (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="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v80" />
</server>
<uninstall modify='true'>
<offering id='com.ibm.websphere.WCT.v80' 
  profile='WebSphere Customization Toolbox V8.0' 
  features='zmmt,zpmt'/>
</uninstall>
<profile id='WebSphere Customization Toolbox V8.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.v80' 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.v80
  -addFeatures zmmt
  -removeFeatures zpmt
  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.WCT.v80
  -installationDirectory C:\Program Files\IBM\WebSphere\Toolbox
  -keyring C:\keyring_file.keyring -password password
Restriction: The imcl command-line tool in Installation Manager Version 1.4.x and earlier cannot update the product and remove features at the same time You should update the package with the same features using the imcl command and then remove unwanted features using the imclStarting in Installation Manager Version 1.6.2, the -keyring and -password options that have been used to access credentials in a keyring file are deprecated. When you use Installation Manager Version 1.6.2 and later, use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file. There is no migration path from keyring files to storage files because of the differences in the file structures. You must create a storage file to replace a keyring file. For more information on using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the Installation Manager Version 1.6 Information Center.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Feb 6, 2014 11:19:27 PM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-dist&topic=tins_modify_wct
File name: tins_modify_wct.html