Installing the C-CURE Connector & Plugin


Overview

Before starting the Installation process, please contact support to obtain the required Connect-CCURE RTO package and to receive further assistance with the installation.

Resolver Connect® allows you to use a C-CURE Connector and Plugin to pull data from the Software House® system and send the data to Resolver Dispatch®, sharing data between the two platforms.


Installing a C-CURE Connector and Plugin

Before installing the C-CURE Connect and Plugin, customers must contact Software House to update their C-CURE 9000 license to include the Resolver - CCURE9000 - Integration. The update procedure is the same procedure for adding other options or to update a site license. 

Before installing the C-CURE Connector and Plugin, log in to Resolver Connect using a Dispatch Administrator account. A Dispatch Administrator account will have the Access Connect radio button enabled.

Connect Access Radio Button

Notes:
Resolver recommends installing the C-CURE Connector and Plugin on the C-CURE source server. The Connector will require a standalone server If outbound connections are not possible.

You will need access to PowerShell and SQL Server Management Studio to run commands and queries related to the installation.

  1. Navigate to the network location that houses the Connect-CCURE RTO package.
  2. Click on the Connect-CCURE RTO package and copy the InsertLicense PowerShell script.

InsertLicense Script

  1. Navigate and open PowerShell on the connected PC or server and paste the InsertLicense script on the command line.

Note: 
Ensure that your user has Administration user account privileges before running the InsertLicense script.

  1. Press the Enter key to run the script.
  2. Navigate and open SQL Server Management Studio on the connected PC or server.
  3. Query the ACVAudit database using the select * from Audiolog command to verify that the InsertLicense script was successfully added to the C-CURE database.
  4. If successful, the Results section will return a log entry listing information about the InsertLicense script:
    • ServerUTC: year, date, and time the script was run.
    • PrimaryObjectName: Resolver – CCURE90000- Integration.

Query Results

  1.  Query the ACVSCore Database using select * from dbo.LicenseOption to verify that the license was successfully added to the database. If successful, the Results section will have an entry in the table for ObjectID = 5000, Name = Resolver - CCURE9000 - Integration.

Resolver - CCURE9000 - Integration

  1.  Restart the CrossFire services for the license to take effect.
  2. Create the folder path for the C-CURE Connector (C:\Program Files\Resolver Inc\Connect\Connector CCure) on the PC or server you are using to install C-CURE.
  3. Navigate back to the Connector-CCURE RTO package network location.
  4. Click on the CCURE-Connector folder and copy the contents.

CCURE Connector/netcoreapp2.2\win81-x64\publish folder contents

  1. Paste the contents from the CCure Connector folder into the (C:\Program Files\Resolver Inc\Connect\Connector CCure) folder path created in step 10.
  2. Navigate back to the Connector-CCURE RTO package network location and copy the contents from the CCUREPlugin folder.
  3. Navigate to the CCURE server components folder C:\Program Files (x86)\Tyco\CrossFire\ServerComponents and paste the contents from the CCURE Plugin folder into the CCURE folder.

Register the C-CURE Connector

Registering the C-CURE Connector will create a Connector ID.

  1. Open Resolver Connect by logging into Resolver.
  2. From the Resolver Home screen, select the Command Center link from the Home drop-down list.

Home screen Drop-Down List

  1. From the Command Center screen, click on the Launch Connect link on the Menu Bar.

Launch Connect Link

  1. From the Resolver Connect Home screen, click on the REGISTER CONNECTOR button.

Register Connector Button

  1. Enter a connector name in the Connector Alias field and click the Save button.

Register Connector Screen

  1. The Register Connector screen will appear, listing the newly registered connector.
  2. Copy the C-CURE Connector ID.

Registered C-CURE Connector


Preparing the JSON Files

Before editing the appsettings.json file, you must register the C-CURE Connector and copy the Connector ID.

  1. Navigate to the newly created folder path (C:\Program Files\Resolver Inc\Connect\Connector CCure) on the PC or server you are using to install C-CURE.
  2. Locate the appsetting.json file.
  3. Right-click the appsetting.json file and select Open with from the pop-up menu. If Notepad is not in the recent section, select the Choose another app link and select Notepad.
  4. Locate the ConnectorID tag and paste the new Connector ID between the quotation marks after the ConnectorID tag.

