Overview:

Roles

  • Corporate IT personas: IT administrator installs SAP HANA Cloud Connector in his corporate IT landscape.
  • SAP HANA Cloud Platform personas: HCP administrator prepares HCP account, sets up SAP HCP, cloud connector and defines connectivity destinations.

Systems, Tools, Services:

  • on host OS: VirtualBox, SAP Development Tools, SAP HANA Cloud Platform cockpit, SAP HANA Cloud Connector Administrator (both in Google Chrome browser)

Downloads

Download LinkDescriptionContext
s4h-http-access-control.zipAccess control definitionStep 3: Add Access to S/4HANA Back-End System
s4h-onpremise-http.propertiesHTTP connectivity destinationStep 4: Create HTTP Destination in HCP Trial Account

Step 1: Install SAP HANA Cloud Connector in Linux VM

1.1 Download SAP HANA Cloud Connector for Linux

  1. Open the Google Chrome web browser on your host OS and open page SAP Development Tools.
  2. Go to Cloud and scroll to section SAP HANA Cloud Connector.

  3. Download the Linux installer with link sapcc-XXX-linux-x64.zip and read and agree to the following End User License Agreement. Click button I Have Read And Agree to start the download.

Result: The Linux installer for SAP HANA Cloud connector is now available on your host OS.

1.2 Mount a Shared Download Folder in Linux VM

The Linux installer for SAP HANA Cloud connector is stored in a download folder of your host OS. To run it from within the Linux VM (guest OS) you need to mount a shared download folder from your local operating system:

  1. First test the system status of SAP NetWeaver AS ABAP 7.50 as described in section 6.5 of unit 6 in week 1:
  2. In the Linux VM window, logon to the Linux desktop, open the command shell (XTerm on Gnome, Konsole on KDE) and enter sapcontrol -nr 00 -function GetProcessList to check that the processes are running and are all GREEN. When SAP NetWeaver AS ABAP 7.50 is successfully running the command returns an OK message.

  3. In the VirtualBox Manager on your host OS:
    • Select the Linux VM instance.
    • Click Settings and select the Shared Folders entry in the Settings dialog.
    • Click on + to add a new shared folder.
    • Select the Folder Path to the folder containing the SAP HANA Cloud Connector for Linux installer.
    • In Folder Name enter scc and click OK.
    • Click OK.

  4. In the Linux VM window (guest OS):
    • Open the command shell via start menu (enter Konsole in KDE desktop or Xterm in GNU desktop). By default the command shell opens the admin user’s home directory <admin user name>@vhcalnplci.

    • Enter command mkdir scc to create a new folder for the SAP HANA Cloud Connector installation.
    • Enter command sudo mount -t vboxsf scc scc and press Return. Enter your Linux OS admin password.
    • Enter cd scc and then ls to view the sapcc-XXX-linux-x64.zip installation ZIP that is shared from the host OS download folder.

1.2 Run Installer for SAP HANA Cloud Connector in Linux VM

  1. Enter command sudo unzip sapcc-XXX-linux-x64.zip (replace placeholder XXX with the given release version, e.g. 2.9.0.2).
  2. Enter command sudo rpm -i com.sap.scc-ui-XXX.x86_64.rpm (replace XXX with the given version number e.g. 2.9.0-7).

    Note: you can autocomplete the package name with the Tab key while entering the command sudo rpm -i com..

  3. Press the Return key to start the installation process:

  4. Enter command sudo service scc_daemon status.

Result: SAP HANA Cloud Connector is successfully installed and the connector daemon is running on the Linux guest OS.

1.3 Take a snapshot of the Linux VM in VirtualBox Manager

  1. In the Linux VM window select menu item Machine > Take snapshot.
  2. Enter snapshot name NetWeaver & Cloud Connector and click OK.

Top

Step 2: Connect SAP HANA Cloud Connector with Your HCP Trial Account

Once the cloud connector has been installed and the connector daemon has been started, you can log on and perform the initial configuration. You also establish a connection between the cloud connector and your HCP trial account.

