How To
ForgeRock Identity Platform
ForgeRock Identity Cloud

How do I upgrade the Remote Connector Server (RCS) for Identity Cloud and IDM?

Last updated Sep 22, 2021

The purpose of this article is to provide instructions on how to upgrade the RCS for Identity Cloud and IDM.


Upgrading the RCS

You can upgrade the RCS as follows:

  1. Download the new RCS package from BackStage.
  2. Stop the RCS by pressing CTRL + C, or q in the terminal where you started the server.
  3. Rename the existing RCS directory to create a backup, for example:$ mv /path/to/openicf /path/to/openicf_old
  4. Unpack the RCS package you downloaded (you should unpack this to the original directory to keep paths etc the same), for example:$ unzip openicf-zip-1.5.20.0.zip
  5. Copy the following files from your backup to the new RCS directory to retain all your previous settings:
    • conf/ConnectorServer.properties
    • lib/framework/logback.xml (if you have set up the RCS for debug logging)

For example:$ cd /path/to/openicf $ cp /path/to/openicf_old/conf/ConnectorServer.properties conf/ $ cp /path/to/openicf_old/lib/framework/logback.xml lib/framework/

  1. Restart the RCS:$ /path/to/openicf/bin/ConnectorServer.sh /run

See Also

Using Checksums

How do I implement a Remote Connector Server (RCS) for Identity Cloud?

Remote Connectors


Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.