Installing and Configuring Connector Gateway

Download the .zip files for the latest Connector Gateway release.

The Connector Gateway can be installed on UNIX/Windows computer with network connectivity to Identity Security Cloud and the Mainframe Connector.

Create an installation directory on the computer where the Connector Gateway will run and extract the contents of the ConnectorGateway-releaseVersion.zip file included with the release of Identity Security Cloud, where releaseVersion is the version of the Connector Gateway.

Before You Begin

  • Oracle, IBM Java Development Kit 1.8 (8) (32-bit and 64-bit) JDK 11 or later is required.

  • OpenJDK11 is supported on all structures.

    Note
    Sailpoint recommends AdoptOpenJDK 11 for Windows and Red Hat OpenJDK 11 for Linux.

  • After upgrading to the latest version of Connector Gateway, the interceptions are no longer stored in file or read from a file. Pending interceptions which were stored in a file by a previous version of the Connector Gateway, or pending interceptions not sent to the Provisioning Engine will be invalid.

    • The Connector Gateway and the Mainframe Connector can be started / stopped in any order.

    • If there is a firewall between the Connector Gateway and the Mainframe Connector, then you must open the port and port +1 that the Mainframe Connector is listening to.

Note
You are only entitled to download components for which you have an active license with SailPoint. The availability of a component for download does not grant you a license to use it. Downloading a component which you do not have an active license for does not entitle you to use it. Please contact your Account Representative or CSM for more information.

Supported Operating Systems

The Connector Gateway provides support for the following versions:

  • SUSE Linux Enterprise Server version 15 and 12

  • Windows Server version 2016, 2019, and 2022

  • CentOS 8.3 and 7.9

Note
For Linux Support, the distributions and versions of Linux highlighted above are verified, but any currently available and supported distributions and versions of Linux will be supported by SailPoint. Implementers and customers must verify that the distribution and version of Linux of choice is compatible with the version of JDK being used.

Hardware Sizing Considerations

Use the information below to determine the hardware resource allocations required by your Mainframe deployment. For a more detailed explanation, refer to the IdentityIQ Hardware Sizing Guide.

Connector Gateway Resource Allocation

You need to provide a separate host to run the Connector Gateway for the Mainframe connector. Dedicating a virtual machine (VM) as a host for all of the Connector Gateway instances provides a simple approach and a redundancy/backup strategy for this part of the infrastructure.

Regardless of your overall IdentityIQ footprint, SailPoint suggests using the same resources as a medium UI server compute resource target for a single Connector Gateway instance. For example, if a medium footprint calls for 4 CPUs, 8 GB of memory, and 50 GB of storage for a UI server. For more information about Connector Gateway, refer to Connector Gateway (CG) and Mainframe Connectors - FAQ and Troubleshooting.

Note
Connector Gateway can be installed on systems with other ancillary SailPoint products (like IQService). However, be sure that the system has dedicated resources (TCP ports, for example) to support all products to appropriately.