View source for Configure EventNotification Endpoint and Enterprise Service for CUI

EventNotification Endpoint is a middleware which is responsible for receiving incoming COMOS event notifications, queuing them internally and forwarding them to the {{UBIK}} Enterprise Service for further processing. 
This page describes how to setup the system.

= Overview =
* Make sure the [[HowTo:Install_UBIK_Enterprise_Service|Enterprise Service]] and the [[HowTo:Install_UBIK_Web_Service#UBIK.C2.AE_Authentication_Web_Service_USAM.svc|USAM]] are installed on the IIS Server.
* Install the Notification Endpoint Webservice on the IIS Server
* Configure all mandatory settings for the Notification Endpoint Webservice
* Configure the Notification Endpoint Webservice URL in COMOS and enable notifications


= Install Notification Endpoint =
* Download the Notification Endpoint Webservice from the release portal.
* Deploy the Notification Endpoint Webservice to the designated web app folder on the IIS Server (web app folder needs to be created if necessary)
** IIS Manager setting check: see [[Configure_EventNotification_Endpoint_and_Enterprise_Service_for_CUI#IIS_Manager|IIS Manager]]
* Make sure COMOS is configured to send notifications.


= IIS Manager=
* Add a new website under the "Sites" folder in IIS Manager.
* Connect the new site to the corresponding physical folder via the website's "basic settings". <br/> [[Image:WebsiteConfIIS.PNG|300px]]
* Configure a "Binding" for the website.<br/>[[Image:BindingIISConf.PNG|300px|right]]
** The URL can be used as a direct access target,
** or used as an internal target for URL redirection.


= Notification Endpoint=
Adapt “Your/EventNotificationEndpoint/Folder/Configuration/config.json” file, configure at least the mandatory settings:

*	"USAMUrl": 
*	"QueuePath": The folder contain all notifications, which will send to Enterprise Service for process, after processed by ES, the corresponding file will be deleted.
*	"InComingLogPath": All received COMOS notifications will be stored here 
*	"ProcessUrl": The URL, which represent Enterprise Service access point


= Enterprise Service=
* Go to UBIK.EnterpriseService folder,
* Check if CUI plugin installed,
**	Copy paste UBIK.Interface.CUI.dll to “Injection” folder.
* If Injection does not exist, create it.
** Open UBIK.EnterpriseService.exe.config:
* Find “appSettings” session, configure all necessary information, and add "ContentControllerConfigPath" to the end  :
<source lang = "xml">
        <appSettings>
		<!-- System.Diagnostics.ProcessWindowStyle: Normal = 0, Hidden = 1, Minimized = 2, Maximized = 3 -->
		<add key="ConsoleRunMode" value="1" />
		<!-- Nothing = 0, Mark = 1, Delete = 2 -->
		<add key="CommandFileAction" value="0" />
		<add key="ClearWatchFolders" value="0" />
		<!-- Path to json file. Pointing to EnterpriseServicePluginExecutionConfigHolder -->
		<add key="PluginExecutionConfigPath" value="" />
		<add key="ClientSettingsProvider.ServiceUri" value="" />
		<!--TEST IF ONLINE USING BROWSER  // GET http://localhost:9000/api/basicenterpriseservice/getuptimeinfo-->
                <!-- switch on WebInterface: 1, switch off WebInterface : 0 -->
		<add key="ExecuteWebInterface" value="1" />
		<add key="ExecuteTaskByJsonFile" value="0" />
                <!-- Notification Endpoint config ProcessUrl -->
		<add key="WebInterfacePort" value="9000" />
		<add key="WebInterfaceHost" value="http://localhost" />
                <!-- Add this to the ES config file -->
		<add key="ContentControllerConfigPath" value="C:\UBIK\CUI.ES.Config\ContentController.json" />
	</appSettings>
</source>
'''Make sure ContentController.json exist.'''
* Open ContentController.json, change the content base on the requirement:
<source lang = "yaml">
{
   "SqlConnectionDefinition": 
    {
      "SSPI": false (or true, based on your DB setting),
      "SQLUser": "username",
      "SQLPassword": "password",
      "SQLServer": "your SQL Server",
      "SQLInitialCatalog": "DB name"
       }
}
</source>
==See also==
<!-- DO NOT MODIFY THE NAME OF THIS SECTION, BUT REMOVE IT IF NOT REQUIRED -->