ADS Installation Quick Guide September 2023 - V1.5

Installation Quick Guide
Adobe Document Services
September 2023
Version 1.5
Demo21 - Installation Quick Guide
1 Introduction ............................................................................................................................................. 3
2 Install SAP Host Agent: .......................................................................................................................... 4
3 Install the ADS Platform ......................................................................................................................... 5
4 System rename for the SAP NetWeaver Java Instance ...................................................................... 12
5 ADS Configuration................................................................................................................................ 24
6 ADS Testing ......................................................................................................................................... 30
7 SLD Post Activities ............................................................................................................................... 31
8 Troubleshooting.................................................................................................................................... 42
2
1 Introduction
1.1 General
Please make sure you have copied all files from the download to a local drive on your Linux box, i.e. /tmp.
You should have the following content available:
After installation you will have the following setup:
J2E SAP Sybase Database
J2E SAP NetWeaver Application Server Java Instance 10
SCS Instance Instance 11
1.2 System requirements

• Disk: 120 GB
• Memory: 64 GB
1.3 Predefined User

Java Admin (J2EE): Administrator
Password: jk366SAP
1.4 Preparation
You need to download the following components from Service Marketplace:
• Java
o 51050829_1 and 51050829_2
• Software Provisioning Manager 1.0 for Linux (SWPM)
3
2 Install SAP Host Agent:

2.1 Procedure
• Log on as a user with root authorization.
• Change to the directory to which you extracted the SAPHOSTAGENT<SP-version>.SAR archive.
• Start the installation by entering the following command:
./saphostexec -install
The progress of the installation is displayed on the command line.
Create the following directory:
mkdir /usr/sap/tmp
The administrator user sapadm of the SAP Host Agent is created automatically during the installation, but
it does not get assigned a password. You can assign a password after the installation has finished (see
next step).
If required, assign a password to the sapadm user by entering the following command:
passwd sapadm
After the installation has finished successfully, you can check whether SAP Host Agent is up and running
by executing the following command from the directory of the SAP Host Agent executables:
/usr/sap/hostctrl/exe/saphostexec -status
4
3 Install the ADS Platform

3.1 SWPM
We need to create the user j2eadm.
• Start the SWPM → ./sapinst
Open the URL indicated.
5
Accept the security risk and continue.
Logon as user root.
6
7
8
9
10
3.2 Unpack
• Change to your temp directory where you have all the files, i.e. /tmp/ADS
• Unpack the files in the following sequence:
cat dblog.tgz-* | tar -zpxvf - -C / (expected runtime 3 Min.)
cat dbdata.tgz-* | tar -zpxvf - -C / (expected runtime 3 - 5 Min.)
cat dbexe.tgz-* | tar -zpxvf - -C / (expected runtime 3 - 5 Min.)
cat usrsap.tgz-* | tar -zpxvf - -C / (expected runtime 3 Min.)
cat sapmnt.tgz-* | tar -zpxvf - -C / (expected runtime 3 Min.)
11
4 System rename for the SAP NetWeaver Java Instance

4.1 SWPM for System Rename
➔ Change directory to /usr/sap/J2E/SYS/profile
➔ Delete all profiles except the files listed below:
Start the SWPM:
12
13
14
Hint: Instance numbers will be 10 and 11.
15
16
Please use password Final_12 for all users.
17
18
19
20
Hint: Instance numbers will be 10 and 11.
21
22
4.2 Start / Stop ASE Database
su – j2eadm
startdb
stopdb
4.3 Start / Stop and checking your ADS instance
su – j2eadm
sapcontrol -nr 10 -function StartSystem
sapcontrol -nr 10 -function StopSystem
sapcontrol -nr 10 -function GetSystemInstanceList
23
5 ADS Configuration
5.1 Steps in J2EE
• URL: http://<your ADS host>.<your FQDN>:51000/nwa
• User/Pwd: administrator / jk366SAP
5.1.1 Check User

