Skip to Content
Technical Articles
Author's profile photo Marco Huang

[SAP Business Technology Platform on Alibaba Cloud series] Use Cloud Connector in SAP Business Technology Platform on Alibaba Cloud

From this article, you will know how to configure and use Cloud Connector in SAP Business Technology Platform on Alibaba Cloud. Before you start with cloud connector, you need to complete below items in Prerequisites section first.

Prerequisites

  • Subaccount for Cloud Connector in SAP Business Technology Platform on Alibaba Cloud
  • Entitlement of connectivity service for your subaccount
  • Role configuration for Cloud Connector

Subaccount for Cloud Connector

Firstly you need to have a subaccount for Cloud Connector and this subaccount should be a member of the Global Account.

Entitlement of connectivity service for your subaccount

In order to use Cloud Connector, you need to assgin quota for connectivity service for your subaccount. After the entitlement, you can find related application identifier for connectivity in the role configuration section.

Role Configuration for Cloud Connector

The subaccount of Cloud Connector should be assigned below role:

  • Cloud Connector Administrator

It is better to manage the role by creating a role collection, within the role collection you can assign all roles you need into the role collection.

Create new role collection for Cloud Connector

By Clicking the button New Role Collection you will see a pop window, you just need to input the collection name you want.

Just click Save button you will go to the home page that listing all role collections. Find the role collection you want and click the title of the role collection you will go to the detail page where you could configure all the roles you want.

You will see three drop down boxes there:

  • Application Identifier – Identify the service application which the role based on.
  • Role Templete – The pre-defined role templete of the service
  • Role – The specified role you want to configure for your subaccount

For Cloud Connector, you just need to configure as below:

Now your subaccount have the access to allow the Cloud Connector to communicate with the SAP Business Technology Platform.

Installing & configuring the SAP Cloud Connector

With this section you will know how to prepare a environment with Cloud Connector client installed.

SAP provides several options for you to install Cloud Connector. You need to install Cloud Connector and configure the client to connect with SAP Business Technology Platform.

Below items are needed for Cloud Connector:

  • Cloud Connector installation package
  • Jave Runtime (Open-jdk installation)
  • Docker (install docker image for cloud connector)

Install Cloud Connector

Access tools.hana.ondemand.com and search by Cloud Connector, you can find the available component name that accord with your target operation system. For this case I will use Linux version to build the docker environment.

Create directory and download the target cloud connector package

Create a new parent directory with name container-cc, then create child directory named as sapdownloads. Download the target installation package into the sapdownloads directory.

curl -LO https://tools.hana.ondemand.com/additional/sapcc-2.12.4-linux-x64.zip

In the same directory create a new file Dockerfile and with below content:

FROM centos:7

RUN yum -y install initscripts which unzip wget net-tools less

COPY sapdownloads /tmp/sapdownloads/
WORKDIR /tmp/sapdownloads/

RUN unzip sapcc*.zip && \
	rpm -i sapjvm*.rpm && \
	rpm -i com.sap.scc*.rpm

RUN chsh -s /bin/bash sccadmin

EXPOSE 8443
USER sccadmin
WORKDIR /opt/sap/scc

CMD /opt/sapjvm_8/bin/java \
	-server \
	-XtraceFile=log/vm_@PID_trace.log \
	-XX:+GCHistory \
	-XX:GCHistoryFilename=log/vm_@PID_gc.prf \
	-XX:+HeapDumpOnOutOfMemoryError \
	-XX:+DisableExplicitGC \
	-Xms1024m \
	-Xmx1024m \
	-XX:MaxNewSize=512m \
	-XX:NewSize=512m \
	-XX:+UseConcMarkSweepGC \
	-XX:TargetSurvivorRatio=85 \
	-XX:SurvivorRatio=6 \
	-XX:MaxDirectMemorySize=2G \
	-Dorg.apache.tomcat.util.digester.PROPERTY_SOURCE=com.sap.scc.tomcat.utils.PropertyDigester \
	-Dosgi.requiredJavaVersion=1.6 \
	-Dosgi.install.area=. \
	-DuseNaming=osgi \
	-Dorg.eclipse.equinox.simpleconfigurator.exclusiveInstallation=false \
	-Dcom.sap.core.process=ljs_node \
	-Declipse.ignoreApp=true \
	-Dosgi.noShutdown=true \
	-Dosgi.framework.activeThreadType=normal \
	-Dosgi.embedded.cleanupOnSave=true \
	-Dosgi.usesLimit=30 \
	-Djava.awt.headless=true \
	-Dio.netty.recycler.maxCapacity.default=256 \
	-jar plugins/org.eclipse.equinox.launcher_1.1.0.v20100507.jar

 