Connector ID

  1. Make the additional edits to configure the appsettings.json file:
    • CCUREConnector:
      • RootUrl: Enter the IP address of the computer or server where the C-CURE Connector is installed and running.
      • PlugInUrl: Enter the IP address of the computer or server where the C-CURE Plugin is installed and running.
      • SharedSecret: The C-CURE Connector and Plugin both share this ID. This tag has a default value. If changed, you will also need to change the SharedSecret tag in the C-CURE Plugin’s config.json file.
    • QueueClient:
      • VitualHost: Enter the name of the RabbitMQ virtual hostname. You can find the virtual hostname by logging into RabbitMQ Management – Admin – Virtual Hosts.
      • HostName: Enter a RabbitMQ username with full access to the RabbitMQ virtual host instance.
      • UserName: Enter a RabbitMQ username with full access to the RabbitMQ virtual host instance.
      • Password: Enter the RabbitMQ user password.
    • Logging (Optional): If a Log Level is left blank (System and Microsoft), the log level option under Default will be used.
      • LogLevel: Enter one of the following log level options for Default, System, and Microsoft.
        • All: This log option will display all log options and allows you to set up custom logging options.
        • Trace: This log option displays application behaviors and is used to diagnose the application or third-party data libraries.
        • Debug: The most detailed log used for troubleshooting.
        • Info: This log is not as detailed as the Debug log but provides error descriptions.
        • Warn: This log will display warnings that may prevent specific application processes from functioning but will not cause fatal errors or prevent the application from running.
        • Error: The log displays critical error logs.
        • Fatal: This log option displays fatal or critical application errors that have the potential to cause issues with important application functions.
        • Off: This log option turns the logging function off.
    • Application Insights (Optional):
      • Instrumentation Key: Enter a Microsoft Azure ID to output logs and monitor Resolver Connect and the C-CURE Connector.

Completed appsetting.json File

  1. From the Menu Bar, click File and select Save from the drop-down list to save the appsettings.json file.

Note: 
For adding additional C-CURE Connectors, copy the appsettings.json file and change the InstanceID tag from 1 to 2.

  1. Navigate to the CCURE server components folder C:\Program Files (x86)\Tyco\CrossFire\ServerComponents and Locate the CCURE Plugin Config.json file.
  2. Right-click the CCURE Plugin Config.json file and select Open with from the pop-up menu. If Notepad is not in the recent section, select the Choose another app link and select Notepad.
  3. Edit the following sections in the CCURE Plugin Config.json file:
    • PluginBaseUri: Enter the URI of the computer or server where the C-CURE Plugin is installed and running.
    • ConnectorUri: Enter the URI of the computer or server where the C-CURE Plugin is installed and running.
    • ShareSecret: The C-CURE Connector and Plugin both share this ID. This tag has a default value. If changed, you will also need to change the SharedSecret tag in the C-CURE Connector’s config.json file.
    • LogLevel: Enter one of the following log level options for Default, System, and Microsoft.
      • All: This log option will display all log options and allows you to set up custom logging options.
      • Trace: This log option displays application behaviors and is used to diagnose the application or third-party data libraries.
      • Debug: The most detailed log used for troubleshooting.
      • Info: This log is not as detailed as the Debug log but provides error descriptions.
      • Warn: This log will display warnings that may prevent specific application processes from functioning but will not cause fatal errors or prevent the application from running.
      • Error: The log displays critical error logs.
      • Fatal: This log option displays fatal or critical application errors that have the potential to cause issues with important application functions.
      • Off: This log option turns the logging function off. 
    • TimeZone: Enter the local time zone where the C-CURE Connector is located and operational. Time zone names can be found within the Time Zone ID article.
  4. From the Menu Bar, click File and select Save from the drop-down list to save the CCURE Plugin Config.json file.

Completed CCURE Plugin Config.json File


Run the installutil Command

  1. Navigate to the CCURE server components folder C:\Program Files (x86)\Tyco\CrossFire\ServerComponents. Locate and click the Command Prompt to open the application.
  2. From the Command Line, run the installutil command for the Plugin location c:\windows\microsoft.net\framework\v4.0.30319\installutil.exe Resolver.Connect.Connectors.CCurePlugin.exe.

Command Prompt – installutil Command

  1. When the command is finished running, click the x button in the top right-hand corner to close the Command Prompt.

Confirming the C-CURE Connector and Plugin Installation

  1. Navigate and open Windows Services by entering Services in the Windows Search field on the Taskbar and pressing the Enter key.

Windows Services

  1. From the Services screen, scroll until you find the Resolver CCure Plugin Service item.

Resolver CCure Plugin Service

  1. Right-click the Resolver CCure plugin service item and select Start from the pop-up menu.

Start Link on Pop-Up Menu

  1. Navigate to C:/Program Files (x86)/Tyco/Crossfire folder and click on the ACVS.Enterprise.Server.Configuration file to open the Server Configuration application.
  2. On the Services tab, locate the Resolver CCure Plugin Service and make sure that the Status says Running.

Service Tab

  1. Navigate to the C:/Program Files\Resolver Inc\Connect\Connector CCure folder and locate the Connect.Connectors.CCure.exe file.
  2. Click on the Connect.Connectors.CCure.exe file.
  3. The C-CURE Connector will open. Scroll to the Connector Startup is Complete message. If you cannot find the Connector Startup is Complete message, you will need to double-check the Connector and Plugin Configuration settings.

Successful C-CURE Connector/Plugin Installation

  1. Log back into Resolver Connect.
  2. A Circle icon will appear in the C-CURE Connector’s Status field, which indicates the following depending on the circle’s color:
    • Green Circle: The C-CURE Connector is running.
    • Yellow Circle: The C-CURE Connector is running, but configuration errors exist.
    • Red Circle: The C-CURE Connector is not running.

Note:
See the Connect User Guide for further information regarding generating, registering, device configuration, or creating rules.