Skip to Content
Author's profile photo Naveen Kumar

Change Master/Shadow role of cloud connector manually

High Availability configuration requires Master-Shadow cloud connector. While taking over, sometimes in exceptional situations, where both of cloud connector in High Availability configuration are shadow role/master role.  In case such bad-configuration occurs, SCP connection will be lost and Satellite systems cannot connect to SAP cloud platform (formerly known as HANA cloud Platform)


How this can happen:


If you have not setup the cloud connector HA set up perfectly, you might end up in a situation where both of cloud connector act as Master or both act as Shadow Cloud connector.


Options to rectify:

When you configure cloud connector installation ,you get the option to chose master or shadow installations, However if you have trapped in a situation as mentioned above, you either have to reinstall both master and shadow installation, and you can chose master and shadow role while setting up the initial configuration., but you will lose all the configuration and connections set up with satellite systems. Hence it is not recommended

Other option: 

You can change the role as per your requirement using configuration.jar file.



  1. You should be logged in OS level.
  2. sapjvm7 and higher should be installed. Preferably sapjvm8 and higher for newer version of cloud connector. 
  3. configuration.jar should have executable rights.


  1. login to OS level and go to folder where scc is installed. You can find it under /opt/sap/scc/ directory in linux.
  2. Shut down the cloud connector for which you want to change the role using command

       service scc_daemon stop

3. Run the below command from the directory

java -jar configurator.jar -be [master/shadow]

which role you want to assign to one of cloud connector.

4.start the cloud connector

service scc_daemon start

Please check the status for confirmation. It should be started and should give you URL to login:



Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Phil Cooley
      Phil Cooley

      Thanks Naveen. I actually had this occur on a project due to firewall changes so nice that you have documented how to fix this for future customers. Thanks for sharing!

      Author's profile photo Naveen Kumar
      Naveen Kumar
      Blog Post Author

      Sharing is caring ..Thanks Phill for your feedback.

      Author's profile photo Jorge Luna Torres
      Jorge Luna Torres

      Thanks Naveen!

      Author's profile photo Brendan Farthing
      Brendan Farthing

      Naveen Kumar ,

      Do you know if there is an option to script a “change role” under normal circumstances. I dont mean under the scenario you describe above. I mean is there a way we can create a script to do the same as going into the UI and pressing the Change Role button to flip Master to Shadow, or vice versa?

      I’ll give you our scenario:

      We run our Cloud Connectors in HA mode on Windows Servers. We need 24×7 uptime for our SAP Cloud connectivity to our internal SAP systems.

      At least once a month we apply Microsoft Server security patches to the Cloud Connector servers and most of the time a reboot happens afterwards to complete the patching.

      We schedule the MS patching to be 1 day apart between the two HA servers.

      We manually set the server about to be patched into Shadow mode (if not already in that mode) by going into the UI and selecting the Change Role option. So that when the server reboots after patching, there is no outage to our SAP Cloud connectivity.

      But we would like to script the the Role Change (safely) using Powershell along with our MS Patching and have zero outage when we do that via a script (or worst case a very brief outage for a couple of seconds when the servers change role).

      We want to script it to save a person having to do this manually each time.

      Does SAP support such Powershell scripting of Cloud Connector to change roles from Master to Shadow or vice versa?




      Author's profile photo Naveen Kumar
      Naveen Kumar
      Blog Post Author

      Hi Brendan,

      You can create desired script and use below commands:


      sudo su - <sid>adm                          # login via sidadm or root or other user as per your environment

      cd /opt/sap/scc/                                # or directory where you installed your cloud connector) in linux

      service scc_daemon stop.               #stop cloud connector

      java -jar configurator.jar -be [master/shadow]  # change role

      service scc_deamon start              #start cloud connector


      You can change it as per your need.



      Author's profile photo Mohsin Mahmood
      Mohsin Mahmood

      For Windows servers what is the process to change Master back to Master as it is still showing as Shadow


      really appreciate if someone please share the steps.