The directory structure is as below:

.
├── Dockerfile
└── sapdownloads
    ├── sapcc-2.12.0.1-linux-x64.zip
    └── sapjvm-8.1.053-linux-x64.rpm

Build the docker image

Now you have everything ready to build the Docker image that will enable you to instantiate a Linux-based container running the SAP Cloud Connector. The Dockerfile contains instructions to build that image, and are briefly as follows:

  • base the image on the CentOS Linux distribution (which has a reasonably small footprint)
  • on top of the base image install some core tools
  • copy across, from the host (your machine) to the image, the two files you downloaded (the SAP JVM and the SAP Cloud Connector component)
  • unpack and install the SAP JVM and SAP Cloud Connector
  • set up a shell & user (sccadmin) and instructions to start up the SAP Cloud Connector for when a container is created

In the container-scc/ directory (where the Dockerfile file is located), build the image as follows:

docker build -t scc .

You can find all the images by below command:

docker image ls --all

 

Instantiate a container

By running below command to initialize new container for cloud connector:

docker run -p 8443:8443 --name myscc -d scc

Now you are running cloud connector client on port 8443 and with name myscc, meanwhile you enable the detached mode.

By running below command to list all the containers you have:

docker container ls --all

You will find your container with name myscc is running and providing service now.

In case you want to restart the container for some reasons you could run below command:

docker container start <contaiername>

Configure Cloud Connector client

Access https://localhost:8443 to get into the home page of Cloud Connector. At the first time you shall need to change the password. The initial username&password is Administrator & manage.

Finally you get into the home page of the cloud connector.

Specify the appropriate details for your subaccount, as follows:

  • Regions – For SAP Business Technology Platform on Alibaba Cloud, the region value shoule be cf.cn40.platform.sapcloud.cn
  • Suaccount – This should be the ID of your subaccount, you can find this subaccount ID from the home page of your subaccount in the cockpit.
  • Login E-mail – This should be the email address for you to login into the subaccount in SAP Business Technology Platform on Alibaba Cloud
  • Password – The password of the login e-mail. Notice that if you already enabled the two-factor authentication for your login user, you should format the password as password+passcode (no need to input +).

 

Click the arrow button of the subaccount in the Subaccount Dashboard, you will get into the detail page of the connected subaccount:

 

Now you complete all the necessary steps to build the connection with the SAP Business Technology Platform on Alibaba Cloud. Congratulations!

Resources

Cloud Connector on SAP Help Portal

Assigned Tags

      3 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Markus Tolksdorf
      Markus Tolksdorf

      Hi Marco,

      using the portable has some drawbacks as it cannot be upgraded. Better approach is to use the RPM as a basis for the docker container and certainly a supported OS image (SLES or RHEL). Regarding the region selection. To make it nicer, you could also define a Custom Region in Configuration –> Cloud –> Custom Regions.
      This newly defined region can then be selected from the list when adding a new subaccount.

      Best regards,
      Markus

      Author's profile photo Marco Huang
      Marco Huang
      Blog Post Author

      Hi Markus,

      Thank you for your comment! I am fully agree with you.

      Defintely it is better to use the RPM as the basis for the docker container. This article is to introduce Cloud Connector in SAP Cloud Platform on Alicloud. The key point honestly is just the region url for landscape on Alicloud.

      You are right, new configured region can be saved automatically(whatever it is an available region or not), and all the configured regions can be found in the configuration page.

       

      Regards,

      Marco

       

      Author's profile photo Somnath Paul
      Somnath Paul

      Hello Marco,

      Thanks for sharing this blog post. I was trying to follow and stuck with running the container successfully. I could see in my docker log below error message been thrown:

      Error: Unable to access jarfile plugins/org.eclipse.equinox.launcher_1.1.0.v20100507.jar

      I downloaded latest JVM from the sap tool site:

      sapjvm-8.1.072-linux-x64.rpm

      Could you please provide some inputs about what is wrong and how to get this fixed?

       

      • Thank You, Somnath