Creating a New Impulse Emitter

Steps to create a new Emitter are:

1. Expand "Emitter" menu from under the ETL section and click "Emitter Home" (see figure 1 below)
2. Click "Create New Emitter" located at the top on the Emitter home page.
3. Fill out the form and provide 
   1. Emitter name: a user defined unique name
   2. Group name: Any name to group data coming from multiple devices or sources into a single emitter (in case of IoT). This is not being used in case on Impulse emitter and, therefore, any value will work here.
   3. Core: number of cluster cores used to run the emitter in parallel (leave default for Impulse)
   4. Memory per core: RAM size per core (leave default for Impulse)
   5. Storage type: Select Impulse from the dropdown options. This selection will open more fields relevant to Impulse based emitter.
4. Fill out the Impulse specific fields as described below:
   1. Sink URL: this is the host name of the Impulse DW master node. This URL will be privately shared for security reason
   2. Sink Port: Port number of the DW master node server. This will be shared privately.
   3. Table Name: Specify the table name you like to create in the Impulse DW. If this table exists, the emitted data will be appended in the DW. All table names are prefixed (automatically) with the username followed by a dot while indexing in the DW.
   4. Sink User: default '__none__' 
   5. Sink Password: Give DW authentication password (not used for a secured internal deployment within the same firewall as Momentum is deployed)
   6. Primary Partition Column: DW performs the best if this is a time or date or timestamp column. 
   7. Date Format: If the partition column is a date/time/timestamp based column, specify the date format. Any Joda-time date format can be specified. If the partition column is a non-date based column, leave this field as '__none__'
   8. Missing Datetime Placeholder: If the partition column is a datetime based column, specify the date that will replace any missing or null values. The datetime must be specified in the format YYYY-MM-DDThh:mm:ssZ format even though your partition column is not in that format. For non-datetime based partition column, leave it to its default value '__none__'
   9. Partition Granularity: This is an important field for datetime based partition column. Specify how your data will be partitioned to be stored in physical disk. Any of the following partition granularity can be specified all, none, second, minute, fifteen_minute, thirty_minute, hour, day, week, month, quarter and year
5. Save the Emitter form.

Figure 1: Showing Emitter Home and Emitter top menus

Editing An Existing Emitter

1. Expand Emitter menu from the left menu options --> click "Emitter Home" 
2. On the emitter home page, select (checkbox) the emitter you want to edit.
3. Click "Edit" located at the top on the emitter home page.
4. Edit the form fields as necessary and submit to save the changes.