SFTP Adapter Installation in PI Environment Adapter... · SFTP Adapter Installation in PI Environment Applies to: SAP NetWeaver PI 7.1, For more information, visit the SOA Management

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2010 SAP AG 1

SFTP Adapter Installation in PI

Environment

Applies to:

SAP NetWeaver PI 7.1, For more information, visit the SOA Management homepage.

Summary

This document clearly explains the step by step procedure for installing SFTP Adapter in PI system.

Author: Prableen Jolly

Company: Accenture Services Private Ltd.

Created on: 22 June 2010

Author Bio

Prableen Jolly has 3+ years of experience as SAP Basis Consultant with Accenture Services Pvt.Ltd.

https://www.sdn.sap.com/irj/sdn/soa-management

SFTP Adapter Installation in PI Environment


© 2010 SAP AG 2

Table of Contents

1. Installation Steps ....................................................................................................................................... 3

Installing the SEEBURGER Software Component Version ......................................................................... 3

Installing the SEEBURGER Common Components.................................................................................... 6

Installing the Adapter ............................................................................................................................... 14

Deploying the Adapter Metadata .............................................................................................................. 18

Setting Up the SSH Keystore ................................................................................................................... 24

Create an SAP XI User for the Certificate Handling .................................................................................. 28

Restart the XI Server/J2EE Engine .......................................................................................................... 29

Related Content .......................................................................................................................................... 30

Disclaimer and Liability Notice ..................................................................................................................... 31



© 2010 SAP AG 3

1. Installation Steps

Installing the SEEBURGER Software Component Version

The SEEBURGER Software component version has to be installed before the adapters and its metadata files can be deployed. This Software Component Version is delivered empty and is only used as a standard location where Seeburger adapters’ metadata can be imported, therefore installing the Seeburger Software Component Version is required for first time installations only, not for updates.

The following steps must be carried out for deployment:

1. Copy the file from

<InstallFolder>\Content\XI3_0_SEEBURGER_EDI_ADAPTER_3.0_of_Seeburger.tpz to the repository server’s import folder (e.g. <ServerSystemId>/global/xi/repository_server/import/).

2. Start the “Integration Repository” GUI via following url:-

http://<hostname>:5<instance_no>00/rep/start/index.jsp



© 2010 SAP AG 4

Specify user name and password to log on.

3. Choose “Import design objects…” from the Tools menu:

Following window will pop up.



© 2010 SAP AG 5

4. Select the file name and click ok.

5. The following screen will appear. Click on the import button.

6. The following screen will appear. Click on close.



© 2010 SAP AG 6

Installing the SEEBURGER Common Components

Before installing adapters and additional modules two sets of “tools” need to be deployed:-

1. SeeXIBaseTools.sca

2. SeeXIExtendedTools.sca

Procedure

1. Open SDM by clicking on the file “RemoteGui.bat” from \usr\sap\SID\DVEBMGS01\SDM\program

2. The following window appears, click on the connect button and enter the password to connect.



© 2010 SAP AG 7

3. Go to “Deployment” tab.



© 2010 SAP AG 8

4. Click on Add button, choose the path of the file to be deployed and click on the choose button.

These files can be found at following locations:-

<Inst.dir>:\Tools\deploy\SeeXIBaseTools.sca

<Inst.dir>:\Tools\deploy\SeeXIExtendedTools.sca



© 2010 SAP AG 9

5. Click on the arrow in the bottom right corner of the screen and select the following options:- Update deployed SDAs/SCAs that have any version Stop when the first error occurs

Then click on the next button.

6. Again click on the next button.



© 2010 SAP AG 10

7. Click on “Start Deployment”

8. Once the deployment is completed successfully, click the confirm button.



© 2010 SAP AG 11

Now, repeat the same steps for deploying SeeXIExtendedTools.sca



© 2010 SAP AG 12

Click on next

Click on “Start Deployment”



© 2010 SAP AG 13



© 2010 SAP AG 14

Installing the Adapter

Deploy the file SFTPAdapter.sca from SDM.

The file can be found at the following location:-

<Inst.dir>:\AdapterSFTP\deploy\SFTPAdapter.sca



© 2010 SAP AG 15



© 2010 SAP AG 16



© 2010 SAP AG 17



© 2010 SAP AG 18

Deploying the Adapter Metadata