• set new pwd for ADSUSER (<password>) in User Management (later to be used in ABAP
RFC “ADS”)
• In case user has to be created, see below group and role that has to be assigned:
24
5.1.2 Create destination to S4H (naming convention: FP_ICF_DATA_<SID>)

In NetweaverAdministrator
-> Configuration
-> Destinations -> create
http://help.sap.com/saphelp_nwpi711/helpdata/de/14/3e19736e574ca78e20fc7ae2e11010/content.htm
Name: FP_ICF_K00
! Please note that full-qualifier will lead to error when doing the final ping test !
! Please only enter server-name and port !
25
➔ Use Basic authentication

➔ ADS_AGENT must exist in S4H/100
➔ PING Test
➔ Can be ignored
5.2 Steps in Backend S4H

Create service user ADS_AGENT with password <your password> in client 100 and add following roles:
SAP_BC_FPADS_ICF
SAP_BC_FP_ICF
➔ Save
26
5.2.1 Generate roles and make a user comparison to ADS_AGENT
5.2.2 Adjust RFC connection to J2EE

SM59 -> http-connection to external server
-> Adjust RFC ADS
-> enter target host (to J2EE) and port
-> Path Prefix /AdobeDocumentServices/Config?style=rpc
27
If you get an error after addid the Path "Query string not allowed"
➔ This is not an error, but a warning from SM59. Press enter to continue.
-> adjust user/psswd
28
Connection Test: http Response 405 can be ignored
Make sense for example that the Output Device “LOCL” (Frontend Printer) was set to Device Type PDF1
685571 - Printing SAP Interactive Forms by Adobe
1444342 - Device type-independent printing of ADS forms
➔ Device Attributes
➔ Access method
29
6 ADS Testing
Report FP_TEST_00 (sa38/print preview)
In case of errors, check note 944221 - Error analysis for problems in form processing
30
7 SLD Post Activities

The following operations are optional only if you register the system on your own SLD available in the
landscape. Here only the work from point 7.1.6 is necessary and if you want to use the new functionality
.........
7.1 Steps in J2EE

• URL: http://<your ADS host>.<your FQDN>:51000/sld/index.html
7.1.1 Home Settings Server Configuration

Administration -> Settings -> Server Configuration -> Object Server set to your new hostname
7.1.2 SLD Data Supplier

Administration -> Settings -> Parameters -> Section “All”
➔ Adapt GatewayHost to your new Hostname
31
7.1.3 Verify Hosts, Hostname

➔ File System -> etc -> HOSTNAME and hosts if new host is included
7.1.4 SLD Data Supplier JCo Server Configuration

• URL: http://<your ADS host>.<your FQDN>:51000/startPage
➔ SAP NetWeaver Administrator
Configuration -> Infrastructure -> JCo Server Configuration
➔ Verify and adapt all seen Server Names to the right new hostname
7.1.5 Destination
7.1.5.1 HTTP Destination SLD_DataSupplier

Configuration -> Infrastructure -> Destinations
➔ Adapt SLD_DataSupplier to the new host “Connection and Transport”
32
➔ Adapt SLD_DataSupplier to the new host “Logon Data”

o Password is jk366SAP
➔ Ping HTTP Destination SLD_DataSupplier
33
7.1.5.2 RFC Destination SAPSLDAPI_J2E_REP

➔ -> Adapt to the new installed Demo21 system
➔ Ping RFC Destination SAPSLDAPI_J2E_REP
34
7.1.6 Register Demo21 System

See also KBA 2276637 - How to configure the rz70 for sending data via RFC
➔ http see KBA 2188401
➔ SE38
➔ Report RSLDHTTPCONF
➔ Create RFC on second tab
➔ Add on first tab
➔
➔
➔
➔ Test and verify Data if new technical system is available in SLD (old S4H can be deleted)
http://linux-1rzq.kmudemo.site:51000/sld
35
36
7.1.7 Business System Wizard
37
➔ Finish
38
7.1.8 Test LCR Interface

