Fiori: technical installation and configuration of

one app from A - Z

Posted by M. Stitselaar in SAP for Mobile on Jun 10, 2014 1:52:36 AM
inShare

Now that the Fiori apps are included within the SAP software, I wanted to know (as a SAP technical
basis consultant) what the steps and the effort would be to get one app up-and-running.
Although there is a lot of Fiori documentation available, I had trouble to get an overview of the
technical steps to get one Fiori app working.

I realize that the below steps only apply to the system I installed (with the specific release and
patch level) and the app I choose (because each app has specific after care), but it will gave me an
idea what technical steps are needed and where I found the documentation and software.
The app I configured was: MyContacts.

Installation
As I said, this is for me only a way to get hands-on experience with Fiori.
To keep the costs low I choose a system setup with 1 combined frontend and backend system.
So just to be clear: normally you choose a system setup with a separate frontend server (with
Gateway) and backend system (with SAP ERP for example).
I have installed SAP ECC 6.0 Ehp7 and I used the integrated Gateway which comes already out of
the box when you install this system.
Just for your information I installed this SAP ECC system on AWS on a m3.large server.
The installation came automatically with the following patch level:
SAP_BASIS_740_0005
SAP_ABA_740_0005
SAP_GWFND_740_0005
SAP_UI_740_0006

And the installation of SAP ECC 6.0 Ehp7 came with kernel version 741

Patches and add-ons

To get the basis of the system up-to-date I installed the following patches via SPAM:
SAP_GWFND patch 6
SAP_UI patch 7 and 8

And I installed the FIORI ERP APPLICATIONS X2 1.0 as add-ons via transaction SAINT.
The software you can download from http://service.sap.com/support > Software download >
Installation and upgrades > A-Z index > F > SAP Fiori > SAP Fiori for Suite > FIORI ERP
APPLICATIONS X2
When you go there you will see 5 downloadable objects:
But out of these 5, I only had to install the 2 UI add-ons via SAINT.
The 3 GBX are not needed as they are already in the system (included in the EA-APPL).
When you try to install these GBX you get the message:

So now we have the basic installation and patching done

The patch level in SPAM looks like:
We can start with the configuration part.

Configuration general
Activate services
Activate the following services (under default_host>sap) via transaction SICF:
opu > utils > initial_logon
opu > odata > ui2
public > bc > ui5_ui5
public > bc > ui2
public > opu > resources
public> myssocntl
bc > ui2 > start_up
bc > ui5_ui5 > ui2 > launchpage
bc > ui5_ui5 > ui2 > tilechips
bc > ui5_ui5 > ui2 > ushell
bc > ui5_ui5 > sap > arsrvc_lpd_c
bc > ui5_ui5 > sap > arsrvc_sm
bc > ui5_ui5 > sap > arsrvc_spb_admn
bc > ui5_ui5 > sap > arsrvc_suite_pb
bc > ui5_ui5 > sap > arsrvc_upb_admn
bc > ui5_ui5 > sap > ar_srvc_launch
bc > ui5_ui5 > sap > ar_srvc_news

Create a trusted RFC between Gateway and Backend system.

As I said, to keep the costs low I have a combined frontend and backend system setup.
So I only created in transaction SM59 an RFC connection to itself.
It should have the nameconvention: <SID>CLNT<CLIENT>.
And in the Logon & Security tab it should use the current user.
In case you use a separate frontend and backend system, you have to create a trusted RFC
connection.
So on each system create an RFC destination to the other system and make it trusting via
transaction SMT1.

Creating the SAP System Alias for Applications

SAP Transaction SPRO > SAP NetWeaver > Gateway > Odata Channel > Configuration >
Connection Settings > SAP NetWeaver Gateway to SAP System > Manage SAP System
Aliases
Here we have to create a new entry.
I created the entry with the name ERP. Use the RFC destination that was created in the previous
step.

Activation of SAP NetWeaver Gateway

SAP Transaction SPRO > SAP NetWeaver > Gateway > Odata Channel > Configuration >
Connection Settings > Activate or Deactivate SAP NetWeaver Gateway
Here we have to choose "Activate".

Add Gateway and UI5 Services

 SAP transaction /IWFND/MAINT_SERVICE
Choose Add Service.
Maintain local in System Alias field and choose Enter.
A list of services now appear who are not yet activated:

Now we select the services that need to be activated.

