[AIX Solaris HP-UX Linux Windows]

Installing and using the WebSphere Customization Toolbox

The WebSphere® Customization Toolbox include tools for managing, configuring, and migrating various parts of your WebSphere Application Server environment.

About this task

The WebSphere Customization Toolbox contains the Web Server Plug-ins Configuration Tool, Profile Management Tool (z/OS® only), z/OS Migration Management Tool, and Remote Installation Tool for IBM® i.
Note: In version 8.5.5.11 and higher, when using Java SE 8 as the default SDK, the graphical user interface (GUI) for the WebSphere Customization Toolbox is supported only on AIX®, HP-UX, Linux, and Windows. The GUI is not supported on Solaris systems when using Java SE 8 as the default SDK. To use the WebSphere Customization Toolbox on Solaris when using Java SE 8, use the wctcmd -tool pct command. You can continue to use the GUI on all supported platforms with Java SE 6, but no service can be provided after the end of support in April 2018, which could expose your environment to security risks.
  • Use the Web Server Plug-ins Configuration Tool to configure your web server plug-ins for any operating system on which the WebSphere Customization Toolbox can be installed.
  • Launch the Profile Management Tool (z/OS only) on a Windows or Linux® operating system to generate jobs and instructions for creating profiles for WebSphere Application Server on z/OS systems.
  • Launch the z/OS Migration Management Tool on a Windows or Linux operating system to generate definitions for migrating WebSphere Application Server for z/OS profiles.
  • Use the Remote Installation Tool for IBM i to install IBM Installation Manager or a WebSphere Application Server product offering from a Windows workstation to a remote target IBM i system.
Note: When you install a WebSphere Application Server full-profile offering on a distributed operating system, the program automatically installs two additional tools into the WebSphere Customization Toolbox on that system:
  • Configuration Migration Tool for distributed operating systems
  • Profile Management Tool for distributed operating systems

Procedure

Perform one of the following procedures:

  • Install and use the following tools.
    • Web Server Plug-ins Configuration Tool

      The Web Server Plug-ins Configuration Tool allows you to configure your web server plug-ins on distributed and Windows operating systems.

    • Profile Management Tool (z/OS only)

      The Profile Management Tool (z/OS only) allows you to build and process definitions for creating WebSphere Application Server profiles.

      Processing the definitions results in the generation of customization jobs that you then run on the z/OS system. You can upload directly to the z/OS system as you process a definition, or you can save it locally and upload it to the z/OS system later.

    • z/OS Migration Management Tool

      The z/OS Migration Management Tool allows you to build and process definitions for migrating WebSphere Application Server profiles.

      Processing the definitions results in the generation of customization jobs that you then run on the z/OS system. You can upload directly to the z/OS system as you process a definition, or you can save it locally and upload it to the z/OS system later.

    • Remote Installation Tool for IBM i

      The Remote Installation Tool for IBM i is a command-line utility for installing WebSphere Application Server product offerings from a Windows machine to a remote machine running the IBM i operating system.

  • Use the WCT command to invoke the pct tool to configure your web server plug-ins on distributed and Windows operating systems.

What to do next

Restriction:
You cannot use some combinations of the GUI customization tools for IBM WebSphere Application Server Version 8.5 concurrently.
  • You cannot have the following two tools or two instances of either tool open at the same time:
    • Profile Management Tool for distributed operating systems
    • Configuration Migration Tool for distributed operating systems
  • You cannot have two of the following tools within the WebSphere Customization Toolbox or two instances of any one tool open at the same time:
    • Web Server Plug-ins Configuration Tool
    • Profile Management Tool (z/OS only), which runs on Intel-based Windows or Linux operating systems
    • z/OS Migration Management Tool, which runs on Intel-based Windows or Linux operating systems
You can use one tool from one of these two sets and one tool from the other set at the same time.