➔ Adapt the corresponding RFC within the new installed Demo21 System to new SLD
o TCP/IP Connections
Verify if JCo Server was up and running within SLD (Administration -> Details -> JCoServers)
39
7.1.9 SLD check

TR SLDCheck in the new Demo21 System
40
7.1.10 SLDAPICUST check

TR SLDAPICUST
➔ Adapt before testing the new SLD host name details and the password of Administrator
➔ Test
41
8 Troubleshooting
8.1.1 SAP Host Agent installation fails
Error: groupadd exit with status 127 …..
Solution:
Use the SWPM to create the SAP Host Agent User. Then continue with the steps in in this guide.
◼ System Rename → Preparation → Operating System Users and Groups
42
8.1.2 Java system does not start due to "cannot find jc.sap" error
➔ See KBA 1924672
43

ADS Installation Quick Guide September 2023 - V1.5

Uploaded by

Copyright:

Available Formats

ADS Installation Quick Guide September 2023 - V1.5

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

ADS Installation Quick Guide September 2023 - V1.5

Uploaded by

Copyright:

Available Formats

Installation Quick Guide

Adobe Document Services

2 Install SAP Host Agent: .......................................................................................................................... 4

3 Install the ADS Platform ......................................................................................................................... 5

4 System rename for the SAP NetWeaver Java Instance ...................................................................... 12

6 ADS Testing ......................................................................................................................................... 30

7 SLD Post Activities ............................................................................................................................... 31

You should have the following content available:

After installation you will have the following setup:

J2E SAP Sybase Database

J2E SAP NetWeaver Application Server Java Instance 10

SCS Instance Instance 11

1.2 System requirements

1.3 Predefined User

2 Install SAP Host Agent:

The progress of the installation is displayed on the command line.

Create the following directory:

3 Install the ADS Platform

• Start the SWPM → ./sapinst

Open the URL indicated.

Accept the security risk and continue.

Logon as user root.

cat dblog.tgz-* | tar -zpxvf - -C / (expected runtime 3 Min.)

cat dbdata.tgz-* | tar -zpxvf - -C / (expected runtime 3 - 5 Min.)

cat dbexe.tgz-* | tar -zpxvf - -C / (expected runtime 3 - 5 Min.)

cat usrsap.tgz-* | tar -zpxvf - -C / (expected runtime 3 Min.)

cat sapmnt.tgz-* | tar -zpxvf - -C / (expected runtime 3 Min.)

4 System rename for the SAP NetWeaver Java Instance

Start the SWPM:

Hint: Instance numbers will be 10 and 11.

Please use password Final_12 for all users.

Hint: Instance numbers will be 10 and 11.

4.2 Start / Stop ASE Database

4.3 Start / Stop and checking your ADS instance

sapcontrol -nr 10 -function StartSystem

sapcontrol -nr 10 -function StopSystem

sapcontrol -nr 10 -function GetSystemInstanceList

5.1.1 Check User

5.1.2 Create destination to S4H (naming convention: FP_ICF_DATA_<SID>)

-> Destinations -> create

! Please only enter server-name and port !

➔ Use Basic authentication

5.2 Steps in Backend S4H

5.2.1 Generate roles and make a user comparison to ADS_AGENT

5.2.2 Adjust RFC connection to J2EE

-> Adjust RFC ADS

-> enter target host (to J2EE) and port

-> Path Prefix /AdobeDocumentServices/Config?style=rpc

-> adjust user/psswd

Connection Test: http Response 405 can be ignored

685571 - Printing SAP Interactive Forms by Adobe

1444342 - Device type-independent printing of ADS forms

7 SLD Post Activities

7.1 Steps in J2EE

7.1.1 Home Settings Server Configuration

7.1.2 SLD Data Supplier

➔ Adapt GatewayHost to your new Hostname

7.1.3 Verify Hosts, Hostname

7.1.4 SLD Data Supplier JCo Server Configuration