In this case we will do: LAUNCHPAD
Enter the Package the object shall be assigned to. In case the objects are not transported select
Local Object (this is what I did).
Choose Enter.
Confirm the information message that the metadata was loaded successfully.
Perform the same steps that you just did for LAUNCHPAD, but now for:
PAGEBUILDER_SERVICE_V_0_1
PAGE_BUILDER_CONF
PAGE_BUILDER_CUST
PAGE_BUILDER_PERS
QUICKVIEW
TRANSPORT
INTEROP

Configuration Fiori app specific

The app I configured was MyContact.
The configuration for the specific configuration can be found in the SAP Help.

First I activated the related service in transaction SICF.

I searched for *mycontact* and activated it:
Second I activated the specific app with transaction /IWFND/MAINT_SERVICE
We see that MyContact has no system alias assigned yet:

Add a system alias.

Only fill in the Service Doc Identifier: in this case search for SD_MYCONTACTS
And use the created alias ERP (which is an RFC to this system itself, because the Gateway and
backend system are one and the same)
 The result:

We can already test this service to see of we get an error by clicking on the "Call Browser"-button in
the left corner window.
I got the message "This XML file does not appear to have any style information associated with it.
The document tree is shown below."
So no error is shown.

FYI: Gateway errors can be show via transaction /IWFND/ERROR_LOG

Authorizations
I created a user TESTFIORI.
End users must have authorization object S_RFCACL assigned to them before they can use a trusted
connection.

In transaction PFCG I filled in the following roles:

SAP_SD_MYCONT_APP
SAP_SD_BCR_FIELDSALESREP

For both roles I did the following:

Go into change mode (we need the "Authorizations"-tab and "Users"-tab to be green)
 Goto "Authorizations"-tab and Change autorisation data. Save and Generate the
authorizations (normally a functional authorization colleague will perform this action for you)
Goto "Users"-tab and add your TESTFIORI user to the list of users. After this perform a User
Comparison > Complete comparison
Both tabs should be green now.

We also need to add some basic Fiori authorizations.

I decided to add them to the SAP_SD_MYCONT_APP as this user already has this role (not so nice
maybe, but this is just used as a demo).
So on in transaction PFCG authorization tab of SAP_SD_MYCONT_APP go to Change Authorization
Data under the Maintain Authorization Data and Generate Profiles section.
Select Edit > "Insert authorization(s) > From template..."
I choose the following two (one by one):
/IWFND/RT_GW_USER
/IWBEP/RT_MGW_USR
After this again Save and Generate.

Testing
First I want in the Launchpad designer to create a specific group for this app.
Start the Fiori Launchpad Designer via:
http://<hostname>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html

First time we start we see not much:

Create a new catalog by clicking on the + sign in the left corner.

And create also a new Group by going to the Group tab and click on the + sign.

Now add an app in this newly created group:

Click on the + sign and add MyContacts:
The result:

Now we have to go back to SAP transaction PFCG and add this newly created group to the user
TESTFIORI.
We edit the role SAP_SD_MYCONT_APP which this user TESTFIORI already has.
Goto "Menu"-tab and in the button-bar change the "Transaction"-button so that it becomes the
"Group"-button.
Choose the group we created in the Designer:
Now start the Fiori Launchpad
http://<hostname>:<port>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html
and logon with the newly created user.

There are more apps shown but this is because they came along also with the patches I installed.
When I click on the MyContacts app:
There is no data in the system as I newly installed it, but for me this was what I wanted to see: an
app in the Fiori Launchpad .

And it also works form my smart phone:

 Troubleshooting
During the installation and configuration I ran into a number of issues.
They can be prevented when you perform the steps in the above order.
To prevent some basic mistakes, remember that there is a need for:
Patching Gateway and SAP_UI
General configuration & authorization for basic Fiori
App specific configuration & authorization
Opening the ICM server port of the SAP system in firewall (if you want to access it via public
Internet via your mobile device)

Troubleshooting tips:
SU53 to see what autorization you miss
/IWFND/ERROR_LOG to see the application logs
dev_icm to see the errors in the ICM trace

Summary of the effort

My technical effort was:
Setup AWS system + download software = 1 day
Installation ECC system + patching = 2 days
Configuration general + Fiori app specific = 2 day
Testing and documentation = 1 day

Of course this was just a simple test with a combined frontend / backend system and only one app.
But also with this limited setup for myself I got a feeling for the steps that a technical basis
consultant needs to perform.

It is also possible to deploy a complete preconfigured Fiori solution on AWS via the CAL (Cloud
Appliance Library).
The steps for this are described in my next blog.

Best regards,
Marco