IBM InfoSphere Federation Server, Version 10.5

Running the wrapper configuration tool

The Federation Server wrapper configuration tool is introduced in Version 10. The configuration tool provides a GUI interface for configuring relational wrappers.

Before you begin

Before you install and use the configuration tool, ensure that your federated system is set up correctly. The wrappers must be installed for the data sources that you want to configure.

About this task

The configuration tool detects any existing DB2® instance. You select which instance and wrapper you want to configure and input the required and optional environment variables for each wrapper. Based on your input, the configuration tool writes environment variables to the db2dj.ini file and exports the .profile of the DB2 instance. For Informix® and Teradata wrappers, the tool runs djxLink. After the configuration is complete, you can choose to restart DB2 and enable the configuration.

When you start the configuration tool, the federation installer determines the operating system, user authorization, and the DB2 version installed. Based on this information, the configuration tool presents you with the wrappers that you can configure.

Restrictions: The configuration tool supports the Linux and UNIX operating systems. You can use the configuration tool to configure the following relational wrappers:
  • Informix
  • Microsoft SQL Server
  • ODBC
  • Oracle
  • Sybase
  • Teradata
The configuration tool does not support the JDBC wrapper.

Procedure

  1. Launch the configuration tool.

    Go to the installation path of the configuration tool: /installation_path/bin/rwcfg. In the folder/installation_path/bin/rwcfg/rwcfg.bin, run rwcfg.bin to launch the configuration tool. The user ID must have root authority if a root user installed the product. The user ID must have non-root authority if a non-root user installed the product.

  2. Select the instance and relational wrappers to configure.
    The Welcome panel prompts you to select an instance to configure. On the Select instance and wrapper to configure panel:
    • Select an instance to configure. The panel displays the wrappers that were installed based on the instance you selected.
    • Select the wrapper that you want to configure
  3. Configure the relational wrappers.

    For each wrapper, you are prompted to input required and optional parameters. The configuration tool guides you through setting all system variables and running the djxlink script.

  4. Review the pre-configuration summary and run the configuration.

    A pre-configuration summary panel summarizes your input. You can return to a previous panel if you need to make any changes or continue to configure the selected components. When you run the configuration, the configuration tool sets your input environment variables to db2dj.ini and .profile of instance, and runs .profile and djxlink if needed.

  5. Restart the federated server.

    After the configuration is complete, the Restart Federation Server panel displays. You can to restart the federated server or wait to restart later.

  6. Review post-configuration summary. After the configuration is complete, the Configuration Summary panel displays. This panel lists the following information:
    • The status of selected components.
    • The details of the configuration status including the return codes, warning and error messages, and log file information.

Feedback