Installing the adapter framework

Follow the instructions in one of the following sections to install the Adapter Framework if indicated by the procedural overview in Overview of installation:

Note:
If you select the WebSphere Business Integration Toolset software for installation, then the adapter framework is automatically selected for installation.

Installing the adapter framework using the graphical installer

Do the following to install the adapter framework:

Note:
If your integration broker is WebSphere InterChange Server and you are installing WebSphere Business Integration Adapters on the same computer on which InterChange Server is installed, you must install the adapter framework to a separate directory. With version 2.6, the adapter framework is no longer installed with WebSphere InterChange Server.
  1. Invoke Installer for Adapter Framework as described in Invoking the graphical WBIA installer for the Adapter Framework.
  2. At the language selection prompt, choose the desired language from the drop-down menu and click OK.
  3. At the Welcome screen click Next.
  4. At the IBM license acceptance screen, read the terms and if you agree, click I accept the terms in the license agreement and then click OK.
    Note:
    Installer next examines your system for pre-existing conditions that may require your attention.
    • If you are attempting to install on an unsupported platform, Installer presents an unsupported platform screen. Click Cancel to exit the installation.
    • If you are attempting to install on a Windows machine but do not have administrative privileges, Installer presents a Windows requirement not met screen. Click Cancel to exit the installation.
    • If Installer detects an installed previous version of the adapter framework on your system, Installer presents a dialog identifying the previous version of the framework and suggesting that you first uninstall it before proceeding. Click Next to proceed.
      • If Installer detects an installed ICS version 4.2.2 on your system, Installer recommends installing the framework on a separate system. Adapter Framework 2.6 cannot coexist with ICS 4.2.2 on the same system. Click Cancel to exit the installation, click Next to choose an ICS broker.
      • If it detects a version of ICS that is older than ICS 4.2.2 Installer presents a dialog that advises against installing the framework. Adapter Framework 2.6 is not compatible with a pre-ICS 4.2.2 integration broker.
  5. At the ICS broker screen, click the box to choose ICS as your integration broker. Click Next.
  6. At the product directory screen, perform one of the following tasks:
    Important:
    You must specify a product directory path and name that does not contain spaces.
    Installer verifies that the selected installation location does not contain ICS or a pre-2.6.0 version of the adapter framework. If these conditions are not met, Installer asks you to select a different installation location.
  7. If you are installing on a Windows system, Installer presents the Feature window. Click the boxes to install the Adapter Framework and the IBM WebSphere Business Integration Toolset.
    Note:
    If you select the toolset, the adapter framework is automatically selected. You cannot select the toolset if any of the following conditions are true:
    • Integration broker is ICS
    • Operating system is Windows 2003
    • ICS is installed on your system.
    Click Next to continue.
  8. At the WebSphere MQ Java library screen, either type the directory path to the java\lib directory of the WebSphere MQ installation or click Browse to select the directory, then click Next.
  9. If you are installing on SuSE, AIX, or Solaris, Installer presents the location panel for the IBM Tivoli Monitoring for Transaction Performance (ITMTP) Management Agent. If ITMTP agent version 5.2 fix pack 1 is found, the default directory name on this panel is set to the install location of the ITMTP agent. Otherwise the default directory name is left blank, and you can enter the install location.
  10. If you are installing on Solaris or AIX and configuring WebSphere Application Server as your integration broker, then Installer presents the location panel for the WebSphere Application Server (WAS) Application Clients 5.0.2, 5.1 or 5.1.1. If WAS clients are found, the default directory name on this panel is set to the install location of the WAS client. Otherwise the default directory name is left blank, and you can enter the install location of IBM WebSphere Application Server Application Clients 5.0.2, 5.1 or 5.1.1.
  11. If you are installing on Windows and installer detects that you have a supported version of WebSphere Studio Application Developer Integration Edition installed then it presents a screen where you must do one of the following:
  12. If you enabled the Add plug-ins to an existing workbench installation radio button at step 11 then you are presented with a screen displaying the path of the default WSADIE directory. This is the path where the tools plug-ins will be installed.

    To change the default to the location of a different WSADIE directory, either type the path to the installation directory of WSADIE in the text field labeled IBM WebSphere Studio Workbench directory or click Browse to navigate to the directory, then click Next.

  13. If you are installing on a Windows computer then Installer next presents the program folder selection screen. In the Program Group field, type the name of the program group in which shortcuts for the adapters should be created or accept the default program group and then click Next.
  14. The summary screen lists the features that will be installed, the specified product directory, and the amount of disk space required. Read the information to verify it and then click Next.
  15. After Installer finishes successfully, click Finish.

Installing Adapter Framework silently on Windows systems