The Adapter Metadata file SFTPAdatperMetadata.xml is deployed as follows: 1. Start the Integration Repository (Design).

2. Expand the entry “SEEBURGER_EDI_ADAPTER of seeburger, the following screen appears.

3. Switch to change mode and select both the checkboxes under “Object Attributes” as shown in the screenshot below and save your changes.



© 2010 SAP AG 19

4. On saving the changes, the following screen will appear, click on Close.

5. From the menu, choose Object -> New



© 2010 SAP AG 20

The following screen will appear.

6. Make the entries as per the screenshot below and then click on the create button.



© 2010 SAP AG 21

7. Click on apply

The following screen appears



© 2010 SAP AG 22

8. Click on “Upload XML Description from File” button from the toolbar and specify the path of the

Metadata file and click on open button.

This file is stored in the directory <Inst.dir>:\ AdapterSFTP\metadata\SFTPAdapterMetadata.xml.



© 2010 SAP AG 23

9. Click on save



© 2010 SAP AG 24

Setting Up the SSH Keystore

The SSH requires a server public key for data encryption. The SFTP adapter stores these keys in the SAP J2EE key store. The adapter requires at least 2 different views to be defined in the J2EE key Storage service.

Create the SSH_hosts view as follows:

1. Open the SAP J2EE Administration Tool.

2. Scroll down to Server -> Services -> Key Storage.

3. Click on Create View and enter the name of the view “SSH_hosts” and click ok.



© 2010 SAP AG 25

An entry with the name SSH_Hosts appears.

4. Now again click on Create View button and enter the view name “SSH_CA” and click ok.



© 2010 SAP AG 26

5. Click on the create button in the Entry button group.

Fill in the required details in the screen below. Enter rsa_ca as name, select Store certificate and click on the Generate button.



© 2010 SAP AG 27

7. Click again on the Create button in the entry button group.

8. Fill in the subject properties. Enter dsa_ca as name, select the DSA algorithm, select Store certificate and click on the Generate button.

Note: SSH_CA view should now contain 4 entries: dsa_ca, dsa_ca-cert, rsa_ca and rsa_ca-cert. These are

internal service keys used by the adapter to sign and store the ssh server’s public keys.



© 2010 SAP AG 28

Create an SAP XI User for the Certificate Handling

Start the SAP GUI:

1. Start transaction SU01 and create the user “seeburger” with the password “init”. Assign the role “SAP_J2EE_ADMIN” to the user “seeburger”. Save the user and leave the transaction.

2. Logoff and try to login using the newly created account “seeburger”. After login, the password must be changed. This time use “adapter” as password.

Start the Visual Administrator GUI:

1. Select Server > Services > Connector Container.

2. Select Connectors > Connector 1.0 > seeburger.com/com.seeburger.xi.<Module>

3. Click in the right window on “Managed Connection Factory”.

4. Click in the right window on the panel “Properties”.

5. Set the value for the “adapterUser” key to “seeburger”.

6. Set the value for the “adapterUserPassword” key to “adapter”.

7. Save the changes with the symbol “Save” in the menu bar.



© 2010 SAP AG 29

Restart the XI Server/J2EE Engine

Restart the XI server.



© 2010 SAP AG 30

Related Content

SAP Note 1265127

www.help.sap.com

www.sdn.sap.com

For more information, visit the SOA Management homepage.

https://service.sap.com/sap/support/notes/1265127

http://www.help.sap.com/

http://www.sdn.sap.com/

https://www.sdn.sap.com/irj/sdn/soa-management



© 2010 SAP AG 31

Disclaimer and Liability Notice

This document may discuss sample coding or other information that does not include SAP official interfaces and therefore is not

supported by SAP. Changes made based on this information are not supported and can be overwritten during an upgrade.

SAP will not be held liable for any damages caused by using or misusing the information, code or methods suggested in this document,

and anyone using these methods does so at his/her own risk.

SAP offers no guarantees and assumes no responsibility or liability of any type with respect to the content of this technical article or code sample, including any liability resulting from incompatibility between the content within this document and the materials and

services offered by SAP. You agree that you will not hold, or seek to hold, SAP responsible or liable with respect to the content of this

document.

Documents

SFTP Adapter Installation in PI Environment Adapter... · SFTP Adapter Installation in PI Environment Applies to: SAP NetWeaver PI 7.1, For more information, visit the SOA Management