Вы находитесь на странице: 1из 31

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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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
servers 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

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 7


3. Go to Deployment tab.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 10

7. Click on Start Deployment

8. Once the deployment is completed successfully, click the confirm button.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 11

Now, repeat the same steps for deploying SeeXIExtendedTools.sca

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 12

Click on next

Click on Start Deployment
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 13


SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 15


SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 16


SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 17


SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 19

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

5. From the menu, choose Object -> New
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 21

7. Click on apply

The following screen appears
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 23


9. Click on save

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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 servers public keys.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.

SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2010 SAP AG 29

Restart the XI Server/J2EE Engine
Restart the XI server.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.
SFTP Adapter Installation in PI Environment
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
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.