Installing Connector Gateway

Install the Connector Gateway on a Windows or UNIX system.

  1. Download the Connector Gateway from the Mainframe Connectors Downloads page.

  2. Unzip the ConnectorGateway-<releaseVersion>.zip file in the temporary directory.

    The following files are extracted:

    • init.xml

    • install.bat

    • log4j.properties

    • ConnectorGateway.jar

    • log4j-core-2.17.1.jar

    • log4j-api-2.17.1.jar

    • log

  3. Edit the batch file and set JDK_HOME to the root directory of your JDK installation.

  4. Run the following batch file to install Connector Gateway on 32-bit or 64-bit systems:

    • (32-bit) install.bat 32

    • (64-bit) install.bat 64

      Note
      Update batch file classpath from:
      --Classpath="%CG_HOME%\ConnectorGateway.jar;%CG_HOME%\log4j-1.2.16.jar;%JDK_HOME%\lib\tools.jar" to the following:
      --Classpath="%CG_HOME%\ConnectorGateway.jar;%CG_HOME%\log4j-core-2.17.1;%CG_HOME%\log4j-api-2.17.1"

  5. Verify that the SailPointConnectorGateway_<service name> service has been installed, where <service name> is the name of the service to which the Connector Gateway is connected during the installation of the ACF2 Connector.

    For example, you can use 20 as a value for server entries.

  6. Edit the init.xml file and set the host and port details for the Mainframe Connector and the listening port for the Connector Gateway in the Server tag. For more information on parameters in the init.xml file, refer to Example init.xml File.

    Note
    Restart the Connector Gateway after init.xml file is modified.

    The parameters in the init.xml file can also be set using the command line as follows:

    java -jar ConnectorGateway.jar -smHostname <MF Host> -smPort <MF Agent Port> -serverPort <Connector Gateway Port> -characterSet <Character Set>

    Note
    All the parameters in the init.xml file can be set using the above command. You can set one or more parameters at a time.

  7. Start the SailPointConnectorGateway_<service name> service.

  1. Download the Connector Gateway from the Mainframe Connectors Downloads page.

  2. Unzip the ConnectorGateway-releaseVersion.zip file in the temporary directory.

    The following files are extracted:

    • init.xml

    • install.bat

    • log4j.properties

    • ConnectorGateway.jar

    • ConnectorGateway32.exe

    • ConnectorGateway64.exe

    • log4j-core-2.17.1.jar

    • log4j-api-2.17.1.jar

    • log

  3. Add the bin directory of the Java Development Kit to the system PATH variable.

  4. Edit the init.xml file and set the host and port details for the Mainframe Connector and the listening port for the Connector Gateway in the Server tag.

    For more information on parameters in init.xml file, refer to Example init.xml File.

  5. Run the following to start the Connector Gateway:

    java -jar ConnectorGateway.jar