Versions Compared

Key

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

Clean up shrine.conf

shrine.conf is considerably more compact than in SHRINE 3.0.0. Take this opportunity to clean out the file in older installations. See the example file start with a fresh shrine.conf file available in shrine-setup/qep-and-adapter-shrine.conf as a starting point.

Add password.conf file 

Move shrine.keystore.password and shrine.hiveCredentials.password properties from shrine.conf to password.conf. The password.conf file should contain the following properties:

Code Block
languagebash
themeRDark
shrine.keystore.password = "<enter your password>"
shrine.hiveCredentials.password = "<enter your password>"

...

Update shrine.conf

  • Remove pmEndpoint.url and replace with pmEndpoint. Add pmEndpoint.urlPath property to shrine. urlPath only contains the path of the pmEndpoint urlconf only if different from default value of /i2b2/services/PMService/getServices/. This value will be appended to the i2b2BaseUrl. 
  • Remove ontEndpoint.url and replace with . Add ontEndpoint.urlPathurlPath property to shrine. urlPath only contains the path of the ontEndpoint urlconf only if different from default value of /i2b2/services/rest/OntologyService/. This value will be appended to the i2b2BaseUrl. 
  • Remove adapter.crcEndpoint.url. Add adapter.crcEndpoint.urlPath property to shrine.conf only if different from default value of /i2b2/services/QueryToolService/. This value will be appended to the i2b2BaseUrl. 
  • Remove breakdownResultOutputTypes.
  • Move shrine.messagequeue element to to shrine.hub.messagequeue.
  • Move i2b2BaseUrl and hubBaseUrl shrinehubBaseUrl into the main shrine{} block.

Updated shrine.conf

Code Block
languagebash
themeRDark
shrine {


  shrineHubBaseUrl = "https://shrine-hub.faraway.com:6443" //The shrine hub's URL as observed from this tomcat server
  i2b2BaseUrl = "http://i2b2.example.com:9090" //The local i2b2's URL as observed from this tomcat server
  i2b2Domain = "exampleDomain"
  i2b2ShrineProjectName = "SHRINE"


  nodeKey = "testNode" //node key to get information from the hub about this node.


  //shrineDatabaseType = "mysql" // "mysql" by default. It can be "sqlserver" "mysql" or "oracle"


  webclient {
   siteAdminEmail = "shrine-admin@example.com"
  }
  
  hiveCredentials {
    username = "demo"
    crcProjectId = "Demo"
  }//hiveCredentials


  keystore {
    privateKeyAlias = "shrine-node1"
    caCertAliases = ["shrine-ca"]
  }//keystore


  steward {
    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"
    }
  }//steward
}//shrine



(Optional) Require a specific project for users

To require users to be a member of a specific PM cell project. (Leave blank for current behavior.)

Code Block
languagexml
themeRDark
shrine.authenticate.pmProjectName = "ACT"

(Optional) Override default info logging level

...

Override with environmental override in /opt/shrine/tomcat/webapps/shrine-api/WEB-INF/classes/logback.xml. Below is an example of changing the logging level to debug:

Code Block
languagexml
themeRDark
<logger name="net.shrine" additivity="false" level="debug">
 <appender-ref ref="shrine"/>
</logger>