How To

Environment setup and Application Deployment

System Requirements

To run the application the following packages are required

1. Java (openjdk 1.7 or above)
2. Gradle
3. PostgreSQL version 9.x
4. Tomcat web server version 7 or above

Instructions

• Setup development boxes – https://github.com/OpenLMIS/open-lmis/blob/master/README.md
• Setup QA/UAT boxes – https://github.com/OpenLMIS/env-setup

System Set up Guide

1. Log in as the Admin User

   • (userID/password): Admin123/Admin123

2. Upload the following Reference Data (Sample upload files can be found on Upload WIKI, which can be modified to use)

• Upload ‘Facilities’ data
• Upload ‘Program supported by facilities’ data
• Upload ‘Products’ data
• Map ‘Program’ to ‘Products’ mapping
• Upload ‘Supervisory Nodes’ data
• Upload ‘Requisition Group’ data
• Upload ‘Requisition Group members’ data
• Upload ‘Requisition Group supported programs and Schedule data’

Admin Functionalities that can be performed

1. Template Configuration

   • Configure R&R Template #263

2. Manage Facility

   • Create Facility #129
   • Search Facility
   • Delete / Restore Facility #317

User Functionalities that can be performed

1. Log in as the User

   • (userID/password): User123/User123

2. Requisitions

   • Initiate R&R #78

Seed users and rights

storeincharge	Requisition View Create
facilityhead	Requisition View Authorize
medicalofficer	Requisition View Approve (Lower level hierarchy)
lmu	Requisition View Approve (Higher level hierarchy)
lmuincharge	Requisition Convert to Order View Orders

Cookbook Testing

1. Using chefspec (rspec based) tool for cookbook testing https://github.com/acrmp/chefspec .
2. Gemfile in env-setup has the gems loaded.
3. Run bundle install to install the gems.
4. unit_test rake task is defined in Rakefile.
5. Use bundle exec rake to test all cookbooks.
6. For individual cookbook spec testing use rspec chef/cookbooks//spec/*_spec.rb