Install the C-Cure Connector & Plugin

As part of the connector configuration process, you will need to log into Connect and register the connector to obtain a connector ID. As such, ensure you have login credentials for a Dispatch user account that’s authorized to access Connect prior to completing the steps below. See the Dispatch Administrator’s Guide for more information on creating user accounts.

For hosted customers, the server hosting the connector must have a firewall rule enabled to allow outbound communication to Resolver's hosted environment.
The plugin must be installed on the C-Cure source server and, where possible, Resolver recommends installing the connector on the C-Cure source server. If outbound connections from that server are not possible, the connector will require a standalone server.
Before installing the connector, ensure that your computer meets the System Requirements.

To install the C-Cure connector and plugin:

  1. Double-click the Connect Setup folder in the Perspective download package.

  2. Right-click the Connector-CCure.exe file and select Run as administrator to open the InstallShield Wizard.

  3. Follow the steps in the wizard until the installation is complete. This will install the C-Cure connector and plugin.

  4. Open Connect.

    If you are unable to launch Connect, ensure that the Connect Access checkbox on your Dispatch User account has been checked. If it has and it is still not working, contact Support for assistance.
  5. Click Register Connector.

  6. Enter a name for the connector in the Connector Alias field, then click Save.The Register Connector screen.

  7. Highlight the ID code in the Connector ID column beside the new connector, right-click it, then select Copy to copy the code to your clipboard.Copying the Connector ID to the clipboard.

  8. Navigate to the location where the connector was installed. By default, it can be found at C:\Program Files\Resolver Inc.\Connect\Connector CCure.

  9. Right-click the appsettings.json file, then select Open with to open the file with Notepad.

  10. Paste the Connector ID obtained in step 7 between the quotation marks after “ConnectorID”Pasting the C-Cure Connector ID in the appsettings.json file.

    Ensure your changes match the settings configured in the Connect appsettings.json file and are entered within the quotations marks after the semi-colon for each setting (e.g. “VirtualHost”: “00.00”,).
  11. Make edits to the remainder of the settings in the file:

    1. CCureConnector:

      1. RootUrl: Enter the IP address of the computer where the C-Cure connector is installed and running.

      2. PlugInUrl: Enter the IP address of the computer where the C-Cure plugin is installed and running.

      3. SharedSecret: This is the shared ID between the C-Cure plugin and connector. If necessary, change the default value to an alternate shared key, ensuring the same key has been added in the config.json file for the plugin in step 15. c. below.

    2. QueueClient:

      1. VirtualHost: Enter the name of the RabbitMQ Virtual host name.

      2. HostName: Enter the host name of the server where RabbitMQ is installed.

      3. UserName: Enter the username of the RabbitMQ user that has full access to the RabbitMQ virtual host instance.

      4. Password: Enter the password of the RabbitMQ user.

    3. Logging (optional):

      1. LogLevel: Enter one of the following log levels for Default, System, and Microsoft (note that if no values are entered for System and/or Microsoft, the values entered for Default will be applied):

        • Debug: The highest log value. This value is often used by developers and for troubleshooting.

        • Information: Useful to support staff by providing context to errors.

        • Error: Displays critical error logs.

    4. Application Insights (optional):

      1. Instrumentation Key: Enter the Azure ID to output the logs. This optional configuration allows you to include a monitoring tool for the Connect and connectors.A fully configured appsettings.json file for the C-Cure connector.

  12. Click File > Save to save your changes, then close the file.

    If you need to create another instance of the connector, make a copy of the appsettings.json file and change the InstanceID to 2. If additional connectors are required, continue making copies of the file and changing the InstanceID to the next sequential number (3, 4, 5, etc.).
  13. Navigate to the location of the C-Cure connector plugin. By default, it’s located at C:\Program Files (x86)\Tyco\CrossFire\ServerComponents.

  14. Right-click the CCure Plugin Config.json file, then select Open with to open the file in Notepad.

  15. Make edits to the following settings in the file:

    1. PluginBaseUri: Enter the URI of the computer where the C-Cure plugin is installed and running.

    2. ConnectorUri: Enter the URI of the computer where the C-Cure connector is installed and running.

    3. SharedSecret: If you changed the default value of the shared secret in the appsettings.json file in step 11. a. iii., enter the alternate shared secret.

    4. Log Level: Enter how much information will be logged (e.g. Debug, Info, Warn, Error).

    5. TimeZone: Enter the time zone where the C-Cure devices will be operating. The names of the time zones can be obtained from the Time Zone IDs article on the Microsoft website.

  16. Click File > Save to save your changes, then close the file. The appsettings.json file for the C-Cure plugin.

  17. Open Command Prompt from the CCure connector plugin folder. By default, it’s located at C:\Program Files (x86)\Tyco\CrossFire\ServerComponents.
  18. Run the installutil command against the location of the plugin (i.e., c:\windows\microsoft.net\framework\v4.0.30319\installutil.exe Resolver.Connect.Connectors.CCurePlugin.exe), then close when finished.Command Prompt running the installutil command.

  19. Open Windows Services.
  20. Right-click the Resolver CCure plugin service, then click Start.The Resolver CCure plugin service.

    Windows Services will display two Resolver CCure Plugins. When starting the service, ensure the Resolver CCure plugin service (lowercase) is selected and not Resolver CCure Plugin Service (uppercase).
  21. Double-click the ACVS.Enterprise.Server.Configuration file to open the Server Configuration application. By default, this application is located in C:\Program Files (x86)\Tyco\CrossFire.
  22. Ensure the Resolver CCure Plugin Service is showing a Running status in the Services tab, then close when finished.The Server Configuration application.

  23. Navigate to the installation folder. By default, it’s located at C:\Program Files\Resolver Inc\Connect\Connector CCure.
  24. Double-click Connect.Connectors.CCure.exe to run the C-Cure connector. The connector is running correctly if a “Connector startup is complete” message is displayed in Command Prompt. If this message is not displayed, confirm the configuration settings in step 13 are correct.

    The Connect.Connectors.CCure.exe file must always be running while using C-Cure connector. If it’s not running, the C-Cure connector will display a red circle in the Status column in Connect, indicating the connector is not currently online.
    A successfully running C-Cure connector after double-clicking the Connect.Connectors.CCure.exe file.
  25. Return to Connect and log back in if necessary.

  26. Refresh the browser. The circle in the Status column beside the new C-Cure connector should be green to indicate the connector is currently running and should now display a Get Latest button. If the circle is yellow, it means the connector is running, but there are errors in the settings. If the circle is red, it means the connector is not running.

    For information on generating, registering, or editing devices or creating rules, see the Connect User’s Guide.