Page tree
Skip to end of metadata
Go to start of metadata

To configure the Data Steward, you must first make sure that you have created a user with Data Steward privileges. To create a Data Steward, please follow the instructions here:


Chapter 8.2 - Setting up the Data Steward user


Find the steward section in shrine.conf . This section governs how the data steward application behaves, including its ability to send audit emails to the Data Steward. Set valid email addresses in the 'From' and 'To' fields. Set the externalStewardBaseUrl to the URL your Data Steward should use for the data steward application. (The email contains a link to help her easily start the audits.)


shrine {
...
  steward {
    createTopicsMode = Approved //the default is Pending - the most secure - but most sites use Approved

    emailDataSteward {
      //provide the email address of the shrine node system admin, to handle bounces and invalid addresses
      from = "shrine-admin@example.com"
      //provide the email address of the shrine node system admin, to handle bounces and invalid addresses
      to = "shrine-steward@example.com"
      //provide the externally-reachable URL for the data steward
      externalStewardBaseUrl = "https://shrine.example.com:6443/shrine-api/shrine-steward"
    }
  } // end steward
...
}

If you wish to not send emails, you can simply switch sendAuditEmails = false in this section.


SHRINE by default assumes it can send mail via smtp on localhost port 25. However, if your tomcat server cannot easily send email you may need to add an email{} section inside of the shrine{} section in shrine.conf. SHRINE sends emails from postfix on port 25 by default, but uses javaxmail internally. Any valid javaxmail configuration values should work. Here is an example that uses AWS SES:

shrine {
...
  email {
    //add javax mail properties from https://www.tutorialspoint.com/javamail_api/javamail_api_smtp_servers.htm here
    javaxmail {
      mail {
        smtp {
          //for postfix on localhost
          //host = localhost
          //port = 25

          //for AWS SES - See http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-using-smtp-java.html
		  //comment out if you want to just use postfix over port 25
            host = email-smtp.us-east-1.amazonaws.com
            port = 25
            transport.protocol = smtps
            auth = true
            starttls.enable = true
            starttls.required = true
          }
        }
      }

      //Must be set for AWS SES. See http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-using-smtp-java.html
      authenticator {
          username = yourSESUsername
          password = yourSESPassword
      }
    }
  } //end email section
...
}