Difference between revisions of "Configure EventNotification Endpoint and Enterprise Service for CUI"
(→Enterprise Service) |
(→Enterprise Service) |
||
| Line 39: | Line 39: | ||
** Find the “appSettings” section, configure all necessary information, and add the "ContentControllerConfigPath" setting to the end: | ** Find the “appSettings” section, configure all necessary information, and add the "ContentControllerConfigPath" setting to the end: | ||
<source lang = "xml"> | <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> | </source> | ||
'''Make sure ContentController.json exists.''' | '''Make sure ContentController.json exists.''' | ||
Revision as of 15:13, 26 July 2023
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.
Contents
Overview
- Make sure the Enterprise Service and the 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 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".
- Configure a "Binding" for the website.
- 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": The URL of the USAM Service
- "QueuePath": The folder containing all files, which will be sent to Enterprise Service for processing. After having been processed by ES, the corresponding files will be deleted.
- "InComingLogPath": All received COMOS notifications will be stored here
- "ProcessUrl": The URL of the Enterprise Service web interface
Enterprise Service
- Go to the UBIK.EnterpriseService folder,
- Check if the CUI plugin is installed,
- Copy and paste UBIK.Interface.CUI.dll to the “Injection” folder (create it if it does not exist).
- Open UBIK.EnterpriseService.exe.config:
- Find the “appSettings” section, configure all necessary information, and add the "ContentControllerConfigPath" setting to the end:
<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>
<!-- 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>
Make sure ContentController.json exists.
- Create or adapt ContentController.json according to your database connection:
{
"SqlConnectionDefinition":
{
"SSPI": false (or true, based on your DB setting),
"SQLUser": "username",
"SQLPassword": "password",
"SQLServer": "your SQL Server",
"SQLInitialCatalog": "DB name"
}
}
"SqlConnectionDefinition":
{
"SSPI": false (or true, based on your DB setting),
"SQLUser": "username",
"SQLPassword": "password",
"SQLServer": "your SQL Server",
"SQLInitialCatalog": "DB name"
}
}
