Preparing Your System for CygNet Bridge

CygNet Bridge works with your existing CygNet system in conjunction with the additional CygNet Bridge companion products you select to install, so your system must first be prepared to support interoperation of these features.

Preparation Overview

Preparing your system is necessary prior to adding CygNet Bridge and its companion components to your CygNet installation. Preview the following topics for more information before beginning.

• Prepare your system for CygNet Bridge:
  • Enable .NET Framework
  • Install IIS
  • Activate HTTPS
• Prepare your system for intended companion features:
  • Prepare your system for CygNet Mobile
  • Prepare your system for CygNet Dispatch
  • Prepare your system for CygNet Bridge API

Preparing Your CygNet System

To prepare your CygNet system, prior to installing CygNet Bridge or associated products, complete the following preparatory tasks:

• Comply with CygNet system requirements
• Prepare CygNet Software

Complying with CygNet System Requirements

Before installing CygNet Bridge, ensure that all components supporting the applications you will be installing are available and in compliance with CygNet system requirements. Follow the steps described to prepare your server and system to interoperate with all required elements.

To Comply with CygNet System Requirements for CygNet Bridge

• Components - For all components you plan to install, verify and comply with requirements listed in the CygNet System Requirements document. The following list is an overview only, and is not a substitute for specific components and versions listed in the systems requirements document.
  • Operating System - Verify or install Microsoft Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, or Windows Server 2012 on your system. Follow Microsoft instructions for this process.
  • Visual C++ Redistributable Packages (x64) - Verify or install the required Microsoft Visual C++ Redistributable Packages (x64) appropriate for your operating system.
  • ASP.NET Framework - Verify or install .NET Framework 4.6.2 or later on your system. See Installing .NET Framework for CygNet Bridge for more information.
    • The .NET framework (HTTP and TCP) is included with most supported operating systems.
  • Internet Information Services (IIS) Web Software - Verify or install IIS Web Software on your system with Administrative privileges; your operating system version determines which version is installed, and you must have administrative rights to do so. Follow Microsoft instructions for this process. See Installing IIS for CygNet Bridge for more information.
  • IIS Web Server Secure Sockets Layer (SSL) - Although HTTP or HTTPS could be used, installing the HTTPS secure certificate communication version (https://*) is strongly recommended. HTTPS traffic is encrypted from end to end, helping to ensure that data transmitted between the web server and your CygNet installation is more secure; HTTP is not secure and is not safe for production environments. Verify or install IIS Web Server SSL protocol to use HTTPS. See Installing HTTPS for CygNet Bridge for more information.
  • Windows Authentication - Verify that Windows Authentication is enabled in your operating system.
    1. In the Control Panel, click Programs and Features
    2. In the left pane, select Turn Windows Features on or off
    3. Expand Internet Information Services > World Wide Web Services > Security. Click the check box to select Windows Authentication and then click OK.

Once CygNet system requirements are complete for CygNet Bridge, prepare your system for each CygNet product you are installing.

To Comply with CygNet System Requirements for CygNet Bridge Companion Features

• Prepare Your System for CygNet Mobile
• Prepare Your System for CygNet Dispatch
• Prepare Your System for CygNet Bridge API

After all system requirements are complete for CygNet software and each CygNet Bridge companion product you intend to install, proceed to preparing your CygNet software installation for CygNet Bridge.

Preparing Your CygNet Software Installation

To Configure CygNet Software for CygNet Bridge and Companion Products

1. Verify or upgrade your CygNet software to be v8.5.1 or above. It is highly recommended to use the latest version of CygNet Software as your baseline to access additional product functionality.
2. In the Address Resolution Service, ARS, install the CygNet license provided by your Account Manager or CygNet Sales if you need to update licensing for additional products.
• Trial license - Runs CygNet Bridge and selected companion products as a trial until a specified date; will not start after the expiration date
• Full license - Runs CygNet Bridge and selected companion products for a specified level of service based on your site needs; has no expiration date

3. In the Access Control Service, ACS, configure the ACS security settings needed for access to CygNet Bridge and each of your selected companion products.

   See Configuring Applications and Events and Assigning Permissions to Events in the Security section for general information about this process.

1. On the Permissions page, right-click to access the context menu and then select New App to access the New Application dialog box.
2. Enter the following values to add ACS security events for each desired Bridge feature, for the service and permission levels needed (examples shown; replace with levels appropriate for your usage):
• CygNet Mobile
  • Application: FAC, Description: Facility Service, Event: ACCESS, Event Description: Bridge Access, Security ID: IIS APPPOOL\CygNet Bridge, Level: 1, ID Type: CG
  • Application: GRP, Description: Group Service, Event: ACCESS, Event Description: Bridge Hierarchy, Security ID: IIS APPPOOL\CygNet Bridge, Level: 1, ID Type: CG
  • Application: GRP, Description: Group Service, Event: ACCESS, Event Description: Bridge, Security ID: IIS APPPOOL\CygNet Bridge, Level: 3, ID Type: CG
  • Application: MOBILE, Description: Mobile Security, Event: ACCESS, Event Description: Mobile Access, Security ID: [Enter all desired User IDs for Level 2], Level: 2, ID Type: US
• CygNet Bridge API
  • Application: BRDGAPI, Description: Bridge API Security, Event: ACCESS, Event Description: Bridge API Access, Security ID: [Enter all desired User IDs for Level 1], Level: 1, ID Type: US
  • Similar service application access for all services providing required data, e.g. VHS for History API calls, PNT for points, etc.
• CygNet Dispatch
  • Application: FMS, Description: Flow Measurement Service, Event: JOB, Event Description: Dispatch Job, Security ID: [Enter all desired User IDs for Level 5], Level: 5, ID Type: US

See Security Events and Security Reference for CygNet Bridge Applications (CygNet Dispatch: FMS/JOB, CygNet Mobile: MOBILE/ACCESS, or CygNet Bridge: BRDGAPI/ACCESS) for more information about user authorization levels for these CygNet products.

More:

Enabling .NET Framework

Installing IIS

Activating HTTPS