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. Only use samples and updates for the version of Eclipse that is compatible with Rule Designer (see IBM Operational Decision Manager detailed system requirements).

About this task

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>/ODM900
    The installation directory contains the components for Decision Server such as executionserver and studio.
  2. Start Eclipse or a supported IBM® Eclipse-based product.
  3. Switch to the Java perspective (click Window > Open Perspective > Java).
  4. Open Window > Preferences > Install/Update > Available software sites.
  5. Disable all the sites except the following:
    • http://download.eclipse.org/release/2023.12
    • http://download.eclipse.org/release/4.30
  6. Click Add and enter the following location: 
    https://download.eclipse.org/tools/orbit/simrel/orbit-aggregation/release/4.30.0
  7. Click Apply > Close .
  8. 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.
  9. Expand the ODM Rule Studio Features category, and select IBM Decision Server Rule Designer.
  10. Click Next. Eclipse calculates the dependencies and requirements.
  11. In the Install dialog, click Next, select I accept the terms of the license agreements, and click Finish.

    The installation might take a few seconds to complete.

  12. In the Trust Artifacts dialog, select Unsigned and click Trust Selected.
  13. Click Restart Now when you are prompted to restart Eclipse. The restart might take 30 seconds to complete.

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.win32.zip (for installation on Windows)
    • cobol-importer-update-site.linux.zip (for installation on Linux®)
    • cobol-update-site.zip
    • pli-importer-update-site.win32.zip
    • pli-update.zip
    • rule-designer-samples-update-site.zip
    • rule-designer-update-site.zip
Tip:

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