Import Data from File Server

For importing data, a file server location whitelist must be configured. Only file server paths
allowed by this whitelist can be accessed when creating a model from a file, or importing data
from files. For exporting models, another file server location whitelist must be configured. Only
file server paths allowed by this whitelist can be accessed when exporting a model.

1. Install Java Standard Edition Runtime Environment (JRE)

Java Standard Edition Runtime Environment (JRE) version 7 or higher must be installed.
To download the latest JRE, please visit Oracle.com.

1
 It’s also recommended to set JRE_HOME environment variable to point to your JRE
installation folder.

2. Install SAP JVM

1. Download (or locate an existing) SAP JVM from SAP Development Tools Website.

For supported SAP JVM versions, see Prerequisites.

2
 2. Extract the SAP JVM on the server where the SAP CP CC will be installed, and note the
folder location.

EXAMPLE: Unzip the file into C:\SAPJVM\sapjvm_8.

3. Installing SAP Cloud Platform Cloud Connector on premise

1. Download the latest version per your operating system SAP Development Tools
Website.

3
EXAMPLE: In case of Microsoft Windows, download .msi file.

4
2. Start the installation of the SAP Cloud Platform Cloud Connector.

5
 NOTES:

• Under Select JDK Installation, make sure to point to SAP JVM folder installed above.

• Ensure that you select the option to start the cloud connector after installation.

4. Set Up Data Acquisition with SAP CP Cloud Connector

Before the initial configuration of the SAP CP CC you, or the owner of your
organization’s S-User account, must open an SAP Product Support Incident at the
following link: https://launchpad.support.sap.com/#incident/solution using the
component LOD-ANA-BI.

6
Your support ticket should include:

• A statement about wanting to set up data acquisition with the SAP CP CC

• Your SAP Analytics Cloud tenant URL
• Your S-User account ID

EXAMPLE:

Dear SAP Support,

I would like to set up data acquisition with the SAP Cloud Platform
Cloud Connector in SAP Analytics Cloud.
My tenant URL is: <your Tenant URL>
My S-User ID is: <your S-User>

NOTE: Once our Operations team has configured a subaccount for data acquisition on
your SAP Analytics Cloud system, you will be able to complete the following steps
successfully. Depending on the day and our workload, typically we will get back to you
within an hour or the next business day.

7
 If you do not know your S-User account ID, contact the person within your company who
is handling your SAP account. If you do not know who this person is, contact SAP Support.

5. Install SAP Analytics Cloud Agent

The SAP Analytics Cloud Agent (SAC Agent) is a WAR file that can be deployed on
Tomcat application server. There are two ways to do this:

1. Install a separate Tomcat application server to deploy SAC Agent WAR file as
described in the Install Apache Tomcat section below
2. Use an existing Tomcat Java application server running in your environment

NOTE: It is recommended that you install a separate Tomcat server since the SAC
Agent may require updates. This way you can take advantage of the new connectivity
types being offered in SAP Analytics Cloud. For more information, see Updating SAP
Analytics Cloud Agent.

1. Install Apache Tomcat

1. To install Apache Tomcat, please visit Apache Tomcat Website and

download the 32/64-bit Windows Server Installer.

NOTE: Apache Tomcat 7 or higher, as well as 64-bit Apache Tomcat must be installed.

8
 2. Once you download Apache Tomcat, start the installation.

NOTE: Under Java Virtual Machine make sure to point to SAP JVM folder installed
above.

9
3. Once you complete the installation, navigate to the “bin” folder
within the Tomcat destination folder and double click Tomcat8w.exe

4. In the Tomcat properties directory, navigate to the Java tab and

increase the Initial Memory Pool and Maximum Memory Pool values
to 1024MB and 2048MB respectively. This will ensure you avoid any
timeout errors when acquiring larger data sets in SAC.

10
 5. Start Tomcat if it’s not running.

NOTE: Under the General tab you can choose the Startup type as Automatic. This will
enable Tomcat to run automatically after startup. You can also start/stop the Tomcat
application by clicking on the ‘Start’ or ‘Stop’ buttons.

11
 2. Deploy SAP Analytics Cloud Agent

1. Go to SAP Software Downloads page and enter ‘SAP Analytics Cloud Agent’ into
the search bar at the top.

2. Click the SAP Analytics Cloud Agent and download the zip file of the latest version.

12
3. Extract the zip file and copy the file C4A_AGENT.war to your Tomcat > webapps
directory

4. Create a user for the SAP Analytics Cloud agent and assign the Services role to
the user
A. Navigate to Tomcat > conf directory:

13
 B. To create a user, open the tomcat-users.xml file in Notepad and add the
following lines:

<role rolename="Services"/>

<user username="CloudAgent" password="Welcome1" roles="Services"/>

14
NOTE: Replace CloudAgent with a user name for the SAP Analytics Cloud agent, and
replace Welcome1 with a password for the user.

15
The user credentials will be needed later for setting up the connection to SAP
Analytics Cloud Agent. For more information about how to create the user and assign
the role, see Configuring Manager Application Access.

5. Save the tomcat-users.xml file.

6. Start Tomcat by double clicking the Tomcat8.exe file located in the Tomcat
installation folder.

EXAMPLE: C:\Program Files\Apache Software Foundation\Tomcat 8.5\bin

7. To ensure that Tomcat is up and running, enter your Tomcat server hostname
along with default Tomcat port 8080 in your browser.

NOTE: To find your Tomcat server hostname on Microsoft Windows, navigate to:
Control Panel > System and Security > System.

Your Tomcat server hostname is the same as your Full computer name as shown below.

If your Tomcat is connected, the following screen should appear.

16
 8. Test if the SAP Analytics Cloud Agent installation was successful by opening the
