--- title: Java RCS release notes description: "Subscribe for automatic updates: ICF release notes RSS Feed" component: openicf page_id: openicf:connector-release-notes:connector-server canonical_url: https://docs.pingidentity.com/openicf/connector-release-notes/connector-server.html section_ids: 1_5_20_34_java_rcs: 1.5.20.34 Java RCS 1_5_20_33_java_rcs: 1.5.20.33 Java RCS 1_5_20_32_java_rcs: 1.5.20.32 Java RCS 1_5_20_31_java_rcs: 1.5.20.31 Java RCS 1_5_20_30_java_rcs: 1.5.20.30 Java RCS 1_5_20_29_java_rcs: 1.5.20.29 Java RCS 1_5_20_28_java_rcs: 1.5.20.28 Java RCS 1_5_20_27_java_rcs: 1.5.20.27 Java RCS 1_5_20_26_java_rcs: 1.5.20.26 Java RCS 1_5_20_23_java_rcs: 1.5.20.23 Java RCS java_17_required: Java 17 required more_bundled_connectors: More bundled connectors 1_5_20_22_java_rcs: 1.5.20.22 Java RCS 1_5_20_21_java_rcs: 1.5.20.21 Java RCS 1_5_20_18_java_rcs: 1.5.20.18 Java RCS 1_5_20_15_java_rcs: 1.5.20.15 Java RCS 1_5_20_14_java_rcs: 1.5.20.14 Java RCS 1_5_20_12_java_rcs: 1.5.20.12 Java RCS 1_5_20_11_java_rcs: 1.5.20.11 Java RCS 1_5_20_9_java_rcs: 1.5.20.9 Java RCS 1_5_20_8_java_rcs: 1.5.20.8 Java RCS 1_5_20_7_java_rcs: 1.5.20.7 Java RCS 1_5_20_6_java_rcs: 1.5.20.6 Java RCS 1_5_20_5_java_rcs: 1.5.20.5 Java RCS 1_5_20_4_java_rcs: 1.5.20.4 Java RCS 1_5_20_3_java_rcs: 1.5.20.3 Java RCS 1_5_20_2_java_rcs: 1.5.20.2 Java RCS 1_5_20_0_java_rcs: 1.5.20.0 Java RCS 1_5_19_6_java_rcs: 1.5.19.6 Java RCS 1_5_19_5_java_rcs: 1.5.19.5 Java RCS 1_5_19_4_java_rcs: 1.5.19.4 Java RCS 1_5_19_3_java_rcs: 1.5.19.3 Java RCS 1_5_19_2_java_rcs: 1.5.19.2 Java RCS 1_5_19_1_java_rcs: 1.5.19.1 Java RCS 1_5_19_0_java_rcs: 1.5.19.0 Java RCS 1_5_18_0_java_rcs: 1.5.18.0 Java RCS --- # Java RCS release notes Subscribe for automatic updates: [icon: rss-square, set=fa][ICF release notes RSS Feed](./feed.xml) Refer to [Connector framework release notes](framework.html) for details regarding any changes to the ICF Connector Framework that can affect RCS behavior. Downloads are available on [Backstage](https://backstage.forgerock.com/downloads/browse/idm/featured/connectors). | | | | - | ----------------------------------------------------------------------------------------------- | | | Updates to the Java RCS can also include security, formatting, and other internal-facing fixes. | ## 1.5.20.34 Java RCS No public changes were made to Java RCS, though a new version was released. ## 1.5.20.33 Java RCS * OPENICF-3349: The RCS resolves DNS names each time it establishes a new WebSocket connection. * OPENICF-3366: The `pingpongInterval` and `groupCheckInterval` can now be set to `0`. Learn more in [RCS configuration properties](../connector-reference/configure-server.html#rcs-properties). ## 1.5.20.32 Java RCS * OPENICF-3369: The Java RCS now supports Java 21. Learn more in [Install Java RCS](../connector-reference/java-server.html). * OPENICF-3275: The `connectorserver.loggingConfigFile` property has been removed from `ConnectorServer.properties`. To specify a custom logback configuration file, set the `LOGGING_CONFIG` system property to the location of your `logback.xml` file. Learn more in [Logging configuration file](../connector-reference/icf-logs.html#icf-logging-config-file). ## 1.5.20.31 Java RCS * OPENICF-3255: The Java RCS now sets and uses a default temp directory location within the RCS installation folder. ## 1.5.20.30 Java RCS * OPENICF-2272: The Java RCS download now includes a sample dockerfile at `path/to/openicf/docker/Dockerfile`. Learn more in [Deploy Java RCS in a Docker container](../connector-reference/rcs-docker.html). ## 1.5.20.29 Java RCS * OPENICF-1724: Fixed error message when uninstalling non-existent Java RCS Windows service. ## 1.5.20.28 Java RCS * OPENICF-2153: Ability to output `CAUD_TRANSACTION_ID` in the RCS logs. * OPENICF-2616: The default truststore is now the RCS security/trustStore previously introduced by OPENICF-2152. * OPENICF-2970: Simplified default `ConnectorServer.properties` and added sample configurations available in `conf/samples`: * `ConnectorServer.properties.cloud-client` * `ConnectorServer.properties.default-parameters` * `ConnectorServer.properties.onprem-client` * `ConnectorServer.properties.onprem-server` * OPENICF-2972: Removed the `/setDefaults` command. ## 1.5.20.27 Java RCS * OPENICF-2969: The default RCS `webSocketConnections` are reduced from `3` to `2`. ## 1.5.20.26 Java RCS * OPENICF-2942: You can launch Java RCS in a [Docker container](../connector-reference/rcs-docker.html) with multiple values (comma-separated) defined for `connectorserver.url` in `OPENICF_OPTS`. ## 1.5.20.23 Java RCS ### Java 17 required Running Java RCS requires Java 17. ### More bundled connectors Java RCS now bundles the following additional connectors: * AS400 * Cerner * Epic * IBM RACF * MongoDB * Oracle EBS * Peoplesoft * SAP * SAP HANA DB ## 1.5.20.22 Java RCS * OPENICF-2640: If remote IDM process is stopped, Websocket connections increase until IDM process is back. ## 1.5.20.21 Java RCS * OPENICF-2228: `logback.xml` moved to `conf/` directory. * OPENICF-2152: Provide a default SSL truststore file. * OPENICF-2511: Connection to IDM becomes dysfunctional after a period of inactivity in RCS. * OPENICF-2643: Timeout waiting to acquire a websocket to send a message has been decreased from 2 minutes to 30 seconds. * OPENICF-2644: NPE may be thrown on WebSocketConnectionGroup shutdown. * OPENICF-2154: RCS now logs any connector exception to the log file and console. ## 1.5.20.18 Java RCS * OPENICF-1638: The default `logback.xml` logging configuration rolls log files daily. Refer to [Rolling log policy](../connector-reference/icf-logs.html#icf-rolling-log-policy). * OPENICF-2547: New local connector facade created --> Method: newConnectorFacadeInstance. ## 1.5.20.15 Java RCS * OPENICF-2336: Java RCS: Change the default connector.groupCheckInterval=900 seconds to 60 seconds. ## 1.5.20.14 Java RCS * OPENICF-1418: Java RCS: Invalid interval properties not handled properly for client mode. * OPENICF-2181: Java RCS: Housekeeping task should log which endpoint/instance it is working with. * OPENICF-2274: Java RCS: Response to unknown protobuf request should contain RCS version. ## 1.5.20.12 Java RCS * OPENICF-1473: Java RCS: ConnectorServer.properties template should include config for FRAAS. * OPENICF-1889: Java RCS: Include relevant defaults for RCS config. ## 1.5.20.11 Java RCS * OPENICF-2132: Java RCS: docker-entrypoint.sh uses -run instead of -service to start the RCS. * OPENICF-2137: Java RCS: When running in -service mode, version is not displayed at startup. * OPENICF-2174: Java RCS: Incompatible with AM macaroons: Unrecognized field "expireTime". ## 1.5.20.9 Java RCS Bundled connectors were updated, though no changes to the remote connector server were made. ## 1.5.20.8 Java RCS * OPENICF-2000: potential log flooding resulting from operation cancel request messages for LocalOperations which have already completed. ## 1.5.20.7 Java RCS * OPENICF-1883: Java RCS: Improve stability of RCS WebSocket connection management. * OPENICF-1975: Java RCS: Increase default heap size from 512m to 1g. * OPENICF-1925: Java RCS: require explicitly set property to enable agent deployment. ## 1.5.20.6 Java RCS * OPENICF-1832: Java RCS: High CPU usage when running as a service. ## 1.5.20.5 Java RCS * OPENICF-1855: Investigate handling query 'poison pill' termination via recon automatic retry upon exception receipt. ## 1.5.20.4 Java RCS * OPENICF-1726: Java RCS: OAuth access token should be cached and reused till expired. * OPENICF-1744: Java RCS: Unable to run RCS with Marketo connector using a different groovy version. * OPENICF-1796: Java RCS: NPE if connectorserver.url has a bad hostname ## 1.5.20.3 Java RCS * OPENICF-1725: Java RCS: classPath issue in JAVA\_DLL when running as a service on Windows. * OPENICF-1730: Client ConnectorInfos cache not refreshed upon RCS instance restart when using RCS Agent. * OPENICF-1743: Java RCS: windows service starts up and stops abruptly. * OPENICF-1751: Sporadic issues managing RCS-hosted connectors through IDM Native Admin Console. * OPENICF-1783: Java RCS: Rename the windows service name. * OPENICF-1792: Java RCS: message hostId missing and causing a connection drop. * OPENICF-1746: Java RCS: Should display its current version in console and jar files should have their version in file name. * OPENICF-1764: Java RCS: on Windows, ConnectorServer.bat /setKey does not work. * OPENICF-1774: Java RCS: upgrade Procrun to latest version for RCS as a Windows service. ## 1.5.20.2 Java RCS * OPENICF-1655: Java RCS: When using TLS, the RCS does not work behind a proxy. ## 1.5.20.0 Java RCS * OPENICF-1366: Java Connector Server: /setDefaults does not revert config to default properly. * OPENICF-1502: RCS: requests not cancelled when websocket closes. * OPENICF-1540: RCS: requests bearer token from AM, but doesn't look for error status code in response. * OPENICF-1544: Fix double-checked locking in WebSocketConnectionGroup. * OPENICF-1549: Update default ConnectorServer.properties. * OPENICF-1555: Clarify locking behavior in ConnectorServer for Grizzly server lifecycle. * OPENICF-1561: RCS: Reduce log level for common debug messages. ## 1.5.19.6 Java RCS * OPENIDM-16178: IDM recon would fail w/ remote Java connector server. ## 1.5.19.5 Java RCS * OPENICF-1516: Failed ICF Search Query confuses total number of search results. * OPENICF-1520: Java RCS: Connection groups can accumulate many more websockets than they should have. ## 1.5.19.4 Java RCS * OPENICF-1485: Java RCS: Non operational ConnectionGroup should be closed and removed. * OPENICF-1486: Java RCS: Connection housekeeping task may stop running. * OPENICF-1494: Java RCS: Housekeeping task gets blocked. * OPENICF-1500: Java RCS: Improve default logging. ## 1.5.19.3 Java RCS * OPENICF-1482: Java RCS: fails to reestablish connections to IDM after IDM is restarted. ## 1.5.19.2 Java RCS * OPENICF-1467: RCS: endless loops on connection loss and shutdown. ## 1.5.19.1 Java RCS No issues specific to the Remote Connector Server were addressed in this release. ## 1.5.19.0 Java RCS * OPENICF-1393: Java Connector Server: useSSL property use should be clarified. * OPENICF-1394: missing connectorserver.scope in connectorserver property file. * OPENICF-1395: Investigate and clean up the following start up error message. * OPENICF-1397: Java Connector Server: javax.net.ssl trustStore and keyStore properties should be set. * OPENICF-1399: restarting IDM with active RCS causes RCS to decrement websocket connection count. * OPENICF-1400: Java Connector Server: Property name usessl should match docs and code. * OPENICF-1404: Java connector server proxy config for port is incorrect. * OPENICF-1407: Java RCS: Incorrect url in Debug message of HttpRequestPacket header for non-SSL. * OPENICF-1408: Java RCS: NPE when we set proxyHost for client mode. ## 1.5.18.0 Java RCS * OPENICF-1371: Java Connector server does not always reestablish closed websockets. * OPENICF-1390: Java RCS: Prevent use of websockets that are about to be closed. * OPENICF-1392: Java Connector Server: TTL should be in seconds.