2.1 Set up Initial Configuration

  1. Open the Google Chrome web browser on your host OS and enter URL https://localhost:8443.
  2. In Google Chrome you get informed that your connection is not secure. Press the Advanced button and click the link Proceed to localhost (unsafe).

  3. Add a bookmark to the SAP HANA Cloud Connector Login page, e. g. named SCC for SAP Cloud Connector (to add a new bookmark see Week 2 - Unit 1 for more details.).

  4. Enter user credentials:

    • User Name: Administrator
    • Password: manage

  5. Apply the following steps for the initial setup of the new cloud connector instance:

    • Change the admin password from manage to one of your choice.
    • Keep the default installation type Master (Primary installation) selected.
    • Click Save.

  6. Add the very first HCP account (i.e. your HCP trial account) by entering the following form fields:

    First Account

    PropertyValue
    Landscape Hosthanatrial.ondemand.com
    Account Namep19XXXtrial (paste it from the clipboard, see step 2 in the note below)
    Display Namee.g. My Trial Account
    Account Userp194XXX (paste it from the clipboard, see step 3 in the note below)
    Passwordenter your own password!
    Location IDmust be kept empty!

    Warning: You must keep the Location ID field empty, otherwise the HTTP destination that is imported later in step 4 won’t work at runtime! In order to route requests to a cloud connector with a Location ID it also needs to be configured in the respective destinations what is not the case for our imported destination. For more technical details see SAP HANA Cloud Connector Help - Initial Configuration.

    Note: How to get your HCP trial account name and user:

    • Step 1: In Google Chrome browser open new tab and logon to HCP Cockpit with URL https://account.hanatrial.ondemand.com. Enter your user credentials based on Week 1 > Unit 5 > Step: Get SAP HANA Cloud Platform trial account.
    • Step 2: On the Overview page scroll to section Account Information and copy the Account name into the clipboard, e.g. p1942128127trial.

    • Step 3: In the HCP cockpit toolbar press the user icon at the right side. Copy the ID into the clipboard, e.g. P1942128127.

    HTTPS Proxy

    Enter Host and Port fields if you are working behind a firewall with a proxy.

  7. Click Save.

Result: After the initial configuration was successfully set up the Connector view displays a new dashboard entry for the newly added HCP trial account.

Click on tree item Account: My Trial Account to view more account details.

Related Resources: For more details see SAP HANA Cloud Platform Documentation:

2.2 Check Connection in HCP Trial Account

Check connectivity in your HCP trial account:

  1. In Google Chrome browser select the tab with the HCP cockpit.
  2. In HCP cockpit go to Connectivity > Cloud Connectors. The green Connected text indicates, that your HCP trial account is successfully connected with your SAP HANA Cloud Connector installation that is running on your local Linux VM.

Result: You successfully set up the initial configuration of the SAP HANA Cloud Connector that is running on your Linux VM (i.e. in your own corporate network). It is connected with Your HCP trial account hosted on the SAP HANA Cloud Platform trial landscape hanatrial.ondemand.com.

Step 3: Add Access to S/4HANA Back-End System

To allow your HANA Cloud Platform applications to access SAP S/4HANA back-end system on the intranet, you need to insert an extra line into the cloud connector access control management.

3.1 Expose S/4HANA Back-End System with Access Control Definition

Expose the SAP back-end system host to your HCP trial account with the following entry in the access control list:

  1. In Google Chrome browser open the tab with SAP HANA Cloud Connector Administrator or use the browser bookmark SCC you added in Step 2.1.
  2. In the navigation pane select item Account: My Trial Account > Cloud To On-Premise.
  3. Choose tab Access Control to add corporate network hosts that can be accessed from your HCP account.
  4. Download the file s4h-http-access-control.zip.
  5. Click Import button in the toolbar under Mapping Virtual To Internal System and choose the previously downloaded ZIP-file s4h-http-access-control.zip.

Result: A new access control entry is added with the following definition:

StatusVirtual HostInternal HostCheck ResultProtocolBack-end Type
Oks4h:443localhost:44300ReachableHTTPSABAP System

The virtual host s4h:443 specifies the host name to be used for the HTTP destination configuration in SAP HANA Cloud Platform. The virtual host can be a fake name and does not need to exist.

For this backend system we also need to provide the resource URL path(s) that shall be exposed for access from SAP HANA Cloud Platform:

