ccdaservice/README.md

   1 # Prepare
   2
   3 * Import to database, table background_services: ccdaservice/support/background_services.sql - Now included in database.sql and upgrade 5.0.1
   4 * If not already completed, you must install the CCM features using the Modules->Manage Modules click Unregistered tab.
   5 * The Carecoordination module setting for Mirth IP must be set to localhost. Menu item: Modules->Manage Modules click in Carecoordination Config, the settings tab.
   6 * Ignore any errors that do not throw you back to command prompt when using npm install as some libs need to be compiled and is verbose about it.
   7
   8 ## Ubuntu
   9
  10 - apt-get remove --purge nodejs npm // Ensures clean install and will allow chance to cleanup.
  11
  12 - curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
  13
  14 - sudo apt-get install -y nodejs
  15
  16 Navigate to: openemr/ccdaservice and run the following to install requires dependencies.
  17
  18 - sudo npm install libxmljs -g
  19
  20 - sudo npm link libxmljs
  21
  22 - sudo npm install --production
  23
  24 - sudo npm i node-linux // Not in use at moment - ssmanager handles service process.
  25
  26 * If the service is not installed in last step the ssmanager, started by backgroud services, will still start and maintain ccda service.
  27 * For portal this is not necessarily true.
  28
  29 ## Windows
  30
  31 * Download and install node v6.9.5 or 6.1 for your windows version.
  32 * Ensure system variable NODE_PATH is set i.e %USERPROFILE%\AppData\Roaming\npm\node_modules
  33
  34 ####  - Important to start Node.js cmd prompt as adminisrator.
  35
  36 Navigate to: openemr/ccdaservice and run the following:
  37
  38 - npm install libxmljs -g
  39
  40 - npm install node-windows -g
  41
  42 - npm link libxmljs
  43
  44 -npm link node-windows
  45
  46 - npm install --production
  47
  48 * The service will automatically be installed when OpenEMR is log into the first time and with both installs, ccda service is monitored by ssmanager started by background services.
  49
  50 ## Developing
  51 * Note that these scripts run in strict mode so javascript will hold you very much accountable with how objects and variables are handled.
  52 * Important to note that during developement error checking is relaxed, so after CCM sends xml, it waits to receive back document and if document generation errors for some reason either CCM waits till php timeout or you need to restart apache to clear that socket. 99% of the time this is not an issue however, currently CCM doesn't do any supervision on socket communication thus sends and waits. I hate timers but may be solution here.
  53 * For now node modules are run local to service directory so all support dependecies are installed there (except libxmljs & node-windows).
  54
  55 ## Tools
  56 * node winservice is service install/start both Windows and Ubuntu (not currently used in Ubuntu)
  57 * node unservice is service uninstall
  58
  59 ## License
  60                 Copyright 2017 sjpadgett@gmail.com
  61                 GNU GPL