...
- clone the mifos head repository, as per Mifos Version Control Guide
- On the very first use of the new workspace (only), you'll need to do an
mvn install
in the (new) mifos-reporting-libs Maven module, either via mvn CLI in thereporting-libs
directory or in mifos-report-libs project in Eclipse launch the mvn install launch configuration, to get the BIRT JARs which are not available on Maven central into your local Maven repo. - If you have any existing projects, switch to an entirely new, clean workspace using File -> Switch Workspace.
- in your Eclipse IDE, menu File > Import > Existing Projects into Workspace
- Select root directory, Browse to where your git tree is
- Select All projects - there should be (at the time of writing this) about 16 of them (correctly set-up Eclipse .project & .classpath for all of them are in Git)
- do NOT check Copy projects into workspace (it's off/unchecked by default already)
- optional: In order to separate this set of projects from other projects in the workspace, it is best to use Eclipse working sets. Do this if you didn't Switch to a brand-new Workspace (above).
- in the Eclipse Package Explorer view, click that little downwards face (options) arrow icon
- change the Top Level Elements from Projects to Working Sets
- use Configure Working Sets to add a New... one named e.g. "Mifos", and Add → the mifos-* projects to its Working set content
- or, drag & drop the 16 or so mifos-* projects into/under the Working Set (unless during the creating of the working set already)
- or, it's possible to already do this directly during the Import > Existing Projects into Workspace wizard
- in the Eclipse Package Explorer view, click that little downwards face (options) arrow icon
- optional: connect eGit by marking all projects, right-clicking, Team > Share Project, Git, highlight/mark/check all the projects lines (they'll all have "Repository" column to '../.git', that's correct), Finish.
- if there is anything in red, do an F5 refresh of all the mifos-* projects
- if there are any "this or that JAR not found" issues in red, try right-click Maven > Update Dependencies (must have M2Eclipse installed)
- NEVER use right-click Maven > Update Project Configuration (revert and go back to the one in Git if you do so by mistake) - this would break the workspace, see Workspace 2.0 Eclipse Maven Settings
- make sure there are no red build errors on all mifos-* projects anymore
- start-up the Mifos web application via the e.g. Mifos START 8080.launch Eclipse launch configuration in the mifos-server project by right-clicking Debug As... (Starting directly as debug makes hot code replacement work)
- Mifos web application is now available at e.g. http://localhost:8080/mifos/ (make sure you don't by mistake use or copy/paste http://0.0.0.0:8080/mifos, as printed in the start-up logs
INFO org.eclipse.jetty.util.log WebApp@25468780 at
http://0.0.0.0:8080/mifos
andINFO org.eclipse.jetty.util.log Started SocketConnector@0.0.0.0:8080
)
...