EnabledStatusURL PathAccess Policy
trueOk/sap/Path and all sub-paths

Related Resources: For more details see SAP HANA Cloud Platform Documentation: Configuring Access Control.

3.2 Take another snapshot of the Linux VM in VirtualBox Manager

  1. In the Linux VM window select menu item Machine > Take snapshot.
  2. Enter snapshot name NetWeaver & Cloud Connector Setup and click OK.

3.3 See Exposed Back-End System in HCP Trial Account

Check Cloud Connector Host in your HCP trial account:

  1. In Google Chrome browser select the HCP cockpit tab.
  2. In the Connectivity > Cloud Connectors view a new host entry is added.

Result: Now the cloud knows about the SAP back-end system and can access it via connectivity destinations to be defined next.

(Virtual) HostProtocolBack-End TypeResources
s4h:443HTTPABAP SystemAvailable

Step 4: Create HTTP Destination in HCP Trial Account

Based on the exposed S/4HANA back-end system that is connected with your HCP trial account you now create a new HTTP destination. It points to the virtual back-end host http://s4h:443 and will be used in SAP Web IDE for connecting the UX extension app with OData services exposed by the S/4HANA back-end.

4.1 Add a new Connectivity Destination in HCP Trial Account

To import a new connectivity destination of type HTTP apply the following steps:

  1. In the HCP cockpit tab of your browser open Connectivity > Destinations.
  2. Download the file s4h-onpremise-http.properties.
  3. Click Import Destinations and choose the previously downloaded properties-file s4h-onpremise-http.properties.

    Destination Configuration

    PropertyValue
    Names4h-onpremise-http
    TypeHTTP
    DescriptorS/4HANA HTTP API
    URLhttps://s4h:443
    Proxy TypeOnPremise
    AuthenticationBasicAuthentication
    UserDEVELOPER
    Passwordsee next step.
  4. Enter the password Appl1ance that you assigned to your SAP NetWeaver AS ABAP 7.50 back-end user DEVELOPER in Week 1 - Unit 6.
  5. Click Save.

    The newly imported HTTP destination configuration is displayed in read-only mode:

    Note: The URL https://s4h:443 points to the virtual host s4h:443 as defined before in Step 3.1 Expose S/4HANA Back-End System with Access Control Definition. The additional properties WebIDEEnabled and WebIDEUsage allow SAP Web IDE to call design-time-specific OData services from the ABAP backend (e.g. odata_abap for the OData functionality of SAP Gateway allows SAP Web IDE to access the OData service catalog of the ABAP backend system).

  6. Click Check Connection to test system communication between SAP HANA Cloud Platform and the SAP back-end on network level.

Result: You added a new HTTP destination to your HCP trial account that points to the S/4HANA back-end system and enables OData service access via virtual host http://s4h:443.

Related Resources: For more details see SAP HANA Cloud Platform Documentation:

4.2 Test OData Service Access in SAP Web IDE

With the HTTP destination in place you can use SAP Web IDE to browse the OData services that are exposed by the S/4HANA back-end by means of SAP HANA Cloud connector.

  1. In Google Chrome browser open your SAP Web IDE bookmark from Week 1 - Unit 5 in a new tab.
  2. On the Welcome page in section Create a Project click on New Project from Template.

  3. Click on tile List Report Application and click Next.

  4. Enter “Project Name” Test, “Title” Test and click Next.
  5. In the “Data Connection” step keep the default source Service Catalog selected and choose the system entry S/4HANA HTTP API from the dropdown list to load all exposed services into the table.
  6. In the filter field enter PROD to view all matching OData services including EPM_REF_APPS_PROD_MAN_SRV.

  7. Click Show Details to get closer information on the selected EPM_REF_APPS_PROD_MAN_SRV OData service.

  8. Click the Cancel button in the upper right corner of the template creation dialog. We come back to SAP Web IDE later this week in Unit 5 on the UX extension part.

Result: The SAP HANA Cloud Connector is installed on your Linux VM with a secure connection between your HCP trial account and the SAP back-end system. The OData service EPM_REF_APPS_PROD_MAN_SRV can be selected in SAP Web IDE to build an application consuming it.

Top

< Previous Unit 2Up ^ Week 2Next > Unit 4