Setting up an electronic Lab in OSCAR

Owned by Marc Dumontier
Dec 21, 2016
1 min read



  1. Get hl7_file_management (git clone ssh://<username>@source.oscartools.org:29418/hl7_file_management)
  2. Update src/main/resource/LabProperties.properties
    1. incomingHL7dir1=<some real place the labs will but put..same for Completed/Error directories>
    2. keyLocation1 = <more on this later>
    3. oscarURL = <obvious, use something like https://localhost:8080/oscar_15>
  3. Login to OSCAR, go to administration panel, and under System Management, choose "Key Pair Generator"
    1. Click "Create New Key", choose 'oscar'  (it's case-sensitive) for the 2 fields, and generate the key.
    2. Go back to the  "Key Pair Generator" and choose "Create New Key" again
    3. The service name should be somewhat descritive, short, no spaces, etc. for example "GDML" or "LifeLabs"
    4. Lab Type should be the type of lab you are receiving. 
    5. When you click to generate the key would will download a keyPair.key file. Put this in keyLocation1 location as per 2.(b)
  4. I usually need to modify the keyPair.key file to not have linefeeds in the key
  5. build hl7_file_management using 'mvn package'. This basically installs the updated LabProperties.properties in the JAR
  6. deploy the updated JAR. cp ./target/IncomingHL7Management-1.0-SNAPSHOT.jar ./mule-1.3.3/lib/user/IncomingHL7Management-1.0-SNAPSHOT.jar
  7. set MULE_HOME=<hl7_file_management>/mule-1.3.3
  8. Startup mule <hl7_file_management>/mule-1.3.3/bin/mule
  9. Drop a file (with .hl7 extension) in the incoming dir, watch the log for any problems