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 Installation process overview:

Installing the Adapter Framework using the graphical installer

Do the following to install the Adapter Framework:

Note:
If you are installing WebSphere Business Integration Adapters on the same computer on which InterChange Server is installed, you must not install the Adapter Framework.
  1. Invoke Installer 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, click I accept the terms in the license agreement and then click OK.
  5. 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.
  6. 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.
  7. 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.
  8. If you are installing on Windows and installer detects that you have a supported version of WebSphere Studio Application Developer Integration Edition or WebSphere Studio Workbench installed then it presents a screen where you must do one of the following:
  9. If you enabled the Add plug-ins to an existing workbench installation radio button at step 8 then you are presented with a screen where you must specify the path of the workbench installation into which you want the tools plug-ins installed.

    Either type path to the installation directory of WSADIE or WSWB in the text field labeled IBM WebSphere Studio Workbench directory or click Browse to navigate to the directory, then click Next.

  10. 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.
  11. After Installer finishes successfully, click Finish.

Installing the Adapter Framework silently

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

  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 8.

    Table 8. Silent installation options for the Adapter Framework

    Option name Option values
    -P installLocation
     
    

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

    If you leave this option commented, the product installs to the default directory listed in Table 7.

    This value must not contain any spaces.

    -W mqDirectoryUserInput.mqLibraryLocation
     
    

    Set this option to the path of the java\lib directory within the WebSphere MQ installation on the computer when the operating system is Windows.

    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 or if the operating system is not Windows.

    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 mqUserInputAIX.mqLibraryLocation
     
    

    Set this option to the path of the java/lib directory within the WebSphere MQ installation on the computer when the operating system is AIX.

    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, or if the platform is not AIX.

    Comment out this option if you want to use the default values. On the AIX platform, installer uses the default value /usr/mqm/java/lib.

    -W mqUserInputSOL.mqLibraryLocation
     
    

    Set this option to the path of the java/lib directory within the WebSphere MQ installation on the computer when the operating system is Solaris or HP-UX.

    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, or if the platform is not Solaris or HP-UX.

    Comment out this option if you want to use the default values. On the Solaris and HP-UX platforms, installer uses the default value /opt/mqm/java/lib.

    -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.

    This option is only relevant on the Windows platform. Comment out this option when installing on UNIX.

    -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 directory in which the workbench should be installed, for example C:\WebSphereAdapters\Tools.

    This option is only relevant on the Windows platform. Comment out this option when installing on UNIX.

    -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.

    This option is only relevant on the Windows platform. Comment out this option when installing on UNIX.

    -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 is not relevant for any broker on any platform. Comment out this option.

    -G removeModifiedResponse
     
    

    This option is not relevant for any broker on any platform. Comment out this option.

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

Copyright IBM Corp. 1997, 2003