Configuration Manager

The Configuration Manager provides a user interface to more easily configure a number of configuration files necessary to process AMI events. The Smart Grid Integration Framework uses several windows services to process AMI events. The Configuration Manager makes it easy to configure these services for use.

If the Configuration Manager is installed on the local machine, use the following link to view it: http://localhost/miner.configuration.web/default.aspx. If you're viewing the Configuration Manager across a network, replace "localhost" in the previous link with the name of the server that is hosting the Configuration Manager.

Service Name	Description
Smartgrid Event Processor	Filters AMI events using pipeline rules and adds them to an Oracle state data store.
Smartgrid Log Service	Records any errors and messages to the event log.
Smartgrid Post Event Processor	Queries the state data store for events. Filters out momentary and partial power events before sending the remaining events to Responder for processing.

The following tables list some of the configuration settings that may be set using the Configuration Manager. Those in the first table are required when setting up support for AMI events. The second table contains optional settings. If you choose not to set a value for an optional setting, a default value will be used.

The Configuration Manager uses the values provided to update settings for the Smart Grid services. The Services column indicates the Smart Grid service(s) impacted by the configuration setting. Should you find a need to modify a setting, any impacted services will need to be stopped and restarted.

The Configuration Manager stores all settings in a centralized database. If you modify settings, all Smart Grid users will be impacted. You can edit or delete any existing setting. You may also create a new setting.

Edit: Click the Edit button next to any setting to modify the XML. Once you've made changes, click Update to save them. Click Cancel to return to the list of configuration settings without saving changes.
Delete: Click Delete next to any setting you wish to remove. Note that this will impact how AMI events are processed and could prevent the Smart Grid services from functioning properly.
Add New: Click Add New Configuration to create a new setting or recreate a deleted setting. The Type value is provided in the descriptions below for each configuration setting or key.

Required Settings

Configuration Setting (Key) Description Services

Miner.Smartgrid.AmiDatastore.DbConnection.Password

Password used to connect to the table in which AMI events are stored before being sent to Responder for processing.

Event Processor, Post Event Processor

Miner.Smartgrid.AmiDatastore.DbConnection.Server

Oracle: This is the TNS name for the database that contains the GIS tables.

SQL: This is the name of the database containing the GIS tables.

Event Processor, Post Event Processor

Miner.Smartgrid.AmiDatastore.DbConnection.Type

Type of server that hosts the table in which AMI events are stored before being sent to Responder for processing.

Event Processor, Post Event Processor

Miner.Smartgrid.AmiDatastore.DbConnection.UserName

User name used to connect to the table in which AMI events are stored before being sent to Responder for processing.

Event Processor, Post Event Processor

Miner.SmartgridAmiGeodatabase.Database

This setting is necessary ONLY if you're using a SQLServer geodatabase. This is the name of the SQLServer database.

Event Processor, Post Event Processor

Miner.Smartgrid.AmiGeodatabase.Instance

This is the instance of the geodatabase.

Event Processor, Post Event Processor

Miner.Smartgrid.AmiGeodatabase.Password

Enter the password used to connect to the geodatabase.

Event Processor, Post Event Processor

Miner.Smartgrid.AmiGeodatabase.Server

Oracle: This is the TNS name for the database that contains the AMI tables.

SQL: This is the name of the database containing the AMI tables.

Event Processor, Post Event Processor

Miner.Smartgrid.AmiGeodatabase.UserId

Enter the user name used to connect to the geodatabase.

Event Processor, Post Event Processor

Miner.Smartgrid.AmiGeodatabase.Version

This is the default version in the geodatabase (e.g., sde.default, dbo.default).

Event Processor, Post Event Processor

Miner.Smartgrid.RxDbConnection.Password

Enter the password used to connect to the Responder schema.

Event Processor, Post Event Processor

Miner.Smartgrid.RxDbConnection.Server

Oracle: This is the TNS name for the database that contains the Responder tables.

SQL: This is the name of the database containing the Responder tables.

Event Processor, Post Event Processor

Miner.Smartgrid.RxDbConnection.Type

Type of server that hosts the table in which AMI events are stored before being sent to Responder for processing.

Event Processor, Post Event Processor

Miner.Smartgrid.RxDbConnection.Username

Enter the user name used to connect to the Responder schema.

Event Processor, Post Event Processor

