CouchDB Documents Module

From OpenEMR Project Wiki

Overview

This feature will be available in OpenEMR version 4.1.1.
This feature should only be used by users with technical proficiency. Using this feature will require devising your own backup solution for your patient documents (the OpenEMR backup mechanisms do NOT backup documents within the CouchDB database).

Installing CouchDB

Windows

Even though CouchDB is not officially supported in Windows, an unofficial version is available here:
  1. http://wiki.apache.org/couchdb/Installing_on_Windows
  2. https://github.com/downloads/dch/couchdb/setup-couchdb-1.1.1_js185_otp_R14B03+fix-win32-crypto.exe

Linux

Linux version is available here:
  1. http://couchdb.apache.org/downloads.html

Configuring OpenEMR to use CouchDB

  1. Install the Apache CouchDB. (see above)
  2. If installation is success, normally it will be available on port number 5984.
  3. It can be reached through the browser (http://localhost:5984).
  4. Basic administration utility will be available in http://localhost:5984/_utils.
  5. Initially it is running without username and password with all privileges. This can be reset by going to CouchDB\etc\couchdb\local.ini. In the lower side uncomment the ;admin = mysecretpassword . Put the desired password. On restarting the couchDB, this will take effect and also the password set will be hashed in the local.ini.
  6. Enable CouchDB from Administration->Globals->Documents->Document Storage Method.

Future Plans

This feature currently stores patient documents in CouchDB. Also plan to support storing of the following documents in CouchDB in the future:
  1. Generated X12 file
  2. Generated PDF file
  3. ERA file