{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"OpenMRS SDK ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":"allows for rapid development of modules and the OpenMRS Platform code. It is an ever expanding project with a rich feature-set, outlined below. Operating System compatibility was also taken into account, allowing users to install the SDK and be up and running within a few minutes on Windows, Linux and Mac OS X.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"3"},"exclude":{"value":"Overview"}},"macroMetadata":{"macroId":{"value":"e03e9365-d970-4a49-a509-ed9f677a4258"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"f941f0b7-7517-4887-a626-2cd7eb7c113f"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Release Notes","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.7.0 (released on 2017/01/20)","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"30"},"jqlQuery":{"value":"project = SDK AND fixVersion = 3.7.0 ORDER BY updated DESC, priority DESC, created ASC "},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"9a855294-c2a6-414f-af12-e49f117417a9"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}},"localId":"17285bd3-a93e-4428-b32c-3333b87f4796"}},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.6.0","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"30"},"jqlQuery":{"value":"project = SDK AND fixVersion = 3.6.0 ORDER BY updated DESC, priority DESC, created ASC "},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"459547db-fb38-4895-8ff0-912c2a62a13e"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}},"localId":"95151f19-73f9-4e73-b064-cf77ab574cc8"}},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.5.0 (released on 2016/11/29)","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"30"},"jqlQuery":{"value":"project = SDK AND fixVersion = 3.5.0 ORDER BY updated DESC, priority DESC, created ASC "},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"e21f6c5e-72af-44eb-8744-3d4e9f7b8234"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}},"localId":"e277b302-c405-4a2e-87b0-55462353973a"}},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.4.0 (released on 2016/10/12)","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"30"},"jqlQuery":{"value":"project = SDK AND fixVersion = 3.4.0 ORDER BY updated DESC, priority DESC, created ASC "},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"85954a2d-02ec-4295-bfa4-180b74dcd9c5"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}},"localId":"c1cbd555-b2d3-49dd-963d-15aa95655c2c"}},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.3.0 (released on 2016/09/05)","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"30"},"jqlQuery":{"value":"project = SDK AND fixVersion = 3.3.0 ORDER BY updated DESC, priority DESC, created ASC "},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"5e82c564-e540-4dde-889b-07c9f5b2ac2e"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}},"localId":"f5949a59-9910-4497-9da8-78c7949e1b8e"}},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.2.0 (released on 2016/08/18)","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"OpenMRS JIRAkey,summary,type,assignee,reporter,priority,status,resolution30project = SDK AND fixVersion = 3.2.0 ORDER BY updated DESC, priority DESC, created ASC 45c5771b-fa4b-3e43-b34a-c19dc45ccc95","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"30"},"jqlQuery":{"value":"project = SDK AND fixVersion = 3.2.0 ORDER BY updated DESC, priority DESC, created ASC "},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"c3c7deec-8636-42b8-987d-670db6aaf949"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}}}}],"version":1}}}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.1 (released on 2016/08/03)","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"30"},"jqlQuery":{"value":"key in (SDK-120,SDK-122,SDK-121,SDK-116,SDK-103,SDK-113,SDK-109,SDK-104,SDK-102,SDK-111,SDK-114,SDK-115,SDK-101,SDK-108,SDK-112,SDK-105)"},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"58b0c859-97f2-4f67-b65e-2929e4bfd753"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}},"localId":"93c3ccba-80bf-4608-b434-15d9b9e059b5"}},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3.0 (released on 2016/07/13)","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"20"},"jqlQuery":{"value":"project = SDK AND fixVersion = 3.0 ORDER BY updated DESC, priority DESC, created ASC "},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"7e45b1b7-5a03-447c-a86f-5e6d986b7fe6"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}},"localId":"dcf9510e-4002-4ea1-bf45-c79e9acb5c0a"}},{"type":"extension","attrs":{"layout":"full-width","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS JIRA"},"columns":{"value":"key,summary,type,assignee,reporter,priority,status,resolution"},"maximumIssues":{"value":"30"},"jqlQuery":{"value":"project = SDK AND fixVersion = 3.2.0 ORDER BY updated DESC, priority DESC, created ASC "},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"}},"macroMetadata":{"macroId":{"value":"1411e19d-b73e-49e9-b10b-472196fe99a4"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/download/resources/confluence.extra.jira/jira-table.png"}}],"title":"Jira Legacy"}},"localId":"98d0a75b-6a44-4704-945e-4d344a32a2d3"}},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"all release notes...","type":"text","marks":[{"type":"link","attrs":{"href":"https://issues.openmrs.org/browse/SDK/?selectedTab=com.atlassian.jira.jira-projects-plugin:versions-panel"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Requirements","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"JDK 1.8","type":"text"}]},{"type":"paragraph","content":[{"text":"To make sure that you have JDK 1.8 installed properly, open up a console/terminal and enter:","type":"text"}]},{"type":"paragraph","content":[{"text":"on Windows:","type":"text"}]},{"type":"codeBlock","content":[{"text":"java -version","type":"text"}]},{"type":"paragraph","content":[{"text":"on Linux/Mac:","type":"text"}]},{"type":"codeBlock","content":[{"text":"javac -version","type":"text"}]},{"type":"paragraph","content":[{"text":"It should say:","type":"text"}]},{"type":"codeBlock","content":[{"text":"java version \"1.8.0_172\"\nJava(TM) SE Runtime Environment (build 1.8.0_172-b11)\nJava HotSpot(TM) 64-Bit Server VM (build 25.172-b11, mixed mode)","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not have similar output or the Java version does not start from 1.8, then you have to install JDK. Follow ","type":"text"},{"text":"Oracle's guide","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Maven 3.x","type":"text"}]},{"type":"paragraph","content":[{"text":"To make sure that you have Apache Maven 3.x installed, open up a console/terminal and enter:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn -v","type":"text"}]},{"type":"paragraph","content":[{"text":"You should see:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Apache Maven 3.5.3 (3383c37e1f9e9b3bc3df5050c29c8aff9f295297; 2018-02-24T22:49:05+03:00)\nMaven home: C:\\Users\\AppData\\Local\\Temp\\apache-maven-3.5.3\\bin\\..\nJava version: 1.8.0_172, vendor: Oracle Corporation\nJava home: C:\\Program Files\\Java\\jdk1.8.0_172\\jre\nDefault locale: en_US, platform encoding: Cp1252\nOS name: \"windows 7\", version: \"6.1\", arch: \"amd64\", family: \"windows\"","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not have similar output, you are missing the Maven, please go ahead and install it. Here are tutorials for ","type":"text"},{"text":"Windows","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.mkyong.com/maven/how-to-install-maven-in-windows/"}}]},{"text":", ","type":"text"},{"text":"Mac OSX","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.journaldev.com/2348/how-to-install-maven-on-mac-os-x-mavericks-10-9"}}]},{"text":", ","type":"text"},{"text":"Ubuntu","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.mkyong.com/maven/how-to-install-maven-in-ubuntu/"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Miscellaneous ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"installmiscellaneous"},"legacyAnchorId":{"value":"OpenMRSSDK-installmiscellaneous"}},"macroMetadata":{"macroId":{"value":"2079766a-21a3-43bc-b961-8af8a9ff4f0b"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"74912a2c-27bc-4b54-a09c-a97ddf065ac8"}}]},{"type":"paragraph","content":[{"text":"Although ","type":"text"},{"text":"Git","type":"text","marks":[{"type":"strong"}]},{"text":" is not necessary for OpenMRS SDK to work, we recommended you to install it as well. See ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/display/docs/Using+Git#UsingGit-InstallGitonyourcomputer"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"You will also want to make sure that your maven has enough memory available for building code, running tests and servers. Please set the ","type":"text"},{"text":"MAVEN_OPTS","type":"text","marks":[{"type":"strong"}]},{"text":" system property to \"","type":"text"},{"text":"-Xmx768m -XX:MaxPermSize=512m","type":"text","marks":[{"type":"strong"}]},{"text":"\". It depends on your OS on how you set it up. See ","type":"text"},{"text":"http://stackoverflow.com/a/2820738","type":"text","marks":[{"type":"link","attrs":{"href":"http://stackoverflow.com/a/2820738"}}]},{"text":" for Windows or ","type":"text"},{"text":"http://unix.stackexchange.com/a/117470","type":"text","marks":[{"type":"link","attrs":{"href":"http://unix.stackexchange.com/a/117470"}}]},{"text":" for Unix/Linux.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are using an IDE for calling openmrs-sdk commands, please make sure to configure VM arguments in run configurations accordingly.","type":"text"}]},{"type":"paragraph","content":[{"text":"You will also need ","type":"text"},{"text":"MySQL 5.7","type":"text","marks":[{"type":"strong"}]},{"text":" for development of most OpenMRS modules. Please follow ","type":"text"},{"text":"MySQL's guide","type":"text","marks":[{"type":"link","attrs":{"href":"https://dev.mysql.com/doc/refman/5.6/en/installing.html"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Once completed, let's move on to setting up the SDK.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"To setup the OpenMRS SDK you just need to open up a terminal/console and enter:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn org.openmrs.maven.plugins:openmrs-sdk-maven-plugin:setup-sdk","type":"text"}]},{"type":"paragraph","content":[{"text":"Once it is finished, you can make sure the OpenMRS SDK works by running the following command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:help","type":"text"}]},{"type":"paragraph","content":[{"text":"It should produce the following output:","type":"text"}]},{"type":"codeBlock","content":[{"text":"[INFO] Scanning for projects...\n[INFO]\n[INFO] ------------------< org.apache.maven:standalone-pom >-------------------\n[INFO] Building Maven Stub Project (No POM) 1\n[INFO] --------------------------------[ pom ]---------------------------------\n[INFO]\n[INFO] --- openmrs-sdk-maven-plugin:3.13.4:help (default-cli) @ standalone-pom -\n--\nOpenMRS SDK 3.13.4\n\nFor more info, see SDK documentation: https://wiki.openmrs.org/display/docs/OpenMRS+SDK","type":"text"}]},{"type":"paragraph","content":[{"text":"If that is the case, you have successfully installed the SDK.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upgrade","type":"text"}]},{"type":"paragraph","content":[{"text":"You can upgrade to the latest version of the OpenMRS SDK by running:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:setup-sdk -U","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Basic usage","type":"text"}]},{"type":"paragraph","content":[{"text":"Let's start from creating a server to run the OpenMRS platform or a distribution. ","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:setup","type":"text"}]},{"type":"paragraph","content":[{"text":"When asked specify server id, which you will later use to run your server. You can have as many servers as you want. Each server can run a different set of modules and use a different database.","type":"text"}]},{"type":"paragraph","content":[{"text":"Next type '1' to setup a distribution or '2' to setup the OpenMRS platform without any modules.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that for running a distribution you will most likely need to have ","type":"text"},{"text":"MySQL 5.7 installed","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/pages/resumedraft.action?draftId=25476136#OpenMRSSDK-installmiscellaneous"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Answer all remaining wizard questions, which may include selecting a version of platform or distribution, database connection details, JDK path.","type":"text"}]},{"type":"paragraph","content":[{"text":"Next let's create a module.","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:create-project","type":"text"}]},{"type":"paragraph","content":[{"text":"You will need to choose what type of module you want to create. It is either a platform module, which can be run on any server or OpenMRS Reference Application module, which needs to be run on a server with the OpenMRS Reference Application distribution installed.","type":"text"}]},{"type":"paragraph","content":[{"text":"A new directory named after the artifactId (","type":"text"},{"text":"basicexample","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"by default) will be created for you with all the initial code constituting any OpenMRS module.","type":"text"}]},{"type":"paragraph","content":[{"text":"Let's build, deploy and run the module on the server.","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd basicexample\nmvn clean install openmrs-sdk:run","type":"text"}]},{"type":"paragraph","content":[{"text":"You will be asked to choose the server id, which you want this new module to be deployed to. If you do not want to be asked for the server id each time you run the module, just use:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn clean install openmrs-sdk:run -DserverId=your_server_id","type":"text"}]},{"type":"paragraph","content":[{"text":"When running the server for the first time, you will see:","type":"text"}]},{"type":"codeBlock","content":[{"text":"WARN - OpenmrsUtil.getRuntimeProperties(2039) |2020-04-26 13:58:31,866| Unable to find a runtime properties file. Initial setup is needed. View the webapp to run the setup wizard.\nApr 26, 2020 1:58:31 PM org.apache.coyote.AbstractProtocol start\nINFO: Starting ProtocolHandler [\"http-bio-8080\"]","type":"text"}]},{"type":"paragraph","content":[{"text":"You need to go to ","type":"text"},{"text":"http://localhost:8080/openmrs/","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8080/openmrs/"}}]},{"text":" to complete the setup. You should see a page with the installation progress. Once done you will be redirected to the login page. Use ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"as the username and ","type":"text"},{"text":"Admin123","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"as the password.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Documentation","type":"text"}]},{"type":"paragraph","content":[{"text":"The OpenMRS SDK consists of a number of commands. In this section we will cover different use cases for them. By default all OpenMRS SDK commands work in a wizard mode that is, if there are any parameters required, but not provided, you will be asked for them.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Setting up servers","type":"text"}]},{"type":"paragraph","content":[{"text":"The openmrs-sdk:setup command allows you to easily create instances of servers running OpenMRS. You can have as many servers on your machine as you wish. They are stored in ~/openmrs (Linux/Mac) or %userprofile%\\openmrs (Windows).","type":"text"}]},{"type":"paragraph","content":[{"text":"The OpenMRS SDK supports setting up a server with a plain platform or any distribution.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Databases","type":"text"}]},{"type":"paragraph","content":[{"text":"Servers can be configured to use ","type":"text"},{"text":"H2","type":"text","marks":[{"type":"strong"}]},{"text":" or","type":"text"},{"text":" MySQL 5.7","type":"text","marks":[{"type":"strong"}]},{"text":" database. We also support databases running in a ","type":"text"},{"text":"docker container","type":"text","marks":[{"type":"strong"}]},{"text":". The H2 database is only supported by some modules. If you choose to install the Reference Application distribution, you must use the MySQL database.","type":"text"}]},{"type":"paragraph","content":[{"text":"The SDK comes with the ","type":"text"},{"text":"H2","type":"text","marks":[{"type":"strong"}]},{"text":" database so you do not have to install anything to use it. The ","type":"text"},{"text":"MySQL 5.7","type":"text","marks":[{"type":"strong"}]},{"text":" database needs to be installed prior to using it with the SDK. Please refer to ","type":"text"},{"text":"installation instructions","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/pages/resumedraft.action?draftId=25476136#OpenMRSSDK-installmiscellaneous"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"An H2 database is stored in a directory under ~/openmrs/server_id/database","type":"text"}]},{"type":"paragraph","content":[{"text":"A MySQL database with initial schema is created, if it does not exist when running setup. If you include @DBNAME@ in a dbUri, it will be replaced with \"your_server_id\".","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"db docker container","type":"text","marks":[{"type":"strong"}]},{"text":" support comes in two flavours. One is letting SDK create and manage a MySQL 5.7 docker container for you. The other is creating a DB docker container manually and specifying container Id, label or name and connection details when setting up a server. The db docker container will always be started (if not already running) before starting the OpenMRS server.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Distributions","type":"text"}]},{"type":"paragraph","content":[{"text":"The SDK supports setting up a server with a distribution. The OpenMRS distribution consists of a platform and a set of modules.","type":"text"}]},{"type":"paragraph","content":[{"text":"If your distribution is published as a maven artifact, you can make it work with SDK by simply adding ","type":"text"},{"text":"openmrs-distro.properties","type":"text","marks":[{"type":"strong"}]},{"text":" file under ","type":"text"},{"text":"src/main/resources","type":"text","marks":[{"type":"strong"}]},{"text":". That way others will be able to setup your distribution by simply typing ","type":"text"},{"text":"-Ddistro=package:artifactId:version","type":"text","marks":[{"type":"strong"}]},{"text":". To setup such a distribution it is not even required to clone its repository as Maven will fetch the given artifact from a remote repository.","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"here ","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openmrs/openmrs-distro-referenceapplication/blob/master/package/src/main/resources/openmrs-distro.properties"}}]},{"text":"how it is done for the Reference Application distribution.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not use maven to publish your distribution, you can also create ","type":"text"},{"text":"openmrs-distro.properties","type":"text","marks":[{"type":"strong"}]},{"text":" file. The openmrs-sdk:setup command will have to be run from a directory, which contains the file or with","type":"text"},{"text":" -Ddistro=path/to/openmrs-distro.properties","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"here ","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/rkorytkowski/openmrs-owa-conceptdictionary/blob/master/openmrs-distro.properties"}}]},{"text":"how it is done for the Concept Dictionary OWA server.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples are provided as batch commands whenever possible, which means parameters are specified explicitly and you should not be asked questions. If you skip the parameters, you should be able to achieve the same following wizard questions.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Setup OpenMRS Reference Application 2.10.0 on MySQL database","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:setup -DserverId=distro-2-10-0 -Ddistro=referenceapplication:2.10.0 -DdbUri=jdbc:mysql://localhost:3306/distro-2-10-0 -DdbUser=root -DdbPassword=Root123 -DjavaHome=\"C:\\Program Files\\Java\\jdk1.8.0_172\"","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Setup OpenMRS Platform 2.3.5 on H2 database","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:setup -DserverId=platform-2-3-0 -Dplatform=2.3.0 -DdbDriver=h2","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Which JDK would you like to use to run this server?:","type":"text"},{"type":"hardBreak"},{"text":"1) JAVA_HOME (currently: C:\\Program Files\\Java\\jdk1.8.0_172)","type":"text"},{"type":"hardBreak"},{"text":"2) Other...","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 1","type":"text"}]},{"type":"paragraph","content":[{"text":"The server will use JAVA_HOME system variable whenever starting up. It means that if the value is changed in the system, the server will start using the new value after restart.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Setup OpenMRS Platform 2.3.0-SNAPSHOT on MySQL database","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:setup -DserverId=platform-2-3-0 -Dplatform=2.3.0-SNAPSHOT -DdbDriver=mysql -DdbUri=jdbc:mysql://localhost:3306/@DBNAME@ -DdbUser=root -DdbPassword=Roo123","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Which JDK would you like to use to run this server?:","type":"text"},{"type":"hardBreak"},{"text":"1) JAVA_HOME (currently: C:\\Program Files\\Java\\jdk1.8.0_172\\jre)","type":"text"},{"type":"hardBreak"},{"text":"2) Other...","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 1","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Setup Concept Dictionary OWA distribution on H2 database","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"git clone https://github.com/rkorytkowski/openmrs-owa-conceptdictionary\ncd openmrs-owa-conceptdictionary\nmvn openmrs-sdk:setup -DserverId=conceptdictionary","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Setting up a new server...","type":"text"}]},{"type":"paragraph","content":[{"text":"You can setup the following servers:\n1) OpenMRS Concepts OWA server 1.0 from current directory\n2) Distribution\n3) Platform\nWhich one do you choose? [1/2/3]:","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"Answer: 1","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Would you like to use the h2 database (-DdbDriver) (note that some modules do not support it)? [Y/n]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: Y","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Which JDK would you like to use to run this server?:","type":"text"},{"type":"hardBreak"},{"text":"1) JAVA_HOME (currently: C:\\Program Files\\Java\\jdk1.8.0_172\\jre)","type":"text"},{"type":"hardBreak"},{"text":"2) Other...","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 1","type":"text"}]},{"type":"paragraph","content":[{"text":"Adding '-Drun' flag will make SDK run newly created server right after successful setup.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":5},"content":[{"text":"Setup new Server from a distribution that uses the SDK Docker for MySQL (non-interactive mode)","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:setup -DserverId=test -Ddistro=org.openmrs.module:mirebalais:1.3.0-SNAPSHOT -DbatchAnswers=\"8080,1044,MySQL 5.6 in SDK docker container (requires pre-installed Docker)\"","type":"text"}]},{"type":"paragraph","content":[{"text":"This will create a new server with id = \"test\", based on the distribution defined in the mirebalais module's openmrs-distro.properties file, providing answers to server port (8080), debug port (1044), and to use the SDK Docker container.","type":"text"}]},{"type":"paragraph","content":[{"text":"Deleting servers","type":"text"}]},{"type":"paragraph","content":[{"text":"You can delete a server by running:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:delete -DserverId=myserver","type":"text"}]},{"type":"paragraph","content":[{"text":"The command will delete the server as well as the database it used. If the command fails for some reason, you can delete the server manually by dropping ~/openmrs/mysever (Linux/Mac) or %userprofile%\\openmrs (Windows) directory.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating projects","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Creating OpenMRS module","type":"text"}]},{"type":"paragraph","content":[{"text":"To create an openmrs module project in the current directory, use the openmrs-sdk:create-project command. The newly created project has basic structure and configuration files generated from an archetype. It is ready to be built and installed on an OpenMRS instance right after creation.","type":"text"}]},{"type":"paragraph","content":[{"text":"There are three types of projects: ","type":"text"},{"text":"referenceapplication-module, content-package module","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"platform-module. ","type":"text","marks":[{"type":"strong"}]},{"text":"After you choose the module type, the SDK will run a wizard, where you will have to provide information about a module to create.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create a Content Package module","type":"text"}]},{"type":"paragraph","content":[{"text":"The command is in non-interactive mode and it initializes a basic OpenMRS content package project with specified details like module ID, name, version, and description, using the OpenMRS SDK Maven plugin.","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn org.openmrs.maven.plugins:openmrs-sdk-maven-plugin:5.16.0-SNAPSHOT:create-project -Dtype=content-package -DmoduleId=hiv -DmoduleName=Hiv -DgroupId=org.openmrs.content -Dversion=1.0.0-SNAPSHOT -Dcontentpackage=1.0.0 -DmoduleDescription=\"this is a basic content package template project\"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Creating OWA project","type":"text"}]},{"type":"paragraph","content":[{"text":"To create new OWA project run ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:create-project -Dtype=owa-project","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Creating Reference Application module","type":"text"}]},{"type":"paragraph","content":[{"text":"Creating a module has always the same workflow. The example shows how to create the Reference Application module.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"paragraph","content":[{"text":"In a directory where you want to have a directory with a project, run:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:create-project","type":"text"}]},{"type":"paragraph","content":[{"text":"The wizard will appear:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"What kind of project would you like to create?: ","type":"text"},{"type":"hardBreak"},{"text":"1) Platform module ","type":"text"},{"type":"hardBreak"},{"text":"2) Reference Application module ","type":"text"},{"type":"hardBreak"},{"text":"3) Open Web App ","type":"text"}]},{"type":"paragraph","content":[{"text":"4) Content Package","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2/3/4]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 2","type":"text"}]},{"type":"paragraph","content":[{"text":"Wizard asks for basic informations about your new module. Conventions and hints are displayed as well.","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Module id uniquely identifies your module in the OpenMRS world.","type":"text"},{"type":"hardBreak"},{"text":"It is advised to consult your module id on ","type":"text"},{"text":"https://talk.openmrs.org","type":"text","marks":[{"type":"link","attrs":{"href":"https://talk.openmrs.org/"}}]},{"text":" to eliminate possible collisions. ","type":"text"},{"type":"hardBreak"},{"text":"Module id must consists of lowercase letters, must start from a letter, can contain alphanumerics and dots,","type":"text"},{"type":"hardBreak"},{"text":"e.g. webservices.rest, metadatasharing, reporting, htmlformentry.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please specify 'module id': (default: 'basicexample'):","type":"text"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Module name is a user friendly name displayed to the user instead of the module id. ","type":"text"},{"type":"hardBreak"},{"text":"By convention it is a module id with spaces between words.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please specify 'module name': (default: 'Basic example'):","type":"text"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Describe Your module in a few sentences : ","type":"text"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"GroupId, artifactId and version combined together identify your module in the maven repository. ","type":"text"},{"type":"hardBreak"},{"text":"By convention OpenMRS modules use 'org.openmrs.module' as a groupId and the module id as an artifactId. ","type":"text"},{"type":"hardBreak"},{"text":"The version should follow maven versioning convention, which in short is: major.minor.maintenance(-SNAPSHOT).","type":"text"}]},{"type":"paragraph","content":[{"text":"Please specify groupId (default: 'org.openmrs.module', must follow java conventions for naming packages): :","type":"text"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Please specify 'artifactId' (all lowercase, must start from a letter, allowed a-z, 0-9): ","type":"text"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Please specify 'initial version': (default: '1.0.0-SNAPSHOT'): ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"paragraph","content":[{"text":"Process is finished with creating project in your current directory. It should be ready to be packaged with","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn clean install","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Creating OWA project","type":"text"}]},{"type":"paragraph","content":[{"text":"Run the command from any directory","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:create-project -Dtype=owa-project","type":"text"}]},{"type":"paragraph"},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Please specify a directory for OWA project (a relative or absolute path):","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: owaName","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":" ? What is your app name?","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Follow Yeoman configurator","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"If you don't have npm installed globally, run the below command from the OWA project directory","type":"text"},{"type":"hardBreak"},{"text":"Windows users:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"./npm.cmd install","type":"text"}]},{"type":"paragraph","content":[{"text":"Linux/Mac users:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"./npm install","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Deploying projects","type":"text"}]},{"type":"paragraph","content":[{"text":"The openmrs-sdk:deploy command allows you to deploy module, Open Web App, Distribution and Platform to your OpenMRS server. ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Deploying module","type":"text"}]},{"type":"paragraph","content":[{"text":"OpenMRS SDK supports deploying modules in two ways. Either by running the command from the directory that contains module or by passing module artifactId, groupId and version.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy OpenMRS Appui module from any directory","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:deploy -DserverId=serverId ","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"What would you like to deploy?:","type":"text"},{"type":"hardBreak"},{"text":"1) Module","type":"text"},{"type":"hardBreak"},{"text":"2) Open Web App","type":"text"},{"type":"hardBreak"},{"text":"3) Distribution","type":"text"},{"type":"hardBreak"},{"text":"4) Platform","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2/3/4]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 1","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Please specify 'groupId': (default: 'org.openmrs.module'): ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: org.openmrs.module","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Please specify 'artifactId':","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: appui","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"You can deploy the following versions of the module:","type":"text"}]},{"type":"paragraph","content":[{"text":"1) 1.13.0-SNAPSHOT","type":"text"}]},{"type":"paragraph","content":[{"text":"2) 1.12.0","type":"text"}]},{"type":"paragraph","content":[{"text":"3) 1.11.0","type":"text"}]},{"type":"paragraph","content":[{"text":"4) 1.10.0","type":"text"}]},{"type":"paragraph","content":[{"text":"5) 1.9.0","type":"text"}]},{"type":"paragraph","content":[{"text":"6) Other...","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2/3/4/5/6]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 1","type":"text"}]},{"type":"paragraph","content":[{"text":"If the module is installed you will be asked if you want to upgrade it","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Module is installed already. Do you want to upgrade it to version '1.6-SNAPSHOT'? [Y/n]: ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: y","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy OpenMRS Appui module from it's directory","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:deploy -DserverId=serverId","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Would you like to deploy appui 1.13.0-SNAPSHOT from the current directory? [Y/n]: ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: y","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy a module from it's directory (non-interactive mode)","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:deploy -DserverId=serverId -DbatchAnswers=y","type":"text"}]},{"type":"paragraph","content":[{"text":"This will perform the same operation as above, but will answer the question asked with \"y\" without being prompted.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Deploying OWA","type":"text"}]},{"type":"paragraph","content":[{"text":"This example will show how to install Concept Dictionary OWA.","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:deploy","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"You have the following servers::","type":"text"},{"type":"hardBreak"},{"text":"1) refapp","type":"text"},{"type":"hardBreak"},{"text":"2) platform-2-3-0","type":"text"},{"type":"hardBreak"},{"text":"3) test","type":"text"},{"type":"hardBreak"},{"text":"4) conceptdictionary","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2/3/4]: ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Select server you would like to use.","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"What would you like to deploy?:","type":"text"},{"type":"hardBreak"},{"text":"1) Module","type":"text"},{"type":"hardBreak"},{"text":"2) Open Web App","type":"text"},{"type":"hardBreak"},{"text":"3) Distribution","type":"text"},{"type":"hardBreak"},{"text":"4) Platform","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2/3/4]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 2","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Which OWA would you like to deploy?:","type":"text"},{"type":"hardBreak"},{"text":"1) ideliver.ui","type":"text"},{"type":"hardBreak"},{"text":"2) openmrs-owa-conceptdictionary","type":"text"},{"type":"hardBreak"},{"text":"3) openmrs-owa-cohortbuilder","type":"text"},{"type":"hardBreak"},{"text":"4) openmrs-owa-sysadmin","type":"text"},{"type":"hardBreak"},{"text":"5) openmrs-owa-addonmanager","type":"text"},{"type":"hardBreak"},{"text":"6) openmrs-owa-obsadmin","type":"text"},{"type":"hardBreak"},{"text":"7) openmrs-owa-orderentryui","type":"text"},{"type":"hardBreak"},{"text":"8) openmrs-owa-builtinreports","type":"text"},{"type":"hardBreak"},{"text":"9) openmrs-owa-labworkflow","type":"text"},{"type":"hardBreak"},{"text":"10) openmrs-owa-orderentry","type":"text"},{"type":"hardBreak"},{"text":"11) openmrs-owa-bahmni-appointments","type":"text"},{"type":"hardBreak"},{"text":"12) Other...","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2/3/4/5/6/7/8/9/10/11/12]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 1","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Which version would you like to deploy?:","type":"text"}]},{"type":"paragraph","content":[{"text":"1) 1.0.0","type":"text"}]},{"type":"paragraph","content":[{"text":"2) 1.0.0-beta.6","type":"text"}]},{"type":"paragraph","content":[{"text":"3) 1.0.0-beta.3","type":"text"}]},{"type":"paragraph","content":[{"text":"4) 1.0.0-beta.1","type":"text"}]},{"type":"paragraph","content":[{"text":"5) 1.0.0-beta","type":"text"}]},{"type":"paragraph","content":[{"text":"6) Other...","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: 1 to select latest version.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you don't have Open Web App Module on selected server, before deploying OWA, SDK will install its latest version.","type":"text"}]},{"type":"paragraph","content":[{"text":"If there is no default directory 'owa' on selected server, you will have either to confirm to create it, or pass absolute path to directory where you want to install OWAs.","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"There is no default directory 'owa' on server refapp, would you like to create it? (if not, you will be asked for path to custom directory) [Y/n]: y","type":"text"}]}]},{"type":"paragraph","content":[{"text":"It is recommended to agree by answering with Y.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Deploying Distribution ","type":"text"}]},{"type":"paragraph","content":[{"text":"You can upgrade your server's distribution version(to 2.1 and above) using the openmrs-sdk:deploy command. OpenMRS SDK supports ","type":"text"},{"text":"openmrs-distro-properties","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openmrs/openmrs-sdk/blob/master/maven-plugin/src/main/resources/openmrs-distro-2.3.1.properties"}}]},{"text":" files that contains all necessary information(modules, core version etc.). ","type":"text"},{"type":"hardBreak"},{"text":"The parameter responsible for distribution is -Ddistro. You can pass there:","type":"text"},{"type":"hardBreak"},{"text":"1) Artifact information e.g referenceapplication:2.10.0","type":"text"},{"type":"hardBreak"},{"text":"2) Path to openmrs-distro.properties file","type":"text"},{"type":"hardBreak"},{"text":"You can also run openmrs-sdk:deploy command from directory that contains openmrs-distro.properties file. ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy Reference Application 2.10.0 from any directory","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:deploy -DserverId=serverId -Ddistro=referenceapplication:2.10.0","type":"text"}]},{"type":"paragraph","content":[{"text":"You will see all updates and additions required to upgrade the distribution version","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph"}]},{"type":"paragraph","content":[{"text":"Answer: y","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy Reference Application 2.10.0 from directory with openmrs-distro.properties file","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:deploy -DserverId=serverId ","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Would you like to deploy serverID OpenMRS Concepts OWA server from the current directory? [Y/n]: ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: y","type":"text"}]},{"type":"paragraph","content":[{"text":"You will see all updates and additions required to upgrade the distribution version","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph"}]},{"type":"paragraph","content":[{"text":"Answer: y","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy Reference Application 2.10.0 with path to openmrs-distro.properties file","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:deploy -DserverId=serverId -Ddistro=/path/to/file","type":"text"}]},{"type":"paragraph","content":[{"text":"You will see all updates and additions required to upgrade the distribution version","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph"}]},{"type":"paragraph","content":[{"text":"Answer: y","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Deploying Platform ","type":"text"}]},{"type":"paragraph","content":[{"text":"Deploying platform replaces OpenMRS core on selected server. ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy 2.3.0 platform to selected server","type":"text"}]},{"type":"codeBlock","content":[{"text":"mvn openmrs-sdk:deploy -DserverId=serverId -Dplatform=2.3.0","type":"text"}]},{"type":"paragraph","content":[{"text":"If you will try to downgrade server's platform, you will be asked to confirm this action with prompt:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Note that downgrades are generally not supported by OpenMRS. Please consider setting up a new server with the given version instead. Are you sure you would like to downgrade? [Y/n]","type":"text"}]}]},{"type":"paragraph","content":[{"text":"You will see all updates and additions required to upgrade the platform version","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"The Reference Application 2.9.0 introduces the following changes:","type":"text"},{"type":"hardBreak"},{"text":"^ Updates openmrs-webapp 2.1.4 to 2.3.0","type":"text"},{"type":"hardBreak"},{"text":"^ Updates owa-omod 1.10.0 to 1.11.0","type":"text"},{"type":"hardBreak"},{"text":"^ Updates webservices.rest-omod 2.24.0 to 2.26.0","type":"text"},{"type":"hardBreak"},{"text":"^ Updates fhir-omod 1.18.0 to 1.19.0","type":"text"}]},{"type":"paragraph","content":[{"text":"Would you like to apply those changes to 'openmrs'? [Y/n]","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: y","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Building projects","type":"text"}]},{"type":"paragraph","content":[{"text":"With openmrs-sdk:build you can either build all server's watched projects or OWA project.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Building watched projects","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:build -DserverId=serverId ","type":"text"}]},{"type":"paragraph","content":[{"text":"All watched projects will be build in the correct order by creating temporary maven reactor project.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Build OWA project in working directory","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:build","type":"text"}]},{"type":"paragraph","content":[{"text":"You will see prompt message if there is OWA project found in working directory:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Would you like to apply those changes to 'server4'? [Y/n]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Answer: y","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Cloning and Forking OpenMRS module repository","type":"text"}]},{"type":"paragraph","content":[{"text":"You can clone any OpenMRS module repository by executing openmrs-sdk:clone command.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Cloning OpenMRS module repository","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:clone","type":"text"}]},{"type":"paragraph","content":[{"text":"You will be asked for artifactId of module You want to clone:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Please specify 'artifactId':","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Note: groupId is set to ","type":"text","marks":[{"type":"em"}]},{"text":"\"org.openmrs.module\"","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", but it can be changed by adding ","type":"text","marks":[{"type":"em"}]},{"text":"-DgroupId=","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" to","type":"text","marks":[{"type":"em"}]},{"text":" openmrs-sdk:clone","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" command.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Then You will be asked for GitHub credentials:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Please specify 'GitHub username':","type":"text"}]}]},{"type":"paragraph","content":[{"text":"and:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Please specify 'GitHub personal access token':","type":"text"}]}]},{"type":"paragraph","content":[{"text":"OpenMRS SDK will automatically clone repository to current directory, fork it to Your GitHub account and add upstream remote to git repository.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Watching projects","type":"text"}]},{"type":"paragraph","content":[{"text":"Note (Windows) : See the solution section of this ","type":"text"},{"text":"article","type":"text","marks":[{"type":"link","attrs":{"href":"https://community.perforce.com/s/article/3472"}}]},{"text":", for step by step instructions to grant Create Symbolic Links privileges to a user or group. (In the current version of the SDK, watch does not copy files. It creates a symbolic link in the distribution folder to the source folder. Older versions of Windows do not support symbolic links. For those that do, the user account running this command must have the Create Symbolic Links privilege. Generally, it can be added through the Local Security Policy snap-in by a user with Administration privileges. Review details about the ","type":"text"},{"text":"Create Symbolic Links","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/create-symbolic-links"}}]},{"text":" permission for more information.)","type":"text"}]},{"type":"paragraph","content":[{"text":"You can add a module as watched by the selected server executing the openmrs-sdk:watch command in module's project directory. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:watch -DserverId=myserver","type":"text"}]},{"type":"paragraph","content":[{"text":"UI changes (given UI Framework is used) in project's code will be automatically deployed to the running server.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also list watched modules for the given server typing:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:info -DserverId=myserverId","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want to stop watching a module:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:unwatch -DserverId=myserverId -DartifactId=mymodule","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Running and debugging servers","type":"text"}]},{"type":"paragraph","content":[{"text":"You can run any server with:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:run -DserverId=myserver","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not specify the serverId parameter, then you will be presented with a list of previously setup servers:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"You have the following servers::","type":"text"},{"type":"hardBreak"},{"text":"1) conceptdictionary","type":"text"},{"type":"hardBreak"},{"text":"2) platform-1-11-7","type":"text"},{"type":"hardBreak"},{"text":"3) platform-1-11-5","type":"text"}]},{"type":"paragraph","content":[{"text":"Which one do you choose? [1/2/3]:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"By default a server is started on port ","type":"text"},{"text":"8080","type":"text","marks":[{"type":"strong"}]},{"text":" so you should be able to access it opening up ","type":"text"},{"text":"http://localhost:8080/openmrs","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8080/openmrs"}}]},{"text":" in your browser. You can change the port by specifying ","type":"text"},{"text":"-Dport=8081","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Before running the server make sure that the classpath to your JDBC driver is properly configured. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The SDK runs OpenMRS on embedded ","type":"text"},{"text":"Tomcat 7.0.6","type":"text","marks":[{"type":"strong"}]},{"text":", which you do not have to install, because it is bundled with the SDK. By default it uses -Xmx768m and -XX:MaxPermSize=512m for memory settings. You can increase those settings by defining ","type":"text"},{"text":"MAVEN_OPTS=\"-Xmx768m -XX:MaxPermSize=512m\"","type":"text","marks":[{"type":"strong"}]},{"text":" in your system properties or in a run configuration in your IDE. If you specify lower values, they will be increased to the default values as they are required to run OpenMRS.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"If you execute the run command from a directory with a module or openmrs-core project, it will be automatically deployed before starting up the server. You can add the following run configuration to the IDE to build, deploy and run the project:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn clean install openmrs-sdk:run -DserverId=myserver","type":"text"}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Debugging","type":"text"}]},{"type":"paragraph","content":[{"text":"You have 2 ways of debugging a server. First is by connecting to a running server by using a remote debugger configuration in your IDE. To run the server in remote debugging mode use:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:run -DserverId=myserver -Ddebug","type":"text"}]},{"type":"paragraph","content":[{"text":"By default the server listens for remote debuggers on port ","type":"text"},{"text":"1044","type":"text","marks":[{"type":"strong"}]},{"text":". You can configure it to use a different port by setting ","type":"text"},{"text":"-Ddebug=1045","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Alternatively, you can debug a server by running it in a debug mode straight from your IDE. It depends on your IDE, how to do it, but usually you just create a debug configuration and as the run command specify:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:run -DserverId=myserver -Dfork=false","type":"text"}]},{"type":"paragraph","content":[{"text":"It is important to use ","type":"text"},{"text":"-Dfork=false","type":"text","marks":[{"type":"strong"}]},{"text":" to disable forking a new process for Tomcat as it is not possible to debug a forked process that way (the debugger stays connected to the Maven process and not the Tomcat process).","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Setting JDK","type":"text"}]},{"type":"paragraph","content":[{"text":"When setting up a server you are asked to select JDK. OpenMRS Platform 2.x requires JDK 1.8 whereas lower versions require JDK 1.7. The SDK prevents you from running a server using a wrong JDK. You should see the following message trying to do so:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"The JDK 1.7.0_51 is not compatible with OpenMRS Platform 2.0.0-beta. Please use JDK 1.8 to run this server.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are running in a forked mode, correct the java.home property in C:\\Users\\Rafal\\openmrs\\platform\\openmrs-server.properties","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Following the message please correct the java.home property in openmrs-server.properties by pointing to the correct JDK version.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Pulling changes from upstream","type":"text"}]},{"type":"paragraph","content":[{"text":"The openmrs-sdk:pull command can pull changes from upstream for all watched projects or for any project if executed in it's directory.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Pulling changes for all watched projects","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:pull -DserverId=serverId","type":"text"}]},{"type":"paragraph","content":[{"text":"This command will try to update your projects to the latest upstream master (upstream remote repository is the one in the project's pom.xml, if not preset then it will be created for you). If openmrs-core will be detected it will ask you for the upstream branch you want to pull changes from.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":" Pulling changes for any git project","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:pull","type":"text"}]},{"type":"paragraph","content":[{"text":"If you run this command from a directory that contains openmrs git project, it will be updated to upstream master or if openmrs-core will be detected it will ask you for the upstream branch you want to pull changes from. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating Pull Request","type":"text"}]},{"type":"paragraph","content":[{"text":"You can create or update pull request to any OpenMRS repository using command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:pr","type":"text"}]},{"type":"paragraph","content":[{"text":"Before, ensure that you don't have any uncommited changes in local repository, otherwise SDK will show proper message and abort process.","type":"text"}]},{"type":"paragraph","content":[{"text":"Valid pull request should address issue from ","type":"text"},{"text":"JIRA","type":"text","marks":[{"type":"link","attrs":{"href":"https://tickets.openmrs.org/browse/SDK"}}]},{"text":", so you will be asked to specify issue id:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"wide","width":100.0},"content":[{"type":"media","attrs":{"width":1280,"id":"1979bb51-c2f1-4164-81b2-9acf31551fd9","collection":"contentId-25476136","type":"file","height":609},"marks":[{"type":"link","attrs":{"href":"https://asciinema.org/a/9eejbbaf4lqir7jnfvq7ae32d"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating docker configuration for distribution","type":"text"}]},{"type":"paragraph","content":[{"text":"SDK offers convenient way to create docker configuration for distributions with command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:build-distro","type":"text"}]},{"type":"paragraph","content":[{"text":"If current directory contains openmrs-distro.properties file, SDK will use it to setup docker instance, similarly as setup command. If current directory is base directory of Maven project, SDK will build it, and look for openmrs-distro.properties file in created jar file. Trying to build distribution in project not containing openmrs-distro.properties file will fail. If neither of mentioned conditions are met, SDK will offer you to build one of latest OpenMRS Reference Application distributions from remote repository.","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"You can deploy the following versions of distribution:","type":"text"}]},{"type":"paragraph","content":[{"text":"1) Reference Application 2.11.0-SNAPSHOT","type":"text"}]},{"type":"paragraph","content":[{"text":"2) Reference Application 2.10.0","type":"text"}]},{"type":"paragraph","content":[{"text":"3) Reference Application 2.9.0","type":"text"}]},{"type":"paragraph","content":[{"text":"4) Reference Application 2.8.1","type":"text"}]},{"type":"paragraph","content":[{"text":"5) Reference Application 2.7.0","type":"text"}]},{"type":"paragraph","content":[{"text":"6) Other...","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Either way, you will be asked to specify directory for generated files:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Specify build directory for generated files (-Ddir, default: 'docker')","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Similar to openmrs-sdk:setup, you can point to openmrs-distro.properties file, by using the ","type":"text"},{"text":"-Ddistro","type":"text","marks":[{"type":"strong"}]},{"text":" property, as shown in the following command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn openmrs-sdk:build-distro -Ddistro=/path/to/openmrs-distro.properties","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"SDK will create ready to use configuration based on provided openmrs-distro.properties file. All you have to do is enter specified directory and run instance with:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"docker-compose up","type":"text"}]},{"type":"paragraph","content":[{"text":"And go to ","type":"text"},{"text":"http://localhost:8080/openmrs","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8080/openmrs"}}]},{"text":" in your browser. Naturally docker and docker-compose are required.","type":"text"}]},{"type":"paragraph","content":[{"text":"Created configuration consist of 2 containers: one for OpenMRS server deployed on Tomcat, another for MySQL 5.7. Besides, volume for database files is created. Database port is not exposed on host machine.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Updating openmrs distribution for docker config","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"To update distribution that has been originally setup by build-distro goal run the same command and specify when prompt folder name where current setup exists. SDK will update only war file, modules, sqldump and openmrs-distro.properties file. Make sure to run ","type":"text"},{"text":"docker-compose build","type":"text","marks":[{"type":"strong"}]},{"text":" before running the containers. All existing docker config files will remain the same.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Releasing new SDK Versions ","type":"text"}]},{"type":"paragraph","content":[{"text":"New SDK versions are released via Travis CI following the steps at ","type":"text"},{"text":"https://github.com/openmrs/openmrs-sdk#releasing","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openmrs/openmrs-sdk#releasing"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Feedback ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"feedback"},"legacyAnchorId":{"value":"OpenMRSSDK-feedback"}},"macroMetadata":{"macroId":{"value":"1ce23f35-d132-4105-b6f3-9b84d65601c0"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"e5e54971-4902-4e48-9d6a-eaee124a14e6"}}]},{"type":"paragraph","content":[{"text":"Please help us improve SDK. We kindly ask you to report any problems in ","type":"text"},{"text":"JIRA","type":"text","marks":[{"type":"link","attrs":{"href":"https://tickets.openmrs.org/browse/SDK"}}]},{"text":". Please include the output of openmrs-sdk:help in your problem description.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Acknowledgments","type":"text"}]},{"type":"paragraph","content":[{"text":"The project is currently maintained thanks to developers funded by ","type":"text"},{"text":"the SolDevelo company","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.soldevelo.com/"}}]},{"text":" and lead by ","type":"text"},{"type":"mention","attrs":{"id":"712020:87fa96db-f091-49e1-859a-5d0ed99abab4","text":"@Rafal Korytkowski"}},{"text":" (Regenstrief).","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"In 2016 SolDevelo developers ","type":"text"},{"type":"mention","attrs":{"id":"712020:19843a29-4e9f-49eb-b24d-b0e78251f32b","text":"@Adam Grzybkowski"}},{"text":", ","type":"text"},{"type":"mention","attrs":{"id":"712020:7d35a248-acca-4136-8861-732956aeffb2","text":"@Paweł Gutkowski"}},{"text":", ","type":"text"},{"type":"mention","attrs":{"id":"712020:f07f4505-a150-4c1f-9613-fbeda4ad88f7","text":"@Tomasz Marzeion"}},{"text":" lead by ","type":"text"},{"type":"mention","attrs":{"id":"712020:87fa96db-f091-49e1-859a-5d0ed99abab4","text":"@Rafal Korytkowski"}},{"text":" worked on OpenMRS 3.0.0 and OpenMRS 3.1.0 release.","type":"text"}]},{"type":"paragraph","content":[{"text":"In GSoC 2015 the OpenMRS SDK was reworked by Dmytro Trifonov mentored by ","type":"text"},{"type":"mention","attrs":{"id":"712020:87fa96db-f091-49e1-859a-5d0ed99abab4","text":"@Rafal Korytkowski"}},{"text":" to support OpenMRS Reference Application 2.x and provide better integration with IDEs by the mean of a maven plugin.","type":"text"}]},{"type":"paragraph","content":[{"text":"The SDK 1.x was developed by ","type":"text"},{"type":"mention","attrs":{"id":"712020:76e5c250-a32b-44e5-8a05-73128f0b7130","text":"@Chris Niesel"}},{"text":" mentored by ","type":"text"},{"type":"mention","attrs":{"id":"712020:87fa96db-f091-49e1-859a-5d0ed99abab4","text":"@Rafal Korytkowski"}},{"text":" as part of Google Summer of Code 2013 (GSoC 2013).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Resources","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph"},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repo: ","type":"text"},{"text":"https://github.com/openmrs/openmrs-sdk","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openmrs/openmrs-sdk"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JIRA: ","type":"text"},{"text":"https://tickets.openmrs.org/browse/SDK","type":"text","marks":[{"type":"link","attrs":{"href":"https://tickets.openmrs.org/browse/SDK"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GitHub: ","type":"text"},{"text":"https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token"}}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Found Bintray access configuration with username: username and API key: APIKEY","type":"text"}]},{"type":"paragraph","content":[{"text":"Would you like to use it?(if no, you will be asked for new credentials) [Y/n]:","type":"text"}]}],"version":1}

Browser not supported