Editing Advanced Options in Project Configuration

Modify project deployment properties, project options, and instances in a project configuration file.

1. In the CCR Project Configuration editor, select the Advanced tab.
2. If no project deployment item exists, select Add.
3. Choose a project deployment type from the Project Deployment Details window. The options are:

   Type	Description
   Non-HA	Non-HA deployments create one project option item and one instance item as children under the project deployment item.
   HA	HA deployments create one project option item and two instance items as children under the project deployment item. HA provides for hot project failover between instances.

4. Options are shown in the main Project Deployment Node as Project Deployment Details. To add an option, check that option's box. Uncheck to remove an option.
   This table outlines the project options you can set using the Project Configuration view in ESP Studio or by editing the CCR file.

   Note: When you change options in a deployed project, use Studio or esp_cluster_admin to stop and remove the project from the node, then redeploy (add) the project.

   Project Option	Description
   Debug Level	Set a logging level for debugging the project, ranging from 0 to 7. The default level is 3. Each number represents the following: 0: LOG_EMERG - system is unusable 1: LOG_ALERT - action must be taken immediately 2: LOG_CRIT - critical conditions 3: LOG_ERR - error conditions 4: LOG_WARNING - warning conditions 5: LOG_NORMAL - normal but significant conditions 6: LOG_INFO - informational 7: LOG_DEBUG - debug level messages
   Performance Monitor Refresh Interval	Define performance monitor refresh interval within the project. This option specifies, in seconds, how often the set of performance records—one per stream and one per gateway connection—is obtained from the running Event Stream Processor. By default, performance monitor refresh interval is set to 5. Set this option to 0 to disable monitoring; this also optimizes performance.
   Java Classpath	Set the Java classpath. Value is a filepath to the classpath file.
   Java Max Heap	Set the max Java heap for the project. Default value is 256 megabytes.
   Bad Record File	To save bad records to a file, select the bad-record-file option for Project Type, and indicate the file name of an ESP project for Value Field. If a file name is not specified, bad records are discarded. Default file name is esp_bad_record_file.
   Utf8	Enable Utf8 functionality on the server. Default value is true, set to false to disable.
   Web Service Enabled	When this value is set to true, it enables project access to Web services so that Web services clients can connect to the ESP Web Services Provider. This connection allows access to project data and can be used to publish data to project streams and windows. Default value is false.
   Optimize	Suppresses redundant store updates. Default value is true, set to false to disable.
   On Error Discard Record	If set to true, the record being computed is discarded when a computation failure occurs. If set to false, any uncomputed columns are null-padded and record processing continues. The default value is true. Note: If the computation of a key column fails, the record will be discarded regardless of this option.
   On Error Log	If set to true, any computation errors that occur will be logged in the error message. The default value is true.
   Time Interval	Set the constant interval expression that specifies the maximum age of rows in a window, in seconds. Default value is set to 1.
   Precision	Set decimal display characteristics for number characters in the project. Default value is 6.
   Memory	Set memory usage limits for the project. Default is 0, meaning unlimited.
   Command Port	Set an explicit command port number if you need to expose the port outside the firewall. Otherwise, do not modify this value. If you set an explicit command port, ensure that port is available on all machines that can run the project. If the port is 0, the program selects an arbitrary port. To define a specific port, set a value between 1 and 65535. Default value is 0.
   SQL Port	Set an explicit SQL port number if you need to expose the port outside the firewall. Otherwise, do not modify this value. If you set an explicit SQL port, ensure that port is available on all machines that can run the project. If the port is 0, the program selects an arbitrary port. To define a specific port, set a value between 1 and 65535. Default value is 0.
   Gateway Port	Set an explicit gateway port number if you need to expose the port outside the firewall. Otherwise, do not modify this value. If you set an explicit gateway port, ensure that port is available on all machines that can run the project. If the port is 0, the program selects an arbitrary port. To define a specific port, set a value between 1 and 65535. Default value is 0.

5. To configure an option item, complete these fields:

   Option	Description
   Name	Select from the list of available options shown in the above table.
   Value	Enter a value for the property option.

   Note: To return options to their default settings, click Reset All.
6. To add an affinity under the instance item, right-click the instance item and select New > affinity. Complete these fields:

   Option	Description
   Name	Enter a name for the affinity item.
   Strength	Select a strength level.
   Type	Select a type. (for example, controller).
   Charge	Select a charge.

7. To remove items from the All Advanced Configurations list:
   • Select a project deployment item and click Remove.
   • Right-click an option or affinity item and select Delete.