Installing Rule Designer

As a rule developer, you work in Rule Designer to create a decision service. You define a XOM and set up a vocabulary to author and orchestrate the rules that implement your business logic. You must install Rule Designer into an existing Eclipse.

About this task

Rule Designer is installed from the Eclipse Marketplace into an existing instance of Eclipse 2024-12 External link opens a new window or tab. Use at least Eclipse Modeling Tool or Eclipse IDE for Enterprise Java™ and Web Developers.

Eclipse 2024-12 uses Java Development Kit (JDK) 21. You can download the JDK from IBM® Semeru Runtimes Downloads External link opens a new window or tab.

Note:
If you install Rule Designer in an Eclipse environment that does not use an English locale:
  • The Eclipse messages remain in the language of your Eclipse environment.
  • If Rule Designer provides the verbalizer for the language, you can create rule artifacts in this language. If a verbalizer for this language does not exist, the rule artifacts that you create are in English.
  • Rule Designer messages appear in the locale if it is supported. Otherwise, they appear 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. Start your instance of Eclipse.
  2. Open Window > Preferences > Install > Update > Available software sites.
  3. Disable all the sites except the following:
    • http://download.eclipse.org/releases/2024.12
    • http://download.eclipse.org/eclipse/updates/4.34
  4. Click Apply > Close.
  5. Click Help > Eclipse Marketplace.
  6. In the Find field, enter the text Operational Decision Manager and click Go.
  7. Locate the entry of IBM Operational Decision Manager for Developers v9.5.x - Rule Designer that matches the version to install, and then click Install.

    Eclipse calculates the dependencies and requirements.

  8. In the Install dialog, click Confirm.
  9. In the Review Licenses dialog, select I accept the terms of the license agreement, and then click Finish.

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

  10. During the installation, you are prompted with a Trusted Authorities dialog. Select https://raw.githubusercontent.com in Authoring / Update site section, and then click Trust Selected to continue.
  11. A Trust Artifacts dialog opens a few moments later. Click Select All, and then click Trust Selected to continue the installation. The installation might take a few seconds to complete.
  12. If you are prompted to restart Eclipse, click Yes. The restart might take 30 seconds to complete.
  13. If not displayed by default, switch to the Rule perspective (click Window > Open Perspective > Rule).
  14. Optional: If you have an existing project, import it into the Rule Designer (click File > Import > General > Existing Projects into Workspace) and copy them into the workspace.
  15. To be able to publish to Decision Center from an instance of the ODM for production Helm chart, you must either import the default security certificate or use a replacement. For more information, see Importing a security certificate in Rule Designer.

Results

Using this installation of Rule Designer, you can do the following activities:

  • Write a Java XOM that references XOM annotations and the decision engine API.
  • Run and debug decision operations.
  • Publish and synchronize rule projects from Rule Designer to Decision Center. To create the connection between the two in Rule Designer, add /decisioncenter to the Decision Center URL. For more information, see Storing and synchronizing rules External link opens a new window or tab.
Restriction: You cannot generate a Java client project to execute rulesets through the rule engine API or the Rule Execution Server API.