License Terms

This program is part of the OpenLMIS logistics management information system platform software. Copyright © 2013, 2014, 2015 VillageReach, JSI, and ThoughtWorks.

This site contains code and related material necessary to implement a configuration of the OpenLMIS logistics management information system platform. See https://github.com/OpenLMIS/open-lmis/ for details of OpenLMIS.

This site contains free software: you can redistribute it and/or modify it under the terms of the appropriate license. As this site contains code developed by more than one organization and licensed under different terms you should refer to the license terms stated in each component for details.

The programs and documents on this site are distributed in the hope that they will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the applicable License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses.

System Requirements

• JDK 7
• Postgresql 9
• Git
• Gradle 2.3
  • For Linux users
    • Download the source binary directly from the gradle website.
    • Copy the downloaded folder to /usr/bin
    • Add the path to gradle bin folder to your /etc/profile file export PATH="$PATH:/usr/bin/gradle-2.3/bin"
  • For Mac users
    • Install HomeBrew
    • Run brew install gradle
• Node.js
  • For Linux users
    • Install Node.js as described here based on your Linux flavour.
  • For Mac users

    • Install Node.js directly or using homebrew using brew install nodejs

    • Those who install Node.js using Homebrew should export the following (or include in $HOME/.bash_profile or $HOME/.profile or $HOME/.bashrc or $HOME/.zshrc, depending on your shell.

      export NODE_PATH="/usr/local/bin/node"
      export PATH="/usr/local/share/npm/bin:$PATH"

• NPM dependencies (used for linting JS, LESS files, minifying JS files & running jasmine specs etc.)
  • Install Grunt command-line runner by running (after installing Node.js) > npm install -g grunt-cli
  • Install karma test runner with karma coverage by running > npm install -g karma karma-coverage
  • Install karma command line with: > npm install -g karma-cli
  • Install project-specific grunt dependencies by navigating to modules/openlmis-web from project root directory and run > npm install (one-time activity)
  • Grunt tasks available can be found in modules/openlmis-web/Gruntfile.js

Source code

1. Get the source code using git clone https://github.com/openlmis/open-lmis.git.
2. For now, all work should be pushed to the 2.0 branch, not master. After cloning, you can do git checkout 2.0 to get into the 2.0 branch.
3. Set up dependencies on submodules using

   > git submodule init
   > git submodule update

IntelliJ IDEA Setup

1. Run gradle idea to create the IntelliJ project files (may take some time downloading dependencies).
2. Open the open-lmis.ipr file (may take some time indexing files, first time only).
3. Install Lombok plugin according to the IntelliJ version.
4. To run individual tests in IntelliJ, configure your IntelliJ preferences to enable "annotation processing"

Jasmine Tests

1. To run jasmine tests headlessly: gradle karmaRun

Running App on embedded Jetty server

1. Clone the project repository using git.
2. Setup postgres user with password as configured in gradle.properties file.
3. You can use gradle clean setupdb setupExtensions seed build testseed run to start the app.
4. You can use gradle clean setupdb setupExtensions seed build to just run all of the tests.
5. There are bunch of gradle tasks that you can see by running gradle tasks:

• build is to build the app.
• setupdb is to recreate the database and schema.
• setupExtensions is to apply the database schema extensions added.
• seed is to seed in the reference data.
• testseed puts in some test data which can be used to browse through basic functionality in the system.
• run is to start the embedded jetty server.

Once the system is running, you can access the home page at http://localhost:9091/. You can log into the default instance with: user: Admin123, pass: Admin123

Code analysis

Analysis of Java and Javascript sources can be reported on and visualized using a SonarQube server and the included sonarRunner task.

1. Install and run the SonarQube server.
2. Configure the Sonar properties in gradle.properties to point to your Sonar server and database.
3. Build the project and run the analysis:

• Basic analysis: gradle build sonarRunner
• With coverage reports install the Sonar Cobertura plugin and run cobertura report before sonar analysis. e.g. gradle build cobertura sonarRunner

Server setup

See SonarQube.org for official documentation. For more information on how the OpenLMIS project configures SonarQube see the OpenLMIS sonar-configuration repository.

Issues

1. You may encounter a java.lang.OutOfMemoryError: PermGen space. This is a result of not enough memory for the Jetty JVM. One way to fix this is to export the following (or include in $HOME/.bash_profile or $HOME/.profile or $HOME/.bashrc or $HOME/.zshrc, depending on your shell).

   export JAVA_OPTS="-XX:MaxPermSize=512m"
   export JAVA_TOOL_OPTIONS="-Xmx1024m -XX:MaxPermSize=512m -Xms512m"

2. If a few integration tests fail, like this: org.openlmis.core.repository.mapper.FacilityMapperIT > shouldUpdateFacilityWithSuppliedModifiedTime FAILED java.lang.AssertionError at FacilityMapperIT.java:292 This can be caused by the timezone in postgresql.conf being different than your operating system timezone. To fix, stop the postgresql server, and edit the following line: timezone = 'US/Pacific' to match your current operating system timezone, then restart the postgresql server.

Tech Stack

• Java 1.7
• Gradle 2.3
• Postgres 9
• Spring
• Mybatis
• Angularjs
• Jasmine
• Node.js
• Grunt.js