Versions Compared

Key

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

...

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 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 Shrine no longer uses broadcasterServiceEndpoint in shrine.conf . Delete that from shrine.conf to save confusion.

Add a Timezone Parameter to mysql URLs in /opt/shrine/tomcat/conf/context.xml (MariaDB only)

Inside /opt/shrine/tomcat/conf/context.xml, add a ?serverTimezone=UTC parameter to each mysql URL. (No change is needed if you are using a different brand of database.)password.conf. The password.conf file should contain the following properties:

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

Changes to shrine.conf

  • Remove pmEndpoint.url and replace with pmEndpoint.urlPath. urlPath only contains the path of the pmEndpoint url. This value will be appended to the i2b2BaseUrl. 
  • Remove ontEndpoint.url and replace with ontEndpoint.urlPath. urlPath only contains the path of the ontEndpoint url. This value will be appended to the i2b2BaseUrl.
  • Remove breakdownResultOutputTypes.
  • Move shrine.messagequeue element to to shrine.hub.messagequeue.
  • Move i2b2BaseUrl and hubBaseUrl into the main shrine{} block.

(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".
<Context>
    <WatchedResource>WEB-INF/web.xml</WatchedResource>
    <Resource name="jdbc/problemDB" auth="Container" type="javax.sql.DataSource"
              maxTotal="128" maxIdle="32" maxWaitMillis="10000"
              username="shrine" password="demouser" driverClassName="com.mysql.jdbc.Driver"
              url="jdbc:mysql://localhost:3306/shrine_query_history?serverTimezone=UTC"
              testOnBorrow="true" validationQuery="SELECT 1" />
...

Override default logging level from info to debug (Optional)

Override with environmental override in shrinein /appsopt/shrine-api-war/srctomcat/mainwebapps/resources/logback.xml, and shrine/commons/util/src/main/resources/shrine-api/WEB-INF/classes/logback.xml

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

Remove akka and permgen parameters from setenv.sh

With earlier versions of the JDK SHRINE needed a few arguments involving akka and permgen. Remove these. Set -Xmx to use all but one gigabyte of your system's memory. A typical SHRINE setenv.sh will look like:

Code Block
languagebash
themeRDark
# Set Tomcat options
export CATALINA_OPTS="$CATALINA_OPTS -server -Xms1024m -Xmx3072m -Duser.timezone=America/New_York"

Ensure that adapterMappingsFileName exists in shrine.conf

...

Code Block
languagejs
themeRDark
titleshrine.conf
shrine {
...  
  adapter {
...
    adapterMappingsFileName = "AdapterMappings.csv"
...
  }//adapter
...
}//shrine