Configuration Setting (Key)	Description	Services
Miner.Smartgrid.AmiDatastore.DbConnection.Password	Password used to connect to the table in which AMI events are stored before being sent to Responder for processing.	Event Processor, Post Event Processor
Miner.Smartgrid.AmiDatastore.DbConnection.Server	Oracle: This is the TNS name for the database that contains the GIS tables. SQL: This is the name of the database containing the GIS tables.	Event Processor, Post Event Processor
Miner.Smartgrid.AmiDatastore.DbConnection.Type	Type of server that hosts the table in which AMI events are stored before being sent to Responder for processing.	Event Processor, Post Event Processor
Miner.Smartgrid.AmiDatastore.DbConnection.UserName	User name used to connect to the table in which AMI events are stored before being sent to Responder for processing.	Event Processor, Post Event Processor
Miner.SmartgridAmiGeodatabase.Database	This setting is necessary ONLY if you're using a SQLServer geodatabase. This is the name of the SQLServer database.	Event Processor, Post Event Processor
Miner.Smartgrid.AmiGeodatabase.Instance	This is the instance of the geodatabase.	Event Processor, Post Event Processor
Miner.Smartgrid.AmiGeodatabase.Password	Enter the password used to connect to the geodatabase.	Event Processor, Post Event Processor
Miner.Smartgrid.AmiGeodatabase.Server	Oracle: This is the TNS name for the database that contains the AMI tables. SQL: This is the name of the database containing the AMI tables.	Event Processor, Post Event Processor
Miner.Smartgrid.AmiGeodatabase.UserId	Enter the user name used to connect to the geodatabase.	Event Processor, Post Event Processor
Miner.Smartgrid.AmiGeodatabase.Version	This is the default version in the geodatabase (e.g., sde.default, dbo.default).	Event Processor, Post Event Processor
Miner.Smartgrid.RxDbConnection.Password	Enter the password used to connect to the Responder schema.	Event Processor, Post Event Processor
Miner.Smartgrid.RxDbConnection.Server	Oracle: This is the TNS name for the database that contains the Responder tables. SQL: This is the name of the database containing the Responder tables.	Event Processor, Post Event Processor
Miner.Smartgrid.RxDbConnection.Type	Type of server that hosts the table in which AMI events are stored before being sent to Responder for processing.	Event Processor, Post Event Processor
Miner.Smartgrid.RxDbConnection.Username	Enter the user name used to connect to the Responder schema.	Event Processor, Post Event Processor

Optional Settings

Configuration Setting Description Services

Miner.Smartgrid.AMI.MomentaryFilterTimespan

Defines the maximum length of momentary outages. The default setting is 00:01:00 (hh:mm:ss).

Event Processor

Miner.Smartgrid.AmiEventQueue.DequeueTimeout

This is the amount of time the database waits before timing out when dequeuing from the event queue.

Event Processor

Miner.Smartgrid.AmiEventQueue.QueuePath

This is the path to the eventqueue (e.g., .\private$\smartgrid.eventqueue).

Event Processor

Miner.Smartgrid.EventProcessor.AmiEventPipeline

Sets the pipeline rules used to filter incoming AMI events before passing them to Responder for processing.

This configuration may be edited to comment out a specific pipeline rule if you wish to remove a level of filtering from incoming AMI events. It can be removed if you wish to remove all filtering.

The ChildName attribute must always contain the name of the pipeline rule the follows it. If this value is incorrect, the pipeline will not process events as expected.

Event Processor

Miner.Smartgrid.EventProcessor.Dispatcher.ApartmentState

Use this setting to indicate whether the Event Processor is using a multi-threaded or single-threaded apartment. Valid values: MTA (multi-threaded apartment) or STA (single-threaded apartment).

Event Processor

Miner.Smartgrid.EventProcessor.Dispatcher.Receiver.MaxQueueDepth

This setting determines the maximum queue depth allowed to build up for dispatcher before it will block posting of new messages as specified according to the TaskExecutionPolicies: ConstrainQueueDepthDiscardTasks, ConstrainQueueDepthThrottleExecution.

Event Processor

Miner.Smartgrid.EventProcessor.Dispatcher.Receiver.TaskExecutionPolicy

This setting indicates how tasks are processed. It is set to (2) by default and should not be changed unless it is to (0), in which case some MaxQueueDepth should be specified as well. Valid values:

Unconstrained (0): All tasks are queued with no constraints.