following URL in your browser:
http://<Host>:<Port>/C4A_AGENT/deploymentInfo

EXAMPLE: http://Full_Computer_Name:8080/C4A_AGENT/deploymentInfo

A. If prompted in the browser, provide the necessary information:

• User Name: Agent user name specified in tomcat-users.xml file
• Password: Agent password specified in tomcat-users.xml file
B. The version of the deployed SAP Analytics Cloud Agent should be displayed
like below:

To make this connection work, you will need an Apache Tomcat with SAP Analytics Cloud
Agent and SAP CP Cloud Connector to be setup.

1. Install a separate Tomcat application server to deploy SAC Agent WAR file as
described in the Install Apache Tomcat section below
2. Use an existing Tomcat Java application server running in your environment

6. Configure the SAP CP Cloud Connector

17
1. Launch the SAPCP Cloud Connector administration page and login
using: https://<SAPCPCC_HOST>:<SAPCPCC_PORT>
A. Replace <SAPCPCC_HOST> with the host name of the system where the
cloud connector is installed
B. https://localhost:8443 can be used if accessing from the same machine
where SAP CP CC is installed with 8443 as the default port

NOTE: Depending on your browser, you may encounter an error message such as the
ones below. To proceed, click on the Advanced button for Chrome or click on
‘Continue to this Website’ for Internet Explorer.

2. Login to SAP CP CC. If this is your first login, use the following default credentials:
A. User Name: Administrator
B. Password: manage

18
3. The Initial Setup phase requires two actions:
1. Change the initial password after first login
2. Please choose Master (Primary Installation)

4. Click on Save button

5. The information obtained from SAP Support Incident should be used in the Define
Subaccount dialog to define your subaccount:

19
NOTE: If you access the internet through a proxy, specify your proxy host and port
number otherwise you can leave those blank.

6. Confirm that you are connected in the Connection Information area. You may need to
select the Connect button to start the connection

20
7. Select Cloud to On-Premise > Access Control > + to add new mapping

21
8. In the Backend Type list, select Other SAP System and click on Next

9. In the Protocol list, select HTTP and click on Next

NOTE: You can choose HTTPS if SSL is configured on the Apache Tomcat instance
where SAP Analytics Cloud is deployed.

22
10. Enter the internal host name and internal port number of the Tomcat server where
the SAP Analytics Cloud Agent is running.

11. Enter a Virtual Host name and Virtual Port

The default Virtual Host and Virtual Port are the internal host and port specified
previously. You can keep the default values or you can rename them so that the
internal host name and port are not exposed. The virtual host name and port will be
used when configuring the SAP Analytics Cloud Agent.

12. In the Principal Type list, select None

23
13. (Optional) Add a description for the system and click Next
14. Select Check Internal Host to ensure the SAP CP Cloud Connector can access the
SAP Analytics Cloud Agent, and then select Finish

15. If the mapping was successful, the Check Result field will display as Reachable

24
16. Select the newly added system
17. Add Resource
A. In the Resources Accessible area, select + to add new resource

B. Set the URL Path to /C4A_AGENT/

C. Choose Path and all sub-paths, and then select Save

25
 D. Both Statuses next to the Mapping and Resources should appear in green
state:

7. Configure SAP Analytics Cloud Agent

1. Log on to SAP Analytics Cloud with an administrator account and go

to System > Administration

26
2. Navigate to the Datasource Configuration tab and select pencil icon in right upper
corner to edit
3. In the SAP Analytics Cloud agent section, enter the following information:
• Host: Virtual host specified during the system mapping in SAP CP Cloud
Connector
• Port: Virtual port specified during the system mapping in SAP CP Cloud
Connector
• Username: Agent user name specified in tomcat-users.xml file
• Password: Agent password specified in tomcat-users.xml file

27
 4. Click on Save icon in the right upper corner
5. Click on Check configuration button. The following green popup states that you’ve
configured everything properly:

8. Configure a connection to your local file server

NOTE: Any users under the specific tenant will have access to all files defined within the
whitelist.

1. Create a Whitelist.txt file on the same computer where your Tomcat is running
and the SAP Analytics Cloud Agent is deployed.
A. This file should contain the path(s) to your file(s) you would like to have
white listed and accessible from SAP Analytics Cloud.
B. Add a path or multiple paths to the file where your files are located.

28
Example:
C:\FileServer\MyData
C:\FileServer\MyCompanyData

C. Save the file into a folder, for example C:\FileServer\Whitelist.txt

2. Set the operating system environment variable

SAP_CLOUD_AGENT_FILE_SERVER_WHITELIST_PATH to the location of the
Whitelist.txt.
▪ Variable name for import:
SAP_CLOUD_AGENT_FILE_SERVER_WHITELIST_PATH
▪ Variable value: C:\FileServer\Whitelist.txt

29
NOTE: If you want to set up export to your file system you’ll need to specify the
environment variable
SAP_CLOUD_AGENT_FILE_SERVER_EXPORT_WHITELIST_PATH pointing to the
Whitelist.txt file.

3. Restart Apache Tomcat as described at the end of How to Install Apache

Tomcat
4. Go to Main Menu > System > Administration
• Turn on Allow model import from File Server for model import
• For model export, turn on Allow model export to File Server

5. Click Add Connection > Import Data Connection > File Server

30
 6. Enter the required connection information:
• Connection Name
• Description
• Folder Path, as defined in the Whitelist.txt

NOTE: You must specify separate connections per each path defined in the
Whitelist.txt.

31
 7. Click Create

The new connection is added to the list of connections on the Connections screen

8. You can use the recently created File Server Connection in Menu > Modeler to
choose a file from the folder location and to create a model

32