Versions Compared

Key

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

...

...

...

...

...

...

...

...

...

...

...

...

...

...


This tutorial will introduce you to OpenMRS SDK (Software Development Kit). It assumes that you have basic understanding of OpenMRS modular architecture (you can learn about it by reading Technical Overview).

To get started, make sure that you have installed the latest version of OpenMRS SDK and Oracle JDK 8. You can find instruction how to do that instructions on OpenMRS SDK wiki pages.

...

If you want to enable remote debugging by default when running the server,
specify the port number here (e.g. 1044). Leave blank to disable debugging.
(Do not do this on a production server) (default: 'no debugging'): 

Type default value '1044' and push enter. Specifying debug port is essential to setup remote debugging configuration. You will be asked what database you want to use:

...

So you will always have module compiled from your sources on 'webservices-dev' server. At the end of the installation, you will get a prompt as below.


No Format
Would you like to deploy webservices.rest 2.29.0-SNAPSHOT from the current directory? [Y/n]:

Now it's time to create debugging configuration in IDE. The recommended way is to create remote debugging configuration on address 'localhost:1044' (1044 is debug port you specified during server creation). This way, you can run instance from command line:

...

To sum up, our openmrs-distro.properties file will look like this:

name= OWA development
version= 1.0
war.openmrs= 2.0.0
omod.owa=1.6.2
omod.webservices.rest=2.17-SNAPSHOT 

SDK automatically assumes that modules Maven Group ID is 'org.openmrs.module', but you can declare another Group ID

...