IBM Streams 4.2

Running the script interactively

Interactive mode enables you to run the teda-create-project script without specifying any parameters, enabling you to create simple, default applications.

Procedure

  1. To start the script, run the following command:
    teda-create-project
  2. Proceed through the wizard, specifying values for your application, such as the application type (1 for ITE or 2 for Lookup Manager), ITE application variant, and application parameters.
  3. Set the following parameters:
    • APPLICATION_FOLDER: The name of the directory that contains your IBM Streams project, not the base path to the location in the file system. To use the default value (iteAppl for an ITE application or lookupmgr for a Lookup Manager application), press Enter. If you set up more than one job, specify a unique value for this parameter for each job.
    • APPLICATION_NAMESPACE: The root namespace of your job. For more information, see Application namespace. To use the default value (itejob.a), press Enter.
    • PROJECT_BASE: The absolute path to the folder that contains all the projects and their sources. This path points to the parent directory of the folder that is defined as your project folder in the APPLICATION_FOLDER parameter. You can use environment variables by adding the percent symbol (%) before and after the environment variable name. To use the default value ($HOME/teda_applications), press Enter.
  4. To view a summary of all the parameters and the values that you specified, press Enter.
  5. If you use a database in your custom composites, configure it as described in the com.ibm.streams.db toolkit.
  6. Determine whether you want to back up or remote the application folder that is identified in the APPLICATION_FOLDER parameter. The default value backs up the folder. To accept this default value, press Enter. The name of the backed up folder is changed to <APPLICATION_FOLDER>_<timestamp>. You are prompted to back up or remove this folder when the folder is found on the file system.

Results

The application is created in the /<home>/streamsadmin/teda_applications folder.

What to do next

  • After you create your application, you can stop the script here (by specifying no) or create another project (by specifying yes).
  • If you create additional jobs, common setting are stored so you do not need to enter these values again. Common parameter settings are PROJECT_BASE and global.applicationControlDirectory.
  • You can customize the applications by implementing your own source code in custom composites by using any text editor or the Streams Studio. If you want to use the Streams Studio, import the projects into your Eclipse workspace.