ConstrainQueueDepthTrhottleExecution (2): Queue enforces maximum depth (specified at queue creation) but does not discard any tasks. It forces the thread posting any tasks after the limit is reached to sleep until the queue depth falls below the limit.

Event Processor

Miner.Smartgrid.EventProcessor.Dispatcher.SchedulingRate

This is the scheduling rate which dispatcher threads will work or sleep as specified for TaskExecutionPolicies: ConstrainSchedulingRateDiscardTasks, ConstrainSchedulingRateThrottleExecution.

Event Processor

Miner.Smartgrid.EventProcessor.Dispatcher.ThreadCount

If the Event Processor is using a multi-threaded apartment, this setting indicates the number of threads. If Miner.Smartgrid.EventProcessor.Dispatcher.ApartmentState is set to STA, then this setting is ignored.

Set this to a value that optimizes your performance.

Event Processor

Miner.Smartgrid.EventService.EventMapping

Ties the event values (such as 3.23.74.85) with a friendly name "CommunicationRestored".

Event Processor

Miner.Smartgrid.PostEventProcessor.AmiEventPipeline

This configuration contains the pipeline rules used during post event processing. This configuration may be edited to comment out a specific pipeline rule if you wish to remove a specific action from the post event processing.

The ChildName attribute must always contain the name of the pipeline rule the follows it. If this value is incorrect, the pipeline will not process events as expected.

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.ApartmentState

Use this setting to indicate whether the Post Event Processor is using a multi-threaded or single-threaded apartment. Valid values: MTA (multi-threaded apartment) or STA (single-threaded apartment).

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.PollingInterval

This setting determines how often the PostEventDispatcher looks at the queue to determine if events are ready for processing.

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.Receiver.MaxQueueDepth

This setting determines the maximum queue depth allowed to build up for dispatcher before it will block posting of new messages as specified according to the TaskExecutionPolicies: ConstrainQueueDepthDiscardTasks, ConstrainQueueDepthThrottleExecution.

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.Receiver.TaskExecutionPolicy

This setting indicates how tasks are processed. It is set to (2) by default and should not be changed unless it is to (0), in which case some MaxQueueDepth should be specified as well. Valid values:

Unconstrained (0): All tasks are queued with no constraints.

ConstrainQueueDepthTrhottleExecution (2): Queue enforces maximum depth (specified at queue creation) but does not discard any tasks. It forces the thread posting any tasks after the limit is reached to sleep until the queue depth falls below the limit.

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.ReprocessRestoredCount

Determines the maximum number of times the PostEventDispatcher will attempt to process an event.

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.ReprocessRestoredTimespan

Determines the amount of time a restored event waits before it is processed by the PostEventDisptacher.

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.SchedulingRate

This is the scheduling rate which dispatcher threads will work or sleep as specified for TaskExecutionPolicies: ConstrainSchedulingRateDiscardTasks, ConstrainSchedulingRateThrottleExecution.

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.StewedTimespan

This setting determines the amount of time an event waits before it is processed. This time should never exceed the maximum time for a momentary.

Post Event Processor

Miner.Smartgrid.PostEventProcessor.Dispatcher.Threadcount

If the Post Event Processor is using a multi-threaded apartment, this setting indicates the number of threads. If Miner.Smartgrid.EventProcessor.Dispatcher.ApartmentState is set to STA, then this setting is ignored.

Set this to a value that optimizes your performance.

Post Event Processor

