Web service installation guide¶
v1.2.0 and later
Prerequisites¶
In order to install openIMIS Web Services, you need first to install openIMIS Database and Web Application.
If not yet installed please follow the steps from the database and web application installation guides.
Copy openIMIS Web Services¶
Download and unzip the release from Github web_service_vb repository (https://github.com/openimis/web_service_vb/releases/latest) in a new folder (openIMIS.WS.X.Y.Z) under the IIS wwwroot (usually in C:\inetpub\wwwroot).
Configure openIMIS Web Services in IIS¶
In Internet Information Service (IIS) Manager, right click on the previous added IMIS site and select Add application. Fill in the form as follows:
- Alias: Services (mandatory for the mobile apps)
- Physical Path: The path of the Services Folder in the sources (usually C:\inetpub\wwwroot\openIMIS.WS.X.Y.Z)
Configure openIMIS Web services¶
Edit the web.config:
- Similarly, the Web services needs that the database connection string to be updated
- In the services source files (usually C:\inetpub\wwwroot\openIMIS.WS.X.Y.Z),
- locate the the file “web.config” and edit it accordingly. For example:
1 2 3 4 | <connectionStrings>
<remove name="CHF_CENTRALConnectionString" />
<add name="CHF_CENTRALConnectionString" connectionString="Data Source=[DatabaseIPAdress];Initial Catalog=IMIS;User ID=[ImisUserId];Password=[ImisUserPassword]" providerName="System.Data.SqlClient" />
</connectionStrings>
|
- -Important note-: the name attribute must remain “CHF_CENTRALConnectionString”