Configuring DRMS Parameters in Oracle Utilities Edge Distributed Energy Resources Management System
Configure the following DRMS parameters in Oracle Utilities Edge Distributed Energy Resources Management System to establish the communication between Oracle Utilities 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 Oracle Utilities Edge Distributed Energy Resources Management System 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 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
OIC_MODEL_EXPORT_URL
(SP Network Location Transfer Flow)
https://hostname:port/ic/api/integration/v2/
flows/oracleutilities/project/OUTL-BA-
DACS_DERMS/ OUTL-BA-DERMS_DACS_SPNWLOC_TRNFR/1.0/
spNetworkLocSync
Oracle Integration Cloud (OIC) Security Credentials
Oracle Utilities 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 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, Event Device Outcome and SP Network Location.
 
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
OIC_MODEL_EXPORT_SCHEDULE
Schedule for sending network model information to OIC web service.
 
Schedule is configured using unix-line cron expressions comprised of 5 required fields separated by white space.
 
The fields are as follows: minutes, hours,day-of-month, month,day-of-week
 
Example: ‘0 21 * * ?’ executes every day at 21:00
ASSET_MGR
The DER manager class.
 
Default: DACSMgr
 
Make sure this is set to DACS Mgr to send the outbound message out.