Configuration Setting	Description	Services
Miner.Smartgrid.AMI.MomentaryFilterTimespan	Defines the maximum length of momentary outages. The default setting is 00:01:00 (hh:mm:ss).	Event Processor
Miner.Smartgrid.AmiEventQueue.DequeueTimeout	This is the amount of time the database waits before timing out when dequeuing from the event queue.	Event Processor
Miner.Smartgrid.AmiEventQueue.QueuePath	This is the path to the eventqueue (e.g., .\private$\smartgrid.eventqueue).	Event Processor
Miner.Smartgrid.EventProcessor.AmiEventPipeline	Sets the pipeline rules used to filter incoming AMI events before passing them to Responder for processing. This configuration may be edited to comment out a specific pipeline rule if you wish to remove a level of filtering from incoming AMI events. It can be removed if you wish to remove all filtering. The ChildName attribute must always contain the name of the pipeline rule the follows it. If this value is incorrect, the pipeline will not process events as expected.	Event Processor
Miner.Smartgrid.EventProcessor.Dispatcher.ApartmentState	Use this setting to indicate whether the Event Processor is using a multi-threaded or single-threaded apartment. Valid values: MTA (multi-threaded apartment) or STA (single-threaded apartment).	Event Processor
Miner.Smartgrid.EventProcessor.Dispatcher.Receiver.MaxQueueDepth	This setting determines the maximum queue depth allowed to build up for dispatcher before it will block posting of new messages as specified according to the TaskExecutionPolicies: ConstrainQueueDepthDiscardTasks, ConstrainQueueDepthThrottleExecution.	Event Processor
Miner.Smartgrid.EventProcessor.Dispatcher.Receiver.TaskExecutionPolicy	This setting indicates how tasks are processed. It is set to (2) by default and should not be changed unless it is to (0), in which case some MaxQueueDepth should be specified as well. Valid values: Unconstrained (0): All tasks are queued with no constraints. ConstrainQueueDepthTrhottleExecution (2): Queue enforces maximum depth (specified at queue creation) but does not discard any tasks. It forces the thread posting any tasks after the limit is reached to sleep until the queue depth falls below the limit.	Event Processor
Miner.Smartgrid.EventProcessor.Dispatcher.SchedulingRate	This is the scheduling rate which dispatcher threads will work or sleep as specified for TaskExecutionPolicies: ConstrainSchedulingRateDiscardTasks, ConstrainSchedulingRateThrottleExecution.	Event Processor
Miner.Smartgrid.EventProcessor.Dispatcher.ThreadCount	If the Event Processor is using a multi-threaded apartment, this setting indicates the number of threads. If Miner.Smartgrid.EventProcessor.Dispatcher.ApartmentState is set to STA, then this setting is ignored. Set this to a value that optimizes your performance.	Event Processor
Miner.Smartgrid.EventService.EventMapping	Ties the event values (such as 3.23.74.85) with a friendly name "CommunicationRestored".	Event Processor
Miner.Smartgrid.PostEventProcessor.AmiEventPipeline	This configuration contains the pipeline rules used during post event processing. This configuration may be edited to comment out a specific pipeline rule if you wish to remove a specific action from the post event processing. The ChildName attribute must always contain the name of the pipeline rule the follows it. If this value is incorrect, the pipeline will not process events as expected.	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.ApartmentState	Use this setting to indicate whether the Post Event Processor is using a multi-threaded or single-threaded apartment. Valid values: MTA (multi-threaded apartment) or STA (single-threaded apartment).	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.PollingInterval	This setting determines how often the PostEventDispatcher looks at the queue to determine if events are ready for processing.	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.Receiver.MaxQueueDepth	This setting determines the maximum queue depth allowed to build up for dispatcher before it will block posting of new messages as specified according to the TaskExecutionPolicies: ConstrainQueueDepthDiscardTasks, ConstrainQueueDepthThrottleExecution.	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.Receiver.TaskExecutionPolicy	This setting indicates how tasks are processed. It is set to (2) by default and should not be changed unless it is to (0), in which case some MaxQueueDepth should be specified as well. Valid values: Unconstrained (0): All tasks are queued with no constraints. ConstrainQueueDepthTrhottleExecution (2): Queue enforces maximum depth (specified at queue creation) but does not discard any tasks. It forces the thread posting any tasks after the limit is reached to sleep until the queue depth falls below the limit.	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.ReprocessRestoredCount	Determines the maximum number of times the PostEventDispatcher will attempt to process an event.	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.ReprocessRestoredTimespan	Determines the amount of time a restored event waits before it is processed by the PostEventDisptacher.	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.SchedulingRate	This is the scheduling rate which dispatcher threads will work or sleep as specified for TaskExecutionPolicies: ConstrainSchedulingRateDiscardTasks, ConstrainSchedulingRateThrottleExecution.	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.StewedTimespan	This setting determines the amount of time an event waits before it is processed. This time should never exceed the maximum time for a momentary.	Post Event Processor
Miner.Smartgrid.PostEventProcessor.Dispatcher.Threadcount	If the Post Event Processor is using a multi-threaded apartment, this setting indicates the number of threads. If Miner.Smartgrid.EventProcessor.Dispatcher.ApartmentState is set to STA, then this setting is ignored. Set this to a value that optimizes your performance.	Post Event Processor