Adding Rule Designer to an existing Eclipse

After you install the update site for Rule Designer, add the software to an existing Eclipse.

Before you begin

To install Rule Designer in an existing Eclipse environment, you must make sure that you have the required plug-ins available in <InstallDir>/studio/update-sites. If you do not have the plug-ins, use Installation Manager to update your installation package.

Make sure that you install the patches for your Eclipse version first.

About this task

Installing Rule Designer in an existing Eclipse can be useful if you use one of the following products:
  • Rational® Developer for System
  • Rational Software Architect

To extend your Eclipse environment, you add the designer plug-ins to your Eclipse instance.

Note:
If you install Rule Designer in an Eclipse environment that uses a non-English locale:
  • The Eclipse messages remain in that language.
  • If Rule Designer provides the verbalizer for the language, you can create rule artifacts in this language. If there is no verbalizer for this language, the rule artifacts that you create are in English.
  • Rule Designer messages are displayed in the non-English locale if it is supported. Otherwise, they are displayed in English.
  • To change the locale so that everything is in English, add the osgi.nl=en_US property to the <Eclipse_InstallDir>/configuration/config.ini file, and then restart Rule Designer.

Procedure

  1. In the configuration/config.ini file of your Eclipse installation, add the IBM_DS_HOME property to define the Decision Server installation directory, for example: IBM_DS_HOME=<InstallDir>/ODM811
    The installation directory contains the components for Decision Server such as executionserver and studio. You can copy this property from the configuration/config.ini file provided in the installation of Decision Server.
  2. Start Eclipse or a supported IBM® Eclipse-based product.
  3. Switch to the Java perspective (click Window > Open Perspective > Java).
  4. Click Help > Install New Software.
  5. Add the sites to install:
    1. In the Install wizard, next to the Work with field, click Add.
    2. In the Add Repository dialog, click Archive.
    3. Browse to the <InstallDir>/studio/update-sites directory, click Open, and select rule-designer-update-site.zip.
    4. In the Name field, enter a name for the site, and then click OK. This might take a few seconds.
  6. In the Work with field, select All Available Sites from the list.
  7. Expand the Business rules and events category, and select IBM Decision Server Rule Designer.
  8. Click Next. Eclipse calculates the dependencies and requirements.
  9. In the Install dialog, click Next, select I accept the terms of the license agreement, and click Finish.

    The installation might take a few seconds to complete. If a security warning about the validity of the software opens, click OK to proceed with the installation.

  10. Click Restart Now if you are prompted to restart Eclipse.

What to do next

You can also install the following optional update sites the same way:
  • IBM Decision Server Rule Designer Samples:
    • rule-designer-samples-update-site.zip
  • IBM Decision Server COBOL management update sites:
    • cobol-importer-license-update-site.zip
    • cobol-importer-update-site.linux.zip (for installation on Linux®)
    • cobol-importer-update-site.win32.zip (for installation on Windows)
    • cobol-update-site.zip
Tip:

In Eclipse, you can see what is installed by clicking Help > Install New Software > What is already installed?.