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

    • update.bat

    • log4j.properties

    • ConnectorGateway.jar

    • ConnectorGateway64.exe

    • log4j-core-2.24.3.jar

    • log4j-api-2.24.3.jar

    • log

  3. Set JAVA_HOME environment variable to the root directory of your JDK installation

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

    • install.bat

    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 connector.

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

  5. 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.

    To update Service Name edit the install.bat file and rename SERVICE_NAME_SUFFIX variable.

  6. Start the SailPointConnectorGateway_<service name> service.

  7. To provide heap memory settings for the Java Virtual Machine (JVM) pass the values like below:

    install.bat JvmMsValue JvmMxValue i.e. install.bat 32 512

    update.bat JvmMsValue JvmMxValue i.e. update.bat 32 512

    Note

    • JvmMx Stands for Maximum heap size which Sets the maximum amount of memory the JVM can allocate for the heap. default is 512MB

    • JvmMs Stands for: Minimum heap size which Sets the initial memory allocation for the heap when the JVM starts. default is 32 MB

       

  8. Whenever JDK version is upgraded from one version to another, Run update.bat file as follow:

    • (64-bit) update.bat 64

  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

    • update.bat

    • log4j.properties

    • ConnectorGateway.jar

    • ConnectorGateway64.exe

    • log4j-core-2.24.3.jar

    • log4j-api-2.24.3.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