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:
- Database - used to store the OpenIMIS data.
- link to instruction: https://openimis.readthedocs.io/en/latest/database_sql_server_installation_guide.html
- link to Github repository: https://github.com/openimis/database_ms_sqlserver/releases/tag/v1.2.1
- Note: executing the dbo.SETUP-IMIS procedure is very important
- Web application - is the main component of the openIMIS infrastructure. It is used to manage all openIMIS entities from any browser.
- link to instruction: https://openimis.readthedocs.io/en/latest/web_app_vb_installation_guide.html
- link to Github repository: https://github.com/openimis/web_app_vb
- Note: if you couldn't sign in please verify:
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]
- verify if the database dbo.SETUP-IMIS procedure was executed correctly
- Web services - used to manage all operation happening in the field.
- link to instruction: https://openimis.readthedocs.io/en/latest/web_service_vb_installation_guide.html
- link to Github repository: https://github.com/openimis/web_service_vb
- 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:
- go to the IIS web app bin directory (For example C:\inetpub\wwwroot\openIMIS\bin)
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
- paste copied files to IIS web services bin directory (For example C:\inetpub\wwwroot\openIMIS.WS\bin)
- 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?
- Download the WSDL (Web Services Description Language
- go to http://localhost/Services/imisservices.asmx
- choose "Service Description"
- save the WSDL file (For instance: ctrl + s)
- Download and open the SoapUI
- Choose File -> New SOAP Project
- Fill the form
- insert the project name
- 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:
USE [IMIS] GO INSERT INTO [dbo].[tblGender] ([Code] ,[Gender] ,[AltLanguage] ,[SortOrder]) VALUES ('F' ,'Feale' ,'' ,1) GO