How do I upgrade the Remote Connector Server (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/

6. 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?

Connectors Guide › Remote Connectors