sftp adapter installation

Upload: marri-mahipal

Post on 15-Oct-2015

76 views

Category:

Documents


4 download

DESCRIPTION

SFTP Adapter Installation

TRANSCRIPT

  • 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

    \Content\XI3_0_SEEBURGER_EDI_ADAPTER_3.0_of_Seeburger.tpz to the repository servers import folder (e.g. /global/xi/repository_server/import/).

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

    http://:500/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:-

    :\Tools\deploy\SeeXIBaseTools.sca

    :\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:-

    :\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 :\ 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.

    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.