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.
- Navigate to the network location that houses the Connect-CCURE RTO package.
- Click on the Connect-CCURE RTO package and copy the InsertLicense PowerShell script.
InsertLicense Script
- 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.
- Press the Enter key to run the script.
- Navigate and open SQL Server Management Studio on the connected PC or server.
- Query the ACVAudit database using the select * from Audiolog command to verify that the InsertLicense script was successfully added to the C-CURE database.
- 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
- 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
- Restart the CrossFire services for the license to take effect.
- 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.
- Navigate back to the Connector-CCURE RTO package network location.
- Click on the CCURE-Connector folder and copy the contents.
CCURE Connector/netcoreapp2.2\win81-x64\publish folder contents
- Paste the contents from the CCure Connector folder into the (C:\Program Files\Resolver Inc\Connect\Connector CCure) folder path created in step 10.
- Navigate back to the Connector-CCURE RTO package network location and copy the contents from the CCUREPlugin folder.
- 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.
- Open Resolver Connect by logging into Resolver.
- From the Resolver Home screen, select the Command Center link from the Home drop-down list.
Home screen Drop-Down List
- From the Command Center screen, click on the Launch Connect link on the Menu Bar.
Launch Connect Link
- From the Resolver Connect Home screen, click on the REGISTER CONNECTOR button.
Register Connector Button
- Enter a connector name in the Connector Alias field and click the Save button.
Register Connector Screen
- The Register Connector screen will appear, listing the newly registered connector.
- 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.
- 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.
- Locate the appsetting.json file.
- 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.
- Locate the ConnectorID tag and paste the new Connector ID between the quotation marks after the ConnectorID tag.
Connector ID
- 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.
- LogLevel: Enter one of the following log level options for Default, System, and Microsoft.
- Application Insights (Optional):
- Instrumentation Key: Enter a Microsoft Azure ID to output logs and monitor Resolver Connect and the C-CURE Connector.
- CCUREConnector:
Completed appsetting.json File
- 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.
- Navigate to the CCURE server components folder C:\Program Files (x86)\Tyco\CrossFire\ServerComponents and Locate the CCURE Plugin Config.json file.
- 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.
- 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.
- 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
- Navigate to the CCURE server components folder C:\Program Files (x86)\Tyco\CrossFire\ServerComponents. Locate and click the Command Prompt to open the application.
- 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
- 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
- Navigate and open Windows Services by entering Services in the Windows Search field on the Taskbar and pressing the Enter key.
Windows Services
- From the Services screen, scroll until you find the Resolver CCure Plugin Service item.
Resolver CCure Plugin Service
- Right-click the Resolver CCure plugin service item and select Start from the pop-up menu.
Start Link on Pop-Up Menu
- Navigate to C:/Program Files (x86)/Tyco/Crossfire folder and click on the ACVS.Enterprise.Server.Configuration file to open the Server Configuration application.
- On the Services tab, locate the Resolver CCure Plugin Service and make sure that the Status says Running.
Service Tab
- Navigate to the C:/Program Files\Resolver Inc\Connect\Connector CCure folder and locate the Connect.Connectors.CCure.exe file.
- Click on the Connect.Connectors.CCure.exe file.
- 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
- Log back into Resolver Connect.
- 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.