Installing data handlers

Follow the instructions in one of the following sections to install a data handler if indicated by the procedural overview in Installation process overview:

Installing data handlers using the graphical installer

Do the following to install a data handler using the graphical installer:

  1. Invoke Installer as described in for your data handler.
  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 data handlers. The product directory must contain an installation of a compatible version of the Adapter Framework. You may specify another directory, but it must contain an installation of a compatible version of the Adapter Framework.

    On the Windows platform, 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.

    On the UNIX platform, the installer queries an entry in a file created by either the Adapter Framework installer or the WebSphere InterChange Server installer.

    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. If you are installing on a Windows computer then Installer presents the program folder selection screen for some data handlers. 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.
  8. After Installer finishes successfully, click Finish.

Installing data handlers silently

Do the following to perform a silent installation of a data handler:

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

    Table 9. Silent installation options for data handlers

    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.

    -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, 2004