Anonymous user
OpenMRS resources: Difference between revisions
→New Beginner Tickets
imported>Chrishay7 |
imported>Hypotext |
||
(26 intermediate revisions by 2 users not shown) | |||
Line 10:
Here is a [https://photos-5.dropbox.com/t/1/AAAAYoZcyOdcpW-q2FdsrAjD6waykEdpsOAzY8zpJGRlPQ/12/110243113/png/1024x768/3/1416646800/0/2/Capture%20d%27%C3%A9cran%202014-11-21%2015.34.34.png/8UfRRfbN2rbiRiztoMIyZ7wCf_uKZbgKEZjfTov0TBE screenshot]! (please ignore the French)
= Relevant Links =
[http://en.flossmanuals.net/_booki/openmrs-developers-guide/openmrs-developers-guide.pdf Developer's Guide]▼
Here are all the relevant links for future use:▼
▲* [http://en.flossmanuals.net/_booki/openmrs-developers-guide/openmrs-developers-guide.pdf Developer's Guide]
* [https://drive.google.com/folderview?id=0B47JK2xjSdD0WC1KUWlPSUU2MXM&usp=sharing Google Drive with VMs] Just download OpenMRS.tar.gz▼
* [https://docs.google.com/presentation/d/1Wa3TqRJSJgXLOt_rehlGa6NK6uh_2oW8Y04xjagywPY/edit?usp=sharing Wintersession Presentation]▼
▲[https://drive.google.com/folderview?id=0B47JK2xjSdD0WC1KUWlPSUU2MXM&usp=sharing Google Drive with VMs] Just download OpenMRS.tar.gz
▲[https://docs.google.com/presentation/d/1Wa3TqRJSJgXLOt_rehlGa6NK6uh_2oW8Y04xjagywPY/edit?usp=sharing Wintersession Presentation]
▲Here are all the relevant links:
* [http://opensourceprinceton.wikidot.com/ OSAP wiki] (which has even MORE links!)
* [http://opensourceprinceton.wikidot.com/openmrs-getting-started Background OpenMRS reading] (more links to check out in your free time)
Line 53 ⟶ 27:
* [https://github.com/hypotext/OpenMRS-dev-setup/wiki/Setting-up-git,-plus-workflow-tutorial Git + workflow tutorial]
* [https://github.com/hypotext/OpenMRS-dev-setup/wiki/Running-the-OpenMRS-webapp-and-viewing-changes-in-code Running the webapp and viewing changes in code]
= Git setup =
See [https://github.com/hypotext/OpenMRS-dev-setup/wiki/Setting-up-git,-plus-workflow-tutorial here]. (Not necessary for Full Virtual Machine Setup)
= OpenMRS setup =
It's highly recommended you choose one of the VM based setups. If that's not possible (often because of memory constraints) or if you'd simply prefer to do the manual setup, follow the guide here: https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer and make sure to talk to
1) Partial Virtual Machine Setup▼
* This setup uses a virtual machine that has the full OpenMRS setup
* Pros: Quick and easy to do. You
* Cons: Might be sluggish if you don't have enough RAM.
* Requirements:
Installation: Download and install [https://www.virtualbox.org/wiki/Downloads VirtualBox]. Download the [https://drive.google.com/file/d/0B47JK2xjSdD0ckZPdnUwaFJXOG8/view?usp=sharing Virtual Machine] (the OpenMRS.tar.gz file). Then extract the folder from this link. Add the downloaded machine in VirtualBox (Machine->Add Machine and navigate to the OpenMRS.vbox file within the folder extracted from the VM link). Install the VirtualBox Extension Pack from the previous VirtualBox link. If working on the sample bug, click on snapshots in the top right of the VirtualBox window and restore the top snapshot. Then just run the machine and begin!
* This quick setup allows you to communicate with a virtual machine (VM) that has all OpenMRS related setup requirements already installed. You will be working in your machine and running/testing the code by using the command line to control the VM.
* Pros: Allows you to use your preferred text editor/work environment.
* Cons: Less intuitive of what's going on unless you are very comfortable with working from the command line.
* Requirements: 10GB of hard disk space and 3GB RAM. Requires you to install VirtualBox and Vagrant.
* Once VirtualBox and Vagrant are installed, follow the rest of the setup in the README here: https://github.com/cpschuster/OpenMRS-dev-setup/tree/express-setup . Issue this command to clone it to your machine:
Line 75 ⟶ 59:
before issuing "vagrant up".
▲2) Full Virtual Machine Setup
'''3) Manual Setup'''▼
▲* This setup uses a virtual machine that has the full OpenMRS setup fully configured for you. You will be using the virtual machine to both write code and to run/test it. Features snapshots of the VM that allow you to very quickly skip to various stages of this demo in case you get stuck. Simply install VirtualBox and copy over the VM's file from a provided flash drive. Then simply run the machine in VirtualBox and begin working.
▲* Pros: Quick and easy to do. You don't need to install anything on your machine (other than the VM) to work on the project.
▲* Requirements: 10GB hard disk space and 3GB RAM (preferably 4+GB). Requires you to install VirtualBox and to download/copy over the VM.
▲3) Manual Setup
* This setup fully configures your machine to be able to contribute to OpenMRS.
* Pros: Lowest hardware requirements.
* Cons: Slowest and most error prone setup (especially if you run Windows)
▲It's highly recommended you choose one of the VM based setups. If that's not possible or if you'd simply prefer to do the manual setup, follow the guide here: https://wiki.openmrs.org/display/docs/Getting+Started+as+a+Developer and make sure to talk to Nicole and Danni about this setup.
= Sample Bug Walkthrough =
Before
= General Workflow =
See [https://github.com/hypotext/OpenMRS-dev-setup/wiki/Setting-up-git,-plus-workflow-tutorial here].▼
git: version control system.
GitHub: visual interface for git. Lets you view repositories, pull requests (requests from other people to add original code), etc. online.
* First,
* Set up your remotes so you get new code and push your original code to the right places (setting an "origin" remote for your fork and an "upstream" remote for the official code base)
* Pull new changes from
* Make a new branch for the ticket you'd like to work on
* Make local changes on your machine to fix the bug/implement the feature
* Push to your "origin" remote
* When done, make a pull request on upstream, which will be reviewed. [https://github.com/openmrs/openmrs-core/pulls Current OpenMRS pull requests]
* Repeat
* Hopefully get your pull request merged into upstream! [https://github.com/openmrs/openmrs-core/pull/1160 Looks like this].
▲
= New Beginner Tickets =
If you're working on one of these, please tell Chris, Katherine, and/or Vibhaa (or edit the wiki and
▲* Pair programming is great!
▲If you're working on one of these, please edit the wiki and put your name next to it!
* [https://issues.openmrs.org/browse/TRUNK-3274 TRUNK-3274] Voided person addresses and names should be ignored by the short patient form validator
Line 123 ⟶ 98:
* [https://issues.openmrs.org/browse/TRUNK-4575 TRUNK-4575] TestData - Duration Unit not usable
* [https://issues.openmrs.org/browse/TRUNK-3746 TRUNK-3746] Error adding a ConvSet in a second form schema
* [https://issues.openmrs.org/browse/TRUNK-4473?filter=10068 TRUNK-4473] Form Resource (Long-Text) causes error with binary file upload
List of all intro tickets:
* https://tickets.openmrs.org/secure/IssueNavigator.jspa?mode=hide&requestId=10068
|