Setting Up the PIT Landscape

Objective

After completing this lesson, you will be able to set up the PIT landscape

Technical Prerequisites

There are a certain technical prerequisites for working with the PIT tool.

The technical prerequisites can apply to the PIT tool itself as well as to the connected SAP Process Orchestration and SAP Process Integration systems serving as source and target systems. All components involved must meet certain requirements with respect to versioning and configuration.

Release Version and System Types

The PIT tool distinguishes between a source system from which messages are extracted and a target system in which these messages are replayed and tested.

For certain scenarios, source and target system can be identical. The systems must fulfill the following prerequisites:

PIT System

  • The PIT tool server components are part of the standard Java-only PI delivery since 7.50 SP14.
  • The PIT tool client is part of the SAP NetWeaver Developer Studio (version at least 7.50 SP14).
  • The CTC Configuration Wizard, PI Test Tool, was successfully executed.

Source System: The Test Data Can Be Extracted from the Following Systems:

  • SAP Process Orchestration or Advanced Adapter Engine Extended installation (Java-only PI).
  • SAP Process Integration dual stack (releases before SAP NetWeaver 7.5) or SAP Process Integration dual usage type installation (as of 7.5).
  • The Process Integration components must have, a least, release version 7.31 SP17, 7.40 SP12, or 7.50 SP06. For more details, refer to note 2650265, 2707854 and 2739354.
  • You must have activated message logging either system-wide or per scenario that you want to test.

Target System: A System Serving as Target System Must Fulfill the Following Prerequisites:

  • The system must be an Advanced Adapter Engine Extended (AEX) or SAP Process Orchestration system running at least on version 7.50 SP14 with the latest kernel patch.

    Note

    PI dual usage type installations aren’t supported as test targets.
  • You must have activated the message logging either system-wide or per scenario you want to test.
  • The CTC Configuration Wizard, PI Test Tool Target, was successfully executed.

Automated Configuration

You have to execute an automated configuration task on the PIT system as well as on the target system.

Before you start working with the PIT tool, you, first, need to execute an automated configuration task in your PIT system by running the CTC Configuration Wizard, PI Test Tool.

Before you connect a target system to the PIT tool, run the CTC Configuration Wizard, PI Test Tool Target, on the respective system.

To start the CTC Configuration Wizard, perform the following steps:

  • Open URL http(s)://<host>:<port>/nwa, and navigate to:Configuration → Scenarios → All Configuration Tasks.
  • Expand the task name list, and select the required tasks

Note

Find further information about the CTC Wizards in note 2728587.

To obtain detailed information about the executed configuration steps, expand the Details Bar in the wizard user interface.

Manual Configuration

The CTC Wizard creates a destination with the default name PIT_SYSTEM. The action retrieve_response (defined by the application com.sap.aii.pit.injector.app) must be assigned to the user maintained in this destination.

