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)

• ‘Facilities’ data : Story #121
• ‘Program supported by facilities’ data : Story # 152
• ‘Products’ data : Story # 122
• ‘Program’ to ‘Products’ mapping : Story #124
• ‘Supervisory Nodes’ data : Story #117
• ‘Requisition Group’ data : Story #117
• ‘Requisition Group members’ data : Story #117
• ‘Requisition Group supported programs and Schedule data’ : Story #117

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 | User Name || Rights |- |Hello || Hello1 |}

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