IBM WebSphere Multichannel Bank Transformation Toolkit, Version 7.1

Installing the toolkit on a development workstation

This topic describes how to install WebSphere® Multichannel Bank Transformation Toolkit on a development workstation.

Procedure

To set up the development workstation, do the following steps:

  1. Install IBM® Rational® Application Developer.
  2. Insert the WebSphere Multichannel Bank Transformation Toolkit CD into the CD-ROM and browse the CD.
  3. Start the Installation Wizard for WebSphere Multichannel Bank Transformation Toolkit.
    • For Windows platforms, locate and double-click the setup.exe file.
    • For Linux platforms, locate and invoke the setupLinux.bin file.
    The Introduction window opens.
  4. Click Next. The "Product license agreement" window opens.
  5. Select the I accept the terms in the license agreement check box and click Next.
    Note:

    The Installation Wizard detects if any version of Bank Transformation Toolkit is already installed on your system. WebSphere Multichannel Bank Transformation Toolkit V7.1 can coexist with Branch Transformation Toolkit V4.3, 5.0, 5.1 and 5.2. However, WebSphere Multichannel Bank Transformation Toolkit V7.1 cannot coexist with WebSphere Multichannel Branch Transformation Toolkit V5.2.0.1 and 5.2.0.2, and WebSphere Multichannel Bank Transformation Toolkit V7.0 and 6.1.1, and 6.1.2. If you already have version 7.0.0 installed, the Installation Wizard displays an error message, which indicates that V7.0 is already installed. You must uninstall V7.0 before you installed V7.1.

    The Installation Wizard also checks whether IBM Rational Application Developer is installed. If IBM Rational Application Developer is installed, the Installation Wizard installs the toolkit components designed for IBM Rational Application Developer.

  6. Select the destination directory for the installation files. By default, the destination directory is:
    • For Windows: C:\IBM\WebSphere\Multichannel Bank Transformation Toolkit 7.1
    • For Linux: /opt/IBM/WebSphere/Multichannel_Bank_Transformation_Toolkit_7.1
    If you do not want to select the default destination directory, click Browse, and then select the folder that you want to use. Click Next.
  7. On the Pre-Installation Summary window, review the installation summary, and then click Install. The Bank Transformation Toolkit installation program creates the directories on the target workstation.
    Table 1. Directories created by the installation program.
    Directory name Description of contents
    license Product license files
    javadoc Product Java documentation
    lib Product runtime libraries
    plugins Tooling:
    • Transaction Editor plug-in
    • Migration tool plug-in
    • Formatter Simulator plug-in
    • Application Wizard plug-in
    • XUI Editor plug-in
    • Deployment Descriptor Editor plug-in
    Runtime:
    • Business component plug-in
    • Rich client platform plug-in
    samples Product samples
    jre Install Anywhere bundled JVM
    Uninstall Product uninstallation files
    migration Migration-related files
    reference Open source components
    rcptools Rich client platform tooling
  8. Start IBM Rational Application Developer.
  9. Set your preferences before you import WebSphere Multichannel Bank Transformation Toolkit Java source:
    • To work with complex projects, use the source folders as source containers instead of creating packages inside the project. To use source folders as source containers, create source folders as children of the project and create packages inside these source folders. To automate this, click Window > Preferences. Expand the Java node, and then select the New Project node. Select the Folders check box.
    • To develop applications by using WebSphere Multichannel Bank Transformation Toolkit, add the framework functional units (the JAR files containing the classes) to the application classpath. You can use any approach to do this, but you must account for the class loader policies.

      A recommended approach is to add an overall classpath variable named BTT to point to the root directory of the Bank Transformation Toolkit installation. To do this, do the following steps:

      Another approach is to define a classpath variable for each functional unit available in the product. Each classpath variable points to the concrete JAR associated with the functional unit (see the tables in Functional units, packages, and dependencies).

    1. Click Window > Preferences.
    2. Expand the Java node and select Build Path.
    3. Expand the Build Path node and select Classpath Variables.
    4. Click New and enter BTT in the Name field.
    5. In the Path field, enter the path in which WebSphere Multichannel Bank Transformation Toolkit is installed.
    6. Click OK.

    To add another classpath variable, repeat steps 9a - 9f. You might want to add a classpath variable named BTT_EXTERNAL to point to the external dependencies. To enable the external classpath variable, all the required external JAR files must be in the directory to which this variable points. The overall classpath variables makes it easier for you to select the WebSphere Multichannel Bank Transformation Toolkit JAR files for your Java project.

    The remainder of this procedure and all the other procedures assumes that you are using the recommended approach.

  10. Create a Java project for your application.
    1. Select File > New > Project.
    2. In the left panel, select Java; and then in the right panel, select Java Project. Click Next.
    3. Enter the name of your project, and then click Finish.
  11. Embed WebSphere Multichannel Bank Transformation Toolkit functional units and the required application resources inside the J2EE EAR file to deploy an application.

    WebSphere Multichannel Bank Transformation Toolkit uses functional units to provide a coherent structure of JAR files for you to build an application. The JAR files in the functional units contain the required set of classes for an execution environment.

    To enable the functional units to become available to your project, add either the compiled JAR files to the project classpath or import the JAR files into the workspace. You might want to import the JAR files into the workspace if you want to embed the JAR files and resources into your application when, for example, it is self-contained and independently deployed.

    For either option, you only add or import the JAR files and the corequisite functional units that are required to optimize the deployment and distribution of the application. For more information on JAR files and their corequisite functional units, see the Functional units, packages, and dependencies topic.

Results

After you have installed WebSphere Multichannel Bank Transformation Toolkit in IBM Rational Application Developer, you can develop solutions that are based on WebSphere Multichannel Bank Transformation Toolkit.



Feedback