In case the CTC Configuration Wizard "PI Test Tool Target" wasn’t executed, you must manually perform the following configuration settings in the SAP NetWeaver Administrator (NWA):

  • Make sure the injector application com.sap.aii.pit.injector.app is deployed and running ,and the property pit.injector.enabled is set to true.
  • Ensure that an HTTP destination is used to retrieve the response of a synchronous message. Also, the destination has to point to the base URL of the PIT system (http<s>://<host>:<port>).The action retrieve_response (defined by the application com.sap.aii.pit.injector.app) must be assigned to the user maintained in the destination. The application property pit.injector.response.destination.name has to contain the name of the destination.

Setting up SAP NWDS

The PIT tool offers an SAP NetWeaver Developer Studio (NWDS)-based user interface, and a web-based user interface.

The SAP Process Integration Test perspective within the SAP NetWeaver Developer Studio (NWDS) targets PIT test developers and test administrators. It offers the full PIT functionality like landscape configuration, test development, test execution, and test verification.

Personas responsible for test execution usually prefer to work within a web-based user interface. Therefore, starting with SAP NetWeaver 7.5 SP17, PIT offers a web-based user interface based on UI5, with a reduced set of functionalities targeted at test execution.

The Configuration and the Test Run Starts will be done in the SAP NetWeaver Developer Studio (NWDS).

Open the perspective SAP Process Integration Test under Window → Perspective → Open Perspective → Other.

Before you can start to create test cases, you have to maintain the connection to the PIT System. Therefore, open Window → Preferences → SAP Process Integration Test, and maintain the connection settings for the PIT server.

Once the connection is configured, you can start to configure the test landscape.

Please have in your mind that each system that you connect to the PIT Tool System needs an http destination, and each connected PI Dual Stack system also an RFC destination. This should be created in the NWA before maintaining the Test Systems in the PIT Test System Browser.

Note

Do not use destination PIT_SYSTEM for this connection. PIT_SYSTEM is a destination on the target system pointed to the PIT System for synchronous messages only.

Create a Target Scenario

Business Scenario

Create a target scenario in NWK for the migration test from SAP PI 7.4 to SAP PO 7.5.

Exercise Information

Note

In this exercise, when the values include ##, replace the character with a two-digit number (01–30).

Exercise Options

You can perform this exercise in two ways:

  1. Live Environment: choose Start Exercise, and from the entry page choose Open PDF Document. Follow the steps described in this pdf in your own system landscape.
  2. Simulation: choose Start Exercise, and from the entry page choose Start Tutorial. Watch the step-by-step instructions within the simulation.

Note

We recommend running the simulation first.
ExerciseStart Exercise

Task 1: Create Two Business Components and Two Communication Channels

Steps

  1. Create business component BC_PIT_##_SND, and assign SI_Material_outb as the outbound interface.

    1. In the SAP Process Integration Designer Perspective, navigate to the PI Explorer tab.

    2. From the menu, choose New → Business Component.

    3. In the New Business Component window, as the name enter BC_PIT_##_SND.

    4. Choose the Finish button.

    5. In the Business Component screen, in the Sender Interface area, in the Name field, enter SI_Material_outb from the urn:education.com:BIT400:A namespace. This is done by using the Add button of the field. Select the entry in the list.

    6. Choose OK.

    7. Save the business component.

  2. Create a communication channel CC_HTTP_Sender_## of the HTTP_AAE / Sender type for the BC_PIT_##_SND business component, use the latest version available.

    1. On the PI Explorer tab page, choose New → Channel.

    2. In the Create a channel dialog box, for the channel name enter CC_HTTP_Sender_##.

    3. Enter BC_PIT_##_SND as Communication Component by using the Browse button. Select your sender component from the list.

    4. Choose the OK button.

    5. Choose the Finish button.

    6. In the Adapter Type area, select HTTP_AAE in the http://sap.com/xi/XI/System of SAP BASIS 7.50. This can be done by using the Browse button.

    7. Select the line, and choose the OK button.

    8. In the General Details area, change the Direction to Sender.

    9. Save and activate the communication channel.

  3. Create business component BC_PIT_##_RCV and assign SI_Material_inb as the inbound interface.

    1. Follow the description in step 1. Use the following values:

      Field NameValue
      Name (of the Receiver Business Component)BC_PIT_##_RCV
      Receiver InterfaceSI_Materials_inb | urn:education.com:BIT400:B

  4. Create a communication channel CC_File_Receiver_## of the File / Receiver type for the BC_PIT_##_RCV business component, use the latest version available.

    1. On the PI Explorer tab page, choose New → Channel.

    2. In the Create a channel dialog box, for the channel name, enter CC_File_Receiver_##.

    3. Enter BC_PIT_##_RCV as Communication Component by using the Browse button. Select your sender component from the list.

    4. Choose the OK button.

    5. Choose the Finish button.

    6. In the Adapter Type area, select File in the http://sap.com/xi/XI/System of SAP BASIS 7.50. This can be done by using the Browse button.

    7. Select the line, and choose the OK button.

    8. In the General Details area, ensure that the Direction is set to Receiver.

    9. Find the Adapter-specific tab page.

    10. On the Target tab page, enter /usr/sap/trans/tmp/group## in the Target Directory field. In the Filename Scheme field, enter PIT_Material_.xml.

      Caution

      The target directory may display with extra spaces or hyphens on-screen. Ensure that you do not include any spaces or hyphens when entering the target directory.

    11. Save and activate the communication channel.

Task 2: Create and Deploy the iFlow iFlow_MaterialA_MaterialsB_##_PIT

Create an Integration Flow for the scenario. Assign the business systems BC_PIT_##_SND as the sender and BC_PIT_##_RCV as the receiver. Use the communication channels created in the previous exercise.

Steps

  1. Create an Integration Flow for the scenario.

    1. In the SAP Process Integration Designer Perspective navigate to thePI Explorer tab.

    2. From the menu, choose New → Integration Flow.

    3. Enter iFlow_MaterialA_MaterialsB_##_PIT as the Name and ID.

    4. Choose the Point-to-Point Channel pattern.

    5. Choose Next.

    6. In the Sender System tab, use the Browse button to select the BC_PIT_##_SND communication component.

    7. Choose OK.

    8. Using the Browse button, choose the interface and the operation SI_Material_outb.

    9. Choose OK.

    10. In the Receiver Systems tab, choose Add.

    11. Choose BC_PIT_##_RCV and OK.

    12. In the Interface column, choose the … (ellipsis) button that appears when you select it, and choose SI_Materials_inb interface.

    13. ChooseFinish.

    14. Your new iFlow opens automatically. If it does not open, refresh the PI Explorer tab, and double-click in it.

  2. Assign the Sender Channel.

    1. Select the arrow from the BC_PIT_##_SND to the iFlow until the color changes to orange.

    2. Right-click, and choose Assign Referenced Channel.

    3. Select the CC_HTTP_Sender_## channel, and choose OK.

  3. Assign the Receiver Channel.

    1. Select the arrow from the BC_PIT_##_RCV to the iFlow until the color changes to orange.

    2. Right-click, and choose Assign Referenced Channel.

    3. Select the CC_File_Receiver_## channel, and choose OK.

  4. Assign a mapping program to your iFlow Scenario.

    1. In the iFlow, select the line between the two envelopes, and choose Add Mapping.

    2. Right-click in the Mapping step, and choose Assign Mapping.

    3. Select the OM_MaterialA_MaterialsB | SC_BIT400_MAPPING 1.0 of education.com operation mapping, and choose OK.

    4. For the iFlow in the Properties tab, select the Runtime Configuration button and enable the radio button Use scenario-specific configurations for Logging. For both Message Preparation (BI Step) and also for Mapping (AM Step), choose the option Log. You do not have to choose an option for Receiver Determination (MS Step).

  5. Save, activate, and deploy your iFlow.

    1. Save your iFlow.

    2. Right-click in the iFlow, and chooseActivate.

    3. Choose Yes.

      Result

      iFlow should be activated successfully. Refresh if not refreshed automatically.

    4. Right-click in your iFlow, and choose Deploy.

    5. Choose Yes.

      Result

      Your iFlow should be successfully deployed.

Log in to track your progress & complete quizzes

Learning

SAP FacebookSAP YoutubeSAP LinkedIn