Changes between Version 7 and Version 8 of OnyxDeployment

Timestamp:

01/04/11 21:57:26 (14 years ago)

Author:

jeff.lusted

Comment:

--

OnyxDeployment

@@ -1 +1 @@
 == Deploying an Onyx Questionnaire ==
 
-This details what is required to deploy our onyx questionnaire. The first few paragraphs outline some of the major prerequisites and some minor complications in deploying across development and production environments.
+This details what is required to deploy our onyx questionnaire. The first few paragraphs outline some of the major prerequisites and some minor complications in deploying across development and production environments.[[BR]]
+
+These notes are open for discussion or improvement.
 
 === The Onyx Questionnaire and the PMI Lookup ===
 Onyx uses a web service to access the Patient Master Index (the PMI). This web service is provided by the pmi-lookup. The Onyx questionnaire is currently installed alongside the pmi-lookup; ie: within the same instance of tomcat.[[BR]]
 
-This seems sensible as we have only one questionnaire at the moment, and we don't know what it would entail to run more than one questionnaire at the same time. These ideas will have to be worked out in time. For the moment, we are sticking to using one tomcat instance.
+This seems sensible as we have only one questionnaire at the moment, and we don't know what it would entail to run more than one questionnaire at the same time. These ideas will have to be worked out in time. For the moment, we are sticking to using one tomcat instance. This is almost certainly more secure as the Obiba interface for the web service is not encrypted at present.
 
 There is a development and a production version of the pmi-lookup. The production version uses an !SqlServer table function invocation in JDBC to retrieve demographic data. For testing Onyx in a situation where !SqlServer is not available, the development version uses a !MySql database.
@@ -26 +28 @@
 === Deploying PMI Lookup Production Version ===
 The version 1.0 artifact is located at http://mvn.briccs.org.uk/org/bru/briccs/briccs-pmi-lookup/production-1.0/briccs-pmi-lookup-production-1.0.war
+
+   1. Unzip war file into $BRICCS_WEBAPPS/briccs-pmi-lookup-production-1.0
+   1. Locate config file at $BRICCS_WEBAPPS/briccs-pmi-lookup-production-1.0/WEB-INF/classes/pmi-lookup-config.properties
+   1. Edit the config file for database, user and password. There are appropriate templates in the config file.
+   1. Locate and edit log4j properties file at $BRICCS_WEBAPPS/briccs-pmi-lookup-production-1.0/WEB-INF/classes/log4j.properties
+   1. Place a context file for deployment within the tomcat tree: $CATALINA_HOME/webapps/patient-lookup.xml
+   1. Deploy within tomcat using manager commands of some sort.