Do the following to perform a silent installation of the Adapter Framework on Windows systems:

  1. Prepare a response file to install the Adapter Framework as described in Preparing the installation response file, using the desired options listed in Table 12.

    Table 12. Silent installation options for Adapter Framework on Windows

    Option name Option values
    -W BrokerPanel.ICS
    
    Set the value of this property to 1 if your integration broker is IBM WebSphere InterChange Server.
    -W destination.path
    

    Set this option to the path and name of the directory into which you want the adapter framework installed.

    The install location must not contain IBM WebSphere InterChange Server or a previous version to IBM WebSphere Business Integration Adapter Framework, version 2.6.0. The installation path must not contain space characters. For example, to install the framework to C:\IBM\WebSphereAdapters enter the following:

    -W destination.path="C:\IBM\WebSphereAdapters"
    

    Note: IBM WebSphere Business Integration Adapters, IBM WebSphere Business Integration Adapter Development Kit, and IBM WebSphere Business Integration data handlers must be installed to the same location as the IBM WebSphere Business Integration Adapter Framework. Select a location that has sufficient space for these components.

    -P support.active
    

    Set this option to true if you want to install the adapter framework. If this option is set to false, the framework is not installed. For example, to select the toolset for installation use

    -P support.active="true"
    
    -P frameworkTOOLS_f.active
    

    Set this option to true if you want to install the IBM WebSphere Business Integration Toolset. If this option is set to false, the toolset is not installed. For example, to select the toolset for installation use

    -P frameworkTOOLS_f.active="true"
    
    -W mqDirectoryUserInput.mqLibraryLocation
    

    Set this option to the path of the java\lib directory within the WebSphere MQ installation on the computer

    Comment out this option if your broker is WebSphere InterChange Server and you are installing the Adapter Framework on the same computer where the broker is installed.

    Comment out this option if you want to use the default values. On the Windows platform, Installer searches the Windows registry by default and uses the value it finds there.

    -W workbenchChoice.workbenchList
    

    Set this option to 1 to add the tools plug-ins to an existing installation of WebSphere Studio Workbench or WebSphere Studio Application Developer Integration Edition.

    Set this option to 2 to install WebSphere Studio Workbench.

    -W workbenchLocation.workbenchLocDirectory
    
    If you specified that WebSphere Studio Workbench be installed by setting the value of the workbenchChoice.workbenchList option to 2, then set this option to the target installation directory. For example: C:\WebSphereAdapters\Tools.
    -W inputShortcuts.folder
    

    Set this option to the name of the program group created for the WBIA product, for example IBM WebSphere Business Integration Adapters.

    -G replaceExistingResponse
    

    Set this option to yesToAll or yes to replace all files found on the system that have the same name as those being copied by the installer.

    Set this option to noToAll or no to not replace any files found on the system that have the same name as those being copied by the installer.

    -G replaceNewerResponses
    

    Set this option to yesToAll or yes to replace all files found on the system that are newer than those being copied by the installer.

    Set this option to noToAll or no to not replace any files found on the system that are newer than those being copied by the installer.

    -G createDirectoryResponse
    

    Set this option to yes to create the product directory specified by the option if it does not already exist.

    Set this option to no to not have the product directory created if it does not exist.

    You must set this option to yes if the specified directory does not exist for the installation to succeed.

    -G removeExistingResponse
    
    This option specifies whether to remove a file that exists on the system. The possible values are as follows: yesToAll, yes, noToAll, or no. Note: that this option is for uninstall only.
    -G removeModifiedResponse
    

    This option specifies whether to remove a file that has been modified since it was last installed. The possible values are as follows: yesToAll, yes, noToAll, andno. Note that this option is for uninstall only.

  2. Perform the silent installation as described in Executing the silent installation, using the response file prepared in step 1.

Installing Adapter Framework silently on UNIX or Linux systems

Do the following to perform a silent installation of the Adapter Framework on UNIX or Linux systems:

  1. Prepare a response file to install Adapter Framework as described in Preparing the installation response file, using the desired options listed in Table 12.

    Table 13. Silent installation options for Adapter Framework on UNIX or Linux

    Option name Option values
    -W BrokerPanel.ICS
    
    Set the value of this property to 1 if your integration broker is IBM WebSphere InterChange Server. Otherwise, skip this option.
    -W destination.path
    

    Set this option to the path and name of the directory into which you want the adapter framework installed. The install location must not contain IBM WebSphere InterChange Server or a previous version to IBM WebSphere Business Integration Adapter Framework, version 2.6.0. The installation path must not contain space characters. Note: IBM WebSphere Business Integration Adapters, IBM WebSphere Business Integration Adapter Development Kit, and IBM WebSphere Business Integration data handlers must be installed to the same location as the IBM WebSphere Business Integration Adapter Framework. Select a location that has sufficient space for these components.

    -W ITMTPPanel.ITMTPLocation
    
    The directory path to IBM Tivoli Monitoring for Transaction Performance (ITMTP) Management Agent 5.2 (fix pack 1). Set this property if you intend to enable IBM Tivoli Application Response Measurement (ARM).
    -W WASClientPanel.WASClientLocation
    
    The directory path to IBM WebSphere Application Server Application Clients 5.0.2 or 5.1. Set this property if you intend to enable IBM Tivoli Common Event Infrastructure (CEI) with the adapter framework.
    -W mqUserInput.mqLibraryLocation
    
    Set this option to the path of the IBM WebSphere MQ 5.3 Java library location on Solaris and HP platforms. For example if IBM WebSphere MQ 5.3 Java library is located at /opt/mqm/java/lib, use-W mqUserInput.mqLibraryLocation="/opt/mqm/java/lib"
    -G replaceExistingResponse
    

    Set this option to yesToAll or yes to replace all files found on the system that have the same name as those being copied by the installer.

    Set this option to noToAll or no to not replace any files found on the system that have the same name as those being copied by the installer.

    -G replaceNewerResponses
    

    Set this option to yesToAll or yes to replace all files found on the system that are newer than those being copied by the installer.

    Set this option to noToAll or no to not replace any files found on the system that are newer than those being copied by the installer.

    -G createDirectoryResponse
    

    Set this option to yes to create the product directory specified by the option if it does not already exist.

    Set this option to no to not have the product directory created if it does not exist.

    You must set this option to yes if the specified directory does not exist for the installation to succeed.

    -G removeExistingResponse
    
    This option specifies whether to remove a file that exists on the system. The possible values are as follows: yesToAll, yes, noToAll, or no. Note: that this option is for uninstall only.
    -G removeModifiedResponse
    

    This option specifies whether to remove a file that has been modified since it was last installed. The possible values are as follows: yesToAll, yes, noToAll, and no. Note that this option is for uninstall only.

  2. Perform the silent installation as described in Executing the silent installation, using the response file prepared in step 1.

Copyright IBM Corp. 1997, 2004