Migrating solutions

You can migrate solutions you developed in a previous version of Decision Server Insights by opening the solutions in the new version of Insight Designer.

Before you begin

Install the new version of Decision Server Insights. For more information, see Installing Decision Server Advanced components.

About this task

When you install a new version of Decision Server Insights, it is important to be aware that each version is a complete installation with new shortcuts and a new distribution structure. Although you can have co-existing versions of Insight Designer on the same computer, this situation might result in class name clashes. Having several projects that access a shared file system cache is error prone. However in some cases it is necessary to keep an installation of a previous version during your migration to help you migrate the most up-to-date version of your projects.

If you update your installation you must still rebuild your solution.

Note: When you migrate your solution, Insight Server automatically uses the latest version of the rule engine. If you do not migrate your solution and deploy it to a new Insight Server, an earlier version of the rule engine is used. All previous versions of the rule engine are included in the run time for backward compatibility.

Procedure

  1. Open the new version of Insight Designer.
  2. Open the Decision Insight perspective (Window > Open Perspective > Other > Decision Insight).
  3. Open the Insight Designer workspace that contains the projects you want to migrate.
  4. If you have Java Interfaces projects, replace all of these projects with Java Model projects.
    1. Right-click your project and select Configure > Migrate Solution.
    2. In the Migrate Solution wizard, click Finish.
  5. If you have client projects, add the Decision Server Insights runtime JAR files as external libraries to the build path.
    1. Select your Java™ project and click Project > Properties on the workbench menu.
    2. In the Project Properties dialog, select the Java Build Path page in the navigator.
    3. On the Java Build Path page, click the Libraries tab.
    4. Click Add Library.
    5. In the JAR Selection dialog, select IBM ODM Library and click Next.
    6. Select the Insight Solution Gateway, Insight Solution Liberty Server, and Insight Solution TestDriver libraries and click OK.
    7. In Window > Preferences, expand Java and select Compiler to verify that the JDK compliance level of your project is set to 1.8. If it is not, change it to 1.8.
  6. Click Clean > Build All.