Configuring DRMS Parameters in Oracle Utilities Grid Edge Distributed Energy Resources Management System
Configure the following DRMS parameters in Oracle Utilities Grid Edge Distributed Energy Resources Management System to establish the communication between Oracle Utilities Grid Edge Distributed Energy Resources Management System and Oracle Integration Cloud, as well as for controlling other parameters related to the integration.
DRMS Parameters
The DRMS parameters can be populated from:
• The Grid Edge DERMS Application > Tools Selection > DERMS Configuration Parameters User Interface (UI) or
• Using the SQL files to load the DRMS_Parameters table.
Oracle Integration Cloud (OIC) Endpoint URL
Oracle Utilities Grid Edge Distributed Energy Resources Management System invokes the endpoint URL to send outbound messages to Oracle Integration Cloud.
Attribute
Value
OIC_STATUS_ACK_URL
(Device Status Check Ack Flow)
https://hostname:port /ic/api/integration/v2/flows/oracleutilities/project/OUTL-BA-DACS_DERMS/OUTL-BA-DRMS_DACS_DEV_STAT_ACK/1.0/status-check-ack-to-dacs
OIC_RESERVE_DEVICE_URL
(Event Device Reservation Flow)
https://hostname:port /ic/api/integration/v2/flows/oracleutilities/project/OUTL-BA-DACS_DERMS/OUTL_BA_DRMS_DACS_EVT_DVCRESV/1.0/reserveDevice
OIC_ENROLL_URL
(Enrollment Request Flow)
https://hostname:port /ic/api/integration/v2/flows/oracleutilities/project/OUTL-BA-DACS_DERMS/OUTL-BA-DRMS_DACS_ENROLLRQ/1.0/enroll-to-dacs
OIC_ENROLL_ACK_URL
(Enroll Sync Ack Flow)
https://hostname:port /ic/api/integration/v2/ flows/oracleutilities/project/OUTL-BA- DACS_DERMS/OUTL-BA-DRMS_DACS_SYNC_ACK/1.0/sendEnrollAck
OIC_DEVICE_OUTCOME_DACS_URL
(Event Device Outcome Process Flow)
https://hostname:port /ic/api/integration/v2/flows/oracleutilities/project/OUTL-BA-DACS_DERMS/OUTL-BA-DRMS_DACS_EVT_OUTC_TRNFR/1.0/eventOutcome
OIC_STAGE_STATUS_CHANGE_URL
(Program Event Status Update Flow)
https://hostname:port /ic/api/integration/v2/flows/oracleutilities/project/OUTL-BA-DACS_DERMS/OUTL-BA-DRMS_DACS_PEVNT_STAT_UPD/1.0/statusUpdate
Oracle Integration Cloud (OIC) Security Credentials
Oracle Utilities Grid Edge Distributed Energy Resources Management System uses these credentials to connect to Oracle Integration Cloud.
Attribute
Value
Populate the following when using OAuth Client Credential to access OIC.
config.auth.token.url
URL for requesting OAuth token to be used for outgoing requests. If this parameter is not specified, then the basic http authentication will be used.
config.auth.token.scope
The scope value used when requesting OAuth token to be used for outgoing requests.
config.auth.token.user
Client ID
 
User for requesting OAuth token to be used for outgoing requests.
config.auth.token.pwd
Client Secret
 
Password for requesting OAuth token to be used for outgoing requests. This parameter should be encrypted. For testing, this can be plain text.
config.auth.timeout
OAuth communication timeout (seconds)
Populate the following when using Basic Authentication to access OIC.
OIC_USER
Define the OIC username.
OIC_Password
Define the OIC password.
DERMS Security Credentials to Receive REST Messages
Oracle Utilities Grid Edge Distributed Energy Resources Management System uses these credentials to receive REST messages.
Attribute
Value
NMS_URL
The NMS URL to receive REST Messages.
Populate the following when using OAuth to receive REST messages.
config.auth.jwk
Either URL for requesting token signing certificate from OAuth server or the certificate itself.
 
If this parameter is not specified, then incoming requests with bearer token authentication will be rejected with error 401 (Unauthorized). In production environments, it is recommended to configure the certificate itself instead of URL.
config.auth.allow.user
Username used for validating OAuth tokens in incoming requests. It should match the principal or (if principal not provided) subject in the received token.
config.auth.allow.scope
Scope value used for validating OAuth tokens in incoming requests. It should match one of the scope values in the received token.
Populate the following when using Basic Authentication receive REST Messages.
NMS_USER
NMS user. This can be encrypted using the WLS key.
NMS_PASS
NMS password. This can be encrypted using the WLS key.
Other Attributes Related to the Integration
Attribute
Value
DERMS_SITE
Site ID passed in the messages to OIC as drmsInstanceId.
MAX_FILE_RECORDS
Maximum number of records to write in a file for Event Device Reservation and Event Device Outcome.
 
Default value is 1000.
MAX_RETRIES
Set the value to the number of retries DERMS will perform upon receiving a technical fault or negative acknowledgment.
 
Note: The drms_outbound_messages database table holds the outbound messages to be resent when the ack status = 'FAIL' and the num_retries is less than the configured MAX_RETRIES value. If you want to resend a failed message that has already retried the maximum number of times, update the num_retries record back to 0. If you need to resend a successful message for any reason, also update the status to 'FAIL'.
OIC_NOTIFY_STAGE_
STATUSES
Stage Status updates to send to Digital Asset Cloud Service (DACS).
 
• Default statuses sent: SCHEDULED,CANCELED,IN_PROGRESS,COMPLETED
• Valid values: PLANNED,SCHEDULED, IN_PROGRESS, COMPLETED ,CANCELED,FORCED_CANCELED
USE_OUAI_REDUCTION_
FCAST
This flag determines if the OUAI-based reduction forecast has to be used.
 
Default: false