Installing adapters

Follow the instructions in one of the following sections to install an adapter if indicated by the procedural overview in Installation process overview:

Installing adapters using the graphical installer

Do the following to install an adapter using the graphical installer:

  1. Invoke Installer as described in for your adapter.
  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. The product directory screen allows you to specify where to install the adapters. The product directory must contain an installation of a compatible version of the Adapter Framework. The field defaults to the value contained in the CROSSWORLDS environment variable, which is set by the either the WebSphere InterChange Server Installer or the WebSphere Business Integration Adapters Installer for Adapter Framework. You may specify another directory, but it must contain an installation of a compatible version of the Adapter Framework.

    For information on installing the Adapter Framework, see Installing the Adapter Framework. For more information on installing WebSphere InterChange Server, see the System Installation Guide for Windows or Unix.

    At the product directory screen, perform one of the following tasks:

  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 IBM WebSphere InterChange Server screen, do one of the following tasks depending on your integration broker:
  8. If you are installing on a Windows computer then Installer presents the program folder selection screen. In the Program Group field, type the name of the program group in which you want to create shortcuts for the adapters or accept the default program group and then click Next.
  9. After Installer finishes successfully, click Finish.

Installing adapters silently

Do the following to perform a silent installation of an adapter:

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

    Table 10. Silent installation options for adapters

    Option name Option values
    -W installLocation.active
     
    
    You must set this option to the value true to be able to specify the installation location through the use of the installLocation.value option.

    If you comment out this option or set it to a value other than false, the silent installation is affected as follows:

    • If you are installing on Windows and installer detects the presence of the CROSSWORLDS environment variable, then the product installs to the location specified by the environment variable.
    • If you are installing on UNIX and installer finds an entry for the product in the vpd.properties file, then the product installs to the location specified in the file.
    • If you are installing on Windows and installer does not detect the presence of the CROSSWORLDS environment variable, but there is a lib directory in the default installation location specified in Table 7 that contains a valid version of CROSSWORLDS.JAR, then the product installs to the default location specified in Table 7.
    • If you are installing on UNIX and installer does not find an entry for the product in the vpd.properties file, but there is a lib directory in the default installation location specified in Table 7 that contains a valid version of CROSSWORLDS.JAR, then the product installs to the default location specified in Table 7.
    -W installLocation.value
     
    

    Set this option to the directory path in which the WebSphere Business Integration Adapters product is installed.

    If you comment out this option or set it to a value other than false, the silent installation is affected as follows:

    • If you are installing on Windows and installer detects the presence of the CROSSWORLDS environment variable, then the product installs to the location specified by the environment variable.
    • If you are installing on UNIX and installer finds an entry for the product in the vpd.properties file, then the product installs to the location specified in the file.
    • If you are installing on Windows and installer does not detect the presence of the CROSSWORLDS environment variable, but there is a lib directory in the default installation location specified in Table 7 that contains a valid version of CROSSWORLDS.JAR, then the product installs to the default location specified in Table 7.
    • If you are installing on UNIX and installer does not find an entry for the product in the vpd.properties file, but there is a lib directory in the default installation location specified in Table 7 that contains a valid version of CROSSWORLDS.JAR, then the product installs to the default location specified in Table 7.

    -W inputServer.name
     
    

    Set this option to the name of the InterChange Server instance with which the installed adapters will communicate. The name is case-sensitive and must be specified accurately or the adapters will not be able to communicate with the server.

    You must make sure this option is not commented and is set to the proper value when installing adapters to communicate with WebSphere InterChange Server. Comment out this option when installing adapters to communicate with the WMQI or WAS brokers.

    -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