Installing the Spok Mobile Message Monitoring Service
For more information about how to install the Spok Mobile Message Monitoring Service on-premises, see Installing the Spok Mobile Message Monitoring Service.
Deploying the Message Monitoring Database
The CareConnectMonitoring
database resides on the Spok Hosted server, and contains all data which has been synchronized from clients. To create this database, execute the SQL script Create.sql
located in {Hosted Folder}\CareConnect Monitoring\Database\. Execute this script on the Hosted server; if Message Monitoring is deployed to a different location with network access to the Hosted database, execute the script on that server instead.
Configuring the Authentication
The steps below will allow the Web UI to be accessed from outside the server on which it is running.
- Open the
Hosted.sql
script. - Change “
APPSERVER_HOSTNAME
” to the actual domain name of the Message Monitoring server. If this server is located behind a load balancer for the Web Application, use the load balancer domain name instead. - Run the script.y
Deploying the Message Monitoring Sync Service
The CareConnect.MonitoringSyncService
is deployed on the Hosted server and any other server in the Hosted environment. It prompts all of the CareConnect.Monitoring.Api services to synchronize (fetch) data from the client’s Spok Mobile server and Contact Center, and also fetches push notification data from the Spok Mobile Hosted database. It processes the synchronized data in a scheduled job, so that the system does not make calculations such as time between checkpoints at the time it fetches the data for the reporting UI.
To deploy the CareConnect.MonitoringSyncService
, do the following on the Hosted server; if the Message Monitoring service is deployed to a separate server, perform these steps on that server instead.
The Message Monitoring Sync Service does not support high availability environments.
- Copy the {Hosted Folder}\CareConnect Monitoring\Monitoring SyncService folder to the Hosted server folder D:\Program Files (x86)\Spok\Care Connect\
-
Right click on the Monitoring SyncService folder and give all permissions to “NETWORK SERVICE” and “LOCAL SERVICE” users to the Monitoring SyncService folder and child folders.
- Open a command prompt as an administrator.
- Navigate to
installutil.exe
, usually located in C:\windows\microsoft.net\framework\v4.0.30319\. - Run the following to install CareConnect.Monitoring.SyncService:
Installutil "D:\Program Files (x86)\Spok\Care Connect\Monitoring SyncService\CareConnect.Monitoring.SyncService.exe" - Open the configuration file
CareConnect.Monitoring.SyncService.exe.config
and change the following:- Change the tags
connectionStrings
,DataEntities
, andDataEntitiesLog
to point to theCareConnectMonitoring
database. - Change
Hosted
andHosted_Archive
to point to the Hosted server and theAmcomAmcPremiseCore
database. - Change the Configuration Service
url
attribute in thecnfgClient
tag to point to the Hosted Configuration Service. If the service is behind a load balancer, set theurl
attribute to the load balancer URL. - You can either leave the
appSettings
tag as it is, or make the following optional changes:- Change the synchronization interval to the following:
<add key="syncCron" value="0 */15 * * * ?" />
Where “15” means every 15 minutes. - Change the processing data interval to the following:
<add key="processCron" value="0 */15 * * * ?" />
Where “15” means every 15 minutes. - Change the date from which the initial synchronization should be made (for all tenants). This only determines from which prior date the initial synchronization will be made; subequent intervals will use the settings from
syncCron
.
<add key="syncLookbackDays" value="40" />
- Change the synchronization interval to the following:
- Change the tags
- You can now start the Monitoring Service from the Windows Services management screen. You can find it listed as "Spok Monitoring Synchronization Service." It will not do anything until you select tenants from the Web UI (see Installing the Spok Mobile Message Monitoring Service - Spok Mobile Hosted). You can look at the SyncService log file to confirm that the service has been started successfully. The
sync-log.txt
log file is located in thelogs\
directory of theSyncService
folder. Because the location of the log is a log4net setting, it can be changed inCareConnect.Monitoring.SyncServicexe.config
.
Deploying the Message Monitoring Reporting UI
CareConnect.MonitoringWeb
is the reporting user interface, which reports gathered data and allows you to filter and sort it. You can also use the Configuration page of the reporting UI to configure which clients to include in the Message Monitoring service. The reporting UI is an ASP.NET application on the Hosted server (or, if Message Monitoring is deployed on a different server, on that server instead).
- Copy the {Hosted Folder}\CareConnect Monitoring\Monitoring folder to the IIS default folder \wwwroot\
- Open the IIS Manager and navigate to the Monitoring folder under Default Web Site.
- Select Convert to Application, then click OK.
-
Open the Web.Config file in the Monitoring folder and change
DataEntities
in theconnectionStrings
tag to point to the CareConnetMonitoring database. In thecnfgClient
tag, change theurl
to point to the Hosted Configuration Service; if the service is behind a load balancer, use the load balancer URL instead. -
Start the Monitoring application and navigate to Configuration page. You should see all of the tenants there.
For more information about the Spok Mobile Message Monitoring interface, see Spok Mobile Message Monitoring.