Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Configuration properties involved:

coar-notify.enabled = true|false

show/hide the COAR Notify logo in the footer linked to the informative page;  used also in the authorization feature at java class org.dspace.app.rest.authorization.impl.CoarNotifyEnabled 

ldn.enabled = true|false

true => message is received and managed
false => message is refuced and the server respond with an HTTP 404

ldn.notify.inbox = DSpace\url\address\

where the ldn inbox rest service is mapped. IE: ${dspace.server.url}/ldn/inbox

coar-notify.ip-range.enabled = true|false

enables the filter on the IP of the sender (external) for received ldn message (into the DSpace ldn inbox)

Relation with the Quality Assurance Correction Service

...

LDN incoming messages are stored into the ldn_message database table. The incoming LDN messages is stored into a logical queue. The queue_status column of the table contains the status of the LDN message inside the queue. All the possible queue_status values are described into the java class org.dspace.app.ldn.LDNMessageEntity as integer constants.

QUEUE_STATUS_UNTRUSTED_IP

QUEUE_STATUS_UNTRUSTED

the message must not be enrouted
QUEUE_STATUS_QUEUEDthe message needs to be evaluated by the Extractor
QUEUE_STATUS_PROCESSINGthe message is currently being evaluated by the extractor
QUEUE_STATUS_PROCESSEDthe message has been already evaluated
QUEUE_STATUS_FAILEDthe message has been evaluated but its routing has failed


If valued as queued the LDN message will be processed. 

LDN Message logical queue is managed by:

  • The LDN Message Extractor is an asynchronous DSpace task that reads the oldest manageable LDN message and

...

  • enroute it to

...

  • the LDN Router; the extractor instance ends as soon as the LDN message extracted is routed and processed or failed

...

  • . For each tentative the attempts counter of the message is increased by 1 and the timeout is increased by X minutes, where X= the value of the configuration property ldn.processor.queue.msg.timeout | defaulted to 60.
  • The LDN Message Timeout Checker  is an asynchronous DSpace task that looks for timed-out messages with attempts less than Y, where Y= the value of the configuration property ldn.processor.max.attempts.

Please consider that this means that the corresponding QAEvent is not automatically created! The corresponding QAEvent is created by the processor instance of the LDN message, invoked by the extractor.

...