Migrating the Text Analytics properties to InfoSphere BigInsights Version 2 (all releases) and moving existing AQL files

Procedure

  1. In the InfoSphere® BigInsights™ Eclipse environment, open the properties of your InfoSphere BigInsights project.
  2. Under BigInsights click Text Analytics > General, then click Migrate.

    After this step is done, the Text Analytics Version 1 (all releases) properties (that consist of the location of a main AQL file and the data path to search included AQL files, dictionaries and UDF JAR files) are migrated to modular Text Analytics properties. The modular Text Analytics properties consist of the location of source AQL modules, which is, by default, /textAnalytics/src in the root directory of the project, and the location of compiled Text Analytics modules (TAM) files, which are, by default, /textAnalytics/bin in the root directory of the project.

    However, the AQL code is not automatically moved from the previous location to the new in textAnalytics/src directory. You must do this operation manually.
    CAUTION:
    The migration of Text Analytics properties is irreversible. It is recommended that you back up your project.
  3. Move the AQL v1.x source into the textAnalytics/src folder within the migrated InfoSphere BigInsights project. By following the design that is established in Migrating Text Analytics extractors from AQL 1.x to modular AQL, create new AQL modules, create new AQL files within each module, or move existing AQL files to a module.
    • To create an AQL module, click New > BigInsights > Other > AQL Module.
    • To create an AQL file, click New > BigInsights > Other > AQL Script.
    • Move AQL source files into an existing module and fix any compilation errors. For example, you might be required to add a module statement at the beginning of each AQL file, and remove any include statements.
  4. Validate the migration by running regression tests and ensuring that the extraction results are the same before migration and after migration.