How to install the OpenIMIS?

Most of the information about how to install the OpenIMIS can be found here:
https://openimis.readthedocs.io/en/latest/

For the C1 project the most valuable will be the following components:

1. Database - used to store the OpenIMIS data.

   1. link to instruction: https://openimis.readthedocs.io/en/latest/database_sql_server_installation_guide.html

   2. link to Github repository: https://github.com/openimis/database_ms_sqlserver/releases/tag/v1.2.1

   3. Note: executing the dbo.SETUP-IMIS procedure is very important

2. Web application - is the main component of the openIMIS infrastructure. It is used to manage all openIMIS entities from any browser.

   1. link to instruction: https://openimis.readthedocs.io/en/latest/web_app_vb_installation_guide.html

   2. link to Github repository: https://github.com/openimis/web_app_vb

   3. Note: if you couldn't sign in please verify:

      1. connection string (from web.config) you can use the SQLCMD to verify if you can connect to the database: 

         SQLCMD -S [server address] -U [user login] -P [user password]

         
         
         

      2. verify if the database dbo.SETUP-IMIS procedure was executed correctly

3. Web services - used to manage all operation happening in the field.

   1. link to instruction: https://openimis.readthedocs.io/en/latest/web_service_vb_installation_guide.html

   2. link to Github repository: https://github.com/openimis/web_service_vb

   3. Note: If after installation on page http://localhost/Services/imisservices.asmx you got the information about error related to missing 'Microsoft.ReportViewer.' (where '' means specific value) dependency you can follow steps below:

      1. go to the IIS web app bin directory (For example C:\inetpub\wwwroot\openIMIS\bin)

      2. copy the following dll files: 

         Microsoft.ReportViewer.Common.dll Microsoft.ReportViewer.DataVisualization.dll Microsoft.ReportViewer.Design.dll Microsoft.ReportViewer.ProcessingObjectModel.dll Microsoft.ReportViewer.WebDesign.dll Microsoft.ReportViewer.WebForms.dll Microsoft.ReportViewer.WinForms.dll

         
         
         

      3. paste copied files to IIS web services bin directory (For example C:\inetpub\wwwroot\openIMIS.WS\bin)

      4. go to http://localhost/Services/imisservices.asmx and verify it works fine

Which IDE I should use?

The Visual Studio 2017 community edition can be used. 
Link to LICENSE TERMS: https://visualstudio.microsoft.com/license-terms/mlt553321/
Link to the download page: https://visualstudio.microsoft.com/downloads/

How to use the OpenIMIS Web Services?

The http://localhost/Services/imisservices.asmx page could be used.

Alternatively:
The SoapUI (https://www.soapui.org/) can be used as tool for sending SOAP requests. This software works on both Linux and Windows OSes.

How to upload the OpenIMIS WSDL to SoapUI?

1. Download the WSDL (Web Services Description Language

   1. go to http://localhost/Services/imisservices.asmx

   2. choose "Service Description"

   3. save the WSDL file (For instance: ctrl + s)

1. Download and open the SoapUI

2. Choose File -> New SOAP Project

3. Fill the form

   1. insert the project name

   2. choose previously saved WSDL file as initial WSDL

How to add genders to the OpenIMIS software?

In the restored database I haven't any genders I've added genders manually using below script: